add interactive WebAssembly quantum textbook

.github/workflows/ci.yml

@@ -105,4 +105,4 @@ jobs:
       - name: Gosec
         uses: securego/gosec@master
         with:
-          args: -exclude=G115,G404 -exclude-dir=backend/braket -exclude-dir=observe/otelbridge -exclude-dir=observe/prombridge ./...
+          args: -exclude=G115,G404 -exclude-dir=backend/braket -exclude-dir=observe/otelbridge -exclude-dir=observe/prombridge -exclude-dir=textbook/wasm ./...

.github/workflows/textbook.yml

@@ -0,0 +1,33 @@
+name: Textbook
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "textbook/**"
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-go@v5
+        with:
+          go-version: "1.24"
+
+      - name: Build WASM
+        run: |
+          cp "$(go env GOROOT)/lib/wasm/wasm_exec.js" textbook/wasm_exec.js
+          cd textbook/wasm && GOOS=js GOARCH=wasm go build -ldflags="-w -s" -o ../main.wasm .
+
+      - name: Deploy to GitHub Pages
+        uses: peaceiris/actions-gh-pages@v4
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: ./textbook
+          exclude_assets: ".github,wasm"

.gitignore

@@ -33,3 +33,7 @@ go.work.sum
 
 # Claude
 docs/
+
+# Textbook build artifacts
+textbook/main.wasm
+textbook/wasm_exec.js

Makefile

@@ -1,4 +1,4 @@
-.PHONY: test test-race test-all lint vet fuzz bench bench-gpu-cuda test-gpu-cuda coverage clean hooks
+.PHONY: test test-race test-all lint vet fuzz bench bench-gpu-cuda test-gpu-cuda coverage clean hooks textbook textbook-serve textbook-clean
 
 test:
 	go test -count=1 -timeout=5m ./...
@@ -63,3 +63,14 @@ hooks:
 clean:
 	rm -f coverage.out coverage.html
 	go clean -testcache
+
+textbook:
+	cp "$$(go env GOROOT)/lib/wasm/wasm_exec.js" textbook/wasm_exec.js
+	cd textbook/wasm && GOOS=js GOARCH=wasm go build -ldflags="-w -s" -o ../main.wasm .
+
+textbook-serve: textbook
+	@echo "Serving textbook at http://localhost:8080"
+	python3 -m http.server 8080 -d textbook
+
+textbook-clean:
+	rm -f textbook/main.wasm textbook/wasm_exec.js

README.md

@@ -59,7 +59,7 @@ Requires Go 1.24+.
 | Pulse Programming | OpenPulse model, waveforms, defcal |
 | Noise Modeling | Kraus operators, device noise models, depolarizing/amplitude-damping channels |
 | Observability | Zero-dep hooks + OpenTelemetry and Prometheus bridges |
-| Education | 20 Jupyter notebooks from qubits to Shor's algorithm (Go kernel via [gonb](https://github.com/janpfeifer/gonb)) |
+| Education | Textbook from qubits to Shor's algorithm (Go via [gonb](https://github.com/janpfeifer/gonb)) |
 
 ```
 q0: ─H───@──
@@ -70,8 +70,7 @@ q1: ─────X──
 ## Documentation
 
 - [API Reference](https://pkg.go.dev/github.com/splch/goqu)
-- [Notebooks](notebooks/)
-- [Benchmarks](https://splch.github.io/goqu/dev/bench/)
+- [Textbook](https://splch.github.io/goqu/)
 
 ## Contributing