@issuegraph/viewer 0.1.0

package/dist/parts.d.ts

@@ -0,0 +1,89 @@
+/**
+ * The pieces every projection draws the same way.
+ *
+ * Identity, provenance, holds, readiness stations and edge badges are one
+ * grammar, not three — the design's extensibility clause turns on that. Putting
+ * them here means a projection cannot invent a second spelling of "this issue
+ * is held", and a change to the grammar lands in every projection at once.
+ */
+import type { NormalizedDocument, RankProvenance, ViewerHold, ViewerIssue, ViewerSlot } from './document.ts';
+import { type ElementSpec } from './element.ts';
+/** How a readiness station is filled — the parallelism channel. */
+export type StationFill = 'filled' | 'hollow' | 'dashed';
+/**
+ * Filled = ready now. Hollow = ready once a named rank lands. Dashed = held.
+ *
+ * The hollow case needs the host to have told us the rank; without it a ready
+ * slot is simply ready, and inventing a pending state would claim a dependency
+ * nobody declared.
+ */
+export declare function stationFill(slot: ViewerSlot): StationFill;
+export declare function station(fill: StationFill): ElementSpec;
+/**
+ * The identity chip: the qualified reference, linked only when the host gave us
+ * a URL. The viewer never constructs one — knowing a tracker's URL shape is the
+ * kind of knowledge this layer exists not to have.
+ */
+export declare function identity(issue: ViewerIssue): ElementSpec;
+/**
+ * The provenance line, in the three forms the design fixes: a matched ordering
+ * query, the declared tier, and an effective-priority promotion that names the
+ * dependent the urgency arrived through.
+ */
+export declare function provenanceLine(provenance: RankProvenance | undefined): ElementSpec | null;
+/** One hold, rendered with the family it belongs to visible in the markup. */
+export declare function holdLine(hold: ViewerHold): ElementSpec;
+/**
+ * Every relationship touching a ROW, as badges in the format's own field order
+ * — so two rows with the same relationships always read identically.
+ *
+ * TAKES THE ROW'S WHOLE KEY SET, NOT ONE KEY, because a together unit is ONE
+ * row and its partners get no row of their own. Reading only the lead dropped
+ * every relationship a partner owned: a unit blocked through its partner
+ * rendered no blocking badge at all, so the order UI showed a held unit and
+ * silently withheld what was holding it. The keys are the row's identity, so
+ * `other` is whichever endpoint is OUTSIDE the set, and an edge internal to the
+ * unit still reads from its `from` end exactly as it did when the set was one
+ * key — a single-key row is unchanged by construction.
+ */
+export declare function edgeBadges(document: NormalizedDocument, keys: readonly string[]): ElementSpec | null;
+/** The legend. Rendered once per scene so the grammar is readable cold. */
+export declare function legend(): ElementSpec;
+/**
+ * Every key a projection draws under some OTHER key's station, mapped to it.
+ *
+ * One rule for the linear and graph projections, which both render a together
+ * unit as a single row or node keyed by its lead. Written once because two
+ * copies of "which key stands in for which" is exactly how a projection's
+ * markup and its published `navigable` came to disagree in the first place.
+ *
+ * Only non-identity entries, so a lookup that misses means "represents itself"
+ * and no projection has to enumerate the keys that are already their own.
+ */
+export declare function stationsOf(document: NormalizedDocument): ReadonlyMap<string, string>;
+/**
+ * The caller's options, with `selected` and `focused` named the way THIS
+ * projection names them.
+ *
+ * APPLIED BEFORE THE SCENE IS BUILT, and that is the whole point of it being
+ * here rather than only in `reconcile`. Reconciling afterwards fixed the state
+ * a handle reports and left the MARKUP built from the un-canonicalized key: the
+ * station's row was never marked `aria-current`, the roving tab stop stayed on
+ * whatever the fallback resolved to, and `renderViewer` — which never calls
+ * `reconcile` at all — was simply wrong. A viewer whose reported state and
+ * rendered DOM disagree is the defect, whichever half is right.
+ *
+ * The projection publishes the SAME map it canonicalized with, so `reconcile`
+ * cannot reach a different answer than the markup did.
+ */
+export declare function atStations<T extends {
+    selected?: string | null | undefined;
+    focused?: string | null | undefined;
+}>(options: T, stations: ReadonlyMap<string, string>): T;
+/** The title of a slot, naming every member — a together unit is one row. */
+export declare function slotTitle(document: NormalizedDocument, slot: ViewerSlot): string;
+/** A slot's accessible name: what it is, where it sits, and whether it is held. */
+export declare function slotLabel(document: NormalizedDocument, slot: ViewerSlot): string;
+/** The empty state. A container with nothing in it reads as a bug. */
+export declare function emptyState(message: string): ElementSpec;
+//# sourceMappingURL=parts.d.ts.map

