@onerjs/core 8.54.4 → 8.54.6

package/FlowGraph/Blocks/Data/Utils/flowGraphArrayIndexBlock.pure.js.map

@@ -1 +1 @@
-{"version":3,"file":"flowGraphArrayIndexBlock.pure.js","sourceRoot":"","sources":["../../../../../../../dev/core/src/FlowGraph/Blocks/Data/Utils/flowGraphArrayIndexBlock.pure.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,OAAO,EAAqC,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGlG,OAAO,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAErE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AACpF,OAAO,EAAwB,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE7E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;GAEG;AACH,MAAM,OAAO,wBAAkC,SAAQ,cAAc;IAgBjE;;;OAGG;IACH,YAA4B,MAAoC;QAC5D,KAAK,CAAC,MAAM,CAAC,CAAC;QADU,WAAM,GAAN,MAAM,CAA8B;QAG5D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAC1D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpF,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACa,cAAc,CAAC,OAAyB;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5D,IAAI,KAAK,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC9C,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACvC,CAAC;IACL,CAAC;IAED;;;OAGG;IACa,SAAS,CAAC,mBAAyB;QAC/C,KAAK,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;IACzC,CAAC;IAEe,YAAY;QACxB,uEAAsC;IAC1C,CAAC;CACJ;AAED,IAAI,WAAW,GAAG,KAAK,CAAC;AACxB;;;GAGG;AACH,MAAM,UAAU,gCAAgC;IAC5C,IAAI,WAAW,EAAE,CAAC;QACd,OAAO;IACX,CAAC;IACD,WAAW,GAAG,IAAI,CAAC;IAEnB,aAAa,kEAAiC,wBAAwB,CAAC,CAAC;AAC5E,CAAC","sourcesContent":["/** This file must only contain pure code and pure imports */\n\nimport { type IFlowGraphBlockConfiguration, FlowGraphBlock } from \"core/FlowGraph/flowGraphBlock\";\nimport { type FlowGraphContext } from \"core/FlowGraph/flowGraphContext\";\nimport { type FlowGraphDataConnection } from \"core/FlowGraph/flowGraphDataConnection.pure\";\nimport { RichTypeAny } from \"core/FlowGraph/flowGraphRichTypes.pure\";\nimport { FlowGraphBlockNames } from \"../../flowGraphBlockNames\";\nimport { FlowGraphInteger } from \"core/FlowGraph/CustomTypes/flowGraphInteger.pure\";\nimport { type FlowGraphNumber, getNumericValue } from \"core/FlowGraph/utils\";\nimport { type Nullable } from \"core/types\";\nimport { RegisterClass } from \"core/Misc/typeStore\";\n\n/**\n * This simple Util block takes an array as input and selects a single element from it.\n */\nexport class FlowGraphArrayIndexBlock<T = any> extends FlowGraphBlock {\n    /**\n     * Input connection: The array to select from.\n     */\n    public readonly array: FlowGraphDataConnection<T[]>;\n\n    /**\n     * Input connection: The index to select.\n     */\n    public readonly index: FlowGraphDataConnection<FlowGraphNumber>;\n\n    /**\n     * Output connection: The selected element.\n     */\n    public readonly value: FlowGraphDataConnection<Nullable<T>>;\n\n    /**\n     * Construct a FlowGraphArrayIndexBlock.\n     * @param config construction parameters\n     */\n    constructor(public override config: IFlowGraphBlockConfiguration) {\n        super(config);\n\n        this.array = this.registerDataInput(\"array\", RichTypeAny);\n        this.index = this.registerDataInput(\"index\", RichTypeAny, new FlowGraphInteger(-1));\n        this.value = this.registerDataOutput(\"value\", RichTypeAny);\n    }\n\n    /**\n     * @internal\n     */\n    public override _updateOutputs(context: FlowGraphContext): void {\n        const array = this.array.getValue(context);\n        const index = getNumericValue(this.index.getValue(context));\n        if (array && index >= 0 && index < array.length) {\n            this.value.setValue(array[index], context);\n        } else {\n            this.value.setValue(null, context);\n        }\n    }\n\n    /**\n     * Serializes this block\n     * @param serializationObject the object to serialize to\n     */\n    public override serialize(serializationObject?: any): void {\n        super.serialize(serializationObject);\n    }\n\n    public override getClassName(): string {\n        return FlowGraphBlockNames.ArrayIndex;\n    }\n}\n\nlet _Registered = false;\n/**\n * Register side effects for flowGraphArrayIndexBlock.\n * Safe to call multiple times; only the first call has an effect.\n */\nexport function RegisterFlowGraphArrayIndexBlock(): void {\n    if (_Registered) {\n        return;\n    }\n    _Registered = true;\n\n    RegisterClass(FlowGraphBlockNames.ArrayIndex, FlowGraphArrayIndexBlock);\n}\n"]}
+{"version":3,"file":"flowGraphArrayIndexBlock.pure.js","sourceRoot":"","sources":["../../../../../../../dev/core/src/FlowGraph/Blocks/Data/Utils/flowGraphArrayIndexBlock.pure.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,OAAO,EAAqC,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGlG,OAAO,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAErE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC;AACpF,OAAO,EAAwB,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE7E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;GAEG;AACH,MAAM,OAAO,wBAAkC,SAAQ,cAAc;IAgBjE;;;OAGG;IACH,YAA4B,MAAoC;QAC5D,KAAK,CAAC,MAAM,CAAC,CAAC;QADU,WAAM,GAAN,MAAM,CAA8B;QAG5D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QAC1D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACpF,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACa,cAAc,CAAC,OAAyB;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC9C,yFAAyF;QACzF,oDAAoD;QACpD,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC9C,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACnC,OAAO;QACX,CAAC;QACD,0FAA0F;QAC1F,uCAAuC;QACvC,IAAI,KAAa,CAAC;QAClB,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC/B,MAAM,OAAO,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;YACvD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBACxB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBACnC,OAAO;YACX,CAAC;YACD,KAAK,GAAG,OAAO,CAAC;QACpB,CAAC;aAAM,CAAC;YACJ,KAAK,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,KAAK,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC9C,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACvC,CAAC;IACL,CAAC;IAED;;;OAGG;IACa,SAAS,CAAC,mBAAyB;QAC/C,KAAK,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;IACzC,CAAC;IAEe,YAAY;QACxB,uEAAsC;IAC1C,CAAC;CACJ;AAED,IAAI,WAAW,GAAG,KAAK,CAAC;AACxB;;;GAGG;AACH,MAAM,UAAU,gCAAgC;IAC5C,IAAI,WAAW,EAAE,CAAC;QACd,OAAO;IACX,CAAC;IACD,WAAW,GAAG,IAAI,CAAC;IAEnB,aAAa,kEAAiC,wBAAwB,CAAC,CAAC;AAC5E,CAAC","sourcesContent":["/** This file must only contain pure code and pure imports */\n\nimport { type IFlowGraphBlockConfiguration, FlowGraphBlock } from \"core/FlowGraph/flowGraphBlock\";\nimport { type FlowGraphContext } from \"core/FlowGraph/flowGraphContext\";\nimport { type FlowGraphDataConnection } from \"core/FlowGraph/flowGraphDataConnection.pure\";\nimport { RichTypeAny } from \"core/FlowGraph/flowGraphRichTypes.pure\";\nimport { FlowGraphBlockNames } from \"../../flowGraphBlockNames\";\nimport { FlowGraphInteger } from \"core/FlowGraph/CustomTypes/flowGraphInteger.pure\";\nimport { type FlowGraphNumber, getNumericValue } from \"core/FlowGraph/utils\";\nimport { type Nullable } from \"core/types\";\nimport { RegisterClass } from \"core/Misc/typeStore\";\n\n/**\n * This simple Util block takes an array as input and selects a single element from it.\n */\nexport class FlowGraphArrayIndexBlock<T = any> extends FlowGraphBlock {\n    /**\n     * Input connection: The array to select from.\n     */\n    public readonly array: FlowGraphDataConnection<T[]>;\n\n    /**\n     * Input connection: The index to select.\n     */\n    public readonly index: FlowGraphDataConnection<FlowGraphNumber>;\n\n    /**\n     * Output connection: The selected element.\n     */\n    public readonly value: FlowGraphDataConnection<Nullable<T>>;\n\n    /**\n     * Construct a FlowGraphArrayIndexBlock.\n     * @param config construction parameters\n     */\n    constructor(public override config: IFlowGraphBlockConfiguration) {\n        super(config);\n\n        this.array = this.registerDataInput(\"array\", RichTypeAny);\n        this.index = this.registerDataInput(\"index\", RichTypeAny, new FlowGraphInteger(-1));\n        this.value = this.registerDataOutput(\"value\", RichTypeAny);\n    }\n\n    /**\n     * @internal\n     */\n    public override _updateOutputs(context: FlowGraphContext): void {\n        const array = this.array.getValue(context);\n        const rawIndex = this.index.getValue(context);\n        // An undefined or unconnected input short-circuits to a null output rather than crashing\n        // `getNumericValue` on a missing `.value` property.\n        if (rawIndex === undefined || rawIndex === null) {\n            this.value.setValue(null, context);\n            return;\n        }\n        // A string index is an opaque reference whose format the host environment owns, so ask it\n        // which element the reference denotes.\n        let index: number;\n        if (typeof rawIndex === \"string\") {\n            const decoded = context.decodeIndexReference(rawIndex);\n            if (decoded === undefined) {\n                this.value.setValue(null, context);\n                return;\n            }\n            index = decoded;\n        } else {\n            index = getNumericValue(rawIndex);\n        }\n        if (array && index >= 0 && index < array.length) {\n            this.value.setValue(array[index], context);\n        } else {\n            this.value.setValue(null, context);\n        }\n    }\n\n    /**\n     * Serializes this block\n     * @param serializationObject the object to serialize to\n     */\n    public override serialize(serializationObject?: any): void {\n        super.serialize(serializationObject);\n    }\n\n    public override getClassName(): string {\n        return FlowGraphBlockNames.ArrayIndex;\n    }\n}\n\nlet _Registered = false;\n/**\n * Register side effects for flowGraphArrayIndexBlock.\n * Safe to call multiple times; only the first call has an effect.\n */\nexport function RegisterFlowGraphArrayIndexBlock(): void {\n    if (_Registered) {\n        return;\n    }\n    _Registered = true;\n\n    RegisterClass(FlowGraphBlockNames.ArrayIndex, FlowGraphArrayIndexBlock);\n}\n"]}

package/FlowGraph/Blocks/Data/flowGraphCachedOperationBlock.d.ts

@@ -14,6 +14,7 @@ export declare abstract class FlowGraphCachedOperationBlock<OutputT> extends Flo
      * Output connection: Whether the value is valid.
      */
     readonly isValid: FlowGraphDataConnection<boolean>;
+    private readonly _outputRichType;
     constructor(outputRichType: RichType<OutputT>, config?: IFlowGraphBlockConfiguration);
     /**
      * @internal
@@ -21,5 +22,22 @@ export declare abstract class FlowGraphCachedOperationBlock<OutputT> extends Flo
      * @param context the graph context
      */
     abstract _doOperation(context: FlowGraphContext): OutputT | undefined;
+    /**
+     * The value delivered on the `value` output when the operation cannot produce a result.
+     *
+     * Defaults to the output type's default value. Override this when a block defines a different
+     * value for that case, for example a polymorphic block whose output type is only known from its
+     * inputs. Implementations must return a fresh value rather than a shared instance, because
+     * consumers may mutate the value they receive.
+     * @param _context the graph context
+     * @returns the value to deliver alongside `isValid = false`
+     */
+    protected _getInvalidOutputValue(_context: FlowGraphContext): OutputT;
     _updateOutputs(context: FlowGraphContext): void;
+    /**
+     * Reports the operation as invalid. `value` is still assigned, so it never reports a stale
+     * result from an earlier execution nor an undefined value on the first one.
+     * @param context the graph context
+     */
+    private _setInvalid;
 }

package/FlowGraph/Blocks/Data/flowGraphCachedOperationBlock.js

@@ -8,9 +8,27 @@ const CacheExecIdName = "cachedExecutionId";
 export class FlowGraphCachedOperationBlock extends FlowGraphBlock {
     constructor(outputRichType, config) {
         super(config);
+        this._outputRichType = outputRichType;
         this.value = this.registerDataOutput("value", outputRichType);
         this.isValid = this.registerDataOutput("isValid", RichTypeBoolean);
     }
+    /**
+     * The value delivered on the `value` output when the operation cannot produce a result.
+     *
+     * Defaults to the output type's default value. Override this when a block defines a different
+     * value for that case, for example a polymorphic block whose output type is only known from its
+     * inputs. Implementations must return a fresh value rather than a shared instance, because
+     * consumers may mutate the value they receive.
+     * @param _context the graph context
+     * @returns the value to deliver alongside `isValid = false`
+     */
+    _getInvalidOutputValue(_context) {
+        const defaultValue = this._outputRichType.defaultValue;
+        // The rich type defaults for object types (vectors, matrices, ...) are shared instances, so
+        // hand out a copy to keep a consumer from mutating the default for every other block.
+        const clone = defaultValue?.clone;
+        return typeof clone === "function" ? clone.call(defaultValue) : defaultValue;
+    }
     _updateOutputs(context) {
         const cachedExecutionId = context._getExecutionVariable(this, CacheExecIdName, -1);
         const cachedValue = context._getExecutionVariable(this, CacheName, null);
@@ -22,7 +40,7 @@ export class FlowGraphCachedOperationBlock extends FlowGraphBlock {
             try {
                 const calculatedValue = this._doOperation(context);
                 if (calculatedValue === undefined || calculatedValue === null) {
-                    this.isValid.setValue(false, context);
+                    this._setInvalid(context);
                     return;
                 }
                 context._setExecutionVariable(this, CacheName, calculatedValue);
@@ -31,9 +49,18 @@ export class FlowGraphCachedOperationBlock extends FlowGraphBlock {
                 this.isValid.setValue(true, context);
             }
             catch (e) {
-                this.isValid.setValue(false, context);
+                this._setInvalid(context);
             }
         }
     }
+    /**
+     * Reports the operation as invalid. `value` is still assigned, so it never reports a stale
+     * result from an earlier execution nor an undefined value on the first one.
+     * @param context the graph context
+     */
+    _setInvalid(context) {
+        this.isValid.setValue(false, context);
+        this.value.setValue(this._getInvalidOutputValue(context), context);
+    }
 }
 //# sourceMappingURL=flowGraphCachedOperationBlock.js.map

package/FlowGraph/Blocks/Data/flowGraphCachedOperationBlock.js.map

@@ -1 +1 @@
-{"version":3,"file":"flowGraphCachedOperationBlock.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FlowGraph/Blocks/Data/flowGraphCachedOperationBlock.ts"],"names":[],"mappings":"AACA,OAAO,EAAqC,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGzF,OAAO,EAAiB,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAE/E,MAAM,SAAS,GAAG,sBAAsB,CAAC;AACzC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAE5C;;GAEG;AACH,MAAM,OAAgB,6BAAuC,SAAQ,cAAc;IAW/E,YAAY,cAAiC,EAAE,MAAqC;QAChF,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC9D,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IACvE,CAAC;IASe,cAAc,CAAC,OAAyB;QACpD,MAAM,iBAAiB,GAAG,OAAO,CAAC,qBAAqB,CAAC,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC;QACnF,MAAM,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAoB,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QAC5F,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,IAAI,IAAI,iBAAiB,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC;YACjG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACrC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC;gBACD,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;gBACnD,IAAI,eAAe,KAAK,SAAS,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;oBAC5D,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;oBACtC,OAAO;gBACX,CAAC;gBACD,OAAO,CAAC,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;gBAChE,OAAO,CAAC,qBAAqB,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;gBAC1E,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;gBAC9C,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACzC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACT,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC1C,CAAC;QACL,CAAC;IACL,CAAC;CACJ","sourcesContent":["import { type Nullable } from \"../../../types\";\r\nimport { type IFlowGraphBlockConfiguration, FlowGraphBlock } from \"../../flowGraphBlock\";\r\nimport { type FlowGraphContext } from \"../../flowGraphContext\";\r\nimport { type FlowGraphDataConnection } from \"../../flowGraphDataConnection\";\r\nimport { type RichType, RichTypeBoolean } from \"../../flowGraphRichTypes.pure\";\r\n\r\nconst CacheName = \"cachedOperationValue\";\r\nconst CacheExecIdName = \"cachedExecutionId\";\r\n\r\n/**\r\n * A block that will cache the result of an operation and deliver it as an output.\r\n */\r\nexport abstract class FlowGraphCachedOperationBlock<OutputT> extends FlowGraphBlock {\r\n    /**\r\n     * The output of the operation\r\n     */\r\n    public readonly value: FlowGraphDataConnection<OutputT>;\r\n\r\n    /**\r\n     * Output connection: Whether the value is valid.\r\n     */\r\n    public readonly isValid: FlowGraphDataConnection<boolean>;\r\n\r\n    constructor(outputRichType: RichType<OutputT>, config?: IFlowGraphBlockConfiguration) {\r\n        super(config);\r\n\r\n        this.value = this.registerDataOutput(\"value\", outputRichType);\r\n        this.isValid = this.registerDataOutput(\"isValid\", RichTypeBoolean);\r\n    }\r\n\r\n    /**\r\n     * @internal\r\n     * Operation to realize\r\n     * @param context the graph context\r\n     */\r\n    public abstract _doOperation(context: FlowGraphContext): OutputT | undefined;\r\n\r\n    public override _updateOutputs(context: FlowGraphContext) {\r\n        const cachedExecutionId = context._getExecutionVariable(this, CacheExecIdName, -1);\r\n        const cachedValue = context._getExecutionVariable<Nullable<OutputT>>(this, CacheName, null);\r\n        if (cachedValue !== undefined && cachedValue !== null && cachedExecutionId === context.executionId) {\r\n            this.isValid.setValue(true, context);\r\n            this.value.setValue(cachedValue, context);\r\n        } else {\r\n            try {\r\n                const calculatedValue = this._doOperation(context);\r\n                if (calculatedValue === undefined || calculatedValue === null) {\r\n                    this.isValid.setValue(false, context);\r\n                    return;\r\n                }\r\n                context._setExecutionVariable(this, CacheName, calculatedValue);\r\n                context._setExecutionVariable(this, CacheExecIdName, context.executionId);\r\n                this.value.setValue(calculatedValue, context);\r\n                this.isValid.setValue(true, context);\r\n            } catch (e) {\r\n                this.isValid.setValue(false, context);\r\n            }\r\n        }\r\n    }\r\n}\r\n"]}
+{"version":3,"file":"flowGraphCachedOperationBlock.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FlowGraph/Blocks/Data/flowGraphCachedOperationBlock.ts"],"names":[],"mappings":"AACA,OAAO,EAAqC,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGzF,OAAO,EAAiB,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAE/E,MAAM,SAAS,GAAG,sBAAsB,CAAC;AACzC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAE5C;;GAEG;AACH,MAAM,OAAgB,6BAAuC,SAAQ,cAAc;IAa/E,YAAY,cAAiC,EAAE,MAAqC;QAChF,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC;QACtC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC9D,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC;IACvE,CAAC;IASD;;;;;;;;;OASG;IACO,sBAAsB,CAAC,QAA0B;QACvD,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC;QACvD,4FAA4F;QAC5F,sFAAsF;QACtF,MAAM,KAAK,GAAI,YAAqD,EAAE,KAAK,CAAC;QAC5E,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IACjF,CAAC;IAEe,cAAc,CAAC,OAAyB;QACpD,MAAM,iBAAiB,GAAG,OAAO,CAAC,qBAAqB,CAAC,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC;QACnF,MAAM,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAoB,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QAC5F,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,IAAI,IAAI,iBAAiB,KAAK,OAAO,CAAC,WAAW,EAAE,CAAC;YACjG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACrC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC;gBACD,MAAM,eAAe,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;gBACnD,IAAI,eAAe,KAAK,SAAS,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;oBAC5D,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;oBAC1B,OAAO;gBACX,CAAC;gBACD,OAAO,CAAC,qBAAqB,CAAC,IAAI,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;gBAChE,OAAO,CAAC,qBAAqB,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;gBAC1E,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;gBAC9C,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACzC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACT,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC9B,CAAC;QACL,CAAC;IACL,CAAC;IAED;;;;OAIG;IACK,WAAW,CAAC,OAAyB;QACzC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;CACJ","sourcesContent":["import { type Nullable } from \"../../../types\";\r\nimport { type IFlowGraphBlockConfiguration, FlowGraphBlock } from \"../../flowGraphBlock\";\r\nimport { type FlowGraphContext } from \"../../flowGraphContext\";\r\nimport { type FlowGraphDataConnection } from \"../../flowGraphDataConnection\";\r\nimport { type RichType, RichTypeBoolean } from \"../../flowGraphRichTypes.pure\";\r\n\r\nconst CacheName = \"cachedOperationValue\";\r\nconst CacheExecIdName = \"cachedExecutionId\";\r\n\r\n/**\r\n * A block that will cache the result of an operation and deliver it as an output.\r\n */\r\nexport abstract class FlowGraphCachedOperationBlock<OutputT> extends FlowGraphBlock {\r\n    /**\r\n     * The output of the operation\r\n     */\r\n    public readonly value: FlowGraphDataConnection<OutputT>;\r\n\r\n    /**\r\n     * Output connection: Whether the value is valid.\r\n     */\r\n    public readonly isValid: FlowGraphDataConnection<boolean>;\r\n\r\n    private readonly _outputRichType: RichType<OutputT>;\r\n\r\n    constructor(outputRichType: RichType<OutputT>, config?: IFlowGraphBlockConfiguration) {\r\n        super(config);\r\n\r\n        this._outputRichType = outputRichType;\r\n        this.value = this.registerDataOutput(\"value\", outputRichType);\r\n        this.isValid = this.registerDataOutput(\"isValid\", RichTypeBoolean);\r\n    }\r\n\r\n    /**\r\n     * @internal\r\n     * Operation to realize\r\n     * @param context the graph context\r\n     */\r\n    public abstract _doOperation(context: FlowGraphContext): OutputT | undefined;\r\n\r\n    /**\r\n     * The value delivered on the `value` output when the operation cannot produce a result.\r\n     *\r\n     * Defaults to the output type's default value. Override this when a block defines a different\r\n     * value for that case, for example a polymorphic block whose output type is only known from its\r\n     * inputs. Implementations must return a fresh value rather than a shared instance, because\r\n     * consumers may mutate the value they receive.\r\n     * @param _context the graph context\r\n     * @returns the value to deliver alongside `isValid = false`\r\n     */\r\n    protected _getInvalidOutputValue(_context: FlowGraphContext): OutputT {\r\n        const defaultValue = this._outputRichType.defaultValue;\r\n        // The rich type defaults for object types (vectors, matrices, ...) are shared instances, so\r\n        // hand out a copy to keep a consumer from mutating the default for every other block.\r\n        const clone = (defaultValue as unknown as { clone?: () => OutputT })?.clone;\r\n        return typeof clone === \"function\" ? clone.call(defaultValue) : defaultValue;\r\n    }\r\n\r\n    public override _updateOutputs(context: FlowGraphContext) {\r\n        const cachedExecutionId = context._getExecutionVariable(this, CacheExecIdName, -1);\r\n        const cachedValue = context._getExecutionVariable<Nullable<OutputT>>(this, CacheName, null);\r\n        if (cachedValue !== undefined && cachedValue !== null && cachedExecutionId === context.executionId) {\r\n            this.isValid.setValue(true, context);\r\n            this.value.setValue(cachedValue, context);\r\n        } else {\r\n            try {\r\n                const calculatedValue = this._doOperation(context);\r\n                if (calculatedValue === undefined || calculatedValue === null) {\r\n                    this._setInvalid(context);\r\n                    return;\r\n                }\r\n                context._setExecutionVariable(this, CacheName, calculatedValue);\r\n                context._setExecutionVariable(this, CacheExecIdName, context.executionId);\r\n                this.value.setValue(calculatedValue, context);\r\n                this.isValid.setValue(true, context);\r\n            } catch (e) {\r\n                this._setInvalid(context);\r\n            }\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Reports the operation as invalid. `value` is still assigned, so it never reports a stale\r\n     * result from an earlier execution nor an undefined value on the first one.\r\n     * @param context the graph context\r\n     */\r\n    private _setInvalid(context: FlowGraphContext): void {\r\n        this.isValid.setValue(false, context);\r\n        this.value.setValue(this._getInvalidOutputValue(context), context);\r\n    }\r\n}\r\n"]}

