@coldtea/pr-lens-renderer 0.4.0 → 0.5.0

package/README.md

@@ -77,6 +77,21 @@ The atlas is as deterministic as the SVG. Same document, same boxes, in the same
 
 Each lens fills in what it draws. The architecture lens places lanes, cards and edges and no flow step; the data-flow lens places the cards heading its columns and the steps of each flow, and no lane or edge. A node the same render draws twice, heading a column in two stacked flows, gets the box covering both of them: a reader sent to that node is being sent to all of it. A card's box is the card, not the badge strip above it, which is context a veil may dim.
 
+## The walkthrough embed
+
+```ts
+import { renderWalkthroughEmbed } from "@coldtea/pr-lens-renderer";
+
+const result = renderWalkthroughEmbed(doc, { theme: "dark" });
+if (result.type === "rendered") write(result.embed.svg);
+```
+
+A document's walkthrough as one animated SVG, 870 wide, for a surface that shows images and runs no script: a pull request comment, a README. The caption above the stage is styled as a GitHub alert, the camera flies between the diagrams on the canvas's own path and at its pace, and the context outside each step's focus is dimmed through a mask rather than a veil, because the picture cannot know the colour of the page it lands on. The tour plays twice and rests on its last step, caption and all; under `prefers-reduced-motion` it is that still. Only the diagrams the tour visits travel with it.
+
+The result is `absent` for a document with no walkthrough and `unresolvable`, with the steps at fault, for one whose tour points at something its diagrams do not draw. `renderAll` draws the embed for each half of the pair it was asked for and lists it under `walkthrough` in the manifest; a `neutral` render gets none, since the embed is transparent and tuned per half.
+
+The canvas and the embed share the strip layout, the camera and the walkthrough resolution (`stripLayout`, `frame`, `interpolateFlight`, `resolveWalkthrough`), so a step framed on one lands the same way on the other. A browser bundle imports them from `@coldtea/pr-lens-renderer/walkthrough`, which reaches nothing of node; `planTiles` and the embed itself stay on the root entry, since they draw.
+
 ## 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:

package/dist/atlas.d.ts

@@ -18,6 +18,12 @@ export type RenderAtlas = {
     messages: Record<string, Record<string, Box>>;
     /** The data-model lens's cards; its stores land in `lanes` and its relations in `edges`. */
     tables: Record<string, Box>;
+    /**
+     * The rows a table card draws, keyed by table then column name. A folded
+     * card lists only the columns it shows, so a column with no box here is one
+     * the picture left out, not one the surface may place by counting rows.
+     */
+    columns: Record<string, Record<string, Box>>;
 };
 /** An atlas for a drawing that has placed nothing. */
 export declare const emptyAtlas: () => RenderAtlas;

