majacQ · pull · Jan 30, 2026 · Jan 30, 2026 · Jan 30, 2026 · Feb 2, 2026
diff --git a/.editorconfig b/.editorconfig
@@ -0,0 +1,7 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+trim_trailing_whitespace = true
+insert_final_newline = true
diff --git a/.gitattributes b/.gitattributes
@@ -0,0 +1 @@
+Sources/JavaScriptKit/Runtime/** linguist-generated
diff --git a/.github/actions/install-swift/action.yml b/.github/actions/install-swift/action.yml
@@ -0,0 +1,37 @@
+name: 'Install Swift toolchain'
+description: 'Install Swift toolchain tarball from URL'
+inputs:
+  download-url:
+    description: 'URL to download Swift toolchain tarball'
+    required: true
+
+runs:
+  using: composite
+  steps:
+    # https://www.swift.org/install/linux/#installation-via-tarball
+    - name: Install dependent packages for Swift
+      shell: bash
+      run: >
+        sudo apt-get -q update &&
+        sudo apt-get install -y
+        binutils
+        git
+        gnupg2
+        libc6-dev
+        libcurl4-openssl-dev
+        libedit2
+        libgcc-9-dev
+        libpython3.8
+        libsqlite3-0
+        libstdc++-9-dev
+        libxml2-dev
+        libz3-dev
+        pkg-config
+        tzdata
+        unzip
+        zlib1g-dev
+        curl
+
+    - name: Install Swift
+      shell: bash
+      run: curl -fL ${{ inputs.download-url }} | sudo tar xfz - --strip-components=2 -C /usr/local
diff --git a/.github/dependabot.yml b/.github/dependabot.yml
@@ -0,0 +1,11 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: 'github-actions'
+    directory: '/'
+    schedule:
+      interval: 'weekly'
diff --git a/.github/workflows/compatibility.yml b/.github/workflows/compatibility.yml
diff --git a/.github/workflows/documentation.yml b/.github/workflows/documentation.yml
diff --git a/.github/workflows/npm-publish.yml b/.github/workflows/npm-publish.yml
diff --git a/.github/workflows/perf.yml b/.github/workflows/perf.yml
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
@@ -3,23 +3,200 @@ on:
   pull_request:
   push:
     branches: [main]
+concurrency:
+  group: ${{ github.workflow }} / ${{ startsWith(github.event_name, 'pull') && github.ref_name || github.sha }}
+  cancel-in-progress: ${{ startsWith(github.event_name, 'pull') }}
 jobs:
   test:
     name: Build and Test
     strategy:
       matrix:
-        os: [macOS-10.15, Ubuntu-18.04]
-    runs-on: ${{ matrix.os }}
+        entry:
+          - os: ubuntu-22.04
+            toolchain:
+              download-url: https://download.swift.org/swift-6.1-release/ubuntu2204/swift-6.1-RELEASE/swift-6.1-RELEASE-ubuntu22.04.tar.gz
+            wasi-backend: Node
+            target: "wasm32-unknown-wasi"
+            env: |
+              JAVASCRIPTKIT_DISABLE_TRACING_TRAIT=1
+          - os: ubuntu-24.04
+            toolchain:
+              download-url: https://download.swift.org/development/ubuntu2404/swift-DEVELOPMENT-SNAPSHOT-2025-12-01-a/swift-DEVELOPMENT-SNAPSHOT-2025-12-01-a-ubuntu24.04.tar.gz
+            wasi-backend: Node
+            target: "wasm32-unknown-wasip1"
+          - os: ubuntu-24.04
+            toolchain:
+              download-url: https://download.swift.org/swift-6.3-branch/ubuntu2404/swift-6.3-DEVELOPMENT-SNAPSHOT-2026-03-05-a/swift-6.3-DEVELOPMENT-SNAPSHOT-2026-03-05-a-ubuntu24.04.tar.gz
+            wasi-backend: Node
+            target: "wasm32-unknown-wasip1"
+          - os: ubuntu-22.04
+            toolchain:
+              download-url: https://download.swift.org/development/ubuntu2204/swift-DEVELOPMENT-SNAPSHOT-2025-12-01-a/swift-DEVELOPMENT-SNAPSHOT-2025-12-01-a-ubuntu22.04.tar.gz
+            wasi-backend: Node
+            target: "wasm32-unknown-wasip1-threads"
+
+    runs-on: ${{ matrix.entry.os }}
+    env:
+      JAVASCRIPTKIT_WASI_BACKEND: ${{ matrix.entry.wasi-backend }}
     steps:
       - name: Checkout
-        uses: actions/checkout@master
+        uses: actions/checkout@v6
+      - name: Export matrix env
+        if: ${{ matrix.entry.env != '' && matrix.entry.env != null }}
+        run: |
+          cat <<'EOF' >> "$GITHUB_ENV"
+          ${{ matrix.entry.env }}
+          EOF
+      - uses: ./.github/actions/install-swift
+        with:
+          download-url: ${{ matrix.entry.toolchain.download-url }}
+      - uses: swiftwasm/setup-swiftwasm@v2
+        id: setup-swiftwasm
         with:
-          fetch-depth: 1
-      - name: Run Test
+          target: ${{ matrix.entry.target }}
+      - name: Configure environment variables
         run: |
-          git clone https://github.com/kylef/swiftenv.git ~/.swiftenv
-          export SWIFTENV_ROOT="$HOME/.swiftenv"
-          export PATH="$SWIFTENV_ROOT/bin:$PATH"
-          eval "$(swiftenv init -)"
-          make bootstrap
-          make test
+          echo "SWIFT_SDK_ID=${{ steps.setup-swiftwasm.outputs.swift-sdk-id }}" >> $GITHUB_ENV
+          echo "SWIFT_BIN_PATH=$(dirname $(which swiftc))" >> $GITHUB_ENV
+      - run: make bootstrap
+      - run: make unittest
+        # Skip unit tests with uwasi because its proc_exit throws
+        # unhandled promise rejection.
+        if: ${{ matrix.entry.wasi-backend != 'MicroWASI' }}
+      - name: Check if SwiftPM resources are stale
+        run: |
+          make regenerate_swiftpm_resources
+          git diff --exit-code Sources/JavaScriptKit/Runtime
+      - run: swift test --package-path ./Plugins/PackageToJS
+      - run: swift test --package-path ./Plugins/BridgeJS
+      - name: Validate BridgeJS TypeScript declarations
+        run: npm run check:bridgejs-dts
+
+  test-bridgejs-against-swift-versions:
+    name: Test BridgeJS against Swift versions
+    strategy:
+      matrix:
+        entry:
+          - image: "swift:6.1.2"
+            swift-syntax-version: "601.0.0"
+          - image: "swift:6.2"
+            swift-syntax-version: "602.0.0"
+    runs-on: ubuntu-latest
+    container:
+      image: ${{ matrix.entry.image }}
+    steps:
+      - uses: actions/checkout@v6
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: '20'
+      - name: Install TypeScript
+        run: npm install
+      - name: Validate BridgeJS TypeScript declarations
+        run: npm run check:bridgejs-dts
+      - name: Run BridgeJS tests
+        # NOTE: Seems like the prebuilt SwiftSyntax binaries are not compatible with
+        # non-macro dependents, so disable experimental prebuilts for now.
+        run: swift test --disable-experimental-prebuilts --package-path ./Plugins/BridgeJS
+        env:
+          BRIDGEJS_OVERRIDE_SWIFT_SYNTAX_VERSION: ${{ matrix.entry.swift-syntax-version }}
+
+  native-build:
+    # Check native build to make it easy to develop applications by Xcode
+    name: Build for native target
+    strategy:
+      matrix:
+        include:
+          - os: macos-15
+            xcode: Xcode_16.4
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v6
+      - run: swift build --product BridgeJSTool
+        env:
+          DEVELOPER_DIR: /Applications/${{ matrix.xcode }}.app/Contents/Developer/
+      - run: swift build --package-path ./Examples/Basic
+        env:
+          DEVELOPER_DIR: /Applications/${{ matrix.xcode }}.app/Contents/Developer/
+
+  prettier:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v6
+        with:
+          node-version: '20'
+      - run: npm install
+      - run: npx prettier --check Runtime/src
+
+  format:
+    runs-on: ubuntu-latest
+    container:
+      image: swift:6.1.2
+    steps:
+      - uses: actions/checkout@v6
+      - run: ./Utilities/format.swift
+      - name: Check for formatting changes
+        run: |
+          git config --global --add safe.directory "$GITHUB_WORKSPACE"
+          git diff --exit-code || {
+            echo "::error::The formatting changed some files. Please run \`./Utilities/format.swift\` and commit the changes."
+            exit 1
+          }
+
+  check-bridgejs-generated:
+    runs-on: ubuntu-22.04
+    steps:
+      - uses: actions/checkout@v6
+      - uses: ./.github/actions/install-swift
+        with:
+          download-url: https://download.swift.org/development/ubuntu2204/swift-DEVELOPMENT-SNAPSHOT-2025-09-14-a/swift-DEVELOPMENT-SNAPSHOT-2025-09-14-a-ubuntu22.04.tar.gz
+      - run: make bootstrap
+      - run: ./Utilities/bridge-js-generate.sh
+      - name: Check if BridgeJS generated files are up-to-date
+        run: |
+          git config --global --add safe.directory "$GITHUB_WORKSPACE"
+          git diff --exit-code || {
+            echo "::error::BridgeJS generated files are out of date. Please run \`./Utilities/bridge-js-generate.sh\` and commit the changes."
+            exit 1
+          }
+
+  build-examples:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: ./.github/actions/install-swift
+        with:
+          download-url: https://download.swift.org/development/ubuntu2204/swift-DEVELOPMENT-SNAPSHOT-2026-03-09-a/swift-DEVELOPMENT-SNAPSHOT-2026-03-09-a-ubuntu22.04.tar.gz
+      - uses: swiftwasm/setup-swiftwasm@v2
+        id: setup-wasm32-unknown-wasip1
+        with: { target: wasm32-unknown-wasip1 }
+      - uses: swiftwasm/setup-swiftwasm@v2
+        id: setup-wasm32-unknown-wasip1-threads
+        with: { target: wasm32-unknown-wasip1-threads }
+      - run: |
+          swift --version
+          ./Utilities/build-examples.sh
+        env:
+          SWIFT_SDK_ID_wasm32_unknown_wasip1_threads: ${{ steps.setup-wasm32-unknown-wasip1-threads.outputs.swift-sdk-id }}
+          SWIFT_SDK_ID_wasm32_unknown_wasip1: ${{ steps.setup-wasm32-unknown-wasip1.outputs.swift-sdk-id }}
+      - run: ./Utilities/prepare-gh-pages.sh
+      - name: Upload static files as artifact
+        id: deployment
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: ./_site
+  deploy-examples:
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    needs: build-examples
+    permissions:
+      pages: write
+      id-token: write
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
diff --git a/.gitignore b/.gitignore
@@ -6,3 +6,27 @@ node_modules
 /*.xcodeproj
 xcuserdata/
 .swiftpm
+.vscode
+Examples/*/Bundle
+Examples/*/package-lock.json
+Package.resolved
+Plugins/BridgeJS/Sources/TS2Swift/JavaScript/package-lock.json
+Plugins/BridgeJS/Tests/BridgeJSToolTests/__Snapshots__/**/*.actual
+bridge-js.config.local.json
+_site/
+
+# AI coding agent config files
+AGENTS.md
+CLAUDE.md
+GEMINI.md
+.claude/
+.opencode/
+.cursor/
+.cursorrules
+.codex/
+.aider*
+.cline/
+.clinerules
+.windsurf/
+.windsurfrules
+.codeiumignore
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		Sources/JavaScriptKit/Runtime/** linguist-generated