Add camera-first, offline-capable GridPuzzle phone app

.github/workflows/browser-pages.yml

@@ -0,0 +1,87 @@
+name: Build and deploy phone scanner
+on:
+  push:
+    branches: [browser-scanner]
+  workflow_dispatch:
+permissions:
+  contents: read
+concurrency:
+  group: gridpuzzle-browser-pages
+  cancel-in-progress: true
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    timeout-minutes: 30
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-python@v7
+        with:
+          python-version: '3.14'
+      - uses: actions/setup-node@v6
+        with:
+          node-version: '22'
+      - run: python -m pip install -e '.[dev]'
+      - name: Native adapter and full solver regressions
+        run: python -m pytest -q tests -m 'not slow'
+      - name: Geometry and model tests
+        run: node --test web/tests/*.test.js
+      - name: Build self-hosted application
+        run: python scripts/build_web.py
+      - name: Retain build for independent testing
+        uses: actions/upload-artifact@v7
+        with:
+          name: scanner-static-build
+          path: _site
+          retention-days: 7
+      - name: Install browser test runtime
+        run: |
+          npm install --no-save --package-lock=false --ignore-scripts playwright@1.63.0
+          npx playwright install --with-deps chromium webkit
+      - name: Cross-tab solver update regressions
+        run: node scripts/solver_update_regressions.cjs
+      - name: Chromium and mobile WebKit acceptance tests
+        run: node scripts/browser_smoke.cjs
+      - name: Scanner variation, review and real-newspaper regressions
+        run: |
+          node scripts/browser_regressions.cjs
+          node scripts/newspaper_regressions.cjs
+      - name: Upload screenshots and test report
+        if: always()
+        uses: actions/upload-artifact@v7
+        with:
+          name: browser-test-report
+          path: browser-artifacts
+          if-no-files-found: ignore
+      - name: Upload static Pages site
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: _site
+  configure:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pages: write
+    steps:
+      - name: Check Pages configuration
+        id: pages
+        uses: actions/configure-pages@v6
+      - name: Explain the one-time repository setting
+        if: failure()
+        run: |
+          echo '::error::Pages is not enabled for Actions. A repository owner must set Settings > Pages > Source to GitHub Actions, then re-run this job. The workflow token cannot grant itself repository administration permission.'
+  deploy:
+    needs: [build, configure]
+    runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
+    # The default github-pages environment may be restricted to the default
+    # branch. This branch has its own Pages environment so the deployment can
+    # originate from browser-scanner without weakening that default policy.
+    environment:
+      name: gridpuzzle-browser-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Publish the tested branch artifact
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/browser-tests.yml

@@ -0,0 +1,23 @@
+name: Browser branch tests
+on:
+  pull_request:
+permissions:
+  contents: read
+concurrency:
+  group: browser-tests-${{ github.event.pull_request.number }}
+  cancel-in-progress: true
+jobs:
+  unit:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v7
+      - uses: actions/setup-node@v6
+        with:
+          node-version: '22'
+      - name: Browser model, lifecycle and safety unit tests
+        run: node --test web/tests/*.test.js
+      - name: Check every browser module parses
+        run: find web -name '*.js' -not -path '*/vendor/*' -exec node --check {} \;
+      - name: Explain full-browser coverage
+        run: echo 'The browser-scanner push workflow is the single full Chromium/WebKit + Python deployment gate; PR CI intentionally avoids duplicating that expensive suite.'

.gitignore

@@ -136,5 +136,11 @@ test.py
 mypuz/
 _test/
 solve*.ipynb
+
+# browser scanner build and acceptance outputs
+node_modules/
+_site/
+_preview/
+browser-artifacts/
 # ruff
 .ruff_cache/

Examples/BrowserScanner/Newspaper/README.md

@@ -0,0 +1,11 @@
+# Real newspaper scanner fixtures
+
+These are user-provided newspaper puzzle photographs from 2026-09-07, cropped to the puzzle grid and downsampled to keep the repository and browser regression suite small. They are real newsprint images, not generated OCR fixtures.
+
+- `2026-09-07-sudoku.webp`: shaded 9×9 Sudoku with paper texture and uneven illumination.
+- `2026-09-07-str8ts.webp`: 9×9 Str8ts with solid black separators, including numbered black cells.
+- `ground-truth.json`: hand-checked printed clues and Str8ts black-cell geometry.
+
+`scripts/newspaper_regressions.cjs` runs the production scanner and self-hosted Tesseract.js pipeline against both images in Chromium and WebKit. Wrong, missing, or invented clues are acceptable only when the corresponding cell is explicitly flagged for review. The suite also enforces minimum correct-transcription counts and exact Str8ts black-cell geometry.
+
+The images live outside `web/`, so they are not shipped in the GitHub Pages application or included in the offline PWA bundle.

Examples/BrowserScanner/Newspaper/ground-truth.json

@@ -0,0 +1,37 @@
+{
+  "fixtures": [
+    {
+      "name": "2026-09-07-sudoku",
+      "image": "2026-09-07-sudoku.webp",
+      "type": "sudoku",
+      "cells": [
+        null, null, null, null, 8, null, null, 3, null,
+        8, null, null, 7, null, null, null, null, null,
+        null, null, null, 9, null, 5, null, null, 4,
+        null, null, null, 2, 9, null, 7, null, null,
+        7, null, null, 8, 3, null, null, 2, 5,
+        null, 1, null, null, null, null, 4, 9, null,
+        null, null, null, null, null, null, null, 5, null,
+        null, 8, null, null, 4, null, null, null, null,
+        2, 3, null, null, null, 7, null, null, null
+      ]
+    },
+    {
+      "name": "2026-09-07-str8ts",
+      "image": "2026-09-07-str8ts.webp",
+      "type": "str8ts",
+      "black": [2, 3, 7, 8, 18, 19, 22, 23, 30, 35, 38, 42, 45, 50, 57, 58, 61, 62, 72, 73, 77, 78],
+      "cells": [
+        9, null, "#", 6, null, null, null, "#", "#",
+        null, null, null, 1, 4, null, 6, 5, null,
+        "#", "#", null, 2, "#", "#", null, null, null,
+        3, null, null, "#", 9, null, null, null, 5,
+        null, null, "#", 8, null, null, "#", null, null,
+        "#", null, null, null, null, 1, null, null, null,
+        null, 7, null, 9, "#", null, 3, 2, "#",
+        null, null, null, 4, null, 5, null, null, 8,
+        7, "#", null, null, null, "#", "#", null, null
+      ]
+    }
+  ]
+}