@aura3d/engine 1.0.0

package/dist/scripting/StateMachine.js.map

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

package/dist/scripting/UtilityAI.d.ts

@@ -0,0 +1,55 @@
+import type { Blackboard } from "./BehaviorTree";
+export type UtilityCurve = "linear" | "inverse" | "quadratic" | "cubic" | "boolean" | "logistic";
+export type UtilityScoring = "multiply" | "average" | "min" | "max" | "sum";
+export interface UtilityContext {
+    readonly blackboard?: Blackboard;
+    readonly values?: Record<string, number | boolean | string | undefined>;
+}
+export interface UtilityConsiderationOptions {
+    readonly name: string;
+    readonly input: (context: UtilityContext) => number | boolean;
+    readonly curve?: UtilityCurve;
+    readonly weight?: number;
+    readonly threshold?: number;
+    readonly slope?: number;
+}
+export interface UtilityActionOptions {
+    readonly name: string;
+    readonly considerations: readonly UtilityConsideration[];
+    readonly scoring?: UtilityScoring;
+    readonly baseScore?: number;
+    readonly enabled?: boolean;
+}
+export interface UtilityActionScore {
+    readonly action: string;
+    readonly score: number;
+    readonly considerationScores: Record<string, number>;
+}
+export declare class UtilityConsideration {
+    readonly name: string;
+    readonly curve: UtilityCurve;
+    readonly weight: number;
+    readonly threshold: number;
+    readonly slope: number;
+    private readonly input;
+    constructor(options: UtilityConsiderationOptions);
+    evaluate(context: UtilityContext): number;
+}
+export declare class UtilityAction {
+    readonly name: string;
+    readonly considerations: readonly UtilityConsideration[];
+    readonly scoring: UtilityScoring;
+    readonly baseScore: number;
+    enabled: boolean;
+    constructor(options: UtilityActionOptions);
+    score(context: UtilityContext): UtilityActionScore;
+}
+export declare class UtilityAI {
+    private readonly actions;
+    addAction(action: UtilityAction): void;
+    removeAction(name: string): boolean;
+    setActionEnabled(name: string, enabled: boolean): void;
+    evaluate(context: UtilityContext): readonly UtilityActionScore[];
+    select(context: UtilityContext): UtilityActionScore | undefined;
+}
+//# sourceMappingURL=UtilityAI.d.ts.map

package/dist/scripting/UtilityAI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UtilityAI.d.ts","sourceRoot":"","sources":["../../../../packages/scripting/src/UtilityAI.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;AACjG,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAE5E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;CACzE;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,MAAM,GAAG,OAAO,CAAC;IAC9D,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACzD,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtD;AAED,qBAAa,oBAAoB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgD;gBAE1D,OAAO,EAAE,2BAA2B;IAShD,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM;CAK1C;AAED,qBAAa,aAAa;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,EAAE,SAAS,oBAAoB,EAAE,CAAC;IACzD,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;gBAEL,OAAO,EAAE,oBAAoB;IAQzC,KAAK,CAAC,OAAO,EAAE,cAAc,GAAG,kBAAkB;CAUnD;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAE/C,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAOtC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAOnC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAMtD,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,kBAAkB,EAAE;IAOhE,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,kBAAkB,GAAG,SAAS;CAGhE"}

package/dist/scripting/UtilityAI.js

