@cristianormazabal/triton-core 0.1.0 → 0.1.2

package/dist/contracts/anchors.js

@@ -0,0 +1,20 @@
+/**
+ * Anchors
+ *
+ * Contracts for the node-anchor registry: the mechanism that makes
+ * individual nodes addressable from outside their parent diagram.
+ *
+ * Every linkable diagram's layout engine produces a NodeAnchorRegistry
+ * alongside its Scene. The registry maps each node's logical ID to its
+ * bounding box and optional cardinal ports, expressed in the diagram's
+ * LOCAL coordinate space (before any composition-level translation/scaling).
+ *
+ * The composition layer (poster layout) transforms local anchors to
+ * poster-space coordinates, merges registries from child cells with
+ * path-prefixed keys, and publishes the merged result upward — enabling
+ * cross-diagram linking at any nesting depth.
+ *
+ * Dependency: primitives.ts
+ */
+export {};
+//# sourceMappingURL=anchors.js.map

package/dist/contracts/anchors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchors.js","sourceRoot":"","sources":["../../../../src/contracts/anchors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/contracts/animations.d.ts

@@ -0,0 +1,5 @@
+export declare const CONNECTOR_ANIMATIONS: readonly ["march", "particle", "draw", "pulse", "glow", "comet", "stream", "flow", "colorcycle"];
+export type RenderedConnectorAnimation = typeof CONNECTOR_ANIMATIONS[number];
+export type CrossLinkAnimation = RenderedConnectorAnimation | 'none';
+export declare function isRenderedConnectorAnimation(value: unknown): value is RenderedConnectorAnimation;
+//# sourceMappingURL=animations.d.ts.map

package/dist/contracts/animations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animations.d.ts","sourceRoot":"","sources":["../../../../src/contracts/animations.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,kGAUvB,CAAC;AAEX,MAAM,MAAM,0BAA0B,GAAG,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7E,MAAM,MAAM,kBAAkB,GAAG,0BAA0B,GAAG,MAAM,CAAC;AAErE,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,0BAA0B,CAEhG"}

package/dist/contracts/animations.js

@@ -0,0 +1,15 @@
+export const CONNECTOR_ANIMATIONS = [
+    'march',
+    'particle',
+    'draw',
+    'pulse',
+    'glow',
+    'comet',
+    'stream',
+    'flow',
+    'colorcycle',
+];
+export function isRenderedConnectorAnimation(value) {
+    return typeof value === 'string' && CONNECTOR_ANIMATIONS.includes(value);
+}
+//# sourceMappingURL=animations.js.map

package/dist/contracts/animations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"animations.js","sourceRoot":"","sources":["../../../../src/contracts/animations.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,OAAO;IACP,UAAU;IACV,MAAM;IACN,OAAO;IACP,MAAM;IACN,OAAO;IACP,QAAQ;IACR,MAAM;IACN,YAAY;CACJ,CAAC;AAKX,MAAM,UAAU,4BAA4B,CAAC,KAAc;IACzD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,oBAA0C,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAClG,CAAC"}

package/dist/contracts/crosslink.d.ts

@@ -3,12 +3,8 @@
  *
  * Contracts for cross-diagram linking in poster compositions.
  *
- * Two constructs:
- *   - CrossLink: a single directed/undirected edge between nodes in
- *     different cells of a poster.
- *   - Trace: a named, ordered, optionally-typed multi-hop path of
- *     cross-links representing a logical thread (user journey,
- *     requirement traceability, distributed request path).
+ * CrossLink: a single directed/undirected edge between nodes in
+ * different cells of a poster.
  *
  * Cross-links are presentation-layer assertions on the composition.
  * They do NOT modify any child diagram's IR or Scene — each cell
@@ -17,9 +13,12 @@
  *
  * Dependency: primitives.ts, anchors.ts
  */
-import type { Point, Color } from './primitives.js';
+import type { Point } from './primitives.js';
 import type { CardinalSide, NodeAnchor } from './anchors.js';
