@kgdiff/g6 0.0.0-stage → 0.2.0

package/dist/options.js

@@ -0,0 +1,172 @@
+import { BACKGROUND_PLUGIN_KEY, EDGE_LABEL_SIZE, HOVER_BEHAVIOR_KEY, HOVER_EDGE_WIDTH, HOVER_NODE_WIDTH, HOVER_STATE, NODE_TYPE, TEXT_HALO_ALPHA, Z, } from './constants.js';
+import { kgdiffData } from './map.js';
+const CHANGE_FAMILIES = new Set([
+    'added',
+    'removed',
+    'content',
+    'structure',
+    'identity',
+]);
+function num(v, fallback) {
+    return typeof v === 'number' && Number.isFinite(v) ? v : fallback;
+}
+/**
+ * Hover on a node, as the resolver does it: a 2-wide stroke in the family's strong color
+ * (secondary text color for context), drawn on top, label revealed even below its LOD zoom.
+ */
+export function hoverNodeStyle(datum, theme) {
+    const d = kgdiffData(datum.data);
+    if (d === null || d.kgdiff !== 'node')
+        return {};
+    const style = datum.style ?? {};
+    const fam = d.family;
+    const opacity = Math.max(num(style.labelOpacity, 0), num(style.opacity, 1));
+    return {
+        lineWidth: HOVER_NODE_WIDTH,
+        stroke: d.changed && CHANGE_FAMILIES.has(fam)
+            ? theme.family[fam].strong
+            : theme.text.secondary,
+        zIndex: Z.node + Z.span - 1,
+        label: typeof style.labelText === 'string' && style.labelText.length > 0,
+        labelOpacity: opacity,
+        labelStrokeOpacity: TEXT_HALO_ALPHA * opacity,
+    };
+}
+/** Hover on an edge: at least 2.5 wide, arrowhead, on top, its label shown. */
+export function hoverEdgeStyle(datum, theme) {
+    const d = kgdiffData(datum.data);
+    if (d === null || (d.kgdiff !== 'edge' && d.kgdiff !== 'glyph'))
+        return {};
+    const style = datum.style ?? {};
+    const own = typeof style.labelText === 'string' && style.labelText.length > 0;
+    const text = own ? style.labelText : d.label;
+    const opacity = Math.max(num(style.labelOpacity, 0), num(style.opacity, 1));
+    return {
+        lineWidth: Math.max(num(style.lineWidth, 1), HOVER_EDGE_WIDTH),
+        endArrow: datum.source !== datum.target,
+        zIndex: (d.kgdiff === 'glyph' ? Z.glyph : Z.edge) + Z.span - 1,
+        label: text.length > 0,
+        labelText: text,
+        labelFill: own ? style.labelFill : theme.neutral.label,
+        labelFontSize: own ? num(style.labelFontSize, EDGE_LABEL_SIZE) : EDGE_LABEL_SIZE,
+        labelOpacity: opacity,
+        labelStrokeOpacity: TEXT_HALO_ALPHA * opacity,
+    };
+}
+/** Update animations: what interpolates when a frame replaces the previous one. */
+const NODE_ANIMATION = {
+    enter: 'fade',
+    exit: 'fade',
+    show: 'fade',
+    hide: 'fade',
+    update: [
+        {
+            fields: [
+                'x',
+                'y',
+                'size',
+                'fill',
+                'stroke',
+                'lineWidth',
+                'opacity',
+                'labelOpacity',
+                'ringOpacity',
+                'haloStrokeOpacity',
+                'sublabelOpacity',
+            ],
+        },
+    ],
+    translate: [{ fields: ['x', 'y'] }],
+};
+const EDGE_ANIMATION = {
+    enter: 'fade',
+    exit: 'fade',
+    show: 'fade',
+    hide: 'fade',
+    update: [
+        {
+            fields: [
+                'sourceNode',
+                'targetNode',
+                'stroke',
+                'lineWidth',
+                'opacity',
+                'labelOpacity',
+                'curveOffset',
+            ],
+        },
+    ],
+    translate: [{ fields: ['sourceNode', 'targetNode'] }],
+};
+export function generatedOptions(input) {
+    const theme = input.theme;
+    return {
+        container: input.container,
+        autoResize: true,
+        theme: false,
+        padding: 32,
+        data: input.data,
+        node: {
+            type: NODE_TYPE,
+            state: { [HOVER_STATE]: (datum) => hoverNodeStyle(datum, theme()) },
+            animation: NODE_ANIMATION,
+        },
+        edge: {
+            state: { [HOVER_STATE]: (datum) => hoverEdgeStyle(datum, theme()) },
+            animation: EDGE_ANIMATION,
+        },
+        behaviors: input.interactive
+            ? [
+                'zoom-canvas',
+                'drag-canvas',
+                {
+                    type: 'hover-activate',
+                    key: HOVER_BEHAVIOR_KEY,
+                    state: HOVER_STATE,
+                    degree: 0,
+                    enable: input.hoverable,
+                },
+            ]
+            : [],
+        plugins: [
+            { type: 'background', key: BACKGROUND_PLUGIN_KEY, background: theme().canvas.background },
+        ],
+    };
+}
+const CONCAT = new Set(['behaviors', 'plugins', 'transforms']);
+function isPlain(v) {
+    return (v !== null &&
+        typeof v === 'object' &&
+        !Array.isArray(v) &&
+        Object.getPrototypeOf(v) === Object.prototype);
+}
+function deepMerge(a, b) {
+    const out = { ...a };
+    for (const [key, value] of Object.entries(b)) {
+        const base = out[key];
+        out[key] = isPlain(base) && isPlain(value) ? deepMerge(base, value) : value;
+    }
+    return out;
+}
+/**
+ * User options over generated ones: `behaviors`, `plugins` and `transforms` are appended to the
+ * generated lists; plain objects (`node`, `edge`, `node.state`…) merge recursively; everything
+ * else (arrays, functions, primitives) from `user` replaces the generated value.
+ */
+export function mergeG6Options(generated, user) {
+    if (user === undefined)
+        return generated;
+    const out = { ...generated };
+    for (const [key, value] of Object.entries(user)) {
+        const base = out[key];
+        if (CONCAT.has(key) && Array.isArray(base) && Array.isArray(value))
+            out[key] = [...base, ...value];
+        else if (isPlain(base) && isPlain(value))
+            out[key] = deepMerge(base, value);
+        else
+            out[key] = value;
+    }
+    // The merged object is GraphOptions plus whatever the caller added; G6 validates it.
+    return out;
+}
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

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

