@coldtea/pr-lens-renderer 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ohans Emmanuel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,91 @@
+# @coldtea/pr-lens-renderer
+
+A schema-valid PR Lens graph document in, a self-contained animated SVG out. No network, no filesystem, no clock: the same document renders to the same bytes on any machine, which is what lets a diagram be addressed by the hash of itself.
+
+MIT © Ohans Emmanuel.
+
+```bash
+pnpm add @coldtea/pr-lens-renderer
+```
+
+```ts
+import { parseGraphDoc } from "@coldtea/pr-lens-schema";
+import { render, renderAll } from "@coldtea/pr-lens-renderer";
+
+const doc = parseGraphDoc(json);
+
+// One diagram.
+const { svg, width, height } = render(doc, { lens: "architecture", theme: "dark" });
+
+// Every drill-down section, in both themes, plus the manifest a comment is built from.
+const { assets, manifest } = renderAll(doc, { config });
+```
+
+## Two lenses
+
+`architecture` draws lanes of cards with the change written into them: a coloured outline and a badge per delta, removed elements ghosted and struck through, edges tinted by their own delta, one hero edge with a glow, and a travelling pulse on anything the document marked `animated`.
+
+`data-flow` draws a flow as a sequence: participant columns, lifelines, activation bars, return arrows, self-messages, and the architecture lens's travelling pulse on every step the document marks `animated`. Those steps share one cycle and take it in turn — one dot crossing one arrow at a time, in the order the steps happen, a repeated step taking consecutive turns. A turn is spent entirely on its crossing, so the next arrow lights as the last dot lands.
+
+## Rendering for a GitHub comment
+
+Every file is self-contained. No script, no external stylesheet, no image, no font file, and no CSS custom property that would need the surrounding page — GitHub serves comment images through a proxy where that page does not exist. Animation is SMIL, which survives being loaded as an `<img>`; the exact patterns here are the ones proven to play inside a real pull request comment.
+
+Themes are separate files rather than one file that adapts, because an image cannot see the theme of the page it lands in. Render both and pair them:
+
+```html
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="…-dark.svg">
+  <img src="…-light.svg" alt="…">
+</picture>
+```
+
+## Determinism
+
+The hard requirement is that a diagram does not rearrange itself between two pushes that barely changed anything.
+
+- **Depth** is a longest path from a source, so an arrow points at a node below the one it left. Cycles are ranked too, by dropping the edge that closes one — chosen by a walk in document order, not by map iteration order.
+- **`layout.rank` and `layout.laneOrder` are hints**, applied as a floor rather than an answer. A hint can push a node further down; it cannot lift one above what feeds it. A stale hint from an extraction model therefore cannot invert an edge.
+- **Depth is counted within a lane.** A lane that only enters the story late still starts at the top of its column, and a rank no card in the lane occupies leaves no empty row behind.
+- **Text is measured from a table**, never from a font engine, so a CI runner with no fonts installed lays out identically to a laptop with all of them.
+- **Every coordinate is rounded before it is written**, and every comparison is by code unit rather than by `localeCompare`. Arithmetic that differs in the last bit — or a sort that consults the host's collation data — would change the bytes, and the render hash with it.
+- **Every lane is the same fixed width**, a constant rather than anything derived from what the lanes hold. A width drawn from content couples every column to the contents of the ones before it, so adding one node with a long name to the first lane would slide every card in every later lane sideways. The cost is that a lane holding something narrow is wider than it needs to be; stability is worth more. A lane header too long for its band gives up its tail rather than widening the band.
+
+Adding a node to one lane leaves every card in every other lane exactly where it was — before it or after it. There are tests for that, and golden SVGs for the reference documents: a change to one is a change to what a reviewer sees, so it is reviewed by a person before it is committed.
+
+```bash
+pnpm test                 # compares against the goldens
+UPDATE_GOLDENS=1 pnpm test  # records them, for a human to read the diff of
+```
+
+## Corrections
+
+A repository's `.github/pr-lens.yml` is an overlay, applied here before layout and never written back into inference, so a correction keeps holding as the code moves:
+
+```ts
+render(doc, { lens: "architecture", theme: "dark", config });
+```
+
+`rename`, `lane` and `group` address nodes by `id:<node-id>` or by a glob over the paths backing them. A `lane` correction may name a band the document never declared; it gets created, with the id for a label, so write `lane: infrastructure` rather than `lane: l3`.
+
+`exclude` takes with it every edge and flow step that touched what it removed, every view that pointed at nothing else, and every layout hint left naming something that is gone — half an arrow is worse than none, and the corrected document is a document like any other, so it still parses.
+
+## Addresses
+
+Renders are content-addressed because GitHub's image proxy caches hard: a changed diagram has to arrive as a new URL, not as new bytes at the old one. `contentHash`, `renderAssetId` and `renderAssetFileName` are the single owners of that format, and every surface that builds such a URL must go through them.
+
+An asset's `path` is safe to join to an output directory, and its `id` is always a legal `Id`. View ids are authored by an extraction model and the contract lets one contain `/`, `:` and `.`, so `a/../../elsewhere` is a valid id; those characters are re-spelled one-for-one on the way into an address, which cannot produce a separator or a dot segment. Re-spelling can lengthen an id that was already near the contract's limit, so one that would overflow keeps a readable prefix and ends in a digest of the whole original — which is what stops two different views being handed the same address.
+
+## Untrusted text
+
+Labels, subtitles and titles come from a model. They are escaped for XML at the boundary, and the code points XML 1.0 has no spelling for — most control characters, lone surrogates, the two non-characters — are dropped there too, because the schema constrains how long a label is but not which characters it may contain, and one of those would make the file fail to parse rather than merely look wrong.
+
+## Refusals
+
+`PrLensRenderError` carries a `code` a caller can switch on: `UNKNOWN_VIEW`, `LENS_NOT_DECLARED`, `NOTHING_TO_RENDER`, `NO_FLOW_IN_SCOPE`, `TOO_MANY_ASSETS`. A document that parsed is otherwise safe to render — the renderer trusts `@coldtea/pr-lens-schema` and never re-validates it.
+
+`TOO_MANY_ASSETS` cannot be reached by a parsed document: the contract caps a view tree at `MAX_VIEWS`, which is `MAX_RENDER_ASSETS` divided by the two themes a `<picture>` pair needs. A hand-built one can reach it, because that cap lives in a refinement and a refinement does not survive into the inferred type. The check is a postcondition on what `renderAll` is about to produce rather than a re-reading of what came in — how many pictures a render makes depends on how many themes the caller asked for, which no document knows.
+
+---
+
+Part of [PR Lens](https://prlens.dev) — review what actually matters.

package/dist/bounds.d.ts

@@ -0,0 +1,23 @@
+import type { Box } from "./geometry.js";
+/** The smallest box containing all of them, or nothing when there are none. */
+export declare const union: (boxes: readonly Box[]) => Box | undefined;
+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 declare const canvasFor: (laid: {
+    width: number;
+    height: number;
+}, drawn: Box | undefined, margin: number) => Canvas;
+//# sourceMappingURL=bounds.d.ts.map

package/dist/bounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounds.d.ts","sourceRoot":"","sources":["../src/bounds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEzC,+EAA+E;AAC/E,eAAO,MAAM,KAAK,UAAW,SAAS,GAAG,EAAE,KAAG,GAAG,GAAG,SAiBnD,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvF;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,SACd;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,SAChC,GAAG,GAAG,SAAS,UACd,MAAM,KACb,MAYF,CAAC"}

package/dist/bounds.js

@@ -0,0 +1,39 @@
+/** The smallest box containing all of them, or nothing when there are none. */
+export const union = (boxes) => {
+    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 };
+};
+/**
+ * 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, drawn, margin) => {
+    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,
+    };
+};
+//# sourceMappingURL=bounds.js.map

package/dist/bounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounds.js","sourceRoot":"","sources":["../src/bounds.ts"],"names":[],"mappings":"AAEA,+EAA+E;AAC/E,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,KAAqB,EAAmB,EAAE;IAC9D,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACvB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE1C,IAAI,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC;IACnB,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC;IAClB,IAAI,KAAK,GAAG,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC;IAClC,IAAI,MAAM,GAAG,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;IAEpC,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QAC7B,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;QAC3B,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,EAAE,CAAC;AACxE,CAAC,CAAC;AAIF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CACvB,IAAuC,EACvC,KAAsB,EACtB,MAAc,EACN,EAAE;IACV,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IAEjG,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAE7C,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;QAC/E,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC;QAClF,MAAM;QACN,MAAM;KACP,CAAC;AACJ,CAAC,CAAC"}

package/dist/corrections.d.ts

@@ -0,0 +1,12 @@
+import type { GraphDoc, MapCorrections } from "@coldtea/pr-lens-schema";
+/**
+ * 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 declare const applyCorrections: (doc: GraphDoc, corrections: MapCorrections) => GraphDoc;
+//# sourceMappingURL=corrections.d.ts.map

package/dist/corrections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"corrections.d.ts","sourceRoot":"","sources":["../src/corrections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,QAAQ,EAIR,cAAc,EAGf,MAAM,yBAAyB,CAAC;AAmDjC;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,QAAS,QAAQ,eAAe,cAAc,KAAG,QAsE7E,CAAC"}

package/dist/corrections.js

@@ -0,0 +1,122 @@
+import { assertNever } from "@coldtea/pr-lens-schema";
+import { PrLensRenderError } from "./errors.js";
+import { matchesGlob } from "./glob.js";
+const ID_SELECTOR = "id:";
+const selects = (selector, node) => {
+    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, survives) => {
+    switch (scope.kind) {
+        case "all":
+            return scope;
+        case "selection": {
+            const narrowed = {
+                kind: "selection",
+                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, survives) => 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, corrections) => {
+    const excluded = new Set(doc.nodes.filter((node) => corrections.exclude.some((selector) => selects(selector, node))).map((node) => node.id));
+    const nodes = 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 = [...new Set(nodes.map((node) => node.lane))]
+        .filter((id) => !declared.has(id))
+        .map((id) => ({ id, label: id }));
+    const lanes = [...doc.lanes, ...invented];
+    const edges = doc.edges.filter((edge) => !excluded.has(edge.from) && !excluded.has(edge.to));
+    const flows = 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 = 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) => lanes.some((lane) => lane.id === id),
+        node: (id) => !excluded.has(id),
+        edge: (id) => edges.some((edge) => edge.id === id),
+        flow: (id) => 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, survives) => {
+    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 }),
+    };
+};
+//# sourceMappingURL=corrections.js.map

package/dist/corrections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"corrections.js","sourceRoot":"","sources":["../src/corrections.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,WAAW,GAAG,KAAK,CAAC;AAE1B,MAAM,OAAO,GAAG,CAAC,QAAgB,EAAE,IAAe,EAAW,EAAE;IAC7D,IAAI,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5F,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACrE,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,WAAW,GAAG,CAClB,KAAgB,EAChB,QAAwI,EACjH,EAAE;IACzB,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,KAAK;YACR,OAAO,KAAK,CAAC;QACf,KAAK,WAAW,EAAE,CAAC;YACjB,MAAM,QAAQ,GAAG;gBACf,IAAI,EAAE,WAAoB;gBAC1B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACxC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACxC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACxC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;aACzC,CAAC;YACF,MAAM,KAAK,GACT,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;YAChG,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1C,CAAC;QACD;YACE,OAAO,WAAW,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAAC;IACtD,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,WAAW,GAAG,CAClB,KAAsB,EACtB,QAA2C,EACnC,EAAE,CACV,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;IACrB,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAChD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACnC,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC9E,CAAC,CAAC,CAAC;AAEL;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,GAAa,EAAE,WAA2B,EAAY,EAAE;IACvF,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CACnH,CAAC;IAEF,MAAM,KAAK,GAAgB,GAAG,CAAC,KAAK;SACjC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;SACxC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QAC5E,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QACxE,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QAC1E,OAAO;YACL,GAAG,IAAI;YACP,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK;YACtC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI;YAClC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK;SACxC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEL,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QACpB,MAAM,IAAI,iBAAiB,CACzB,mBAAmB,EACnB,kEAAkE,CACnE,CAAC;IAEJ;;;;OAIG;IACH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAW,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;SAClE,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;SACjC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;IAEpC,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,CAAC,KAAK,EAAE,GAAG,QAAQ,CAAC,CAAC;IAE1C,MAAM,KAAK,GAAgB,GAAG,CAAC,KAAK,CAAC,MAAM,CACzC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAC7D,CAAC;IAEF,MAAM,KAAK,GAAW,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC/C,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QAChG,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QAEvC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1E,MAAM,QAAQ,GAAkB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAClD,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAC5D,CAAC;QACF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAErC,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG;QACf,IAAI,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC;QAC1D,IAAI,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACvC,IAAI,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC;QAC1D,IAAI,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC;KAC3D,CAAC;IAEF,OAAO;QACL,GAAG,GAAG;QACN,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC;QACvC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC;KAC3C,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,YAAY,GAAG,CACnB,MAA0B,EAC1B,QAA2C,EACvB,EAAE;IACtB,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE3C,MAAM,IAAI,GACR,MAAM,CAAC,IAAI,KAAK,SAAS;QACvB,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAE1F,OAAO;QACL,GAAG,MAAM;QACT,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QACjD,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;KACxC,CAAC;AACJ,CAAC,CAAC"}

package/dist/design.d.ts

@@ -0,0 +1,112 @@
+/**
+ * The measurements of the validated prototype, in one place. These are the
+ * design system: change a number here and every diagram moves with it.
+ */
+export declare const DIAGRAM_MARGIN = 16;
+export declare const LANE_TOP = 44;
+export declare const LANE_HEADER_BASELINE = 68;
+export declare const LANE_PADDING_X = 16;
+export declare const LANE_GAP = 20;
+export declare const LANE_BOTTOM_PADDING = 20;
+/**
+ * Every lane is the same width, and that width is a constant rather than
+ * anything derived from what the lanes hold.
+ *
+ * A lane's width decides where the lane after it starts, so a width drawn
+ * from content couples every column to the contents of the ones before it:
+ * adding one node with a long name to the first lane would slide every card
+ * in every later lane sideways, which is exactly the teleport a reviewer
+ * comparing two pushes must never be shown. The cost is that a lane holding
+ * something narrow is wider than it needs to be. Stability is worth more.
+ *
+ * Sized so that two cards sharing a row still each get a readable width.
+ */
+export declare const LANE_CONTENT_WIDTH = 372;
+export declare const LANE_RADIUS = 12;
+export declare const LANE_LABEL_SIZE = 10;
+export declare const LANE_LABEL_TRACKING = 0.12;
+export declare const CONTENT_TOP = 92;
+export declare const ROW_GAP = 52;
+export declare const CARD_RADIUS = 10;
+export declare const CARD_GAP_X = 12;
+export declare const CARD_HEIGHT = 52;
+export declare const CARD_HEIGHT_WITH_SUBTITLE = 62;
+export declare const CARD_PADDING_X = 14;
+export declare const ICON_CHIP_SIZE = 26;
+export declare const ICON_CHIP_GAP = 10;
+export declare const ICON_CHIP_RADIUS = 7;
+/** Below this a card's title steps down a size to keep its room. */
+export declare const ICON_MIN_CARD_WIDTH = 200;
+export declare const TITLE_SIZE = 13;
+export declare const TITLE_SIZE_SMALL = 11.5;
+export declare const SUBTITLE_SIZE = 9.5;
+export declare const BADGE_HEIGHT = 16;
+export declare const BADGE_PADDING_X = 9;
+export declare const BADGE_TEXT_SIZE = 8.5;
+export declare const BADGE_TRACKING = 0.06;
+export declare const BADGE_GAP = 6;
+export declare const BADGE_RADIUS = 8;
+/** How far the badge row rides above the top edge of the card it labels. */
+export declare const BADGE_RISE = 8;
+export declare const PILL_HEIGHT = 15;
+export declare const PILL_PADDING_X = 8;
+export declare const PILL_TEXT_SIZE = 9.5;
+/** Two label pills never sit closer than this, in either direction. */
+export declare const PILL_CLEARANCE = 2;
+/**
+ * Routes travel in the gaps of the grid: vertical corridors beside lanes and
+ * horizontal bands between rows. Both gaps are physically 52px across — lane
+ * padding + lane gap + lane padding one way, ROW_GAP the other — and a track
+ * keeps this clearance from the cards on either side, leaving 40px of room.
+ */
+export declare const TRACK_CLEARANCE = 6;
+/**
+ * Neighbouring tracks in one gap sit this far apart at most; when a gap
+ * carries more traffic than the room allows, the pitch shrinks to fit. An
+ * added route therefore nudges its gap-mates proportionately — an accepted
+ * trade, and one that never moves a card.
+ */
+export declare const TRACK_PITCH_MAX = 16;
+/**
+ * And never closer than this: below it, parallel runs stop reading as
+ * separate lines. A gap asked to carry more traffic than the floor allows
+ * does not compress further — it widens instead, corridors pushing the lanes
+ * beside them apart and row gaps pushing the rows, in proportion to the
+ * traffic and to nothing else.
+ */
+export declare const TRACK_PITCH_MIN = 10;
+/** Step between neighbouring arrow ports along one card face. */
+export declare const PORT_PITCH = 16;
+/** Ports keep clear of the card's rounded corners. */
+export declare const PORT_INSET = 14;
+/**
+ * A turn's bend radius comes from the shorter of its two legs, capped here.
+ * Deriving it from the longer leg balloons a route with one short leg and one
+ * long one — the shape every corridor run has — clear out of its corridor.
+ */
+export declare const BEND_RADIUS_MAX = 34;
+/** One turn of the travelling pulse, and of the staggered train. */
+export declare const PULSE_DURATION = 1.6;
+export declare const HERO_PULSE_DURATION = 2.1;
+export declare const HERO_PULSE_COUNT = 3;
+/**
+ * A sequence animates one step at a time, in order, because that is the one
+ * thing a sequence has to say. Each pulse owns a slot of the cycle outright
+ * and crosses its arrow for the whole of it, so the drawing always has
+ * exactly one dot in flight — the next arrow lights as the last dot lands.
+ *
+ * This is how long one crossing takes when the flow is short enough to
+ * afford it: brisk enough to read as travelling, slow enough to follow.
+ */
+export declare const FLOW_STEP_TRAVEL = 1.4;
+/**
+ * A whole sequence should play through in one sitting. Past this the steps
+ * share the ceiling instead, which speeds up a long flow rather than asking
+ * a reader to wait a minute for its last arrow.
+ */
+export declare const FLOW_CYCLE_MAX = 16;
+/** How much of its own slot a pulse spends fading in, and again fading out. */
+export declare const FLOW_PULSE_RAMP = 0.08;
+/** More repeats than this and the arrows stop reading as separate calls. */
+export declare const FLOW_MAX_PULSES_PER_MESSAGE = 3;
+//# sourceMappingURL=design.d.ts.map

