@kgdiff/layout 0.0.0-stage → 0.1.0

package/dist/simulate.d.ts

@@ -0,0 +1,64 @@
+/**
+ * The force simulation. d3-force supplies the link and many-body (Barnes–Hut) forces; the tick
+ * loop is our own so that it is synchronous and timer-free (no d3-timer, safe in workers and
+ * Node), runs a fixed number of ticks (no time-based termination) and can change forces between
+ * phases:
+ *
+ *  1. structure (first ~35% of ticks): links + charge + node-only collision. The graph unfolds
+ *     without label boxes jamming it.
+ *  2. orientation (union layouts): the component is rotated onto its principal axis (wide
+ *     layouts suit screens and horizontal labels) and mirrored to a canonical handedness; if its
+ *     label boxes could not fit in its current extent, it is scaled up once (`makeRoom`).
+ *  3. labels: label boxes are inflated from 50% to 100% over ~25% of the ticks, then held.
+ *     Collision is not scaled by alpha: it keeps working while the other forces cool down.
+ *  4. a position-level pass removes any overlap that is left, and merge / split partners that
+ *     ended up far apart are docked next to each other.
+ */
+import { type SimulationLinkDatum, type SimulationNodeDatum } from 'd3-force';
+import { type CollisionBoxes } from './forces/collide-rect.js';
+import { type Spring } from './forces/springs.js';
+import type { Random } from './prng.js';
+export interface SimNode extends SimulationNodeDatum {
+    index: number;
+    x: number;
+    y: number;
+    vx: number;
+    vy: number;
+}
+export interface SimLink extends SimulationLinkDatum<SimNode> {
+    source: SimNode;
+    target: SimNode;
+    distance: number;
+    strength: number;
+}
+export interface SimulationSpec {
+    /** Initial positions; fixed nodes carry `fx` / `fy`. Indices must be 0..n−1. */
+    readonly nodes: SimNode[];
+    readonly links: SimLink[];
+    readonly springs: readonly Spring[];
+    /** Many-body strength per node (negative = repulsion). */
+    readonly charge: Float64Array;
+    /** Node-only boxes (structure phase). */
+    readonly nodeBoxes: CollisionBoxes;
+    /** Full node + label boxes (label phase and final overlap removal). */
+    readonly labelBoxes: CollisionBoxes;
+    readonly ticks: number;
+    /** Starting alpha (1 for a fresh layout, lower to refine around fixed nodes). */
+    readonly alpha: number;
+    /** Pull towards the origin; 0 disables it (anchored layouts). */
+    readonly gravity: number;
+    /** Rotate / mirror into canonical orientation after the structure phase. */
+    readonly orient: boolean;
+    readonly springStrength: number;
+    readonly springLength: number;
+    /** Partners farther apart than this are docked next to each other at the end (0 = never). */
+    readonly dockDistance: number;
+    /** Many-body cut-off (docs/algorithms.md: 900; shorter when refining around fixed nodes). */
+    readonly chargeRange: number;
+    /** Gap kept between boxes. */
+    readonly padding: number;
+    readonly random: Random;
+}
+/** Run the simulation in place. Returns the number of overlap-removal passes used. */
+export declare function simulate(spec: SimulationSpec): number;
+//# sourceMappingURL=simulate.d.ts.map

package/dist/simulate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulate.d.ts","sourceRoot":"","sources":["../src/simulate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAGL,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACzB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,KAAK,cAAc,EAIpB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAA8B,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,MAAM,WAAW,OAAQ,SAAQ,mBAAmB;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,OAAQ,SAAQ,mBAAmB,CAAC,OAAO,CAAC;IAC3D,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,uEAAuE;IACvE,QAAQ,CAAC,UAAU,EAAE,cAAc,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,6FAA6F;IAC7F,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,6FAA6F;IAC7F,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,8BAA8B;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAcD,sFAAsF;AACtF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAuGrD"}

package/dist/simulate.js

