@oh-just-another/renderer-core 0.57.0

package/dist/constants.js

@@ -0,0 +1,115 @@
+/**
+ * Tunable constants for the renderer core. All "magic numbers" used by
+ * `renderScene` / `renderLinks` / `renderGrid` live here so there is one
+ * place to tweak performance / visual behaviour.
+ */
+import { GRID_COLOR, GRID_DOT_COLOR } from "@oh-just-another/tokens";
+/**
+ * Default zoom thresholds for the level-of-detail pipeline. Tuned for
+ * a typical 1920×1080 viewport viewing a 10k-shape scene.
+ *
+ * - `placeholder: 0.15` — below 15% zoom (one screen ≈ 6.7× world),
+ *   shapes degrade to flat AABB fills. Saves ~10× renderer cost per
+ *   shape.
+ * - `hideText: 0.4` — below 40% zoom text glyphs are too small to read
+ *   anyway; skipping the `wrapText` + `measureText` calls saves the
+ *   bulk of text rendering cost.
+ *
+ * Hosts override per-render by passing `RenderSceneOptions.lod`.
+ */
+export const DEFAULT_LOD = {
+    placeholder: 0.15,
+    hideText: 0.4,
+};
+/**
+ * Grey colour used for placeholder fills when LOD switches to the
+ * cheapest path. A mid-tone neutral that blends with most scene
+ * palettes; override via `RenderSceneOptions.placeholderFill`.
+ */
+export const DEFAULT_PLACEHOLDER_FILL = "#bbb";
+/**
+ * Viewport-rect inflation factor applied by hosts when computing the
+ * world-space culling rect. 0.05 = 5% padding on each side — enough
+ * to avoid flicker during a one-frame pan without keeping much
+ * off-screen geometry alive in the renderer.
+ */
+export const VIEWPORT_CULL_PADDING_RATIO = 0.05;
+/**
+ * Text-decoration geometry (underline / strikethrough), as fractions of
+ * font size, measured from the line's top (the renderer draws text with
+ * a top baseline).
+ *
+ * - `TEXT_DECORATION_THICKNESS` — line thickness ≈ 6% of font size
+ *   (clamped to ≥1 px in the renderer).
+ * - `TEXT_UNDERLINE_OFFSET` — underline top, ~92% down (just below the
+ *   glyph baseline).
+ * - `TEXT_STRIKETHROUGH_OFFSET` — strikethrough centre, ~50% (x-height).
+ */
+export const TEXT_DECORATION_THICKNESS = 0.06;
+export const TEXT_UNDERLINE_OFFSET = 0.92;
+export const TEXT_STRIKETHROUGH_OFFSET = 0.5;
+/**
+ * Corner radius (world px) for the rounded bends of an elbow (orthogonal)
+ * connector and of a straight connector broken by user waypoints. Each
+ * corner is replaced by a quadratic arc of this radius, clamped to half the
+ * shorter adjacent segment so short segments don't overshoot. 0 disables
+ * rounding (sharp corners). Range: 0–16.
+ */
+export const LINK_CORNER_RADIUS = 10;
+// --- Grid -------------------------------------------------------------------
+//
+// Lines and dots are tuned independently: a ruled line covers far more
+// pixels than a lone dot, so the dot grid needs a darker colour, a
+// slightly fatter mark, and a denser ladder to read as clearly as the
+// line grid at the same zoom.
+/** Stroke colour for the ruled (`"lines"`) grid. Neutral step-6 gray. */
+export const GRID_LINE_COLOR = GRID_COLOR;
+/** Fill colour for the dotted (`"dots"`) grid — darker step-9 gray so the dots stay legible on a gray canvas. */
+export const GRID_DOT_FILL = GRID_DOT_COLOR;
+/** On-screen stroke width (px) of a grid line. Divided by zoom at the use site so the line stays 1 px regardless of view scale. */
+export const GRID_LINE_WIDTH_PX = 1.0;
+/**
+ * Dot radius (screen px) for `gridStyle === "dots"`. Constant across
+ * zoom (divided by `zoom` at the use site). Reads as a crisp anchor on
+ * a gray surface. Range: 1.0–2.0.
+ */
+export const GRID_DOT_RADIUS_PX = 1;
+/**
+ * Below this on-screen spacing (px) a grid level paints nothing —
+ * denser rendering reads as a flat haze. Only used by the fixed-ladder
+ * path (`options.levels`); the default dynamic ladder uses the fade
+ * bands below instead.
+ */
+export const GRID_MIN_SCREEN_SPACING_PX = 4;
+// --- Dynamic (infinite) grid ladder -----------------------------------------
+//
+// The default grid is a SELF-SIMILAR, zoom-relative ladder: instead of a
+// fixed set of world steps it renders a handful of rungs anchored to the
+// current zoom, each rung `GRID_LEVEL_SUBDIV`× the previous. As you zoom
+// the rungs slide — a finer rung fades in and a coarser one fades out —
+// so new lines / dots keep appearing at EVERY zoom, not just at the
+// hand-picked thresholds of a fixed ladder. Rungs finer than `gridSize`
+// are purely visual (snap-to-grid still rounds to `gridSize`).
+/** Ratio between adjacent rungs. 4 keeps the 64/16/4/1 cadence. */
+export const GRID_LEVEL_SUBDIV = 4;
+/**
+ * How many self-similar rungs to paint at once (finest first). 3 keeps a
+ * stable fully-opaque coarse tier while the finest rung fades in/out.
+ */
+export const GRID_LEVEL_RUNGS = 3;
+/**
+ * Line grid fade band (on-screen px). A rung is invisible at/below
+ * `FROM`, ramps to full opacity by `FULL`, and stays full above. Tuned
+ * so at 100 % (gridSize 20) the 20 px rung reads faint and the 80 px rung
+ * is solid, while subdividing forever.
+ */
+export const GRID_LINE_FADE_FROM_PX = 12;
+export const GRID_LINE_FADE_FULL_PX = 56;
+/**
+ * Dot grid fade band. Lower / tighter than lines so the base `gridSize`
+ * dot lattice is fully solid at 100 % (the denser dot field) yet still
+ * subdivides on zoom-in.
+ */
+export const GRID_DOT_FADE_FROM_PX = 10;
+export const GRID_DOT_FADE_FULL_PX = 20;
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGrE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,WAAW,GAAe;IACrC,WAAW,EAAE,IAAI;IACjB,QAAQ,EAAE,GAAG;CACd,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,CAAC;AAEhD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC;AAC9C,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAC1C,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAErC,+EAA+E;AAC/E,EAAE;AACF,uEAAuE;AACvE,mEAAmE;AACnE,sEAAsE;AACtE,8BAA8B;AAE9B,yEAAyE;AACzE,MAAM,CAAC,MAAM,eAAe,GAAG,UAAU,CAAC;AAE1C,iHAAiH;AACjH,MAAM,CAAC,MAAM,aAAa,GAAG,cAAc,CAAC;AAE5C,mIAAmI;AACnI,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAEtC;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAEpC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC;AAE5C,+EAA+E;AAC/E,EAAE;AACF,yEAAyE;AACzE,yEAAyE;AACzE,yEAAyE;AACzE,wEAAwE;AACxE,oEAAoE;AACpE,wEAAwE;AACxE,+DAA+D;AAE/D,mEAAmE;AACnE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAEnC;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAElC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AACzC,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACxC,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAC"}

