@kgdiff/renderer 0.0.0-stage → 0.2.0

package/dist/math.d.ts

@@ -0,0 +1,33 @@
+/** Small numeric helpers shared by the camera, drawing, culling and picking. */
+export declare const TAU: number;
+/** `value` limited to [lo, hi] (NaN stays NaN). */
+export declare function clamp(value: number, lo: number, hi: number): number;
+export declare function lerp(a: number, b: number, t: number): number;
+/** Hermite smoothstep of `x` between `edge0` and `edge1`. */
+export declare function smoothstep(edge0: number, edge1: number, x: number): number;
+export declare function easeInOutCubic(t: number): number;
+/** Round a CSS-pixel coordinate to the device-pixel grid (crisp text and hairlines). */
+export declare function snap(value: number, dpr: number): number;
+/**
+ * Offset (css px) that puts a stroke of `width` css px on whole device pixels:
+ * odd device widths are centred on pixel centres, even ones on pixel edges.
+ */
+export declare function crispOffset(width: number, dpr: number): number;
+/** One coordinate of B(t) for a quadratic with endpoints `p0`, `p2` and control `c`. */
+export declare function quadAt(p0: number, c: number, p2: number, t: number): number;
+/** One coordinate of B′(t). */
+export declare function quadSlope(p0: number, c: number, p2: number, t: number): number;
+/**
+ * Parameter where the curve is `dist` away from its start (`fromEnd` false) or end
+ * (`fromEnd` true). Bisection, valid for the gentle curvatures used for parallel edges.
+ */
+export declare function quadTrim(x0: number, y0: number, cx: number, cy: number, x2: number, y2: number, dist: number, fromEnd: boolean): number;
+/** Squared distance from (px, py) to the segment a–b. */
+export declare function distToSegmentSq(px: number, py: number, ax: number, ay: number, bx: number, by: number): number;
+/** Squared distance from (px, py) to a quadratic curve, by flattening into `steps` segments. */
+export declare function distToQuadSq(px: number, py: number, x0: number, y0: number, cx: number, cy: number, x2: number, y2: number, steps?: number): number;
+/** Whether segment a–b touches the axis-aligned rectangle (Liang–Barsky). */
+export declare function segmentHitsRect(ax: number, ay: number, bx: number, by: number, x0: number, y0: number, x1: number, y1: number): boolean;
+/** Whether two rectangles given as x, y, w, h overlap (touching edges do not count). */
+export declare function rectsOverlap(ax: number, ay: number, aw: number, ah: number, bx: number, by: number, bw: number, bh: number): boolean;
+//# sourceMappingURL=math.d.ts.map

package/dist/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../src/math.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,eAAO,MAAM,GAAG,QAAc,CAAC;AAE/B,mDAAmD;AACnD,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAG1E;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wFAAwF;AACxF,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE9D;AAQD,wFAAwF;AACxF,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3E;AAED,+BAA+B;AAC/B,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,GACf,MAAM,CAkBR;AAED,yDAAyD;AACzD,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,MAAM,CASR;AAED,gGAAgG;AAChG,wBAAgB,YAAY,CAC1B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,KAAK,SAAK,GACT,MAAM,CAcR;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAC7B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,OAAO,CA4BT;AAED,wFAAwF;AACxF,wBAAgB,YAAY,CAC1B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,GACT,OAAO,CAET"}

package/dist/math.js

