@bian-womp/spark-graph 0.3.88 → 0.3.90

package/lib/src/core/type-utils.js.map

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

package/lib/src/core/types.d.ts

@@ -0,0 +1,95 @@
+import type { DataTypeId, NodeTypeId, HandleId, InputHandleDescriptor, NodeCategoryId, ResolvedHandles, ExecutionPolicy, LogLevel } from "@bian-womp/spark-protocol";
+export interface DataTypeDescriptor<T = unknown> {
+    id: DataTypeId;
+    displayName?: string;
+    validate(value: T): boolean;
+    helpers?: Record<string, unknown>;
+    bakeTarget?: {
+        nodeTypeId: NodeTypeId;
+        inputHandle: HandleId;
+    };
+}
+export type InvalidateReason = "input-changed" | "dependency-changed" | "manual" | "disposed";
+export type NodeDisposeReason = "node-removed" | "runtime-dispose" | "runtime-rebuild" | "adapter-dispose";
+export interface NodeContext<State> {
+    state: State;
+    setState(next: Partial<State>): void;
+    disposeReason?: NodeDisposeReason;
+}
+export interface ExecutionContext<State> extends NodeContext<State> {
+    nodeId: string;
+    environment: Record<string, unknown>;
+    customNodeData?: Record<string, unknown>;
+    runId: string;
+    abortSignal: AbortSignal;
+    emit: (handle: HandleId, value: unknown) => void;
+    invalidateDownstream: () => void;
+    execute: (opts?: {
+        propagate?: boolean;
+        resolve?: () => void;
+        reason?: string;
+    }) => void;
+    getInput: (handle: HandleId) => unknown;
+    reportProgress?: (value: number) => void;
+    setCustomData?: (data: Record<string, unknown>) => void;
+    log: (level: LogLevel, message: string, context?: Record<string, unknown>) => void;
+}
+/**
+ * Extract State type from ExecutionContext<State>
+ */
+export type ExtractStateFromContext<T> = T extends ExecutionContext<infer S> ? S : never;
+/**
+ * Extract State type from impl function signature
+ */
+export type ExtractStateFromImpl<Impl> = Impl extends (inputs: any, ctx: ExecutionContext<infer State>) => any ? State : never;
+/**
+ * Extract Inputs type from impl function signature
+ */
+export type ExtractInputsFromImpl<Impl> = Impl extends (inputs: infer I, ctx: any) => any ? I : never;
+export interface RuntimeNodeStats {
+    runs: number;
+    active: number;
+    queued: number;
+    lastStartAt?: number;
+    lastEndAt?: number;
+    lastDurationMs?: number;
+    progress: number;
+    lastError?: unknown;
+}
+export interface RuntimeEdgeStats {
+    runs: number;
+    inFlight: boolean;
+    lastStartAt?: number;
+    lastEndAt?: number;
+    lastDurationMs?: number;
+    progress: number;
+    lastError?: unknown;
+}
+export type TypedValue<T = unknown> = {
+    __spark_type: DataTypeId;
+    __spark_value: T;
+};
+type InferState<Impl, State> = ExtractStateFromImpl<Impl> extends never ? State : ExtractStateFromImpl<Impl>;
+export interface NodeTypeDescriptor<I extends Record<string, InputHandleDescriptor> = Record<string, InputHandleDescriptor>, O extends Record<string, DataTypeId | DataTypeId[]> = Record<string, DataTypeId | DataTypeId[]>, State = unknown, Impl extends (inputs: any, ctx: ExecutionContext<any>) => any = (inputs: Record<string, unknown>, ctx: ExecutionContext<State>) => void | Record<string, unknown> | Promise<void | Record<string, unknown>>> {
+    id: NodeTypeId;
+    categoryId: NodeCategoryId;
+    displayName?: string;
+    inputs: I;
+    outputs: O;
+    impl: Impl;
+    policy?: Partial<ExecutionPolicy>;
+    logLevel?: LogLevel;
+    resolveHandles?: (ctx: {
+        nodeId: string;
+        environment: Record<string, unknown>;
+        params?: Record<string, unknown>;
+        inputs?: Record<string, unknown>;
+    }) => Partial<ResolvedHandles> | Promise<Partial<ResolvedHandles>>;
+    inputDefaults?: Record<string, unknown>;
+    lifecycle?: {
+        prepare?: (params: Record<string, unknown>, ctx: ExecutionContext<InferState<Impl, State>>) => void | Promise<void>;
+        dispose?: (ctx: NodeContext<InferState<Impl, State>>) => void;
+    };
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/lib/src/core/types.d.ts.map

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

package/lib/src/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/src/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/types.ts"],"names":[],"mappings":""}

package/lib/src/examples/arrays.d.ts

@@ -0,0 +1,5 @@
+import type { GraphDefinition } from "@bian-womp/spark-protocol";
+export declare function createArrayComposeDecomposeDef(): GraphDefinition;
+export declare function createArrayComposeDecomposeRegistry(): import("..").Registry;
+export declare function main(): Promise<void>;
+//# sourceMappingURL=arrays.d.ts.map

package/lib/src/examples/arrays.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrays.d.ts","sourceRoot":"","sources":["../../../src/examples/arrays.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAKjE,wBAAgB,8BAA8B,IAAI,eAAe,CAchE;AAED,wBAAgB,mCAAmC,0BAElD;AAED,wBAAsB,IAAI,kBA6CzB"}

package/lib/src/examples/arrays.js

@@ -0,0 +1,49 @@
+import { setupBasicGraphRegistry, createRuntime } from "../misc/base";
+import { LocalEngine } from "../runtime/LocalEngine";
+import { installLogging } from "./shared";
+export function createArrayComposeDecomposeDef() {
+    return {
+        nodes: [
+            { nodeId: "compose", typeId: "base.array.compose" },
+            { nodeId: "decompose", typeId: "base.array.decompose" },
+        ],
+        edges: [
+            {
+                id: "e_compose_items_to_decompose_items",
+                source: { nodeId: "compose", handle: "Items" },
+                target: { nodeId: "decompose", handle: "Items" },
+            },
+        ],
+    };
+}
+export function createArrayComposeDecomposeRegistry() {
+    return setupBasicGraphRegistry();
+}
+export async function main() {
+    console.log("Array compose/decompose example: dynamic handle resolution");
+    console.log("- compose(base.array.compose) -> decompose(base.array.decompose)");
+    console.log("- Setting compose.Length will dynamically add inputs compose.Item0..ItemN and drive decompose.Item0..ItemN outputs via Items array");
+    const runtime = createRuntime(createArrayComposeDecomposeRegistry(), createArrayComposeDecomposeDef());
+    const engine = new LocalEngine(runtime, "auto");
+    installLogging(engine);
+    engine.launch();
+    // Compose 3 items and observe decompose dynamic outputs
+    engine.setInputs("compose", {
+        Length: 3,
+        Item0: "alpha",
+        Item1: "beta",
+        Item2: "gamma",
+    });
+    await engine.whenIdle();
+    console.log("d.Item0..2 =>", engine.getOutput("decompose", "Item0"), engine.getOutput("decompose", "Item1"), engine.getOutput("decompose", "Item2"));
+    // Grow to 5 items; dynamic inputs/outputs should expand automatically
+    engine.setInputs("compose", { Length: 5, Item3: "delta", Item4: "epsilon" });
+    await engine.whenIdle();
+    console.log("d.Item0..4 =>", engine.getOutput("decompose", "Item0"), engine.getOutput("decompose", "Item1"), engine.getOutput("decompose", "Item2"), engine.getOutput("decompose", "Item3"), engine.getOutput("decompose", "Item4"));
+    // Shrink to 2 items; dynamic outputs should shrink
+    engine.setInputs("compose", { Length: 2 });
+    await engine.whenIdle();
+    console.log("d.Item0..1 =>", engine.getOutput("decompose", "Item0"), engine.getOutput("decompose", "Item1"));
+    engine.dispose();
+}
+//# sourceMappingURL=arrays.js.map

package/lib/src/examples/arrays.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrays.js","sourceRoot":"","sources":["../../../src/examples/arrays.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,UAAU,8BAA8B;IAC5C,OAAO;QACL,KAAK,EAAE;YACL,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,oBAAoB,EAAE;YACnD,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,sBAAsB,EAAE;SACxD;QACD,KAAK,EAAE;YACL;gBACE,EAAE,EAAE,oCAAoC;gBACxC,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE;gBAC9C,MAAM,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE;aACjD;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mCAAmC;IACjD,OAAO,uBAAuB,EAAE,CAAC;AACnC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,OAAO,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC;IAC1E,OAAO,CAAC,GAAG,CAAC,kEAAkE,CAAC,CAAC;IAChF,OAAO,CAAC,GAAG,CACT,oIAAoI,CACrI,CAAC;IAEF,MAAM,OAAO,GAAG,aAAa,CAAC,mCAAmC,EAAE,EAAE,8BAA8B,EAAE,CAAC,CAAC;IACvG,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAChD,cAAc,CAAC,MAAM,CAAC,CAAC;IACvB,MAAM,CAAC,MAAM,EAAE,CAAC;IAEhB,wDAAwD;IACxD,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE;QAC1B,MAAM,EAAE,CAAC;QACT,KAAK,EAAE,OAAO;QACd,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,OAAO;KACf,CAAC,CAAC;IACH,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;IACxB,OAAO,CAAC,GAAG,CACT,eAAe,EACf,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,EACtC,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,EACtC,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CACvC,CAAC;IAEF,sEAAsE;IACtE,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC7E,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;IACxB,OAAO,CAAC,GAAG,CACT,eAAe,EACf,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,EACtC,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,EACtC,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,EACtC,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,EACtC,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CACvC,CAAC;IAEF,mDAAmD;IACnD,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IAC3C,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;IACxB,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IAE7G,MAAM,CAAC,OAAO,EAAE,CAAC;AACnB,CAAC"}

package/lib/src/examples/async.d.ts

@@ -0,0 +1,5 @@
+import type { GraphDefinition } from "@bian-womp/spark-protocol";
+export declare function createAsyncGraphDef(): GraphDefinition;
+export declare function createAsyncGraphRegistry(id?: string): import("..").Registry;
+export declare function main(): Promise<void>;
+//# sourceMappingURL=async.d.ts.map

package/lib/src/examples/async.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.d.ts","sourceRoot":"","sources":["../../../src/examples/async.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAKjE,wBAAgB,mBAAmB,oBAoDlC;AAED,wBAAgB,wBAAwB,CAAC,EAAE,CAAC,EAAE,MAAM,yBAInD;AAED,wBAAsB,IAAI,kBAgCzB"}

package/lib/src/examples/async.js

@@ -0,0 +1,91 @@
+import { setupBasicGraphRegistry, registerDelayNode, createRuntime, BaseMathOperation } from "../misc/base";
+import { LocalEngine } from "../runtime/LocalEngine";
+import { installLogging } from "./shared";
+export function createAsyncGraphDef() {
+    const def = {
+        nodes: [
+            {
+                nodeId: "n1",
+                typeId: "base.math",
+            },
+            {
+                nodeId: "n2",
+                typeId: "async.delay",
+                params: { policy: { asyncConcurrency: "queue", maxQueue: 4 } },
+            },
+            {
+                nodeId: "n3",
+                typeId: "base.separateXYZ",
+            },
+            {
+                nodeId: "n4",
+                typeId: "base.compareXYZ",
+            },
+        ],
+        edges: [
+            {
+                id: "e1",
+                source: { nodeId: "n1", handle: "Result" },
+                target: { nodeId: "n2", handle: "Value" },
+            },
+            // Demonstrate async edge conversion: vec3[] -> float[] using coercion
+            {
+                id: "e2",
+                source: { nodeId: "n4", handle: "XYZ" },
+                target: { nodeId: "n1", handle: "A" },
+                typeId: "base.vec3[]",
+            },
+            {
+                id: "e3",
+                source: { nodeId: "n3", handle: "X" },
+                target: { nodeId: "n4", handle: "X" },
+            },
+            {
+                id: "e4",
+                source: { nodeId: "n3", handle: "Y" },
+                target: { nodeId: "n4", handle: "Y" },
+            },
+            {
+                id: "e5",
+                source: { nodeId: "n3", handle: "Z" },
+                target: { nodeId: "n4", handle: "Z" },
+            },
+        ],
+    };
+    return def;
+}
+export function createAsyncGraphRegistry(id) {
+    const registry = setupBasicGraphRegistry(id);
+    registerDelayNode(registry);
+    return registry;
+}
+export async function main() {
+    const runtime = createRuntime(createAsyncGraphRegistry(), createAsyncGraphDef());
+    const engine = new LocalEngine(runtime, "auto");
+    installLogging(engine);
+    engine.launch();
+    // Set base ms
+    engine.setInputs("n1", { Operation: BaseMathOperation.Add, A: [1], B: [2] });
+    engine.setInputs("n2", { DelayMs: 250 });
+    // Provide XYZ and route through async conversion edge
+    engine.setInputs("n3", {
+        XYZ: [
+            [1, 2, 3],
+            [4, 5, 6],
+            [7, 8, 9],
+        ],
+    });
+    // Rapid inputs to n1.B should cancel prior runs (switch)
+    // Note: n1.A is edge-driven from n4.XYZ, so we change n1.B instead
+    engine.setInputs("n1", { B: [3] });
+    engine.setInputs("n1", { B: [4] });
+    engine.setInputs("n1", { B: [5] });
+    await new Promise((r) => setTimeout(r, 1000));
+    engine.setInputs("n1", { B: [10] });
+    engine.setInputs("n1", { B: [11] });
+    engine.setInputs("n1", { B: [12] });
+    await new Promise((r) => setTimeout(r, 1500));
+    await engine.whenIdle();
+    engine.dispose();
+}
+//# sourceMappingURL=async.js.map

package/lib/src/examples/async.js.map

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

package/lib/src/examples/progress.d.ts

@@ -0,0 +1,5 @@
+import type { GraphDefinition } from "@bian-womp/spark-protocol";
+export declare function createProgressGraphDef(): GraphDefinition;
+export declare function createProgressGraphRegistry(id?: string): import("..").Registry;
+export declare function main(): Promise<void>;
+//# sourceMappingURL=progress.d.ts.map

package/lib/src/examples/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../src/examples/progress.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAKjE,wBAAgB,sBAAsB,oBAsBrC;AAED,wBAAgB,2BAA2B,CAAC,EAAE,CAAC,EAAE,MAAM,yBAItD;AAED,wBAAsB,IAAI,kBAsBzB"}

package/lib/src/examples/progress.js

@@ -0,0 +1,51 @@
+import { registerProgressNodes, setupBasicGraphRegistry, createRuntime } from "../misc/base";
+import { LocalEngine } from "../runtime/LocalEngine";
+import { installLogging } from "./shared";
+export function createProgressGraphDef() {
+    const def = {
+        nodes: [
+            { nodeId: "steps", typeId: "base.input.number" },
+            { nodeId: "delay", typeId: "base.input.number" },
+            { nodeId: "work", typeId: "async.progress" },
+        ],
+        edges: [
+            {
+                id: "e1",
+                source: { nodeId: "steps", handle: "Result" },
+                target: { nodeId: "work", handle: "Steps" },
+            },
+            {
+                id: "e2",
+                source: { nodeId: "delay", handle: "Result" },
+                target: { nodeId: "work", handle: "DelayMs" },
+            },
+            // not wiring ShouldError to show manual input driven error later
+        ],
+    };
+    return def;
+}
+export function createProgressGraphRegistry(id) {
+    const registry = setupBasicGraphRegistry(id);
+    registerProgressNodes(registry);
+    return registry;
+}
+export async function main() {
+    const runtime = createRuntime(createProgressGraphRegistry(), createProgressGraphDef());
+    const engine = new LocalEngine(runtime, "auto");
+    installLogging(engine);
+    engine.launch();
+    // Seed initial values
+    engine.setInputs("steps", { Value: 12 });
+    engine.setInputs("delay", { Value: 80 });
+    // Manually set ShouldError on the worker (unwired input)
+    engine.setInputs("work", { ShouldError: false });
+    // After 2s, trigger an error run
+    await new Promise((r) => setTimeout(r, 2000));
+    console.log("-- triggering error run --");
+    engine.setInputs("work", { ShouldError: true });
+    // After 5s, stop and exit
+    await new Promise((r) => setTimeout(r, 5000));
+    await engine.whenIdle();
+    engine.dispose();
+}
+//# sourceMappingURL=progress.js.map

package/lib/src/examples/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../../src/examples/progress.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7F,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,UAAU,sBAAsB;IACpC,MAAM,GAAG,GAAoB;QAC3B,KAAK,EAAE;YACL,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE;YAChD,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE;YAChD,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE;SAC7C;QACD,KAAK,EAAE;YACL;gBACE,EAAE,EAAE,IAAI;gBACR,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE;gBAC7C,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;aAC5C;YACD;gBACE,EAAE,EAAE,IAAI;gBACR,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE;gBAC7C,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE;aAC9C;YACD,iEAAiE;SAClE;KACF,CAAC;IACF,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,EAAW;IACrD,MAAM,QAAQ,GAAG,uBAAuB,CAAC,EAAE,CAAC,CAAC;IAC7C,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAChC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI;IACxB,MAAM,OAAO,GAAG,aAAa,CAAC,2BAA2B,EAAE,EAAE,sBAAsB,EAAE,CAAC,CAAC;IACvF,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAChD,cAAc,CAAC,MAAM,CAAC,CAAC;IAEvB,MAAM,CAAC,MAAM,EAAE,CAAC;IAEhB,sBAAsB;IACtB,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IACzC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IACzC,yDAAyD;IACzD,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;IAEjD,iCAAiC;IACjC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAC1C,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhD,0BAA0B;IAC1B,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;IAC9C,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;IACxB,MAAM,CAAC,OAAO,EAAE,CAAC;AACnB,CAAC"}

package/lib/src/examples/run.d.ts

@@ -0,0 +1,2 @@
+export declare function run(example: string): Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/lib/src/examples/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/examples/run.ts"],"names":[],"mappings":"AAAA,wBAAsB,GAAG,CAAC,OAAO,EAAE,MAAM,iBA0BxC"}

package/lib/src/examples/run.js

@@ -0,0 +1,32 @@
+export async function run(example) {
+    switch (example) {
+        case "simple":
+            await import("./simple").then((m) => m.main());
+            break;
+        case "runMode":
+            await import("./runMode").then((m) => m.main());
+            break;
+        case "async":
+            await import("./async").then((m) => m.main());
+            break;
+        case "progress":
+            await import("./progress").then((m) => m.main());
+            break;
+        case "validation":
+            await import("./validation").then((m) => m.main());
+            break;
+        case "snapshot":
+            await import("./snapshot").then((m) => m.main());
+            break;
+        case "arrays":
+            await import("./arrays").then((m) => m.main());
+            break;
+        default:
+            throw new Error(`Unknown example: ${example}`);
+    }
+}
+const exampleArg = (process.argv && process.argv[2]) || "simple";
+console.log(`Running example: ${exampleArg}`);
+// top-level await is supported by tsx
+run(exampleArg);
+//# sourceMappingURL=run.js.map

package/lib/src/examples/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../src/examples/run.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,OAAe;IACvC,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,QAAQ;YACX,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/C,MAAM;QACR,KAAK,SAAS;YACZ,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAChD,MAAM;QACR,KAAK,OAAO;YACV,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9C,MAAM;QACR,KAAK,UAAU;YACb,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACjD,MAAM;QACR,KAAK,YAAY;YACf,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACnD,MAAM;QACR,KAAK,UAAU;YACb,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACjD,MAAM;QACR,KAAK,QAAQ;YACX,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/C,MAAM;QACR;YACE,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC;AACjE,OAAO,CAAC,GAAG,CAAC,oBAAoB,UAAU,EAAE,CAAC,CAAC;AAE9C,sCAAsC;AACtC,GAAG,CAAC,UAAU,CAAC,CAAC"}

package/lib/src/examples/runMode.d.ts

@@ -0,0 +1,2 @@
+export declare function main(): Promise<void>;
+//# sourceMappingURL=runMode.d.ts.map

package/lib/src/examples/runMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runMode.d.ts","sourceRoot":"","sources":["../../../src/examples/runMode.ts"],"names":[],"mappings":"AA8OA,wBAAsB,IAAI,kBAmBzB"}

package/lib/src/examples/runMode.js

@@ -0,0 +1,223 @@
+import { GraphBuilder } from "../builder/GraphBuilder";
+import { setupBasicGraphRegistry, registerDelayNode, BaseMathOperation } from "../misc/base";
+import { LocalEngine } from "../runtime/LocalEngine";
+import { installLogging } from "./shared";
+function buildDef() {
+    return {
+        nodes: [
+            { nodeId: "input1", typeId: "base.input.number" },
+            { nodeId: "input2", typeId: "base.input.number" },
+            { nodeId: "math1", typeId: "base.math" },
+            { nodeId: "math2", typeId: "base.math" },
+            {
+                nodeId: "delay1",
+                typeId: "async.delay",
+                params: { policy: { asyncConcurrency: "queue", maxQueue: 4 } },
+            },
+            {
+                nodeId: "delay2",
+                typeId: "async.delay",
+                params: { policy: { asyncConcurrency: "queue", maxQueue: 4 } },
+            },
+        ],
+        edges: [
+            {
+                id: "e1",
+                source: { nodeId: "input1", handle: "Result" },
+                target: { nodeId: "math1", handle: "A" },
+            },
+            {
+                id: "e2",
+                source: { nodeId: "input2", handle: "Result" },
+                target: { nodeId: "math1", handle: "B" },
+            },
+            {
+                id: "e3",
+                source: { nodeId: "math1", handle: "Result" },
+                target: { nodeId: "math2", handle: "A" },
+            },
+            {
+                id: "e4",
+                source: { nodeId: "math2", handle: "Result" },
+                target: { nodeId: "delay1", handle: "Value" },
+            },
+            {
+                id: "e5",
+                source: { nodeId: "delay1", handle: "Result" },
+                target: { nodeId: "delay2", handle: "Value" },
+            },
+        ],
+    };
+}
+async function demoAutoMode() {
+    console.log("\n" + "=".repeat(60));
+    console.log("AUTO MODE DEMONSTRATION");
+    console.log("=".repeat(60));
+    console.log("In auto mode, nodes automatically execute when inputs change.\n");
+    const registry = setupBasicGraphRegistry();
+    registerDelayNode(registry);
+    const builder = new GraphBuilder(registry);
+    const def = buildDef();
+    const runtime = builder.build(def);
+    const engine = new LocalEngine(runtime, "auto");
+    installLogging(engine);
+    engine.launch();
+    // Configure nodes
+    engine.setInputs("math1", { Operation: BaseMathOperation.Add });
+    engine.setInputs("math2", { Operation: BaseMathOperation.Multiply, B: [2] });
+    engine.setInputs("delay1", { DelayMs: 100 });
+    engine.setInputs("delay2", { DelayMs: 100 });
+    console.log("Step 1: Set input1 = 5");
+    console.log("  → input1 runs and outputs 5");
+    console.log("  → math1.A gets set to 5, but math1 waits for input2 (B)\n");
+    engine.setInputs("input1", { Value: 5 });
+    await new Promise((r) => setTimeout(r, 200));
+    console.log("Step 2: Set input2 = 3");
+    console.log("  → input2 runs and outputs 3");
+    console.log("  → math1 automatically runs (A=5, B=3) → Result=8");
+    console.log("  → math2 automatically runs (A=8, B=2) → Result=16");
+    console.log("  → delay1 automatically runs → delay2 automatically runs\n");
+    engine.setInputs("input2", { Value: 3 });
+    await new Promise((r) => setTimeout(r, 500));
+    console.log("Step 3: Set input1 = 10");
+    console.log("  → math1 automatically runs (A=10, B=3) → Result=13");
+    console.log("  → math2 automatically runs (A=13, B=2) → Result=26");
+    console.log("  → delay1 automatically runs → delay2 automatically runs\n");
+    engine.setInputs("input1", { Value: 10 });
+    await engine.whenIdle();
+    engine.dispose();
+}
+async function demoManualMode() {
+    console.log("\n" + "=".repeat(60));
+    console.log("MANUAL MODE DEMONSTRATION");
+    console.log("=".repeat(60));
+    console.log("In manual mode, nodes only execute when explicitly called.\n");
+    const registry = setupBasicGraphRegistry();
+    registerDelayNode(registry);
+    const builder = new GraphBuilder(registry);
+    const def = buildDef();
+    const runtime = builder.build(def);
+    const engine = new LocalEngine(runtime, "manual");
+    installLogging(engine);
+    engine.launch();
+    // Configure nodes
+    engine.setInputs("math1", { Operation: BaseMathOperation.Add });
+    engine.setInputs("math2", { Operation: BaseMathOperation.Multiply, B: [2] });
+    engine.setInputs("delay1", { DelayMs: 100 });
+    engine.setInputs("delay2", { DelayMs: 100 });
+    console.log("Step 1: Set input1 = 5");
+    console.log("  → input1 runs immediately (input nodes run when Value is set, even in manual mode)");
+    console.log("  → math1 does NOT run automatically (waits for explicit call)\n");
+    engine.setInputs("input1", { Value: 5 });
+    await new Promise((r) => setTimeout(r, 100));
+    console.log("Step 2: computeNode('math1') - runs math1 and upstream nodes");
+    console.log("  → math1 runs using input1's output (A=5, B=undefined) → Result=5 (uses defaults for B)");
+    console.log("  → math2 does NOT run (no propagation)\n");
+    await engine.computeNode("math1");
+    await new Promise((r) => setTimeout(r, 200));
+    console.log("Step 3: Set input1=7, then computeNode('math1')");
+    console.log("  → input1 runs immediately when Value is set");
+    console.log("  → math1 runs as an isolated compute (no downstream propagation)");
+    console.log("  → Note: math1 may use previous B value if input2 hasn't run yet\n");
+    engine.setInputs("input1", { Value: 7 });
+    await new Promise((r) => setTimeout(r, 100));
+    await engine.computeNode("math1");
+    await new Promise((r) => setTimeout(r, 200));
+    console.log("Step 4: Set input1=7, then runFromHere('math1') - runs math1 AND all downstream");
+    console.log("  → input1 runs immediately when Value is set");
+    console.log("  → math1 runs (A=7, B=undefined) → Result=7 (uses defaults for B)");
+    console.log("  → math2 runs → delay1 runs → delay2 runs\n");
+    engine.setInputs("input1", { Value: 7 });
+    await new Promise((r) => setTimeout(r, 100));
+    await engine.runFromHere("math1");
+    await new Promise((r) => setTimeout(r, 500));
+    console.log("Step 5: Set input2 = 4, then runFromHere('math1') - runs upstream and downstream");
+    console.log("  → input2 runs immediately when Value is set");
+    console.log("  → math1 runs (A=7, B=4) → Result=11");
+    console.log("  → math2 runs (A=11, B=2) → Result=22");
+    console.log("  → delay1 runs (delay2 may run after delay1 completes)\n");
+    engine.setInputs("input2", { Value: 4 });
+    await new Promise((r) => setTimeout(r, 100));
+    await engine.runFromHere("math1");
+    await new Promise((r) => setTimeout(r, 500));
+    console.log("Step 6: computeNode('math2') - runs ONLY math2");
+    console.log("  → math2 runs with current inputs (A=11, B=2) → Result=22");
+    console.log("  → delay1 does NOT run (no propagation)\n");
+    await engine.computeNode("math2");
+    await new Promise((r) => setTimeout(r, 200));
+    await engine.whenIdle();
+    engine.dispose();
+}
+async function demoModeSwitching() {
+    console.log("\n" + "=".repeat(60));
+    console.log("MODE SWITCHING DEMONSTRATION");
+    console.log("=".repeat(60));
+    console.log("You can switch between modes at runtime.\n");
+    const registry = setupBasicGraphRegistry();
+    registerDelayNode(registry);
+    const builder = new GraphBuilder(registry);
+    const def = buildDef();
+    const runtime = builder.build(def);
+    const engine = new LocalEngine(runtime, "manual");
+    installLogging(engine);
+    engine.launch();
+    // Configure nodes
+    engine.setInputs("math1", { Operation: BaseMathOperation.Add });
+    engine.setInputs("math2", { Operation: BaseMathOperation.Multiply, B: [2] });
+    engine.setInputs("delay1", { DelayMs: 100 });
+    engine.setInputs("delay2", { DelayMs: 100 });
+    console.log("Starting in MANUAL mode");
+    console.log("Step 1: Set input1 = 5");
+    console.log("  → input1 runs immediately (input nodes run when Value is set)\n");
+    engine.setInputs("input1", { Value: 5 });
+    await new Promise((r) => setTimeout(r, 100));
+    console.log("Step 2: Set input2 = 0, then switch to AUTO mode");
+    engine.setInputs("input2", { Value: 0 });
+    engine.setRunMode("auto");
+    console.log("  → input2 runs and outputs 0");
+    console.log("  → math1 automatically runs (A=5, B=0) → Result=5");
+    console.log("  → math2 automatically runs (A=5, B=2) → Result=10");
+    console.log("  → delay1 automatically runs → delay2 automatically runs\n");
+    await new Promise((r) => setTimeout(r, 500));
+    console.log("Step 3: Switch back to MANUAL mode");
+    engine.setRunMode("manual");
+    console.log("Step 4: Set input2 = 8");
+    console.log("  → input2.Value is set to 8");
+    console.log("  → In manual mode, input nodes run when Value is set, but after mode switching they may need explicit trigger");
+    console.log("  → math1 does NOT run automatically (waits for explicit call)\n");
+    engine.setInputs("input2", { Value: 8 });
+    await new Promise((r) => setTimeout(r, 100));
+    console.log("Step 5a: runFromHere('math1') - may use old input2 value");
+    console.log("  → math1 runs, but input2 may not have run yet, so uses old B=0 → Result=5");
+    console.log("  → math2 does NOT run (math1 output didn't change)\n");
+    await engine.runFromHere("math1");
+    await new Promise((r) => setTimeout(r, 200));
+    console.log("Step 5b: Explicitly run input2, then runFromHere('math1') - uses new value");
+    console.log("  → input2 runs and outputs 8");
+    console.log("  → math1 runs with current inputs (A=5, B=8) → Result=13");
+    console.log("  → math2 runs (A=13, B=2) → Result=26");
+    console.log("  → delay1 runs → delay2 runs\n");
+    await engine.computeNode("input2");
+    await engine.runFromHere("math1");
+    await new Promise((r) => setTimeout(r, 500));
+    await engine.whenIdle();
+    engine.dispose();
+}
+export async function main() {
+    await demoAutoMode();
+    await demoManualMode();
+    await demoModeSwitching();
+    console.log("\n" + "=".repeat(60));
+    console.log("SUMMARY");
+    console.log("=".repeat(60));
+    console.log("AUTO MODE:");
+    console.log("  • Nodes automatically execute when inputs change");
+    console.log("  • Changes propagate through the entire graph automatically");
+    console.log("  • Use setInputs() and nodes run themselves\n");
+    console.log("MANUAL MODE:");
+    console.log("  • Nodes only execute when explicitly called");
+    console.log("  • Use computeNode(nodeId) to run a node (no downstream propagation, but upstream nodes run if needed)");
+    console.log("  • Use runFromHere(nodeId) to run a node and all downstream nodes (upstream nodes run if needed)");
+    console.log("  • Use computeNode(nodeId) to run one node without downstream propagation\n");
+}
+//# sourceMappingURL=runMode.js.map