package/FlowGraph/Blocks/Event/flowGraphReceiveCustomEventBlock.pure.d.ts

@@ -2,6 +2,7 @@
 import { type FlowGraphContext } from "../../flowGraphContext.js";
 import { FlowGraphEventBlock } from "../../flowGraphEventBlock.js";
 import { type RichType } from "../../flowGraphRichTypes.pure.js";
+import { type FlowGraphDataConnection } from "../../flowGraphDataConnection.pure.js";
 import { type IFlowGraphBlockConfiguration } from "../../flowGraphBlock.js";
 /**
  * Parameters used to create a FlowGraphReceiveCustomEventBlock.
@@ -33,12 +34,26 @@ export declare class FlowGraphReceiveCustomEventBlock extends FlowGraphEventBloc
      */
     config: IFlowGraphReceiveCustomEventBlockConfiguration;
     initPriority: number;
+    /**
+     * Output: the opaque reference identifying the received event source.
+     * Receivers configured with the same event id share the same reference, so comparing their
+     * `event` outputs for equality succeeds. The reference format is owned by the host environment.
+     */
+    readonly eventRef: FlowGraphDataConnection<string>;
     constructor(
     /**
      * the configuration of the block
      */
     config: IFlowGraphReceiveCustomEventBlockConfiguration);
