0.5.0-pre.5

.github/workflows/build-filament.yml

@@ -329,6 +329,62 @@ jobs:
           AWS_SECRET_ACCESS_KEY: ${{ secrets.R2_SECRET_ACCESS_KEY }}
           AWS_DEFAULT_REGION: auto
 
+  build-linux-arm64:
+    name: Build Linux (arm64)
+    # GitHub-hosted arm64 runner — build_linux.sh detects the host arch and
+    # produces filament-<version>-linux-arm64-{release,debug}.zip.
+    runs-on: ubuntu-24.04-arm
+    needs: setup
+    if: contains(needs.setup.outputs.matrix, 'linux')
+    env:
+      FILAMENT_VERSION: ${{ needs.setup.outputs.filament_version }}
+      FILAMENT_REPO: ${{ needs.setup.outputs.filament_repo }}
+    steps:
+      - name: Checkout thermion
+        uses: actions/checkout@v4
+
+      - name: Checkout Filament
+        run: git clone --depth 1 --branch ${{ env.FILAMENT_VERSION }} ${{ env.FILAMENT_REPO }} filament
+
+      - name: Install dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y clang libc++-dev libc++abi-dev ninja-build libx11-dev libxcursor-dev libxrandr-dev libxinerama-dev libxi-dev libgl1-mesa-dev libglu1-mesa-dev libxxf86vm-dev
+
+      - name: Build Filament
+        run: |
+          mkdir -p output
+          chmod +x scripts/build_linux.sh
+          scripts/build_linux.sh filament ${{ env.FILAMENT_VERSION }} output --clean
+
+      - name: Upload release artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: filament-linux-arm64-release
+          path: output/filament-${{ env.FILAMENT_VERSION }}-linux-arm64-release.zip
+          retention-days: 7
+
+      - name: Upload debug artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: filament-linux-arm64-debug
+          path: output/filament-${{ env.FILAMENT_VERSION }}-linux-arm64-debug.zip
+          retention-days: 7
+
+      - name: Upload to R2
+        if: inputs.upload_to_r2
+        run: |
+          for variant in release debug; do
+            aws s3 cp \
+              "output/filament-${{ env.FILAMENT_VERSION }}-linux-arm64-${variant}.zip" \
+              "s3://${{ env.R2_BUCKET_NAME }}/filament-${{ env.FILAMENT_VERSION }}-linux-arm64-${variant}.zip" \
+              --endpoint-url "${{ env.R2_ENDPOINT }}"
+          done
+        env:
+          AWS_ACCESS_KEY_ID: ${{ secrets.R2_ACCESS_KEY_ID }}
+          AWS_SECRET_ACCESS_KEY: ${{ secrets.R2_SECRET_ACCESS_KEY }}
+          AWS_DEFAULT_REGION: auto
+
   build-windows:
     name: Build Windows
     runs-on: windows-2022

.github/workflows/build-libassimp.yml