package/dist/edge-cache-bitmap.d.ts

@@ -0,0 +1,34 @@
+import type { Link } from "@oh-just-another/scene";
+/**
+ * Per-edge rasterised bitmap cache. Mirror of `ElementBitmapCache` but
+ * keyed on `Link` identity. Long-path edges (orthogonal routes around
+ * obstacles, beziers with many waypoints) cost real CPU per frame;
+ * caching the rasterised stroke as an `ImageBitmap` lets pan / camera
+ * moves draw with one `drawImage` call instead of a fresh
+ * `path → stroke` pass.
+ *
+ * Invalidation: every scene mutation produces a fresh edge object via
+ * `apply(scene, patch)`, so reference inequality on the cached
+ * `edgeRef` signals "stale". No version field needed.
+ *
+ * Hosts that don't want bitmaps in memory just don't instantiate one —
+ * `renderLinks` ignores the cache when absent.
+ */
+export interface LinkBitmapCache<V = unknown> {
+    get(edge: Link, zoomBucket: number): V | undefined;
+    set(edge: Link, zoomBucket: number, value: V): void;
+    delete(edge: Link, zoomBucket: number): void;
+    clear(): void;
+    readonly size: number;
+}
+export declare class InMemoryLinkBitmapCache<V> implements LinkBitmapCache<V> {
+    private readonly entries;
+    private readonly cap;
+    constructor(cap?: number);
+    get size(): number;
+    get(edge: Link, zoomBucket: number): V | undefined;
+    set(edge: Link, zoomBucket: number, value: V): void;
+    delete(edge: Link, zoomBucket: number): void;
+    clear(): void;
+}
+//# sourceMappingURL=edge-cache-bitmap.d.ts.map