@@ -0,0 +1,113 @@
+export class UtilityConsideration {
+    name;
+    curve;
+    weight;
+    threshold;
+    slope;
+    input;
+    constructor(options) {
+        this.name = options.name;
+        this.input = options.input;
+        this.curve = options.curve ?? "linear";
+        this.weight = options.weight ?? 1;
+        this.threshold = options.threshold ?? 0.5;
+        this.slope = options.slope ?? 10;
+    }
+    evaluate(context) {
+        const raw = this.input(context);
+        const value = typeof raw === "boolean" ? (raw ? 1 : 0) : clamp01(raw);
+        return round3(clamp01(applyCurve(value, this.curve, this.threshold, this.slope) * this.weight));
+    }
+}
+export class UtilityAction {
+    name;
+    considerations;
+    scoring;
+    baseScore;
+    enabled;
+    constructor(options) {
+        this.name = options.name;
+        this.considerations = options.considerations;
+        this.scoring = options.scoring ?? "multiply";
+        this.baseScore = options.baseScore ?? 0;
+        this.enabled = options.enabled ?? true;
+    }
+    score(context) {
+        const considerationScores = Object.fromEntries(this.considerations.map((consideration) => [consideration.name, consideration.evaluate(context)]));
+        const values = Object.values(considerationScores);
+        const combined = values.length === 0 ? 0 : combineScores(values, this.scoring);
+        return {
+            action: this.name,
+            score: round3(clamp01(combined + this.baseScore)),
+            considerationScores
+        };
+    }
+}
+export class UtilityAI {
+    actions = [];
+    addAction(action) {
+        if (this.actions.some((entry) => entry.name === action.name)) {
+            throw new Error(`Utility action already registered: ${action.name}`);
+        }
+        this.actions.push(action);
+    }
+    removeAction(name) {
+        const index = this.actions.findIndex((action) => action.name === name);
+        if (index < 0)
+            return false;
+        this.actions.splice(index, 1);
+        return true;
+    }
+    setActionEnabled(name, enabled) {
+        const action = this.actions.find((entry) => entry.name === name);
+        if (!action)
+            throw new Error(`Utility action is not registered: ${name}`);
+        action.enabled = enabled;
+    }
+    evaluate(context) {
+        return this.actions
+            .filter((action) => action.enabled)
+            .map((action) => action.score(context))
+            .sort((left, right) => right.score - left.score || left.action.localeCompare(right.action));
+    }
+    select(context) {
+        return this.evaluate(context)[0];
+    }
+}
+function combineScores(values, scoring) {
+    switch (scoring) {
+        case "average":
+            return values.reduce((sum, value) => sum + value, 0) / values.length;
+        case "min":
+            return Math.min(...values);
+        case "max":
+            return Math.max(...values);
+        case "sum":
+            return Math.min(1, values.reduce((sum, value) => sum + value, 0));
+        case "multiply":
+            return values.reduce((product, value) => product * value, 1);
+    }
+}
+function applyCurve(value, curve, threshold, slope) {
+    switch (curve) {
+        case "inverse":
+            return 1 - value;
+        case "quadratic":
+            return value * value;
+        case "cubic":
+            return value * value * value;
+        case "boolean":
+            return value >= threshold ? 1 : 0;
+        case "logistic":
+            return 1 / (1 + Math.exp(-slope * (value - threshold)));
+        case "linear":
+            return value;
+    }
+}
+function clamp01(value) {
+    return Math.max(0, Math.min(1, Number.isFinite(value) ? value : 0));
+}
+function round3(value) {
+    return Number(value.toFixed(3));
+}
+//# sourceMappingURL=UtilityAI.js.map

package/dist/scripting/UtilityAI.js.map

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

package/dist/scripting/VisualGraph.d.ts

@@ -0,0 +1,19 @@
+import { type VisualNode } from "./VisualNode";
+export interface VisualEdge {
+    readonly fromNode: string;
+    readonly fromPort: string;
+    readonly toNode: string;
+    readonly toPort: string;
+}
+export interface VisualGraph {
+    readonly nodes: readonly VisualNode[];
+    readonly edges: readonly VisualEdge[];
+}
+export type SerializedVisualGraph = {
+    readonly nodes: readonly VisualNode[];
+    readonly edges: readonly VisualEdge[];
+};
+export declare function validateGraph(graph: VisualGraph): readonly string[];
+export declare function serializeGraph(graph: VisualGraph): SerializedVisualGraph;
+export declare function deserializeGraph(serialized: SerializedVisualGraph): VisualGraph;
+//# sourceMappingURL=VisualGraph.d.ts.map

