Remove hash based code and use Pyodide/WASM

Author: johnsamuelwrites

.github/workflows/deploy.yml

@@ -1,18 +1,12 @@
 # Deploy multilingual docs to GitHub Pages.
 #
-# This workflow replaces GitHub's default Jekyll deployment so we can:
-#   1. Build the browser WASM bundle from demo.ml via WATCodeGenerator.
-#      `multilingual build-wasm-bundle demo.ml` emits:
-#        - module.wat        (WebAssembly Text — educational display in docs)
-#        - module.wasm       (binary — executed in the browser REPL)
-#        - host_shim.js      (JS host import stubs for print_str, print_f64, …)
-#        - abi_manifest.json (ABI metadata)
-#   2. Copy all bundle artifacts into assets/wasm/.
-#   3. Build the Jekyll site.
-#   4. Deploy _site/ to GitHub Pages.
+# Jobs:
+#   1. test-blocks  — verify every executable doc code block runs correctly.
+#   2. build-jekyll — build the Jekyll site.
+#   3. deploy       — publish _site/ to GitHub Pages.
 #
-# The build is purely Python-driven (multilingualprogramming[wasm]).
-# No Rust toolchain or wasm-pack is required.
+# The interactive REPL and inline Run buttons execute code client-side via
+# Pyodide (ProgramExecutor), so no server-side WASM bundle is required.
 #
 # Trigger: every push to main, or manually via workflow_dispatch.
 
@@ -57,112 +51,26 @@ jobs:
           cache:          pip
           cache-dependency-path: multilingual-src/pyproject.toml
 
-      - name: Install multilingual with WASM extras
+      - name: Install multilingual
         working-directory: multilingual-src
-        run: pip install -e ".[dev,wasm]"
-
-      - name: Install wabt (wat2wasm, wasm-validate)
-        run: sudo apt-get install -y wabt
+        run: pip install -e ".[dev]"
 
       - name: Install pytest
         run: pip install pytest
 
       - name: Run code-block tests
         run: pytest _tests/ -v --tb=short
 
-  # ── Job 2: Build WASM ────────────────────────────────────────────────────
-  build-wasm:
-    name: Build WASM browser bundle
-    runs-on: ubuntu-latest
-    needs: test-blocks
-
-    steps:
-      - name: Checkout docs repo (for demo.ml)
-        uses: actions/checkout@v4
-
-      - name: Checkout multilingual source
-        uses: actions/checkout@v4
-        with:
-          repository: johnsamuelwrites/multilingual
-          path:       multilingual-src
-
-      - name: Set up Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: '3.12'
-          cache:          pip
-          cache-dependency-path: multilingual-src/pyproject.toml
-
-      - name: Install multilingual with WASM extras
-        working-directory: multilingual-src
-        run: pip install -e ".[dev,wasm]"
-
-      # wabt must be installed before the bundle build so wat2wasm is
-      # available to assemble the WAT text → WASM binary.
-      - name: Install wabt (wat2wasm, wasm-validate, wasm2wat)
-        run: sudo apt-get install -y wabt
-
-      - name: Build browser WASM bundle from demo.ml
-        run: |
-          # WATCodeGenerator compiles demo.ml → WAT text (module.wat).
-          # Additional artifacts: host_shim.js, abi_manifest.json
-          mkdir -p wasm-out
-          multilingual build-wasm-bundle demo.ml --out-dir wasm-out
-
-      - name: Assemble and validate demo WASM binary
-        run: |
-          # Assemble the canonical WAT text into a binary.
-          # This works whether build-wasm-bundle emits .wasm or not;
-          # we always produce the binary from the WAT source of truth.
-          wat2wasm wasm-out/module.wat -o wasm-out/module.wasm
-          wasm-validate wasm-out/module.wasm
-
-      - name: Stage all WASM artifacts under assets/wasm/
-        run: |
-          # Collect everything into assets/wasm/ so the artifact layout
-          # matches the Jekyll source tree exactly.
-          mkdir -p assets/wasm/blocks
-          # Rename module.* → multilingual.* and move into assets/wasm/
-          mv wasm-out/module.wasm       assets/wasm/multilingual.wasm
-          mv wasm-out/module.wat        assets/wasm/multilingual.wat
-          mv wasm-out/host_shim.js      assets/wasm/host_shim.js
-          mv wasm-out/abi_manifest.json assets/wasm/abi_manifest.json
-          # Per-block binaries compiled in the next step land in assets/wasm/blocks/
-
-      - name: Compile per-block WASM binaries
-        run: |
-          # Each executable code block in the docs gets its own WASM binary,
-          # keyed by SHA-256 hash of its content, stored in assets/wasm/blocks/.
-          # The browser Run button fetches the per-block binary and executes it,
-          # falling back to the demo binary if a block wasn't compiled.
-          python _scripts/compile_blocks.py
-
-      - name: Upload WASM artefacts
-        uses: actions/upload-artifact@v4
-        with:
-          name: wasm-pkg
-          path: assets/wasm/
-          retention-days: 1
-
-  # ── Job 3: Build Jekyll ───────────────────────────────────────────────────
+  # ── Job 2: Build Jekyll ───────────────────────────────────────────────────
   build-jekyll:
     name: Build Jekyll site
     runs-on: ubuntu-latest
-    needs: build-wasm
+    needs: test-blocks
 
     steps:
       - name: Checkout docs repo
         uses: actions/checkout@v4
 
-      - name: Download WASM artefacts
-        uses: actions/download-artifact@v4
-        with:
-          name: wasm-pkg
-          path: assets/wasm/
-        # Downloaded layout (relative to repo root):
-        #   assets/wasm/multilingual.wasm, multilingual.wat, …
-        #   assets/wasm/blocks/<hash16>.wasm  (one per compiled code block)
-
       - name: Set up Ruby
         uses: ruby/setup-ruby@v1
         with:
@@ -180,15 +88,12 @@ jobs:
           JEKYLL_ENV: production
         run: bundle exec jekyll build --baseurl "${{ steps.pages.outputs.base_path }}"
 
-      - name: Inject block hashes into built HTML
-        run: python _scripts/inject_hashes.py
-
       - name: Upload Pages artefact
         uses: actions/upload-pages-artifact@v3
         with:
           path: _site/
 
-  # ── Job 4: Deploy ─────────────────────────────────────────────────────────
+  # ── Job 3: Deploy ─────────────────────────────────────────────────────────
   deploy:
     name: Deploy to GitHub Pages
     runs-on: ubuntu-latest