package/dist/design.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"design.d.ts","sourceRoot":"","sources":["../src/design.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,eAAO,MAAM,QAAQ,KAAK,CAAC;AAC3B,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,eAAO,MAAM,QAAQ,KAAK,CAAC;AAC3B,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAExC,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,eAAO,MAAM,OAAO,KAAK,CAAC;AAE1B,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,cAAc,KAAK,CAAC;AAEjC,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAClC,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,eAAO,MAAM,gBAAgB,OAAO,CAAC;AACrC,eAAO,MAAM,aAAa,MAAM,CAAC;AAEjC,eAAO,MAAM,YAAY,KAAK,CAAC;AAC/B,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC,eAAO,MAAM,SAAS,IAAI,CAAC;AAC3B,eAAO,MAAM,YAAY,IAAI,CAAC;AAC9B,4EAA4E;AAC5E,eAAO,MAAM,UAAU,IAAI,CAAC;AAE5B,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,uEAAuE;AACvE,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC;;;;;GAKG;AACH,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC;;;;;GAKG;AACH,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,iEAAiE;AACjE,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,sDAAsD;AACtD,eAAO,MAAM,UAAU,KAAK,CAAC;AAE7B;;;;GAIG;AACH,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,oEAAoE;AACpE,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAElC;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,MAAM,CAAC;AACpC;;;;GAIG;AACH,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,+EAA+E;AAC/E,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,4EAA4E;AAC5E,eAAO,MAAM,2BAA2B,IAAI,CAAC"}