package/dist/parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parts.d.ts","sourceRoot":"","sources":["../src/parts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EACV,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,WAAW,EACX,UAAU,EACX,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,WAAW,EAAW,MAAM,cAAc,CAAC;AAGzD,mEAAmE;AACnE,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,CAIzD;AAQD,wBAAgB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAOtD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAgBxD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,cAAc,GAAG,SAAS,GAAG,WAAW,GAAG,IAAI,CAuBzF;AAED,8EAA8E;AAC9E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,CAEtD;AAoBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,WAAW,GAAG,IAAI,CA0BpG;AAED,2EAA2E;AAC3E,wBAAgB,MAAM,IAAI,WAAW,CAWpC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,kBAAkB,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAQpF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE,EAChH,OAAO,EAAE,CAAC,EACV,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC,CAAC,CAKH;AAED,6EAA6E;AAC7E,wBAAgB,SAAS,CAAC,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAIhF;AAED,mFAAmF;AACnF,wBAAgB,SAAS,CAAC,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,UAAU,GAAG,MAAM,CAGhF;AAED,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CAEvD"}

package/dist/parts.js

@@ -0,0 +1,214 @@
+/**
+ * The pieces every projection draws the same way.
+ *
+ * Identity, provenance, holds, readiness stations and edge badges are one
+ * grammar, not three — the design's extensibility clause turns on that. Putting
+ * them here means a projection cannot invent a second spelling of "this issue
+ * is held", and a change to the grammar lands in every projection at once.
+ */
+import { element } from "./element.js";
+import { EDGE_ORDER, treatmentFor } from "./vocabulary.js";
+/**
+ * Filled = ready now. Hollow = ready once a named rank lands. Dashed = held.
+ *
+ * The hollow case needs the host to have told us the rank; without it a ready
+ * slot is simply ready, and inventing a pending state would claim a dependency
+ * nobody declared.
+ */
+export function stationFill(slot) {
+    if (!slot.ready)
+        return 'dashed';
+    const after = slot.readyAfterRank;
+    return after === undefined || after === null ? 'filled' : 'hollow';
+}
+const STATION_LABEL = Object.freeze({
+    filled: 'ready now',
+    hollow: 'ready after an earlier rank',
+    dashed: 'held',
+});
+export function station(fill) {
+    return element('span', {
+        class: 'ig-station',
+        'data-fill': fill,
+        role: 'img',
+        'aria-label': STATION_LABEL[fill],
+    });
+}
+/**
+ * The identity chip: the qualified reference, linked only when the host gave us
+ * a URL. The viewer never constructs one — knowing a tracker's URL shape is the
+ * kind of knowledge this layer exists not to have.
+ */
+export function identity(issue) {
+    if (issue.url === undefined || issue.url === '') {
+        return element('span', { class: 'ig-id' }, [issue.key]);
+    }
+    return element('span', { class: 'ig-id' }, [
+        element('a', {
+            class: 'ig-link',
+            href: issue.url,
+            rel: 'noreferrer',
+            'aria-label': `open ${issue.key}`,
+        }, [`${issue.key} ↗`]),
+    ]);
+}
+/**
+ * The provenance line, in the three forms the design fixes: a matched ordering
+ * query, the declared tier, and an effective-priority promotion that names the
+ * dependent the urgency arrived through.
+ */
+export function provenanceLine(provenance) {
+    if (provenance === undefined)
+        return null;
+    switch (provenance.kind) {
+        case 'matched-query':
+            return element('p', { class: 'ig-provenance' }, [
+                `matched ordered query ${String(provenance.index)} · `,
+                element('span', { class: 'ig-id' }, [provenance.label]),
+            ]);
+        case 'declared-tier':
+            return element('p', { class: 'ig-provenance' }, [
+                `priority tier P${String(provenance.priority)}`,
+            ]);
+        case 'promotion': {
+            const via = provenance.promotedBy.length === 0
+                ? ''
+                : ` · inherited from ${provenance.promotedBy.join(', ')}`;
+            return element('p', { class: 'ig-provenance' }, [
+                element('span', { class: 'ig-id' }, [provenance.notation]),
+                `${via}`,
+            ]);
+        }
+    }
+}
+/** One hold, rendered with the family it belongs to visible in the markup. */
+export function holdLine(hold) {
+    return element('p', { class: 'ig-hold', 'data-family': hold.family }, [hold.reason]);
+}
+/** A badge naming one relationship, on all four channels at once. */
+function edgeBadge(field, detail) {
+    const treatment = treatmentFor(field);
+    return element('span', {
+        class: 'ig-badge',
+        'data-edge': field,
+        title: `${treatment.label} ${detail}`,
+        'aria-label': `${treatment.label} ${detail}`,
+    }, [
+        element('span', { class: 'ig-glyph', 'aria-hidden': 'true' }, [treatment.glyph]),
+        element('span', {}, [detail]),
+    ]);
+}
+/**
+ * Every relationship touching a ROW, as badges in the format's own field order
+ * — so two rows with the same relationships always read identically.
+ *
+ * TAKES THE ROW'S WHOLE KEY SET, NOT ONE KEY, because a together unit is ONE
+ * row and its partners get no row of their own. Reading only the lead dropped
+ * every relationship a partner owned: a unit blocked through its partner
+ * rendered no blocking badge at all, so the order UI showed a held unit and
+ * silently withheld what was holding it. The keys are the row's identity, so
+ * `other` is whichever endpoint is OUTSIDE the set, and an edge internal to the
+ * unit still reads from its `from` end exactly as it did when the set was one
+ * key — a single-key row is unchanged by construction.
+ */
+export function edgeBadges(document, keys) {
+    const mine = new Set(keys);
+    const badges = [];
+    // ONE EDGE, ONE BADGE. Both endpoints of an intra-unit edge are members, so
+    // it appears in two `edgesOf` entries and would otherwise render twice on the
+    // row that owns both ends.
+    const seen = new Set();
+    for (const field of EDGE_ORDER) {
+        for (const key of keys) {
+            for (const edge of document.edgesOf.get(key) ?? []) {
+                if (edge.field !== field)
+                    continue;
+                const identity = `${edge.field}\u0000${edge.from}\u0000${edge.to}`;
+                if (seen.has(identity))
+                    continue;
+                seen.add(identity);
+                const treatment = treatmentFor(field);
+                // A symmetric edge states one fact whichever end you read it from, so it
+                // is announced as one relationship rather than as two directions.
+                const outgoing = mine.has(edge.from);
+                const other = outgoing ? edge.to : edge.from;
+                const detail = treatment.symmetric || outgoing ? other : `${other} (incoming)`;
+                badges.push(edgeBadge(field, detail));
+            }
+        }
+    }
+    if (badges.length === 0)
+        return null;
+    return element('span', { class: 'ig-badges' }, badges);
+}
+/** The legend. Rendered once per scene so the grammar is readable cold. */
+export function legend() {
+    return element('fieldset', { class: 'ig-legend' }, [
+        element('legend', { class: 'ig-legend-caption' }, ['relationships']),
+        ...EDGE_ORDER.map((field) => {
+            const treatment = treatmentFor(field);
+            return element('span', { class: 'ig-badge', 'data-edge': field }, [
+                element('span', { class: 'ig-glyph', 'aria-hidden': 'true' }, [treatment.glyph]),
+                element('span', {}, [treatment.label]),
+            ]);
+        }),
+    ]);
+}
+/**
+ * Every key a projection draws under some OTHER key's station, mapped to it.
+ *
+ * One rule for the linear and graph projections, which both render a together
+ * unit as a single row or node keyed by its lead. Written once because two
+ * copies of "which key stands in for which" is exactly how a projection's
+ * markup and its published `navigable` came to disagree in the first place.
+ *
+ * Only non-identity entries, so a lookup that misses means "represents itself"
+ * and no projection has to enumerate the keys that are already their own.
+ */
+export function stationsOf(document) {
+    const stations = new Map();
+    for (const slot of document.order.slots) {
+        for (const member of slot.members) {
+            if (member !== slot.lead)
+                stations.set(member, slot.lead);
+        }
+    }
+    return stations;
+}
+/**
+ * The caller's options, with `selected` and `focused` named the way THIS
+ * projection names them.
+ *
+ * APPLIED BEFORE THE SCENE IS BUILT, and that is the whole point of it being
+ * here rather than only in `reconcile`. Reconciling afterwards fixed the state
+ * a handle reports and left the MARKUP built from the un-canonicalized key: the
+ * station's row was never marked `aria-current`, the roving tab stop stayed on
+ * whatever the fallback resolved to, and `renderViewer` — which never calls
+ * `reconcile` at all — was simply wrong. A viewer whose reported state and
+ * rendered DOM disagree is the defect, whichever half is right.
+ *
+ * The projection publishes the SAME map it canonicalized with, so `reconcile`
+ * cannot reach a different answer than the markup did.
+ */
+export function atStations(options, stations) {
+    if (stations.size === 0)
+        return options;
+    const at = (key) => key === null || key === undefined ? key : (stations.get(key) ?? key);
+    return { ...options, selected: at(options.selected), focused: at(options.focused) };
+}
+/** The title of a slot, naming every member — a together unit is one row. */
+export function slotTitle(document, slot) {
+    return slot.members
+        .map((member) => document.byKey.get(member)?.title ?? member)
+        .join(' · ');
+}
+/** A slot's accessible name: what it is, where it sits, and whether it is held. */
+export function slotLabel(document, slot) {
+    const position = slot.rank === null ? 'held, no rank' : `rank ${String(slot.rank)}`;
+    return `${slotTitle(document, slot)} — ${slot.members.join(', ')} — ${position}`;
+}
+/** The empty state. A container with nothing in it reads as a bug. */
+export function emptyState(message) {
+    return element('p', { class: 'ig-empty' }, [message]);
+}
+//# sourceMappingURL=parts.js.map

