@onerjs/core 8.44.7 → 8.44.9

package/FlowGraph/flowGraphSignalConnection.js

@@ -13,6 +13,11 @@ export class FlowGraphSignalConnection extends FlowGraphConnection {
          * Set priority before adding the connection as sorting happens only when the connection is added.
          */
         this.priority = 0;
+        /**
+         * Timestamp of the last activation (set on output signals when they fire).
+         * @internal
+         */
+        this._lastActivationTime = -1;
     }
     _isSingularConnection() {
         return false;
@@ -26,6 +31,7 @@ export class FlowGraphSignalConnection extends FlowGraphConnection {
      * @internal
      */
     _activateSignal(context) {
+        this._lastActivationTime = performance.now();
         context.logger?.addLogItem({
             action: "ActivateSignal" /* FlowGraphAction.ActivateSignal */,
             className: this._ownerBlock.getClassName(),
@@ -36,8 +42,14 @@ export class FlowGraphSignalConnection extends FlowGraphConnection {
             },
         });
         if (this.connectionType === 0 /* FlowGraphConnectionType.Input */) {
+            // Check breakpoint before executing
+            if (context._shouldBreak(this._ownerBlock, this)) {
+                return; // Execution paused — stored as pending activation
+            }
             context._notifyExecuteNode(this._ownerBlock);
+            const startTime = performance.now();
             this._ownerBlock._execute(context, this);
+            this._ownerBlock._lastExecutionTime = performance.now() - startTime;
             context._increaseExecutionId();
         }
         else {

package/FlowGraph/flowGraphSignalConnection.js.map

@@ -1 +1 @@
-{"version":3,"file":"flowGraphSignalConnection.js","sourceRoot":"","sources":["../../../../dev/core/src/FlowGraph/flowGraphSignalConnection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAA2B,MAAM,uBAAuB,CAAC;AAErF,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD;;;;GAIG;AACH,MAAM,OAAO,yBAA0B,SAAQ,mBAAuE;IAAtH;;QAMI;;;WAGG;QACI,aAAQ,GAAW,CAAC,CAAC;IAmChC,CAAC;IAjCmB,qBAAqB;QACjC,OAAO,KAAK,CAAC;IACjB,CAAC;IAEe,SAAS,CAAC,KAAgC;QACtD,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACvB,uDAAuD;QACvD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IACjE,CAAC;IAED;;OAEG;IACI,eAAe,CAAC,OAAyB;QAC5C,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC;YACvB,MAAM,uDAAgC;YACtC,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE;YAC1C,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ;YACnC,OAAO,EAAE;gBACL,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,IAAI,EAAE,IAAI,CAAC,IAAI;aAClB;SACJ,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,cAAc,0CAAkC,EAAE,CAAC;YACxD,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC7C,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACzC,OAAO,CAAC,oBAAoB,EAAE,CAAC;QACnC,CAAC;aAAM,CAAC;YACJ,KAAK,MAAM,cAAc,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBAChD,cAAc,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAC5C,CAAC;QACL,CAAC;IACL,CAAC;CACJ;AAED,aAAa,CAAC,2BAA2B,EAAE,yBAAyB,CAAC,CAAC","sourcesContent":["import type { FlowGraphExecutionBlock } from \"./flowGraphExecutionBlock\";\r\nimport { FlowGraphConnection, FlowGraphConnectionType } from \"./flowGraphConnection\";\r\nimport type { FlowGraphContext } from \"./flowGraphContext\";\r\nimport { RegisterClass } from \"../Misc/typeStore\";\r\nimport { FlowGraphAction } from \"./flowGraphLogger\";\r\n\r\n/**\r\n * Represents a connection point for a signal.\r\n * When an output point is activated, it will activate the connected input point.\r\n * When an input point is activated, it will execute the block it belongs to.\r\n */\r\nexport class FlowGraphSignalConnection extends FlowGraphConnection<FlowGraphExecutionBlock, FlowGraphSignalConnection> {\r\n    /**\r\n     * Optional payload. Can be used, for example, when an error is thrown to pass additional information.\r\n     */\r\n    public payload: any;\r\n\r\n    /**\r\n     * The priority of the signal. Signals with higher priority will be executed first.\r\n     * Set priority before adding the connection as sorting happens only when the connection is added.\r\n     */\r\n    public priority: number = 0;\r\n\r\n    public override _isSingularConnection(): boolean {\r\n        return false;\r\n    }\r\n\r\n    public override connectTo(point: FlowGraphSignalConnection): void {\r\n        super.connectTo(point);\r\n        // sort according to priority to handle execution order\r\n        this._connectedPoint.sort((a, b) => b.priority - a.priority);\r\n    }\r\n\r\n    /**\r\n     * @internal\r\n     */\r\n    public _activateSignal(context: FlowGraphContext): void {\r\n        context.logger?.addLogItem({\r\n            action: FlowGraphAction.ActivateSignal,\r\n            className: this._ownerBlock.getClassName(),\r\n            uniqueId: this._ownerBlock.uniqueId,\r\n            payload: {\r\n                connectionType: this.connectionType,\r\n                name: this.name,\r\n            },\r\n        });\r\n        if (this.connectionType === FlowGraphConnectionType.Input) {\r\n            context._notifyExecuteNode(this._ownerBlock);\r\n            this._ownerBlock._execute(context, this);\r\n            context._increaseExecutionId();\r\n        } else {\r\n            for (const connectedPoint of this._connectedPoint) {\r\n                connectedPoint._activateSignal(context);\r\n            }\r\n        }\r\n    }\r\n}\r\n\r\nRegisterClass(\"FlowGraphSignalConnection\", FlowGraphSignalConnection);\r\n"]}
+{"version":3,"file":"flowGraphSignalConnection.js","sourceRoot":"","sources":["../../../../dev/core/src/FlowGraph/flowGraphSignalConnection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAA2B,MAAM,uBAAuB,CAAC;AAErF,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD;;;;GAIG;AACH,MAAM,OAAO,yBAA0B,SAAQ,mBAAuE;IAAtH;;QAMI;;;WAGG;QACI,aAAQ,GAAW,CAAC,CAAC;QAY5B;;;WAGG;QACI,wBAAmB,GAAW,CAAC,CAAC,CAAC;IAgC5C,CAAC;IA9CmB,qBAAqB;QACjC,OAAO,KAAK,CAAC;IACjB,CAAC;IAEe,SAAS,CAAC,KAAgC;QACtD,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACvB,uDAAuD;QACvD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IACjE,CAAC;IAQD;;OAEG;IACI,eAAe,CAAC,OAAyB;QAC5C,IAAI,CAAC,mBAAmB,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAC7C,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC;YACvB,MAAM,uDAAgC;YACtC,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE;YAC1C,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ;YACnC,OAAO,EAAE;gBACL,cAAc,EAAE,IAAI,CAAC,cAAc;gBACnC,IAAI,EAAE,IAAI,CAAC,IAAI;aAClB;SACJ,CAAC,CAAC;QACH,IAAI,IAAI,CAAC,cAAc,0CAAkC,EAAE,CAAC;YACxD,oCAAoC;YACpC,IAAI,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,EAAE,CAAC;gBAC/C,OAAO,CAAC,kDAAkD;YAC9D,CAAC;YACD,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAC7C,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YACpC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACzC,IAAI,CAAC,WAAW,CAAC,kBAAkB,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YACpE,OAAO,CAAC,oBAAoB,EAAE,CAAC;QACnC,CAAC;aAAM,CAAC;YACJ,KAAK,MAAM,cAAc,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBAChD,cAAc,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;YAC5C,CAAC;QACL,CAAC;IACL,CAAC;CACJ;AAED,aAAa,CAAC,2BAA2B,EAAE,yBAAyB,CAAC,CAAC","sourcesContent":["import type { FlowGraphExecutionBlock } from \"./flowGraphExecutionBlock\";\r\nimport { FlowGraphConnection, FlowGraphConnectionType } from \"./flowGraphConnection\";\r\nimport type { FlowGraphContext } from \"./flowGraphContext\";\r\nimport { RegisterClass } from \"../Misc/typeStore\";\r\nimport { FlowGraphAction } from \"./flowGraphLogger\";\r\n\r\n/**\r\n * Represents a connection point for a signal.\r\n * When an output point is activated, it will activate the connected input point.\r\n * When an input point is activated, it will execute the block it belongs to.\r\n */\r\nexport class FlowGraphSignalConnection extends FlowGraphConnection<FlowGraphExecutionBlock, FlowGraphSignalConnection> {\r\n    /**\r\n     * Optional payload. Can be used, for example, when an error is thrown to pass additional information.\r\n     */\r\n    public payload: any;\r\n\r\n    /**\r\n     * The priority of the signal. Signals with higher priority will be executed first.\r\n     * Set priority before adding the connection as sorting happens only when the connection is added.\r\n     */\r\n    public priority: number = 0;\r\n\r\n    public override _isSingularConnection(): boolean {\r\n        return false;\r\n    }\r\n\r\n    public override connectTo(point: FlowGraphSignalConnection): void {\r\n        super.connectTo(point);\r\n        // sort according to priority to handle execution order\r\n        this._connectedPoint.sort((a, b) => b.priority - a.priority);\r\n    }\r\n\r\n    /**\r\n     * Timestamp of the last activation (set on output signals when they fire).\r\n     * @internal\r\n     */\r\n    public _lastActivationTime: number = -1;\r\n\r\n    /**\r\n     * @internal\r\n     */\r\n    public _activateSignal(context: FlowGraphContext): void {\r\n        this._lastActivationTime = performance.now();\r\n        context.logger?.addLogItem({\r\n            action: FlowGraphAction.ActivateSignal,\r\n            className: this._ownerBlock.getClassName(),\r\n            uniqueId: this._ownerBlock.uniqueId,\r\n            payload: {\r\n                connectionType: this.connectionType,\r\n                name: this.name,\r\n            },\r\n        });\r\n        if (this.connectionType === FlowGraphConnectionType.Input) {\r\n            // Check breakpoint before executing\r\n            if (context._shouldBreak(this._ownerBlock, this)) {\r\n                return; // Execution paused — stored as pending activation\r\n            }\r\n            context._notifyExecuteNode(this._ownerBlock);\r\n            const startTime = performance.now();\r\n            this._ownerBlock._execute(context, this);\r\n            this._ownerBlock._lastExecutionTime = performance.now() - startTime;\r\n            context._increaseExecutionId();\r\n        } else {\r\n            for (const connectedPoint of this._connectedPoint) {\r\n                connectedPoint._activateSignal(context);\r\n            }\r\n        }\r\n    }\r\n}\r\n\r\nRegisterClass(\"FlowGraphSignalConnection\", FlowGraphSignalConnection);\r\n"]}

package/FlowGraph/flowGraphValidator.d.ts

@@ -0,0 +1,66 @@
+import type { FlowGraph } from "./flowGraph.js";
+import type { FlowGraphBlock } from "./flowGraphBlock.js";
+/**
+ * Severity level for a validation issue.
+ */
+export declare enum FlowGraphValidationSeverity {
+    /** A critical issue that will cause runtime failure. */
+    Error = 0,
+    /** A potential issue that may indicate a mistake. */
+    Warning = 1
+}
+/**
+ * A single validation issue found in the flow graph.
+ */
+export interface IFlowGraphValidationIssue {
+    /** The severity level. */
+    severity: FlowGraphValidationSeverity;
+    /** Human-readable description of the issue. */
+    message: string;
+    /** The block where the issue was found (if applicable). */
+    block?: FlowGraphBlock;
+    /** The connection name involved (if applicable). */
+    connectionName?: string;
+}
+/**
+ * The result of validating a flow graph.
+ */
+export interface IFlowGraphValidationResult {
+    /** Whether the graph passed validation with no errors. */
+    isValid: boolean;
+    /** All issues found, ordered by severity (errors first). */
+    issues: IFlowGraphValidationIssue[];
+    /** Convenience: number of error-level issues. */
+    errorCount: number;
+    /** Convenience: number of warning-level issues. */
+    warningCount: number;
+    /** Map from block uniqueId to the issues affecting that block. */
+    issuesByBlock: Map<string, IFlowGraphValidationIssue[]>;
+}
+/**
+ * Validates a flow graph and returns all issues found.
+ *
+ * The following checks are performed:
+ * 1. **No event blocks** — the graph has no entry points.
+ * 2. **Unconnected required data inputs** — a non-optional data input with no connection.
+ * 3. **Unconnected signal inputs** — an execution block whose `in` signal has no connection and
+ *    that is not an event block (entry point).
+ * 4. **Data type mismatches** — a data connection whose source richType is incompatible with the
+ *    target richType.
+ * 5. **Unreachable blocks** — blocks not reachable from any event block via signal/data traversal.
+ * 6. **Data dependency cycles** — circular data-only connections that would cause infinite recursion.
+ *
+ * @param flowGraph - The flow graph to validate.
+ * @returns The validation result.
+ */
+export declare function ValidateFlowGraph(flowGraph: FlowGraph): IFlowGraphValidationResult;
+/**
+ * Extended validation that also checks for unreachable blocks.
+ * Requires a full list of all blocks in the graph (including those not reachable
+ * from event blocks via the normal traversal).
+ *
+ * @param flowGraph - The flow graph to validate.
+ * @param allKnownBlocks - Complete list of all blocks (e.g., from the editor's node set).
+ * @returns The validation result.
+ */
+export declare function ValidateFlowGraphWithBlockList(flowGraph: FlowGraph, allKnownBlocks: FlowGraphBlock[]): IFlowGraphValidationResult;

package/FlowGraph/flowGraphValidator.js

@@ -0,0 +1,324 @@
+import { FlowGraphExecutionBlock } from "./flowGraphExecutionBlock.js";
+import { FlowGraphEventBlock } from "./flowGraphEventBlock.js";
+/**
+ * Severity level for a validation issue.
+ */
+export var FlowGraphValidationSeverity;
+(function (FlowGraphValidationSeverity) {
+    /** A critical issue that will cause runtime failure. */
+    FlowGraphValidationSeverity[FlowGraphValidationSeverity["Error"] = 0] = "Error";
+    /** A potential issue that may indicate a mistake. */
+    FlowGraphValidationSeverity[FlowGraphValidationSeverity["Warning"] = 1] = "Warning";
+})(FlowGraphValidationSeverity || (FlowGraphValidationSeverity = {}));
+// Types that are mutually coercible and should not produce type-mismatch warnings
+const NumericLikeTypes = new Set(["number" /* FlowGraphTypes.Number */, "FlowGraphInteger" /* FlowGraphTypes.Integer */, "boolean" /* FlowGraphTypes.Boolean */]);
+const VectorLikeTypes = new Set(["Vector4" /* FlowGraphTypes.Vector4 */, "Quaternion" /* FlowGraphTypes.Quaternion */]);
+const ColorLikeTypes = new Set(["Color3" /* FlowGraphTypes.Color3 */, "Color4" /* FlowGraphTypes.Color4 */]);
+/**
+ * @internal
+ */
+function _AreTypesCompatible(sourceType, targetType) {
+    if (sourceType === targetType) {
+        return true;
+    }
+    // "any" is compatible with everything
+    if (sourceType === "any" /* FlowGraphTypes.Any */ || targetType === "any" /* FlowGraphTypes.Any */) {
+        return true;
+    }
+    // Numeric coercion group
+    if (NumericLikeTypes.has(sourceType) && NumericLikeTypes.has(targetType)) {
+        return true;
+    }
+    // Vector4 / Quaternion are interchangeable
+    if (VectorLikeTypes.has(sourceType) && VectorLikeTypes.has(targetType)) {
+        return true;
+    }
+    // Color3 → Color4 widening is safe
+    if (ColorLikeTypes.has(sourceType) && ColorLikeTypes.has(targetType)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Validates a flow graph and returns all issues found.
+ *
+ * The following checks are performed:
+ * 1. **No event blocks** — the graph has no entry points.
+ * 2. **Unconnected required data inputs** — a non-optional data input with no connection.
+ * 3. **Unconnected signal inputs** — an execution block whose `in` signal has no connection and
+ *    that is not an event block (entry point).
+ * 4. **Data type mismatches** — a data connection whose source richType is incompatible with the
+ *    target richType.
+ * 5. **Unreachable blocks** — blocks not reachable from any event block via signal/data traversal.
+ * 6. **Data dependency cycles** — circular data-only connections that would cause infinite recursion.
+ *
+ * @param flowGraph - The flow graph to validate.
+ * @returns The validation result.
+ */
+export function ValidateFlowGraph(flowGraph) {
+    const issues = [];
+    const issuesByBlock = new Map();
+    const addIssue = (issue) => {
+        issues.push(issue);
+        if (issue.block) {
+            let arr = issuesByBlock.get(issue.block.uniqueId);
+            if (!arr) {
+                arr = [];
+                issuesByBlock.set(issue.block.uniqueId, arr);
+            }
+            arr.push(issue);
+        }
+    };
+    // Collect ALL blocks via visitAllBlocks
+    const allBlocks = [];
+    flowGraph.visitAllBlocks((block) => {
+        allBlocks.push(block);
+    });
+    // ── Check 1: No event blocks ───────────────────────────────────────
+    const eventBlocks = _GetEventBlocks(flowGraph);
+    if (eventBlocks.length === 0) {
+        addIssue({
+            severity: 0 /* FlowGraphValidationSeverity.Error */,
+            message: "Graph has no event blocks — nothing will trigger execution.",
+        });
+    }
+    // ── Check 2: Unconnected required data inputs ──────────────────────
+    for (const block of allBlocks) {
+        for (const input of block.dataInputs) {
+            if (!input.optional && !input.isDisabled && !input.isConnected()) {
+                addIssue({
+                    severity: 1 /* FlowGraphValidationSeverity.Warning */,
+                    message: `"${input.name}" is not connected and will use its default value.`,
+                    block,
+                    connectionName: input.name,
+                });
+            }
+        }
+    }
+    // ── Check 3: Unconnected signal inputs on non-event execution blocks
+    for (const block of allBlocks) {
+        if (block instanceof FlowGraphExecutionBlock) {
+            // Skip event blocks — they are entry points and don't need an incoming signal.
+            if (_IsEventBlock(block)) {
+                continue;
+            }
+            const inSignal = block.signalInputs.find((s) => s.name === "in");
+            if (inSignal && !inSignal.isConnected()) {
+                addIssue({
+                    severity: 0 /* FlowGraphValidationSeverity.Error */,
+                    message: `Execution block has no incoming signal — it will never execute.`,
+                    block,
+                    connectionName: "in",
+                });
+            }
+        }
+    }
+    // ── Check 4: Data type mismatches ──────────────────────────────────
+    for (const block of allBlocks) {
+        for (const input of block.dataInputs) {
+            if (!input.isConnected()) {
+                continue;
+            }
+            const source = input._connectedPoint[0];
+            const srcType = source.richType?.typeName;
+            const tgtType = input.richType?.typeName;
+            if (srcType && tgtType && !_AreTypesCompatible(srcType, tgtType)) {
+                // If either side has a typeTransformer, it's intentionally converted
+                if (source.richType.typeTransformer !== undefined || input.richType.typeTransformer !== undefined) {
+                    continue;
+                }
+                addIssue({
+                    severity: 1 /* FlowGraphValidationSeverity.Warning */,
+                    message: `Type mismatch: "${source._ownerBlock.name}.${source.name}" (${srcType}) → "${block.name}.${input.name}" (${tgtType}).`,
+                    block,
+                    connectionName: input.name,
+                });
+            }
+        }
+    }
+    // ── Check 5: Unreachable blocks ────────────────────────────────────
+    const reachableIds = new Set();
+    flowGraph.visitAllBlocks((block) => {
+        reachableIds.add(block.uniqueId);
+    });
+    // We need to also check standalone data blocks not visited by visitAllBlocks.
+    // visitAllBlocks starts from event blocks; any block not found is unreachable.
+    // Since we can only iterate blocks we know about, the allBlocks list IS
+    // from visitAllBlocks, so everything in it IS reachable.
+    // There's no separate registry of "all added blocks" in the FlowGraph.
+    // So: unreachable blocks are blocks that exist but aren't visited.
+    // Currently visitAllBlocks IS our source, so this check is a no-op for
+    // blocks added via the graph. However, the editor creates nodes and adds
+    // execution blocks, so we should compare against the editor's full list.
+    // For the core validator, we expose a variant that accepts an external block list.
+    // ── Check 6: Data dependency cycles ────────────────────────────────
+    _DetectDataCycles(allBlocks, addIssue);
+    // Sort: errors first, then warnings
+    issues.sort((a, b) => a.severity - b.severity);
+    return {
+        isValid: issues.every((i) => i.severity !== 0 /* FlowGraphValidationSeverity.Error */),
+        issues,
+        errorCount: issues.filter((i) => i.severity === 0 /* FlowGraphValidationSeverity.Error */).length,
+        warningCount: issues.filter((i) => i.severity === 1 /* FlowGraphValidationSeverity.Warning */).length,
+        issuesByBlock,
+    };
+}
+/**
+ * Extended validation that also checks for unreachable blocks.
+ * Requires a full list of all blocks in the graph (including those not reachable
+ * from event blocks via the normal traversal).
+ *
+ * @param flowGraph - The flow graph to validate.
+ * @param allKnownBlocks - Complete list of all blocks (e.g., from the editor's node set).
+ * @returns The validation result.
+ */
+export function ValidateFlowGraphWithBlockList(flowGraph, allKnownBlocks) {
+    const result = ValidateFlowGraph(flowGraph);
+    // Check for unreachable blocks
+    const reachableIds = new Set();
+    flowGraph.visitAllBlocks((block) => {
+        reachableIds.add(block.uniqueId);
+    });
+    for (const block of allKnownBlocks) {
+        if (!reachableIds.has(block.uniqueId)) {
+            const issue = {
+                severity: 1 /* FlowGraphValidationSeverity.Warning */,
+                message: `Block is unreachable from any event block.`,
+                block,
+            };
+            result.issues.push(issue);
+            result.warningCount++;
+            let arr = result.issuesByBlock.get(block.uniqueId);
+            if (!arr) {
+                arr = [];
+                result.issuesByBlock.set(block.uniqueId, arr);
+            }
+            arr.push(issue);
+            // Also run Check 2 and Check 3 on unreachable blocks so the editor
+            // can display all issues, not just reachability ones.
+            for (const input of block.dataInputs) {
+                if (!input.optional && !input.isDisabled && !input.isConnected()) {
+                    const dataIssue = {
+                        severity: 1 /* FlowGraphValidationSeverity.Warning */,
+                        message: `"${input.name}" is not connected and will use its default value.`,
+                        block,
+                        connectionName: input.name,
+                    };
+                    result.issues.push(dataIssue);
+                    result.warningCount++;
+                    arr.push(dataIssue);
+                }
+            }
+            if (block instanceof FlowGraphExecutionBlock && !_IsEventBlock(block)) {
+                const inSignal = block.signalInputs.find((s) => s.name === "in");
+                if (inSignal && !inSignal.isConnected()) {
+                    const signalIssue = {
+                        severity: 0 /* FlowGraphValidationSeverity.Error */,
+                        message: `Execution block has no incoming signal — it will never execute.`,
+                        block,
+                        connectionName: "in",
+                    };
+                    result.issues.push(signalIssue);
+                    result.errorCount++;
+                    arr.push(signalIssue);
+                }
+            }
+        }
+    }
+    result.isValid = result.issues.every((i) => i.severity !== 0 /* FlowGraphValidationSeverity.Error */);
+    result.issues.sort((a, b) => a.severity - b.severity);
+    return result;
+}
+/**
+ * Get all event blocks from a flow graph.
+ * @param flowGraph - the flow graph
+ * @returns the event blocks
+ */
+function _GetEventBlocks(flowGraph) {
+    const eventBlocks = [];
+    for (const type in flowGraph._eventBlocks) {
+        for (const block of flowGraph._eventBlocks[type]) {
+            eventBlocks.push(block);
+        }
+    }
+    return eventBlocks;
+}
+/**
+ * Detect whether a block is an event block (entry point).
+ * @param block - the block to check
+ * @returns true if it is an event block
+ */
+function _IsEventBlock(block) {
+    return block instanceof FlowGraphEventBlock;
+}
+/**
+ * Detects cycles among data-only blocks.
+ * A data cycle means that block A's output feeds into block B's input, and
+ * block B's output feeds back into block A (directly or indirectly).
+ * This would cause infinite recursion during getValue().
+ * @param allBlocks - all blocks to check
+ * @param addIssue - callback to report issues
+ */
+function _DetectDataCycles(allBlocks, addIssue) {
+    // Build adjacency: for each block, which blocks do its data inputs depend on?
+    // (Data inputs pull values from connected output blocks.)
+    const white = 0; // unvisited
+    const gray = 1; // in current DFS path
+    const black = 2; // fully explored
+    const color = new Map();
+    for (const block of allBlocks) {
+        color.set(block.uniqueId, white);
+    }
+    const blockMap = new Map();
+    for (const block of allBlocks) {
+        blockMap.set(block.uniqueId, block);
+    }
+    const reportedCycleBlocks = new Set();
+    function dfs(block) {
+        color.set(block.uniqueId, gray);
+        for (const input of block.dataInputs) {
+            if (!input.isConnected()) {
+                continue;
+            }
+            for (const connected of input._connectedPoint) {
+                const dep = connected._ownerBlock;
+                // Only consider data-only blocks (not execution blocks which are driven by signals)
+                if (dep instanceof FlowGraphExecutionBlock) {
+                    continue;
+                }
+                const depColor = color.get(dep.uniqueId);
+                if (depColor === gray) {
+                    // Cycle found
+                    if (!reportedCycleBlocks.has(block.uniqueId)) {
+                        reportedCycleBlocks.add(block.uniqueId);
+                        addIssue({
+                            severity: 0 /* FlowGraphValidationSeverity.Error */,
+                            message: `Data dependency cycle detected — getValue() will recurse infinitely.`,
+                            block,
+                        });
+                    }
+                    if (!reportedCycleBlocks.has(dep.uniqueId)) {
+                        reportedCycleBlocks.add(dep.uniqueId);
+                        addIssue({
+                            severity: 0 /* FlowGraphValidationSeverity.Error */,
+                            message: `Data dependency cycle detected — getValue() will recurse infinitely.`,
+                            block: dep,
+                        });
+                    }
+                    return true;
+                }
+                if (depColor === white) {
+                    dfs(dep);
+                }
+            }
+        }
+        color.set(block.uniqueId, black);
+        return false;
+    }
+    for (const block of allBlocks) {
+        if (color.get(block.uniqueId) === white) {
+            dfs(block);
+        }
+    }
+}
+//# sourceMappingURL=flowGraphValidator.js.map

package/FlowGraph/flowGraphValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowGraphValidator.js","sourceRoot":"","sources":["../../../../dev/core/src/FlowGraph/flowGraphValidator.ts"],"names":[],"mappings":"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","sourcesContent":["import type { FlowGraph } from \"./flowGraph\";\nimport type { FlowGraphBlock } from \"./flowGraphBlock\";\nimport { FlowGraphExecutionBlock } from \"./flowGraphExecutionBlock\";\nimport type { FlowGraphDataConnection } from \"./flowGraphDataConnection\";\nimport { FlowGraphTypes } from \"./flowGraphRichTypes\";\nimport { FlowGraphEventBlock } from \"./flowGraphEventBlock\";\nimport type { FlowGraphEventType } from \"./flowGraphEventType\";\n\n/**\n * Severity level for a validation issue.\n */\nexport const enum FlowGraphValidationSeverity {\n    /** A critical issue that will cause runtime failure. */\n    Error,\n    /** A potential issue that may indicate a mistake. */\n    Warning,\n}\n\n/**\n * A single validation issue found in the flow graph.\n */\nexport interface IFlowGraphValidationIssue {\n    /** The severity level. */\n    severity: FlowGraphValidationSeverity;\n    /** Human-readable description of the issue. */\n    message: string;\n    /** The block where the issue was found (if applicable). */\n    block?: FlowGraphBlock;\n    /** The connection name involved (if applicable). */\n    connectionName?: string;\n}\n\n/**\n * The result of validating a flow graph.\n */\nexport interface IFlowGraphValidationResult {\n    /** Whether the graph passed validation with no errors. */\n    isValid: boolean;\n    /** All issues found, ordered by severity (errors first). */\n    issues: IFlowGraphValidationIssue[];\n    /** Convenience: number of error-level issues. */\n    errorCount: number;\n    /** Convenience: number of warning-level issues. */\n    warningCount: number;\n    /** Map from block uniqueId to the issues affecting that block. */\n    issuesByBlock: Map<string, IFlowGraphValidationIssue[]>;\n}\n\n// Types that are mutually coercible and should not produce type-mismatch warnings\nconst NumericLikeTypes = new Set<string>([FlowGraphTypes.Number, FlowGraphTypes.Integer, FlowGraphTypes.Boolean]);\nconst VectorLikeTypes = new Set<string>([FlowGraphTypes.Vector4, FlowGraphTypes.Quaternion]);\nconst ColorLikeTypes = new Set<string>([FlowGraphTypes.Color3, FlowGraphTypes.Color4]);\n\n/**\n * @internal\n */\nfunction _AreTypesCompatible(sourceType: string, targetType: string): boolean {\n    if (sourceType === targetType) {\n        return true;\n    }\n    // \"any\" is compatible with everything\n    if (sourceType === FlowGraphTypes.Any || targetType === FlowGraphTypes.Any) {\n        return true;\n    }\n    // Numeric coercion group\n    if (NumericLikeTypes.has(sourceType) && NumericLikeTypes.has(targetType)) {\n        return true;\n    }\n    // Vector4 / Quaternion are interchangeable\n    if (VectorLikeTypes.has(sourceType) && VectorLikeTypes.has(targetType)) {\n        return true;\n    }\n    // Color3 → Color4 widening is safe\n    if (ColorLikeTypes.has(sourceType) && ColorLikeTypes.has(targetType)) {\n        return true;\n    }\n    return false;\n}\n\n/**\n * Validates a flow graph and returns all issues found.\n *\n * The following checks are performed:\n * 1. **No event blocks** — the graph has no entry points.\n * 2. **Unconnected required data inputs** — a non-optional data input with no connection.\n * 3. **Unconnected signal inputs** — an execution block whose `in` signal has no connection and\n *    that is not an event block (entry point).\n * 4. **Data type mismatches** — a data connection whose source richType is incompatible with the\n *    target richType.\n * 5. **Unreachable blocks** — blocks not reachable from any event block via signal/data traversal.\n * 6. **Data dependency cycles** — circular data-only connections that would cause infinite recursion.\n *\n * @param flowGraph - The flow graph to validate.\n * @returns The validation result.\n */\nexport function ValidateFlowGraph(flowGraph: FlowGraph): IFlowGraphValidationResult {\n    const issues: IFlowGraphValidationIssue[] = [];\n    const issuesByBlock = new Map<string, IFlowGraphValidationIssue[]>();\n\n    const addIssue = (issue: IFlowGraphValidationIssue) => {\n        issues.push(issue);\n        if (issue.block) {\n            let arr = issuesByBlock.get(issue.block.uniqueId);\n            if (!arr) {\n                arr = [];\n                issuesByBlock.set(issue.block.uniqueId, arr);\n            }\n            arr.push(issue);\n        }\n    };\n\n    // Collect ALL blocks via visitAllBlocks\n    const allBlocks: FlowGraphBlock[] = [];\n    flowGraph.visitAllBlocks((block) => {\n        allBlocks.push(block);\n    });\n\n    // ── Check 1: No event blocks ───────────────────────────────────────\n    const eventBlocks = _GetEventBlocks(flowGraph);\n    if (eventBlocks.length === 0) {\n        addIssue({\n            severity: FlowGraphValidationSeverity.Error,\n            message: \"Graph has no event blocks — nothing will trigger execution.\",\n        });\n    }\n\n    // ── Check 2: Unconnected required data inputs ──────────────────────\n    for (const block of allBlocks) {\n        for (const input of block.dataInputs) {\n            if (!input.optional && !input.isDisabled && !input.isConnected()) {\n                addIssue({\n                    severity: FlowGraphValidationSeverity.Warning,\n                    message: `\"${input.name}\" is not connected and will use its default value.`,\n                    block,\n                    connectionName: input.name,\n                });\n            }\n        }\n    }\n\n    // ── Check 3: Unconnected signal inputs on non-event execution blocks\n    for (const block of allBlocks) {\n        if (block instanceof FlowGraphExecutionBlock) {\n            // Skip event blocks — they are entry points and don't need an incoming signal.\n            if (_IsEventBlock(block)) {\n                continue;\n            }\n            const inSignal = block.signalInputs.find((s) => s.name === \"in\");\n            if (inSignal && !inSignal.isConnected()) {\n                addIssue({\n                    severity: FlowGraphValidationSeverity.Error,\n                    message: `Execution block has no incoming signal — it will never execute.`,\n                    block,\n                    connectionName: \"in\",\n                });\n            }\n        }\n    }\n\n    // ── Check 4: Data type mismatches ──────────────────────────────────\n    for (const block of allBlocks) {\n        for (const input of block.dataInputs) {\n            if (!input.isConnected()) {\n                continue;\n            }\n            const source = input._connectedPoint[0] as FlowGraphDataConnection<any>;\n            const srcType = source.richType?.typeName;\n            const tgtType = input.richType?.typeName;\n            if (srcType && tgtType && !_AreTypesCompatible(srcType, tgtType)) {\n                // If either side has a typeTransformer, it's intentionally converted\n                if (source.richType.typeTransformer !== undefined || input.richType.typeTransformer !== undefined) {\n                    continue;\n                }\n                addIssue({\n                    severity: FlowGraphValidationSeverity.Warning,\n                    message: `Type mismatch: \"${source._ownerBlock.name}.${source.name}\" (${srcType}) → \"${block.name}.${input.name}\" (${tgtType}).`,\n                    block,\n                    connectionName: input.name,\n                });\n            }\n        }\n    }\n\n    // ── Check 5: Unreachable blocks ────────────────────────────────────\n    const reachableIds = new Set<string>();\n    flowGraph.visitAllBlocks((block) => {\n        reachableIds.add(block.uniqueId);\n    });\n    // We need to also check standalone data blocks not visited by visitAllBlocks.\n    // visitAllBlocks starts from event blocks; any block not found is unreachable.\n    // Since we can only iterate blocks we know about, the allBlocks list IS\n    // from visitAllBlocks, so everything in it IS reachable.\n    // There's no separate registry of \"all added blocks\" in the FlowGraph.\n    // So: unreachable blocks are blocks that exist but aren't visited.\n    // Currently visitAllBlocks IS our source, so this check is a no-op for\n    // blocks added via the graph. However, the editor creates nodes and adds\n    // execution blocks, so we should compare against the editor's full list.\n    // For the core validator, we expose a variant that accepts an external block list.\n\n    // ── Check 6: Data dependency cycles ────────────────────────────────\n    _DetectDataCycles(allBlocks, addIssue);\n\n    // Sort: errors first, then warnings\n    issues.sort((a, b) => a.severity - b.severity);\n\n    return {\n        isValid: issues.every((i) => i.severity !== FlowGraphValidationSeverity.Error),\n        issues,\n        errorCount: issues.filter((i) => i.severity === FlowGraphValidationSeverity.Error).length,\n        warningCount: issues.filter((i) => i.severity === FlowGraphValidationSeverity.Warning).length,\n        issuesByBlock,\n    };\n}\n\n/**\n * Extended validation that also checks for unreachable blocks.\n * Requires a full list of all blocks in the graph (including those not reachable\n * from event blocks via the normal traversal).\n *\n * @param flowGraph - The flow graph to validate.\n * @param allKnownBlocks - Complete list of all blocks (e.g., from the editor's node set).\n * @returns The validation result.\n */\nexport function ValidateFlowGraphWithBlockList(flowGraph: FlowGraph, allKnownBlocks: FlowGraphBlock[]): IFlowGraphValidationResult {\n    const result = ValidateFlowGraph(flowGraph);\n\n    // Check for unreachable blocks\n    const reachableIds = new Set<string>();\n    flowGraph.visitAllBlocks((block) => {\n        reachableIds.add(block.uniqueId);\n    });\n\n    for (const block of allKnownBlocks) {\n        if (!reachableIds.has(block.uniqueId)) {\n            const issue: IFlowGraphValidationIssue = {\n                severity: FlowGraphValidationSeverity.Warning,\n                message: `Block is unreachable from any event block.`,\n                block,\n            };\n            result.issues.push(issue);\n            result.warningCount++;\n            let arr = result.issuesByBlock.get(block.uniqueId);\n            if (!arr) {\n                arr = [];\n                result.issuesByBlock.set(block.uniqueId, arr);\n            }\n            arr.push(issue);\n\n            // Also run Check 2 and Check 3 on unreachable blocks so the editor\n            // can display all issues, not just reachability ones.\n            for (const input of block.dataInputs) {\n                if (!input.optional && !input.isDisabled && !input.isConnected()) {\n                    const dataIssue: IFlowGraphValidationIssue = {\n                        severity: FlowGraphValidationSeverity.Warning,\n                        message: `\"${input.name}\" is not connected and will use its default value.`,\n                        block,\n                        connectionName: input.name,\n                    };\n                    result.issues.push(dataIssue);\n                    result.warningCount++;\n                    arr.push(dataIssue);\n                }\n            }\n\n            if (block instanceof FlowGraphExecutionBlock && !_IsEventBlock(block)) {\n                const inSignal = block.signalInputs.find((s) => s.name === \"in\");\n                if (inSignal && !inSignal.isConnected()) {\n                    const signalIssue: IFlowGraphValidationIssue = {\n                        severity: FlowGraphValidationSeverity.Error,\n                        message: `Execution block has no incoming signal — it will never execute.`,\n                        block,\n                        connectionName: \"in\",\n                    };\n                    result.issues.push(signalIssue);\n                    result.errorCount++;\n                    arr.push(signalIssue);\n                }\n            }\n        }\n    }\n\n    result.isValid = result.issues.every((i) => i.severity !== FlowGraphValidationSeverity.Error);\n    result.issues.sort((a, b) => a.severity - b.severity);\n    return result;\n}\n\n/**\n * Get all event blocks from a flow graph.\n * @param flowGraph - the flow graph\n * @returns the event blocks\n */\nfunction _GetEventBlocks(flowGraph: FlowGraph): FlowGraphEventBlock[] {\n    const eventBlocks: FlowGraphEventBlock[] = [];\n    for (const type in flowGraph._eventBlocks) {\n        for (const block of flowGraph._eventBlocks[type as FlowGraphEventType]) {\n            eventBlocks.push(block);\n        }\n    }\n    return eventBlocks;\n}\n\n/**\n * Detect whether a block is an event block (entry point).\n * @param block - the block to check\n * @returns true if it is an event block\n */\nfunction _IsEventBlock(block: FlowGraphBlock): boolean {\n    return block instanceof FlowGraphEventBlock;\n}\n\n/**\n * Detects cycles among data-only blocks.\n * A data cycle means that block A's output feeds into block B's input, and\n * block B's output feeds back into block A (directly or indirectly).\n * This would cause infinite recursion during getValue().\n * @param allBlocks - all blocks to check\n * @param addIssue - callback to report issues\n */\nfunction _DetectDataCycles(allBlocks: FlowGraphBlock[], addIssue: (issue: IFlowGraphValidationIssue) => void): void {\n    // Build adjacency: for each block, which blocks do its data inputs depend on?\n    // (Data inputs pull values from connected output blocks.)\n    const white = 0; // unvisited\n    const gray = 1; // in current DFS path\n    const black = 2; // fully explored\n    const color = new Map<string, number>();\n\n    for (const block of allBlocks) {\n        color.set(block.uniqueId, white);\n    }\n\n    const blockMap = new Map<string, FlowGraphBlock>();\n    for (const block of allBlocks) {\n        blockMap.set(block.uniqueId, block);\n    }\n\n    const reportedCycleBlocks = new Set<string>();\n\n    function dfs(block: FlowGraphBlock): boolean {\n        color.set(block.uniqueId, gray);\n        for (const input of block.dataInputs) {\n            if (!input.isConnected()) {\n                continue;\n            }\n            for (const connected of input._connectedPoint) {\n                const dep = (connected as FlowGraphDataConnection<any>)._ownerBlock;\n                // Only consider data-only blocks (not execution blocks which are driven by signals)\n                if (dep instanceof FlowGraphExecutionBlock) {\n                    continue;\n                }\n                const depColor = color.get(dep.uniqueId);\n                if (depColor === gray) {\n                    // Cycle found\n                    if (!reportedCycleBlocks.has(block.uniqueId)) {\n                        reportedCycleBlocks.add(block.uniqueId);\n                        addIssue({\n                            severity: FlowGraphValidationSeverity.Error,\n                            message: `Data dependency cycle detected — getValue() will recurse infinitely.`,\n                            block,\n                        });\n                    }\n                    if (!reportedCycleBlocks.has(dep.uniqueId)) {\n                        reportedCycleBlocks.add(dep.uniqueId);\n                        addIssue({\n                            severity: FlowGraphValidationSeverity.Error,\n                            message: `Data dependency cycle detected — getValue() will recurse infinitely.`,\n                            block: dep,\n                        });\n                    }\n                    return true;\n                }\n                if (depColor === white) {\n                    dfs(dep);\n                }\n            }\n        }\n        color.set(block.uniqueId, black);\n        return false;\n    }\n\n    for (const block of allBlocks) {\n        if (color.get(block.uniqueId) === white) {\n            dfs(block);\n        }\n    }\n}\n"]}

package/FlowGraph/index.d.ts

@@ -14,5 +14,6 @@ export * from "./flowGraphParser.js";
 export * from "./flowGraphPathConverter.js";
 export * from "./flowGraphPathConverterComponent.js";
 export * from "./flowGraphLogger.js";
+export * from "./flowGraphValidator.js";
 export * from "./Blocks/index.js";
 export * from "./CustomTypes/index.js";

package/FlowGraph/index.js

@@ -14,6 +14,7 @@ export * from "./flowGraphParser.js";
 export * from "./flowGraphPathConverter.js";
 export * from "./flowGraphPathConverterComponent.js";
 export * from "./flowGraphLogger.js";
+export * from "./flowGraphValidator.js";
 // eslint-disable-next-line @typescript-eslint/no-restricted-imports
 export * from "./Blocks/index.js";
 // eslint-disable-next-line @typescript-eslint/no-restricted-imports

package/FlowGraph/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../dev/core/src/FlowGraph/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mCAAmC,CAAC;AAClD,cAAc,mBAAmB,CAAC;AAClC,oEAAoE;AACpE,cAAc,gBAAgB,CAAC;AAC/B,oEAAoE;AACpE,cAAc,qBAAqB,CAAC","sourcesContent":["export * from \"./flowGraph\";\r\nexport * from \"./flowGraphBlock\";\r\nexport * from \"./flowGraphSignalConnection\";\r\nexport * from \"./flowGraphExecutionBlock\";\r\nexport * from \"./flowGraphEventBlock\";\r\nexport * from \"./flowGraphRichTypes\";\r\nexport * from \"./flowGraphContext\";\r\nexport * from \"./flowGraphCoordinator\";\r\nexport * from \"./typeDefinitions\";\r\nexport * from \"./flowGraphConnection\";\r\nexport * from \"./flowGraphDataConnection\";\r\nexport * from \"./flowGraphAssetsContext\";\r\nexport * from \"./flowGraphParser\";\r\nexport * from \"./flowGraphPathConverter\";\r\nexport * from \"./flowGraphPathConverterComponent\";\r\nexport * from \"./flowGraphLogger\";\r\n// eslint-disable-next-line @typescript-eslint/no-restricted-imports\r\nexport * from \"./Blocks/index\";\r\n// eslint-disable-next-line @typescript-eslint/no-restricted-imports\r\nexport * from \"./CustomTypes/index\";\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../dev/core/src/FlowGraph/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mCAAmC,CAAC;AAClD,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,oEAAoE;AACpE,cAAc,gBAAgB,CAAC;AAC/B,oEAAoE;AACpE,cAAc,qBAAqB,CAAC","sourcesContent":["export * from \"./flowGraph\";\r\nexport * from \"./flowGraphBlock\";\r\nexport * from \"./flowGraphSignalConnection\";\r\nexport * from \"./flowGraphExecutionBlock\";\r\nexport * from \"./flowGraphEventBlock\";\r\nexport * from \"./flowGraphRichTypes\";\r\nexport * from \"./flowGraphContext\";\r\nexport * from \"./flowGraphCoordinator\";\r\nexport * from \"./typeDefinitions\";\r\nexport * from \"./flowGraphConnection\";\r\nexport * from \"./flowGraphDataConnection\";\r\nexport * from \"./flowGraphAssetsContext\";\r\nexport * from \"./flowGraphParser\";\r\nexport * from \"./flowGraphPathConverter\";\r\nexport * from \"./flowGraphPathConverterComponent\";\r\nexport * from \"./flowGraphLogger\";\r\nexport * from \"./flowGraphValidator\";\r\n// eslint-disable-next-line @typescript-eslint/no-restricted-imports\r\nexport * from \"./Blocks/index\";\r\n// eslint-disable-next-line @typescript-eslint/no-restricted-imports\r\nexport * from \"./CustomTypes/index\";\r\n"]}

package/FlowGraph/serialization.js

@@ -1,3 +1,4 @@
+import { Logger } from "../Misc/logger.js";
 import { Color3, Color4 } from "../Maths/math.color.js";
 import { Matrix, Quaternion, Vector2, Vector3, Vector4 } from "../Maths/math.vector.js";
 import { FlowGraphInteger } from "./CustomTypes/flowGraphInteger.js";
@@ -87,12 +88,18 @@ export function defaultValueSerializationFunction(key, value, serializationObjec
             };
         }
         else {
-            // only if it is not an object
-            if (typeof value !== "object") {
+            if (typeof value !== "object" || value === null) {
                 serializationObject[key] = value;
             }
             else {
-                throw new Error(`Could not serialize value ${value}`);
+                // Plain object (e.g. parsed event config) — store it if JSON-safe,
+                // otherwise skip (e.g. objects containing functions like pathConverter).
+                try {
+                    serializationObject[key] = JSON.parse(JSON.stringify(value));
+                }
+                catch {
+                    Logger.Warn(`FlowGraph serialization: value for key "${key}" is not JSON-serializable and was skipped.`);
+                }
             }
         }
     }

package/FlowGraph/serialization.js.map

@@ -1 +1 @@
-{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../../../../dev/core/src/FlowGraph/serialization.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAGrF,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAkB,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAElF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAErF,SAAS,eAAe,CAAC,SAAiB;IACtC,OAAO,CACH,SAAS,KAAK,MAAM;QACpB,SAAS,KAAK,cAAc;QAC5B,SAAS,KAAK,YAAY;QAC1B,SAAS,KAAK,cAAc;QAC5B,SAAS,KAAK,WAAW;QACzB,SAAS,KAAK,cAAc;QAC5B,SAAS,KAAK,iBAAiB;QAC/B,SAAS,KAAK,WAAW,CAC5B,CAAC;AACN,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAiB;IACxC,OAAO,CACH,SAAS,2CAA2B;QACpC,SAAS,2CAA2B;QACpC,SAAS,2CAA2B;QACpC,SAAS,iDAA8B;QACvC,SAAS,yCAA0B;QACnC,SAAS,yCAA0B,CACtC,CAAC;AACN,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAiB;IACxC,OAAO,SAAS,yCAA0B,IAAI,SAAS,6CAA4B,IAAI,SAAS,6CAA4B,CAAC;AACjI,CAAC;AAED,SAAS,yBAAyB,CAAC,SAAiB;IAChD,OAAO,SAAS,KAAK,gBAAgB,CAAC;AAC1C,CAAC;AAED,SAAS,WAAW,CAAC,SAAiB,EAAE,KAAoB,EAAE,cAAc,GAAG,KAAK;IAChF,IAAI,SAAS,2CAA2B,EAAE,CAAC;QACvC,OAAO,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;SAAM,IAAI,SAAS,2CAA2B,EAAE,CAAC;QAC9C,IAAI,cAAc,EAAE,CAAC;YACjB,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACnB,CAAC;QACD,OAAO,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;SAAM,IAAI,SAAS,2CAA2B,EAAE,CAAC;QAC9C,OAAO,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;SAAM,IAAI,SAAS,iDAA8B,EAAE,CAAC;QACjD,IAAI,cAAc,EAAE,CAAC;YACjB,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;YACf,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACnB,CAAC;QACD,OAAO,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;SAAM,IAAI,SAAS,yCAA0B,EAAE,CAAC;QAC7C,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;SAAM,IAAI,SAAS,yCAA0B,EAAE,CAAC;QAC7C,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,CAAC;SAAM,CAAC;QACJ,MAAM,IAAI,KAAK,CAAC,6BAA6B,SAAS,EAAE,CAAC,CAAC;IAC9D,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,gEAAgE;AAChE,MAAM,UAAU,iCAAiC,CAAC,GAAW,EAAE,KAAU,EAAE,mBAAwB;IAC/F,MAAM,SAAS,GAAG,KAAK,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC;IAChD,IAAI,iBAAiB,CAAC,SAAS,CAAC,IAAI,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/D,mBAAmB,CAAC,GAAG,CAAC,GAAG;YACvB,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE;YACtB,SAAS;SACZ,CAAC;IACN,CAAC;SAAM,IAAI,SAAS,oDAA2B,EAAE,CAAC;QAC9C,mBAAmB,CAAC,GAAG,CAAC,GAAG;YACvB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,SAAS;SACZ,CAAC;IACN,CAAC;SAAM,CAAC;QACJ,IAAI,SAAS,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,mBAAmB,CAAC,GAAG,CAAC,GAAG;gBACvB,EAAE,EAAE,KAAK,CAAC,EAAE;gBACZ,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,SAAS;aACZ,CAAC;QACN,CAAC;aAAM,CAAC;YACJ,8BAA8B;YAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC5B,mBAAmB,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACrC,CAAC;iBAAM,CAAC;gBACJ,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,EAAE,CAAC,CAAC;YAC1D,CAAC;QACL,CAAC;IACL,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,gEAAgE;AAChE,MAAM,UAAU,yBAAyB,CAAC,GAAW,EAAE,mBAAwB,EAAE,eAAgC,EAAE,KAAY;IAC3H,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IACnD,IAAI,UAAU,CAAC;IACf,MAAM,SAAS,GAAG,iBAAiB,EAAE,IAAI,IAAI,iBAAiB,EAAE,SAAS,CAAC;IAC1E,IAAI,eAAe,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,IAAI,KAAK,GAAoB,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;QACpJ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,KAAK,GAAG,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3I,CAAC;QACD,UAAU,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,iBAAiB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACtH,CAAC;SAAM,IAAI,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;QACtC,UAAU,GAAG,WAAW,CAAC,SAAS,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACjE,CAAC;SAAM,IAAI,yBAAyB,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9C,2GAA2G;QAC3G,MAAM,GAAG,GAAG,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,KAAK,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACrF,uHAAuH;QACvH,UAAU,GAAG,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,KAAK,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC1G,CAAC;SAAM,IAAI,SAAS,yCAA0B,EAAE,CAAC;QAC7C,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC3D,CAAC;SAAM,IAAI,SAAS,6CAA4B,EAAE,CAAC;QAC/C,UAAU,GAAG,IAAI,iBAAiB,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;SAAM,IAAI,SAAS,6CAA4B,EAAE,CAAC;QAC/C,UAAU,GAAG,IAAI,iBAAiB,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAChE,CAAC;SAAM,IAAI,SAAS,oDAA2B,EAAE,CAAC;QAC9C,UAAU,GAAG,gBAAgB,CAAC,SAAS,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACrE,CAAC;SAAM,IAAI,SAAS,yCAA0B,IAAI,SAAS,yCAA0B,IAAI,SAAS,2CAA2B,EAAE,CAAC;QAC5H,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;SAAM,IAAI,iBAAiB,IAAI,iBAAiB,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACpE,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC;IACzC,CAAC;SAAM,CAAC;QACJ,IAAI,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,EAAE,CAAC;YACnC,iCAAiC;YACjC,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;gBAC/C,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;oBACjB,OAAO,GAAG,CAAC;gBACf,CAAC;gBACD,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG;oBACV,IAAI,EAAE,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC;iBAC7C,CAAC;gBACF,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;oBACnC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,KAAK,GAAG,yBAAyB,CAAC,OAAO,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;gBACxF,CAAC;gBACD,OAAO,GAAG,CAAC;YACf,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,CAAC;aAAM,CAAC;YACJ,UAAU,GAAG,iBAAiB,CAAC;QACnC,CAAC;IACL,CAAC;IACD,OAAO,UAAU,CAAC;AACtB,CAAC;AAED;;;;;;GAMG;AACH,gEAAgE;AAChE,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAChD,0FAA0F;IAC1F,OAAO,SAAS,kFAA0C,CAAC;AAC/D,CAAC","sourcesContent":["import type { IAssetContainer } from \"core/IAssetContainer\";\r\nimport { Color3, Color4 } from \"../Maths/math.color\";\r\nimport { Matrix, Quaternion, Vector2, Vector3, Vector4 } from \"../Maths/math.vector\";\r\nimport type { Scene } from \"../scene\";\r\nimport { FlowGraphBlockNames } from \"./Blocks/flowGraphBlockNames\";\r\nimport { FlowGraphInteger } from \"./CustomTypes/flowGraphInteger\";\r\nimport { FlowGraphTypes, getRichTypeByFlowGraphType } from \"./flowGraphRichTypes\";\r\nimport type { TransformNode } from \"core/Meshes/transformNode\";\r\nimport { FlowGraphMatrix2D, FlowGraphMatrix3D } from \"./CustomTypes/flowGraphMatrix\";\r\n\r\nfunction IsMeshClassName(className: string) {\r\n    return (\r\n        className === \"Mesh\" ||\r\n        className === \"AbstractMesh\" ||\r\n        className === \"GroundMesh\" ||\r\n        className === \"InstanceMesh\" ||\r\n        className === \"LinesMesh\" ||\r\n        className === \"GoldbergMesh\" ||\r\n        className === \"GreasedLineMesh\" ||\r\n        className === \"TrailMesh\"\r\n    );\r\n}\r\n\r\nfunction IsVectorClassName(className: string) {\r\n    return (\r\n        className === FlowGraphTypes.Vector2 ||\r\n        className === FlowGraphTypes.Vector3 ||\r\n        className === FlowGraphTypes.Vector4 ||\r\n        className === FlowGraphTypes.Quaternion ||\r\n        className === FlowGraphTypes.Color3 ||\r\n        className === FlowGraphTypes.Color4\r\n    );\r\n}\r\n\r\nfunction IsMatrixClassName(className: string) {\r\n    return className === FlowGraphTypes.Matrix || className === FlowGraphTypes.Matrix2D || className === FlowGraphTypes.Matrix3D;\r\n}\r\n\r\nfunction IsAnimationGroupClassName(className: string) {\r\n    return className === \"AnimationGroup\";\r\n}\r\n\r\nfunction ParseVector(className: string, value: Array<number>, flipHandedness = false) {\r\n    if (className === FlowGraphTypes.Vector2) {\r\n        return Vector2.FromArray(value);\r\n    } else if (className === FlowGraphTypes.Vector3) {\r\n        if (flipHandedness) {\r\n            value[2] *= -1;\r\n        }\r\n        return Vector3.FromArray(value);\r\n    } else if (className === FlowGraphTypes.Vector4) {\r\n        return Vector4.FromArray(value);\r\n    } else if (className === FlowGraphTypes.Quaternion) {\r\n        if (flipHandedness) {\r\n            value[2] *= -1;\r\n            value[3] *= -1;\r\n        }\r\n        return Quaternion.FromArray(value);\r\n    } else if (className === FlowGraphTypes.Color3) {\r\n        return new Color3(value[0], value[1], value[2]);\r\n    } else if (className === FlowGraphTypes.Color4) {\r\n        return new Color4(value[0], value[1], value[2], value[3]);\r\n    } else {\r\n        throw new Error(`Unknown vector class name ${className}`);\r\n    }\r\n}\r\n\r\n/**\r\n * The default function that serializes values in a context object to a serialization object\r\n * @param key the key where the value should be stored in the serialization object\r\n * @param value the value to store\r\n * @param serializationObject the object where the value will be stored\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nexport function defaultValueSerializationFunction(key: string, value: any, serializationObject: any) {\r\n    const className = value?.getClassName?.() ?? \"\";\r\n    if (IsVectorClassName(className) || IsMatrixClassName(className)) {\r\n        serializationObject[key] = {\r\n            value: value.asArray(),\r\n            className,\r\n        };\r\n    } else if (className === FlowGraphTypes.Integer) {\r\n        serializationObject[key] = {\r\n            value: value.value,\r\n            className,\r\n        };\r\n    } else {\r\n        if (className && (value.id || value.name)) {\r\n            serializationObject[key] = {\r\n                id: value.id,\r\n                name: value.name,\r\n                className,\r\n            };\r\n        } else {\r\n            // only if it is not an object\r\n            if (typeof value !== \"object\") {\r\n                serializationObject[key] = value;\r\n            } else {\r\n                throw new Error(`Could not serialize value ${value}`);\r\n            }\r\n        }\r\n    }\r\n}\r\n\r\n/**\r\n * The default function that parses values stored in a serialization object\r\n * @param key the key to the value that will be parsed\r\n * @param serializationObject the object that will be parsed\r\n * @param assetsContainer the assets container that will be used to find the objects\r\n * @param scene\r\n * @returns\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nexport function defaultValueParseFunction(key: string, serializationObject: any, assetsContainer: IAssetContainer, scene: Scene) {\r\n    const intermediateValue = serializationObject[key];\r\n    let finalValue;\r\n    const className = intermediateValue?.type ?? intermediateValue?.className;\r\n    if (IsMeshClassName(className)) {\r\n        let nodes: TransformNode[] = scene.meshes.filter((m) => (intermediateValue.id ? m.id === intermediateValue.id : m.name === intermediateValue.name));\r\n        if (nodes.length === 0) {\r\n            nodes = scene.transformNodes.filter((m) => (intermediateValue.id ? m.id === intermediateValue.id : m.name === intermediateValue.name));\r\n        }\r\n        finalValue = intermediateValue.uniqueId ? nodes.find((m) => m.uniqueId === intermediateValue.uniqueId) : nodes[0];\r\n    } else if (IsVectorClassName(className)) {\r\n        finalValue = ParseVector(className, intermediateValue.value);\r\n    } else if (IsAnimationGroupClassName(className)) {\r\n        // do not use the scene.getAnimationGroupByName because it is possible that two AGs will have the same name\r\n        const ags = scene.animationGroups.filter((ag) => ag.name === intermediateValue.name);\r\n        // uniqueId changes on each load. this is used for the glTF loader, that uses serialization after the scene was loaded.\r\n        finalValue = ags.length === 1 ? ags[0] : ags.find((ag) => ag.uniqueId === intermediateValue.uniqueId);\r\n    } else if (className === FlowGraphTypes.Matrix) {\r\n        finalValue = Matrix.FromArray(intermediateValue.value);\r\n    } else if (className === FlowGraphTypes.Matrix2D) {\r\n        finalValue = new FlowGraphMatrix2D(intermediateValue.value);\r\n    } else if (className === FlowGraphTypes.Matrix3D) {\r\n        finalValue = new FlowGraphMatrix3D(intermediateValue.value);\r\n    } else if (className === FlowGraphTypes.Integer) {\r\n        finalValue = FlowGraphInteger.FromValue(intermediateValue.value);\r\n    } else if (className === FlowGraphTypes.Number || className === FlowGraphTypes.String || className === FlowGraphTypes.Boolean) {\r\n        finalValue = intermediateValue.value[0];\r\n    } else if (intermediateValue && intermediateValue.value !== undefined) {\r\n        finalValue = intermediateValue.value;\r\n    } else {\r\n        if (Array.isArray(intermediateValue)) {\r\n            // configuration data of an event\r\n            finalValue = intermediateValue.reduce((acc, val) => {\r\n                if (!val.eventData) {\r\n                    return acc;\r\n                }\r\n                acc[val.id] = {\r\n                    type: getRichTypeByFlowGraphType(val.type),\r\n                };\r\n                if (typeof val.value !== \"undefined\") {\r\n                    acc[val.id].value = defaultValueParseFunction(\"value\", val, assetsContainer, scene);\r\n                }\r\n                return acc;\r\n            }, {});\r\n        } else {\r\n            finalValue = intermediateValue;\r\n        }\r\n    }\r\n    return finalValue;\r\n}\r\n\r\n/**\r\n * Given a name of a flow graph block class, return if this\r\n * class needs to be created with a path converter. Used in\r\n * parsing.\r\n * @param className the name of the flow graph block class\r\n * @returns a boolean indicating if the class needs a path converter\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nexport function needsPathConverter(className: string) {\r\n    // I am not using the ClassName property here because it was causing a circular dependency\r\n    return className === FlowGraphBlockNames.JsonPointerParser;\r\n}\r\n"]}
+{"version":3,"file":"serialization.js","sourceRoot":"","sources":["../../../../dev/core/src/FlowGraph/serialization.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IAssetContainer } from \"core/IAssetContainer\";\r\nimport { Logger } from \"../Misc/logger\";\r\nimport { Color3, Color4 } from \"../Maths/math.color\";\r\nimport { Matrix, Quaternion, Vector2, Vector3, Vector4 } from \"../Maths/math.vector\";\r\nimport type { Scene } from \"../scene\";\r\nimport { FlowGraphBlockNames } from \"./Blocks/flowGraphBlockNames\";\r\nimport { FlowGraphInteger } from \"./CustomTypes/flowGraphInteger\";\r\nimport { FlowGraphTypes, getRichTypeByFlowGraphType } from \"./flowGraphRichTypes\";\r\nimport type { TransformNode } from \"core/Meshes/transformNode\";\r\nimport { FlowGraphMatrix2D, FlowGraphMatrix3D } from \"./CustomTypes/flowGraphMatrix\";\r\n\r\nfunction IsMeshClassName(className: string) {\r\n    return (\r\n        className === \"Mesh\" ||\r\n        className === \"AbstractMesh\" ||\r\n        className === \"GroundMesh\" ||\r\n        className === \"InstanceMesh\" ||\r\n        className === \"LinesMesh\" ||\r\n        className === \"GoldbergMesh\" ||\r\n        className === \"GreasedLineMesh\" ||\r\n        className === \"TrailMesh\"\r\n    );\r\n}\r\n\r\nfunction IsVectorClassName(className: string) {\r\n    return (\r\n        className === FlowGraphTypes.Vector2 ||\r\n        className === FlowGraphTypes.Vector3 ||\r\n        className === FlowGraphTypes.Vector4 ||\r\n        className === FlowGraphTypes.Quaternion ||\r\n        className === FlowGraphTypes.Color3 ||\r\n        className === FlowGraphTypes.Color4\r\n    );\r\n}\r\n\r\nfunction IsMatrixClassName(className: string) {\r\n    return className === FlowGraphTypes.Matrix || className === FlowGraphTypes.Matrix2D || className === FlowGraphTypes.Matrix3D;\r\n}\r\n\r\nfunction IsAnimationGroupClassName(className: string) {\r\n    return className === \"AnimationGroup\";\r\n}\r\n\r\nfunction ParseVector(className: string, value: Array<number>, flipHandedness = false) {\r\n    if (className === FlowGraphTypes.Vector2) {\r\n        return Vector2.FromArray(value);\r\n    } else if (className === FlowGraphTypes.Vector3) {\r\n        if (flipHandedness) {\r\n            value[2] *= -1;\r\n        }\r\n        return Vector3.FromArray(value);\r\n    } else if (className === FlowGraphTypes.Vector4) {\r\n        return Vector4.FromArray(value);\r\n    } else if (className === FlowGraphTypes.Quaternion) {\r\n        if (flipHandedness) {\r\n            value[2] *= -1;\r\n            value[3] *= -1;\r\n        }\r\n        return Quaternion.FromArray(value);\r\n    } else if (className === FlowGraphTypes.Color3) {\r\n        return new Color3(value[0], value[1], value[2]);\r\n    } else if (className === FlowGraphTypes.Color4) {\r\n        return new Color4(value[0], value[1], value[2], value[3]);\r\n    } else {\r\n        throw new Error(`Unknown vector class name ${className}`);\r\n    }\r\n}\r\n\r\n/**\r\n * The default function that serializes values in a context object to a serialization object\r\n * @param key the key where the value should be stored in the serialization object\r\n * @param value the value to store\r\n * @param serializationObject the object where the value will be stored\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nexport function defaultValueSerializationFunction(key: string, value: any, serializationObject: any) {\r\n    const className = value?.getClassName?.() ?? \"\";\r\n    if (IsVectorClassName(className) || IsMatrixClassName(className)) {\r\n        serializationObject[key] = {\r\n            value: value.asArray(),\r\n            className,\r\n        };\r\n    } else if (className === FlowGraphTypes.Integer) {\r\n        serializationObject[key] = {\r\n            value: value.value,\r\n            className,\r\n        };\r\n    } else {\r\n        if (className && (value.id || value.name)) {\r\n            serializationObject[key] = {\r\n                id: value.id,\r\n                name: value.name,\r\n                className,\r\n            };\r\n        } else {\r\n            if (typeof value !== \"object\" || value === null) {\r\n                serializationObject[key] = value;\r\n            } else {\r\n                // Plain object (e.g. parsed event config) — store it if JSON-safe,\r\n                // otherwise skip (e.g. objects containing functions like pathConverter).\r\n                try {\r\n                    serializationObject[key] = JSON.parse(JSON.stringify(value));\r\n                } catch {\r\n                    Logger.Warn(`FlowGraph serialization: value for key \"${key}\" is not JSON-serializable and was skipped.`);\r\n                }\r\n            }\r\n        }\r\n    }\r\n}\r\n\r\n/**\r\n * The default function that parses values stored in a serialization object\r\n * @param key the key to the value that will be parsed\r\n * @param serializationObject the object that will be parsed\r\n * @param assetsContainer the assets container that will be used to find the objects\r\n * @param scene\r\n * @returns\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nexport function defaultValueParseFunction(key: string, serializationObject: any, assetsContainer: IAssetContainer, scene: Scene) {\r\n    const intermediateValue = serializationObject[key];\r\n    let finalValue;\r\n    const className = intermediateValue?.type ?? intermediateValue?.className;\r\n    if (IsMeshClassName(className)) {\r\n        let nodes: TransformNode[] = scene.meshes.filter((m) => (intermediateValue.id ? m.id === intermediateValue.id : m.name === intermediateValue.name));\r\n        if (nodes.length === 0) {\r\n            nodes = scene.transformNodes.filter((m) => (intermediateValue.id ? m.id === intermediateValue.id : m.name === intermediateValue.name));\r\n        }\r\n        finalValue = intermediateValue.uniqueId ? nodes.find((m) => m.uniqueId === intermediateValue.uniqueId) : nodes[0];\r\n    } else if (IsVectorClassName(className)) {\r\n        finalValue = ParseVector(className, intermediateValue.value);\r\n    } else if (IsAnimationGroupClassName(className)) {\r\n        // do not use the scene.getAnimationGroupByName because it is possible that two AGs will have the same name\r\n        const ags = scene.animationGroups.filter((ag) => ag.name === intermediateValue.name);\r\n        // uniqueId changes on each load. this is used for the glTF loader, that uses serialization after the scene was loaded.\r\n        finalValue = ags.length === 1 ? ags[0] : ags.find((ag) => ag.uniqueId === intermediateValue.uniqueId);\r\n    } else if (className === FlowGraphTypes.Matrix) {\r\n        finalValue = Matrix.FromArray(intermediateValue.value);\r\n    } else if (className === FlowGraphTypes.Matrix2D) {\r\n        finalValue = new FlowGraphMatrix2D(intermediateValue.value);\r\n    } else if (className === FlowGraphTypes.Matrix3D) {\r\n        finalValue = new FlowGraphMatrix3D(intermediateValue.value);\r\n    } else if (className === FlowGraphTypes.Integer) {\r\n        finalValue = FlowGraphInteger.FromValue(intermediateValue.value);\r\n    } else if (className === FlowGraphTypes.Number || className === FlowGraphTypes.String || className === FlowGraphTypes.Boolean) {\r\n        finalValue = intermediateValue.value[0];\r\n    } else if (intermediateValue && intermediateValue.value !== undefined) {\r\n        finalValue = intermediateValue.value;\r\n    } else {\r\n        if (Array.isArray(intermediateValue)) {\r\n            // configuration data of an event\r\n            finalValue = intermediateValue.reduce((acc, val) => {\r\n                if (!val.eventData) {\r\n                    return acc;\r\n                }\r\n                acc[val.id] = {\r\n                    type: getRichTypeByFlowGraphType(val.type),\r\n                };\r\n                if (typeof val.value !== \"undefined\") {\r\n                    acc[val.id].value = defaultValueParseFunction(\"value\", val, assetsContainer, scene);\r\n                }\r\n                return acc;\r\n            }, {});\r\n        } else {\r\n            finalValue = intermediateValue;\r\n        }\r\n    }\r\n    return finalValue;\r\n}\r\n\r\n/**\r\n * Given a name of a flow graph block class, return if this\r\n * class needs to be created with a path converter. Used in\r\n * parsing.\r\n * @param className the name of the flow graph block class\r\n * @returns a boolean indicating if the class needs a path converter\r\n */\r\n// eslint-disable-next-line @typescript-eslint/naming-convention\r\nexport function needsPathConverter(className: string) {\r\n    // I am not using the ClassName property here because it was causing a circular dependency\r\n    return className === FlowGraphBlockNames.JsonPointerParser;\r\n}\r\n"]}