@@ -0,0 +1,222 @@
+name: Build libassimp (standalone)
+
+# Temporary workflow to iterate on the libassimp build (per-platform) WITHOUT
+# waiting for the full ~40min Filament build. It builds ONLY libassimp from the
+# third_party/libassimp/tnt overlay against the Filament tag in filament.version,
+# mirroring the exact libassimp cmake invocation used by each build_*.sh /
+# build_windows.bat (including the zlib include-path fix).
+#
+# Safe to delete once the libassimp build is green in the real "Build Filament"
+# workflow on every platform.
+
+on:
+  workflow_dispatch:
+    inputs:
+      filament_version:
+        description: 'Filament tag (overrides filament.version)'
+        required: false
+        type: string
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  setup:
+    runs-on: ubuntu-24.04
+    outputs:
+      version: ${{ steps.read.outputs.version }}
+      repo: ${{ steps.read.outputs.repo }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Read Filament version
+        id: read
+        run: |
+          read -r REPO VERSION < filament.version
+          [ -n "${{ inputs.filament_version }}" ] && VERSION="${{ inputs.filament_version }}"
+          echo "repo=$REPO" >> "$GITHUB_OUTPUT"
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+          echo "Building libassimp against Filament repo=$REPO ref=$VERSION"
+
+  build:
+    needs: setup
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - platform: windows
+            runner: windows-2022
+          - platform: linux
+            runner: ubuntu-24.04
+          - platform: macos
+            runner: macos-14
+          - platform: ios
+            runner: macos-14
+          - platform: android
+            runner: ubuntu-24.04
+          - platform: web
+            runner: ubuntu-24.04
+    runs-on: ${{ matrix.runner }}
+    env:
+      FILAMENT_VERSION: ${{ needs.setup.outputs.version }}
+      FILAMENT_REPO: ${{ needs.setup.outputs.repo }}
+    steps:
+      - name: Checkout thermion
+        uses: actions/checkout@v4
+
+      - name: Checkout Filament
+        shell: bash
+        run: git clone --depth 1 --branch "$FILAMENT_VERSION" "$FILAMENT_REPO" filament
+
+      - name: Patch libassimp tnt overlay (if the patch script exists on this branch)
+        shell: bash
+        run: |
+          if [ -f scripts/patch_libassimp_tnt.py ]; then
+            python3 scripts/patch_libassimp_tnt.py "$GITHUB_WORKSPACE/filament"
+          else
+            echo "patch_libassimp_tnt.py not present on this branch — building the unpatched tnt overlay (still exercises the zlib include path)."
+          fi
+
+      - name: Setup CMake
+        uses: jwlawson/actions-setup-cmake@v2
+        with:
+          cmake-version: '3.30.0'
+
+      - name: Setup Ninja (non-Windows)
+        if: matrix.platform != 'windows'
+        uses: seanmiddleditch/gha-setup-ninja@master
+
+      - name: Install deps (Linux runners)
+        if: matrix.platform == 'linux' || matrix.platform == 'android' || matrix.platform == 'web'
+        run: sudo apt-get update && sudo apt-get install -y ninja-build
+
+      - name: Setup Android NDK
+        if: matrix.platform == 'android'
+        uses: nttld/setup-ndk@v1
+        id: ndk
+        with:
+          ndk-version: r27c
+
+      - name: Setup Emscripten
+        if: matrix.platform == 'web'
+        uses: mymindstorm/setup-emsdk@v14
+        with:
+          version: '6.0.4'
+
+      # ---- Windows: MSVC, mirrors build_windows.bat libassimp cmake ----
+      - name: Build libassimp (Windows)
+        if: matrix.platform == 'windows'
+        shell: cmd
+        run: |
+          mkdir filament\out\assimp
+          cd filament\out\assimp
+          cmake -G "Visual Studio 17 2022" -T v142 ^
+            -DCMAKE_BUILD_TYPE=Release ^
+            -DCMAKE_CXX_STANDARD=17 ^
+            -DCMAKE_C_FLAGS=/I..\..\third_party\libz ^
+            -DCMAKE_CXX_FLAGS=/I..\..\third_party\libz ^
+            -DASSIMP_BUILD_ASSIMP_TOOLS=OFF ^
+            -DASSIMP_BUILD_TESTS=OFF ^
+            -DASSIMP_BUILD_SAMPLES=OFF ^
+            -DASSIMP_WARNINGS_AS_ERRORS=OFF ^
+            ..\..\third_party\libassimp\tnt
+          cmake --build . --config Release
+
+      # ---- Linux / macOS: Ninja, mirrors build_linux.sh libassimp cmake ----
+      - name: Build libassimp (Linux/macOS)
+        if: matrix.platform == 'linux' || matrix.platform == 'macos'
+        shell: bash
+        run: |
+          mkdir -p filament/out/assimp
+          cd filament/out/assimp
+          cmake -G Ninja -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_STANDARD=17 \
+            -DCMAKE_C_FLAGS="-I$GITHUB_WORKSPACE/filament/third_party/libz" \
+            -DCMAKE_CXX_FLAGS="-I$GITHUB_WORKSPACE/filament/third_party/libz" \
+            -DASSIMP_BUILD_ASSIMP_TOOLS=OFF \
+            -DASSIMP_BUILD_TESTS=OFF \
+            -DASSIMP_BUILD_SAMPLES=OFF \
+            -DASSIMP_WARNINGS_AS_ERRORS=OFF \
+            "$GITHUB_WORKSPACE/filament/third_party/libassimp/tnt"
+          cmake --build .
+
+      # ---- iOS: Ninja + iphoneos sysroot, mirrors build_ios.sh libassimp cmake ----
+      - name: Build libassimp (iOS)
+        if: matrix.platform == 'ios'
+        shell: bash
+        run: |
+          mkdir -p filament/out/assimp-ios
+          cd filament/out/assimp-ios
+          cmake -G Ninja -DCMAKE_BUILD_TYPE=Release -DCMAKE_CXX_STANDARD=17 \
+            -DCMAKE_SYSTEM_NAME=iOS \
+            -DCMAKE_OSX_SYSROOT=iphoneos \
+            -DCMAKE_OSX_ARCHITECTURES=arm64 \
+            -DIOS=1 \
+            -DCMAKE_C_FLAGS="-I$GITHUB_WORKSPACE/filament/third_party/libz" \
+            -DCMAKE_CXX_FLAGS="-I$GITHUB_WORKSPACE/filament/third_party/libz" \
+            -DASSIMP_BUILD_ASSIMP_TOOLS=OFF \
+            -DASSIMP_BUILD_TESTS=OFF \
+            -DASSIMP_BUILD_SAMPLES=OFF \
+            -DASSIMP_WARNINGS_AS_ERRORS=OFF \
+            "$GITHUB_WORKSPACE/filament/third_party/libassimp/tnt"
+          cmake --build .
+
+      # ---- Android: Ninja + NDK toolchain (arm64-v8a), mirrors build_android.sh ----
+      - name: Build libassimp (Android)
+        if: matrix.platform == 'android'
+        shell: bash
+        env:
+          ANDROID_NDK_HOME: ${{ steps.ndk.outputs.ndk-path }}
+        run: |
+          mkdir -p filament/out/assimp-android
+          cd filament/out/assimp-android
+          cmake -G Ninja \
+            -DCMAKE_TOOLCHAIN_FILE="$ANDROID_NDK_HOME/build/cmake/android.toolchain.cmake" \
+            -DANDROID_ABI=arm64-v8a \
+            -DANDROID_PLATFORM=android-21 \
+            -DCMAKE_BUILD_TYPE=Release \
+            -DCMAKE_CXX_STANDARD=17 \
+            -DCMAKE_C_FLAGS="-I$GITHUB_WORKSPACE/filament/third_party/libz" \
+            -DCMAKE_CXX_FLAGS="-I$GITHUB_WORKSPACE/filament/third_party/libz" \
+            -DASSIMP_BUILD_ASSIMP_TOOLS=OFF \
+            -DASSIMP_BUILD_TESTS=OFF \
+            -DASSIMP_BUILD_SAMPLES=OFF \
+            -DASSIMP_WARNINGS_AS_ERRORS=OFF \
+            "$GITHUB_WORKSPACE/filament/third_party/libassimp/tnt"
+          cmake --build .
+
+      # ---- Web: Ninja + Emscripten, mirrors build_web.sh libassimp cmake ----
+      - name: Build libassimp (Web)
+        if: matrix.platform == 'web'
+        shell: bash
+        run: |
+          mkdir -p filament/out/assimp-web
+          cd filament/out/assimp-web
+          cmake -G Ninja -DCMAKE_BUILD_TYPE=Release \
+            -DCMAKE_CXX_STANDARD=20 \
+            -DCMAKE_TOOLCHAIN_FILE="$EMSDK/upstream/emscripten/cmake/Modules/Platform/Emscripten.cmake" \
+            -DCMAKE_C_FLAGS="-pthread -I$GITHUB_WORKSPACE/filament/third_party/libz -matomics -mbulk-memory" \
+            -DCMAKE_CXX_FLAGS="-pthread -I$GITHUB_WORKSPACE/filament/third_party/libz -matomics -mbulk-memory" \
+            -DASSIMP_BUILD_ASSIMP_TOOLS=OFF \
+            -DASSIMP_BUILD_TESTS=OFF \
+            -DASSIMP_BUILD_SAMPLES=OFF \
+            -DASSIMP_WARNINGS_AS_ERRORS=OFF \
+            "$GITHUB_WORKSPACE/filament/third_party/libassimp/tnt"
+          cmake --build .
+
+      - name: Locate built libassimp
+        if: always()
+        shell: bash
+        run: |
+          echo "=== libassimp artifacts ==="
+          find filament/out -iname '*assimp*' -type f 2>/dev/null || true
+
+      - name: Upload libassimp
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: libassimp-${{ matrix.platform }}
+          path: |
+            filament/out/**/assimp.lib
+            filament/out/**/libassimp.a
+          if-no-files-found: warn
+          retention-days: 3

.github/workflows/deploy.yml

@@ -0,0 +1,89 @@
+name: Deploy site
+
+# Builds the documentation site (Astro) and the WASM examples gallery, stages the
+# gallery under /gallery/ in the docs output, and deploys both to a single
+# Cloudflare Pages project (thermion-docs → thermion.dev).
+#
+# The whole site is already cross-origin-isolated via docs/public/_headers
+# (COOP same-origin + COEP credentialless on /*), so the gallery's
+# SharedArrayBuffer (multithreaded WASM) works without any path-scoped headers.
+#
+# Fires on:
+#   - a release tag push v* (same event publish-pub-dev.yml uses) — the site
+#     deploys on a Thermion release, NOT on every develop commit
+#   - manual dispatch (re-deploy without cutting a release)
+#
+# Requires repo secrets CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID.
+
+on:
+  push:
+    tags: ['v[0-9]+.[0-9]+.[0-9]+*']
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: deploy-site-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    name: Build & deploy site
+    # Any standard runner works: the web-artifact download step runs
+    # `dart run thermion_dart:download_web` with `skip_native_build` set (see
+    # examples/dart/web_gallery/pubspec.yaml + thermion_dart/hook/build.dart), so
+    # it does no host C++ compile and needs no C++ toolchain.
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+
+      # --- documentation (Astro) ---
+      - uses: pnpm/action-setup@v4
+        with:
+          package_json_file: docs/package.json
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          cache: pnpm
+          cache-dependency-path: docs/pnpm-lock.yaml
+      - name: Build docs
+        working-directory: docs
+        run: |
+          pnpm install --frozen-lockfile
+          pnpm build
+
+      # --- examples gallery (WASM) ---
+      - uses: dart-lang/setup-dart@v1
+      - name: Resolve gallery dependencies
+        run: |
+          (cd thermion_dart && dart pub get)
+          (cd examples/dart/examples_lib && dart pub get)
+          (cd examples/dart/web_gallery && dart pub get)
+      - name: Download thermion web artifacts (thermion_dart.js/wasm)
+        # Run from the gallery so thermion_dart's build hook picks up the
+        # `skip_native_build` userDefine (declared under hooks.user_defines in
+        # examples/dart/web_gallery/pubspec.yaml). That makes the hook no-op its
+        # host C++ build: download_web.dart only fetches prebuilt artifacts over
+        # HTTP, so no native compile — and no C++ toolchain on the runner — is
+        # needed. (The later `dart compile wasm` step is unaffected: the hook's
+        # buildCodeAssets branch runs before the skip and still downloads for web.)
+        working-directory: examples/dart/web_gallery
+        run: dart run thermion_dart:download_web -o web
+      - name: Copy shared assets
+        run: cp -r examples/assets examples/dart/web_gallery/web/assets
+      - name: Compile gallery to WASM
+        working-directory: examples/dart/web_gallery
+        run: dart compile wasm web/main.dart -o web/main.wasm
+      - name: Stage gallery under docs output
+        run: |
+          mkdir -p docs/dist/gallery
+          cp -r examples/dart/web_gallery/web/. docs/dist/gallery/
+
+      # --- deploy a single Cloudflare Pages project ---
+      - name: Deploy to Cloudflare Pages
+        uses: cloudflare/wrangler-action@v3
+        with:
+          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+          command: pages deploy docs/dist --project-name=thermion-docs