package/dist/patch.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Frame-to-frame patches. G6's `setData` re-reads and compares the whole graph and merges full
+ * styles into every changed element; sending G6 only what changed — new elements, removed ids,
+ * and for updated elements just the changed style keys — keeps its data layer proportional to
+ * the change. Pure.
+ */
+import type { EdgeData, ID, NodeData } from '@antv/g6';
+export type Datum = NodeData | EdgeData;
+export interface Patch {
+    readonly add: {
+        nodes: NodeData[];
+        edges: EdgeData[];
+    };
+    /** Partial data: `id` (edges also `source` / `target`), the changed style keys, changed `data`. */
+    readonly update: {
+        nodes: NodeData[];
+        edges: EdgeData[];
+    };
+    readonly remove: {
+        nodes: ID[];
+        edges: ID[];
+    };
+    /**
+     * Elements whose id switched between node and edge (only possible through id collisions):
+     * added after `remove`, since G6 rejects a duplicate id.
+     */
+    readonly readd: {
+        nodes: NodeData[];
+        edges: EdgeData[];
+    };
+    /** Number of elements added, updated, removed or re-added. */
+    readonly size: number;
+}
+/** Structural equality for style values (primitives, arrays, plain objects such as badges). */
+export declare function deepEqual(a: unknown, b: unknown): boolean;
+/**
+ * The patch turning `prev` (by id) into `next`. Edge updates always carry `zIndex`: without a
+ * numeric one, G6's `updateData` recomputes an edge's zIndex from its endpoints. O(elements ×
+ * style keys).
+ */
+export declare function diffData(prev: ReadonlyMap<ID, Datum>, next: {
+    readonly nodes: readonly NodeData[];
+    readonly edges: readonly EdgeData[];
+}): Patch;
+//# sourceMappingURL=patch.d.ts.map

package/dist/patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../src/patch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEvD,MAAM,MAAM,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExC,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,GAAG,EAAE;QAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QAAC,KAAK,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAC;IACvD,mGAAmG;IACnG,QAAQ,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QAAC,KAAK,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAC;IAC1D,QAAQ,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QAAC,KAAK,EAAE,EAAE,EAAE,CAAA;KAAE,CAAC;IAC9C;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QAAC,KAAK,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAC;IACzD,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,+FAA+F;AAC/F,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAUzD;AA6BD;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,WAAW,CAAC,EAAE,EAAE,KAAK,CAAC,EAC5B,IAAI,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAA;CAAE,GACjF,KAAK,CA4DP"}

