History

doxa-maps-88655c70 18b3366c2b Regenerate the library index, which had fallen a day behind check:library-index was FAILING: the derived menu was 70,718 seconds — about 19.6 hours — older than library/composables/useMapFly.js, which this flight edited to give fitBounds an explicit duration. The file's own header says "DERIVED — cannot drift from the code", which is only true of a file that gets regenerated, and nothing had regenerated it. The regeneration added one entry, and it is not cosmetic: viewportScrim.js was missing from the index entirely while being imported by six files — PosterDialog, SemanticTreeLegend, PosterWall, DataTable, LegendTools and my-upg-100-list/poster-wall. A real, widely-used utility that an inheritor reading the library menu could not discover. 85 reusable items now catalogued. Measured the wider hygiene question while here, since the standing work list asks for non-reusable components to be demoted out of the shared zone: of the 82 items the index advertises, exactly ONE has zero code importers — useMapSelection.js. The other 81 are live. So the shared library is in good shape and there is no demotion sweep to run. The first measurement said fifteen components were unused, and it was wrong in a way worth recording. It counted importers among BUNDLES only, so anything imported by a sibling library component read as dead — PosterPreview.vue has five importers and would have been demoted. Counting importers anywhere, not just in plugin-designs/, is what reduced fifteen candidates to one. useMapSelection is left in place deliberately, because removing a file from the shared zone is a different kind of change from regenerating a derived doc and deserves its own commit. It is carded instead. Worth knowing before that decision: it is 192 lines, unchanged since the initial commit `d5ba21f`, so it was never adopted rather than orphaned by a refactor; its one dependency (getCircleRadiusInterpolation) still resolves, so it is dead rather than broken; and it appears in zero of the nineteen built bundles, which is the decisive evidence since Vite would tree-shake exactly this.		2026-09-23 07:16:13 +00:00
..
architecture	Document why a gate cannot import plugin source, and stop teaching public binds	2026-09-22 17:40:11 +00:00
assets	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
contributing	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
readme-images	Name the UPG-100 legend's tabs, instead of shipping the placeholder	2026-09-23 06:52:18 +00:00
screenshots	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
CONTRIBUTING.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
develop-a-plugin-and-see-it-live.md	Hand an inheritor a token that works, and stop claiming one is present without checking	2026-09-23 04:09:07 +00:00
explanation.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
how-to.md	Land the swarm's work: no iframes anywhere, a tree that keeps its shape, deeper facets	2026-09-22 14:51:52 +00:00
README-embed-example.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
README-longform.md	Say which embed targets we actually verified, and which we only expect to work	2026-09-23 05:33:51 +00:00
README-SECTION-3-cli-commands.md	Check that the CLI doc still quotes package.json correctly	2026-09-23 04:19:42 +00:00
README.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
reference-capability-exemplars.md	Give nested ProfileLoader children the profile-config they require	2026-09-22 09:37:35 +00:00
reference-library-index.md	Regenerate the library index, which had fallen a day behind	2026-09-23 07:16:13 +00:00
reference.md	Fix the same broken token command in reference.md, and say only what was measured	2026-09-23 04:13:45 +00:00
slide-deck-outline.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
tutorial.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00
why.md	consolidate docs into documentation/ and deployment shells into deployment/	2026-09-21 23:23:23 +00:00

README.md

documentation/ — pick your path

        "what is this?"          "teach me"        "how do I …?"       "look it up"      "all the detail"
             │                       │                   │                  │                  │
         why.md  ──────────►  tutorial.md  ────►  how-to.md  ────►  reference.md  ───►  architecture/
        (2 min, 1 diagram)   (first map)         (task recipes)     (tables)           (contracts)

why.md — the problem and the "map islands" idea. Start here.
tutorial.md — build your first map, no jargon.
how-to.md — recipes: embed, iframe, SPA, colors, CDN, mobile, tokens.
reference.md — config fields, build scripts, the profile-config contract.
explanation.md — the model in 15 lines.
architecture/ — the deep end: full contracts, the per-file catalog.
README-embed-example.md — the drop-in README used when this bundler is embedded inside a host repo.

Nothing on the simple path is longer than a few minutes; everything complex lives in architecture/, linked from where you'd need it.