@@ -0,0 +1,247 @@
+/**
+ * The force simulation. d3-force supplies the link and many-body (Barnes–Hut) forces; the tick
+ * loop is our own so that it is synchronous and timer-free (no d3-timer, safe in workers and
+ * Node), runs a fixed number of ticks (no time-based termination) and can change forces between
+ * phases:
+ *
+ *  1. structure (first ~35% of ticks): links + charge + node-only collision. The graph unfolds
+ *     without label boxes jamming it.
+ *  2. orientation (union layouts): the component is rotated onto its principal axis (wide
+ *     layouts suit screens and horizontal labels) and mirrored to a canonical handedness; if its
+ *     label boxes could not fit in its current extent, it is scaled up once (`makeRoom`).
+ *  3. labels: label boxes are inflated from 50% to 100% over ~25% of the ticks, then held.
+ *     Collision is not scaled by alpha: it keeps working while the other forces cool down.
+ *  4. a position-level pass removes any overlap that is left, and merge / split partners that
+ *     ended up far apart are docked next to each other.
+ */
+import { forceLink, forceManyBody, } from 'd3-force';
+import { collideVelocities, collisionScratch, removeOverlaps, } from './forces/collide-rect.js';
+import { dockPartners } from './forces/free-spot.js';
+import { applyGravity, applySprings } from './forces/springs.js';
+import { coolingFactor } from './math.js';
+const ALPHA_MIN = 0.001;
+/** d3's default: velocities keep 60% per tick. */
+const VELOCITY_RETAIN = 0.6;
+const STRUCTURE_SHARE = 0.35;
+const RAMP_SHARE = 0.25;
+/** Label boxes start the label phase at this fraction of their size. */
+const RAMP_FROM = 0.5;
+const COLLIDE_STRENGTH = 0.7;
+/** Label boxes may cover at most this share of the nodes' bounding box after the structure phase. */
+const ROOM_DENSITY = 0.4;
+const MAX_OVERLAP_PASSES = 150;
+/** Run the simulation in place. Returns the number of overlap-removal passes used. */
+export function simulate(spec) {
+    const { nodes, ticks } = spec;
+    const n = nodes.length;
+    if (n === 0)
+        return 0;
+    if (ticks > 0) {
+        const link = forceLink(spec.links)
+            .distance((l) => l.distance)
+            .strength((l) => l.strength);
+        link.initialize(nodes, spec.random);
+        const charge = forceManyBody()
+            .strength((d) => spec.charge[d.index] ?? 0)
+            .theta(0.9)
+            .distanceMax(spec.chargeRange);
+        charge.initialize(nodes, spec.random);
+        const decay = coolingFactor(ALPHA_MIN / spec.alpha, ticks);
+        const structureEnd = Math.round(ticks * STRUCTURE_SHARE);
+        const rampTicks = Math.max(1, Math.round(ticks * RAMP_SHARE));
+        const ramp = scratchBoxes(spec.nodeBoxes);
+        const scratch = collisionScratch(n);
+        let alpha = spec.alpha;
+        for (let tick = 0; tick < ticks; tick++) {
+            alpha *= decay;
+            link(alpha);
+            charge(alpha);
+            if (spec.springs.length > 0) {
+                applySprings(nodes, spec.springs, alpha, spec.springStrength, spec.springLength);
+            }
+            if (spec.gravity > 0)
+                applyGravity(nodes, alpha, spec.gravity);
+            let boxes = spec.nodeBoxes;
+            if (tick >= structureEnd) {
+                const t = Math.min(1, (tick - structureEnd + 1) / rampTicks);
+                boxes =
+                    t >= 1
+                        ? spec.labelBoxes
+                        : blendBoxes(spec.nodeBoxes, spec.labelBoxes, RAMP_FROM + (1 - RAMP_FROM) * t, ramp);
+            }
+            if (boxes !== undefined)
+                collideVelocities(nodes, boxes, spec.padding, COLLIDE_STRENGTH, scratch);
+            for (const node of nodes) {
+                if (node.fx == null) {
+                    node.vx *= VELOCITY_RETAIN;
+                    node.x += node.vx;
+                }
+                else {
+                    node.x = node.fx;
+                    node.vx = 0;
+                }
+                if (node.fy == null) {
+                    node.vy *= VELOCITY_RETAIN;
+                    node.y += node.vy;
+                }
+                else {
+                    node.y = node.fy;
+                    node.vy = 0;
+                }
+            }
+            if (tick + 1 === structureEnd) {
+                if (spec.orient)
+                    orient(nodes);
+                makeRoom(nodes, spec.labelBoxes, spec.padding, ROOM_DENSITY);
+            }
+        }
+    }
+    const cleared = removeOverlaps(nodes, spec.labelBoxes, spec.padding, MAX_OVERLAP_PASSES);
+    let passes = cleared.passes;
+    if (spec.springs.length > 0 && spec.dockDistance > 0) {
+        const pinned = dockPartners(nodes, spec.springs, spec.labelBoxes, spec.padding, spec.dockDistance);
+        if (pinned.length > 0) {
+            // Make room around docked pairs: they hold still, their new neighbours step aside. Only
+            // the docked nodes (and whatever was left over) need to be looked at.
+            const invMass = Float64Array.from(spec.labelBoxes.invMass);
+            const active = Uint8Array.from(cleared.unresolved);
+            for (const k of pinned) {
+                invMass[k] = 0;
+                active[k] = 1;
+            }
+            const boxes = { ...spec.labelBoxes, invMass };
+            const room = removeOverlaps(nodes, boxes, spec.padding, MAX_OVERLAP_PASSES, active);
+            // Whatever the pinned pass could not clear (a pinned pair in a tight spot) is cleared with
+            // everyone movable again.
+            const rest = Uint8Array.from(room.unresolved);
+            for (const k of pinned)
+                rest[k] = 1;
+            passes += room.passes;
+            passes += removeOverlaps(nodes, spec.labelBoxes, spec.padding, MAX_OVERLAP_PASSES, rest).passes;
+        }
+    }
+    return passes;
+}
+function scratchBoxes(like) {
+    const n = like.halfWidth.length;
+    return {
+        halfWidth: new Float64Array(n),
+        halfHeight: new Float64Array(n),
+        offsetY: new Float64Array(n),
+        invMass: like.invMass,
+    };
+}
+/** Boxes with the label part scaled by `s` (node part kept), written into `out`. */
+function blendBoxes(node, full, s, out) {
+    const n = node.halfWidth.length;
+    for (let i = 0; i < n; i++) {
+        const top = node.offsetY[i] - node.halfHeight[i];
+        const bottom = node.offsetY[i] + node.halfHeight[i];
+        const fullBottom = full.offsetY[i] + full.halfHeight[i];
+        const b = bottom + (fullBottom - bottom) * s;
+        out.halfWidth[i] = node.halfWidth[i] + (full.halfWidth[i] - node.halfWidth[i]) * s;
+        out.halfHeight[i] = (b - top) / 2;
+        out.offsetY[i] = (b + top) / 2;
+    }
+    return out;
+}
+/**
+ * Rotate the (free) layout so its principal axis is horizontal, then mirror so the heavier tail
+ * points right / down. Only exact operations: the eigenvector of the 2×2 covariance matrix gives
+ * cos / sin directly.
+ */
+function orient(nodes) {
+    let cx = 0;
+    let cy = 0;
+    for (const d of nodes) {
+        cx += d.x;
+        cy += d.y;
+    }
+    cx /= nodes.length;
+    cy /= nodes.length;
+    let sxx = 0;
+    let syy = 0;
+    let sxy = 0;
+    for (const d of nodes) {
+        const dx = d.x - cx;
+        const dy = d.y - cy;
+        sxx += dx * dx;
+        syy += dy * dy;
+        sxy += dx * dy;
+    }
+    const half = (sxx - syy) / 2;
+    const lambda = (sxx + syy) / 2 + Math.sqrt(half * half + sxy * sxy);
+    let ux = sxy;
+    let uy = lambda - sxx;
+    if (Math.abs(ux) + Math.abs(uy) < 1e-12 * (sxx + syy + 1)) {
+        ux = lambda - syy;
+        uy = sxy;
+    }
+    const len = Math.sqrt(ux * ux + uy * uy);
+    const c = len > 0 ? ux / len : 1;
+    const s = len > 0 ? uy / len : 0;
+    let m3x = 0;
+    let m3y = 0;
+    for (const d of nodes) {
+        const dx = d.x - cx;
+        const dy = d.y - cy;
+        const rx = c * dx + s * dy;
+        const ry = -s * dx + c * dy;
+        d.x = rx;
+        d.y = ry;
+        const vx = c * d.vx + s * d.vy;
+        d.vy = -s * d.vx + c * d.vy;
+        d.vx = vx;
+        m3x += rx * rx * rx;
+        m3y += ry * ry * ry;
+    }
+    const fx = m3x < 0 ? -1 : 1;
+    const fy = m3y < 0 ? -1 : 1;
+    if (fx === 1 && fy === 1)
+        return;
+    for (const d of nodes) {
+        d.x *= fx;
+        d.vx *= fx;
+        d.y *= fy;
+        d.vy *= fy;
+    }
+}
+/**
+ * Scale the (free) layout up about its centroid when its label boxes could not possibly fit:
+ * when their total area exceeds `density` × the area of the nodes' bounding box. A dense graph
+ * pulls itself together tighter than its labels allow, and pushing boxes apart one pair at a time
+ * through such a jam takes many passes; a uniform scale keeps the picture and makes the room in
+ * one step. Fixed nodes, if any, rule this out.
+ */
+function makeRoom(nodes, boxes, padding, density) {
+    if (nodes.length < 3 || boxes.invMass.some((m) => m === 0))
+        return;
+    let minX = Number.POSITIVE_INFINITY;
+    let minY = Number.POSITIVE_INFINITY;
+    let maxX = Number.NEGATIVE_INFINITY;
+    let maxY = Number.NEGATIVE_INFINITY;
+    let area = 0;
+    let cx = 0;
+    let cy = 0;
+    for (const d of nodes) {
+        minX = Math.min(minX, d.x);
+        maxX = Math.max(maxX, d.x);
+        minY = Math.min(minY, d.y);
+        maxY = Math.max(maxY, d.y);
+        cx += d.x;
+        cy += d.y;
+        area += (2 * boxes.halfWidth[d.index] + padding) * (2 * boxes.halfHeight[d.index] + padding);
+    }
+    const span = Math.max(1, maxX - minX) * Math.max(1, maxY - minY);
+    const ratio = area / (density * span);
+    if (ratio <= 1)
+        return;
+    const scale = Math.sqrt(ratio);
+    cx /= nodes.length;
+    cy /= nodes.length;
+    for (const d of nodes) {
+        d.x = cx + (d.x - cx) * scale;
+        d.y = cy + (d.y - cy) * scale;
+    }
+}
+//# sourceMappingURL=simulate.js.map

