@xenolithengine/graph-core 0.7.0-beta.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 strelok2012
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,55 @@
+# @xenolithengine/graph-core
+
+[![BETA](https://img.shields.io/badge/status-BETA-FCB400?style=flat-square)](https://github.com/XenolithEngine/xenolith-graph#status)
+[![MIT](https://img.shields.io/badge/license-MIT-FCB400?style=flat-square)](https://github.com/XenolithEngine/xenolith-graph/blob/main/LICENSE)
+
+Headless graph model, type system, command bus, and event emitter for XenolithGraph. Zero runtime dependencies.
+
+> **Beta** — public API in `STABLE-API.md` is the surface we plan to freeze, but it is **NOT frozen yet** — breaking changes can land at any point before v1.0. If you adopt now, pin an exact version.
+
+Part of [XenolithGraph](https://github.com/XenolithEngine/xenolith-graph) — an AI-native, embeddable node-graph editor for the web with its own visual design language (Xen).
+
+## Install
+
+```bash
+pnpm add @xenolithengine/graph-core
+```
+
+Zero runtime dependencies. Pure ESM, TypeScript-first.
+
+## Usage
+
+```ts
+import { Graph, CommandBus, AddNode, ConnectPins, createNodeId } from '@xenolithengine/graph-core'
+
+const graph = new Graph()
+const bus = new CommandBus({ graph })
+
+const a = createNodeId()
+const b = createNodeId()
+
+bus.apply(new AddNode({ id: a, type: 'math.add', position: { x: 0, y: 0 }, pins: [] }))
+bus.apply(new AddNode({ id: b, type: 'math.mul', position: { x: 200, y: 0 }, pins: [] }))
+
+bus.undo()  // removes b
+bus.redo()  // re-adds b
+```
+
+## What's exported
+
+- `Graph` — node/edge/comment store; `Node`, `Edge`, `Pin`, `Comment` types
+- `CommandBus` + commands: `AddNode`, `RemoveNode`, `ConnectPins`, `DisconnectEdge`, `MoveNode`, `ResizeNode`, `SetNodeState`, `SetNodePins`, `SetNodeWidgets`, `AddComment`, `RemoveComment`, `MoveComment`, `ResizeComment`, `SetCommentText`
+- `Selection` — selection model with `SelectionMode`
+- `NodeRegistry`, `TypeRegistry` — schemas + type compatibility
+- Traversal: `incomers`, `outgoers`, `topoOrder`, `wouldCreateCycle`, `reachableFrom`, `connectedEdges`, `roots`, `leaves`
+- Templates & macros: `MACRO_TYPE`, `createMacro`, `planMacroCollapse`, `planMacroExpand`, `templateInterface`, `materializeInterface`, `planTemplateExtraction`, `planTemplateUnpack`, `flattenTemplateInstance`
+- Widgets: `defaultWidgetValue`, `widgetValue`, `clampWidgetValue`, `widgetIsVisible`; `WidgetSpec`, `WidgetType`
+- `EventEmitter`, `fuzzyMatch`, ID helpers (`createNodeId`, `createEdgeId`, `createPinId`, `createCommentId`, `createTypeId`, `isUuidV7`)
+
+## Docs
+
+- [Full guide](https://xenolithengine.github.io/xenolith-graph/guides/api/) — top-level architecture
+- [API reference](https://xenolithengine.github.io/xenolith-graph/guides/api/) — every method exposed by `XenolithEditor`
+- [GitHub](https://github.com/XenolithEngine/xenolith-graph)
+
+MIT © XenolithEngine

package/dist/command-bus.d.ts

@@ -0,0 +1,56 @@
+import type { EventEmitter } from './event-emitter.js';
+import type { Graph } from './graph.js';
+export interface CommandContext {
+    graph: Graph;
+    events: EventEmitter<CoreEvents>;
+}
+export interface Command<T = unknown> {
+    readonly type: string;
+    apply(ctx: CommandContext): T;
+    undo(ctx: CommandContext, applied: T): void;
+}
+export type CoreEvents = {
+    'command:applied': {
+        command: Command<unknown>;
+        result: unknown;
+    };
+    'command:undone': {
+        command: Command<unknown>;
+    };
+    'command:redone': {
+        command: Command<unknown>;
+    };
+    'transaction:committed': {
+        commands: Command<unknown>[];
+    };
+    'transaction:reverted': {
+        commands: Command<unknown>[];
+    };
+};
+export interface CommandBusOptions {
+    /** Maximum number of undo entries to retain. Older entries are dropped when exceeded. */
+    maxHistory?: number;
+}
+export declare class CommandBus {
+    #private;
+    constructor(ctx: CommandContext, opts?: CommandBusOptions);
+    apply<T>(command: Command<T>): T;
+    /** Open a manual undo group: subsequent applies collapse into one entry until `endGroup()` or
+     *  the idle timer fires. Re-entrant: a second call while a group is open is a no-op (does NOT
+     *  reset the buffer). `idleTimeoutMs > 0` auto-flushes after that many ms of inactivity
+     *  (every apply resets the timer); `0` means "explicit endGroup only". */
+    beginGroup(opts?: {
+        label?: string;
+        idleTimeoutMs?: number;
+    }): void;
+    /** Close the active group. No-op if none open. Empty group leaves history untouched (no
+     *  zero-command entry). Idempotent — calling twice is safe. */
+    endGroup(): void;
+    undo(): boolean;
+    redo(): boolean;
+    canUndo(): boolean;
+    canRedo(): boolean;
+    transaction<R>(fn: () => R): R;
+    clearHistory(): void;
+}
+//# sourceMappingURL=command-bus.d.ts.map

package/dist/command-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-bus.d.ts","sourceRoot":"","sources":["../src/command-bus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEvC,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,KAAK,CAAA;IACZ,MAAM,EAAE,YAAY,CAAC,UAAU,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,OAAO,CAAC,CAAC,GAAG,OAAO;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,CAAC,CAAA;IAC7B,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,CAAA;CAC5C;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,iBAAiB,EAAQ;QAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAA;IACvE,gBAAgB,EAAS;QAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAA;IACtD,gBAAgB,EAAS;QAAE,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAA;IACtD,uBAAuB,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAA;KAAE,CAAA;IACzD,sBAAsB,EAAG;QAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAA;KAAE,CAAA;CAC1D,CAAA;AAWD,MAAM,WAAW,iBAAiB;IAChC,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,qBAAa,UAAU;;gBAgBT,GAAG,EAAE,cAAc,EAAE,IAAI,GAAE,iBAAsB;IAK7D,KAAK,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAkBhC;;;8EAG0E;IAC1E,UAAU,CAAC,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,IAAI;IAQvE;mEAC+D;IAC/D,QAAQ,IAAI,IAAI;IAsBhB,IAAI,IAAI,OAAO;IAcf,IAAI,IAAI,OAAO;IAcf,OAAO,IAAI,OAAO;IAClB,OAAO,IAAI,OAAO;IAElB,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAyC9B,YAAY,IAAI,IAAI;CA2BrB"}

package/dist/command-bus.js

@@ -0,0 +1,180 @@
+export class CommandBus {
+    #ctx;
+    #maxHistory;
+    #log = [];
+    #cursor = 0;
+    #txBuffer = null;
+    // Open group (G10 — Baklava rete-history-plugin parity). Unlike a transaction (synchronous
+    // scope via a fn), a group spans multiple top-level apply() calls and is closed either by an
+    // explicit `endGroup()` OR by an idle timer (every apply resets it). All applies between
+    // beginGroup → endGroup commit as ONE undo entry, even when interleaved with caller code
+    // returning to the event loop (drag-move per-frame ticks, rapid widget edits, etc.).
+    #groupBuffer = null;
+    #groupLabel = undefined;
+    #groupIdleMs = 0;
+    #groupTimer = null;
+    constructor(ctx, opts = {}) {
+        this.#ctx = ctx;
+        this.#maxHistory = opts.maxHistory ?? Number.POSITIVE_INFINITY;
+    }
+    apply(command) {
+        const result = command.apply(this.#ctx);
+        const applied = { command: command, result };
+        if (this.#txBuffer) {
+            this.#txBuffer.push(applied);
+        }
+        else if (this.#groupBuffer) {
+            this.#groupBuffer.push(applied);
+            this.#bumpGroupIdle();
+        }
+        else {
+            this.#truncateRedo();
+            this.#log.push({ kind: 'single', entry: applied });
+            this.#cursor++;
+            this.#enforceHistoryBound();
+        }
+        this.#ctx.events.emit('command:applied', { command: applied.command, result });
+        return result;
+    }
+    /** Open a manual undo group: subsequent applies collapse into one entry until `endGroup()` or
+     *  the idle timer fires. Re-entrant: a second call while a group is open is a no-op (does NOT
+     *  reset the buffer). `idleTimeoutMs > 0` auto-flushes after that many ms of inactivity
+     *  (every apply resets the timer); `0` means "explicit endGroup only". */
+    beginGroup(opts = {}) {
+        if (this.#groupBuffer || this.#txBuffer)
+            return;
+        this.#groupBuffer = [];
+        this.#groupLabel = opts.label;
+        this.#groupIdleMs = opts.idleTimeoutMs ?? 0;
+        this.#bumpGroupIdle();
+    }
+    /** Close the active group. No-op if none open. Empty group leaves history untouched (no
+     *  zero-command entry). Idempotent — calling twice is safe. */
+    endGroup() {
+        if (!this.#groupBuffer)
+            return;
+        const buffer = this.#groupBuffer;
+        this.#groupBuffer = null;
+        this.#groupLabel = undefined;
+        this.#groupIdleMs = 0;
+        if (this.#groupTimer) {
+            clearTimeout(this.#groupTimer);
+            this.#groupTimer = null;
+        }
+        if (buffer.length === 0)
+            return;
+        this.#truncateRedo();
+        this.#log.push({ kind: 'tx', entries: buffer });
+        this.#cursor++;
+        this.#enforceHistoryBound();
+        this.#ctx.events.emit('transaction:committed', { commands: buffer.map((e) => e.command) });
+    }
+    /** Auto-flush group after inactivity. Setting groupIdleMs:0 (or no timer source) opts out. */
+    #bumpGroupIdle() {
+        if (this.#groupIdleMs <= 0)
+            return;
+        if (this.#groupTimer)
+            clearTimeout(this.#groupTimer);
+        this.#groupTimer = setTimeout(() => { this.endGroup(); }, this.#groupIdleMs);
+    }
+    undo() {
+        if (!this.canUndo())
+            return false;
+        this.#cursor--;
+        const entry = this.#log[this.#cursor];
+        if (entry.kind === 'single') {
+            this.#undoOne(entry.entry);
+        }
+        else {
+            for (let i = entry.entries.length - 1; i >= 0; i--) {
+                this.#undoOne(entry.entries[i]);
+            }
+        }
+        return true;
+    }
+    redo() {
+        if (!this.canRedo())
+            return false;
+        const entry = this.#log[this.#cursor];
+        // Advance the cursor before re-applying so listeners observing command:redone read a consistent
+        // canUndo/canRedo (mirrors undo(), which decrements first). #redoOne doesn't depend on the cursor.
+        this.#cursor++;
+        if (entry.kind === 'single') {
+            this.#redoOne(entry.entry);
+        }
+        else {
+            for (const e of entry.entries)
+                this.#redoOne(e);
+        }
+        return true;
+    }
+    canUndo() { return this.#cursor > 0; }
+    canRedo() { return this.#cursor < this.#log.length; }
+    transaction(fn) {
+        // Nested transactions join the outer one — commands accumulate in the same buffer, and the
+        // OUTERMOST call is the only one that commits or reverts. Lets a high-level multi-step
+        // operation (e.g. macro→template) call into building-block methods that each open a transaction
+        // and still produce a SINGLE undoable history entry. Inner errors propagate so the outermost
+        // handler rolls everything back atomically.
+        if (this.#txBuffer) {
+            return fn();
+        }
+        // A group is the outer scope when one's open — fold the transaction's applies into the
+        // group buffer so endGroup() commits everything as ONE history entry. apply() already
+        // routes to #groupBuffer when no #txBuffer exists.
+        if (this.#groupBuffer) {
+            return fn();
+        }
+        const buffer = [];
+        this.#txBuffer = buffer;
+        try {
+            const result = fn();
+            this.#txBuffer = null;
+            if (buffer.length === 0)
+                return result;
+            this.#truncateRedo();
+            this.#log.push({ kind: 'tx', entries: buffer });
+            this.#cursor++;
+            this.#enforceHistoryBound();
+            this.#ctx.events.emit('transaction:committed', { commands: buffer.map((e) => e.command) });
+            return result;
+        }
+        catch (err) {
+            this.#txBuffer = null;
+            for (let i = buffer.length - 1; i >= 0; i--) {
+                try {
+                    this.#undoOne(buffer[i]);
+                }
+                catch {
+                    // continue rollback even if a single undo throws
+                }
+            }
+            this.#ctx.events.emit('transaction:reverted', { commands: buffer.map((e) => e.command) });
+            throw err;
+        }
+    }
+    clearHistory() {
+        this.#log.length = 0;
+        this.#cursor = 0;
+    }
+    #truncateRedo() {
+        if (this.#cursor < this.#log.length) {
+            this.#log.length = this.#cursor;
+        }
+    }
+    #enforceHistoryBound() {
+        while (this.#log.length > this.#maxHistory) {
+            this.#log.shift();
+            this.#cursor--;
+        }
+    }
+    #undoOne(applied) {
+        applied.command.undo(this.#ctx, applied.result);
+        this.#ctx.events.emit('command:undone', { command: applied.command });
+    }
+    #redoOne(applied) {
+        applied.result = applied.command.apply(this.#ctx);
+        this.#ctx.events.emit('command:redone', { command: applied.command });
+    }
+}
+//# sourceMappingURL=command-bus.js.map

package/dist/command-bus.js.map

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

package/dist/commands-comment.d.ts

@@ -0,0 +1,52 @@
+import type { Command, CommandContext } from './command-bus.js';
+import type { Comment, Vec2 } from './graph.js';
+import type { CommentId } from './ids.js';
+export declare class AddComment implements Command<void> {
+    readonly comment: Comment;
+    readonly type = "AddComment";
+    constructor(comment: Comment);
+    apply(ctx: CommandContext): void;
+    undo(ctx: CommandContext): void;
+}
+export declare class RemoveComment implements Command<Comment> {
+    readonly commentId: CommentId;
+    readonly type = "RemoveComment";
+    constructor(commentId: CommentId);
+    apply(ctx: CommandContext): Comment;
+    undo(ctx: CommandContext, removed: Comment): void;
+}
+export declare class MoveComment implements Command<Vec2> {
+    #private;
+    readonly commentId: CommentId;
+    readonly type = "MoveComment";
+    constructor(commentId: CommentId, target: Vec2);
+    apply(ctx: CommandContext): Vec2;
+    undo(ctx: CommandContext, old: Vec2): void;
+}
+export declare class ResizeComment implements Command<Vec2> {
+    #private;
+    readonly commentId: CommentId;
+    readonly type = "ResizeComment";
+    constructor(commentId: CommentId, target: Vec2);
+    apply(ctx: CommandContext): Vec2;
+    undo(ctx: CommandContext, old: Vec2): void;
+}
+export declare class SetCommentText implements Command<{
+    text: string;
+    color: string | undefined;
+}> {
+    readonly commentId: CommentId;
+    private readonly text;
+    private readonly color?;
+    readonly type = "SetCommentText";
+    constructor(commentId: CommentId, text: string, color?: string | undefined);
+    apply(ctx: CommandContext): {
+        text: string;
+        color: string | undefined;
+    };
+    undo(ctx: CommandContext, old: {
+        text: string;
+        color: string | undefined;
+    }): void;
+}
+//# sourceMappingURL=commands-comment.d.ts.map

package/dist/commands-comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands-comment.d.ts","sourceRoot":"","sources":["../src/commands-comment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEzC,qBAAa,UAAW,YAAW,OAAO,CAAC,IAAI,CAAC;IAElC,QAAQ,CAAC,OAAO,EAAE,OAAO;IADrC,QAAQ,CAAC,IAAI,gBAAe;gBACP,OAAO,EAAE,OAAO;IAErC,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAIhC,IAAI,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;CAGhC;AAED,qBAAa,aAAc,YAAW,OAAO,CAAC,OAAO,CAAC;IAExC,QAAQ,CAAC,SAAS,EAAE,SAAS;IADzC,QAAQ,CAAC,IAAI,mBAAkB;gBACV,SAAS,EAAE,SAAS;IAEzC,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO;IAMnC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;CAGlD;AAED,qBAAa,WAAY,YAAW,OAAO,CAAC,IAAI,CAAC;;IAGnC,QAAQ,CAAC,SAAS,EAAE,SAAS;IAFzC,QAAQ,CAAC,IAAI,iBAAgB;gBAER,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI;IAIvD,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAQhC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI;CAG3C;AAED,qBAAa,aAAc,YAAW,OAAO,CAAC,IAAI,CAAC;;IAGrC,QAAQ,CAAC,SAAS,EAAE,SAAS;IAFzC,QAAQ,CAAC,IAAI,mBAAkB;gBAEV,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI;IAIvD,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAQhC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI;CAG3C;AAED,qBAAa,cAAe,YAAW,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;IAGvF,QAAQ,CAAC,SAAS,EAAE,SAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IAJzB,QAAQ,CAAC,IAAI,oBAAmB;gBAErB,SAAS,EAAE,SAAS,EACZ,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,YAAA;IAGjC,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE;IAQvE,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,IAAI;CAGlF"}

package/dist/commands-comment.js

@@ -0,0 +1,92 @@
+export class AddComment {
+    comment;
+    type = 'AddComment';
+    constructor(comment) {
+        this.comment = comment;
+    }
+    apply(ctx) {
+        ctx.graph._addComment(this.comment);
+    }
+    undo(ctx) {
+        ctx.graph._removeComment(this.comment.id);
+    }
+}
+export class RemoveComment {
+    commentId;
+    type = 'RemoveComment';
+    constructor(commentId) {
+        this.commentId = commentId;
+    }
+    apply(ctx) {
+        const removed = ctx.graph._removeComment(this.commentId);
+        if (!removed)
+            throw new Error(`RemoveComment: comment not found: ${this.commentId}`);
+        return removed;
+    }
+    undo(ctx, removed) {
+        ctx.graph._addComment(removed);
+    }
+}
+export class MoveComment {
+    commentId;
+    type = 'MoveComment';
+    #target;
+    constructor(commentId, target) {
+        this.commentId = commentId;
+        this.#target = { x: target.x, y: target.y };
+    }
+    apply(ctx) {
+        const c = ctx.graph.getComment(this.commentId);
+        if (!c)
+            throw new Error(`MoveComment: comment not found: ${this.commentId}`);
+        const old = { x: c.position.x, y: c.position.y };
+        ctx.graph._patchComment(this.commentId, { position: { x: this.#target.x, y: this.#target.y } });
+        return old;
+    }
+    undo(ctx, old) {
+        ctx.graph._patchComment(this.commentId, { position: old });
+    }
+}
+export class ResizeComment {
+    commentId;
+    type = 'ResizeComment';
+    #target;
+    constructor(commentId, target) {
+        this.commentId = commentId;
+        this.#target = { x: target.x, y: target.y };
+    }
+    apply(ctx) {
+        const c = ctx.graph.getComment(this.commentId);
+        if (!c)
+            throw new Error(`ResizeComment: comment not found: ${this.commentId}`);
+        const old = { x: c.size.x, y: c.size.y };
+        ctx.graph._patchComment(this.commentId, { size: { x: this.#target.x, y: this.#target.y } });
+        return old;
+    }
+    undo(ctx, old) {
+        ctx.graph._patchComment(this.commentId, { size: old });
+    }
+}
+export class SetCommentText {
+    commentId;
+    text;
+    color;
+    type = 'SetCommentText';
+    constructor(commentId, text, color) {
+        this.commentId = commentId;
+        this.text = text;
+        this.color = color;
+    }
+    apply(ctx) {
+        const c = ctx.graph.getComment(this.commentId);
+        if (!c)
+            throw new Error(`SetCommentText: comment not found: ${this.commentId}`);
+        const old = { text: c.text, color: c.color };
+        ctx.graph._patchComment(this.commentId, { text: this.text, ...(this.color !== undefined ? { color: this.color } : {}) });
+        return old;
+    }
+    undo(ctx, old) {
+        ctx.graph._patchComment(this.commentId, { text: old.text, ...(old.color !== undefined ? { color: old.color } : {}) });
+    }
+}
+//# sourceMappingURL=commands-comment.js.map

package/dist/commands-comment.js.map

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

package/dist/commands-mut.d.ts

@@ -0,0 +1,58 @@
+import type { Command, CommandContext } from './command-bus.js';
+import type { Edge, Pin, Vec2 } from './graph.js';
+import type { NodeId } from './ids.js';
+import type { WidgetSpec } from './widget.js';
+export declare class MoveNode implements Command<Vec2> {
+    #private;
+    readonly nodeId: NodeId;
+    readonly type = "MoveNode";
+    constructor(nodeId: NodeId, target: Vec2);
+    apply(ctx: CommandContext): Vec2;
+    undo(ctx: CommandContext, old: Vec2): void;
+}
+export declare class ResizeNode implements Command<Vec2 | undefined> {
+    #private;
+    private readonly nodeId;
+    readonly type = "ResizeNode";
+    constructor(nodeId: NodeId, target: Vec2);
+    apply(ctx: CommandContext): Vec2 | undefined;
+    undo(ctx: CommandContext, old: Vec2 | undefined): void;
+}
+export declare class SetNodeState implements Command<Record<string, unknown>> {
+    private readonly nodeId;
+    private readonly partial;
+    readonly type = "SetNodeState";
+    constructor(nodeId: NodeId, partial: Record<string, unknown>);
+    apply(ctx: CommandContext): Record<string, unknown>;
+    undo(ctx: CommandContext, old: Record<string, unknown>): void;
+}
+export interface SetNodePinsUndo {
+    pins: Pin[];
+    prunedEdges: Edge[];
+}
+/** Replace a node's pin list wholesale (variadic pins: Sequence/MakeArray "+", Branch true/false).
+ *  Edges incident to a pin that no longer exists are pruned and restored on undo. */
+export declare class SetNodePins implements Command<SetNodePinsUndo> {
+    #private;
+    private readonly nodeId;
+    readonly type = "SetNodePins";
+    constructor(nodeId: NodeId, pins: Pin[]);
+    apply(ctx: CommandContext): SetNodePinsUndo;
+    undo(ctx: CommandContext, applied: SetNodePinsUndo): void;
+}
+export interface SetNodeWidgetsUndo {
+    widgets: WidgetSpec[] | undefined;
+}
+/** Replace a node's widget list wholesale. Used by runtime plugins to synthesise widgets in
+ *  response to schema changes (e.g. `@xenolithengine/graph-plugin-runtime`'s Schema-node flow that derives a
+ *  Struct's editable fields from a wired Schema). Per-widget `state[key]` values survive removal,
+ *  so re-adding a widget under the same key picks up the previously typed value. */
+export declare class SetNodeWidgets implements Command<SetNodeWidgetsUndo> {
+    #private;
+    private readonly nodeId;
+    readonly type = "SetNodeWidgets";
+    constructor(nodeId: NodeId, widgets: WidgetSpec[] | undefined);
+    apply(ctx: CommandContext): SetNodeWidgetsUndo;
+    undo(ctx: CommandContext, applied: SetNodeWidgetsUndo): void;
+}
+//# sourceMappingURL=commands-mut.d.ts.map

package/dist/commands-mut.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands-mut.d.ts","sourceRoot":"","sources":["../src/commands-mut.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAC/D,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,qBAAa,QAAS,YAAW,OAAO,CAAC,IAAI,CAAC;;IAI1C,QAAQ,CAAC,MAAM,EAAE,MAAM;IAHzB,QAAQ,CAAC,IAAI,cAAa;gBAGf,MAAM,EAAE,MAAM,EACvB,MAAM,EAAE,IAAI;IAKd,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAQhC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,IAAI,GAAG,IAAI;CAG3C;AAED,qBAAa,UAAW,YAAW,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC;;IAIxD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHzB,QAAQ,CAAC,IAAI,gBAAe;gBAGT,MAAM,EAAE,MAAM,EAC/B,MAAM,EAAE,IAAI;IAKd,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS;IAQ5C,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,IAAI,GAAG,SAAS,GAAG,IAAI;CAGvD;AAED,qBAAa,YAAa,YAAW,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAGjE,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH1B,QAAQ,CAAC,IAAI,kBAAiB;gBAEX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAGnD,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAQnD,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAG9D;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,GAAG,EAAE,CAAA;IACX,WAAW,EAAE,IAAI,EAAE,CAAA;CACpB;AAED;qFACqF;AACrF,qBAAa,WAAY,YAAW,OAAO,CAAC,eAAe,CAAC;;IAIxD,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHzB,QAAQ,CAAC,IAAI,iBAAgB;gBAGV,MAAM,EAAE,MAAM,EAC/B,IAAI,EAAE,GAAG,EAAE;IAKb,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,eAAe;IAiB3C,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;CAI1D;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,UAAU,EAAE,GAAG,SAAS,CAAA;CAClC;AAED;;;oFAGoF;AACpF,qBAAa,cAAe,YAAW,OAAO,CAAC,kBAAkB,CAAC;;IAI9D,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHzB,QAAQ,CAAC,IAAI,oBAAmB;gBAGb,MAAM,EAAE,MAAM,EAC/B,OAAO,EAAE,UAAU,EAAE,GAAG,SAAS;IAKnC,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,kBAAkB;IAQ9C,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI;CAG7D"}