@kgdiff/renderer 0.0.0-stage → 0.2.0

package/dist/paint.js

@@ -0,0 +1,197 @@
+/**
+ * Paints one frame (or a swipe pair) into a `Ctx2D`. Pass order (docs/visual-language.md):
+ * background + grid → collapsed pills → edges → glyph arcs → halos → nodes (+ rings, pulses)
+ * → pivots → badges → labels. Swipe draws the background once, then each side clipped to its
+ * half with its own label placement.
+ */
+import { LabelAtlas } from './atlas.js';
+import { drawBackground, GridTiles } from './draw/background.js';
+import { BadgePass } from './draw/badges.js';
+import { drawCollapsed } from './draw/collapsed.js';
+import { drawEdges } from './draw/edges.js';
+import { drawGlyphArcs, drawPivots } from './draw/glyphs.js';
+import { drawHalos, HaloSprites } from './draw/halos.js';
+import { LabelPass } from './draw/labels.js';
+import { drawNodes } from './draw/nodes.js';
+import { Interner } from './frame-cache.js';
+import { CollisionGrid } from './labels.js';
+import { clamp, snap } from './math.js';
+import { createStats, resetStats } from './paint-stats.js';
+import { Fonts, TextMeasurer } from './text.js';
+export function isSplit(frame) {
+    return 'before' in frame && 'after' in frame && 'split' in frame;
+}
+/** Divider position (css px, on the device-pixel grid) for a split fraction. */
+export function splitX(split, width, dpr) {
+    return snap(clamp(Number.isFinite(split) ? split : 0.5, 0, 1) * width, dpr);
+}
+/** Caches that live as long as a renderer: fonts, text metrics, sprites, atlas, tiles. */
+export class Resources {
+    factory;
+    fonts;
+    measurer;
+    atlas;
+    halos;
+    tiles;
+    interner = new Interner();
+    dpr = 0;
+    theme;
+    constructor(factory, theme, fallbackMeasureCtx) {
+        this.factory = factory;
+        this.theme = theme;
+        this.fonts = new Fonts(theme);
+        // A private context for measuring, so measuring never disturbs drawing state.
+        this.measurer = new TextMeasurer(factory(1, 1)?.ctx ?? fallbackMeasureCtx);
+        this.atlas = new LabelAtlas(factory);
+        this.halos = new HaloSprites(factory);
+        this.tiles = new GridTiles(factory);
+    }
+    setTheme(theme) {
+        if (theme === this.theme)
+            return;
+        this.theme = theme;
+        this.fonts.setTheme(theme);
+        this.measurer.clear();
+        this.halos.clear();
+        this.tiles.clear();
+        this.atlas?.configure(this.dpr || 1, theme.canvas.background);
+    }
+    /** Called before painting: re-keys pixel-ratio dependent caches. */
+    prepare(dpr) {
+        if (dpr === this.dpr)
+            return;
+        this.dpr = dpr;
+        this.tiles.clear();
+        this.atlas?.configure(dpr, this.theme.canvas.background);
+    }
+    /** Web fonts finished loading: metrics and rasterized labels are stale. */
+    fontsChanged() {
+        this.measurer.clear();
+        this.atlas?.wipe();
+    }
+}
+/** New label rasterizations per frame (≈ 3–5 ms of text rendering on mid-range hardware). */
+export const LABEL_RASTER_BUDGET = 160;
+export class Painter {
+    res;
+    stats = createStats();
+    /** Override for exports, which must contain every label in one paint. */
+    rasterBudget = LABEL_RASTER_BUDGET;
+    labels = new LabelPass();
+    badges = new BadgePass();
+    grid = new CollisionGrid();
+    view = {
+        k: 1,
+        ox: 0,
+        oy: 0,
+        width: 0,
+        height: 0,
+        dpr: 1,
+        x0: 0,
+        x1: 0,
+        y0: 0,
+        y1: 0,
+        strictX: false,
+        stats: this.stats,
+    };
+    constructor(res) {
+        this.res = res;
+    }
+    paint(target, cam, frame, caches, version, theme, grid) {
+        const { ctx, width, height, dpr } = target;
+        const v = this.view;
+        resetStats(this.stats);
+        this.res.prepare(dpr);
+        this.res.atlas?.beginFrame(this.rasterBudget);
+        v.k = cam.k;
+        v.ox = width / 2 - cam.x * cam.k;
+        v.oy = height / 2 - cam.y * cam.k;
+        v.width = width;
+        v.height = height;
+        v.dpr = dpr;
+        v.x0 = 0;
+        v.x1 = width;
+        v.y0 = 0;
+        v.y1 = height;
+        v.strictX = false;
+        ctx.setTransform(dpr, 0, 0, dpr, 0, 0);
+        ctx.imageSmoothingEnabled = true;
+        const split = frame !== null && isSplit(frame);
+        const spotlight = frame === null
+            ? 0
+            : split
+                ? Math.max(frame.before.spotlight, frame.after.spotlight)
+                : frame.spotlight;
+        drawBackground(ctx, v, theme, grid ? this.res.tiles : null, spotlight);
+        this.stats.phases.push('background');
+        if (frame === null)
+            return this.stats;
+        if (!split) {
+            caches.main.sync(frame, version, this.res.interner);
+            this.layers(ctx, frame, caches.main, theme);
+            return this.stats;
+        }
+        const sx = splitX(frame.split, width, dpr);
+        caches.before.sync(frame.before, version, this.res.interner);
+        caches.after.sync(frame.after, version, this.res.interner);
+        if (sx > 0) {
+            v.x0 = 0;
+            v.x1 = sx;
+            v.strictX = true;
+            ctx.save();
+            ctx.beginPath();
+            ctx.rect(0, 0, sx, height);
+            ctx.clip();
+            this.layers(ctx, frame.before, caches.before, theme);
+            ctx.restore();
+        }
+        if (sx < width) {
+            v.x0 = sx;
+            v.x1 = width;
+            v.strictX = true;
+            ctx.save();
+            ctx.beginPath();
+            ctx.rect(sx, 0, width - sx, height);
+            ctx.clip();
+            this.layers(ctx, frame.after, caches.after, theme);
+            ctx.restore();
+        }
+        if (sx > 0 && sx < width) {
+            // 1 css px divider on whole device pixels.
+            const w = Math.max(1, Math.round(dpr));
+            ctx.globalAlpha = 1;
+            ctx.fillStyle = theme.surface.borderStrong;
+            ctx.fillRect(Math.round(sx * dpr - w / 2) / dpr, 0, w / dpr, height);
+        }
+        this.stats.phases.push('divider');
+        return this.stats;
+    }
+    layers(ctx, frame, cache, theme) {
+        const v = this.view;
+        const res = this.res;
+        const phases = this.stats.phases;
+        // Screen-space layout first: node discs and badges are obstacles; labels and pills compete
+        // for the rest by priority. Drawing then follows the documented pass order.
+        this.labels.begin(frame, cache, v, this.grid);
+        this.badges.layout(frame, cache, v, res.fonts, res.measurer, this.grid);
+        this.labels.place(frame, cache, v, res, this.grid);
+        drawCollapsed(ctx, frame.collapsed, cache.pillShown, v, theme, res.fonts, res.measurer);
+        phases.push('collapsed');
+        drawEdges(ctx, frame, cache, v);
+        phases.push('edges');
+        drawGlyphArcs(ctx, frame, cache, v, theme, res.fonts);
+        phases.push('glyphs');
+        drawHalos(ctx, frame, cache, v, theme, res.halos);
+        phases.push('halos');
+        drawNodes(ctx, frame, cache, v, theme);
+        phases.push('nodes');
+        drawPivots(ctx, frame, cache, v, theme);
+        phases.push('pivots');
+        this.badges.draw(ctx, frame, theme);
+        phases.push('badges');
+        this.stats.labels += this.labels.draw(ctx, v, theme, res);
+        this.stats.deferredLabels = res.atlas?.deferred ?? 0;
+        phases.push('labels');
+    }
+}
+//# sourceMappingURL=paint.js.map

