@cristianormazabal/triton-core 0.1.0 → 0.1.2

package/dist/diagrams/mermaid/timeline/numbered.js

@@ -0,0 +1,112 @@
+/**
+ * @file diagrams/timeline/numbered.ts — Horizontal numbered-circle infographic.
+ *
+ * The "our-timeline" T1 look: a straight horizontal axis through evenly spaced
+ * large numbered circles (01, 02, 03…). Each node's date + title callout
+ * alternates ABOVE / BELOW the axis, connected by a short vertical edging line.
+ * Highlighted (active) nodes are filled; the rest are hollow rings.
+ *
+ * Built on the shared kernel (collectEntries, formatDate, pen, util/round).
+ * Deterministic; no clock.
+ */
+import { pen } from '../../../scene/build.js';
+import { applyOverlays } from '../../../overlay/apply.js';
+import { wrapText } from '../../../text/wrap.js';
+import { formatDate } from '../../../time/dates.js';
+import { collectEntries } from './shared.js';
+import { rhu, rhuInt } from '../../../util/round.js';
+export function layoutNumbered(ir, theme) {
+    const { palette, typography, spacing } = theme;
+    const p = pen(theme);
+    const margin = spacing.diagramMargin;
+    const entries = collectEntries(ir);
+    const n = Math.max(entries.length, 1);
+    // ── Geometry ───────────────────────────────────────────────────────────────
+    const circleR = 34;
+    const numFont = rhuInt(typography.titleFontSize + 2);
+    const dateFont = typography.smallFontSize;
+    const titleFont = typography.baseFontSize;
+    const innerW = 150; // max wrapped title width
+    const titleLH = rhuInt(titleFont * 1.3);
+    const dateGap = 6;
+    const calloutGap = circleR + 14; // clearance from circle to first callout line
+    // Pre-wrap titles to size the callout stacks.
+    const placed = entries.map(e => ({
+        ...e,
+        dateStr: formatDate(e.date, 'full'),
+        titleLines: wrapText(e.label, titleFont, innerW, 2).lines,
+    }));
+    const maxTitleLines = Math.max(1, ...placed.map(e => e.titleLines.length));
+    const calloutH = calloutGap + dateFont + dateGap + maxTitleLines * titleLH + 10;
+    const subtitle = typeof ir.metadata.subtitle === 'string' ? ir.metadata.subtitle : undefined;
+    const headerH = ir.metadata.title
+        ? typography.titleFontSize + (subtitle ? typography.baseFontSize + 10 : 0) + 22
+        : 0;
+    const axisY = margin + headerH + calloutH + circleR;
+    const pitch = Math.max(innerW + 30, circleR * 2 + 60);
+    const leftX = margin + 24;
+    const nodeX = (i) => leftX + i * pitch + circleR;
+    const totalW = rhuInt(nodeX(n - 1) + circleR + 24 + margin);
+    const totalH = rhuInt(axisY + circleR + calloutH + margin);
+    const elements = [];
+    // ── Document title (centered) ──────────────────────────────────────────────
+    if (ir.metadata.title) {
+        elements.push(p.text(ir.metadata.title, rhuInt(totalW / 2), margin + typography.titleFontSize, typography.titleFontSize, palette.text, { weight: 'bold', anchor: 'middle' }));
+        if (subtitle) {
+            elements.push(p.text(subtitle, rhuInt(totalW / 2), margin + typography.titleFontSize + typography.baseFontSize + 8, typography.baseFontSize, palette.textMuted, { anchor: 'middle' }));
+        }
+    }
+    // ── Weaving spine: a continuous horizontal line that arcs AROUND each node, ─
+    //    alternating over/under (opposite the callout side) — the "edging line".
+    const arcR = circleR + 5;
+    let spine = `M ${rhu(margin)} ${rhu(axisY)}`;
+    const apexes = [];
+    placed.forEach((_e, i) => {
+        const x = nodeX(i);
+        const lineAbove = i % 2 === 0; // weave starts ABOVE on the first node
+        const sweep = lineAbove ? 1 : 0; // 1 = arc up/over, 0 = arc down/under
+        spine += ` L ${rhu(x - arcR)} ${rhu(axisY)} A ${arcR} ${arcR} 0 0 ${sweep} ${rhu(x + arcR)} ${rhu(axisY)}`;
+        apexes.push({ x, y: lineAbove ? axisY - arcR : axisY + arcR });
+    });
+    spine += ` L ${rhu(totalW - margin)} ${rhu(axisY)}`;
+    elements.push(p.path(spine, palette.border, 2));
+    // Dot at each arc apex (the spine's min/max around each node).
+    for (const a of apexes)
+        elements.push(p.circle({ x: rhu(a.x), y: rhu(a.y) }, 4, palette.primary, palette.background, 1.5));
+    // ── Nodes + alternating callouts ───────────────────────────────────────────
+    placed.forEach((e, i) => {
+        const x = nodeX(i);
+        const above = i % 2 === 1; // node 2 (index 1) callout goes up, like the reference
+        const filled = e.status === 'active';
+        const numColor = filled ? '#FFFFFF' : palette.primary;
+        // Circle node (drawn over the spine).
+        elements.push(p.circle({ x: rhu(x), y: rhu(axisY) }, circleR, filled ? palette.primary : palette.background, palette.primary, 3));
+        elements.push(p.text(String(i + 1).padStart(2, '0'), rhu(x), rhu(axisY + numFont * 0.35), numFont, numColor, { weight: 'bold', anchor: 'middle' }));
+        // Callout: date (near) + title (far), stacked away from the axis.
+        if (above) {
+            const dateY = axisY - calloutGap;
+            elements.push(p.text(e.dateStr, rhu(x), rhu(dateY), dateFont, palette.textMuted, { anchor: 'middle' }));
+            let ty = dateY - dateFont - dateGap;
+            for (let li = e.titleLines.length - 1; li >= 0; li--) {
+                elements.push(p.text(e.titleLines[li], rhu(x), rhu(ty), titleFont, palette.primary, { weight: 'bold', anchor: 'middle' }));
+                ty -= titleLH;
+            }
+        }
+        else {
+            const dateY = axisY + calloutGap;
+            elements.push(p.text(e.dateStr, rhu(x), rhu(dateY), dateFont, palette.textMuted, { anchor: 'middle' }));
+            let ty = dateY + titleLH;
+            for (const ln of e.titleLines) {
+                elements.push(p.text(ln, rhu(x), rhu(ty), titleFont, palette.primary, { weight: 'bold', anchor: 'middle' }));
+                ty += titleLH;
+            }
+        }
+    });
+    const scene = applyOverlays({
+        viewBox: { x: 0, y: 0, width: totalW, height: totalH },
+        background: palette.background,
+        elements,
+    }, ir.overlays, theme);
+    return { scene, anchors: {} };
+}
+//# sourceMappingURL=numbered.js.map