package/dist/scripting/VisualGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VisualGraph.d.ts","sourceRoot":"","sources":["../../../../packages/scripting/src/VisualGraph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;CACvC;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;CACvC,CAAC;AAEF,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,MAAM,EAAE,CAuCnE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,qBAAqB,CAcxE;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,qBAAqB,GAAG,WAAW,CAe/E"}

package/dist/scripting/VisualGraph.js

@@ -0,0 +1,74 @@
+import { validateNode } from "./VisualNode.js";
+export function validateGraph(graph) {
+    const errors = [];
+    const nodes = new Map(graph.nodes.map((node) => [node.id, node]));
+    const seenNodeIds = new Set();
+    for (const node of graph.nodes) {
+        if (seenNodeIds.has(node.id)) {
+            errors.push(`Duplicate node id: ${node.id}`);
+        }
+        seenNodeIds.add(node.id);
+        errors.push(...validateNode(node));
+    }
+    for (const edge of graph.edges) {
+        const from = nodes.get(edge.fromNode);
+        const to = nodes.get(edge.toNode);
+        if (!from) {
+            errors.push(`Missing edge source node: ${edge.fromNode}`);
+            continue;
+        }
+        if (!to) {
+            errors.push(`Missing edge target node: ${edge.toNode}`);
+            continue;
+        }
+        const fromPort = from.ports.find((port) => port.id === edge.fromPort);
+        const toPort = to.ports.find((port) => port.id === edge.toPort);
+        if (!fromPort || fromPort.direction !== "output") {
+            errors.push(`Invalid source port: ${edge.fromNode}.${edge.fromPort}`);
+        }
+        if (!toPort || toPort.direction !== "input") {
+            errors.push(`Invalid target port: ${edge.toNode}.${edge.toPort}`);
+        }
+        if (fromPort && toPort && fromPort.type !== toPort.type && fromPort.type !== "any" && toPort.type !== "any") {
+            errors.push(`Port type mismatch: ${edge.fromNode}.${edge.fromPort} -> ${edge.toNode}.${edge.toPort}`);
+        }
+    }
+    return errors;
+}
+export function serializeGraph(graph) {
+    const errors = validateGraph(graph);
+    if (errors.length > 0) {
+        throw new Error(errors.join("; "));
+    }
+    return {
+        nodes: graph.nodes.map((node) => ({
+            id: node.id,
+            kind: node.kind,
+            ports: node.ports.map((port) => ({ ...port })),
+            data: cloneData(node.data)
+        })),
+        edges: graph.edges.map((edge) => ({ ...edge }))
+    };
+}
+export function deserializeGraph(serialized) {
+    const graph = {
+        nodes: serialized.nodes.map((node) => ({
+            id: node.id,
+            kind: node.kind,
+            ports: node.ports.map((port) => ({ ...port })),
+            data: cloneData(node.data)
+        })),
+        edges: serialized.edges.map((edge) => ({ ...edge }))
+    };
+    const errors = validateGraph(graph);
+    if (errors.length > 0) {
+        throw new Error(errors.join("; "));
+    }
+    return graph;
+}
+function cloneData(data) {
+    if (data === undefined)
+        return undefined;
+    return JSON.parse(JSON.stringify(data));
+}
+//# sourceMappingURL=VisualGraph.js.map

package/dist/scripting/VisualGraph.js.map

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

package/dist/scripting/VisualGraphExecutor.d.ts

@@ -0,0 +1,11 @@
+import { type VisualGraph } from "./VisualGraph";
+export interface VisualExecutionResult {
+    readonly values: ReadonlyMap<string, unknown>;
+    readonly executionOrder: readonly string[];
+    readonly nodeKinds: readonly string[];
+    readonly blockedClaims: readonly string[];
+}
+export declare class VisualGraphExecutor {
+    execute(graph: VisualGraph): VisualExecutionResult;
+}
+//# sourceMappingURL=VisualGraphExecutor.d.ts.map