package/dist/paint.js.map

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

package/dist/pick.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Hit testing at a screen point, topmost first: nodes (grid lookup; a point inside a disc beats
+ * the tolerance ring, then higher z), then edges (distance to the segment / curve / loop, higher
+ * z first), then collapsed pills. Invisible and fully transparent elements, and pills hidden by
+ * label collision, are never picked.
+ */
+import type { FrameVisuals } from '@kgdiff/scene';
+import type { FrameCache } from './frame-cache.js';
+import type { PickResult } from './index.js';
+import type { Fonts, TextMeasurer } from './text.js';
+/** Extra reach (px) around node discs. */
+export declare const NODE_PICK_TOLERANCE = 3;
+/** Extra reach (px) beyond half an edge's width. */
+export declare const EDGE_PICK_TOLERANCE = 4;
+export interface PickView {
+    readonly k: number;
+    readonly ox: number;
+    readonly oy: number;
+    readonly dpr: number;
+}
+export declare function pickNode(frame: FrameVisuals, cache: FrameCache, v: PickView, sx: number, sy: number): number;
+export declare function pickEdge(frame: FrameVisuals, cache: FrameCache, v: PickView, sx: number, sy: number): number;
+export declare function pickCollapsed(frame: FrameVisuals, cache: FrameCache, v: PickView, sx: number, sy: number, fonts: Fonts, measurer: TextMeasurer): number;
+/** Topmost element at screen point (sx, sy), or null. */
+export declare function pickAt(frame: FrameVisuals, cache: FrameCache, v: PickView, sx: number, sy: number, fonts: Fonts, measurer: TextMeasurer): PickResult | null;
+//# sourceMappingURL=pick.d.ts.map