package/dist/edge-cache-bitmap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge-cache-bitmap.d.ts","sourceRoot":"","sources":["../src/edge-cache-bitmap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAEnD;;;;;;;;;;;;;;GAcG;AAEH,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,OAAO;IAC1C,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC;IACnD,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACpD,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,KAAK,IAAI,IAAI,CAAC;IACd,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AASD,qBAAa,uBAAuB,CAAC,CAAC,CAAE,YAAW,eAAe,CAAC,CAAC,CAAC;IACnE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,GAAG,SAAM;IAIrB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAalD,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAUnD,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAI5C,KAAK,IAAI,IAAI;CAGd"}

package/dist/edge-cache-bitmap.js

@@ -0,0 +1,42 @@
+const keyFor = (edge, zoomBucket) => `${edge.id}@${zoomBucket}`;
+export class InMemoryLinkBitmapCache {
+    entries = new Map();
+    cap;
+    constructor(cap = 256) {
+        this.cap = cap;
+    }
+    get size() {
+        return this.entries.size;
+    }
+    get(edge, zoomBucket) {
+        const key = keyFor(edge, zoomBucket);
+        const e = this.entries.get(key);
+        if (!e)
+            return undefined;
+        if (e.edgeRef !== edge) {
+            this.entries.delete(key);
+            return undefined;
+        }
+        this.entries.delete(key);
+        this.entries.set(key, e);
+        return e.value;
+    }
+    set(edge, zoomBucket, value) {
+        const key = keyFor(edge, zoomBucket);
+        if (this.entries.has(key))
+            this.entries.delete(key);
+        this.entries.set(key, { edgeRef: edge, value });
+        if (this.entries.size > this.cap) {
+            const oldest = this.entries.keys().next().value;
+            if (oldest !== undefined)
+                this.entries.delete(oldest);
+        }
+    }
+    delete(edge, zoomBucket) {
+        this.entries.delete(keyFor(edge, zoomBucket));
+    }
+    clear() {
+        this.entries.clear();
+    }
+}
+//# sourceMappingURL=edge-cache-bitmap.js.map

package/dist/edge-cache-bitmap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge-cache-bitmap.js","sourceRoot":"","sources":["../src/edge-cache-bitmap.ts"],"names":[],"mappings":"AA+BA,MAAM,MAAM,GAAG,CAAC,IAAU,EAAE,UAAkB,EAAU,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,IAAI,UAAU,EAAE,CAAC;AAEtF,MAAM,OAAO,uBAAuB;IACjB,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;IACtC,GAAG,CAAS;IAE7B,YAAY,GAAG,GAAG,GAAG;QACnB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,GAAG,CAAC,IAAU,EAAE,UAAkB;QAChC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,CAAC;YAAE,OAAO,SAAS,CAAC;QACzB,IAAI,CAAC,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACzB,OAAO,CAAC,CAAC,KAAK,CAAC;IACjB,CAAC;IAED,GAAG,CAAC,IAAU,EAAE,UAAkB,EAAE,KAAQ;QAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACrC,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAChD,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAChD,IAAI,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAU,EAAE,UAAkB;QACnC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;CACF"}

package/dist/edge-cache.d.ts

@@ -0,0 +1,32 @@
+import type { Bounds, LinkId } from "@oh-just-another/types";
+import { type Link, type Scene } from "@oh-just-another/scene";
+/**
+ * Per-edge memo invalidated by identity of either the `Link` ref or the
+ * `Scene` ref. Links' world AABB depends on endpoint shapes' positions —
+ * a shape move replaces the shape ref but leaves the edge ref intact, so
+ * a plain by-edge cache would go stale. Patches always replace the
+ * `Scene` ref, so `(edge, scene)` together form a sound key.
+ */
+export declare class LinkBoundsCache {
+    private readonly entries;
+    get(scene: Scene, edge: Link): Bounds | null | undefined;
+    set(scene: Scene, edge: Link, value: Bounds | null): Bounds | null;
+    getOrCompute(scene: Scene, edge: Link): Bounds | null;
+    invalidate(id: LinkId): void;
+    clear(): void;
+    prune(scene: Scene): void;
+    get size(): number;
+}
+/**
+ * AABB of the edge's polyline in world space. Returns `null` when the
+ * path is unresolvable (missing endpoint shape). Pure with respect to
+ * the `(scene, edge)` pair.
+ */
+export declare const computeLinkWorldBounds: (scene: Scene, edge: Link) => Bounds | null;
+/**
+ * Shared module-level cache. Survives across `renderLinks` calls — the
+ * `(edge, scene)` identity key ensures stale entries fall out automatically
+ * once a patch produces a new scene reference.
+ */
+export declare const sharedLinkBoundsCache: LinkBoundsCache;
+//# sourceMappingURL=edge-cache.d.ts.map