package/dist/atlas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"atlas.d.ts","sourceRoot":"","sources":["../src/atlas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAc,KAAK,GAAG,EAAE,MAAM,eAAe,CAAC;AAErD;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,wFAAwF;IACxF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAC9C,4FAA4F;IAC5F,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,UAAU,QAAO,WAA8E,CAAC;AAE7G,MAAM,MAAM,UAAU,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE,CAAC;AAElD;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,YACZ,SAAS,UAAU,EAAE,UACtB,MAAM,KACb,MAAM,CAAC,MAAM,EAAE,GAAG,CAgBpB,CAAC"}
+{"version":3,"file":"atlas.d.ts","sourceRoot":"","sources":["../src/atlas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAc,KAAK,GAAG,EAAE,MAAM,eAAe,CAAC;AAErD;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,wFAAwF;IACxF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;IAC9C,4FAA4F;IAC5F,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;CAC9C,CAAC;AAEF,sDAAsD;AACtD,eAAO,MAAM,UAAU,QAAO,WAA2F,CAAC;AAE1H,MAAM,MAAM,UAAU,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE,CAAC;AAElD;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,YACZ,SAAS,UAAU,EAAE,UACtB,MAAM,KACb,MAAM,CAAC,MAAM,EAAE,GAAG,CAgBpB,CAAC"}

package/dist/atlas.js

@@ -1,7 +1,7 @@
 import { covering } from "./bounds.js";
 import { roundCoord } from "./geometry.js";
 /** An atlas for a drawing that has placed nothing. */
-export const emptyAtlas = () => ({ lanes: {}, nodes: {}, edges: {}, messages: {}, tables: {} });
+export const emptyAtlas = () => ({ lanes: {}, nodes: {}, edges: {}, messages: {}, tables: {}, columns: {} });
 /**
  * Boxes onto the canvas and into a record, in the order they were drawn.
  *

package/dist/atlas.js.map

@@ -1 +1 @@
-{"version":3,"file":"atlas.js","sourceRoot":"","sources":["../src/atlas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAe,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,UAAU,EAAY,MAAM,eAAe,CAAC;AAsBrD,sDAAsD;AACtD,MAAM,CAAC,MAAM,UAAU,GAAG,GAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;AAI7G;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,OAA8B,EAC9B,MAAc,EACO,EAAE;IACvB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAe,CAAC;IACrC,KAAK,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,OAAO,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,KAAK,GAAwB,EAAE,CAAC;IACtC,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,KAAK;QAC3B,KAAK,CAAC,EAAE,CAAC,GAAG;YACV,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;YACpC,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;YACpC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC;YAC5B,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC;SAC/B,CAAC;IACJ,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}
+{"version":3,"file":"atlas.js","sourceRoot":"","sources":["../src/atlas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAe,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,UAAU,EAAY,MAAM,eAAe,CAAC;AA4BrD,sDAAsD;AACtD,MAAM,CAAC,MAAM,UAAU,GAAG,GAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;AAI1H;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,OAA8B,EAC9B,MAAc,EACO,EAAE;IACvB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAe,CAAC;IACrC,KAAK,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,OAAO,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9B,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,MAAM,KAAK,GAAwB,EAAE,CAAC;IACtC,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,KAAK;QAC3B,KAAK,CAAC,EAAE,CAAC,GAAG;YACV,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;YACpC,CAAC,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;YACpC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC;YAC5B,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC;SAC/B,CAAC;IACJ,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/glob.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../src/glob.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,WAAW,YAAa,MAAM,QAAQ,MAAM,KAAG,OAY3D,CAAC"}
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../src/glob.ts"],"names":[],"mappings":"AAmCA;;;;GAIG;AACH,eAAO,MAAM,WAAW,YAAa,MAAM,QAAQ,MAAM,KAAG,OA4C3D,CAAC"}

package/dist/glob.js

@@ -1,17 +1,80 @@
-const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+import { assertNever } from "@coldtea/pr-lens-schema";
+const tokenize = (pattern) => {
+    const tokens = [];
+    for (let i = 0; i < pattern.length; i += 1) {
+        const ch = pattern[i];
+        if (ch === "*" &&
+            pattern[i + 1] === "*" &&
+            pattern[i + 2] === "/" &&
+            (i === 0 || pattern[i - 1] === "/")) {
+            tokens.push({ kind: "crossDir" });
+            i += 2;
+        }
+        else if (ch === "*" && pattern[i + 1] === "*") {
+            tokens.push({ kind: "cross" });
+            i += 1;
+        }
+        else if (ch === "*") {
+            tokens.push({ kind: "star" });
+        }
+        else if (ch === "?") {
+            tokens.push({ kind: "any" });
+        }
+        else {
+            tokens.push({ kind: "char", value: ch });
+        }
+    }
+    return tokens;
+};
 /**
  * Path matching for config selectors, with the subset of glob a person
  * actually writes in one: `**` crosses directory boundaries, `*` and `?` do
  * not. Every other character is literal.
  */
 export const matchesGlob = (pattern, path) => {
-    const source = pattern
-        .split("**")
-        .map((crossing) => crossing
-        .split("*")
-        .map((segment) => segment.split("?").map(escapeRegExp).join("[^/]"))
-        .join("[^/]*"))
-        .join(".*");
-    return new RegExp(`^${source}$`).test(path);
+    const n = path.length;
+    const reachable = new Uint8Array(n + 1);
+    reachable[0] = 1;
+    for (const token of tokenize(pattern)) {
+        switch (token.kind) {
+            case "crossDir": {
+                const first = reachable.indexOf(1);
+                if (first !== -1) {
+                    for (let j = first + 1; j <= n; j += 1) {
+                        if (path[j - 1] === "/")
+                            reachable[j] = 1;
+                    }
+                }
+                break;
+            }
+            case "cross":
+                for (let j = 1; j <= n; j += 1) {
+                    if (reachable[j - 1])
+                        reachable[j] = 1;
+                }
+                break;
+            case "star":
+                for (let j = 1; j <= n; j += 1) {
+                    if (path[j - 1] !== "/" && reachable[j - 1])
+                        reachable[j] = 1;
+                }
+                break;
+            case "any":
+                for (let j = n; j >= 1; j -= 1) {
+                    reachable[j] = path[j - 1] !== "/" && reachable[j - 1] ? 1 : 0;
+                }
+                reachable[0] = 0;
+                break;
+            case "char":
+                for (let j = n; j >= 1; j -= 1) {
+                    reachable[j] = path[j - 1] === token.value && reachable[j - 1] ? 1 : 0;
+                }
+                reachable[0] = 0;
+                break;
+            default:
+                return assertNever(token);
+        }
+    }
+    return reachable[n] === 1;
 };
 //# sourceMappingURL=glob.js.map

package/dist/glob.js.map

@@ -1 +1 @@
-{"version":3,"file":"glob.js","sourceRoot":"","sources":["../src/glob.ts"],"names":[],"mappings":"AAAA,MAAM,YAAY,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AAE7F;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAe,EAAE,IAAY,EAAW,EAAE;IACpE,MAAM,MAAM,GAAG,OAAO;SACnB,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAChB,QAAQ;SACL,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;SACnE,IAAI,CAAC,OAAO,CAAC,CACjB;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO,IAAI,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9C,CAAC,CAAC"}
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../src/glob.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,10 +1,14 @@
 export { RENDERER_NAME, RENDERER_VERSION } from "./version.js";
-export { render, renderAll, type RenderAllOptions, type RenderThemes, type RenderAllResult, type RenderedAsset, type RenderedSvg, type RenderOptions, } from "./render.js";
+export { render, type RenderedSvg, type RenderOptions } from "./render.js";
+export { renderAll, type RenderAllOptions, type RenderAllResult, type RenderedAsset, type RenderedWalkthrough, type RenderedWalkthroughs, type RenderThemes, } from "./render-all.js";
+export { EMBED_WIDTH, renderWalkthroughEmbed, walkthroughLabel, type WalkthroughEmbed, type WalkthroughEmbedOptions, type WalkthroughEmbedResult, } from "./walkthrough/embed.js";
+export { planTiles, renderFlow, type TilePlan } from "./walkthrough/tiles.js";
+export * from "./walkthrough/index.js";
 export { emptyAtlas, type RenderAtlas } from "./atlas.js";
 export { PrLensRenderError, type RenderErrorCode } from "./errors.js";
 export type { Box } from "./geometry.js";
-export { paletteFor, THEMES, THEME_PAIR, type Palette, type Theme } from "./theme.js";
-export { buildManifest, canonicalJson, contentHash, CONTENT_HASH_LENGTH, graphContentHash, renderAssetFileName, renderAssetId, type AssetAddress, } from "./manifest.js";
+export { isPairTheme, paletteFor, THEMES, THEME_PAIR, type PairTheme, type Palette, type Theme } from "./theme.js";
+export { assetIdentity, buildManifest, canonicalJson, contentHash, CONTENT_HASH_LENGTH, graphContentHash, renderAssetFileName, renderAssetId, walkthroughAssetFileName, walkthroughAssetId, type AssetAddress, } from "./manifest.js";
 export { applyCorrections } from "./corrections.js";
 export { findView, flattenViews, resolveScope, type ScopedGraph } from "./scope.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,EACL,MAAM,EACN,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAEtE,YAAY,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAEtF,OAAO,EACL,aAAa,EACb,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,KAAK,YAAY,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,EAAE,MAAM,EAAE,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAE3E,OAAO,EACL,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,KAAK,YAAY,GAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,KAAK,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAE9E,cAAc,wBAAwB,CAAC;AAEvC,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAEtE,YAAY,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,KAAK,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnH,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,wBAAwB,EACxB,kBAAkB,EAClB,KAAK,YAAY,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,9 +1,13 @@
 export { RENDERER_NAME, RENDERER_VERSION } from "./version.js";
-export { render, renderAll, } from "./render.js";
+export { render } from "./render.js";
+export { renderAll, } from "./render-all.js";
+export { EMBED_WIDTH, renderWalkthroughEmbed, walkthroughLabel, } from "./walkthrough/embed.js";
+export { planTiles, renderFlow } from "./walkthrough/tiles.js";
+export * from "./walkthrough/index.js";
 export { emptyAtlas } from "./atlas.js";
 export { PrLensRenderError } from "./errors.js";
-export { paletteFor, THEMES, THEME_PAIR } from "./theme.js";
-export { buildManifest, canonicalJson, contentHash, CONTENT_HASH_LENGTH, graphContentHash, renderAssetFileName, renderAssetId, } from "./manifest.js";
+export { isPairTheme, paletteFor, THEMES, THEME_PAIR } from "./theme.js";
+export { assetIdentity, buildManifest, canonicalJson, contentHash, CONTENT_HASH_LENGTH, graphContentHash, renderAssetFileName, renderAssetId, walkthroughAssetFileName, walkthroughAssetId, } from "./manifest.js";
 export { applyCorrections } from "./corrections.js";
 export { findView, flattenViews, resolveScope } from "./scope.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,EACL,MAAM,EACN,SAAS,GAOV,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,UAAU,EAAoB,MAAM,YAAY,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAwB,MAAM,aAAa,CAAC;AAItE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAA4B,MAAM,YAAY,CAAC;AAEtF,OAAO,EACL,aAAa,EACb,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,GAEd,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAoB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,EAAE,MAAM,EAAwC,MAAM,aAAa,CAAC;AAE3E,OAAO,EACL,SAAS,GAOV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,WAAW,EACX,sBAAsB,EACtB,gBAAgB,GAIjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAiB,MAAM,wBAAwB,CAAC;AAE9E,cAAc,wBAAwB,CAAC;AAEvC,OAAO,EAAE,UAAU,EAAoB,MAAM,YAAY,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAwB,MAAM,aAAa,CAAC;AAItE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAA4C,MAAM,YAAY,CAAC;AAEnH,OAAO,EACL,aAAa,EACb,aAAa,EACb,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,wBAAwB,EACxB,kBAAkB,GAEnB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAoB,MAAM,YAAY,CAAC"}