+    _updateOutputs(context: FlowGraphContext): void;
     _preparePendingTasks(context: FlowGraphContext): void;
+    /**
+     * The value an output falls back to when the sender provides no value for it: the default
+     * declared by the payload schema, or the socket type's default when the schema declares none.
+     * @param key the payload key
+     * @returns the default value for that key
+     */
+    private _getEventDataDefault;
     _cancelPendingTasks(context: FlowGraphContext): void;
     _executeEvent(_context: FlowGraphContext, _payload: any): boolean;
     serialize(serializationObject?: any): void;

package/FlowGraph/Blocks/Event/flowGraphReceiveCustomEventBlock.pure.js

@@ -1,7 +1,7 @@
 /** This file must only contain pure code and pure imports */
 import { FlowGraphEventBlock } from "../../flowGraphEventBlock.js";
 import { Logger } from "../../../Misc/logger.js";
-import { getRichTypeByFlowGraphType } from "../../flowGraphRichTypes.pure.js";
+import { getRichTypeByFlowGraphType, RichTypeString } from "../../flowGraphRichTypes.pure.js";
 import { FlowGraphCoordinator } from "../../flowGraphCoordinator.js";
 import { RegisterClass } from "../../../Misc/typeStore.js";
 /**
@@ -26,8 +26,18 @@ export class FlowGraphReceiveCustomEventBlock extends FlowGraphEventBlock {
             const typeKey = typeof entry.type === "string" ? entry.type : entry.type?.typeName;
             const richType = typeof entry.type?.serialize === "function" ? entry.type : getRichTypeByFlowGraphType(typeKey);
             entry.type = richType;
-            this.registerDataOutput(key, richType);
+            // Pass default value from event data schema so outputs have the correct initial value
+            this.registerDataOutput(key, richType, entry.value);
         }
+        // Reserved `event` output exposing the event reference. Guard against a
+        // (pathological) custom event value socket literally named "event".
+        this.eventRef =
+            this.config.eventData && Object.prototype.hasOwnProperty.call(this.config.eventData, "event")
+                ? this.getDataOutput("event")
+                : this.registerDataOutput("event", RichTypeString);
+    }
+    _updateOutputs(context) {
+        this.eventRef.setValue(context.getEventReference(this.config.eventId), context);
     }
     _preparePendingTasks(context) {
         const observable = context.configuration.coordinator.getCustomEventObservable(this.config.eventId);
@@ -36,15 +46,42 @@ export class FlowGraphReceiveCustomEventBlock extends FlowGraphEventBlock {
             this._reportError(context, `FlowGraphReceiveCustomEventBlock: Too many observers for event ${this.config.eventId}. Max is ${FlowGraphCoordinator.MaxEventsPerType}.`);
             return;
         }
-        const eventObserver = observable.add((eventData) => {
-            const keys = Object.keys(eventData);
-            for (const key of keys) {
-                this.getDataOutput(key)?.setValue(eventData[key], context);
+        const eventObserver = observable.add((eventData, eventState) => {
+            // Make this dispatch's EventState reachable by event/stopPropagation
+            // for the duration of the synchronous receiver flow.
+            context.configuration.coordinator._beginEventDispatch(this.config.eventId, eventState);
+            try {
+                // Drive the outputs from the configured payload schema rather than from the incoming
+                // keys, so a key the sender omitted (or sent as undefined) resets to its configured
+                // default instead of retaining the value from a previous dispatch.
+                for (const key in this.config.eventData) {
+                    const output = this.getDataOutput(key);
+                    if (!output) {
+                        continue;
+                    }
+                    const incoming = eventData?.[key];
+                    output.setValue(incoming === undefined ? this._getEventDataDefault(key) : incoming, context);
+                }
+                // Expose the event reference before activating downstream flow.
+                this.eventRef.setValue(context.getEventReference(this.config.eventId), context);
+                this._execute(context);
+            }
+            finally {
+                context.configuration.coordinator._endEventDispatch();
             }
-            this._execute(context);
         });
         context._setExecutionVariable(this, "_eventObserver", eventObserver);
     }
+    /**
+     * The value an output falls back to when the sender provides no value for it: the default
+     * declared by the payload schema, or the socket type's default when the schema declares none.
+     * @param key the payload key
+     * @returns the default value for that key
+     */
+    _getEventDataDefault(key) {
+        const entry = this.config.eventData?.[key];
+        return entry?.value !== undefined ? entry.value : entry?.type?.defaultValue;
+    }
     _cancelPendingTasks(context) {
         const observable = context.configuration.coordinator.getCustomEventObservable(this.config.eventId);
         if (observable) {

package/FlowGraph/Blocks/Event/flowGraphReceiveCustomEventBlock.pure.js.map

@@ -1 +1 @@
-{"version":3,"file":"flowGraphReceiveCustomEventBlock.pure.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FlowGraph/Blocks/Event/flowGraphReceiveCustomEventBlock.pure.ts"],"names":[],"mappings":"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","sourcesContent":["/** This file must only contain pure code and pure imports */\r\n\r\nimport { type Observer } from \"../../../Misc/observable.pure\";\r\nimport { type FlowGraphContext } from \"../../flowGraphContext\";\r\nimport { FlowGraphEventBlock } from \"../../flowGraphEventBlock\";\r\nimport { type Nullable } from \"../../../types\";\r\nimport { Logger } from \"../../../Misc/logger\";\r\nimport { type RichType, getRichTypeByFlowGraphType } from \"../../flowGraphRichTypes.pure\";\r\nimport { type IFlowGraphBlockConfiguration } from \"../../flowGraphBlock\";\r\nimport { FlowGraphBlockNames } from \"../flowGraphBlockNames\";\r\nimport { FlowGraphCoordinator } from \"core/FlowGraph/flowGraphCoordinator\";\r\nimport { RegisterClass } from \"../../../Misc/typeStore\";\r\n/**\r\n * Parameters used to create a FlowGraphReceiveCustomEventBlock.\r\n */\r\nexport interface IFlowGraphReceiveCustomEventBlockConfiguration extends IFlowGraphBlockConfiguration {\r\n    /**\r\n     * The id of the event to receive.\r\n     * This event id is unique to the environment (not the context).\r\n     */\r\n    eventId: string;\r\n    /**\r\n     * The names of the data outputs for that event. Should be in the same order as the event data in\r\n     * SendCustomEvent\r\n     */\r\n    eventData: { [key: string]: { type: RichType<any> } };\r\n}\r\n\r\n/**\r\n * A block that receives a custom event.\r\n * It saves the event data in the data outputs, based on the provided eventData in the configuration. For example, if the event data is\r\n * `{ x: { type: RichTypeNumber }, y: { type: RichTypeNumber } }`, the block will have two data outputs: x and y.\r\n */\r\nexport class FlowGraphReceiveCustomEventBlock extends FlowGraphEventBlock {\r\n    public override initPriority: number = 1;\r\n\r\n    constructor(\r\n        /**\r\n         * the configuration of the block\r\n         */\r\n        public override config: IFlowGraphReceiveCustomEventBlockConfiguration\r\n    ) {\r\n        super(config);\r\n        // use event data to register data outputs\r\n        for (const key in this.config.eventData) {\r\n            const entry = this.config.eventData[key];\r\n            // Handle deserialized config where type may be a string typeName, a plain object\r\n            // with a typeName property (from old JSON serialization), or a proper RichType instance.\r\n            const typeKey = typeof entry.type === \"string\" ? entry.type : entry.type?.typeName;\r\n            const richType = typeof entry.type?.serialize === \"function\" ? entry.type : getRichTypeByFlowGraphType(typeKey);\r\n            entry.type = richType;\r\n            this.registerDataOutput(key, richType);\r\n        }\r\n    }\r\n\r\n    public override _preparePendingTasks(context: FlowGraphContext): void {\r\n        const observable = context.configuration.coordinator.getCustomEventObservable(this.config.eventId);\r\n        // check if we are not exceeding the max number of events\r\n        if (observable && observable.hasObservers() && observable.observers.length > FlowGraphCoordinator.MaxEventsPerType) {\r\n            this._reportError(context, `FlowGraphReceiveCustomEventBlock: Too many observers for event ${this.config.eventId}. Max is ${FlowGraphCoordinator.MaxEventsPerType}.`);\r\n            return;\r\n        }\r\n\r\n        const eventObserver = observable.add((eventData: { [key: string]: any }) => {\r\n            const keys = Object.keys(eventData);\r\n            for (const key of keys) {\r\n                this.getDataOutput(key)?.setValue(eventData[key], context);\r\n            }\r\n            this._execute(context);\r\n        });\r\n        context._setExecutionVariable(this, \"_eventObserver\", eventObserver);\r\n    }\r\n    public override _cancelPendingTasks(context: FlowGraphContext): void {\r\n        const observable = context.configuration.coordinator.getCustomEventObservable(this.config.eventId);\r\n        if (observable) {\r\n            const eventObserver = context._getExecutionVariable<Nullable<Observer<any[]>>>(this, \"_eventObserver\", null);\r\n            observable.remove(eventObserver);\r\n        } else {\r\n            Logger.Warn(`FlowGraphReceiveCustomEventBlock: Missing observable for event ${this.config.eventId}`);\r\n        }\r\n    }\r\n\r\n    public override _executeEvent(_context: FlowGraphContext, _payload: any): boolean {\r\n        return true;\r\n    }\r\n\r\n    public override serialize(serializationObject: any = {}) {\r\n        super.serialize(serializationObject);\r\n        // Override the eventData in config to store typeName strings instead of RichType instances\r\n        const serializedEventData: any = {};\r\n        for (const key in this.config.eventData) {\r\n            serializedEventData[key] = { type: this.config.eventData[key].type.typeName };\r\n        }\r\n        serializationObject.config.eventData = serializedEventData;\r\n    }\r\n\r\n    /**\r\n     * @returns class name of the block.\r\n     */\r\n    public override getClassName(): string {\r\n        return FlowGraphBlockNames.ReceiveCustomEvent;\r\n    }\r\n}\r\n\r\nlet _Registered = false;\r\n/**\r\n * Register side effects for flowGraphReceiveCustomEventBlock.\r\n * Safe to call multiple times; only the first call has an effect.\r\n */\r\nexport function RegisterFlowGraphReceiveCustomEventBlock(): void {\r\n    if (_Registered) {\r\n        return;\r\n    }\r\n    _Registered = true;\r\n\r\n    RegisterClass(FlowGraphBlockNames.ReceiveCustomEvent, FlowGraphReceiveCustomEventBlock);\r\n}\r\n"]}
+{"version":3,"file":"flowGraphReceiveCustomEventBlock.pure.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FlowGraph/Blocks/Event/flowGraphReceiveCustomEventBlock.pure.ts"],"names":[],"mappings":"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","sourcesContent":["/** This file must only contain pure code and pure imports */\r\n\r\nimport { type Observer } from \"../../../Misc/observable.pure\";\r\nimport { type FlowGraphContext } from \"../../flowGraphContext\";\r\nimport { FlowGraphEventBlock } from \"../../flowGraphEventBlock\";\r\nimport { type Nullable } from \"../../../types\";\r\nimport { Logger } from \"../../../Misc/logger\";\r\nimport { type RichType, getRichTypeByFlowGraphType, RichTypeString } from \"../../flowGraphRichTypes.pure\";\r\nimport { type FlowGraphDataConnection } from \"../../flowGraphDataConnection.pure\";\r\nimport { type IFlowGraphBlockConfiguration } from \"../../flowGraphBlock\";\r\nimport { FlowGraphBlockNames } from \"../flowGraphBlockNames\";\r\nimport { FlowGraphCoordinator } from \"core/FlowGraph/flowGraphCoordinator\";\r\nimport { RegisterClass } from \"../../../Misc/typeStore\";\r\n/**\r\n * Parameters used to create a FlowGraphReceiveCustomEventBlock.\r\n */\r\nexport interface IFlowGraphReceiveCustomEventBlockConfiguration extends IFlowGraphBlockConfiguration {\r\n    /**\r\n     * The id of the event to receive.\r\n     * This event id is unique to the environment (not the context).\r\n     */\r\n    eventId: string;\r\n    /**\r\n     * The names of the data outputs for that event. Should be in the same order as the event data in\r\n     * SendCustomEvent\r\n     */\r\n    eventData: { [key: string]: { type: RichType<any> } };\r\n}\r\n\r\n/**\r\n * A block that receives a custom event.\r\n * It saves the event data in the data outputs, based on the provided eventData in the configuration. For example, if the event data is\r\n * `{ x: { type: RichTypeNumber }, y: { type: RichTypeNumber } }`, the block will have two data outputs: x and y.\r\n */\r\nexport class FlowGraphReceiveCustomEventBlock extends FlowGraphEventBlock {\r\n    public override initPriority: number = 1;\r\n\r\n    /**\r\n     * Output: the opaque reference identifying the received event source.\r\n     * Receivers configured with the same event id share the same reference, so comparing their\r\n     * `event` outputs for equality succeeds. The reference format is owned by the host environment.\r\n     */\r\n    public readonly eventRef: FlowGraphDataConnection<string>;\r\n\r\n    constructor(\r\n        /**\r\n         * the configuration of the block\r\n         */\r\n        public override config: IFlowGraphReceiveCustomEventBlockConfiguration\r\n    ) {\r\n        super(config);\r\n        // use event data to register data outputs\r\n        for (const key in this.config.eventData) {\r\n            const entry = this.config.eventData[key];\r\n            // Handle deserialized config where type may be a string typeName, a plain object\r\n            // with a typeName property (from old JSON serialization), or a proper RichType instance.\r\n            const typeKey = typeof entry.type === \"string\" ? entry.type : entry.type?.typeName;\r\n            const richType = typeof entry.type?.serialize === \"function\" ? entry.type : getRichTypeByFlowGraphType(typeKey);\r\n            entry.type = richType;\r\n            // Pass default value from event data schema so outputs have the correct initial value\r\n            this.registerDataOutput(key, richType, (entry as any).value);\r\n        }\r\n        // Reserved `event` output exposing the event reference. Guard against a\r\n        // (pathological) custom event value socket literally named \"event\".\r\n        this.eventRef =\r\n            this.config.eventData && Object.prototype.hasOwnProperty.call(this.config.eventData, \"event\")\r\n                ? this.getDataOutput(\"event\")!\r\n                : this.registerDataOutput(\"event\", RichTypeString);\r\n    }\r\n\r\n    public override _updateOutputs(context: FlowGraphContext): void {\r\n        this.eventRef.setValue(context.getEventReference(this.config.eventId), context);\r\n    }\r\n\r\n    public override _preparePendingTasks(context: FlowGraphContext): void {\r\n        const observable = context.configuration.coordinator.getCustomEventObservable(this.config.eventId);\r\n        // check if we are not exceeding the max number of events\r\n        if (observable && observable.hasObservers() && observable.observers.length > FlowGraphCoordinator.MaxEventsPerType) {\r\n            this._reportError(context, `FlowGraphReceiveCustomEventBlock: Too many observers for event ${this.config.eventId}. Max is ${FlowGraphCoordinator.MaxEventsPerType}.`);\r\n            return;\r\n        }\r\n\r\n        const eventObserver = observable.add((eventData: { [key: string]: any }, eventState) => {\r\n            // Make this dispatch's EventState reachable by event/stopPropagation\r\n            // for the duration of the synchronous receiver flow.\r\n            context.configuration.coordinator._beginEventDispatch(this.config.eventId, eventState);\r\n            try {\r\n                // Drive the outputs from the configured payload schema rather than from the incoming\r\n                // keys, so a key the sender omitted (or sent as undefined) resets to its configured\r\n                // default instead of retaining the value from a previous dispatch.\r\n                for (const key in this.config.eventData) {\r\n                    const output = this.getDataOutput(key);\r\n                    if (!output) {\r\n                        continue;\r\n                    }\r\n                    const incoming = eventData?.[key];\r\n                    output.setValue(incoming === undefined ? this._getEventDataDefault(key) : incoming, context);\r\n                }\r\n                // Expose the event reference before activating downstream flow.\r\n                this.eventRef.setValue(context.getEventReference(this.config.eventId), context);\r\n                this._execute(context);\r\n            } finally {\r\n                context.configuration.coordinator._endEventDispatch();\r\n            }\r\n        });\r\n        context._setExecutionVariable(this, \"_eventObserver\", eventObserver);\r\n    }\r\n\r\n    /**\r\n     * The value an output falls back to when the sender provides no value for it: the default\r\n     * declared by the payload schema, or the socket type's default when the schema declares none.\r\n     * @param key the payload key\r\n     * @returns the default value for that key\r\n     */\r\n    private _getEventDataDefault(key: string): any {\r\n        const entry = this.config.eventData?.[key] as { type: RichType<any>; value?: any } | undefined;\r\n        return entry?.value !== undefined ? entry.value : entry?.type?.defaultValue;\r\n    }\r\n    public override _cancelPendingTasks(context: FlowGraphContext): void {\r\n        const observable = context.configuration.coordinator.getCustomEventObservable(this.config.eventId);\r\n        if (observable) {\r\n            const eventObserver = context._getExecutionVariable<Nullable<Observer<any[]>>>(this, \"_eventObserver\", null);\r\n            observable.remove(eventObserver);\r\n        } else {\r\n            Logger.Warn(`FlowGraphReceiveCustomEventBlock: Missing observable for event ${this.config.eventId}`);\r\n        }\r\n    }\r\n\r\n    public override _executeEvent(_context: FlowGraphContext, _payload: any): boolean {\r\n        return true;\r\n    }\r\n\r\n    public override serialize(serializationObject: any = {}) {\r\n        super.serialize(serializationObject);\r\n        // Override the eventData in config to store typeName strings instead of RichType instances\r\n        const serializedEventData: any = {};\r\n        for (const key in this.config.eventData) {\r\n            serializedEventData[key] = { type: this.config.eventData[key].type.typeName };\r\n        }\r\n        serializationObject.config.eventData = serializedEventData;\r\n    }\r\n\r\n    /**\r\n     * @returns class name of the block.\r\n     */\r\n    public override getClassName(): string {\r\n        return FlowGraphBlockNames.ReceiveCustomEvent;\r\n    }\r\n}\r\n\r\nlet _Registered = false;\r\n/**\r\n * Register side effects for flowGraphReceiveCustomEventBlock.\r\n * Safe to call multiple times; only the first call has an effect.\r\n */\r\nexport function RegisterFlowGraphReceiveCustomEventBlock(): void {\r\n    if (_Registered) {\r\n        return;\r\n    }\r\n    _Registered = true;\r\n\r\n    RegisterClass(FlowGraphBlockNames.ReceiveCustomEvent, FlowGraphReceiveCustomEventBlock);\r\n}\r\n"]}