package/dist/edge-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge-cache.d.ts","sourceRoot":"","sources":["../src/edge-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,EAAsB,KAAK,IAAI,EAAE,KAAK,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAEnF;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAGpB;IAEJ,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS;IAUxD,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI;IAKlE,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI;IAMrD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI5B,KAAK,IAAI,IAAI;IAIb,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAMzB,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,KAAK,EAAE,MAAM,IAAI,KAAG,MAAM,GAAG,IA2B1E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,eAAuC,CAAC"}

package/dist/edge-cache.js

@@ -0,0 +1,90 @@
+import { getLinkCurvePoints } from "@oh-just-another/scene";
+/**
+ * Per-edge memo invalidated by identity of either the `Link` ref or the
+ * `Scene` ref. Links' world AABB depends on endpoint shapes' positions —
+ * a shape move replaces the shape ref but leaves the edge ref intact, so
+ * a plain by-edge cache would go stale. Patches always replace the
+ * `Scene` ref, so `(edge, scene)` together form a sound key.
+ */
+export class LinkBoundsCache {
+    entries = new Map();
+    get(scene, edge) {
+        const entry = this.entries.get(edge.id);
+        if (!entry)
+            return undefined;
+        if (entry.edge !== edge || entry.scene !== scene) {
+            this.entries.delete(edge.id);
+            return undefined;
+        }
+        return entry.value;
+    }
+    set(scene, edge, value) {
+        this.entries.set(edge.id, { edge, scene, value });
+        return value;
+    }
+    getOrCompute(scene, edge) {
+        const cached = this.get(scene, edge);
+        if (cached !== undefined)
+            return cached;
+        return this.set(scene, edge, computeLinkWorldBounds(scene, edge));
+    }
+    invalidate(id) {
+        this.entries.delete(id);
+    }
+    clear() {
+        this.entries.clear();
+    }
+    prune(scene) {
+        for (const id of this.entries.keys()) {
+            if (!scene.links.has(id))
+                this.entries.delete(id);
+        }
+    }
+    get size() {
+        return this.entries.size;
+    }
+}
+/**
+ * AABB of the edge's polyline in world space. Returns `null` when the
+ * path is unresolvable (missing endpoint shape). Pure with respect to
+ * the `(scene, edge)` pair.
+ */
+export const computeLinkWorldBounds = (scene, edge) => {
+    // Curved (bezier) links bow out from the straight chord, so the AABB is
+    // taken over the FLATTENED curve (same geometry the renderer draws and
+    // hit-testing uses) — otherwise the arc paints outside the dirty rect /
+    // viewport cull and gets clipped. Non-curved edges return their polyline.
+    const path = getLinkCurvePoints(scene, edge);
+    if (!path || path.length === 0)
+        return null;
+    let minX = Infinity;
+    let minY = Infinity;
+    let maxX = -Infinity;
+    let maxY = -Infinity;
+    for (const p of path) {
+        if (p.x < minX)
+            minX = p.x;
+        if (p.y < minY)
+            minY = p.y;
+        if (p.x > maxX)
+            maxX = p.x;
+        if (p.y > maxY)
+            maxY = p.y;
+    }
+    // Inflate by stroke half-width + arrowhead reach. This keeps an
+    // axis-aligned link (a horizontal/vertical line, otherwise a zero-area AABB)
+    // non-degenerate, so dirty-rect union / viewport culling don't drop it. Also
+    // covers arrowhead / thick-stroke overhang past the path.
+    const heads = edge.arrowheads;
+    const hasHead = (heads?.from !== undefined && heads.from !== "none") ||
+        (heads?.to !== undefined && heads.to !== "none");
+    const pad = Math.max(2, (edge.style.strokeWidth ?? 1) / 2 + (hasHead ? (heads.size ?? 10) : 0));
+    return { x: minX - pad, y: minY - pad, width: maxX - minX + pad * 2, height: maxY - minY + pad * 2 };
+};
+/**
+ * Shared module-level cache. Survives across `renderLinks` calls — the
+ * `(edge, scene)` identity key ensures stale entries fall out automatically
+ * once a patch produces a new scene reference.
+ */
+export const sharedLinkBoundsCache = new LinkBoundsCache();
+//# sourceMappingURL=edge-cache.js.map

