@xenolithengine/graph-plugin-runtime 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,60 @@
+# @xenolithengine/graph-plugin-runtime
+
+[![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)
+
+Blueprint-style node runtime for XenolithGraph: typed exec/data primitives + a headless interpreter that runs a graph as a simulation. Installs as an editor plugin.
+
+> **Experimental** — runtime APIs (`Runtime`, `codegen`, `RtGraph`) may still evolve before v1.0. The editor-plugin surface (`runtimePlugin`, schemas) tracks the v0.7 BETA freeze.
+
+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-plugin-runtime
+```
+
+## Usage
+
+Register primitives + pin types into an editor:
+
+```ts
+import { XenolithEditor } from '@xenolithengine/graph-editor'
+import { runtimePlugin, attachRuntimeBridge } from '@xenolithengine/graph-plugin-runtime'
+
+const editor = await XenolithEditor.init('#graph')
+editor.use(runtimePlugin)
+attachRuntimeBridge(editor)        // drives the live graph + mirrors outputs into widgets
+```
+
+Headless VM (no editor):
+
+```ts
+import { Runtime, BUILTIN_PRIMITIVES, type RtGraph } from '@xenolithengine/graph-plugin-runtime'
+
+const rt = new Runtime(BUILTIN_PRIMITIVES)
+rt.setVar('x', 3)
+rt.tick(myRtGraph)
+console.log(rt.getVar('result'))
+```
+
+## What's exported
+
+- `runtimePlugin` — install into an editor with `editor.use(runtimePlugin)`
+- `attachRuntimeBridge(editor)` — drives the live graph from the editor and mirrors Output values to widgets
+- `Runtime` — headless interpreter (`tick`, `getVar`, `setVar`, `onAfterTick`)
+- `codegen(graph, defs)` — emits a compiled JS evaluator from an `RtGraph`
+- `Allocate`, `mandelbrotPixelGraph`, `mandelbrotPixelReference` — reference graphs / nodes for benchmarks
+- `BUILTIN_PRIMITIVES`, `COLLECTION_PRIMITIVES`, `domainNodes`
+- Schemas: `PIN_TYPES`, `PRIMITIVE_SCHEMAS`, `PRIMITIVE_CATEGORY_COLORS`, `PRIMITIVE_ICONS`
+- Schema-sync helpers: `pinsFromSchemaFields`, `widgetsFromSchemaFields`, `schemaPinTypeFor`
+- Value coercion: `asNumber`, `asBool`, `asArray`
+- Types: `NodeDef`, `RtNode`, `RtPin`, `RtEdge`, `RtGraph`, `PureIO`, `ExecIO`, `VmValue`
+
+## Docs
+
+- [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/editor/output-widget.d.ts

@@ -0,0 +1,3 @@
+import type { CanvasWidgetController } from '@xenolithengine/graph-editor';
+export declare const outputWidget: CanvasWidgetController;
+//# sourceMappingURL=output-widget.d.ts.map

package/dist/editor/output-widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-widget.d.ts","sourceRoot":"","sources":["../../src/editor/output-widget.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AAW1E,eAAO,MAAM,YAAY,EAAE,sBAsB1B,CAAA"}

package/dist/editor/output-widget.js

@@ -0,0 +1,43 @@
+// Canvas-widget renderer for the `Output` primitive — draws whatever value the Output node received
+// straight into the node. Generic: supports number / string / bool / array / object. Registered by
+// `runtimePlugin.install` so any host that uses the plugin gets Output rendering out of the box.
+function format(value) {
+    if (value === undefined || value === null)
+        return '—';
+    if (typeof value === 'number')
+        return Number.isInteger(value) ? String(value) : value.toFixed(2);
+    if (typeof value === 'string' || typeof value === 'boolean')
+        return String(value);
+    if (Array.isArray(value))
+        return `${value.length} item${value.length === 1 ? '' : 's'}`;
+    if (typeof value === 'object')
+        return `${Object.keys(value).length} fields`;
+    return String(value);
+}
+export const outputWidget = {
+    draw(ctx, { value, width, height, accent, muted }) {
+        const text = format(value);
+        // Pick the largest font size from a fixed ladder that still fits the rect width — prevents the
+        // big-number-clipped-on-the-left bug where "0.45" rendered as ".45" because right-aligned text
+        // overflowed past the widget's left edge.
+        const sizes = [24, 20, 17, 14, 12, 10];
+        ctx.textBaseline = 'middle';
+        ctx.textAlign = 'right';
+        let size = sizes[sizes.length - 1];
+        for (const s of sizes) {
+            ctx.font = `${s}px Inter`;
+            if (ctx.measureText(text).width <= width - 2) {
+                size = s;
+                break;
+            }
+        }
+        ctx.font = `${size}px Inter`;
+        ctx.fillStyle = accent;
+        ctx.fillText(text, width, height / 2);
+        ctx.fillStyle = muted;
+        ctx.font = '9px Inter';
+        ctx.textAlign = 'left';
+        ctx.fillText('output', 0, height - 4);
+    },
+};
+//# sourceMappingURL=output-widget.js.map

package/dist/editor/output-widget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-widget.js","sourceRoot":"","sources":["../../src/editor/output-widget.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,mGAAmG;AACnG,iGAAiG;AAIjG,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,GAAG,CAAA;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;IAChG,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;IACjF,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,KAAK,CAAC,MAAM,QAAQ,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;IACvF,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC,MAAM,SAAS,CAAA;IACrF,OAAO,MAAM,CAAC,KAAK,CAAC,CAAA;AACtB,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAA2B;IAClD,IAAI,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE;QAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;QAC1B,+FAA+F;QAC/F,+FAA+F;QAC/F,0CAA0C;QAC1C,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAA;QACtC,GAAG,CAAC,YAAY,GAAG,QAAQ,CAAA;QAC3B,GAAG,CAAC,SAAS,GAAG,OAAO,CAAA;QACvB,IAAI,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAE,CAAA;QACnC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,UAAU,CAAA;YACzB,IAAI,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBAAC,IAAI,GAAG,CAAC,CAAC;gBAAC,MAAK;YAAC,CAAC;QACnE,CAAC;QACD,GAAG,CAAC,IAAI,GAAG,GAAG,IAAI,UAAU,CAAA;QAC5B,GAAG,CAAC,SAAS,GAAG,MAAM,CAAA;QACtB,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,CAAA;QACrC,GAAG,CAAC,SAAS,GAAG,KAAK,CAAA;QACrB,GAAG,CAAC,IAAI,GAAG,WAAW,CAAA;QACtB,GAAG,CAAC,SAAS,GAAG,MAAM,CAAA;QACtB,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,CAAA;IACvC,CAAC;CACF,CAAA"}

package/dist/editor/plugin.d.ts

@@ -0,0 +1,3 @@
+import type { XenolithPlugin } from '@xenolithengine/graph-editor';
+export declare const runtimePlugin: XenolithPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/editor/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/editor/plugin.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,8BAA8B,CAAA;AA8CjF,eAAO,MAAM,aAAa,EAAE,cAkD3B,CAAA"}

package/dist/editor/plugin.js

@@ -0,0 +1,115 @@
+// The XenolithGraph plugin: installs the runtime's pin types + primitive node schemas into the
+// editor (so the COMPUTE graph is visible/editable and the primitives show in the Tab palette).
+// Type-only imports from core/editor → erased at runtime, so the headless VM stays import-free.
+//
+// This is the registration layer only — driving the live graph (reading editor.graph each tick and
+// running the VM) is the host's job, kept separate so the same VM can run headlessly.
+import { PIN_TYPES, PRIMITIVE_SCHEMAS } from './schemas.js';
+import { outputWidget } from './output-widget.js';
+import { structWidget } from './struct-widget.js';
+import { pinsFromSchemaFields, widgetsFromSchemaFields } from './schema-sync.js';
+/** Find the Struct's `schema` IN-pin id (looks for label='schema', falls back to id ending ':schema'). */
+function findSchemaPinId(node) {
+    for (const p of node.pins) {
+        if (p.kind === 'data' && p.direction === 'in' && (p.label === 'schema' || String(p.id) === 'schema' || String(p.id).endsWith(':schema'))) {
+            return String(p.id);
+        }
+    }
+    return null;
+}
+/** Re-sync a Struct's pins from the Schema currently wired into its `schema` pin. No-op if the
+ *  Struct has no schema pin, or no edge into it, or the source isn't a Schema-typed node. */
+function syncStructFromSchema(ctx, structId) {
+    const struct = ctx.graph.getNode(structId);
+    if (!struct || struct.type !== 'Struct')
+        return;
+    const schemaPinId = findSchemaPinId(struct);
+    if (!schemaPinId)
+        return;
+    let sourceSchema = null;
+    for (const e of ctx.graph.edges()) {
+        if (String(e.to.node) === String(structId) && String(e.to.pin) === schemaPinId) {
+            const src = ctx.graph.getNode(e.from.node);
+            if (src && src.type === 'Schema') {
+                sourceSchema = src;
+                break;
+            }
+        }
+    }
+    const fields = sourceSchema?.state['fields'] ?? {};
+    const extras = sourceSchema?.state['extraPins'] ?? [];
+    ctx.setNodePins(structId, pinsFromSchemaFields(struct.pins, fields, extras));
+    // Preserve any HAND-AUTHORED widgets that aren't `field:*` (none today, but the API allows it);
+    // replace the schema-derived widget block wholesale on every sync.
+    const handAuthored = (struct.widgets ?? []).filter((w) => !String(w.id).startsWith('field:'));
+    ctx.setNodeWidgets(structId, [...handAuthored, ...widgetsFromSchemaFields(fields)]);
+    // Seed `state[<field>]` with each field's default value so the pinKey-bound widget shows
+    // something and the Struct evaluator's fallback returns that value (not undefined) on the first
+    // tick before any wire delivers. Skip a field whose state is already set (user already typed).
+    for (const [key, value] of Object.entries(fields)) {
+        if (struct.state[key] === undefined)
+            ctx.setWidgetValue(structId, `field:${key}`, value, { ephemeral: true });
+    }
+}
+export const runtimePlugin = {
+    name: 'runtime',
+    install(ctx) {
+        for (const t of PIN_TYPES)
+            ctx.types.register(t);
+        for (const s of PRIMITIVE_SCHEMAS)
+            ctx.registry.register(s);
+        ctx.registerWidget('output', outputWidget);
+        ctx.registerWidget('struct', structWidget);
+        // Schema → Struct pin sync: when an edge enters a Struct's `schema` pin, synthesize one in-pin
+        // per field of the source Schema. On disconnect, strip the synthesized field pins.
+        const offConn = ctx.on('edge:connected', ({ edge }) => {
+            const target = ctx.graph.getNode(edge.to.node);
+            if (target?.type === 'Struct')
+                syncStructFromSchema(ctx, edge.to.node);
+        });
+        const offDisc = ctx.on('edge:disconnected', () => {
+            // We don't know which endpoint vanished without an edge record; rescan all Structs and
+            // re-sync. Cheap on graphs of any plausible size (one setNodePins per Struct, no-op when
+            // pins didn't change).
+            for (const n of ctx.graph.nodes()) {
+                if (n.type === 'Struct')
+                    syncStructFromSchema(ctx, n.id);
+            }
+        });
+        // `loadJSON` adds edges via a fast path that doesn't fire edge:connected, so on graph load
+        // we explicitly rescan every Struct with a wired Schema and sync once.
+        const offLoaded = ctx.on('graph:loaded', () => {
+            for (const n of ctx.graph.nodes()) {
+                if (n.type === 'Struct')
+                    syncStructFromSchema(ctx, n.id);
+            }
+        });
+        // A Schema's `fields` widget changing also needs a re-sync on every Struct wired to it.
+        const offWidget = ctx.on('widget:changed', ({ nodeId, widgetId }) => {
+            const n = ctx.graph.getNode(nodeId);
+            if (!n || n.type !== 'Schema' || widgetId !== 'fields')
+                return;
+            for (const struct of ctx.graph.nodes()) {
+                if (struct.type !== 'Struct')
+                    continue;
+                for (const e of ctx.graph.edges()) {
+                    if (String(e.from.node) === String(nodeId) && String(e.to.node) === String(struct.id)) {
+                        syncStructFromSchema(ctx, struct.id);
+                        break;
+                    }
+                }
+            }
+        });
+        return () => {
+            offConn();
+            offDisc();
+            offLoaded();
+            offWidget();
+            for (const s of PRIMITIVE_SCHEMAS)
+                ctx.registry.unregister(s.type);
+            for (const t of PIN_TYPES)
+                ctx.types.unregister(t.id);
+        };
+    },
+};
+//# sourceMappingURL=plugin.js.map

package/dist/editor/plugin.js.map

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

package/dist/editor/runtime-bridge.d.ts

@@ -0,0 +1,6 @@
+import type { XenolithEditor } from '@xenolithengine/graph-editor';
+import type { Runtime } from '../vm/interpreter.js';
+/** Wire automatic post-tick behaviour into a Runtime: mirror Output VM vars into widget state.
+ *  Returns a disposer that removes the listener (call on host teardown / engine switch). */
+export declare function attachRuntimeBridge(editor: XenolithEditor, rt: Runtime): () => void;
+//# sourceMappingURL=runtime-bridge.d.ts.map

package/dist/editor/runtime-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-bridge.d.ts","sourceRoot":"","sources":["../../src/editor/runtime-bridge.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAGnD;4FAC4F;AAC5F,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,EAAE,OAAO,GAAG,MAAM,IAAI,CASnF"}

package/dist/editor/runtime-bridge.js

@@ -0,0 +1,24 @@
+// Editor ↔ Runtime bridge. The bits a host shouldn't have to re-implement:
+//   - Output node value mirroring: every `Output` writes its current value into VM var
+//     `output:<nodeId>`; the bridge copies that into the node's `state.value` so the in-node
+//     `output` widget shows the live value. WORKAROUND until core ships
+//     `graphSnapshot({ shareState: true })` so Output can mutate its own state in-place.
+//
+// Hosts call `attachRuntimeBridge(editor, rt)` ONCE after creating the Runtime. From then on,
+// every `rt.tick(...)` automatically refreshes Output widgets. No per-host loop.
+import { OUTPUT_VAR_PREFIX } from '../vm/collection.js';
+/** Wire automatic post-tick behaviour into a Runtime: mirror Output VM vars into widget state.
+ *  Returns a disposer that removes the listener (call on host teardown / engine switch). */
+export function attachRuntimeBridge(editor, rt) {
+    return rt.onAfterTick(() => {
+        for (const n of editor.graph.nodes()) {
+            if (n.type !== 'Output')
+                continue;
+            const v = rt.getVar(`${OUTPUT_VAR_PREFIX}${String(n.id)}`);
+            if (v === undefined)
+                continue;
+            editor.setWidgetValue(n.id, 'value', v, { ephemeral: true });
+        }
+    });
+}
+//# sourceMappingURL=runtime-bridge.js.map

package/dist/editor/runtime-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-bridge.js","sourceRoot":"","sources":["../../src/editor/runtime-bridge.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,uFAAuF;AACvF,6FAA6F;AAC7F,wEAAwE;AACxE,yFAAyF;AACzF,EAAE;AACF,8FAA8F;AAC9F,iFAAiF;AAIjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAEvD;4FAC4F;AAC5F,MAAM,UAAU,mBAAmB,CAAC,MAAsB,EAAE,EAAW;IACrE,OAAO,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;QACzB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;YACrC,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ;gBAAE,SAAQ;YACjC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,iBAAiB,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAA;YAC1D,IAAI,CAAC,KAAK,SAAS;gBAAE,SAAQ;YAC7B,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC9D,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/editor/schema-sync.d.ts

@@ -0,0 +1,28 @@
+import type { Pin, WidgetSpec } from '@xenolithengine/graph-core';
+/** Declaration for a non-field pin synthesized from a Schema (multi-inputs, named outputs, etc.).
+ *  Lives in `Schema.state.extraPins` so the graph author can express things that don't fit the
+ *  flat `state.fields = {key: defaultValue}` model — e.g. an Agent's `subscribe` multi pin. */
+export interface SchemaExtraPin {
+    label: string;
+    direction: 'in' | 'out';
+    type: string;
+    multiple?: boolean;
+}
+/** Map a default value's runtime type to a pin type. `null`/`undefined` → `'any'`. */
+export declare function schemaPinTypeFor(defaultValue: unknown): string;
+/** Replace any prior `field:*` AND `extra:*` pins on the node with a fresh set derived from the
+ *  Schema's `state.fields` (one IN-pin per key) and `state.extraPins` (verbatim declarations).
+ *  Non-synthesized pins (the schema in-pin, the self out-pin) are kept in place at the front of
+ *  the result so the binding pin survives a re-sync. Order: kept-base + field:* + extra:*. */
+export declare function pinsFromSchemaFields(current: ReadonlyArray<Pin>, fields: Readonly<Record<string, unknown>>, extras?: ReadonlyArray<SchemaExtraPin>): Pin[];
+/** Synthesize one WidgetSpec per field on a Schema. `key = fieldName` so the editor's implicit
+ *  pinKey-binding kicks in (widget hides when its matching pin is wired, shows otherwise). Label
+ *  is empty — the pin row already shows the field name on the left, a second copy inside the
+ *  chip would just duplicate it.
+ *  - string  → text (editable)
+ *  - number  → number (editable)
+ *  - boolean → toggle
+ *  - array/object/null/undefined → DISABLED text (read-only display; no editable widget exists
+ *    for these types, but we still render the current value so the user sees what's in state). */
+export declare function widgetsFromSchemaFields(fields: Readonly<Record<string, unknown>>): WidgetSpec[];
+//# sourceMappingURL=schema-sync.d.ts.map

package/dist/editor/schema-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-sync.d.ts","sourceRoot":"","sources":["../../src/editor/schema-sync.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,GAAG,EAAS,UAAU,EAAE,MAAM,4BAA4B,CAAA;AAExE;;+FAE+F;AAC/F,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,IAAI,GAAG,KAAK,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,OAAO,GAAG,MAAM,CAQ9D;AAED;;;8FAG8F;AAC9F,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,EAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EACzC,MAAM,GAAE,aAAa,CAAC,cAAc,CAAM,GACzC,GAAG,EAAE,CAsBP;AAED;;;;;;;;kGAQkG;AAClG,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,UAAU,EAAE,CAS/F"}

package/dist/editor/schema-sync.js

@@ -0,0 +1,70 @@
+// Schema → Struct pin synthesis. A connected Schema's `state.fields` object (`{name: default}`) is
+// turned into one data-in Pin per key on the Struct. Pure helpers — the plugin's edge listener
+// calls them and forwards the result to `ctx.setNodePins`. Pin id convention: `field:<key>` so the
+// Struct V3 evaluator (which derives field name from id suffix after `:`) sees the right field.
+/** Map a default value's runtime type to a pin type. `null`/`undefined` → `'any'`. */
+export function schemaPinTypeFor(defaultValue) {
+    if (defaultValue === null || defaultValue === undefined)
+        return 'any';
+    if (typeof defaultValue === 'string')
+        return 'string';
+    if (typeof defaultValue === 'number')
+        return 'scalar';
+    if (typeof defaultValue === 'boolean')
+        return 'bool';
+    if (Array.isArray(defaultValue))
+        return 'array';
+    if (typeof defaultValue === 'object')
+        return 'object';
+    return 'any';
+}
+/** Replace any prior `field:*` AND `extra:*` pins on the node with a fresh set derived from the
+ *  Schema's `state.fields` (one IN-pin per key) and `state.extraPins` (verbatim declarations).
+ *  Non-synthesized pins (the schema in-pin, the self out-pin) are kept in place at the front of
+ *  the result so the binding pin survives a re-sync. Order: kept-base + field:* + extra:*. */
+export function pinsFromSchemaFields(current, fields, extras = []) {
+    const kept = current.filter((p) => {
+        const id = String(p.id);
+        return !id.startsWith('field:') && !id.startsWith('extra:');
+    });
+    const fieldPins = Object.keys(fields).map((key) => ({
+        id: (`field:${key}`),
+        kind: 'data',
+        direction: 'in',
+        type: schemaPinTypeFor(fields[key]),
+        multiple: false,
+        label: key,
+    }));
+    const extraPins = extras.map((spec) => ({
+        id: (`extra:${spec.label}`),
+        kind: 'data',
+        direction: spec.direction,
+        type: spec.type,
+        multiple: spec.multiple ?? false,
+        label: spec.label,
+    }));
+    return [...kept, ...fieldPins, ...extraPins];
+}
+/** Synthesize one WidgetSpec per field on a Schema. `key = fieldName` so the editor's implicit
+ *  pinKey-binding kicks in (widget hides when its matching pin is wired, shows otherwise). Label
+ *  is empty — the pin row already shows the field name on the left, a second copy inside the
+ *  chip would just duplicate it.
+ *  - string  → text (editable)
+ *  - number  → number (editable)
+ *  - boolean → toggle
+ *  - array/object/null/undefined → DISABLED text (read-only display; no editable widget exists
+ *    for these types, but we still render the current value so the user sees what's in state). */
+export function widgetsFromSchemaFields(fields) {
+    return Object.keys(fields).map((key) => {
+        const v = fields[key];
+        const id = `field:${key}`;
+        if (typeof v === 'string')
+            return { id, type: 'text', key, label: '' };
+        if (typeof v === 'number')
+            return { id, type: 'number', key, label: '' };
+        if (typeof v === 'boolean')
+            return { id, type: 'toggle', key, label: '' };
+        return { id, type: 'text', key, label: '', disabled: true };
+    });
+}
+//# sourceMappingURL=schema-sync.js.map

package/dist/editor/schema-sync.js.map

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

package/dist/editor/schemas.d.ts

@@ -0,0 +1,28 @@
+import type { NodeSchema, TypeDescriptor } from '@xenolithengine/graph-core';
+export declare const PIN_TYPES: TypeDescriptor[];
+export declare const PRIMITIVE_SCHEMAS: NodeSchema[];
+/** Header glyph icon per primitive type (names from render-pixi's built-in Feather set). Hosts can
+ *  apply these to node `glyph` so the generic nodes are visually distinguishable at a glance. */
+export declare const PRIMITIVE_ICONS: Record<string, string>;
+/** Colours for the primitive categories — declared in the runtime preset's `categories` palette. */
+export declare const PRIMITIVE_CATEGORY_COLORS: {
+    readonly flow: {
+        readonly color: "#E8E8E8";
+    };
+    readonly state: {
+        readonly color: "#5B9DFF";
+    };
+    readonly math: {
+        readonly color: "#4FC08D";
+    };
+    readonly array: {
+        readonly color: "#3FB6FF";
+    };
+    readonly domain: {
+        readonly color: "#FFB020";
+    };
+    readonly io: {
+        readonly color: "#E6C87A";
+    };
+};
+//# sourceMappingURL=schemas.d.ts.map

package/dist/editor/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/editor/schemas.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAa,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAEvF,eAAO,MAAM,SAAS,EAAE,cAAc,EAOrC,CAAA;AAUD,eAAO,MAAM,iBAAiB,EAAE,UAAU,EAuJzC,CAAA;AAED;iGACiG;AACjG,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmBlD,CAAA;AAGD,oGAAoG;AACpG,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;CAO5B,CAAA"}