@coldtea/pr-lens-renderer 0.1.0

package/dist/svg/primitives.js

@@ -0,0 +1,34 @@
+/**
+ * Code points XML 1.0 has no spelling for: most control characters, the
+ * surrogate halves, and the two non-characters at the end of the basic plane.
+ * They are dropped rather than escaped, because there is no escape — a
+ * document containing one is not merely ugly, it does not parse.
+ *
+ * Labels reach here from an extraction model by way of the schema, which
+ * constrains their length but not their alphabet, so this is the last place
+ * such a character can be stopped. Matching by code point rather than by code
+ * unit is what keeps a well-formed astral character — which is a pair of
+ * surrogates in memory — from being mistaken for two lone halves.
+ */
+const FORBIDDEN_IN_XML = /[\u0000-\u0008\u000B\u000C\u000E-\u001F\uD800-\uDFFF\uFFFE\uFFFF]/gu;
+/**
+ * XML escaping for text nodes and attribute values alike. Attributes are
+ * always written in double quotes, so the single quote does not need an
+ * entity, but `<` and `&` do in both positions.
+ */
+export const escapeXml = (value) => value
+    .replace(FORBIDDEN_IN_XML, "")
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;");
+const serialiseAttributes = (attributes) => Object.entries(attributes)
+    .filter((entry) => entry[1] !== undefined)
+    .map(([name, value]) => ` ${name}="${escapeXml(String(value))}"`)
+    .join("");
+export const tag = (name, attributes) => `<${name}${serialiseAttributes(attributes)}/>`;
+export const wrap = (name, attributes, children) => `<${name}${serialiseAttributes(attributes)}>${children}</${name}>`;
+export const textNode = (attributes, content) => wrap("text", attributes, escapeXml(content));
+/** Joins emitted fragments with newlines, dropping the ones that produced nothing. */
+export const lines = (fragments) => fragments.filter((fragment) => fragment.length > 0).join("\n");
+//# sourceMappingURL=primitives.js.map

package/dist/svg/primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../src/svg/primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,gBAAgB,GACpB,qEAAqE,CAAC;AAExE;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAa,EAAU,EAAE,CACjD,KAAK;KACF,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC;KAC7B,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;KACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;KACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;KACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAI7B,MAAM,mBAAmB,GAAG,CAAC,UAAsB,EAAU,EAAE,CAC7D,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC;KACvB,MAAM,CAAC,CAAC,KAAK,EAAsC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;KAC7E,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,KAAK,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC;KAChE,IAAI,CAAC,EAAE,CAAC,CAAC;AAEd,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,UAAsB,EAAU,EAAE,CAClE,IAAI,IAAI,GAAG,mBAAmB,CAAC,UAAU,CAAC,IAAI,CAAC;AAEjD,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,UAAsB,EAAE,QAAgB,EAAU,EAAE,CACrF,IAAI,IAAI,GAAG,mBAAmB,CAAC,UAAU,CAAC,IAAI,QAAQ,KAAK,IAAI,GAAG,CAAC;AAErE,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,UAAsB,EACtB,OAAe,EACP,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;AAE1D,sFAAsF;AACtF,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,SAA4B,EAAU,EAAE,CAC5D,SAAS,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC"}

package/dist/svg/pulse.d.ts

@@ -0,0 +1,24 @@
+/**
+ * The travelling pulse: the mark that says a connection carries traffic
+ * rather than merely existing. Both lenses draw it from here, because a
+ * reader moving between them is reading one language — an architecture edge
+ * and a sequence message differ in what they connect, not in how they live.
+ *
+ * A line running behind the drawing's clock says so with a negative `begin`,
+ * which starts its motion that far into its own turn. A positive delay would
+ * describe the same steady state and lie for the seconds after load: an
+ * animation has no effect before it begins, so the dot waiting for its turn
+ * would sit at the canvas origin, in the corner, in full view.
+ */
+/** The dot itself, so both lenses draw the same mark whatever clock moves it. */
+export declare const PULSE_RADIUS = 2.6;
+export declare const TRAIN_RADIUS = 3;
+export declare const travellingPulses: (pulse: {
+    path: string;
+    colour: string;
+    /** Dots riding this line at once, spread evenly around the turn. */
+    count: number;
+    /** How far this line runs behind the drawing's clock, in seconds. */
+    lag: number;
+}) => string;
+//# sourceMappingURL=pulse.d.ts.map

