Development

npm install
npm test            # unit tests (node --test)
npm run typecheck
npm run package     # builds cte-diff-<version>.vsix

Release: bump version in package.json, add a CHANGELOG.md entry, commit, then run scripts/release.sh.

This site

The site is MkDocs Material, with the landing page in overrides/home.html and the playground page in overrides/playground.html. The landing page's live demo (web/demo.ts) and the playground (web/playground.ts) bundle the extension's own parser and results view (src/cte.ts, src/query.ts, src/results.ts). Both run the extension's SQL over the made-up tables in web/sample.ts: the demo from web/demo-rows.json, generated on DuckDB; the playground live, on DuckDB in the browser (duckdb-wasm).

npm run site:js                        # builds docs/javascripts/playground.js and demo.js
node scripts/demo-rows.ts              # regenerates web/demo-rows.json (needs the duckdb CLI)
python3 -m venv .venv && .venv/bin/pip install -r requirements-docs.txt
.venv/bin/mkdocs serve

.github/workflows/pages.yml builds the site on every pull request and deploys it to GitHub Pages from main.