package/dist/pick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pick.d.ts","sourceRoot":"","sources":["../src/pick.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAKlD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAErD,0CAA0C;AAC1C,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,oDAAoD;AACpD,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAKD,wBAAgB,QAAQ,CACtB,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,UAAU,EACjB,CAAC,EAAE,QAAQ,EACX,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,MAAM,CA+BR;AAED,wBAAgB,QAAQ,CACtB,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,UAAU,EACjB,CAAC,EAAE,QAAQ,EACX,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,MAAM,CAmDR;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,UAAU,EACjB,CAAC,EAAE,QAAQ,EACX,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,YAAY,GACrB,MAAM,CAgBR;AAED,yDAAyD;AACzD,wBAAgB,MAAM,CACpB,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,UAAU,EACjB,CAAC,EAAE,QAAQ,EACX,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,YAAY,GACrB,UAAU,GAAG,IAAI,CAQnB"}

package/dist/pick.js

@@ -0,0 +1,125 @@
+import { pillRect } from './draw/collapsed.js';
+import { isLoop } from './draw/edges.js';
+import { loopCenterY, loopRadius } from './draw/link.js';
+import { NODE_MIN_R } from './draw/view.js';
+import { distToQuadSq, distToSegmentSq } from './math.js';
+/** Extra reach (px) around node discs. */
+export const NODE_PICK_TOLERANCE = 3;
+/** Extra reach (px) beyond half an edge's width. */
+export const EDGE_PICK_TOLERANCE = 4;
+const candidates = [];
+const rect = new Float64Array(4);
+export function pickNode(frame, cache, v, sx, sy) {
+    if (cache.nodeCount === 0)
+        return -1;
+    const { k } = v;
+    const wx = (sx - v.ox) / k;
+    const wy = (sy - v.oy) / k;
+    const grid = cache.nodeGrid();
+    const reach = Math.max(grid.maxR, NODE_MIN_R / k) + NODE_PICK_TOLERANCE / k;
+    grid.query(wx - reach, wy - reach, wx + reach, wy + reach, candidates);
+    let best = -1;
+    let bestInside = false;
+    let bestZ = Number.NEGATIVE_INFINITY;
+    let bestD = Number.POSITIVE_INFINITY;
+    for (const i of candidates) {
+        const n = frame.nodes[i];
+        const r = Math.max(n.r, NODE_MIN_R / k);
+        const d = Math.hypot(n.x - wx, n.y - wy);
+        if (d > r + NODE_PICK_TOLERANCE / k)
+            continue;
+        const inside = d <= r;
+        const better = best < 0 ||
+            (inside && !bestInside) ||
+            (inside === bestInside &&
+                (n.z > bestZ || (n.z === bestZ && (inside ? i > best : d < bestD))));
+        if (better) {
+            best = i;
+            bestInside = inside;
+            bestZ = n.z;
+            bestD = d;
+        }
+    }
+    return best;
+}
+export function pickEdge(frame, cache, v, sx, sy) {
+    const { k } = v;
+    const wx = (sx - v.ox) / k;
+    const wy = (sy - v.oy) / k;
+    let best = -1;
+    let bestZ = Number.NEGATIVE_INFINITY;
+    let bestD = Number.POSITIVE_INFINITY;
+    for (const b of cache.edgeBuckets) {
+        const tol = (b.width / 2 + EDGE_PICK_TOLERANCE) / k;
+        const tol2 = tol * tol;
+        for (const i of b.members) {
+            const e = frame.edges[i];
+            let d2;
+            if (isLoop(e.x1, e.y1, e.x2, e.y2)) {
+                const r = Math.max(e.r1 * k, NODE_MIN_R);
+                const rho = loopRadius(r, e.curvature) / k;
+                const cy = loopCenterY(e.y1 * k, r, rho * k) / k;
+                const d = Math.abs(Math.hypot(wx - e.x1, wy - cy) - rho);
+                d2 = d * d;
+            }
+            else if (e.curvature === 0) {
+                if (wx < Math.min(e.x1, e.x2) - tol ||
+                    wx > Math.max(e.x1, e.x2) + tol ||
+                    wy < Math.min(e.y1, e.y2) - tol ||
+                    wy > Math.max(e.y1, e.y2) + tol) {
+                    continue;
+                }
+                d2 = distToSegmentSq(wx, wy, e.x1, e.y1, e.x2, e.y2);
+            }
+            else {
+                const cx = (e.x1 + e.x2) / 2 - (e.y2 - e.y1) * e.curvature;
+                const cy = (e.y1 + e.y2) / 2 + (e.x2 - e.x1) * e.curvature;
+                if (wx < Math.min(e.x1, e.x2, cx) - tol ||
+                    wx > Math.max(e.x1, e.x2, cx) + tol ||
+                    wy < Math.min(e.y1, e.y2, cy) - tol ||
+                    wy > Math.max(e.y1, e.y2, cy) + tol) {
+                    continue;
+                }
+                d2 = distToQuadSq(wx, wy, e.x1, e.y1, cx, cy, e.x2, e.y2);
+            }
+            if (d2 > tol2)
+                continue;
+            if (b.z > bestZ || (b.z === bestZ && d2 < bestD)) {
+                best = i;
+                bestZ = b.z;
+                bestD = d2;
+            }
+        }
+    }
+    return best;
+}
+export function pickCollapsed(frame, cache, v, sx, sy, fonts, measurer) {
+    const groups = frame.collapsed;
+    for (let i = groups.length - 1; i >= 0; i--) {
+        const g = groups[i];
+        if (!(g.count > 0) || !Number.isFinite(g.x + g.y) || !cache.pillPickable(i))
+            continue;
+        pillRect(g, v, fonts, measurer, rect);
+        if (sx >= rect[0] &&
+            sx <= rect[0] + rect[2] &&
+            sy >= rect[1] &&
+            sy <= rect[1] + rect[3]) {
+            return i;
+        }
+    }
+    return -1;
+}
+/** Topmost element at screen point (sx, sy), or null. */
+export function pickAt(frame, cache, v, sx, sy, fonts, measurer) {
+    const node = pickNode(frame, cache, v, sx, sy);
+    if (node >= 0)
+        return { type: 'node', index: node };
+    const edge = pickEdge(frame, cache, v, sx, sy);
+    if (edge >= 0)
+        return { type: 'edge', index: edge };
+    const group = pickCollapsed(frame, cache, v, sx, sy, fonts, measurer);
+    if (group >= 0)
+        return { type: 'collapsed', index: group };
+    return null;
+}
+//# sourceMappingURL=pick.js.map