@@ -0,0 +1,138 @@
+/** Small numeric helpers shared by the camera, drawing, culling and picking. */
+export const TAU = Math.PI * 2;
+/** `value` limited to [lo, hi] (NaN stays NaN). */
+export function clamp(value, lo, hi) {
+    return Math.min(Math.max(value, lo), hi);
+}
+export function lerp(a, b, t) {
+    return a + (b - a) * t;
+}
+/** Hermite smoothstep of `x` between `edge0` and `edge1`. */
+export function smoothstep(edge0, edge1, x) {
+    const t = clamp((x - edge0) / (edge1 - edge0), 0, 1);
+    return t * t * (3 - 2 * t);
+}
+export function easeInOutCubic(t) {
+    return t < 0.5 ? 4 * t * t * t : 1 - (-2 * t + 2) ** 3 / 2;
+}
+/** Round a CSS-pixel coordinate to the device-pixel grid (crisp text and hairlines). */
+export function snap(value, dpr) {
+    return Math.round(value * dpr) / dpr;
+}
+/**
+ * Offset (css px) that puts a stroke of `width` css px on whole device pixels:
+ * odd device widths are centred on pixel centres, even ones on pixel edges.
+ */
+export function crispOffset(width, dpr) {
+    return Math.round(width * dpr) % 2 === 1 ? 0.5 / dpr : 0;
+}
+// ─── Quadratic Bézier edges ─────────────────────────────────────────────────
+//
+// Curvature convention (edges and glyphs): the control point is the chord midpoint
+// moved along the left normal (−dy, dx) by `curvature · chord length`. The curve's
+// apex therefore sits `curvature / 2 · length` off the chord; the sign picks the side.
+/** One coordinate of B(t) for a quadratic with endpoints `p0`, `p2` and control `c`. */
+export function quadAt(p0, c, p2, t) {
+    const u = 1 - t;
+    return u * u * p0 + 2 * u * t * c + t * t * p2;
+}
+/** One coordinate of B′(t). */
+export function quadSlope(p0, c, p2, t) {
+    return 2 * (1 - t) * (c - p0) + 2 * t * (p2 - c);
+}
+/**
+ * Parameter where the curve is `dist` away from its start (`fromEnd` false) or end
+ * (`fromEnd` true). Bisection, valid for the gentle curvatures used for parallel edges.
+ */
+export function quadTrim(x0, y0, cx, cy, x2, y2, dist, fromEnd) {
+    if (dist <= 0)
+        return fromEnd ? 1 : 0;
+    const ox = fromEnd ? x2 : x0;
+    const oy = fromEnd ? y2 : y0;
+    const d2 = dist * dist;
+    let lo = fromEnd ? 1 : 0;
+    let hi = 0.5;
+    const mx = quadAt(x0, cx, x2, 0.5) - ox;
+    const my = quadAt(y0, cy, y2, 0.5) - oy;
+    if (mx * mx + my * my <= d2)
+        return 0.5;
+    for (let i = 0; i < 12; i++) {
+        const mid = (lo + hi) / 2;
+        const px = quadAt(x0, cx, x2, mid) - ox;
+        const py = quadAt(y0, cy, y2, mid) - oy;
+        if (px * px + py * py < d2)
+            lo = mid;
+        else
+            hi = mid;
+    }
+    return (lo + hi) / 2;
+}
+/** Squared distance from (px, py) to the segment a–b. */
+export function distToSegmentSq(px, py, ax, ay, bx, by) {
+    const dx = bx - ax;
+    const dy = by - ay;
+    const len2 = dx * dx + dy * dy;
+    let t = len2 > 0 ? ((px - ax) * dx + (py - ay) * dy) / len2 : 0;
+    t = clamp(t, 0, 1);
+    const ex = ax + t * dx - px;
+    const ey = ay + t * dy - py;
+    return ex * ex + ey * ey;
+}
+/** Squared distance from (px, py) to a quadratic curve, by flattening into `steps` segments. */
+export function distToQuadSq(px, py, x0, y0, cx, cy, x2, y2, steps = 16) {
+    let best = Number.POSITIVE_INFINITY;
+    let ax = x0;
+    let ay = y0;
+    for (let i = 1; i <= steps; i++) {
+        const t = i / steps;
+        const bx = quadAt(x0, cx, x2, t);
+        const by = quadAt(y0, cy, y2, t);
+        const d = distToSegmentSq(px, py, ax, ay, bx, by);
+        if (d < best)
+            best = d;
+        ax = bx;
+        ay = by;
+    }
+    return best;
+}
+/** Whether segment a–b touches the axis-aligned rectangle (Liang–Barsky). */
+export function segmentHitsRect(ax, ay, bx, by, x0, y0, x1, y1) {
+    if (ax >= x0 && ax <= x1 && ay >= y0 && ay <= y1)
+        return true;
+    if (bx >= x0 && bx <= x1 && by >= y0 && by <= y1)
+        return true;
+    if ((ax < x0 && bx < x0) ||
+        (ax > x1 && bx > x1) ||
+        (ay < y0 && by < y0) ||
+        (ay > y1 && by > y1)) {
+        return false;
+    }
+    const dx = bx - ax;
+    const dy = by - ay;
+    let t0 = 0;
+    let t1 = 1;
+    const clip = (p, q) => {
+        if (p === 0)
+            return q >= 0;
+        const r = q / p;
+        if (p < 0) {
+            if (r > t1)
+                return false;
+            if (r > t0)
+                t0 = r;
+        }
+        else {
+            if (r < t0)
+                return false;
+            if (r < t1)
+                t1 = r;
+        }
+        return true;
+    };
+    return clip(-dx, ax - x0) && clip(dx, x1 - ax) && clip(-dy, ay - y0) && clip(dy, y1 - ay);
+}
+/** Whether two rectangles given as x, y, w, h overlap (touching edges do not count). */
+export function rectsOverlap(ax, ay, aw, ah, bx, by, bw, bh) {
+    return ax < bx + bw && bx < ax + aw && ay < by + bh && by < ay + ah;
+}
+//# sourceMappingURL=math.js.map