package/dist/svg/pulse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pulse.d.ts","sourceRoot":"","sources":["../../src/svg/pulse.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AACH,iFAAiF;AACjF,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B,eAAO,MAAM,gBAAgB,UAAW;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAC;CACb,KAAG,MAoBH,CAAC"}

package/dist/svg/pulse.js

@@ -0,0 +1,33 @@
+import { HERO_PULSE_DURATION, PULSE_DURATION } from "../design.js";
+import { coord } from "../geometry.js";
+import { lines, tag, wrap } from "./primitives.js";
+/**
+ * The travelling pulse: the mark that says a connection carries traffic
+ * rather than merely existing. Both lenses draw it from here, because a
+ * reader moving between them is reading one language — an architecture edge
+ * and a sequence message differ in what they connect, not in how they live.
+ *
+ * A line running behind the drawing's clock says so with a negative `begin`,
+ * which starts its motion that far into its own turn. A positive delay would
+ * describe the same steady state and lie for the seconds after load: an
+ * animation has no effect before it begins, so the dot waiting for its turn
+ * would sit at the canvas origin, in the corner, in full view.
+ */
+/** The dot itself, so both lenses draw the same mark whatever clock moves it. */
+export const PULSE_RADIUS = 2.6;
+export const TRAIN_RADIUS = 3;
+export const travellingPulses = (pulse) => {
+    const { path, colour, count, lag } = pulse;
+    const train = count > 1;
+    const duration = train ? HERO_PULSE_DURATION : PULSE_DURATION;
+    return lines(Array.from({ length: count }, (_, index) => {
+        const behind = (lag + (duration / count) * index) % duration;
+        return wrap("circle", { r: train ? TRAIN_RADIUS : PULSE_RADIUS, fill: colour }, tag("animateMotion", {
+            dur: `${coord(duration)}s`,
+            begin: behind === 0 ? undefined : `${coord(behind - duration)}s`,
+            repeatCount: "indefinite",
+            path,
+        }));
+    }));
+};
+//# sourceMappingURL=pulse.js.map

package/dist/svg/pulse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pulse.js","sourceRoot":"","sources":["../../src/svg/pulse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;;;;;;;GAWG;AACH,iFAAiF;AACjF,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAC;AAChC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAE9B,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAOhC,EAAU,EAAE;IACX,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;IAC3C,MAAM,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC;IACxB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,cAAc,CAAC;IAE9D,OAAO,KAAK,CACV,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE;QACzC,MAAM,MAAM,GAAG,CAAC,GAAG,GAAG,CAAC,QAAQ,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,QAAQ,CAAC;QAC7D,OAAO,IAAI,CACT,QAAQ,EACR,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,EACxD,GAAG,CAAC,eAAe,EAAE;YACnB,GAAG,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG;YAC1B,KAAK,EAAE,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG;YAChE,WAAW,EAAE,YAAY;YACzB,IAAI;SACL,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;AACJ,CAAC,CAAC"}

package/dist/text.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The renderer never asks a font engine how wide a string is: it must produce
+ * the same geometry on a CI runner with no fonts installed as on a laptop
+ * with all of them. Widths come from a table instead, and every box is sized
+ * with enough slack that the small error against a real face stays invisible.
+ */
+export type Face = "sans" | "sans-bold" | "mono";
+export declare const SANS_STACK = "-apple-system, BlinkMacSystemFont, \"Segoe UI\", \"Noto Sans\", Helvetica, Arial, sans-serif";
+export declare const MONO_STACK = "ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, monospace";
+/** Width of `text` in user units at `fontSize`, to a hundredth of a unit. */
+export declare const measure: (text: string, face: Face, fontSize: number) => number;
+/**
+ * Shortens `text` until it fits `maxWidth`, ellipsis included. Cutting by
+ * code point rather than by UTF-16 unit keeps a surrogate pair from being
+ * split into a replacement character.
+ */
+export declare const truncate: (text: string, face: Face, fontSize: number, maxWidth: number) => string;
+//# sourceMappingURL=text.d.ts.map