package/dist/patch.js

@@ -0,0 +1,120 @@
+/** Structural equality for style values (primitives, arrays, plain objects such as badges). */
+export function deepEqual(a, b) {
+    if (a === b)
+        return true;
+    if (typeof a !== 'object' || typeof b !== 'object' || a === null || b === null)
+        return false;
+    if (Array.isArray(a) !== Array.isArray(b))
+        return false;
+    const ka = Object.keys(a);
+    const kb = Object.keys(b);
+    if (ka.length !== kb.length)
+        return false;
+    const ra = a;
+    const rb = b;
+    return ka.every((k) => deepEqual(ra[k], rb[k]));
+}
+/** Keys of `next` whose values differ from `prev` (structurally), or null when none do. */
+function changedKeys(prev, next) {
+    if (next === undefined)
+        return null;
+    let out = null;
+    for (const key of Object.keys(next)) {
+        const value = next[key];
+        const old = prev?.[key];
+        if (old === value || (typeof value === 'object' && deepEqual(old, value)))
+            continue;
+        if (out === null)
+            out = {};
+        out[key] = value;
+    }
+    return out;
+}
+function shallowEqual(a, b) {
+    if (a === b)
+        return true;
+    if (a === undefined || b === undefined)
+        return false;
+    const ka = Object.keys(a);
+    return ka.length === Object.keys(b).length && ka.every((k) => a[k] === b[k]);
+}
+/**
+ * The patch turning `prev` (by id) into `next`. Edge updates always carry `zIndex`: without a
+ * numeric one, G6's `updateData` recomputes an edge's zIndex from its endpoints. O(elements ×
+ * style keys).
+ */
+export function diffData(prev, next) {
+    const add = { nodes: [], edges: [] };
+    const update = { nodes: [], edges: [] };
+    const remove = { nodes: [], edges: [] };
+    const readd = { nodes: [], edges: [] };
+    const seen = new Set();
+    for (const node of next.nodes) {
+        const old = prev.get(node.id);
+        if (old === undefined || 'source' in old) {
+            if (old === undefined)
+                add.nodes.push(node);
+            else
+                readd.nodes.push(node);
+            continue;
+        }
+        seen.add(node.id);
+        const style = changedKeys(old.style, node.style);
+        const dataChanged = !shallowEqual(old.data, node.data);
+        const typeChanged = old.type !== node.type;
+        if (style === null && !dataChanged && !typeChanged)
+            continue;
+        const patch = { id: node.id };
+        if (style !== null)
+            patch.style = style;
+        if (dataChanged)
+            patch.data = node.data;
+        if (typeChanged)
+            patch.type = node.type;
+        update.nodes.push(patch);
+    }
+    for (const edge of next.edges) {
+        const id = edge.id;
+        const old = prev.get(id);
+        if (old === undefined || !('source' in old)) {
+            if (old === undefined)
+                add.edges.push(edge);
+            else
+                readd.edges.push(edge);
+            continue;
+        }
+        seen.add(id);
+        const style = changedKeys(old.style, edge.style);
+        const dataChanged = !shallowEqual(old.data, edge.data);
+        const typeChanged = old.type !== edge.type;
+        const endsChanged = old.source !== edge.source || old.target !== edge.target;
+        if (style === null && !dataChanged && !typeChanged && !endsChanged)
+            continue;
+        const patch = { id, source: edge.source, target: edge.target };
+        patch.style = { ...style, zIndex: edge.style?.zIndex };
+        if (dataChanged)
+            patch.data = edge.data;
+        if (typeChanged)
+            patch.type = edge.type;
+        update.edges.push(patch);
+    }
+    for (const [id, old] of prev) {
+        // Kept elements were marked seen; added ones were not in `prev` at all.
+        if (seen.has(id))
+            continue;
+        if ('source' in old)
+            remove.edges.push(id);
+        else
+            remove.nodes.push(id);
+    }
+    const size = add.nodes.length +
+        add.edges.length +
+        update.nodes.length +
+        update.edges.length +
+        remove.nodes.length +
+        remove.edges.length +
+        readd.nodes.length +
+        readd.edges.length;
+    return { add, update, remove, readd, size };
+}
+//# sourceMappingURL=patch.js.map

package/dist/patch.js.map

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