package/dist/edge-cache.js.map

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

package/dist/edge-renderer.d.ts

@@ -0,0 +1,73 @@
+import { type Link, type Scene } from "@oh-just-another/scene";
+import type { Bounds, Vec2 } from "@oh-just-another/types";
+import type { RenderTarget } from "./render-target.js";
+import { type LinkBoundsCache } from "./edge-cache.js";
+import type { LinkBitmapCache } from "./edge-cache-bitmap.js";
+export interface RenderLinksOptions {
+    /**
+     * Called for edges whose endpoints can't be resolved (e.g. anchor
+     * endpoint references a missing shape). The default is to silently
+     * skip them.
+     */
+    readonly onMissingEndpoint?: (edge: Link) => void;
+    /**
+     * World-space rect — only edges whose AABB intersects it are drawn.
+     * Omit to draw every edge. Match `RenderSceneOptions.viewportWorld`
+     * for consistent culling between shape and edge passes.
+     */
+    readonly viewportWorld?: Bounds;
+    /**
+     * Cache used to memoize per-edge world AABBs. Defaults to the shared
+     * module-level cache so per-frame edge-bounds work is amortized across
+     * paint passes.
+     */
+    readonly edgeBoundsCache?: LinkBoundsCache;
+    /**
+     * Optional dirty rectangle (world coords). Links whose AABB does
+     * not intersect this rect are skipped — mirrors the same dirty-rect
+     * filter `renderScene` applies to shapes. Caller is responsible for
+     * having cleared the corresponding screen region.
+     */
+    readonly dirtyWorld?: Bounds;
+    /**
+     * Per-edge bitmap cache. When supplied along with `rasteriseLink`,
+     * edges whose object reference hasn't changed AND whose zoom bucket
+     * matches are drawn from the cache via `drawImage` instead of
+     * re-stroking the path. Pass `undefined` to opt out — the rest of
+     * renderLinks works unchanged.
+     */
+    readonly edgeBitmapCache?: LinkBitmapCache;
+    /**
+     * Host-side rasteriser: receives the edge, its world bbox, the
+     * scene reference, and the active zoom bucket; returns the
+     * image source to cache (`ImageBitmap`, `OffscreenCanvas`,
+     * `HTMLCanvasElement` — anything the host's `RenderTarget.draw
+     * Image` accepts). Returning `null` skips the cache for that
+     * edge (e.g. an edge so small the bitmap isn't worth it).
+     */
+    readonly rasteriseLink?: (edge: Link, bounds: Bounds, scene: Scene, zoomBucket: number) => unknown;
+    /**
+     * Active zoom (defaults to `scene.viewport.zoom`). Cache lookups
+     * round this through `zoomBucket()` so small camera adjustments
+     * still hit the cache.
+     */
+    readonly zoom?: number;
+}
+/**
+ * Draws every edge in the scene, in layer-then-z order. Resolves endpoints
+ * through `getLinkPath` (which honours anchor refs and explicit waypoints)
+ * and emits the appropriate primitive sequence for the edge's routing.
+ *
+ * Call this *after* `renderScene` so edges sit on top of shapes. Both
+ * functions write to the same `RenderTarget` under the same scene-level
+ * viewport transform, so coordinates align.
+ */
+export declare const renderLinks: (scene: Scene, target: RenderTarget, options?: RenderLinksOptions) => void;
+/**
+ * Stroke a polyline with rounded corners: each interior vertex is replaced
+ * by a quadratic arc of `radius` (clamped to half the shorter adjacent
+ * segment). Works for 90° elbow bends and arbitrary-angle waypoint bends.
+ * Caller has already `beginPath()`.
+ */
+export declare const strokeRoundedPolyline: (target: RenderTarget, raw: readonly Vec2[], radius: number) => void;
+//# sourceMappingURL=edge-renderer.d.ts.map

package/dist/edge-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge-renderer.d.ts","sourceRoot":"","sources":["../src/edge-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,IAAI,EAGT,KAAK,KAAK,EACX,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAS9D,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAClD;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;IAC3C;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,eAAe,CAAC;IAC3C;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CACvB,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,MAAM,KACf,OAAO,CAAC;IACb;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,GACtB,OAAO,KAAK,EACZ,QAAQ,YAAY,EACpB,UAAS,kBAAuB,KAC/B,IAmDF,CAAC;AAyNF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,YAAY,EACpB,KAAK,SAAS,IAAI,EAAE,EACpB,QAAQ,MAAM,KACb,IAqCF,CAAC"}