-import type { RouteStyle } from './routing.js';
+import type { CurveStyle, RouteStyle } from './routing.js';
+import type { CrossLinkAnimation } from './animations.js';
+export { CONNECTOR_ANIMATIONS, isRenderedConnectorAnimation, } from './animations.js';
+export type { CrossLinkAnimation, RenderedConnectorAnimation, } from './animations.js';
 /**
  * Address of a node across poster nesting levels.
  *
@@ -38,6 +37,8 @@ export interface NodeAddress {
     readonly cellPath: readonly string[];
     /** Node ID within the target cell's diagram. */
     readonly nodeId: string;
+    /** Poster sugar for addressing array elements, resolved during poster layout. */
+    readonly elementIndex?: number;
 }
 /** Visual style of a cross-diagram edge. */
 export type CrossLinkEdgeStyle = 'solid' | 'dashed' | 'dotted';
@@ -61,6 +62,10 @@ export interface CrossLink {
      * Defaults to 'orthogonal' when omitted.
      */
     readonly routing?: RouteStyle;
+    /**
+     * Optional interpolation style for curved connectors.
+     */
+    readonly curveStyle?: CurveStyle;
     /**
      * Optional hint for which wall to exit from the source node.
      * When set, the routing engine skips all other srcWall candidates.
@@ -77,50 +82,25 @@ export interface CrossLink {
      * 'march'    — marching ants (stroke-dashoffset cycle). Only visible when
      *              the edge style is dashed or dotted; silently ignored on solid.
      * 'particle' — a dot travels along the path. Works on any edge style.
+     * 'draw'     — dashoffset reveal/erase loop over the approximate path length.
+     * 'pulse'    — breathing stroke-width animation.
+     * 'glow'     — stroke-opacity pulse.
+     * 'comet'    — particle with a short fading tail.
+     * 'stream'   — multiple staggered particles.
+     * 'flow'     — animated gradient band along the connector direction.
+     * 'colorcycle' — stroke hue cycle.
      * 'none'     — explicitly suppresses the default animation for this edge.
      *
      * When omitted the renderer applies defaults:
      *   dashed → 'march', dotted → 'march', solid → no animation.
      */
-    readonly animation?: 'march' | 'particle' | 'none';
-    /**
-     * If this link is part of a trace, the trace's ID.
-     * Used to apply consistent styling (colour, grouping) across trace members.
-     */
-    readonly traceId?: string;
+    readonly animation?: CrossLinkAnimation;
     /**
      * Optional property bag for future per-link overrides (tension, color, etc.).
      * Parsed from `{ key: value }` blocks in the syntax.
      */
     readonly props?: Readonly<Record<string, string | number>>;
 }
