feat: WASM SDK docs, demo integration, site updates (#10)

* demo: ux improvements - drop zone, loading overlay, web worker parse, Line/LineArt off by default

* demo: non-blocking markdown/html rendering via worker + render cache

* chore: clean root PNGs and add /*.png to .gitignore

* feat: add WASM SDK docs, demo integration, and site updates

- Add docs/09-wasm-sdk.md with objectives, advantages, API ref, and use cases
- Update README.md with WebAssembly SDK section, features, and project layout
- Add site pages: quick-start-wasm, api/wasm, guides/wasm-use-cases
- Add WebAssembly tab to site landing page QuickStart
- Add Live Demo link to site hero and footer
- Integrate demo/ build into site/public/demo/ for GitHub Pages
- Update deploy-site workflow to build demo before site
- Add DEMO_BASE_PATH env var to demo vite config for /demo/ base path

Author: raphaelmansuy

.github/workflows/deploy-site.yml

@@ -6,6 +6,8 @@ on:
       - main
     paths:
       - 'site/**'
+      - 'demo/**'
+      - 'crates/edgeparse-wasm/pkg/**'
       - '.github/workflows/deploy-site.yml'
   workflow_dispatch:
 
@@ -43,6 +45,18 @@ jobs:
         working-directory: site
         run: pnpm install --frozen-lockfile
 
+      - name: Build demo app
+        working-directory: demo
+        run: |
+          npm ci
+          DEMO_BASE_PATH=/demo/ npx vite build
+
+      - name: Copy demo into site
+        run: |
+          rm -rf site/public/demo
+          mkdir -p site/public/demo
+          cp -r demo/dist/* site/public/demo/
+
       - name: Build site
         working-directory: site
         run: pnpm run build

.gitignore

@@ -45,3 +45,6 @@ examples/output/
 mission/
 logs/
 .playwright-mcp/
+
+# Root-level screenshots (use site/public/ or docs/ for committed images)
+/*.png

.vite/deps/_metadata.json

@@ -0,0 +1,8 @@
+{
+  "hash": "f05f3447",
+  "configHash": "86da36e8",
+  "lockfileHash": "e3b0c442",
+  "browserHash": "82f036c2",
+  "optimized": {},
+  "chunks": {}
+}

.vite/deps/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

Cargo.lock

@@ -6,6 +6,7 @@ members = [
     "crates/pdf-cos",
     "crates/edgeparse-python",
     "crates/edgeparse-node",
+    "crates/edgeparse-wasm",
 ]
 default-members = [
     "crates/edgeparse-core",
@@ -24,7 +25,7 @@ description = "EdgeParse — High-performance PDF-to-structured-data extraction
 [workspace.dependencies]
 # PDF parsing (local fork of lopdf 0.39.0, renamed pdf-cos for clarity)
 # Using package alias so all existing `use lopdf::...` code works unchanged.
-lopdf = { package = "pdf-cos", path = "crates/pdf-cos", version = "0.39.0" }
+lopdf = { package = "pdf-cos", path = "crates/pdf-cos", version = "0.39.0", default-features = false }
 pdf-extract = "0.10.0"
 
 # CLI

Cargo.toml

@@ -506,6 +506,30 @@ publish-brew: ## Generate Homebrew formula and push to $(BREW_TAP_REPO)
 publish-all: publish-rust publish-python publish-node publish-cli publish-brew ## Publish everything: Rust crates + Python wheels + Node.js packages + CLI binaries + Homebrew formula
 	$(call ok,All SDKs + CLI + Homebrew tap published)
 
+# ══════════════════════════════════════════════════════════════════════════════
+## WASM
+# ══════════════════════════════════════════════════════════════════════════════
+
+WASM_CRATE := crates/edgeparse-wasm
+
+wasm-build: ## Build WASM package (release, --target web)
+	$(call info,Building WASM package...)
+	@cd $(WASM_CRATE) && wasm-pack build --target web --release --scope edgeparse
+	$(call ok,WASM package built → $(WASM_CRATE)/pkg/)
+
+wasm-check: ## Check WASM compilation (fast, no codegen)
+	$(call info,Checking WASM compilation...)
+	@cargo check --target wasm32-unknown-unknown -p edgeparse-wasm
+	$(call ok,WASM check passed)
+
+wasm-size: wasm-build ## Show WASM binary size
+	@echo "Raw WASM size:"
+	@du -h $(WASM_CRATE)/pkg/edgeparse_wasm_bg.wasm
+
+wasm-clean: ## Remove WASM build artefacts (pkg/)
+	$(call warn,Removing $(WASM_CRATE)/pkg/ ...)
+	@rm -rf $(WASM_CRATE)/pkg/
+
 # ══════════════════════════════════════════════════════════════════════════════
 ## Clean
 # ══════════════════════════════════════════════════════════════════════════════