package/dist/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,MAAM,IAAI,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;AAEjD,eAAO,MAAM,UAAU,iGACqE,CAAC;AAC7F,eAAO,MAAM,UAAU,0EACgD,CAAC;AA0CxE,6EAA6E;AAC7E,eAAO,MAAM,OAAO,SAAU,MAAM,QAAQ,IAAI,YAAY,MAAM,KAAG,MAIpE,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,QAAQ,SACb,MAAM,QACN,IAAI,YACA,MAAM,YACN,MAAM,KACf,MAiBF,CAAC"}

package/dist/text.js

@@ -0,0 +1,70 @@
+import { assertNever } from "@coldtea/pr-lens-schema";
+export const SANS_STACK = '-apple-system, BlinkMacSystemFont, "Segoe UI", "Noto Sans", Helvetica, Arial, sans-serif';
+export const MONO_STACK = 'ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace';
+/** Advance widths per 1000 units of em, for the regular sans face. */
+const SANS_ADVANCE = {
+    " ": 278, "!": 278, '"': 355, "#": 556, $: 556, "%": 889, "&": 667, "'": 191,
+    "(": 333, ")": 333, "*": 389, "+": 584, ",": 278, "-": 333, ".": 278, "/": 278,
+    "0": 556, "1": 556, "2": 556, "3": 556, "4": 556, "5": 556, "6": 556, "7": 556,
+    "8": 556, "9": 556, ":": 278, ";": 278, "<": 584, "=": 584, ">": 584, "?": 556,
+    "@": 1015, A: 667, B: 667, C: 722, D: 722, E: 667, F: 611, G: 778, H: 722,
+    I: 278, J: 500, K: 667, L: 556, M: 833, N: 722, O: 778, P: 667, Q: 778, R: 722,
+    S: 667, T: 611, U: 722, V: 667, W: 944, X: 667, Y: 667, Z: 611, "[": 278,
+    "\\": 278, "]": 278, "^": 469, _: 556, "`": 333, a: 556, b: 556, c: 500, d: 556,
+    e: 556, f: 278, g: 556, h: 556, i: 222, j: 222, k: 500, l: 222, m: 833, n: 556,
+    o: 556, p: 556, q: 556, r: 333, s: 500, t: 278, u: 556, v: 500, w: 722, x: 500,
+    y: 500, z: 500, "{": 334, "|": 260, "}": 334, "~": 584,
+};
+/** What a character outside the table is assumed to cost, in the same units. */
+const FALLBACK_ADVANCE = 600;
+/**
+ * The bold face of the same family runs a little wider at every weight step.
+ * One factor over the regular table is close enough for boxes that already
+ * carry padding, and it keeps a second table from drifting out of sync.
+ */
+const BOLD_WIDENING = 1.06;
+const MONO_ADVANCE = 600;
+const advanceFor = (face, character) => {
+    switch (face) {
+        case "sans":
+            return SANS_ADVANCE[character] ?? FALLBACK_ADVANCE;
+        case "sans-bold":
+            return (SANS_ADVANCE[character] ?? FALLBACK_ADVANCE) * BOLD_WIDENING;
+        case "mono":
+            return MONO_ADVANCE;
+        default:
+            return assertNever(face, "Unhandled font face");
+    }
+};
+/** Width of `text` in user units at `fontSize`, to a hundredth of a unit. */
+export const measure = (text, face, fontSize) => {
+    let thousandths = 0;
+    for (const character of text)
+        thousandths += advanceFor(face, character);
+    return Math.round((thousandths / 1000) * fontSize * 100) / 100;
+};
+const ELLIPSIS = "…";
+/**
+ * Shortens `text` until it fits `maxWidth`, ellipsis included. Cutting by
+ * code point rather than by UTF-16 unit keeps a surrogate pair from being
+ * split into a replacement character.
+ */
+export const truncate = (text, face, fontSize, maxWidth) => {
+    if (measure(text, face, fontSize) <= maxWidth)
+        return text;
+    const characters = [...text];
+    const ellipsisWidth = measure(ELLIPSIS, face, fontSize);
+    let width = 0;
+    let kept = 0;
+    for (const character of characters) {
+        const next = width + measure(character, face, fontSize);
+        if (next + ellipsisWidth > maxWidth)
+            break;
+        width = next;
+        kept += 1;
+    }
+    if (kept === 0)
+        return ELLIPSIS;
+    return `${characters.slice(0, kept).join("").trimEnd()}${ELLIPSIS}`;
+};
+//# sourceMappingURL=text.js.map