package/dist/diagrams/mermaid/timeline/numbered.js.map

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

package/dist/diagrams/{timeline → mermaid/timeline}/roadmap.d.ts

@@ -12,7 +12,7 @@
  * (no axis breaks in v1). Uses only shared theme tokens.
  */
 import type { TimelineDocument } from './ir.js';
-import type { LayoutResult } from '../../contracts/index.js';
-import type { ResolvedTheme } from '../../contracts/index.js';
+import type { LayoutResult } from '../../../contracts/index.js';
+import type { ResolvedTheme } from '../../../contracts/index.js';
 export declare function layoutRoadmap(ir: TimelineDocument, theme: ResolvedTheme): LayoutResult;
 //# sourceMappingURL=roadmap.d.ts.map

package/dist/diagrams/mermaid/timeline/roadmap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roadmap.d.ts","sourceRoot":"","sources":["../../../../../../src/diagrams/mermaid/timeline/roadmap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAuB,MAAM,SAAS,CAAC;AACrE,OAAO,KAAK,EAAuB,YAAY,EAAE,MAAM,6BAA6B,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAejE,wBAAgB,aAAa,CAAC,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,aAAa,GAAG,YAAY,CAmGtF"}

package/dist/diagrams/mermaid/timeline/roadmap.js

@@ -0,0 +1,125 @@
+/**
+ * @file diagrams/timeline/roadmap.ts — Roadmap infographic layout.
+ *
+ * Four horizontal zones (top→bottom):
+ *   1. Header     — title.
+ *   2. Callouts   — milestone labels + (date), leader line + dot down to band.
+ *   3. Phase band — activity pills from dateX(start)→dateX(end), status-coloured,
+ *                   lane-packed so overlapping ranges stack instead of collide.
+ *   4. Date axis  — baseline with date labels at milestone x positions.
+ *
+ * Built on the GENERAL time/dates + text/metrics modules. Linear date mapping
+ * (no axis breaks in v1). Uses only shared theme tokens.
+ */
+import { applyOverlays } from '../../../overlay/apply.js';
+import { rhuInt } from '../../../util/round.js';
+import { pen } from '../../../scene/build.js';
+import { measureText } from '../../../text/metrics.js';
+import { truncateText } from '../../../text/wrap.js';
+import { startOrdinal, endOrdinal, formatDate } from '../../../time/dates.js';
+import { statusColor } from './shared.js';
+const leftOrd = startOrdinal;
+const rightOrd = endOrdinal;
+const fmtDate = (date) => formatDate(date, 'axis');
+export function layoutRoadmap(ir, theme) {
+    const { palette, typography, spacing } = theme;
+    const draw = pen(theme);
+    const margin = spacing.diagramMargin;
+    // ── Time range ─────────────────────────────────────────────────────────────
+    const acts = ir.activities;
+    const miles = ir.milestones;
+    const allOrds = [];
+    for (const a of acts) {
+        allOrds.push(leftOrd(a.start), rightOrd(a.end ?? a.start));
+    }
+    for (const m of miles)
+        allOrds.push(leftOrd(m.date));
+    if (allOrds.length === 0)
+        allOrds.push(0, 1);
+    const minOrd = Math.min(...allOrds);
+    const maxOrd = Math.max(...allOrds);
+    const span = Math.max(1, maxOrd - minOrd);
+    // ── Canvas + axis geometry ─────────────────────────────────────────────────
+    const W = 1040;
+    const axisLeft = margin + 10;
+    const axisRight = W - margin - 10;
+    const axisW = axisRight - axisLeft;
+    const dateX = (ord) => rhuInt(axisLeft + ((ord - minOrd) / span) * axisW);
+    // ── Lane-pack activities (avoid overlap) ───────────────────────────────────
+    const sorted = [...acts].sort((a, b) => leftOrd(a.start) - leftOrd(b.start));
+    const laneEnds = [];
+    const pills = sorted.map(a => {
+        const s = leftOrd(a.start);
+        const e = Math.max(rightOrd(a.end ?? a.start), s + Math.round(span / 30)); // min visible width
+        let lane = laneEnds.findIndex(end => s >= end);
+        if (lane === -1) {
+            lane = laneEnds.length;
+            laneEnds.push(e);
+        }
+        else
+            laneEnds[lane] = e;
+        return { label: a.label, startOrd: s, endOrd: e, color: statusColor(palette, a.status), lane };
+    });
+    const numLanes = Math.max(1, laneEnds.length);
+    // ── Vertical zones ─────────────────────────────────────────────────────────
+    const headerH = ir.metadata.title ? typography.titleFontSize + 20 : 8;
+    const calloutH = miles.length ? 56 : 12;
+    const laneH = 34;
+    const lanePad = 6;
+    const bandTop = margin + headerH + calloutH;
+    const bandH = numLanes * laneH + (numLanes - 1) * lanePad;
+    const bandBot = bandTop + bandH;
+    const axisY = bandBot + 26;
+    const totalH = rhuInt(axisY + typography.smallFontSize + margin);
+    const elements = [];
+    // ── Title ─────────────────────────────────────────────────────────────────
+    if (ir.metadata.title) {
+        elements.push(draw.text(ir.metadata.title, margin, margin + typography.titleFontSize, typography.titleFontSize, palette.text, { weight: 'bold', anchor: 'start' }));
+    }
+    // ── Band background ────────────────────────────────────────────────────────
+    elements.push(draw.rect({ x: axisLeft, y: bandTop, width: axisW, height: bandH }, palette.surface, palette.border, 1, { rx: 6 }));
+    // ── Activity pills ─────────────────────────────────────────────────────────
+    const pillFont = typography.smallFontSize;
+    for (const p of pills) {
+        const x1 = dateX(p.startOrd), x2 = dateX(p.endOrd);
+        const px = x1, pw = Math.max(14, x2 - x1);
+        const py = bandTop + p.lane * (laneH + lanePad);
+        elements.push(draw.rect({ x: px, y: py, width: pw, height: laneH }, p.color, p.color, 0, { rx: 6 }));
+        const label = truncateText(p.label, pillFont, pw - 12);
+        if (label && measureText(label, pillFont).width <= pw - 8) {
+            elements.push(draw.text(label, px + pw / 2, py + laneH / 2 + pillFont * 0.35, pillFont, palette.background, { weight: 'bold', anchor: 'middle' }));
+        }
+    }
+    // ── Milestone callouts (above band) ────────────────────────────────────────
+    for (const m of miles) {
+        const mx = dateX(leftOrd(m.date));
+        const labelY = margin + headerH + typography.baseFontSize;
+        elements.push(draw.text(m.label, mx, labelY, typography.baseFontSize, palette.text, { weight: 'bold', anchor: 'middle' }));
+        elements.push(draw.text(`(${fmtDate(m.date)})`, mx, labelY + typography.smallFontSize + 2, typography.smallFontSize, palette.textMuted, { anchor: 'middle' }));
+        // leader line down to band top + dot
+        elements.push(draw.path(`M ${mx} ${labelY + typography.smallFontSize + 6} L ${mx} ${bandTop}`, palette.border, 1));
+        elements.push(draw.circle({ x: mx, y: bandTop }, 4, palette.primary, palette.background, 1.5));
+    }
+    // ── Date axis ──────────────────────────────────────────────────────────────
+    elements.push(draw.path(`M ${axisLeft} ${axisY} L ${axisRight} ${axisY}`, palette.border, 1.5));
+    const axisDates = new Set();
+    for (const m of miles)
+        axisDates.add(m.date);
+    for (const a of acts) {
+        axisDates.add(a.start);
+        if (a.end)
+            axisDates.add(a.end);
+    }
+    for (const d of axisDates) {
+        const x = dateX(leftOrd(d));
+        elements.push(draw.path(`M ${x} ${axisY - 3} L ${x} ${axisY + 3}`, palette.border, 1));
+        elements.push(draw.text(fmtDate(d), x, axisY + typography.smallFontSize + 2, typography.smallFontSize, palette.textMuted, { anchor: 'middle' }));
+    }
+    const scene = applyOverlays({
+        viewBox: { x: 0, y: 0, width: W, height: totalH },
+        background: palette.background,
+        elements,
+    }, ir.overlays, theme);
+    return { scene, anchors: {} };
+}
+//# sourceMappingURL=roadmap.js.map