package/dist/design.js

@@ -0,0 +1,112 @@
+/**
+ * The measurements of the validated prototype, in one place. These are the
+ * design system: change a number here and every diagram moves with it.
+ */
+export const DIAGRAM_MARGIN = 16;
+export const LANE_TOP = 44;
+export const LANE_HEADER_BASELINE = 68;
+export const LANE_PADDING_X = 16;
+export const LANE_GAP = 20;
+export const LANE_BOTTOM_PADDING = 20;
+/**
+ * Every lane is the same width, and that width is a constant rather than
+ * anything derived from what the lanes hold.
+ *
+ * A lane's width decides where the lane after it starts, so a width drawn
+ * from content couples every column to the contents of the ones before it:
+ * adding one node with a long name to the first lane would slide every card
+ * in every later lane sideways, which is exactly the teleport a reviewer
+ * comparing two pushes must never be shown. The cost is that a lane holding
+ * something narrow is wider than it needs to be. Stability is worth more.
+ *
+ * Sized so that two cards sharing a row still each get a readable width.
+ */
+export const LANE_CONTENT_WIDTH = 372;
+export const LANE_RADIUS = 12;
+export const LANE_LABEL_SIZE = 10;
+export const LANE_LABEL_TRACKING = 0.12;
+export const CONTENT_TOP = 92;
+export const ROW_GAP = 52;
+export const CARD_RADIUS = 10;
+export const CARD_GAP_X = 12;
+export const CARD_HEIGHT = 52;
+export const CARD_HEIGHT_WITH_SUBTITLE = 62;
+export const CARD_PADDING_X = 14;
+export const ICON_CHIP_SIZE = 26;
+export const ICON_CHIP_GAP = 10;
+export const ICON_CHIP_RADIUS = 7;
+/** Below this a card's title steps down a size to keep its room. */
+export const ICON_MIN_CARD_WIDTH = 200;
+export const TITLE_SIZE = 13;
+export const TITLE_SIZE_SMALL = 11.5;
+export const SUBTITLE_SIZE = 9.5;
+export const BADGE_HEIGHT = 16;
+export const BADGE_PADDING_X = 9;
+export const BADGE_TEXT_SIZE = 8.5;
+export const BADGE_TRACKING = 0.06;
+export const BADGE_GAP = 6;
+export const BADGE_RADIUS = 8;
+/** How far the badge row rides above the top edge of the card it labels. */
+export const BADGE_RISE = 8;
+export const PILL_HEIGHT = 15;
+export const PILL_PADDING_X = 8;
+export const PILL_TEXT_SIZE = 9.5;
+/** Two label pills never sit closer than this, in either direction. */
+export const PILL_CLEARANCE = 2;
+/**
+ * Routes travel in the gaps of the grid: vertical corridors beside lanes and
+ * horizontal bands between rows. Both gaps are physically 52px across — lane
+ * padding + lane gap + lane padding one way, ROW_GAP the other — and a track
+ * keeps this clearance from the cards on either side, leaving 40px of room.
+ */
+export const TRACK_CLEARANCE = 6;
+/**
+ * Neighbouring tracks in one gap sit this far apart at most; when a gap
+ * carries more traffic than the room allows, the pitch shrinks to fit. An
+ * added route therefore nudges its gap-mates proportionately — an accepted
+ * trade, and one that never moves a card.
+ */
+export const TRACK_PITCH_MAX = 16;
+/**
+ * And never closer than this: below it, parallel runs stop reading as
+ * separate lines. A gap asked to carry more traffic than the floor allows
+ * does not compress further — it widens instead, corridors pushing the lanes
+ * beside them apart and row gaps pushing the rows, in proportion to the
+ * traffic and to nothing else.
+ */
+export const TRACK_PITCH_MIN = 10;
+/** Step between neighbouring arrow ports along one card face. */
+export const PORT_PITCH = 16;
+/** Ports keep clear of the card's rounded corners. */
+export const PORT_INSET = 14;
+/**
+ * A turn's bend radius comes from the shorter of its two legs, capped here.
+ * Deriving it from the longer leg balloons a route with one short leg and one
+ * long one — the shape every corridor run has — clear out of its corridor.
+ */
+export const BEND_RADIUS_MAX = 34;
+/** One turn of the travelling pulse, and of the staggered train. */
+export const PULSE_DURATION = 1.6;
+export const HERO_PULSE_DURATION = 2.1;
+export const HERO_PULSE_COUNT = 3;
+/**
+ * A sequence animates one step at a time, in order, because that is the one
+ * thing a sequence has to say. Each pulse owns a slot of the cycle outright
+ * and crosses its arrow for the whole of it, so the drawing always has
+ * exactly one dot in flight — the next arrow lights as the last dot lands.
+ *
+ * This is how long one crossing takes when the flow is short enough to
+ * afford it: brisk enough to read as travelling, slow enough to follow.
+ */
+export const FLOW_STEP_TRAVEL = 1.4;
+/**
+ * A whole sequence should play through in one sitting. Past this the steps
+ * share the ceiling instead, which speeds up a long flow rather than asking
+ * a reader to wait a minute for its last arrow.
+ */
+export const FLOW_CYCLE_MAX = 16;
+/** How much of its own slot a pulse spends fading in, and again fading out. */
+export const FLOW_PULSE_RAMP = 0.08;
+/** More repeats than this and the arrows stop reading as separate calls. */
+export const FLOW_MAX_PULSES_PER_MESSAGE = 3;
+//# sourceMappingURL=design.js.map

