@issuegraph/viewer 0.3.0 → 0.9.1

package/dist/layout.d.ts

@@ -46,6 +46,15 @@ export interface NodeBox {
     /** The slot this node belongs to, when it is on the spine. */
     readonly rank: number | null;
     readonly held: boolean;
+    /**
+     * The runner is working this one NOW.
+     *
+     * §16b gives it the top station on the spine, above rank 1, because "what is
+     * running" and "what is next" are the same question asked one step apart —
+     * and a NOW row rendered above the canvas, which is what shipped, is off the
+     * one line the whole sequence is supposed to read down.
+     */
+    readonly now?: boolean;
 }
 export interface Point {
     readonly x: number;
@@ -62,68 +71,88 @@ export interface GraphLayout {
     /** The free vertical channels arcs route through. */
     readonly leftChannel: number;
     readonly rightChannel: number;
+    /**
+     * The x of the spine LINE — the one vertical the whole sequence reads off.
+     * Stations are centred on it and the cards sit to its right.
+     */
+    readonly spineLineX: number;
+    /** Where the spine line starts and ends, so it spans the stations and no more. */
+    readonly spineTop: number;
+    readonly spineBottom: number;
+    /** The x each of the three column headings is set at. */
+    readonly columnX: Readonly<Record<Column, number>>;
+    /**
+     * The slot leads the canvas draws NOWHERE — runner-held, and blocking nothing
+     * on the spine, so they explain nothing about the order. They are the graph's
+     * half of §16a's footer group, and the projection renders them beneath the
+     * stage as that group rather than on a column.
+     */
+    readonly footer: readonly string[];
+    /** Whether this layout is the in-column preview or the full-width picture. */
+    readonly compact: boolean;
 }
 /**
- * How wide a drawn label runs, under the same model {@link fitLabel} truncates
- * with.
+ * How wide a drawn label runs.
  *
- * EXPORTED SO A TEST CAN CHECK THE GEOMETRY WITHOUT RESTATING THE MODEL. The
- * overflow invariant used to be asserted with `text.length * --ig-char-width`,
- * which is the mono advance at the wrong size and the very assumption #44
- * named — so the guard shared the defect it was guarding against. Measuring
- * with this checks that the right box got the right label; the wide-glyph
- * bound is what checks the model itself, against a number stated outside it.
+ * NOTHING TRUNCATES ANY MORE, and this is what replaced the function that did.
+ * A node is an HTML card whose title wraps, so the question stopped being "how
+ * much of this fits on one line" and became "how many lines does this need" —
+ * which is what {@link layoutGraph} asks it, to give a card a height before
+ * anything is rendered. `fitLabel` went with the truncation it existed to
+ * perform: §16b's acceptance is that nothing truncates that the design draws in
+ * full, and a helper that shortens a title had no caller left.
+ *
+ * IT IS A CEILING, per character class rather than a flat average — see
+ * `labelWidth`. A card that reserves slightly too much leaves a gap; one that
+ * reserves too little is overlapped by the next rank.
  */
 export declare function measureLabel(theme: Theme, label: string): number;
-export declare function fitLabel(theme: Theme, label: string, width: number): string;
-/** Lay a document out. Pure: coordinates depend only on the document and the theme. */
-export declare function layoutGraph(document: NormalizedDocument, theme: Theme): GraphLayout;
+/**
+ * Lay a document out. Pure: coordinates depend only on the document, the theme
+ * and the size.
+ *
+ * COMPACT IS A SIZE, NOT A DEGRADED MODE. §16b is explicit that at a settings
+ * column's width the arcs and both gutters cannot be drawn legibly, so the
+ * in-column case is a spine-only preview with an expand affordance rather than
+ * the same picture squeezed. Expressed as a zero-width gutter, so exactly one
+ * layout computes both and the spine's own geometry cannot differ between them.
+ */
+export declare function layoutGraph(document: NormalizedDocument, theme: Theme, compact?: boolean): GraphLayout;
 export interface EdgeGeometry {
     /** The SVG path. Always a quadratic through one of the free channels. */
     readonly d: string;
     readonly start: Point;
     readonly end: Point;
+    /**
+     * The quadratic's control point — the one `d` bows through.
+     *
+     * Published so a caller that needs a point ON the curve can solve for one
+     * rather than estimate it from the chord. The midpoint of a quadratic is
+     * `¼P₀ + ½C + ¼P₂`, which is a different point from the chord's midpoint
+     * wherever the curve actually bows, and the difference is the whole width of
+     * a channel.
+     */
+    readonly control: Point;
+    /**
+     * Which bound of its own box each endpoint sits on.
+     *
+     * PUBLISHED BECAUSE "OUTSIDE THE CARD" IS NOT DERIVABLE FROM THE LINE, and
+     * three separate attempts to derive it proved that the hard way. A caller
+     * placing a mark beside an endpoint must know which way is away from the card,
+     * and the chord's direction, the arriving tangent and the routing channel each
+     * answer a different question — so each of them was right for some edges and
+     * put marks inside a card for others.
+     *
+     * `facingSide` already decides this, per endpoint, and used to discard it. A
+     * `left` anchor is cleared by moving further left; a `right` one by moving
+     * right. The two ends genuinely differ: an arc between a gutter card and a
+     * spine card leaves one box's right face and arrives on the other's left, so
+     * one shared direction cannot clear both.
+     */
+    readonly startSide: 'left' | 'right';
+    readonly endSide: 'left' | 'right';
     /** Radians. Orients the terminal marker along the path's own tangent. */
     readonly endAngle: number;
 }
-/**
- * The geometry for one edge, derived entirely from the two boxes' bounds.
- *
- * Returns `null` when either end has no box — which `normalizeDocument` has
- * already made impossible for a kept edge, so a `null` here means a caller
- * built a layout from a different document than the edge came from. Refusing is
- * better than drawing at coordinates nobody computed.
- */
 export declare function edgeGeometry(layout: GraphLayout, edge: ViewerEdge): EdgeGeometry | null;
-/**
- * The path joining two members of one together unit, clear of every member box.
- *
- * ONE CONNECTOR PER DECLARED EDGE, which is why this takes two keys rather than
- * a position in the member list. A group is joined by pointing at any existing
- * member (§4.3.7), so `2 together-with 1` plus `3 together-with 1` is an
- * ordinary STAR whose members lay out as three consecutive rows — and a
- * connector drawn between adjacent rows would claim a `2`–`3` relationship the
- * document never declares while leaving the real `1`–`3` edge undrawable.
- *
- * TWO ROUTES, and the branch is the whole of it. Members of a slot are placed
- * consecutively in one column, so an edge between NEIGHBOURING rows crosses
- * only the gap between them and is drawn straight. An edge that spans a row —
- * which only a star can produce — would run through the node between them, so
- * it is routed out to a lane in the enclosure's own padding. The lane sits left
- * of `x`, and every member box in a column starts at exactly `x`, so the
- * vertical run is provably outside every occupied x-range rather than merely
- * looking clear.
- *
- * Endpoints come from measured bounds on both routes, per the kit's
- * implementation note: a hit target derived from an eyeballed offset drifts the
- * first time the type scale moves.
- */
-export declare function connectorPath(layout: GraphLayout, members: readonly string[], from: string, to: string, theme: Theme): string | null;
-/** The box enclosing a together unit's members, padded clear of their bounds. */
-export declare function enclosureBounds(layout: GraphLayout, members: readonly string[], theme: Theme): {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-} | null;
 //# sourceMappingURL=layout.d.ts.map

package/dist/layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../src/layout.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../src/layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEpE,OAAO,EAAoB,KAAK,KAAK,EAAgB,MAAM,YAAY,CAAC;AAExE;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAe7C,CAAC;AAEH,mCAAmC;AACnC,MAAM,MAAM,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAEhD,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB;;;;;;;OAOG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,kEAAkE;IAClE,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IAC7D,qDAAqD;IACrD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAyHD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhE;AAyOD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,EAAE,KAAK,EACZ,OAAO,UAAQ,GACd,WAAW,CA8Lb;AAED,MAAM,WAAW,YAAY;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC;IACpB;;;;;;;;OAQG;IACH,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AA4DD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,WAAW,EACnB,IAAI,EAAE,UAAU,GACf,YAAY,GAAG,IAAI,CAqCrB"}