package/FlowGraph/Blocks/Event/flowGraphSceneReadyEventBlock.pure.d.ts

@@ -1,6 +1,7 @@
 /** This file must only contain pure code and pure imports */
 import { FlowGraphEventBlock } from "../../flowGraphEventBlock.js";
 import { type FlowGraphContext } from "../../flowGraphContext.js";
+import { type FlowGraphDataConnection } from "../../flowGraphDataConnection.pure.js";
 import { FlowGraphBlockNames } from "../flowGraphBlockNames.js";
 import { FlowGraphEventType } from "../../flowGraphEventType.js";
 /**
@@ -9,6 +10,14 @@ import { FlowGraphEventType } from "../../flowGraphEventType.js";
 export declare class FlowGraphSceneReadyEventBlock extends FlowGraphEventBlock {
     initPriority: number;
     readonly type: FlowGraphEventType;
+    /**
+     * Output: the opaque reference identifying this event source.
+     * All instances of this block share the same reference, so comparing the `event` output of two
+     * of them for equality succeeds. The reference format is owned by the host environment.
+     */
+    readonly eventRef: FlowGraphDataConnection<string>;
+    constructor();
+    _updateOutputs(context: FlowGraphContext): void;
     _executeEvent(context: FlowGraphContext, _payload: any): boolean;
     _preparePendingTasks(context: FlowGraphContext): void;
     _cancelPendingTasks(context: FlowGraphContext): void;