-/**
- * Semantic type of a trace — what relationship the hops represent.
- * Extensible; these are the built-in vocabulary from the design spec.
- */
-export type TraceType = 'satisfies' | 'triggers' | 'calls' | 'reads' | 'writes' | 'extends' | 'custom';
-/**
- * A named, ordered, optionally-typed multi-hop path of cross-diagram links.
- *
- * Traces desugar to atomic CrossLink[]s at composition time.
- * The TraceRecord groups them under a name for consistent styling,
- * legend display, and agent addressability.
- */
-export interface TraceRecord {
-    /** Unique trace ID (auto-generated or author-specified). */
-    readonly id: string;
-    /** Human-readable name displayed in the legend. */
-    readonly name: string;
-    /** Optional semantic type governing the trace legend pill label. */
-    readonly type?: TraceType;
-    /**
-     * Ordered hop endpoints. Length N produces N-1 atomic links:
-     *   hops[0]→hops[1], hops[1]→hops[2], …, hops[N-2]→hops[N-1]
-     */
-    readonly hops: readonly NodeAddress[];
-    /** Resolved colour assigned at composition time from the categorical palette. */
-    readonly color?: Color;
-}
 /**
  * A cross-link with both endpoints resolved to poster-space coordinates.
  * Produced by the resolution pass; consumed by the routing pass.

package/dist/contracts/crosslink.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crosslink.d.ts","sourceRoot":"","sources":["../../../../src/contracts/crosslink.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAI/C;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,gDAAgD;IAChD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAID,4CAA4C;AAC5C,MAAM,MAAM,kBAAkB,GAC1B,OAAO,GACP,QAAQ,GACR,QAAQ,CAAC;AAEb,yCAAyC;AACzC,MAAM,MAAM,kBAAkB,GAC1B,UAAU,GACV,YAAY,GACZ,eAAe,CAAC;AAIpB;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,+BAA+B;IAC/B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,qDAAqD;IACrD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC;IAClC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;IACnD;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;CAC5D;AAID;;;GAGG;AACH,MAAM,MAAM,SAAS,GACjB,WAAW,GACX,UAAU,GACV,OAAO,GACP,OAAO,GACP,QAAQ,GACR,SAAS,GACT,QAAQ,CAAC;AAEb;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,CAAC;IACtC,iFAAiF;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB;AAID;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC9B,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;CAC/B;AAID;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAID;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GACxB,eAAe,GACf,YAAY,GACZ,iBAAiB,GACjB,WAAW,CAAC;AAEhB,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,gDAAgD;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,qCAAqC;IACrC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACrD"}
+{"version":3,"file":"crosslink.d.ts","sourceRoot":"","sources":["../../../../src/contracts/crosslink.ts"],"names":[],"mappings":"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"}

package/dist/contracts/crosslink.js

@@ -0,0 +1,17 @@
+/**
+ * Cross-Link
+ *
+ * Contracts for cross-diagram linking in poster compositions.
+ *
+ * CrossLink: a single directed/undirected edge between nodes in
+ * different cells of a poster.
+ *
+ * Cross-links are presentation-layer assertions on the composition.
+ * They do NOT modify any child diagram's IR or Scene — each cell
+ * compiles as if links don't exist. All resolution happens at
+ * composition time, after every cell has produced its LayoutResult.
+ *
+ * Dependency: primitives.ts, anchors.ts
+ */
+export { CONNECTOR_ANIMATIONS, isRenderedConnectorAnimation, } from './animations.js';
+//# sourceMappingURL=crosslink.js.map

package/dist/contracts/crosslink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crosslink.js","sourceRoot":"","sources":["../../../../src/contracts/crosslink.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,OAAO,EACL,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,iBAAiB,CAAC"}

package/dist/contracts/diagram.js

@@ -0,0 +1,24 @@
+/**
+ * Diagram
+ *
+ * The contract every diagram type must satisfy.
+ *
+ * Parsing and layout are defined as separate interfaces.
+ * This segregation matters:
+ *
+ *   DiagramParser<IR>       — knows how to turn text into an IR.
+ *                             Testable in isolation; no theme required.
+ *
+ *   DiagramLayoutEngine<IR> — knows how to turn an IR into a Scene.
+ *                             Testable in isolation with a fixture IR.
+ *
+ *   DiagramModule<IR>       — the full module: composes both.
+ *                             This is the type diagram directories export.
+ *
+ * Callers that only need to parse (e.g. a linter, a validator) depend on
+ * DiagramParser. Callers that only need to render a pre-built IR (e.g. a
+ * server receiving JSON) depend on DiagramLayoutEngine. The full pipeline
+ * depends on DiagramModule.
+ */
+export {};
+//# sourceMappingURL=diagram.js.map

package/dist/contracts/diagram.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagram.js","sourceRoot":"","sources":["../../../../src/contracts/diagram.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG"}

package/dist/contracts/index.d.ts

@@ -7,7 +7,8 @@
  * Dependency order (each file imports only from files above it):
  *
  *   primitives   (no deps)
- *   scene        ← primitives
+ *   animations   (no deps)
+ *   scene        ← primitives, animations
  *   theme        ← primitives
  *   overlay      ← primitives
  *   routing      ← primitives
@@ -16,14 +17,16 @@
  *   diagram      ← scene, theme, overlay
  */
 export type { Point, Size, Rect, Color, FontFamily, TextAnchor, FontWeight, } from './primitives.js';
+export type { RenderedConnectorAnimation, CrossLinkAnimation, } from './animations.js';
+export { CONNECTOR_ANIMATIONS, isRenderedConnectorAnimation, } from './animations.js';
 export type { SceneRect, SceneCircle, ScenePath, SceneText, SceneGroup, SceneElement, Scene, } from './scene.js';
 export type { ThemePalette, ThemeTypography, ThemeSpacing, ThemeEdges, ThemePanel, ResolvedTheme, ThemeInput, } from './theme.js';
 export type { RawNote, RawLegend, RawOverlay, LegendCorner, LegendEntry, Legend, Annotation, CompiledOverlays, } from './overlay.js';