package/dist/text.js.map

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

package/dist/theme.d.ts

@@ -0,0 +1,44 @@
+import { THEMES, type Theme } from "@coldtea/pr-lens-schema";
+/**
+ * The two halves of a GitHub `<picture>` pair. A comment ships both and the
+ * client picks; neither half may depend on the page it lands in, because an
+ * SVG served as an image cannot see it.
+ *
+ * The contract owns the pair, because the number of themes is one half of the
+ * arithmetic that bounds a document's view tree. Re-exported here so a caller
+ * rendering a diagram does not have to reach into the schema for it.
+ */
+export { THEMES, type Theme };
+/**
+ * Every colour the renderer can paint, resolved to a literal before it
+ * reaches the document. CSS custom properties would be shorter, but GitHub
+ * serves these files through an image proxy where nothing outside the file
+ * exists, so the palette is baked in per theme.
+ */
+export type Palette = {
+    background: string;
+    dot: string;
+    lane: string;
+    card: string;
+    cardBorder: string;
+    foreground: string;
+    muted: string;
+    edge: string;
+    chip: string;
+    pill: string;
+    pillBorder: string;
+    lifeline: string;
+    added: string;
+    addedFill: string;
+    addedBorder: string;
+    modified: string;
+    modifiedFill: string;
+    modifiedBorder: string;
+    removed: string;
+    removedFill: string;
+    removedBorder: string;
+    neutralFill: string;
+    shadow: string;
+};
+export declare const paletteFor: (theme: Theme) => Palette;
+//# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,MAAM,EAAE,KAAK,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAE1E;;;;;;;;GAQG;AACH,OAAO,EAAE,MAAM,EAAE,KAAK,KAAK,EAAE,CAAC;AAE9B;;;;;GAKG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAsDF,eAAO,MAAM,UAAU,UAAW,KAAK,KAAG,OASzC,CAAC"}

package/dist/theme.js

@@ -0,0 +1,72 @@
+import { assertNever, THEMES } from "@coldtea/pr-lens-schema";
+/**
+ * The two halves of a GitHub `<picture>` pair. A comment ships both and the
+ * client picks; neither half may depend on the page it lands in, because an
+ * SVG served as an image cannot see it.
+ *
+ * The contract owns the pair, because the number of themes is one half of the
+ * arithmetic that bounds a document's view tree. Re-exported here so a caller
+ * rendering a diagram does not have to reach into the schema for it.
+ */
+export { THEMES };
+const LIGHT = {
+    background: "#ffffff",
+    dot: "rgba(140,149,159,.35)",
+    lane: "#f6f8fa",
+    card: "#ffffff",
+    cardBorder: "#d1d9e0",
+    foreground: "#1f2328",
+    muted: "#59636e",
+    edge: "#8c959f",
+    chip: "#f6f8fa",
+    pill: "#ffffff",
+    pillBorder: "#d8dee4",
+    lifeline: "#d1d9e0",
+    added: "#1a7f37",
+    addedFill: "#dafbe1",
+    addedBorder: "rgba(31,136,61,.4)",
+    modified: "#9a6700",
+    modifiedFill: "#fff8c5",
+    modifiedBorder: "rgba(154,103,0,.35)",
+    removed: "#d1242f",
+    removedFill: "#ffebe9",
+    removedBorder: "rgba(209,36,47,.35)",
+    neutralFill: "#f6f8fa",
+    shadow: "rgba(31,35,40,.14)",
+};
+const DARK = {
+    background: "#0d1117",
+    dot: "rgba(110,118,129,.22)",
+    lane: "rgba(110,118,129,.07)",
+    card: "#1c2128",
+    cardBorder: "#3d444d",
+    foreground: "#e6edf3",
+    muted: "#9198a1",
+    edge: "#6e7681",
+    chip: "rgba(110,118,129,.18)",
+    pill: "#0d1117",
+    pillBorder: "#21262d",
+    lifeline: "#30363d",
+    added: "#3fb950",
+    addedFill: "rgba(46,160,67,.15)",
+    addedBorder: "rgba(63,185,80,.4)",
+    modified: "#d29922",
+    modifiedFill: "rgba(187,128,9,.15)",
+    modifiedBorder: "rgba(210,153,34,.4)",
+    removed: "#f85149",
+    removedFill: "rgba(248,81,73,.12)",
+    removedBorder: "rgba(248,81,73,.4)",
+    neutralFill: "rgba(110,118,129,.18)",
+    shadow: "rgba(0,0,0,.28)",
+};
+export const paletteFor = (theme) => {
+    switch (theme) {
+        case "light":
+            return LIGHT;
+        case "dark":
+            return DARK;
+        default:
+            return assertNever(theme, "Unhandled theme");
+    }
+};
+//# sourceMappingURL=theme.js.map