package/FlowGraph/Blocks/Event/flowGraphSceneReadyEventBlock.pure.js

@@ -1,16 +1,24 @@
 /** This file must only contain pure code and pure imports */
 import { FlowGraphEventBlock } from "../../flowGraphEventBlock.js";
+import { RichTypeString } from "../../flowGraphRichTypes.pure.js";
 import { RegisterClass } from "../../../Misc/typeStore.js";
+/** Event source key used to build this block's event reference. */
+const EventKey = "sceneReady";
 /**
  * Block that triggers when a scene is ready.
  */
 export class FlowGraphSceneReadyEventBlock extends FlowGraphEventBlock {
     constructor() {
-        super(...arguments);
+        super();
         this.initPriority = -1;
         this.type = "SceneReady" /* FlowGraphEventType.SceneReady */;
+        this.eventRef = this.registerDataOutput("event", RichTypeString);
+    }
+    _updateOutputs(context) {
+        this.eventRef.setValue(context.getEventReference(EventKey), context);
     }
     _executeEvent(context, _payload) {
+        this.eventRef.setValue(context.getEventReference(EventKey), context);
         this._execute(context);
         return true;
     }

package/FlowGraph/Blocks/Event/flowGraphSceneReadyEventBlock.pure.js.map

@@ -1 +1 @@
-{"version":3,"file":"flowGraphSceneReadyEventBlock.pure.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FlowGraph/Blocks/Event/flowGraphSceneReadyEventBlock.pure.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAIhE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD;;GAEG;AACH,MAAM,OAAO,6BAA8B,SAAQ,mBAAmB;IAAtE;;QACoB,iBAAY,GAAW,CAAC,CAAC,CAAC;QAEjB,SAAI,oDAAqD;IAkBtF,CAAC;IAhBmB,aAAa,CAAC,OAAyB,EAAE,QAAa;QAClE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IAChB,CAAC;IACe,oBAAoB,CAAC,OAAyB;QAC1D,QAAQ;IACZ,CAAC;IACe,mBAAmB,CAAC,OAAyB;QACzD,QAAQ;IACZ,CAAC;IACD;;OAEG;IACa,YAAY;QACxB,iFAA2C;IAC/C,CAAC;CACJ;AAED,IAAI,WAAW,GAAG,KAAK,CAAC;AACxB;;;GAGG;AACH,MAAM,UAAU,qCAAqC;IACjD,IAAI,WAAW,EAAE,CAAC;QACd,OAAO;IACX,CAAC;IACD,WAAW,GAAG,IAAI,CAAC;IAEnB,aAAa,4EAAsC,6BAA6B,CAAC,CAAC;AACtF,CAAC","sourcesContent":["/** This file must only contain pure code and pure imports */\r\n\r\nimport { FlowGraphEventBlock } from \"../../flowGraphEventBlock\";\r\nimport { type FlowGraphContext } from \"core/FlowGraph/flowGraphContext\";\r\nimport { FlowGraphBlockNames } from \"../flowGraphBlockNames\";\r\nimport { FlowGraphEventType } from \"core/FlowGraph/flowGraphEventType\";\r\nimport { RegisterClass } from \"../../../Misc/typeStore\";\r\n/**\r\n * Block that triggers when a scene is ready.\r\n */\r\nexport class FlowGraphSceneReadyEventBlock extends FlowGraphEventBlock {\r\n    public override initPriority: number = -1;\r\n\r\n    public override readonly type: FlowGraphEventType = FlowGraphEventType.SceneReady;\r\n\r\n    public override _executeEvent(context: FlowGraphContext, _payload: any): boolean {\r\n        this._execute(context);\r\n        return true;\r\n    }\r\n    public override _preparePendingTasks(context: FlowGraphContext): void {\r\n        // no-op\r\n    }\r\n    public override _cancelPendingTasks(context: FlowGraphContext): void {\r\n        // no-op\r\n    }\r\n    /**\r\n     * @returns class name of the block.\r\n     */\r\n    public override getClassName() {\r\n        return FlowGraphBlockNames.SceneReadyEvent;\r\n    }\r\n}\r\n\r\nlet _Registered = false;\r\n/**\r\n * Register side effects for flowGraphSceneReadyEventBlock.\r\n * Safe to call multiple times; only the first call has an effect.\r\n */\r\nexport function RegisterFlowGraphSceneReadyEventBlock(): void {\r\n    if (_Registered) {\r\n        return;\r\n    }\r\n    _Registered = true;\r\n\r\n    RegisterClass(FlowGraphBlockNames.SceneReadyEvent, FlowGraphSceneReadyEventBlock);\r\n}\r\n"]}
+{"version":3,"file":"flowGraphSceneReadyEventBlock.pure.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FlowGraph/Blocks/Event/flowGraphSceneReadyEventBlock.pure.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGhE,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAGxE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,mEAAmE;AACnE,MAAM,QAAQ,GAAG,YAAY,CAAC;AAE9B;;GAEG;AACH,MAAM,OAAO,6BAA8B,SAAQ,mBAAmB;IAYlE;QACI,KAAK,EAAE,CAAC;QAZI,iBAAY,GAAW,CAAC,CAAC,CAAC;QAEjB,SAAI,oDAAqD;QAW9E,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IACrE,CAAC;IAEe,cAAc,CAAC,OAAyB;QACpD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;IAEe,aAAa,CAAC,OAAyB,EAAE,QAAa;QAClE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;QACrE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IAChB,CAAC;IACe,oBAAoB,CAAC,OAAyB;QAC1D,QAAQ;IACZ,CAAC;IACe,mBAAmB,CAAC,OAAyB;QACzD,QAAQ;IACZ,CAAC;IACD;;OAEG;IACa,YAAY;QACxB,iFAA2C;IAC/C,CAAC;CACJ;AAED,IAAI,WAAW,GAAG,KAAK,CAAC;AACxB;;;GAGG;AACH,MAAM,UAAU,qCAAqC;IACjD,IAAI,WAAW,EAAE,CAAC;QACd,OAAO;IACX,CAAC;IACD,WAAW,GAAG,IAAI,CAAC;IAEnB,aAAa,4EAAsC,6BAA6B,CAAC,CAAC;AACtF,CAAC","sourcesContent":["/** This file must only contain pure code and pure imports */\r\n\r\nimport { FlowGraphEventBlock } from \"../../flowGraphEventBlock\";\r\nimport { type FlowGraphContext } from \"core/FlowGraph/flowGraphContext\";\r\nimport { type FlowGraphDataConnection } from \"core/FlowGraph/flowGraphDataConnection.pure\";\r\nimport { RichTypeString } from \"core/FlowGraph/flowGraphRichTypes.pure\";\r\nimport { FlowGraphBlockNames } from \"../flowGraphBlockNames\";\r\nimport { FlowGraphEventType } from \"core/FlowGraph/flowGraphEventType\";\r\nimport { RegisterClass } from \"../../../Misc/typeStore\";\r\n\r\n/** Event source key used to build this block's event reference. */\r\nconst EventKey = \"sceneReady\";\r\n\r\n/**\r\n * Block that triggers when a scene is ready.\r\n */\r\nexport class FlowGraphSceneReadyEventBlock extends FlowGraphEventBlock {\r\n    public override initPriority: number = -1;\r\n\r\n    public override readonly type: FlowGraphEventType = FlowGraphEventType.SceneReady;\r\n\r\n    /**\r\n     * Output: the opaque reference identifying this event source.\r\n     * All instances of this block share the same reference, so comparing the `event` output of two\r\n     * of them for equality succeeds. The reference format is owned by the host environment.\r\n     */\r\n    public readonly eventRef: FlowGraphDataConnection<string>;\r\n\r\n    constructor() {\r\n        super();\r\n        this.eventRef = this.registerDataOutput(\"event\", RichTypeString);\r\n    }\r\n\r\n    public override _updateOutputs(context: FlowGraphContext): void {\r\n        this.eventRef.setValue(context.getEventReference(EventKey), context);\r\n    }\r\n\r\n    public override _executeEvent(context: FlowGraphContext, _payload: any): boolean {\r\n        this.eventRef.setValue(context.getEventReference(EventKey), context);\r\n        this._execute(context);\r\n        return true;\r\n    }\r\n    public override _preparePendingTasks(context: FlowGraphContext): void {\r\n        // no-op\r\n    }\r\n    public override _cancelPendingTasks(context: FlowGraphContext): void {\r\n        // no-op\r\n    }\r\n    /**\r\n     * @returns class name of the block.\r\n     */\r\n    public override getClassName() {\r\n        return FlowGraphBlockNames.SceneReadyEvent;\r\n    }\r\n}\r\n\r\nlet _Registered = false;\r\n/**\r\n * Register side effects for flowGraphSceneReadyEventBlock.\r\n * Safe to call multiple times; only the first call has an effect.\r\n */\r\nexport function RegisterFlowGraphSceneReadyEventBlock(): void {\r\n    if (_Registered) {\r\n        return;\r\n    }\r\n    _Registered = true;\r\n\r\n    RegisterClass(FlowGraphBlockNames.SceneReadyEvent, FlowGraphSceneReadyEventBlock);\r\n}\r\n"]}

package/FlowGraph/Blocks/Event/flowGraphSceneTickEventBlock.pure.d.ts

@@ -28,8 +28,15 @@ export declare class FlowGraphSceneTickEventBlock extends FlowGraphEventBlock {
      * the time in seconds since the last frame.
      */
     readonly deltaTime: FlowGraphDataConnection<number>;
+    /**
+     * Output: the opaque reference identifying this event source.
+     * All instances of this block share the same reference, so comparing the `event` output of two
+     * of them for equality succeeds. The reference format is owned by the host environment.
+     */
+    readonly eventRef: FlowGraphDataConnection<string>;
     readonly type: FlowGraphEventType;
     constructor();
+    _updateOutputs(context: FlowGraphContext): void;
     /**
      * @internal
      */

package/FlowGraph/Blocks/Event/flowGraphSceneTickEventBlock.pure.js

@@ -1,7 +1,9 @@
 /** This file must only contain pure code and pure imports */
 import { FlowGraphEventBlock } from "../../flowGraphEventBlock.js";
-import { RichTypeNumber } from "../../flowGraphRichTypes.pure.js";
+import { RichTypeNumber, RichTypeString } from "../../flowGraphRichTypes.pure.js";
 import { RegisterClass } from "../../../Misc/typeStore.js";
+/** Event source key used to build this block's event reference. */
+const EventKey = "sceneTick";
 /**
  * Block that triggers on scene tick (before each render).
  */
@@ -11,6 +13,10 @@ export class FlowGraphSceneTickEventBlock extends FlowGraphEventBlock {
         this.type = "SceneBeforeRender" /* FlowGraphEventType.SceneBeforeRender */;
         this.timeSinceStart = this.registerDataOutput("timeSinceStart", RichTypeNumber);
         this.deltaTime = this.registerDataOutput("deltaTime", RichTypeNumber);
+        this.eventRef = this.registerDataOutput("event", RichTypeString);
+    }
+    _updateOutputs(context) {
+        this.eventRef.setValue(context.getEventReference(EventKey), context);
     }
     /**
      * @internal
@@ -24,6 +30,7 @@ export class FlowGraphSceneTickEventBlock extends FlowGraphEventBlock {
     _executeEvent(context, payload) {
         this.timeSinceStart.setValue(payload.timeSinceStart, context);
         this.deltaTime.setValue(payload.deltaTime, context);
+        this.eventRef.setValue(context.getEventReference(EventKey), context);
         this._execute(context);
         return true;
     }

package/FlowGraph/Blocks/Event/flowGraphSceneTickEventBlock.pure.js.map

@@ -1 +1 @@
-{"version":3,"file":"flowGraphSceneTickEventBlock.pure.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FlowGraph/Blocks/Event/flowGraphSceneTickEventBlock.pure.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAIxE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAgBxD;;GAEG;AACH,MAAM,OAAO,4BAA6B,SAAQ,mBAAmB;IAajE;QACI,KAAK,EAAE,CAAC;QAHa,SAAI,kEAA4D;QAIrF,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,kBAAkB,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;QAChF,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,kBAAkB,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACa,oBAAoB,CAAC,QAA0B;QAC3D,QAAQ;IACZ,CAAC;IAED;;OAEG;IACa,aAAa,CAAC,OAAyB,EAAE,OAAqC;QAC1F,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAC9D,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACa,mBAAmB,CAAC,QAA0B;QAC1D,QAAQ;IACZ,CAAC;IAED;;OAEG;IACa,YAAY;QACxB,+EAA0C;IAC9C,CAAC;CACJ;AAED,IAAI,WAAW,GAAG,KAAK,CAAC;AACxB;;;GAGG;AACH,MAAM,UAAU,oCAAoC;IAChD,IAAI,WAAW,EAAE,CAAC;QACd,OAAO;IACX,CAAC;IACD,WAAW,GAAG,IAAI,CAAC;IAEnB,aAAa,0EAAqC,4BAA4B,CAAC,CAAC;AACpF,CAAC","sourcesContent":["/** This file must only contain pure code and pure imports */\r\n\r\nimport { FlowGraphEventBlock } from \"../../flowGraphEventBlock\";\r\nimport { type FlowGraphContext } from \"core/FlowGraph/flowGraphContext\";\r\nimport { RichTypeNumber } from \"core/FlowGraph/flowGraphRichTypes.pure\";\r\nimport { type FlowGraphDataConnection } from \"core/FlowGraph/flowGraphDataConnection.pure\";\r\nimport { FlowGraphBlockNames } from \"../flowGraphBlockNames\";\r\nimport { FlowGraphEventType } from \"core/FlowGraph/flowGraphEventType\";\r\nimport { RegisterClass } from \"../../../Misc/typeStore\";\r\n\r\n/**\r\n * Payload for the scene tick event.\r\n */\r\nexport interface IFlowGraphOnTickEventPayload {\r\n    /**\r\n     * the time in seconds since the scene started.\r\n     */\r\n    timeSinceStart: number;\r\n    /**\r\n     * the time in seconds since the last frame.\r\n     */\r\n    deltaTime: number;\r\n}\r\n\r\n/**\r\n * Block that triggers on scene tick (before each render).\r\n */\r\nexport class FlowGraphSceneTickEventBlock extends FlowGraphEventBlock {\r\n    /**\r\n     * the time in seconds since the scene started.\r\n     */\r\n    public readonly timeSinceStart: FlowGraphDataConnection<number>;\r\n\r\n    /**\r\n     * the time in seconds since the last frame.\r\n     */\r\n    public readonly deltaTime: FlowGraphDataConnection<number>;\r\n\r\n    public override readonly type: FlowGraphEventType = FlowGraphEventType.SceneBeforeRender;\r\n\r\n    constructor() {\r\n        super();\r\n        this.timeSinceStart = this.registerDataOutput(\"timeSinceStart\", RichTypeNumber);\r\n        this.deltaTime = this.registerDataOutput(\"deltaTime\", RichTypeNumber);\r\n    }\r\n\r\n    /**\r\n     * @internal\r\n     */\r\n    public override _preparePendingTasks(_context: FlowGraphContext): void {\r\n        // no-op\r\n    }\r\n\r\n    /**\r\n     * @internal\r\n     */\r\n    public override _executeEvent(context: FlowGraphContext, payload: IFlowGraphOnTickEventPayload): boolean {\r\n        this.timeSinceStart.setValue(payload.timeSinceStart, context);\r\n        this.deltaTime.setValue(payload.deltaTime, context);\r\n        this._execute(context);\r\n        return true;\r\n    }\r\n\r\n    /**\r\n     * @internal\r\n     */\r\n    public override _cancelPendingTasks(_context: FlowGraphContext) {\r\n        // no-op\r\n    }\r\n\r\n    /**\r\n     * @returns class name of the block.\r\n     */\r\n    public override getClassName(): string {\r\n        return FlowGraphBlockNames.SceneTickEvent;\r\n    }\r\n}\r\n\r\nlet _Registered = false;\r\n/**\r\n * Register side effects for flowGraphSceneTickEventBlock.\r\n * Safe to call multiple times; only the first call has an effect.\r\n */\r\nexport function RegisterFlowGraphSceneTickEventBlock(): void {\r\n    if (_Registered) {\r\n        return;\r\n    }\r\n    _Registered = true;\r\n\r\n    RegisterClass(FlowGraphBlockNames.SceneTickEvent, FlowGraphSceneTickEventBlock);\r\n}\r\n"]}
+{"version":3,"file":"flowGraphSceneTickEventBlock.pure.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FlowGraph/Blocks/Event/flowGraphSceneTickEventBlock.pure.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAEhE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAIxF,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,mEAAmE;AACnE,MAAM,QAAQ,GAAG,WAAW,CAAC;AAgB7B;;GAEG;AACH,MAAM,OAAO,4BAA6B,SAAQ,mBAAmB;IAoBjE;QACI,KAAK,EAAE,CAAC;QAHa,SAAI,kEAA4D;QAIrF,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,kBAAkB,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAAC;QAChF,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,kBAAkB,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QACtE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IACrE,CAAC;IAEe,cAAc,CAAC,OAAyB;QACpD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACa,oBAAoB,CAAC,QAA0B;QAC3D,QAAQ;IACZ,CAAC;IAED;;OAEG;IACa,aAAa,CAAC,OAAyB,EAAE,OAAqC;QAC1F,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAC9D,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;QACrE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACa,mBAAmB,CAAC,QAA0B;QAC1D,QAAQ;IACZ,CAAC;IAED;;OAEG;IACa,YAAY;QACxB,+EAA0C;IAC9C,CAAC;CACJ;AAED,IAAI,WAAW,GAAG,KAAK,CAAC;AACxB;;;GAGG;AACH,MAAM,UAAU,oCAAoC;IAChD,IAAI,WAAW,EAAE,CAAC;QACd,OAAO;IACX,CAAC;IACD,WAAW,GAAG,IAAI,CAAC;IAEnB,aAAa,0EAAqC,4BAA4B,CAAC,CAAC;AACpF,CAAC","sourcesContent":["/** This file must only contain pure code and pure imports */\r\n\r\nimport { FlowGraphEventBlock } from \"../../flowGraphEventBlock\";\r\nimport { type FlowGraphContext } from \"core/FlowGraph/flowGraphContext\";\r\nimport { RichTypeNumber, RichTypeString } from \"core/FlowGraph/flowGraphRichTypes.pure\";\r\nimport { type FlowGraphDataConnection } from \"core/FlowGraph/flowGraphDataConnection.pure\";\r\nimport { FlowGraphBlockNames } from \"../flowGraphBlockNames\";\r\nimport { FlowGraphEventType } from \"core/FlowGraph/flowGraphEventType\";\r\nimport { RegisterClass } from \"../../../Misc/typeStore\";\r\n\r\n/** Event source key used to build this block's event reference. */\r\nconst EventKey = \"sceneTick\";\r\n\r\n/**\r\n * Payload for the scene tick event.\r\n */\r\nexport interface IFlowGraphOnTickEventPayload {\r\n    /**\r\n     * the time in seconds since the scene started.\r\n     */\r\n    timeSinceStart: number;\r\n    /**\r\n     * the time in seconds since the last frame.\r\n     */\r\n    deltaTime: number;\r\n}\r\n\r\n/**\r\n * Block that triggers on scene tick (before each render).\r\n */\r\nexport class FlowGraphSceneTickEventBlock extends FlowGraphEventBlock {\r\n    /**\r\n     * the time in seconds since the scene started.\r\n     */\r\n    public readonly timeSinceStart: FlowGraphDataConnection<number>;\r\n\r\n    /**\r\n     * the time in seconds since the last frame.\r\n     */\r\n    public readonly deltaTime: FlowGraphDataConnection<number>;\r\n\r\n    /**\r\n     * Output: the opaque reference identifying this event source.\r\n     * All instances of this block share the same reference, so comparing the `event` output of two\r\n     * of them for equality succeeds. The reference format is owned by the host environment.\r\n     */\r\n    public readonly eventRef: FlowGraphDataConnection<string>;\r\n\r\n    public override readonly type: FlowGraphEventType = FlowGraphEventType.SceneBeforeRender;\r\n\r\n    constructor() {\r\n        super();\r\n        this.timeSinceStart = this.registerDataOutput(\"timeSinceStart\", RichTypeNumber);\r\n        this.deltaTime = this.registerDataOutput(\"deltaTime\", RichTypeNumber);\r\n        this.eventRef = this.registerDataOutput(\"event\", RichTypeString);\r\n    }\r\n\r\n    public override _updateOutputs(context: FlowGraphContext): void {\r\n        this.eventRef.setValue(context.getEventReference(EventKey), context);\r\n    }\r\n\r\n    /**\r\n     * @internal\r\n     */\r\n    public override _preparePendingTasks(_context: FlowGraphContext): void {\r\n        // no-op\r\n    }\r\n\r\n    /**\r\n     * @internal\r\n     */\r\n    public override _executeEvent(context: FlowGraphContext, payload: IFlowGraphOnTickEventPayload): boolean {\r\n        this.timeSinceStart.setValue(payload.timeSinceStart, context);\r\n        this.deltaTime.setValue(payload.deltaTime, context);\r\n        this.eventRef.setValue(context.getEventReference(EventKey), context);\r\n        this._execute(context);\r\n        return true;\r\n    }\r\n\r\n    /**\r\n     * @internal\r\n     */\r\n    public override _cancelPendingTasks(_context: FlowGraphContext) {\r\n        // no-op\r\n    }\r\n\r\n    /**\r\n     * @returns class name of the block.\r\n     */\r\n    public override getClassName(): string {\r\n        return FlowGraphBlockNames.SceneTickEvent;\r\n    }\r\n}\r\n\r\nlet _Registered = false;\r\n/**\r\n * Register side effects for flowGraphSceneTickEventBlock.\r\n * Safe to call multiple times; only the first call has an effect.\r\n */\r\nexport function RegisterFlowGraphSceneTickEventBlock(): void {\r\n    if (_Registered) {\r\n        return;\r\n    }\r\n    _Registered = true;\r\n\r\n    RegisterClass(FlowGraphBlockNames.SceneTickEvent, FlowGraphSceneTickEventBlock);\r\n}\r\n"]}