package/dist/design.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Codes are the stable half of a failure; the message is for a human. Every
+ * one of these describes a document the renderer cannot draw, never an
+ * internal fault.
+ */
+export type RenderErrorCode = "UNKNOWN_VIEW" | "LENS_NOT_DECLARED" | "NOTHING_TO_RENDER" | "NO_FLOW_IN_SCOPE" | "TOO_MANY_ASSETS";
+export declare class PrLensRenderError extends Error {
+    readonly code: RenderErrorCode;
+    constructor(code: RenderErrorCode, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,mBAAmB,GACnB,mBAAmB,GACnB,kBAAkB,GAClB,iBAAiB,CAAC;AAEtB,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAE/B,YAAY,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAIjD;CACF"}

package/dist/errors.js

@@ -0,0 +1,9 @@
+export class PrLensRenderError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.name = "PrLensRenderError";
+        this.code = code;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACjC,IAAI,CAAkB;IAE/B,YAAY,IAAqB,EAAE,OAAe;QAChD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/geometry.d.ts

@@ -0,0 +1,20 @@
+export type Point = {
+    x: number;
+    y: number;
+};
+export type Box = {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};
+/** Which face of a box a line meets. */
+export type Side = "top" | "right" | "bottom" | "left";
+/**
+ * Every coordinate the renderer writes goes through here. Floating point
+ * arithmetic that differs in the last bit would otherwise change the bytes of
+ * the document without changing the picture, and the render hash with it.
+ */
+export declare const coord: (value: number) => string;
+export declare const boxCentre: (box: Box) => Point;
+//# sourceMappingURL=geometry.d.ts.map

package/dist/geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../src/geometry.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7C,MAAM,MAAM,GAAG,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E,wCAAwC;AACxC,MAAM,MAAM,IAAI,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEvD;;;;GAIG;AACH,eAAO,MAAM,KAAK,UAAW,MAAM,KAAG,MAIrC,CAAC;AAEF,eAAO,MAAM,SAAS,QAAS,GAAG,KAAG,KAGnC,CAAC"}