package/dist/simulate.js.map

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

package/dist/text-metrics.d.ts

@@ -0,0 +1,32 @@
+/**
+ * DOM-free text metrics: label widths are estimated from per-character advances so the layout
+ * is identical in Node and in every browser (docs/algorithms.md §12 `estimateLabelWidth`).
+ */
+/** Advance of one code point, in em. */
+export declare function charAdvance(char: string): number;
+/** Sum of per-character advances × font size. See the public `estimateLabelWidth`. */
+export declare function labelWidth(text: string, fontSize: number): number;
+/** Gap between the node circle and the top of its label (world units, visual-language §Typography). */
+export declare const LABEL_GAP = 5;
+/** Height of one label line in em (12 px text + its 3 px halo). */
+export declare const LINE_HEIGHT_EM = 1.25;
+/** Renamed nodes show the old name 14 px (at 12 px text) below the new one, at 11/12 size. */
+export declare const SECONDARY_OFFSET_EM: number;
+export declare const SECONDARY_SIZE_RATIO: number;
+/**
+ * Reserved label width is capped so a pathological label (a 300-character IRI) cannot blow up
+ * the layout; renderers truncate long labels anyway. 32 em ≈ 55 Latin characters.
+ */
+export declare const MAX_LABEL_EM = 32;
+export interface LabelBox {
+    /** Full width of the label block (world units). */
+    readonly width: number;
+    /** Full height of the label block, all lines. */
+    readonly height: number;
+}
+/**
+ * The block of text drawn centered below a node: its label and, for renamed nodes, the struck
+ * old label on a second, slightly smaller line.
+ */
+export declare function labelBox(label: string, labelBefore: string | undefined, fontSize: number): LabelBox;
+//# sourceMappingURL=text-metrics.d.ts.map

