Add bazel support (#1420 )

* Add bazel support * Add github workflow for bazel
Run C++26 workflows with docker (#1421 )
2026-04-30 19:09:10 +08:00 · 2026-04-30 12:30:01 +02:00 · 2026-04-30 12:27:12 +02:00
23 changed files with 903 additions and 203 deletions
--- a/.bazelrc
+++ b/.bazelrc
@ -0,0 +1,26 @@
+# Bazel settings for ETL
+build --enable_bzlmod
+build --cxxopt=-std=c++17
+
+# Cross-compilation: build flags + QEMU (mirrors .devcontainer/run-tests.sh)
+# Each config sets CC + tool env vars so Bazel's auto-configured toolchain
+# finds the full cross-tool suite, and --run_under for QEMU execution.
+build:armhf    --repo_env=CC=arm-linux-gnueabihf-gcc --repo_env=AR=arm-linux-gnueabihf-ar --repo_env=LD=arm-linux-gnueabihf-ld --repo_env=NM=arm-linux-gnueabihf-nm --repo_env=STRIP=arm-linux-gnueabihf-strip --repo_env=OBJDUMP=arm-linux-gnueabihf-objdump
+build:armhf    --cxxopt=-std=c++23 --copt=-DETL_NO_STL --copt=-O0
+test:armhf     --run_under=/usr/bin/qemu-arm-static
+
+build:i386     --repo_env=CC=i686-linux-gnu-gcc --repo_env=AR=i686-linux-gnu-ar --repo_env=LD=i686-linux-gnu-ld --repo_env=NM=i686-linux-gnu-nm --repo_env=STRIP=i686-linux-gnu-strip --repo_env=OBJDUMP=i686-linux-gnu-objdump
+build:i386     --cxxopt=-std=c++23 --copt=-DETL_NO_STL --copt=-O0
+test:i386      --run_under=/usr/bin/qemu-i386-static
+
+build:powerpc  --repo_env=CC=powerpc-linux-gnu-gcc --repo_env=AR=powerpc-linux-gnu-ar --repo_env=LD=powerpc-linux-gnu-ld --repo_env=NM=powerpc-linux-gnu-nm --repo_env=STRIP=powerpc-linux-gnu-strip --repo_env=OBJDUMP=powerpc-linux-gnu-objdump
+build:powerpc  --cxxopt=-std=c++23 --copt=-DETL_NO_STL --copt=-O0
+test:powerpc   --run_under=/usr/bin/qemu-ppc
+
+build:riscv64  --repo_env=CC=riscv64-linux-gnu-gcc --repo_env=AR=riscv64-linux-gnu-ar --repo_env=LD=riscv64-linux-gnu-ld --repo_env=NM=riscv64-linux-gnu-nm --repo_env=STRIP=riscv64-linux-gnu-strip --repo_env=OBJDUMP=riscv64-linux-gnu-objdump
+build:riscv64  --cxxopt=-std=c++23 --copt=-DETL_NO_STL --copt=-O0
+test:riscv64   --run_under=/usr/bin/qemu-riscv64-static
+
+build:s390x    --repo_env=CC=s390x-linux-gnu-gcc --repo_env=AR=s390x-linux-gnu-ar --repo_env=LD=s390x-linux-gnu-ld --repo_env=NM=s390x-linux-gnu-nm --repo_env=STRIP=s390x-linux-gnu-strip --repo_env=OBJDUMP=s390x-linux-gnu-objdump
+build:s390x    --cxxopt=-std=c++23 --copt=-DETL_NO_STL --copt=-O0
+test:s390x     --run_under=/usr/bin/qemu-s390x-static
--- a/.bazelversion
+++ b/.bazelversion
@ -0,0 +1 @@
+8.5.1
--- a/.devcontainer/Dockerfile
+++ b/.devcontainer/Dockerfile
@ -58,6 +58,11 @@ RUN set -eux; \
    && install -m 755 treefmt /usr/bin/treefmt \
    && rm treefmt.tar.gz treefmt

+# Install Bazelisk as 'bazel'
+RUN ARCH=$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/') && \
+    wget -qO /usr/local/bin/bazel https://github.com/bazelbuild/bazelisk/releases/latest/download/bazelisk-linux-${ARCH} && \
+    chmod +x /usr/local/bin/bazel
+
 RUN set -eux \
    && echo "Pip version: " \
    && pip --version \
--- a/.devcontainer/armhf/Dockerfile
+++ b/.devcontainer/armhf/Dockerfile
@ -18,9 +18,11 @@ RUN dpkg --add-architecture armhf && \
    ninja-build \
    git \
    wget \
+    ca-certificates \
    file \
    libc6:armhf \
    libstdc++6:armhf \
+    libatomic1:armhf \
    && rm -rf /var/lib/apt/lists/*

 # Create non-root user with stable UID/GID
@ -34,6 +36,11 @@ RUN groupadd --gid ${USER_GID} ${USERNAME} && \
 # Set working directory
 WORKDIR /workspaces/etl

+# Install Bazelisk as 'bazel'
+RUN ARCH=$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/') && \
+    wget -qO /usr/local/bin/bazel https://github.com/bazelbuild/bazelisk/releases/latest/download/bazelisk-linux-${ARCH} && \
+    chmod +x /usr/local/bin/bazel
+
 # Verify QEMU and cross-compilation setup
 RUN echo "=== Host Architecture ===" && \
    uname -m && \
--- a/.devcontainer/i386/Dockerfile
+++ b/.devcontainer/i386/Dockerfile
@ -18,9 +18,11 @@ RUN dpkg --add-architecture i386 && \
    ninja-build \
    git \
    wget \
+    ca-certificates \
    file \
    libc6:i386 \
    libstdc++6:i386 \
+    libatomic1:i386 \
    && rm -rf /var/lib/apt/lists/*

 # Create non-root user with stable UID/GID
@ -34,6 +36,11 @@ RUN groupadd --gid ${USER_GID} ${USERNAME} && \
 # Set working directory
 WORKDIR /workspaces/etl

+# Install Bazelisk as 'bazel'
+RUN ARCH=$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/') && \
+    wget -qO /usr/local/bin/bazel https://github.com/bazelbuild/bazelisk/releases/latest/download/bazelisk-linux-${ARCH} && \
+    chmod +x /usr/local/bin/bazel
+
 # Verify QEMU and cross-compilation setup
 RUN echo "=== Host Architecture ===" && \
    uname -m && \
--- a/.devcontainer/powerpc/Dockerfile
+++ b/.devcontainer/powerpc/Dockerfile
@ -46,6 +46,7 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
    g++-powerpc-linux-gnu \
    libc6:powerpc \
    libstdc++6:powerpc \
+    libatomic1:powerpc \
    && rm -rf /var/lib/apt/lists/*

 # Create non-root user with stable UID/GID
@ -59,6 +60,11 @@ RUN groupadd --gid ${USER_GID} ${USERNAME} && \
 # Set working directory
 WORKDIR /workspaces/etl

+# Install Bazelisk as 'bazel'
+RUN ARCH=$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/') && \
+    wget -qO /usr/local/bin/bazel https://github.com/bazelbuild/bazelisk/releases/latest/download/bazelisk-linux-${ARCH} && \
+    chmod +x /usr/local/bin/bazel
+
 # Verify QEMU and cross-compilation setup
 RUN echo "=== Host Architecture ===" && \
    uname -m && \
--- a/.devcontainer/riscv64/Dockerfile
+++ b/.devcontainer/riscv64/Dockerfile
@ -18,9 +18,11 @@ RUN dpkg --add-architecture riscv64 && \
    ninja-build \
    git \
    wget \
+    ca-certificates \
    file \
    libc6:riscv64 \
    libstdc++6:riscv64 \
+    libatomic1:riscv64 \
    && rm -rf /var/lib/apt/lists/*

 # Create non-root user with stable UID/GID
@ -34,6 +36,11 @@ RUN groupadd --gid ${USER_GID} ${USERNAME} && \
 # Set working directory
 WORKDIR /workspaces/etl

+# Install Bazelisk as 'bazel'
+RUN ARCH=$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/') && \
+    wget -qO /usr/local/bin/bazel https://github.com/bazelbuild/bazelisk/releases/latest/download/bazelisk-linux-${ARCH} && \
+    chmod +x /usr/local/bin/bazel
+
 # Verify QEMU and cross-compilation setup
 RUN echo "=== Host Architecture ===" && \
    uname -m && \
--- a/.devcontainer/s390x/Dockerfile
+++ b/.devcontainer/s390x/Dockerfile
@ -18,9 +18,11 @@ RUN dpkg --add-architecture s390x && \
    ninja-build \
    git \
    wget \
+    ca-certificates \
    file \
    libc6:s390x \
    libstdc++6:s390x \
+    libatomic1:s390x \
    && rm -rf /var/lib/apt/lists/*

 # Create non-root user with stable UID/GID
@ -34,6 +36,11 @@ RUN groupadd --gid ${USER_GID} ${USERNAME} && \
 # Set working directory
 WORKDIR /workspaces/etl

+# Install Bazelisk as 'bazel'
+RUN ARCH=$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/') && \
+    wget -qO /usr/local/bin/bazel https://github.com/bazelbuild/bazelisk/releases/latest/download/bazelisk-linux-${ARCH} && \
+    chmod +x /usr/local/bin/bazel
+
 # Verify QEMU and cross-compilation setup
 RUN echo "=== Host Architecture ===" && \
    uname -m && \
--- a/.devcontainer/ubuntu-26.04/Dockerfile
+++ b/.devcontainer/ubuntu-26.04/Dockerfile
@ -0,0 +1,20 @@
+FROM ubuntu:26.04
+
+ENV DEBIAN_FRONTEND=noninteractive
+
+RUN apt-get update && apt-get install -y \
+    build-essential \
+    cmake \
+    git \
+    ninja-build \
+    python3 \
+    python3-pip \
+    clang \
+    docker.io \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN useradd -m -s /bin/bash vscode
+
+WORKDIR /etl
+
+CMD ["/bin/bash"]
--- a/.github/workflows/bazel-gcc-c++23-no-stl.yml
+++ b/.github/workflows/bazel-gcc-c++23-no-stl.yml
@ -0,0 +1,22 @@
+name: bazel-gcc-c++23-no-stl
+on:
+  push:
+    branches: [ master, development, pull-request/* ]
+  pull_request:
+    branches: [ master, development, pull-request/* ]
+    types: [opened, synchronize, reopened]
+
+jobs:
+
+  build-bazel-gcc-cpp23-no-stl:
+    name: Bazel GCC C++23 Linux - No STL
+    runs-on: ubuntu-24.04
+
+    steps:
+    - uses: actions/checkout@v4
+
+    - name: Build
+      run: bazel build //test:etl_tests --cxxopt=-std=c++23 --copt=-DETL_NO_STL
+
+    - name: Run tests
+      run: bazel test //test:etl_tests --cxxopt=-std=c++23 --copt=-DETL_NO_STL --test_output=all
--- a/.github/workflows/clang-c++26.yml
+++ b/.github/workflows/clang-c++26.yml
@ -10,95 +10,91 @@ jobs:

  build-clang-cpp26-linux-stl:
    name: Clang C++26 Linux - STL
-    if: false # enabled when ubuntu-26.04 is available in github
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-26.04]
+    runs-on: ubuntu-24.04

    steps:
    - uses: actions/checkout@v4

-    - name: Build
-      run: |
-        export CC=clang
-        export CXX=clang++
-        export ASAN_OPTIONS=alloc_dealloc_mismatch=0,detect_leaks=0
-        cmake -DBUILD_TESTS=ON -DNO_STL=OFF -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=OFF -DETL_CXX_STANDARD=26 ./
-        clang --version
-        make -j "$(getconf _NPROCESSORS_ONLN)"
+    - name: Build Docker image
+      run: docker build -t etl-ubuntu-2604 -f .devcontainer/ubuntu-26.04/Dockerfile .

-    - name: Run tests
-      run: ./test/etl_tests -v
+    - name: Build and run tests
+      run: |
+        docker run --rm --user root -v ${{ github.workspace }}:/workspaces/etl etl-ubuntu-2604 bash -c "\
+          cd /workspaces/etl && \
+          export CC=clang && \
+          export CXX=clang++ && \
+          export ASAN_OPTIONS=alloc_dealloc_mismatch=0,detect_leaks=0 && \
+          cmake -DBUILD_TESTS=ON -DNO_STL=OFF -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=OFF -DETL_CXX_STANDARD=26 ./ && \
+          clang --version && \
+          make -j \$(getconf _NPROCESSORS_ONLN) && \
+          ./test/etl_tests -v"

  build-clang-cpp26-linux-no-stl:
    name: Clang C++26 Linux - No STL
-    if: false # enabled when ubuntu-26.04 is available in github
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-26.04]
+    runs-on: ubuntu-24.04

    steps:
    - uses: actions/checkout@v4

-    - name: Build
-      run: |
-        export CC=clang
-        export CXX=clang++
-        export ASAN_OPTIONS=alloc_dealloc_mismatch=0,detect_leaks=0
-        cmake -DBUILD_TESTS=ON -DNO_STL=ON -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=OFF -DETL_CXX_STANDARD=26 ./
-        clang --version
-        make -j "$(getconf _NPROCESSORS_ONLN)"
+    - name: Build Docker image
+      run: docker build -t etl-ubuntu-2604 -f .devcontainer/ubuntu-26.04/Dockerfile .

-    - name: Run tests
-      run: ./test/etl_tests -v
+    - name: Build and run tests
+      run: |
+        docker run --rm --user root -v ${{ github.workspace }}:/workspaces/etl etl-ubuntu-2604 bash -c "\
+          cd /workspaces/etl && \
+          export CC=clang && \
+          export CXX=clang++ && \
+          export ASAN_OPTIONS=alloc_dealloc_mismatch=0,detect_leaks=0 && \
+          cmake -DBUILD_TESTS=ON -DNO_STL=ON -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=OFF -DETL_CXX_STANDARD=26 ./ && \
+          clang --version && \
+          make -j \$(getconf _NPROCESSORS_ONLN) && \
+          ./test/etl_tests -v"

  build-clang-cpp26-linux-stl-force-cpp03:
    name: Clang C++26 Linux - STL - Force C++03
-    if: false # enabled when ubuntu-26.04 is available in github
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-26.04]
+    runs-on: ubuntu-24.04

    steps:
    - uses: actions/checkout@v4

-    - name: Build
-      run: |
-        export CC=clang
-        export CXX=clang++
-        export ASAN_OPTIONS=alloc_dealloc_mismatch=0,detect_leaks=0
-        cmake -D BUILD_TESTS=ON -DNO_STL=OFF -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=ON -DETL_CXX_STANDARD=26 ./
-        clang --version
-        make -j "$(getconf _NPROCESSORS_ONLN)"
+    - name: Build Docker image
+      run: docker build -t etl-ubuntu-2604 -f .devcontainer/ubuntu-26.04/Dockerfile .

-    - name: Run tests
-      run: ./test/etl_tests -v
+    - name: Build and run tests
+      run: |
+        docker run --rm --user root -v ${{ github.workspace }}:/workspaces/etl etl-ubuntu-2604 bash -c "\
+          cd /workspaces/etl && \
+          export CC=clang && \
+          export CXX=clang++ && \
+          export ASAN_OPTIONS=alloc_dealloc_mismatch=0,detect_leaks=0 && \
+          cmake -DBUILD_TESTS=ON -DNO_STL=OFF -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=ON -DETL_CXX_STANDARD=26 ./ && \
+          clang --version && \
+          make -j \$(getconf _NPROCESSORS_ONLN) && \
+          ./test/etl_tests -v"

  build-clang-cpp26-linux-no-stl-force-cpp03:
    name: Clang C++26 Linux - No STL - Force C++03
-    if: false # enabled when ubuntu-26.04 is available in github
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-26.04]
+    runs-on: ubuntu-24.04

    steps:
    - uses: actions/checkout@v4

-    - name: Build
-      run: |
-        export CC=clang
-        export CXX=clang++
-        export ASAN_OPTIONS=alloc_dealloc_mismatch=0,detect_leaks=0
-        cmake -D BUILD_TESTS=ON -DNO_STL=ON -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=ON -DETL_CXX_STANDARD=26 ./
-        clang --version
-        make -j "$(getconf _NPROCESSORS_ONLN)"
+    - name: Build Docker image
+      run: docker build -t etl-ubuntu-2604 -f .devcontainer/ubuntu-26.04/Dockerfile .

-    - name: Run tests
-      run: ./test/etl_tests -v
+    - name: Build and run tests
+      run: |
+        docker run --rm --user root -v ${{ github.workspace }}:/workspaces/etl etl-ubuntu-2604 bash -c "\
+          cd /workspaces/etl && \
+          export CC=clang && \
+          export CXX=clang++ && \
+          export ASAN_OPTIONS=alloc_dealloc_mismatch=0,detect_leaks=0 && \
+          cmake -DBUILD_TESTS=ON -DNO_STL=ON -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=ON -DETL_CXX_STANDARD=26 ./ && \
+          clang --version && \
+          make -j \$(getconf _NPROCESSORS_ONLN) && \
+          ./test/etl_tests -v"

  build-clang-cpp26-osx-stl:
    name: Clang C++26 OSX - STL
--- a/.github/workflows/clang-syntax-checks.yml
+++ b/.github/workflows/clang-syntax-checks.yml
@ -405,76 +405,80 @@ jobs:

  build-clang-cpp26-linux-STL:
    name: Syntax Check - Clang C++26 Linux STL
-    if: false # enabled when ubuntu-26.04 is available in github
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-26.04]
+    runs-on: ubuntu-24.04

    steps:
    - uses: actions/checkout@v4

+    - name: Build Docker image
+      run: docker build -t etl-ubuntu-2604 -f .devcontainer/ubuntu-26.04/Dockerfile .
+
    - name: Build
      run: |
-        export CC=clang
-        export CXX=clang++
-        cmake -DNO_STL=OFF -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=OFF -DETL_CXX_STANDARD=26 ./test/syntax_check
-        clang++ --version
-        make -j "$(getconf _NPROCESSORS_ONLN)"
+        docker run --rm --user root -v ${{ github.workspace }}:/workspaces/etl etl-ubuntu-2604 bash -c "\
+          cd /workspaces/etl && \
+          export CC=clang && \
+          export CXX=clang++ && \
+          cmake -DNO_STL=OFF -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=OFF -DETL_CXX_STANDARD=26 ./test/syntax_check && \
+          clang++ --version && \
+          make -j \$(getconf _NPROCESSORS_ONLN)"

  build-clang-cpp26-linux-No-STL:
    name: Syntax Check - Clang C++26 Linux No STL
-    if: false # enabled when ubuntu-26.04 is available in github
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-26.04]
+    runs-on: ubuntu-24.04

    steps:
    - uses: actions/checkout@v4

+    - name: Build Docker image
+      run: docker build -t etl-ubuntu-2604 -f .devcontainer/ubuntu-26.04/Dockerfile .
+
    - name: Build
      run: |
-        export CC=clang
-        export CXX=clang++
-        cmake -DNO_STL=ON -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=OFF -DETL_CXX_STANDARD=26 ./test/syntax_check
-        clang++ --version
-        make -j "$(getconf _NPROCESSORS_ONLN)"
+        docker run --rm --user root -v ${{ github.workspace }}:/workspaces/etl etl-ubuntu-2604 bash -c "\
+          cd /workspaces/etl && \
+          export CC=clang && \
+          export CXX=clang++ && \
+          cmake -DNO_STL=ON -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=OFF -DETL_CXX_STANDARD=26 ./test/syntax_check && \
+          clang++ --version && \
+          make -j \$(getconf _NPROCESSORS_ONLN)"

  build-clang-cpp26-linux-STL-Force-CPP03:
    name: Syntax Check - Clang C++26 Linux STL Force C++03
-    if: false # enabled when ubuntu-26.04 is available in github
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-26.04]
+    runs-on: ubuntu-24.04

    steps:
    - uses: actions/checkout@v4

+    - name: Build Docker image
+      run: docker build -t etl-ubuntu-2604 -f .devcontainer/ubuntu-26.04/Dockerfile .
+
    - name: Build
      run: |
-        export CC=clang
-        export CXX=clang++
-        cmake -DNO_STL=OFF -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=ON -DETL_CXX_STANDARD=26 ./test/syntax_check
-        clang++ --version
-        make -j "$(getconf _NPROCESSORS_ONLN)"
+        docker run --rm --user root -v ${{ github.workspace }}:/workspaces/etl etl-ubuntu-2604 bash -c "\
+          cd /workspaces/etl && \
+          export CC=clang && \
+          export CXX=clang++ && \
+          cmake -DNO_STL=OFF -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=ON -DETL_CXX_STANDARD=26 ./test/syntax_check && \
+          clang++ --version && \
+          make -j \$(getconf _NPROCESSORS_ONLN)"

  build-clang-cpp26-linux-No-STL-Force-CPP03:
    name: Syntax Check - Clang C++26 Linux No STL Force C++03
-    if: false # enabled when ubuntu-26.04 is available in github
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-26.04]
+    runs-on: ubuntu-24.04

    steps:
    - uses: actions/checkout@v4

+    - name: Build Docker image
+      run: docker build -t etl-ubuntu-2604 -f .devcontainer/ubuntu-26.04/Dockerfile .
+
    - name: Build
      run: |
-        export CC=clang
-        export CXX=clang++
-        cmake -DNO_STL=ON -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=ON -DETL_CXX_STANDARD=26 ./test/syntax_check
-        clang++ --version
-        make -j "$(getconf _NPROCESSORS_ONLN)"
+        docker run --rm --user root -v ${{ github.workspace }}:/workspaces/etl etl-ubuntu-2604 bash -c "\
+          cd /workspaces/etl && \
+          export CC=clang && \
+          export CXX=clang++ && \
+          cmake -DNO_STL=ON -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=ON -DETL_CXX_STANDARD=26 ./test/syntax_check && \
+          clang++ --version && \
+          make -j \$(getconf _NPROCESSORS_ONLN)"
--- a/.github/workflows/gcc-c++26.yml
+++ b/.github/workflows/gcc-c++26.yml
@ -10,92 +10,88 @@ jobs:

  build-gcc-cpp26-linux-stl:
    name: GCC C++26 Linux - STL
-    if: false # enabled when ubuntu-26.04 is available in github
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-26.04]
+    runs-on: ubuntu-24.04

    steps:
    - uses: actions/checkout@v4

-    - name: Build
-      run: |
-        export ASAN_OPTIONS=alloc_dealloc_mismatch=0,detect_leaks=0
-        export CC=gcc
-        export CXX=g++
-        cmake -DBUILD_TESTS=ON -DNO_STL=OFF -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=OFF -DETL_CXX_STANDARD=26 ./
-        gcc --version
-        make -j "$(getconf _NPROCESSORS_ONLN)"
+    - name: Build Docker image
+      run: docker build -t etl-ubuntu-2604 -f .devcontainer/ubuntu-26.04/Dockerfile .

-    - name: Run tests
-      run: ./test/etl_tests -v
+    - name: Build and run tests
+      run: |
+        docker run --rm --user root -v ${{ github.workspace }}:/workspaces/etl etl-ubuntu-2604 bash -c "\
+          cd /workspaces/etl && \
+          export ASAN_OPTIONS=alloc_dealloc_mismatch=0,detect_leaks=0 && \
+          export CC=gcc && \
+          export CXX=g++ && \
+          cmake -DBUILD_TESTS=ON -DNO_STL=OFF -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=OFF -DETL_CXX_STANDARD=26 ./ && \
+          gcc --version && \
+          make -j \$(getconf _NPROCESSORS_ONLN) && \
+          ./test/etl_tests -v"

  build-gcc-cpp26-linux-no-stl:
    name: GCC C++26 Linux - No STL
-    if: false # enabled when ubuntu-26.04 is available in github
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-26.04]
+    runs-on: ubuntu-24.04

    steps:
    - uses: actions/checkout@v4

-    - name: Build
-      run: |
-        export ASAN_OPTIONS=alloc_dealloc_mismatch=0,detect_leaks=0
-        export CC=gcc
-        export CXX=g++
-        cmake -DBUILD_TESTS=ON -DNO_STL=ON -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=OFF -DETL_CXX_STANDARD=26 ./
-        gcc --version
-        make -j "$(getconf _NPROCESSORS_ONLN)"
+    - name: Build Docker image
+      run: docker build -t etl-ubuntu-2604 -f .devcontainer/ubuntu-26.04/Dockerfile .

-    - name: Run tests
-      run: ./test/etl_tests -v
+    - name: Build and run tests
+      run: |
+        docker run --rm --user root -v ${{ github.workspace }}:/workspaces/etl etl-ubuntu-2604 bash -c "\
+          cd /workspaces/etl && \
+          export ASAN_OPTIONS=alloc_dealloc_mismatch=0,detect_leaks=0 && \
+          export CC=gcc && \
+          export CXX=g++ && \
+          cmake -DBUILD_TESTS=ON -DNO_STL=ON -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=OFF -DETL_CXX_STANDARD=26 ./ && \
+          gcc --version && \
+          make -j \$(getconf _NPROCESSORS_ONLN) && \
+          ./test/etl_tests -v"

  build-gcc-cpp26-linux-stl-force-cpp03:
    name: GCC C++26 Linux - STL - Force C++03
-    if: false # enabled when ubuntu-26.04 is available in github
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-26.04]
+    runs-on: ubuntu-24.04

    steps:
    - uses: actions/checkout@v4

-    - name: Build
-      run: |
-        export ASAN_OPTIONS=alloc_dealloc_mismatch=0,detect_leaks=0
-        export CC=gcc
-        export CXX=g++
-        cmake -DBUILD_TESTS=ON -DNO_STL=OFF -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=ON -DETL_CXX_STANDARD=26 ./
-        gcc --version
-        make -j "$(getconf _NPROCESSORS_ONLN)"
+    - name: Build Docker image
+      run: docker build -t etl-ubuntu-2604 -f .devcontainer/ubuntu-26.04/Dockerfile .

-    - name: Run tests
-      run: ./test/etl_tests -v
+    - name: Build and run tests
+      run: |
+        docker run --rm --user root -v ${{ github.workspace }}:/workspaces/etl etl-ubuntu-2604 bash -c "\
+          cd /workspaces/etl && \
+          export ASAN_OPTIONS=alloc_dealloc_mismatch=0,detect_leaks=0 && \
+          export CC=gcc && \
+          export CXX=g++ && \
+          cmake -DBUILD_TESTS=ON -DNO_STL=OFF -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=ON -DETL_CXX_STANDARD=26 ./ && \
+          gcc --version && \
+          make -j \$(getconf _NPROCESSORS_ONLN) && \
+          ./test/etl_tests -v"

  build-gcc-cpp26-linux-no-stl-force-cpp03:
    name: GCC C++26 Linux - No STL - Force C++03
-    if: false # enabled when ubuntu-26.04 is available in github
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-26.04]
+    runs-on: ubuntu-24.04

    steps:
    - uses: actions/checkout@v4

-    - name: Build
-      run: |
-        export ASAN_OPTIONS=alloc_dealloc_mismatch=0,detect_leaks=0
-        export CC=gcc
-        export CXX=g++
-        cmake -DBUILD_TESTS=ON -DNO_STL=ON -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=ON -DETL_CXX_STANDARD=26 ./
-        gcc --version
-        make -j "$(getconf _NPROCESSORS_ONLN)"
+    - name: Build Docker image
+      run: docker build -t etl-ubuntu-2604 -f .devcontainer/ubuntu-26.04/Dockerfile .

-    - name: Run tests
-      run: ./test/etl_tests -v
+    - name: Build and run tests
+      run: |
+        docker run --rm --user root -v ${{ github.workspace }}:/workspaces/etl etl-ubuntu-2604 bash -c "\
+          cd /workspaces/etl && \
+          export ASAN_OPTIONS=alloc_dealloc_mismatch=0,detect_leaks=0 && \
+          export CC=gcc && \
+          export CXX=g++ && \
+          cmake -DBUILD_TESTS=ON -DNO_STL=ON -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=ON -DETL_CXX_STANDARD=26 ./ && \
+          gcc --version && \
+          make -j \$(getconf _NPROCESSORS_ONLN) && \
+          ./test/etl_tests -v"
--- a/.github/workflows/gcc-syntax-checks.yml
+++ b/.github/workflows/gcc-syntax-checks.yml
@ -405,76 +405,80 @@ jobs:

  build-gcc-cpp26-linux-STL:
    name: Syntax Check - GCC C++26 Linux STL
-    if: false # enabled when ubuntu-26.04 is available in github
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-26.04]
+    runs-on: ubuntu-24.04

    steps:
    - uses: actions/checkout@v4

+    - name: Build Docker image
+      run: docker build -t etl-ubuntu-2604 -f .devcontainer/ubuntu-26.04/Dockerfile .
+
    - name: Build
      run: |
-        export CC=gcc
-        export CXX=g++
-        cmake -DNO_STL=OFF -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=OFF -DETL_CXX_STANDARD=26 ./test/syntax_check
-        gcc --version
-        make -j "$(getconf _NPROCESSORS_ONLN)"
+        docker run --rm --user root -v ${{ github.workspace }}:/workspaces/etl etl-ubuntu-2604 bash -c "\
+          cd /workspaces/etl && \
+          export CC=gcc && \
+          export CXX=g++ && \
+          cmake -DNO_STL=OFF -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=OFF -DETL_CXX_STANDARD=26 ./test/syntax_check && \
+          gcc --version && \
+          make -j \$(getconf _NPROCESSORS_ONLN)"

  build-gcc-cpp26-linux-No-STL:
    name: Syntax Check - GCC C++26 Linux No STL
-    if: false # enabled when ubuntu-26.04 is available in github
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-26.04]
+    runs-on: ubuntu-24.04

    steps:
    - uses: actions/checkout@v4

+    - name: Build Docker image
+      run: docker build -t etl-ubuntu-2604 -f .devcontainer/ubuntu-26.04/Dockerfile .
+
    - name: Build
      run: |
-        export CC=gcc
-        export CXX=g++
-        cmake -DNO_STL=ON -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=OFF -DETL_CXX_STANDARD=26 ./test/syntax_check
-        gcc --version
-        make -j "$(getconf _NPROCESSORS_ONLN)"
+        docker run --rm --user root -v ${{ github.workspace }}:/workspaces/etl etl-ubuntu-2604 bash -c "\
+          cd /workspaces/etl && \
+          export CC=gcc && \
+          export CXX=g++ && \
+          cmake -DNO_STL=ON -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=OFF -DETL_CXX_STANDARD=26 ./test/syntax_check && \
+          gcc --version && \
+          make -j \$(getconf _NPROCESSORS_ONLN)"

  build-gcc-cpp26-linux-STL-Force-CPP03:
    name: Syntax Check - GCC C++26 Linux STL Force C++03
-    if: false # enabled when ubuntu-26.04 is available in github
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-26.04]
+    runs-on: ubuntu-24.04

    steps:
    - uses: actions/checkout@v4

+    - name: Build Docker image
+      run: docker build -t etl-ubuntu-2604 -f .devcontainer/ubuntu-26.04/Dockerfile .
+
    - name: Build
      run: |
-        export CC=gcc
-        export CXX=g++
-        cmake -DNO_STL=OFF -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=ON -DETL_CXX_STANDARD=26 ./test/syntax_check
-        gcc --version
-        make -j "$(getconf _NPROCESSORS_ONLN)"
+        docker run --rm --user root -v ${{ github.workspace }}:/workspaces/etl etl-ubuntu-2604 bash -c "\
+          cd /workspaces/etl && \
+          export CC=gcc && \
+          export CXX=g++ && \
+          cmake -DNO_STL=OFF -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=ON -DETL_CXX_STANDARD=26 ./test/syntax_check && \
+          gcc --version && \
+          make -j \$(getconf _NPROCESSORS_ONLN)"

  build-gcc-cpp26-linux-No-STL-Force-CPP03:
    name: Syntax Check - GCC C++26 Linux No STL Force C++03
-    if: false # enabled when ubuntu-26.04 is available in github
-    runs-on: ${{ matrix.os }}
-    strategy:
-      matrix:
-        os: [ubuntu-26.04]
+    runs-on: ubuntu-24.04

    steps:
    - uses: actions/checkout@v4

+    - name: Build Docker image
+      run: docker build -t etl-ubuntu-2604 -f .devcontainer/ubuntu-26.04/Dockerfile .
+
    - name: Build
      run: |
-        export CC=gcc
-        export CXX=g++
-        cmake -DNO_STL=ON -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=ON -DETL_CXX_STANDARD=26 ./test/syntax_check
-        gcc --version
-        make -j "$(getconf _NPROCESSORS_ONLN)"
+        docker run --rm --user root -v ${{ github.workspace }}:/workspaces/etl etl-ubuntu-2604 bash -c "\
+          cd /workspaces/etl && \
+          export CC=gcc && \
+          export CXX=g++ && \
+          cmake -DNO_STL=ON -DETL_USE_TYPE_TRAITS_BUILTINS=OFF -DETL_USER_DEFINED_TYPE_TRAITS=OFF -DETL_FORCE_TEST_CPP03_IMPLEMENTATION=ON -DETL_CXX_STANDARD=26 ./test/syntax_check && \
+          gcc --version && \
+          make -j \$(getconf _NPROCESSORS_ONLN)"
--- a/BUILD.bazel
+++ b/BUILD.bazel
@ -0,0 +1,9 @@
+load("@rules_cc//cc:defs.bzl", "cc_library")
+
+package(default_visibility = ["//visibility:public"])
+
+cc_library(
+    name = "etl",
+    hdrs = glob(["include/**/*.h"]),
+    includes = ["include"],
+)
--- a/MODULE.bazel
+++ b/MODULE.bazel
@ -0,0 +1,7 @@
+module(
+    name = "etl",
+    version = "0.0.0",
+)
+
+bazel_dep(name = "platforms", version = "0.0.11")
+bazel_dep(name = "rules_cc", version = "0.1.1")
--- a/MODULE.bazel.lock
+++ b/MODULE.bazel.lock
@ -0,0 +1,205 @@
+{
+  "lockFileVersion": 24,
+  "registryFileHashes": {
+    "https://bcr.bazel.build/bazel_registry.json": "8a28e4aff06ee60aed2a8c281907fb8bcbf3b753c91fb5a5c57da3215d5b3497",
+    "https://bcr.bazel.build/modules/abseil-cpp/20210324.2/MODULE.bazel": "7cd0312e064fde87c8d1cd79ba06c876bd23630c83466e9500321be55c96ace2",
+    "https://bcr.bazel.build/modules/abseil-cpp/20211102.0/MODULE.bazel": "70390338f7a5106231d20620712f7cccb659cd0e9d073d1991c038eb9fc57589",
+    "https://bcr.bazel.build/modules/abseil-cpp/20230125.1/MODULE.bazel": "89047429cb0207707b2dface14ba7f8df85273d484c2572755be4bab7ce9c3a0",
+    "https://bcr.bazel.build/modules/abseil-cpp/20230802.0.bcr.1/MODULE.bazel": "1c8cec495288dccd14fdae6e3f95f772c1c91857047a098fad772034264cc8cb",
+    "https://bcr.bazel.build/modules/abseil-cpp/20230802.0/MODULE.bazel": "d253ae36a8bd9ee3c5955384096ccb6baf16a1b1e93e858370da0a3b94f77c16",
+    "https://bcr.bazel.build/modules/abseil-cpp/20230802.1/MODULE.bazel": "fa92e2eb41a04df73cdabeec37107316f7e5272650f81d6cc096418fe647b915",
+    "https://bcr.bazel.build/modules/abseil-cpp/20240116.1/MODULE.bazel": "37bcdb4440fbb61df6a1c296ae01b327f19e9bb521f9b8e26ec854b6f97309ed",
+    "https://bcr.bazel.build/modules/abseil-cpp/20240116.1/source.json": "9be551b8d4e3ef76875c0d744b5d6a504a27e3ae67bc6b28f46415fd2d2957da",
+    "https://bcr.bazel.build/modules/bazel_features/1.1.1/MODULE.bazel": "27b8c79ef57efe08efccbd9dd6ef70d61b4798320b8d3c134fd571f78963dbcd",
+    "https://bcr.bazel.build/modules/bazel_features/1.11.0/MODULE.bazel": "f9382337dd5a474c3b7d334c2f83e50b6eaedc284253334cf823044a26de03e8",
+    "https://bcr.bazel.build/modules/bazel_features/1.15.0/MODULE.bazel": "d38ff6e517149dc509406aca0db3ad1efdd890a85e049585b7234d04238e2a4d",
+    "https://bcr.bazel.build/modules/bazel_features/1.17.0/MODULE.bazel": "039de32d21b816b47bd42c778e0454217e9c9caac4a3cf8e15c7231ee3ddee4d",
+    "https://bcr.bazel.build/modules/bazel_features/1.18.0/MODULE.bazel": "1be0ae2557ab3a72a57aeb31b29be347bcdc5d2b1eb1e70f39e3851a7e97041a",
+    "https://bcr.bazel.build/modules/bazel_features/1.19.0/MODULE.bazel": "59adcdf28230d220f0067b1f435b8537dd033bfff8db21335ef9217919c7fb58",
+    "https://bcr.bazel.build/modules/bazel_features/1.30.0/MODULE.bazel": "a14b62d05969a293b80257e72e597c2da7f717e1e69fa8b339703ed6731bec87",
+    "https://bcr.bazel.build/modules/bazel_features/1.30.0/source.json": "b07e17f067fe4f69f90b03b36ef1e08fe0d1f3cac254c1241a1818773e3423bc",
+    "https://bcr.bazel.build/modules/bazel_features/1.4.1/MODULE.bazel": "e45b6bb2350aff3e442ae1111c555e27eac1d915e77775f6fdc4b351b758b5d7",
+    "https://bcr.bazel.build/modules/bazel_features/1.9.1/MODULE.bazel": "8f679097876a9b609ad1f60249c49d68bfab783dd9be012faf9d82547b14815a",
+    "https://bcr.bazel.build/modules/bazel_skylib/1.0.3/MODULE.bazel": "bcb0fd896384802d1ad283b4e4eb4d718eebd8cb820b0a2c3a347fb971afd9d8",
+    "https://bcr.bazel.build/modules/bazel_skylib/1.1.1/MODULE.bazel": "1add3e7d93ff2e6998f9e118022c84d163917d912f5afafb3058e3d2f1545b5e",
+    "https://bcr.bazel.build/modules/bazel_skylib/1.2.0/MODULE.bazel": "44fe84260e454ed94ad326352a698422dbe372b21a1ac9f3eab76eb531223686",
+    "https://bcr.bazel.build/modules/bazel_skylib/1.2.1/MODULE.bazel": "f35baf9da0efe45fa3da1696ae906eea3d615ad41e2e3def4aeb4e8bc0ef9a7a",
+    "https://bcr.bazel.build/modules/bazel_skylib/1.3.0/MODULE.bazel": "20228b92868bf5cfc41bda7afc8a8ba2a543201851de39d990ec957b513579c5",
+    "https://bcr.bazel.build/modules/bazel_skylib/1.4.1/MODULE.bazel": "a0dcb779424be33100dcae821e9e27e4f2901d9dfd5333efe5ac6a8d7ab75e1d",
+    "https://bcr.bazel.build/modules/bazel_skylib/1.4.2/MODULE.bazel": "3bd40978e7a1fac911d5989e6b09d8f64921865a45822d8b09e815eaa726a651",
+    "https://bcr.bazel.build/modules/bazel_skylib/1.5.0/MODULE.bazel": "32880f5e2945ce6a03d1fbd588e9198c0a959bb42297b2cfaf1685b7bc32e138",
+    "https://bcr.bazel.build/modules/bazel_skylib/1.6.1/MODULE.bazel": "8fdee2dbaace6c252131c00e1de4b165dc65af02ea278476187765e1a617b917",
+    "https://bcr.bazel.build/modules/bazel_skylib/1.7.0/MODULE.bazel": "0db596f4563de7938de764cc8deeabec291f55e8ec15299718b93c4423e9796d",
+    "https://bcr.bazel.build/modules/bazel_skylib/1.7.1/MODULE.bazel": "3120d80c5861aa616222ec015332e5f8d3171e062e3e804a2a0253e1be26e59b",
+    "https://bcr.bazel.build/modules/bazel_skylib/1.7.1/source.json": "f121b43eeefc7c29efbd51b83d08631e2347297c95aac9764a701f2a6a2bb953",
+    "https://bcr.bazel.build/modules/buildozer/7.1.2/MODULE.bazel": "2e8dd40ede9c454042645fd8d8d0cd1527966aa5c919de86661e62953cd73d84",
+    "https://bcr.bazel.build/modules/buildozer/7.1.2/source.json": "c9028a501d2db85793a6996205c8de120944f50a0d570438fcae0457a5f9d1f8",
+    "https://bcr.bazel.build/modules/google_benchmark/1.8.2/MODULE.bazel": "a70cf1bba851000ba93b58ae2f6d76490a9feb74192e57ab8e8ff13c34ec50cb",
+    "https://bcr.bazel.build/modules/googletest/1.11.0/MODULE.bazel": "3a83f095183f66345ca86aa13c58b59f9f94a2f81999c093d4eeaa2d262d12f4",
+    "https://bcr.bazel.build/modules/googletest/1.14.0.bcr.1/MODULE.bazel": "22c31a561553727960057361aa33bf20fb2e98584bc4fec007906e27053f80c6",
+    "https://bcr.bazel.build/modules/googletest/1.14.0.bcr.1/source.json": "41e9e129f80d8c8bf103a7acc337b76e54fad1214ac0a7084bf24f4cd924b8b4",
+    "https://bcr.bazel.build/modules/googletest/1.14.0/MODULE.bazel": "cfbcbf3e6eac06ef9d85900f64424708cc08687d1b527f0ef65aa7517af8118f",
+    "https://bcr.bazel.build/modules/jsoncpp/1.9.5/MODULE.bazel": "31271aedc59e815656f5736f282bb7509a97c7ecb43e927ac1a37966e0578075",
+    "https://bcr.bazel.build/modules/jsoncpp/1.9.5/source.json": "4108ee5085dd2885a341c7fab149429db457b3169b86eb081fa245eadf69169d",
+    "https://bcr.bazel.build/modules/libpfm/4.11.0/MODULE.bazel": "45061ff025b301940f1e30d2c16bea596c25b176c8b6b3087e92615adbd52902",
+    "https://bcr.bazel.build/modules/platforms/0.0.10/MODULE.bazel": "8cb8efaf200bdeb2150d93e162c40f388529a25852b332cec879373771e48ed5",
+    "https://bcr.bazel.build/modules/platforms/0.0.11/MODULE.bazel": "0daefc49732e227caa8bfa834d65dc52e8cc18a2faf80df25e8caea151a9413f",
+    "https://bcr.bazel.build/modules/platforms/0.0.11/source.json": "f7e188b79ebedebfe75e9e1d098b8845226c7992b307e28e1496f23112e8fc29",
+    "https://bcr.bazel.build/modules/platforms/0.0.4/MODULE.bazel": "9b328e31ee156f53f3c416a64f8491f7eb731742655a47c9eec4703a71644aee",
+    "https://bcr.bazel.build/modules/platforms/0.0.5/MODULE.bazel": "5733b54ea419d5eaf7997054bb55f6a1d0b5ff8aedf0176fef9eea44f3acda37",
+    "https://bcr.bazel.build/modules/platforms/0.0.6/MODULE.bazel": "ad6eeef431dc52aefd2d77ed20a4b353f8ebf0f4ecdd26a807d2da5aa8cd0615",
+    "https://bcr.bazel.build/modules/platforms/0.0.7/MODULE.bazel": "72fd4a0ede9ee5c021f6a8dd92b503e089f46c227ba2813ff183b71616034814",
+    "https://bcr.bazel.build/modules/platforms/0.0.8/MODULE.bazel": "9f142c03e348f6d263719f5074b21ef3adf0b139ee4c5133e2aa35664da9eb2d",
+    "https://bcr.bazel.build/modules/protobuf/21.7/MODULE.bazel": "a5a29bb89544f9b97edce05642fac225a808b5b7be74038ea3640fae2f8e66a7",
+    "https://bcr.bazel.build/modules/protobuf/27.0/MODULE.bazel": "7873b60be88844a0a1d8f80b9d5d20cfbd8495a689b8763e76c6372998d3f64c",
+    "https://bcr.bazel.build/modules/protobuf/27.1/MODULE.bazel": "703a7b614728bb06647f965264967a8ef1c39e09e8f167b3ca0bb1fd80449c0d",
+    "https://bcr.bazel.build/modules/protobuf/29.0-rc2/MODULE.bazel": "6241d35983510143049943fc0d57937937122baf1b287862f9dc8590fc4c37df",
+    "https://bcr.bazel.build/modules/protobuf/29.0/MODULE.bazel": "319dc8bf4c679ff87e71b1ccfb5a6e90a6dbc4693501d471f48662ac46d04e4e",
+    "https://bcr.bazel.build/modules/protobuf/29.0/source.json": "b857f93c796750eef95f0d61ee378f3420d00ee1dd38627b27193aa482f4f981",
+    "https://bcr.bazel.build/modules/protobuf/3.19.0/MODULE.bazel": "6b5fbb433f760a99a22b18b6850ed5784ef0e9928a72668b66e4d7ccd47db9b0",
+    "https://bcr.bazel.build/modules/pybind11_bazel/2.11.1/MODULE.bazel": "88af1c246226d87e65be78ed49ecd1e6f5e98648558c14ce99176da041dc378e",
+    "https://bcr.bazel.build/modules/pybind11_bazel/2.11.1/source.json": "be4789e951dd5301282729fe3d4938995dc4c1a81c2ff150afc9f1b0504c6022",
+    "https://bcr.bazel.build/modules/re2/2023-09-01/MODULE.bazel": "cb3d511531b16cfc78a225a9e2136007a48cf8a677e4264baeab57fe78a80206",
+    "https://bcr.bazel.build/modules/re2/2023-09-01/source.json": "e044ce89c2883cd957a2969a43e79f7752f9656f6b20050b62f90ede21ec6eb4",
+    "https://bcr.bazel.build/modules/rules_android/0.1.1/MODULE.bazel": "48809ab0091b07ad0182defb787c4c5328bd3a278938415c00a7b69b50c4d3a8",
+    "https://bcr.bazel.build/modules/rules_android/0.1.1/source.json": "e6986b41626ee10bdc864937ffb6d6bf275bb5b9c65120e6137d56e6331f089e",
+    "https://bcr.bazel.build/modules/rules_cc/0.0.1/MODULE.bazel": "cb2aa0747f84c6c3a78dad4e2049c154f08ab9d166b1273835a8174940365647",
+    "https://bcr.bazel.build/modules/rules_cc/0.0.10/MODULE.bazel": "ec1705118f7eaedd6e118508d3d26deba2a4e76476ada7e0e3965211be012002",
+    "https://bcr.bazel.build/modules/rules_cc/0.0.13/MODULE.bazel": "0e8529ed7b323dad0775ff924d2ae5af7640b23553dfcd4d34344c7e7a867191",
+    "https://bcr.bazel.build/modules/rules_cc/0.0.14/MODULE.bazel": "5e343a3aac88b8d7af3b1b6d2093b55c347b8eefc2e7d1442f7a02dc8fea48ac",
+    "https://bcr.bazel.build/modules/rules_cc/0.0.15/MODULE.bazel": "6704c35f7b4a72502ee81f61bf88706b54f06b3cbe5558ac17e2e14666cd5dcc",
+    "https://bcr.bazel.build/modules/rules_cc/0.0.16/MODULE.bazel": "7661303b8fc1b4d7f532e54e9d6565771fea666fbdf839e0a86affcd02defe87",
+    "https://bcr.bazel.build/modules/rules_cc/0.0.2/MODULE.bazel": "6915987c90970493ab97393024c156ea8fb9f3bea953b2f3ec05c34f19b5695c",
+    "https://bcr.bazel.build/modules/rules_cc/0.0.6/MODULE.bazel": "abf360251023dfe3efcef65ab9d56beefa8394d4176dd29529750e1c57eaa33f",
+    "https://bcr.bazel.build/modules/rules_cc/0.0.8/MODULE.bazel": "964c85c82cfeb6f3855e6a07054fdb159aced38e99a5eecf7bce9d53990afa3e",
+    "https://bcr.bazel.build/modules/rules_cc/0.0.9/MODULE.bazel": "836e76439f354b89afe6a911a7adf59a6b2518fafb174483ad78a2a2fde7b1c5",
+    "https://bcr.bazel.build/modules/rules_cc/0.1.1/MODULE.bazel": "2f0222a6f229f0bf44cd711dc13c858dad98c62d52bd51d8fc3a764a83125513",
+    "https://bcr.bazel.build/modules/rules_cc/0.1.1/source.json": "d61627377bd7dd1da4652063e368d9366fc9a73920bfa396798ad92172cf645c",
+    "https://bcr.bazel.build/modules/rules_foreign_cc/0.9.0/MODULE.bazel": "c9e8c682bf75b0e7c704166d79b599f93b72cfca5ad7477df596947891feeef6",
+    "https://bcr.bazel.build/modules/rules_fuzzing/0.5.2/MODULE.bazel": "40c97d1144356f52905566c55811f13b299453a14ac7769dfba2ac38192337a8",
+    "https://bcr.bazel.build/modules/rules_fuzzing/0.5.2/source.json": "c8b1e2c717646f1702290959a3302a178fb639d987ab61d548105019f11e527e",
+    "https://bcr.bazel.build/modules/rules_java/4.0.0/MODULE.bazel": "5a78a7ae82cd1a33cef56dc578c7d2a46ed0dca12643ee45edbb8417899e6f74",
+    "https://bcr.bazel.build/modules/rules_java/5.3.5/MODULE.bazel": "a4ec4f2db570171e3e5eb753276ee4b389bae16b96207e9d3230895c99644b86",
+    "https://bcr.bazel.build/modules/rules_java/6.0.0/MODULE.bazel": "8a43b7df601a7ec1af61d79345c17b31ea1fedc6711fd4abfd013ea612978e39",
+    "https://bcr.bazel.build/modules/rules_java/6.4.0/MODULE.bazel": "e986a9fe25aeaa84ac17ca093ef13a4637f6107375f64667a15999f77db6c8f6",
+    "https://bcr.bazel.build/modules/rules_java/6.5.2/MODULE.bazel": "1d440d262d0e08453fa0c4d8f699ba81609ed0e9a9a0f02cd10b3e7942e61e31",
+    "https://bcr.bazel.build/modules/rules_java/7.10.0/MODULE.bazel": "530c3beb3067e870561739f1144329a21c851ff771cd752a49e06e3dc9c2e71a",
+    "https://bcr.bazel.build/modules/rules_java/7.12.2/MODULE.bazel": "579c505165ee757a4280ef83cda0150eea193eed3bef50b1004ba88b99da6de6",
+    "https://bcr.bazel.build/modules/rules_java/7.2.0/MODULE.bazel": "06c0334c9be61e6cef2c8c84a7800cef502063269a5af25ceb100b192453d4ab",
+    "https://bcr.bazel.build/modules/rules_java/7.3.2/MODULE.bazel": "50dece891cfdf1741ea230d001aa9c14398062f2b7c066470accace78e412bc2",
+    "https://bcr.bazel.build/modules/rules_java/7.6.1/MODULE.bazel": "2f14b7e8a1aa2f67ae92bc69d1ec0fa8d9f827c4e17ff5e5f02e91caa3b2d0fe",
+    "https://bcr.bazel.build/modules/rules_java/8.14.0/MODULE.bazel": "717717ed40cc69994596a45aec6ea78135ea434b8402fb91b009b9151dd65615",
+    "https://bcr.bazel.build/modules/rules_java/8.14.0/source.json": "8a88c4ca9e8759da53cddc88123880565c520503321e2566b4e33d0287a3d4bc",
+    "https://bcr.bazel.build/modules/rules_jvm_external/4.4.2/MODULE.bazel": "a56b85e418c83eb1839819f0b515c431010160383306d13ec21959ac412d2fe7",
+    "https://bcr.bazel.build/modules/rules_jvm_external/5.1/MODULE.bazel": "33f6f999e03183f7d088c9be518a63467dfd0be94a11d0055fe2d210f89aa909",
+    "https://bcr.bazel.build/modules/rules_jvm_external/5.2/MODULE.bazel": "d9351ba35217ad0de03816ef3ed63f89d411349353077348a45348b096615036",
+    "https://bcr.bazel.build/modules/rules_jvm_external/5.3/MODULE.bazel": "bf93870767689637164657731849fb887ad086739bd5d360d90007a581d5527d",
+    "https://bcr.bazel.build/modules/rules_jvm_external/6.1/MODULE.bazel": "75b5fec090dbd46cf9b7d8ea08cf84a0472d92ba3585b476f44c326eda8059c4",
+    "https://bcr.bazel.build/modules/rules_jvm_external/6.3/MODULE.bazel": "c998e060b85f71e00de5ec552019347c8bca255062c990ac02d051bb80a38df0",
+    "https://bcr.bazel.build/modules/rules_jvm_external/6.3/source.json": "6f5f5a5a4419ae4e37c35a5bb0a6ae657ed40b7abc5a5189111b47fcebe43197",
+    "https://bcr.bazel.build/modules/rules_kotlin/1.9.0/MODULE.bazel": "ef85697305025e5a61f395d4eaede272a5393cee479ace6686dba707de804d59",
+    "https://bcr.bazel.build/modules/rules_kotlin/1.9.6/MODULE.bazel": "d269a01a18ee74d0335450b10f62c9ed81f2321d7958a2934e44272fe82dcef3",
+    "https://bcr.bazel.build/modules/rules_kotlin/1.9.6/source.json": "2faa4794364282db7c06600b7e5e34867a564ae91bda7cae7c29c64e9466b7d5",
+    "https://bcr.bazel.build/modules/rules_license/0.0.3/MODULE.bazel": "627e9ab0247f7d1e05736b59dbb1b6871373de5ad31c3011880b4133cafd4bd0",
+    "https://bcr.bazel.build/modules/rules_license/0.0.7/MODULE.bazel": "088fbeb0b6a419005b89cf93fe62d9517c0a2b8bb56af3244af65ecfe37e7d5d",
+    "https://bcr.bazel.build/modules/rules_license/1.0.0/MODULE.bazel": "a7fda60eefdf3d8c827262ba499957e4df06f659330bbe6cdbdb975b768bb65c",
+    "https://bcr.bazel.build/modules/rules_license/1.0.0/source.json": "a52c89e54cc311196e478f8382df91c15f7a2bfdf4c6cd0e2675cc2ff0b56efb",
+    "https://bcr.bazel.build/modules/rules_pkg/0.7.0/MODULE.bazel": "df99f03fc7934a4737122518bb87e667e62d780b610910f0447665a7e2be62dc",
+    "https://bcr.bazel.build/modules/rules_pkg/1.0.1/MODULE.bazel": "5b1df97dbc29623bccdf2b0dcd0f5cb08e2f2c9050aab1092fd39a41e82686ff",
+    "https://bcr.bazel.build/modules/rules_pkg/1.0.1/source.json": "bd82e5d7b9ce2d31e380dd9f50c111d678c3bdaca190cb76b0e1c71b05e1ba8a",
+    "https://bcr.bazel.build/modules/rules_proto/4.0.0/MODULE.bazel": "a7a7b6ce9bee418c1a760b3d84f83a299ad6952f9903c67f19e4edd964894e06",
+    "https://bcr.bazel.build/modules/rules_proto/5.3.0-21.7/MODULE.bazel": "e8dff86b0971688790ae75528fe1813f71809b5afd57facb44dad9e8eca631b7",
+    "https://bcr.bazel.build/modules/rules_proto/6.0.2/MODULE.bazel": "ce916b775a62b90b61888052a416ccdda405212b6aaeb39522f7dc53431a5e73",
+    "https://bcr.bazel.build/modules/rules_proto/7.0.2/MODULE.bazel": "bf81793bd6d2ad89a37a40693e56c61b0ee30f7a7fdbaf3eabbf5f39de47dea2",
+    "https://bcr.bazel.build/modules/rules_proto/7.0.2/source.json": "1e5e7260ae32ef4f2b52fd1d0de8d03b606a44c91b694d2f1afb1d3b28a48ce1",
+    "https://bcr.bazel.build/modules/rules_python/0.10.2/MODULE.bazel": "cc82bc96f2997baa545ab3ce73f196d040ffb8756fd2d66125a530031cd90e5f",
+    "https://bcr.bazel.build/modules/rules_python/0.23.1/MODULE.bazel": "49ffccf0511cb8414de28321f5fcf2a31312b47c40cc21577144b7447f2bf300",
+    "https://bcr.bazel.build/modules/rules_python/0.25.0/MODULE.bazel": "72f1506841c920a1afec76975b35312410eea3aa7b63267436bfb1dd91d2d382",
+    "https://bcr.bazel.build/modules/rules_python/0.28.0/MODULE.bazel": "cba2573d870babc976664a912539b320cbaa7114cd3e8f053c720171cde331ed",
+    "https://bcr.bazel.build/modules/rules_python/0.31.0/MODULE.bazel": "93a43dc47ee570e6ec9f5779b2e64c1476a6ce921c48cc9a1678a91dd5f8fd58",
+    "https://bcr.bazel.build/modules/rules_python/0.4.0/MODULE.bazel": "9208ee05fd48bf09ac60ed269791cf17fb343db56c8226a720fbb1cdf467166c",
+    "https://bcr.bazel.build/modules/rules_python/0.40.0/MODULE.bazel": "9d1a3cd88ed7d8e39583d9ffe56ae8a244f67783ae89b60caafc9f5cf318ada7",
+    "https://bcr.bazel.build/modules/rules_python/0.40.0/source.json": "939d4bd2e3110f27bfb360292986bb79fd8dcefb874358ccd6cdaa7bda029320",
+    "https://bcr.bazel.build/modules/rules_shell/0.2.0/MODULE.bazel": "fda8a652ab3c7d8fee214de05e7a9916d8b28082234e8d2c0094505c5268ed3c",
+    "https://bcr.bazel.build/modules/rules_shell/0.2.0/source.json": "7f27af3c28037d9701487c4744b5448d26537cc66cdef0d8df7ae85411f8de95",
+    "https://bcr.bazel.build/modules/stardoc/0.5.1/MODULE.bazel": "1a05d92974d0c122f5ccf09291442580317cdd859f07a8655f1db9a60374f9f8",
+    "https://bcr.bazel.build/modules/stardoc/0.5.3/MODULE.bazel": "c7f6948dae6999bf0db32c1858ae345f112cacf98f174c7a8bb707e41b974f1c",
+    "https://bcr.bazel.build/modules/stardoc/0.5.6/MODULE.bazel": "c43dabc564990eeab55e25ed61c07a1aadafe9ece96a4efabb3f8bf9063b71ef",
+    "https://bcr.bazel.build/modules/stardoc/0.7.0/MODULE.bazel": "05e3d6d30c099b6770e97da986c53bd31844d7f13d41412480ea265ac9e8079c",
+    "https://bcr.bazel.build/modules/stardoc/0.7.1/MODULE.bazel": "3548faea4ee5dda5580f9af150e79d0f6aea934fc60c1cc50f4efdd9420759e7",
+    "https://bcr.bazel.build/modules/stardoc/0.7.1/source.json": "b6500ffcd7b48cd72c29bb67bcac781e12701cc0d6d55d266a652583cfcdab01",
+    "https://bcr.bazel.build/modules/upb/0.0.0-20220923-a547704/MODULE.bazel": "7298990c00040a0e2f121f6c32544bab27d4452f80d9ce51349b1a28f3005c43",
+    "https://bcr.bazel.build/modules/zlib/1.2.11/MODULE.bazel": "07b389abc85fdbca459b69e2ec656ae5622873af3f845e1c9d80fe179f3effa0",
+    "https://bcr.bazel.build/modules/zlib/1.3.1.bcr.5/MODULE.bazel": "eec517b5bbe5492629466e11dae908d043364302283de25581e3eb944326c4ca",
+    "https://bcr.bazel.build/modules/zlib/1.3.1.bcr.5/source.json": "22bc55c47af97246cfc093d0acf683a7869377de362b5d1c552c2c2e16b7a806",
+    "https://bcr.bazel.build/modules/zlib/1.3.1/MODULE.bazel": "751c9940dcfe869f5f7274e1295422a34623555916eb98c174c1e945594bf198"
+  },
+  "selectedYankedVersions": {},
+  "moduleExtensions": {
+    "@@rules_kotlin+//src/main/starlark/core/repositories:bzlmod_setup.bzl%rules_kotlin_extensions": {
+      "general": {
+        "bzlTransitiveDigest": "rL/34P1aFDq2GqVC2zCFgQ8nTuOC6ziogocpvG50Qz8=",
+        "usagesDigest": "QI2z8ZUR+mqtbwsf2fLqYdJAkPOHdOV+tF2yVAUgRzw=",
+        "recordedFileInputs": {},
+        "recordedDirentsInputs": {},
+        "envVariables": {},
+        "generatedRepoSpecs": {
+          "com_github_jetbrains_kotlin_git": {
+            "repoRuleId": "@@rules_kotlin+//src/main/starlark/core/repositories:compiler.bzl%kotlin_compiler_git_repository",
+            "attributes": {
+              "urls": [
+                "https://github.com/JetBrains/kotlin/releases/download/v1.9.23/kotlin-compiler-1.9.23.zip"
+              ],
+              "sha256": "93137d3aab9afa9b27cb06a824c2324195c6b6f6179d8a8653f440f5bd58be88"
+            }
+          },
+          "com_github_jetbrains_kotlin": {
+            "repoRuleId": "@@rules_kotlin+//src/main/starlark/core/repositories:compiler.bzl%kotlin_capabilities_repository",
+            "attributes": {
+              "git_repository_name": "com_github_jetbrains_kotlin_git",
+              "compiler_version": "1.9.23"
+            }
+          },
+          "com_github_google_ksp": {
+            "repoRuleId": "@@rules_kotlin+//src/main/starlark/core/repositories:ksp.bzl%ksp_compiler_plugin_repository",
+            "attributes": {
+              "urls": [
+                "https://github.com/google/ksp/releases/download/1.9.23-1.0.20/artifacts.zip"
+              ],
+              "sha256": "ee0618755913ef7fd6511288a232e8fad24838b9af6ea73972a76e81053c8c2d",
+              "strip_version": "1.9.23-1.0.20"
+            }
+          },
+          "com_github_pinterest_ktlint": {
+            "repoRuleId": "@@bazel_tools//tools/build_defs/repo:http.bzl%http_file",
+            "attributes": {
+              "sha256": "01b2e0ef893383a50dbeb13970fe7fa3be36ca3e83259e01649945b09d736985",
+              "urls": [
+                "https://github.com/pinterest/ktlint/releases/download/1.3.0/ktlint"
+              ],
+              "executable": true
+            }
+          },
+          "rules_android": {
+            "repoRuleId": "@@bazel_tools//tools/build_defs/repo:http.bzl%http_archive",
+            "attributes": {
+              "sha256": "cd06d15dd8bb59926e4d65f9003bfc20f9da4b2519985c27e190cddc8b7a7806",
+              "strip_prefix": "rules_android-0.1.1",
+              "urls": [
+                "https://github.com/bazelbuild/rules_android/archive/v0.1.1.zip"
+              ]
+            }
+          }
+        },
+        "recordedRepoMappingEntries": [
+          [
+            "rules_kotlin+",
+            "bazel_tools",
+            "bazel_tools"
+          ]
+        ]
+      }
+    }
+  },
+  "facts": {}
+}
--- a/docs/bazel.md
+++ b/docs/bazel.md
@ -0,0 +1,295 @@
+# Building ETL with Bazel
+
+ETL provides first-class [Bazel](https://bazel.build/) support, both for developing ETL itself and for consuming it as a dependency in your own projects.
+
+## Prerequisites
+
+- [Bazelisk](https://github.com/bazelbuild/bazelisk) (recommended) or [Bazel](https://bazel.build/install) 7.0 or later (with Bzlmod support)
+
+[Bazelisk](https://github.com/bazelbuild/bazelisk) is a launcher that automatically downloads and runs the Bazel version specified in the `.bazelversion` file at the project root. This ensures all contributors use a consistent Bazel version. Simply install Bazelisk and use `bazel` as usual — it transparently delegates to the correct version.
+
+## Syntax Checks
+
+To validate that every ETL header is well-formed and compiles on its own (equivalent to `test/run-syntax-checks.sh` for CMake):
+
+```sh
+bazel build //test/syntax_check:syntax_check
+```
+
+This compiles a set of minimal `.t.cpp` files, each of which includes a single ETL header, with strict warning flags enabled.
+
+## Cleaning Build Artifacts
+
+To remove all build outputs and symlinks (`bazel-bin`, `bazel-out`, `bazel-etl`, etc.):
+
+```sh
+bazel clean
+```
+
+For a full cleanup including the external dependency cache:
+
+```sh
+bazel clean --expunge
+```
+
+## Running Unit Tests
+
+To run the full test suite:
+
+```sh
+bazel test //test:etl_tests
+```
+
+You can also pass standard Bazel flags:
+
+```sh
+# Run with verbose test output
+bazel test //test:etl_tests --test_output=all
+
+# Run tests matching a filter (UnitTest++ subset)
+bazel test //test:etl_tests --test_arg=<suite_name>
+```
+
+## Using ETL in Your Project
+
+### With Bzlmod (recommended, Bazel 7+)
+
+Add ETL as a dependency in your project's `MODULE.bazel`:
+
+```python
+bazel_dep(name = "etl", version = "20.47.1")
+
+git_override(
+    module_name = "etl",
+    remote = "https://github.com/ETLCPP/etl.git",
+    tag = "20.47.1",  # or a specific commit
+)
+```
+
+Then depend on it in your `BUILD.bazel`:
+
+```python
+cc_library(
+    name = "my_library",
+    srcs = ["my_library.cpp"],
+    hdrs = ["my_library.h"],
+    deps = ["@etl//:etl"],
+)
+```
+
+### With WORKSPACE (legacy)
+
+In your `WORKSPACE` file:
+
+```python
+load("@bazel_tools//tools/build_defs/repo:git.bzl", "git_repository")
+
+git_repository(
+    name = "etl",
+    remote = "https://github.com/ETLCPP/etl.git",
+    tag = "20.47.1",
+)
+```
+
+Then use `deps = ["@etl//:etl"]` in your targets as shown above.
+
+## Project Structure
+
+| File | Purpose |
+|---|---|
+| `MODULE.bazel` | Module definition and dependencies |
+| `BUILD.bazel` | Exposes ETL as a `cc_library` |
+| `.bazelversion` | Bazel version for Bazelisk |
+| `.bazelrc` | Default Bazel settings |
+| `test/BUILD.bazel` | Unit test target |
+| `test/syntax_check/BUILD.bazel` | Header syntax check target |
+| `test/UnitTest++/BUILD.bazel` | Vendored UnitTest++ framework |
+
+## Cross-Compilation
+
+Bazel supports cross-compilation through its [platforms](https://bazel.build/extending/platforms) and [toolchains](https://bazel.build/extending/toolchains) system. Since ETL is a header-only library, there is nothing to cross-compile for the library itself. However, when building tests or consuming ETL in an application targeting a different architecture, you need to define a platform and register an appropriate C++ toolchain.
+
+Example platform definition (e.g. in a `platforms/BUILD.bazel`):
+
+```python
+platform(
+    name = "linux_arm64",
+    constraint_values = [
+        "@platforms//os:linux",
+        "@platforms//cpu:aarch64",
+    ],
+)
+```
+
+Then build with:
+
+```sh
+bazel build //:etl --platforms=//platforms:linux_arm64
+```
+
+> **Note:** You must also have a C++ toolchain registered that supports the target platform.
+> See the [Bazel toolchains documentation](https://bazel.build/extending/toolchains) for details.
+
+### Running Cross-Compiled Tests under QEMU
+
+Cross-compiled test binaries cannot run natively on the host. Pre-defined configurations in `.bazelrc` select the correct cross-compiler via `--repo_env=CC`, set the build flags to match `.devcontainer/run-tests.sh` (C++23, No-STL, `-O0`), and use `--run_under` to execute the resulting binary under the appropriate QEMU emulator:
+
+```sh
+# Cross-build and run tests for ARM (armhf)
+bazel test //test:etl_tests --config=armhf
+
+# Other architectures
+bazel test //test:etl_tests --config=i386
+bazel test //test:etl_tests --config=powerpc
+bazel test //test:etl_tests --config=riscv64
+bazel test //test:etl_tests --config=s390x
+```
+
+These configs are designed to run inside the Docker containers under `.devcontainer/`, which provide the cross-compiler toolchains and QEMU binaries. Each config sets `CC`, `AR`, `LD`, `NM`, `STRIP`, and `OBJDUMP` via `--repo_env` so that Bazel's auto-configured toolchain finds the complete prefixed cross-tool suite.
+
+You can also use `--run_under` directly for custom setups:
+
+```sh
+bazel test //test:etl_tests --run_under=/usr/bin/qemu-arm-static
+```
+
+## Compiler and Build Configuration
+
+Unlike CMake where options like `ETL_CXX_STANDARD` and `CMAKE_CXX_COMPILER` are set at configure time, Bazel uses command-line flags and `.bazelrc` configurations.
+
+### C++ Standard Version
+
+Use `--cxxopt` to pass the desired standard flag:
+
+```sh
+# C++17 (default in .bazelrc)
+bazel test //test:etl_tests --cxxopt=-std=c++17
+
+# C++20
+bazel test //test:etl_tests --cxxopt=-std=c++20
+
+# C++23
+bazel test //test:etl_tests --cxxopt=-std=c++23
+
+# C++14
+bazel test //test:etl_tests --cxxopt=-std=c++14
+```
+
+### Optimization Level
+
+Use `--compilation_mode` (shorthand `-c`) for standard profiles, or `--copt` for explicit flags:
+
+```sh
+# Debug (default) — no optimization, debug symbols
+bazel test //test:etl_tests -c dbg
+
+# Optimized — O2 with NDEBUG
+bazel test //test:etl_tests -c opt
+
+# Fast build — no optimization, no debug symbols
+bazel test //test:etl_tests -c fastbuild
+
+# Custom optimization level
+bazel test //test:etl_tests --copt=-O3
+bazel test //test:etl_tests --copt=-O1
+bazel test //test:etl_tests --copt=-Os
+```
+
+### Selecting the Compiler (GCC vs Clang)
+
+Bazel uses the system's default `CC` environment variable. Override it to switch compilers:
+
+```sh
+# Use Clang
+bazel test //test:etl_tests --repo_env=CC=clang
+
+# Use a specific GCC version
+bazel test //test:etl_tests --repo_env=CC=gcc-13
+
+# Use a specific Clang version
+bazel test //test:etl_tests --repo_env=CC=clang-18
+```
+
+> **Note:** Bazel's auto-configured toolchain infers the C++ compiler from `CC` automatically
+> (e.g. `CC=gcc-13` → `g++-13` for C++ compilation). There is no need to set `CXX` separately.
+
+### Combining Options
+
+Flags can be combined freely:
+
+```sh
+# Clang, C++20, optimized
+bazel test //test:etl_tests --repo_env=CC=clang --cxxopt=-std=c++20 -c opt
+
+# GCC 13, C++23, debug
+bazel test //test:etl_tests --repo_env=CC=gcc-13 --cxxopt=-std=c++23 -c dbg
+```
+
+### STL vs. No-STL Mode
+
+ETL can operate without the standard library, which is common on bare-metal embedded targets. Use `--copt` to define `ETL_NO_STL`:
+
+```sh
+# Build and test without STL
+bazel test //test:etl_tests --copt=-DETL_NO_STL
+
+# Build with STL (default, no flag needed)
+bazel test //test:etl_tests
+```
+
+When `ETL_NO_STL` is defined, ETL provides its own implementations of containers, algorithms, and utilities instead of delegating to `<algorithm>`, `<type_traits>`, etc.
+
+### Type Traits Configuration
+
+ETL supports three type traits strategies, controlled via preprocessor defines:
+
+| Mode | Define | Description |
+|---|---|---|
+| **STL type traits** | *(default)* | Uses `<type_traits>` from the standard library |
+| **Compiler builtins** | `ETL_USE_TYPE_TRAITS_BUILTINS` | Uses compiler intrinsics (`__is_trivially_copyable`, etc.) — useful when STL headers are unavailable or incomplete |
+| **User-defined** | `ETL_USER_DEFINED_TYPE_TRAITS` | Uses ETL's own type traits implementations |
+
+```sh
+# Use compiler built-in type traits
+bazel test //test:etl_tests --copt=-DETL_USE_TYPE_TRAITS_BUILTINS
+
+# Use ETL's own user-defined type traits
+bazel test //test:etl_tests --copt=-DETL_USER_DEFINED_TYPE_TRAITS
+```
+
+These are mutually exclusive — define at most one. If neither is defined and STL is available, ETL uses `<type_traits>`.
+
+### Other Configuration Defines
+
+Additional defines can be passed the same way via `--copt=-D...`:
+
+| Define | Description |
+|---|---|
+| `ETL_FORCE_TEST_CPP03_IMPLEMENTATION` | Force C++03 code paths even when a newer standard is available |
+| `ETL_MESSAGES_ARE_NOT_VIRTUAL` | Use non-virtual message types |
+
+```sh
+# Force C++03 implementation paths
+bazel test //test:etl_tests --copt=-DETL_FORCE_TEST_CPP03_IMPLEMENTATION
+```
+
+### Using `.bazelrc` Presets
+
+To avoid retyping flags, add configurations to `.bazelrc`:
+
+```
+# .bazelrc
+
+# Named configurations
+build:clang    --repo_env=CC=clang
+build:gcc13    --repo_env=CC=gcc-13
+build:c++20    --cxxopt=-std=c++20
+build:c++23    --cxxopt=-std=c++23
+build:release  --compilation_mode=opt
+```
+
+Then use them with `--config`:
+
+```sh
+bazel test //test:etl_tests --config=clang --config=c++20 --config=release
+```
--- a/include/etl/tuple.h
+++ b/include/etl/tuple.h
@ -1181,7 +1181,7 @@ namespace etl
 namespace std
 {
  #if ETL_NOT_USING_STL                                                                                                       \
-    && !((defined(ETL_DEVELOPMENT_OS_APPLE) || (ETL_COMPILER_FULL_VERSION >= 190000) && (ETL_COMPILER_FULL_VERSION < 220000)) \
+    && !((defined(ETL_DEVELOPMENT_OS_APPLE) || (ETL_COMPILER_FULL_VERSION >= 190000) && (ETL_COMPILER_FULL_VERSION < 210000)) \
         && defined(ETL_COMPILER_CLANG))
  template <typename T>
  struct tuple_size;
--- a/test/BUILD.bazel
+++ b/test/BUILD.bazel
@ -0,0 +1,36 @@
+load("@rules_cc//cc:defs.bzl", "cc_test")
+
+cc_test(
+    name = "etl_tests",
+    size = "small",
+    srcs = glob(
+        [
+            "*.cpp",
+            "*.h",
+        ],
+        exclude = [
+            "maincpp03check.cpp",
+        ],
+    ),
+    copts = [
+        "-Itest",
+        "-fno-omit-frame-pointer",
+        "-fno-common",
+        "-pedantic-errors",
+        "-Wall",
+        "-Wextra",
+        "-Werror",
+        "-Wfloat-equal",
+        "-Wshadow",
+        "-Wnull-dereference",
+        "-Wsign-conversion",
+        "-Wextra-semi",
+        "-Wno-maybe-uninitialized",
+        "-g",
+    ],
+    linkopts = ["-latomic"],
+    deps = [
+        "//:etl",
+        "//test/UnitTest++:unittest-cpp",
+    ],
+)
--- a/test/UnitTest++/BUILD.bazel
+++ b/test/UnitTest++/BUILD.bazel
@ -0,0 +1,20 @@
+load("@rules_cc//cc:defs.bzl", "cc_library")
+
+package(default_visibility = ["//visibility:public"])
+
+cc_library(
+    name = "unittest-cpp",
+    srcs = glob(
+        [
+            "*.cpp",
+            "Posix/*.cpp",
+        ],
+    ),
+    hdrs = glob(
+        [
+            "*.h",
+            "Posix/*.h",
+        ],
+    ),
+    includes = ["."],
+)
--- a/test/syntax_check/BUILD.bazel
+++ b/test/syntax_check/BUILD.bazel
@ -0,0 +1,18 @@
+load("@rules_cc//cc:defs.bzl", "cc_library")
+
+cc_library(
+    name = "syntax_check",
+    srcs = glob(
+        ["*.t.cpp"],
+    ),
+    hdrs = ["etl_profile.h"],
+    copts = [
+        "-Itest/syntax_check",
+        "-pedantic-errors",
+        "-Wall",
+        "-Wextra",
+        "-Werror",
+        "-Wextra-semi",
+    ],
+    deps = ["//:etl"],
+)
--- a/test/syntax_check/CMakeLists.txt
+++ b/test/syntax_check/CMakeLists.txt
@ -27,6 +27,10 @@ if (ETL_FORCE_TEST_CPP03_IMPLEMENTATION)
 	add_definitions(-DETL_FORCE_TEST_CPP03_IMPLEMENTATION)
 endif()

+# Override the compile rule to use -fsyntax-only instead of -c,
+# since this project only checks syntax and doesn't produce object files.
+set(CMAKE_CXX_COMPILE_OBJECT "<CMAKE_CXX_COMPILER> <DEFINES> <INCLUDES> <FLAGS> -fsyntax-only <SOURCE>")
+
 add_library(tests OBJECT)
 target_compile_definitions(tests PRIVATE __STDC_LIMIT_MACROS __STDC_CONSTANT_MACROS __STDC_FORMAT_MACROS)
 target_include_directories(tests PRIVATE "")
@ -38,7 +42,6 @@ set_target_properties(tests PROPERTIES
 if (CMAKE_CXX_COMPILER_ID MATCHES "GNU")
 target_compile_options(tests
 	    PRIVATE
-		-fsyntax-only
 		-pedantic-errors
 		-Werror
 		-Wextra-semi
@ -47,7 +50,6 @@ endif ()
 if (CMAKE_CXX_COMPILER_ID MATCHES "Clang")
 target_compile_options(tests
 	    PRIVATE
-		-fsyntax-only
 		-pedantic-errors
 		-Werror
 		-Wextra-semi