package/dist/scripting/VisualGraphExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VisualGraphExecutor.d.ts","sourceRoot":"","sources":["../../../../packages/scripting/src/VisualGraphExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkC,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAMjF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,qBAAqB;CAiDnD"}

package/dist/scripting/VisualGraphExecutor.js

@@ -0,0 +1,214 @@
+import { validateGraph } from "./VisualGraph.js";
+import { getVisualNodeDefinition } from "./VisualNodeCatalog.js";
+import {} from "./VisualNode.js";
+const visualNodeOutputsBrand = Symbol("VisualNodeOutputs");
+export class VisualGraphExecutor {
+    execute(graph) {
+        const errors = validateGraph(graph);
+        if (errors.length > 0) {
+            throw new Error(errors.join("; "));
+        }
+        const values = new Map();
+        const executionOrder = [];
+        const nodes = new Map(graph.nodes.map((node) => [node.id, node]));
+        const visiting = new Set();
+        const visited = new Set();
+        const executeNode = (nodeId) => {
+            if (visited.has(nodeId))
+                return;
+            if (visiting.has(nodeId)) {
+                throw new Error(`Visual graph cycle detected at node: ${nodeId}`);
+            }
+            const node = nodes.get(nodeId);
+            if (!node) {
+                throw new Error(`Missing visual node: ${nodeId}`);
+            }
+            visiting.add(nodeId);
+            for (const edge of graph.edges.filter((candidate) => candidate.toNode === node.id)) {
+                executeNode(edge.fromNode);
+            }
+            setNodeOutput(values, node, executeVisualNode(node, graph.edges.filter((edge) => edge.toNode === node.id), values));
+            visiting.delete(nodeId);
+            visited.add(nodeId);
+            executionOrder.push(nodeId);
+        };
+        for (const node of graph.nodes) {
+            executeNode(node.id);
+        }
+        return {
+            values,
+            executionOrder,
+            nodeKinds: [...new Set(graph.nodes.map((node) => node.kind))].sort(),
+            blockedClaims: [
+                "Unity Visual Scripting parity",
+                "Unreal Blueprint parity",
+                "async latent action graph parity",
+                "editor-authored visual scripting parity"
+            ]
+        };
+    }
+}
+function executeVisualNode(node, inputEdges, values) {
+    const definition = getVisualNodeDefinition(node.kind);
+    if (!definition)
+        throw new Error(`Unsupported visual node kind: ${node.kind}`);
+    const input = (port) => getInputValue(node, port, inputEdges, values);
+    const number = (port) => Number(input(port) ?? 0);
+    const boolean = (port) => Boolean(input(port));
+    switch (node.kind) {
+        case "const":
+            return node.data?.value;
+        case "log":
+            return input("in");
+        case "add":
+            return inputEdges.length > 1
+                ? inputEdges.reduce((total, edge) => total + Number(readEdgeValue(edge, values) ?? 0), 0)
+                : number("in");
+        case "subtract":
+            return number("a") - number("b");
+        case "multiply":
+            return number("a") * number("b");
+        case "divide": {
+            const divisor = number("b");
+            if (divisor === 0)
+                throw new Error(`Visual node ${node.id} divide by zero.`);
+            return number("a") / divisor;
+        }
+        case "power":
+            return Math.pow(number("base"), number("exponent"));
+        case "sqrt": {
+            const value = number("value");
+            if (value < 0)
+                throw new Error(`Visual node ${node.id} cannot calculate square root of a negative number.`);
+            return Math.sqrt(value);
+        }
+        case "abs":
+            return Math.abs(number("value"));
+        case "sin":
+            return Math.sin(number("angle"));
+        case "cos":
+            return Math.cos(number("angle"));
+        case "tan":
+            return Math.tan(number("angle"));
+        case "min":
+            return Math.min(number("a"), number("b"));
+        case "max":
+            return Math.max(number("a"), number("b"));
+        case "clamp":
+            return Math.max(number("min"), Math.min(number("max"), number("value")));
+        case "lerp":
+            return number("a") + (number("b") - number("a")) * number("t");
+        case "inverseLerp": {
+            const a = number("a");
+            const b = number("b");
+            if (a === b)
+                throw new Error(`Visual node ${node.id} inverseLerp requires different a and b values.`);
+            return (number("value") - a) / (b - a);
+        }
+        case "and":
+            return boolean("a") && boolean("b");
+        case "or":
+            return boolean("a") || boolean("b");
+        case "not":
+            return !boolean("value");
+        case "xor":
+            return boolean("a") !== boolean("b");
+        case "equal":
+            return input("a") === input("b");
+        case "notEqual":
+            return input("a") !== input("b");
+        case "greater":
+            return number("a") > number("b");
+        case "less":
+            return number("a") < number("b");
+        case "greaterEqual":
+            return number("a") >= number("b");
+        case "lessEqual":
+            return number("a") <= number("b");
+        case "isNull": {
+            const value = input("value");
+            return value === null || value === undefined;
+        }
+        case "isValid": {
+            const value = input("value");
+            return value !== null && value !== undefined;
+        }
+        case "select":
+            return boolean("condition") ? input("ifTrue") : input("ifFalse");
+        case "branch": {
+            const selected = boolean("condition") ? "true" : "false";
+            return outputs(selected, {
+                true: selected === "true",
+                false: selected === "false",
+                selected
+            });
+        }
+        case "switch": {
+            const caseCount = Math.max(1, Math.min(3, Math.floor(number("caseCount"))));
+            const selectedIndex = Math.floor(number("value"));
+            const selected = selectedIndex >= 0 && selectedIndex < caseCount ? `case${selectedIndex}` : "default";
+            return outputs(selected, {
+                case0: selected === "case0",
+                case1: selected === "case1",
+                case2: selected === "case2",
+                default: selected === "default",
+                selected
+            });
+        }
+        case "sequence": {
+            const count = Math.max(1, Math.min(3, Math.floor(number("count"))));
+            const orderedOutputs = Array.from({ length: count }, (_, index) => `out${index}`);
+            return outputs(orderedOutputs, {
+                out0: count > 0,
+                out1: count > 1,
+                out2: count > 2,
+                outputs: orderedOutputs
+            });
+        }
+        case "forRange": {
+            const startIndex = Math.floor(number("startIndex"));
+            const endIndex = Math.floor(number("endIndex"));
+            const iterations = Math.max(0, Math.min(256, endIndex - startIndex));
+            const indices = Array.from({ length: iterations }, (_, index) => startIndex + index);
+            return outputs(indices, {
+                body: iterations > 0,
+                completed: true,
+                index: indices[0] ?? startIndex,
+                indices
+            });
+        }
+        case "gate": {
+            const isOpen = !boolean("startClosed");
+            return outputs(isOpen ? "out" : undefined, {
+                out: isOpen,
+                isOpen
+            });
+        }
+    }
+}
+function getInputValue(node, portId, inputEdges, values) {
+    const edge = inputEdges.find((candidate) => candidate.toPort === portId);
+    if (edge)
+        return readEdgeValue(edge, values);
+    const dataValue = node.data?.[portId];
+    if (dataValue !== undefined)
+        return dataValue;
+    return node.ports.find((port) => port.id === portId)?.defaultValue;
+}
+function readEdgeValue(edge, values) {
+    return values.get(`${edge.fromNode}.${edge.fromPort}`) ?? values.get(edge.fromNode);
+}
+function setNodeOutput(values, node, value) {
+    const resolved = isOutputMap(value) ? value : outputs(value);
+    values.set(node.id, resolved.value);
+    for (const port of node.ports.filter((entry) => entry.direction === "output")) {
+        values.set(`${node.id}.${port.id}`, resolved.byPort?.[port.id] ?? resolved.value);
+    }
+}
+function outputs(value, byPort) {
+    return { [visualNodeOutputsBrand]: true, value, byPort };
+}
+function isOutputMap(value) {
+    return typeof value === "object" && value !== null && value[visualNodeOutputsBrand] === true;
+}
+//# sourceMappingURL=VisualGraphExecutor.js.map