package/dist/diagrams/mermaid/timeline/roadmap.js.map

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

package/dist/diagrams/{timeline → mermaid/timeline}/serpentine.d.ts

@@ -14,7 +14,7 @@
  * Determinism: round-half-up, stable (ordinal, id) sort, no clock.
  */
 import type { TimelineDocument } from './ir.js';
-import type { LayoutResult } from '../../contracts/index.js';
-import type { ResolvedTheme } from '../../contracts/index.js';
+import type { LayoutResult } from '../../../contracts/index.js';
+import type { ResolvedTheme } from '../../../contracts/index.js';
 export declare function layoutSerpentine(ir: TimelineDocument, theme: ResolvedTheme): LayoutResult;
 //# sourceMappingURL=serpentine.d.ts.map

package/dist/diagrams/mermaid/timeline/serpentine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serpentine.d.ts","sourceRoot":"","sources":["../../../../../../src/diagrams/mermaid/timeline/serpentine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,KAAK,EAAuB,YAAY,EAAE,MAAM,6BAA6B,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AA4DjE,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,aAAa,GAAG,YAAY,CAiGzF"}

package/dist/diagrams/mermaid/timeline/serpentine.js

@@ -0,0 +1,152 @@
+/**
+ * @file diagrams/timeline/serpentine.ts — Serpentine (boustrophedon) layout.
+ *
+ * A single winding track runs left→right, U-turns down, right→left, U-turns, …
+ * Entries (milestones + activities, by start date) are placed at uniform
+ * arc-length positions t_i = (i + 0.5) / n along the path. A play cap marks the
+ * start, a target/bullseye cap the end. Labels sit above/below each node by row
+ * parity.
+ *
+ * Built on the GENERAL time/dates module. Uses only shared theme tokens.
+ * v3 fidelity notes vs core: solid track (v3 scene has no stroke gradients) and
+ * inline play/target caps (no icon registry yet).
+ *
+ * Determinism: round-half-up, stable (ordinal, id) sort, no clock.
+ */
+import { applyOverlays } from '../../../overlay/apply.js';
+import { rhu, rhuInt } from '../../../util/round.js';
+import { pen } from '../../../scene/build.js';
+import { statusColor, collectEntries } from './shared.js';
+/** Point (x,y) at arc-length s along the boustrophedon path. */
+function pathPointAtS(s, geo) {
+    const { xl, xr, pathStartY, nRows, rowSpacing, turnRadius: r, rowWidth } = geo;
+    const L_turn = Math.PI * r;
+    let remaining = Math.max(0, Math.min(s, geo.totalLength));
+    for (let row = 0; row < nRows; row++) {
+        const y_row = pathStartY + row * rowSpacing;
+        if (remaining <= rowWidth + 1e-9) {
+            const t = Math.min(remaining, rowWidth);
+            return row % 2 === 0 ? { x: rhu(xl + t), y: rhu(y_row) } : { x: rhu(xr - t), y: rhu(y_row) };
+        }
+        remaining -= rowWidth;
+        if (row < nRows - 1) {
+            if (remaining <= L_turn + 1e-9) {
+                const alpha = Math.min(remaining, L_turn) / r;
+                return row % 2 === 0
+                    ? { x: rhu(xr + r * Math.sin(alpha)), y: rhu(y_row + r * (1 - Math.cos(alpha))) }
+                    : { x: rhu(xl - r * Math.sin(alpha)), y: rhu(y_row + r * (1 - Math.cos(alpha))) };
+            }
+            remaining -= L_turn;
+        }
+    }
+    const lastRow = nRows - 1;
+    const y_last = rhu(pathStartY + lastRow * rowSpacing);
+    return lastRow % 2 === 0 ? { x: rhu(xr), y: y_last } : { x: rhu(xl), y: y_last };
+}
+/** SVG path d for the full boustrophedon, smooth arc U-turns. */
+function buildPathD(geo) {
+    const { xl, xr, pathStartY, nRows, rowSpacing, turnRadius: r } = geo;
+    const parts = [];
+    for (let row = 0; row < nRows; row++) {
+        const y = rhu(pathStartY + row * rowSpacing);
+        const y_next = rhu(pathStartY + (row + 1) * rowSpacing);
+        if (row === 0)
+            parts.push(`M ${xl} ${y}`);
+        if (row % 2 === 0) {
+            parts.push(`L ${xr} ${y}`);
+            if (row < nRows - 1)
+                parts.push(`A ${r} ${r} 0 1 1 ${xr} ${y_next}`);
+        }
+        else {
+            parts.push(`L ${xl} ${y}`);
+            if (row < nRows - 1)
+                parts.push(`A ${r} ${r} 0 1 0 ${xl} ${y_next}`);
+        }
+    }
+    return parts.join(' ');
+}
+export function layoutSerpentine(ir, theme) {
+    const { palette, typography } = theme;
+    const p = pen(theme);
+    // ── Entries ────────────────────────────────────────────────────────────────
+    const entries = collectEntries(ir).map(e => ({
+        id: e.id, label: e.label, ord: e.ord,
+        color: e.kind === 'milestone' ? palette.primary : statusColor(palette, e.status),
+    }));
+    const n = entries.length;
+    // ── Geometry ─────────────────────────────────────────────────────────────
+    const W = 1040;
+    const turnRadius = 80;
+    const rowSpacing = 160;
+    const trackWidth = 14;
+    const nodeR = 10;
+    const badgeR = 22;
+    const PATH_XL = rhu(turnRadius + 10);
+    const PATH_XR = rhu(W - turnRadius - 10);
+    const ROW_W = rhu(PATH_XR - PATH_XL);
+    const nRows = Math.max(2, Math.ceil(n / 3));
+    const headerH = ir.metadata.title ? typography.titleFontSize + 28 : 0;
+    const TOP_PAD = 64;
+    const BOTTOM_PAD = 64;
+    const pathStartY = rhu(headerH + TOP_PAD);
+    const L_turn = rhu(Math.PI * turnRadius);
+    const totalLength = rhu(nRows * ROW_W + (nRows - 1) * L_turn);
+    const pathEndY = rhu(pathStartY + (nRows - 1) * rowSpacing);
+    const canvasH = rhuInt(pathEndY + BOTTOM_PAD);
+    const geo = { xl: PATH_XL, xr: PATH_XR, pathStartY, nRows, rowSpacing, turnRadius, rowWidth: ROW_W, totalLength };
+    const elements = [];
+    // ── Title ─────────────────────────────────────────────────────────────────
+    if (ir.metadata.title) {
+        elements.push(p.text(ir.metadata.title, rhu(W / 2), rhuInt(typography.titleFontSize + 8), typography.titleFontSize, palette.text, { weight: 'bold', anchor: 'middle' }));
+    }
+    // ── Track ─────────────────────────────────────────────────────────────────
+    const pathD = buildPathD(geo);
+    const pathStart = pathPointAtS(0, geo);
+    const pathEnd = pathPointAtS(totalLength, geo);
+    elements.push(p.path(pathD, palette.primary, trackWidth, { fill: 'none' }));
+    // ── Nodes + labels ────────────────────────────────────────────────────────
+    function rowForS(s) {
+        let remaining = Math.max(0, s);
+        for (let row = 0; row < nRows; row++) {
+            if (remaining <= ROW_W + 1e-9)
+                return row;
+            remaining -= ROW_W;
+            if (row < nRows - 1) {
+                if (remaining <= L_turn + 1e-9)
+                    return row;
+                remaining -= L_turn;
+            }
+        }
+        return nRows - 1;
+    }
+    const labelFontSize = typography.smallFontSize;
+    for (let i = 0; i < n; i++) {
+        const s = rhu(((i + 0.5) / n) * totalLength);
+        const pt = pathPointAtS(s, geo);
+        const e = entries[i];
+        elements.push(p.circle({ x: pt.x, y: pt.y }, nodeR, palette.background, e.color, 3));
+        const isEvenRow = rowForS(s) % 2 === 0;
+        const labelY = isEvenRow
+            ? rhu(pt.y + nodeR + 6 + labelFontSize * 0.9)
+            : rhu(pt.y - nodeR - 8);
+        const labelText = e.label.length > 18 ? `${e.label.slice(0, 16)}…` : e.label;
+        elements.push(p.text(labelText, pt.x, labelY, labelFontSize, palette.text, { anchor: 'middle' }));
+    }
+    // ── Start cap (play triangle) ─────────────────────────────────────────────
+    elements.push(p.circle({ x: pathStart.x, y: pathStart.y }, badgeR, palette.primary, palette.primary, 2));
+    {
+        const cx = pathStart.x, cy = pathStart.y, t = badgeR * 0.5;
+        elements.push(p.path(`M ${rhu(cx - t * 0.5)} ${rhu(cy - t)} L ${rhu(cx + t)} ${rhu(cy)} L ${rhu(cx - t * 0.5)} ${rhu(cy + t)} Z`, palette.background, 0, { fill: palette.background }));
+    }
+    // ── End cap (target / bullseye) ───────────────────────────────────────────
+    elements.push(p.circle({ x: pathEnd.x, y: pathEnd.y }, badgeR, palette.primary, palette.primary, 2));
+    elements.push(p.circle({ x: pathEnd.x, y: pathEnd.y }, rhu(badgeR * 0.62), 'none', palette.background, 2.5));
+    elements.push(p.circle({ x: pathEnd.x, y: pathEnd.y }, rhu(badgeR * 0.28), palette.background, palette.background, 0));
+    const scene = applyOverlays({
+        viewBox: { x: 0, y: 0, width: W, height: canvasH },
+        background: palette.background,
+        elements,
+    }, ir.overlays, theme);
+    return { scene, anchors: {} };
+}
+//# sourceMappingURL=serpentine.js.map