package/dist/replay.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Replay plan: the timeline times at which the controller resolves a frame and hands it to G6,
+ * which animates linearly from one sample to the next. Pure.
+ */
+import type { Timeline } from '@kgdiff/scene';
+export interface ReplayStep {
+    /** Timeline time to resolve (ms at 1×). */
+    readonly t: number;
+    /** Time since the previous step (ms at 1×); the first step counts from 0. */
+    readonly dt: number;
+    /** On the first step of a unit (window, or chapter in chapter mode): its hunks, for the camera. */
+    readonly focus: readonly number[] | null;
+}
+/**
+ * Sample every unit of `timeline` at `samples` (fractions of its duration). Units are the
+ * hunk windows, or the chapters in chapter mode (whose windows overlap and play together).
+ * Steps are sorted by time; samples closer than 1e-6 ms are merged. O(U log U).
+ */
+export declare function planReplay(timeline: Timeline, samples?: readonly number[]): ReplayStep[];
+//# sourceMappingURL=replay.d.ts.map

package/dist/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../src/replay.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,mGAAmG;IACnG,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;CAC1C;AAQD;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,QAAQ,EAClB,OAAO,GAAE,SAAS,MAAM,EAAmB,GAC1C,UAAU,EAAE,CA4Bd"}

package/dist/replay.js

@@ -0,0 +1,36 @@
+import { REPLAY_SAMPLES } from './constants.js';
+/**
+ * Sample every unit of `timeline` at `samples` (fractions of its duration). Units are the
+ * hunk windows, or the chapters in chapter mode (whose windows overlap and play together).
+ * Steps are sorted by time; samples closer than 1e-6 ms are merged. O(U log U).
+ */
+export function planReplay(timeline, samples = REPLAY_SAMPLES) {
+    const units = timeline.mode === 'chapters'
+        ? timeline.chapters.map((c) => ({ start: c.start, end: c.end, hunks: c.hunks }))
+        : timeline.windows.map((w) => ({ start: w.start, end: w.end, hunks: [w.hunk] }));
+    const raw = [];
+    units.forEach((u, k) => {
+        if (!Number.isFinite(u.start) || !Number.isFinite(u.end))
+            return;
+        const length = Math.max(0, u.end - u.start);
+        samples.forEach((f, s) => {
+            raw.push({ t: u.start + f * length, focus: s === 0 ? u.hunks : null, order: k });
+        });
+    });
+    raw.sort((a, b) => a.t - b.t || a.order - b.order);
+    const steps = [];
+    let prev = 0;
+    for (const r of raw) {
+        const last = steps[steps.length - 1];
+        if (last !== undefined && r.t - last.t < 1e-6) {
+            if (r.focus !== null && last.focus === null) {
+                steps[steps.length - 1] = { ...last, focus: r.focus };
+            }
+            continue;
+        }
+        steps.push({ t: r.t, dt: Math.max(0, r.t - prev), focus: r.focus });
+        prev = r.t;
+    }
+    return steps;
+}
+//# sourceMappingURL=replay.js.map

package/dist/replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.js","sourceRoot":"","sources":["../src/replay.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAiBhD;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,QAAkB,EAClB,OAAO,GAAsB,cAAc;IAE3C,MAAM,KAAK,GACT,QAAQ,CAAC,IAAI,KAAK,UAAU;QAC1B,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QAChF,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACrF,MAAM,GAAG,GAAoE,EAAE,CAAC;IAChF,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACrB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC;YAAE,OAAO;QACjE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAC5C,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACvB,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QACnF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IACnD,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACrC,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC;YAC9C,IAAI,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC5C,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;YACxD,CAAC;YACD,SAAS;QACX,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACpE,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;IACb,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

@@ -1,6 +1,57 @@
 {
   "name": "@kgdiff/g6",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "AntV G6 v5 adapter for kgdiff: render semantic graph diffs inside your G6 graphs.",
+  "keywords": [
+    "kgdiff",
+    "antv",
+    "g6",
+    "adapter"
+  ],
+  "homepage": "https://github.com/iiwish/kgdiff/tree/main/packages/g6#readme",
+  "bugs": {
+    "url": "https://github.com/iiwish/kgdiff/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/iiwish/kgdiff.git",
+    "directory": "packages/g6"
+  },
+  "license": "MIT",
+  "author": "iiwish",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@kgdiff/core": "0.2.0",
+    "@kgdiff/scene": "0.2.0"
+  },
+  "peerDependencies": {
+    "@antv/g6": "^5.1.0"
+  },
+  "devDependencies": {
+    "@antv/g6": "5.1.1"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json",
+    "test": "vitest run"
+  }
 }

package/src/color.ts