package/dist/scripting/VisualGraphExecutor.js.map

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

package/dist/scripting/VisualNode.d.ts

@@ -0,0 +1,17 @@
+export type VisualPortDirection = "input" | "output";
+export type VisualPortType = "flow" | "number" | "boolean" | "string" | "object" | "any";
+export interface VisualPort {
+    readonly id: string;
+    readonly direction: VisualPortDirection;
+    readonly type: VisualPortType;
+    readonly optional?: boolean;
+    readonly defaultValue?: unknown;
+}
+export interface VisualNode {
+    readonly id: string;
+    readonly kind: string;
+    readonly ports: readonly VisualPort[];
+    readonly data?: Readonly<Record<string, unknown>>;
+}
+export declare function validateNode(node: VisualNode): readonly string[];
+//# sourceMappingURL=VisualNode.d.ts.map

package/dist/scripting/VisualNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VisualNode.d.ts","sourceRoot":"","sources":["../../../../packages/scripting/src/VisualNode.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,QAAQ,CAAC;AACrD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEzF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACnD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,MAAM,EAAE,CAyBhE"}

package/dist/scripting/VisualNode.js

@@ -0,0 +1,24 @@
+export function validateNode(node) {
+    const errors = [];
+    const ports = new Set();
+    if (node.id.length === 0) {
+        errors.push("Node id is required");
+    }
+    for (const port of node.ports) {
+        if (port.id.length === 0) {
+            errors.push(`Port id is required on node ${node.id}`);
+        }
+        if (ports.has(port.id)) {
+            errors.push(`Duplicate port id on node ${node.id}: ${port.id}`);
+        }
+        ports.add(port.id);
+        if (port.direction !== "input" && port.direction !== "output") {
+            errors.push(`Invalid port direction on node ${node.id}.${port.id}`);
+        }
+        if (!["flow", "number", "boolean", "string", "object", "any"].includes(port.type)) {
+            errors.push(`Invalid port type on node ${node.id}.${port.id}`);
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=VisualNode.js.map

package/dist/scripting/VisualNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VisualNode.js","sourceRoot":"","sources":["../../../../packages/scripting/src/VisualNode.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,YAAY,CAAC,IAAgB;IAC3C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,IAAI,IAAI,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,+BAA+B,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,IAAI,CAAC,6BAA6B,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QAClE,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnB,IAAI,IAAI,CAAC,SAAS,KAAK,OAAO,IAAI,IAAI,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC9D,MAAM,CAAC,IAAI,CAAC,kCAAkC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAClF,MAAM,CAAC,IAAI,CAAC,6BAA6B,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/scripting/VisualNodeCatalog.d.ts

@@ -0,0 +1,14 @@
+import { type VisualNode, type VisualPort } from "./VisualNode";
+export type VisualNodeCategory = "value" | "math" | "logic" | "flow" | "debug";
+export interface VisualNodeDefinition {
+    readonly kind: string;
+    readonly category: VisualNodeCategory;
+    readonly title: string;
+    readonly description: string;
+    readonly ports: readonly VisualPort[];
+    readonly oldBranchSource: readonly string[];
+}
+export declare function listVisualNodeDefinitions(): readonly VisualNodeDefinition[];
+export declare function getVisualNodeDefinition(kind: string): VisualNodeDefinition | undefined;
+export declare function createVisualNode(kind: string, id: string, data?: Readonly<Record<string, unknown>>): VisualNode;
+//# sourceMappingURL=VisualNodeCatalog.d.ts.map

package/dist/scripting/VisualNodeCatalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VisualNodeCatalog.d.ts","sourceRoot":"","sources":["../../../../packages/scripting/src/VisualNodeCatalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAuB,MAAM,cAAc,CAAC;AAErF,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,CAAC;AAE/E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAwCD,wBAAgB,yBAAyB,IAAI,SAAS,oBAAoB,EAAE,CAM3E;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAGtF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,UAAU,CAS/G"}