package/dist/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAc,MAAM,yBAAyB,CAAC;AAE1E;;;;;;;;GAQG;AACH,OAAO,EAAE,MAAM,EAAc,CAAC;AAkC9B,MAAM,KAAK,GAAY;IACrB,UAAU,EAAE,SAAS;IACrB,GAAG,EAAE,uBAAuB;IAC5B,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,UAAU,EAAE,SAAS;IACrB,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,SAAS;IAChB,SAAS,EAAE,SAAS;IACpB,WAAW,EAAE,oBAAoB;IACjC,QAAQ,EAAE,SAAS;IACnB,YAAY,EAAE,SAAS;IACvB,cAAc,EAAE,qBAAqB;IACrC,OAAO,EAAE,SAAS;IAClB,WAAW,EAAE,SAAS;IACtB,aAAa,EAAE,qBAAqB;IACpC,WAAW,EAAE,SAAS;IACtB,MAAM,EAAE,oBAAoB;CAC7B,CAAC;AAEF,MAAM,IAAI,GAAY;IACpB,UAAU,EAAE,SAAS;IACrB,GAAG,EAAE,uBAAuB;IAC5B,IAAI,EAAE,uBAAuB;IAC7B,IAAI,EAAE,SAAS;IACf,UAAU,EAAE,SAAS;IACrB,UAAU,EAAE,SAAS;IACrB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,uBAAuB;IAC7B,IAAI,EAAE,SAAS;IACf,UAAU,EAAE,SAAS;IACrB,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,SAAS;IAChB,SAAS,EAAE,qBAAqB;IAChC,WAAW,EAAE,oBAAoB;IACjC,QAAQ,EAAE,SAAS;IACnB,YAAY,EAAE,qBAAqB;IACnC,cAAc,EAAE,qBAAqB;IACrC,OAAO,EAAE,SAAS;IAClB,WAAW,EAAE,qBAAqB;IAClC,aAAa,EAAE,oBAAoB;IACnC,WAAW,EAAE,uBAAuB;IACpC,MAAM,EAAE,iBAAiB;CAC1B,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAY,EAAW,EAAE;IAClD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,OAAO;YACV,OAAO,KAAK,CAAC;QACf,KAAK,MAAM;YACT,OAAO,IAAI,CAAC;QACd;YACE,OAAO,WAAW,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;IACjD,CAAC;AACH,CAAC,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Stamped into every render manifest so a stored diagram can be traced to the
+ * code that drew it. Kept in step with package.json by a test, since a
+ * package cannot read its own manifest without doing I/O the renderer does
+ * not otherwise need.
+ */
+export declare const RENDERER_NAME = "@coldtea/pr-lens-renderer";
+export declare const RENDERER_VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,aAAa,8BAA8B,CAAC;AAEzD,eAAO,MAAM,gBAAgB,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,9 @@
+/**
+ * Stamped into every render manifest so a stored diagram can be traced to the
+ * code that drew it. Kept in step with package.json by a test, since a
+ * package cannot read its own manifest without doing I/O the renderer does
+ * not otherwise need.
+ */
+export const RENDERER_NAME = "@coldtea/pr-lens-renderer";
+export const RENDERER_VERSION = "0.1.0";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,2BAA2B,CAAC;AAEzD,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@coldtea/pr-lens-renderer",
+  "version": "0.1.0",
+  "description": "The PR Lens renderer: a schema-valid graph document in, a self-contained animated SVG out.",
+  "license": "MIT",
+  "author": "Ohans Emmanuel",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/coldteadotai/pr-lens.git",
+    "directory": "packages/renderer"
+  },
+  "homepage": "https://github.com/coldteadotai/pr-lens/tree/main/packages/renderer#readme",
+  "keywords": [
+    "pr-lens",
+    "code-review",
+    "architecture-diagram",
+    "data-flow",
+    "svg",
+    "diagram"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.11"
+  },
+  "dependencies": {
+    "@coldtea/pr-lens-schema": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.0",
+    "typescript": "7.0.2",
+    "vitest": "4.1.11"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}

