@diagrammo/dgmo 0.65.0 → 0.66.0

package/dist/advanced.d.ts

@@ -1,12 +1,14 @@
-import { a as DgmoError, P as PaletteConfig, T as TagGroup, f as PaletteColors, C as CompactViewState, k as TagEntry } from './dgmo-router-Dd5PTjxl.js';
-export { l as CHART_TYPE_DESCRIPTIONS, b as ChartTypeId, c as ChartTypeMeta, m as DecodedDiagramUrl, d as DgmoSeverity, n as EncodeDiagramUrlOptions, o as EncodeDiagramUrlResult, R as RenderCategory, q as autoTagColorCycle, s as chartTypeParsers, g as chartTypes, t as decodeDiagramUrl, u as decodeViewState, v as encodeDiagramUrl, w as encodeViewState, i as formatDgmoError, x as getAllChartTypes, y as getAvailablePalettes, j as getPalette, z as getRenderCategory, A as isExtendedChartType, B as isValidHex, F as knownChartTypeIds, G as makeDgmoError, p as parseDgmo, H as parseDgmoChartType, I as registerPalette, J as tagAttrKey, p as validate } from './dgmo-router-Dd5PTjxl.js';
-import { M as MapDataSource, P as ParsedMap, c as MapData, j as ResolvedMap, k as MapLayoutLegend, l as GeoExtent } from './themes-DiUAG4Bf.js';
-export { A as AirportData, B as BoundaryTopology, G as Gazetteer, a as GazetteerEntry, b as MapCompletionOptions, m as MapDirectives, n as MapEdge, d as MapLocationMatch, e as MapPlaceCompletion, o as MapPoi, q as MapRegion, f as MapRegionCompletion, r as MapRoute, u as PoiPos, v as ProjectionFamily, R as RegionName, g as RegionNames, w as ResolvedEdge, x as ResolvedPoi, y as ResolvedRegion, z as ResolvedRoute, T as Theme, h as completeMapPlaces, i as completeMapRegions, p as palettes, C as renderForExport, s as searchMapLocations, t as themes } from './themes-DiUAG4Bf.js';
+import { D as DgmoError, P as PaletteConfig, T as TagGroup, a as PaletteColors, C as CompactViewState, g as TagEntry } from './tag-groups-NUA2F1I5.js';
+export { h as DecodedDiagramUrl, c as DgmoSeverity, i as EncodeDiagramUrlOptions, j as EncodeDiagramUrlResult, k as autoTagColorCycle, l as decodeDiagramUrl, m as decodeViewState, n as encodeDiagramUrl, o as encodeViewState, f as formatDgmoError, p as makeDgmoError, t as tagAttrKey } from './tag-groups-NUA2F1I5.js';
+import { M as MapDataSource, P as ParsedMap, b as MapData, d as ResolvedMap, e as MapLayoutLegend, f as GeoExtent } from './d3-Bfhj-XBX.js';
+export { A as AirportData, B as BoundaryTopology, G as Gazetteer, a as GazetteerEntry, g as MapDirectives, h as MapEdge, i as MapPoi, j as MapRegion, k as MapRoute, l as PoiPos, m as ProjectionFamily, R as RegionName, c as RegionNames, n as ResolvedEdge, o as ResolvedPoi, p as ResolvedRegion, q as ResolvedRoute, r as renderForExport } from './d3-Bfhj-XBX.js';
+export { b as CHART_TYPE_DESCRIPTIONS, C as ChartTypeId, a as ChartTypeMeta, R as RenderCategory, d as chartTypeParsers, c as chartTypes, e as getAllChartTypes, f as getAvailablePalettes, g as getPalette, h as getRenderCategory, i as isExtendedChartType, j as isValidHex, k as knownChartTypeIds, p as parseDgmo, l as parseDgmoChartType, m as registerPalette, p as validate } from './dgmo-router-EAW7XiBE.js';
 import { Selection } from 'd3-selection';
 import * as d3Scale from 'd3-scale';
-import { P as ParsedOrg, F as FillMode, R as RaciMarker, a as ParsedRaci, b as RaciVariant, c as RaciTask } from './chart-meta-D98NbYDp.js';
-export { A as ALL_CHART_TYPES, I as ImportSource, O as OrgNode, d as RaciPhase, e as RaciRoleAssignment, f as ReadFileFn, g as ResolveImportsResult, h as contrastText, i as getSeriesColors, j as hexToHSL, k as hexToHSLString, l as hslToHex, m as mix, n as normalizePertSourceForShare, p as parseFirstLine, o as parseOrg, q as parseRaci, r as resolveOrgImports, s as shade, t as shapeFill, u as tint } from './chart-meta-D98NbYDp.js';
+import { P as ParsedOrg, F as FillMode, R as RaciMarker, a as ParsedRaci, b as RaciVariant, c as RaciTask } from './chart-meta-CpicJ1kj.js';
+export { A as ALL_CHART_TYPES, I as ImportSource, O as OrgNode, d as RaciPhase, e as RaciRoleAssignment, f as ReadFileFn, g as ResolveImportsResult, h as contrastText, i as getSeriesColors, j as hexToHSL, k as hexToHSLString, l as hslToHex, m as mix, n as normalizePertSourceForShare, p as parseFirstLine, o as parseOrg, q as parseRaci, r as resolveOrgImports, s as shade, t as shapeFill, u as tint } from './chart-meta-CpicJ1kj.js';
 import { GeoProjection } from 'd3-geo';
+export { M as MapCompletionOptions, a as MapLocationMatch, b as MapPlaceCompletion, c as MapRegionCompletion, T as Theme, d as completeMapPlaces, e as completeMapRegions, p as palettes, s as searchMapLocations, t as themes } from './themes-Dem5xalq.js';
 
 /**
  * Stable diagnostic codes for in-arrow label parsing errors.

package/dist/advanced.js

@@ -79,18 +79,18 @@ import {
 import {
   renderMap,
   renderMapForExport
-} from "./chunk-QRWY5QTA.js";
+} from "./chunk-O274UTXH.js";
 import "./chunk-FWVKPEG3.js";
 import {
   mapContentAspect,
   mapExportDimensions
-} from "./chunk-PZOFMBF3.js";
+} from "./chunk-X26BF4T2.js";
 import {
   albersSkewFallback,
   layoutMap,
   mapBackgroundColor,
   mapNeutralLandColor
-} from "./chunk-6E5YZR4S.js";
+} from "./chunk-R7S5542V.js";
 import {
   decodeFeatures,
   regionAt
@@ -313,7 +313,7 @@ import {
   renderSlopeChart,
   renderVenn,
   renderWordCloud
-} from "./chunk-ZZXPYVS4.js";
+} from "./chunk-3OT63FS4.js";
 import "./chunk-7L53J53J.js";
 import "./chunk-EOYPX6SF.js";
 import {

package/dist/block.d.ts

@@ -1,3 +1,6 @@
+import { M as MapDataSource } from './d3-Bfhj-XBX.js';
+import './tag-groups-NUA2F1I5.js';
+
 /**
  * Canonical stylesheet for the standard DGMO embed block (BL-114).
  *
@@ -106,6 +109,20 @@ interface DgmoBlockOptions {
      * trusted, since these end up in markup verbatim.
      */
     dataAttributes?: Record<string, string>;
+    /**
+     * Map basemap assets, forwarded to `render()`. Without them a ` ```dgmo `
+     * fence containing a map emits the error card ("This map has no basemap
+     * data") — this module reads nothing from disk or the network on its own,
+     * and it has no environment default, because it runs in browsers as much as
+     * in build scripts.
+     *
+     * A Node host (a remark build, a static-site generator, a report writer)
+     * passes `loadMapData` from `@diagrammo/dgmo/advanced` — as the FUNCTION, so
+     * the eleven basemap JSON files are read only for a fence that turns out to
+     * be a map. A browser host supplies the data itself, or a loader that
+     * fetches it.
+     */
+    mapData?: MapDataSource;
     /** Receives palette-fallback warnings. Default: console.warn. */
     onWarn?: (message: string) => void;
 }