package/dist/text-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-metrics.d.ts","sourceRoot":"","sources":["../src/text-metrics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkFH,wCAAwC;AACxC,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWhD;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAcjE;AAID,uGAAuG;AACvG,eAAO,MAAM,SAAS,IAAI,CAAC;AAC3B,mEAAmE;AACnE,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC,8FAA8F;AAC9F,eAAO,MAAM,mBAAmB,QAAU,CAAC;AAC3C,eAAO,MAAM,oBAAoB,QAAU,CAAC;AAC5C;;;GAGG;AACH,eAAO,MAAM,YAAY,KAAK,CAAC;AAE/B,MAAM,WAAW,QAAQ;IACvB,mDAAmD;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,QAAQ,EAAE,MAAM,GACf,QAAQ,CAUV"}

package/dist/text-metrics.js

@@ -0,0 +1,153 @@
+/**
+ * DOM-free text metrics: label widths are estimated from per-character advances so the layout
+ * is identical in Node and in every browser (docs/algorithms.md §12 `estimateLabelWidth`).
+ */
+/** Advance widths in em. */
+const EM_WIDE = 1;
+const EM_DIGIT = 0.6;
+const EM_UPPER = 0.68;
+const EM_OTHER = 0.56;
+const EM_SPACE = 0.3;
+/** One regional indicator is half of a flag emoji (a flag is a pair). */
+const EM_REGIONAL = 0.5;
+/**
+ * Code point ranges rendered full-width: East Asian Wide / Fullwidth blocks (CJK, kana, Hangul,
+ * full-width forms) and emoji. Sorted, inclusive, non-overlapping (binary searched).
+ */
+const WIDE_RANGES = [
+    [0x1100, 0x115f], // Hangul Jamo initials
+    [0x231a, 0x231b],
+    [0x2329, 0x232a],
+    [0x23e9, 0x23ec],
+    [0x23f0, 0x23f0],
+    [0x23f3, 0x23f3],
+    [0x25fd, 0x25fe],
+    [0x2600, 0x27bf], // misc symbols, dingbats (mostly emoji presentation)
+    [0x2b1b, 0x2b1c],
+    [0x2b50, 0x2b50],
+    [0x2b55, 0x2b55],
+    [0x2e80, 0x303e], // CJK radicals, Kangxi, ideographic description, CJK symbols & punctuation
+    [0x3041, 0x33ff], // kana, Bopomofo, Hangul compatibility, Kanbun, enclosed CJK, CJK compat
+    [0x3400, 0x4dbf], // CJK Ext. A
+    [0x4e00, 0x9fff], // CJK Unified Ideographs
+    [0xa000, 0xa4cf], // Yi
+    [0xa960, 0xa97f], // Hangul Jamo Ext. A
+    [0xac00, 0xd7a3], // Hangul syllables
+    [0xf900, 0xfaff], // CJK compatibility ideographs
+    [0xfe10, 0xfe19], // vertical forms
+    [0xfe30, 0xfe6f], // CJK compatibility forms, small forms
+    [0xff00, 0xff60], // full-width forms
+    [0xffe0, 0xffe6],
+    [0x16fe0, 0x18aff], // Tangut, Khitan…
+    [0x1b000, 0x1b2ff], // kana supplements
+    [0x1f004, 0x1f004],
+    [0x1f0cf, 0x1f0cf],
+    [0x1f18e, 0x1f18e],
+    [0x1f191, 0x1f19a],
+    [0x1f200, 0x1f2ff], // enclosed ideographic supplement
+    [0x1f300, 0x1f64f], // pictographs, emoticons
+    [0x1f680, 0x1f6ff], // transport & map
+    [0x1f7e0, 0x1f7eb],
+    [0x1f900, 0x1f9ff], // supplemental symbols & pictographs
+    [0x1fa70, 0x1faff],
+    [0x20000, 0x2fffd], // CJK Ext. B–F, compatibility supplement
+    [0x30000, 0x3fffd], // CJK Ext. G+
+];
+const ZERO_WIDTH = /[\p{Mn}\p{Me}\p{Cf}\p{Cc}]/u;
+const SPACE = /\s/u;
+const DIGIT = /\p{Nd}/u;
+const UPPER = /\p{Lu}/u;
+function inRanges(cp, ranges) {
+    let lo = 0;
+    let hi = ranges.length - 1;
+    while (lo <= hi) {
+        const mid = (lo + hi) >>> 1;
+        const range = ranges[mid];
+        if (range === undefined)
+            return false;
+        if (cp < range[0])
+            hi = mid - 1;
+        else if (cp > range[1])
+            lo = mid + 1;
+        else
+            return true;
+    }
+    return false;
+}
+function asciiAdvance(cp) {
+    if (cp === 0x20 || cp === 0x09)
+        return EM_SPACE;
+    if (cp < 0x20 || cp === 0x7f)
+        return 0;
+    if (cp >= 0x30 && cp <= 0x39)
+        return EM_DIGIT;
+    if (cp >= 0x41 && cp <= 0x5a)
+        return EM_UPPER;
+    return EM_OTHER;
+}
+/** Advance of one code point, in em. */
+export function charAdvance(char) {
+    const cp = char.codePointAt(0) ?? 0;
+    if (cp < 0x80)
+        return asciiAdvance(cp);
+    // Combining marks, joiners, variation selectors, emoji skin-tone modifiers draw no advance.
+    if (ZERO_WIDTH.test(char) || (cp >= 0x1f3fb && cp <= 0x1f3ff))
+        return 0;
+    if (cp >= 0x1f1e6 && cp <= 0x1f1ff)
+        return EM_REGIONAL;
+    if (inRanges(cp, WIDE_RANGES))
+        return EM_WIDE;
+    if (SPACE.test(char))
+        return EM_SPACE;
+    if (DIGIT.test(char))
+        return EM_DIGIT;
+    if (UPPER.test(char))
+        return EM_UPPER;
+    return EM_OTHER;
+}
+/** Sum of per-character advances × font size. See the public `estimateLabelWidth`. */
+export function labelWidth(text, fontSize) {
+    let em = 0;
+    for (let i = 0; i < text.length; i++) {
+        const unit = text.charCodeAt(i);
+        if (unit < 0x80) {
+            em += asciiAdvance(unit);
+            continue;
+        }
+        const cp = text.codePointAt(i) ?? unit;
+        const char = String.fromCodePoint(cp);
+        if (cp > 0xffff)
+            i++;
+        em += charAdvance(char);
+    }
+    return em * fontSize;
+}
+// ─── Label geometry (shared with bounds and collision) ───────────────────────
+/** Gap between the node circle and the top of its label (world units, visual-language §Typography). */
+export const LABEL_GAP = 5;
+/** Height of one label line in em (12 px text + its 3 px halo). */
+export const LINE_HEIGHT_EM = 1.25;
+/** Renamed nodes show the old name 14 px (at 12 px text) below the new one, at 11/12 size. */
+export const SECONDARY_OFFSET_EM = 14 / 12;
+export const SECONDARY_SIZE_RATIO = 11 / 12;
+/**
+ * Reserved label width is capped so a pathological label (a 300-character IRI) cannot blow up
+ * the layout; renderers truncate long labels anyway. 32 em ≈ 55 Latin characters.
+ */
+export const MAX_LABEL_EM = 32;
+/**
+ * The block of text drawn centered below a node: its label and, for renamed nodes, the struck
+ * old label on a second, slightly smaller line.
+ */
+export function labelBox(label, labelBefore, fontSize) {
+    const max = MAX_LABEL_EM * fontSize;
+    let width = Math.min(max, labelWidth(label, fontSize));
+    let height = LINE_HEIGHT_EM * fontSize;
+    if (labelBefore !== undefined && labelBefore !== label) {
+        const secondary = fontSize * SECONDARY_SIZE_RATIO;
+        width = Math.max(width, Math.min(max, labelWidth(labelBefore, secondary)));
+        height += SECONDARY_OFFSET_EM * fontSize;
+    }
+    return { width, height };
+}
+//# sourceMappingURL=text-metrics.js.map

