@issuegraph/viewer 0.1.0

package/dist/layout.js

@@ -0,0 +1,297 @@
+/**
+ * Graph geometry, computed — never eyeballed.
+ *
+ * Three columns, three jobs: the LEFT GUTTER holds open issues outside the
+ * order that explain a hold, the CENTRE SPINE is the work order itself, and the
+ * RIGHT GUTTER holds issues the order never works. Sequence is vertical
+ * position on the spine; dependency is everything off it.
+ *
+ * Two rules carry most of the weight, and both come from the design's
+ * implementation note rather than from taste:
+ *
+ *  - **Every edge endpoint is derived from a node's computed bounds.** An edge
+ *    terminates ON a bound, never at a remembered offset, so a node that
+ *    changes size moves its edges with it.
+ *  - **Arcs stay out of the occupied x-ranges** and out of the station band.
+ *    The colour-blind-safety claim rests on four redundant channels, and the
+ *    terminal marker is the one that separates `decomposed-from` from
+ *    `duplicate-of` — a marker hidden under an opaque card silently drops the
+ *    encoding to three.
+ *
+ * Deterministic by construction: no measurement, no randomness, no clock. The
+ * same document always produces the same coordinates, which is what lets a
+ * panel whose job is to be authoritative be trusted between refreshes.
+ */
+/**
+ * Custom properties carrying LAYOUT OUTPUT rather than theme input.
+ *
+ * A theme token is a value a host chooses; these are values this module
+ * COMPUTES and writes onto individual elements, so the rail can sit on the node
+ * it names without either side hard-coding a coordinate. They are declared here
+ * so `styles.test.ts` can tell the two kinds apart — a `var()` naming neither a
+ * theme token nor one of these is still a defect, and still fails.
+ */
+export const LAYOUT_PROPERTIES = Object.freeze([
+    '--ig-stage-w',
+    '--ig-stage-h',
+    '--ig-row-x',
+    '--ig-row-y',
+    '--ig-row-w',
+    '--ig-row-h',
+]);
+function metric(theme, token) {
+    return theme.metrics[token];
+}
+/**
+ * A node's width follows its own contents rather than the column, so an edge
+ * terminating on its bound lands where the reader sees the box end. Clamped to
+ * the column so the channels stay free.
+ */
+/**
+ * The label as it fits the box the layout gave it.
+ *
+ * `boxWidth` CLAMPS to the column, so a title longer than the column gets a box
+ * narrower than its text — and an SVG `<text>` neither wraps nor clips, so the
+ * overflow ran straight across the routing channel and the neighbouring nodes,
+ * hiding the edges and labels the graph exists to show. Long issue titles are
+ * ordinary, so this was the common case rather than an edge one.
+ *
+ * IT MEASURES WITH THE SAME METRIC `boxWidth` SIZES WITH, which is the whole
+ * reason this belongs beside it rather than in the projection. Both read
+ * `--ig-char-width`, so the renderer's idea of what fits and the layout's cannot
+ * disagree — a separate estimate in the drawing code would be a second opinion
+ * about the same question, and the two would drift.
+ *
+ * THE ELLIPSIS IS THIS PACKAGE'S OWN TREATMENT, not a new convention: the rail's
+ * HTML rows already resolve an over-long title with `text-overflow: ellipsis`,
+ * so a canvas label that simply stopped mid-word would make the two surfaces
+ * disagree about what a truncated title looks like.
+ *
+ * NOTHING IS LOST TO A READER — the full title stays in the node's accessible
+ * name and its `<title>`, so this shortens what is DRAWN and never what is
+ * available.
+ */
+export function fitLabel(theme, label, width) {
+    const room = width - metric(theme, '--ig-space') * 2;
+    const fits = Math.floor(room / metric(theme, '--ig-char-width'));
+    if (fits >= label.length)
+        return label;
+    // Below two characters there is no room for a glyph AND the ellipsis, and an
+    // ellipsis alone names nothing — so the box has become too small to label at
+    // all, and drawing nothing is honester than drawing a lone dot.
+    if (fits < 2)
+        return '';
+    return `${label.slice(0, fits - 1)}\u2026`;
+}
+function boxWidth(theme, label, columnWidth) {
+    const padding = metric(theme, '--ig-space') * 2;
+    const measured = label.length * metric(theme, '--ig-char-width') + padding;
+    return Math.min(columnWidth, Math.max(columnWidth / 2, measured));
+}
+/**
+ * Assign every key that needs a box to a column.
+ *
+ * Totality is the requirement, not a nicety: every kept edge's endpoints must
+ * have bounds or its geometry is undefined, and `normalizeDocument` has already
+ * dropped the edges whose ends this document does not carry. Anything touched
+ * by an edge and not on the spine therefore lands in a gutter — the right one
+ * when the order deliberately never works it, the left one when it is an open
+ * issue standing in the way.
+ */
+function assignColumns(document) {
+    const spine = [];
+    const slotMembers = new Map();
+    const placed = new Set();
+    for (const slot of document.order.slots) {
+        slotMembers.set(slot.lead, slot.members);
+        for (const member of slot.members) {
+            if (placed.has(member))
+                continue;
+            placed.add(member);
+            spine.push(member);
+        }
+    }
+    const neverWorked = new Set(document.order.excluded.map((exclusion) => exclusion.key));
+    for (const edge of document.edges) {
+        if (edge.field !== 'decomposed-from')
+            continue;
+        const origin = document.byKey.get(edge.to);
+        if (origin !== undefined && !origin.open && !placed.has(edge.to))
+            neverWorked.add(edge.to);
+    }
+    const left = [];
+    const right = [];
+    const seen = new Set(placed);
+    for (const edge of document.edges) {
+        for (const end of [edge.from, edge.to]) {
+            if (seen.has(end))
+                continue;
+            seen.add(end);
+            (neverWorked.has(end) ? right : left).push(end);
+        }
+    }
+    for (const key of neverWorked) {
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        right.push(key);
+    }
+    return { spine, left, right, slotMembers };
+}
+/** Lay a document out. Pure: coordinates depend only on the document and the theme. */
+export function layoutGraph(document, theme) {
+    const rowHeight = metric(theme, '--ig-row-height');
+    const gap = metric(theme, '--ig-space');
+    const gutterWidth = metric(theme, '--ig-gutter-width');
+    const spineWidth = metric(theme, '--ig-spine-width');
+    const channelWidth = metric(theme, '--ig-gutter-width') / 2;
+    // THE CANVAS RESERVES WHAT THE ENCLOSURE NEEDS, AND WHAT THE FOCUS RING DOES.
+    // A `together-with` enclosure pads clear of its members' bounds, so a unit on
+    // the first or last row drew at a negative coordinate or past the bottom edge
+    // — outside the viewBox, and outside the stage, which hides its overflow.
+    // The focus ring reaches FURTHER than the enclosure and was clipped by the
+    // same edge: `:focus-visible` sits `--ig-space-tight` clear of the element and
+    // is `--ig-focus-ring` thick, so it extends their SUM outward, while a margin
+    // of `--ig-space-tight` alone left the top segment outside the stage — and on
+    // a one-row graph the bottom segment with it. A partial ring is exactly the
+    // indicator a keyboard reader depends on, so the margin covers the larger of
+    // the two demands rather than the one that happens to be named here.
+    // SUMMED FROM THE TOKENS, never written as 8: geometry is theme data in this
+    // package, so a retheme that changes either token moves the reservation with
+    // it instead of silently reintroducing the clip.
+    // The ENCLOSURE's own inset stays `--ig-space-tight` — this is the canvas
+    // margin, which must merely be big enough for both, not the same quantity.
+    const pad = metric(theme, '--ig-space-tight') + metric(theme, '--ig-focus-ring');
+    const { spine, left, right, slotMembers } = assignColumns(document);
+    const leftX = pad;
+    const spineX = pad + gutterWidth + channelWidth;
+    const rightX = spineX + spineWidth + channelWidth;
+    const width = rightX + gutterWidth + pad;
+    // The channels sit between the columns, so no arc routed through one can
+    // cross an occupied x-range.
+    const leftChannel = pad + gutterWidth + channelWidth / 2;
+    const rightChannel = spineX + spineWidth + channelWidth / 2;
+    const rankOf = new Map();
+    const heldOf = new Map();
+    for (const slot of document.order.slots) {
+        for (const member of slot.members) {
+            rankOf.set(member, slot.rank);
+            heldOf.set(member, !slot.ready);
+        }
+    }
+    const nodes = new Map();
+    const place = (keys, column, x, columnWidth) => {
+        keys.forEach((key, index) => {
+            const label = document.byKey.get(key)?.title ?? key;
+            nodes.set(key, {
+                key,
+                column,
+                x,
+                y: pad + index * (rowHeight + gap),
+                width: boxWidth(theme, label, columnWidth),
+                height: rowHeight,
+                rank: rankOf.get(key) ?? null,
+                held: heldOf.get(key) ?? false,
+            });
+        });
+    };
+    place(spine, 'spine', spineX, spineWidth);
+    place(left, 'left', leftX, gutterWidth);
+    place(right, 'right', rightX, gutterWidth);
+    const rows = Math.max(spine.length, left.length, right.length);
+    const height = rows === 0 ? 0 : rows * (rowHeight + gap) - gap + pad * 2;
+    return {
+        width,
+        height,
+        nodes,
+        spineOrder: spine,
+        slotMembers,
+        leftChannel,
+        rightChannel,
+    };
+}
+/**
+ * Where an edge leaves and enters, in the fraction of a box's height it uses.
+ *
+ * Departures leave low and arrivals enter high, so a path never runs along the
+ * centre line where the readiness station sits. That is the design's
+ * station-collision rule expressed as two numbers instead of a special case.
+ */
+const DEPART_FRACTION = 0.75;
+const ARRIVE_FRACTION = 0.25;
+/**
+ * Which bound of `box` the edge should leave from or arrive at.
+ *
+ * PAIRWISE, NOT PER-COLUMN, and the difference is the whole correctness of the
+ * drawing. Deciding from a box's own column alone made every spine endpoint the
+ * LEFT bound — so an arc to the right gutter left the spine on its far side and
+ * had to cross the node to reach its own terminal, occluding exactly the marker
+ * the colour-blind-safety claim depends on.
+ *
+ * ON A TIE, FACE THE CHANNEL. Two nodes in the same column have the same x, so
+ * "face the other" says nothing — and defaulting LEFT was right for the spine
+ * only by coincidence: the left channel happens to sit left of it. For two
+ * left-gutter nodes the same channel is on their RIGHT, so the default sent
+ * both endpoints out of the canvas and dragged the path back across the boxes.
+ * Facing the channel is the rule the spine case was an instance of, so it keeps
+ * "arcs bow left of the spine" while fixing the gutter.
+ */
+function facingSide(box, other, channelX) {
+    const centre = box.x + box.width / 2;
+    const otherCentre = other.x + other.width / 2;
+    if (otherCentre !== centre)
+        return otherCentre > centre ? 'right' : 'left';
+    return channelX > centre ? 'right' : 'left';
+}
+function anchor(box, fraction, side) {
+    return {
+        x: side === 'left' ? box.x : box.x + box.width,
+        y: box.y + box.height * fraction,
+    };
+}
+/**
+ * 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 function edgeGeometry(layout, edge) {
+    const from = layout.nodes.get(edge.from);
+    const to = layout.nodes.get(edge.to);
+    if (from === undefined || to === undefined)
+        return null;
+    // The channel is chosen FIRST, because on a same-column tie it is what
+    // decides which bound each endpoint uses. A pair of spine nodes bows LEFT, as
+    // the design fixes; anything touching the right gutter uses the right channel
+    // so the two families never tangle.
+    const usesRight = from.column === 'right' || to.column === 'right';
+    const controlX = usesRight ? layout.rightChannel : layout.leftChannel;
+    const start = anchor(from, DEPART_FRACTION, facingSide(from, to, controlX));
+    const end = anchor(to, ARRIVE_FRACTION, facingSide(to, from, controlX));
+    const controlY = (start.y + end.y) / 2;
+    const round = (value) => (Math.round(value * 100) / 100).toFixed(2);
+    const d = `M ${round(start.x)} ${round(start.y)} Q ${round(controlX)} ${round(controlY)} ${round(end.x)} ${round(end.y)}`;
+    return {
+        d,
+        start,
+        end,
+        endAngle: Math.atan2(end.y - controlY, end.x - controlX),
+    };
+}
+/** The box enclosing a together unit's members, padded clear of their bounds. */
+export function enclosureBounds(layout, members, theme) {
+    const boxes = members
+        .map((member) => layout.nodes.get(member))
+        .filter((box) => box !== undefined);
+    if (boxes.length < 2)
+        return null;
+    const pad = metric(theme, '--ig-space-tight');
+    const x = Math.min(...boxes.map((box) => box.x)) - pad;
+    const y = Math.min(...boxes.map((box) => box.y)) - pad;
+    const right = Math.max(...boxes.map((box) => box.x + box.width)) + pad;
+    const bottom = Math.max(...boxes.map((box) => box.y + box.height)) + pad;
+    return { x, y, width: right - x, height: bottom - y };
+}
+//# sourceMappingURL=layout.js.map

