@xenolithengine/graph-core 0.7.0-beta.0

package/dist/graph.js

@@ -0,0 +1,141 @@
+export class Graph {
+    #nodes = new Map();
+    #edges = new Map();
+    #comments = new Map();
+    #version = 0;
+    get version() { return this.#version; }
+    get nodeCount() { return this.#nodes.size; }
+    get edgeCount() { return this.#edges.size; }
+    get commentCount() { return this.#comments.size; }
+    getNode(id) { return this.#nodes.get(id); }
+    hasNode(id) { return this.#nodes.has(id); }
+    *nodes() {
+        for (const n of this.#nodes.values())
+            yield n;
+    }
+    getEdge(id) { return this.#edges.get(id); }
+    hasEdge(id) { return this.#edges.has(id); }
+    *edges() {
+        for (const e of this.#edges.values())
+            yield e;
+    }
+    getComment(id) { return this.#comments.get(id); }
+    hasComment(id) { return this.#comments.has(id); }
+    *comments() {
+        for (const c of this.#comments.values())
+            yield c;
+    }
+    /** @internal */
+    _addComment(comment) {
+        if (this.#comments.has(comment.id)) {
+            throw new Error(`Graph: duplicate comment id ${comment.id}`);
+        }
+        this.#comments.set(comment.id, comment);
+        this.#version++;
+    }
+    /** @internal */
+    _removeComment(id) {
+        const comment = this.#comments.get(id);
+        if (!comment)
+            return undefined;
+        this.#comments.delete(id);
+        this.#version++;
+        return comment;
+    }
+    /** @internal — patch mutable Comment fields in place (identity `id` is immutable). */
+    _patchComment(id, patch) {
+        const comment = this.#comments.get(id);
+        if (!comment)
+            return undefined;
+        if (patch.position !== undefined)
+            comment.position = patch.position;
+        if (patch.size !== undefined)
+            comment.size = patch.size;
+        if (patch.text !== undefined)
+            comment.text = patch.text;
+        if (patch.color !== undefined)
+            comment.color = patch.color;
+        this.#version++;
+        return comment;
+    }
+    /** @internal — call only from CommandBus-applied commands. */
+    _addNode(node) {
+        if (this.#nodes.has(node.id)) {
+            throw new Error(`Graph: duplicate node id ${node.id}`);
+        }
+        this.#nodes.set(node.id, node);
+        this.#version++;
+    }
+    /** @internal */
+    _removeNode(id) {
+        const node = this.#nodes.get(id);
+        if (!node)
+            return undefined;
+        this.#nodes.delete(id);
+        this.#version++;
+        return node;
+    }
+    /** @internal */
+    _addEdge(edge) {
+        if (this.#edges.has(edge.id)) {
+            throw new Error(`Graph: duplicate edge id ${edge.id}`);
+        }
+        this.#edges.set(edge.id, edge);
+        this.#version++;
+    }
+    /** @internal */
+    _removeEdge(id) {
+        const edge = this.#edges.get(id);
+        if (!edge)
+            return undefined;
+        this.#edges.delete(id);
+        this.#version++;
+        return edge;
+    }
+    /**
+     * @internal — patch a subset of mutable Node fields in place.
+     * Only `position`, `size`, `state`, and `type` may be patched; identity (`id`) and pin structure
+     * (`pins`) are immutable through this method by design. Returns the patched node (same reference)
+     * or undefined if the id is unknown.
+     */
+    _patchNode(id, patch) {
+        const node = this.#nodes.get(id);
+        if (!node)
+            return undefined;
+        if (patch.position !== undefined)
+            node.position = patch.position;
+        if (patch.size !== undefined)
+            node.size = patch.size;
+        if (patch.state !== undefined)
+            node.state = patch.state;
+        if (patch.type !== undefined)
+            node.type = patch.type;
+        this.#version++;
+        return node;
+    }
+    /** @internal — replace a node's pin list wholesale. Pruning edges incident to dropped pins is the
+     *  caller's job (the SetNodePins command does it so the change is undoable). */
+    _setNodePins(id, pins) {
+        const node = this.#nodes.get(id);
+        if (!node)
+            return undefined;
+        node.pins = pins;
+        this.#version++;
+        return node;
+    }
+    /** @internal — replace a node's widget list wholesale. Per-widget `node.state[key]` values are
+     *  NOT touched: re-adding a previously-removed widget under the same key restores its value.
+     *  Use via the `SetNodeWidgets` command so the change is undoable. */
+    _setNodeWidgets(id, widgets) {
+        const node = this.#nodes.get(id);
+        if (!node)
+            return undefined;
+        if (widgets && widgets.length > 0)
+            node.widgets = widgets;
+        else
+            delete node.widgets;
+        this.#version++;
+        return node;
+    }
+}
+//# sourceMappingURL=graph.js.map

package/dist/graph.js.map

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

package/dist/ids.d.ts

@@ -0,0 +1,28 @@
+declare const NodeIdBrand: unique symbol;
+declare const EdgeIdBrand: unique symbol;
+declare const PinIdBrand: unique symbol;
+declare const CommentIdBrand: unique symbol;
+declare const TypeIdBrand: unique symbol;
+export type NodeId = string & {
+    readonly [NodeIdBrand]: true;
+};
+export type EdgeId = string & {
+    readonly [EdgeIdBrand]: true;
+};
+export type PinId = string & {
+    readonly [PinIdBrand]: true;
+};
+export type CommentId = string & {
+    readonly [CommentIdBrand]: true;
+};
+export type TypeId = string & {
+    readonly [TypeIdBrand]: true;
+};
+export declare function createNodeId(): NodeId;
+export declare function createEdgeId(): EdgeId;
+export declare function createPinId(): PinId;
+export declare function createCommentId(): CommentId;
+export declare function createTypeId(value: string): TypeId;
+export declare function isUuidV7(value: unknown): boolean;
+export {};
+//# sourceMappingURL=ids.d.ts.map

package/dist/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../src/ids.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,WAAW,EAAE,OAAO,MAAM,CAAA;AACxC,OAAO,CAAC,MAAM,WAAW,EAAE,OAAO,MAAM,CAAA;AACxC,OAAO,CAAC,MAAM,UAAU,EAAE,OAAO,MAAM,CAAA;AACvC,OAAO,CAAC,MAAM,cAAc,EAAE,OAAO,MAAM,CAAA;AAC3C,OAAO,CAAC,MAAM,WAAW,EAAE,OAAO,MAAM,CAAA;AAExC,MAAM,MAAM,MAAM,GAAM,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,WAAW,CAAC,EAAE,IAAI,CAAA;CAAE,CAAA;AACjE,MAAM,MAAM,MAAM,GAAM,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,WAAW,CAAC,EAAE,IAAI,CAAA;CAAE,CAAA;AACjE,MAAM,MAAM,KAAK,GAAO,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,UAAU,CAAC,EAAE,IAAI,CAAA;CAAE,CAAA;AAChE,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,cAAc,CAAC,EAAE,IAAI,CAAA;CAAE,CAAA;AACpE,MAAM,MAAM,MAAM,GAAM,MAAM,GAAG;IAAE,QAAQ,CAAC,CAAC,WAAW,CAAC,EAAE,IAAI,CAAA;CAAE,CAAA;AA6BjE,wBAAgB,YAAY,IAAI,MAAM,CAAoC;AAC1E,wBAAgB,YAAY,IAAI,MAAM,CAAoC;AAC1E,wBAAgB,WAAW,IAAI,KAAK,CAAqC;AACzE,wBAAgB,eAAe,IAAI,SAAS,CAAiC;AAC7E,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAA2B;AAE9E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEhD"}

package/dist/ids.js

@@ -0,0 +1,31 @@
+const UUID_V7_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+let lastIssuedMs = 0n;
+function uuidV7() {
+    const now = BigInt(Date.now());
+    const ms = now > lastIssuedMs ? now : lastIssuedMs + 1n;
+    lastIssuedMs = ms;
+    const bytes = new Uint8Array(16);
+    bytes[0] = Number((ms >> 40n) & 0xffn);
+    bytes[1] = Number((ms >> 32n) & 0xffn);
+    bytes[2] = Number((ms >> 24n) & 0xffn);
+    bytes[3] = Number((ms >> 16n) & 0xffn);
+    bytes[4] = Number((ms >> 8n) & 0xffn);
+    bytes[5] = Number(ms & 0xffn);
+    crypto.getRandomValues(bytes.subarray(6));
+    bytes[6] = ((bytes[6] ?? 0) & 0x0f) | 0x70;
+    bytes[8] = ((bytes[8] ?? 0) & 0x3f) | 0x80;
+    const hex = [];
+    for (let i = 0; i < 16; i++)
+        hex.push((bytes[i] ?? 0).toString(16).padStart(2, '0'));
+    const h = hex.join('');
+    return `${h.slice(0, 8)}-${h.slice(8, 12)}-${h.slice(12, 16)}-${h.slice(16, 20)}-${h.slice(20, 32)}`;
+}
+export function createNodeId() { return uuidV7(); }
+export function createEdgeId() { return uuidV7(); }
+export function createPinId() { return uuidV7(); }
+export function createCommentId() { return uuidV7(); }
+export function createTypeId(value) { return value; }
+export function isUuidV7(value) {
+    return typeof value === 'string' && UUID_V7_PATTERN.test(value);
+}
+//# sourceMappingURL=ids.js.map

package/dist/ids.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+export declare const VERSION = "0.7.0-beta.0";
+export { EventEmitter } from './event-emitter.js';
+export type { EventMap, Listener, Unsubscribe, ErrorListener } from './event-emitter.js';
+export { createNodeId, createEdgeId, createPinId, createCommentId, createTypeId, isUuidV7, } from './ids.js';
+export type { NodeId, EdgeId, PinId, CommentId, TypeId } from './ids.js';
+export { Graph } from './graph.js';
+export type { Node, Edge, Pin, Comment, Vec2, PinKind, PinDirection, NodeGlyph } from './graph.js';
+export { incomers, outgoers, connectedEdges, roots, leaves, topoOrder, wouldCreateCycle, reachableFrom } from './traversal.js';
+export { CommandBus } from './command-bus.js';
+export type { Command, CommandContext, CommandBusOptions, CoreEvents } from './command-bus.js';
+export { AddNode, RemoveNode, ConnectPins, DisconnectEdge } from './commands.js';
+export type { RemoveNodeUndo } from './commands.js';
+export { MoveNode, ResizeNode, SetNodeState, SetNodePins, SetNodeWidgets } from './commands-mut.js';
+export type { SetNodePinsUndo, SetNodeWidgetsUndo } from './commands-mut.js';
+export { AddComment, RemoveComment, MoveComment, ResizeComment, SetCommentText } from './commands-comment.js';
+export { nodesInsideComment } from './comment-spatial.js';
+export type { PlacedNode, CommentRect } from './comment-spatial.js';
+export { Selection } from './selection.js';
+export type { SelectionMode, SelectionChange } from './selection.js';
+export { NodeRegistry, migrateNodePayload } from './node-registry.js';
+export type { NodeSchema, PinSchema, NodeSearchResult } from './node-registry.js';
+export { TypeRegistry } from './types-registry.js';
+export type { TypeDescriptor } from './types-registry.js';
+export { fuzzyMatch } from './fuzzy.js';
+export type { FuzzyMatch } from './fuzzy.js';
+export { REROUTE_TYPE, isReroute, createReroute, REROUTE_NODE_TYPE, rerouteNodeSchema } from './reroute.js';
+export { MACRO_TYPE, isMacro, createMacro, macroMembers, boundaryEdges, macroProxyPins, planMacroCollapse, planMacroExpand, flattenMacroProxies, disconnectedWidgetBoundPins } from './macro.js';
+export type { MacroBoundary, MacroProxyPin, MacroProxyRecord, MacroCollapsePlan, MacroExpandPlan, Minters } from './macro.js';
+export { TEMPLATE_INPUT_TYPE, TEMPLATE_OUTPUT_TYPE, TEMPLATE_INSTANCE_TYPE, isTemplateBoundary, isTemplateInstance, templateInterface, materializeInterface, planTemplateExtraction, planTemplateUnpack, templateDefContains, } from './template-def.js';
+export type { TemplateDefId, TemplateDefinition, TemplateInterfacePin, TemplateMinters, TemplateExtraction, TemplateUnpackPlan, } from './template-def.js';
+export { flattenTemplateInstance, flattenAllTemplateInstances } from './template-flatten.js';
+export type { FlattenedTemplate, PinRef } from './template-flatten.js';
+export { defaultWidgetValue, widgetValue, clampWidgetValue, comboOptions, widgetVisibility, widgetBindKey, widgetIsVisible } from './widget.js';
+export type { WidgetSpec, WidgetType, WidgetStyle, ComboOption, ComboOptionResolved } from './widget.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,20 @@
+export const VERSION = '0.7.0-beta.0';
+export { EventEmitter } from './event-emitter.js';
+export { createNodeId, createEdgeId, createPinId, createCommentId, createTypeId, isUuidV7, } from './ids.js';
+export { Graph } from './graph.js';
+export { incomers, outgoers, connectedEdges, roots, leaves, topoOrder, wouldCreateCycle, reachableFrom } from './traversal.js';
+export { CommandBus } from './command-bus.js';
+export { AddNode, RemoveNode, ConnectPins, DisconnectEdge } from './commands.js';
+export { MoveNode, ResizeNode, SetNodeState, SetNodePins, SetNodeWidgets } from './commands-mut.js';
+export { AddComment, RemoveComment, MoveComment, ResizeComment, SetCommentText } from './commands-comment.js';
+export { nodesInsideComment } from './comment-spatial.js';
+export { Selection } from './selection.js';
+export { NodeRegistry, migrateNodePayload } from './node-registry.js';
+export { TypeRegistry } from './types-registry.js';
+export { fuzzyMatch } from './fuzzy.js';
+export { REROUTE_TYPE, isReroute, createReroute, REROUTE_NODE_TYPE, rerouteNodeSchema } from './reroute.js';
+export { MACRO_TYPE, isMacro, createMacro, macroMembers, boundaryEdges, macroProxyPins, planMacroCollapse, planMacroExpand, flattenMacroProxies, disconnectedWidgetBoundPins } from './macro.js';
+export { TEMPLATE_INPUT_TYPE, TEMPLATE_OUTPUT_TYPE, TEMPLATE_INSTANCE_TYPE, isTemplateBoundary, isTemplateInstance, templateInterface, materializeInterface, planTemplateExtraction, planTemplateUnpack, templateDefContains, } from './template-def.js';
+export { flattenTemplateInstance, flattenAllTemplateInstances } from './template-flatten.js';
+export { defaultWidgetValue, widgetValue, clampWidgetValue, comboOptions, widgetVisibility, widgetBindKey, widgetIsVisible } from './widget.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,cAAc,CAAA;AAErC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAGjD,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,WAAW,EACX,eAAe,EACf,YAAY,EACZ,QAAQ,GACT,MAAM,UAAU,CAAA;AAGjB,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAE9H,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAG7C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAGhF,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAGnG,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAC7G,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAGzD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAG1C,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAGrE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAGlD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAGvC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAC3G,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,iBAAiB,EAAE,eAAe,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAA;AAGhM,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,mBAAmB,CAAA;AAU1B,OAAO,EAAE,uBAAuB,EAAE,2BAA2B,EAAE,MAAM,uBAAuB,CAAA;AAG5F,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,gBAAgB,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA"}

package/dist/macro.d.ts

@@ -0,0 +1,120 @@
+import type { Edge, Node, Pin, Vec2 } from './graph.js';
+import type { NodeId, PinId, EdgeId } from './ids.js';
+/** Reserved node type for a macro — a group of nodes that collapses into a single compact node and
+ *  expands back in place (inline, no drill-in subgraph). The graph stays flat: members live in the
+ *  graph and are hidden while collapsed. `state.members` holds the member ids, `state.collapsed`
+ *  the fold state. Boundary-crossing edges become the macro's proxy pins (see boundaryEdges). */
+export declare const MACRO_TYPE = "Macro";
+export declare function isMacro(node: {
+    type: string;
+}): boolean;
+/** Mint a collapsed macro node carrying its member ids. Pins are derived from boundary edges by the
+ *  editor on collapse, so a fresh macro starts pinless. */
+export declare function createMacro(position: Vec2, members: NodeId[]): Node;
+/** Member ids of a macro node (empty for a non-macro or one with no members). */
+export declare function macroMembers(node: Node): NodeId[];
+export interface MacroBoundary {
+    /** Edges entering the group (from outside → a member): become the macro's input pins. */
+    inputs: Edge[];
+    /** Edges leaving the group (a member → outside): become the macro's output pins. */
+    outputs: Edge[];
+    /** Edges fully inside the group: hidden while collapsed, restored on expand. */
+    internal: Edge[];
+}
+export interface MacroProxyPin {
+    direction: 'in' | 'out';
+    /** The member node this proxy stands in for. */
+    memberNode: NodeId;
+    /** The member's own pin the boundary edges cross at. */
+    memberPin: PinId;
+    /** Boundary edges routed through this proxy (an in-pin may gather several feeds; an out-pin may
+     *  fan out to several externals). */
+    edges: EdgeId[];
+}
+/** Collapse boundary edges into the macro's proxy pins: one input pin per distinct member IN-pin that
+ *  receives an external feed, one output pin per distinct member OUT-pin that drives an external. Pin
+ *  insertion order follows first appearance, so collapse is deterministic. */
+export declare function macroProxyPins(boundary: MacroBoundary): MacroProxyPin[];
+/** One restored-on-expand record per macro proxy edge: which fresh macro edge stands in for which
+ *  original external↔member connection. Stored on the macro's state so expand can rebuild exactly. */
+export interface MacroProxyRecord {
+    /** Id of the macro proxy edge (external↔macro) created on collapse. `null` for a LIFTED pin —
+     *  a widget-bound member IN-pin that wasn't wire-fed at collapse time but was surfaced anyway
+     *  so the user can wire to it later (UX parity with Template's open boundary pins). On a future
+     *  connect-to-macro-pin while collapsed, the editor fills this in with the real edge id so
+     *  expand rewires it correctly; while it stays null the pin is a no-op on expand. */
+    edgeId: EdgeId | null;
+    /** The macro's own proxy pin this crossing uses — fixed for the macro's lifetime, so collapse and
+     *  expand just re-point the edge between this pin and the member pin without re-deriving pins. */
+    macroPin: PinId;
+    direction: 'in' | 'out';
+    externalNode: NodeId;
+    externalPin: PinId;
+    memberNode: NodeId;
+    memberPin: PinId;
+}
+export interface Minters {
+    pin: () => PinId;
+    edge: () => EdgeId;
+}
+export interface MacroCollapsePlan {
+    /** Proxy pins to give the macro node. */
+    pins: Pin[];
+    /** Boundary edges to remove (rewired onto the macro). */
+    disconnect: EdgeId[];
+    /** New external↔macro edges. */
+    connect: Edge[];
+    /** Restore map → macro.state for expand. */
+    proxyMap: MacroProxyRecord[];
+}
+export interface PlanMacroCollapseOpts {
+    /** Member IN-pins to expose on the macro even though no external edge crosses them yet —
+     *  typically the widget-bound IN-pins discovered via `disconnectedWidgetBoundPins`. Each entry
+     *  becomes a proxy IN-pin with a sentinel `proxyMap` record (`edgeId: null`) so the editor can
+     *  finalise the bridge when the user later connects to it. Entries that overlap a wire-fed
+     *  boundary pin are silently de-duplicated. */
+    liftPins?: ReadonlyArray<{
+        node: NodeId;
+        pin: PinId;
+    }>;
+}
+/** Plan a collapse: derive proxy pins from boundary crossings and rewire each boundary edge onto the
+ *  macro (external↔member becomes external↔macro.proxyPin). Pure — the caller applies it through the
+ *  command bus and persists `proxyMap` on the macro. `typeOf` resolves a member pin's wire type so
+ *  the proxy pin carries it; `mint` supplies fresh pin/edge ids. */
+export declare function planMacroCollapse(macroId: NodeId, members: NodeId[], edges: ReadonlyArray<Edge>, pinInfo: (node: NodeId, pin: PinId) => {
+    type: string;
+    label?: string;
+}, mint: Minters, opts?: PlanMacroCollapseOpts): MacroCollapsePlan;
+/** Find every widget-bound IN-pin on `member` that isn't already fed by an incoming edge — the
+ *  set that needs to be LIFTED onto a macro on collapse so the widget surface survives. Pure;
+ *  pass `hasIncomingEdge(pinId)` so the caller drives boundary-awareness from whatever index it
+ *  has (graph.edges() pass, edge-by-node cache, anything cheap). Skips button widgets (no pin
+ *  binding) and OUT-pins (display widgets — macro pins lift inputs only). */
+export declare function disconnectedWidgetBoundPins(member: Node, hasIncomingEdge: (pinId: PinId) => boolean): Array<{
+    node: NodeId;
+    pin: PinId;
+}>;
+export interface MacroExpandPlan {
+    /** Macro proxy edges to remove. */
+    disconnect: EdgeId[];
+    /** Original external↔member edges to restore (fresh ids). */
+    connect: Edge[];
+}
+/** Plan an expand: drop every macro proxy edge and rebuild the original external↔member edges from
+ *  the stored proxy map. Pure — caller applies it and strips the macro's proxy pins. */
+export declare function planMacroExpand(proxyMap: ReadonlyArray<MacroProxyRecord>, mint: Minters): MacroExpandPlan;
+/** Partition edges relative to a member set — the heart of macro pin-proxying. An edge with exactly
+ *  one endpoint inside the group crosses the boundary (input if it enters, output if it leaves); both
+ *  inside is internal; both outside is ignored. Order within each bucket follows input order. */
+export declare function boundaryEdges(members: ReadonlySet<NodeId>, edges: ReadonlyArray<Edge>): MacroBoundary;
+/** Flatten collapsed macros into their primitives for a host interpreter: drop every `Macro` node and
+ *  remap any edge endpoint that lands on a macro proxy pin back to the member pin it bridges (via the
+ *  macro's `state.proxyMap`). Recurses through nested macros (a member pin may itself be an inner
+ *  macro's proxy pin). Pure — never mutates the inputs. Internal member↔member edges pass through
+ *  untouched; the macro grouping becomes purely visual. */
+export declare function flattenMacroProxies(nodes: ReadonlyArray<Node>, edges: ReadonlyArray<Edge>): {
+    nodes: Node[];
+    edges: Edge[];
+};
+//# sourceMappingURL=macro.d.ts.map

package/dist/macro.d.ts.map

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

package/dist/macro.js

@@ -0,0 +1,226 @@
+import { createNodeId } from './ids.js';
+import { widgetBindKey } from './widget.js';
+/** Reserved node type for a macro — a group of nodes that collapses into a single compact node and
+ *  expands back in place (inline, no drill-in subgraph). The graph stays flat: members live in the
+ *  graph and are hidden while collapsed. `state.members` holds the member ids, `state.collapsed`
+ *  the fold state. Boundary-crossing edges become the macro's proxy pins (see boundaryEdges). */
+export const MACRO_TYPE = 'Macro';
+export function isMacro(node) {
+    return node.type === MACRO_TYPE;
+}
+/** Mint a collapsed macro node carrying its member ids. Pins are derived from boundary edges by the
+ *  editor on collapse, so a fresh macro starts pinless. */
+export function createMacro(position, members) {
+    return {
+        id: createNodeId(),
+        type: MACRO_TYPE,
+        position,
+        state: { members: [...members], collapsed: true },
+        pins: [],
+    };
+}
+/** Member ids of a macro node (empty for a non-macro or one with no members). */
+export function macroMembers(node) {
+    if (!isMacro(node))
+        return [];
+    const m = node.state['members'];
+    return Array.isArray(m) ? m : [];
+}
+/** Collapse boundary edges into the macro's proxy pins: one input pin per distinct member IN-pin that
+ *  receives an external feed, one output pin per distinct member OUT-pin that drives an external. Pin
+ *  insertion order follows first appearance, so collapse is deterministic. */
+export function macroProxyPins(boundary) {
+    const order = [];
+    const byKey = new Map();
+    const add = (direction, node, pin, edge) => {
+        const key = `${direction}:${node}:${pin}`;
+        let proxy = byKey.get(key);
+        if (!proxy) {
+            proxy = { direction, memberNode: node, memberPin: pin, edges: [] };
+            byKey.set(key, proxy);
+            order.push(proxy);
+        }
+        proxy.edges.push(edge);
+    };
+    for (const e of boundary.inputs)
+        add('in', e.to.node, e.to.pin, e.id);
+    for (const e of boundary.outputs)
+        add('out', e.from.node, e.from.pin, e.id);
+    return order;
+}
+/** Plan a collapse: derive proxy pins from boundary crossings and rewire each boundary edge onto the
+ *  macro (external↔member becomes external↔macro.proxyPin). Pure — the caller applies it through the
+ *  command bus and persists `proxyMap` on the macro. `typeOf` resolves a member pin's wire type so
+ *  the proxy pin carries it; `mint` supplies fresh pin/edge ids. */
+export function planMacroCollapse(macroId, members, edges, pinInfo, mint, opts = {}) {
+    const boundary = boundaryEdges(new Set(members), edges);
+    const proxies = macroProxyPins(boundary);
+    const byId = new Map(edges.map((e) => [e.id, e]));
+    const pins = [];
+    const connect = [];
+    const disconnect = [];
+    const proxyMap = [];
+    for (const proxy of proxies) {
+        const pinId = mint.pin();
+        const info = pinInfo(proxy.memberNode, proxy.memberPin);
+        pins.push({
+            id: pinId,
+            kind: 'data',
+            direction: proxy.direction,
+            type: info.type,
+            multiple: proxy.direction === 'out',
+            ...(info.label !== undefined ? { label: info.label } : {}),
+        });
+        for (const beId of proxy.edges) {
+            const orig = byId.get(beId);
+            disconnect.push(beId);
+            const newId = mint.edge();
+            // input: external.out → macro.in ;  output: macro.out → external.in
+            const external = proxy.direction === 'in' ? orig.from : orig.to;
+            const newEdge = proxy.direction === 'in'
+                ? { id: newId, from: { ...external }, to: { node: macroId, pin: pinId } }
+                : { id: newId, from: { node: macroId, pin: pinId }, to: { ...external } };
+            connect.push(newEdge);
+            proxyMap.push({
+                edgeId: newId,
+                macroPin: pinId,
+                direction: proxy.direction,
+                externalNode: external.node,
+                externalPin: external.pin,
+                memberNode: proxy.memberNode,
+                memberPin: proxy.memberPin,
+            });
+        }
+    }
+    // Lifted pins: surface free widget-bound IN-pins as macro IN proxies even though no boundary
+    // edge crosses them. De-dupe against wire-fed proxies so a pin that's already exposed via a
+    // real edge isn't doubled. `edgeId: null` marks the entry pending — editor finalises it on the
+    // first connect-to-macro-pin while collapsed.
+    const wiredMemberPins = new Set(proxies.filter((p) => p.direction === 'in').map((p) => String(p.memberPin)));
+    for (const lift of opts.liftPins ?? []) {
+        if (wiredMemberPins.has(String(lift.pin)))
+            continue;
+        wiredMemberPins.add(String(lift.pin));
+        const pinId = mint.pin();
+        const info = pinInfo(lift.node, lift.pin);
+        pins.push({
+            id: pinId,
+            kind: 'data',
+            direction: 'in',
+            type: info.type,
+            multiple: false,
+            ...(info.label !== undefined ? { label: info.label } : {}),
+        });
+        proxyMap.push({
+            edgeId: null,
+            macroPin: pinId,
+            direction: 'in',
+            externalNode: '', // filled in when user wires it
+            externalPin: '',
+            memberNode: lift.node,
+            memberPin: lift.pin,
+        });
+    }
+    return { pins, disconnect, connect, proxyMap };
+}
+/** Find every widget-bound IN-pin on `member` that isn't already fed by an incoming edge — the
+ *  set that needs to be LIFTED onto a macro on collapse so the widget surface survives. Pure;
+ *  pass `hasIncomingEdge(pinId)` so the caller drives boundary-awareness from whatever index it
+ *  has (graph.edges() pass, edge-by-node cache, anything cheap). Skips button widgets (no pin
+ *  binding) and OUT-pins (display widgets — macro pins lift inputs only). */
+export function disconnectedWidgetBoundPins(member, hasIncomingEdge) {
+    const widgets = member.widgets;
+    if (!widgets || widgets.length === 0)
+        return [];
+    const out = [];
+    for (const w of widgets) {
+        const key = widgetBindKey(w);
+        if (key === undefined)
+            continue;
+        const pin = member.pins.find((p) => p.label === key || String(p.id) === key);
+        if (!pin || pin.direction !== 'in')
+            continue;
+        if (hasIncomingEdge(pin.id))
+            continue;
+        out.push({ node: member.id, pin: pin.id });
+    }
+    return out;
+}
+/** Plan an expand: drop every macro proxy edge and rebuild the original external↔member edges from
+ *  the stored proxy map. Pure — caller applies it and strips the macro's proxy pins. */
+export function planMacroExpand(proxyMap, mint) {
+    const disconnect = [];
+    const connect = [];
+    for (const r of proxyMap) {
+        // Lifted-but-never-wired pin (edgeId stayed null): no external edge to drop, no member edge
+        // to restore — the macro pin just disappears with the rest on expand. Skip entirely.
+        if (r.edgeId === null)
+            continue;
+        disconnect.push(r.edgeId);
+        const ext = { node: r.externalNode, pin: r.externalPin };
+        const mem = { node: r.memberNode, pin: r.memberPin };
+        connect.push(r.direction === 'in'
+            ? { id: mint.edge(), from: ext, to: mem }
+            : { id: mint.edge(), from: mem, to: ext });
+    }
+    return { disconnect, connect };
+}
+/** Partition edges relative to a member set — the heart of macro pin-proxying. An edge with exactly
+ *  one endpoint inside the group crosses the boundary (input if it enters, output if it leaves); both
+ *  inside is internal; both outside is ignored. Order within each bucket follows input order. */
+export function boundaryEdges(members, edges) {
+    const inputs = [];
+    const outputs = [];
+    const internal = [];
+    for (const e of edges) {
+        const fromIn = members.has(e.from.node);
+        const toIn = members.has(e.to.node);
+        if (fromIn && toIn)
+            internal.push(e);
+        else if (toIn)
+            inputs.push(e);
+        else if (fromIn)
+            outputs.push(e);
+    }
+    return { inputs, outputs, internal };
+}
+/** Flatten collapsed macros into their primitives for a host interpreter: drop every `Macro` node and
+ *  remap any edge endpoint that lands on a macro proxy pin back to the member pin it bridges (via the
+ *  macro's `state.proxyMap`). Recurses through nested macros (a member pin may itself be an inner
+ *  macro's proxy pin). Pure — never mutates the inputs. Internal member↔member edges pass through
+ *  untouched; the macro grouping becomes purely visual. */
+export function flattenMacroProxies(nodes, edges) {
+    const macroProxy = new Map();
+    for (const n of nodes) {
+        if (n.type !== MACRO_TYPE)
+            continue;
+        const m = new Map();
+        for (const r of (n.state['proxyMap'] ?? [])) {
+            m.set(String(r.macroPin), { node: r.memberNode, pin: r.memberPin });
+        }
+        macroProxy.set(String(n.id), m);
+    }
+    const flatten = (node, pin) => {
+        let n = node, p = pin, guard = 0;
+        while (guard++ < 64) {
+            const next = macroProxy.get(String(n))?.get(String(p));
+            if (!next)
+                break;
+            n = next.node;
+            p = next.pin;
+        }
+        return { node: n, pin: p };
+    };
+    const outNodes = nodes.filter((n) => n.type !== MACRO_TYPE);
+    const outEdges = [];
+    for (const e of edges) {
+        const from = flatten(e.from.node, e.from.pin);
+        const to = flatten(e.to.node, e.to.pin);
+        // An endpoint still on a macro means a missing proxy mapping — drop the dangling edge.
+        if (macroProxy.has(String(from.node)) || macroProxy.has(String(to.node)))
+            continue;
+        outEdges.push({ id: e.id, from, to });
+    }
+    return { nodes: outNodes, edges: outEdges };
+}
+//# sourceMappingURL=macro.js.map