v4: Cartesian OKLab matcher, sRGB-space ordered dither, flat API

.github/workflows/javascript-test.yml

@@ -0,0 +1,57 @@
+name: JavaScript Tests
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'packages/javascript/**'
+      - 'packages/rust/wasm/**'
+      - 'packages/rust/core/**'
+      - '.github/workflows/javascript-test.yml'
+  pull_request:
+    paths:
+      - 'packages/javascript/**'
+      - 'packages/rust/wasm/**'
+      - 'packages/rust/core/**'
+      - '.github/workflows/javascript-test.yml'
+  workflow_dispatch:
+
+defaults:
+  run:
+    working-directory: packages/javascript
+
+jobs:
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: wasm32-unknown-unknown
+
+      - uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: packages/rust
+
+      - name: Install wasm-pack
+        run: curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh
+
+      - name: Build WASM
+        working-directory: .
+        run: wasm-pack build packages/rust/wasm --target bundler --out-dir ../../javascript/src/wasm-core
+
+      - uses: oven-sh/setup-bun@v2
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Type check
+        run: bun run type-check
+
+      - name: Run tests
+        run: bun run test
+
+      - name: Build
+        run: bun run build

.github/workflows/python-lint.yml

@@ -26,7 +26,7 @@ jobs:
         run: uv python install 3.11
 
       - name: Install dependencies
-        run: uv --project packages/python sync --all-extras
+        run: uv --project packages/python sync --all-extras --no-install-project
 
       - name: Run prek
         run: uv --project packages/python run prek run --all-files --config packages/python/.pre-commit-config.yaml

.github/workflows/python-test.yml

@@ -5,10 +5,12 @@ on:
     branches: [main]
     paths:
       - 'packages/python/**'
+      - 'packages/rust/**'
       - '.github/workflows/python-test.yml'
   pull_request:
     paths:
       - 'packages/python/**'
+      - 'packages/rust/**'
       - '.github/workflows/python-test.yml'
   workflow_dispatch:
 
@@ -33,8 +35,17 @@ jobs:
       - name: Set up Python ${{ matrix.python-version }}
         run: uv python install ${{ matrix.python-version }}
 
+      - uses: dtolnay/rust-toolchain@stable
+
+      - uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: packages/python
+
       - name: Install dependencies
-        run: uv sync --all-extras
+        run: uv sync --all-extras --no-install-project
+
+      - name: Build and install package
+        run: uv run maturin develop --release
 
       - name: Run tests
         run: uv run pytest tests/ -v --tb=short
@@ -49,4 +60,4 @@ jobs:
         with:
           file: ./packages/python/coverage.xml
           fail_ci_if_error: false
-          flags: python
+          flags: python

.github/workflows/release.yml

@@ -15,78 +15,145 @@ jobs:
   release-please:
     runs-on: ubuntu-latest
     outputs:
-      python-release-created: ${{ steps.release.outputs['packages/python--release_created'] }}
-      python-tag: ${{ steps.release.outputs['packages/python--tag_name'] }}
-      javascript-release-created: ${{ steps.release.outputs['packages/javascript--release_created'] }}
-      javascript-tag: ${{ steps.release.outputs['packages/javascript--tag_name'] }}
+      release-created: ${{ steps.release.outputs['packages/python--release_created'] }}
+      tag: ${{ steps.release.outputs['packages/python--tag_name'] }}
     steps:
       - uses: googleapis/release-please-action@v4
         id: release
         with:
-          # Use manifest-based config for monorepo
           config-file: release-please-config.json
           manifest-file: .release-please-manifest.json
 
-  # Publish Python package to PyPI
-  publish-python:
+  # ── Rust: publish epaper-dithering-core to crates.io ────────────────────────
+
+  publish-rust:
     needs: release-please
-    if: ${{ needs.release-please.outputs.python-release-created }}
+    if: ${{ needs.release-please.outputs.release-created }}
     runs-on: ubuntu-latest
-    defaults:
-      run:
-        working-directory: packages/python
     steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
+      - uses: actions/checkout@v4
+
+      - uses: dtolnay/rust-toolchain@stable
 
-      - name: Set up Python
-        uses: actions/setup-python@v5
+      - uses: Swatinem/rust-cache@v2
         with:
-          python-version: "3.11"
+          workspaces: packages/rust
 