-export type { RouteStyle, PortDirection, RouteRequest, Route, Router, } from './routing.js';
+export type { RouteStyle, CurveStyle, PortDirection, RouteRequest, Route, Router, } from './routing.js';
 export type { DiagramParser, DiagramLayoutEngine, DiagramModule, DiagramKind, InputFormat, BaseIR, } from './diagram.js';
 export type { DiagramErrorCode, DiagramError, Result, } from './result.js';
 export { ok, err } from './result.js';
 export type { Renderer } from './renderer.js';
 export type { CardinalSide, CardinalPorts, NodeAnchor, NodeAnchorRegistry, OccupiedPort, LayoutResult, PortHint, LayoutOptions, } from './anchors.js';
-export type { NodeAddress, CrossLinkEdgeStyle, CrossLinkDirection, CrossLink, TraceType, TraceRecord, ResolvedCrossLink, RouteQuality, PerturbationKind, Perturbation, } from './crosslink.js';
+export type { NodeAddress, CrossLinkEdgeStyle, CrossLinkDirection, RenderedConnectorAnimation as CrossLinkRenderedAnimation, CrossLinkAnimation as CrossLinkAnimationName, CrossLink, ResolvedCrossLink, RouteQuality, PerturbationKind, Perturbation, } from './crosslink.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/contracts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/contracts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,YAAY,EACV,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,UAAU,EACV,UAAU,EACV,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,KAAK,GACN,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,UAAU,EACV,UAAU,EACV,aAAa,EACb,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,OAAO,EACP,SAAS,EACT,UAAU,EACV,YAAY,EACZ,WAAW,EACX,MAAM,EACN,UAAU,EACV,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,UAAU,EACV,aAAa,EACb,YAAY,EACZ,KAAK,EACL,MAAM,GACP,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,WAAW,EACX,MAAM,GACP,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,MAAM,GACP,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAEtC,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,YAAY,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,SAAS,EACT,SAAS,EACT,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,YAAY,GACb,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/contracts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,YAAY,EACV,KAAK,EACL,IAAI,EACJ,IAAI,EACJ,KAAK,EACL,UAAU,EACV,UAAU,EACV,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,SAAS,EACT,UAAU,EACV,YAAY,EACZ,KAAK,GACN,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,UAAU,EACV,UAAU,EACV,aAAa,EACb,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,OAAO,EACP,SAAS,EACT,UAAU,EACV,YAAY,EACZ,WAAW,EACX,MAAM,EACN,UAAU,EACV,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACb,YAAY,EACZ,KAAK,EACL,MAAM,GACP,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,WAAW,EACX,MAAM,GACP,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,MAAM,GACP,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAEtC,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,YAAY,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,aAAa,GACd,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,0BAA0B,IAAI,0BAA0B,EACxD,kBAAkB,IAAI,sBAAsB,EAC5C,SAAS,EACT,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,YAAY,GACb,MAAM,gBAAgB,CAAC"}

package/dist/contracts/index.js

@@ -0,0 +1,21 @@
+/**
+ * Contracts — barrel re-export.
+ *
+ * Import everything from here. Do not import directly from sub-files
+ * outside the contracts/ directory.
+ *
+ * Dependency order (each file imports only from files above it):
+ *
+ *   primitives   (no deps)
+ *   animations   (no deps)
+ *   scene        ← primitives, animations
+ *   theme        ← primitives
+ *   overlay      ← primitives
+ *   routing      ← primitives
+ *   result       (no deps)
+ *   renderer     ← scene
+ *   diagram      ← scene, theme, overlay
+ */
+export { CONNECTOR_ANIMATIONS, isRenderedConnectorAnimation, } from './animations.js';
+export { ok, err } from './result.js';
+//# sourceMappingURL=index.js.map

package/dist/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/contracts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAiBH,OAAO,EACL,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,iBAAiB,CAAC;AAyDzB,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC"}