@@ -139,4 +156,4 @@ declare function buildDgmoBlockHtml(source: string, svgsHtml: string, options?:
  */
 declare function errorBlockHtml(err: unknown, source: string, options?: Pick<DgmoBlockOptions, 'className' | 'legacyClassNames'>): string;
 
-export { BLOCK_CSS, type BlockColorMode, type BlockMode, type DgmoBlockOptions, type DgmoBlockResult, EDITOR_BASE_URL, buildDgmoBlockHtml, errorBlockHtml, renderDgmoBlock };
+export { BLOCK_CSS, type BlockColorMode, type BlockMode, type DgmoBlockOptions, type DgmoBlockResult, EDITOR_BASE_URL, MapDataSource, buildDgmoBlockHtml, errorBlockHtml, renderDgmoBlock };

package/dist/block.js

@@ -4,7 +4,7 @@ import {
 } from "./chunk-D3K4U3ZM.js";
 import {
   render
-} from "./chunk-ZZXPYVS4.js";
+} from "./chunk-3OT63FS4.js";
 import {
   docsLink,
   renderErrorCard
@@ -1052,6 +1052,7 @@ function resolveBlockOptions(opts) {
     legacyClassNames: opts.legacyClassNames ?? [],
     dataAttributes: opts.dataAttributes ?? {},
     title: opts.title,
+    mapData: opts.mapData,
     onWarn: opts.onWarn ?? ((message) => console.warn(message))
   };
 }