-      - name: Install uv
-        uses: astral-sh/setup-uv@v4
+      - name: Publish to crates.io
+        run: cargo publish -p epaper-dithering-core
+        env:
+          CARGO_REGISTRY_TOKEN: ${{ secrets.CARGO_REGISTRY_TOKEN }}
 
-      - name: Install dependencies
-        run: uv sync
+  # ── Python: build wheels for each platform ──────────────────────────────────
 
-      - name: Build package
-        run: uv build
+  build-python-wheels:
+    needs: release-please
+    if: ${{ needs.release-please.outputs.release-created }}
+    name: Build wheels (${{ matrix.target }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: x86_64
+          - os: ubuntu-latest
+            target: aarch64
+          - os: ubuntu-latest
+            target: armv7
+          - os: macos-latest
+            target: universal2-apple-darwin
+          - os: windows-latest
+            target: x86_64
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: PyO3/maturin-action@v1
+        with:
+          working-directory: packages/python
+          target: ${{ matrix.target }}
+          manylinux: auto
+          args: --release --out dist --find-interpreter
+          sccache: true
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.target }}
+          path: packages/python/dist
+
+  build-python-sdist:
+    needs: release-please
+    if: ${{ needs.release-please.outputs.release-created }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
 
-      - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
+      - uses: PyO3/maturin-action@v1
         with:
-          packages-dir: packages/python/dist/
+          working-directory: packages/python
+          command: sdist
+          args: --out dist
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-sdist
+          path: packages/python/dist
+
+  publish-python:
+    needs: [build-python-wheels, build-python-sdist]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          merge-multiple: true
+          path: dist
+
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/
+
+  # ── JavaScript ───────────────────────────────────────────────────────────────
 
-  # Publish JavaScript package to npm
   publish-javascript:
     needs: release-please
-    if: ${{ needs.release-please.outputs.javascript-release-created }}
+    if: ${{ needs.release-please.outputs.release-created }}
     runs-on: ubuntu-latest
     permissions:
-      id-token: write  # Required for npm provenance
+      id-token: write
       contents: read
     defaults:
       run:
         working-directory: packages/javascript
     steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
+      - uses: actions/checkout@v4
+
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: wasm32-unknown-unknown
+
+      - uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: packages/rust
+
+      - name: Install wasm-pack
+        run: curl https://rustwasm.github.io/wasm-pack/installer/init.sh -sSf | sh
+
+      - name: Build WASM
+        working-directory: ${{ github.workspace }}
+        run: wasm-pack build packages/rust/wasm --target bundler --out-dir ../../javascript/src/wasm-core
 
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
+      - uses: actions/setup-node@v4
         with:
           node-version: '25'
           registry-url: 'https://registry.npmjs.org'
 
-      - name: Setup Bun
-        uses: oven-sh/setup-bun@v2
+      - uses: oven-sh/setup-bun@v2
 
       - name: Install dependencies
         run: bun install
 
       - name: Run tests
-        run: bun test
+        run: bun run test
 
       - name: Build package
         run: bun run build

.github/workflows/rust-test.yml

@@ -0,0 +1,36 @@
+name: Rust Tests
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'packages/rust/**'
+      - '.github/workflows/rust-test.yml'
+  pull_request:
+    paths:
+      - 'packages/rust/**'
+      - '.github/workflows/rust-test.yml'
+  workflow_dispatch:
+
+defaults:
+  run:
+    working-directory: packages/rust
+
+jobs:
+  test:
+    name: Test
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: dtolnay/rust-toolchain@stable
+
+      - uses: Swatinem/rust-cache@v2
+        with:
+          workspaces: packages/rust
+
+      - name: Test
+        run: cargo test --workspace
+
+      - name: Clippy
+        run: cargo clippy --workspace -- -D warnings

.gitignore

@@ -77,4 +77,11 @@ yarn.lock
 *.gif
 *.bmp
 !fixtures/images/
-uv.lock
+uv.lock
+
+# Python scratch / dev files
+packages/python/test.py
+packages/python/test_timed.py
+packages/python/benchmark.py
+packages/python/np_test.py
+packages/python/*.pdf

.release-please-manifest.json

@@ -1,4 +1,3 @@
 {
-  "packages/python": "0.6.4",
-  "packages/javascript": "2.2.1"
+  "packages/python": "3.0.0"
 }