@nowline/layout 0.8.6 → 0.9.0

package/dist/edge-routing.d.ts

@@ -1,89 +1,80 @@
-import type { BoundingBox, Point, PositionedIncludeRegion, PositionedSwimlane } from './types.js';
-/** A visible parallel or group bracket stroke. Used by the
- *  bracket-clearance nudge: arrows whose chosen elbow X falls within
- *  `BRACKET_NUDGE_PX` of one of these lines are shifted away. Brackets
- *  are NOT obstacles — they're aesthetic preferences, not collisions. */
-export interface BracketLine {
-    x: number;
-    yTop: number;
-    yBottom: number;
+import type { BoundingBox, Point } from './types.js';
+/** Spacing between the lanes of one gap (§3.4 "Channels"). */
+export declare const CHANNEL_LANE_PX = 2.5;
+/** A vertical leg keeps more than this from a bar's left or right edge over its height (§6). */
+export declare const EDGE_CLEARANCE_PX = 1;
+/** Full arrowhead width (and the length along the leg is `ARROW_HEAD_LENGTH_PX`). */
+export declare const ARROW_HEAD_WIDTH_PX = 7;
+/** Length of a full arrowhead along its leg. */
+export declare const ARROW_HEAD_LENGTH_PX = 5;
+/** The narrowest arrowhead; a target narrower than this gets a dot of this diameter (§8 O6). */
+export declare const ARROW_HEAD_MIN_PX = 3;
+/** One end of a dependency arrow: an item bar or a group / parallel. */
+export interface ArrowEnd {
+    /** The entity's dates in x (an item's bar is drawn inside them, a seam in from each). */
+    startX: number;
+    endX: number;
+    /** Painted left edge and width (the bar, or the container's box). */
+    paintedX: number;
+    paintedWidth: number;
+    /** Painted top and bottom (a container's box runs from its header to its body's bottom). */
+    top: number;
+    bottom: number;
+    /** An item's row midline (`box.y + bandwidth / 2`); undefined for a container. */
+    rowY?: number;
+    /**
+     * Where a horizontal leg leaves this item on its own row: the row
+     * midline, or the progress strip's centre when its caption spills, so
+     * the leg runs under the caption. Undefined for a container.
+     */
+    exitY?: number;
 }
-/** Per-edge routing request. `from` and `to` are the (visualEdge, midY)
- *  attach points the rest of the layout already computed; the router
- *  produces the orthogonal polyline that connects them. */
-export interface EdgeRouteRequest {
+export interface DependencyRouteRequest {
     fromId: string;
     toId: string;
-    from: Point;
-    to: Point;
-    /** Marker → item edges (anchor / milestone source) skip the channel
-     *  router entirely — the cut line is the visible stem, the path is
-     *  always a short horizontal stub. Set true to bypass routing. */
-    isMarkerSource: boolean;
+    source: ArrowEnd;
+    target: ArrowEnd;
+}
+/** A vertical stroke a vertical leg must keep clear of. */
+export interface VerticalEdge {
+    x: number;
+    top: number;
+    bottom: number;
+}
+export interface RouteObstacles {
+    /**
+     * What a horizontal leg must stay out of: every bar with its spilled
+     * caption and decorations, every container header band, and every lane
+     * or region edge (zero-height boxes).
+     */
+    blocks: BoundingBox[];
+    /** The left and right edges of every bar and drawn container, over its height. */
+    edges: VerticalEdge[];
 }
-export interface EdgeRouteResult {
+export interface RoutedDependency {
     fromId: string;
     toId: string;
+    /** First = source port, last = target port (the arrowhead's tip). */
     waypoints: Point[];
-    /** True when the chosen channel intersected an item bar. The
-     *  renderer paints these edges BEFORE bar fills with a thinner
-     *  stroke so the bar still reads as the foreground. */
-    underBar: boolean;
+    /** The target waits: its horizontal leg is dotted, its length the slack. */
+    slack: boolean;
+    headWidth: number;
+    head: 'arrow' | 'dot';
 }
-/** Distance (px) the elbow X must keep from any visible bracket. Picked
- *  to leave a small visible gap between the arrow's vertical leg and
- *  the bracket stroke without forcing the arrow far from its natural
- *  mid-gutter line. */
-export declare const BRACKET_NUDGE_PX = 4;
-/** Minimum horizontal source stub (px) — distance from the source's
- *  exit point to the vertical-leg elbow. Below this, the source-side
- *  arrow body collapses into the bar's right edge with no visible
- *  horizontal segment. Treated as a hard constraint when picking
- *  the channel X for left-to-right edges. */
-export declare const MIN_SOURCE_STUB_PX = 6;
-/** Minimum horizontal target stub (px) — distance from the vertical-leg
- *  elbow to the target's left edge. Below this, the arrowhead has no
- *  horizontal lead-in: the leg appears to plunge directly into the bar
- *  without a visible target-side stub. Treated as a hard constraint
- *  when picking the channel X for left-to-right edges; conflicts with
- *  obstacle / bracket clearance trigger the under-bar fallback. */
-export declare const MIN_TARGET_STUB_PX = 6;
-export interface ChannelGridInput {
-    /** Every painted item box (visual edges, including chip-spill
-     *  growth). Treated as hard obstacles: a vertical leg crossing one
-     *  triggers under-bar fallback. */
-    itemBars: BoundingBox[];
-    /** Every visible bracket stroke (parallel `bracket:solid|dashed`,
-     *  filled-style group chiclets are NOT brackets). Used by the
-     *  clearance nudge only — not obstacles. */
-    brackets: BracketLine[];
-}
-export declare class ChannelGrid {
-    private readonly items;
-    private readonly brackets;
-    constructor(input: ChannelGridInput);
-    /** True when a vertical line at `x` intersects any item bar within
-     *  the Y span `[yMin, yMax]`. */
-    hasObstacle(x: number, yMin: number, yMax: number): boolean;
-    /** Visible brackets within `radius` px of `x` whose Y span overlaps
-     *  `[yMin, yMax]`. The clearance nudge uses these to shift the
-     *  elbow X away from the bracket. */
-    bracketsNear(x: number, yMin: number, yMax: number, radius: number): BracketLine[];
-}
-/**
- * Walk a positioned swimlane tree and collect every painted item bar
- * (visual edges) AND every visible bracket stroke. Output feeds
- * `ChannelGrid` so the router knows what to avoid.
- *
- * Swimlanes contained in include regions count too — items inside an
- * isolated region share the parent timeline so cross-region arrows
- * still need the obstacle/bracket data to route cleanly.
- */
-export declare function collectRoutingObstacles(swimlanes: PositionedSwimlane[], includes: PositionedIncludeRegion[]): ChannelGridInput;
+/** Where an arrow leaves `end`: the middle of its last day, or its middle when shorter than a day. */
+export declare function sourcePortX(end: ArrowEnd, pixelsPerDay: number): number;
+/** Where an arrow lands on `end`: the middle of its first day, or its middle when shorter than a day. */
+export declare function targetPortX(end: ArrowEnd, pixelsPerDay: number): number;
+/** Arrowhead for a leg landing across a target `width` wide (§8 O6). */
+export declare function arrowHead(width: number): {
+    headWidth: number;
+    head: 'arrow' | 'dot';
+};
 /**
- * Route every dependency edge in one batch so slot assignment can
- * coordinate across edges that share a channel. Marker → item edges
- * route as direct stubs and bypass the channel router.
+ * Route every item dependency of one chart (the host, or one isolated
+ * region) in a batch, so arrows sharing a gap can take lanes. Returns one
+ * entry per request; `null` where position already says it (a target on
+ * its source's row that starts where the source ends).
  */
-export declare function routeChannelEdges(requests: EdgeRouteRequest[], grid: ChannelGrid): EdgeRouteResult[];
+export declare function routeDependencies(requests: DependencyRouteRequest[], obstacles: RouteObstacles, pixelsPerDay: number): Array<RoutedDependency | null>;
 //# sourceMappingURL=edge-routing.d.ts.map

package/dist/edge-routing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"edge-routing.d.ts","sourceRoot":"","sources":["../src/edge-routing.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EACR,WAAW,EACX,KAAK,EACL,uBAAuB,EACvB,kBAAkB,EAErB,MAAM,YAAY,CAAC;AAEpB;;;yEAGyE;AACzE,MAAM,WAAW,WAAW;IACxB,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;2DAE2D;AAC3D,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,EAAE,KAAK,CAAC;IACV;;sEAEkE;IAClE,cAAc,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,KAAK,EAAE,CAAC;IACnB;;2DAEuD;IACvD,QAAQ,EAAE,OAAO,CAAC;CACrB;AAED;;;uBAGuB;AACvB,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC;;;;6CAI6C;AAC7C,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC;;;;;mEAKmE;AACnE,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAmBpC,MAAM,WAAW,gBAAgB;IAC7B;;uCAEmC;IACnC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB;;gDAE4C;IAC5C,QAAQ,EAAE,WAAW,EAAE,CAAC;CAC3B;AAED,qBAAa,WAAW;IACpB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IAEzC,YAAY,KAAK,EAAE,gBAAgB,EAGlC;IAED;qCACiC;IACjC,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAS1D;IAED;;yCAEqC;IACrC,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAUjF;CACJ;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACnC,SAAS,EAAE,kBAAkB,EAAE,EAC/B,QAAQ,EAAE,uBAAuB,EAAE,GACpC,gBAAgB,CAqElB;AAyPD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC7B,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,IAAI,EAAE,WAAW,GAClB,eAAe,EAAE,CAkDnB"}
+{"version":3,"file":"edge-routing.d.ts","sourceRoot":"","sources":["../src/edge-routing.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAErD,8DAA8D;AAC9D,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,gGAAgG;AAChG,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,gDAAgD;AAChD,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC,gGAAgG;AAChG,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAWnC,wEAAwE;AACxE,MAAM,WAAW,QAAQ;IACrB,yFAAyF;IACzF,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,4FAA4F;IAC5F,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,kFAAkF;IAClF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,CAAC;IACjB,MAAM,EAAE,QAAQ,CAAC;CACpB;AAED,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC3B;;;;OAIG;IACH,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,kFAAkF;IAClF,KAAK,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,SAAS,EAAE,KAAK,EAAE,CAAC;IACnB,4EAA4E;IAC5E,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,GAAG,KAAK,CAAC;CACzB;AAED,sGAAsG;AACtG,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,yGAAyG;AACzG,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,GAAG,KAAK,CAAA;CAAE,CAGrF;AAoLD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC7B,QAAQ,EAAE,sBAAsB,EAAE,EAClC,SAAS,EAAE,cAAc,EACzB,YAAY,EAAE,MAAM,GACrB,KAAK,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA6FhC"}