Integrate tile57 engine

.dockerignore

@@ -0,0 +1,58 @@
+# Docker build context trimming. The image build only needs the Go source, the
+# embedded web assets (web/embed.go go:embed list), go.mod/go.sum, and
+# scripts/xbuild-tile57.sh — everything else just bloats the context. The tile57
+# engine is git-cloned inside the builder, not copied from here.
+
+# VCS + agent/editor state
+.git/
+.github/
+.claude/
+.idea/
+.vscode/
+.DS_Store
+
+# The tile57 engine submodule: cloned fresh in the builder (shallow + floating),
+# never copied from the context — so the local checkout doesn't leak in or pin it.
+tile57/
+
+# Build output / release staging
+bin/
+dist/
+release-assets/
+*.test
+*.out
+coverage.*
+
+# Local Go workspace override (must never reach the builder — it would repoint the
+# engine replace at a path that doesn't exist in the image).
+go.work
+go.work.sum
+
+# Baked tile archives + generated (non-embedded) client assets
+*.pmtiles
+web/*.pmtiles
+web/colortables.json
+web/linestyles.json
+web/patterns.json
+web/patterns.png
+web/sprite.json
+web/sprite.png
+web/chartplotter.wasm
+web/charts-index.json
+web/charts-user.*
+
+# Large test/data material + local artifacts (not needed to build the binary)
+testdata/
+examples/
+*.cpx
+/chartplotter
+
+# The docs site (Docusaurus) is not part of the binary build
+docs/node_modules/
+docs/build/
+docs/.docusaurus/
+
+# Docker + compose files themselves
+Dockerfile
+.dockerignore
+compose.yaml

.github/workflows/ci.yml

@@ -4,31 +4,71 @@ on:
   push:
   pull_request:
 
+# libtile57 is the sole engine: the build is CGO and statically links the native
+# lib from the public beetlebugorg/tile57 repo, built with Zig 0.16. That repo is
+# the ./tile57 git submodule (go.mod's replace points at ./tile57/bindings/go, and
+# the binding's cgo LDFLAGS at its zig-out/lib); its own submodules fetch the IHO
+# S-101 catalogues. `submodules: recursive` checks it out at the committed pin, then
+# we float it to the engine's latest main (the pin is just last-known-good).
+# NOTE: correct-by-construction but unvalidated until pushed to GitHub.
 jobs:
   build-test:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v7
+      - name: Checkout chartplotter (+ tile57 engine submodule)
+        uses: actions/checkout@v7
+        with:
+          path: chartplotter
+          submodules: recursive
+      # Keep building against the engine's latest main (floating); the committed
+      # submodule pin is just last-known-good. Move tile57 to origin/main, then
+      # re-sync its nested IHO catalogues to that commit's pins.
+      - name: Float tile57 submodule to latest main
+        run: |
+          git -C chartplotter submodule update --remote tile57
+          git -C chartplotter submodule update --init --recursive tile57
       - uses: actions/setup-go@v6
         with:
           go-version: '1.26'
           cache: true
+          cache-dependency-path: chartplotter/go.sum
+      - name: Install Zig
+        uses: mlugg/setup-zig@v2
+        with:
+          version: 0.16.0
+      - name: Build libtile57
+        run: make -C chartplotter tile57-lib
       - name: Format check
-        run: test -z "$(gofmt -l .)" || (gofmt -l . && exit 1)
+        run: make -C chartplotter fmt-check
       - name: Vet
-        run: go vet ./...
+        run: make -C chartplotter vet
       - name: Test
-        run: go test ./...
+        run: make -C chartplotter test
       - name: Build
-        run: go build ./...
+        run: make -C chartplotter build
 
   govulncheck:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v7
+      - name: Checkout chartplotter (+ tile57 engine submodule)
+        uses: actions/checkout@v7
+        with:
+          path: chartplotter
+          submodules: recursive
+      - name: Float tile57 submodule to latest main
+        run: |
+          git -C chartplotter submodule update --remote tile57
+          git -C chartplotter submodule update --init --recursive tile57
       - uses: actions/setup-go@v6
         with:
           go-version: '1.26'
           cache: true
+          cache-dependency-path: chartplotter/go.sum
+      - name: Install Zig
+        uses: mlugg/setup-zig@v2
+        with:
+          version: 0.16.0
+      - name: Build libtile57
+        run: make -C chartplotter tile57-lib
       - name: Vulnerability scan
-        run: go run golang.org/x/vuln/cmd/govulncheck@latest ./...
+        run: cd chartplotter && go run golang.org/x/vuln/cmd/govulncheck@latest ./...

.github/workflows/docker.yml

@@ -0,0 +1,76 @@
+name: Docker
+
+# Build + publish the multi-arch container image to GHCR. On a v* tag we push the
+# version + `latest`; on main we push `edge` (a rolling pre-release image). The
+# image is a FROM scratch wrapper around the fully-static musl binary (the
+# "go-dims" pattern) — see Dockerfile.
+#
+# Multi-arch is done by zig-cc CROSS-COMPILE inside the builder stage, NOT QEMU:
+# the builder is pinned to the native BUILDPLATFORM and links each TARGETARCH with
+# `zig cc`, so buildx emits linux/amd64 + linux/arm64 from one fast amd64 runner.
+# The engine (public github.com/beetlebugorg/tile57, whose submodules hold the IHO
+# S-101 catalogues) is git-cloned inside the Dockerfile, so no sibling checkout is
+# needed here. Same IHO-embed caveat as the binary releases (accepted — the image
+# embeds the catalogue via libtile57).
+#
+# NOTE: correct-by-construction but UNVALIDATED until a real push runs on GitHub
+# (buildx needs GHCR auth + the runner, neither available locally).
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*"]
+
+permissions:
+  contents: read
+  packages: write
+
+env:
+  IMAGE: ghcr.io/beetlebugorg/chartplotter
+
+jobs:
+  image:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout chartplotter
+        uses: actions/checkout@v7
+
+      - name: Set up QEMU
+        # Only needed so buildx can DECLARE the arm64 platform; the actual build is
+        # a native cross-compile (the builder stage pins --platform=$BUILDPLATFORM),
+        # so no guest code is emulated.
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Derive image tags
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ${{ env.IMAGE }}
+          tags: |
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=raw,value=latest,enable=${{ startsWith(github.ref, 'refs/tags/v') }}
+            type=raw,value=edge,enable=${{ github.ref == 'refs/heads/main' }}
+
+      - name: Build + push (linux/amd64, linux/arm64)
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          platforms: linux/amd64,linux/arm64
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          build-args: |
+            VERSION=${{ github.ref_type == 'tag' && github.ref_name || format('edge-{0}', github.sha) }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

.github/workflows/docs.yml

@@ -11,6 +11,7 @@ on:
       - "web/**"
       - "cmd/**"
       - "internal/**"
+      - "pkg/**"
       - "scripts/fetch-demo-cells.sh"
       - "Makefile"
       - "go.mod"
@@ -27,16 +28,38 @@ concurrency:
   group: pages
   cancel-in-progress: true
 
+# The demo + Chart 1 tiles are baked by the chartplotter binary, which links the
+# native libtile57 engine — so this build needs the ./tile57 engine submodule (its
+# own submodules fetch the IHO S-101 catalogues from the IHO's own repos) and the
+# Zig toolchain, same as ci.yml. `submodules: recursive` checks it out at the
+# committed pin, then it's floated to the engine's latest main (matching go.mod's
+# ./tile57/bindings/go replace).
+# NOTE: correct-by-construction but unvalidated until pushed to GitHub.
 jobs:
   build:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v7
+      - name: Checkout chartplotter (+ tile57 engine submodule)
+        uses: actions/checkout@v7
+        with:
+          path: chartplotter
+          submodules: recursive
+      - name: Float tile57 submodule to latest main
+        run: |
+          git -C chartplotter submodule update --remote tile57
+          git -C chartplotter submodule update --init --recursive tile57
 
       - uses: actions/setup-go@v6
         with:
           go-version: "1.26"
           cache: true
+          cache-dependency-path: chartplotter/go.sum
+      - name: Install Zig
+        uses: mlugg/setup-zig@v2
+        with:
+          version: 0.16.0
+      - name: Build libtile57
+        run: make -C chartplotter tile57-lib
 
       # Cache the curated NOAA demo-cell downloads (one per band over Annapolis),
       # keyed on the cell list / fetch script so a change re-downloads. Lets the
@@ -45,57 +68,52 @@ jobs:
         uses: actions/cache@v6
         with:
           path: ${{ runner.temp }}/demo-cells
-          key: demo-cells-${{ hashFiles('scripts/fetch-demo-cells.sh', 'Makefile') }}
+          key: demo-cells-${{ hashFiles('chartplotter/scripts/fetch-demo-cells.sh', 'chartplotter/Makefile') }}
 
       # Cache the S-52 PresLib "ECDIS Chart 1" source cells (the IHO draft zip is
       # fetched once and extracted), keyed on the fetch script so a change re-pulls.
       - name: Cache PresLib Chart 1 cells
         uses: actions/cache@v6
         with:
           path: ${{ runner.temp }}/preslib-cells
-          key: preslib-cells-${{ hashFiles('scripts/fetch-preslib-cells.sh') }}
+          key: preslib-cells-${{ hashFiles('chartplotter/scripts/fetch-preslib-cells.sh') }}
 
       # Build the read-only widget demo bundle into docs/static/demo so Docusaurus
-      # copies it into the published site at /chartplotter/demo/. Needs the S-101
-      # catalogue (IHO material kept out of the repo): clone it and let `make build`
-      # (a dep of `make demo`) embed it. The bundle is pure static files — no backend.
+      # copies it into the published site at /chartplotter/demo/. The S-101
+      # catalogue is embedded in libtile57 (fetched via the tile57 submodules
+      # above), so no catalogue clone or --s101 override is needed. The bundle is
+      # pure static files — no backend.
       - name: Build live demo bundle (docs/static/demo)
         run: |
-          git clone --depth 1 https://github.com/iho-ohi/S-101_Portrayal-Catalogue.git "$RUNNER_TEMP/s101-pc"
-          git clone --depth 1 https://github.com/iho-ohi/S-101-Documentation-and-FC.git "$RUNNER_TEMP/s101-fc"
-          make demo \
-            S101_PC="$RUNNER_TEMP/s101-pc/PortrayalCatalog" \
-            S101_FC="$RUNNER_TEMP/s101-fc/S-101FC/FeatureCatalogue.xml" \
+          make -C chartplotter demo \
             DEMO_CACHE="$RUNNER_TEMP/demo-cells" \
             DEMO_OUT="docs/static/demo"
 
       # Bake the S-52 "ECDIS Chart 1" reference sheet to tiles into docs/static/chart1
       # (published at /chartplotter/chart1/). The symbol-compliance docs page embeds
-      # it live, reusing the demo bundle's frontend assets. Reuses the S-101 catalogue
-      # cloned above; the source cells come from the IHO PresLib draft (fetched once).
+      # it live, reusing the demo bundle's frontend assets; the source cells come
+      # from the IHO PresLib draft (fetched once).
       - name: Build live Chart 1 tiles (docs/static/chart1)
         run: |
-          make demo-chart1 \
-            S101_PC="$RUNNER_TEMP/s101-pc/PortrayalCatalog" \
-            S101_FC="$RUNNER_TEMP/s101-fc/S-101FC/FeatureCatalogue.xml" \
+          make -C chartplotter demo-chart1 \
             PRESLIB_CACHE="$RUNNER_TEMP/preslib-cells" \
             DEMO_CHART1_OUT="docs/static/chart1"
 
       - uses: actions/setup-node@v6
         with:
           node-version: "20"
           cache: npm
-          cache-dependency-path: docs/package-lock.json
+          cache-dependency-path: chartplotter/docs/package-lock.json
       - name: Install
-        working-directory: docs
+        working-directory: chartplotter/docs
         run: npm ci
       - name: Build
-        working-directory: docs
+        working-directory: chartplotter/docs
         run: npm run build
 
       - uses: actions/upload-pages-artifact@v5
         with:
-          path: docs/build
+          path: chartplotter/docs/build
 
   deploy:
     needs: build