umlimator 0.16.0 → 0.17.0

package/README.md

@@ -65,7 +65,7 @@ drill-down, a data pipeline, an AI agent's skills, and host pages for embedding,
 npm install umlimator
 ```
 
-Or from GitHub, at a tag or any commit: `"umlimator": "github:zintaen/umlimator#v0.16.0"`. npm 12 refuses git
+Or from GitHub, at a tag or any commit: `"umlimator": "github:zintaen/umlimator#v0.17.0"`. npm 12 refuses git
 dependencies unless the project opts in, so that also needs `allow-git=root` in the `.npmrc` next to `package.json`.
 
 ## Embed
@@ -189,6 +189,9 @@ A model has shared `nodes` and `edges`, and `views` that each show a subset, wit
 path. The full schema is `engine/references/schema.md` (§ Map model); `examples/bookshop.json` uses most of it.
 A model file that starts with `"$schema": "<path to>/umlimator.schema.json"` (exported as `umlimator/schema.json`)
 gets completion and checks in editors, and `validate(model)` lists its errors and warnings, each with where it is.
+`"schemaVersion": 2` marks a model that may hold typed elements and typed views (`docs/diagrams/model.md`); none is
+drawn as such yet: a typed view shows its nodes as plain cards, with a warning. A model with no `schemaVersion` is a
+map, as always, and a version newer than the module reads is an error.
 
 Card kinds: `frontend`, `backend`, `ai`, `database`, `queue`, `security`, `cloud`, `external` and `file` (skill-map
 kinds such as `public`, `lane`, `script`, `hook` and `board` work too). Fields beyond the schema:
@@ -299,7 +302,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: zintaen/umlimator@v0.16.0
+      - uses: zintaen/umlimator@v0.17.0
         with:
           models: "docs/*.json"   # optional: where the models are (default: every .json that is a map model)
 ```
@@ -371,6 +374,7 @@ With `UMLIMATOR_OFFLINE=1` the CLI fetches nothing: a logo not in the cache keep
 ## Development
 
 ```bash
+npm run build               # src/ into lib/umlimator.js and lib/umlimator-all.js: edit the sources, commit all three
 node --test                 # layout() in Node: the bench views' geometry and the layout rules
 python3 tests/embed.py      # render() in headless Chrome: events, keyboard, colours, contrast, editing, the element
 python3 bench/bench.py --check-determinism --expect bench/expected.json --max-ms m50=2000
@@ -379,7 +383,8 @@ python3 bench/bench.py --check-determinism --expect bench/expected.json --max-ms
 The bench lays out fixed models (10 to 69 cards, and 50 modules with 100 lines) in headless Chrome and reports the
 time per phase, the layout check's issues and a hash of the geometry. `--expect` fails on a view that no longer draws as
 recorded in `bench/expected.json`; a change that moves lines on purpose refreshes it with `--write-expected`. CI runs
-all of the above, and checks that the files copied from upstream (`engine/scripts`, `engine/references`,
+all of the above, fails when `lib/umlimator.js` is not what `src/` builds or a source uses a name it does not import,
+and checks that the files copied from upstream (`engine/scripts`, `engine/references`,
 `tools/fetch_icons.py`) are unmodified.
 
 To release, bump `package.json`'s version in a PR and add that version's `## X.Y.Z: …` section to
@@ -392,7 +397,8 @@ umlimator.py                 CLI: render, stills, check, record, pdf, pin-icons,
 umlimator_import.py          import's readers: Structurizr DSL, C4-PlantUML, Mermaid, compose and Kubernetes JSON
 umlimator_mcp.py             the MCP server that `umlimator.py mcp` runs
 action.yml                   the diff Action: what a pull request changes in its maps, posted on it
-lib/                         the module (umlimator.js), its types, the default theme, <umlimator-map> and the docs plugins
+src/                         the module's sources, by layer: core, draw, layout, map, canvas, page (tools/build.mjs joins them)
+lib/                         the module (umlimator.js; umlimator-all.js with every diagram family; both built and committed), its types, the default theme, <umlimator-map> and the docs plugins
 engine/                      the page templates the CLI inlines the module into; the upstream renderer and schema
 docs/                        the module's API and the editing design; docs/diagrams/: the plan for 28 diagram types (not built yet)
 tests/, bench/               tests, benchmark models and results

package/THIRD_PARTY_NOTICES.md

@@ -10,7 +10,7 @@ umlimator contains, or builds on, the work below. Each entry says what is used a
 
 ## EricTechPro/super-board, `/visual` skill
 
-`lib/umlimator.js` and `engine/assets/template.html` derive from super-board's `skills/visual/assets/template.html`
+`src/` (built into `lib/umlimator.js`) and `engine/assets/template.html` derive from super-board's `skills/visual/assets/template.html`
 at commit `d0b7d5a` (29 Oct 2026), modified by umlimator (the changes are in its git history and `docs/module-api.md`);
 `engine/scripts/visual.py` and `engine/references/` are copied from that commit unmodified. Source:
 https://github.com/EricTechPro/super-board