release: v0.1.4 — VL annotations + layer0 zoom

.gitignore

@@ -17,7 +17,12 @@ build/
 
 # Docs
 site/
+# Staged from core/dist for local zensical; rebuild stages fresh.
+docs/assets/molplot/
 
 # OS / editors
 .DS_Store
 *.log
+
+.tox/
+.venv/

.pre-commit-config.yaml

@@ -1,3 +1,6 @@
+# Managed by prek: `prek install`
+default_install_hook_types: [pre-commit, pre-push]
+
 # Local hooks mirror .github/workflows/ci.yml job-for-job so a green pre-push
 # means a green CI. See CLAUDE.md "Build & test".
 repos:

CLAUDE.md

@@ -47,7 +47,7 @@ on Vega-Lite so a single spec is portable between the browser and matplotlib.
 | Preset compiler | `scripts/build-presets.mjs` |
 | TS chart engine | `core/src/` |
 | TS tests | `core/tests/` |
-| Demo gallery | `page/src/` |
+| Web Component example | `example/src/` |
 | Python package | `python/src/molplot/` |
 | Python tests | `python/tests/` |
 | Docs | `docs/` |
@@ -57,24 +57,24 @@ on Vega-Lite so a single spec is portable between the browser and matplotlib.
 ```bash
 npm install
 npm run build:presets    # regenerate generated preset artifacts from presets/*.json
-npm run dev              # demo gallery at localhost:3000 (alias of dev:page)
+npm run dev              # Web Component example at localhost:3000
 npm run build:core       # rslib → core/dist (npm publish artifact)
-npm run typecheck        # core + page
+npm run typecheck        # core + example
 npm test                 # core (rstest, node) + python (pytest)
 npm run lint             # biome check --write
 cd python && pytest      # python only
 ```
 
 ## Monorepo structure
 
-npm workspaces: `["core", "page"]`. `python/` is a separate hatchling package
-(not an npm workspace). `page/` bundles `@molcrafts/molplot` from **source** via
+npm workspaces: `["core", "example"]`. `python/` is a separate hatchling package
+(not an npm workspace). `example/` bundles `@molcrafts/molplot` from **source** via
 an rsbuild alias; each package's `dist/` is for publish only.
 
 | Package | Path | Purpose |
 |---------|------|---------|
 | `@molcrafts/molplot` | `core/` | Vega-Lite chart classes + spec builders + theme |
-| `page` | `page/` | React 19 demo gallery |
+| `example` | `example/` | React 19 Web Component playground |
 | `molcrafts-molplot` (PyPI) | `python/` | scienceplots wrapper + VL→matplotlib renderer |
 
 ## Critical invariants

README.md

@@ -27,7 +27,7 @@ molplot/
 ├── presets/            # canonical design tokens (single source of truth) + JSON schema
 ├── scripts/            # build-presets.mjs — compiles presets → per-package artifacts
 ├── core/               # @molcrafts/molplot — Vega-Lite chart classes (TypeScript)
-├── page/               # demo gallery (React 19 + rsbuild)
+├── example/            # Web Component example (React 19 + rsbuild)
 ├── python/             # molcrafts-molplot — scienceplots wrapper + VL→matplotlib
 └── docs/               # zensical docs
 ```
@@ -62,8 +62,8 @@ fig, ax = molplot.render(spec)               # same spec → matplotlib figure
 ```bash
 npm install
 npm run build:presets    # regenerate preset artifacts from presets/*.json
-npm run dev:page         # demo gallery at localhost:3000
-npm run typecheck        # core + page
+npm run dev:example      # Web Component example at localhost:3000
+npm run typecheck        # core + example
 npm test                 # core (rstest) + python (pytest)
 npm run lint             # biome
 ```
@@ -72,6 +72,25 @@ The generated preset files (`core/src/presets/generated.ts`,
 `python/src/molplot/presets/*`) are committed and guarded in CI — run
 `npm run build:presets` after editing any `presets/*.json` and commit the result.
 
+## Documentation
+
+Full manual: [docs.molcrafts.org/molplot](https://docs.molcrafts.org/molplot/)
+(sources in [`docs/`](docs/)):
+
+- [Getting started](https://docs.molcrafts.org/molplot/getting-started/)
+- [Unified preset](https://docs.molcrafts.org/molplot/getting-started/preset/)
+- [Web (Vega-Lite)](https://docs.molcrafts.org/molplot/getting-started/web/)
+- [Python (scienceplots)](https://docs.molcrafts.org/molplot/getting-started/python/)
+- [Charts in Markdown](https://docs.molcrafts.org/molplot/getting-started/markdown/)
+- [API reference](https://docs.molcrafts.org/molplot/api/)
+
+```bash
+# local preview
+pip install -e ./python  # or: pip install molcrafts-molplot
+pip install "zensical>=0.0.53" "molcrafts-zensical-theme>=0.2.5"
+zensical serve
+```
+
 ## License
 
 BSD-3-Clause

biome.json

@@ -9,6 +9,8 @@
       "!**/.rslib",
       "!**/out",
       "!**/site",
+      "!**/docs/assets",
+      "!**/.cache",
       "!**/*.css",
       "!**/presets/generated.ts"
     ]

core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molcrafts/molplot",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "type": "module",
   "exports": {
     ".": {

core/rslib.config.ts

@@ -7,6 +7,7 @@ export default defineConfig({
       bundle: false,
       dts: true,
       source: {
+        // Sources only (`tests/` lives outside; do not put `*.test.ts` under src/).
         entry: { index: "./src/**" },
       },
       output: {