@diagrammo/dgmo 0.22.0 → 0.23.0

package/docs/language-reference.md

@@ -1469,12 +1469,47 @@ Indented shorthand also supports groups (place arrow directly after group header
 ### 13.6 Directives
 
 - `direction TB` — top-to-bottom layout (default: `LR`)
+- `box-metric <Label> [color]` — name a numeric value dimension (see §13.8); optional trailing color sets the ramp hue
+- `show-values` — print each box's numeric value as text (off by default)
 
 ### 13.7 Options
 
 - `active-tag GroupName` — set active tag group for coloring
+- `active-tag none` — suppress tag coloring
+- `active-tag <metric>` — make the value ramp the active dimension (see §13.8)
 - `hide team:Backend, team:Frontend` — hide nodes with matching tag values (colon syntax for tag:value)
 
+### 13.8 Value metric (numeric ramp)
+
+Boxes can carry a numeric measure that drives a continuous color ramp — a
+choropleth-style "value dimension" alongside the categorical tag groups.
+
+```
+boxes-and-lines Fleet Crews
+box-metric Crew blue
+show-values
+
+Flagship value: 120
+Frigate value: 40
+Sloop value: 12
+Flagship -> Frigate
+Flagship -> Sloop
+```
+
+- `value: <number>` on any box records its measure (a reserved metadata key —
+  lifted out, never rendered as a tag). Non-numeric values are an error.
+- `box-metric <Label> [color]` names the dimension and optionally sets the ramp
+  hue (default: the palette's primary color).
+- The ramp anchors at `0` for all-non-negative data, else at the data minimum.
+- The value ramp is the resting-active dimension whenever any box has a
+  `value:` (so value shading works in static export with no interaction).
+  `active-tag <tag-group>` switches to a tag group; `active-tag none` suppresses
+  tinting; `active-tag <metric>` forces the value ramp. On a name collision
+  between a tag group and the metric label, the tag group wins.
+- When the value ramp is active, every box tints along the min→max ramp and the
+  legend shows a gradient capsule; boxes without a `value:` get a neutral fill.
+- `show-values` additionally prints each box's number as text.
+
 ---
 
 ## 15. Timeline Diagrams

package/gallery/fixtures/boxes-and-lines.dgmo

@@ -6,28 +6,30 @@ tag Priority p High red, Medium orange, Low gray
 active-tag Team
 hide priority:Low
 
+box-metric Load orange
+
 direction LR
 
 // --- Services ---
-API Gateway t: Backend
+API Gateway t: Backend, value: 850
   Main entry point for all requests
   Routes to **backend services**
   -routes-> UserService
   -routes-> ProductService
   -routes-> OrderService
 
-UserService t: Backend
+UserService t: Backend, value: 430
   Handles auth and profiles
   Uses `JWT` tokens for sessions
   -reads-> UserDB
   -checks-> SessionCache
 
-ProductService t: Frontend, description: Product catalog and search
+ProductService t: Frontend, value: 620, description: Product catalog and search
   Supports *full-text* search
   -queries-> ProductDB
   -invalidates-> ProductCache
 
-OrderService t: Backend
+OrderService t: Backend, value: 290
   Order processing pipeline
   Validates inventory before commit
   -writes-> OrderDB

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diagrammo/dgmo",
-  "version": "0.22.0",
+  "version": "0.23.0",
   "description": "DGMO diagram markup language — parser, renderer, and color system",
   "license": "MIT",
   "repository": {

package/src/boxes-and-lines/parser.ts

@@ -26,6 +26,7 @@ import {
   extractColor,
   parseFirstLine,
   OPTION_NOCOLON_RE,
+  peelTrailingColorName,
   splitNameAndMeta,
   tryParseSharedOption,
   warnUnknownMetaKeys,
@@ -297,6 +298,26 @@ export function parseBoxesAndLines(content: string): ParsedBoxesAndLines {
         continue;
       }
 
+      // box-metric / show-values directives — pre-content only (like
+      // active-tag). Explicit regex branches: a bare flag and a
+      // `key value` form won't both match the active-tag OPTION codepath.
+      if (!contentStarted) {
+        const metricMatch = trimmed.match(/^box-metric\s+(.+)$/i);
+        if (metricMatch) {
+          // Regex capture group present after successful match.
+          const { label, colorName } = peelTrailingColorName(
+            metricMatch[1]!.trim()
+          );
+          result.boxMetric = label;
+          if (colorName !== undefined) result.boxMetricColor = colorName;
+          continue;
+        }
+        if (/^show-values$/i.test(trimmed)) {
+          result.showValues = true;
+          continue;
+        }
+      }
+
       // active-tag directive
       if (!contentStarted) {
         const optMatch = trimmed.match(OPTION_NOCOLON_RE);
@@ -784,6 +805,23 @@ function parseNodeLine(
     delete metadata['description'];
   }
 
+  // Lift `value: X` out of metadata into a typed numeric field (mirror of the
+  // map parser). Validate finite-numeric; delete from metadata so it never
+  // becomes a `data-tag-value` attribute.
+  let value: number | undefined;
+  if (metadata['value'] !== undefined) {
+    const raw = metadata['value'];
+    const num = Number(raw);
+    if (Number.isFinite(num)) {
+      value = num;
+    } else {
+      diagnostics.push(
+        makeDgmoError(lineNum, `value must be a number (got "${raw}")`, 'error')
+      );
+    }
+    delete metadata['value'];
+  }
+
   // TD-18 alias is now peeled by splitNameAndMeta — re-register if set.
   if (split.alias) {
     nameAliasMap?.set(normalizeName(split.alias), label);
@@ -796,6 +834,7 @@ function parseNodeLine(
     lineNumber: lineNum,
     metadata,
     ...(description !== undefined && { description }),
+    ...(value !== undefined && { value }),
   };
 }
 

package/src/boxes-and-lines/renderer.ts

@@ -11,6 +11,7 @@ import type {
   LegendConfig,
   LegendState,
   LegendCallbacks,
+  LegendGroupData,
   ControlsGroupToggle,
 } from '../utils/legend-types';
 import {
@@ -19,7 +20,8 @@ import {
   TITLE_Y,
 } from '../utils/title-constants';
 import { contrastText, mix, shapeFill } from '../palettes/color-utils';
-import { resolveTagColor, resolveActiveTagGroup } from '../utils/tag-groups';
+import { resolveColor } from '../colors';
+import { resolveTagColor } from '../utils/tag-groups';
 import type { TagGroup } from '../utils/tag-groups';
 import type { PaletteColors } from '../palettes';
 import { renderInlineText } from '../utils/inline-markdown';
@@ -50,6 +52,9 @@ const NODE_TEXT_PADDING = 12;
 const GROUP_RX = 8;
 const GROUP_LABEL_FONT_SIZE = 14;
 const GROUP_LABEL_ZONE = 32;
+// % tint floor so the ramp minimum still reads as "low, present" (mirror map).
+const RAMP_FLOOR = 15;
+const VALUE_FONT_SIZE = 11;
 
 type D3G = d3Selection.Selection<SVGGElement, unknown, null, undefined>;
 type D3Svg = d3Selection.Selection<SVGSVGElement, unknown, null, undefined>;
@@ -184,8 +189,30 @@ function nodeColors(
   activeGroupName: string | null,
   palette: PaletteColors,
   isDark: boolean,
+  value: {
+    active: boolean;
+    hue: string;
+    fillForValue: (v: number) => string;
+  },
   solid?: boolean
 ): { fill: string; stroke: string; text: string } {
+  // Untagged-neutral fill, reused by the value path for no-value boxes.
+  const neutralFill = mix(palette.bg, palette.text, isDark ? 90 : 95);
+  // Value dimension active: choropleth tint by the node's value, neutral when a
+  // box has no value (mirror map: `value !== undefined ? fillForValue : neutral`).
+  if (value.active) {
+    const fill =
+      node.value !== undefined ? value.fillForValue(node.value) : neutralFill;
+    // Stroke = the ramp hue (NOT a tag color — there may be none); a present
+    // stroke is required for the app's --bl-node-stroke hover-dim to work.
+    const stroke = value.hue;
+    const text = contrastText(
+      fill,
+      palette.textOnFillLight,
+      palette.textOnFillDark
+    );
+    return { fill, stroke, text };
+  }
   const tagColor = resolveTagColor(
     node.metadata,
     [...tagGroups],
@@ -368,6 +395,83 @@ export function renderBoxesAndLines(
   const sGroupLabelZone = sctx.structural(GROUP_LABEL_ZONE);
   const sTitleFontSize = sctx.text(TITLE_FONT_SIZE);
   const sTitleY = sctx.structural(TITLE_Y);
+
+  // ── Value ramp + active-dimension resolution (mirror of map's value model) ──
+  // The ramp is computed in the renderer (architectural divergence from the
+  // map, which precomputes in layout) — node sizes are value-independent, and
+  // this file already owns all colouring + the legend build. Hoisted ONCE
+  // before the node loop so `fillForValue` is not recomputed per node.
+  const nodeValues = parsed.nodes
+    .filter((n) => n.value !== undefined)
+    .map((n) => n.value!);
+  const hasRamp = nodeValues.length > 0;
+  const allNonNegative = hasRamp && nodeValues.every((v) => v >= 0);
+  const rampMin = allNonNegative ? 0 : Math.min(...nodeValues);
+  const rampMax = Math.max(...nodeValues);
+  // Default hue = palette.primary (NOT red like the map — boxes have no water to
+  // stand out against, and red reads as alarm on a neutral metric). A trailing
+  // color on `box-metric` overrides.
+  const rampHue =
+    resolveColor(parsed.boxMetricColor ?? '', palette) ?? palette.primary;
+  // Lift the ramp anchor off the near-black surface on dark themes so the
+  // lowest values read as a clear muted tint rather than sinking to the surface.
+  const rampBase = isDark ? mix(palette.surface, palette.text, 28) : palette.bg;
+  const fillForValue = (v: number): string => {
+    const t = rampMax > rampMin ? (v - rampMin) / (rampMax - rampMin) : 1;
+    const pct = RAMP_FLOOR + Math.max(0, Math.min(1, t)) * (100 - RAMP_FLOOR);
+    return mix(rampHue, rampBase, pct);
+  };
+  const VALUE_NAME = hasRamp ? parsed.boxMetric?.trim() || 'Value' : null;
+
+  // Local active-dimension resolver — mirror map's inline matchColorGroup /
+  // activeIsScore. Do NOT extend the shared resolveActiveTagGroup (it has a
+  // fixed 3-arg signature consumed by 7 chart types). On a name collision
+  // between a tag group and the metric label, the tag group wins (AC9).
+  const matchColorGroup = (v: string): string | null => {
+    const lv = v.trim().toLowerCase();
+    if (lv === 'none') return null;
+    const tg = parsed.tagGroups.find((g) => g.name.toLowerCase() === lv);
+    if (tg) return tg.name;
+    if (lv === VALUE_NAME?.toLowerCase()) return VALUE_NAME;
+    return v; // unknown name passes through → renders neutral
+  };
+  const override = activeTagGroup; // string | null | undefined
+  let activeGroup: string | null;
+  if (override !== undefined) {
+    activeGroup = override === null ? null : matchColorGroup(override);
+  } else if (parsed.options['active-tag'] !== undefined) {
+    activeGroup = matchColorGroup(parsed.options['active-tag']);
+  } else {
+    // Default-active dimension: value ramp when any box has a value, else the
+    // first declared tag group, else none.
+    activeGroup =
+      VALUE_NAME ??
+      (parsed.tagGroups.length > 0 ? parsed.tagGroups[0]!.name : null);
+  }
+  const activeIsValue = VALUE_NAME !== null && activeGroup === VALUE_NAME;
+
+  // Synthetic legend group for the value ramp (empty entries + gradient),
+  // prepended to the tag groups handed to renderLegendD3 — exactly like the
+  // map's VALUE_NAME group. The shared legend infra renders the gradient capsule
+  // ONLY when it is the active group (legendState.activeGroup === its name).
+  const valueGroup: LegendGroupData | null =
+    VALUE_NAME !== null
+      ? {
+          name: VALUE_NAME,
+          entries: [],
+          gradient: {
+            min: rampMin,
+            max: rampMax,
+            hue: rampHue,
+            base: rampBase,
+          },
+        }
+      : null;
+  const legendGroups: readonly LegendGroupData[] = [
+    ...(valueGroup ? [valueGroup] : []),
+    ...parsed.tagGroups,
+  ];
+
   // Reserve legend height only when a legend will actually render. App-hosted
   // controls move the Descriptions toggle to the app overlay, so a
   // descriptions-only chart (no tag groups) reserves nothing.
@@ -375,13 +479,13 @@ export function renderBoxesAndLines(
     (n) => n.description && n.description.length > 0
   );
   const willRenderLegend =
-    parsed.tagGroups.length > 0 ||
+    legendGroups.length > 0 ||
     (reserveHasDescriptions && controlsHost !== 'app');
   const sLegendHeight = willRenderLegend
     ? sctx.structural(
         getMaxLegendReservedHeight(
           {
-            groups: parsed.tagGroups,
+            groups: legendGroups,
             position: { placement: 'top-center', titleRelation: 'below-title' },
             mode: exportMode ? 'export' : 'preview',
           },
@@ -390,12 +494,6 @@ export function renderBoxesAndLines(
       )
     : 0;
 
-  const activeGroup = resolveActiveTagGroup(
-    parsed.tagGroups,
-    parsed.options['active-tag'],
-    activeTagGroup
-  );
-
   // Build hidden set
   const hidden = hiddenTagValues ?? parsed.initialHiddenTagValues;
 
@@ -414,7 +512,7 @@ export function renderBoxesAndLines(
     (n) => n.description && n.description.length > 0
   );
   const needsLegend =
-    parsed.tagGroups.length > 0 || (hasAnyDescriptions && onToggleDescriptions);
+    legendGroups.length > 0 || (hasAnyDescriptions && onToggleDescriptions);
   const legendH = needsLegend ? sLegendHeight + 8 : 0;
 
   const groupLabelsSet = new Set(layout.groups.map((g) => g.label));
@@ -809,6 +907,7 @@ export function renderBoxesAndLines(
       activeGroup,
       palette,
       isDark,
+      { active: activeIsValue, hue: rampHue, fillForValue },
       parsed.options['solid-fill'] === 'on'
     );
 
@@ -826,6 +925,12 @@ export function renderBoxesAndLines(
       nodeG.attr(`data-tag-${key.toLowerCase()}`, val.toLowerCase());
     }
 
+    // Numeric value drives the gradient scrub; guard on !== undefined so a
+    // legitimate `value: 0` still emits data-value="0" (0 is falsy).
+    if (node.value !== undefined) {
+      nodeG.attr('data-value', node.value);
+    }
+
     if (onClickItem) {
       nodeG.on('click', (event: Event) => {
         // Don't intercept clicks on links in description text
@@ -1004,6 +1109,58 @@ export function renderBoxesAndLines(
           .text(fitted.lines[li]!);
       }
     }
+
+    // ── show-values: print the numeric value as text (opt-in) ──
+    // Independent of the active dimension (a user may want the numbers printed
+    // while a tag group tints). Plain nodes: centered below the label. Described
+    // nodes: a top-right corner badge so it never overflows the full body (R2-6).
+    if (parsed.showValues && node.value !== undefined) {
+      const valueText = String(node.value);
+      const descShown = !!(desc && desc.length > 0 && !hideDescriptions);
+      if (descShown) {
+        // Corner badge — pill behind the number so it reads over the header.
+        const padX = 6;
+        const padY = 5;
+        const bw = valueText.length * VALUE_FONT_SIZE * CHAR_WIDTH_RATIO + 8;
+        const bh = VALUE_FONT_SIZE + 4;
+        const bx = ln.width / 2 - bw - 4;
+        const by = -ln.height / 2 + 4;
+        nodeG
+          .append('rect')
+          .attr('x', bx)
+          .attr('y', by)
+          .attr('width', bw)
+          .attr('height', bh)
+          .attr('rx', 3)
+          .attr('fill', palette.bg)
+          .attr('opacity', 0.85);
+        nodeG
+          .append('text')
+          .attr('class', 'bl-node-value')
+          .attr('x', bx + bw - padX)
+          .attr('y', by + padY)
+          .attr('text-anchor', 'end')
+          .attr('dominant-baseline', 'central')
+          .attr('font-size', VALUE_FONT_SIZE)
+          .attr('font-weight', '600')
+          .attr('fill', palette.textMuted)
+          .text(valueText);
+      } else {
+        // Plain node: value centered just above the bottom edge.
+        nodeG
+          .append('text')
+          .attr('class', 'bl-node-value')
+          .attr('x', 0)
+          .attr('y', ln.height / 2 - VALUE_FONT_SIZE)
+          .attr('text-anchor', 'middle')
+          .attr('dominant-baseline', 'central')
+          .attr('font-size', VALUE_FONT_SIZE)
+          .attr('font-weight', '600')
+          .attr('fill', colors.text)
+          .attr('opacity', 0.8)
+          .text(valueText);
+      }
+    }
   }
 
   // ── Render legend ──────────────────────────────────────
@@ -1011,9 +1168,10 @@ export function renderBoxesAndLines(
     (n) => n.description && n.description.length > 0
   );
   // App-hosted: the Descriptions control moves to the app overlay, so a
-  // descriptions-only legend (no tag groups) has nothing left to render.
+  // descriptions-only legend (no tag groups) has nothing left to render. The
+  // value ramp (a synthetic group in legendGroups) also forces a legend.
   const hasLegend =
-    parsed.tagGroups.length > 0 || (hasDescriptions && controlsHost !== 'app');
+    legendGroups.length > 0 || (hasDescriptions && controlsHost !== 'app');
 
   if (hasLegend) {
     // Build controls group for description toggle. App-hosted controls own the
@@ -1035,7 +1193,7 @@ export function renderBoxesAndLines(
     }
 
     const legendConfig: LegendConfig = {
-      groups: parsed.tagGroups,
+      groups: legendGroups,
       position: { placement: 'top-center', titleRelation: 'below-title' },
       mode: exportMode ? 'export' : 'preview',
       // Keep inactive sibling tag groups visible as collapsed pills so the user

package/src/boxes-and-lines/types.ts

@@ -6,6 +6,9 @@ export interface BLNode {
   readonly lineNumber: number;
   readonly metadata: Readonly<Record<string, string>>;
   readonly description?: readonly string[];
+  /** Numeric measure lifted from `value: X` metadata (mirror of map's
+   *  `region.value`). Drives the value ramp / choropleth tinting. */
+  readonly value?: number;
 }
 
 export interface BLEdge {
@@ -36,6 +39,12 @@ export interface ParsedBoxesAndLines {
   readonly options: Readonly<Record<string, string>>;
   readonly initialHiddenTagValues: ReadonlyMap<string, ReadonlySet<string>>;
   readonly direction: 'LR' | 'TB';
+  /** `box-metric <label> [color]` — names the value-ramp dimension and
+   *  optionally sets its hue. Mirror of map's `region-metric`. */
+  readonly boxMetric?: string;
+  readonly boxMetricColor?: string;
+  /** `show-values` — print each box's numeric value as text (opt-in). */
+  readonly showValues?: boolean;
   readonly diagnostics: readonly DgmoError[];
   readonly error: string | null;
 }

package/src/completion.ts

@@ -447,6 +447,8 @@ export const COMPLETION_REGISTRY = new Map<string, DirectiveSpec>([
       direction: { description: 'Layout direction', values: ['LR', 'TB'] },
       'active-tag': { description: 'Active tag group name' },
       hide: { description: 'Hide tag:value pairs' },
+      'box-metric': { description: 'Metric label for the value ramp' },
+      'show-values': { description: 'Print box values as text' },
     }),
   ],
   [
@@ -740,12 +742,9 @@ export const PIPE_METADATA = new Map<string, PipeContextMap>([
     {
       node: {
         description: { description: 'Node description text' },
+        value: { description: 'Numeric value for the metric ramp' },
       },
-      edge: {
-        width: { description: 'Edge stroke width in pixels' },
-        split: { description: 'Traffic split percentage' },
-        fanout: { description: 'Fanout multiplier (integer >= 1)' },
-      },
+      edge: {},
     },
   ],
   [

package/src/d3.ts

@@ -4301,8 +4301,16 @@ function renderTimelineHorizontalTimeSort(
     ? -(topScaleH + markerReserve + ERA_ROW_H / 2)
     : 0;
   const innerWidth = width - margin.left - margin.right;
-  const innerHeight = height - margin.top - margin.bottom;
-  const rowH = Math.min(ctx.structural(28), innerHeight / sorted.length);
+  const availInnerHeight = height - margin.top - margin.bottom;
+  const rowH = Math.min(ctx.structural(28), availInnerHeight / sorted.length);
+  // Each event needs only `rowH` of vertical space. When the container is
+  // taller than the rows require (rowH hits its 28px cap), draw the era
+  // bands and time axis to the content height instead of the full container
+  // so the axis sits just below the last event rather than leaving a large
+  // vertical gap. The SVG itself shrinks to match (top-aligned via
+  // preserveAspectRatio) so callers don't reserve dead space below the chart.
+  const innerHeight = rowH * sorted.length;
+  const usedHeight = margin.top + innerHeight + margin.bottom;
 
   const xScale = d3Scale
     .scaleLinear()
@@ -4313,8 +4321,8 @@ function renderTimelineHorizontalTimeSort(
     .select(container)
     .append('svg')
     .attr('width', width)
-    .attr('height', height)
-    .attr('viewBox', `0 0 ${width} ${height}`)
+    .attr('height', usedHeight)
+    .attr('viewBox', `0 0 ${width} ${usedHeight}`)
     .attr('preserveAspectRatio', 'xMidYMin meet')
     .style('background', bgColor);
 

package/src/editor/keywords.ts

@@ -110,6 +110,9 @@ export const DIRECTIVE_KEYWORDS = new Set([
   'hide',
   'mode',
   'direction',
+  // Boxes-and-lines
+  'box-metric',
+  'show-values',
   // ER
   'notation',
   // Class

package/src/map/data/PROVENANCE.json

@@ -1 +1 @@
-{"assets":{"gazetteer.json":{"bytes":130706,"gzBytes":56251,"sha256":"8cefc36db73c9337429e66c94339a385656de3ec22a67487b0a146aa37dd632a"},"lakes.json":{"bytes":6315,"gzBytes":1487,"sha256":"5840ffd49b8dbf30183a9534a72adf80b6e77ceec224665393fa94e956220323"},"mountain-ranges.json":{"bytes":30081,"gzBytes":8971,"sha256":"b0eb87e6b3c514b882245299fbe698b3caaa3f40494e3d220f973caf6a12a16c"},"region-names.json":{"bytes":11667,"gzBytes":2235,"sha256":"059662d30b6ee8572c5943096905e05218e5f337e6973a9d43d6b41b7313a9ac"},"rivers.json":{"bytes":6707,"gzBytes":2158,"sha256":"3912508469099b1c37360c5505ea033c4ffa30ce95f7428e668e9d824cb81407"},"us-states.json":{"bytes":23313,"gzBytes":7413,"sha256":"0fe3a8937bc7566192662439f29a7866e8823d687290bcb003433ad5edd86567"},"world-coarse.json":{"bytes":55426,"gzBytes":18390,"sha256":"9ed5a15d775c0a303003dcf096a209dd433383ea52e18014885d482c38bc01a4"},"world-detail.json":{"bytes":163555,"gzBytes":46762,"sha256":"e99dddc3fccd96465ad4e5cd7bcca839095672e9c595d78276d510c44db84fd7"}},"counts":{"countries":175,"gazetteerAliases":8,"gazetteerCities":2118,"mountainRanges":114,"usStates":56},"generatedBy":"scripts/build-map-data.mjs","sourceHashes":{"https://cdn.jsdelivr.net/gh/martynafford/natural-earth-geojson@master/110m/physical/ne_110m_lakes.json":{"bytes":27711,"sha256":"6f315b60488e0cf5da9c360e3ce593babf64c2f44cc21e2820c536f7a2aff606"},"https://cdn.jsdelivr.net/gh/martynafford/natural-earth-geojson@master/110m/physical/ne_110m_rivers_lake_centerlines.json":{"bytes":54146,"sha256":"959e13128e4eb5a6ee530b8270c5017bcee9149ce48a97f6fe7fee1fce600b5d"},"https://cdn.jsdelivr.net/gh/nvkelso/natural-earth-vector@master/geojson/ne_50m_geography_regions_polys.geojson":{"bytes":4305815,"sha256":"33396643d8f0eed408e80bf5ca43dcdb7993f790fdc4eadae311660f8b91fe76"},"https://cdn.jsdelivr.net/npm/us-atlas@3.0.1/states-10m.json":{"bytes":114554,"sha256":"d76b391ccfa8bff601d51e3e3da5d43a89fa46cd5caca72ce731b383be5596d0"},"https://cdn.jsdelivr.net/npm/world-atlas@2.0.2/countries-110m.json":{"bytes":107761,"sha256":"2516c915867c7baf18ddec727aec46c315541a07cfb3d79a6559b05d5e94eee8"},"https://cdn.jsdelivr.net/npm/world-atlas@2.0.2/countries-50m.json":{"bytes":756420,"sha256":"04342cdc1e3016bcd7db1630de95684d67b79fe3c8c460321e87aef469502394"},"https://download.geonames.org/export/dump/cities5000.zip":{"bytes":5546862,"sha256":"e898c1399b05bd521540c5fa56ac3db44b4b2029d432b5f40a1e45f66d5a0929"}},"sources":{"geonames":{"citiesUrl":"https://download.geonames.org/export/dump/cities5000.zip","license":"CC BY 4.0 — https://creativecommons.org/licenses/by/4.0/","modificationDateRange":"2006-01-17..2026-05-25 (filtered subset)"},"lakes":{"url":"https://cdn.jsdelivr.net/gh/martynafford/natural-earth-geojson@master/110m/physical/ne_110m_lakes.json","version":"natural-earth 110m (martynafford snapshot)"},"mountainRanges":{"license":"public domain (Natural Earth)","url":"https://cdn.jsdelivr.net/gh/nvkelso/natural-earth-vector@master/geojson/ne_50m_geography_regions_polys.geojson","version":"natural-earth 50m (nvkelso vector snapshot)"},"rivers":{"url":"https://cdn.jsdelivr.net/gh/martynafford/natural-earth-geojson@master/110m/physical/ne_110m_rivers_lake_centerlines.json","version":"natural-earth 110m (martynafford snapshot)"},"usAtlas":{"url":"https://cdn.jsdelivr.net/npm/us-atlas@3.0.1/states-10m.json","version":"3.0.1"},"worldCoarse":{"url":"https://cdn.jsdelivr.net/npm/world-atlas@2.0.2/countries-110m.json","version":"2.0.2"},"worldDetail":{"url":"https://cdn.jsdelivr.net/npm/world-atlas@2.0.2/countries-50m.json","version":"2.0.2"}},"tooling":{"mapshaper":"0.7.22"}}
+{"assets":{"gazetteer.json":{"bytes":130767,"gzBytes":56261,"sha256":"5ad56e5ba0b3a4f9a6dc8bd3bf8b0fda0e7b86cbe4d85d231114f5dd967d65f7"},"lakes.json":{"bytes":6315,"gzBytes":1487,"sha256":"5840ffd49b8dbf30183a9534a72adf80b6e77ceec224665393fa94e956220323"},"mountain-ranges.json":{"bytes":90845,"gzBytes":26493,"sha256":"a698b3f296e61712fb39b3d8d42ec7c4699f8aadecb549367feb7d09f7785580"},"na-lakes.json":{"bytes":39387,"gzBytes":11281,"sha256":"2a41c04969209380d544a09efe354277e12d704458af95955201eb4f698d16c6"},"na-land.json":{"bytes":114082,"gzBytes":32375,"sha256":"7b94c9bb4e809c22813da5ae939e1ff6a781fd77a04d9c1585a9a82d2a195388"},"region-names.json":{"bytes":11667,"gzBytes":2235,"sha256":"059662d30b6ee8572c5943096905e05218e5f337e6973a9d43d6b41b7313a9ac"},"rivers.json":{"bytes":6707,"gzBytes":2158,"sha256":"3912508469099b1c37360c5505ea033c4ffa30ce95f7428e668e9d824cb81407"},"us-states.json":{"bytes":23313,"gzBytes":7413,"sha256":"0fe3a8937bc7566192662439f29a7866e8823d687290bcb003433ad5edd86567"},"water-bodies.json":{"bytes":4854,"gzBytes":2123,"sha256":"6d1a407a376c63518329c52189e2887053c4b61062af0597e060050ae8469635"},"world-coarse.json":{"bytes":55436,"gzBytes":18397,"sha256":"5cb42e3c8975dde56504ca5c68ece0a1e71d0929680b5fc8cdab758c8666dbf8"},"world-detail.json":{"bytes":163562,"gzBytes":46767,"sha256":"39f1736eaabe9e21190972be3157822be22ee84fdc41751237f2b516f09a7586"}},"counts":{"countries":175,"gazetteerAliases":8,"gazetteerCities":2119,"mountainRanges":205,"usStates":56,"waterBodies":113},"generatedBy":"scripts/build-map-data.mjs","sourceHashes":{"https://cdn.jsdelivr.net/gh/martynafford/natural-earth-geojson@master/10m/physical/ne_10m_lakes.json":{"bytes":6648697,"sha256":"93c8fdf0e591e113f449d0d466e15c7a9841b9b6571c7afe41f95ba51b322452"},"https://cdn.jsdelivr.net/gh/martynafford/natural-earth-geojson@master/110m/physical/ne_110m_lakes.json":{"bytes":27711,"sha256":"6f315b60488e0cf5da9c360e3ce593babf64c2f44cc21e2820c536f7a2aff606"},"https://cdn.jsdelivr.net/gh/martynafford/natural-earth-geojson@master/110m/physical/ne_110m_rivers_lake_centerlines.json":{"bytes":54146,"sha256":"959e13128e4eb5a6ee530b8270c5017bcee9149ce48a97f6fe7fee1fce600b5d"},"https://cdn.jsdelivr.net/gh/nvkelso/natural-earth-vector@master/geojson/ne_10m_admin_0_countries.geojson":{"bytes":13287234,"sha256":"239eec57ac17f100a11e2536cffc56752c318b50ae765b0918ff7aab4ce8f255"},"https://cdn.jsdelivr.net/gh/nvkelso/natural-earth-vector@master/geojson/ne_10m_geography_regions_polys.geojson":{"bytes":5583870,"sha256":"b7b26e50ea917d3696aec87f932def2bf5f890f5770e441d59c162c6f4c92a77"},"https://cdn.jsdelivr.net/gh/nvkelso/natural-earth-vector@master/geojson/ne_110m_geography_marine_polys.geojson":{"bytes":534055,"sha256":"b9c3f7f557d0ff5217906adc82b66ecdac14aa7438df7e518cf6675d037bceb8"},"https://cdn.jsdelivr.net/gh/nvkelso/natural-earth-vector@master/geojson/ne_50m_geography_marine_polys.geojson":{"bytes":1163418,"sha256":"6fe58083e0cc5c7fad9e396970e28a8580bbd8770cfa4d1d7b5a34423e912f97"},"https://cdn.jsdelivr.net/npm/us-atlas@3.0.1/states-10m.json":{"bytes":114554,"sha256":"d76b391ccfa8bff601d51e3e3da5d43a89fa46cd5caca72ce731b383be5596d0"},"https://cdn.jsdelivr.net/npm/world-atlas@2.0.2/countries-110m.json":{"bytes":107761,"sha256":"2516c915867c7baf18ddec727aec46c315541a07cfb3d79a6559b05d5e94eee8"},"https://cdn.jsdelivr.net/npm/world-atlas@2.0.2/countries-50m.json":{"bytes":756420,"sha256":"04342cdc1e3016bcd7db1630de95684d67b79fe3c8c460321e87aef469502394"},"https://download.geonames.org/export/dump/cities5000.zip":{"bytes":5549002,"sha256":"d20e28b2f610da34c21fd82ff6a8e4d24ebe67eba2dccf65bd2c4332ff0f380a"}},"sources":{"geonames":{"citiesUrl":"https://download.geonames.org/export/dump/cities5000.zip","license":"CC BY 4.0 — https://creativecommons.org/licenses/by/4.0/","modificationDateRange":"2006-01-17..2026-06-02 (filtered subset)"},"lakes":{"url":"https://cdn.jsdelivr.net/gh/martynafford/natural-earth-geojson@master/110m/physical/ne_110m_lakes.json","version":"natural-earth 110m (martynafford snapshot)"},"marineCoarse":{"url":"https://cdn.jsdelivr.net/gh/nvkelso/natural-earth-vector@master/geojson/ne_110m_geography_marine_polys.geojson","version":"natural-earth 110m (nvkelso vector snapshot)"},"marineDetail":{"url":"https://cdn.jsdelivr.net/gh/nvkelso/natural-earth-vector@master/geojson/ne_50m_geography_marine_polys.geojson","version":"natural-earth 50m (nvkelso vector snapshot)"},"mountainRanges":{"url":"https://cdn.jsdelivr.net/gh/nvkelso/natural-earth-vector@master/geojson/ne_10m_geography_regions_polys.geojson","version":"natural-earth 10m (nvkelso vector snapshot)"},"naLakes":{"url":"https://cdn.jsdelivr.net/gh/martynafford/natural-earth-geojson@master/10m/physical/ne_10m_lakes.json","version":"natural-earth 10m (martynafford snapshot)"},"naLand":{"url":"https://cdn.jsdelivr.net/gh/nvkelso/natural-earth-vector@master/geojson/ne_10m_admin_0_countries.geojson","version":"natural-earth 10m (nvkelso vector snapshot)"},"rivers":{"url":"https://cdn.jsdelivr.net/gh/martynafford/natural-earth-geojson@master/110m/physical/ne_110m_rivers_lake_centerlines.json","version":"natural-earth 110m (martynafford snapshot)"},"usAtlas":{"url":"https://cdn.jsdelivr.net/npm/us-atlas@3.0.1/states-10m.json","version":"3.0.1"},"worldCoarse":{"url":"https://cdn.jsdelivr.net/npm/world-atlas@2.0.2/countries-110m.json","version":"2.0.2"},"worldDetail":{"url":"https://cdn.jsdelivr.net/npm/world-atlas@2.0.2/countries-50m.json","version":"2.0.2"}},"tooling":{"mapshaper":"0.7.22"}}

package/src/map/data/README.md

@@ -10,6 +10,10 @@ hand-edit — regenerate from source.
 - `us-states.json` — US states + DC + territories (TopoJSON), keyed by ISO 3166-2.
 - `lakes.json` — major lakes (Natural Earth 110m, TopoJSON), drawn as water over land.
 - `rivers.json` — major river centerlines (Natural Earth 110m, TopoJSON), drawn as thin water lines.
+- `na-land.json` — NA-clipped 10m country land (TopoJSON, ISO-keyed): crisp neighbour context under the albers-usa US view.
+- `na-lakes.json` — NA-clipped 10m major lakes (TopoJSON): the lakes counterpart to `na-land.json` for the US view.
+- `mountain-ranges.json` — notable mountain ranges (Natural Earth 50m geography regions, FEATURECLA "Range/mtn", TopoJSON), drawn as a subtle gradient relief cue when the `relief` directive is on. Optional; single tier (no elevation).
+- `water-bodies.json` — water-body orientation labels (`{ entries: [lat, lon, name, tier, kind] }`) from Natural Earth 110m+50m geography marine polys (oceans/seas/gulfs/bays/straits/channels/sounds; rivers + reefs excluded). Anchors are mapshaper inner points; `tier` is the NE scalerank. Drawn only when the `context-labels` directive is on. Optional.
 - `gazetteer.json` — `{ cities, byName, alt }` city index (see `types.ts`).
   `byName`/`alt` reference `cities` by array index (normalized).
 - `PROVENANCE.json` — source versions + per-asset sha256/sizes + GeoNames date range.
@@ -18,6 +22,8 @@ hand-edit — regenerate from source.
 ## Sources & attribution
 - **Country boundaries:** Natural Earth via `world-atlas@2.0.2` (public domain).
 - **US states:** US Census via `us-atlas@3.0.1` (public domain).
+- **Mountain ranges:** Natural Earth 50m `geography_regions_polys` via `nvkelso/natural-earth-vector` (public domain).
+- **Water bodies:** Natural Earth 110m+50m `geography_marine_polys` via `nvkelso/natural-earth-vector` (public domain). One editorial override applied (`Gulf of Mexico` → `Gulf of America`).
 - **Cities:** Data © **GeoNames**, licensed under **CC BY 4.0**
   (https://creativecommons.org/licenses/by/4.0/) — https://www.geonames.org/.