@@ -1062,7 +1063,11 @@ async function renderDgmoBlock(source, options = {}) {
   const diagnostics = [];
   let chartType;
   const renderTheme = async (theme) => {
-    const r = await render(trimmed, { palette: palette.id, theme });
+    const r = await render(trimmed, {
+      palette: palette.id,
+      theme,
+      ...opts.mapData !== void 0 ? { mapData: opts.mapData } : {}
+    });
     chartType = r.chartType;
     diagnostics.push(...r.diagnostics);
     const errors = r.diagnostics.filter((d) => d.severity === "error");

package/dist/{chart-meta-D98NbYDp.d.ts → chart-meta-CpicJ1kj.d.ts}

@@ -1,4 +1,5 @@
-import { f as PaletteColors, T as TagGroup, a as DgmoError } from './dgmo-router-Dd5PTjxl.js';
+import './dgmo-router-EAW7XiBE.js';
+import { a as PaletteColors, T as TagGroup, D as DgmoError } from './tag-groups-NUA2F1I5.js';
 
 /** Convert hex (#RRGGBB or #RGB) to { h, s, l } with h in degrees, s/l as percentages. */
 declare function hexToHSL(hex: string): {

package/dist/chart-meta.d.ts

@@ -1,2 +1,3 @@
-export { b as ChartTypeId, c as ChartTypeMeta, C as CompactViewState, m as DecodedDiagramUrl, n as EncodeDiagramUrlOptions, o as EncodeDiagramUrlResult, f as PaletteColors, g as chartTypes, t as decodeDiagramUrl, u as decodeViewState, v as encodeDiagramUrl, w as encodeViewState, y as getAvailablePalettes, j as getPalette, H as parseDgmoChartType } from './dgmo-router-Dd5PTjxl.js';
-export { A as ALL_CHART_TYPES, O as OrgNode, P as ParsedOrg, k as hexToHSLString, n as normalizePertSourceForShare, p as parseFirstLine, o as parseOrg, q as parseRaci, r as resolveOrgImports } from './chart-meta-D98NbYDp.js';
+export { C as ChartTypeId, a as ChartTypeMeta, c as chartTypes, f as getAvailablePalettes, g as getPalette, l as parseDgmoChartType } from './dgmo-router-EAW7XiBE.js';
+export { A as ALL_CHART_TYPES, O as OrgNode, P as ParsedOrg, k as hexToHSLString, n as normalizePertSourceForShare, p as parseFirstLine, o as parseOrg, q as parseRaci, r as resolveOrgImports } from './chart-meta-CpicJ1kj.js';
+export { C as CompactViewState, h as DecodedDiagramUrl, i as EncodeDiagramUrlOptions, j as EncodeDiagramUrlResult, a as PaletteColors, l as decodeDiagramUrl, m as decodeViewState, n as encodeDiagramUrl, o as encodeViewState } from './tag-groups-NUA2F1I5.js';

package/dist/{chunk-ZZXPYVS4.js → chunk-3OT63FS4.js}

@@ -2749,8 +2749,8 @@ async function exportMap(ctx) {
   const { content, theme, palette, options } = ctx;
   const { parseMap } = await import("./parser-UKQC7N6K.js");
   const { resolveMap } = await import("./resolver-B3TXWNWF.js");
-  const { renderMapForExport } = await import("./renderer-AOFIEF2T.js");
-  const { mapExportDimensions } = await import("./dimensions-ILAVBRQ3.js");
+  const { renderMapForExport } = await import("./renderer-T66477EQ.js");
+  const { mapExportDimensions } = await import("./dimensions-RD3Y7FCF.js");
   const effectivePalette = await resolveExportPalette(theme, palette);
   const mapParsed = parseMap(content, effectivePalette);
   const { data: mapData, reason } = await resolveMapDataSource(
@@ -3718,4 +3718,4 @@ export {
   renderForExport,
   render
 };
-//# sourceMappingURL=chunk-ZZXPYVS4.js.map
+//# sourceMappingURL=chunk-3OT63FS4.js.map

package/dist/{chunk-QRWY5QTA.js → chunk-O274UTXH.js}

@@ -6,7 +6,7 @@ import {
   mapLegendConfig,
   mapLegendGroups,
   parsePathRings
-} from "./chunk-6E5YZR4S.js";
+} from "./chunk-R7S5542V.js";
 import {
   TITLE_FONT_SIZE,
   TITLE_FONT_WEIGHT,
@@ -781,4 +781,4 @@ export {
   renderMap,
   renderMapForExport
 };
-//# sourceMappingURL=chunk-QRWY5QTA.js.map
+//# sourceMappingURL=chunk-O274UTXH.js.map

package/dist/{chunk-6E5YZR4S.js → chunk-R7S5542V.js}

@@ -1036,20 +1036,6 @@ function createLabelMetrics(size) {
   };
 }
 
-// src/map/layout-constants.ts
-var FIT_PAD = 24;
-var WORLD_LABEL_ANCHORS = {
-  US: [-98.5, 39.5],
-  // CONUS geographic centre (near Lebanon, Kansas)
-  // Russia crosses the antimeridian (Chukotka at ~170°W), so on a non-global
-  // (e.g. Europe) projection its geometry smears across the whole frame and the
-  // area-weighted centroid lands mid-map (over Europe) — useless as a label
-  // anchor. Pin it to European Russia (~Volga) so a Europe view labels visible
-  // western Russia on its eastern margin; on a world view this still sits over
-  // Russian land. (See the curated-anchor smear-gate bypass in context-labels.)
-  RU: [45, 58]
-};
-
 // src/map/region-labels.ts
 function placeRegionLabels(args) {
   const {
@@ -1452,6 +1438,7 @@ function placeRegionLabels(args) {
 }
 
 // src/map/layout.ts
+var FIT_PAD = 24;
 var PATH_DIGITS = 1;
 var THIN_TOL = 0.6;
 var ALBERS_SKEW_MAX = 1.25;
@@ -1496,6 +1483,17 @@ var R_MIN = 4;
 var R_MAX = 22;
 var POI_FILL_OPACITY_MAX = 0.92;
 var POI_FILL_OPACITY_MIN = 0.55;
+var WORLD_LABEL_ANCHORS = {
+  US: [-98.5, 39.5],
+  // CONUS geographic centre (near Lebanon, Kansas)
+  // Russia crosses the antimeridian (Chukotka at ~170°W), so on a non-global
+  // (e.g. Europe) projection its geometry smears across the whole frame and the
+  // area-weighted centroid lands mid-map (over Europe) — useless as a label
+  // anchor. Pin it to European Russia (~Volga) so a Europe view labels visible
+  // western Russia on its eastern margin; on a world view this still sits over
+  // Russian land. (See the curated-anchor smear-gate bypass in context-labels.)
+  RU: [45, 58]
+};
 var MAX_CLUSTER_EXTENT_FACTOR = 0.18;
 var MAX_COLUMN_ROWS = 7;
 var REGION_LABEL_HALO_RATIO = 4.5;
@@ -3365,4 +3363,4 @@ export {
   albersSkewFallback,
   layoutMap
 };
-//# sourceMappingURL=chunk-6E5YZR4S.js.map
+//# sourceMappingURL=chunk-R7S5542V.js.map

package/dist/{chunk-PZOFMBF3.js → chunk-X26BF4T2.js}

@@ -1,6 +1,6 @@
 import {
   buildMapProjection
-} from "./chunk-6E5YZR4S.js";
+} from "./chunk-R7S5542V.js";
 import {
   TITLE_FONT_SIZE,
   TITLE_Y
@@ -51,4 +51,4 @@ export {
   mapContentAspect,
   mapExportDimensions
 };
-//# sourceMappingURL=chunk-PZOFMBF3.js.map
+//# sourceMappingURL=chunk-X26BF4T2.js.map

package/dist/{themes-DiUAG4Bf.d.ts → d3-Bfhj-XBX.d.ts}

@@ -1,4 +1,4 @@
-import { T as TagGroup, a as DgmoError, P as PaletteConfig, f as PaletteColors, C as CompactViewState } from './dgmo-router-Dd5PTjxl.js';
+import { T as TagGroup, D as DgmoError, a as PaletteColors, C as CompactViewState } from './tag-groups-NUA2F1I5.js';
 
 /** A POI / route-stop position: gazetteer name (+ optional ISO scope) or coords. */
 type PoiPos = {
@@ -458,25 +458,6 @@ interface ResolvedMap {
     readonly error: string | null;
 }
 
-/**
- * All built-in palettes, keyed by camelCase id. Use directly with render():
- *
- *   await render(text, { palette: palettes.catppuccin });
- *
- * For preference/settings storage, the `.id` field of each entry is the
- * canonical string (e.g. `'tokyo-night'`, `'nord'`) — that's the wire format
- * used by share URLs and the CLI `--palette` flag.
- */
-declare const palettes: {
-    readonly atlas: PaletteConfig;
-    readonly blueprint: PaletteConfig;
-    readonly slate: PaletteConfig;
-    readonly tidewater: PaletteConfig;
-    readonly nord: PaletteConfig;
-    readonly catppuccin: PaletteConfig;
-    readonly tokyoNight: PaletteConfig;
-};
-
 /**
  * How a host supplies map basemap assets: the data itself, or a loader that
  * returns it. Declared here (rather than accepting only `MapData`) so a Node
@@ -512,120 +493,4 @@ type RenderForExportOptions = {
 };
 declare function renderForExport(content: string, theme: 'light' | 'dark' | 'transparent', palette?: PaletteColors, viewState?: CompactViewState, options?: RenderForExportOptions): Promise<string>;
 
-interface MapPlaceCompletion {
-    /** Canonical display name (original casing), e.g. `Portland`. */
-    readonly name: string;
-    /** Text to insert. ISO-qualified (`Portland US-OR`) iff the name is
-     *  ambiguous in the gazetteer; bare otherwise (disambiguate-once, §24B.8). */
-    readonly insert: string;
-    /** Menu label (`Portland — US-OR` when ambiguous, else `Portland`). */
-    readonly label: string;
-    /** Secondary detail, e.g. `US-OR · 652,503`. */
-    readonly detail: string;
-    readonly iso: string;
-    readonly sub?: string;
-    readonly pop: number;
-    /** `'airport'` for IATA-code entries (icon/grouping affordance); absent or
-     *  `'city'` for gazetteer cities. Cities rank above airports for a shared
-     *  prefix so ~1500 codes never bury city names (ADR-5). */
-    readonly kind?: 'city' | 'airport';
-}
-interface MapCompletionOptions {
-    /** Max results (default 12). */
-    readonly limit?: number;
-    /** IATA-coded airports (`airports.json`). When supplied, airport codes
-     *  matching the prefix are offered as a second (post-city) group. Optional —
-     *  absent (old DI bundles / no asset) just yields city-only completions. */
-    readonly airports?: AirportData;
-    /** Resolver-inferred map scope (country `US` or subdivision `US-CA`). Biases
-     *  airport ranking so in-region airports sort above out-of-region same-prefix
-     *  ones (ADR-6). Pure rank, never a filter — cross-region airports still
-     *  appear. App passes the document's inferred scope in (Slice 2). */
-    readonly scopeISO?: string;
-}
-/**
- * Prefix-match city names + alternate-name aliases against the gazetteer,
- * rank by population (desc; stable tie-break by gazetteer index), and emit
- * ISO-qualified insert text only for ambiguous (same-named) places.
- *
- * Pure + deterministic. Empty/blank query → `[]` (the caller gates min length).
- */
-declare function completeMapPlaces(query: string, gazetteer: Gazetteer, opts?: MapCompletionOptions): MapPlaceCompletion[];
-/** A POI search hit — a city or airport the resolver can resolve, with the
- *  exact `token` to paste into DGMO (a `poi`/route endpoint). Powers the CLI
- *  `dgmo map search` command and the MCP `lookup_map_location` tool, so authors
- *  (and AI agents) can DISCOVER valid place tokens instead of guessing — e.g.
- *  learn that "New York" must be `New York City` and that `JFK` is bundled. */
-interface MapLocationMatch {
-    /** Canonical display name (cities) or full airport name. */
-    readonly name: string;
-    /** Exact text to use in DGMO. Cities: the name, ISO-qualified when ambiguous
-     *  (`Portland US-OR`). Airports: the upper-case IATA code (`JFK`). */
-    readonly token: string;
-    readonly kind: 'city' | 'airport';
-    readonly iso: string;
-    readonly sub?: string;
-    /** City population (0 for airports). */
-    readonly pop: number;
-    /** Human detail, e.g. `US-OR · 652,503` or `Airport · John F Kennedy Intl`. */
-    readonly detail: string;
-}
-/**
- * Substring-search cities + airports for a discovery surface (CLI / MCP), so an
- * author can find the exact token the resolver expects. Unlike
- * {@link completeMapPlaces} (prefix-only, editor type-ahead), this matches
- * anywhere in a city name OR an airport code/name, so "york" finds
- * `New York City` and "kennedy" finds `JFK`.
- *
- * Ranking: exact-name (or exact-IATA) → prefix → substring; within a tier,
- * cities by population desc (deterministic index tie-break), cities before
- * airports. Pure + deterministic. Empty query → `[]`.
- */
-declare function searchMapLocations(query: string, gazetteer: Gazetteer, opts?: {
-    readonly limit?: number;
-    readonly airports?: AirportData;
-}): MapLocationMatch[];
-interface MapRegionCompletion {
-    /** Display name = insert text (the resolver disambiguates cross-layer
-     *  collisions like Georgia by map scope, §24B.8). */
-    readonly name: string;
-    /** ISO 3166-1/3166-2 id. */
-    readonly iso: string;
-    readonly layer: 'country' | 'us-state';
-    /** Secondary detail, e.g. `US state · US-CA` or `Country · DE`. */
-    readonly detail: string;
-}
-/**
- * Prefix-match fill-able region names (countries + US states) for region-fill
- * lines. Matches the folded display name OR the ISO code; deterministic
- * (alphabetical by name, then layer). Pure. Empty query → `[]`.
- *
- * `regions` is injected (the `region-names.json` asset, shipped in dist/map-data
- * alongside the gazetteer). Cross-layer same-name (Georgia: country GE + state
- * US-GA) yields both entries, distinguished by `detail`.
- */
-declare function completeMapRegions(query: string, regions: readonly RegionName[], opts?: MapCompletionOptions): MapRegionCompletion[];
-
-/**
- * Theme — render mode flag. Selects which palette variant the renderer uses
- * for background and text:
- *  - 'light'       → palette.light colors
- *  - 'dark'        → palette.dark colors
- *  - 'transparent' → no background fill (for embedding in colored containers)
- */
-type Theme = 'light' | 'dark' | 'transparent';
-/**
- * `themes` namespace — use with render() options for a typed handle:
- *
- *   await render(text, { theme: themes.dark });
- *
- * Passing the raw string `'dark'` also works (the underlying type is the
- * string-literal union); the namespace is the conventional path.
- */
-declare const themes: {
-    readonly light: "light";
-    readonly dark: "dark";
-    readonly transparent: "transparent";
-};
-
-export { type AirportData as A, type BoundaryTopology as B, renderForExport as C, type Gazetteer as G, type MapDataSource as M, type ParsedMap as P, type RegionName as R, type Theme as T, type GazetteerEntry as a, type MapCompletionOptions as b, type MapData as c, type MapLocationMatch as d, type MapPlaceCompletion as e, type MapRegionCompletion as f, type RegionNames as g, completeMapPlaces as h, completeMapRegions as i, type ResolvedMap as j, type MapLayoutLegend as k, type GeoExtent as l, type MapDirectives as m, type MapEdge as n, type MapPoi as o, palettes as p, type MapRegion as q, type MapRoute as r, searchMapLocations as s, themes as t, type PoiPos as u, type ProjectionFamily as v, type ResolvedEdge as w, type ResolvedPoi as x, type ResolvedRegion as y, type ResolvedRoute as z };
+export { type AirportData as A, type BoundaryTopology as B, type Gazetteer as G, type MapDataSource as M, type ParsedMap as P, type RegionName as R, type GazetteerEntry as a, type MapData as b, type RegionNames as c, type ResolvedMap as d, type MapLayoutLegend as e, type GeoExtent as f, type MapDirectives as g, type MapEdge as h, type MapPoi as i, type MapRegion as j, type MapRoute as k, type PoiPos as l, type ProjectionFamily as m, type ResolvedEdge as n, type ResolvedPoi as o, type ResolvedRegion as p, type ResolvedRoute as q, renderForExport as r };

package/dist/{dgmo-router-Dd5PTjxl.d.ts → dgmo-router-EAW7XiBE.d.ts}

@@ -1,264 +1,4 @@
-type DgmoSeverity = 'error' | 'warning';
-interface DgmoError {
-    line: number;
-    column?: number;
-    message: string;
-    severity: DgmoSeverity;
-    /**
-     * Optional stable diagnostic code (e.g. 'E_ARROW_SUBSTRING_IN_LABEL').
-     * Additive; pre-existing diagnostics omit this field and existing
-     * substring-on-`.message` assertions keep working unchanged.
-     */
-    code?: string;
-}
-declare function makeDgmoError(line: number, message: string, severity?: DgmoSeverity, code?: string): DgmoError;
-/** Runtime params passed to `emit()` and forwarded to a message builder. */
-type DiagnosticParams = Record<string, unknown>;
-/**
- * Parameter type for a `DiagnosticSpec.message` builder body. Typed loosely
- * (`any`) on purpose: builders are hand-authored interpolation bags keyed by
- * ad-hoc names, and dgmo's tsconfig enables `noPropertyAccessFromIndexSignature`
- * (which forbids `p.name` dot-access on a `Record<string, unknown>`). Using
- * `any` here keeps builder bodies readable (`p.name`) instead of forcing
- * `p['name']` bracket access at every interpolation site.
- */
-type DiagnosticMessageParams = any;
-interface DiagnosticSpec {
-    /** Stable diagnostic code, e.g. `'E_MAP_UNKNOWN_PLACE'`. */
-    code: string;
-    /** Severity — must agree with the `E_`/`W_`/`I_` code prefix. */
-    severity: DgmoSeverity;
-    /** Owning chart type (`'map'`, `'swimlane'`, …) or `null` for universal/global codes. */
-    chartType: string | null;
-    /** Short human label for the catalog UI. */
-    title: string;
-    /**
-     * Canonical message wording. A plain string for static messages, or a
-     * builder `(params) => string` when the message interpolates runtime
-     * values. The builder must tolerate being called with `{}` so the
-     * catalog can show a representative message without live params.
-     */
-    message: string | ((params: DiagnosticMessageParams) => string);
-    /** Optional fix guidance shown alongside the message. */
-    hint?: string;
-    /** Minimal `.dgmo` source that triggers this diagnostic (for docs/console). */
-    example?: string;
-}
-/** Optional extras when emitting (currently just an explicit column). */
-interface EmitOptions {
-    column?: number;
-}
-/**
- * Emit a diagnostic from its `DiagnosticSpec`. The code, severity, and
- * canonical wording all come from the spec — call sites supply only the
- * line and the interpolation params, so the code/severity can never drift
- * out of sync with the declared spec. Replaces the per-parser
- * `push`/`err`/`fail` wrappers that each re-declared this shape.
- */
-declare function emit(spec: DiagnosticSpec, line: number, params?: DiagnosticParams, opts?: EmitOptions): DgmoError;
-declare function formatDgmoError(err: DgmoError): string;
-
-/**
- * Compact view state schema (ADR-6).
- * All fields optional. Only non-default values are encoded.
- * `tag: null` means "user chose none"; absent `tag` means "use DSL default" (ADR-5).
- */
-interface CompactViewState {
-    tag?: string | null;
-    cs?: number[];
-    cg?: string[];
-    swim?: string | null;
-    cl?: string[];
-    cc?: string[];
-    rm?: string;
-    htv?: Record<string, string[]>;
-    ha?: string[];
-    sem?: boolean;
-    cm?: boolean;
-    c4l?: string;
-    c4s?: string;
-    c4c?: string;
-    rps?: number;
-    spd?: number;
-    io?: Record<string, number>;
-    hd?: boolean;
-    cbd?: boolean;
-    rq?: string;
-    an?: boolean;
-    fl?: boolean;
-}
-interface DecodedDiagramUrl {
-    dsl: string;
-    viewState: CompactViewState;
-    palette?: string;
-    theme?: 'light' | 'dark';
-    filename?: string;
-}
-interface EncodeDiagramUrlOptions {
-    baseUrl?: string;
-    viewState?: CompactViewState;
-    palette?: string;
-    theme?: 'light' | 'dark';
-    filename?: string;
-}
-type EncodeDiagramUrlResult = {
-    url: string;
-    error?: undefined;
-} | {
-    url?: undefined;
-    error: 'too-large';
-    compressedSize: number;
-    limit: number;
-};
-/**
- * Encode a CompactViewState to a compressed string for URL embedding.
- * Returns empty string if state has no keys (ADR-4).
- */
-declare function encodeViewState(state: CompactViewState): string;
-/**
- * Decode a compressed view state string back to CompactViewState.
- * Returns empty object on failure (no crash).
- */
-declare function decodeViewState(encoded: string): CompactViewState;
-/**
- * Compress a DGMO DSL string into a shareable URL.
- * Returns `{ url }` on success, or `{ error: 'too-large', compressedSize, limit }` if the
- * compressed payload exceeds the 8 KB limit.
- */
-declare function encodeDiagramUrl(dsl: string, options?: EncodeDiagramUrlOptions): EncodeDiagramUrlResult;
-/**
- * Decode a DGMO DSL string and view state from a URL query string or hash.
- * Accepts any of:
- *   - `?dgmo=<payload>&vs=<state>`
- *   - `#dgmo=<payload>&vs=<state>` (backwards compat)
- *   - `dgmo=<payload>`
- *   - `<bare payload>`
- *
- * Returns `{ dsl, viewState }`. The DSL is empty string on invalid input.
- */
-declare function decodeDiagramUrl(hash: string): DecodedDiagramUrl;
-
-/**
- * Color definitions for a single mode (light or dark).
- * 10 semantic UI colors + 9 named accent colors = 19 total.
- *
- * `readonly` on every field (and the nested `colors` map) by design —
- * palettes flow from the registry into every renderer; nothing in the
- * pipeline should ever mutate a palette in place.
- */
-interface PaletteColors {
-    /** Main background (#eceff4 light / #2e3440 dark for Nord) */
-    readonly bg: string;
-    /** Cards, panels (#e5e9f0 / #3b4252) */
-    readonly surface: string;
-    /** Popovers, dropdowns (#e5e9f0 / #434c5e) */
-    readonly overlay: string;
-    /** Borders, dividers, muted (#d8dee9 / #4c566a) */
-    readonly border: string;
-    /** Primary text (#2e3440 / #eceff4) */
-    readonly text: string;
-    /** Secondary/diminished text (#4c566a / #d8dee9) */
-    readonly textMuted: string;
-    /**
-     * Light-mode arg for `contrastText()` when text is rendered on a
-     * tinted shape fill (e.g. `shapeFill()` output). Must guarantee
-     * ≥ 4.5:1 WCAG AA against any `shapeFill()` the palette can produce.
-     * Distinct from `colors.white` because palette-aesthetic anchors don't
-     * always meet contrast requirements (TD-5).
-     */
-    readonly textOnFillLight: string;
-    /** Dark-mode counterpart to `textOnFillLight`. */
-    readonly textOnFillDark: string;
-    /** Primary accent — buttons, links */
-    readonly primary: string;
-    /** Secondary accent */
-    readonly secondary: string;
-    /** Tertiary accent */
-    readonly accent: string;
-    /** Error/danger */
-    readonly destructive: string;
-    /**
-     * Used for: inline annotations (red), pie charts, cScale,
-     * series rotation, journey actors, Gantt tasks.
-     */
-    readonly colors: {
-        readonly red: string;
-        readonly orange: string;
-        readonly yellow: string;
-        readonly green: string;
-        readonly blue: string;
-        readonly purple: string;
-        readonly teal: string;
-        readonly cyan: string;
-        readonly gray: string;
-        readonly black: string;
-        readonly white: string;
-    };
-}
-/**
- * Complete palette definition. One object per color scheme.
- * This is what palette authors create — the single artifact for NFR1.
- *
- * Palettes are immutable from the consumer's perspective; the registry
- * hands out the same frozen-shape object on every `getPalette(id)`.
- */
-interface PaletteConfig {
-    /** Registry key: 'nord', 'slate', 'catppuccin' */
-    readonly id: string;
-    /** Display name: 'Nord', 'Slate', 'Catppuccin' */
-    readonly name: string;
-    /** Light mode color definitions */
-    readonly light: PaletteColors;
-    /** Dark mode color definitions */
-    readonly dark: PaletteColors;
-}
-
-/** A single entry inside a tag group: `Value color` */
-interface TagEntry {
-    readonly value: string;
-    readonly color: string;
-    /**
-     * The color NAME the author wrote (one of the recognized palette names),
-     * when the entry declared an explicit color. Absent for bare/auto-colored
-     * entries. `color` above is always the RESOLVED hex (auto and explicit are
-     * indistinguishable there); this preserves the authored-vs-auto distinction
-     * so a GUI editor can round-trip an explicit color through a reparse.
-     */
-    readonly authoredColor?: string;
-    readonly lineNumber: number;
-}
-/**
- * A tag group block: heading + entries.
- *
- * Parser internals build via `Writable<TagGroup>` from `utils/brand.ts`;
- * once returned to a chart-type parser, consumers see the readonly view.
- */
-interface TagGroup {
-    readonly name: string;
-    readonly alias?: string;
-    readonly entries: readonly TagEntry[];
-    /** Default value for nodes without explicit metadata. First entry unless another is marked `default`. */
-    readonly defaultValue?: string;
-    readonly lineNumber: number;
-}
-/**
- * DOM-safe key for a tag group — used wherever the group name becomes a
- * `data-tag-*` attribute suffix, an entity metadata key, or an `active-tag`
- * match target. For a single-identifier name (the only form the parser used to
- * accept) this is exactly `name.toLowerCase()`, so swapping it in for existing
- * diagrams is byte-identical. A quoted multi-word name (`tag "Trust Zone" as tz`)
- * slugs to a hyphenated identifier (`trust-zone`) so it never produces an
- * invalid DOM attribute name; the original `name` is kept for the legend label.
- */
-declare function tagAttrKey(name: string): string;
-/**
- * The categorical name cycle used to auto-assign colors to bare tag values,
- * in deterministic order. Aliased to the shared {@link CATEGORICAL_COLOR_ORDER}
- * (RGB-seeded, max-contrast, neutrals excluded) so tag swatches and data-chart
- * series colors share one canonical rotation. If a group has more colorless
- * entries than free categorical names, the cycle wraps.
- */
-declare const autoTagColorCycle: readonly string[];
+import { P as PaletteConfig, D as DgmoError } from './tag-groups-NUA2F1I5.js';
 
 /** Validate that a hex string is well-formed (#RGB or #RRGGBB). */
 declare function isValidHex(value: string): boolean;
@@ -537,4 +277,4 @@ declare function parseDgmo(content: string): {
     chartType: string | null;
 };
 
-export { isExtendedChartType as A, isValidHex as B, type CompactViewState as C, type DiagnosticSpec as D, type EmitOptions as E, knownChartTypeIds as F, makeDgmoError as G, parseDgmoChartType as H, registerPalette as I, tagAttrKey as J, type PaletteConfig as P, type RenderCategory as R, type TagGroup as T, type DgmoError as a, type ChartTypeId as b, type ChartTypeMeta as c, type DgmoSeverity as d, type DiagnosticParams as e, type PaletteColors as f, chartTypes as g, emit as h, formatDgmoError as i, getPalette as j, type TagEntry as k, CHART_TYPE_DESCRIPTIONS as l, type DecodedDiagramUrl as m, type EncodeDiagramUrlOptions as n, type EncodeDiagramUrlResult as o, parseDgmo as p, autoTagColorCycle as q, resolvePaletteOrFallback as r, chartTypeParsers as s, decodeDiagramUrl as t, decodeViewState as u, encodeDiagramUrl as v, encodeViewState as w, getAllChartTypes as x, getAvailablePalettes as y, getRenderCategory as z };
+export { type ChartTypeId as C, type RenderCategory as R, type ChartTypeMeta as a, CHART_TYPE_DESCRIPTIONS as b, chartTypes as c, chartTypeParsers as d, getAllChartTypes as e, getAvailablePalettes as f, getPalette as g, getRenderCategory as h, isExtendedChartType as i, isValidHex as j, knownChartTypeIds as k, parseDgmoChartType as l, registerPalette as m, parseDgmo as p, resolvePaletteOrFallback as r };

package/dist/{dimensions-ILAVBRQ3.js → dimensions-RD3Y7FCF.js}

@@ -1,8 +1,8 @@
 import {
   mapContentAspect,
   mapExportDimensions
-} from "./chunk-PZOFMBF3.js";
-import "./chunk-6E5YZR4S.js";
+} from "./chunk-X26BF4T2.js";
+import "./chunk-R7S5542V.js";
 import "./chunk-4QV26TEG.js";
 import "./chunk-L65WI4HO.js";
 import "./chunk-A4GOY3PE.js";
@@ -19,4 +19,4 @@ export {
   mapContentAspect,
   mapExportDimensions
 };
-//# sourceMappingURL=dimensions-ILAVBRQ3.js.map
+//# sourceMappingURL=dimensions-RD3Y7FCF.js.map

package/dist/index.d.ts

@@ -1,7 +1,10 @@
-import { D as DiagnosticSpec, P as PaletteConfig, C as CompactViewState, a as DgmoError } from './dgmo-router-Dd5PTjxl.js';
-export { b as ChartTypeId, c as ChartTypeMeta, d as DgmoSeverity, e as DiagnosticParams, E as EmitOptions, f as PaletteColors, g as chartTypes, h as emit, i as formatDgmoError, j as getPalette, r as resolvePaletteOrFallback, p as validate } from './dgmo-router-Dd5PTjxl.js';
-import { T as Theme, M as MapDataSource } from './themes-DiUAG4Bf.js';
-export { G as Gazetteer, a as GazetteerEntry, b as MapCompletionOptions, c as MapData, d as MapLocationMatch, e as MapPlaceCompletion, f as MapRegionCompletion, R as RegionName, g as RegionNames, h as completeMapPlaces, i as completeMapRegions, p as palettes, s as searchMapLocations, t as themes } from './themes-DiUAG4Bf.js';
+import { b as DiagnosticSpec, P as PaletteConfig, C as CompactViewState, D as DgmoError } from './tag-groups-NUA2F1I5.js';
+export { c as DgmoSeverity, d as DiagnosticParams, E as EmitOptions, a as PaletteColors, e as emit, f as formatDgmoError } from './tag-groups-NUA2F1I5.js';
+export { C as ChartTypeId, a as ChartTypeMeta, c as chartTypes, g as getPalette, r as resolvePaletteOrFallback, p as validate } from './dgmo-router-EAW7XiBE.js';
+import { T as Theme } from './themes-Dem5xalq.js';
+export { M as MapCompletionOptions, a as MapLocationMatch, b as MapPlaceCompletion, c as MapRegionCompletion, d as completeMapPlaces, e as completeMapRegions, p as palettes, s as searchMapLocations, t as themes } from './themes-Dem5xalq.js';
+import { M as MapDataSource } from './d3-Bfhj-XBX.js';
+export { G as Gazetteer, a as GazetteerEntry, b as MapData, R as RegionName, c as RegionNames } from './d3-Bfhj-XBX.js';
 
 /**
  * Make an SVG produced by `@diagrammo/dgmo`'s static `render()` suitable for

package/dist/index.js

@@ -11,7 +11,7 @@ import {
 } from "./chunk-SQAG3UXH.js";
 import {
   render
-} from "./chunk-ZZXPYVS4.js";
+} from "./chunk-3OT63FS4.js";
 import {
   renderErrorCard
 } from "./chunk-7L53J53J.js";

package/dist/{renderer-AOFIEF2T.js → renderer-T66477EQ.js}

@@ -1,9 +1,9 @@
 import {
   renderMap,
   renderMapForExport
-} from "./chunk-QRWY5QTA.js";
+} from "./chunk-O274UTXH.js";
 import "./chunk-FWVKPEG3.js";
-import "./chunk-6E5YZR4S.js";
+import "./chunk-R7S5542V.js";
 import "./chunk-4QV26TEG.js";
 import "./chunk-L65WI4HO.js";
 import "./chunk-A4GOY3PE.js";
@@ -24,4 +24,4 @@ export {
   renderMap,
   renderMapForExport
 };
-//# sourceMappingURL=renderer-AOFIEF2T.js.map
+//# sourceMappingURL=renderer-T66477EQ.js.map

package/dist/tag-groups-NUA2F1I5.d.ts

@@ -0,0 +1,263 @@
+type DgmoSeverity = 'error' | 'warning';
+interface DgmoError {
+    line: number;
+    column?: number;
+    message: string;
+    severity: DgmoSeverity;
+    /**
+     * Optional stable diagnostic code (e.g. 'E_ARROW_SUBSTRING_IN_LABEL').
+     * Additive; pre-existing diagnostics omit this field and existing
+     * substring-on-`.message` assertions keep working unchanged.
+     */
+    code?: string;
+}
+declare function makeDgmoError(line: number, message: string, severity?: DgmoSeverity, code?: string): DgmoError;
+/** Runtime params passed to `emit()` and forwarded to a message builder. */
+type DiagnosticParams = Record<string, unknown>;
+/**
+ * Parameter type for a `DiagnosticSpec.message` builder body. Typed loosely
+ * (`any`) on purpose: builders are hand-authored interpolation bags keyed by
+ * ad-hoc names, and dgmo's tsconfig enables `noPropertyAccessFromIndexSignature`
+ * (which forbids `p.name` dot-access on a `Record<string, unknown>`). Using
+ * `any` here keeps builder bodies readable (`p.name`) instead of forcing
+ * `p['name']` bracket access at every interpolation site.
+ */
+type DiagnosticMessageParams = any;
+interface DiagnosticSpec {
+    /** Stable diagnostic code, e.g. `'E_MAP_UNKNOWN_PLACE'`. */
+    code: string;
+    /** Severity — must agree with the `E_`/`W_`/`I_` code prefix. */
+    severity: DgmoSeverity;
+    /** Owning chart type (`'map'`, `'swimlane'`, …) or `null` for universal/global codes. */
+    chartType: string | null;
+    /** Short human label for the catalog UI. */
+    title: string;
+    /**
+     * Canonical message wording. A plain string for static messages, or a
+     * builder `(params) => string` when the message interpolates runtime
+     * values. The builder must tolerate being called with `{}` so the
+     * catalog can show a representative message without live params.
+     */
+    message: string | ((params: DiagnosticMessageParams) => string);
+    /** Optional fix guidance shown alongside the message. */
+    hint?: string;
+    /** Minimal `.dgmo` source that triggers this diagnostic (for docs/console). */
+    example?: string;
+}
+/** Optional extras when emitting (currently just an explicit column). */
+interface EmitOptions {
+    column?: number;
+}
+/**
+ * Emit a diagnostic from its `DiagnosticSpec`. The code, severity, and
+ * canonical wording all come from the spec — call sites supply only the
+ * line and the interpolation params, so the code/severity can never drift
+ * out of sync with the declared spec. Replaces the per-parser
+ * `push`/`err`/`fail` wrappers that each re-declared this shape.
+ */
+declare function emit(spec: DiagnosticSpec, line: number, params?: DiagnosticParams, opts?: EmitOptions): DgmoError;
+declare function formatDgmoError(err: DgmoError): string;
+
+/**
+ * Compact view state schema (ADR-6).
+ * All fields optional. Only non-default values are encoded.
+ * `tag: null` means "user chose none"; absent `tag` means "use DSL default" (ADR-5).
+ */
+interface CompactViewState {
+    tag?: string | null;
+    cs?: number[];
+    cg?: string[];
+    swim?: string | null;
+    cl?: string[];
+    cc?: string[];
+    rm?: string;
+    htv?: Record<string, string[]>;
+    ha?: string[];
+    sem?: boolean;
+    cm?: boolean;
+    c4l?: string;
+    c4s?: string;
+    c4c?: string;
+    rps?: number;
+    spd?: number;
+    io?: Record<string, number>;
+    hd?: boolean;
+    cbd?: boolean;
+    rq?: string;
+    an?: boolean;
+    fl?: boolean;
+}
+interface DecodedDiagramUrl {
+    dsl: string;
+    viewState: CompactViewState;
+    palette?: string;
+    theme?: 'light' | 'dark';
+    filename?: string;
+}
+interface EncodeDiagramUrlOptions {
+    baseUrl?: string;
+    viewState?: CompactViewState;
+    palette?: string;
+    theme?: 'light' | 'dark';
+    filename?: string;
+}
+type EncodeDiagramUrlResult = {
+    url: string;
+    error?: undefined;
+} | {
+    url?: undefined;
+    error: 'too-large';
+    compressedSize: number;
+    limit: number;
+};
+/**
+ * Encode a CompactViewState to a compressed string for URL embedding.
+ * Returns empty string if state has no keys (ADR-4).
+ */
+declare function encodeViewState(state: CompactViewState): string;
+/**
+ * Decode a compressed view state string back to CompactViewState.
+ * Returns empty object on failure (no crash).
+ */
+declare function decodeViewState(encoded: string): CompactViewState;
+/**
+ * Compress a DGMO DSL string into a shareable URL.
+ * Returns `{ url }` on success, or `{ error: 'too-large', compressedSize, limit }` if the
+ * compressed payload exceeds the 8 KB limit.
+ */
+declare function encodeDiagramUrl(dsl: string, options?: EncodeDiagramUrlOptions): EncodeDiagramUrlResult;
+/**
+ * Decode a DGMO DSL string and view state from a URL query string or hash.
+ * Accepts any of:
+ *   - `?dgmo=<payload>&vs=<state>`
+ *   - `#dgmo=<payload>&vs=<state>` (backwards compat)
+ *   - `dgmo=<payload>`
+ *   - `<bare payload>`
+ *
+ * Returns `{ dsl, viewState }`. The DSL is empty string on invalid input.
+ */
+declare function decodeDiagramUrl(hash: string): DecodedDiagramUrl;
+
+/**
+ * Color definitions for a single mode (light or dark).
+ * 10 semantic UI colors + 9 named accent colors = 19 total.
+ *
+ * `readonly` on every field (and the nested `colors` map) by design —
+ * palettes flow from the registry into every renderer; nothing in the
+ * pipeline should ever mutate a palette in place.
+ */
+interface PaletteColors {
+    /** Main background (#eceff4 light / #2e3440 dark for Nord) */
+    readonly bg: string;
+    /** Cards, panels (#e5e9f0 / #3b4252) */
+    readonly surface: string;
+    /** Popovers, dropdowns (#e5e9f0 / #434c5e) */
+    readonly overlay: string;
+    /** Borders, dividers, muted (#d8dee9 / #4c566a) */
+    readonly border: string;
+    /** Primary text (#2e3440 / #eceff4) */
+    readonly text: string;
+    /** Secondary/diminished text (#4c566a / #d8dee9) */
+    readonly textMuted: string;
+    /**
+     * Light-mode arg for `contrastText()` when text is rendered on a
+     * tinted shape fill (e.g. `shapeFill()` output). Must guarantee
+     * ≥ 4.5:1 WCAG AA against any `shapeFill()` the palette can produce.
+     * Distinct from `colors.white` because palette-aesthetic anchors don't
+     * always meet contrast requirements (TD-5).
+     */
+    readonly textOnFillLight: string;
+    /** Dark-mode counterpart to `textOnFillLight`. */
+    readonly textOnFillDark: string;
+    /** Primary accent — buttons, links */
+    readonly primary: string;
+    /** Secondary accent */
+    readonly secondary: string;
+    /** Tertiary accent */
+    readonly accent: string;
+    /** Error/danger */
+    readonly destructive: string;
+    /**
+     * Used for: inline annotations (red), pie charts, cScale,
+     * series rotation, journey actors, Gantt tasks.
+     */
+    readonly colors: {
+        readonly red: string;
+        readonly orange: string;
+        readonly yellow: string;
+        readonly green: string;
+        readonly blue: string;
+        readonly purple: string;
+        readonly teal: string;
+        readonly cyan: string;
+        readonly gray: string;
+        readonly black: string;
+        readonly white: string;
+    };
+}
+/**
+ * Complete palette definition. One object per color scheme.
+ * This is what palette authors create — the single artifact for NFR1.
+ *
+ * Palettes are immutable from the consumer's perspective; the registry
+ * hands out the same frozen-shape object on every `getPalette(id)`.
+ */
+interface PaletteConfig {
+    /** Registry key: 'nord', 'slate', 'catppuccin' */
+    readonly id: string;
+    /** Display name: 'Nord', 'Slate', 'Catppuccin' */
+    readonly name: string;
+    /** Light mode color definitions */
+    readonly light: PaletteColors;
+    /** Dark mode color definitions */
+    readonly dark: PaletteColors;
+}
+
+/** A single entry inside a tag group: `Value color` */
+interface TagEntry {
+    readonly value: string;
+    readonly color: string;
+    /**
+     * The color NAME the author wrote (one of the recognized palette names),
+     * when the entry declared an explicit color. Absent for bare/auto-colored
+     * entries. `color` above is always the RESOLVED hex (auto and explicit are
+     * indistinguishable there); this preserves the authored-vs-auto distinction
+     * so a GUI editor can round-trip an explicit color through a reparse.
+     */
+    readonly authoredColor?: string;
+    readonly lineNumber: number;
+}
+/**
+ * A tag group block: heading + entries.
+ *
+ * Parser internals build via `Writable<TagGroup>` from `utils/brand.ts`;
+ * once returned to a chart-type parser, consumers see the readonly view.
+ */
+interface TagGroup {
+    readonly name: string;
+    readonly alias?: string;
+    readonly entries: readonly TagEntry[];
+    /** Default value for nodes without explicit metadata. First entry unless another is marked `default`. */
+    readonly defaultValue?: string;
+    readonly lineNumber: number;
+}
+/**
+ * DOM-safe key for a tag group — used wherever the group name becomes a
+ * `data-tag-*` attribute suffix, an entity metadata key, or an `active-tag`
+ * match target. For a single-identifier name (the only form the parser used to
+ * accept) this is exactly `name.toLowerCase()`, so swapping it in for existing
+ * diagrams is byte-identical. A quoted multi-word name (`tag "Trust Zone" as tz`)
+ * slugs to a hyphenated identifier (`trust-zone`) so it never produces an
+ * invalid DOM attribute name; the original `name` is kept for the legend label.
+ */
+declare function tagAttrKey(name: string): string;
+/**
+ * The categorical name cycle used to auto-assign colors to bare tag values,
+ * in deterministic order. Aliased to the shared {@link CATEGORICAL_COLOR_ORDER}
+ * (RGB-seeded, max-contrast, neutrals excluded) so tag swatches and data-chart
+ * series colors share one canonical rotation. If a group has more colorless
+ * entries than free categorical names, the cycle wraps.
+ */
+declare const autoTagColorCycle: readonly string[];
+
+export { type CompactViewState as C, type DgmoError as D, type EmitOptions as E, type PaletteConfig as P, type TagGroup as T, type PaletteColors as a, type DiagnosticSpec as b, type DgmoSeverity as c, type DiagnosticParams as d, emit as e, formatDgmoError as f, type TagEntry as g, type DecodedDiagramUrl as h, type EncodeDiagramUrlOptions as i, type EncodeDiagramUrlResult as j, autoTagColorCycle as k, decodeDiagramUrl as l, decodeViewState as m, encodeDiagramUrl as n, encodeViewState as o, makeDgmoError as p, tagAttrKey as t };

package/dist/themes-Dem5xalq.d.ts

@@ -0,0 +1,139 @@
+import { P as PaletteConfig } from './tag-groups-NUA2F1I5.js';
+import { A as AirportData, G as Gazetteer, R as RegionName } from './d3-Bfhj-XBX.js';
+
+/**
+ * All built-in palettes, keyed by camelCase id. Use directly with render():
+ *
+ *   await render(text, { palette: palettes.catppuccin });
+ *
+ * For preference/settings storage, the `.id` field of each entry is the
+ * canonical string (e.g. `'tokyo-night'`, `'nord'`) — that's the wire format
+ * used by share URLs and the CLI `--palette` flag.
+ */
+declare const palettes: {
+    readonly atlas: PaletteConfig;
+    readonly blueprint: PaletteConfig;
+    readonly slate: PaletteConfig;
+    readonly tidewater: PaletteConfig;
+    readonly nord: PaletteConfig;
+    readonly catppuccin: PaletteConfig;
+    readonly tokyoNight: PaletteConfig;
+};
+
+interface MapPlaceCompletion {
+    /** Canonical display name (original casing), e.g. `Portland`. */
+    readonly name: string;
+    /** Text to insert. ISO-qualified (`Portland US-OR`) iff the name is
+     *  ambiguous in the gazetteer; bare otherwise (disambiguate-once, §24B.8). */
+    readonly insert: string;
+    /** Menu label (`Portland — US-OR` when ambiguous, else `Portland`). */
+    readonly label: string;
+    /** Secondary detail, e.g. `US-OR · 652,503`. */
+    readonly detail: string;
+    readonly iso: string;
+    readonly sub?: string;
+    readonly pop: number;
+    /** `'airport'` for IATA-code entries (icon/grouping affordance); absent or
+     *  `'city'` for gazetteer cities. Cities rank above airports for a shared
+     *  prefix so ~1500 codes never bury city names (ADR-5). */
+    readonly kind?: 'city' | 'airport';
+}
+interface MapCompletionOptions {
+    /** Max results (default 12). */
+    readonly limit?: number;
+    /** IATA-coded airports (`airports.json`). When supplied, airport codes
+     *  matching the prefix are offered as a second (post-city) group. Optional —
+     *  absent (old DI bundles / no asset) just yields city-only completions. */
+    readonly airports?: AirportData;
+    /** Resolver-inferred map scope (country `US` or subdivision `US-CA`). Biases
+     *  airport ranking so in-region airports sort above out-of-region same-prefix
+     *  ones (ADR-6). Pure rank, never a filter — cross-region airports still
+     *  appear. App passes the document's inferred scope in (Slice 2). */
+    readonly scopeISO?: string;
+}
+/**
+ * Prefix-match city names + alternate-name aliases against the gazetteer,
+ * rank by population (desc; stable tie-break by gazetteer index), and emit
+ * ISO-qualified insert text only for ambiguous (same-named) places.
+ *
+ * Pure + deterministic. Empty/blank query → `[]` (the caller gates min length).
+ */
+declare function completeMapPlaces(query: string, gazetteer: Gazetteer, opts?: MapCompletionOptions): MapPlaceCompletion[];
+/** A POI search hit — a city or airport the resolver can resolve, with the
+ *  exact `token` to paste into DGMO (a `poi`/route endpoint). Powers the CLI
+ *  `dgmo map search` command and the MCP `lookup_map_location` tool, so authors
+ *  (and AI agents) can DISCOVER valid place tokens instead of guessing — e.g.
+ *  learn that "New York" must be `New York City` and that `JFK` is bundled. */
+interface MapLocationMatch {
+    /** Canonical display name (cities) or full airport name. */
+    readonly name: string;
+    /** Exact text to use in DGMO. Cities: the name, ISO-qualified when ambiguous
+     *  (`Portland US-OR`). Airports: the upper-case IATA code (`JFK`). */
+    readonly token: string;
+    readonly kind: 'city' | 'airport';
+    readonly iso: string;
+    readonly sub?: string;
+    /** City population (0 for airports). */
+    readonly pop: number;
+    /** Human detail, e.g. `US-OR · 652,503` or `Airport · John F Kennedy Intl`. */
+    readonly detail: string;
+}
+/**
+ * Substring-search cities + airports for a discovery surface (CLI / MCP), so an
+ * author can find the exact token the resolver expects. Unlike
+ * {@link completeMapPlaces} (prefix-only, editor type-ahead), this matches
+ * anywhere in a city name OR an airport code/name, so "york" finds
+ * `New York City` and "kennedy" finds `JFK`.
+ *
+ * Ranking: exact-name (or exact-IATA) → prefix → substring; within a tier,
+ * cities by population desc (deterministic index tie-break), cities before
+ * airports. Pure + deterministic. Empty query → `[]`.
+ */
+declare function searchMapLocations(query: string, gazetteer: Gazetteer, opts?: {
+    readonly limit?: number;
+    readonly airports?: AirportData;
+}): MapLocationMatch[];
+interface MapRegionCompletion {
+    /** Display name = insert text (the resolver disambiguates cross-layer
+     *  collisions like Georgia by map scope, §24B.8). */
+    readonly name: string;
+    /** ISO 3166-1/3166-2 id. */
+    readonly iso: string;
+    readonly layer: 'country' | 'us-state';
+    /** Secondary detail, e.g. `US state · US-CA` or `Country · DE`. */
+    readonly detail: string;
+}
+/**
+ * Prefix-match fill-able region names (countries + US states) for region-fill
+ * lines. Matches the folded display name OR the ISO code; deterministic
+ * (alphabetical by name, then layer). Pure. Empty query → `[]`.
+ *
+ * `regions` is injected (the `region-names.json` asset, shipped in dist/map-data
+ * alongside the gazetteer). Cross-layer same-name (Georgia: country GE + state
+ * US-GA) yields both entries, distinguished by `detail`.
+ */
+declare function completeMapRegions(query: string, regions: readonly RegionName[], opts?: MapCompletionOptions): MapRegionCompletion[];
+
+/**
+ * Theme — render mode flag. Selects which palette variant the renderer uses
+ * for background and text:
+ *  - 'light'       → palette.light colors
+ *  - 'dark'        → palette.dark colors
+ *  - 'transparent' → no background fill (for embedding in colored containers)
+ */
+type Theme = 'light' | 'dark' | 'transparent';
+/**
+ * `themes` namespace — use with render() options for a typed handle:
+ *
+ *   await render(text, { theme: themes.dark });
+ *
+ * Passing the raw string `'dark'` also works (the underlying type is the
+ * string-literal union); the namespace is the conventional path.
+ */
+declare const themes: {
+    readonly light: "light";
+    readonly dark: "dark";
+    readonly transparent: "transparent";
+};
+
+export { type MapCompletionOptions as M, type Theme as T, type MapLocationMatch as a, type MapPlaceCompletion as b, type MapRegionCompletion as c, completeMapPlaces as d, completeMapRegions as e, palettes as p, searchMapLocations as s, themes as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diagrammo/dgmo",
-  "version": "0.65.0",
+  "version": "0.66.0",
   "description": "DGMO diagram markup language — parser, renderer, and color system",
   "license": "MIT",
   "author": "Diagrammo LLC",