ec012f45b6
Some checks are pending
build-gate / build (push) Waiting to run
Pins keep their navy but gain a white ring and a radius that shrinks as you zoom out, so neighbouring dots separate instead of merging into one blue mass. The Driver asked for rings rather than clustering, explicitly to avoid more logic. The top header no longer carries selection state. That belongs under the filter toggles, in the second header, and nowhere else. The filter menu is anchored to its trigger again. It had been moved to fixed positioning to escape a scroller that was clipping it out of existence, and viewport coordinates go stale in ways that put the menu somewhere unrelated to the box that opened it. A gallery row now carries its identity as an attribute. A Vue key is a reconciliation hint and is never rendered, so the smoke check read undefined and reported a broken deep link on a page that works — measured zero occurrences of that attribute in both the generator and the built page. Asserting on the visible label instead would have coupled a machine check to display text. That repaired gate immediately earned its keep: it caught the gallery asking for assets one directory too deep. The relative asset base was correct while the gallery was the root page and silently wrong once it moved aside for the studio, and the failure surfaced as a JSON parse error rather than a 404, because an unknown path answers with HTML. |
||
|---|---|---|
| .. | ||
| api | ||
| colors | ||
| components | ||
| composables | ||
| constants | ||
| data | ||
| i18n | ||
| layouts | ||
| scripts | ||
| stores | ||
| styles | ||
| utils | ||
| index.js | ||
| ProfileLoader.vue | ||
| README.md | ||
library/ (@map) — the shared map template
The other half of the architecture (see ../plugin-designs/README.md):
every map in plugin-designs/<your-map>/ composes the reusable, parameterized pieces that live here.
Fix something here and every map benefits on the next build; break something here and every map
breaks — read components/WARNING.md before touching shared pieces.
| Folder | What lives there |
|---|---|
ProfileLoader.vue |
The root of every bundle: parses profile-config, loads the profile, provides the stores + config |
components/ |
Shared UI — map, legends, controls, popup (PeopleGroupDetail), tables, charts, hints (README) |
composables/ |
Shared logic — map engine (useMapInstance), provider switch, shadow-DOM styles, theming |
stores/ |
Per-instance Pinia stores (ui / map / data) — provided by ProfileLoader, injected by children |
api/ |
Data-source registry (sources.json) + fetch layer — the JAMstack runtime wiring |
colors/ |
Color sets maps opt into via profile-config.colorSet |
i18n/ |
The shared string catalogs (all maps speak the same languages) |
data/ |
Small shared datasets baked at build time (big served data lives in ../data/) |
constants/ |
Shared constants |
scripts/ |
Maintainer pipelines (posters, research) — not part of any bundle |
The rule of thumb (same as WARNING.md): custom code in your app-profile, reusable code here — and things only move from the first to the second once they've earned it.