package/dist/parts.js.map

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

package/dist/projections/graph.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The graph projection: the ordered spine with gutters, and arcs for everything
+ * off it.
+ *
+ * Sequence is vertical position on the spine. Dependency is the arcs. Both
+ * readings work at once because they use different visual channels, which is
+ * the whole reason this shape was chosen over a force-directed or layered
+ * drawing — those make dependency legible and sequence a hunt, and their layout
+ * shifts between refreshes, which destroys trust in a panel whose job is to be
+ * authoritative.
+ *
+ * IT REFUSES RATHER THAN DEGRADES. The list scales; the canvas is a local
+ * instrument answering "what surrounds this issue", so past its budget it says
+ * so and offers the next move instead of drawing a hairball.
+ */
+import type { NormalizedDocument } from '../document.ts';
+import { type Scene } from '../scene.ts';
+import { type Theme } from '../theme.ts';
+import { type SceneOptions } from './linear.ts';
+/**
+ * The node budget, from the design's scale table. Above the first threshold the
+ * canvas shows component capsules; above the second, clusters only.
+ */
+export declare const GRAPH_NODE_BUDGET = 60;
+export declare const CLUSTER_ONLY_BUDGET = 300;
+export interface GraphOptions extends SceneOptions {
+    readonly theme?: Theme | undefined;
+}
+export declare function graphScene(document: NormalizedDocument, rawOptions?: GraphOptions): Scene;
+//# sourceMappingURL=graph.d.ts.map

package/dist/projections/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/projections/graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EACV,kBAAkB,EAInB,MAAM,gBAAgB,CAAC;AAoBxB,OAAO,EAA0B,KAAK,KAAK,EAAmB,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,KAAK,KAAK,EAAgB,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,KAAK,YAAY,EAA6B,MAAM,aAAa,CAAC;AAE3E;;;GAGG;AACH,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,MAAM,WAAW,YAAa,SAAQ,YAAY;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC;CACpC;AA4bD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,kBAAkB,EAAE,UAAU,GAAE,YAAiB,GAAG,KAAK,CA4Q7F"}