package/dist/pick.js.map

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

package/dist/renderer.d.ts

@@ -0,0 +1,28 @@
+import type { Theme } from '@kgdiff/scene';
+import { type Size } from './camera.js';
+import { type Ctx2D, type SurfaceFactory } from './ctx.js';
+import type { CameraState, Renderer, RendererOptions } from './index.js';
+/** Test seams and platform overrides (not part of the public API). */
+export interface RendererDeps {
+    /** Context to draw into instead of `canvas.getContext('2d')` (null = no drawing). */
+    readonly context?: Ctx2D | null;
+    readonly surfaceFactory?: SurfaceFactory;
+    readonly now?: () => number;
+    readonly requestFrame?: (cb: (time: number) => void) => number;
+    readonly cancelFrame?: (id: number) => void;
+}
+/** What the minimap needs from its renderer beyond the public API. */
+export interface RendererInternals {
+    theme(): Theme;
+    pixelRatio(): number;
+    size(): Size;
+    onTheme(listener: (theme: Theme) => void): () => void;
+    /** Move the camera on behalf of the user (minimap drags): `camera` reports source 'user'. */
+    userSet(state: CameraState): void;
+    readonly requestFrame: (cb: (time: number) => void) => number;
+    readonly cancelFrame: (id: number) => void;
+}
+export declare const internals: WeakMap<Renderer, RendererInternals>;
+/** Implementation of `createRenderer` with optional test seams. */
+export declare function createRendererImpl(container: HTMLElement, options: RendererOptions, deps?: RendererDeps): Renderer;
+//# sourceMappingURL=renderer.d.ts.map

package/dist/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAgB,KAAK,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAA4C,KAAK,IAAI,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,KAAK,KAAK,EAAqB,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAE9E,OAAO,KAAK,EACV,WAAW,EAEX,QAAQ,EAER,eAAe,EAEhB,MAAM,YAAY,CAAC;AAMpB,sEAAsE;AACtE,MAAM,WAAW,YAAY;IAC3B,qFAAqF;IACrF,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,KAAK,MAAM,CAAC;IAC/D,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7C;AAED,sEAAsE;AACtE,MAAM,WAAW,iBAAiB;IAChC,KAAK,IAAI,KAAK,CAAC;IACf,UAAU,IAAI,MAAM,CAAC;IACrB,IAAI,IAAI,IAAI,CAAC;IACb,OAAO,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACtD,6FAA6F;IAC7F,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,KAAK,MAAM,CAAC;IAC9D,QAAQ,CAAC,WAAW,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C;AAED,eAAO,MAAM,SAAS,sCAA6C,CAAC;AA8dpE,mEAAmE;AACnE,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,WAAW,EACtB,OAAO,EAAE,eAAe,EACxB,IAAI,GAAE,YAAiB,GACtB,QAAQ,CAKV"}