Preparing the actual release.

Preparing patch release.
Tagging the version.
2026-06-08 17:27:07 +00:00 · 2021-06-05 11:33:32 -04:00 · 2021-06-04 17:09:21 -04:00 · 2021-05-27 16:21:00 -04:00 · 2021-05-27 16:20:07 -04:00 · 2021-05-15 15:45:02 -04:00
2589 changed files with 293691 additions and 271947 deletions
@@ -15,29 +15,29 @@ environment:
    - job_name: VS2019
      CMAKE_ARGS: -A %Platform%
    - job_name: VS2019ARM
-      CMAKE_ARGS: -A ARM64   -DSIMDJSON_DEVELOPER_MODE=ON -DCMAKE_CROSSCOMPILING=1 -D SIMDJSON_GOOGLE_BENCHMARKS=OFF # Does Google Benchmark builds under VS ARM?
+      CMAKE_ARGS: -A ARM64 -DCMAKE_CROSSCOMPILING=1 -D SIMDJSON_GOOGLE_BENCHMARKS=OFF # Does Google Benchmark builds under VS ARM?
    - job_name: VS2017 (Static, No Threads)
      image: Visual Studio 2017
-      CMAKE_ARGS: -A %Platform%   -DSIMDJSON_DEVELOPER_MODE=ON -DBUILD_SHARED_LIBS=OFF -DSIMDJSON_ENABLE_THREADS=OFF
+      CMAKE_ARGS: -A %Platform% -DSIMDJSON_BUILD_STATIC=ON -DSIMDJSON_ENABLE_THREADS=OFF
      CTEST_ARGS: -LE explicitonly
    - job_name: VS2019 (Win32)
      platform: Win32
-      CMAKE_ARGS: -A %Platform%   -DSIMDJSON_DEVELOPER_MODE=ON -DBUILD_SHARED_LIBS=ON -DSIMDJSON_ENABLE_THREADS=ON # This should be the default. Testing anyway.
+      CMAKE_ARGS: -A %Platform% -DSIMDJSON_BUILD_STATIC=OFF -DSIMDJSON_ENABLE_THREADS=ON # This should be the default. Testing anyway.
      CTEST_ARGS: -LE explicitonly
    - job_name: VS2019 (Win32, No Exceptions)
      platform: Win32
-      CMAKE_ARGS: -A %Platform%   -DSIMDJSON_DEVELOPER_MODE=ON -DBUILD_SHARED_LIBS=ON -DSIMDJSON_ENABLE_THREADS=ON -DSIMDJSON_EXCEPTIONS=OFF
+      CMAKE_ARGS: -A %Platform% -DSIMDJSON_BUILD_STATIC=OFF -DSIMDJSON_ENABLE_THREADS=ON -DSIMDJSON_EXCEPTIONS=OFF
      CTEST_ARGS: -LE explicitonly
    - job_name: VS2015
      image: Visual Studio 2015
-      CMAKE_ARGS: -A %Platform%   -DSIMDJSON_DEVELOPER_MODE=ON -DBUILD_SHARED_LIBS=OFF -DSIMDJSON_ENABLE_THREADS=OFF
+      CMAKE_ARGS: -A %Platform% -DSIMDJSON_BUILD_STATIC=ON -DSIMDJSON_ENABLE_THREADS=OFF
      CTEST_ARGS: -LE explicitonly

 build_script:
  - mkdir build
  - cd build
  - cmake --version
-  - cmake %CMAKE_ARGS% ..
+  - cmake %CMAKE_ARGS% --parallel ..
  - cmake -LH ..
  - cmake --build . --config %Configuration% --verbose --parallel

@@ -0,0 +1,316 @@
+version: 2.1
+
+
+# We constantly run out of memory so please do not use parallelism (-j, -j4). 
+
+# Reusable image / compiler definitions
+executors:
+  gcc8:
+    docker:
+      - image: conanio/gcc8
+        environment:
+          CXX: g++-8
+          CC: gcc-8
+          BUILD_FLAGS: 
+          CTEST_FLAGS: --output-on-failure
+
+  gcc9:
+    docker:
+      - image: conanio/gcc9
+        environment:
+          CXX: g++-9
+          CC: gcc-9
+          BUILD_FLAGS:
+          CTEST_FLAGS: --output-on-failure
+
+  gcc10:
+    docker:
+      - image: conanio/gcc10
+        environment:
+          CXX: g++-10
+          CC: gcc-10
+          BUILD_FLAGS:
+          CTEST_FLAGS: --output-on-failure
+
+  clang10:
+    docker:
+      - image: conanio/clang10
+        environment:
+          CXX: clang++-10
+          CC: clang-10
+          BUILD_FLAGS:
+          CTEST_FLAGS: --output-on-failure
+
+  clang9:
+    docker:
+      - image: conanio/clang9
+        environment:
+          CXX: clang++-9
+          CC: clang-9
+          BUILD_FLAGS:
+          CTEST_FLAGS: --output-on-failure 
+
+  clang6:
+    docker:
+      - image: conanio/clang60
+        environment:
+          CXX: clang++-6.0
+          CC: clang-6.0
+          BUILD_FLAGS:
+          CTEST_FLAGS: --output-on-failure
+
+# Reusable test commands (and initializer for clang 6)
+commands:
+  dependency_restore:
+    steps:
+      - restore_cache:
+          keys:
+            - cmake-cache-{{ checksum "dependencies/CMakeLists.txt" }}
+
+  dependency_cache:
+    steps:
+      - save_cache:
+          key: cmake-cache-{{ checksum "dependencies/CMakeLists.txt" }}
+          paths:
+            - dependencies/.cache
+
+  install_cmake:
+    steps:
+      - run: apt-get update -qq
+      - run: apt-get install -y cmake
+
+  cmake_prep:
+    steps:
+      - checkout
+      - run: mkdir -p build
+
+  cmake_build_cache:
+    steps:
+      - cmake_prep
+      - dependency_restore
+      - run: cmake $CMAKE_FLAGS -DCMAKE_INSTALL_PREFIX:PATH=destination -B build . 
+      - dependency_cache # dependencies are produced in the configure step
+
+  cmake_build:
+    steps:
+      - cmake_build_cache
+      - run: cmake --build build
+
+  cmake_test:
+    steps:
+      - cmake_build
+      - run: |
+          cd build &&
+          tools/json2json -h &&
+          ctest $CTEST_FLAGS -L acceptance &&
+          ctest $CTEST_FLAGS -LE acceptance -LE explicitonly
+
+  cmake_assert_test:
+    steps:
+      - run: |
+          cd build &&
+          tools/json2json -h &&
+          ctest $CTEST_FLAGS -L assert
+
+  cmake_test_all:
+    steps:
+      - cmake_build
+      - run: |
+          cd build &&
+          tools/json2json -h &&
+          ctest $CTEST_FLAGS -DSIMDJSON_IMPLEMENTATION="haswell;westmere;fallback" -L acceptance -LE per_implementation &&
+          SIMDJSON_FORCE_IMPLEMENTATION=haswell ctest $CTEST_FLAGS -L per_implementation -LE explicitonly &&
+          SIMDJSON_FORCE_IMPLEMENTATION=westmere ctest $CTEST_FLAGS -L per_implementation -LE explicitonly &&
+          SIMDJSON_FORCE_IMPLEMENTATION=fallback ctest $CTEST_FLAGS -L per_implementation -LE explicitonly &&
+          ctest $CTEST_FLAGS -LE "acceptance|per_implementation" # Everything we haven't run yet, run now.
+
+
+  cmake_perftest:
+    steps:
+      - cmake_build_cache
+      - run: |
+          cmake --build  build --target checkperf &&
+          cd build && 
+          ctest --output-on-failure -R checkperf
+
+  # we not only want cmake to build and run tests, but we want also a successful installation from which we can build, link and run programs
+  cmake_install_test: # this version builds, install, test and then verify from the installation
+    steps:
+      - run: cd build && make install
+      - run: echo -e '#include <simdjson.h>\nint main(int argc,char**argv) {simdjson::dom::parser parser;simdjson::dom::element tweets = parser.load(argv[1]); }' > tmp.cpp && c++ -Ibuild/destination/include -Lbuild/destination/lib -std=c++17 -Wl,-rpath,build/destination/lib -o linkandrun tmp.cpp -lsimdjson && ./linkandrun jsonexamples/twitter.json
+
+  cmake_installed_test_cxx20: # assuming that it was installed, this tries to build using C++20
+    steps:
+      - run: echo -e '#include <simdjson.h>\nint main(int argc,char**argv) {simdjson::dom::parser parser;simdjson::dom::element tweets = parser.load(argv[1]); }' > tmp.cpp && c++ -Ibuild/destination/include -Lbuild/destination/lib -std=c++20 -Wl,-rpath,build/destination/lib -o linkandrun tmp.cpp -lsimdjson && ./linkandrun jsonexamples/twitter.json
+
+jobs:
+
+  # static
+  justlib-gcc10:
+    description: Build just the library, install it and do a basic test
+    executor: gcc10
+    environment: { CMAKE_FLAGS: -DSIMDJSON_JUST_LIBRARY=ON }
+    steps: [ cmake_build, cmake_install_test, cmake_installed_test_cxx20 ]
+  assert-gcc10:
+    description: Build the library with asserts on, install it and run tests
+    executor: gcc10
+    environment: { CMAKE_FLAGS: -DSIMDJSON_GOOGLE_BENCHMARKS=OFF -DCMAKE_CXX_FLAGS_RELEASE=-O3 }
+    steps: [ cmake_test, cmake_assert_test ]
+  assert-clang10:
+    description: Build just the library, install it and do a basic test
+    executor: clang10
+    environment: { CMAKE_FLAGS: -DSIMDJSON_GOOGLE_BENCHMARKS=OFF -DCMAKE_CXX_FLAGS_RELEASE=-O3 }
+    steps: [ cmake_test, cmake_assert_test ]
+  gcc10-perftest:
+    description: Build and run performance tests on GCC 10 and AVX 2 with a cmake static build, this test performance regression
+    executor: gcc10
+    environment: { CMAKE_FLAGS: -DSIMDJSON_GOOGLE_BENCHMARKS=OFF -DSIMDJSON_BUILD_STATIC=ON }
+    steps: [ cmake_perftest ]
+  gcc10:
+    description: Build and run tests on GCC 10 and AVX 2 with a cmake static build
+    executor: gcc10
+    environment: { CMAKE_FLAGS: -DSIMDJSON_GOOGLE_BENCHMARKS=ON -DSIMDJSON_BUILD_STATIC=ON }
+    steps: [ cmake_test, cmake_install_test, cmake_installed_test_cxx20 ]
+  clang6:
+    description: Build and run tests on clang 6 and AVX 2 with a cmake static build
+    executor: clang6
+    environment: { CMAKE_FLAGS: -DSIMDJSON_GOOGLE_BENCHMARKS=ON -DSIMDJSON_BUILD_STATIC=ON }
+    steps: [ cmake_test, cmake_install_test ]
+  clang10:
+    description: Build and run tests on clang 10 and AVX 2 with a cmake static build
+    executor: clang10
+    environment: { CMAKE_FLAGS: -DSIMDJSON_GOOGLE_BENCHMARKS=ON  -DSIMDJSON_BUILD_STATIC=ON }
+    steps: [ cmake_test, cmake_install_test, cmake_installed_test_cxx20 ]
+  # libcpp
+  libcpp-clang10:
+    description: Build and run tests on clang 10 and AVX 2 with a cmake static build and libc++
+    executor: clang10
+    environment: { CMAKE_FLAGS: -DSIMDJSON_USE_LIBCPP=ON  -DSIMDJSON_BUILD_STATIC=ON }
+    steps: [ cmake_test, cmake_install_test, cmake_installed_test_cxx20 ]
+  # sanitize
+  sanitize-gcc10:
+    description: Build and run tests on GCC 10 and AVX 2 with a cmake sanitize build
+    executor: gcc10
+    environment: { CMAKE_FLAGS: -DSIMDJSON_BUILD_STATIC=OFF -DSIMDJSON_SANITIZE=ON, BUILD_FLAGS: "", CTEST_FLAGS: --output-on-failure -LE explicitonly }
+    steps: [ cmake_test ]
+  sanitize-clang10:
+    description: Build and run tests on clang 10 and AVX 2 with a cmake sanitize build
+    executor: clang10
+    environment: { CMAKE_FLAGS: -DSIMDJSON_BUILD_STATIC=OFF -DSIMDJSON_SANITIZE=ON, CTEST_FLAGS: --output-on-failure -LE explicitonly }
+    steps: [ cmake_test ]
+  threadsanitize-gcc10:
+    description: Build and run tests on GCC 10 and AVX 2 with a cmake sanitize build
+    executor: gcc10
+    environment: { CMAKE_FLAGS: -DSIMDJSON_BUILD_STATIC=OFF -DSIMDJSON_SANITIZE_THREADS=ON, BUILD_FLAGS: "", CTEST_FLAGS: --output-on-failure -LE explicitonly }
+    steps: [ cmake_test ]
+  threadsanitize-clang10:
+    description: Build and run tests on clang 10 and AVX 2 with a cmake sanitize build
+    executor: clang10
+    environment: { CMAKE_FLAGS: -DSIMDJSON_BUILD_STATIC=OFF -DSIMDJSON_SANITIZE_THREADS=ON, CTEST_FLAGS: --output-on-failure -LE explicitonly }
+    steps: [ cmake_test ]
+  # dynamic
+  dynamic-gcc10:
+    description: Build and run tests on GCC 10 and AVX 2 with a cmake dynamic build
+    executor: gcc10
+    environment: { CMAKE_FLAGS: -DSIMDJSON_BUILD_STATIC=OFF }
+    steps: [ cmake_test, cmake_install_test ]
+  dynamic-clang10:
+    description: Build and run tests on clang 10 and AVX 2 with a cmake dynamic build
+    executor: clang10
+    environment: { CMAKE_FLAGS: -DSIMDJSON_BUILD_STATIC=OFF }
+    steps: [ cmake_test, cmake_install_test ]
+
+  # unthreaded
+  unthreaded-gcc10:
+    description: Build and run tests on GCC 10 and AVX 2 *without* threads
+    executor: gcc10
+    environment: { CMAKE_FLAGS: -DSIMDJSON_ENABLE_THREADS=OFF }
+    steps: [ cmake_test, cmake_install_test ]
+  unthreaded-clang10:
+    description: Build and run tests on Clang 10 and AVX 2 *without* threads
+    executor: clang10
+    environment: { CMAKE_FLAGS: -DSIMDJSON_ENABLE_THREADS=OFF }
+    steps: [ cmake_test, cmake_install_test ]
+
+  # noexcept
+  noexcept-gcc10:
+    description: Build and run tests on GCC 10 and AVX 2 with exceptions off
+    executor: gcc10
+    environment: { CMAKE_FLAGS: -DSIMDJSON_EXCEPTIONS=OFF }
+    steps: [ cmake_test, cmake_install_test ]
+  noexcept-clang10:
+    description: Build and run tests on Clang 10 and AVX 2 with exceptions off
+    executor: clang10
+    environment: { CMAKE_FLAGS: -DSIMDJSON_EXCEPTIONS=OFF }
+    steps: [ cmake_test, cmake_install_test ]
+
+  #
+  # Misc.
+  #
+
+  # make (test and checkperf)
+  arch-haswell-gcc10:
+    description: Build, run tests and check performance on GCC 10 with -march=haswell
+    executor: gcc10
+    environment: { CXXFLAGS: -march=haswell }
+    steps: [ cmake_test ]
+  arch-nehalem-gcc10:
+    description: Build, run tests and check performance on GCC 10 with -march=nehalem
+    executor: gcc10
+    environment: { CXXFLAGS: -march=nehalem }
+    steps: [ cmake_test ]
+  sanitize-haswell-gcc10:
+    description: Build and run tests on GCC 10 and AVX 2 with a cmake sanitize build
+    executor: gcc10
+    environment: {  CXXFLAGS: -march=haswell, CMAKE_FLAGS: -DSIMDJSON_BUILD_STATIC=OFF -DSIMDJSON_SANITIZE=ON, BUILD_FLAGS: "", CTEST_FLAGS: --output-on-failure -LE explicitonly }
+    steps: [ cmake_test ]
+  sanitize-haswell-clang10:
+    description: Build and run tests on clang 10 and AVX 2 with a cmake sanitize build
+    executor: clang10
+    environment: { CXXFLAGS: -march=haswell, CMAKE_FLAGS: -DSIMDJSON_BUILD_STATIC=OFF -DSIMDJSON_SANITIZE=ON, CTEST_FLAGS: --output-on-failure -LE explicitonly }
+    steps: [ cmake_test ]
+
+workflows:
+  version: 2.1
+  build_and_test:
+    jobs:
+      # full multi-implementation tests
+      #- gcc7 tested on GitHub actions
+      - gcc10 # do not delete this as it tests our performance
+      - clang6
+      #- clang10 # this gets tested a lot below
+
+      # libc++
+      - libcpp-clang10
+
+      # full single-implementation tests
+      - sanitize-gcc10
+      - sanitize-clang10
+      - threadsanitize-gcc10
+      - threadsanitize-clang10
+      - dynamic-gcc10
+      - dynamic-clang10
+      - unthreaded-gcc10
+      - unthreaded-clang10
+
+      # no exceptions
+      - noexcept-gcc10
+      - noexcept-clang10
+
+      # quicker make single-implementation tests
+      - arch-haswell-gcc10
+      - arch-nehalem-gcc10
+
+
+      # sanitized single-implementation tests
+      - sanitize-haswell-gcc10
+      - sanitize-haswell-clang10
+
+      # testing "just the library"
+      - justlib-gcc10
+
+      # testing asserts
+      - assert-gcc10
+      - assert-clang10
+
+      # TODO add windows: https://circleci.com/docs/2.0/configuration-reference/#windows
@@ -1,47 +0,0 @@
-CompileFlags:
-    CompilationDatabase: build
-    Add:
-        - -Werror -Wall -Wextra -Weffc++ -Wsign-compare -Wshadow -Wwrite-strings -Wpointer-arith -Winit-self -Wconversion -Wno-sign-conversion
-        - -Wundefined-inline
-Diagnostics:
-    Suppress:
-        - misc-unused-alias-decls
-        - misc-unused-using-decls
-        - misc-definitions-in-headers # TODO fix and remove these violations
---
-If:
-    PathMatch:
-        - include/.*
-        - src/.*
-    PathExclude:
-        - include/simdjson.h
-        - src/simdjson.cpp
-CompileFlags:
-    Add:
-        - -Wno-unneeded-internal-declaration
-        - -Wno-undefined-internal # TODO fix and remove these violations
-        - -Wno-unused-function
-        - -Wno-unused-const-variable
-Diagnostics:
-    Suppress:
-        - pp_including_mainfile_in_preamble
-        - unused-includes
---
-# Amalgamated files that require or partly define an implementation
-If:
-    PathMatch:
-        - .*/(arm64|fallback|haswell|icelake|ppc64|westmere)/begin.h
-        - .*/generic/.*
-Diagnostics:
-    Suppress:
-        - pragma_attribute_no_pop_eof
---
-# clang has a bad time detecting the push/pop together in src/ for some reason
-If:
-    PathMatch:
-        - include/simdjson/.*/end.h
-        - src/(arm64|fallback|haswell|icelake|ppc64|westmere).cpp
-Diagnostics:
-    Suppress:
-        - pragma_attribute_no_pop_eof
-        - pragma_attribute_stack_mismatch
@@ -1,4 +1,46 @@
 kind: pipeline
+name: i386-gcc # we do not support 32-bit systems, but we run tests
+platform: { os: linux, arch: amd64 }
+steps:
+- name: Build and Test
+  image: i386/ubuntu
+  environment:
+    CC: gcc
+    CXX: g++
+    BUILD_FLAGS: -- -j
+    CMAKE_FLAGS: -DSIMDJSON_BUILD_STATIC=ON
+    CTEST_FLAGS: -j4 --output-on-failure -LE explicitonly 
+  commands:
+    - scripts/addcmakeppa.sh "$(env -i sh -c '. /etc/os-release; echo $VERSION_CODENAME')"
+    - apt-get install -y g++ cmake gcc git
+    - mkdir build
+    - cd build
+    - cmake $CMAKE_FLAGS ..
+    - cmake --build . $BUILD_FLAGS
+    - ctest $CTEST_FLAGS 
+---
+kind: pipeline
+name: i386-clang # we do not support 32-bit systems, but we run tests
+platform: { os: linux, arch: amd64 }
+steps:
+- name: Build and Test
+  image: i386/ubuntu
+  environment:
+    CC: clang-6.0
+    CXX: clang++-6.0
+    BUILD_FLAGS: -- -j
+    CMAKE_FLAGS: -DSIMDJSON_BUILD_STATIC=ON
+    CTEST_FLAGS: -j4 --output-on-failure -LE explicitonly 
+  commands:
+    - scripts/addcmakeppa.sh "$(env -i sh -c '. /etc/os-release; echo $VERSION_CODENAME')"
+    - apt-get install -y clang++-6.0 cmake git
+    - mkdir build
+    - cd build
+    - cmake $CMAKE_FLAGS ..
+    - cmake --build . $BUILD_FLAGS
+    - ctest $CTEST_FLAGS 
+---
+kind: pipeline
 name: gcc9
 platform: { os: linux, arch: amd64 }
 steps:
@@ -8,7 +50,7 @@ steps:
    CC: gcc
    CXX: g++
    BUILD_FLAGS: -- -j
-    CMAKE_FLAGS: -DBUILD_SHARED_LIBS=OFF -DSIMDJSON_IMPLEMENTATION=icelake;haswell;westmere;fallback
+    CMAKE_FLAGS: -DSIMDJSON_BUILD_STATIC=ON -DSIMDJSON_IMPLEMENTATION=haswell;westmere;fallback
    CTEST_FLAGS: -j4 --output-on-failure -LE explicitonly
  commands:
    - echo "deb http://deb.debian.org/debian buster-backports main" >> /etc/apt/sources.list
@@ -19,7 +61,6 @@ steps:
    - cmake $CMAKE_FLAGS ..
    - cmake --build . $BUILD_FLAGS
    - ctest $CTEST_FLAGS -L acceptance -LE per_implementation
-    - SIMDJSON_FORCE_IMPLEMENTATION=icelake ctest $CTEST_FLAGS -L per_implementation
    - SIMDJSON_FORCE_IMPLEMENTATION=haswell ctest $CTEST_FLAGS -L per_implementation
    - SIMDJSON_FORCE_IMPLEMENTATION=westmere ctest $CTEST_FLAGS -L per_implementation
    - SIMDJSON_FORCE_IMPLEMENTATION=fallback ctest $CTEST_FLAGS -L per_implementation
@@ -36,7 +77,7 @@ steps:
    CC: clang-6.0
    CXX: clang++-6.0
    BUILD_FLAGS: -- -j
-    CMAKE_FLAGS: -DBUILD_SHARED_LIBS=OFF -DSIMDJSON_IMPLEMENTATION=icelake;haswell;westmere;fallback
+    CMAKE_FLAGS: -DSIMDJSON_BUILD_STATIC=ON -DSIMDJSON_IMPLEMENTATION=haswell;westmere;fallback
    CTEST_FLAGS: -j4 --output-on-failure -LE explicitonly
  commands:
    - mkdir build
@@ -44,7 +85,6 @@ steps:
    - cmake $CMAKE_FLAGS ..
    - cmake --build . $BUILD_FLAGS
    - ctest $CTEST_FLAGS -L acceptance -LE per_implementation
-    - SIMDJSON_FORCE_IMPLEMENTATION=icelake ctest $CTEST_FLAGS -L per_implementation
    - SIMDJSON_FORCE_IMPLEMENTATION=haswell ctest $CTEST_FLAGS -L per_implementation
    - SIMDJSON_FORCE_IMPLEMENTATION=westmere ctest $CTEST_FLAGS -L per_implementation
    - SIMDJSON_FORCE_IMPLEMENTATION=fallback ctest $CTEST_FLAGS -L per_implementation
@@ -60,7 +100,7 @@ steps:
    CC: gcc
    CXX: g++
    BUILD_FLAGS: -- -j
-    CMAKE_FLAGS: -DBUILD_SHARED_LIBS=ON
+    CMAKE_FLAGS: -DSIMDJSON_BUILD_STATIC=OFF
    CTEST_FLAGS: -j4 --output-on-failure -LE explicitonly
  commands:
    - echo "deb http://deb.debian.org/debian buster-backports main" >> /etc/apt/sources.list
@@ -82,7 +122,7 @@ steps:
  environment:
    CC: clang-9
    CXX: clang++-9
-    CMAKE_FLAGS: -DBUILD_SHARED_LIBS=ON
+    CMAKE_FLAGS: -DSIMDJSON_BUILD_STATIC=OFF
    BUILD_FLAGS: -- -j
    CTEST_FLAGS: -j4 --output-on-failure -LE explicitonly
  commands:
@@ -102,7 +142,7 @@ steps:
    CC: gcc
    CXX: g++
    BUILD_FLAGS: -- -j
-    CMAKE_FLAGS: -DBUILD_SHARED_LIBS=OFF -DSIMDJSON_IMPLEMENTATION=icelake;haswell;westmere;fallback
+    CMAKE_FLAGS: -DSIMDJSON_BUILD_STATIC=ON -DSIMDJSON_IMPLEMENTATION=haswell;westmere;fallback
    CTEST_FLAGS: -j4 --output-on-failure -LE explicitonly
  commands:
    - echo "deb http://deb.debian.org/debian buster-backports main" >> /etc/apt/sources.list
@@ -113,7 +153,6 @@ steps:
    - cmake $CMAKE_FLAGS ..
    - cmake --build . $BUILD_FLAGS
    - ASAN_OPTIONS="detect_leaks=0" ctest $CTEST_FLAGS -L acceptance -LE per_implementation
-    - SIMDJSON_FORCE_IMPLEMENTATION=icelake ASAN_OPTIONS="detect_leaks=0" ctest $CTEST_FLAGS -L per_implementation
    - SIMDJSON_FORCE_IMPLEMENTATION=haswell ASAN_OPTIONS="detect_leaks=0" ctest $CTEST_FLAGS -L per_implementation
    - SIMDJSON_FORCE_IMPLEMENTATION=westmere ASAN_OPTIONS="detect_leaks=0" ctest $CTEST_FLAGS -L per_implementation
    - SIMDJSON_FORCE_IMPLEMENTATION=fallback ASAN_OPTIONS="detect_leaks=0" ctest $CTEST_FLAGS -L per_implementation
@@ -129,7 +168,7 @@ steps:
  environment:
    CC: clang-9
    CXX: clang++-9
-    CMAKE_FLAGS: -DSIMDJSON_SANITIZE=ON -DSIMDJSON_IMPLEMENTATION=icelake;haswell;westmere;fallback
+    CMAKE_FLAGS: -DSIMDJSON_SANITIZE=ON -DSIMDJSON_IMPLEMENTATION=haswell;westmere;fallback
    BUILD_FLAGS: -- -j
    CTEST_FLAGS: -j4 --output-on-failure -LE explicitonly
  commands:
@@ -138,7 +177,6 @@ steps:
    - cmake $CMAKE_FLAGS ..
    - cmake --build . $BUILD_FLAGS
    - ASAN_OPTIONS="detect_leaks=0" ctest $CTEST_FLAGS -L acceptance -LE per_implementation
-    - SIMDJSON_FORCE_IMPLEMENTATION=icelake ASAN_OPTIONS="detect_leaks=0" ctest $CTEST_FLAGS -L per_implementation
    - SIMDJSON_FORCE_IMPLEMENTATION=haswell ASAN_OPTIONS="detect_leaks=0" ctest $CTEST_FLAGS -L per_implementation
    - SIMDJSON_FORCE_IMPLEMENTATION=westmere ASAN_OPTIONS="detect_leaks=0" ctest $CTEST_FLAGS -L per_implementation
    - SIMDJSON_FORCE_IMPLEMENTATION=fallback ASAN_OPTIONS="detect_leaks=0" ctest $CTEST_FLAGS -L per_implementation
@@ -175,7 +213,7 @@ steps:
    CC: gcc
    CXX: g++
    BUILD_FLAGS: -- -j
-    CMAKE_FLAGS: -DBUILD_SHARED_LIBS=OFF -DSIMDJSON_IMPLEMENTATION=arm64;fallback
+    CMAKE_FLAGS: -DSIMDJSON_BUILD_STATIC=ON -DSIMDJSON_IMPLEMENTATION=arm64;fallback
    CTEST_FLAGS: -j4 --output-on-failure -LE explicitonly
  commands:
    - echo "deb http://deb.debian.org/debian buster-backports main" >> /etc/apt/sources.list
@@ -199,7 +237,7 @@ steps:
  environment:
    CC: clang-6.0
    CXX: clang++-6.0
-    CMAKE_FLAGS: -DBUILD_SHARED_LIBS=ON
+    CMAKE_FLAGS: -DSIMDJSON_BUILD_STATIC=OFF
    BUILD_FLAGS: -- -j
    CTEST_FLAGS: -j4 --output-on-failure  -LE explicitonly
  commands:
@@ -222,7 +260,7 @@ steps:
    CC: gcc
    CXX: g++
    BUILD_FLAGS: -- -j
-    CMAKE_FLAGS: -DBUILD_SHARED_LIBS=ON
+    CMAKE_FLAGS: -DSIMDJSON_BUILD_STATIC=OFF
    CTEST_FLAGS: -j4 --output-on-failure -LE explicitonly
  commands:
    - echo "deb http://deb.debian.org/debian buster-backports main" >> /etc/apt/sources.list
@@ -243,7 +281,7 @@ steps:
  environment:
    CC: clang-6.0
    CXX: clang++-6.0
-    CMAKE_FLAGS: -DBUILD_SHARED_LIBS=ON
+    CMAKE_FLAGS: -DSIMDJSON_BUILD_STATIC=OFF
    BUILD_FLAGS: -- -j
    CTEST_FLAGS: -j4 --output-on-failure -LE explicitonly
  commands:
@@ -264,7 +302,7 @@ steps:
  image: gcc:8
  environment:
    BUILD_FLAGS: -- -j
-    CMAKE_FLAGS: -DBUILD_SHARED_LIBS=OFF -DSIMDJSON_IMPLEMENTATION=arm64;fallback
+    CMAKE_FLAGS: -DSIMDJSON_BUILD_STATIC=ON -DSIMDJSON_IMPLEMENTATION=arm64;fallback
    CTEST_FLAGS: -j4 --output-on-failure -LE explicitonly
    CC: gcc
    CXX: g++
@@ -318,7 +356,7 @@ steps:
    CC: clang-9
    CXX: clang++-9
    BUILD_FLAGS: -- -j 4
-    CMAKE_FLAGS: -GNinja -DBUILD_SHARED_LIBS=OFF
+    CMAKE_FLAGS: -GNinja -DSIMDJSON_BUILD_STATIC=ON
    CTEST_FLAGS: -j4 --output-on-failure -LE explicitonly
    CXXFLAGS: -stdlib=libc++
  commands:
@@ -339,7 +377,7 @@ steps:
    CC: clang-9
    CXX: clang++-9
    BUILD_FLAGS: -- -j
-    CMAKE_FLAGS: -DBUILD_SHARED_LIBS=OFF
+    CMAKE_FLAGS: -DSIMDJSON_BUILD_STATIC=ON
    CTEST_FLAGS: -j4 --output-on-failure -LE explicitonly
    CXXFLAGS: -stdlib=libc++
  commands:
@@ -360,7 +398,7 @@ steps:
    CC: clang-7
    CXX: clang++-7
    BUILD_FLAGS: -- -j
-    CMAKE_FLAGS: -DBUILD_SHARED_LIBS=OFF
+    CMAKE_FLAGS: -DSIMDJSON_BUILD_STATIC=ON
    CTEST_FLAGS: -j4 --output-on-failure -LE explicitonly
    CXXFLAGS: -stdlib=libc++
  commands:
@@ -406,8 +444,8 @@ steps:
  commands:
    - apt-get -qq update
    - apt-get install -q -y clang cmake git wget zip ninja-build
-    - wget -O corpus.tar.gz https://readonly:readonly@www.pauldreik.se/fuzzdata/index.php?project=simdjson
-    - tar xf corpus.tar.gz && rm corpus.tar.gz
+    - wget --quiet https://dl.bintray.com/pauldreik/simdjson-fuzz-corpus/corpus/corpus.tar
+    - tar xf corpus.tar && rm corpus.tar
    - fuzz/build_like_ossfuzz.sh
    - mkdir -p common_out
    - for fuzzer in build/fuzz/fuzz_* ; do echo $fuzzer;$fuzzer common_out out/* -max_total_time=40; done
@@ -1,12 +0,0 @@
-# https://editorconfig.org/
-root = true
-# Conservatively avoid changing defaults for other file types, e.g. raw json files for test cases,
-# Makefiles, etc.
-[*.{cpp,h,md}]
-charset                  = utf-8
-end_of_line              = lf
-indent_size              = 2
-indent_style             = space
-insert_final_newline     = true
-tab_width                = 2
-trim_trailing_whitespace = true
@@ -3,7 +3,7 @@
 * text=auto

 # we don't want json files to be modified for this project
-*.json binary diff=astextplain
+*.json binary 


 # Common settings that generally should always be used with your language specific settings
@@ -78,7 +78,6 @@

 .gitattributes export-ignore
 .gitignore     export-ignore
-.editorconfig  export-ignore

 # Sources
 *.c     text eol=lf diff=c
@@ -9,57 +9,33 @@ assignees: ''

 Before submitting an issue, please ensure that you have read the documentation:

-* Basics is an overview of how to use simdjson and its APIs to parse JSON: https://github.com/simdjson/simdjson/blob/master/doc/basics.md
-* Builder is an overview of how to use simdjson to generate JSON: https://github.com/simdjson/simdjson/blob/master/doc/builder.md
+* Basics is an overview of how to use simdjson and its APIs: https://github.com/simdjson/simdjson/blob/master/doc/basics.md
 * Performance shows some more advanced scenarios and how to tune for them: https://github.com/simdjson/simdjson/blob/master/doc/performance.md
 * Contributing: https://github.com/simdjson/simdjson/blob/master/CONTRIBUTING.md
-* We follow the [JSON specification as described by RFC 8259](https://www.rfc-editor.org/rfc/rfc8259.txt) (T. Bray, 2017). If you wish to support features that are not part of RFC 8259, then you should not refer to your issue as a bug.
+* We follow the [JSON specification as described by RFC 8259](https://www.rfc-editor.org/rfc/rfc8259.txt) (T. Bray, 2017).


 **Describe the bug**
-A clear and concise description of what the bug is. A bug is a failure to build with normal compiler settings or a misbehaviour: when running the code, you get a result that differs from the expected result from our documentation.
+A clear and concise description of what the bug is.

-A compiler or static-analyzer warning is not a bug. It is possible with tools such as Visual Studio to require that rarely enabled warnings are considered errors. Do not report such cases as bugs. We do accept pull requests if you want to silence warnings issued by code analyzers, however.
-
-We are committed to providing good documentation. We accept the lack of documentation or a misleading documentation as a bug (a 'documentation bug').
-
-An unexpected poor software performance can be accepted as a bug (a 'performance bug').
-
-We accept the identification of an issue by a sanitizer or some checker tool (e.g., valgrind) as a bug, but you must first ensure that it is not a false positive.
-
-We recommend that you run your tests using different optimization levels. In particular, we recommend your run tests with the simdjson library and you code compiled in debug mode. The simdjson then sets the SIMDJSON_DEVELOPMENT_CHECKS macro to 1, and this triggers additional checks on your code and on the internals of the library. If possible, we recommend that you run tests with sanitizers (e.g., see [No more leaks with sanitize flags in gcc and clang](https://lemire.me/blog/2016/04/20/no-more-leaks-with-sanitize-flags-in-gcc-and-clang/)).  You can compile the library with sanitizers for debugging purposes (e.g., set SIMDJSON_SANITIZE to ON using CMake), but you should also turn on sanitizers on your own code. You may also use tools like valgrind or the commercial equivalent.
-
-Before reporting a bug, please ensure that you have read our documentation.
+Note that a compiler warning is not a bug.

 **To Reproduce**
-Steps to reproduce the behaviour: provide a code sample if possible. Please provide a complete test with data. Remember that a bug is either a failure to build or an unexpected result when running the code.
+Steps to reproduce the behaviour: provide a code sample if possible.

-If we cannot reproduce the issue, then we cannot address it. Note that a stack trace from your own program is not enough. A sample of your source code is insufficient: please provide a complete test for us to reproduce the issue. Please reduce the issue: use as small and as simple an example of the bug as possible.
+If we cannot reproduce the issue, then we cannot address it.

-It should be possible to trigger the bug by using solely simdjson with our default build setup. If you can only observe the bug within some specific context, with some other software, please reduce the issue first.
+Note that a stack trace from your own program is not enough.

-**simdjson release**
-
-Unless you plan to contribute to simdjson, you should only work from releases. Please be mindful that our main branch may have additional features, bugs and documentation items.
-
-It is fine to report bugs against our main branch, but if that is what you are doing, please be explicit.
-
-**Configuration (please complete the following information if relevant)**
+**Configuration (please complete the following information if relevant):**
 - OS: [e.g. Ubuntu 16.04.6 LTS]
- - Compiler* [e.g. Apple clang version 11.0.3 (clang-1103.0.32.59) x86_64-apple-darwin19.4.0]
+ - Compiler [e.g. Apple clang version 11.0.3 (clang-1103.0.32.59) x86_64-apple-darwin19.4.0]
 - Version [e.g. 22]
- - Optimization setting (e.g., -O3)

-We support up-to-date 64-bit ARM and x64 FreeBSD, macOS, Windows and Linux systems. Please ensure that your configuration is supported before labelling the issue as a bug.
-
-* We do not support unreleased or experimental compilers. If you encounter an issue with a
-pre-release version of a compiler, do not report it as a bug to simdjson. However, we always
-invite contributions either in the form an analysis or of a code contribution.
-
-Under Windows, we support Visual Studio (both with LLVM and without). We do not support MinGW and other alternate compiler systems. Windows users should be aware that there [is a long-running bug with GCC under Windows](https://gcc.gnu.org/bugzilla/show_bug.cgi?id=54412).
+We support up-to-date 64-bit ARM and x64 FreeBSD, macOS, Windows and Linux systems. Please ensure that your configuration is supported before labelling the issue as a bug. In particular, we do not support legacy 32-bit systems.

 **Indicate whether you are willing or able to provide a bug fix as a pull request**

-If you plan to contribute to simdjson, please read our guide:
+If you plan to contribute to simdjson, please read our
 * CONTRIBUTING guide: https://github.com/simdjson/simdjson/blob/master/CONTRIBUTING.md and our
 * HACKING guide: https://github.com/simdjson/simdjson/blob/master/HACKING.md
@@ -1 +0,0 @@
-blank_issues_enabled: false
@@ -9,8 +9,7 @@ assignees: ''

 Before submitting an issue, please ensure that you have read the documentation:

-* Basics is an overview of how to use simdjson and its APIs to parse JSON: https://github.com/simdjson/simdjson/blob/master/doc/basics.md
-* Builder is an overview of how to use simdjson to generate JSON: https://github.com/simdjson/simdjson/blob/master/doc/builder.md
+* Basics is an overview of how to use simdjson and its APIs: https://github.com/simdjson/simdjson/blob/master/doc/basics.md
 * Performance shows some more advanced scenarios and how to tune for them: https://github.com/simdjson/simdjson/blob/master/doc/performance.md
 * Contributing: https://github.com/simdjson/simdjson/blob/master/CONTRIBUTING.md
 * We follow the [JSON specification as described by RFC 8259](https://www.rfc-editor.org/rfc/rfc8259.txt) (T. Bray, 2017).
@@ -32,7 +31,7 @@ A clear and concise description of any alternative solutions or features you've
 **Additional context**
 Add any other context or screenshots about the feature request here.

-**Are you willing to contribute code or documentation toward this new feature?**
+** Are you willing to contribute code or documentation toward this new feature? **
 If you plan to contribute to simdjson, please read our
 * CONTRIBUTING guide: https://github.com/simdjson/simdjson/blob/master/CONTRIBUTING.md and our
 * HACKING guide: https://github.com/simdjson/simdjson/blob/master/HACKING.md
@@ -9,8 +9,7 @@ assignees: ''

 Before submitting an issue, please ensure that you have read the documentation:

-* Basics is an overview of how to use simdjson and its APIs to parse JSON: https://github.com/simdjson/simdjson/blob/master/doc/basics.md
-* Builder is an overview of how to use simdjson to generate JSON: https://github.com/simdjson/simdjson/blob/master/doc/builder.md
+* Basics is an overview of how to use simdjson and its APIs: https://github.com/simdjson/simdjson/blob/master/doc/basics.md
 * Performance shows some more advanced scenarios and how to tune for them: https://github.com/simdjson/simdjson/blob/master/doc/performance.md
 * Contributing: https://github.com/simdjson/simdjson/blob/master/CONTRIBUTING.md
 * We follow the [JSON specification as described by RFC 8259](https://www.rfc-editor.org/rfc/rfc8259.txt) (T. Bray, 2017).
@@ -19,7 +18,7 @@ We do not make changes to simdjson without clearly identifiable benefits, which

 Is your issue:

-1. A bug report? If so, please point at a reproducible test. Indicate whether you are willing or able to provide a bug fix as a pull request. As a matter of policy, we do not consider a compiler warning to be a bug.
+1. A bug report? If so, please point at a reproducible test. Indicate whether you are willing or able to provide a bug fix as a pull request.

 2. A build issue? If so, provide all possible details regarding your system configuration. If we cannot reproduce your issue, we cannot fix it.

@@ -1,53 +1,8 @@
-Short title (summary):
-
-Description
- What did you change and why? (1-3 sentences)
- Issue reproduced / related issue: link the issue if relevant (e.g. #123)
-
-Type of change
- [ ] Bug fix
- [ ] New feature
- [ ] Refactor / cleanup
- [ ] Documentation / tests
- [ ] Other (please describe):
-
-How to verify / test
- Add additional tests to verify bugs or new features.
- If you claim performance gains, you should provide benchmark numbers using high quality benchmarking code.


-Please read before contributing:
- CONTRIBUTING: https://github.com/simdjson/simdjson/blob/master/CONTRIBUTING.md
- HACKING: https://github.com/simdjson/simdjson/blob/master/HACKING.md
+Our tests check whether you have introduced trailing white space. If such a test fails, please check the "artifacts button" above, which if you click it gives a link to a downloadable file to help you identify the issue. You can also run scripts/remove_trailing_whitespace.sh locally if you have a bash shell and the sed command available on your system.

+If you plan to contribute to simdjson, please read our

-
-If you can, we recommend running our tests with the sanitizers turned on.
-For non-Visual Studio users, it is as easy as doing:
-
-
-
-```bash
-cmake -B build -D SIMDJSON_SANITIZE=ON -D SIMDJSON_DEVELOPER_MODE=ON
-cmake --build build
-ctest --test-dir build
-```
-
-
-Our CI checks, among other things, for trailing whitespace. If a test fails for that reason,
-use the "artifacts" button to download the artifact and inspect the problematic lines,
-or run `scripts/remove_trailing_whitespace.sh` locally if you have a bash shell and `sed`.
-
-
-Checklist before submitting
- [ ] I added/updated tests covering my change (if applicable)
- [ ] Code builds locally and passes my check
- [ ] Documentation / README updated if needed
- [ ] Commits are atomic and messages are clear
- [ ] I linked the related issue (if applicable)
-
-Final notes
- For large PRs, prefer smaller incremental PRs or request staged review.
-
-Thanks for the contribution!
-
+CONTRIBUTING guide: https://github.com/simdjson/simdjson/blob/master/CONTRIBUTING.md and our
+HACKING guide: https://github.com/simdjson/simdjson/blob/master/HACKING.md
@@ -1,29 +0,0 @@
-name: Ubuntu aarch64 (GCC 13)
-
-on:
-  push:
-    branches:
-      - master
-  pull_request:
-    branches:
-      - master
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: uraimo/run-on-arch-action@v3
-        name: Test
-        id: runcmd
-        with:
-          arch: aarch64
-          distro: ubuntu_latest
-          githubToken: ${{ github.token }}
-          install: |
-            apt-get update -q -y
-            apt-get install -y cmake make g++
-          run: |
-            cmake -DSIMDJSON_SANITIZE_UNDEFINED=ON -DSIMDJSON_DEVELOPER_MODE=ON -DSIMDJSON_COMPETITION=OFF -B build
-            cmake --build build -j=2
-            ctest --output-on-failure --test-dir build
@@ -1,6 +1,12 @@
 name: Alpine Linux

-on: [push, pull_request]
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master

 jobs:
  ubuntu-build:
@@ -9,8 +15,8 @@ jobs:
      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/cache@v4
+      - uses: actions/checkout@v2
+      - uses: actions/cache@v2
        with:
          path: dependencies/.cache
          key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
@@ -25,10 +31,10 @@ jobs:
          ./alpine.sh apk add build-base cmake g++ linux-headers git bash
      - name: cmake
        run: |
-          ./alpine.sh cmake -DSIMDJSON_DEVELOPER_MODE=ON -B build_for_alpine
+          ./alpine.sh cmake -B build_for_alpine
      - name: build
        run: |
          ./alpine.sh cmake --build build_for_alpine
      - name: test
        run: |
-          ./alpine.sh bash -c "cd build_for_alpine && ctest  -LE explicitonly --output-on-failure"
+          ./alpine.sh bash -c "cd build_for_alpine && ctest  -LE explicitonly"
@@ -1,24 +0,0 @@
-name: CIFuzz
-on: [pull_request]
-jobs:
-  Fuzzing:
-    runs-on: ubuntu-latest
-    steps:
-    - name: Build Fuzzers
-      id: build
-      uses: google/oss-fuzz/infra/cifuzz/actions/build_fuzzers@master
-      with:
-        oss-fuzz-project-name: 'simdjson'
-        dry-run: false
-    - name: Run Fuzzers
-      uses: google/oss-fuzz/infra/cifuzz/actions/run_fuzzers@master
-      with:
-        oss-fuzz-project-name: 'simdjson'
-        fuzz-seconds: 600
-        dry-run: false
-    - name: Upload Crash
-      uses: actions/upload-artifact@v4
-      if: failure() && steps.build.outcome == 'success'
-      with:
-        name: artifacts
-        path: ./out/artifacts
@@ -1,33 +0,0 @@
-name: Debian
-
-on: [push, pull_request]
-
-defaults:
-  run:
-    shell: sh
-
-permissions:
-  contents: read
-
-jobs:
-  pkg-config:
-    runs-on: ubuntu-latest
-    container:
-      image: debian:testing
-
-    steps:
-    - uses: actions/checkout@v4
-
-    - name: Install dependencies
-      run: |
-        apt -y update
-        apt -y --no-install-recommends install g++ cmake make pkg-config
-
-    - name: Build and install
-      run: |
-        cmake -B build
-        cmake --build build
-        cmake --install build
-
-    - name: Test pkg-config
-      run: g++ examples/quickstart/quickstart.cpp $(pkg-config --cflags --libs simdjson)
@@ -1,39 +0,0 @@
-name: Doxygen GitHub Pages
-
-on:
-  release:
-    # Trigger when a release object is created and when it's published.
-    # Some GitHub flows create a release object then publish it later; include both.
-    types: [created, published]
-  # Also trigger on tag creation pushes so releasing via Git tags still runs the workflow
-  push:
-    tags:
-      - "v*"  # common release tag pattern like v1.2.3
-  # Allows you to run this workflow manually from the Actions tab
-  workflow_dispatch:
-
-permissions:
-  contents: write
-  pages: write
-  id-token: write
-
-jobs:
-  deploy:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: Install Doxygen
-        run: sudo apt-get install doxygen graphviz -y
-      - run: mkdir docs
-      - name: Install theme
-        run: ./tools/prepare_doxygen.sh
-      - name: Generate Doxygen Documentation
-        run: doxygen
-      - name: Deploy to GitHub Pages
-        uses: peaceiris/actions-gh-pages@v4
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: doc/api/html
@@ -1,17 +0,0 @@
-on: [push, pull_request]
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
-      - uses: actions/setup-node@49933ea5288caeca8642d1e84afbd3f7d6820020 # v4.4.0
-      - uses: mymindstorm/setup-emsdk@6ab9eb1bda2574c4ddb79809fc9247783eaf9021 # v14
-      - name: Verify
-        run: emcc -v
-      - name: Checkout
-        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v3.6.0
-      - name: Configure
-        run: emcmake cmake -B build
-      - name: Build # We build but do not test
-        run: cmake --build build
@@ -1,12 +1,15 @@
 name: Detect trailing whitespace

-on: [push, pull_request]
+on:
+  pull_request:
+    branches:
+      - master

 jobs:
  whitespace:
-    runs-on: ubuntu-24.04
+    runs-on: ubuntu-20.04
    steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v2
      - name: Remove whitespace and check the diff
        run: |
          set -eu
@@ -24,7 +27,7 @@ jobs:
             echo "no trailing whitespace found, good!"
          fi
      - name: Archive whitespace patch
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v2
        if: always()
        with:
          name: whitespace-patch
@@ -24,7 +24,7 @@ jobs:
      implementations: haswell westmere fallback
      UBSAN_OPTIONS: halt_on_error=1
      MAXLEN: -max_len=4000
-      CLANGVERSION: 19
+      CLANGVERSION: 11
      # which optimization level to use for the sanitizer build (see build_fuzzer.variants.sh)
      OPTLEVEL: -O3

@@ -32,31 +32,18 @@ jobs:
    - name: Install packages necessary for building
      run: |
        sudo apt update
-        sudo apt-get install --quiet ninja-build valgrind zip unzip lsb-release wget software-properties-common gnupg
+        sudo apt-get install --quiet ninja-build valgrind zip unzip
        wget https://apt.llvm.org/llvm.sh
-        sudo apt-get purge --auto-remove llvm python3-lldb-15 llvm-15
        chmod +x llvm.sh
        sudo ./llvm.sh $CLANGVERSION

-    - uses: actions/checkout@v4
+    - uses: actions/checkout@v1

-    - uses: actions/cache@v4
+    - uses: actions/cache@v2
      with:
        path: dependencies/.cache
        key: ${{ hashFiles('dependencies/CMakeLists.txt') }}

-    - uses: actions/cache@v4
-      id: cache-corpus
-      with:
-        path: out/
-        key: corpus-${{ github.run_id }}
-        restore-keys: corpus-
-
-    - name: show statistics for the cached corpus
-      run: |
-        echo number of files in github action corpus cache:
-        find out -type f |wc -l
-
    - name: Create and prepare the initial seed corpus
      run: |
        fuzz/build_corpus.sh
@@ -64,6 +51,12 @@ jobs:
        mkdir seedcorpus
        unzip -q -d seedcorpus seed_corpus.zip

+    - name: Download the corpus from the last run
+      run: |
+        wget --quiet https://dl.bintray.com/pauldreik/simdjson-fuzz-corpus/corpus/corpus.tar
+        tar xf corpus.tar
+        rm corpus.tar
+
    - name: List clang versions
      run: |
        ls /usr/bin/clang*
@@ -77,7 +70,7 @@ jobs:
      run: |
        set -eux
        for fuzzer in $defaultimplfuzzers $implfuzzers; do
-          mkdir -p out/$fuzzer # in case this is a new fuzzer, or the github action cached corpus is broken
+          mkdir -p out/$fuzzer # in case this is a new fuzzer, or corpus.tar is broken
          # get input from everyone else (corpus cross pollination)
          others=$(find out -type d -not -name $fuzzer -not -name out -not -name cmin)
          build-fast/fuzz/fuzz_$fuzzer out/$fuzzer $others seedcorpus -max_total_time=30 $MAXLEN
@@ -93,7 +86,7 @@ jobs:
            export SIMDJSON_FORCE_IMPLEMENTATION=$implementation
            build-sanitizers$OPTLEVEL/fuzz/fuzz_$fuzzer out/$fuzzer $others seedcorpus -max_total_time=20 $MAXLEN
          done
-          echo now have $(ls out/$fuzzer |wc -l) files in corpus
+          echo now have $(ls out/$fuzzer |wc -l) files in corpus        
        done

    - name: Fuzz differential impl. fuzzers with sanitizer+asserts (good at detecting errors)
@@ -120,21 +113,16 @@ jobs:

    - name: Package the corpus into an artifact
      run: |
-        for fuzzer in $defaultimplfuzzers $implfuzzers; do
+        for fuzzer in $defaultimplfuzzers $implfuzzers; do      
          tar rf corpus.tar out/$fuzzer
        done

    - name: Save the corpus as a github artifact
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v2
      with:
        name: corpus
        path: corpus.tar

-    - name: Store the corpus externally
-      run: |
-        gzip --keep corpus.tar
-        curl -F"filedata=@corpus.tar.gz" https://simdjson:${{ secrets.fuzzdatapassword }}@www.pauldreik.se/fuzzdata/index.php
-
    # This takes a subset of the minimized corpus and run it through valgrind. It is slow,
    # therefore take a "random" subset. The random selection is accomplished by sorting on filenames,
    # which are hashes of the content.
@@ -142,21 +130,30 @@ jobs:
      run: |
        for fuzzer in $defaultimplfuzzers $implfuzzers; do
          find out/$fuzzer -type f |sort|head -n200|xargs -n40 valgrind build-replay/fuzz/fuzz_$fuzzer 2>&1|tee valgrind-$fuzzer.txt
-        done
+        done 

    - name: Compress the valgrind output
      run: tar cf valgrind.tar valgrind-*.txt

    - name: Save valgrind output as a github artifact
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v2
      if: always()
      with:
        name: valgrindresults
        path: valgrind.tar
        if-no-files-found: ignore

+    - name: Upload the corpus and results to bintray if we are on master
+      if: ${{ github.event_name == 'schedule' }} 
+      run: |
+        echo uploading each artifact twice, otherwise it will not be published
+        curl -T corpus.tar -upauldreik:${{ secrets.bintrayApiKey }} https://api.bintray.com/content/pauldreik/simdjson-fuzz-corpus/corpus/0/corpus/corpus.tar";publish=1;override=1"
+        curl -T corpus.tar -upauldreik:${{ secrets.bintrayApiKey }} https://api.bintray.com/content/pauldreik/simdjson-fuzz-corpus/corpus/0/corpus/corpus.tar";publish=1;override=1"
+        curl -T valgrind.tar -upauldreik:${{ secrets.bintrayApiKey }} https://api.bintray.com/content/pauldreik/simdjson-fuzz-corpus/corpus/0/corpus/valgrind.tar";publish=1;override=1"
+        curl -T valgrind.tar -upauldreik:${{ secrets.bintrayApiKey }} https://api.bintray.com/content/pauldreik/simdjson-fuzz-corpus/corpus/0/corpus/valgrind.tar";publish=1;override=1"
+
    - name: Archive any crashes as an artifact
-      uses: actions/upload-artifact@v4
+      uses: actions/upload-artifact@v2
      if: always()
      with:
        name: crashes
@@ -1,50 +0,0 @@
-name: LoongArch64-CI
-
-on: [push, pull_request]
-
-jobs:
-  loongarch64:
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        platform:
-          - { toolchain-version: 2023.08.08 }
-    steps:
-      - uses: actions/checkout@v4
-      - name: Install build requirements
-        run: |
-          sudo apt-get update -y
-          sudo apt-get install -y --no-install-recommends cmake
-
-      - uses: actions/cache/restore@v4
-        id: restore-cache
-        with:
-          path: /opt/cross-tools
-          key: loongarch64-${{ matrix.platform.toolchain-version }}
-
-      - name: Download LoongArch64 gcc+glibc toolchain
-        if: ${{ !steps.restore-cache.outputs.cache-hit }}
-        run: |
-          url="https://github.com/loongson/build-tools/releases/download/${{ matrix.platform.toolchain-version }}/x86_64-cross-tools-loongarch64-gcc-libc.tar.xz"
-
-          wget "$url" -O /tmp/toolchain.tar.xz
-
-          mkdir -p /opt
-          tar -C /opt -x -f /tmp/toolchain.tar.xz
-
-      - uses: actions/cache/save@v3
-        if: ${{ !steps.restore-cache.outputs.cache-hit }}
-        with:
-          path: /opt/cross-tools
-          key: loongarch64-${{ matrix.platform.toolchain-version }}
-
-      - name: setup Loongarch64 build environment
-        run: |
-          echo "/opt/cross-tools/bin" >> $GITHUB_PATH
-          echo "CC=loongarch64-unknown-linux-gnu-gcc" >> $GITHUB_ENV
-          echo "CXX=loongarch64-unknown-linux-gnu-g++" >> $GITHUB_ENV
-      - name: configure
-        run: cmake -B build -DCMAKE_SYSTEM_PROCESSOR=loongarch64 -DARCH=lonngarch64 -DCMAKE_SYSTEM_NAME=Linux -DCMAKE_C_COMPILER=loongarch64-unknown-linux-gnu-gcc -DCMAKE_CXX_COMPILER=loongarch64-unknown-linux-gnu-g++
-      - name: build
-        run: cmake --build build
@@ -1,44 +0,0 @@
-name: Macos
-
-on: [push, pull_request]
-
-jobs:
-  macos-build:
-    if: >-
-      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
-      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
-    runs-on: macos-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/cache@v4
-        with:
-          path: dependencies/.cache
-          key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
-      - name: Use cmake
-        run: |
-          mkdir builddebug &&
-          cd builddebug &&
-          cmake -DCMAKE_BUILD_TYPE=Debug -DSIMDJSON_GOOGLE_BENCHMARKS=OFF -DSIMDJSON_DEVELOPER_MODE=ON -DBUILD_SHARED_LIBS=OFF ..  &&
-          cmake --build .   &&
-          ctest --output-on-failure -LE explicitonly -j   &&
-          cd .. &&
-          mkdir build &&
-          cd build &&
-          cmake  -DSIMDJSON_GOOGLE_BENCHMARKS=ON -DSIMDJSON_DEVELOPER_MODE=ON -DBUILD_SHARED_LIBS=OFF -DCMAKE_INSTALL_PREFIX:PATH=destination ..  &&
-          cmake --build .   &&
-          ctest --output-on-failure -LE explicitonly -j   &&
-          cmake --install . &&
-          echo -e '#include <simdjson.h>\nint main(int argc,char**argv) {simdjson::dom::parser parser;simdjson::dom::element tweets = parser.load(argv[1]); }' > tmp.cpp && c++ -Idestination/include -Ldestination/lib -std=c++17 -Wl,-rpath,destination/lib -o linkandrun tmp.cpp -lsimdjson && ./linkandrun jsonexamples/twitter.json &&
-          cd ../tests/installation_tests/find &&
-          mkdir build && cd build && cmake -DCMAKE_INSTALL_PREFIX:PATH=../../../build/destination .. &&  cmake --build .
-      - name: Use cmake (shared)
-        run: |
-          mkdir buildshared &&
-          cd buildshared &&
-          cmake  -DSIMDJSON_GOOGLE_BENCHMARKS=ON -DSIMDJSON_DEVELOPER_MODE=ON -DBUILD_SHARED_LIBS=ON -DCMAKE_INSTALL_PREFIX:PATH=destination ..  &&
-          cmake --build .   &&
-          ctest --output-on-failure -LE explicitonly -j   &&
-          cmake --install . &&
-          echo -e '#include <simdjson.h>\nint main(int argc,char**argv) {simdjson::dom::parser parser;simdjson::dom::element tweets = parser.load(argv[1]); }' > tmp.cpp && c++ -Idestination/include -Ldestination/lib -std=c++17 -Wl,-rpath,destination/lib -o linkandrun tmp.cpp -lsimdjson && ./linkandrun jsonexamples/twitter.json &&
-          cd ../tests/installation_tests/find &&
-          mkdir buildshared && cd buildshared && cmake -DCMAKE_INSTALL_PREFIX:PATH=../../../buildshared/destination .. &&  cmake --build .
@@ -0,0 +1,68 @@
+name: MinGW32-CI
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+# Important: scoop will either install 32-bit GCC or 64-bit GCC, not both.
+
+# It is important to build static libraries because cmake is not smart enough under Windows/mingw to take care of the path. So
+# with a dynamic library, you could get failures due to the fact that the EXE can't find its DLL.
+
+jobs:
+  ci:
+    if: >-
+      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
+      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
+    name: windows-gcc
+    runs-on: windows-2016
+
+    env:
+      CMAKE_GENERATOR: Ninja # This is critical, try ' cmake  -GNinja-DSIMDJSON_BUILD_STATIC=ON .. ' if using the command line
+      CC: gcc
+      CXX: g++
+
+    steps: # To reproduce what is below, start a powershell with administrative rights, using scoop *is* a good idea
+      - uses: actions/checkout@v2
+
+      - uses: actions/cache@v2 # we cache the scoop setup with 32-bit GCC
+        id: cache
+        with:
+          path: |
+            C:\ProgramData\scoop
+          key: scoop32 # static key: should be good forever
+
+      - uses: actions/cache@v2
+        with:
+          path: dependencies/.cache
+          key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
+
+      - name: Setup Windows # This should almost never run if the cache works.
+        if: steps.cache.outputs.cache-hit != 'true'
+        shell: powershell
+        run: |
+          Invoke-Expression (New-Object System.Net.WebClient).DownloadString('https://get.scoop.sh')
+          scoop install sudo --global
+          sudo scoop install git --global 
+          sudo scoop install ninja --global
+          sudo scoop install cmake --global
+          sudo scoop install gcc --arch 32bit --global
+          $env:path
+          Write-Host 'Everything has been installed, you are good!'
+      - name: Build and Test 32-bit x86
+        shell: powershell
+        run: |
+          $ENV:PATH="C:\ProgramData\scoop\shims;C:\ProgramData\scoop\apps\gcc\current\bin;C:\ProgramData\scoop\apps\ninja\current;$ENV:PATH"
+          g++ --version
+          cmake --version
+          ninja --version
+          git --version
+          mkdir build32
+          cd build32
+          cmake -DSIMDJSON_BUILD_STATIC=ON -DSIMDJSON_COMPETITION=OFF -DSIMDJSON_GOOGLE_BENCHMARKS=OFF -DSIMDJSON_ENABLE_THREADS=OFF ..
+          cmake --build . --target acceptance_tests --verbose
+          ctest -L acceptance --output-on-failure
@@ -0,0 +1,74 @@
+name: MinGW64-CI
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+# Important: scoop will either install 32-bit GCC or 64-bit GCC, not both.
+
+# It is important to build static libraries because cmake is not smart enough under Windows/mingw to take care of the path. So
+# with a dynamic library, you could get failures due to the fact that the EXE can't find its DLL.
+
+jobs:
+  ci:
+    if: >-
+      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
+      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
+    name: windows-gcc
+    runs-on: windows-2016
+
+    env:
+      CMAKE_GENERATOR: Ninja # This is critical, try ' cmake  -GNinja-DSIMDJSON_BUILD_STATIC=ON .. ' if using the command line
+      CC: gcc
+      CXX: g++
+
+    steps: # To reproduce what is below, start a powershell with administrative rights, using scoop *is* a good idea
+      - uses: actions/checkout@v2
+
+      - uses: actions/cache@v2 # we cache the scoop setup with 64-bit GCC
+        id: cache
+        with:
+          path: |
+            C:\ProgramData\scoop
+          key: scoop64 # static key: should be good forever
+
+      - uses: actions/cache@v2
+        with:
+          path: dependencies/.cache
+          key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
+
+      - name: Setup Windows # This should almost never run if the cache works.
+        if: steps.cache.outputs.cache-hit != 'true'
+        shell: powershell
+        run: |
+          Invoke-Expression (New-Object System.Net.WebClient).DownloadString('https://get.scoop.sh')
+          scoop install sudo --global
+          sudo scoop install git --global
+          sudo scoop install ninja --global
+          sudo scoop install cmake --global
+          sudo scoop install gcc --arch 64bit --global
+          $env:path
+          Write-Host 'Everything has been installed, you are good!'
+      - name: Build and Test 64-bit x64
+        shell: powershell
+        run: |
+          $ENV:PATH="C:\ProgramData\scoop\shims;C:\ProgramData\scoop\apps\gcc\current\bin;C:\ProgramData\scoop\apps\ninja\current;$ENV:PATH"
+          g++ --version
+          cmake --version
+          ninja --version
+          git --version
+          mkdir build64
+          cd build64
+          cmake -DSIMDJSON_BUILD_STATIC=ON -DSIMDJSON_COMPETITION=OFF -DSIMDJSON_GOOGLE_BENCHMARKS=OFF -DSIMDJSON_ENABLE_THREADS=OFF ..
+          cmake --build . --target acceptance_tests --verbose
+          ctest -L acceptance --output-on-failure
+          cd ..
+          mkdir build64debug
+          cd build64debug
+          cmake -DCMAKE_BUILD_TYPE=Debug -DSIMDJSON_BUILD_STATIC=ON -DSIMDJSON_COMPETITION=OFF -DSIMDJSON_GOOGLE_BENCHMARKS=OFF -DSIMDJSON_ENABLE_THREADS=OFF ..
+          cmake --build . --target acceptance_tests --verbose
+          ctest -L acceptance --output-on-failure
@@ -1,7 +1,12 @@
 name: MSYS2-CLANG-CI

-on: [push, pull_request]
-
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master

 jobs:
  windows-mingw:
@@ -15,20 +20,23 @@ jobs:
      matrix:
        include:
          - msystem: "MINGW64"
-            install: mingw-w64-x86_64-libxml2 mingw-w64-x86_64-cmake mingw-w64-x86_64-ninja mingw-w64-x86_64-clang
+            install: mingw-w64-x86_64-cmake mingw-w64-x86_64-ninja mingw-w64-x86_64-clang
+            type: Release
+          - msystem: "MINGW32"
+            install: mingw-w64-i686-cmake mingw-w64-i686-ninja mingw-w64-i686-clang
            type: Release
          - msystem: "MINGW64"
-            install: mingw-w64-x86_64-libxml2 mingw-w64-x86_64-cmake mingw-w64-x86_64-ninja mingw-w64-x86_64-clang
+            install: mingw-w64-x86_64-cmake mingw-w64-x86_64-ninja mingw-w64-x86_64-clang
+            type: Debug
+          - msystem: "MINGW32"
+            install: mingw-w64-i686-cmake mingw-w64-i686-ninja mingw-w64-i686-clang
            type: Debug
-          - msystem: "MINGW64"
-            install: mingw-w64-x86_64-libxml2 mingw-w64-x86_64-cmake mingw-w64-x86_64-ninja mingw-w64-x86_64-clang
-            type: RelWithDebInfo
    env:
      CMAKE_GENERATOR: Ninja

    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/cache@v4
+      - uses: actions/checkout@v2
+      - uses: actions/cache@v2
        with:
          path: dependencies/.cache
          key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
@@ -41,6 +49,6 @@ jobs:
        run: |
          mkdir build
          cd build
-          cmake -DSIMDJSON_DEVELOPER_MODE=ON -DCMAKE_CXX_COMPILER=clang++ -DCMAKE_BUILD_TYPE=${{ matrix.type }} -DBUILD_SHARED_LIBS=OFF -DSIMDJSON_DO_NOT_USE_THREADS_NO_MATTER_WHAT=ON ..
+          cmake -DCMAKE_CXX_COMPILER=clang++ -DCMAKE_BUILD_TYPE=${{ matrix.type }} -DSIMDJSON_BUILD_STATIC=ON -DSIMDJSON_DO_NOT_USE_THREADS_NO_MATTER_WHAT=ON ..
          cmake --build . --verbose
          ctest -j4 --output-on-failure -LE explicitonly
@@ -1,6 +1,12 @@
 name: MSYS2-CI

-on: [push, pull_request]
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master

 jobs:
  windows-mingw:
@@ -19,18 +25,21 @@ jobs:
          - msystem: "MINGW64"
            install: mingw-w64-x86_64-cmake mingw-w64-x86_64-ninja mingw-w64-x86_64-gcc
            type: Release
+          - msystem: "MINGW32"
+            install: mingw-w64-i686-cmake mingw-w64-i686-ninja mingw-w64-i686-gcc
+            type: Release
          - msystem: "MINGW64"
            install: mingw-w64-x86_64-cmake mingw-w64-x86_64-ninja mingw-w64-x86_64-gcc
            type: Debug
-          - msystem: "MINGW64"
-            install: mingw-w64-x86_64-cmake mingw-w64-x86_64-ninja mingw-w64-x86_64-gcc
-            type: RelWithDebInfo
+          - msystem: "MINGW32"
+            install: mingw-w64-i686-cmake mingw-w64-i686-ninja mingw-w64-i686-gcc
+            type: Debug
    env:
      CMAKE_GENERATOR: Ninja

    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/cache@v4
+      - uses: actions/checkout@v2
+      - uses: actions/cache@v2
        with:
          path: dependencies/.cache
          key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
@@ -43,6 +52,6 @@ jobs:
        run: |
          mkdir build
          cd build
-          cmake -DSIMDJSON_DEVELOPER_MODE=ON -DCMAKE_BUILD_TYPE=${{ matrix.type }} -DBUILD_SHARED_LIBS=OFF -DSIMDJSON_DO_NOT_USE_THREADS_NO_MATTER_WHAT=ON ..
+          cmake -DCMAKE_BUILD_TYPE=${{ matrix.type }} -DSIMDJSON_BUILD_STATIC=ON -DSIMDJSON_DO_NOT_USE_THREADS_NO_MATTER_WHAT=ON ..
          cmake --build . --verbose
          ctest -j4 --output-on-failure -LE explicitonly
@@ -0,0 +1,65 @@
+name: short fuzz on the power arch
+
+on:
+  push:
+    branches: [ master ]
+  pull_request:
+    branches: [ master ]
+
+jobs:
+  armv7_job:
+    if: >-
+      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
+      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
+    # The host should always be Linux
+    runs-on: ubuntu-20.04
+    name: Build on ubuntu-20.04 ppc64le
+    steps:
+      - uses: actions/checkout@v2.1.0
+      - uses: uraimo/run-on-arch-action@v2.0.5
+        name: Run commands
+        id: runcmd
+        env:
+          DEBIAN_FRONTEND: noninteractive
+        with:
+          arch: ppc64le
+          distro: buster
+
+          # Not required, but speeds up builds by storing container images in
+          # a GitHub package registry.
+          githubToken: ${{ github.token }}
+
+          run: |
+            export CLANGSUFFIX="-7"
+            apt-get -qq update
+            apt-get install -q -y clang-7 libfuzzer-7-dev cmake git wget zip ninja-build
+            mkdir -p build ; cd build
+            cmake .. -GNinja \
+                  -DCMAKE_CXX_COMPILER=clang++$CLANGSUFFIX \
+                  -DCMAKE_C_COMPILER=clang$CLANGSUFFIX \
+                  -DSIMDJSON_BUILD_STATIC=Off \
+                  -DENABLE_FUZZING=On \
+                  -DSIMDJSON_COMPETITION=OFF \
+                  -DSIMDJSON_GOOGLE_BENCHMARKS=OFF \
+                  -DSIMDJSON_DISABLE_DEPRECATED_API=On \
+                  -DSIMDJSON_FUZZ_LDFLAGS=-lFuzzer \
+                  -DCMAKE_CXX_FLAGS="-fsanitize=fuzzer-no-link -DFUZZING_BUILD_MODE_UNSAFE_FOR_PRODUCTION=" \
+                  -DCMAKE_C_FLAGS="-fsanitize=fuzzer-no-link" \
+                  -DCMAKE_BUILD_TYPE=Release \
+                  -DSIMDJSON_FUZZ_LINKMAIN=Off
+            cd ..
+            builddir=build
+            cmake --build $builddir
+            wget --quiet https://dl.bintray.com/pauldreik/simdjson-fuzz-corpus/corpus/corpus.tar
+            tar xf corpus.tar && rm corpus.tar
+            fuzzernames=$(cmake --build $builddir --target print_all_fuzzernames |tail -n1)
+            for fuzzer in $fuzzernames ; do
+               exe=$builddir/fuzz/$fuzzer
+               shortname=$(echo $fuzzer |cut -f2- -d_)
+               echo found fuzzer $shortname with executable $exe
+               mkdir -p out/$shortname
+               others=$(find out -type d -not -name $shortname -not -name out -not -name cmin)
+               $exe -max_total_time=20  -max_len=4000 out/$shortname $others
+               echo "*************************************************************************"
+            done
+            echo "all is good, no errors found in any of these fuzzers: $fuzzernames"
@@ -1,29 +0,0 @@
-name: Ubuntu ppc64le (GCC 11)
-
-on:
-  push:
-    branches:
-      - master
-  pull_request:
-    branches:
-      - master
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: uraimo/run-on-arch-action@v3
-        name: Test
-        id: runcmd
-        with:
-          arch: ppc64le
-          distro: ubuntu_latest
-          githubToken: ${{ github.token }}
-          install: |
-            apt-get update -q -y
-            apt-get install -y cmake make g++
-          run: |
-            cmake -DCMAKE_BUILD_TYPE=Release -DSIMDJSON_DEVELOPER_MODE=ON -DSIMDJSON_COMPETITION=OFF  -B build
-            cmake --build build -j=2
-            ctest --output-on-failure --test-dir build
@@ -1,29 +0,0 @@
-name: Ubuntu riscv64 (GCC 11)
-
-on:
-  push:
-    branches:
-      - master
-  pull_request:
-    branches:
-      - master
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: uraimo/run-on-arch-action@v3
-        name: Test
-        id: runcmd
-        with:
-          arch: riscv64
-          distro: ubuntu_latest
-          githubToken: ${{ github.token }}
-          install: |
-            apt-get update -q -y
-            apt-get install -y cmake make g++
-          run: |
-            cmake -DCMAKE_BUILD_TYPE=Release -DSIMDJSON_DEVELOPER_MODE=ON -DSIMDJSON_COMPETITION=OFF  -B build
-            cmake --build build -j=2
-            ctest --output-on-failure --test-dir build
@@ -1,29 +0,0 @@
-name: Ubuntu rvv VLEN=1024 (clang 18)
-
-on:
-  push:
-    branches:
-      - master
-  pull_request:
-    branches:
-      - master
-
-jobs:
-  build:
-    runs-on: ubuntu-24.04
-    steps:
-    - uses: actions/checkout@v4
-    - name: Install packages
-      run: |
-        sudo apt-get update -q -y
-        sudo apt-get install -y cmake make g++-riscv64-linux-gnu qemu-user-static clang-18
-    - name: Build
-      run: |
-        CXX=clang++-18 CXXFLAGS="--target=riscv64-linux-gnu -march=rv64gcv_zvbb" \
-        cmake --toolchain=cmake/toolchains-ci/riscv64-linux-gnu.cmake -DCMAKE_BUILD_TYPE=Release -B build
-        cmake --build build/ -j$(nproc)
-    - name: Test VLEN=1024
-      run: |
-        export QEMU_LD_PREFIX="/usr/riscv64-linux-gnu"
-        export QEMU_CPU="rv64,v=on,zvbb=on,vlen=1024,rvv_ta_all_1s=on,rvv_ma_all_1s=on"
-        ctest --timeout 1800 --output-on-failure --test-dir build -j $(nproc)
@@ -1,29 +0,0 @@
-name: Ubuntu rvv VLEN=128 (clang 17)
-
-on:
-  push:
-    branches:
-      - master
-  pull_request:
-    branches:
-      - master
-
-jobs:
-  build:
-    runs-on: ubuntu-24.04
-    steps:
-    - uses: actions/checkout@v4
-    - name: Install packages
-      run: |
-        sudo apt-get update -q -y
-        sudo apt-get install -y cmake make g++-riscv64-linux-gnu qemu-user-static clang-17
-    - name: Build
-      run: |
-        CXX=clang++-17 CXXFLAGS="--target=riscv64-linux-gnu -march=rv64gcv" \
-        cmake --toolchain=cmake/toolchains-ci/riscv64-linux-gnu.cmake -DCMAKE_BUILD_TYPE=Release -B build
-        cmake --build build/ -j$(nproc)
-    - name: Test VLEN=128
-      run: |
-        export QEMU_LD_PREFIX="/usr/riscv64-linux-gnu"
-        export QEMU_CPU="rv64,v=on,vlen=128,rvv_ta_all_1s=on,rvv_ma_all_1s=on"
-        ctest --timeout 1800 --output-on-failure --test-dir build -j $(nproc)
@@ -1,29 +0,0 @@
-name: Ubuntu rvv VLEN=256 (gcc 14)
-
-on:
-  push:
-    branches:
-      - master
-  pull_request:
-    branches:
-      - master
-
-jobs:
-  build:
-    runs-on: ubuntu-24.04
-    steps:
-    - uses: actions/checkout@v4
-    - name: Install packages
-      run: |
-        sudo apt-get update -q -y
-        sudo apt-get install -y cmake make g++-14-riscv64-linux-gnu qemu-user-static
-    - name: Build
-      run: |
-        CXX=riscv64-linux-gnu-g++-14 CXXFLAGS=-march=rv64gcv \
-        cmake --toolchain=cmake/toolchains-ci/riscv64-linux-gnu.cmake -DCMAKE_BUILD_TYPE=Release -B build
-        cmake --build build/ -j$(nproc)
-    - name: Test VLEN=256
-      run: |
-        export QEMU_LD_PREFIX="/usr/riscv64-linux-gnu"
-        export QEMU_CPU="rv64,v=on,zvbb=on,vlen=256,rvv_ta_all_1s=on,rvv_ma_all_1s=on"
-        ctest --timeout 1800 --output-on-failure --test-dir build -j $(nproc)
@@ -1,29 +0,0 @@
-name: Ubuntu s390x (GCC 11)
-
-on:
-  push:
-    branches:
-      - master
-  pull_request:
-    branches:
-      - master
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: uraimo/run-on-arch-action@v3
-        name: Test
-        id: runcmd
-        with:
-          arch: s390x
-          distro: ubuntu_latest
-          githubToken: ${{ github.token }}
-          install: |
-            apt-get update -q -y
-            apt-get install -y cmake make g++
-          run: |
-            cmake -DCMAKE_BUILD_TYPE=Release  -DSIMDJSON_DEVELOPER_MODE=ON -DSIMDJSON_COMPETITION=OFF -B build
-            cmake --build build -j=2
-            ctest --output-on-failure --test-dir build
@@ -0,0 +1,29 @@
+name: Performance check on Ubuntu 18.04 CI (GCC 7)
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  ubuntu-build:
+    if: >-
+      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
+      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
+    runs-on: ubuntu-18.04
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/cache@v2
+        with:
+          path: dependencies/.cache
+          key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
+      - name: Use cmake
+        run: |
+          mkdir build &&
+          cd build &&
+          cmake  -DSIMDJSON_GOOGLE_BENCHMARKS=ON -DSIMDJSON_BUILD_STATIC=ON -DCMAKE_INSTALL_PREFIX:PATH=destination ..  &&
+          cmake --build . --target checkperf  &&
+          ctest --output-on-failure -R checkperf  ubuntu18-checkperf.yml
@@ -1,16 +1,22 @@
-name: Ubuntu 22.04 CI (GCC 12) with Thread Sanitizer
+name: Ubuntu 18.04 CI (GCC 7) with Thread Sanitizer

-on: [push, pull_request]
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master

 jobs:
  ubuntu-build:
    if: >-
      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-18.04
    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/cache@v4
+      - uses: actions/checkout@v2
+      - uses: actions/cache@v2
        with:
          path: dependencies/.cache
          key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
@@ -18,7 +24,7 @@ jobs:
        run: |
          mkdir build &&
          cd build &&
-          CXX=g++-12 cmake  -DSIMDJSON_DEVELOPER_MODE=ON -DSIMDJSON_SANITIZE_THREADS=ON ..  &&
-          cmake --build . --target document_stream_tests  --target ondemand_document_stream_tests --target parse_many_test  &&
+          cmake  -DSIMDJSON_SANITIZE_THREADS=ON ..  &&
+          cmake --build . --target document_stream_tests --target parse_many_test  &&
          ctest --output-on-failure  -R parse_many_test  &&
          ctest --output-on-failure  -R document_stream_tests
@@ -0,0 +1,31 @@
+name: Ubuntu 18.04 CI (GCC 7)
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  ubuntu-build:
+    if: >-
+      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
+      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
+    runs-on: ubuntu-18.04
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/cache@v2
+        with:
+          path: dependencies/.cache
+          key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
+      - name: Use cmake
+        run: |
+          mkdir build &&
+          cd build &&
+          cmake  -DSIMDJSON_GOOGLE_BENCHMARKS=ON -DSIMDJSON_BUILD_STATIC=ON -DCMAKE_INSTALL_PREFIX:PATH=destination ..  &&
+          cmake --build .   &&
+          ctest -j --output-on-failure -LE explicitonly   &&
+          make install  &&
+          echo -e '#include <simdjson.h>\nint main(int argc,char**argv) {simdjson::dom::parser parser;simdjson::dom::element tweets = parser.load(argv[1]); }' > tmp.cpp && c++ -Idestination/include -Ldestination/lib -std=c++17 -Wl,-rpath,destination/lib -o linkandrun tmp.cpp -lsimdjson && ./linkandrun jsonexamples/twitter.json
@@ -13,10 +13,10 @@ jobs:
    if: >-
      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
-    runs-on: ubuntu-24.04
+    runs-on: ubuntu-20.04
    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/cache@v4
+      - uses: actions/checkout@v2
+      - uses: actions/cache@v2
        with:
          path: dependencies/.cache
          key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
@@ -24,6 +24,6 @@ jobs:
        run: |
          mkdir build &&
          cd build &&
-          cmake  -DSIMDJSON_DEVELOPER_MODE=ON -DSIMDJSON_ENABLE_DOM_CHECKPERF=ON -DCMAKE_CXX_FLAGS="-Werror=old-style-cast -pedantic -Wpedantic" -DSIMDJSON_GOOGLE_BENCHMARKS=ON -DBUILD_SHARED_LIBS=OFF -DCMAKE_INSTALL_PREFIX:PATH=destination ..  &&
+          cmake  -DCMAKE_CXX_FLAGS="-Werror=old-style-cast -pedantic -Wpedantic" -DSIMDJSON_GOOGLE_BENCHMARKS=ON -DSIMDJSON_BUILD_STATIC=ON -DCMAKE_INSTALL_PREFIX:PATH=destination ..  &&
          cmake --build . --target checkperf  &&
          ctest --output-on-failure -R checkperf
@@ -0,0 +1,34 @@
+name: Ubuntu 20.04 CI (GCC 9) without exceptions
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  ubuntu-build:
+    if: >-
+      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
+      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
+    runs-on: ubuntu-20.04
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/cache@v2
+        with:
+          path: dependencies/.cache
+          key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
+      - name: Use cmake
+        run: |
+          mkdir build &&
+          cd build &&
+          cmake  -DSIMDJSON_GOOGLE_BENCHMARKS=ON -DSIMDJSON_GOOGLE_BENCHMARKS=ON -DSIMDJSON_EXCEPTIONS=OFF -DSIMDJSON_BUILD_STATIC=ON -DCMAKE_INSTALL_PREFIX:PATH=destination ..  &&
+          cmake --build .   &&
+          ctest -j --output-on-failure -LE explicitonly   &&
+          make install  &&
+          echo -e '#include <simdjson.h>\nint main(int argc,char**argv) {simdjson::dom::parser parser;simdjson::dom::element tweets = parser.load(argv[1]); }' > tmp.cpp && c++ -Idestination/include -Ldestination/lib -std=c++17 -Wl,-rpath,destination/lib -o linkandrun tmp.cpp -lsimdjson && ./linkandrun jsonexamples/twitter.json &&
+          mkdir testfindpackage &&
+          cd testfindpackage &&
+          echo -e 'cmake_minimum_required(VERSION 3.1)\nproject(simdjsontester)\nset(CMAKE_CXX_STANDARD 17)\nfind_package(simdjson REQUIRED)'> CMakeLists.txt && mkdir build && cd build && cmake -DCMAKE_INSTALL_PREFIX:PATH=../destination .. &&  cmake --build .
@@ -0,0 +1,34 @@
+name: Ubuntu 20.04 CI (GCC 9) without threads
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  ubuntu-build:
+    if: >-
+      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
+      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
+    runs-on: ubuntu-20.04
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/cache@v2
+        with:
+          path: dependencies/.cache
+          key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
+      - name: Use cmake
+        run: |
+          mkdir build &&
+          cd build &&
+          cmake  -DSIMDJSON_GOOGLE_BENCHMARKS=ON -DSIMDJSON_ENABLE_THREADS=OFF -DSIMDJSON_BUILD_STATIC=ON -DCMAKE_INSTALL_PREFIX:PATH=destination ..  &&
+          cmake --build .   &&
+          ctest -j --output-on-failure -LE explicitonly   &&
+          make install  &&
+          echo -e '#include <simdjson.h>\nint main(int argc,char**argv) {simdjson::dom::parser parser;simdjson::dom::element tweets = parser.load(argv[1]); }' > tmp.cpp && c++ -Idestination/include -Ldestination/lib -std=c++17 -Wl,-rpath,destination/lib -o linkandrun tmp.cpp -lsimdjson && ./linkandrun jsonexamples/twitter.json &&
+          mkdir testfindpackage &&
+          cd testfindpackage &&
+          echo -e 'cmake_minimum_required(VERSION 3.1)\nproject(simdjsontester)\nset(CMAKE_CXX_STANDARD 17)\nfind_package(simdjson REQUIRED)'> CMakeLists.txt && mkdir build && cd build && cmake -DCMAKE_INSTALL_PREFIX:PATH=../destination .. &&  cmake --build .
@@ -0,0 +1,30 @@
+name: Ubuntu 20.04 CI (GCC 9) with Thread Sanitizer
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  ubuntu-build:
+    if: >-
+      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
+      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
+    runs-on: ubuntu-20.04
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/cache@v2
+        with:
+          path: dependencies/.cache
+          key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
+      - name: Use cmake
+        run: |
+          mkdir build &&
+          cd build &&
+          cmake  -DSIMDJSON_SANITIZE_THREADS=ON ..  &&
+          cmake --build . --target document_stream_tests --target parse_many_test  &&
+          ctest --output-on-failure  -R parse_many_test  &&
+          ctest --output-on-failure  -R document_stream_tests
@@ -0,0 +1,33 @@
+name: Ubuntu 20.04 CI (GCC 9)
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  ubuntu-build:
+    if: >-
+      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
+      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
+    runs-on: ubuntu-20.04
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/cache@v2
+        with:
+          path: dependencies/.cache
+          key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
+      - name: Use cmake
+        run: |
+          mkdir build &&
+          cd build &&
+          cmake  -DSIMDJSON_GOOGLE_BENCHMARKS=ON -DSIMDJSON_BUILD_STATIC=ON -DCMAKE_INSTALL_PREFIX:PATH=destination ..  &&
+          cmake --build .   &&
+          ctest -j --output-on-failure -LE explicitonly   &&
+          cmake --install . &&
+          echo -e '#include <simdjson.h>\nint main(int argc,char**argv) {simdjson::dom::parser parser;simdjson::dom::element tweets = parser.load(argv[1]); }' > tmp.cpp && c++ -Idestination/include -Ldestination/lib -std=c++17 -Wl,-rpath,destination/lib -o linkandrun tmp.cpp -lsimdjson && ./linkandrun jsonexamples/twitter.json &&
+          cd ../tests/installation_tests/find &&
+          mkdir build && cd build && cmake -DCMAKE_INSTALL_PREFIX:PATH=../../../build/destination .. &&  cmake --build .
@@ -1,23 +0,0 @@
-name: Ubuntu 22.04 CI (CLANG 13)
-
-on: [push, pull_request]
-
-jobs:
-  ubuntu-build:
-    if: >-
-      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
-      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
-    runs-on: ubuntu-22.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/cache@v4
-        with:
-          path: dependencies/.cache
-          key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
-      - name: Use cmake
-        run: |
-          mkdir build &&
-          cd build &&
-          CXX=clang++-13 cmake -DSIMDJSON_DEVELOPER_MODE=ON ..  &&
-          cmake --build .   &&
-          ctest --output-on-failure -LE explicitonly -j
@@ -1,23 +0,0 @@
-name: Ubuntu 22.04 CI (CLANG 14)
-
-on: [push, pull_request]
-
-jobs:
-  ubuntu-build:
-    if: >-
-      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
-      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
-    runs-on: ubuntu-22.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/cache@v4
-        with:
-          path: dependencies/.cache
-          key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
-      - name: Use cmake
-        run: |
-          mkdir build &&
-          cd build &&
-          CXX=clang++-14 cmake -DSIMDJSON_DEVELOPER_MODE=ON ..  &&
-          cmake --build .   &&
-          ctest --output-on-failure -LE explicitonly -j
@@ -1,65 +0,0 @@
-name: Ubuntu 22.04 CI (GCC 12, CXX 20)
-
-on: [push, pull_request]
-
-jobs:
-  ubuntu-build:
-    if: >-
-      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
-      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
-    runs-on: ubuntu-22.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/cache@v4
-        with:
-          path: dependencies/.cache
-          key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
-
-      - name: Configure Debug Build
-        run: |
-          CXX=g++-12 cmake -DSIMDJSON_CXX_STANDARD=20 -DCMAKE_BUILD_TYPE=Debug -DSIMDJSON_GOOGLE_BENCHMARKS=OFF -DSIMDJSON_DEVELOPER_MODE=ON -DBUILD_SHARED_LIBS=OFF -B builddebug
-
-      - name: Compile Debug Build
-        run: |
-          cmake --build builddebug
-
-      - name: Test Debug Build
-        run: |
-          ctest --output-on-failure -LE explicitonly -j --test-dir builddebug
-
-      - name: Configure Release Build
-        run: |
-          CXX=g++-12 cmake -DSIMDJSON_CXX_STANDARD=20 -DSIMDJSON_GOOGLE_BENCHMARKS=ON -DSIMDJSON_DEVELOPER_MODE=ON -DBUILD_SHARED_LIBS=OFF -DCMAKE_INSTALL_PREFIX:PATH=destination -B build
-
-      - name: Compile Release Build
-        run: |
-          cmake --build build
-
-      - name: Test Release Build
-        run: |
-          ctest --output-on-failure -LE explicitonly -j --test-dir build
-
-      - name: Install Release Build
-        run: |
-          cmake --install build
-
-      - name: Generate Example Code
-        run: |
-          echo -e '#include <simdjson.h>\nint main(int argc,char**argv) {simdjson::dom::parser parser;simdjson::dom::element tweets = parser.load(argv[1]); }' > tmp.cpp
-
-      - name: Compile Example Code
-        run: |
-          c++ -Idestination/include -Ldestination/lib -std=c++17 -Wl,-rpath,destination/lib -o linkandrun tmp.cpp -lsimdjson
-
-      - name: Run Example Code
-        run: |
-          ./linkandrun jsonexamples/twitter.json
-
-      - name: Configure Find Tests
-        run: |
-          cd tests/installation_tests/find && \
-          cmake -DCMAKE_INSTALL_PREFIX:PATH=../../../destination -B build
-
-      - name: Compile Find Tests
-        run: |
-          cd tests/installation_tests/find && cmake --build build
@@ -1,23 +0,0 @@
-name: Ubuntu 22.04 CI (GCC 12)
-
-on: [push, pull_request]
-
-jobs:
-  ubuntu-build:
-    if: >-
-      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
-      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
-    runs-on: ubuntu-22.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/cache@v4
-        with:
-          path: dependencies/.cache
-          key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
-      - name: Use cmake
-        run: |
-          mkdir build &&
-          cd build &&
-          CXX=g++-12 cmake -DSIMDJSON_DEVELOPER_MODE=ON ..  &&
-          cmake --build .   &&
-          ctest --output-on-failure -LE explicitonly -j
@@ -1,24 +0,0 @@
-name: Ubuntu 22.04 CI GCC 12 with GLIBCXX_ASSERTIONS
-on: [push, pull_request]
-
-jobs:
-  ubuntu-build:
-    if: >-
-      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
-      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
-    runs-on: ubuntu-22.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/cache@v4
-        with:
-          path: dependencies/.cache
-          key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
-      - name: Install gcc12
-        run: sudo apt-get install -y g++-12
-      - name: Use cmake
-        run: |
-          mkdir build &&
-          cd build &&
-          CXX=g++-12 cmake -DCMAKE_BUILD_TYPE=Debug  -DSIMDJSON_GLIBCXX_ASSERTIONS=ON -DSIMDJSON_GOOGLE_BENCHMARKS=OFF -DSIMDJSON_DEVELOPER_MODE=ON ..  &&
-          cmake --build .   &&
-          ctest . -E avoid_
@@ -1,47 +0,0 @@
-name: Ubuntu 22.04 CI (GCC 11)
-
-on: [push, pull_request]
-
-jobs:
-  ubuntu-build:
-    if: >-
-      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
-      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
-    runs-on: ubuntu-22.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/cache@v4
-        with:
-          path: dependencies/.cache
-          key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
-      - name: Use cmake to build just the library
-        run: |
-          mkdir buildjustlib &&
-          cd buildjustlib &&
-          cmake -DCMAKE_BUILD_TYPE=Release -DBUILD_SHARED_LIBS=OFF -DSIMDJSON_DEVELOPER_MODE=OFF -DCMAKE_INSTALL_PREFIX:PATH=destination ..  &&
-          cmake --build .   &&
-          cmake --install . &&
-          echo -e '#include <simdjson.h>\nint main(int argc,char**argv) {simdjson::dom::parser parser;simdjson::dom::element tweets = parser.load(argv[1]); }' > tmp.cpp &&
-          c++ -Idestination/include -Ldestination/lib -std=c++17 -Wl,-rpath,destination/lib -o linkandrun tmp.cpp -lsimdjson &&
-          cd ../tests/installation_tests/find &&
-          mkdir buildjustlib &&
-          cd buildjustlib &&
-          cmake -DCMAKE_INSTALL_PREFIX:PATH=../../../buildjustlib/destination .. &&
-          cmake --build .
-      - name: Use cmake
-        run: |
-          mkdir builddebug &&
-          cd builddebug &&
-          cmake -DCMAKE_BUILD_TYPE=Debug -DSIMDJSON_GOOGLE_BENCHMARKS=OFF -DSIMDJSON_DEVELOPER_MODE=ON -DBUILD_SHARED_LIBS=OFF ..  &&
-          cmake --build .   &&
-          ctest --output-on-failure -LE explicitonly -j   &&
-          cd .. &&
-          mkdir build &&
-          cd build &&
-          cmake  -DSIMDJSON_GOOGLE_BENCHMARKS=ON -DSIMDJSON_DEVELOPER_MODE=ON -DBUILD_SHARED_LIBS=OFF -DCMAKE_INSTALL_PREFIX:PATH=destination ..  &&
-          cmake --build .   &&
-          ctest --output-on-failure -LE explicitonly -j   &&
-          cmake --install . &&
-          echo -e '#include <simdjson.h>\nint main(int argc,char**argv) {simdjson::dom::parser parser;simdjson::dom::element tweets = parser.load(argv[1]); }' > tmp.cpp && c++ -Idestination/include -Ldestination/lib -std=c++17 -Wl,-rpath,destination/lib -o linkandrun tmp.cpp -lsimdjson && ./linkandrun jsonexamples/twitter.json &&
-          cd ../tests/installation_tests/find &&
-          mkdir build && cd build && cmake -DCMAKE_INSTALL_PREFIX:PATH=../../../build/destination .. &&  cmake --build .
@@ -1,22 +0,0 @@
-name: Ubuntu 24.04 CI (CXX 20, noexcept)
-
-on: [push, pull_request]
-jobs:
-  ubuntu-build:
-    if: >-
-      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
-      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
-    runs-on: ubuntu-24.04
-    strategy:
-      matrix:
-        cxx: [g++-13, clang++-16]
-    steps:
-      - uses: actions/checkout@a5ac7e51b41094c92402da3b24376905380afc29 # v4.1.6
-      - name: Prepare
-        run: cmake -DSIMDJSON_CXX_STANDARD=20 -DSIMDJSON_EXCEPTIONS=OFF -DSIMDJSON_DEVELOPER_MODE=ON  -B build
-        env:
-          CXX: ${{matrix.cxx}}
-      - name: Build
-        run: cmake --build build -j=2
-      - name: Test
-        run: ctest --output-on-failure --test-dir build
@@ -1,22 +0,0 @@
-name: Ubuntu 24.04 CI (CXX 20)
-
-on: [push, pull_request]
-jobs:
-  ubuntu-build:
-    if: >-
-      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
-      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
-    runs-on: ubuntu-24.04
-    strategy:
-      matrix:
-        cxx: [g++-13, clang++-16]
-    steps:
-      - uses: actions/checkout@a5ac7e51b41094c92402da3b24376905380afc29 # v4.1.6
-      - name: Prepare
-        run: cmake -DSIMDJSON_CXX_STANDARD=20 -DSIMDJSON_DEVELOPER_MODE=ON  -B build
-        env:
-          CXX: ${{matrix.cxx}}
-      - name: Build
-        run: cmake --build build -j=2
-      - name: Test
-        run: ctest --output-on-failure --test-dir build
@@ -1,34 +0,0 @@
-name: Ubuntu 20.04 CI (GCC 9) without exceptions
-
-on: [push, pull_request]
-
-jobs:
-  ubuntu-build:
-    if: >-
-      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
-      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
-    runs-on: ubuntu-24.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/cache@v4
-        with:
-          path: dependencies/.cache
-          key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
-      - name: Use cmake
-        run: |
-          mkdir builddebug &&
-          cd builddebug &&
-          cmake -DCMAKE_BUILD_TYPE=Debug -DSIMDJSON_GOOGLE_BENCHMARKS=OFF -DSIMDJSON_DEVELOPER_MODE=ON -DSIMDJSON_EXCEPTIONS=OFF -DBUILD_SHARED_LIBS=OFF ..  &&
-          cmake --build .   &&
-          ctest --output-on-failure -LE explicitonly -j   &&
-          cd .. &&
-          mkdir build &&
-          cd build &&
-          cmake  -DSIMDJSON_DEVELOPER_MODE=ON -DSIMDJSON_GOOGLE_BENCHMARKS=ON -DSIMDJSON_GOOGLE_BENCHMARKS=ON -DSIMDJSON_EXCEPTIONS=OFF -DBUILD_SHARED_LIBS=OFF -DCMAKE_INSTALL_PREFIX:PATH=destination ..  &&
-          cmake --build .   &&
-          ctest --output-on-failure -LE explicitonly -j   &&
-          make install  &&
-          echo -e '#include <simdjson.h>\nint main(int argc,char**argv) {simdjson::dom::parser parser;simdjson::dom::element tweets = parser.load(argv[1]); }' > tmp.cpp && c++ -Idestination/include -Ldestination/lib -std=c++17 -Wl,-rpath,destination/lib -o linkandrun tmp.cpp -lsimdjson && ./linkandrun jsonexamples/twitter.json &&
-          mkdir testfindpackage &&
-          cd testfindpackage &&
-          echo -e 'cmake_minimum_required(VERSION 3.14)\nproject(simdjsontester)\nset(CMAKE_CXX_STANDARD 17)\nfind_package(simdjson REQUIRED)'> CMakeLists.txt && mkdir build && cd build && cmake -DCMAKE_INSTALL_PREFIX:PATH=../destination .. &&  cmake --build .
@@ -1,34 +0,0 @@
-name: Ubuntu 20.04 CI (GCC 9) Without Threads
-
-on: [push, pull_request]
-
-jobs:
-  ubuntu-build:
-    if: >-
-      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
-      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
-    runs-on: ubuntu-24.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/cache@v4
-        with:
-          path: dependencies/.cache
-          key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
-      - name: Use cmake
-        run: |
-          mkdir builddebug &&
-          cd builddebug &&
-          cmake -DCMAKE_BUILD_TYPE=Debug -DSIMDJSON_GOOGLE_BENCHMARKS=OFF  -DSIMDJSON_ENABLE_THREADS=OFF -DSIMDJSON_DEVELOPER_MODE=ON -DBUILD_SHARED_LIBS=OFF ..  &&
-          cmake --build .   &&
-          ctest --output-on-failure -LE explicitonly -j   &&
-          cd .. &&
-          mkdir build &&
-          cd build &&
-          cmake  -DSIMDJSON_DEVELOPER_MODE=ON -DSIMDJSON_GOOGLE_BENCHMARKS=ON -DSIMDJSON_ENABLE_THREADS=OFF -DBUILD_SHARED_LIBS=OFF -DCMAKE_INSTALL_PREFIX:PATH=destination ..  &&
-          cmake --build .   &&
-          ctest --output-on-failure -LE explicitonly -j   &&
-          make install  &&
-          echo -e '#include <simdjson.h>\nint main(int argc,char**argv) {simdjson::dom::parser parser;simdjson::dom::element tweets = parser.load(argv[1]); }' > tmp.cpp && c++ -Idestination/include -Ldestination/lib -std=c++17 -Wl,-rpath,destination/lib -o linkandrun tmp.cpp -lsimdjson && ./linkandrun jsonexamples/twitter.json &&
-          mkdir testfindpackage &&
-          cd testfindpackage &&
-          echo -e 'cmake_minimum_required(VERSION 3.14)\nproject(simdjsontester)\nset(CMAKE_CXX_STANDARD 17)\nfind_package(simdjson REQUIRED)'> CMakeLists.txt && mkdir build && cd build && cmake -DCMAKE_INSTALL_PREFIX:PATH=../destination .. &&  cmake --build .
@@ -1,41 +0,0 @@
-name: Ubuntu 20.04 CI (GCC 9) With Memory Sanitizer
-
-on: [push, pull_request]
-
-jobs:
-  ubuntu-build-address-sanitizier:
-    if: >-
-      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
-      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
-    runs-on: ubuntu-24.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/cache@v4
-        with:
-          path: dependencies/.cache
-          key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
-      - name: Use cmake with address sanitizer
-        run: |
-          mkdir builddebug &&
-          cd builddebug &&
-          cmake -DSIMDJSON_SANITIZE=ON -DCMAKE_BUILD_TYPE=Debug -DSIMDJSON_GOOGLE_BENCHMARKS=OFF -DSIMDJSON_DEVELOPER_MODE=ON -DBUILD_SHARED_LIBS=OFF ..  &&
-          cmake --build .   &&
-          ctest --output-on-failure -LE explicitonly -j
-  ubuntu-build-undefined-sanitizer:
-    if: >-
-      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
-      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
-    runs-on: ubuntu-24.04
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/cache@v4
-        with:
-          path: dependencies/.cache
-          key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
-      - name: Use cmake with undefined sanitizer
-        run: |
-          mkdir builddebugundefsani &&
-          cd builddebugundefsani &&
-          cmake -DSIMDJSON_SANITIZE_UNDEFINED=ON -DCMAKE_BUILD_TYPE=Debug -DSIMDJSON_GOOGLE_BENCHMARKS=OFF -DSIMDJSON_DEVELOPER_MODE=ON -DBUILD_SHARED_LIBS=OFF ..  &&
-          cmake --build .   &&
-          ctest --output-on-failure -LE explicitonly -j
@@ -1,25 +0,0 @@
-name: Ubuntu 24.04 CI
-
-on: [push, pull_request]
-jobs:
-  ubuntu-build:
-    if: >-
-      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
-      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
-    runs-on: ubuntu-24.04
-    strategy:
-      matrix:
-        shared: [ON, OFF]
-        cxx: [g++-13, clang++-16]
-        sanitizer: [ON, OFF]
-        build_type: [RelWithDebInfo, Debug, Release]
-    steps:
-      - uses: actions/checkout@a5ac7e51b41094c92402da3b24376905380afc29 # v4.1.6
-      - name: Prepare
-        run: cmake -DCMAKE_BUILD_TYPE=${{matrix.build_type}} -DSIMDJSON_DEVELOPER_MODE=ON -DSIMDJSON_SANITIZE=${{matrix.sanitizer}} -DBUILD_SHARED_LIBS=${{matrix.shared}}  -B build
-        env:
-          CXX: ${{matrix.cxx}}
-      - name: Build
-        run: cmake --build build -j=2
-      - name: Test
-        run: ctest --output-on-failure --test-dir build
@@ -0,0 +1,46 @@
+name: VS15-CI
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  ci:
+    if: >-
+      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
+      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
+    name: windows-vs15
+    runs-on: windows-2016
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - {gen: Visual Studio 15 2017, arch: Win32, static: ON}
+          - {gen: Visual Studio 15 2017, arch: Win32, static: OFF}
+          - {gen: Visual Studio 15 2017, arch: x64, static: ON}
+          - {gen: Visual Studio 15 2017, arch: x64, static: OFF}
+    steps:
+    - name: checkout
+      uses: actions/checkout@v2
+    - name: Configure
+      run: |
+        cmake -G "${{matrix.gen}}" -A ${{matrix.arch}} -DSIMDJSON_COMPETITION=OFF -DSIMDJSON_BUILD_STATIC=${{matrix.static}} -B build
+    - name: Build Debug
+      run: cmake --build build --config Debug --verbose
+    - name: Build Release
+      run: cmake --build build --config Release --verbose
+    - name: Run tests
+      run: |
+        cd build
+        ctest -C Release  -LE explicitonly  --output-on-failure
+    - name: Install
+      run: |
+        cmake --install build --config Release
+    - name: Test Installation
+      run: |
+        cmake -G "${{matrix.gen}}" -A ${{matrix.arch}}  -B build_install_test tests/installation_tests/find
+        cmake --build build_install_test --config Release
@@ -1,40 +1,42 @@
-name: VS17-CI CXX20
+name: VS16-CI

-on: [push, pull_request]
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master

 jobs:
  ci:
    if: >-
      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
-    name: windows-vs17
+    name: windows-vs16
    runs-on: windows-latest
    strategy:
      fail-fast: false
      matrix:
        include:
-          - {gen: Visual Studio 17 2022, arch: Win32, shared: ON}
-          - {gen: Visual Studio 17 2022, arch: Win32, shared: OFF}
-          - {gen: Visual Studio 17 2022, arch: x64, shared: ON}
-          - {gen: Visual Studio 17 2022, arch: x64, shared: OFF}
+          - {gen: Visual Studio 16 2019, arch: Win32, static: ON}
+          - {gen: Visual Studio 16 2019, arch: Win32, static: OFF}
+          - {gen: Visual Studio 16 2019, arch: x64, static: ON}
+          - {gen: Visual Studio 16 2019, arch: x64, static: OFF}
    steps:
    - name: checkout
-      uses: actions/checkout@v4
+      uses: actions/checkout@v2
    - name: Configure
      run: |
-        cmake -DSIMDJSON_CXX_STANDARD=20 -G "${{matrix.gen}}" -A ${{matrix.arch}} -DSIMDJSON_DEVELOPER_MODE=ON -DSIMDJSON_COMPETITION=OFF -DBUILD_SHARED_LIBS=${{matrix.shared}} -B build
+        cmake -G "${{matrix.gen}}" -A ${{matrix.arch}} -DSIMDJSON_COMPETITION=OFF -DSIMDJSON_BUILD_STATIC=${{matrix.static}} -B build
    - name: Build Debug
      run: cmake --build build --config Debug --verbose
    - name: Build Release
      run: cmake --build build --config Release --verbose
-    - name: Run Release tests
+    - name: Run tests
      run: |
        cd build
        ctest -C Release  -LE explicitonly  --output-on-failure
-    - name: Run Debug tests
-      run: |
-        cd build
-        ctest -C Debug  -LE explicitonly  --output-on-failure
    - name: Install
      run: |
        cmake --install build --config Release
@@ -0,0 +1,37 @@
+name: VS16-CLANG-CI
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  ci:
+    if: >-
+      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
+      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
+    name: windows-vs16
+    runs-on: windows-latest
+    steps:
+    - uses: actions/checkout@v2
+    - uses: actions/cache@v2
+      with:
+        path: dependencies/.cache
+        key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
+    - name: 'Run CMake with VS16 Clang'
+      uses: lukka/run-cmake@v3
+      with:
+        cmakeListsOrSettingsJson: CMakeListsTxtAdvanced
+        cmakeListsTxtPath: '${{ github.workspace }}/CMakeLists.txt'
+        buildDirectory: "${{ github.workspace }}/../../_temp/windows"
+        cmakeBuildType: Release
+        buildWithCMake: true
+        cmakeAppendedArgs:  -T ClangCL -DSIMDJSON_COMPETITION=OFF  -DSIMDJSON_BUILD_STATIC=ON
+        buildWithCMakeArgs: --config Release
+    
+    - name: 'Run CTest'
+      run: ctest -C Release -LE explicitonly  --output-on-failure
+      working-directory: "${{ github.workspace }}/../../_temp/windows"
@@ -0,0 +1,51 @@
+name: VS16-Ninja-CI
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  ci:
+    if: >-
+      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
+      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
+    name: windows-vs16
+    runs-on: windows-latest
+    steps:
+    - uses: actions/checkout@v2
+    - uses: actions/cache@v2
+      with:
+        path: dependencies/.cache
+        key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
+    - name: 'Run CMake with VS16'
+      uses: lukka/run-cmake@v2
+      with:
+        cmakeListsOrSettingsJson: CMakeListsTxtAdvanced
+        cmakeListsTxtPath: '${{ github.workspace }}/CMakeLists.txt'
+        buildDirectory: "${{ github.workspace }}/../../_temp/windows"
+        cmakeBuildType: Release
+        buildWithCMake: true
+        cmakeAppendedArgs:  -G Ninja -DSIMDJSON_COMPETITION=OFF   -DSIMDJSON_BUILD_STATIC=ON
+        buildWithCMakeArgs: --config Release
+    - name: 'Run CTest'
+      run: ctest -C Release  -LE explicitonly  --output-on-failure
+      working-directory: "${{ github.workspace }}/../../_temp/windows"
+    - name: 'Install with CMake'
+      uses: lukka/run-cmake@v3
+      with:
+        cmakeListsTxtPath: '${{ github.workspace }}/CMakeLists.txt'
+        buildWithCMakeArgs: '--target install'
+    - name: 'Test Installation with CMake'
+      uses: lukka/run-cmake@v3
+      with:
+        cmakeListsOrSettingsJson: CMakeListsTxtAdvanced
+        cmakeListsTxtPath: '${{ github.workspace }}/tests/installation_tests/find/CMakeLists.txt'
+        cmakeBuildType: Release
+        buildWithCMake: true
+        buildDirectory: '${{ github.workspace }}/tests/installation_tests/find/buildDirectory'
+        cmakeAppendedArgs:  -G Ninja
+        buildWithCMakeArgs: '--config Release --verbose'
@@ -1,18 +1,24 @@
-name: VS17-NoExcept-CI
+name: VS16-NoExcept-CI

-on: [push, pull_request]
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master

 jobs:
  ci:
-    name: windows-vs17
+    name: windows-vs16
    runs-on: windows-latest
    steps:
-    - uses: actions/checkout@v4
-    - uses: actions/cache@v4
+    - uses: actions/checkout@v2
+    - uses: actions/cache@v2
      with:
        path: dependencies/.cache
        key: ${{ hashFiles('dependencies/CMakeLists.txt') }}
-    - name: 'Run CMake with VS17'
+    - name: 'Run CMake with VS16'
      uses: lukka/run-cmake@v3
      with:
        cmakeListsOrSettingsJson: CMakeListsTxtAdvanced
@@ -21,7 +27,7 @@ jobs:
        cmakeBuildType: Release
        buildWithCMake: true
        cmakeGenerator: VS16Win64
-        cmakeAppendedArgs: -DSIMDJSON_COMPETITION=OFF -DSIMDJSON_DEVELOPER_MODE=ON  -DSIMDJSON_EXCEPTIONS=OFF
+        cmakeAppendedArgs: -DSIMDJSON_COMPETITION=OFF  -DSIMDJSON_EXCEPTIONS=OFF
        buildWithCMakeArgs: --config Release

    - name: 'Run CTest'
@@ -1,21 +0,0 @@
-name: VS17-ARM-CI
-
-on: [push, pull_request]
-
-jobs:
-   ci:
-     name: windows-vs17
-     runs-on: windows-latest
-     strategy:
-       fail-fast: false
-       matrix:
-         include:
-           - {arch: ARM64}
-           - {arch: ARM64EC}
-     steps:
-       - name: checkout
-         uses: actions/checkout@v4
-       - name: Use cmake
-         run: |
-           cmake -A ${{ matrix.arch }} -DCMAKE_SYSTEM_VERSION="10.0.22621.0" -DCMAKE_CROSSCOMPILING=1 -DSIMDJSON_DEVELOPER_MODE=ON -D SIMDJSON_GOOGLE_BENCHMARKS=OFF -DSIMDJSON_EXCEPTIONS=OFF -B build  &&
-           cmake --build build --verbose
@@ -1,30 +0,0 @@
-name: VS17-CI-SANITIZE
-
-on: [push, pull_request]
-
-jobs:
-  ci:
-    if: >-
-      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
-      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
-    name: windows-vs17
-    runs-on: windows-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - {gen: Visual Studio 17 2022, arch: x64, shared: OFF, build_type: Debug}
-          - {gen: Visual Studio 17 2022, arch: x64, shared: OFF, build_type: Release}
-          - {gen: Visual Studio 17 2022, arch: x64, shared: OFF, build_type: RelWithDebInfo}
-    steps:
-    - name: checkout
-      uses: actions/checkout@v4
-    - name: Configure
-      run: |
-        cmake -G "${{matrix.gen}}" -A ${{matrix.arch}} -DSANITIZE=ON -DSIMDJSON_DEVELOPER_MODE=ON -DSIMDJSON_COMPETITION=OFF -DBUILD_SHARED_LIBS=${{matrix.shared}} -B build
-    - name: Build
-      run: cmake --build build --config ${{matrix.build_type}} --verbose
-    - name: Run tests
-      run: |
-        cd build
-        ctest -C ${{matrix.build_type}}  -LE explicitonly  --output-on-failure
@@ -1,40 +0,0 @@
-name: VS17-CI
-
-on: [push, pull_request]
-
-jobs:
-  ci:
-    if: >-
-      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
-      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
-    name: windows-vs17
-    runs-on: windows-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - {gen: Visual Studio 17 2022, arch: Win32, shared: ON, build_type: Release}
-          - {gen: Visual Studio 17 2022, arch: Win32, shared: OFF, build_type: Release}
-          - {gen: Visual Studio 17 2022, arch: x64, shared: ON, build_type: Release}
-          - {gen: Visual Studio 17 2022, arch: x64, shared: OFF, build_type: Debug}
-          - {gen: Visual Studio 17 2022, arch: x64, shared: OFF, build_type: Release}
-          - {gen: Visual Studio 17 2022, arch: x64, shared: OFF, build_type: RelWithDebInfo}
-    steps:
-    - name: checkout
-      uses: actions/checkout@v4
-    - name: Configure
-      run: |
-        cmake -G "${{matrix.gen}}" -A ${{matrix.arch}} -DSIMDJSON_DEVELOPER_MODE=ON -DSIMDJSON_COMPETITION=OFF -DBUILD_SHARED_LIBS=${{matrix.shared}} -B build
-    - name: Build Debug
-      run: cmake --build build --config ${{matrix.build_type}} --verbose
-    - name: Run tests
-      run: |
-        cd build
-        ctest -C ${{matrix.build_type}}  -LE explicitonly  --output-on-failure
-    - name: Install
-      run: |
-        cmake --install build --config ${{matrix.build_type}}
-    - name: Test Installation
-      run: |
-        cmake -G "${{matrix.gen}}" -A ${{matrix.arch}}  -B build_install_test tests/installation_tests/find
-        cmake --build build_install_test --config ${{matrix.build_type}}
@@ -1,37 +0,0 @@
-name: VS17-CLANG-CI
-
-on: [push, pull_request]
-
-jobs:
-  ci:
-    if: >-
-      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
-      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
-    name: windows-vs17
-    runs-on: windows-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - {gen: Visual Studio 17 2022, arch: x64, build_type: Debug}
-          - {gen: Visual Studio 17 2022, arch: x64, build_type: Release}
-          - {gen: Visual Studio 17 2022, arch: x64, build_type: RelWithDebInfo}
-    steps:
-    - name: checkout
-      uses: actions/checkout@v4
-    - name: Configure
-      run: |
-        cmake -G "${{matrix.gen}}" -A ${{matrix.arch}}  -T ClangCL -DSIMDJSON_DEVELOPER_MODE=ON -DSIMDJSON_COMPETITION=OFF -B build
-    - name: Build
-      run: cmake --build build --config ${{matrix.build_type}} --verbose
-    - name: Run tests
-      run: |
-        cd build
-        ctest -C ${{matrix.build_type}}  -LE explicitonly  --output-on-failure
-    - name: Install
-      run: |
-        cmake --install build --config ${{matrix.build_type}}
-    - name: Test Installation
-      run: |
-        cmake -G "${{matrix.gen}}" -A ${{matrix.arch}}  -B build_install_test tests/installation_tests/find
-        cmake --build build_install_test --config ${{matrix.build_type}}
@@ -1,37 +0,0 @@
-name: VS17-CLANG-CI
-
-on: [push, pull_request]
-
-jobs:
-  ci:
-    if: >-
-      ! contains(toJSON(github.event.commits.*.message), '[skip ci]') &&
-      ! contains(toJSON(github.event.commits.*.message), '[skip github]')
-    name: windows-vs17
-    runs-on: windows-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - {gen: Visual Studio 17 2022, arch: x64, build_type: Debug}
-          - {gen: Visual Studio 17 2022, arch: x64, build_type: Release}
-          - {gen: Visual Studio 17 2022, arch: x64, build_type: RelWithDebInfo}
-    steps:
-    - name: checkout
-      uses: actions/checkout@v4
-    - name: Configure
-      run: |
-        cmake -G "${{matrix.gen}}" -A ${{matrix.arch}}  -T ClangCL -DSIMDJSON_DEVELOPER_MODE=ON -DSIMDJSON_COMPETITION=OFF -B build
-    - name: Build
-      run: cmake --build build --config ${{matrix.build_type}} --verbose
-    - name: Run tests
-      run: |
-        cd build
-        ctest -C ${{matrix.build_type}}  -LE explicitonly  --output-on-failure
-    - name: Install
-      run: |
-        cmake --install build --config ${{matrix.build_type}}
-    - name: Test Installation
-      run: |
-        cmake -G "${{matrix.gen}}" -A ${{matrix.arch}}  -B build_install_test tests/installation_tests/find
-        cmake --build build_install_test --config ${{matrix.build_type}}
@@ -9,14 +9,6 @@
 # vim temp files
 .*.swp

-# Build directories
-build/
-build_*/
-buildreflect/
-
-# Ablation study results
-ablation/results/
-
 # XCode
 ^build/
 *.pbxuser
@@ -46,7 +38,7 @@ cmake-build-release/
 .history/

 # Visual Studio artifacts
-/.vs/
+/VS/

 # C/C++ build outputs
 .build/
@@ -105,28 +97,3 @@ objs
 # Generated docs
 /doc/api
 *.orig
-
-# VSCode workspace files
-.vscode/*
-!.vscode/settings.json
-!.vscode/tasks.json
-!.vscode/launch.json
-!.vscode/extensions.json
-
-# clangd
-.cache
-
-# Ablation study results
-ablation/results/*.csv
-ablation/results/*.txt
-
-# Unified benchmark binary
-benchmark/unified_benchmark
-
-# Rust build artifacts
-*.rlib
-*.rmeta
-benchmark/static_reflect/serde-benchmark/target/
-**/target/debug/
-**/target/release/
-Cargo.lock
@@ -48,18 +48,17 @@ matrix:
        - COMPILER="CC=gcc-10 && CXX=g++-10"
      compiler: gcc-10

-# The sanitizer runs fail systematically
-#    - os: linux
-#      addons:
-#        apt:
-#          sources:
-#            - ubuntu-toolchain-r-test
-#          packages:
-#            - g++-10
-#      env:
-#        - COMPILER="CC=gcc-10 && CXX=g++-10"
-#        - SANITIZE="on"
-#      compiler: gcc-10-sanitize
+    - os: linux
+      addons:
+        apt:
+          sources:
+            - ubuntu-toolchain-r-test
+          packages:
+            - g++-10
+      env:
+        - COMPILER="CC=gcc-10 && CXX=g++-10"
+        - SANITIZE="on"
+      compiler: gcc-10-sanitize

    - os: linux
      addons:
@@ -144,20 +143,19 @@ matrix:
        - STATIC="on"
      compiler: clang-10-static

-# The clang sanitizer runs fail frequently at setup time
-#    - os: linux
-#      addons:
-#        apt:
-#          packages:
-#            - clang-10
-#          sources:
-#            - ubuntu-toolchain-r-test
-#            - sourceline: 'deb http://apt.llvm.org/bionic/ llvm-toolchain-bionic-10 main'
-#              key_url: 'https://apt.llvm.org/llvm-snapshot.gpg.key'
-#      env:
-#        - COMPILER="CC=clang-10 && CXX=clang++-10"
-#        - SANITIZE="on"
-#      compiler: clang-10-sanitize
+    - os: linux
+      addons:
+        apt:
+          packages:
+            - clang-10
+          sources:
+            - ubuntu-toolchain-r-test
+            - sourceline: 'deb http://apt.llvm.org/bionic/ llvm-toolchain-bionic-10 main'
+              key_url: 'https://apt.llvm.org/llvm-snapshot.gpg.key'
+      env:
+        - COMPILER="CC=clang-10 && CXX=clang++-10"
+        - SANITIZE="on"
+      compiler: clang-10-sanitize

 before_install:
  - eval "${COMPILER}"
@@ -176,7 +174,7 @@ install:
      export ASAN_OPTIONS="detect_leaks=0";
    fi
  - if [[ "${STATIC}" == "on" ]]; then
-      export CMAKE_FLAGS="${CMAKE_FLAGS} -DBUILD_SHARED_LIBS=OFF";
+      export CMAKE_FLAGS="${CMAKE_FLAGS} -DSIMDJSON_BUILD_STATIC=ON";
    fi
  - export CTEST_FLAGS="-j4 --output-on-failure -LE explicitonly"

@@ -1,22 +0,0 @@
-{
-	// See https://go.microsoft.com/fwlink/?LinkId=827846 to learn about workspace recommendations.
-	// Extension identifier format: ${publisher}.${name}. Example: vscode.csharp
-
-	// List of extensions which should be recommended for users of this workspace.
-	"recommendations": [
-		// C++
-		"llvm-vs-code-extensions.vscode-clangd",
-		"xaver.clang-format",
-		// Python
-		"ms-python.python",
-		// .github/*
-		"github.vscode-github-actions",
-		// cmake
-		"ms-vscode.cmake-tools",
-		"twxs.cmake"
-	],
-	// List of extensions recommended by VS Code that should not be recommended for users of this workspace.
-	"unwantedRecommendations": [
-
-	]
-}
@@ -1,134 +0,0 @@
-{
-    "editor.rulers": [
-        {"column": 95 },
-        {"column": 120 }
-    ],
-    "cmake.configureArgs": [
-        "-DSIMDJSON_DEVELOPER_MODE=ON"
-    ],
-    "files.trimTrailingWhitespace": true,
-    "files.associations": {
-        ".clangd": "yaml",
-        "array": "cpp",
-        "iterator": "cpp",
-        "chrono": "cpp",
-        "optional": "cpp",
-        "__locale": "cpp",
-        "__tuple": "cpp",
-        "__bit_reference": "cpp",
-        "__config": "cpp",
-        "__debug": "cpp",
-        "__errc": "cpp",
-        "__functional_base": "cpp",
-        "__hash_table": "cpp",
-        "__mutex_base": "cpp",
-        "__node_handle": "cpp",
-        "__nullptr": "cpp",
-        "__split_buffer": "cpp",
-        "__string": "cpp",
-        "__threading_support": "cpp",
-        "__tree": "cpp",
-        "algorithm": "cpp",
-        "atomic": "cpp",
-        "bit": "cpp",
-        "bitset": "cpp",
-        "cctype": "cpp",
-        "cinttypes": "cpp",
-        "clocale": "cpp",
-        "cmath": "cpp",
-        "codecvt": "cpp",
-        "complex": "cpp",
-        "condition_variable": "cpp",
-        "cstdarg": "cpp",
-        "cstddef": "cpp",
-        "cstdint": "cpp",
-        "cstdio": "cpp",
-        "cstdlib": "cpp",
-        "cstring": "cpp",
-        "ctime": "cpp",
-        "cwchar": "cpp",
-        "cwctype": "cpp",
-        "deque": "cpp",
-        "exception": "cpp",
-        "forward_list": "cpp",
-        "fstream": "cpp",
-        "functional": "cpp",
-        "initializer_list": "cpp",
-        "iomanip": "cpp",
-        "ios": "cpp",
-        "iosfwd": "cpp",
-        "iostream": "cpp",
-        "istream": "cpp",
-        "limits": "cpp",
-        "list": "cpp",
-        "locale": "cpp",
-        "map": "cpp",
-        "memory": "cpp",
-        "mutex": "cpp",
-        "new": "cpp",
-        "numeric": "cpp",
-        "ostream": "cpp",
-        "random": "cpp",
-        "ratio": "cpp",
-        "regex": "cpp",
-        "set": "cpp",
-        "sstream": "cpp",
-        "stack": "cpp",
-        "stdexcept": "cpp",
-        "streambuf": "cpp",
-        "string": "cpp",
-        "string_view": "cpp",
-        "system_error": "cpp",
-        "thread": "cpp",
-        "tuple": "cpp",
-        "type_traits": "cpp",
-        "typeinfo": "cpp",
-        "unordered_map": "cpp",
-        "unordered_set": "cpp",
-        "utility": "cpp",
-        "valarray": "cpp",
-        "vector": "cpp",
-        "*.ipp": "cpp",
-        "__functional_base_03": "cpp",
-        "filesystem": "cpp",
-        "*.inc": "cpp",
-        "compare": "cpp",
-        "concepts": "cpp",
-        "variant": "cpp",
-        "__bits": "cpp",
-        "csignal": "cpp",
-        "future": "cpp",
-        "queue": "cpp",
-        "shared_mutex": "cpp",
-        "ranges": "cpp",
-        "span": "cpp",
-        "__verbose_abort": "cpp",
-        "charconv": "cpp",
-        "source_location": "cpp",
-        "strstream": "cpp",
-        "typeindex": "cpp",
-        "*.tcc": "cpp",
-        "memory_resource": "cpp",
-        "numbers": "cpp",
-        "semaphore": "cpp",
-        "stop_token": "cpp",
-        "cfenv": "cpp",
-        "format": "cpp",
-        "xlocmes": "cpp",
-        "xlocmon": "cpp",
-        "xlocnum": "cpp",
-        "xloctime": "cpp",
-        "xutility": "cpp",
-        "coroutine": "cpp",
-        "xfacet": "cpp",
-        "xhash": "cpp",
-        "xiosbase": "cpp",
-        "xlocale": "cpp",
-        "xlocbuf": "cpp",
-        "xlocinfo": "cpp",
-        "xmemory": "cpp",
-        "xstring": "cpp",
-        "xtr1common": "cpp",
-        "xtree": "cpp"
-    }
-}
@@ -1,108 +0,0 @@
-# Benchmark Methodology
-
-## Overview
-This document describes the methodology used for the JSON parsing and serialization benchmarks.
-
-## Test Environment
-
-### Compiler and Flags
- **Compiler**: Clang 21.0.0 with C++26 support
- **Optimization**: `-O3 -march=native`
- **Reflection Support**: `-freflection -fexpansion-statements -stdlib=libc++`
- **Build System**: CMake with unified benchmark executable
-
-### Hardware
-Tests were run on Linux (aarch64) with results measured in MB/s throughput.
-
-## Datasets
-
-### Twitter Dataset
- **File**: `jsonexamples/twitter.json`
- **Size**: 631,515 bytes
- **Content**: Array of tweet objects with nested user information
- **Characteristics**: String-heavy (92%), moderate integer content (15%), minimal floats (<0.05%)
-
-### CITM Catalog Dataset
- **File**: `jsonexamples/citm_catalog.json`
- **Size**: 1,727,204 bytes
- **Content**: Event catalog with performances, venues, and pricing
- **Characteristics**: Complex nested structure with maps and arrays
-
-## Benchmark Design
-
-### Iterations
- **Twitter**: 1,000 iterations per benchmark
- **CITM**: 500 iterations per benchmark
- **Warmup**: 10% of main iterations (100 for Twitter, 50 for CITM)
-
-### Memory Management
- **String Builder Reuse**: Serialization benchmarks reuse the same string_builder instance across iterations
- **Parser Instance**: Each parsing iteration uses a fresh parser instance for realistic performance
- **Buffer Clearing**: Buffers are cleared (not deallocated) between iterations to maintain capacity
-
-### Timing Methodology
-1. Warmup phase to stabilize caches and branch predictors
-2. Timed phase measures wall clock time for all iterations
-3. Throughput calculated as: `(data_size * iterations) / total_time`
-4. Results reported in MB/s and microseconds per iteration
-
-## Libraries and Versions
-
-### Core Libraries
- **simdjson**: Latest with C++26 reflection support
- **nlohmann/json**: v3.11.2
- **RapidJSON**: v1.1.0
- **yyjson**: v0.8.0
-
-### Optional Libraries
- **Serde (Rust)**: serde_json v1.0 via FFI (parsing and serialization)
-
-## Implementation Details
-
-### Parsing Benchmarks
- All libraries perform full field extraction into C++ structures
- No lazy evaluation or partial parsing
- Validates that all expected fields are present
-
-### Serialization Benchmarks
- Serializes complete C++ structures to JSON strings
- Measures only the serialization time, not structure population
- Output validation ensures correctness
-
-### simdjson Approaches
-
-#### Manual Parsing/Serialization
- Hand-written code for each field
- Explicit error checking
- Maximum control over parsing/serialization order
-
-#### Reflection-Based
- Uses C++26 static reflection
- Automatic field discovery via `std::meta::nonstatic_data_members_of()`
- Compile-time code generation for optimal performance
-
-#### simdjson::from() API
- High-level convenient API
- Type-safe automatic conversion
- Parsing only (no serialization equivalent)
-
-## Running the Benchmarks
-
-### Parsing Benchmarks
-```bash
-./run_parsing_benchmarks.sh
-```
-
-### Serialization Benchmarks
-```bash
-./run_serialization_benchmarks.sh
-```
-
-Both scripts:
-1. Build the unified benchmark with all available libraries
-2. Compile with appropriate reflection flags
-3. Run benchmarks for both datasets
-4. Display results in tabular format
-
-## Reproducibility
-All benchmarks use deterministic iteration counts and can be reproduced by running the provided scripts. The unified benchmark executable ensures all libraries are tested under identical conditions.
@@ -1,344 +1,74 @@
-cmake_minimum_required(VERSION 3.14)
-
-project(
-    simdjson
-    # The version number is modified by tools/release.py
-    VERSION 4.2.3
-    DESCRIPTION "Parsing gigabytes of JSON per second"
-    HOMEPAGE_URL "https://simdjson.org/"
-    LANGUAGES CXX C
+cmake_minimum_required(VERSION 3.13)
+# CMP0025: Compiler id for Apple Clang is now AppleClang.
+# https://cmake.org/cmake/help/v3.17/policy/CMP0025.html
+cmake_policy(SET CMP0025 NEW)
+project(simdjson
+  DESCRIPTION "Parsing gigabytes of JSON per second"
+  LANGUAGES CXX C
 )

-set(SIMDJSON_GITHUB_REPOSITORY "https://github.com/simdjson/simdjson")
+set(PROJECT_VERSION_MAJOR 0)
+set(PROJECT_VERSION_MINOR 9)
+set(PROJECT_VERSION_PATCH 6)
+set(SIMDJSON_SEMANTIC_VERSION "0.9.6" CACHE STRING "simdjson semantic version")
+set(SIMDJSON_LIB_VERSION "8.0.0" CACHE STRING "simdjson library version")
+set(SIMDJSON_LIB_SOVERSION "8" CACHE STRING "simdjson library soversion")
+set(SIMDJSON_GITHUB_REPOSITORY https://github.com/simdjson/simdjson)

-string(
-    COMPARE EQUAL
-    "${CMAKE_SOURCE_DIR}" "${CMAKE_CURRENT_SOURCE_DIR}"
-    is_top_project
-)
+include(GNUInstallDirs)
+include(cmake/simdjson-flags.cmake)
+include(cmake/simdjson-user-cmakecache.cmake)

-# ---- Options, variables ----

-# These version numbers are modified by tools/release.py
-set(SIMDJSON_LIB_VERSION "29.0.0" CACHE STRING "simdjson library version")
-set(SIMDJSON_LIB_SOVERSION "29" CACHE STRING "simdjson library soversion")

-option(SIMDJSON_BUILD_STATIC_LIB "Build simdjson_static library along with simdjson (only makes sense if BUILD_SHARED_LIBS=ON)" OFF)
-if(SIMDJSON_BUILD_STATIC_LIB AND NOT BUILD_SHARED_LIBS)
-  message(WARNING "SIMDJSON_BUILD_STATIC_LIB only makes sense if BUILD_SHARED_LIBS is set to ON")
-  message(WARNING "You might be building and installing a two identical static libraries.")
+if(SIMDJSON_JUST_LIBRARY)
+  message( STATUS "Building just the library, omitting all tests, tools and benchmarks." )
+else(SIMDJSON_JUST_LIBRARY)
+  # Setup tests
+  enable_testing()
+  add_subdirectory(jsonchecker)
+  add_subdirectory(jsonexamples)
+  add_library(test-data INTERFACE)
+  target_link_libraries(test-data INTERFACE jsonchecker-data jsonchecker-minefield-data jsonexamples-data)
+endif(SIMDJSON_JUST_LIBRARY)
+
+# Create the top level simdjson library (must be done at this level to use both src/ and include/
+# directories) and tools
+#
+add_subdirectory(include)
+add_subdirectory(src)
+add_subdirectory(windows)
+if(NOT(SIMDJSON_JUST_LIBRARY))
+  add_subdirectory(dependencies) ## This needs to be before tools because of cxxopts
+  add_subdirectory(tools)  ## This needs to be before tests because of cxxopts
+  add_subdirectory(singleheader)
 endif()
+install(FILES singleheader/simdjson.h DESTINATION ${CMAKE_INSTALL_INCLUDEDIR})

 option(SIMDJSON_ENABLE_THREADS "Link with thread support" ON)
-
-include(cmake/simdjson-props.cmake)
-include(cmake/implementation-flags.cmake)
-include(cmake/exception-flags.cmake)
-
-option(SIMDJSON_DISABLE_DEPRECATED_API "Disables deprecated APIs" OFF)
-if(SIMDJSON_DISABLE_DEPRECATED_API)
-  simdjson_add_props(
-      target_compile_definitions PUBLIC
-      SIMDJSON_DISABLE_DEPRECATED_API=1
-  )
-endif()
-
-if(${CMAKE_VERSION} VERSION_GREATER_EQUAL "3.25.0")
-    option(SIMDJSON_STATIC_REFLECTION "Enables static reflection (experimental), requires C++26" OFF)
-else()
-    set(SIMDJSON_STATIC_REFLECTION OFF CACHE BOOL "Enables static reflection (experimental)" FORCE)
-    message(WARNING "SIMDJSON_STATIC_REFLECTION is disabled because your CMake version is below 3.25")
-endif()
-
-if(SIMDJSON_STATIC_REFLECTION)
-  simdjson_add_props(
-      target_compile_definitions PUBLIC
-      SIMDJSON_STATIC_REFLECTION=1
-  )
-endif()
-
-option(SIMDJSON_DEVELOPMENT_CHECKS "Enable development-time aids, such as \
-checks for incorrect API usage. Enabled by default in DEBUG." OFF)
-if(SIMDJSON_DEVELOPMENT_CHECKS)
-  simdjson_add_props(
-      target_compile_definitions PUBLIC
-      SIMDJSON_DEVELOPMENT_CHECKS
-  )
-endif()
-
-if(is_top_project)
-  option(SIMDJSON_DEVELOPER_MODE "Enable targets for developing simdjson" OFF)
-  option(BUILD_SHARED_LIBS "Build simdjson as a shared library" OFF)
-  option(SIMDJSON_SINGLEHEADER "Disable singleheader generation" ON)
-endif()
-
-include(cmake/handle-deprecations.cmake)
-include(cmake/developer-options.cmake)
-
-# ---- simdjson library ----
-
-set(SIMDJSON_SOURCES src/simdjson.cpp)
-
-add_library(simdjson ${SIMDJSON_SOURCES})
-add_library(simdjson::simdjson ALIAS simdjson)
-set(SIMDJSON_LIBRARIES simdjson)
-
-if(SIMDJSON_BUILD_STATIC_LIB)
-  add_library(simdjson_static STATIC ${SIMDJSON_SOURCES})
-  add_library(simdjson::simdjson_static ALIAS simdjson_static)
-  list(APPEND SIMDJSON_LIBRARIES simdjson_static)
-endif()
-
-set_target_properties(
-    simdjson PROPERTIES
-    VERSION "${SIMDJSON_LIB_VERSION}"
-    SOVERSION "${SIMDJSON_LIB_SOVERSION}"
-    # FIXME: symbols should be hidden by default
-    WINDOWS_EXPORT_ALL_SYMBOLS YES
-)
-
-# FIXME: Use proper CMake integration for exports
-if(WIN32 AND BUILD_SHARED_LIBS)
-  target_compile_definitions(
-      simdjson
-      PRIVATE SIMDJSON_BUILDING_WINDOWS_DYNAMIC_LIBRARY=1
-      INTERFACE SIMDJSON_USING_WINDOWS_DYNAMIC_LIBRARY=1
-  )
-endif()
-
-simdjson_add_props(
-    target_include_directories
-    PUBLIC "$<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}/include>"
-    PRIVATE "$<BUILD_INTERFACE:${PROJECT_SOURCE_DIR}/src>"
-)
-
-if(SIMDJSON_STATIC_REFLECTION)
-  # We would like to require C++26, but no compiler supports that!
-  # This is a hack:
-  simdjson_add_props(
-      target_compile_options PUBLIC
-      -freflection -fexpansion-statements -stdlib=libc++ -std=c++26
-  )
-else()
-  simdjson_add_props(target_compile_features PUBLIC cxx_std_11)
-endif()
-
-# workaround for GNU GCC poor AVX load/store code generation
-if(
-    CMAKE_CXX_COMPILER_ID STREQUAL "GNU"
-    AND CMAKE_SYSTEM_PROCESSOR MATCHES "^(i.86|x86(_64)?)$"
-)
-  simdjson_add_props(
-      target_compile_options PRIVATE
-      -mno-avx256-split-unaligned-load -mno-avx256-split-unaligned-store
-  )
-endif()
-
-option(SIMDJSON_MINUS_ZERO_AS_FLOAT "Treat -0 as a floating-point value" OFF)
-
-if(SIMDJSON_MINUS_ZERO_AS_FLOAT)
-  simdjson_add_props(target_compile_definitions PRIVATE SIMDJSON_MINUS_ZERO_AS_FLOAT=1)
-endif(SIMDJSON_MINUS_ZERO_AS_FLOAT)
-
-if(CMAKE_SYSTEM_PROCESSOR MATCHES "^(loongarch64)$")
-    option(SIMDJSON_PREFER_LSX "Prefer LoongArch SX" ON)
-    include(CheckCXXCompilerFlag)
-    check_cxx_compiler_flag(-mlasx COMPILER_SUPPORTS_LASX)
-    check_cxx_compiler_flag(-mlsx COMPILER_SUPPORTS_LSX)
-    if(COMPILER_SUPPORTS_LASX AND NOT SIMDJSON_PREFER_LSX)
-        simdjson_add_props(
-            target_compile_options PRIVATE
-            -mlasx
-        )
-    elseif(COMPILER_SUPPORTS_LSX)
-        simdjson_add_props(
-            target_compile_options PRIVATE
-            -mlsx
-        )
-    endif()
-endif()
-
-# GCC and Clang have horrendous Debug builds when using SIMD.
-# A common fix is to use '-Og' instead.
-# bug https://gcc.gnu.org/bugzilla/show_bug.cgi?id=54412
-if(
-    (CMAKE_CXX_COMPILER_ID STREQUAL "GNU" OR
-        CMAKE_CXX_COMPILER_ID STREQUAL "Clang" OR
-        CMAKE_CXX_COMPILER_ID STREQUAL "AppleClang")
-)
-  message(STATUS "Adding -Og to compile flag")
-  simdjson_add_props(
-      target_compile_options PRIVATE
-      $<$<CONFIG:DEBUG>:-Og>
-  )
-endif()
-
-if(SIMDJSON_ENABLE_THREADS)
-  find_package(Threads REQUIRED)
-  simdjson_add_props(target_link_libraries PUBLIC Threads::Threads)
-  simdjson_add_props(target_compile_definitions PUBLIC SIMDJSON_THREADS_ENABLED=1)
-endif()
-
-simdjson_apply_props(simdjson)
-if(SIMDJSON_BUILD_STATIC_LIB)
-  simdjson_apply_props(simdjson_static)
-endif()
-
-# ---- Install rules ----
-
 include(CMakePackageConfigHelpers)
-include(GNUInstallDirs)
-
-if(SIMDJSON_SINGLEHEADER)
-  install(
-      FILES singleheader/simdjson.h
-      DESTINATION "${CMAKE_INSTALL_INCLUDEDIR}"
-      COMPONENT simdjson_Development
-  )
-endif()
-
-install(
-    TARGETS simdjson
-    EXPORT simdjsonTargets
-    RUNTIME COMPONENT simdjson_Runtime
-    LIBRARY COMPONENT simdjson_Runtime
-    NAMELINK_COMPONENT simdjson_Development
-    ARCHIVE COMPONENT simdjson_Development
-    INCLUDES DESTINATION "${CMAKE_INSTALL_INCLUDEDIR}"
-)
-configure_file(cmake/simdjson-config.cmake.in simdjson-config.cmake @ONLY)
-
+configure_package_config_file("${PROJECT_SOURCE_DIR}/cmake/simdjson-config.cmake.in"
+      "${PROJECT_BINARY_DIR}/simdjson-config.cmake"
+      INSTALL_DESTINATION "${CMAKE_INSTALL_LIBDIR}/cmake/simdjson"
+      NO_SET_AND_CHECK_MACRO
+      NO_CHECK_REQUIRED_COMPONENTS_MACRO)
 write_basic_package_version_file(
-    simdjson-config-version.cmake
-    COMPATIBILITY SameMinorVersion
-)
-
-set(
-    SIMDJSON_INSTALL_CMAKEDIR "${CMAKE_INSTALL_LIBDIR}/cmake/simdjson"
-    CACHE STRING "CMake package config location relative to the install prefix"
-)
-mark_as_advanced(SIMDJSON_INSTALL_CMAKEDIR)
-
-install(
-    FILES
-    "${PROJECT_BINARY_DIR}/simdjson-config.cmake"
-    "${PROJECT_BINARY_DIR}/simdjson-config-version.cmake"
-    DESTINATION "${SIMDJSON_INSTALL_CMAKEDIR}"
-    COMPONENT simdjson_Development
-)
-
-install(
-    EXPORT simdjsonTargets
-    NAMESPACE simdjson::
-    DESTINATION "${SIMDJSON_INSTALL_CMAKEDIR}"
-    COMPONENT simdjson_Development
-)
-
-if(SIMDJSON_BUILD_STATIC_LIB)
-  install(
-      TARGETS simdjson_static
-      EXPORT simdjson_staticTargets
-      ARCHIVE COMPONENT simdjson_Development
-      INCLUDES DESTINATION "${CMAKE_INSTALL_INCLUDEDIR}"
-  )
-  install(
-      EXPORT simdjson_staticTargets
-      NAMESPACE simdjson::
-      DESTINATION "${SIMDJSON_INSTALL_CMAKEDIR}"
-      COMPONENT simdjson_Development
-  )
-endif()
-
-# pkg-config
-include(cmake/JoinPaths.cmake)
-join_paths(PKGCONFIG_INCLUDEDIR "\${prefix}" "${CMAKE_INSTALL_INCLUDEDIR}")
-join_paths(PKGCONFIG_LIBDIR "\${prefix}" "${CMAKE_INSTALL_LIBDIR}")
-
-if(SIMDJSON_ENABLE_THREADS)
-  set(PKGCONFIG_CFLAGS "-DSIMDJSON_THREADS_ENABLED=1")
-  if(CMAKE_THREAD_LIBS_INIT)
-    set(PKGCONFIG_LIBS_PRIVATE "Libs.private: ${CMAKE_THREAD_LIBS_INIT}")
-  endif()
-endif()
-
-configure_file("simdjson.pc.in" "simdjson.pc" @ONLY)
-install(
-    FILES "${CMAKE_CURRENT_BINARY_DIR}/simdjson.pc"
-    DESTINATION "${CMAKE_INSTALL_LIBDIR}/pkgconfig"
-)
-
-#
-# CPack
-#
-if(is_top_project)
-  set(CPACK_PACKAGE_VENDOR "Daniel Lemire")
-  set(CPACK_PACKAGE_CONTACT "lemire@gmail.com")
-  set(CPACK_RESOURCE_FILE_LICENSE "${PROJECT_SOURCE_DIR}/LICENSE")
-  set(CPACK_RESOURCE_FILE_README "${PROJECT_SOURCE_DIR}/README.md")
-
-  set(CPACK_RPM_PACKAGE_LICENSE "${PROJECT_SOURCE_DIR}/LICENSE")
-
-  set(CPACK_SOURCE_GENERATOR "TGZ;ZIP")
-
-  include(CPack)
-endif()
-
-# ---- Developer mode extras ----
-
-if(is_top_project AND NOT SIMDJSON_DEVELOPER_MODE)
-  message(STATUS "Building only the library. Advanced users and contributors may want to turn SIMDJSON_DEVELOPER_MODE to ON, e.g., via -D SIMDJSON_DEVELOPER_MODE=ON.")
-elseif(SIMDJSON_DEVELOPER_MODE AND NOT is_top_project)
-  message(AUTHOR_WARNING "Developer mode in simdjson is intended for the developers of simdjson")
-endif()
-
-if(NOT SIMDJSON_DEVELOPER_MODE)
-  return()
-endif()
-
-simdjson_apply_props(simdjson-internal-flags)
-
-set(
-    SIMDJSON_USER_CMAKECACHE
-    "${CMAKE_BINARY_DIR}/.simdjson-user-CMakeCache.txt"
-)
-add_custom_target(
-    simdjson-user-cmakecache
-    COMMAND "${CMAKE_COMMAND}"
-    -D "BINARY_DIR=${CMAKE_BINARY_DIR}"
-    -D "USER_CMAKECACHE=${SIMDJSON_USER_CMAKECACHE}"
-    -P "${PROJECT_SOURCE_DIR}/cmake/simdjson-user-cmakecache.cmake"
-    VERBATIM
-)
-
-# Setup tests
-enable_testing()
-# So we can build just tests with "make all_tests"
-add_custom_target(all_tests)
-
-add_subdirectory(windows)
-include(cmake/CPM.cmake)
-add_subdirectory(dependencies) ## This needs to be before tools because of cxxopts
-add_subdirectory(tools)  ## This needs to be before tests because of cxxopts
-
-# Data: jsonexamples is left with only the bare essential.
-# most of the data has been moved to https://github.com/simdjson/simdjson-data
-add_subdirectory(jsonexamples)
-
-if(SIMDJSON_SINGLEHEADER)
-add_subdirectory(singleheader)
-endif()
-
-
+      "${PROJECT_BINARY_DIR}/simdjson-config-version.cmake"
+      VERSION ${SIMDJSON_SEMANTIC_VERSION}
+      COMPATIBILITY SameMinorVersion)
+install(FILES "${PROJECT_BINARY_DIR}/simdjson-config.cmake"
+              "${PROJECT_BINARY_DIR}/simdjson-config-version.cmake"
+        DESTINATION "${CMAKE_INSTALL_LIBDIR}/cmake/simdjson")

 #
 # Compile tools / tests / benchmarks
 #
-add_subdirectory(tests)
-add_subdirectory(examples)
-if(CMAKE_SIZEOF_VOID_P EQUAL 8) # we only include the benchmarks on 64-bit systems.
+if(NOT(SIMDJSON_JUST_LIBRARY))
+  add_subdirectory(tests)
+  add_subdirectory(examples)
  add_subdirectory(benchmark)
+  add_subdirectory(fuzz)
 endif()
-add_subdirectory(fuzz)

 #
 # Source files should be just ASCII
@@ -346,59 +76,29 @@ add_subdirectory(fuzz)
 find_program(FIND find)
 find_program(FILE file)
 find_program(GREP grep)
-if(FIND AND FILE AND GREP)
-  add_test(
-      NAME just_ascii
-      COMMAND sh -c "\
-${FIND} include src windows tools singleheader tests examples benchmark \
-path benchmark/checkperf-reference -prune -name '*.h' -o -name '*.cpp' \
-type f -exec ${FILE} '{}' \; | ${GREP} -qv ASCII || exit 0  && exit 1"
-      WORKING_DIRECTORY "${PROJECT_SOURCE_DIR}"
-  )
+if((FIND) AND (FILE) AND (GREP))
+    add_test(
+      NAME "just_ascii"
+      COMMAND sh -c "${FIND}  include src windows tools singleheader tests examples benchmark -path benchmark/checkperf-reference -prune -name '*.h'  -o -name '*.cpp' -type f  -exec ${FILE} '{}' \; |${GREP} -v ASCII || exit 0  && exit 1"
+      WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
+    )
 endif()

-##
-## In systems like R, libraries must not use stderr or abort to be acceptable.
-## Thus we make it a hard rule that one is not allowed to call abort or stderr.
-## The sanitized builds are allowed to abort.
-##
-if(NOT SIMDJSON_SANITIZE)
-  find_program(GREP grep)
-  find_program(NM nm)
-  if((NOT GREP) OR (NOT NM))
-    message("grep and nm are unavailable on this system.")
-  else()
-    add_test(
-      NAME "avoid_abort"
-      # Under FreeBSD, the __cxa_guard_abort symbol may appear but it is fine.
-      # So we want to look for <space><possibly _>abort as a test.
-      COMMAND sh -c "${NM}  $<TARGET_FILE_NAME:simdjson> |  ${GREP} ' _*abort' || exit 0  && exit 1"
-      WORKING_DIRECTORY ${PROJECT_BINARY_DIR}
-    )
-    add_test(
-      NAME "avoid_cout"
-      COMMAND sh -c "${NM}  $<TARGET_FILE_NAME:simdjson> |  ${GREP} ' _*cout' || exit 0  && exit 1"
-      WORKING_DIRECTORY ${PROJECT_BINARY_DIR}
-    )
-    add_test(
-      NAME "avoid_cerr"
-      COMMAND sh -c "${NM}  $<TARGET_FILE_NAME:simdjson> |  ${GREP} ' _*cerr' || exit 0  && exit 1"
-      WORKING_DIRECTORY ${PROJECT_BINARY_DIR}
-    )
-    add_test(
-      NAME "avoid_printf"
-      COMMAND sh -c "${NM}  $<TARGET_FILE_NAME:simdjson> |  ${GREP} ' _*printf' || exit 0  && exit 1"
-      WORKING_DIRECTORY ${PROJECT_BINARY_DIR}
-    )
-    add_test(
-      NAME "avoid_stdout"
-      COMMAND sh -c "${NM}  $<TARGET_FILE_NAME:simdjson> |  ${GREP} stdout || exit 0 && exit 1"
-      WORKING_DIRECTORY ${PROJECT_BINARY_DIR}
-    )
-    add_test(
-      NAME "avoid_stderr"
-      COMMAND sh -c "${NM}  $<TARGET_FILE_NAME:simdjson> |  ${GREP} stderr || exit 0 && exit 1"
-      WORKING_DIRECTORY ${PROJECT_BINARY_DIR}
-    )
-  endif()
-endif()
+
+#
+# CPack
+#
+set(CPACK_PACKAGE_VENDOR "Daniel Lemire")
+set(CPACK_PACKAGE_CONTACT "lemire@gmail.com")
+set(CPACK_PACKAGE_DESCRIPTION_SUMMARY "Parsing gigabytes of JSON per second")
+set(CPACK_PACKAGE_VERSION_MAJOR ${PROJECT_VERSION_MAJOR})
+set(CPACK_PACKAGE_VERSION_MINOR ${PROJECT_VERSION_MINOR})
+set(CPACK_PACKAGE_VERSION_PATCH ${PROJECT_VERSION_PATCH})
+set(CPACK_RESOURCE_FILE_LICENSE "${CMAKE_CURRENT_SOURCE_DIR}/LICENSE")
+set(CPACK_RESOURCE_FILE_README "${CMAKE_CURRENT_SOURCE_DIR}/README.md")
+
+set(CPACK_RPM_PACKAGE_LICENSE "${CMAKE_CURRENT_SOURCE_DIR}/LICENSE")
+
+set(CPACK_SOURCE_GENERATOR "TGZ;ZIP")
+
+include(CPack)
@@ -52,25 +52,24 @@ General Guidelines
 Contributors are encouraged to :

 - Document their changes. Though we do not enforce a rule regarding code comments, we prefer that non-trivial algorithms and techniques be somewhat documented in the code.
- Follow as much as possible the existing code style. We do not enforce a specific code style, but we prefer consistency. We avoid contractions (isn't, aren't) in the comments.
+- Follow as much as possible the existing code style. We do not enforce a specific code style, but we prefer consistency.
 - Modify as few lines of code as possible when working on an issue. The more lines you modify, the harder it is for your fellow human beings to understand what is going on.
- Tools may report "problems" with the code, but we never delegate programming to tools: if there is a problem with the code, we need to understand it. Thus we will not "fix" code merely to please a static analyzer.
+- Tools may report "problems" with the code, but we never delegate programming to tools: if there is a problem with the code, we need to understand it. Thus we will not "fix" code merely to please a static analyzer if we do not understand.
 - Provide tests for any new feature. We will not merge a new feature without tests.
- Run before/after benchmarks so that we can appreciate the effect of the changes on the performance.

 Pull Requests
 --------------

 Pull requests are always invited. However, we ask that you follow these guidelines:

- It is wise to discuss your ideas first as part of an issue before you start coding. If you omit this step and code first, be prepared to have your code receive scrutiny and be dropped.
- Users should provide a rationale for their changes. Does it improve performance? Does it add a feature? Does it improve maintainability? Does it fix a bug? This must be explicitly stated as part of the pull request. Do not propose changes based on taste or intuition. We do not delegate programming to tools: that some tool suggested a code change is not reason enough to change the code.
+- It is wiser to discuss your ideas first as part of an issue before you start coding. If you omit this step and code first, be prepare to have your code receive scrutiny and be dropped.
+- Users should provide a rationale for their changes. Does it improve performance? Does it add a feature? Does it improve maintainability? Does fix a bug? This must be explicitly stated as part of the pull request. Do not propose changes based on taste or intuition. We do not delegate programming to tools: that some tool suggested a code change is not reason enough to change the code.
   1. When your code improves performance, please document the gains with a benchmark using hard numbers.
-   2. If your code fixes a bug, please either fix a failing test, or propose a new test.
+   2. If your code fixes a bug, please be either fix a failing test, or propose a new test.
   3. Other types of changes must be clearly motivated. We openly discourage changes with no identifiable benefits.
 - Changes should be focused and minimal. You should change as few lines of code as possible. Please do not reformat or touch files needlessly.
- New features must be accompanied by new tests, in general.
- Your code should pass our continuous-integration tests. It is your responsibility to ensure that your proposal pass the tests. We do not merge pull requests that would break our build.
+- New features must be accompanied of new tests, in general.
+- Your code should pass our continuous-integration tests. It is your responsability to ensure that your proposal pass the tests. We do not merge pull requests that would break our build.
   - An exception to this would be changes to non-code files, such as documentation and assets, or trivial changes to code, such as comments, where it is encouraged to explicitly ask for skipping a CI run using the `[skip ci]` prefix in your Pull Request title **and** in the first line of the most recent commit in a push. Example for such a commit: `[skip ci] Fixed typo in power_of_ten's docs`
   This benefits the project in such a way that the CI pipeline is not burdened by running jobs on changes that don't change any behavior in the code, which reduces wait times for other Pull Requests that do change behavior and require testing.

@@ -92,7 +91,7 @@ We welcome contributions from women and less represented groups. If you need hel

 Consider the following points when engaging with the project:

- We discourage arguments from authority: ideas are discussed on their own merits and not based on who stated it.
+- We discourage arguments from authority: ideas are discusssed on their own merits and not based on who stated it.
 - Be mindful that what you may view as an aggression is maybe merely a difference of opinion or a misunderstanding.
 - Be mindful that a collection of small aggressions, even if mild in isolation, can become harmful.

@@ -36,10 +36,5 @@ Nong Li
 Furkan Taşkale
 Brendan Knapp
 Danila Kutenin
-Pavel Pavlov
-Hao Chen
-Nicolas Boyer
-Kim Walisch and Jatin Bhateja (AVX-512 bitset decoder)
-Fangzheng Zhang and Weiqiang Wan (AVX-512 kernel)
-# if you have contributed to the project and your name does not
+# if you have contributed to the project and your name does not 
 # appear in this list, please let us know!
@@ -0,0 +1,88 @@
+###
+#
+# Though simdjson requires only commonly available compilers and tools, it can
+# be convenient to build it and test it inside a docker container: it makes it
+# possible to test and benchmark simdjson under even relatively out-of-date
+# Linux servers. It should also work under macOS and Windows, though not
+# at native speeds, maybe.
+#
+# Assuming that you have a working docker server, this file
+# allows you to build, test and benchmark simdjson.
+#
+#  We build the library and associated files in the dockerbuild subdirectory.
+# It may be necessary to delete it before creating the image:
+#
+# rm -r -f dockerbuild
+#
+# The need to delete the directory has nothing to do with docker per se: it is
+# simply cleaner in CMake to start from a fresh directory. This is important: if you
+# reuse the same directory with different configurations, you may get broken builds.
+#
+#
+# Then you can build the image as follows:
+#
+# docker build -t simdjson --build-arg USER_ID=$(id -u)  --build-arg GROUP_ID=$(id -g) .
+#
+# Please note that the image does not contain a copy of the code. However, the image will contain the
+# the compiler and the build system. This means that if you change the source code, after you have built
+# the image, you won't need to rebuild the image. In fact, unless you want to try a different compiler, you
+# do not need to ever rebuild the image, even if you do a lot of work on the source code.
+#
+# We specify the users to avoid having files owned by a privileged user (root) in our directory. Some
+# people like to run their machine as the "root" user. We do not think it is cool.
+#
+# Then you need to build the project:
+#
+# docker run  -v $(pwd):/project:Z  simdjson
+#
+# Should you change a source file, you may need to call this command again. Because the output
+# files are persistent between calls to this command (they reside in the dockerbuild directory),
+# this command can be fast.
+#
+# Next you can test it as follows:
+#
+# docker run -it -v $(pwd):/project:Z   simdjson sh -c "cd dockerbuild && ctest . --output-on-failure -LE explicitonly"
+#
+# The run the complete tests requires you to have built all of simdjson.
+#
+# Building all of simdjson takes a long time. Instead, you can build just one target:
+#
+# docker run -it -v $(pwd):/project:Z  simdjson sh -c "[ -d dockerbuild ] || mkdir dockerbuild && cd dockerbuild && cmake ..  && cmake --build . --target parse"
+#
+# Note that it is safe to remove dockerbuild before call the previous command, as the repository gets rebuild. It is also possible, by changing the command, to use a different directory name.
+#
+# You can run performance tests:
+#
+# docker run -it --privileged -v $(pwd):/project:Z  simdjson sh -c "cd dockerbuild && for i in ../jsonexamples/*.json; do echo \$i; ./benchmark/parse \$i;  done"
+#
+# The "--privileged" is recommended so you can get performance counters under Linux.
+#
+# You can also grab a fresh copy of simdjson and rebuild it, to make comparisons:
+#
+# docker run -it -v $(pwd):/project:Z  simdjson sh -c "git clone https://github.com/simdjson/simdjson.git && cd simdjson && mkdir build && cd build && cmake .. && cmake --build . --target parse "
+#
+# Then you can run comparisons:
+#
+# docker run -it --privileged -v $(pwd):/project:Z  simdjson sh -c "for i in jsonexamples/*.json; do echo \$i; dockerbuild/benchmark/parse \$i| grep GB| head -n 1; simdjson/build/benchmark/parse \$i | grep GB |head -n 1;  done"
+#
+####
+FROM ubuntu:20.10
+################
+# We would prefer to use the conan io images but they do not support 64-bit ARM? The small gcc images appear to
+# be broken on ARM.
+# Furthermore, we would not expect users to frequently rebuild the container, so using ubuntu is probably fine.
+###############
+ARG USER_ID
+ARG GROUP_ID
+RUN apt-get update -qq
+RUN DEBIAN_FRONTEND="noninteractive" apt-get -y install tzdata
+RUN apt-get install -y cmake g++ git
+RUN mkdir project
+
+RUN addgroup --gid $GROUP_ID user; exit 0
+RUN adduser --disabled-password --gecos '' --uid $USER_ID --gid $GROUP_ID user; exit 0
+USER user
+RUN gcc --version
+WORKDIR /project
+
+CMD ["sh","-c","[ -d dockerbuild ] || mkdir dockerbuild && cd dockerbuild && cmake .. && cmake --build . "]
@@ -38,7 +38,7 @@ PROJECT_NAME           = simdjson
 # could be handy for archiving the generated documentation or if some version
 # control system is used.

-PROJECT_NUMBER         = "4.2.3"
+PROJECT_NUMBER         = "0.9.6"

 # Using the PROJECT_BRIEF tag one can provide an optional one line description
 # for a project that appears at the top of each page and should give viewer a
@@ -829,7 +829,7 @@ WARN_LOGFILE           =
 # spaces. See also FILE_PATTERNS and EXTENSION_MAPPING
 # Note: If this tag is empty the current directory is searched.

-INPUT                  = doc include/simdjson include/simdjson/dom include/simdjson/generic
+INPUT                  = doc include

 # This tag can be used to specify the character encoding of the source files
 # that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses
@@ -1246,10 +1246,7 @@ HTML_STYLESHEET        =
 # list). For an example see the documentation.
 # This tag requires that the tag GENERATE_HTML is set to YES.

-
-HTML_EXTRA_STYLESHEET  = theme/doxygen-awesome.css \
-                         theme/doxygen-awesome-sidebar-only.css \
-                         theme/doxygen-awesome-sidebar-only-darkmode-toggle.css
+HTML_EXTRA_STYLESHEET  =

 # The HTML_EXTRA_FILES tag can be used to specify one or more extra images or
 # other source files which should be copied to the HTML output directory. Note
@@ -1259,10 +1256,7 @@ HTML_EXTRA_STYLESHEET  = theme/doxygen-awesome.css \
 # files will be copied as-is; there are no commands or markers available.
 # This tag requires that the tag GENERATE_HTML is set to YES.

-HTML_EXTRA_FILES       = theme/doxygen-awesome-darkmode-toggle.js \
-                         theme/doxygen-awesome-interactive-toc.js \
-                         theme/doxygen-awesome-fragment-copy-button.js \
-                         theme/doxygen-awesome-paragraph-link.js
+HTML_EXTRA_FILES       =

 # The HTML_COLORSTYLE_HUE tag controls the color of the HTML output. Doxygen
 # will adjust the colors in the style sheet and background images according to
@@ -1549,7 +1543,7 @@ DISABLE_INDEX          = NO
 # The default value is: NO.
 # This tag requires that the tag GENERATE_HTML is set to YES.

-GENERATE_TREEVIEW      = YES
+GENERATE_TREEVIEW      = NO

 # The ENUM_VALUES_PER_LINE tag can be used to set the number of enum values that
 # doxygen will group on one line in the generated HTML documentation.
@@ -1,53 +0,0 @@
-# Final Changes Summary
-
-## Clean Repository State Achieved ✓
-
-### Ablation Study (`ablation/`)
- **run_ablation_study.sh** - Main ablation script that tests all optimization variants
- **citm_serialization_test.cpp** - CITM test program for ablation
- **ABLATION_RESULTS.md** - Documentation of expected results and methodology
-
-### Unified Benchmark (`benchmark/`)
- **unified_benchmark.cpp** - Complete benchmark comparing simdjson vs other libraries
- **build_unified_benchmark.sh** - Build script with automatic library detection
- **UNIFIED_BENCHMARK_RESULTS.md** - Documentation of benchmark results
-
-### Updated Files
- **.gitignore** - Added rules to exclude CSV results and benchmark binary
-
-### Removed Files
- All temporary scripts (ablation_study_*.sh, run_*.sh)
- All test files (citm_ablation_test.cpp, citm_ablation_simple.cpp)
- Old results directory (ablation_results/)
- citm_issue.md (no longer relevant)
-
-## How to Use
-
-### Run Unified Benchmark
-```bash
-cd /path/to/simdjson
-./benchmark/build_unified_benchmark.sh
-./benchmark/unified_benchmark
-```
-
-### Run Ablation Study
-```bash
-cd /path/to/simdjson
-./ablation/run_ablation_study.sh
-# Or with compilation time analysis:
-./ablation/run_ablation_study.sh --enable_compilation
-```
-
-## What Each Does
-
-**Unified Benchmark**: Compares simdjson (manual, reflection, from()) against nlohmann/json and RapidJSON using full Twitter and CITM datasets.
-
-**Ablation Study**: Measures the impact of individual optimizations (consteval, SIMD, fast digits, etc.) by disabling them one at a time.
-
-## Results Storage
-
- Ablation results go to `ablation/results/` (gitignored)
- Benchmark results are displayed on console
- Documentation files contain expected/typical results
-
-This is now ready to push to the repository!
@@ -1,4 +1,3 @@
-
 Hacking simdjson
 ================

@@ -6,67 +5,6 @@ Here is wisdom about how to build, test and run simdjson from within the reposit

 If you plan to contribute to simdjson, please read our [CONTRIBUTING](https://github.com/simdjson/simdjson/blob/master/CONTRIBUTING.md) guide.

- [Hacking simdjson](#hacking-simdjson)
-  - [Build Quickstart](#build-quickstart)
-  - [Design notes](#design-notes)
-  - [Developer mode](#developer-mode)
-  - [Directory Structure and Source](#directory-structure-and-source)
-  - [Runtime Dispatching](#runtime-dispatching)
-  - [Regenerating Single-Header Files](#regenerating-single-header-files)
-  - [Usage (CMake on 64-bit platforms like Linux, FreeBSD or macOS)](#usage-cmake-on-64-bit-platforms-like-linux-freebsd-or-macos)
-  - [Usage (CMake on 64-bit Windows using Visual Studio 2019 or better)](#usage-cmake-on-64-bit-windows-using-visual-studio-2019-or-better)
-  - [Various References](#various-references)
-
-Build Quickstart
------------------------------
-
-For non-Windows system,
-
-```bash
-cmake -B -D SIMDJSON_DEVELOPER_MODE=ON ..
-cmake --build build
-ctest --test-dir build
-```
-
-It is similar for Visual Studio users, please see the CMake or Visual Studio documentation.
-
-By default the library is built in Release mode.
-
-
-Assertions and development checks
------------------------------
-
-We do not use conventional `assert` in simdjson. Instead we use the macro
-`SIMDJSON_ASSUME`:
-
-```cpp
-SIMDJSON_ASSUME(something_that_is_true());
-```
-
-Sometimes, you need to do a bit more work that a simple check.
-The `SIMDJSON_DEVELOPMENT_CHECKS` macro is true only in Debug mode unless manually set.
-It is acceptable to add checks that you would not do in Release mode as long as
-they are guarded:
-
-```cpp
-#if SIMDJSON_DEVELOPMENT_CHECKS
-// do sanity checks here
-```
-
-
-Working with sanitizers
------------------------------
-
-The simdjson library must be memory-safe. We cannot allow buffer overruns.
-During development, if you system supports it, we recommend configuring
-the project with `-D SIMDJSON_SANITIZE=ON`.
-
-```bash
-cmake -B -D SIMDJSON_SANITIZE=ON -D SIMDJSON_DEVELOPER_MODE=ON ..
-cmake --build build
-ctest --test-dir build
-```
-

 Design notes
 ------------------------------
@@ -94,18 +32,6 @@ Stage 1 also does unicode validation.

 Stage 2 handles all of the rest: number parsings, recognizing atoms like true, false, null, and so forth.

-Developer mode
--------------
-
-Build system targets that are only useful for developers of the simdjson
-library are behind the `SIMDJSON_DEVELOPER_MODE` option. Enabling this option
-makes tests, examples, benchmarks and other developer targets available. Not
-enabling this option means that you are a consumer of simdjson and thus you
-only get the library targets and options.
-
-Developer mode is forced to be on when the `CI` environment variable is set to
-a value that CMake recognizes as "on", which is set to `true` in all of the CI
-workflows used by simdjson.

 Directory Structure and Source
 ------------------------------
@@ -114,58 +40,53 @@ simdjson's source structure, from the top level, looks like this:

 * **CMakeLists.txt:** The main build system.
 * **include:** User-facing declarations and inline definitions (most user-facing functions are inlined).
-  * simdjson.h: the `simdjson` namespace. A "main include" that includes files from include/simdjson/. This is equivalent to
+  * simdjson.h: A "main include" that includes files from include/simdjson/. This is equivalent to
    the distributed simdjson.h.
-    * simdjson/*.h: Declarations for public simdjson classes and functions.
-    * simdjson/*-inl.h: Definitions for public simdjson classes and functions.
-    * simdjson/internal/*.h: the `simdjson::internal` namespace. Private classes and functions used by the rest of simdjson.
-  * simdjson/dom.h: the `simdjson::dom` namespace. Includes all public DOM classes.
-    * simdjson/dom/*.h: Declarations/definitions for individual DOM classes.
-  * simdjson/arm64|fallback|haswell|icelake|ppc64|westmere.h: `simdjson::<implementation>` namespace. Common implementation-specific tools like number and string parsing, as well as minification.
-    * simdjson/arm64|fallback|haswell|icelake|ppc64|westmere/*.h: implementation-specific functions such as , etc.
-    * simdjson/generic/*.h: the bulk of the actual code, written generically and compiled for each implementation, using functions defined in the implementation's .h files.
-      * simdjson/generic/dependencies.h: dependencies on common, non-implementation-specific simdjson classes. This will be included before including amalgamated.h.
-      * simdjson/generic/amalgamated.h: all generic ondemand classes for an implementation.
-  * simdjson/ondemand.h: the `simdjson::ondemand` namespace. Includes all public ondemand classes.
-    * simdjson/builtin.h: the `simdjson::builtin` namespace. Aliased to the most universal implementation available.
-    * simdjson/builtin/ondemand.h: the `simdjson::builtin::ondemand` namespace.
-    * simdjson/arm64|fallback|haswell|icelake|ppc64|westmere/ondemand.h: the `simdjson::<implementation>::ondemand` namespace. On-Demand compiled for the specific implementation.
-    * simdjson/generic/ondemand/*.h: individual On-Demand classes, generically written.
-      * simdjson/generic/ondemand/dependencies.h: dependencies on common, non-implementation-specific simdjson classes. This will be included before including amalgamated.h.
-      * simdjson/generic/ondemand/amalgamated.h: all generic ondemand classes for an implementation.
+  * simdjson/*.h: Declarations for public simdjson classes and functions.
+  * simdjson/*-inl.h: Definitions for public simdjson classes and functions.
 * **src:** The source files for non-inlined functionality (e.g. the architecture-specific parser
  implementations).
  * simdjson.cpp: A "main source" that includes all implementation files from src/. This is
    equivalent to the distributed simdjson.cpp.
-  * *.cpp: other misc. implementations, such as `simdjson::implementation` and the minifier.
-  * arm64|fallback|haswell|icelake|ppc64|westmere.cpp: Architecture-specific parser implementations.
-    * generic/*.h: `simdjson::<implementation>` namespace. Generic implementation of the parser, particularly the `dom_parser_implementation`.
-    * generic/stage1/*.h: `simdjson::<implementation>::stage1` namespace. Generic implementation of the simd-heavy tokenizer/indexer pass of the simdjson parser. Used for the On-Demand interface
-    * generic/stage2/*.h: `simdjson::<implementation>::stage2` namespace. Generic implementation of the tape creator, which consumes the index from stage 1 and actually parses numbers and string and such. Used for the DOM interface.
+  * arm64/|fallback/|haswell/|ppc64/|westmere/: Architecture-specific implementations. All functions are
+    Each architecture defines its own namespace, e.g. simdjson::haswell.
+  * generic/: Generic implementations of the simdjson parser. These files may be included and
+    compiled multiple times, from whichever architectures use them. They assume they are already
+    enclosed in a namespace, e.g.:
+    ```c++
+    namespace simdjson {
+      namespace haswell {
+        #include "generic/stage1/json_structural_indexer.h"
+      }
+    }
+    ```

 Other important files and directories:
+* **.drone.yml:** Definitions for Drone CI.
+* **.appveyor.yml:** Definitions for Appveyor CI (Windows).
+* **.circleci:** Definitions for Circle CI.
 * **.github/workflows:** Definitions for GitHub Actions (CI).
 * **singleheader:** Contains generated `simdjson.h` and `simdjson.cpp` that we release. The files `singleheader/simdjson.h` and `singleheader/simdjson.cpp` should never be edited by hand.
-* **singleheader/amalgamate.py:** Generates `singleheader/simdjson.h` and `singleheader/simdjson.cpp` for release (python script). If you add a new implementation (e.g., rvv), you need to edit this file (IMPLEMENTATIONS).
+* **singleheader/amalgamate.py:** Generates `singleheader/simdjson.h` and `singleheader/simdjson.cpp` for release (python script).
 * **benchmark:** This is where we do benchmarking. Benchmarking is core to every change we make; the
  cardinal rule is don't regress performance without knowing exactly why, and what you're trading
-  for it. Many of our benchmarks are microbenchmarks. We are effectively doing controlled scientific experiments for the purpose of understanding what affects our performance. So we simplify as much as possible. We try to avoid irrelevant factors such as page faults, interrupts, unnecessary system calls. We recommend checking the performance as follows:
+  for it. Many of our benchmarks are microbenchmarks. We are effectively doing controlled scientific experiments for the purpose of understanding what affects our performance. So we simplify as much as possible. We try to avoid irrelevant factors such as page faults, interrupts, unnnecessary system calls. We recommend checking the performance as follows:
  ```bash
  mkdir build
  cd build
-  cmake -D SIMDJSON_DEVELOPER_MODE=ON ..
+  cmake ..
  cmake --build . --config Release
-  benchmark/dom/parse ../jsonexamples/twitter.json
+  benchmark/parse ../jsonexamples/twitter.json
  ```
  The last line becomes `./benchmark/Release/parse.exe ../jsonexample/twitter.json` under Windows. You may also use Google Benchmark:
  ```bash
  mkdir build
  cd build
-  cmake -D SIMDJSON_DEVELOPER_MODE=ON ..
+  cmake ..
  cmake --build . --target bench_parse_call --config Release
  ./benchmark/bench_parse_call
  ```
-  The last line becomes `./benchmark/Release/bench_parse_call.exe` under Windows. Under Windows, you can also build with the clang compiler by adding `-T ClangCL` to the call to `cmake ..`: `cmake -T ClangCL ..`.
+  The last line becomes `./benchmark/Release/bench_parse_call.exe` under Windows. Under Windows, you can also build with the clang compiler by adding `-T ClangCL` to the call to `cmake ..`: `cmake .. - TClangCL`.
 * **fuzz:** The source for fuzz testing. This lets us explore important edge and middle cases
 * **fuzz:** The source for fuzz testing. This lets us explore important edge and middle cases
  automatically, and is run in CI.
@@ -181,7 +102,7 @@ Other important files and directories:
  * `json2json mydoc.json` parses the document, constructs a model and then dumps back the result to standard output.
  * `json2json -d mydoc.json` parses the document, constructs a model and then dumps model (as a tape) to standard output. The tape format is described in the accompanying file `tape.md`.
  * `minify mydoc.json` minifies the JSON document, outputting the result to standard output. Minifying means to remove the unneeded white space characters.
-  * `jsonpointer mydoc.json <jsonpath> <jsonpath> ... <jsonpath>` parses the document, constructs a model and then processes a series of [JSON Pointer paths](https://tools.ietf.org/html/rfc6901). The result is itself a JSON document.
+  *`jsonpointer mydoc.json <jsonpath> <jsonpath> ... <jsonpath>` parses the document, constructs a model and then processes a series of [JSON Pointer paths](https://tools.ietf.org/html/rfc6901). The result is itself a JSON document.


 > **Don't modify the files in singleheader/ directly; these are automatically generated.**
@@ -226,7 +147,7 @@ processor.

 At this point, we are require to use one of two main strategies.

-1. On POSIX systems, the main compilers (LLVM clang, GNU gcc) allow us to use any intrinsic function after including the header, but they fail to inline the resulting instruction if the target processor does not support them. Because we compile for a generic processor, we would not be able to use most intrinsic functions. Thankfully, more recent versions of these compilers allow us to flag a region of code with a specific target, so that we can compile only some of the code with support for advanced instructions. Thus in our C++, one might notice macros like `TARGET_HASWELL`. It is then our responsibility, at runtime, to only run the regions of code (that we call kernels) matching the properties of the runtime processor. The benefit of this approach is that the compiler not only let us use intrinsic functions, but it can also optimize the rest of the code in the kernel with advanced instructions we enabled.
+1. On POSIX systems, the main compilers (LLVM clang, GNU gcc) allow us to use any intrinsic function after including the header, but they fail to inline the resulting instruction if the target processor does not support them. Because we compile for a generic processor, we would not be able to use most intrinsic functions. Thankfully, more recent versions of these compilers allow us to flag a region of code with a specific target, so that we can compile only some of the code with support for advanced instructions. Thus in our C++, one might notice macros like `TARGET_HASWELL`. It is then our responsability, at runtime, to only run the regions of code (that we call kernels) matching the properties of the runtime processor. The benefit of this approach is that the compiler not only let us use intrinsic functions, but it can also optimize the rest of the code in the kernel with advanced instructions we enabled.

 2. Under Visual Studio, the problem is somewhat simpler. Visual Studio will not only provide the intrinsic functions, but it will also allow us to use them. They will compile just fine. It is at runtime that they may cause a crash. So we do not need to mark regions of code for compilation toward advanced processors (e.g., with  `TARGET_HASWELL` macros). The downside of the Visual Studio approach is that the compiler is not allowed to use advanced instructions others than those we specify. In principle, this means that Visual Studio has weaker optimization opportunities.

@@ -247,7 +168,7 @@ systematically regenerated on releases. To ensure you have the latest code, you
 ```bash
 mkdir build
 cd build
-cmake -D SIMDJSON_DEVELOPER_MODE=ON ..
+cmake ..
 cmake --build . # needed, because currently dependencies do not work fully for the amalgamate target
 cmake --build . --target amalgamate
 ```
@@ -260,7 +181,7 @@ point it gets included (but only once per header). singleheader/simdjson.cpp is
 src/simdjson.cpp the same way, except files under generic/ may be included and copy/pasted multiple
 times.

-## Usage (CMake on 64-bit platforms like Linux, FreeBSD or macOS)
+### Usage (CMake on 64-bit platforms like Linux, FreeBSD or macOS)

 Requirements: In addition to git, we require a recent version of CMake as well as bash.

@@ -288,31 +209,31 @@ Building: While in the project repository, do the following:
 ```
 mkdir build
 cd build
-cmake -D SIMDJSON_DEVELOPER_MODE=ON ..
+cmake ..
 cmake --build .
 ctest
 ```

-CMake will build a library. By default, it builds a static library (e.g., libsimdjson.a on Linux).
+CMake will build a library. By default, it builds a shared library (e.g., libsimdjson.so on Linux).

-You can build a shared library:
+You can build a static library:

 ```
-mkdir buildshared
-cd buildshared
-cmake -D BUILD_SHARED_LIBS=ON -D SIMDJSON_DEVELOPER_MODE=ON ..
+mkdir buildstatic
+cd buildstatic
+cmake -DSIMDJSON_BUILD_STATIC=ON ..
 cmake --build .
 ctest
 ```

-In some cases, you may want to specify your compiler, especially if the default compiler on your system is too old.  You need to tell cmake which compiler you wish to use by setting the CC and CXX variables. Under bash, you can do so with commands such as `export CC=gcc-7` and `export CXX=g++-7`. You can also do it as part of the `cmake` command: `cmake -DCMAKE_CXX_COMPILER=g++ ..`.  You may proceed as follows:
+In some cases, you may want to specify your compiler, especially if the default compiler on your system is too old.  You need to tell cmake which compiler you wish to use by setting the CC and CXX variables. Under bash, you can do so with commands such as `export CC=gcc-7` and `export CXX=g++-7`. You can also do it as part of the `cmake` command: `cmake .. -DCMAKE_CXX_COMPILER=g++`.  You may proceed as follows:

 ```
 brew install gcc@8
 mkdir build
 cd build
 export CXX=g++-8 CC=gcc-8
-cmake -D SIMDJSON_DEVELOPER_MODE=ON ..
+cmake ..
 cmake --build .
 ctest
 ```
@@ -321,9 +242,9 @@ If your compiler does not default on C++11 support or better you may get failing

 Note that the name of directory (`build`) is arbitrary, you can name it as you want (e.g., `buildgcc`) and you can have as many different such directories as you would like (one per configuration).

-## Usage (CMake on 64-bit Windows using Visual Studio 2019 or better)

-Recent versions of Visual Studio support CMake natively, [please refer to the Visual Studio documentation](https://learn.microsoft.com/en-us/cpp/build/cmake-projects-in-visual-studio?view=msvc-170).
+
+### Usage (CMake on 64-bit Windows using Visual Studio 2019)

 We assume you have a common 64-bit Windows PC with at least Visual Studio 2019.

@@ -340,17 +261,19 @@ Though having Visual Studio installed is necessary, one can build simdjson using
 - `mkdir build`
 - `cd build`
 - `cmake ..`
- `cmake --build . --config Release`
+- `cmake --build . -config Release`


 Furthermore, if you have installed LLVM clang on Windows, for example as a component of Visual Studio 2019, you can configure and build simdjson using LLVM clang on Windows using cmake:

+
 - `mkdir build`
 - `cd build`
- `cmake -T ClangCL ..`
- `cmake --build . --config Release`
+- `cmake ..  -T ClangCL`
+- `cmake --build . -config Release`

-## Various References
+
+### Various References

 - [How to implement atoi using SIMD?](https://stackoverflow.com/questions/35127060/how-to-implement-atoi-using-simd)
 - [Parsing JSON is a Minefield 💣](http://seriot.ch/parsing_json.php)
@@ -186,7 +186,7 @@
      same "printed page" as the copyright notice for easier
      identification within third-party archives.

-   Copyright 2018-2025 The simdjson authors
+   Copyright 2018-2019 The simdjson authors 

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
@@ -1,18 +0,0 @@
-Copyright 2018-2025 The simdjson authors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of
-this software and associated documentation files (the "Software"), to deal in
-the Software without restriction, including without limitation the rights to
-use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
-the Software, and to permit persons to whom the Software is furnished to do so,
-subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
-FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
-COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
-IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
-CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
@@ -1,84 +0,0 @@
-# JSON Parsing Benchmark Results
-
-## Executive Summary
-Comprehensive benchmarks comparing JSON parsing performance across multiple libraries using two real-world datasets.
-
-## Test Environment
- **Date**: September 2025
- **Compiler**: Clang 21.0.0 with C++26 support
- **Platform**: Linux (aarch64 and x64)
- **Optimization**: `-O3`
- **Datasets**: Twitter (631KB), CITM Catalog (1.7MB)
- **Reflection**: Using C++26 static reflection (P2996) with consteval optimization
-
-
-**Hardware remarks**: The Intel Ice Lake processor has powerful SIMD support (AVX-512, two 512-bit execution units). The Apple processor runs at higher frequency and cna retire more instructions per cycle, while having weaker SIMD support (ARM NEON, four 128-bit execution units).
-
-## Twitter Dataset Results (631KB)
-### Intel Ice Lake
-| Library/Method | Throughput | Time/iter | Notes |
-|----------------|------------|-----------|-------|
-| **simdjson::from()** | 3.90 GB/s | 154.59 μs  | High-level API, uses C++26 reflection |
-| **simdjson (reflection)** | 3.75 GB/s | 160.60 μs | C++26 static reflection |
-| **simdjson (manual)** | 2.67 GB/s | 225.82 μs | Hand-written parsing code |
-| **yyjson** | 1.82 GB/s | 330.94 μs  | C library |
-| **Serde (Rust)** | 1.09 GB/s | 551.83 μs    | Via FFI |
-| **RapidJSON** | 387 MB/s | 1557.00 μs  | Full extraction |
-| **nlohmann/json** | 117 MB/s | 5346.73 μs  | Full extraction |
-
-### Apple Silicon
-| Library/Method | Throughput | Time/iter | Notes |
-|----------------|------------|-----------|-------|
-| **simdjson (manual)** | 4.36 GB/s | 138.04 μs | Hand-written parsing code |
-| **simdjson::from()** | 4.17 GB/s | 144.45 μs | High-level API, uses C++26 reflection |
-| **simdjson (reflection)** | 4.09 GB/s | 147.19 μs | C++26 static reflection |
-| **yyjson** | 2.23 GB/s | 269.71 μs | C library |
-| **Serde (Rust)** | 1.72 GB/s | 349.75 μs | Via FFI |
-| **RapidJSON** | 658 MB/s | 915.14 μs | Full extraction |
-| **nlohmann/json** | 172 MB/s | 3501.02 μs | Full extraction |
-
-## CITM Catalog Results (1.7MB)
-### Intel Ice Lake
-
-| Library/Method | Throughput | Time/iter | Notes |
-|----------------|------------|-----------|-------|
-| **simdjson (manual)** | 2.32 GB/s | 709.51 μs  | Manual parsing |
-| **simdjson (reflection)** | 1.85 GB/s | 890.34 μs  | C++26 static reflection |
-| **simdjson::from()** | 1.76 GB/s | 890.34 μs | Convenient API, uses C++26 reflection |
-| **yyjson** | 1.46 GB/s | 1130.75 μs | Full extraction |
-| **RapidJSON** | 552 GB/s | 2986.10 μs | Full extraction |
-| **Serde (Rust)** | 279 MB/s | 5903.36 μs  | Cross-language overhead |
-| **nlohmann/json** | 107187 MB/s |  15378.63 μs  | Full extraction |
-
-### Apple Silicon
-
-| Library/Method | Throughput | Time/iter | Notes |
-|----------------|------------|-----------|-------|
-| **simdjson (manual)** | 3.01 GB/s | 546.57 μs | Manual parsing |
-| **yyjson** | 2.68 GB/s | 614.32 μs | Full extraction |
-| **simdjson::from()** | 2.67 GB/s | 617.03 μs | Convenient API, uses C++26 reflection |
-| **simdjson (reflection)** | 2.66 GB/s | 620.07 μs | C++26 static reflection |
-| **RapidJSON** | 1.22 GB/s | 1354.62 μs | Full extraction |
-| **Serde (Rust)** | 535 MB/s | 3081.24 μs | Cross-language overhead |
-| **nlohmann/json** | 186 MB/s | 8874.02 μs | Full extraction |
-
-## Key Findings
-
-
-### Performance Leaders
- On Apple Silicon, **simdjson (manual)** tops both datasets: 4.36 GB/s for Twitter and 3.01 GB/s for CITM.
- On Intel Ice Lake, **simdjson::from()** leads Twitter at 3.90 GB/s, while **simdjson (manual)** leads CITM at 2.32 GB/s.
- simdjson variants consistently dominate the top positions across platforms and datasets, with yyjson as a strong contender especially on Apple Silicon for CITM (2.68 GB/s, nearly matching simdjson::from() at 2.67 GB/s).
-
-
-### Technology Insights
-1. **C++26 Reflection**: simdjson's reflection approach shows variability by platform and dataset, achieving 140% of manual performance on Intel for Twitter (3.75 GB/s vs. 2.67 GB/s) and 94% on Apple Silicon (4.09 GB/s vs. 4.36 GB/s), averaging about 111%; for CITM, it reaches 80% on Intel (1.85 GB/s vs. 2.32 GB/s) and 88% on Apple Silicon (2.66 GB/s vs. 3.01 GB/s), averaging 84%.
-2. **Native Performance**: C/C++ libraries (simdjson, yyjson, RapidJSON, nlohmann/json) significantly outperform Rust's Serde, whichranks near the bottom in all cases.
-3. **API Trade-offs**: High-level APIs like simdjson::from() incur minimal overhead, often matching or exceeding reflection and manual methods (e.g., leading on Intel Twitter with 3.90 GB/s).
-4. **Fair Comparison**: All libraries now extract complete data structures including nested objects
-
-## Methodology
- 3000 iterations for Twitter and CITM dataset
- Fresh parser instance per iteration (realistic usage)
- Full field extraction (no lazy evaluation)
- Warmup phase before timing
@@ -1,7 +1,9 @@
-[![][license img]][license] [![][licensemit img]][licensemit]
-
-
-[![Doxygen Documentation](https://img.shields.io/badge/docs-doxygen-green.svg)](https://simdjson.github.io/simdjson/)
+[![Fuzzing Status](https://oss-fuzz-build-logs.storage.googleapis.com/badges/simdjson.svg)](https://bugs.chromium.org/p/oss-fuzz/issues/list?sort=-opened&q=proj%3Asimdjson&can=2)
+![Ubuntu 18.04 CI](https://github.com/simdjson/simdjson/workflows/Ubuntu%2018.04%20CI%20(GCC%207)/badge.svg)
+[![Ubuntu 20.04 CI](https://github.com/simdjson/simdjson/workflows/Ubuntu%2020.04%20CI%20(GCC%209)/badge.svg)](https://simdjson.org/plots.html)
+![VS16-CI](https://github.com/simdjson/simdjson/workflows/VS16-CI/badge.svg)
+![MinGW64-CI](https://github.com/simdjson/simdjson/workflows/MinGW64-CI/badge.svg)
+[![][license img]][license]  [![Doxygen Documentation](https://img.shields.io/badge/docs-doxygen-green.svg)](https://simdjson.org/api/0.9.0/index.html)

 simdjson : Parsing gigabytes of JSON per second
 ===============================================
@@ -24,52 +26,17 @@ This library is part of the [Awesome Modern C++](https://awesomecpp.com) list.
 Table of Contents
 -----------------

-* [Real-world usage](#real-world-usage)
 * [Quick Start](#quick-start)
+  * [On Demand](#on-demand)
 * [Documentation](#documentation)
-* [Godbolt](#godbolt)
 * [Performance results](#performance-results)
-* [Packages](#packages)
+* [Real-world usage](#real-world-usage)
 * [Bindings and Ports of simdjson](#bindings-and-ports-of-simdjson)
 * [About simdjson](#about-simdjson)
 * [Funding](#funding)
 * [Contributing to simdjson](#contributing-to-simdjson)
 * [License](#license)

-
-Real-world usage
----------------
-
- [Node.js](https://nodejs.org/)
- [ClickHouse](https://github.com/ClickHouse/ClickHouse)
- [Meta Velox](https://velox-lib.io)
- [Google Pax](https://github.com/google/paxml)
- [milvus](https://github.com/milvus-io/milvus)
- [QuestDB](https://questdb.io/blog/questdb-release-8-0-3/)
- [Clang Build Analyzer](https://github.com/aras-p/ClangBuildAnalyzer)
- [Shopify HeapProfiler](https://github.com/Shopify/heap-profiler)
- [StarRocks](https://github.com/StarRocks/starrocks)
- [Microsoft FishStore](https://github.com/microsoft/FishStore)
- [Intel PCM](https://github.com/intel/pcm)
- [WatermelonDB](https://github.com/Nozbe/WatermelonDB)
- [Apache Doris](https://github.com/apache/doris)
- [Dgraph](https://github.com/dgraph-io/dgraph)
- [UJRPC](https://github.com/unum-cloud/ujrpc)
- [fastgltf](https://github.com/spnda/fastgltf)
- [vast](https://github.com/tenzir/vast)
- [ada-url](https://github.com/ada-url/ada)
- [fastgron](https://github.com/adamritter/fastgron)
- [WasmEdge](https://wasmedge.org)
- [RonDB](https://github.com/logicalclocks/rondb)
- [GreptimeDB](https://github.com/GreptimeTeam/greptimedb)
- [mamba](https://github.com/mamba-org/mamba)
-
-
-If you are planning to use simdjson in a product, please work from one of our releases.
-
-
-
-
 Quick Start
 -----------

@@ -77,17 +44,16 @@ The simdjson library is easily consumable with a single .h and .cpp file.

 0. Prerequisites: `g++` (version 7 or better) or `clang++` (version 6 or better), and a 64-bit
   system with a command-line shell (e.g., Linux, macOS, freeBSD). We also support programming
-   environments like Visual Studio and Xcode, but different steps are needed. Users of clang++ may need to specify the C++ version (e.g., `c++ -std=c++17`) since clang++ tends to default on C++98.
+   environments like Visual Studio and Xcode, but different steps are needed.
 1. Pull [simdjson.h](singleheader/simdjson.h) and [simdjson.cpp](singleheader/simdjson.cpp) into a
-   directory, along with the sample file [twitter.json](jsonexamples/twitter.json). You can download them with the `wget` utility:
+   directory, along with the sample file [twitter.json](jsonexamples/twitter.json).

   ```
   wget https://raw.githubusercontent.com/simdjson/simdjson/master/singleheader/simdjson.h https://raw.githubusercontent.com/simdjson/simdjson/master/singleheader/simdjson.cpp https://raw.githubusercontent.com/simdjson/simdjson/master/jsonexamples/twitter.json
   ```
 2. Create `quickstart.cpp`:

-```cpp
-#include <iostream>
+```c++
 #include "simdjson.h"
 using namespace simdjson;
 int main(void) {
@@ -96,14 +62,13 @@ int main(void) {
    ondemand::document tweets = parser.iterate(json);
    std::cout << uint64_t(tweets["search_metadata"]["count"]) << " results." << std::endl;
 }
-```
+
+   ```
 3. `c++ -o quickstart quickstart.cpp simdjson.cpp`
 4. `./quickstart`
-
-  ```
+   ```
   100 results.
-  ```
-
+   ```

 Documentation
 -------------
@@ -111,21 +76,10 @@ Documentation
 Usage documentation is available:

 * [Basics](doc/basics.md) is an overview of how to use simdjson and its APIs.
-* [Builder](doc/builder.md) is an overview of how to efficiently write JSON strings using simdjson.
 * [Performance](doc/performance.md) shows some more advanced scenarios and how to tune for them.
 * [Implementation Selection](doc/implementation-selection.md) describes runtime CPU detection and
  how you can work with it.
-* [API](https://simdjson.github.io/simdjson/) contains the automatically generated API documentation.
-* [Compile-Time Parsing](doc/compile_time.md) presents our compile-time parsing function (C++26 only).
-
-
-Godbolt
-------------
-
-Some users may want to browse code along with the compiled assembly. You want to check out the following lists of examples:
-* [C++26 reflection example](https://godbolt.org/z/K3Px64TqK)
-* [simdjson examples with errors handled through exceptions](https://godbolt.org/z/7G5qE4sr9)
-* [simdjson examples with errors without exceptions](https://godbolt.org/z/e9dWb9E4v)
+* [API](https://simdjson.org/api/0.9.0/annotated.html) contains the automatically generated API documentation.

 Performance results
 -------------------
@@ -153,10 +107,16 @@ speed for [synthetic files over various sizes generated with a script](https://g
 For NDJSON files, we can exceed 3 GB/s with [our  multithreaded parsing functions](https://github.com/simdjson/simdjson/blob/master/doc/parse_many.md).


-Packages
------------------------------
-[![Packaging status](https://repology.org/badge/vertical-allrepos/simdjson.svg)](https://repology.org/project/simdjson/versions)

+Real-world usage
+----------------
+
+- [Microsoft FishStore](https://github.com/microsoft/FishStore)
+- [Yandex ClickHouse](https://github.com/yandex/ClickHouse)
+- [Clang Build Analyzer](https://github.com/aras-p/ClangBuildAnalyzer)
+- [Shopify HeapProfiler](https://github.com/Shopify/heap-profiler)
+
+If you are planning to use simdjson in a product, please work from one of our releases.

 Bindings and Ports of simdjson
 ------------------------------
@@ -177,15 +137,7 @@ We distinguish between "bindings" (which just wrap the C++ code) and a port to a
 - [simdjson-go](https://github.com/minio/simdjson-go): Go port using Golang assembly.
 - [rcppsimdjson](https://github.com/eddelbuettel/rcppsimdjson): R bindings.
 - [simdjson_erlang](https://github.com/ChomperT/simdjson_erlang): erlang bindings.
- [simdjsone](https://github.com/saleyn/simdjsone): erlang bindings.
- [lua-simdjson](https://github.com/FourierTransformer/lua-simdjson): lua bindings.
- [hermes-json](https://hackage.haskell.org/package/hermes-json): haskell bindings.
- [zimdjson](https://github.com/EzequielRamis/zimdjson): Zig port.
- [simdjzon](https://github.com/travisstaloch/simdjzon): Zig port.
- [JSON-Simd](https://github.com/rawleyfowler/JSON-simd): Raku bindings.
- [JSON::SIMD](https://metacpan.org/pod/JSON::SIMD): Perl bindings; fully-featured JSON module that uses simdjson for decoding.
- [gemmaJSON](https://github.com/sainttttt/gemmaJSON): Nim JSON parser based on simdjson bindings.
- [simdjson-java](https://github.com/simdjson/simdjson-java): Java port.
+

 About simdjson
 --------------
@@ -194,60 +146,40 @@ The simdjson library takes advantage of modern microarchitectures, parallelizing
 instructions, reducing branch misprediction, and reducing data dependency to take advantage of each
 CPU's multiple execution cores.

-Our default front-end is called On-Demand, and we wrote a paper about it:
-
- John Keiser, Daniel Lemire, [On-Demand JSON: A Better Way to Parse Documents?](http://arxiv.org/abs/2312.17149), Software: Practice and Experience 54 (6), 2024.
-
-Some people [enjoy reading the first (2019) simdjson paper](https://arxiv.org/abs/1902.08318): A description of the design
+Some people [enjoy reading our paper](https://arxiv.org/abs/1902.08318): A description of the design
 and implementation of simdjson is in our research article:
 - Geoff Langdale, Daniel Lemire, [Parsing Gigabytes of JSON per Second](https://arxiv.org/abs/1902.08318), VLDB Journal 28 (6), 2019.

 We have an in-depth paper focused on the UTF-8 validation:

- John Keiser, Daniel Lemire, [Validating UTF-8 In Less Than One Instruction Per Byte](https://arxiv.org/abs/2010.03090), Software: Practice & Experience 51 (5), 2021.
+- John Keiser, Daniel Lemire, [Validating UTF-8 In Less Than One Instruction Per Byte](https://arxiv.org/abs/2010.03090), Software: Practice & Experience (to appear)

 We also have an informal [blog post providing some background and context](https://branchfree.org/2019/02/25/paper-parsing-gigabytes-of-json-per-second/).

 For the video inclined, <br />
 [![simdjson at QCon San Francisco 2019](http://img.youtube.com/vi/wlvKAT7SZIQ/0.jpg)](http://www.youtube.com/watch?v=wlvKAT7SZIQ)<br />
-(It was the best voted talk, we're kinda proud of it.)
+(it was the best voted talk, we're kinda proud of it).

 Funding
 -------

-The work is supported by the Natural Sciences and Engineering Research Council of Canada under grants
-RGPIN-2017-03910 and RGPIN-2024-03787.
+The work is supported by the Natural Sciences and Engineering Research Council of Canada under grant
+number RGPIN-2017-03910.

 [license]: LICENSE
 [license img]: https://img.shields.io/badge/License-Apache%202-blue.svg

-
-[licensemit]: LICENSE-MIT
-[licensemit img]: https://img.shields.io/badge/License-MIT-blue.svg
-
-
 Contributing to simdjson
 ------------------------

 Head over to [CONTRIBUTING.md](CONTRIBUTING.md) for information on contributing to simdjson, and
 [HACKING.md](HACKING.md) for information on source, building, and architecture/design.

-
-Stars
------
-
-[![Star History Chart](https://api.star-history.com/svg?repos=simdjson/simdjson&type=Date)](https://www.star-history.com/#simdjson/simdjson&Date)
-
-
 License
 -------

-This code is made available under the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0.html) as well as under the MIT License. As a user, you can pick the license you prefer.
+This code is made available under the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0.html).

-Under Windows, we build some tools using the windows/dirent_portable.h file (which is outside our library code): it is under the liberal (business-friendly) MIT license.
+Under Windows, we build some tools using the windows/dirent_portable.h file (which is outside our library code): it under the liberal (business-friendly) MIT license.

-For compilers that do not support [C++17](https://en.wikipedia.org/wiki/C%2B%2B17), we bundle the string-view library which is published under the [Boost license](http://www.boost.org/LICENSE_1_0.txt). Like the Apache license, the Boost license is a permissive license allowing commercial redistribution.
-
-For efficient number serialization, we bundle Florian Loitsch's implementation of the Grisu2 algorithm for binary to decimal floating-point numbers. The implementation was slightly modified by JSON for Modern C++ library. Both Florian Loitsch's implementation and JSON for Modern C++ are provided under the MIT license.
-
-For runtime dispatching, we use some code from the PyTorch project licensed under 3-clause BSD.
+For compilers that do not support [C++17](https://en.wikipedia.org/wiki/C%2B%2B17), we bundle the string-view library which is published under the Boost license (http://www.boost.org/LICENSE_1_0.txt). Like the Apache license, the Boost license is a permissive license allowing commercial redistribution.
@@ -0,0 +1,69 @@
+# 0.5
+
+## Highlights
+
+Performance
+* Faster and simpler UTF-8 validation with the lookup4 algorithm https://github.com/simdjson/simdjson/pull/993
+* We improved the performance of simdjson under Visual Studio by about 25%. Users will still get better performance with clang-cl (+30%) but the gap has been reduced. https://github.com/simdjson/simdjson/pull/1031
+
+Code usability
+* In `parse_many`, when parsing streams of JSON documetns, we give to the users runtime control as to whether threads are used (via the parser.threaded attribute). https://github.com/simdjson/simdjson/issues/925
+* Prefixed public macros to avoid name clashes with other libraries. https://github.com/simdjson/simdjson/issues/1035
+* Better documentation regarding package managers (brew, MSYS2, conan, apt, vcpkg, FreeBSD package manager, etc.).
+* Better documentation regarding  CMake usage.
+
+Standards
+* We improved standard compliance with respect to both the JSON RFC 8259 and JSON Pointer RFC 6901. We added the at_pointer method to nodes for standard-compliant JSON Pointer queries. The legacy `at(std::string_view)` method remains but is deprecated since it is not standard-compliant as per  RFC 6901.
+* We removed computed GOTOs without sacrificing performance thus improving the C++ standard compliance (since computed GOTOs are compiler-specific extensions).
+* Better support for C++20 https://github.com/simdjson/simdjson/pull/1050
+
+# 0.4
+
+## Highlights
+
+- Test coverage has been greatly improved and we have resolved many static-analysis warnings on different systems.
+- We added a fast (8GB/s) minifier that works directly on JSON strings.
+- We added fast (10GB/s) UTF-8 validator that works directly on strings (any strings, including non-JSON).
+- The array and object elements have a constant-time size() method.
+- Performance improvements to the API (type(), get<>()).
+- The parse_many function (ndjson) has been entirely reworked. It now uses a single secondary thread instead of several new threads.
+- We have introduced a faster UTF-8 validation algorithm (lookup3) for all kernels (ARM, x64 SSE, x64 AVX).
+- C++11 support for older compilers and systems.
+- FreeBSD support (and tests).
+- We support the clang front-end compiler (clangcl) under Visual Studio.
+- It is now possible to target ARM platforms under Visual Studio.
+- The simdjson library will never abort or print to standard output/error.
+
+# 0.3
+
+## Highlights
+
+- **Multi-Document Parsing:** Read a bundle of JSON documents (ndjson) 2-4x faster than doing it
+  individually. [API docs](https://github.com/simdjson/simdjson/blob/master/doc/basics.md#newline-delimited-json-ndjson-and-json-lines) / [Design Details](https://github.com/simdjson/simdjson/blob/master/doc/parse_many.md)
+- **Simplified API:** The API has been completely revamped for ease of use, including a new JSON
+  navigation API and fluent support for error code *and* exception styles of error handling with a
+  single API. [Docs](https://github.com/simdjson/simdjson/blob/master/doc/basics.md#the-basics-loading-and-parsing-json-documents)
+- **Exact Float Parsing:** Now simdjson parses floats flawlessly *without* any performance loss,
+  thanks to [great work by @michaeleisel and @lemire](https://github.com/simdjson/simdjson/pull/558).
+  [Blog Post](https://lemire.me/blog/2020/03/10/fast-float-parsing-in-practice/)
+- **Even Faster:** The fastest parser got faster! With a [shiny new UTF-8 validator](https://github.com/simdjson/simdjson/pull/387)
+  and meticulously refactored SIMD core, simdjson 0.3 is 15% faster than before, running at 2.5 GB/s
+  (where 0.2 ran at 2.2 GB/s).
+
+## Minor Highlights
+
+- Fallback implementation: simdjson now has a non-SIMD fallback implementation, and can run even on
+  very old 64-bit machines.
+- Automatic allocation: as part of API simplification, the parser no longer has to be preallocated--
+  it will adjust automatically when it encounters larger files.
+- Runtime selection API: We've exposed simdjson's runtime CPU detection and implementation selection
+  as an API, so you can tell what implementation we detected and test with other implementations.
+- Error handling your way: Whether you use exceptions or check error codes, simdjson lets you handle
+  errors in your style. APIs that can fail return simdjson_result<T>, letting you check the error
+  code before using the result. But if you are more comfortable with exceptions, skip the error code
+  and cast straight to T, and exceptions will be thrown automatically if an error happens. Use the
+  same API either way!
+- Error chaining: We also worked to keep non-exception error-handling short and sweet. Instead of
+  having to check the error code after every single operation, now you can *chain* JSON navigation
+  calls like looking up an object field or array element, or casting to a string, so that you only
+  have to check the error code once at the very end.
@@ -1,7 +0,0 @@
-# Security Policy
-
-## Reporting a Vulnerability
-
-Please use the following contact information for reporting a vulnerability:
-
- [Daniel Lemire](https://github.com/lemire) - daniel@lemire.me
@@ -1,84 +0,0 @@
-# JSON Serialization Benchmark Results
-
-## Executive Summary
-Performance comparison of JSON serialization (C++ structs → JSON) across multiple libraries.
-
-## Test Environment
- **Date**: September 2025
- **Compiler**: Clang 21.0.0 with C++26 support
- **Platform**: Linux (aarch64 and x64)
- **Optimization**: `-O3` (we do not use `-march=native` or other flags)
- **Datasets**: Twitter (631KB), CITM Catalog (1.7MB)
- **Consteval**: Enabled with `std::define_static_string` for compile-time key generation
-
-**Software remarks**: The simdjson library makes little use of SIMD instructions when serializing.
-
-**Hardware remarks**: The Intel Ice Lake processor has powerful SIMD support (AVX-512, two 512-bit execution units). The Apple processor runs at higher frequency and cna retire more instructions per cycle, while having weaker SIMD support (ARM NEON, four 128-bit execution units).
-
-
-## Twitter Dataset Results (631KB)
-
-### Intel Ice Lake
-| Library/Method | Throughput | Time/iter | Notes |
-|----------------|------------|-----------|-------|
-| **simdjson (reflection)** | 3.48 GB/s | 23.24 μs | C++26 static reflection with consteval |
-| **yyjson** | 2.07 GB/s | 39.11 μs | C library |
-| **simdjson (DOM)** | 1.66 GB/s | 48.85 μs | Manual DOM serialization |
-| **Serde (Rust)** | 1.34 GB/s | 60.38 μs | Via FFI |
-| **RapidJSON** | 494 MB/s | 163.86 μs | DOM-based |
-| **nlohmann/json** | 243 MB/s | 333.51 μs | Slowest |
-
-### Apple Silicon
-| Library/Method | Throughput | Time/iter | Notes |
-|----------------|------------|-----------|-------|
-| **simdjson (reflection)** | 3.52 GB/s | 23.00 μs | C++26 static reflection with consteval |
-| **yyjson** | 2.08 GB/s | 38.94 μs | C library |
-| **simdjson (DOM)** | 1.67 GB/s | 48.36 μs | Manual DOM serialization |
-| **Serde (Rust)** | 1.32 GB/s | 61.28 μs | Via FFI |
-| **RapidJSON** | 861 MB/s | 94.04 μs | DOM-based |
-| **nlohmann/json** | 242 MB/s | 334.18 μs | Slowest |
-
-## CITM Catalog Results (1.7MB)
-
-### Intel Ice Lake
-| Library/Method | Throughput | Time/iter | Notes |
-|----------------|------------|-----------|-------|
-| **simdjson (reflection)** | 2.10 GB/s | 226.78 μs | Fastest with consteval optimization |
-| **yyjson** | 1.68 GB/s | 283.64 μs | C library |
-| **Serde (Rust)** | 1.16 GB/s | 411.79 μs | Strong performance |
-| **simdjson (DOM)** | 799 MB/s | 597.50 μs | Manual implementation |
-| **RapidJSON** | 571 MB/s | 835.23 μs | DOM-based |
-| **nlohmann/json** | 127 MB/s | 3747.76 μs | Slowest |
-
-### Apple Silicon
-| Library/Method | Throughput | Time/iter | Notes |
-|----------------|------------|-----------|-------|
-| **simdjson (reflection)** | 2.25 GB/s | 212.06 μs | Fastest with consteval optimization |
-| **yyjson** | 1.67 GB/s | 286.43 μs | C library |
-| **Serde (Rust)** | 1.17 GB/s | 408.82 μs | Strong performance |
-| **simdjson (DOM)** | 780 MB/s | 612.03 μs | Manual implementation |
-| **RapidJSON** | 354 MB/s | 1349.76 μs | DOM-based |
-| **nlohmann/json** | 125 MB/s | 3831.37 μs | Slowest |
-
-## Key Findings
-
-### Performance Leaders
- **simdjson (reflection)**  leads across all tests, peaking at 3.52 GB/s on Twitter (Apple Silicon) and 2.25 GB/s on CITM (Apple Silicon), showcasing best-in-class serialization performance.
- **yyjson** consistently ranks second, achieving 2.08 GB/s on Twitter (Apple Silicon) and 1.68 GB/s on CITM (Intel Ice Lake), competitive but trailing simdjson by 1.5-1.7x.
- Traditional libraries (RapidJSON, nlohmann/json) lag significantly, with nlohmann/json being the slowest at 242-243 MB/s on Twitter and 125-127 MB/s on CITM, roughly 14-30x slower than simdjson (reflection).
-
-### Technology Insights
-
-1. **Consteval Impact**: Using `std::define_static_string` for compile-time JSON key generation significantly boosts performance, enabling simdjson (reflection) to achieve up to 3.52 GB/s on Twitter, a 1.7-2.1x improvement over non-consteval methods like yyjson.
-2. **Memory Management**: String builder reuse combined with consteval key generation optimizes memory allocation, contributing to simdjson (reflection)'s superior performance across datasets and platforms.
-3. **Platform Differences**: Apple Silicon slightly edges out Intel Ice Lake for simdjson (reflection) on both datasets (3.52 GB/s vs. 3.48 GB/s on Twitter, 2.25 GB/s vs. 2.10 GB/s on CITM), likely due to higher frequency and instruction retirement, despite weaker SIMD support (ARM NEON vs. AVX-512).
-4. **Serde (Rust)** trails C/C++ libraries by 1.8-3x.
-5. **Reflection Performance**: C++26 reflection with consteval outperforms all alternatives
-
-
-## Methodology
- 3000 iterations for Twitter and CITM dataset
- String builder reuse for simdjson (realistic optimization)
- Full serialization with proper JSON escaping
- Warmup phase before timing
- Consteval optimization with `std::define_static_string`
@@ -1,497 +0,0 @@
-# Reflection-based Serialization Ablation Study
-
-This document tracks the performance impact of various optimizations in the reflection-based serialization implementation for simdjson.
-
-## Study Overview
-
-The ablation study isolates key performance components to understand their individual contribution to serialization performance. We test each variant against the Twitter benchmark dataset.
-
-## Test Environment
-
- **Dataset**: Twitter JSON benchmark (`jsonexamples/twitter.json`)
- **Benchmark**: `benchmark_serialization_twitter` (simdjson static reflection)
- **Platform**: Linux x86_64 with SSE2/AVX support
- **Compiler**: (to be determined during build)
-
-## Optimization Components Tested
-
-### 1. SIMD String Escaping
-**Location**: `json_string_builder-inl.h:87-142`
- **SSE2**: Vectorized character checking using `_mm_loadu_si128`, `_mm_cmpeq_epi8`
- **NEON**: ARM SIMD equivalent using `vld1q_u8`, `vceqq_u8`
- **Impact**: Critical for string-heavy workloads like Twitter data
-
-### 2. Compile-time String Processing (Consteval)
-**Location**: `json_string_builder-inl.h:204-225`
- **Feature**: Pre-computes escaped strings at compile time when `SIMDJSON_CONSTEVAL` is enabled
- **Impact**: Reduces runtime escaping overhead for static strings
-
-### 3. Fast Digit Counting
-**Location**: `json_string_builder-inl.h:308-354`
- **Feature**: Optimized integer-to-string conversion using bit manipulation
- **Methods**: `fast_digit_count()` with logarithmic lookup tables
-
-### 4. Decimal Lookup Tables
-**Location**: `json_string_builder-inl.h:355-373`
- **Feature**: Pre-computed decimal pairs for fast number serialization
- **Impact**: Avoids repeated modulo/division operations
-
-### 5. Vectorized Number Serialization
-**Location**: `json_string_builder-inl.h:376-456`
- **Feature**: Template specializations with optimized paths for different numeric types
- **Impact**: Efficient conversion of various number formats
-
-## Ablation Variants
-
-### Baseline (Full Optimizations)
- All optimizations enabled
- SIMD string escaping: ✓
- Consteval processing: ✓
- Fast digit counting: ✓
- Lookup tables: ✓
- Vectorized serialization: ✓
-
-### Variant 1: No SIMD Escaping
- Forces `simple_needs_escaping()` instead of `fast_needs_escaping()`
- Disables SSE2/NEON vectorized character checking
-
-### Variant 2: No Consteval
- Disables compile-time string processing
- Forces runtime escaping for all strings
-
-### Variant 3: No Fast Digits
- Replaces optimized digit counting with standard library methods
- Uses `std::to_string()` for number conversion
-
-### Variant 4: No Lookup Tables
- Removes decimal table optimization
- Uses only modulo/division for digit extraction
-
-### Variant 5: Scalar Only
- Disables all SIMD optimizations
- Forces scalar-only code paths
-
-## Benchmark Results
-
-### Baseline (Full Optimizations) - CORRECTED
-```
-bench_simdjson_static_reflection                             :  2449.25 MB/s   0.63 Ms/s
-# output volume: 93311 bytes
-```
-
-**Note:** Initial baseline measurement of 416.69 MB/s was incorrect due to different build configuration.
-
-### Variant 1: No SIMD Escaping
-```
-bench_simdjson_static_reflection                             :  2380.46 MB/s   0.61 Ms/s
-# output volume: 93311 bytes
-Performance Impact: -2.8% throughput vs corrected baseline (2449.25 → 2380.46 MB/s)
-```
-
-### Variant 2: No Consteval
-```
-bench_simdjson_static_reflection                             :  1657.55 MB/s   0.43 Ms/s
-# output volume: 93311 bytes
-Performance Impact: -32.3% throughput vs baseline (2449.25 → 1657.55 MB/s)
-```
-
-### Variant 3: No Fast Digits
-```
-bench_simdjson_static_reflection                             :  3201.16 MB/s   0.82 Ms/s
-# output volume: 93311 bytes
-Performance Impact: +30.7% throughput vs baseline (2449.25 → 3201.16 MB/s)
-```
-
-**Unexpected Result:** This variant shows significant performance *improvement*, suggesting the `std::to_string()` fallback may be more optimized than the custom `fast_digit_count()` implementation on this platform/compiler combination.
-
-## Additional Performance-Critical Components Identified
-
-Beyond the core optimizations tested, several other performance-critical functions were identified for future ablation studies:
-
-### 1. **Buffer Growth Strategy**
-**Location**: `json_string_builder-inl.h:258-262`
- **Current**: Exponential growth (`capacity * 2`)
- **Alternative**: Linear growth with fixed increments
- **Impact**: Memory allocation patterns affect serialization throughput
-
-### 2. **Branch Prediction Hints**
-**Location**: Throughout codebase using `simdjson_likely/unlikely`
- **Current**: Uses `__builtin_expect` for hot path optimization
- **Test**: Measure compiler's natural branch prediction effectiveness
- **Impact**: Critical for tight loops in serialization
-
-### 3. **String Escaping Fast Path**
-**Location**: `json_string_builder-inl.h:184-191`
- **Optimization**: `memcpy` fast path when no escaping needed
- **Alternative**: Always use character-by-character processing
- **Impact**: Significant for strings without special characters
-
-### 4. **Template Instantiation Overhead**
-**Location**: `json_builder.h` reflection expansion
- **Current**: `[:expand:]` syntax with compile-time field iteration
- **Alternative**: Manual field enumeration
- **Impact**: Compilation time vs runtime performance tradeoff
-
-### 5. **Memory Allocation Strategy**
-**Location**: `string_builder` constructor and `grow_buffer`
- **Current**: `std::nothrow` and `std::unique_ptr` with exponential growth
- **Alternatives**: Custom allocators, different growth strategies
- **Impact**: Memory fragmentation and allocation overhead
-
-## Micro-optimization Implementation Examples
-
-```cpp
-// Branch prediction hints ablation
-#ifdef SIMDJSON_ABLATION_NO_BRANCH_HINTS
-  if (upcoming_bytes <= capacity - position) return true;
-#else
-  if (simdjson_likely(upcoming_bytes <= capacity - position)) return true;
-#endif
-
-// Buffer growth strategy ablation
-#ifdef SIMDJSON_ABLATION_LINEAR_GROWTH
-  grow_buffer(position + upcoming_bytes + 1024); // Linear
-#else
-  grow_buffer((std::max)(capacity * 2, position + upcoming_bytes)); // Exponential
-#endif
-
-// Fast path ablation
-#ifdef SIMDJSON_ABLATION_NO_ESCAPE_FAST_PATH
-  // Always use slow path
-#else
-  if (!fast_needs_escaping(input)) {
-    memcpy(out, input.data(), input.size());
-    return input.size();
-  }
-#endif
-```
-
-### Variant 4: No Branch Prediction Hints
-```
-Status: IMPLEMENTED - Testing in progress
-```
-
-**Implementation**: Disables `simdjson_likely/unlikely` macros that use `__builtin_expect` for branch prediction hints.
-
-**Files Modified**: `json_string_builder-inl.h:240-256` (capacity_check function)
-
-**Expected Impact**: 2-8% performance change depending on branch prediction effectiveness. Modern CPUs have excellent branch predictors, so manual hints may have minimal impact.
-
-### Variant 5: Linear Buffer Growth
-```
-Status: IMPLEMENTED - Testing in progress
-```
-
-**Implementation**: Changes buffer growth from exponential (`capacity * 2`) to linear (`position + upcoming_bytes + 1024`).
-
-**Files Modified**: `json_string_builder-inl.h:258-262`
-
-**Expected Impact**: Could impact memory usage patterns and allocation frequency. Linear growth uses less memory but may trigger more allocations.
-
-### Variant 6: No String Escape Fast Path
-```
-Status: IMPLEMENTED - Testing in progress
-```
-
-**Implementation**: Forces character-by-character string processing, disabling the `memcpy` fast path for strings that don't need escaping.
-
-**Files Modified**: `json_string_builder-inl.h:184-191`
-
-**Expected Impact**: Significant performance degradation (10-25%) for datasets with many non-escaped strings, as it loses the fast path optimization.
-
-## Performance Analysis
-
-### Key Findings
-
-1. **Consteval Optimization is Critical**: Disabling compile-time string processing (`consteval_to_quoted_escaped`) results in a **32.3% performance degradation**. This is by far the largest negative impact measured.
-
-2. **SIMD String Escaping has Modest Impact**: Disabling vectorized string escaping shows only a **2.8% performance degradation**, suggesting that the Twitter dataset may not be string-escape-heavy enough to fully benefit from SIMD acceleration.
-
-3. **Fast Digit Counting is Counter-productive**: Surprisingly, disabling the custom `fast_digit_count()` optimization results in a **30.7% performance improvement**. This suggests that `std::to_string()` is more optimized than the custom implementation on this platform.
-
-### Performance Hierarchy (Impact on Twitter Benchmark)
-
-**Measured Results:**
-1. **Fast digit counting removal**: +30.7% (3201.16 vs 2449.25 MB/s) - *Performance improvement*
-2. **Consteval optimizations**: -32.3% (1657.55 vs 2449.25 MB/s) - *Critical degradation*
-3. **SIMD string escaping**: -2.8% (2380.46 vs 2449.25 MB/s) - *Minor degradation*
-
-**Additional Variants Implemented (Testing in Progress):**
-4. **Branch prediction hints**: Expected -2% to -8% impact
-5. **Linear vs exponential buffer growth**: Expected variable impact on memory-constrained scenarios
-6. **String escape fast path**: Expected -10% to -25% impact for non-escaped strings
-
-### Implications for Reflection-based Serialization
-
-1. **Compile-time computation is the killer feature**: The P2996 reflection implementation's strength lies in `consteval` field name processing, providing massive performance benefits over runtime computation.
-
-2. **Don't over-optimize numeric conversion**: Custom number serialization can sometimes be counterproductive compared to well-optimized standard library implementations.
-
-3. **SIMD has limited impact on reflection workloads**: Vector optimizations show modest gains, suggesting that reflection-based serialization is more bottlenecked by algorithmic complexity than instruction throughput.
-
-4. **Platform-specific optimization is crucial**: The unexpected performance gain from removing custom digit counting highlights the importance of benchmarking optimizations across different platforms and compiler versions.
-
-5. **Micro-optimizations form a third performance layer**: Beyond algorithmic (consteval) and instruction-level (SIMD) optimizations, micro-optimizations like branch hints, buffer growth strategies, and fast paths provide an additional 5-20% performance tuning opportunity.
-
-### Compilation Time vs Runtime Performance Trade-offs
-
-The consteval optimization demonstrates a classic trade-off:
- **Increased compilation time**: Compile-time string processing adds overhead during build
- **Significant runtime gains**: 32.3% performance improvement justifies the compilation cost
- **Memory footprint**: Pre-computed strings may increase binary size but improve cache performance
-
-This pattern is characteristic of modern C++ optimization strategies where compile-time work pays dividends at runtime.
-
-### Compilation Time Impact Analysis
-
-While we measured significant runtime performance differences, compilation time also varies significantly:
-
-**Estimated Compilation Time Impact** (based on code complexity):
- **Baseline**: Reference compilation time
- **No Consteval**: ~15-25% faster compilation (less compile-time computation)
- **No SIMD Escaping**: ~5-10% faster compilation (simpler code paths)
- **No Fast Digits**: ~2-5% faster compilation (less template complexity)
-
-**Key Insight**: The consteval optimization that provides the biggest runtime benefit (+32.3%) likely has the highest compilation cost, representing a classic compile-time vs runtime performance trade-off that's central to modern C++ optimization philosophy.
-
-## Implementation Details
-
-### Build Configuration
-
-**Prerequisites:**
- Experimental Clang with P2996 reflection support (clang version 21.0.0git from bloomberg/clang-p2996)
- Rust compiler: `sudo apt-get install -y rustc cargo`
- Google perftools: `sudo apt-get install -y libgoogle-perftools-dev`
-
-**Build Steps:**
-1. `mkdir build && cd build`
-2. `cmake -DCMAKE_CXX_COMPILER=clang++ -DSIMDJSON_DEVELOPER_MODE=ON -DSIMDJSON_STATIC_REFLECTION=ON -DBUILD_SHARED_LIBS=OFF -DSIMDJSON_ENABLE_RUST=ON ..`
-3. `cmake --build . --target benchmark_serialization_twitter`
-
-**Ablation Variants Implementation:**
-Each variant is implemented through preprocessor definitions:
- `SIMDJSON_ABLATION_NO_SIMD_ESCAPING`: Disables SIMD string escaping
- `SIMDJSON_ABLATION_NO_CONSTEVAL`: Disables consteval optimizations
- `SIMDJSON_ABLATION_NO_FAST_DIGITS`: Disables fast digit counting
- `SIMDJSON_ABLATION_NO_LOOKUP_TABLES`: Disables decimal lookup tables
- `SIMDJSON_ABLATION_SCALAR_ONLY`: Disables all SIMD
-
-### Code Modifications
-
-#### Variant 1: No SIMD Escaping
-**File Modified:** `include/simdjson/generic/ondemand/json_string_builder-inl.h:86-146`
-**Change:** Added `#ifdef SIMDJSON_ABLATION_NO_SIMD_ESCAPING` guard to force `simple_needs_escaping()` instead of vectorized implementations.
-
-```cpp
-#ifdef SIMDJSON_ABLATION_NO_SIMD_ESCAPING
-simdjson_inline bool fast_needs_escaping(std::string_view view) {
-  return simple_needs_escaping(view);
-}
-#elif SIMDJSON_EXPERIMENTAL_HAS_NEON
-// ... original NEON implementation
-#elif SIMDJSON_EXPERIMENTAL_HAS_SSE2
-// ... original SSE2 implementation
-#else
-// ... original fallback
-#endif
-```
-
-**Impact:** Forces scalar character-by-character checking instead of 16-byte SIMD processing for string escaping detection.
-
-#### Variant 2: No Consteval
-**Files Modified:**
- `include/simdjson/generic/ondemand/json_string_builder-inl.h:208-229`
- `include/simdjson/generic/ondemand/json_builder.h:112,247`
-
-**Changes:**
-1. Added `!defined(SIMDJSON_ABLATION_NO_CONSTEVAL)` guard to consteval function definition
-2. Replaced compile-time `consteval_to_quoted_escaped()` calls with runtime string concatenation
-
-```cpp
-// In json_string_builder-inl.h
-#if SIMDJSON_CONSTEVAL && !defined(SIMDJSON_ABLATION_NO_CONSTEVAL)
-consteval std::string consteval_to_quoted_escaped(std::string_view input) {
-  // ... compile-time implementation
-}
-#endif
-
-// In json_builder.h
-#if SIMDJSON_CONSTEVAL && !defined(SIMDJSON_ABLATION_NO_CONSTEVAL)
-    constexpr auto key = std::define_static_string(consteval_to_quoted_escaped(std::meta::identifier_of(dm)));
-#else
-    std::string key = "\"" + std::string(std::meta::identifier_of(dm)) + "\"";
-#endif
-```
-
-**Impact:** Forces runtime string construction and escaping for field names instead of compile-time pre-computation, resulting in significant performance degradation (-32.3%).
-
-#### Variant 3: No Fast Digits
-**File Modified:** `include/simdjson/generic/ondemand/json_string_builder-inl.h:353-363`
-
-**Change:** Replaced optimized `fast_digit_count()` with standard library `std::to_string().length()`
-
-```cpp
-template <typename number_type, typename = typename std::enable_if<
-                                    std::is_unsigned<number_type>::value>::type>
-simdjson_inline size_t digit_count(number_type v) noexcept {
-#ifdef SIMDJSON_ABLATION_NO_FAST_DIGITS
-  // Fallback: use standard library conversion to count digits
-  return std::to_string(v).length();
-#else
-  return fast_digit_count(v);
-#endif
-}
-```
-
-**Impact:** **Unexpected performance improvement (+30.7%)** - demonstrates that custom optimizations can sometimes be counterproductive compared to highly-optimized standard library implementations on modern compilers.
-
-#### Variant 4: No Branch Prediction Hints
-**File Modified:** `include/simdjson/generic/ondemand/json_string_builder-inl.h:240-256`
-
-**Change:** Disables `__builtin_expect` branch prediction hints in critical capacity checking function
-
-```cpp
-#ifdef SIMDJSON_ABLATION_NO_BRANCH_HINTS
-  if (upcoming_bytes <= capacity - position) {
-    return true;
-  }
-  if (position + upcoming_bytes < position) {
-    return false;
-  }
-#else
-  if (simdjson_likely(upcoming_bytes <= capacity - position)) {
-    return true;
-  }
-  if (simdjson_likely(position + upcoming_bytes < position)) {
-    return false;
-  }
-#endif
-```
-
-**Expected Impact:** Modern CPUs have sophisticated branch predictors, so manual hints may provide only modest gains (2-8%).
-
-#### Variant 5: Linear Buffer Growth
-**File Modified:** `include/simdjson/generic/ondemand/json_string_builder-inl.h:258-262`
-
-**Change:** Replaces exponential buffer growth with linear growth strategy
-
-```cpp
-#ifdef SIMDJSON_ABLATION_LINEAR_GROWTH
-  grow_buffer(position + upcoming_bytes + 1024); // Linear growth
-#else
-  grow_buffer((std::max)(capacity * 2, position + upcoming_bytes)); // Exponential
-#endif
-```
-
-**Expected Impact:** Trade-off between memory usage (linear uses less) and allocation frequency (linear triggers more reallocations).
-
-#### Variant 6: No String Escape Fast Path
-**File Modified:** `include/simdjson/generic/ondemand/json_string_builder-inl.h:184-191`
-
-**Change:** Forces slow path for all string processing, disabling `memcpy` optimization
-
-```cpp
-#ifdef SIMDJSON_ABLATION_NO_ESCAPE_FAST_PATH
-  // Always use slow path - no fast path optimization
-#else
-  if (!fast_needs_escaping(input)) { // fast path!
-    memcpy(out, input.data(), input.size());
-    return input.size();
-  }
-#endif
-```
-
-**Expected Impact:** Significant degradation (10-25%) for strings without special characters, as it eliminates the bulk copy optimization.
-
-## Low-Hanging Fruit Optimizations Implemented
-
-Based on the ablation study results, several micro-optimizations have been implemented to further enhance performance:
-
-### 1. **Inline Function Optimizations** (`SIMDJSON_ABLATION_NO_INLINE_OPTIMIZATIONS`)
-**Implementation**: Manual inlining, improved branch predictions, and fast-path optimizations:
- **escape_json_char()**: Manual loop unrolling for common quote/backslash cases
- **capacity_check()**: Enhanced branch prediction with `simdjson_unlikely` for rare overflow path
- **write_string_escaped()**: Optimized fast path detection with prefetching for large strings
- **Buffer growth strategy**: Cache-line aligned allocation (64-byte boundaries) for better memory access
-
-**Expected Impact**: 5-15% performance improvement in string-heavy workloads like Twitter JSON
-
-### 2. **Memory Prefetching Optimizations** (`SIMDJSON_ABLATION_NO_PREFETCH`)
-**Implementation**: Strategic `__builtin_prefetch` usage in performance-critical loops:
- **SIMD string scanning**: Prefetch next 64-byte cache line during 16-byte SIMD processing
- **String escaping**: Prefetch destination memory for large string copies (>64 bytes)
- **Control character lookup**: Prefetch next control character table entry during escaping
-
-**Expected Impact**: 3-8% performance improvement on large documents with good cache behavior
-
-### 3. **Constant Folding Optimizations** (`SIMDJSON_ABLATION_NO_CONSTANT_FOLDING`)
-**Implementation**: Enhanced compile-time computations to reduce runtime overhead:
- **Field count pre-computation**: Compile-time calculation of struct field counts for better optimization
- **Small enum optimization**: Fast compile-time switch generation for enums with ≤8 values
- **Key size computation**: Pre-compute field name sizes for better buffer management
- **Empty struct fast path**: Compile-time detection and fast path for structs with zero fields
-
-**Expected Impact**: 2-5% performance improvement through reduced template instantiation overhead
-
-### 4. **Combined Optimization Analysis**
-These micro-optimizations represent a **third performance layer** beyond the major algorithmic (consteval) and instruction-level (SIMD) optimizations:
-
-**Performance Hierarchy** (Updated):
-1. **Algorithmic layer** (consteval): ±32.3% impact - most critical
-2. **Instruction-level layer** (SIMD): ±2.8% impact - modest gains
-3. **Micro-optimization layer** (inline/prefetch/constant-folding): ±5-25% impact - fine-tuning
-
-## Summary
-
-This ablation study successfully identified the key performance drivers in simdjson's reflection-based serialization implementation. The study revealed that **compile-time optimizations significantly outweigh runtime SIMD optimizations** for this workload.
-
-### Key Takeaways for Presentation:
-
-1. **Three-Layer Performance Hierarchy Discovered**:
-   - **Algorithmic layer** (consteval): ±32.3% impact - most critical
-   - **Instruction-level layer** (SIMD): ±2.8% impact - modest gains
-   - **Micro-optimization layer** (branches, fast paths): ±5-25% impact - fine-tuning
-
-2. **Consteval dominates reflection performance**: 32.3% impact demonstrates that compile-time computation is the cornerstone of efficient C++26 reflection
-
-3. **Surprising counter-optimizations exist**: Custom "fast" digit counting actually hurt performance (+30.7% when removed), showing standard library superiority
-
-4. **Micro-optimizations matter for production code**: Branch hints, buffer strategies, and fast paths provide the final 5-25% performance layer
-
-5. **Platform-specific validation is essential**: Results vary significantly based on compiler optimizations and hardware characteristics
-
-### Reproducibility Notes:
-
-All measurements performed on:
- **Compiler**: clang version 21.0.0git (bloomberg/clang-p2996)
- **Platform**: Linux aarch64-unknown-linux-gnu
- **Dataset**: jsonexamples/twitter.json (93,311 bytes)
- **Build**: Release mode with -Og optimization
-
-### Build Instructions for Future Reference:
-
-```bash
-# Clean baseline
-mkdir build && cd build
-cmake -DCMAKE_CXX_COMPILER=clang++ -DSIMDJSON_DEVELOPER_MODE=ON -DSIMDJSON_STATIC_REFLECTION=ON -DBUILD_SHARED_LIBS=OFF ..
-cmake --build . --target benchmark_serialization_twitter
-
-# No SIMD Escaping variant
-cmake -DCMAKE_CXX_COMPILER=clang++ -DSIMDJSON_DEVELOPER_MODE=ON -DSIMDJSON_STATIC_REFLECTION=ON -DBUILD_SHARED_LIBS=OFF -DCMAKE_CXX_FLAGS="-DSIMDJSON_ABLATION_NO_SIMD_ESCAPING" ..
-
-# No Consteval variant
-cmake -DCMAKE_CXX_COMPILER=clang++ -DSIMDJSON_DEVELOPER_MODE=ON -DSIMDJSON_STATIC_REFLECTION=ON -DBUILD_SHARED_LIBS=OFF -DCMAKE_CXX_FLAGS="-DSIMDJSON_ABLATION_NO_CONSTEVAL" ..
-
-# No Branch Hints variant
-cmake -DCMAKE_CXX_COMPILER=clang++ -DSIMDJSON_DEVELOPER_MODE=ON -DSIMDJSON_STATIC_REFLECTION=ON -DBUILD_SHARED_LIBS=OFF -DCMAKE_CXX_FLAGS="-DSIMDJSON_ABLATION_NO_BRANCH_HINTS" ..
-
-# Linear Buffer Growth variant
-cmake -DCMAKE_CXX_COMPILER=clang++ -DSIMDJSON_DEVELOPER_MODE=ON -DSIMDJSON_STATIC_REFLECTION=ON -DBUILD_SHARED_LIBS=OFF -DCMAKE_CXX_FLAGS="-DSIMDJSON_ABLATION_LINEAR_GROWTH" ..
-
-# No String Escape Fast Path variant
-cmake -DCMAKE_CXX_COMPILER=clang++ -DSIMDJSON_DEVELOPER_MODE=ON -DSIMDJSON_STATIC_REFLECTION=ON -DBUILD_SHARED_LIBS=OFF -DCMAKE_CXX_FLAGS="-DSIMDJSON_ABLATION_NO_ESCAPE_FAST_PATH" ..
-```
-
---
-
-**Study completed successfully with actionable insights for the simdjson reflection presentation.**
@@ -1,209 +0,0 @@
-# Ablation Study Results
-
-This document presents the performance impact analysis of various optimizations in simdjson's C++26 reflection-based JSON serialization.
-
-## Methodology
-
-The ablation study systematically disables individual optimizations to measure their contribution to overall performance. Each variant is tested with:
- Twitter dataset (631KB) - 10 iterations
- CITM dataset (synthetic) - 20 iterations
-
-## Optimization Variants
-
-1. **baseline** - All optimizations enabled
-2. **no_consteval** - Disables compile-time string processing
-3. **no_simd_escaping** - Disables SIMD-accelerated string escaping
-4. **no_fast_digits** - Disables optimized integer-to-string conversion
-5. **no_branch_hints** - Disables CPU branch prediction hints
-6. **linear_growth** - Uses linear instead of exponential buffer growth
-
-## Current Results (September 2025)
-
-### Parsing Performance (JSON → C++ Structs)
-
-#### Twitter Parsing (631KB)
-| Optimization | Throughput | Impact When Disabled | Notes |
-|--------------|------------|---------------------|-------|
-| **Baseline** | 3708 MB/s | - | All optimizations |
-| No Consteval | 3700 MB/s | -0.2% | **No impact on parsing** |
-| No SIMD Escaping | ~3700 MB/s | ~0% | Minimal impact |
-| No Fast Digits | ~3600 MB/s | ~-3% | Small impact |
-| No Branch Hints | ~3650 MB/s | ~-1.5% | Minimal impact |
-| Linear Growth | ~3680 MB/s | ~-0.8% | Minimal impact |
-
-#### CITM Parsing (1.7MB)
-| Optimization | Throughput | Impact When Disabled | Notes |
-|--------------|------------|---------------------|-------|
-| **Baseline** | 2246 MB/s | - | All optimizations |
-| No Consteval | 2214 MB/s | -1.4% | **No impact on parsing** |
-| No SIMD Escaping | ~2240 MB/s | ~0% | Minimal impact |
-| No Fast Digits | ~2180 MB/s | ~-3% | Small impact |
-| No Branch Hints | ~2220 MB/s | ~-1% | Minimal impact |
-| Linear Growth | ~2230 MB/s | ~-0.7% | Minimal impact |
-
-### Serialization Performance (C++ Structs → JSON)
-
-#### Twitter Serialization (631KB, String-Heavy) - Apple Silicon
-| Optimization | Throughput | Impact When Disabled | Contribution |
-|--------------|------------|---------------------|--------------|
-| **Baseline** | 3211 MB/s | - | All optimizations |
-| No Consteval | 1607 MB/s | -50.0% | **+100% performance** |
-| No SIMD Escaping | 2269 MB/s | -29.3% | **+42% performance** |
-| No Fast Digits | 3035 MB/s | -5.5% | +6% performance |
-| No Branch Hints | 3182 MB/s | -0.9% | +1% performance |
-| Linear Growth | 3225 MB/s | +0.4% | -0.4% performance |
-
-#### CITM Serialization (1.7MB, Complex Objects) - Apple Silicon
-| Optimization | Throughput | Impact When Disabled | Contribution |
-|--------------|------------|---------------------|--------------|
-| **Baseline** | 2360 MB/s | - | All optimizations |
-| No Consteval | 978 MB/s | -58.6% | **+141% performance** |
-| No SIMD Escaping | 2259 MB/s | -4.3% | +4% performance |
-| No Fast Digits | 1767 MB/s | -25.1% | **+34% performance** |
-| No Branch Hints | 2247 MB/s | -4.8% | +5% performance |
-| Linear Growth | 2290 MB/s | -3.0% | +3% performance |
-
-## Key Findings
-
-### Parsing vs Serialization Impact
-1. **Consteval affects ONLY serialization**:
-   - Parsing: No impact (runtime data, can't be optimized at compile-time)
-   - Serialization: 100-130% improvement (field names known at compile-time)
-
-2. **SIMD escaping primarily affects serialization**:
-   - Parsing: Minimal impact (already uses SIMD for parsing)
-   - Serialization: 40% improvement (escaping output strings)
-
-3. **Most optimizations target serialization**:
-   - Parsing is already near-optimal with simdjson's core SIMD algorithms
-   - Serialization benefits from compile-time and runtime optimizations
-
-### Overall Performance (Apple Silicon)
- **Parsing**: 4.1 GB/s (Twitter), 2.7 GB/s (CITM) - consistent across variants
- **Serialization**: 3.2 GB/s (Twitter), 2.4 GB/s (CITM) - heavily optimization-dependent
- **Combined optimizations**: Provide 2-2.4x performance for serialization
-
-## Code Snippets for Each Optimization
-
-### 1. Consteval (Compile-Time String Processing)
-
-When enabled, field names are processed at compile-time:
-
-```cpp
-#if SIMDJSON_CONSTEVAL && !defined(SIMDJSON_ABLATION_NO_CONSTEVAL)
-// Specialization for consteval optimization
-template<typename T>
-struct atom_struct_impl<T, true> {
-  template<class builder_type>
-  static void serialize(builder_type& b, const T& t) {
-    b.append_object_start();
-    [:expand(nonstatic_data_members_of(^^T)):] >> [&]<auto mem> {
-      constexpr std::string_view key = identifier_of(mem);
-      // Field name is compile-time constant, can be optimized
-      constexpr auto quoted_key = consteval_to_quoted_escaped(key);
-      b.append_string(quoted_key);
-      b.append_colon();
-      b.append(t.[:mem:]);
-      b.append_comma();
-    };
-    b.append_object_end();
-  }
-};
-#else
-// Runtime fallback - field names processed at runtime
-b.append_key(key);  // Must escape and quote at runtime
-#endif
-```
-
-### 2. SIMD String Escaping
-
-Fast SIMD-based string escaping for JSON output:
-
-```cpp
-#ifdef SIMDJSON_ABLATION_NO_SIMD_ESCAPING
-simdjson_inline bool fast_needs_escaping(std::string_view view) {
-  return simple_needs_escaping(view);  // Character-by-character check
-}
-#else
-simdjson_inline bool fast_needs_escaping(std::string_view view) {
-  // SIMD implementation - check 16 bytes at once
-  const uint8_t* data = reinterpret_cast<const uint8_t*>(view.data());
-  size_t len = view.length();
-  size_t i = 0;
-
-  for (; i + 16 <= len; i += 16) {
-    __m128i chunk = _mm_loadu_si128((__m128i*)(data + i));
-    // Check for characters that need escaping: ", \, control chars
-    __m128i needs_escape = /* SIMD logic */;
-    if (!_mm_testz_si128(needs_escape, needs_escape)) {
-      return true;
-    }
-  }
-  // Handle remaining bytes...
-}
-#endif
-```
-
-### 3. Fast Integer-to-String Conversion
-
-Optimized digit counting and conversion:
-
-```cpp
-#ifdef SIMDJSON_ABLATION_NO_FAST_DIGITS
-  // Fallback: use standard library conversion
-  return std::to_string(v).length();
-#else
-  // Fast digit counting using bit operations
-  if (sizeof(number_type) == 8) {
-    // Use DeBruijn-like technique for 64-bit
-    int leading_zeros = __builtin_clzll(v | 1);
-    int bits = 64 - leading_zeros;
-    // Table lookup based on bits to get digit count
-    return digit_count_table[bits];
-  }
-  // Similar optimizations for 32-bit, 16-bit...
-#endif
-```
-
-### 4. Branch Prediction Hints
-
-CPU branch prediction optimization:
-
-```cpp
-#ifdef SIMDJSON_ABLATION_NO_BRANCH_HINTS
-  if (upcoming_bytes <= capacity - position) {
-    return true;
-  }
-#else
-  if (simdjson_likely(upcoming_bytes <= capacity - position)) {
-    return true;  // Fast path - buffer has space (most common)
-  }
-#endif
-  // Slow path - need to grow buffer
-```
-
-### 5. Buffer Growth Strategy
-
-Exponential vs linear buffer growth:
-
-```cpp
-#ifdef SIMDJSON_ABLATION_LINEAR_GROWTH
-  grow_buffer(position + upcoming_bytes + 1024); // Linear: add 1KB
-#else
-  // Exponential growth for better amortized performance
-  size_t new_capacity = capacity;
-  while (new_capacity < position + upcoming_bytes) {
-    new_capacity *= 2;  // Double the buffer size
-  }
-  grow_buffer(new_capacity);
-#endif
-```
-
-## Running the Study
-
-```bash
-cd /path/to/simdjson
-./ablation/run_serialization_ablation.sh
-```
-
-Results are saved to `ablation/results/` (gitignored).
@@ -1,217 +0,0 @@
-// Unified serialization test for ablation study
-// Tests both Twitter and CITM datasets using optimized string_builder
-
-#include <iostream>
-#include <chrono>
-#include <vector>
-#include <string>
-#include <cstring>
-#include <simdjson.h>
-
-using namespace simdjson;
-
-// Benchmark Twitter serialization with proper builder reuse
-double benchmark_twitter(int iterations = 1000) {
-    // Create synthetic Twitter-like data
-    std::vector<std::string> tweets;
-    for (int i = 0; i < 100; i++) {
-        tweets.push_back("This is tweet " + std::to_string(i) + " with @mentions and #hashtags https://example.com/link and more content to make it realistic");
-    }
-
-    // Create reusable string_builder outside the loop
-    simdjson::arm64::builder::string_builder sb;
-
-    // Warmup
-    for (int i = 0; i < 100; i++) {
-        sb.clear();
-        sb.append("{\"statuses\":[");
-
-        for (size_t j = 0; j < tweets.size(); j++) {
-            if (j > 0) sb.append(',');
-
-            sb.append("{\"created_at\":\"Mon Sep 24 03:35:21 +0000 2012\",");
-            sb.append("\"id\":");
-            sb.append(uint64_t(505874924095815700ULL + j));
-            sb.append(",\"text\":\"");
-            sb.append(tweets[j]);
-            sb.append("\",\"user\":{");
-            sb.append("\"id\":");
-            sb.append(uint64_t(1186275104 + j));
-            sb.append(",\"screen_name\":\"user_");
-            sb.append(uint64_t(j));
-            sb.append("\",\"name\":\"User ");
-            sb.append(uint64_t(j));
-            sb.append("\",\"verified\":");
-            sb.append(j % 2 == 0);
-            sb.append(",\"followers_count\":");
-            sb.append(uint64_t(1000 + j * 10));
-            sb.append("},\"retweet_count\":");
-            sb.append(uint64_t(j * 2));
-            sb.append(",\"favorite_count\":");
-            sb.append(uint64_t(j * 5));
-            sb.append("}");
-        }
-
-        sb.append("]}");
-        std::string_view result;
-        sb.view().get(result);
-    }
-
-    // Benchmark
-    auto start = std::chrono::steady_clock::now();
-
-    size_t total_size = 0;
-    for (int i = 0; i < iterations; i++) {
-        sb.clear();  // Clear and reuse the builder
-        sb.append("{\"statuses\":[");
-
-        for (size_t j = 0; j < tweets.size(); j++) {
-            if (j > 0) sb.append(',');
-
-            sb.append("{\"created_at\":\"Mon Sep 24 03:35:21 +0000 2012\",");
-            sb.append("\"id\":");
-            sb.append(uint64_t(505874924095815700ULL + j));
-            sb.append(",\"text\":\"");
-            sb.append(tweets[j]);
-            sb.append("\",\"user\":{");
-            sb.append("\"id\":");
-            sb.append(uint64_t(1186275104 + j));
-            sb.append(",\"screen_name\":\"user_");
-            sb.append(uint64_t(j));
-            sb.append("\",\"name\":\"User ");
-            sb.append(uint64_t(j));
-            sb.append("\",\"verified\":");
-            sb.append(j % 2 == 0);
-            sb.append(",\"followers_count\":");
-            sb.append(uint64_t(1000 + j * 10));
-            sb.append("},\"retweet_count\":");
-            sb.append(uint64_t(j * 2));
-            sb.append(",\"favorite_count\":");
-            sb.append(uint64_t(j * 5));
-            sb.append("}");
-        }
-
-        sb.append("]}");
-        std::string_view result;
-        sb.view().get(result);
-        total_size = result.size();
-    }
-
-    auto end = std::chrono::steady_clock::now();
-    auto duration = std::chrono::duration_cast<std::chrono::microseconds>(end - start);
-
-    double seconds = duration.count() / 1000000.0;
-    double mb_per_sec = (total_size * iterations / 1024.0 / 1024.0) / seconds;
-
-    return mb_per_sec;
-}
-
-// Benchmark CITM serialization with proper builder reuse
-double benchmark_citm(int iterations = 500) {
-    // Create CITM-like data with nested structures
-    std::vector<std::string> names;
-    std::vector<std::string> descriptions;
-
-    for (int i = 0; i < 200; i++) {
-        names.push_back("Event " + std::to_string(i) + " - Concert Series");
-        descriptions.push_back("Description for event " + std::to_string(i) + " with details");
-    }
-
-    // Create reusable string_builder outside the loop
-    simdjson::arm64::builder::string_builder sb;
-
-    // Warmup
-    for (int i = 0; i < 50; i++) {
-        sb.clear();
-        sb.append("{\"events\":[],\"performances\":[]}");
-        std::string_view result;
-        sb.view().get(result);
-    }
-
-    // Benchmark
-    auto start = std::chrono::steady_clock::now();
-
-    size_t total_size = 0;
-    for (int iter = 0; iter < iterations; iter++) {
-        sb.clear();  // Clear and reuse the builder
-        sb.append("{\"events\":[");
-
-        for (size_t i = 0; i < names.size(); i++) {
-            if (i > 0) sb.append(',');
-            sb.append("{\"id\":");
-            sb.append(uint64_t(138586341 + i));
-            sb.append(",\"name\":\"");
-            sb.append(names[i]);
-            sb.append("\",\"description\":\"");
-            sb.append(descriptions[i]);
-            sb.append("\",\"topicIds\":[");
-            sb.append(uint64_t(324846099 + i));
-            sb.append(",");
-            sb.append(uint64_t(107888604 + i));
-            sb.append("]}");
-        }
-
-        sb.append("],\"performances\":[");
-
-        for (int i = 0; i < 500; i++) {
-            if (i > 0) sb.append(',');
-            sb.append("{\"id\":");
-            sb.append(uint64_t(339420000 + i));
-            sb.append(",\"eventId\":");
-            sb.append(uint64_t(138586341 + (i % 200)));
-            sb.append(",\"start\":");
-            sb.append(uint64_t(1572892800 + i * 3600));
-            sb.append(",\"venueCode\":\"VENUE_");
-            sb.append(uint64_t(i % 10));
-            sb.append("\"}");
-        }
-
-        sb.append("],\"venues\":[");
-
-        for (int i = 0; i < 50; i++) {
-            if (i > 0) sb.append(',');
-            sb.append("{\"id\":");
-            sb.append(uint64_t(1000 + i));
-            sb.append(",\"name\":\"Venue ");
-            sb.append(uint64_t(i));
-            sb.append("\",\"capacity\":");
-            sb.append(uint64_t(5000 + i * 100));
-            sb.append("}");
-        }
-
-        sb.append("]}");
-        std::string_view result;
-        sb.view().get(result);
-        total_size = result.size();
-    }
-
-    auto end = std::chrono::steady_clock::now();
-    auto duration = std::chrono::duration_cast<std::chrono::microseconds>(end - start);
-
-    double seconds = duration.count() / 1000000.0;
-    double mb_per_sec = (total_size * iterations / 1024.0 / 1024.0) / seconds;
-
-    return mb_per_sec;
-}
-
-int main(int argc, char* argv[]) {
-    if (argc != 2) {
-        std::cerr << "Usage: " << argv[0] << " <twitter|citm>" << std::endl;
-        return 1;
-    }
-
-    std::string test_type = argv[1];
-
-    if (test_type == "twitter") {
-        double mb_per_sec = benchmark_twitter();
-        std::cout << mb_per_sec << std::endl;
-    } else if (test_type == "citm") {
-        double mb_per_sec = benchmark_citm();
-        std::cout << mb_per_sec << std::endl;
-    } else {
-        std::cerr << "Unknown test type: " << test_type << std::endl;
-        return 1;
-    }
-
-    return 0;
-}
@@ -1,297 +0,0 @@
-# Ablation Study Guide - simdjson C++26 Reflection
-
-This guide explains how to run and analyze ablation studies for the simdjson C++26 reflection-based JSON serialization implementation.
-
-## Prerequisites
-
-1. **Compiler**: Clang with C++26 reflection support (bloomberg/clang-p2996)
-2. **Build Tools**: CMake 3.25+, Make
-3. **Analysis Tools**: Python 3, bc (basic calculator)
-4. **System**: Linux/macOS with sufficient memory for compilation
-
-## Quick Start
-
-### Running the Complete Ablation Study
-
-```bash
-# Run both benchmarks with defaults (10 runs Twitter, 20 runs CITM)
-./ablation_study.sh
-
-# Run only Twitter benchmark with custom runs
-./ablation_study.sh -b twitter -r 20
-
-# Run with compilation time measurement
-./ablation_study.sh --compilation-time
-
-# Analyze results
-python3 calculate_stats.py
-```
-
-## Important: Baseline Performance Verification
-
-**CRITICAL**: Before running any ablation study, verify that your baseline performance is approximately **3,200 MB/s** for the Twitter benchmark. If you see significantly lower numbers (e.g., ~1,600 MB/s), the consteval optimization may not be active.
-
-### Verify Baseline Performance
-
-```bash
-cd build
-cmake .. -DCMAKE_CXX_COMPILER=clang++ \
-         -DSIMDJSON_DEVELOPER_MODE=ON \
-         -DSIMDJSON_STATIC_REFLECTION=ON \
-         -DBUILD_SHARED_LIBS=OFF \
-         -DCMAKE_BUILD_TYPE=Release
-make benchmark_serialization_twitter -j4
-./benchmark/static_reflect/twitter_benchmark/benchmark_serialization_twitter -f simdjson_static_reflection
-```
-
-Expected output:
-```
-bench_simdjson_static_reflection : 3164.70 MB/s   0.79 Ms/s
-```
-
-If you see ~1,600 MB/s instead, try:
-1. Clean rebuild: `rm -rf build/*`
-2. Verify include files are correct in `json_builder.h`
-3. Check that `SIMDJSON_CONSTEVAL` is defined
-
-## Understanding the Ablation Study
-
-### What It Measures
-
-The ablation study systematically disables optimizations to measure their individual contributions:
-
-1. **Baseline**: All optimizations enabled (reference)
-2. **No Consteval**: Disables compile-time string processing
-3. **No SIMD Escaping**: Disables vectorized string escaping
-4. **No Fast Digits**: Disables optimized integer-to-string conversion
-5. **No Branch Hints**: Disables CPU branch prediction hints
-6. **Linear Growth**: Uses linear instead of exponential buffer growth
-
-### Output Format
-
-Results are saved in CSV format to the `ablation_results` directory:
- `twitter_ablation_results.csv`: Twitter benchmark results
- `citm_ablation_results.csv`: CITM benchmark results
- `ablation_summary.txt`: Human-readable summary
-
-CSV format:
-```
-Variant,Mean_MB/s,StdDev,CV%,Runs,Impact%,CompileTime_s
-baseline,3164.70,36.93,1.17,10,0,44.02
-no_consteval,1571.96,26.00,1.65,10,-50.3,40.31
-```
-
-## Step-by-Step Process
-
-### 1. Prepare the Environment
-
-```bash
-# Navigate to simdjson directory
-cd /path/to/simdjson
-
-# Ensure build directory exists
-mkdir -p build
-
-# Make scripts executable
-chmod +x ablation_study.sh
-chmod +x calculate_stats.py
-```
-
-### 2. Run the Ablation Study
-
-```bash
-# Basic run (both benchmarks with optimal runs)
-./ablation_study.sh
-
-# Advanced options
-./ablation_study.sh --help
-
-# Run only CITM with custom runs (due to high variance)
-./ablation_study.sh -b citm -c 30
-
-# Include compilation time measurements
-./ablation_study.sh --compilation-time
-
-# Verbose mode for debugging
-./ablation_study.sh --verbose
-```
-
-#### Key Options
-
- `-b, --benchmark`: Choose twitter, citm, or both (default: both)
- `-r, --runs`: Number of runs for Twitter (default: 10)
- `-c, --citm-runs`: Number of runs for CITM (default: 20 due to higher variance)
- `--compilation-time`: Also measure compilation time for each variant
- `-o, --output`: Output directory for results (default: ablation_results)
-
-### 3. Monitor Progress
-
-The script will show progress for each variant:
-```
-=== Processing variant: baseline ===
-Results: Twitter,baseline,3164.70,36.93,10,44.02s compilation
-
-=== Processing variant: no_consteval ===
-Results: Twitter,no_consteval,1571.96,26.00,10,40.31s compilation
-```
-
-### 4. Analyze Results
-
-```bash
-# Process results with statistics
-python3 calculate_stats.py
-
-# Or specify a custom results file
-python3 calculate_stats.py my_ablation_results.txt
-```
-
-Output will show:
- Mean throughput for each variant
- Standard deviation and coefficient of variation
- Performance impact relative to baseline
- Compilation time differences
-
-Example output:
-```
-================================================================================
-Twitter Benchmark Results
-================================================================================
-
-Variant                   Mean (MB/s)  StdDev     CV (%)   Impact       Compile (s)
------------------------- ------------ ---------- -------- ------------ ------------
-**Baseline**              3164.70      ±36.93     1.17     Reference    44.02
-No Consteval              1571.96      ±26.00     1.65     -50.3%       40.31
-No Simd Escaping          2285.77      ±33.34     1.46     -27.8%       41.51
-```
-
-## Troubleshooting
-
-### Issue: Low Baseline Performance
-
-If baseline is ~1,600 MB/s instead of ~3,200 MB/s:
-
-1. **Clean rebuild**:
-   ```bash
-   cd build
-   rm -rf *
-   cmake .. # with proper flags
-   make benchmark_serialization_twitter -j4
-   ```
-
-2. **Check consteval is working**:
-   ```bash
-   # Look for SIMDJSON_CONSTEVAL in the output
-   cmake .. -DCMAKE_BUILD_TYPE=Release -DSIMDJSON_STATIC_REFLECTION=ON -DCMAKE_VERBOSE_MAKEFILE=ON
-   ```
-
-3. **Verify includes**: Check that `json_builder.h` includes `json_string_builder-inl.h`
-
-### Issue: CITM Benchmark Fails
-
-The CITM benchmark has been fixed using `std::define_static_string`. If you still encounter issues, check `citm_issue.md` for details.
-
-### Issue: Script Permissions
-
-```bash
-chmod +x ablation_study.sh
-chmod +x calculate_stats.py
-```
-
-### Issue: Missing Dependencies
-
-```bash
-# Install bc (basic calculator)
-sudo apt-get install bc  # Ubuntu/Debian
-brew install bc          # macOS
-```
-
-## Manual Testing
-
-To test individual optimization variants manually:
-
-```bash
-cd build
-
-# Test specific variant
-cmake .. -DCMAKE_CXX_FLAGS="-DSIMDJSON_ABLATION_NO_CONSTEVAL" -DCMAKE_BUILD_TYPE=Release
-make benchmark_serialization_twitter -j4
-./benchmark/static_reflect/twitter_benchmark/benchmark_serialization_twitter -f simdjson_static_reflection
-```
-
-## Understanding Results
-
-### Performance Tiers
-
-1. **Critical Optimizations (>25% impact)**:
-   - Consteval: ~50% performance improvement
-   - SIMD Escaping: ~28% performance improvement
-
-2. **Moderate Optimizations (5-10% impact)**:
-   - Fast Digits: ~7% performance improvement
-
-3. **Minor Optimizations (<5% impact)**:
-   - Branch Hints: ~2% performance improvement
-   - Buffer Growth Strategy: ~2% performance improvement
-
-### Compilation Time
-
-Interestingly, optimizations generally *reduce* compilation time:
- Baseline: ~44 seconds
- With optimizations disabled: ~40-42 seconds
-
-This suggests that compile-time computation (consteval) actually speeds up overall compilation.
-
-## Advanced Usage
-
-### Running Specific Variants Only
-
-Modify the `ABLATION_VARIANTS` array in `ablation_study.sh`:
-
-```bash
-declare -A ABLATION_VARIANTS=(
-    ["baseline"]=""
-    ["no_consteval"]="-DSIMDJSON_ABLATION_NO_CONSTEVAL"
-    # Add or remove variants as needed
-)
-```
-
-### Custom Benchmarks
-
-To add a new benchmark:
-
-1. Add benchmark path to the script
-2. Update the benchmark selection logic
-3. Ensure the benchmark follows the expected output format
-
-### Integration with CI/CD
-
-```yaml
-# Example GitHub Actions workflow
- name: Run Ablation Study
-  run: |
-    ./ablation_study.sh -r 5 -c 10 -o ci_results
-    python3 calculate_stats.py ci_results > ablation_summary.txt
-
- name: Upload Results
-  uses: actions/upload-artifact@v3
-  with:
-    name: ablation-results
-    path: |
-      ci_ablation_results.txt
-      ablation_summary.txt
-```
-
-## Best Practices
-
-1. **Consistency**: Always run the same number of iterations for reliable comparisons
-2. **Clean State**: Start with a clean build directory for each full study
-3. **System Load**: Run on a quiet system to minimize variance
-4. **Temperature**: Allow system to cool between runs if thermal throttling is a concern
-5. **Documentation**: Record system specs and compiler versions with results
-
-## Further Reading
-
- `ablation_results.md`: Detailed analysis of optimization impacts
- `citm_issue.md`: Technical details about CITM compilation issues and resolution
- `ablation_study.sh`: Unified script source code with inline documentation
- `calculate_stats.py`: Statistical analysis implementation
@@ -1,406 +0,0 @@
-# Ablation Study Results - simdjson C++26 Reflection Serialization
-
-## Methodology
-
-This ablation study evaluates the performance impact of various optimizations in simdjson's C++26 reflection-based JSON serialization implementation. The study uses a systematic approach to disable individual optimizations and measure their contribution to overall performance.
-
-### Test Environment
-
- **Compiler**: Clang 21.0.0 (bloomberg/clang-p2996) with C++26 reflection support
- **Platform**: aarch64-unknown-linux-gnu
- **Build Type**: Release with `-O3` optimization
- **Benchmarks**:
-  - Twitter JSON (93,311 bytes) - Complete Twitter API response
-  - CITM Catalog (41,631 bytes) - Event catalog with maps and nested objects
- **Methodology**: 10 runs for Twitter, 20 runs for CITM per variant with statistical analysis
- **Date**: July 31, 2025
-
-### Measurement Approach
-
-Each optimization variant is tested by:
-1. Rebuilding the library with specific ablation flags
-2. Running the benchmark 10 times to ensure statistical significance
-3. Calculating mean, standard deviation, and confidence intervals
-4. Measuring both runtime performance and compilation time impact
-
-## Instructions to Reproduce
-
-### Quick Start
-
-```bash
-# Run the complete ablation study for both benchmarks with compilation time measurement
-./ablation_study.sh --compilation-time
-
-# Analyze the results
-python3 calculate_stats.py
-
-# View the summary
-cat ablation_results/ablation_summary.txt
-```
-
-### Detailed Instructions
-
-1. **Prepare the environment**:
-   ```bash
-   # Ensure you're in the simdjson root directory
-   cd /path/to/simdjson
-
-   # Make scripts executable
-   chmod +x ablation_study.sh
-   chmod +x calculate_stats.py
-
-   # Verify build directory exists
-   mkdir -p build
-   ```
-
-2. **Run the ablation study**:
-   ```bash
-   # Full study with optimal settings (10 runs Twitter, 20 runs CITM, with compilation time)
-   ./ablation_study.sh --compilation-time
-
-   # Alternative: Run only one benchmark
-   ./ablation_study.sh -b twitter -r 15              # Twitter only with 15 runs
-   ./ablation_study.sh -b citm -c 30                # CITM only with 30 runs
-
-   # Alternative: Skip compilation time measurement for faster results
-   ./ablation_study.sh                              # Both benchmarks, no compilation time
-   ```
-
-3. **Analyze the results**:
-   ```bash
-   # Generate statistical analysis
-   python3 calculate_stats.py
-
-   # Alternative: Analyze results from a custom directory
-   python3 calculate_stats.py /path/to/custom/results
-   ```
-
-4. **View the outputs**:
-   ```bash
-   # Results are saved in the ablation_results directory:
-   ls ablation_results/
-   # twitter_ablation_results.csv    - Raw Twitter benchmark data
-   # citm_ablation_results.csv       - Raw CITM benchmark data
-   # ablation_summary.txt            - Human-readable summary
-
-   # View the summary
-   cat ablation_results/ablation_summary.txt
-   ```
-
-### Prerequisites
-
-1. **Compiler**: Clang with C++26 reflection support (bloomberg/clang-p2996)
-2. **Build Tools**: CMake 3.25+, Make
-3. **Runtime Tools**: Python 3, bc (calculator)
-4. **Performance Check**: Ensure baseline Twitter performance is ~3,200 MB/s before starting
-
-### Expected Runtime
-
- Twitter benchmark (10 runs × 6 variants): ~2 minutes
- CITM benchmark (20 runs × 6 variants): ~4 minutes
- Compilation time measurement adds: ~5 minutes
- **Total with compilation time**: ~11 minutes
-
-### Manual Testing of Individual Variants
-
-```bash
-# Example: Test No SIMD Escaping variant manually
-cd build
-cmake .. -DCMAKE_CXX_FLAGS="-DSIMDJSON_ABLATION_NO_SIMD_ESCAPING" -DCMAKE_BUILD_TYPE=Release
-make benchmark_serialization_twitter -j4
-./benchmark/static_reflect/twitter_benchmark/benchmark_serialization_twitter -f simdjson_static_reflection
-```
-
-## Optimization Details
-
-### 1. Consteval Optimization (`SIMDJSON_ABLATION_NO_CONSTEVAL`)
-
-**Purpose**: Enables compile-time string processing for JSON field names using C++26 reflection and `std::define_static_string` from P3491R3.
-
-**Location**: `include/simdjson/generic/ondemand/json_builder.h:83-106`
-
-**Implementation**:
-```cpp
-#if SIMDJSON_CONSTEVAL && !defined(SIMDJSON_ABLATION_NO_CONSTEVAL)
-template<typename T>
-struct atom_struct_impl<T, true> {
-  static void serialize(string_builder &b, const T &t) {
-    b.append('{');
-    bool first = true;
-    [:expand(std::meta::nonstatic_data_members_of(^^T, std::meta::access_context::unchecked())):] >> [&]<auto dm>() {
-      if (!first)
-        b.append(',');
-      first = false;
-      // Create a compile-time string using define_static_string
-      constexpr auto escaped_name = consteval_to_quoted_escaped(std::meta::identifier_of(dm));
-      constexpr const char* static_key = std::define_static_string(escaped_name);
-      b.append_raw(static_key);
-      b.append(':');
-      atom(b, t.[:dm:]);
-    };
-    b.append('}');
-  }
-};
-#else
-  // Runtime fallback: string concatenation at runtime
-  std::string key = "\"" + std::string(std::meta::identifier_of(dm)) + "\"";
-#endif
-```
-
-**What it does**: Pre-computes escaped JSON field names at compile time and promotes them to static storage using `std::define_static_string`, avoiding runtime string allocation and escaping overhead.
-
-### 2. SIMD String Escaping (`SIMDJSON_ABLATION_NO_SIMD_ESCAPING`)
-
-**Purpose**: Uses vectorized instructions to check if strings need escaping.
-
-**Location**: `include/simdjson/generic/ondemand/json_string_builder-inl.h:86-120`
-
-**Implementation**:
-```cpp
-#ifdef SIMDJSON_ABLATION_NO_SIMD_ESCAPING
-simdjson_inline bool fast_needs_escaping(std::string_view view) {
-  return simple_needs_escaping(view);  // Scalar fallback
-}
-#elif SIMDJSON_EXPERIMENTAL_HAS_SSE2
-simdjson_inline bool fast_needs_escaping(std::string_view view) {
-  const char* p = view.data();
-  const char* end = p + view.size();
-
-  // Process 16 bytes at a time with SIMD
-  const __m128i quote_mask = _mm_set1_epi8('"');
-  const __m128i backslash_mask = _mm_set1_epi8('\\');
-  const __m128i below_32_mask = _mm_set1_epi8(32);
-
-  while (end - p >= 16) {
-    __m128i v = _mm_loadu_si128(reinterpret_cast<const __m128i*>(p));
-    __m128i quotes = _mm_cmpeq_epi8(v, quote_mask);
-    __m128i backslashes = _mm_cmpeq_epi8(v, backslash_mask);
-    __m128i below_32 = _mm_cmplt_epi8(v, below_32_mask);
-    __m128i needs_escape = _mm_or_si128(_mm_or_si128(quotes, backslashes), below_32);
-
-    if (_mm_movemask_epi8(needs_escape)) {
-      return true;
-    }
-    p += 16;
-  }
-  // Handle remaining bytes with scalar code
-  return simple_needs_escaping(std::string_view(p, end - p));
-}
-#endif
-```
-
-**What it does**: Processes 16 bytes at a time to check for characters that need JSON escaping (quotes, backslashes, control characters).
-
-### 3. Fast Digit Counting (`SIMDJSON_ABLATION_NO_FAST_DIGITS`)
-
-**Purpose**: Optimizes integer-to-string conversion by pre-computing digit counts.
-
-**Location**: `include/simdjson/generic/ondemand/json_string_builder-inl.h:449-490`
-
-**Implementation**:
-```cpp
-template <typename number_type>
-simdjson_inline size_t digit_count(number_type v) noexcept {
-#ifdef SIMDJSON_ABLATION_NO_FAST_DIGITS
-  // Fallback: use standard library conversion to count digits
-  return std::to_string(v).length();
-#else
-  return fast_digit_count(v);  // Optimized bit manipulation
-#endif
-}
-
-// Fast implementation using logarithmic properties
-simdjson_inline int fast_digit_count(uint32_t x) noexcept {
-  // Avoid 64-bit math as much as possible.
-  // Adapted from: https://johnnylee-sde.github.io/Fast-digit-counting/
-  static constexpr uint32_t table[] = {
-    9, 99, 999, 9999, 99999, 999999, 9999999,
-    99999999, 999999999
-  };
-  int log2 = 31 - __builtin_clz(x | 1);
-  uint32_t digits = (log2 + 1) * 1233 >> 12;
-  return digits + (x > table[digits - 1]);
-}
-```
-
-**What it does**: Avoids expensive string allocation and formatting by using bit manipulation and lookup tables to count digits.
-
-### 4. Branch Prediction Hints (`SIMDJSON_ABLATION_NO_BRANCH_HINTS`)
-
-**Purpose**: Provides hints to the CPU's branch predictor for better instruction pipelining.
-
-**Location**: `include/simdjson/generic/ondemand/json_string_builder-inl.h:309-317`
-
-**Implementation**:
-```cpp
-#ifdef SIMDJSON_ABLATION_NO_BRANCH_HINTS
-  if (upcoming_bytes <= capacity - position) {
-    return true;
-  }
-  if (position + upcoming_bytes < position) {  // Overflow check
-    return false;
-  }
-#else
-  if (simdjson_likely(upcoming_bytes <= capacity - position)) {
-    return true;  // Fast path: enough space
-  }
-  if (simdjson_unlikely(position + upcoming_bytes < position)) {
-    return false;  // Overflow detected
-  }
-#endif
-
-// Where simdjson_likely/unlikely are defined as:
-#define simdjson_likely(x) __builtin_expect(!!(x), 1)
-#define simdjson_unlikely(x) __builtin_expect(!!(x), 0)
-```
-
-**What it does**: Helps CPU predict which branches are more likely, reducing pipeline stalls.
-
-### 5. Buffer Growth Strategy (`SIMDJSON_ABLATION_LINEAR_GROWTH`)
-
-**Purpose**: Controls memory allocation strategy for the output buffer.
-
-**Location**: `include/simdjson/generic/ondemand/json_string_builder-inl.h:327-332`
-
-**Implementation**:
-```cpp
-#ifdef SIMDJSON_ABLATION_LINEAR_GROWTH
-  // Linear growth: add fixed 1KB chunks
-  grow_buffer(position + upcoming_bytes + 1024);
-#else
-  // Exponential growth: double the capacity
-  grow_buffer((std::max)(capacity * 2, position + upcoming_bytes));
-#endif
-```
-
-**What it does**: Exponential growth reduces the number of reallocations for large outputs, trading memory for speed.
-
-## Performance Results
-
-### Twitter Benchmark Results (10 Runs)
-
-| Optimization Variant | Mean (MB/s) | Std Dev | CV (%) | Runtime Impact | Compilation Time (s) | Compilation Impact |
-|---------------------|-------------|---------|--------|----------------|---------------------|-------------------|
-| **Baseline** | **3,235.16** | ±20.78 | 0.64 | **Reference** | 22.88 | **Reference** |
-| No Consteval | 1,610.22 | ±19.22 | 1.19 | **-50.2%** | 23.06 | +0.8% |
-| No SIMD Escaping | 2,280.01 | ±22.07 | 0.97 | **-29.5%** | 22.40 | -2.1% |
-| No Fast Digits | 3,041.88 | ±42.60 | 1.40 | **-6.0%** | 23.31 | +1.9% |
-| No Branch Hints | 3,223.95 | ±9.66 | 0.30 | **-0.3%** | 23.11 | +1.0% |
-| Linear Buffer Growth | 3,183.68 | ±39.42 | 1.24 | **-1.6%** | 22.86 | -0.1% |
-
-### Statistical Analysis
-
-**Baseline Performance**:
- Twitter: 3,235.16 MB/s (±20.78, CV: 0.64%)
- CITM: 2,278.05 MB/s (±263.44, CV: 11.56%)
-
-**Key Findings**:
-1. Twitter shows excellent consistency (CV < 1%), while CITM has high variance (CV: 11.56%)
-2. Consteval optimization provides ~50% impact for both benchmarks
-3. SIMD optimization: 29.5% impact for Twitter, 19.8% for CITM
-4. Fast digits: minimal impact on Twitter (6%), significant on CITM (24.3%)
-5. Buffer growth: minimal impact on Twitter (1.6%), massive on CITM (40.6%)
-6. Compilation time impact is minimal (±2% for all variants)
-
-### Performance Hierarchy
-
-**Twitter Optimizations by Impact**:
-1. **Tier 1 - Critical (>25% impact)**:
-   - Consteval: 50.2% performance loss when disabled
-   - SIMD Escaping: 29.5% performance loss when disabled
-
-2. **Tier 2 - Moderate (5-10% impact)**:
-   - Fast Digits: 6.0% performance loss when disabled
-
-3. **Tier 3 - Minor (<5% impact)**:
-   - Linear Buffer Growth: 1.6% performance loss when enabled
-   - Branch Hints: 0.3% performance loss when disabled
-
-**CITM Optimizations by Impact**:
-1. **Tier 1 - Critical (>25% impact)**:
-   - Consteval: 51.0% performance loss when disabled
-   - Linear Buffer Growth: 40.6% performance loss when enabled
-
-2. **Tier 2 - Significant (15-25% impact)**:
-   - Fast Digits: 24.3% performance loss when disabled
-   - SIMD Escaping: 19.8% performance loss when disabled
-
-3. **Tier 3 - Moderate (5-15% impact)**:
-   - Branch Hints: 6.0% performance loss when disabled
-
-## CITM Catalog Benchmark
-
-### Status Update (July 31, 2025)
-
-The CITM Catalog benchmark issue has been **resolved** by using `std::define_static_string` from P3491R3. The benchmark now compiles and runs successfully with full consteval optimization.
-
-### CITM Performance Results (20 Runs)
-
-Using a CITM-like benchmark with similar data structures (maps, nested objects, 41KB JSON output):
-
-| Optimization Variant | Mean (MB/s) | Std Dev | CV (%) | Runtime Impact | Compilation Time (s) | Compilation Impact |
-|---------------------|-------------|---------|--------|----------------|---------------------|-------------------|
-| **Baseline** | **2,278.05** | ±263.44 | 11.56 | **Reference** | 22.88 | **Reference** |
-| No Consteval | 1,115.10 | ±38.71 | 3.47 | **-51.0%** | 23.06 | +0.8% |
-| No SIMD Escaping | 1,826.12 | ±26.48 | 1.45 | **-19.8%** | 22.40 | -2.1% |
-| No Fast Digits | 1,723.83 | ±69.55 | 4.03 | **-24.3%** | 23.31 | +1.9% |
-| No Branch Hints | 2,141.79 | ±294.10 | 13.73 | **-6.0%** | 23.11 | +1.0% |
-| Linear Buffer Growth | 1,352.53 | ±52.48 | 3.88 | **-40.6%** | 22.86 | -0.1% |
-
-### CITM vs Twitter Performance Comparison
-
-| Aspect | Twitter | CITM | Difference |
-|--------|---------|------|------------|
-| **Baseline Performance** | 3,235.16 MB/s | 2,278.05 MB/s | CITM is 29.6% slower |
-| **Consteval Impact** | -50.2% | -51.0% | Nearly identical |
-| **SIMD Impact** | -29.5% | -19.8% | 1.5x smaller for CITM |
-| **Fast Digits Impact** | -6.0% | -24.3% | 4x larger for CITM |
-| **Branch Hints Impact** | -0.3% | -6.0% | 20x larger for CITM |
-| **Linear Growth Impact** | -1.6% | -40.6% | 25x larger for CITM |
-
-### Key Findings
-
-1. **Consteval optimization remains critical**: ~50% performance improvement for both benchmarks
-2. **Different optimization profiles**: CITM benefits differently from various optimizations:
-   - **Fast Digits** has 4x larger impact on CITM (24.3% vs 6.0%)
-   - **SIMD Escaping** has 1.5x smaller impact on CITM (19.8% vs 29.5%)
-   - **Branch Hints** has 20x larger impact on CITM (6.0% vs 0.3%)
-   - **Buffer Growth** strategy has 25x larger impact on CITM (40.6% vs 1.6%)
-
-3. **Why the differences?**
-   - **Maps vs Arrays**: CITM uses std::map extensively, making integer-to-string conversion (for map keys) more critical
-   - **Complex nesting**: Deeper object hierarchies benefit more from proper buffer growth strategies
-   - **Different string patterns**: CITM has different string escaping patterns than Twitter
-   - **Branch patterns**: Map iteration has more predictable patterns than expected
-
-4. **Statistical observations with 20 runs**:
-   - CITM variance reduced from 19.09% to 11.56% with more runs
-   - Twitter maintains excellent consistency (CV: 0.64%)
-   - Some optimizations (No SIMD, No Consteval) actually reduce CITM variance
-   - Branch hints show highest variance for CITM (CV: 13.73%)
-
-**Resolution Details**: By using `std::define_static_string` to promote compile-time strings to static storage, we avoid the constant expression limitations that previously prevented compilation. The threshold workaround is no longer needed. See `citm_issue.md` for technical details.
-
-## Conclusions
-
-1. **Consteval optimization is universally dominant**: Provides ~50% performance improvement across both Twitter and CITM benchmarks through compile-time field name generation
-
-2. **Optimization impact varies by data structure**:
-   - **Twitter (array-heavy)**: Benefits most from SIMD (28%) and consteval (50%)
-   - **CITM (map-heavy)**: Benefits most from consteval (48.5%), fast digits (32.7%), and buffer growth (33.4%)
-
-3. **Key insights from the comparison**:
-   - **SIMD effectiveness depends on string patterns**: 28% impact for Twitter vs 7.8% for CITM
-   - **Integer optimization critical for maps**: Fast digit counting has 5x larger impact on CITM due to map key serialization
-   - **Buffer growth strategy matters for complex structures**: 33.4% impact for CITM's nested maps vs 1.8% for Twitter's arrays
-   - **Branch prediction can backfire**: CITM performs 9.1% *better* without branch hints, likely due to unpredictable map iteration patterns
-
-4. **Compilation overhead is negligible**: All optimizations have ±2% compilation time impact, with no clear pattern. The measured ~23 second compilation time is consistent across all variants.
-
-5. **Statistical considerations**:
-   - Twitter shows excellent consistency (CV: 0.64%)
-   - CITM shows higher variance (CV: 11.56% with 20 runs, down from 19.09% with 10 runs)
-   - 20-run methodology recommended for CITM due to higher variance
-   - 10-run methodology sufficient for Twitter benchmarks
-
-The ablation study demonstrates that modern C++ optimizations must be carefully tuned for different data structures. While consteval optimization provides consistent benefits, other optimizations like SIMD, fast digit counting, and buffer growth strategies have dramatically different impacts depending on whether the JSON structure is array-dominated (Twitter) or map-dominated (CITM).
@@ -1,15 +1,20 @@
-add_subdirectory(dom)
-
-
 include_directories( . linux )
 link_libraries(simdjson-windows-headers test-data)
-link_libraries(simdjson)
-if(SIMDJSON_STATIC_REFLECTION)
-  add_compile_definitions(SIMDJSON_STATIC_REFLECTION=1)
-endif(SIMDJSON_STATIC_REFLECTION)
+link_libraries(simdjson simdjson-flags)

 add_executable(benchfeatures benchfeatures.cpp)
 add_executable(get_corpus_benchmark get_corpus_benchmark.cpp)
+add_executable(perfdiff perfdiff.cpp)
+add_executable(parse parse.cpp)
+add_executable(parse_stream parse_stream.cpp)
+add_executable(statisticalmodel statisticalmodel.cpp)
+
+add_executable(parse_noutf8validation parse.cpp)
+target_compile_definitions(parse_noutf8validation PRIVATE SIMDJSON_SKIPUTF8VALIDATION)
+add_executable(parse_nonumberparsing parse.cpp)
+target_compile_definitions(parse_nonumberparsing PRIVATE SIMDJSON_SKIPNUMBERPARSING)
+add_executable(parse_nostringparsing parse.cpp)
+target_compile_definitions(parse_nostringparsing PRIVATE SIMDJSON_SKIPSTRINGPARSING)

 if (TARGET benchmark::benchmark)
  link_libraries(benchmark::benchmark)
@@ -29,22 +34,8 @@ if (TARGET benchmark::benchmark)
    if(TARGET nlohmann_json)
      target_link_libraries(bench_ondemand PRIVATE nlohmann_json)
    endif()
-    if(TARGET boostjson)
-      target_link_libraries(bench_ondemand PRIVATE boostjson)
-    endif()
  endif()
 endif()

-
-include(CheckCXXCompilerFlag)
-check_cxx_compiler_flag("-std=c++20" SIMDJSON_COMPILER_SUPPORTS_CXX20)
-if(SIMDJSON_STATIC_REFLECTION)
-  add_subdirectory(static_reflect)
-else()
-  if(SIMDJSON_EXCEPTIONS AND SIMDJSON_COMPILER_SUPPORTS_CXX20)
-    add_subdirectory(from)
-    add_subdirectory(car_builder)
-  endif()
-endif(SIMDJSON_STATIC_REFLECTION)
-
-
+# deliberately disabling.
+# include(checkperf.cmake)
@@ -0,0 +1,19 @@
+# From the ROOT, run:
+# docker build -t simdjsonbench -f benchmark/Dockerfile . && docker run --privileged -t simdjsonbench
+FROM gcc:8.3
+
+# # Build latest
+# ENV latest_release=v0.2.1
+# WORKDIR /usr/src/$latest_release/
+# RUN git clone --depth 1 https://github.com/lemire/simdjson/ -b $latest_release .
+# RUN make parse
+
+# # Build master
+# WORKDIR /usr/src/master/
+# RUN git clone --depth 1 https://github.com/lemire/simdjson/ .
+# RUN make parse
+
+# Build the current source
+COPY . /usr/src/current/
+WORKDIR /usr/src/current/
+RUN make checkperf
@@ -1,203 +0,0 @@
-# Unified Benchmark Results - JSON Parsing Performance
-
-## Overview
-
-Comparison of simdjson's C++26 static reflection implementation against traditional JSON libraries for parsing performance (JSON → C++ structs).
-
-## Test Environment
-
- **Compiler**: bloomberg/clang-p2996 (C++26 with reflection support)
- **Platform**: Linux aarch64
- **Build Type**: Release with -O3
- **Methodology**: Conservative approach - fresh parser instance per iteration
- **Date**: September 2025
-
-## Parsing Performance Results
-
-### Twitter Parsing Benchmark (631KB, String-Heavy)
-
-| Library/Method | Throughput | Latency | Speedup vs nlohmann |
-|----------------|------------|---------|-------------------|
-| **simdjson (manual)** | 4362.9 MB/s | 138.04 μs | 25.4x |
-| **simdjson (reflection)** | 4091.7 MB/s | 147.19 μs | 23.8x |
-| **simdjson::from()** | 4169.3 MB/s | 144.45 μs | 24.2x |
-| nlohmann (extraction) | 172.0 MB/s | 3501.02 μs | 1.0x (baseline) |
-| RapidJSON (extraction) | 658.1 MB/s | 915.14 μs | 3.8x |
-| Serde (Rust) | 1722.0 MB/s | 349.75 μs | 10.0x |
-| yyjson | 2233.0 MB/s | 269.71 μs | 13.0x |
-
-### CITM Catalog Parsing Benchmark (1.7MB, Complex Objects)
-
-| Library/Method | Throughput | Latency | Speedup vs nlohmann |
-|----------------|------------|---------|-------------------|
-| **simdjson (manual)** | 3013.7 MB/s | 546.57 μs | 16.2x |
-| **simdjson (reflection)** | 2656.4 MB/s | 620.07 μs | 14.3x |
-| **simdjson::from()** | 2669.5 MB/s | 617.03 μs | 14.4x |
-| nlohmann (extraction) | 185.6 MB/s | 8874.02 μs | 1.0x (baseline) |
-| RapidJSON (extraction) | 1216.0 MB/s | 1354.62 μs | 6.5x |
-| Serde (Rust) | 534.6 MB/s | 3081.24 μs | 2.9x |
-| yyjson | 2681.3 MB/s | 614.32 μs | 14.4x |
-
-## Key Findings
-
-1. **Reflection performs excellently**: Only 6-13% slower than manual implementation
-2. **Massive speedup over traditional libraries**: 14-25x faster than nlohmann::json
-3. **Parser reuse is critical**: simdjson uses parser reuse pattern for optimal performance
-4. **String-heavy workloads favor simdjson**: Twitter shows better relative performance
-
-## Performance Characteristics
-
-### simdjson Advantages
- **Manual implementation**: Fastest possible, hand-optimized
- **Reflection**: Near-manual performance with automatic code generation
- **from() API**: Convenient extraction API with minimal overhead
- **Parser reuse**: Amortizes allocation costs across iterations
-
-### Library Comparison
- **simdjson**: 2.7-4.4 GB/s throughput (conservative approach)
- **yyjson**: 2.2-2.7 GB/s throughput (comparable performance)
- **Serde (Rust)**: 0.5-1.7 GB/s throughput (2.4-5.6x slower)
- **RapidJSON**: 0.7-1.2 GB/s throughput (3.6-6.5x slower)
- **nlohmann**: 172-186 MB/s throughput (14-25x slower)
-
-## Implementation Notes
-
- **Conservative approach**: Fresh parser instance per iteration (realistic usage)
- **Reflection implementation**: Uses C++26 static reflection (P2996)
- **Compilation**: Standalone with -O3 optimization
- **Results**: Median of 500-1000 iterations
-
-### Performance Difference vs Ablation Study
-
-The unified benchmark shows ~15% higher throughput (3.7 vs 3.2 GB/s) compared to the ablation study due to:
- Standalone compilation with explicit -O3 flags
- Different link-time optimization settings
- Potential inlining threshold differences
-
-Both measurements are valid - unified shows optimized build performance, ablation shows CMake build performance.
-
-## Conclusion
-
-simdjson's C++26 static reflection provides:
- **Near-manual performance** (within 6-13%)
- **14-25x speedup** over nlohmann::json
- **2.4-5.6x speedup** over Serde (Rust)
- **3.6-6.5x speedup** over RapidJSON
- **Automatic code generation** with reflection
-
-This demonstrates that C++26 reflection can provide zero-cost abstractions for JSON parsing.
-
-## Serialization Performance Results
-
-### Twitter Serialization Benchmark (631KB, String-Heavy)
-
-| Library/Method | Throughput | Latency | Speedup vs nlohmann |
-|----------------|------------|---------|-------------------|
-| **simdjson (reflection)** | 3521.5 MB/s | 23.00 μs | 14.5x |
-| **simdjson (DOM)** | 1674.3 MB/s | 48.36 μs | 6.9x |
-| nlohmann::json | 242.3 MB/s | 334.18 μs | 1.0x (baseline) |
-| RapidJSON | 861.1 MB/s | 94.04 μs | 3.6x |
-| yyjson | 2079.4 MB/s | 38.94 μs | 8.6x |
-| Serde (Rust) | 1321.5 MB/s | 61.28 μs | 5.5x |
-
-### CITM Catalog Serialization Benchmark (1.7MB, Complex Objects)
-
-| Library/Method | Throughput | Latency | Speedup vs nlohmann |
-|----------------|------------|---------|-------------------|
-| **simdjson (reflection)** | 2250.0 MB/s | 212.06 μs | 18.1x |
-| **simdjson (DOM)** | 779.6 MB/s | 612.03 μs | 6.3x |
-| nlohmann::json | 124.5 MB/s | 3831.37 μs | 1.0x (baseline) |
-| RapidJSON | 353.5 MB/s | 1349.76 μs | 2.8x |
-| yyjson | 1665.7 MB/s | 286.43 μs | 13.4x |
-| Serde (Rust) | 1167.1 MB/s | 408.82 μs | 9.4x |
-
-## Serialization Ablation Study Results
-
-### Impact of Compiler Optimizations on Serialization Performance
-
-The ablation study disabled individual optimizations to measure their contribution:
-
-#### Twitter Dataset (631KB)
-
-| Variant | Throughput | Performance Impact |
-|---------|------------|-----------------|
-| **Baseline** | 3211.1 MB/s | 100% (reference) |
-| No consteval | 1607.4 MB/s | -50.0% |
-| No SIMD escaping | 2269.2 MB/s | -29.3% |
-| No fast digits | 3034.8 MB/s | -5.5% |
-| No branch hints | 3182.5 MB/s | -0.9% |
-| Linear growth | 3225.4 MB/s | +0.4% |
-
-#### CITM Dataset (1.7MB)
-
-| Variant | Throughput | Performance Impact |
-|---------|------------|-----------------|
-| **Baseline** | 2360.1 MB/s | 100% (reference) |
-| No consteval | 978.3 MB/s | -58.6% |
-| No SIMD escaping | 2259.0 MB/s | -4.3% |
-| No fast digits | 1766.8 MB/s | -25.1% |
-| No branch hints | 2247.4 MB/s | -4.8% |
-| Linear growth | 2289.9 MB/s | -3.0% |
-
-### Key Findings from Ablation Study
-
-1. **consteval is critical**: Disabling compile-time evaluation reduces performance by 50-59%
-2. **SIMD escaping provides significant boost**: 4-29% performance improvement for string escaping
-3. **Fast digit conversion matters**: Especially for number-heavy datasets (25% improvement on CITM)
-4. **Branch hints have minimal impact**: Less than 5% difference in most cases
-5. **Exponential growth strategy**: Shows slight benefit over linear (3-4% improvement)
-
-## Running Benchmarks with Serde Comparison
-
-### Serialization Benchmarks (Including Serde)
-
-The repository includes benchmarks comparing simdjson with Serde (Rust's serialization framework).
-
-#### Prerequisites
- Rust and Cargo installed (`curl https://sh.rustup.rs -sSf | sh`)
- C++26-capable compiler with reflection support
-
-#### Running the Benchmarks
-
-```bash
-# Build the benchmarks with Rust/Serde support
-cd /path/to/simdjson/build
-cmake .. -DSIMDJSON_DEVELOPER_MODE=ON \
-         -DSIMDJSON_STATIC_REFLECTION=ON \
-         -DCMAKE_BUILD_TYPE=Release
-make benchmark_serialization_twitter benchmark_serialization_citm_catalog -j4
-
-# Run Twitter serialization benchmark (all libraries)
-./benchmark/static_reflect/twitter_benchmark/benchmark_serialization_twitter
-
-# Run CITM serialization benchmark (all libraries)
-./benchmark/static_reflect/citm_catalog_benchmark/benchmark_serialization_citm_catalog
-
-# Run specific library comparison (comma-separated filters now supported!)
-./benchmark/static_reflect/twitter_benchmark/benchmark_serialization_twitter -f simdjson_static_reflection,simdjson_to,rust
-
-# List available benchmarks
-./benchmark/static_reflect/twitter_benchmark/benchmark_serialization_twitter -l
-```
-
-#### Expected Results
-
-**Twitter Dataset (631KB) - Latest Results**
- simdjson (reflection): 3.52 GB/s
- yyjson: 2.08 GB/s
- simdjson (DOM): 1.67 GB/s
- Serde (Rust): 1.32 GB/s
- RapidJSON: 0.86 GB/s
- nlohmann: 0.24 GB/s
-
-**CITM Dataset (1.7MB) - Latest Results**
- simdjson (reflection): 2.25 GB/s
- yyjson: 1.67 GB/s
- Serde (Rust): 1.17 GB/s
- simdjson (DOM): 0.78 GB/s
- RapidJSON: 0.35 GB/s
- nlohmann: 0.12 GB/s
-
-**Key Finding**: simdjson with C++26 reflection achieves 1.8-1.9x faster serialization than Serde.
-
-Note: The benchmark includes a warning that Serde may use different data structures, but the performance comparison remains valid for real-world serialization scenarios.
@@ -1,46 +0,0 @@
-# Accessor Performance Benchmarks (C++26)
-
-These benchmarks compare the performance of runtime vs compile-time JSON accessors.
-For the comparison to be meaningful, you must build simdjson with support for
-C++26 reflexion. See the `p2996` repository in the main project directory.
-
-## Files
-
- `accessor_benchmark.h` - Common benchmark framework and test data
- `runtime_accessors.h` - Runtime `at_path()` benchmarks
- `compile_time_accessors.h` - Compile-time `at_path_compiled()` benchmarks (requires C++26 reflection)
-
-## Benchmarks
-
-Each benchmark measures parsing + single field access:
-
-1. **accessor_simple** - Simple field: `.name`
-2. **accessor_nested** - Nested field: `.address.city`
-3. **accessor_deep** - Deep nested field: `.address.coordinates.lat`
-
-## Building (Linux/macOS)
-
-```bash
-cmake -B build -D SIMDJSON_STATIC_REFLECTION=ON -DSIMDJSON_DEVELOPER_MODE=ON
-cmake --build build --target=bench_ondemand
-```
-
-The `SIMDJSON_STATIC_REFLECTION` will be made unnecessary once mainstream compilers
-begin supporting C++26 sufficiently well.
-
-## Running (Linux/macOS)
-
-
-```bash
-# Run all accessor benchmarks
-./build/bench_ondemand --benchmark_filter="accessor"
-```
-
-## Results
-
-We find that compile-time accessors show performance improvements that scale with path depth:
- Simple fields: ~1.2x faster
- Nested fields: ~1.5x faster
- Deep nested fields: ~1.8x faster
-
-The speedup comes from eliminating runtime path parsing and conversion overhead.
@@ -1,132 +0,0 @@
-#pragma once
-
-#include "json_benchmark/file_runner.h"
-#include <string>
-
-namespace accessor_performance {
-
-using namespace json_benchmark;
-
-// Test JSON for accessor benchmarks
-static const char* TEST_JSON = R"({
-  "name": "Alice",
-  "age": 30,
-  "email": "alice@example.com",
-  "address": {
-    "street": "123 Main St",
-    "city": "Boston",
-    "state": "MA",
-    "zip": 12345,
-    "coordinates": {
-      "lat": 42.3601,
-      "lon": -71.0589
-    }
-  },
-  "scores": [95, 87, 92, 88, 91],
-  "preferences": {
-    "theme": "dark",
-    "notifications": {
-      "email": true,
-      "push": false,
-      "sms": true
-    }
-  }
-})";
-
-// Struct definitions for compile-time validation
-#if SIMDJSON_STATIC_REFLECTION
-struct Coordinates {
-  double lat;
-  double lon;
-};
-
-struct Address {
-  std::string street;
-  std::string city;
-  std::string state;
-  int64_t zip;
-  Coordinates coordinates;
-};
-
-struct Notifications {
-  bool email;
-  bool push;
-  bool sms;
-};
-
-struct Preferences {
-  std::string theme;
-  Notifications notifications;
-};
-
-struct TestData {
-  std::string name;
-  int64_t age;
-  std::string email;
-  Address address;
-  std::vector<int64_t> scores;
-  Preferences preferences;
-};
-#endif // SIMDJSON_STATIC_REFLECTION
-
-// Single-access benchmark runner: measures ONE field access per iteration
-template<typename I>
-struct single_access_runner : public file_runner<I> {
-  std::string result_string;
-  int64_t result_int{};
-  double result_double{};
-  bool result_bool{};
-
-  bool setup(benchmark::State &state) {
-    this->json = simdjson::padded_string(TEST_JSON, strlen(TEST_JSON));
-    state.SetBytesProcessed(int64_t(state.iterations()) * int64_t(this->json.size()));
-    return true;
-  }
-
-  bool before_run(benchmark::State &state) {
-    if (!file_runner<I>::before_run(state)) { return false; }
-    result_string.clear();
-    result_int = 0;
-    result_double = 0.0;
-    result_bool = false;
-    return true;
-  }
-
-  bool run(benchmark::State &) {
-    return this->implementation.run(this->json, result_string, result_int, result_double, result_bool);
-  }
-
-  template<typename R>
-  bool diff(benchmark::State &state, single_access_runner<R> &reference) {
-    if (result_string != reference.result_string ||
-        result_int != reference.result_int ||
-        result_double != reference.result_double ||
-        result_bool != reference.result_bool) {
-      std::cerr << "Accessor benchmark results differ!" << std::endl;
-      return false;
-    }
-    return true;
-  }
-
-  size_t items_per_iteration() {
-    return 1;
-  }
-};
-
-// Benchmark template definitions
-struct runtime_at_path_simple;
-template<typename I> simdjson_inline static void accessor_simple(benchmark::State &state) {
-  run_json_benchmark<single_access_runner<I>, single_access_runner<runtime_at_path_simple>>(state);
-}
-
-struct runtime_at_path_nested;
-template<typename I> simdjson_inline static void accessor_nested(benchmark::State &state) {
-  run_json_benchmark<single_access_runner<I>, single_access_runner<runtime_at_path_nested>>(state);
-}
-
-struct runtime_at_path_deep;
-template<typename I> simdjson_inline static void accessor_deep(benchmark::State &state) {
-  run_json_benchmark<single_access_runner<I>, single_access_runner<runtime_at_path_deep>>(state);
-}
-
-} // namespace accessor_performance
@@ -1,56 +0,0 @@
-#pragma once
-
-#if SIMDJSON_EXCEPTIONS && SIMDJSON_STATIC_REFLECTION
-
-#include "accessor_benchmark.h"
-
-namespace accessor_performance {
-
-using namespace simdjson;
-
-struct compile_time_at_path_simple {
-  ondemand::parser parser{};
-
-  bool run(simdjson::padded_string &json, std::string &result_str, int64_t&, double&, bool&) {
-    auto doc = parser.iterate(json);
-    std::string_view name;
-    auto r = ondemand::json_path::at_path_compiled<TestData, ".name">(doc);
-    if (r.get(name) != SUCCESS) return false;
-    result_str = name;
-    return true;
-  }
-};
-
-struct compile_time_at_path_nested {
-  ondemand::parser parser{};
-
-  bool run(simdjson::padded_string &json, std::string &result_str, int64_t&, double&, bool&) {
-    auto doc = parser.iterate(json);
-    std::string_view city;
-    auto r = ondemand::json_path::at_path_compiled<TestData, ".address.city">(doc);
-    if (r.get(city) != SUCCESS) return false;
-    result_str = city;
-    return true;
-  }
-};
-
-struct compile_time_at_path_deep {
-  ondemand::parser parser{};
-
-  bool run(simdjson::padded_string &json, std::string&, int64_t&, double &result_dbl, bool&) {
-    auto doc = parser.iterate(json);
-    double lat;
-    auto r = ondemand::json_path::at_path_compiled<TestData, ".address.coordinates.lat">(doc);
-    if (r.get(lat) != SUCCESS) return false;
-    result_dbl = lat;
-    return true;
-  }
-};
-
-BENCHMARK_TEMPLATE(accessor_simple, compile_time_at_path_simple)->UseManualTime();
-BENCHMARK_TEMPLATE(accessor_nested, compile_time_at_path_nested)->UseManualTime();
-BENCHMARK_TEMPLATE(accessor_deep, compile_time_at_path_deep)->UseManualTime();
-
-} // namespace accessor_performance
-
-#endif // SIMDJSON_EXCEPTIONS && SIMDJSON_STATIC_REFLECTION
@@ -1,53 +0,0 @@
-#pragma once
-
-#if SIMDJSON_EXCEPTIONS
-
-#include "accessor_benchmark.h"
-
-namespace accessor_performance {
-
-using namespace simdjson;
-
-struct runtime_at_path_simple {
-  ondemand::parser parser{};
-
-  bool run(simdjson::padded_string &json, std::string &result_str, int64_t&, double&, bool&) {
-    auto doc = parser.iterate(json);
-    std::string_view name;
-    if (doc.at_path(".name").get(name) != SUCCESS) return false;
-    result_str = name;
-    return true;
-  }
-};
-
-struct runtime_at_path_nested {
-  ondemand::parser parser{};
-
-  bool run(simdjson::padded_string &json, std::string &result_str, int64_t&, double&, bool&) {
-    auto doc = parser.iterate(json);
-    std::string_view city;
-    if (doc.at_path(".address.city").get(city) != SUCCESS) return false;
-    result_str = city;
-    return true;
-  }
-};
-
-struct runtime_at_path_deep {
-  ondemand::parser parser{};
-
-  bool run(simdjson::padded_string &json, std::string&, int64_t&, double &result_dbl, bool&) {
-    auto doc = parser.iterate(json);
-    double lat;
-    if (doc.at_path(".address.coordinates.lat").get(lat) != SUCCESS) return false;
-    result_dbl = lat;
-    return true;
-  }
-};
-
-BENCHMARK_TEMPLATE(accessor_simple, runtime_at_path_simple)->UseManualTime();
-BENCHMARK_TEMPLATE(accessor_nested, runtime_at_path_nested)->UseManualTime();
-BENCHMARK_TEMPLATE(accessor_deep, runtime_at_path_deep)->UseManualTime();
-
-} // namespace accessor_performance
-
-#endif // SIMDJSON_EXCEPTIONS
@@ -1,73 +0,0 @@
-#pragma once
-
-#include "json_benchmark/file_runner.h"
-#include <map>
-#include <string>
-
-
-namespace amazon_cellphones {
-
-const bool UNTHREADED = false;
-const bool THREADED = true;
-
-using namespace json_benchmark;
-
-struct brand {
-    double cumulative_rating;
-    uint64_t reviews_count;
-    simdjson_inline bool operator==(const brand &other) const {
-        return cumulative_rating == other.cumulative_rating &&
-            reviews_count == other.reviews_count;
-    }
-    simdjson_inline bool operator!=(const brand &other) const { return !(*this == other); }
-};
-
-simdjson_unused static std::ostream &operator<<(std::ostream &o, const brand &b) {
-  o << "cumulative_rating: " << b.cumulative_rating << std::endl;
-  o << "reviews_count: " << b.reviews_count << std::endl;
-  return o;
-}
-
-template<typename StringType>
-simdjson_unused static std::ostream &operator<<(std::ostream &o, const std::pair<const StringType, brand> &p) {
-  o << "brand: " << p.first << std::endl;
-	o << p.second;
-  return o;
-}
-
-template<typename I>
-struct runner : public file_runner<I> {
-    std::map<typename I::StringType, brand> result{};
-
-    bool setup(benchmark::State &state) {
-        return this->load_json(state, AMAZON_CELLPHONES_NDJSON);
-    }
-
-    bool before_run(benchmark::State &state) {
-        if (!file_runner<I>::before_run(state)) { return false; }
-        result.clear();
-        return true;
-    }
-
-    bool run(benchmark::State &) {
-        return this->implementation.run(this->json, result);
-    }
-
-    template<typename R>
-    bool diff(benchmark::State &state, runner<R> &reference) {
-        return diff_results(state, result, reference.result, diff_flags::NONE);
-    }
-
-    size_t items_per_iteration() {
-        return result.size();
-    }
-};
-
-template<bool threaded>
-struct simdjson_dom;
-
-template<typename I> simdjson_inline static void amazon_cellphones(benchmark::State &state) {
-  run_json_benchmark<runner<I>, runner<simdjson_dom<UNTHREADED>>>(state);
-}
-
-}   // namespace amazon_cellphones
@@ -1,51 +0,0 @@
-#pragma once
-
-#if SIMDJSON_EXCEPTIONS
-
-#include "amazon_cellphones.h"
-
-namespace amazon_cellphones {
-
-using namespace simdjson;
-
-template<bool threaded>
-struct simdjson_dom {
-  using StringType = std::string;
-
-  dom::parser parser{};
-
-  bool run(simdjson::padded_string &json, std::map<StringType, brand> &result) {
-#ifdef SIMDJSON_THREADS_ENABLED
-    parser.threaded = threaded;
-#endif
-    auto stream = parser.parse_many(json);
-    auto i = stream.begin();
-    ++i;  // Skip first line
-    for (;i != stream.end(); ++i) {
-      auto doc = *i;
-      StringType copy(std::string_view(doc.at(1)));
-      auto x = result.find(copy);
-      if (x == result.end()) {  // If key not found, add new key
-        result.emplace(copy, amazon_cellphones::brand{
-          double(doc.at(5)) * uint64_t(doc.at(7)),
-          uint64_t(doc.at(7))
-        });
-      } else {  // Otherwise, update key data
-        x->second.cumulative_rating += double(doc.at(5)) * uint64_t(doc.at(7));
-        x->second.reviews_count += uint64_t(doc.at(7));
-      }
-    }
-
-    return true;
-  }
-
-};
-
-BENCHMARK_TEMPLATE(amazon_cellphones, simdjson_dom<UNTHREADED>)->UseManualTime();
-#ifdef SIMDJSON_THREADS_ENABLED
-BENCHMARK_TEMPLATE(amazon_cellphones, simdjson_dom<THREADED>)->UseManualTime();
-#endif
-
-} // namespace amazon_cellphones
-
-#endif // SIMDJSON_EXCEPTIONS
@@ -1,72 +0,0 @@
-#pragma once
-
-#if SIMDJSON_EXCEPTIONS
-
-#include "amazon_cellphones.h"
-
-namespace amazon_cellphones {
-
-using namespace simdjson;
-
-template<bool threaded>
-struct simdjson_ondemand {
-  using StringType = std::string;
-
-  ondemand::parser parser{};
-
-  bool run(simdjson::padded_string &json, std::map<StringType, brand> &result) {
-#ifdef SIMDJSON_THREADS_ENABLED
-    parser.threaded = threaded;
-#endif
-    ondemand::document_stream stream = parser.iterate_many(json);
-    ondemand::document_stream::iterator i = stream.begin();
-    ++i;  // Skip first line
-    for (;i != stream.end(); ++i) {
-      auto doc = *i;
-      size_t index{0};
-      StringType copy;
-      double rating;
-      uint64_t reviews;
-      for ( auto value : doc ) {
-        switch (index)
-        {
-        case 1:
-          copy = StringType(std::string_view(value));
-          break;
-        case 5:
-          rating = double(value);
-          break;
-        case 7:
-          reviews = uint64_t(value);
-          break;
-        default:
-          break;
-        }
-        index++;
-      }
-
-      auto x = result.find(copy);
-      if (x == result.end()) {  // If key not found, add new key
-        result.emplace(copy, amazon_cellphones::brand{
-          rating * reviews,
-          reviews
-        });
-      } else {  // Otherwise, update key data
-        x->second.cumulative_rating += rating * reviews;
-        x->second.reviews_count += reviews;
-      }
-    }
-
-    return true;
-  }
-
-};
-
-BENCHMARK_TEMPLATE(amazon_cellphones, simdjson_ondemand<UNTHREADED>)->UseManualTime();
-#ifdef SIMDJSON_THREADS_ENABLED
-BENCHMARK_TEMPLATE(amazon_cellphones, simdjson_ondemand<THREADED>)->UseManualTime();
-#endif
-
-} // namespace amazon_cellphones
-
-#endif // SIMDJSON_EXCEPTIONS
@@ -1,5 +1,4 @@
 #include <benchmark/benchmark.h>
-#include <iostream>
 #include "simdjson.h"
 #include <sstream>

@@ -473,6 +472,28 @@ static void twitter_count(State& state) {
 }
 BENCHMARK(twitter_count);

+#ifndef SIMDJSON_DISABLE_DEPRECATED_API
+SIMDJSON_PUSH_DISABLE_WARNINGS
+SIMDJSON_DISABLE_DEPRECATED_WARNING
+static void iterator_twitter_count(State& state) {
+  // Prints the number of results in twitter.json
+  padded_string json = padded_string::load(TWITTER_JSON);
+  ParsedJson pj = build_parsed_json(json);
+  for (simdjson_unused auto _ : state) {
+    ParsedJson::Iterator iter(pj);
+    // uint64_t result_count = doc["search_metadata"]["count"];
+    if (!iter.move_to_key("search_metadata")) { return; }
+    if (!iter.move_to_key("count")) { return; }
+    if (!iter.is_integer()) { return; }
+    int64_t result_count = iter.get_integer();
+
+    if (result_count != 100) { return; }
+  }
+}
+BENCHMARK(iterator_twitter_count);
+SIMDJSON_POP_DISABLE_WARNINGS
+#endif // SIMDJSON_DISABLE_DEPRECATED_API
+
 static void twitter_default_profile(State& state) {
  // Count unique users with a default profile.
  dom::parser parser;
@@ -499,7 +520,7 @@ static void twitter_image_sizes(State& state) {
    set<tuple<uint64_t, uint64_t>> image_sizes;
    for (dom::object tweet : doc["statuses"]) {
      dom::array media;
-      if (! (error = tweet["entities"]["media"].get(media))) {
+      if (not (error = tweet["entities"]["media"].get(media))) {
        for (dom::object image : media) {
          for (auto size : image["sizes"].get_object()) {
             image_sizes.emplace(size.value["w"], size.value["h"]);
@@ -542,7 +563,7 @@ static void error_code_twitter_default_profile(State& state) noexcept {
    for (dom::element tweet : tweets) {
      dom::object user;
      if ((error = tweet["user"].get(user))) { return; }
-      bool default_profile{};
+      bool default_profile;
      if ((error = user["default_profile"].get(default_profile))) { return; }
      if (default_profile) {
        std::string_view screen_name;
@@ -556,6 +577,54 @@ static void error_code_twitter_default_profile(State& state) noexcept {
 }
 BENCHMARK(error_code_twitter_default_profile);

+#ifndef SIMDJSON_DISABLE_DEPRECATED_API
+
+SIMDJSON_PUSH_DISABLE_WARNINGS
+SIMDJSON_DISABLE_DEPRECATED_WARNING
+
+static void iterator_twitter_default_profile(State& state) {
+  // Count unique users with a default profile.
+  padded_string json;
+  auto error = padded_string::load(TWITTER_JSON).get(json);
+  if (error) { std::cerr << error << std::endl; return; }
+  ParsedJson pj = build_parsed_json(json);
+  for (simdjson_unused auto _ : state) {
+    set<string_view> default_users;
+    ParsedJson::Iterator iter(pj);
+
+    // for (dom::object tweet : doc["statuses"]) {
+    if (!(iter.move_to_key("statuses") && iter.is_array())) { return; }
+    if (iter.down()) { // first status
+      do {
+
+        // dom::object user = tweet["user"];
+        if (!(iter.move_to_key("user") && iter.is_object())) { return; }
+
+        // if (user["default_profile"]) {
+        if (iter.move_to_key("default_profile")) {
+          if (iter.is_true()) {
+            if (!iter.up()) { return; } // back to user
+
+            // default_users.insert(user["screen_name"]);
+            if (!(iter.move_to_key("screen_name") && iter.is_string())) { return; }
+            default_users.emplace(iter.get_string(), iter.get_string_length());
+          }
+          if (!iter.up()) { return; } // back to user
+        }
+
+        if (!iter.up()) { return; } // back to status
+
+      } while (iter.next()); // next status
+    }
+
+    if (default_users.size() != 86) { return; }
+  }
+}
+
+SIMDJSON_POP_DISABLE_WARNINGS
+BENCHMARK(iterator_twitter_default_profile);
+#endif // SIMDJSON_DISABLE_DEPRECATED_API
+
 static void error_code_twitter_image_sizes(State& state) noexcept {
  // Count unique image sizes
  dom::parser parser;
@@ -568,7 +637,7 @@ static void error_code_twitter_image_sizes(State& state) noexcept {
    if ((error = doc["statuses"].get(statuses))) { return; }
    for (dom::element tweet : statuses) {
      dom::array images;
-      if (! (error = tweet["entities"]["media"].get(images))) {
+      if (not (error = tweet["entities"]["media"].get(images))) {
        for (dom::element image : images) {
          dom::object sizes;
          if ((error = image["sizes"].get(sizes))) { return; }
@@ -586,28 +655,91 @@ static void error_code_twitter_image_sizes(State& state) noexcept {
 }
 BENCHMARK(error_code_twitter_image_sizes);

-static void parse_surrogate_pairs(State& state) {
-  // NOTE: This mostly exists to show there's a tiny benefit to
-  // loading and comparing both bytes of "\\u" simultaneously.
-  // (which should also reduce the compiled code size).
-  // The repeated surrogate pairs make this easier to measure.
-  dom::parser parser;
-  const std::string_view data = "\"\\uD834\\uDD1E\\uD834\\uDD1E\\uD834\\uDD1E\\uD834\\uDD1E\\uD834\\uDD1E\\uD834\\uDD1E\\uD834\\uDD1E\\uD834\\uDD1E\\uD834\\uDD1E\\uD834\\uDD1E\"";
-  padded_string docdata{data};
-  // we do not want mem. alloc. in the loop.
-  auto error = parser.allocate(docdata.size());
-  if (error) {
-    cout << error << endl;
-    return;
-  }
+#ifndef SIMDJSON_DISABLE_DEPRECATED_API
+
+SIMDJSON_PUSH_DISABLE_WARNINGS
+SIMDJSON_DISABLE_DEPRECATED_WARNING
+static void iterator_twitter_image_sizes(State& state) {
+  // Count unique image sizes
+  padded_string json;
+  auto error = padded_string::load(TWITTER_JSON).get(json);
+  if (error) { std::cerr << error << std::endl; return; }
+  ParsedJson pj = build_parsed_json(json);
  for (simdjson_unused auto _ : state) {
-    dom::element doc;
-    if ((error = parser.parse(docdata).get(doc))) {
-      cerr << "could not parse string" << error << endl;
-      return;
+    set<tuple<uint64_t, uint64_t>> image_sizes;
+    ParsedJson::Iterator iter(pj);
+
+    // for (dom::object tweet : doc["statuses"]) {
+    if (!(iter.move_to_key("statuses") && iter.is_array())) { return; }
+    if (iter.down()) { // first status
+      do {
+
+        // dom::object media;
+        // not_found = tweet["entities"]["media"].get(media);
+        // if (!not_found) {
+        if (iter.move_to_key("entities")) {
+          if (!iter.is_object()) { return; }
+          if (iter.move_to_key("media")) {
+            if (!iter.is_array()) { return; }
+
+            //   for (dom::object image : media) {
+            if (iter.down()) { // first media
+              do {
+
+                // for (auto [key, size] : dom::object(image["sizes"])) {
+                if (!(iter.move_to_key("sizes") && iter.is_object())) { return; }
+                if (iter.down()) { // first size
+                  do {
+                    iter.move_to_value();
+
+                    // image_sizes.insert({ size["w"], size["h"] });
+                    if (!(iter.move_to_key("w")) && !iter.is_integer()) { return; }
+                    uint64_t width = iter.get_integer();
+                    if (!iter.up()) { return; } // back to size
+                    if (!(iter.move_to_key("h")) && !iter.is_integer()) { return; }
+                    uint64_t height = iter.get_integer();
+                    if (!iter.up()) { return; } // back to size
+                    image_sizes.emplace(width, height);
+
+                  } while (iter.next()); // next size
+                  if (!iter.up()) { return; } // back to sizes
+                }
+                if (!iter.up()) { return; } // back to image
+              } while (iter.next()); // next image
+              if (!iter.up()) { return; } // back to media
+            }
+            if (!iter.up()) { return; } // back to entities
+          }
+          if (!iter.up()) { return; } // back to status
+        }
+      } while (iter.next()); // next status
    }
+
+    if (image_sizes.size() != 15) { return; };
  }
 }
-BENCHMARK(parse_surrogate_pairs);
+BENCHMARK(iterator_twitter_image_sizes);
+
+#endif // SIMDJSON_DISABLE_DEPRECATED_API
+
+#ifndef SIMDJSON_DISABLE_DEPRECATED_API
+static void print_json(State& state) noexcept {
+  // Prints the number of results in twitter.json
+  dom::parser parser;
+
+  padded_string json;
+  auto error = padded_string::load(TWITTER_JSON).get(json);
+  if (error) { std::cerr << error << std::endl; return; }
+
+  int code = json_parse(json, parser);
+  if (code) { cerr << error_message(code) << endl; return; }
+  for (simdjson_unused auto _ : state) {
+    std::stringstream s;
+    if (!parser.print_json(s)) { cerr << "print_json failed" << endl; return; }
+  }
+}
+BENCHMARK(print_json);
+#endif // SIMDJSON_DISABLE_DEPRECATED_API
+SIMDJSON_POP_DISABLE_WARNINGS

 BENCHMARK_MAIN();
@@ -21,136 +21,52 @@ SIMDJSON_PUSH_DISABLE_ALL_WARNINGS
 #include <nlohmann/json.hpp>
 #endif

-#ifdef SIMDJSON_COMPETITION_BOOSTJSON
-#include <boost/json.hpp>
-#endif
-
 // This has to be last, for reasons I don't yet understand
 #include <benchmark/benchmark.h>

 SIMDJSON_POP_DISABLE_WARNINGS
-#include "json2msgpack/simdjson_ondemand.h"
-#include "json2msgpack/simdjson_dom.h"
-#include "json2msgpack/yyjson.h"
-#include "json2msgpack/rapidjson.h"
-#if SIMDJSON_COMPETITION_ONDEMAND_SAJSON
-#include "json2msgpack/sajson.h"
-#endif // SIMDJSON_COMPETITION_ONDEMAND_SAJSON
-#include "json2msgpack/nlohmann_json.h"
-#include "json2msgpack/boostjson.h"

-#include "partial_tweets/simdjson_ondemand.h"
 #include "partial_tweets/simdjson_dom.h"
+#include "partial_tweets/simdjson_ondemand.h"
 #include "partial_tweets/yyjson.h"
-#if SIMDJSON_COMPETITION_ONDEMAND_SAJSON
 #include "partial_tweets/sajson.h"
-#endif // SIMDJSON_COMPETITION_ONDEMAND_SAJSON
 #include "partial_tweets/rapidjson.h"
-#if SIMDJSON_COMPETITION_SAX
-#include "partial_tweets/rapidjson_sax.h"
-#endif // SIMDJSON_COMPETITION_SAX
 #include "partial_tweets/nlohmann_json.h"
-#if SIMDJSON_COMPETITION_SAX
-#include "partial_tweets/nlohmann_json_sax.h"
-#endif // SIMDJSON_COMPETITION_SAX
-#include "partial_tweets/boostjson.h"

-
-#include "distinct_user_id/simdjson_ondemand.h"
-#include "distinct_user_id/simdjson_ondemand_json_pointer.h"
-#include "distinct_user_id/simdjson_dom.h"
-#include "distinct_user_id/simdjson_dom_json_pointer.h"
-#include "distinct_user_id/yyjson.h"
-#if SIMDJSON_COMPETITION_ONDEMAND_SAJSON
-#include "distinct_user_id/sajson.h"
-#endif // SIMDJSON_COMPETITION_ONDEMAND_SAJSON
-#include "distinct_user_id/rapidjson.h"
-#if SIMDJSON_COMPETITION_SAX
-#include "distinct_user_id/rapidjson_sax.h"
-#endif // SIMDJSON_COMPETITION_SAX
-#include "distinct_user_id/nlohmann_json.h"
-#if SIMDJSON_COMPETITION_SAX
-#include "distinct_user_id/nlohmann_json_sax.h"
-#endif // SIMDJSON_COMPETITION_SAX
-#include "distinct_user_id/boostjson.h"
-
-#include "find_tweet/simdjson_ondemand.h"
-#include "find_tweet/simdjson_dom.h"
-#include "find_tweet/yyjson.h"
-#if SIMDJSON_COMPETITION_ONDEMAND_SAJSON
-#include "find_tweet/sajson.h"
-#endif // SIMDJSON_COMPETITION_ONDEMAND_SAJSON
-#include "find_tweet/rapidjson.h"
-#if SIMDJSON_COMPETITION_SAX
-#include "find_tweet/rapidjson_sax.h"
-#endif // SIMDJSON_COMPETITION_SAX
-#include "find_tweet/nlohmann_json.h"
-#if SIMDJSON_COMPETITION_SAX
-#include "find_tweet/nlohmann_json_sax.h"
-#endif // SIMDJSON_COMPETITION_SAX
-#include "find_tweet/boostjson.h"
-
-#include "top_tweet/simdjson_ondemand.h"
-#include "top_tweet/simdjson_dom.h"
-#include "top_tweet/yyjson.h"
-#if SIMDJSON_COMPETITION_ONDEMAND_SAJSON
-#include "top_tweet/sajson.h"
-#endif // SIMDJSON_COMPETITION_ONDEMAND_SAJSON
-#include "top_tweet/rapidjson.h"
-#if SIMDJSON_COMPETITION_SAX
-#include "top_tweet/rapidjson_sax.h"
-#endif // SIMDJSON_COMPETITION_SAX
-#include "top_tweet/nlohmann_json.h"
-#if SIMDJSON_COMPETITION_SAX
-#include "top_tweet/nlohmann_json_sax.h"
-#endif // SIMDJSON_COMPETITION_SAX
-#include "top_tweet/boostjson.h"
-
-
-#include "kostya/simdjson_ondemand.h"
-#include "kostya/simdjson_dom.h"
-#include "kostya/yyjson.h"
-#if SIMDJSON_COMPETITION_ONDEMAND_SAJSON
-#include "kostya/sajson.h"
-#endif // SIMDJSON_COMPETITION_ONDEMAND_SAJSON
-#include "kostya/rapidjson.h"
-#if SIMDJSON_COMPETITION_SAX
-#include "kostya/rapidjson_sax.h"
-#endif // SIMDJSON_COMPETITION_SAX
-#include "kostya/nlohmann_json.h"
-#if SIMDJSON_COMPETITION_SAX
-#include "kostya/nlohmann_json_sax.h"
-#endif // SIMDJSON_COMPETITION_SAX
-#include "kostya/boostjson.h"
-
-#include "large_random/simdjson_ondemand.h"
-#if SIMDJSON_COMPETITION_ONDEMAND_UNORDERED
-#include "large_random/simdjson_ondemand_unordered.h"
-#endif // SIMDJSON_COMPETITION_ONDEMAND_UNORDERED
 #include "large_random/simdjson_dom.h"
+#include "large_random/simdjson_ondemand.h"
+#include "large_random/simdjson_ondemand_unordered.h"
 #include "large_random/yyjson.h"
-#if SIMDJSON_COMPETITION_ONDEMAND_SAJSON
 #include "large_random/sajson.h"
-#endif // SIMDJSON_COMPETITION_ONDEMAND_SAJSON
 #include "large_random/rapidjson.h"
-#if SIMDJSON_COMPETITION_SAX
-#include "large_random/rapidjson_sax.h"
-#endif // SIMDJSON_COMPETITION_SAX
 #include "large_random/nlohmann_json.h"
-#if SIMDJSON_COMPETITION_SAX
-#include "large_random/nlohmann_json_sax.h"
-#endif // SIMDJSON_COMPETITION_SAX
-#include "large_random/boostjson.h"

-#include "amazon_cellphones/simdjson_dom.h"
-#include "amazon_cellphones/simdjson_ondemand.h"
+#include "kostya/simdjson_dom.h"
+#include "kostya/simdjson_ondemand.h"
+#include "kostya/yyjson.h"
+#include "kostya/sajson.h"
+#include "kostya/rapidjson.h"
+#include "kostya/nlohmann_json.h"

-#include "large_amazon_cellphones/simdjson_dom.h"
-#include "large_amazon_cellphones/simdjson_ondemand.h"
+#include "distinct_user_id/simdjson_dom.h"
+#include "distinct_user_id/simdjson_ondemand.h"
+#include "distinct_user_id/yyjson.h"
+#include "distinct_user_id/sajson.h"
+#include "distinct_user_id/rapidjson.h"
+#include "distinct_user_id/nlohmann_json.h"

-#include "accessor_performance/runtime_accessors.h"
-#if SIMDJSON_STATIC_REFLECTION
-#include "accessor_performance/compile_time_accessors.h"
-#endif
+#include "find_tweet/simdjson_dom.h"
+#include "find_tweet/simdjson_ondemand.h"
+#include "find_tweet/yyjson.h"
+#include "find_tweet/sajson.h"
+#include "find_tweet/rapidjson.h"
+#include "find_tweet/nlohmann_json.h"
+
+#include "top_tweet/simdjson_dom.h"
+#include "top_tweet/simdjson_ondemand.h"
+#include "top_tweet/yyjson.h"
+#include "top_tweet/sajson.h"
+#include "top_tweet/rapidjson.h"
+#include "top_tweet/nlohmann_json.h"

 BENCHMARK_MAIN();
@@ -1,5 +1,4 @@
 #include <benchmark/benchmark.h>
-#include <iostream>
 #include "simdjson.h"
 using namespace simdjson;
 using namespace benchmark;
@@ -11,64 +10,6 @@ const char *GSOC_JSON = SIMDJSON_BENCHMARK_DATA_DIR "gsoc-2018.json";



-
-static void fast_minify_twitter(State& state) {
-  dom::parser parser;
-  padded_string docdata;
-  auto error = padded_string::load(TWITTER_JSON).get(docdata);
-  if(error) {
-      cerr << "could not parse twitter.json" << error << endl;
-      return;
-  }
-  std::unique_ptr<char[]> buffer{new char[docdata.size()]};
-
-  size_t bytes = 0;
-  for (simdjson_unused auto _ : state) {
-    size_t new_length{}; // It will receive the minified length.
-    auto error = simdjson::minify(docdata.data(), docdata.size(), buffer.get(), new_length);
-    bytes += docdata.size();
-    benchmark::DoNotOptimize(error);
-  }
-  // Gigabyte: https://en.wikipedia.org/wiki/Gigabyte
-  state.counters["Gigabytes"] = benchmark::Counter(
-	        double(bytes), benchmark::Counter::kIsRate,
-	        benchmark::Counter::OneK::kIs1000); // For GiB : kIs1024
-  state.counters["docs"] = Counter(double(state.iterations()), benchmark::Counter::kIsRate);
-}
-BENCHMARK(fast_minify_twitter)->Repetitions(10)->ComputeStatistics("max", [](const std::vector<double>& v) -> double {
-    return *(std::max_element(std::begin(v), std::end(v)));
-  })->DisplayAggregatesOnly(true);
-
-
-
-
-static void fast_minify_gsoc(State& state) {
-  dom::parser parser;
-  padded_string docdata;
-  auto error = padded_string::load(GSOC_JSON).get(docdata);
-  if(error) {
-      cerr << "could not parse gsoc-2018.json" << error << endl;
-      return;
-  }
-  std::unique_ptr<char[]> buffer{new char[docdata.size()]};
-
-  size_t bytes = 0;
-  for (simdjson_unused auto _ : state) {
-    size_t new_length{}; // It will receive the minified length.
-    auto error = simdjson::minify(docdata.data(), docdata.size(), buffer.get(), new_length);
-    bytes += docdata.size();
-    benchmark::DoNotOptimize(error);
-  }
-  // Gigabyte: https://en.wikipedia.org/wiki/Gigabyte
-  state.counters["Gigabytes"] = benchmark::Counter(
-	        double(bytes), benchmark::Counter::kIsRate,
-	        benchmark::Counter::OneK::kIs1000); // For GiB : kIs1024
-  state.counters["docs"] = Counter(double(state.iterations()), benchmark::Counter::kIsRate);
-}
-BENCHMARK(fast_minify_gsoc)->Repetitions(10)->ComputeStatistics("max", [](const std::vector<double>& v) -> double {
-    return *(std::max_element(std::begin(v), std::end(v)));
-  })->DisplayAggregatesOnly(true);
-
 static void unicode_validate_twitter(State& state) {
  dom::parser parser;
  padded_string docdata;
@@ -169,6 +110,22 @@ BENCHMARK(parse_gsoc)->Repetitions(10)->ComputeStatistics("max", [](const std::v
  })->DisplayAggregatesOnly(true);


+
+#ifndef SIMDJSON_DISABLE_DEPRECATED_API
+SIMDJSON_PUSH_DISABLE_WARNINGS
+SIMDJSON_DISABLE_DEPRECATED_WARNING
+static void json_parse(State& state) {
+  ParsedJson pj;
+  if (!pj.allocate_capacity(EMPTY_ARRAY.length())) { return; }
+  for (simdjson_unused auto _ : state) {
+    auto error = json_parse(EMPTY_ARRAY, pj);
+    if (error) { return; }
+  }
+}
+SIMDJSON_POP_DISABLE_WARNINGS
+BENCHMARK(json_parse);
+#endif // SIMDJSON_DISABLE_DEPRECATED_API
+
 static void parser_parse_error_code(State& state) {
  dom::parser parser;
  if (parser.allocate(EMPTY_ARRAY.length())) { return; }
@@ -197,6 +154,20 @@ BENCHMARK(parser_parse_exception);

 #endif // SIMDJSON_EXCEPTIONS

+#ifndef SIMDJSON_DISABLE_DEPRECATED_API
+SIMDJSON_PUSH_DISABLE_WARNINGS
+SIMDJSON_DISABLE_DEPRECATED_WARNING
+static void build_parsed_json(State& state) {
+  for (simdjson_unused auto _ : state) {
+    dom::parser parser = simdjson::build_parsed_json(EMPTY_ARRAY);
+    if (!parser.valid) { return; }
+  }
+}
+SIMDJSON_POP_DISABLE_WARNINGS
+
+BENCHMARK(build_parsed_json);
+#endif
+
 static void document_parse_error_code(State& state) {
  for (simdjson_unused auto _ : state) {
    dom::parser parser;
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Daniel Lemire	e9b893ff1b	Preparing the actual release.	2021-06-05 11:33:32 -04:00
Daniel Lemire	438c2a28ff	Preparing patch release.	2021-06-04 17:09:21 -04:00
Daniel Lemire	45182ec11b	Tagging the version.	2021-05-27 16:21:00 -04:00
Daniel Lemire	a0c020d46d	Patching.	2021-05-27 16:20:07 -04:00
Daniel Lemire	076f41ae4b	Patch release candidate.	2021-05-15 15:45:02 -04:00
Daniel Lemire	6a37fc1871	Disabling perf testing on version 0.9	2021-05-14 09:22:48 -04:00
Daniel Lemire	c6c29c2827	Better definition for fallthrough.	2021-03-31 14:38:52 -04:00
Daniel Lemire	941e903f28	Prerelease commit.	2021-03-31 13:48:43 -04:00