package/FlowGraph/Blocks/Event/flowGraphStopEventPropagationBlock.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Re-exports pure implementation and applies runtime side effects.
+ * Import flowGraphStopEventPropagationBlock.pure for tree-shakeable, side-effect-free usage.
+ */
+export * from "./flowGraphStopEventPropagationBlock.pure.js";

package/FlowGraph/Blocks/Event/flowGraphStopEventPropagationBlock.js

@@ -0,0 +1,8 @@
+/**
+ * Re-exports pure implementation and applies runtime side effects.
+ * Import flowGraphStopEventPropagationBlock.pure for tree-shakeable, side-effect-free usage.
+ */
+export * from "./flowGraphStopEventPropagationBlock.pure.js";
+import { RegisterFlowGraphStopEventPropagationBlock } from "./flowGraphStopEventPropagationBlock.pure.js";
+RegisterFlowGraphStopEventPropagationBlock();
+//# sourceMappingURL=flowGraphStopEventPropagationBlock.js.map

package/FlowGraph/Blocks/Event/flowGraphStopEventPropagationBlock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowGraphStopEventPropagationBlock.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FlowGraph/Blocks/Event/flowGraphStopEventPropagationBlock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,2CAA2C,CAAC;AAE1D,OAAO,EAAE,0CAA0C,EAAE,MAAM,2CAA2C,CAAC;AACvG,0CAA0C,EAAE,CAAC","sourcesContent":["/**\r\n * Re-exports pure implementation and applies runtime side effects.\r\n * Import flowGraphStopEventPropagationBlock.pure for tree-shakeable, side-effect-free usage.\r\n */\r\nexport * from \"./flowGraphStopEventPropagationBlock.pure\";\r\n\r\nimport { RegisterFlowGraphStopEventPropagationBlock } from \"./flowGraphStopEventPropagationBlock.pure\";\r\nRegisterFlowGraphStopEventPropagationBlock();\r\n"]}