package/dist/layout.js.map

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

package/dist/mount.d.ts

@@ -0,0 +1,64 @@
+/**
+ * The DOM shell — the only module in this package that touches nodes.
+ *
+ * It is deliberately thin. Everything that could be wrong about WHAT is drawn
+ * lives in the projections, everything that could be wrong about WHERE
+ * navigation goes lives in `navigate`, and what is left here is three
+ * listeners, an index from key to element, and a teardown. A shell that grew
+ * decisions would be a second implementation of the parts above it, testable
+ * only through a DOM.
+ *
+ * IT REACHES NO GLOBAL. The document comes from the container the caller
+ * passed, which is what keeps this module importable on a runtime that has no
+ * DOM — the property the workspace smoke test measures against the published
+ * entry.
+ */
+import { type ViewerDocument } from './document.ts';
+import { type SpecDocument, type SpecElement } from './element.ts';
+import { type NavigationState } from './navigation.ts';
+import { type RenderOptions } from './render.ts';
+import { type Projection } from './scene.ts';
+/** The slice of an element `mount` needs beyond building. */
+export interface MountElement extends SpecElement {
+    readonly ownerDocument: SpecDocument;
+    /** Upper-case, as the DOM reports it. Absent on an implementation that has none. */
+    readonly tagName?: string;
+    addEventListener(type: string, handler: (event: MountEvent) => void): void;
+    removeEventListener(type: string, handler: (event: MountEvent) => void): void;
+    removeChild(child: SpecElement): void;
+    getAttribute(name: string): string | null;
+    readonly parentElement: MountElement | null;
+    focus?(): void;
+}
+/** The slice of an event `mount` reads. */
+export interface MountEvent {
+    readonly target?: MountElement | null;
+    /** Present on a keyboard event. */
+    readonly key?: string;
+    preventDefault?(): void;
+}
+export interface MountOptions extends RenderOptions {
+    /** Called when a key is selected — by click, `Enter`, or `select()`. */
+    readonly onSelect?: ((key: string | null) => void) | undefined;
+    /** Called with the hovered key, and with `null` when nothing is hovered. */
+    readonly onHover?: ((key: string | null) => void) | undefined;
+}
+export interface ViewerHandle {
+    /** Redraw. A still-present selection survives; focus follows it. */
+    update(input: ViewerDocument, options?: MountOptions): void;
+    /** Switch projection. The subject is kept; only the representation changes. */
+    setProjection(projection: Projection): void;
+    /** Select a key programmatically. Fires `onSelect` exactly as a click does. */
+    select(key: string | null): void;
+    readonly state: NavigationState;
+    /** Remove every listener this handle added and empty the container. */
+    destroy(): void;
+}
+/**
+ * Mount a viewer into a container.
+ *
+ * Returns a handle rather than nothing, because a host that cannot tear this
+ * down leaks a listener on every re-render — the shell's one genuine hazard.
+ */
+export declare function mountViewer(container: MountElement, input: ViewerDocument, options?: MountOptions): ViewerHandle;
+//# sourceMappingURL=mount.d.ts.map

package/dist/mount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../src/mount.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAA2B,KAAK,cAAc,EAAqB,MAAM,eAAe,CAAC;AAChG,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAe,MAAM,cAAc,CAAC;AAChF,OAAO,EACL,KAAK,eAAe,EAIrB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,aAAa,EAAY,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAkC,KAAK,UAAU,EAAc,MAAM,YAAY,CAAC;AAGzF,6DAA6D;AAC7D,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC;IACrC,oFAAoF;IACpF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IAC3E,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI,CAAC;IAC9E,WAAW,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IACtC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5C,KAAK,CAAC,IAAI,IAAI,CAAC;CAChB;AAED,2CAA2C;AAC3C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IACtC,mCAAmC;IACnC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,IAAI,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,YAAa,SAAQ,aAAa;IACjD,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC/D,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC/D;AAED,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,MAAM,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5D,+EAA+E;IAC/E,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC5C,+EAA+E;IAC/E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,uEAAuE;IACvE,OAAO,IAAI,IAAI,CAAC;CACjB;AAoED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,YAAY,EACvB,KAAK,EAAE,cAAc,EACrB,OAAO,GAAE,YAAiB,GACzB,YAAY,CAqTd"}