package/dist/diagrams/mermaid/timeline/serpentine.js.map

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

package/dist/diagrams/{timeline → mermaid/timeline}/shared.d.ts

@@ -6,7 +6,7 @@
  * rather than being copy-pasted per layout. Cross-diagram utilities (rounding,
  * dates, text metrics) live in the top-level general modules instead.
  */
-import type { ResolvedTheme } from '../../contracts/index.js';
+import type { ResolvedTheme } from '../../../contracts/index.js';
 import type { TimelineDocument } from './ir.js';
 /**
  * Map a timeline activity status to the theme's semantic palette.

package/dist/diagrams/mermaid/timeline/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../../../src/diagrams/mermaid/timeline/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAGhD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAOtF;AAED,iFAAiF;AACjF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,CAAC;IACxC,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,gBAAgB,GAAG,aAAa,EAAE,CAkBpE"}

package/dist/diagrams/mermaid/timeline/shared.js

@@ -0,0 +1,47 @@
+/**
+ * @file diagrams/timeline/shared.ts — Helpers shared across timeline layouts.
+ *
+ * These are specific to the timeline diagram family (vertical-spine, serpentine,
+ * roadmap, columns, horizontal) but common to all of them — so they live here
+ * rather than being copy-pasted per layout. Cross-diagram utilities (rounding,
+ * dates, text metrics) live in the top-level general modules instead.
+ */
+import { startOrdinal } from '../../../time/dates.js';
+/**
+ * Map a timeline activity status to the theme's semantic palette.
+ *   done → success, active → primary, blocked → error, else → secondary.
+ * Reads only shared palette tokens so every theme restyles consistently.
+ */
+export function statusColor(palette, status) {
+    switch (status) {
+        case 'done': return palette.success;
+        case 'active': return palette.primary;
+        case 'blocked': return palette.error;
+        default: return palette.secondary;
+    }
+}
+/**
+ * Merge milestones + activities into one list keyed by start date, sorted by
+ * (ordinal, id) for stable, deterministic placement. Used by the layouts that
+ * lay both kinds along a single track (spine, serpentine).
+ */
+export function collectEntries(ir) {
+    const entries = [];
+    for (const m of ir.milestones) {
+        entries.push({
+            id: m.id, label: m.label, kind: 'milestone', date: m.date, ord: startOrdinal(m.date),
+            ...(m.description ? { description: m.description } : {}),
+        });
+    }
+    for (const a of ir.activities) {
+        entries.push({
+            id: a.id, label: a.label, kind: 'activity', date: a.start, ord: startOrdinal(a.start),
+            ...(a.end ? { end: a.end } : {}),
+            ...(a.status ? { status: a.status } : {}),
+            ...(a.description ? { description: a.description } : {}),
+        });
+    }
+    entries.sort((p, q) => (p.ord - q.ord) || (p.id < q.id ? -1 : p.id > q.id ? 1 : 0));
+    return entries;
+}
+//# sourceMappingURL=shared.js.map