@@ -0,0 +1,101 @@
+/**
+ * The few color operations G6 cannot do for us: compositing translucent badge tints over the
+ * canvas (the native renderer paints an opaque base first) and building glow gradients.
+ * Scene tokens are `#rgb` / `#rrggbb` / `#rrggbbaa` or `rgb()` / `rgba()`; anything else is
+ * passed through unchanged.
+ */
+
+/** [r, g, b] in 0–255 and alpha in [0, 1]. */
+export type Rgba = readonly [number, number, number, number];
+
+const HEX = /^#([0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})$/i;
+const FUNC = /^rgba?\(\s*([^)]*)\)$/i;
+
+function clampByte(v: number): number {
+  return Math.min(255, Math.max(0, Math.round(v)));
+}
+
+function clampUnit(v: number): number {
+  return Math.min(1, Math.max(0, v));
+}
+
+/** Parse a hex or `rgb()` / `rgba()` color; null for anything else. */
+export function parseColor(color: string): Rgba | null {
+  const s = color.trim();
+  const hex = HEX.exec(s);
+  if (hex !== null) {
+    let h = hex[1] as string;
+    if (h.length <= 4) h = [...h].map((c) => c + c).join('');
+    const n = (i: number): number => Number.parseInt(h.slice(i, i + 2), 16);
+    return [n(0), n(2), n(4), h.length === 8 ? n(6) / 255 : 1];
+  }
+  const fn = FUNC.exec(s);
+  if (fn === null) return null;
+  const parts = (fn[1] as string).split(/[\s,/]+/).filter((p) => p.length > 0);
+  if (parts.length !== 3 && parts.length !== 4) return null;
+  const nums = parts.map((p) =>
+    p.endsWith('%') ? (Number.parseFloat(p) / 100) * 255 : Number.parseFloat(p),
+  );
+  if (nums.some((v) => !Number.isFinite(v))) return null;
+  const alphaPart = parts[3];
+  const alpha =
+    alphaPart === undefined
+      ? 1
+      : alphaPart.endsWith('%')
+        ? Number.parseFloat(alphaPart) / 100
+        : Number.parseFloat(alphaPart);
+  return [
+    clampByte(nums[0] as number),
+    clampByte(nums[1] as number),
+    clampByte(nums[2] as number),
+    clampUnit(alpha),
+  ];
+}
+
+/** `rgba(r, g, b, a)` with `a` multiplied into the color's own alpha. */
+export function withAlpha(color: Rgba, alpha: number): string {
+  const a = Math.round(clampUnit(color[3] * alpha) * 1000) / 1000;
+  return `rgba(${color[0]}, ${color[1]}, ${color[2]}, ${a})`;
+}
+
+/**
+ * `top` painted over `bottom` (source-over) as an opaque `rgb()` color. Returns `top` unchanged
+ * when either color cannot be parsed, and `top` itself when it is already opaque.
+ */
+export function composite(top: string, bottom: string): string {
+  const t = parseColor(top);
+  const b = parseColor(bottom);
+  if (t === null || b === null || t[3] >= 1) return top;
+  const a = t[3];
+  const mix = (i: 0 | 1 | 2): number => clampByte(t[i] * a + b[i] * (1 - a));
+  return `rgb(${mix(0)}, ${mix(1)}, ${mix(2)})`;
+}
+
+/** Glow falloff of the native renderer: (radius fraction, alpha) — a soft, roughly Gaussian profile. */
+const GLOW_STOPS: readonly (readonly [number, number])[] = [
+  [0, 1],
+  [0.3, 0.9],
+  [0.5, 0.6],
+  [0.7, 0.28],
+  [0.86, 0.08],
+  [1, 0],
+];
+
+const gradients = new Map<string, string>();
+
+/**
+ * A CSS radial gradient (parsed by AntV G) filling a circle with the native glow profile in
+ * `color`; `closest-side` makes the gradient end exactly at the circle's radius. Memoized: the
+ * string doubles as G's gradient cache key. Falls back to the plain color when unparsable.
+ */
+export function glowGradient(color: string): string {
+  let g = gradients.get(color);
+  if (g !== undefined) return g;
+  const rgba = parseColor(color);
+  if (rgba === null) return color;
+  const stops = GLOW_STOPS.map(([at, alpha]) => `${withAlpha(rgba, alpha)} ${at * 100}%`);
+  g = `radial-gradient(circle closest-side, ${stops.join(', ')})`;
+  if (gradients.size > 256) gradients.clear();
+  gradients.set(color, g);
+  return g;
+}