@rankonelabs/livid-svg 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Steven Ciraolo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,77 @@
+# @rankonelabs/livid-svg
+
+`LaidOutDiagram` to an SVG string, for [livid](https://github.com/RankOneLabs/livid).
+
+Build-time only. No DOM, no client JS, and nothing measured — geometry arrives
+from [`@rankonelabs/livid-core`](https://www.npmjs.com/package/@rankonelabs/livid-core)
+already computed, so this package draws and does not lay out. That is what makes
+the SVG in a post and the React canvas in an app the *same map* rather than two
+drawings that drifted.
+
+## Install
+
+```
+npm install @rankonelabs/livid-svg @rankonelabs/livid-core
+```
+
+Core is a peer dependency, and the only one. Nothing is imported at runtime —
+this package emits zero dependencies of its own.
+
+## Use
+
+```ts
+import { layout, validateDiagram } from '@rankonelabs/livid-core'
+import { renderSvg } from '@rankonelabs/livid-svg'
+
+const valid = validateDiagram(registry, spec)
+if (!valid.ok) return valid.error
+
+const laid = await layout(valid.value)
+if (!laid.ok) return laid.error
+
+const svg = renderSvg(laid.value, {
+  title: 'Refund approval at HITL',
+  theme: { palette: { lines: { 'line-critical': '#D64500', 'line-parallel': '#1B6CA8' } } },
+})
+```
+
+## Labels
+
+Boxes carry their own text. Circles and diamonds cannot — core holds them to a
+fixed width because growing one distorts it past recognition, and shape carries
+type — so their labels sit alongside with a leader tick, which is also how a
+transit map names a junction. Set `metrics.labelSide` to `right` for a
+top-to-bottom layout.
+
+Text is estimated rather than measured (there is no DOM at build time) and the
+estimate errs wide: a label with room to spare reads fine, a clipped one does
+not. The viewport always includes outside labels, so nothing is cut off.
+
+## Colour
+
+`LineSpec.color` is a token, not a colour — core has no palette. Configure
+tokens through `palette.lines`; any token left unconfigured takes a colour from
+`palette.ramp` by line order, so an unthemed diagram still renders as a map
+rather than one grey tangle.
+
+An edge takes the colour of where it is *going*. Track between two stations on
+one line is that line; track leaving a router onto another line already belongs
+to the new one, which is what makes an interchange read as a change. Edges that
+cross lines are drawn at `branchWeight`, lighter than the track they leave.
+
+## Drill-down
+
+Levels are stacked, not made interactive: a static file has to contain every
+level it can reveal, and stacking reveals them without script. Pass
+`levels: 'root'` to draw only the top. Descending on demand belongs to the React
+renderer.
+
+Feed it `layoutDeep()` output if you want nested levels to have geometry.
+
+## Configuration
+
+Everything visual is config — `palette`, `typography`, `metrics` — and nothing
+is component injection. Both renderers are closed, which is what guarantees they
+agree.
+
+MIT.

package/dist/.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../src/geometry.ts","../src/index.ts","../src/render.ts","../src/shapes.ts","../src/theme.ts"],"version":"5.9.3"}

package/dist/geometry.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Where things sit. Core lays out the graph; this works out what the graph's
+ * *labels* need on top of that, which core cannot know because it has no
+ * opinion about type.
+ */
+import type { NodeShape, Point, Size } from '@rankonelabs/livid-core';
+import type { Metrics, Typography } from './theme.js';
+export interface Box {
+    readonly minX: number;
+    readonly minY: number;
+    readonly maxX: number;
+    readonly maxY: number;
+}
+export declare function boxOf(position: Point, size: Size): Box;
+export declare const EMPTY_BOX: Box;
+export declare function unionOf(boxes: readonly Box[]): Box;
+export declare function boxAround(points: readonly Point[], slack: number): Box;
+/**
+ * Text is estimated, not measured: rendering happens at build time with no DOM
+ * and no font metrics. The estimate only has to be good enough to reserve
+ * space, and it errs wide — a label with room to spare reads fine, a clipped
+ * one does not.
+ */
+export declare function estimateTextWidth(text: string, fontSize: number, advanceRatio: number): number;
+/**
+ * Whether a shape can carry its own label.
+ *
+ * Circles and diamonds cannot: core holds them to a fixed width because
+ * growing one distorts it past recognition, and shape carries type. So their
+ * names sit alongside, which is also how a transit map names a junction.
+ */
+export type LabelPlacement = 'inside' | 'beside';
+export declare function labelPlacementOf(shape: NodeShape): LabelPlacement;
+export interface PlacedLabel {
+    readonly text: string;
+    readonly x: number;
+    readonly y: number;
+    readonly anchor: 'middle' | 'start';
+    /** Space the label occupies, which the viewport has to include. */
+    readonly box: Box;
+    /** Tick from the shape out to the label; absent when the label is inside. */
+    readonly leader: readonly [Point, Point] | null;
+}
+export declare function placeLabel(text: string, shape: NodeShape, position: Point, size: Size, typography: Typography, metrics: Metrics): PlacedLabel;
+//# sourceMappingURL=geometry.d.ts.map

package/dist/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../src/geometry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,WAAW,GAAG;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,GAAG,GAAG,CAOtD;AAED,eAAO,MAAM,SAAS,EAAE,GAA0E,CAAC;AAEnG,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,EAAE,GAAG,GAAG,CAUlD;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,CAStE;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAE9F;AAED;;;;;;GAMG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAIjD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,GAAG,cAAc,CAEjE;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAAC;IACpC,mEAAmE;IACnE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC;CACjD;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,EAChB,QAAQ,EAAE,KAAK,EACf,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,OAAO,GACf,WAAW,CAoDb"}

package/dist/geometry.js

@@ -0,0 +1,94 @@
+/**
+ * Where things sit. Core lays out the graph; this works out what the graph's
+ * *labels* need on top of that, which core cannot know because it has no
+ * opinion about type.
+ */
+export function boxOf(position, size) {
+    return {
+        minX: position.x,
+        minY: position.y,
+        maxX: position.x + size.width,
+        maxY: position.y + size.height,
+    };
+}
+export const EMPTY_BOX = { minX: Infinity, minY: Infinity, maxX: -Infinity, maxY: -Infinity };
+export function unionOf(boxes) {
+    return boxes.reduce((left, right) => ({
+        minX: Math.min(left.minX, right.minX),
+        minY: Math.min(left.minY, right.minY),
+        maxX: Math.max(left.maxX, right.maxX),
+        maxY: Math.max(left.maxY, right.maxY),
+    }), EMPTY_BOX);
+}
+export function boxAround(points, slack) {
+    return unionOf(points.map((point) => ({
+        minX: point.x - slack,
+        minY: point.y - slack,
+        maxX: point.x + slack,
+        maxY: point.y + slack,
+    })));
+}
+/**
+ * Text is estimated, not measured: rendering happens at build time with no DOM
+ * and no font metrics. The estimate only has to be good enough to reserve
+ * space, and it errs wide — a label with room to spare reads fine, a clipped
+ * one does not.
+ */
+export function estimateTextWidth(text, fontSize, advanceRatio) {
+    return text.length * fontSize * advanceRatio;
+}
+const POINT_SHAPES = new Set(['circle', 'diamond']);
+export function labelPlacementOf(shape) {
+    return POINT_SHAPES.has(shape) ? 'beside' : 'inside';
+}
+export function placeLabel(text, shape, position, size, typography, metrics) {
+    const width = estimateTextWidth(text, typography.labelSize, typography.advanceRatio);
+    const height = typography.labelSize;
+    const centreX = position.x + size.width / 2;
+    const centreY = position.y + size.height / 2;
+    if (labelPlacementOf(shape) === 'inside') {
+        // Dominant-baseline is unreliable across renderers, so the baseline is
+        // nudged by a third of the cap height instead.
+        const y = centreY + height / 3;
+        return {
+            text,
+            x: centreX,
+            y,
+            anchor: 'middle',
+            box: boxOf(position, size),
+            leader: null,
+        };
+    }
+    if (metrics.labelSide === 'right') {
+        const startX = position.x + size.width + metrics.leader + metrics.labelGap;
+        return {
+            text,
+            x: startX,
+            y: centreY + height / 3,
+            anchor: 'start',
+            box: { minX: startX, minY: centreY - height, maxX: startX + width, maxY: centreY + height },
+            leader: [
+                { x: position.x + size.width, y: centreY },
+                { x: position.x + size.width + metrics.leader, y: centreY },
+            ],
+        };
+    }
+    const baseline = position.y + size.height + metrics.leader + metrics.labelGap + height;
+    return {
+        text,
+        x: centreX,
+        y: baseline,
+        anchor: 'middle',
+        box: {
+            minX: centreX - width / 2,
+            minY: position.y + size.height,
+            maxX: centreX + width / 2,
+            maxY: baseline + metrics.labelGap,
+        },
+        leader: [
+            { x: centreX, y: position.y + size.height },
+            { x: centreX, y: position.y + size.height + metrics.leader },
+        ],
+    };
+}
+//# sourceMappingURL=geometry.js.map

package/dist/geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.js","sourceRoot":"","sources":["../src/geometry.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @rankonelabs/livid-svg — `LaidOutDiagram` to an SVG string.
+ *
+ * Build-time, zero client JS. Geometry comes from core already computed, so
+ * this package measures nothing and lays out nothing; it draws.
+ */
+export { type SvgOptions, renderSvg, escapeText, escapeAttr } from './render.js';
+export { type LabelSide, type Palette, type Typography, type Metrics, type SvgTheme, type SvgThemeOverrides, DEFAULT_PALETTE, DEFAULT_TYPOGRAPHY, DEFAULT_METRICS, DEFAULT_THEME, resolveTheme, lineColour, } from './theme.js';
+export { type Box, type LabelPlacement, type PlacedLabel, boxOf, unionOf, boxAround, estimateTextWidth, labelPlacementOf, placeLabel, } from './geometry.js';
+export { type ShapeStyle, shapeMarkup, glyphMarkup } from './shapes.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEjF,OAAO,EACL,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,YAAY,EACZ,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,KAAK,GAAG,EACR,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,EACL,OAAO,EACP,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,GACX,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,KAAK,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * @rankonelabs/livid-svg — `LaidOutDiagram` to an SVG string.
+ *
+ * Build-time, zero client JS. Geometry comes from core already computed, so
+ * this package measures nothing and lays out nothing; it draws.
+ */
+export { renderSvg, escapeText, escapeAttr } from './render.js';
+export { DEFAULT_PALETTE, DEFAULT_TYPOGRAPHY, DEFAULT_METRICS, DEFAULT_THEME, resolveTheme, lineColour, } from './theme.js';
+export { boxOf, unionOf, boxAround, estimateTextWidth, labelPlacementOf, placeLabel, } from './geometry.js';
+export { shapeMarkup, glyphMarkup } from './shapes.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAmB,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEjF,OAAO,EAOL,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,YAAY,EACZ,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,OAAO,EAIL,KAAK,EACL,OAAO,EACP,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAChB,UAAU,GACX,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAmB,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC"}

package/dist/render.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `LaidOutDiagram` to an SVG string.
+ *
+ * Build-time only: no DOM, no client JS, and nothing measured — geometry
+ * arrives from core already computed. The renderer's whole job is turning
+ * placed boxes and routes into markup, plus the one thing core cannot know,
+ * which is where labels go.
+ *
+ * Drill-down levels are stacked rather than made interactive. A static file
+ * has to contain every level it can reveal, and stacking reveals them without
+ * script; the React renderer is where descending on demand belongs.
+ */
+import type { AnyRegistry, LaidOutDiagram } from '@rankonelabs/livid-core';
+import { type SvgThemeOverrides } from './theme.js';
+export interface SvgOptions {
+    readonly theme?: SvgThemeOverrides;
+    /** Accessible name for the whole figure. */
+    readonly title?: string | null;
+    /** Caption above the top level. Nested levels caption themselves. */
+    readonly caption?: string | null;
+    /** `all` stacks every drill-down level present; `root` draws only the top. */
+    readonly levels?: 'root' | 'all';
+}
+export declare function renderSvg<R extends AnyRegistry>(diagram: LaidOutDiagram<R>, options?: SvgOptions): string;
+export declare function escapeText(value: string): string;
+export declare function escapeAttr(value: string): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAmC,MAAM,yBAAyB,CAAC;AAI5G,OAAO,EAAiB,KAAK,iBAAiB,EAA4B,MAAM,YAAY,CAAC;AAE7F,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IACnC,4CAA4C;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,qEAAqE;IACrE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,8EAA8E;IAC9E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAClC;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,WAAW,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,UAAe,GAAG,MAAM,CAsD7G;AAmKD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/render.js

@@ -0,0 +1,159 @@
+/**
+ * `LaidOutDiagram` to an SVG string.
+ *
+ * Build-time only: no DOM, no client JS, and nothing measured — geometry
+ * arrives from core already computed. The renderer's whole job is turning
+ * placed boxes and routes into markup, plus the one thing core cannot know,
+ * which is where labels go.
+ *
+ * Drill-down levels are stacked rather than made interactive. A static file
+ * has to contain every level it can reveal, and stacking reveals them without
+ * script; the React renderer is where descending on demand belongs.
+ */
+import { boxAround, boxOf, placeLabel, unionOf } from './geometry.js';
+import { glyphMarkup, shapeMarkup } from './shapes.js';
+import { lineColour, resolveTheme } from './theme.js';
+export function renderSvg(diagram, options = {}) {
+    const theme = resolveTheme(options.theme);
+    const { padding, levelGap } = theme.metrics;
+    const levels = levelsOf(diagram, options.caption ?? null, options.levels !== 'root');
+    const rendered = levels.map((level) => renderLevel(level, theme));
+    const captionHeight = theme.typography.captionSize + theme.metrics.labelGap * 2;
+    const width = Math.max(...rendered.map((level) => level.box.maxX - level.box.minX), 0) + padding * 2;
+    const placed = rendered.map((level, index) => {
+        const above = rendered
+            .slice(0, index)
+            .reduce((total, previous) => total + heightOf(previous, captionHeight) + levelGap, 0);
+        return { ...level, top: padding + above };
+    });
+    const height = placed.reduce((total, level) => total + heightOf(level, captionHeight) + levelGap, 0) - levelGap + padding * 2;
+    const body = placed
+        .map((level) => {
+        const captionY = level.top + theme.typography.captionSize;
+        const contentTop = level.caption === null ? level.top : level.top + captionHeight;
+        const shiftX = padding - level.box.minX;
+        const shiftY = contentTop - level.box.minY;
+        return [
+            level.caption === null
+                ? ''
+                : `<text x="${padding}" y="${round(captionY)}" font-family="${escapeAttr(theme.typography.captionFamily)}" ` +
+                    `font-size="${theme.typography.captionSize}" fill="${theme.palette.caption}">${escapeText(level.caption)}</text>`,
+            `<g transform="translate(${round(shiftX)},${round(shiftY)})">`,
+            level.markup,
+            `</g>`,
+        ]
+            .filter((part) => part !== '')
+            .join('\n');
+    })
+        .join(`\n<line x1="${padding}" x2="${round(width - padding)}" y1="0" y2="0" stroke="${theme.palette.divider}" stroke-width="0"/>\n`);
+    const title = options.title ?? null;
+    return [
+        `<svg xmlns="http://www.w3.org/2000/svg" width="${round(width)}" height="${round(height)}" ` +
+            `viewBox="0 0 ${round(width)} ${round(height)}" role="img"${title === null ? '' : ` aria-label="${escapeAttr(title)}"`}>`,
+        title === null ? '' : `<title>${escapeText(title)}</title>`,
+        `<rect width="100%" height="100%" fill="${theme.palette.surface}"/>`,
+        body,
+        `</svg>`,
+    ]
+        .filter((part) => part !== '')
+        .join('\n');
+}
+/** The tree of drill-down levels, flattened depth-first into a stack. */
+function levelsOf(diagram, caption, deep) {
+    const here = { caption, diagram };
+    if (!deep)
+        return [here];
+    const nested = diagram.nodes.flatMap((node) => node.children === null
+        ? []
+        : levelsOf(node.children, caption === null ? node.node.label : `${caption} ▸ ${node.node.label}`, true));
+    return [here, ...nested];
+}
+function heightOf(level, captionHeight) {
+    const content = level.box.maxY - level.box.minY;
+    return level.caption === null ? content : content + captionHeight;
+}
+/* ------------------------------------------------------------------ *
+ * One level
+ * ------------------------------------------------------------------ */
+function renderLevel(level, theme) {
+    const { diagram } = level;
+    const colours = new Map(diagram.lines.map((line, index) => [line.id, lineColour(theme.palette, line.color, index)]));
+    const colourOf = (line) => (line === null ? undefined : colours.get(line)) ?? theme.palette.caption;
+    const lineOfNode = new Map(diagram.nodes.map((node) => [node.node.id, node.node.line]));
+    const edges = diagram.edges.map((edge) => renderEdge(edge, lineOfNode, colourOf, theme));
+    const nodes = diagram.nodes.map((node) => renderNode(node, diagram, colourOf, theme));
+    const box = unionOf([...edges.map((part) => part.box), ...nodes.map((part) => part.box)]);
+    // Edges first so tracks pass under stations rather than over them.
+    return {
+        caption: level.caption,
+        markup: [...edges.map((part) => part.markup), ...nodes.map((part) => part.markup)].join('\n'),
+        box,
+    };
+}
+/**
+ * An edge takes the colour of where it is going. Track between two stations on
+ * one line is that line; track leaving a router onto another line already
+ * belongs to the new one, which is what makes an interchange read as a change.
+ */
+function renderEdge(edge, lineOfNode, colourOf, theme) {
+    const sourceLine = lineOfNode.get(edge.edge.source) ?? null;
+    const targetLine = lineOfNode.get(edge.edge.target) ?? null;
+    const branching = sourceLine !== targetLine;
+    const weight = branching ? theme.metrics.branchWeight : theme.metrics.lineWeight;
+    if (edge.route.length < 2)
+        return { markup: '', box: { ...EMPTY } };
+    const points = edge.route.map((point) => `${round(point.x)},${round(point.y)}`).join(' ');
+    return {
+        markup: `<polyline points="${points}" fill="none" stroke="${colourOf(targetLine)}" stroke-width="${weight}" ` +
+            `stroke-linejoin="round" stroke-linecap="round"/>`,
+        box: boxAround(edge.route, weight / 2),
+    };
+}
+const EMPTY = { minX: Infinity, minY: Infinity, maxX: -Infinity, maxY: -Infinity };
+function renderNode(placed, diagram, colourOf, theme) {
+    const typeDef = diagram.registry.nodeTypes[placed.node.type];
+    const shape = typeDef?.shape ?? 'rect';
+    const glyph = typeDef?.glyph ?? 'none';
+    const colour = colourOf(placed.node.line);
+    const box = boxOf(placed.position, placed.size);
+    const label = placeLabel(placed.node.label, shape, placed.position, placed.size, theme.typography, theme.metrics);
+    const leader = label.leader === null
+        ? ''
+        : `<line x1="${round(label.leader[0].x)}" y1="${round(label.leader[0].y)}" ` +
+            `x2="${round(label.leader[1].x)}" y2="${round(label.leader[1].y)}" ` +
+            `stroke="${colour}" stroke-width="${theme.metrics.nodeStroke}" stroke-linecap="round"/>`;
+    const description = typeDef === undefined ? placed.node.label : `${placed.node.label} — ${typeDef.label}`;
+    return {
+        markup: [
+            `<g>`,
+            `<title>${escapeText(description)}</title>`,
+            shapeMarkup(shape, box, {
+                fill: theme.palette.nodeFill,
+                stroke: colour,
+                strokeWidth: theme.metrics.nodeStroke,
+            }),
+            glyph === 'none' ? '' : glyphMarkup(glyph, box, colour),
+            leader,
+            `<text x="${round(label.x)}" y="${round(label.y)}" text-anchor="${label.anchor}" ` +
+                `font-family="${escapeAttr(theme.typography.fontFamily)}" font-size="${theme.typography.labelSize}" ` +
+                `font-weight="${theme.typography.labelWeight}" fill="${theme.palette.label}">${escapeText(label.text)}</text>`,
+            `</g>`,
+        ]
+            .filter((part) => part !== '')
+            .join('\n'),
+        box: unionOf([box, label.box]),
+    };
+}
+/* ------------------------------------------------------------------ *
+ * Markup helpers
+ * ------------------------------------------------------------------ */
+const round = (value) => (Math.round(value * 100) / 100).toString();
+const TEXT_ESCAPES = { '&': '&amp;', '<': '&lt;', '>': '&gt;' };
+const ATTR_ESCAPES = { ...TEXT_ESCAPES, '"': '&quot;', "'": '&#39;' };
+export function escapeText(value) {
+    return value.replace(/[&<>]/g, (character) => TEXT_ESCAPES[character] ?? character);
+}
+export function escapeAttr(value) {
+    return value.replace(/[&<>"']/g, (character) => ATTR_ESCAPES[character] ?? character);
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"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"}

package/dist/shapes.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shape and glyph markup. One function per closed vocabulary in core, so a
+ * shape core can name is always a shape this can draw — which is the whole
+ * reason `NodeShape` and `Glyph` are closed sets.
+ */
+import type { Glyph, NodeShape } from '@rankonelabs/livid-core';
+import type { Box } from './geometry.js';
+export interface ShapeStyle {
+    readonly fill: string;
+    readonly stroke: string;
+    readonly strokeWidth: number;
+}
+export declare function shapeMarkup(shape: NodeShape, box: Box, style: ShapeStyle): string;
+/**
+ * The station mark. Drawn at the leading edge rather than the centre so it
+ * does not fight the label for the middle of a box.
+ */
+export declare function glyphMarkup(glyph: Glyph, box: Box, colour: string): string;
+//# sourceMappingURL=shapes.d.ts.map

package/dist/shapes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shapes.d.ts","sourceRoot":"","sources":["../src/shapes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEzC,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAQD,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,CA+CjF;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAqB1E"}

package/dist/shapes.js

@@ -0,0 +1,81 @@
+/**
+ * Shape and glyph markup. One function per closed vocabulary in core, so a
+ * shape core can name is always a shape this can draw — which is the whole
+ * reason `NodeShape` and `Glyph` are closed sets.
+ */
+function attrs(style) {
+    return `fill="${style.fill}" stroke="${style.stroke}" stroke-width="${style.strokeWidth}"`;
+}
+const round = (value) => (Math.round(value * 100) / 100).toString();
+export function shapeMarkup(shape, box, style) {
+    const x = box.minX;
+    const y = box.minY;
+    const w = box.maxX - box.minX;
+    const h = box.maxY - box.minY;
+    const common = attrs(style);
+    switch (shape) {
+        case 'rect':
+            return `<rect x="${round(x)}" y="${round(y)}" width="${round(w)}" height="${round(h)}" ${common}/>`;
+        case 'rounded':
+            return `<rect x="${round(x)}" y="${round(y)}" width="${round(w)}" height="${round(h)}" rx="10" ${common}/>`;
+        case 'stadium':
+            return `<rect x="${round(x)}" y="${round(y)}" width="${round(w)}" height="${round(h)}" rx="${round(h / 2)}" ${common}/>`;
+        case 'circle':
+            return `<circle cx="${round(x + w / 2)}" cy="${round(y + h / 2)}" r="${round(Math.min(w, h) / 2)}" ${common}/>`;
+        case 'hexagon': {
+            const inset = w * 0.18;
+            const points = [
+                [x + inset, y],
+                [x + w - inset, y],
+                [x + w, y + h / 2],
+                [x + w - inset, y + h],
+                [x + inset, y + h],
+                [x, y + h / 2],
+            ];
+            return `<polygon points="${polygon(points)}" ${common}/>`;
+        }
+        case 'diamond': {
+            const points = [
+                [x + w / 2, y],
+                [x + w, y + h / 2],
+                [x + w / 2, y + h],
+                [x, y + h / 2],
+            ];
+            return `<polygon points="${polygon(points)}" ${common}/>`;
+        }
+        case 'cylinder': {
+            const lip = 9;
+            return (`<path d="M${round(x)},${round(y + lip)} a${round(w / 2)},${lip} 0 0 1 ${round(w)},0 ` +
+                `v${round(h - lip * 2)} a${round(w / 2)},${lip} 0 0 1 ${round(-w)},0 z" ${common}/>` +
+                `<ellipse cx="${round(x + w / 2)}" cy="${round(y + lip)}" rx="${round(w / 2)}" ry="${lip}" ` +
+                `fill="none" stroke="${style.stroke}" stroke-width="${style.strokeWidth}"/>`);
+        }
+    }
+}
+function polygon(points) {
+    return points.map((point) => `${round(point[0] ?? 0)},${round(point[1] ?? 0)}`).join(' ');
+}
+/**
+ * The station mark. Drawn at the leading edge rather than the centre so it
+ * does not fight the label for the middle of a box.
+ */
+export function glyphMarkup(glyph, box, colour) {
+    if (glyph === 'none')
+        return '';
+    const cx = box.minX + (box.maxX - box.minX) / 2;
+    const cy = box.minY + (box.maxY - box.minY) / 2;
+    switch (glyph) {
+        case 'dot':
+            return `<circle cx="${round(cx)}" cy="${round(cy)}" r="4" fill="${colour}"/>`;
+        case 'ring':
+            return `<circle cx="${round(cx)}" cy="${round(cy)}" r="4.5" fill="none" stroke="${colour}" stroke-width="2"/>`;
+        case 'bar':
+            return `<rect x="${round(cx - 1.5)}" y="${round(cy - 6)}" width="3" height="12" rx="1.5" fill="${colour}"/>`;
+        case 'square':
+            return `<rect x="${round(cx - 3.5)}" y="${round(cy - 3.5)}" width="7" height="7" fill="${colour}"/>`;
+        case 'chevron':
+            return (`<path d="M${round(cx - 3)},${round(cy - 5)} L${round(cx + 3)},${round(cy)} L${round(cx - 3)},${round(cy + 5)}" ` +
+                `fill="none" stroke="${colour}" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"/>`);
+    }
+}
+//# sourceMappingURL=shapes.js.map

package/dist/shapes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shapes.js","sourceRoot":"","sources":["../src/shapes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,SAAS,KAAK,CAAC,KAAiB;IAC9B,OAAO,SAAS,KAAK,CAAC,IAAI,aAAa,KAAK,CAAC,MAAM,mBAAmB,KAAK,CAAC,WAAW,GAAG,CAAC;AAC7F,CAAC;AAED,MAAM,KAAK,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC;AAEpF,MAAM,UAAU,WAAW,CAAC,KAAgB,EAAE,GAAQ,EAAE,KAAiB;IACvE,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC;IACnB,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC;IACnB,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IAC9B,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAE5B,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,MAAM;YACT,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,CAAC,CAAC,KAAK,MAAM,IAAI,CAAC;QACtG,KAAK,SAAS;YACZ,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,CAAC,CAAC,aAAa,MAAM,IAAI,CAAC;QAC9G,KAAK,SAAS;YACZ,OAAO,YAAY,KAAK,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,aAAa,KAAK,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,MAAM,IAAI,CAAC;QAC3H,KAAK,QAAQ;YACX,OAAO,eAAe,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,MAAM,IAAI,CAAC;QAClH,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC;YACvB,MAAM,MAAM,GAAG;gBACb,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC;gBACd,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC;gBAClB,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAClB,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;gBACtB,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;gBAClB,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;aACf,CAAC;YACF,OAAO,oBAAoB,OAAO,CAAC,MAAM,CAAC,KAAK,MAAM,IAAI,CAAC;QAC5D,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,MAAM,GAAG;gBACb,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACd,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBAClB,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;gBAClB,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;aACf,CAAC;YACF,OAAO,oBAAoB,OAAO,CAAC,MAAM,CAAC,KAAK,MAAM,IAAI,CAAC;QAC5D,CAAC;QACD,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,GAAG,GAAG,CAAC,CAAC;YACd,OAAO,CACL,aAAa,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,UAAU,KAAK,CAAC,CAAC,CAAC,KAAK;gBACtF,IAAI,KAAK,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,IAAI;gBACpF,gBAAgB,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,GAAG,GAAG,CAAC,SAAS,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,SAAS,GAAG,IAAI;gBAC5F,uBAAuB,KAAK,CAAC,MAAM,mBAAmB,KAAK,CAAC,WAAW,KAAK,CAC7E,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,MAAsC;IACrD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAY,EAAE,GAAQ,EAAE,MAAc;IAChE,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,EAAE,CAAC;IAEhC,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEhD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,KAAK;YACR,OAAO,eAAe,KAAK,CAAC,EAAE,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC,iBAAiB,MAAM,KAAK,CAAC;QAChF,KAAK,MAAM;YACT,OAAO,eAAe,KAAK,CAAC,EAAE,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC,iCAAiC,MAAM,sBAAsB,CAAC;QACjH,KAAK,KAAK;YACR,OAAO,YAAY,KAAK,CAAC,EAAE,GAAG,GAAG,CAAC,QAAQ,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,0CAA0C,MAAM,KAAK,CAAC;QAC/G,KAAK,QAAQ;YACX,OAAO,YAAY,KAAK,CAAC,EAAE,GAAG,GAAG,CAAC,QAAQ,KAAK,CAAC,EAAE,GAAG,GAAG,CAAC,gCAAgC,MAAM,KAAK,CAAC;QACvG,KAAK,SAAS;YACZ,OAAO,CACL,aAAa,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI;gBACjH,uBAAuB,MAAM,qEAAqE,CACnG,CAAC;IACN,CAAC;AACH,CAAC"}

package/dist/theme.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Everything about how a diagram looks, as config.
+ *
+ * User control stops at config here as it does in core: a consumer picks
+ * colours, weights, and type, and cannot inject markup. That is what keeps the
+ * SVG in a post and the React canvas in an app the same map.
+ */
+/** Where a label sits when its shape cannot hold text. */
+export type LabelSide = 'below' | 'right';
+export interface Palette {
+    /**
+     * Colour token from `LineSpec.color` to a CSS colour. Tokens are the
+     * consumer's vocabulary — core never sees a colour — so any token missing
+     * here falls back to the ramp below, by line order.
+     */
+    readonly lines: Readonly<Record<string, string>>;
+    /** Assigned by line index to any line whose token is not in `lines`. */
+    readonly ramp: readonly string[];
+    readonly surface: string;
+    readonly nodeFill: string;
+    readonly label: string;
+    readonly caption: string;
+    readonly divider: string;
+}
+export interface Typography {
+    readonly fontFamily: string;
+    readonly labelSize: number;
+    readonly labelWeight: number;
+    readonly captionFamily: string;
+    readonly captionSize: number;
+    /**
+     * Mean glyph advance as a fraction of font size. Text is measured by
+     * estimate rather than measurement because there is no DOM at build time;
+     * see `estimateTextWidth`.
+     */
+    readonly advanceRatio: number;
+}
+export interface Metrics {
+    /** Track weight on the critical path. Thick lines are what read as transit. */
+    readonly lineWeight: number;
+    /** Branches are lighter, so the eye follows the main route first. */
+    readonly branchWeight: number;
+    readonly nodeStroke: number;
+    /** Tick drawn from a point-shaped node out to its label. */
+    readonly leader: number;
+    readonly labelGap: number;
+    readonly padding: number;
+    /** Vertical space between stacked drill-down levels. */
+    readonly levelGap: number;
+    readonly labelSide: LabelSide;
+}
+export interface SvgTheme {
+    readonly palette: Palette;
+    readonly typography: Typography;
+    readonly metrics: Metrics;
+}
+/** Overrides are per-section rather than deep, so the shapes stay nameable. */
+export interface SvgThemeOverrides {
+    readonly palette?: Partial<Palette>;
+    readonly typography?: Partial<Typography>;
+    readonly metrics?: Partial<Metrics>;
+}
+/**
+ * Restrained and high-contrast: the map should read on a white page in a post
+ * and survive being printed. Deliberately not any existing brand palette.
+ */
+export declare const DEFAULT_PALETTE: Palette;
+export declare const DEFAULT_TYPOGRAPHY: Typography;
+export declare const DEFAULT_METRICS: Metrics;
+export declare const DEFAULT_THEME: SvgTheme;
+export declare function resolveTheme(overrides?: SvgThemeOverrides): SvgTheme;
+/**
+ * Colour for one line. A configured token wins; otherwise the ramp assigns by
+ * declaration order, so an unconfigured diagram still renders as a map rather
+ * than as one grey tangle.
+ */
+export declare function lineColour(palette: Palette, token: string, index: number): string;
+//# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,0DAA0D;AAC1D,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE1C,MAAM,WAAW,OAAO;IACtB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,OAAO;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,qEAAqE;IACrE,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,+EAA+E;AAC/E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;CACrC;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,OAQ7B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,UAOhC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,OAS7B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,QAI3B,CAAC;AAEF,wBAAgB,YAAY,CAAC,SAAS,GAAE,iBAAsB,GAAG,QAAQ,CAMxE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMjF"}

package/dist/theme.js

@@ -0,0 +1,63 @@
+/**
+ * Everything about how a diagram looks, as config.
+ *
+ * User control stops at config here as it does in core: a consumer picks
+ * colours, weights, and type, and cannot inject markup. That is what keeps the
+ * SVG in a post and the React canvas in an app the same map.
+ */
+/**
+ * Restrained and high-contrast: the map should read on a white page in a post
+ * and survive being printed. Deliberately not any existing brand palette.
+ */
+export const DEFAULT_PALETTE = {
+    lines: {},
+    ramp: ['#D64500', '#1B6CA8', '#5B3E96', '#0F7B6C', '#A8341F', '#6B7280'],
+    surface: '#FFFFFF',
+    nodeFill: '#FFFFFF',
+    label: '#16181D',
+    caption: '#6B7280',
+    divider: '#D8DCE3',
+};
+export const DEFAULT_TYPOGRAPHY = {
+    fontFamily: 'ui-sans-serif, system-ui, -apple-system, Segoe UI, Roboto, sans-serif',
+    labelSize: 13,
+    labelWeight: 600,
+    captionFamily: 'ui-monospace, SFMono-Regular, Menlo, monospace',
+    captionSize: 11,
+    advanceRatio: 0.55,
+};
+export const DEFAULT_METRICS = {
+    lineWeight: 7,
+    branchWeight: 4,
+    nodeStroke: 2.5,
+    leader: 14,
+    labelGap: 6,
+    padding: 44,
+    levelGap: 96,
+    labelSide: 'below',
+};
+export const DEFAULT_THEME = {
+    palette: DEFAULT_PALETTE,
+    typography: DEFAULT_TYPOGRAPHY,
+    metrics: DEFAULT_METRICS,
+};
+export function resolveTheme(overrides = {}) {
+    return {
+        palette: { ...DEFAULT_PALETTE, ...overrides.palette, lines: { ...DEFAULT_PALETTE.lines, ...overrides.palette?.lines } },
+        typography: { ...DEFAULT_TYPOGRAPHY, ...overrides.typography },
+        metrics: { ...DEFAULT_METRICS, ...overrides.metrics },
+    };
+}
+/**
+ * Colour for one line. A configured token wins; otherwise the ramp assigns by
+ * declaration order, so an unconfigured diagram still renders as a map rather
+ * than as one grey tangle.
+ */
+export function lineColour(palette, token, index) {
+    const configured = palette.lines[token];
+    if (configured !== undefined)
+        return configured;
+    const fallback = palette.ramp[index % palette.ramp.length];
+    return fallback ?? palette.caption;
+}
+//# sourceMappingURL=theme.js.map

package/dist/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+DH;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAY;IACtC,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;IACxE,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;CACnB,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAe;IAC5C,UAAU,EAAE,uEAAuE;IACnF,SAAS,EAAE,EAAE;IACb,WAAW,EAAE,GAAG;IAChB,aAAa,EAAE,gDAAgD;IAC/D,WAAW,EAAE,EAAE;IACf,YAAY,EAAE,IAAI;CACnB,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAY;IACtC,UAAU,EAAE,CAAC;IACb,YAAY,EAAE,CAAC;IACf,UAAU,EAAE,GAAG;IACf,MAAM,EAAE,EAAE;IACV,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE,EAAE;IACX,QAAQ,EAAE,EAAE;IACZ,SAAS,EAAE,OAAO;CACnB,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAa;IACrC,OAAO,EAAE,eAAe;IACxB,UAAU,EAAE,kBAAkB;IAC9B,OAAO,EAAE,eAAe;CACzB,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,YAA+B,EAAE;IAC5D,OAAO;QACL,OAAO,EAAE,EAAE,GAAG,eAAe,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,eAAe,CAAC,KAAK,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;QACvH,UAAU,EAAE,EAAE,GAAG,kBAAkB,EAAE,GAAG,SAAS,CAAC,UAAU,EAAE;QAC9D,OAAO,EAAE,EAAE,GAAG,eAAe,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE;KACtD,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,OAAgB,EAAE,KAAa,EAAE,KAAa;IACvE,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC;IAEhD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3D,OAAO,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC;AACrC,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@rankonelabs/livid-svg",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "LaidOutDiagram to SVG string. Build-time, zero client JS.",
+  "license": "MIT",
+  "keywords": [
+    "diagram",
+    "svg",
+    "architecture",
+    "static-site"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/RankOneLabs/livid.git",
+    "directory": "packages/svg"
+  },
+  "homepage": "https://github.com/RankOneLabs/livid#readme",
+  "bugs": "https://github.com/RankOneLabs/livid/issues",
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "check": "tsc -b",
+    "prepublishOnly": "tsc -b --force"
+  },
+  "peerDependencies": {
+    "@rankonelabs/livid-core": "^0.1.0"
+  },
+  "devDependencies": {
+    "@rankonelabs/livid-core": "^0.1.0"
+  }
+}