package/src/bounds.ts

@@ -0,0 +1,50 @@
+import type { Box } from "./geometry.js";
+
+/** The smallest box containing all of them, or nothing when there are none. */
+export const union = (boxes: readonly Box[]): Box | undefined => {
+  const first = boxes[0];
+  if (first === undefined) return undefined;
+
+  let left = first.x;
+  let top = first.y;
+  let right = first.x + first.width;
+  let bottom = first.y + first.height;
+
+  for (const box of boxes) {
+    left = Math.min(left, box.x);
+    top = Math.min(top, box.y);
+    right = Math.max(right, box.x + box.width);
+    bottom = Math.max(bottom, box.y + box.height);
+  }
+
+  return { x: left, y: top, width: right - left, height: bottom - top };
+};
+
+export type Canvas = { width: number; height: number; shiftX: number; shiftY: number };
+
+/**
+ * A canvas big enough for everything that was drawn.
+ *
+ * Edge routes deliberately leave their lane, and a label pill can be pushed
+ * past the last card in search of clear air, so the space the lanes occupy is
+ * a floor rather than the answer. The canvas only ever grows: the margins the
+ * design leaves above and beside the lanes are part of the design, not slack
+ * to be reclaimed.
+ */
+export const canvasFor = (
+  laid: { width: number; height: number },
+  drawn: Box | undefined,
+  margin: number,
+): Canvas => {
+  if (drawn === undefined) return { width: laid.width, height: laid.height, shiftX: 0, shiftY: 0 };
+
+  const shiftX = Math.max(0, margin - drawn.x);
+  const shiftY = Math.max(0, margin - drawn.y);
+
+  return {
+    width: Math.ceil(Math.max(laid.width, drawn.x + drawn.width + margin) + shiftX),
+    height: Math.ceil(Math.max(laid.height, drawn.y + drawn.height + margin) + shiftY),
+    shiftX,
+    shiftY,
+  };
+};

package/src/corrections.ts