package/dist/contracts/overlay.js

@@ -0,0 +1,22 @@
+/**
+ * Overlay
+ *
+ * Contracts for diagram annotations and legends.
+ *
+ * This file defines two layers:
+ *
+ *   RAW layer  — types emitted by PEG grammars. These are structural captures
+ *                of the overlay syntax, not yet positioned or resolved.
+ *
+ *   RESOLVED layer — types consumed by layout engines and the overlay pipeline.
+ *                    These have fully specified positions and anchor references.
+ *
+ * The separation matters: grammars produce Raw types; the overlay compiler
+ * (implementation, not defined here) converts Raw → Resolved; layout engines
+ * incorporate Resolved overlays into the final Scene geometry.
+ *
+ * Neither layer appears on the Scene type — overlays are fully resolved into
+ * SceneElement[]s before a Scene is returned from layout().
+ */
+export {};
+//# sourceMappingURL=overlay.js.map

package/dist/contracts/overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.js","sourceRoot":"","sources":["../../../../src/contracts/overlay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/dist/contracts/primitives.js

@@ -0,0 +1,13 @@
+/**
+ * Primitives
+ *
+ * Foundational geometric and visual value types.
+ * These are the atoms of the rendering coordinate system.
+ *
+ * Rules for this file:
+ *   - No imports from anywhere in the project.
+ *   - No functions, classes, or values — types only.
+ *   - Every other contract file may import from here; nothing here imports upward.
+ */
+export {};
+//# sourceMappingURL=primitives.js.map

package/dist/contracts/primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../../../src/contracts/primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/contracts/renderer.js

@@ -0,0 +1,15 @@
+/**
+ * Renderer
+ *
+ * Output-format contract. A Renderer transforms a resolved Scene into a
+ * specific output format (SVG string, PNG buffer, Canvas draw calls…).
+ *
+ * Renderers are registered by name via the render registry. The default
+ * renderer is 'svg'. Third-party output formats register themselves with
+ * registerRenderer().
+ *
+ * Renderers know nothing about diagram types, themes, or IR shapes — they
+ * consume only Scene, which is the universal render-ready representation.
+ */
+export {};
+//# sourceMappingURL=renderer.js.map

package/dist/contracts/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../../../src/contracts/renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/contracts/result.js

@@ -0,0 +1,26 @@
+/**
+ * Result
+ *
+ * A discriminated union for all public API return values.
+ *
+ * All public-facing functions (render, compile) return Result<T> instead
+ * of throwing. Internal functions may still throw — errors are caught at
+ * the pipeline boundary and wrapped into Err values.
+ *
+ * Usage:
+ *   const result = await render(input);
+ *   if (!result.ok) { console.error(result.error.message); return; }
+ *   console.log(result.value); // string
+ */
+/** Construct a successful result. */
+export function ok(value) {
+    return { ok: true, value };
+}
+/** Construct a failed result. */
+export function err(code, message, cause) {
+    return {
+        ok: false,
+        error: { code, message, ...(cause !== undefined ? { cause } : {}) },
+    };
+}
+//# sourceMappingURL=result.js.map

package/dist/contracts/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../../src/contracts/result.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAmBH,qCAAqC;AACrC,MAAM,UAAU,EAAE,CAAI,KAAQ;IAC5B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,GAAG,CACjB,IAAsB,EACtB,OAAe,EACf,KAAe;IAEf,OAAO;QACL,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;KACpE,CAAC;AACJ,CAAC"}

package/dist/contracts/routing.d.ts

@@ -25,6 +25,8 @@ export type PortDirection = 'N' | 'S' | 'E' | 'W';
  *   polyline    — straight segments between explicit waypoints.
  */
 export type RouteStyle = 'straight' | 'orthogonal' | 'bezier' | 'polyline';