package/dist/text-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-metrics.js","sourceRoot":"","sources":["../src/text-metrics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,4BAA4B;AAC5B,MAAM,OAAO,GAAG,CAAC,CAAC;AAClB,MAAM,QAAQ,GAAG,GAAG,CAAC;AACrB,MAAM,QAAQ,GAAG,IAAI,CAAC;AACtB,MAAM,QAAQ,GAAG,IAAI,CAAC;AACtB,MAAM,QAAQ,GAAG,GAAG,CAAC;AACrB,yEAAyE;AACzE,MAAM,WAAW,GAAG,GAAG,CAAC;AAExB;;;GAGG;AACH,MAAM,WAAW,GAA2C;IAC1D,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,uBAAuB;IACzC,CAAC,MAAM,EAAE,MAAM,CAAC;IAChB,CAAC,MAAM,EAAE,MAAM,CAAC;IAChB,CAAC,MAAM,EAAE,MAAM,CAAC;IAChB,CAAC,MAAM,EAAE,MAAM,CAAC;IAChB,CAAC,MAAM,EAAE,MAAM,CAAC;IAChB,CAAC,MAAM,EAAE,MAAM,CAAC;IAChB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,qDAAqD;IACvE,CAAC,MAAM,EAAE,MAAM,CAAC;IAChB,CAAC,MAAM,EAAE,MAAM,CAAC;IAChB,CAAC,MAAM,EAAE,MAAM,CAAC;IAChB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,2EAA2E;IAC7F,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,yEAAyE;IAC3F,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa;IAC/B,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,yBAAyB;IAC3C,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK;IACvB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,qBAAqB;IACvC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,mBAAmB;IACrC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,+BAA+B;IACjD,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,iBAAiB;IACnC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,uCAAuC;IACzD,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,mBAAmB;IACrC,CAAC,MAAM,EAAE,MAAM,CAAC;IAChB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,kBAAkB;IACtC,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,mBAAmB;IACvC,CAAC,OAAO,EAAE,OAAO,CAAC;IAClB,CAAC,OAAO,EAAE,OAAO,CAAC;IAClB,CAAC,OAAO,EAAE,OAAO,CAAC;IAClB,CAAC,OAAO,EAAE,OAAO,CAAC;IAClB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,kCAAkC;IACtD,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,yBAAyB;IAC7C,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,kBAAkB;IACtC,CAAC,OAAO,EAAE,OAAO,CAAC;IAClB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,qCAAqC;IACzD,CAAC,OAAO,EAAE,OAAO,CAAC;IAClB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,yCAAyC;IAC7D,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,cAAc;CACnC,CAAC;AAEF,MAAM,UAAU,GAAG,6BAA6B,CAAC;AACjD,MAAM,KAAK,GAAG,KAAK,CAAC;AACpB,MAAM,KAAK,GAAG,SAAS,CAAC;AACxB,MAAM,KAAK,GAAG,SAAS,CAAC;AAExB,SAAS,QAAQ,CAAC,EAAU,EAAE,MAA8C;IAC1E,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,EAAE,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAC3B,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACtC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;YAAE,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;aAC3B,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;YAAE,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;;YAChC,OAAO,IAAI,CAAC;IACnB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,EAAU;IAC9B,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI;QAAE,OAAO,QAAQ,CAAC;IAChD,IAAI,EAAE,GAAG,IAAI,IAAI,EAAE,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC;IACvC,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,IAAI,IAAI;QAAE,OAAO,QAAQ,CAAC;IAC9C,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,IAAI,IAAI;QAAE,OAAO,QAAQ,CAAC;IAC9C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,EAAE,GAAG,IAAI;QAAE,OAAO,YAAY,CAAC,EAAE,CAAC,CAAC;IACvC,4FAA4F;IAC5F,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,OAAO,IAAI,EAAE,IAAI,OAAO,CAAC;QAAE,OAAO,CAAC,CAAC;IACxE,IAAI,EAAE,IAAI,OAAO,IAAI,EAAE,IAAI,OAAO;QAAE,OAAO,WAAW,CAAC;IACvD,IAAI,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;QAAE,OAAO,OAAO,CAAC;IAC9C,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IACtC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IACtC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IACtC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,QAAgB;IACvD,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;YAChB,EAAE,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;YACzB,SAAS;QACX,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QACvC,MAAM,IAAI,GAAG,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,EAAE,GAAG,MAAM;YAAE,CAAC,EAAE,CAAC;QACrB,EAAE,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,EAAE,GAAG,QAAQ,CAAC;AACvB,CAAC;AAED,gFAAgF;AAEhF,uGAAuG;AACvG,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC;AAC3B,mEAAmE;AACnE,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AACnC,8FAA8F;AAC9F,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,GAAG,EAAE,CAAC;AAC3C,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,EAAE,CAAC;AAC5C;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAS/B;;;GAGG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAa,EACb,WAA+B,EAC/B,QAAgB;IAEhB,MAAM,GAAG,GAAG,YAAY,GAAG,QAAQ,CAAC;IACpC,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;IACvD,IAAI,MAAM,GAAG,cAAc,GAAG,QAAQ,CAAC;IACvC,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,KAAK,EAAE,CAAC;QACvD,MAAM,SAAS,GAAG,QAAQ,GAAG,oBAAoB,CAAC;QAClD,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;QAC3E,MAAM,IAAI,mBAAmB,GAAG,QAAQ,CAAC;IAC3C,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC"}