package/FlowGraph/Blocks/Event/flowGraphStopEventPropagationBlock.pure.d.ts

@@ -0,0 +1,37 @@
+/** This file must only contain pure code and pure imports */
+import { FlowGraphExecutionBlockWithOutSignal } from "../../flowGraphExecutionBlockWithOutSignal.js";
+import { type FlowGraphContext } from "../../flowGraphContext.js";
+import { type FlowGraphDataConnection } from "../../flowGraphDataConnection.pure.js";
+import { type IFlowGraphBlockConfiguration } from "../../flowGraphBlock.js";
+/**
+ * Stops the propagation of an in-flight custom event.
+ *
+ * When activated it asks the coordinator to skip the remaining handler nodes of
+ * the currently-dispatching event referenced by the `event` input, then activates
+ * its `out` flow. If the `event` input is not a valid, currently-dispatching event
+ * reference, activating this block only fires `out` with no other effect.
+ */
+export declare class FlowGraphStopEventPropagationBlock extends FlowGraphExecutionBlockWithOutSignal {
+    /**
+     * Input: the event reference (produced by an event operation's `event` output)
+     * whose propagation should be stopped.
+     */
+    readonly event: FlowGraphDataConnection<string>;
+    /**
+     * Input: whether to also stop remaining immediate handlers. See
+     * `FlowGraphCoordinator.stopEventPropagation` for how this maps onto the
+     * Babylon single-Observable dispatch model.
+     */
+    readonly stopImmediate: FlowGraphDataConnection<boolean>;
+    constructor(config?: IFlowGraphBlockConfiguration);
+    _execute(context: FlowGraphContext): void;
+    /**
+     * @returns class name of the block.
+     */
+    getClassName(): string;
+}
+/**
+ * Register side effects for flowGraphStopEventPropagationBlock.
+ * Safe to call multiple times; only the first call has an effect.
+ */
+export declare function RegisterFlowGraphStopEventPropagationBlock(): void;