package/dist/manifest.d.ts

@@ -1,5 +1,5 @@
-import type { GraphDoc, Lens, RenderAsset, RenderManifest } from "@coldtea/pr-lens-schema";
-import { type Theme } from "./theme.js";
+import type { GraphDoc, Lens, RenderAsset, RenderManifest, WalkthroughAsset } from "@coldtea/pr-lens-schema";
+import { type PairTheme, type Theme } from "./theme.js";
 /**
  * How many hex characters of the digest an address carries. Long enough that
  * two different renders will not collide inside one repository's history,
@@ -16,6 +16,11 @@ export declare const CONTENT_HASH_LENGTH = 32;
  * what the same render is called.
  */
 export declare const contentHash: (bytes: string) => string;
+/** The one place an asset's bytes become its identity. */
+export declare const assetIdentity: (svg: string) => {
+    contentHash: string;
+    bytes: number;
+};
 /** JSON with object keys in sorted order, so equal documents hash equal. */
 export declare const canonicalJson: (value: unknown) => string;
 export declare const graphContentHash: (doc: GraphDoc) => string;
@@ -35,5 +40,8 @@ export type AssetAddress = {
 export declare const renderAssetId: ({ lens, theme, view }: AssetAddress) => string;
 /** The file name an asset is written or published under. */
 export declare const renderAssetFileName: (address: AssetAddress, hash: string) => string;
-export declare const buildManifest: (doc: GraphDoc, assets: readonly RenderAsset[]) => RenderManifest;
+/** Listed apart from the view assets, so a view called "walkthrough" cannot collide with it. */
+export declare const walkthroughAssetId: (theme: PairTheme) => string;
+export declare const walkthroughAssetFileName: (theme: PairTheme, hash: string) => string;
+export declare const buildManifest: (doc: GraphDoc, assets: readonly RenderAsset[], walkthrough: readonly WalkthroughAsset[]) => RenderManifest;
 //# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE3F,OAAO,EAAU,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAGhD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,UAAW,MAAM,KAAG,MAC4C,CAAC;AAEzF,4EAA4E;AAC5E,eAAO,MAAM,aAAa,UAAW,OAAO,KAAG,MAS9C,CAAC;AAEF,eAAO,MAAM,gBAAgB,QAAS,QAAQ,KAAG,MAAyC,CAAC;AAE3F,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAsDlF;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,0BAA2B,YAAY,KAAG,MAC1B,CAAC;AAE3C,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,YAAa,YAAY,QAAQ,MAAM,KAAG,MACjC,CAAC;AAE1C,eAAO,MAAM,aAAa,QAAS,QAAQ,UAAU,SAAS,WAAW,EAAE,KAAG,cAU5E,CAAC"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE7G,OAAO,EAAU,KAAK,SAAS,EAAE,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAGhE;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,UAAW,MAAM,KAAG,MAC4C,CAAC;AAEzF,0DAA0D;AAC1D,eAAO,MAAM,aAAa,QAAS,MAAM,KAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAG9E,CAAC;AAEH,4EAA4E;AAC5E,eAAO,MAAM,aAAa,UAAW,OAAO,KAAG,MAS9C,CAAC;AAEF,eAAO,MAAM,gBAAgB,QAAS,QAAQ,KAAG,MAAyC,CAAC;AAE3F,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAsDlF;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,0BAA2B,YAAY,KAAG,MAC1B,CAAC;AAE3C,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,YAAa,YAAY,QAAQ,MAAM,KAAG,MACjC,CAAC;AAE1C,gGAAgG;AAChG,eAAO,MAAM,kBAAkB,UAAW,SAAS,KAAG,MAAgC,CAAC;AAEvF,eAAO,MAAM,wBAAwB,UAAW,SAAS,QAAQ,MAAM,KAAG,MAC9B,CAAC;AAE7C,eAAO,MAAM,aAAa,QACnB,QAAQ,UACL,SAAS,WAAW,EAAE,eACjB,SAAS,gBAAgB,EAAE,KACvC,cAWD,CAAC"}

package/dist/manifest.js

@@ -18,6 +18,11 @@ export const CONTENT_HASH_LENGTH = 32;
  * what the same render is called.
  */
 export const contentHash = (bytes) => createHash("sha256").update(bytes, "utf8").digest("hex").slice(0, CONTENT_HASH_LENGTH);
+/** The one place an asset's bytes become its identity. */
+export const assetIdentity = (svg) => ({
+    contentHash: contentHash(svg),
+    bytes: Buffer.byteLength(svg, "utf8"),
+});
 /** JSON with object keys in sorted order, so equal documents hash equal. */
 export const canonicalJson = (value) => {
     if (value === null || typeof value !== "object")
@@ -87,7 +92,10 @@ const fileNameSafe = (id) => {
 export const renderAssetId = ({ lens, theme, view }) => `${fileNameSafe(view ?? lens)}-${theme}`;
 /** The file name an asset is written or published under. */
 export const renderAssetFileName = (address, hash) => `${renderAssetId(address)}-${hash}.svg`;
-export const buildManifest = (doc, assets) => ({
+/** Listed apart from the view assets, so a view called "walkthrough" cannot collide with it. */
+export const walkthroughAssetId = (theme) => `walkthrough-${theme}`;
+export const walkthroughAssetFileName = (theme, hash) => `${walkthroughAssetId(theme)}-${hash}.svg`;
+export const buildManifest = (doc, assets, walkthrough) => ({
     schemaVersion: SCHEMA_VERSION,
     kind: "render-manifest",
     graph: {
@@ -97,5 +105,6 @@ export const buildManifest = (doc, assets) => ({
     },
     renderer: { name: RENDERER_NAME, version: RENDERER_VERSION },
     assets: [...assets],
+    walkthrough: [...walkthrough],
 });
 //# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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

package/dist/render-all.d.ts

@@ -0,0 +1,35 @@
+import type { Config, GraphDoc, RenderAsset, RenderManifest, WalkthroughAsset } from "@coldtea/pr-lens-schema";
+import { type RenderedSvg } from "./render.js";
+import { type WalkthroughEmbed } from "./walkthrough/embed.js";
+import type { WalkthroughIssue } from "./walkthrough/resolve.js";
+/** The pair, one half of it, or neutral. Never all three: the view cap assumes two assets per view. */
+export type RenderThemes = readonly ["light", "dark"] | readonly ["light"] | readonly ["dark"] | readonly ["neutral"];
+export type RenderAllOptions = {
+    config?: Config;
+    /** The pair by default. */
+    themes?: RenderThemes;
+};
+export type RenderedAsset = RenderedSvg & {
+    asset: RenderAsset;
+};
+export type RenderedWalkthrough = WalkthroughEmbed & {
+    asset: WalkthroughAsset;
+};
+/** `absent` for a neutral render too: the embed has no single-image form. */
+export type RenderedWalkthroughs = {
+    type: "absent";
+} | {
+    type: "unresolvable";
+    issues: WalkthroughIssue[];
+} | {
+    type: "rendered";
+    assets: RenderedWalkthrough[];
+};
+export type RenderAllResult = {
+    assets: RenderedAsset[];
+    walkthrough: RenderedWalkthroughs;
+    manifest: RenderManifest;
+};
+/** Every drill-down section in every theme asked for, or one diagram per lens when there are none. */
+export declare const renderAll: (doc: GraphDoc, options?: RenderAllOptions) => RenderAllResult;
+//# sourceMappingURL=render-all.d.ts.map

package/dist/render-all.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-all.d.ts","sourceRoot":"","sources":["../src/render-all.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,MAAM,EACN,QAAQ,EAER,WAAW,EACX,cAAc,EAEd,gBAAgB,EACjB,MAAM,yBAAyB,CAAC;AAWjC,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAGhE,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAGjE,uGAAuG;AACvG,MAAM,MAAM,YAAY,GACpB,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,GAC1B,SAAS,CAAC,OAAO,CAAC,GAClB,SAAS,CAAC,MAAM,CAAC,GACjB,SAAS,CAAC,SAAS,CAAC,CAAC;AAEzB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG;IAAE,KAAK,EAAE,WAAW,CAAA;CAAE,CAAC;AAEjE,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,GAAG;IACnD,KAAK,EAAE,gBAAgB,CAAC;CACzB,CAAC;AAEF,6EAA6E;AAC7E,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,gBAAgB,EAAE,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,mBAAmB,EAAE,CAAA;CAAE,CAAC;AAExD,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,WAAW,EAAE,oBAAoB,CAAC;IAClC,QAAQ,EAAE,cAAc,CAAC;CAC1B,CAAC;AAEF,sGAAsG;AACtG,eAAO,MAAM,SAAS,QACf,QAAQ,YACJ,gBAAgB,KACxB,eAkFF,CAAC"}

package/dist/render-all.js

@@ -0,0 +1,110 @@
+import { assertNever, MAX_RENDER_ASSETS } from "@coldtea/pr-lens-schema";
+import { PrLensRenderError } from "./errors.js";
+import { assetIdentity, buildManifest, renderAssetFileName, renderAssetId, walkthroughAssetFileName, walkthroughAssetId, } from "./manifest.js";
+import { prepare, render } from "./render.js";
+import { flattenViews } from "./scope.js";
+import { isPairTheme, THEME_PAIR } from "./theme.js";
+import { renderWalkthroughEmbed, } from "./walkthrough/embed.js";
+import { tileIdForView } from "./walkthrough/tile-ids.js";
+/** Every drill-down section in every theme asked for, or one diagram per lens when there are none. */
+export const renderAll = (doc, options = {}) => {
+    const prepared = prepare(doc, options.config);
+    const themes = options.themes ?? THEME_PAIR;
+    const targets = prepared.views.length > 0
+        ? flattenViews(prepared.views)
+            .filter((view) => prepared.lenses.includes(view.lens))
+            .map((view) => ({ lens: view.lens, view }))
+        : prepared.lenses
+            .filter((lens) => {
+            switch (lens) {
+                case "architecture":
+                    return true;
+                case "data-flow":
+                    return prepared.flows.length > 0;
+                case "data-model":
+                    return prepared.dataModel !== undefined;
+                default:
+                    return assertNever(lens, "Unhandled lens");
+            }
+        })
+            .map((lens) => ({ lens, view: undefined }));
+    // Only a hand-built document can reach this: the contract's cap is a refinement, which the type does not carry.
+    if (targets.length * themes.length > MAX_RENDER_ASSETS)
+        throw new PrLensRenderError("TOO_MANY_ASSETS", `this document asks for ${targets.length * themes.length} pictures across ${targets.length} views ` +
+            `and ${themes.length} themes, and a render manifest carries at most ${MAX_RENDER_ASSETS}`);
+    const assets = [];
+    for (const target of targets)
+        for (const theme of themes) {
+            const rendered = render(prepared, {
+                lens: target.lens,
+                theme,
+                view: target.view?.id,
+            });
+            const address = { lens: target.lens, theme, view: target.view?.id };
+            const identity = assetIdentity(rendered.svg);
+            assets.push({
+                ...rendered,
+                asset: {
+                    id: renderAssetId(address),
+                    lens: target.lens,
+                    theme,
+                    view: target.view?.id,
+                    mediaType: "image/svg+xml",
+                    ...identity,
+                    width: rendered.width,
+                    height: rendered.height,
+                    animated: rendered.animated,
+                    path: renderAssetFileName(address, identity.contentHash),
+                },
+            });
+        }
+    if (assets.length === 0)
+        throw new PrLensRenderError("NOTHING_TO_RENDER", "this document declares no renderable view");
+    const walkthrough = renderWalkthroughs(prepared, themes, assets);
+    const walkthroughAssets = walkthrough.type === "rendered"
+        ? walkthrough.assets.map(({ asset }) => asset)
+        : [];
+    return {
+        assets,
+        walkthrough,
+        manifest: buildManifest(prepared, assets.map(({ asset }) => asset), walkthroughAssets),
+    };
+};
+/** Hands the views just drawn to the embed, which then draws only flow and whole-model tiles. */
+const renderWalkthroughs = (doc, themes, drawn) => {
+    const assets = [];
+    for (const theme of themes.filter(isPairTheme)) {
+        const tiles = new Map(drawn.flatMap((asset) => asset.theme === theme && asset.view !== undefined
+            ? [[tileIdForView(asset.view), asset]]
+            : []));
+        const result = renderWalkthroughEmbed(doc, { theme, tiles });
+        switch (result.type) {
+            case "absent":
+            case "unresolvable":
+                return result;
+            case "rendered": {
+                const identity = assetIdentity(result.embed.svg);
+                assets.push({
+                    ...result.embed,
+                    asset: {
+                        id: walkthroughAssetId(theme),
+                        theme,
+                        mediaType: "image/svg+xml",
+                        ...identity,
+                        width: result.embed.width,
+                        height: result.embed.height,
+                        steps: result.embed.steps,
+                        path: walkthroughAssetFileName(theme, identity.contentHash),
+                    },
+                });
+                break;
+            }
+            default:
+                return assertNever(result, "Unhandled walkthrough embed result");
+        }
+    }
+    return assets.length === 0
+        ? { type: "absent" }
+        : { type: "rendered", assets };
+};
+//# sourceMappingURL=render-all.js.map

package/dist/render-all.js.map

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

package/dist/render.d.ts

@@ -1,4 +1,4 @@
-import type { Config, GraphDoc, Lens, RenderAsset, RenderManifest } from "@coldtea/pr-lens-schema";
+import type { Config, GraphDoc, Lens } from "@coldtea/pr-lens-schema";
 import type { RenderAtlas } from "./atlas.js";
 import { type Theme } from "./theme.js";
 export type RenderOptions = {
@@ -11,6 +11,8 @@ export type RenderOptions = {
 };
 export type RenderedSvg = {
     svg: string;
+    /** The painting alone, for a document that nests this picture under its own defs and ground. */
+    body: string;
     width: number;
     height: number;
     lens: Lens;
@@ -20,6 +22,7 @@ export type RenderedSvg = {
     /** Where every lane, node, edge and flow step of this picture landed. */
     atlas: RenderAtlas;
 };
+export declare const prepare: (doc: GraphDoc, config: Config | undefined) => GraphDoc;
 /**
  * A schema-valid document in, one self-contained SVG out.
  *
@@ -29,34 +32,4 @@ export type RenderedSvg = {
  * from rearranging itself between two pushes that barely changed anything.
  */
 export declare const render: (doc: GraphDoc, options: RenderOptions) => RenderedSvg;
-/**
- * What a render may be asked for: the `<picture>` pair, one half of it, or
- * the single self-contained render.
- *
- * Not `readonly Theme[]`, which would admit all three at once — three assets
- * per view against a view cap derived from two, so a document that validates
- * could produce a manifest that does not. The contract's promise is that if
- * it parses, it renders; this is the boundary that keeps it true.
- */
-export type RenderThemes = readonly ["light", "dark"] | readonly ["light"] | readonly ["dark"] | readonly ["neutral"];
-export type RenderAllOptions = {
-    config?: Config;
-    /** The `<picture>` pair by default; `['neutral']` for a single-image surface. */
-    themes?: RenderThemes;
-};
-export type RenderedAsset = RenderedSvg & {
-    asset: RenderAsset;
-};
-export type RenderAllResult = {
-    assets: RenderedAsset[];
-    manifest: RenderManifest;
-};
-/**
- * Every drill-down section a comment will show, in both themes.
- *
- * A document with no sections still renders: it gets one diagram per lens it
- * declares, which is what a comment falls back to when extraction found
- * nothing worth splitting into a tree.
- */
-export declare const renderAll: (doc: GraphDoc, options?: RenderAllOptions) => RenderAllResult;
 //# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,EAAmB,MAAM,yBAAyB,CAAC;AAEpH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK9C,OAAO,EAA0B,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAMhE,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;IACb,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,yEAAyE;IACzE,KAAK,EAAE,WAAW,CAAC;CACpB,CAAC;AAyCF;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,QAAS,QAAQ,WAAW,aAAa,KAAG,WAwC9D,CAAC;AASF;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GACpB,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,GAC1B,SAAS,CAAC,OAAO,CAAC,GAClB,SAAS,CAAC,MAAM,CAAC,GACjB,SAAS,CAAC,SAAS,CAAC,CAAC;AAEzB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iFAAiF;IACjF,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG;IAAE,KAAK,EAAE,WAAW,CAAA;CAAE,CAAC;AAEjE,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,QAAQ,EAAE,cAAc,CAAC;CAC1B,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,QAAS,QAAQ,YAAW,gBAAgB,KAAQ,eAyEzE,CAAC"}
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAmB,MAAM,yBAAyB,CAAC;AAEvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,OAAO,EAAc,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAMpD,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;IACb,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,gGAAgG;IAChG,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;IAClB,yEAAyE;IACzE,KAAK,EAAE,WAAW,CAAC;CACpB,CAAC;AAIF,eAAO,MAAM,OAAO,QAAS,QAAQ,UAAU,MAAM,GAAG,SAAS,KAAG,QACJ,CAAC;AAoCjE;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM,QAAS,QAAQ,WAAW,aAAa,KAAG,WAyC9D,CAAC"}