package/dist/union.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The union graph as the layout sees it: nodes in id order, undirected neighbour pairs drawn
+ * from BOTH versions of every edge (so neither version is favoured), and merge / split partner
+ * pairs. Built once per call in O(N + E).
+ */
+import type { DiffResult, UnionId, UnionNode } from '@kgdiff/core';
+export interface Partner {
+    /** The node that should travel little during replay (merge source / split target). */
+    readonly mover: number;
+    /** Where it travels to / from (merge target / split source). */
+    readonly anchor: number;
+}
+export interface UnionGraph {
+    /** Union nodes sorted by id (UTF-16 code unit order). */
+    readonly nodes: readonly UnionNode[];
+    readonly indexOf: ReadonlyMap<UnionId, number>;
+    /** Distinct undirected neighbour pairs [a, b] with a < b, in first-seen edge order. */
+    readonly pairs: Int32Array;
+    /** CSR adjacency over `pairs`: neighbours of i are `adjacency[offsets[i] .. offsets[i + 1])`, ascending. */
+    readonly offsets: Int32Array;
+    readonly adjacency: Int32Array;
+    readonly partners: readonly Partner[];
+    /** 1 for changed nodes and for endpoints (either version) of changed edges. */
+    readonly changed: Uint8Array;
+}
+/** Build CSR adjacency (ascending neighbour lists) from flat undirected pairs. */
+export declare function buildAdjacency(n: number, pairs: Int32Array): {
+    offsets: Int32Array;
+    adjacency: Int32Array;
+};
+export declare function buildUnionGraph(diff: DiffResult): UnionGraph;
+//# sourceMappingURL=union.d.ts.map

package/dist/union.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"union.d.ts","sourceRoot":"","sources":["../src/union.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEnE,MAAM,WAAW,OAAO;IACtB,sFAAsF;IACtF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/C,uFAAuF;IACvF,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,4GAA4G;IAC5G,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IACtC,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;CAC9B;AAeD,kFAAkF;AAClF,wBAAgB,cAAc,CAC5B,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,UAAU,GAChB;IAAE,OAAO,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,UAAU,CAAA;CAAE,CAchD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAiE5D"}