+/** Named curve style for curved path emission when a route uses interpolation. */
+export type CurveStyle = 'linear' | 'catmull-rom' | 'cardinal' | 'basis' | 'natural' | 'monotone-x' | 'monotone-y';
 export interface RouteRequest {
     /** Source anchor point (center of source node edge). */
     readonly from: Point;
@@ -37,6 +39,8 @@ export interface RouteRequest {
     readonly padding: number;
     /** Bezier only — curve tension in [0, 1]. Default 0.4. */
     readonly tension?: number;
+    /** Optional named curve interpolation for curved path emission. */
+    readonly curveStyle?: CurveStyle;
     /** Direction the exit port faces.  Hint for orthogonal/bezier routing. */
     readonly fromDir?: PortDirection;
     /** Direction the entry port faces. Hint for orthogonal/bezier routing. */

package/dist/contracts/routing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../../../src/contracts/routing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAInD;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAIlD;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,QAAQ,GAAG,UAAU,CAAC;AAI3E,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IACxC,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IACjC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;CAChC;AAID,MAAM,WAAW,KAAK;IACpB,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IACtC,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC;CAC/B;AAID;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,KAAK,CAAC;CACrC"}
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../../../src/contracts/routing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAInD;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAIlD;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE3E,kFAAkF;AAClF,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,aAAa,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,YAAY,GAAG,YAAY,CAAC;AAInH,MAAM,WAAW,YAAY;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC;IACxC,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,mEAAmE;IACnE,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IACjC,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;CAChC;AAID,MAAM,WAAW,KAAK;IACpB,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IACtC,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC;CAC/B;AAID;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,KAAK,CAAC;CACrC"}

package/dist/contracts/routing.js

@@ -0,0 +1,14 @@
+/**
+ * Routing
+ *
+ * Contracts for edge-path routing algorithms.
+ *
+ * Defines what routing algorithms accept and return.
+ * All graph-based diagrams (flow, state, ER, class, …) use a common
+ * routing contract so layout engines can swap algorithms without
+ * changing their own interface.
+ *
+ * No routing logic lives here — only the shapes that implementations must satisfy.
+ */
+export {};
+//# sourceMappingURL=routing.js.map

package/dist/contracts/routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.js","sourceRoot":"","sources":["../../../../src/contracts/routing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/contracts/scene.d.ts

@@ -15,6 +15,7 @@
  *   - Elements are ordered back-to-front (painter's algorithm).
  */
 import type { Color, FontFamily, FontWeight, Point, Rect, TextAnchor } from './primitives.js';
+import type { RenderedConnectorAnimation } from './animations.js';
 export interface SceneRect {
     readonly type: 'rect';
     readonly bounds: Rect;
@@ -22,6 +23,7 @@ export interface SceneRect {
     readonly stroke: Color;
     readonly strokeWidth: number;
     readonly rx?: number;
+    readonly fillOpacity?: number;
     readonly opacity?: number;
 }
 export interface SceneCircle {
@@ -56,10 +58,12 @@ export interface ScenePath {
      *              silently ignored on solid paths.
      * 'particle' — emits a sibling <circle> with <animateMotion> that travels
      *              along the path. Works on any edge style.
+     * Other connector animations emit SMIL either inside the path or as sibling
+     * motion/gradient elements, while retaining a visible static stroke.
      *
      * Both degrade cleanly in rsvg-convert (SMIL ignored → static line/dot).
      */
-    readonly animated?: 'march' | 'particle';
+    readonly animated?: RenderedConnectorAnimation;
 }
 export interface SceneText {
     readonly type: 'text';

package/dist/contracts/scene.d.ts.map

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

package/dist/contracts/scene.js

@@ -0,0 +1,18 @@
+/**
+ * Scene
+ *
+ * The universal render-ready intermediate representation.
+ *
+ * Every DiagramLayoutEngine produces a Scene. Every renderer (SVG, PNG,
+ * canvas, PDF) consumes a Scene. Neither side knows anything about the other.
+ *
+ * Design rules:
+ *   - Every property must be fully resolved — no "inherit", no "auto",
+ *     no unresolved references. The Scene is ready to paint as-is.
+ *   - Scene elements are immutable value objects (all readonly).
+ *   - Scene carries no semantic information (no diagram type, no grammar
+ *     concepts, no overlay specs). It is pure geometry and style.
+ *   - Elements are ordered back-to-front (painter's algorithm).
+ */
+export {};
+//# sourceMappingURL=scene.js.map

package/dist/contracts/scene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene.js","sourceRoot":"","sources":["../../../../src/contracts/scene.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/contracts/theme.js

@@ -0,0 +1,18 @@
+/**
+ * Theme
+ *
+ * The unified visual configuration contract.
+ *
+ * One ResolvedTheme applies uniformly to every diagram type.
+ * No diagram gets private theme keys — all visual tokens are defined here.
+ * This guarantees that switching themes affects all diagrams identically.
+ *
+ * Two shapes exist:
+ *   ThemeInput     — what users/callers provide (all fields optional).
+ *   ResolvedTheme  — what layout engines consume (all fields required).
+ *
+ * A theme resolver (not defined here — that is implementation) merges a
+ * ThemeInput over a base preset to produce a ResolvedTheme.
+ */
+export {};
+//# sourceMappingURL=theme.js.map

package/dist/contracts/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../../../src/contracts/theme.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG"}

package/dist/crosslink/connectors.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Diagram-agnostic post-layout connector stage.
+ *
+ * This is the neutral seam over the existing cross-link routing/rendering
+ * engine. Callers lower their own semantics to local endpoint keys; poster uses
+ * its NodeAddress adapter, while single diagrams can use plain keys like `c3`.
+ */
+import type { SceneElement } from '../contracts/scene.js';
+import type { CardinalSide, NodeAnchorRegistry, OccupiedPort } from '../contracts/anchors.js';
+import type { CrossLink, CrossLinkAnimation, CrossLinkDirection, CrossLinkEdgeStyle } from '../contracts/crosslink.js';
+import type { Rect } from '../contracts/primitives.js';
+import type { CurveStyle, RouteStyle } from '../contracts/routing.js';
+import type { ResolvedTheme } from '../contracts/theme.js';
+export interface NormalizedConnectorSpec {
+    readonly fromKey: string;
+    readonly toKey: string;
+    readonly direction: CrossLinkDirection;
+    readonly style: CrossLinkEdgeStyle;
+    readonly label?: string;
+    readonly routing?: RouteStyle;
+    readonly curveStyle?: CurveStyle;
+    readonly exitWall?: CardinalSide;
+    readonly entryWall?: CardinalSide;
+    readonly animation?: CrossLinkAnimation;
+    readonly props?: Readonly<Record<string, string | number>>;
+    /**
+     * Optional blocked-container IDs for endpoint-aware obstacle exclusion.
+     * Poster passes cell paths here; local DS diagrams normally omit them.
+     */
+    readonly fromContainerKey?: string;
+    readonly toContainerKey?: string;
+}
+export interface ConnectorDiagnostic {
+    readonly connectorIndex: number;
+    readonly message: string;
+}
+export interface ConnectorExtents {
+    readonly minX: number;
+    readonly minY: number;
+    readonly maxX: number;
+    readonly maxY: number;
+}
+export interface ConnectorStageInput {
+    readonly elements?: readonly SceneElement[];
+    readonly layerBuckets?: Readonly<Record<string, readonly SceneElement[]>>;
+    readonly anchors: NodeAnchorRegistry;
+    readonly connectors: readonly NormalizedConnectorSpec[];
+    readonly theme: ResolvedTheme;
+    readonly occupiedPorts?: readonly OccupiedPort[];
+    readonly occupiedTextRects?: readonly Rect[];
+    readonly routingObstacles?: readonly Rect[];
+    readonly containerObstacles?: ReadonlyMap<string, Rect>;
+}
+export interface ConnectorStageResult {
+    readonly pathElements: SceneElement[];
+    readonly labelElements: SceneElement[];
+    readonly elements: SceneElement[];
+    readonly defs: string[];
+    readonly diagnostics: ConnectorDiagnostic[];
+    readonly extents: ConnectorExtents;
+}
+export declare function routeConnectors(input: ConnectorStageInput): ConnectorStageResult;
+export declare function crossLinksToConnectorSpecs(links: readonly CrossLink[], defaults?: {
+    curveStyle?: CurveStyle;
+}): NormalizedConnectorSpec[];
+//# sourceMappingURL=connectors.d.ts.map

package/dist/crosslink/connectors.d.ts.map

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