package/FlowGraph/Blocks/Event/flowGraphStopEventPropagationBlock.pure.js

@@ -0,0 +1,44 @@
+/** This file must only contain pure code and pure imports */
+import { FlowGraphExecutionBlockWithOutSignal } from "../../flowGraphExecutionBlockWithOutSignal.js";
+import { RichTypeBoolean, RichTypeString } from "../../flowGraphRichTypes.pure.js";
+import { RegisterClass } from "../../../Misc/typeStore.js";
+/**
+ * Stops the propagation of an in-flight custom event.
+ *
+ * When activated it asks the coordinator to skip the remaining handler nodes of
+ * the currently-dispatching event referenced by the `event` input, then activates
+ * its `out` flow. If the `event` input is not a valid, currently-dispatching event
+ * reference, activating this block only fires `out` with no other effect.
+ */
+export class FlowGraphStopEventPropagationBlock extends FlowGraphExecutionBlockWithOutSignal {
+    constructor(config) {
+        super(config);
+        this.event = this.registerDataInput("event", RichTypeString);
+        this.stopImmediate = this.registerDataInput("stopImmediate", RichTypeBoolean, false);
+    }
+    _execute(context) {
+        const event = this.event.getValue(context);
+        const stopImmediate = this.stopImmediate.getValue(context);
+        context.configuration.coordinator.stopEventPropagation(event, stopImmediate);
+        this.out._activateSignal(context);
+    }
+    /**
+     * @returns class name of the block.
+     */
+    getClassName() {
+        return "FlowGraphStopEventPropagationBlock" /* FlowGraphBlockNames.StopEventPropagation */;
+    }
+}
+let _Registered = false;
+/**
+ * Register side effects for flowGraphStopEventPropagationBlock.
+ * Safe to call multiple times; only the first call has an effect.
+ */
+export function RegisterFlowGraphStopEventPropagationBlock() {
+    if (_Registered) {
+        return;
+    }
+    _Registered = true;
+    RegisterClass("FlowGraphStopEventPropagationBlock" /* FlowGraphBlockNames.StopEventPropagation */, FlowGraphStopEventPropagationBlock);
+}
+//# sourceMappingURL=flowGraphStopEventPropagationBlock.pure.js.map

package/FlowGraph/Blocks/Event/flowGraphStopEventPropagationBlock.pure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flowGraphStopEventPropagationBlock.pure.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FlowGraph/Blocks/Event/flowGraphStopEventPropagationBlock.pure.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,OAAO,EAAE,oCAAoC,EAAE,MAAM,4CAA4C,CAAC;AAGlG,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGhF,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,OAAO,kCAAmC,SAAQ,oCAAoC;IAcxF,YAAmB,MAAqC;QACpD,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QAC7D,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,iBAAiB,CAAC,eAAe,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;IACzF,CAAC;IAEM,QAAQ,CAAC,OAAyB;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC3D,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,oBAAoB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QAC7E,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED;;OAEG;IACa,YAAY;QACxB,2FAAgD;IACpD,CAAC;CACJ;AAED,IAAI,WAAW,GAAG,KAAK,CAAC;AACxB;;;GAGG;AACH,MAAM,UAAU,0CAA0C;IACtD,IAAI,WAAW,EAAE,CAAC;QACd,OAAO;IACX,CAAC;IACD,WAAW,GAAG,IAAI,CAAC;IAEnB,aAAa,sFAA2C,kCAAkC,CAAC,CAAC;AAChG,CAAC","sourcesContent":["/** This file must only contain pure code and pure imports */\r\n\r\nimport { FlowGraphExecutionBlockWithOutSignal } from \"../../flowGraphExecutionBlockWithOutSignal\";\r\nimport { type FlowGraphContext } from \"../../flowGraphContext\";\r\nimport { type FlowGraphDataConnection } from \"../../flowGraphDataConnection.pure\";\r\nimport { RichTypeBoolean, RichTypeString } from \"../../flowGraphRichTypes.pure\";\r\nimport { type IFlowGraphBlockConfiguration } from \"../../flowGraphBlock\";\r\nimport { FlowGraphBlockNames } from \"../flowGraphBlockNames\";\r\nimport { RegisterClass } from \"../../../Misc/typeStore\";\r\n\r\n/**\r\n * Stops the propagation of an in-flight custom event.\r\n *\r\n * When activated it asks the coordinator to skip the remaining handler nodes of\r\n * the currently-dispatching event referenced by the `event` input, then activates\r\n * its `out` flow. If the `event` input is not a valid, currently-dispatching event\r\n * reference, activating this block only fires `out` with no other effect.\r\n */\r\nexport class FlowGraphStopEventPropagationBlock extends FlowGraphExecutionBlockWithOutSignal {\r\n    /**\r\n     * Input: the event reference (produced by an event operation's `event` output)\r\n     * whose propagation should be stopped.\r\n     */\r\n    public readonly event: FlowGraphDataConnection<string>;\r\n\r\n    /**\r\n     * Input: whether to also stop remaining immediate handlers. See\r\n     * `FlowGraphCoordinator.stopEventPropagation` for how this maps onto the\r\n     * Babylon single-Observable dispatch model.\r\n     */\r\n    public readonly stopImmediate: FlowGraphDataConnection<boolean>;\r\n\r\n    public constructor(config?: IFlowGraphBlockConfiguration) {\r\n        super(config);\r\n        this.event = this.registerDataInput(\"event\", RichTypeString);\r\n        this.stopImmediate = this.registerDataInput(\"stopImmediate\", RichTypeBoolean, false);\r\n    }\r\n\r\n    public _execute(context: FlowGraphContext): void {\r\n        const event = this.event.getValue(context);\r\n        const stopImmediate = this.stopImmediate.getValue(context);\r\n        context.configuration.coordinator.stopEventPropagation(event, stopImmediate);\r\n        this.out._activateSignal(context);\r\n    }\r\n\r\n    /**\r\n     * @returns class name of the block.\r\n     */\r\n    public override getClassName(): string {\r\n        return FlowGraphBlockNames.StopEventPropagation;\r\n    }\r\n}\r\n\r\nlet _Registered = false;\r\n/**\r\n * Register side effects for flowGraphStopEventPropagationBlock.\r\n * Safe to call multiple times; only the first call has an effect.\r\n */\r\nexport function RegisterFlowGraphStopEventPropagationBlock(): void {\r\n    if (_Registered) {\r\n        return;\r\n    }\r\n    _Registered = true;\r\n\r\n    RegisterClass(FlowGraphBlockNames.StopEventPropagation, FlowGraphStopEventPropagationBlock);\r\n}\r\n"]}

package/FlowGraph/Blocks/Event/index.d.ts

@@ -1,6 +1,7 @@
 export * from "./flowGraphMeshPickEventBlock.js";
 export * from "./flowGraphSceneReadyEventBlock.js";
 export * from "./flowGraphReceiveCustomEventBlock.js";
+export * from "./flowGraphStopEventPropagationBlock.js";
 export * from "./flowGraphSendCustomEventBlock.js";
 export * from "./flowGraphSceneTickEventBlock.js";
 export * from "./flowGraphPointerOutEventBlock.js";

package/FlowGraph/Blocks/Event/index.js

@@ -1,6 +1,7 @@
 export * from "./flowGraphMeshPickEventBlock.js";
 export * from "./flowGraphSceneReadyEventBlock.js";
 export * from "./flowGraphReceiveCustomEventBlock.js";
+export * from "./flowGraphStopEventPropagationBlock.js";
 export * from "./flowGraphSendCustomEventBlock.js";
 export * from "./flowGraphSceneTickEventBlock.js";
 export * from "./flowGraphPointerOutEventBlock.js";

package/FlowGraph/Blocks/Event/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FlowGraph/Blocks/Event/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,uCAAuC,CAAC;AACtD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC","sourcesContent":["export * from \"./flowGraphMeshPickEventBlock\";\r\nexport * from \"./flowGraphSceneReadyEventBlock\";\r\nexport * from \"./flowGraphReceiveCustomEventBlock\";\r\nexport * from \"./flowGraphSendCustomEventBlock\";\r\nexport * from \"./flowGraphSceneTickEventBlock\";\r\nexport * from \"./flowGraphPointerOutEventBlock\";\r\nexport * from \"./flowGraphPointerOverEventBlock\";\r\nexport * from \"./flowGraphPhysicsCollisionEventBlock\";\r\nexport * from \"./flowGraphSoundEndedEventBlock\";\r\nexport * from \"./flowGraphKeyboardEventBlock\";\r\nexport * from \"./flowGraphKeyDownEventBlock\";\r\nexport * from \"./flowGraphKeyUpEventBlock\";\r\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FlowGraph/Blocks/Event/index.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,iCAAiC,CAAC;AAChD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,uCAAuC,CAAC;AACtD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC","sourcesContent":["export * from \"./flowGraphMeshPickEventBlock\";\r\nexport * from \"./flowGraphSceneReadyEventBlock\";\r\nexport * from \"./flowGraphReceiveCustomEventBlock\";\r\nexport * from \"./flowGraphStopEventPropagationBlock\";\r\nexport * from \"./flowGraphSendCustomEventBlock\";\r\nexport * from \"./flowGraphSceneTickEventBlock\";\r\nexport * from \"./flowGraphPointerOutEventBlock\";\r\nexport * from \"./flowGraphPointerOverEventBlock\";\r\nexport * from \"./flowGraphPhysicsCollisionEventBlock\";\r\nexport * from \"./flowGraphSoundEndedEventBlock\";\r\nexport * from \"./flowGraphKeyboardEventBlock\";\r\nexport * from \"./flowGraphKeyDownEventBlock\";\r\nexport * from \"./flowGraphKeyUpEventBlock\";\r\n"]}

package/FlowGraph/Blocks/Event/pure.d.ts

@@ -2,6 +2,7 @@
 export * from "./flowGraphMeshPickEventBlock.pure.js";
 export * from "./flowGraphSceneReadyEventBlock.pure.js";
 export * from "./flowGraphReceiveCustomEventBlock.pure.js";
+export * from "./flowGraphStopEventPropagationBlock.pure.js";
 export * from "./flowGraphSendCustomEventBlock.pure.js";
 export * from "./flowGraphSceneTickEventBlock.pure.js";
 export * from "./flowGraphPointerOutEventBlock.pure.js";