package/dist/diagrams/mermaid/timeline/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../../../../src/diagrams/mermaid/timeline/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,OAAiC,EAAE,MAAe;IAC5E,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM,CAAC,CAAI,OAAO,OAAO,CAAC,OAAO,CAAC;QACvC,KAAK,QAAQ,CAAC,CAAE,OAAO,OAAO,CAAC,OAAO,CAAC;QACvC,KAAK,SAAS,CAAC,CAAC,OAAO,OAAO,CAAC,KAAK,CAAC;QACrC,OAAO,CAAC,CAAQ,OAAO,OAAO,CAAC,SAAS,CAAC;IAC3C,CAAC;AACH,CAAC;AAiBD;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,EAAoB;IACjD,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,UAAU,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;YACpF,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzD,CAAC,CAAC;IACL,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,UAAU,EAAE,CAAC;QAC9B,OAAO,CAAC,IAAI,CAAC;YACX,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC;YACrF,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACzD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/diagrams/{timeline → mermaid/timeline}/timeline-columns.d.ts

@@ -13,7 +13,7 @@
  * not a theme token. Built on GENERAL time/dates + text/wrap modules.
  */
 import type { TimelineDocument } from './ir.js';
-import type { LayoutResult } from '../../contracts/index.js';
-import type { ResolvedTheme } from '../../contracts/index.js';
+import type { LayoutResult } from '../../../contracts/index.js';
+import type { ResolvedTheme } from '../../../contracts/index.js';
 export declare function layoutTimelineColumns(ir: TimelineDocument, theme: ResolvedTheme): LayoutResult;
 //# sourceMappingURL=timeline-columns.d.ts.map

package/dist/diagrams/mermaid/timeline/timeline-columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-columns.d.ts","sourceRoot":"","sources":["../../../../../../src/diagrams/mermaid/timeline/timeline-columns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAgC,MAAM,SAAS,CAAC;AAC9E,OAAO,KAAK,EAAuB,YAAY,EAAE,MAAM,6BAA6B,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAsCjE,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE,aAAa,GAAG,YAAY,CA4G9F"}