@@ -0,0 +1,166 @@
+import type {
+  Flow,
+  FlowMessage,
+  GraphDoc,
+  GraphEdge,
+  GraphNode,
+  Lane,
+  MapCorrections,
+  View,
+  ViewScope,
+} from "@coldtea/pr-lens-schema";
+import { assertNever } from "@coldtea/pr-lens-schema";
+import { PrLensRenderError } from "./errors.js";
+import { matchesGlob } from "./glob.js";
+
+const ID_SELECTOR = "id:";
+
+const selects = (selector: string, node: GraphNode): boolean => {
+  if (selector.startsWith(ID_SELECTOR)) return node.id === selector.slice(ID_SELECTOR.length);
+  return node.files.some((file) => matchesGlob(selector, file.path));
+};
+
+/**
+ * A view of a selection with the ids the overlay removed taken out, or
+ * `undefined` when nothing it pointed at survived. A selection is never
+ * allowed to empty out into "show everything": that is a different view.
+ */
+const narrowScope = (
+  scope: ViewScope,
+  survives: { lane: (id: string) => boolean; node: (id: string) => boolean; edge: (id: string) => boolean; flow: (id: string) => boolean },
+): ViewScope | undefined => {
+  switch (scope.kind) {
+    case "all":
+      return scope;
+    case "selection": {
+      const narrowed = {
+        kind: "selection" as const,
+        lanes: scope.lanes.filter(survives.lane),
+        nodes: scope.nodes.filter(survives.node),
+        edges: scope.edges.filter(survives.edge),
+        flows: scope.flows.filter(survives.flow),
+      };
+      const total =
+        narrowed.lanes.length + narrowed.nodes.length + narrowed.edges.length + narrowed.flows.length;
+      return total > 0 ? narrowed : undefined;
+    }
+    default:
+      return assertNever(scope, "Unhandled view scope");
+  }
+};
+
+const narrowViews = (
+  views: readonly View[],
+  survives: Parameters<typeof narrowScope>[1],
+): View[] =>
+  views.flatMap((view) => {
+    const scope = narrowScope(view.scope, survives);
+    if (scope === undefined) return [];
+    return [{ ...view, scope, children: narrowViews(view.children, survives) }];
+  });
+
+/**
+ * Applies a repository's corrections over an inferred document.
+ *
+ * The overlay is re-applied to fresh inference on every run, so a correction
+ * keeps holding as the code moves and inference never learns to agree with
+ * it. Everything a removed node touched goes with it: an edge to a node that
+ * is no longer drawn would point at empty space, and a flow step from one
+ * would animate out of nowhere.
+ */
+export const applyCorrections = (doc: GraphDoc, corrections: MapCorrections): GraphDoc => {
+  const excluded = new Set(
+    doc.nodes.filter((node) => corrections.exclude.some((selector) => selects(selector, node))).map((node) => node.id),
+  );
+
+  const nodes: GraphNode[] = doc.nodes
+    .filter((node) => !excluded.has(node.id))
+    .map((node) => {
+      const rename = corrections.rename.find((rule) => selects(rule.match, node));
+      const lane = corrections.lane.find((rule) => selects(rule.match, node));
+      const group = corrections.group.find((rule) => selects(rule.match, node));
+      return {
+        ...node,
+        label: rename ? rename.to : node.label,
+        lane: lane ? lane.lane : node.lane,
+        group: group ? group.group : node.group,
+      };
+    });
+
+  if (nodes.length === 0)
+    throw new PrLensRenderError(
+      "NOTHING_TO_RENDER",
+      "the exclude rules in this repository's config removed every node",
+    );
+
+  /**
+   * A `lane` correction may name a band the document never declared, which is
+   * how a repository adds one of its own. It gets the id for a label, since
+   * that is the only name the config carries.
+   */
+  const declared = new Set(doc.lanes.map((lane) => lane.id));
+  const invented: Lane[] = [...new Set(nodes.map((node) => node.lane))]
+    .filter((id) => !declared.has(id))
+    .map((id) => ({ id, label: id }));
+
+  const lanes = [...doc.lanes, ...invented];
+
+  const edges: GraphEdge[] = doc.edges.filter(
+    (edge) => !excluded.has(edge.from) && !excluded.has(edge.to),
+  );
+
+  const flows: Flow[] = doc.flows.flatMap((flow) => {
+    const participants = flow.participants.filter((participant) => !excluded.has(participant.node));
+    if (participants.length < 2) return [];
+
+    const kept = new Set(participants.map((participant) => participant.node));
+    const messages: FlowMessage[] = flow.messages.filter(
+      (message) => kept.has(message.from) && kept.has(message.to),
+    );
+    if (messages.length === 0) return [];
+
+    return [{ ...flow, participants, messages }];
+  });
+
+  const survives = {
+    lane: (id: string) => lanes.some((lane) => lane.id === id),
+    node: (id: string) => !excluded.has(id),
+    edge: (id: string) => edges.some((edge) => edge.id === id),
+    flow: (id: string) => flows.some((flow) => flow.id === id),
+  };
+
+  return {
+    ...doc,
+    lanes,
+    nodes,
+    edges,
+    flows,
+    views: narrowViews(doc.views, survives),
+    layout: narrowLayout(doc.layout, survives),
+  };
+};
+
+/**
+ * Layout hints name nodes and lanes, so an exclusion can leave one pointing at
+ * something that is no longer there. The renderer would not notice — a hint
+ * for a node it is not drawing simply goes unread — but the corrected document
+ * is a document like any other, and a surface that writes it out and parses it
+ * back is entitled to have it still be valid.
+ */
+const narrowLayout = (
+  layout: GraphDoc["layout"],
+  survives: Parameters<typeof narrowScope>[1],
+): GraphDoc["layout"] => {
+  if (layout === undefined) return undefined;
+
+  const rank =
+    layout.rank === undefined
+      ? undefined
+      : Object.fromEntries(Object.entries(layout.rank).filter(([id]) => survives.node(id)));
+
+  return {
+    ...layout,
+    laneOrder: layout.laneOrder.filter(survives.lane),
+    ...(rank === undefined ? {} : { rank }),
+  };
+};