package/dist/math.js.map

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

package/dist/minimap.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Minimap (docs/visual-language.md §Minimap): a 184 × 128 floating card with the graph's edges
+ * as faint hairlines (below 3k edges), neutral nodes as small dots, changed nodes as outlined
+ * dots in their family color, and the viewport as an accent rectangle. Click or drag to navigate.
+ *
+ * The world window is centred on the content and grows just enough to contain the viewport, so
+ * the rectangle is always fully visible while the content stays centred and as large as possible.
+ * The window shrinks at once when the viewport needs room and grows back eased, with hysteresis,
+ * so panning never makes it jitter. Marks are rasterized into an offscreen layer whenever the
+ * window or the frame changes; camera moves otherwise only blit that layer and the rectangle.
+ */
+import type { Rect } from '@kgdiff/core';
+import type { NodeVisual, Theme } from '@kgdiff/scene';
+import { type Ctx2D, type SurfaceFactory } from './ctx.js';
+import type { Minimap, MinimapOptions, Renderer } from './index.js';
+export interface MinimapDeps {
+    readonly context?: Ctx2D | null;
+    readonly surfaceFactory?: SurfaceFactory;
+}
+/** The family color of a change mark, or null for neutral context (by `NodeVisual.family`). */
+export declare function markColor(n: NodeVisual, theme: Theme): string | null;
+/**
+ * The minimap's world window: centred on the content, covering the content and the viewport.
+ * Extending symmetrically keeps the content centred; the viewport always fits inside.
+ */
+export declare function minimapWindow(content: Rect, viewport: Rect | null): Rect;
+/**
+ * Minimap zoom (px per world unit) with asymmetric smoothing: shrinks at once (the viewport
+ * must stay visible), grows back eased and only once it has `GROW_SLACK` room (no jitter).
+ */
+export declare class WindowScale {
+    value: number;
+    target: number;
+    growing: boolean;
+    /** Set the scale the window needs now; returns whether `value` changed. */
+    retarget(target: number): boolean;
+    /** Advance the eased growth by `dt` ms; returns whether it is still growing. */
+    step(dt: number): boolean;
+}
+/** Uniform scale + offset that fits `bounds` into a w × h box with padding, centred. */
+export declare function fitTransform(bounds: Rect, w: number, h: number, pad: number): {
+    s: number;
+    ox: number;
+    oy: number;
+};
+/** The minimap plus internals tests and the dev harness inspect. */
+export interface MinimapImpl extends Minimap {
+    /** Current world → minimap transform (css px), or null without content. */
+    transform(): {
+        readonly s: number;
+        readonly ox: number;
+        readonly oy: number;
+    } | null;
+}
+export declare function createMinimapImpl(container: HTMLElement, renderer: Renderer, options?: MinimapOptions, deps?: MinimapDeps): MinimapImpl;
+//# sourceMappingURL=minimap.d.ts.map

package/dist/minimap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimap.d.ts","sourceRoot":"","sources":["../src/minimap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,KAAK,EAAgC,UAAU,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACrF,OAAO,EAAE,KAAK,KAAK,EAAmC,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAE5F,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAqBpE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;CAC1C;AAED,+FAA+F;AAC/F,wBAAgB,SAAS,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI,CAIpE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAexE;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,KAAK,SAAK;IACV,MAAM,SAAK;IACX,OAAO,UAAS;IAEhB,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAWhC;IAED,gFAAgF;IAChF,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAQxB;CACF;AAED,wFAAwF;AACxF,wBAAgB,YAAY,CAC1B,MAAM,EAAE,IAAI,EACZ,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,GAAG,EAAE,MAAM,GACV;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAOvC;AAED,oEAAoE;AACpE,MAAM,WAAW,WAAY,SAAQ,OAAO;IAC1C,2EAA2E;IAC3E,SAAS,IAAI;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CACtF;AA6ZD,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,WAAW,EACtB,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,cAAmB,EAC5B,IAAI,GAAE,WAAgB,GACrB,WAAW,CAEb"}