@onerjs/core 8.56.4 → 9.0.1

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

@@ -20,9 +20,16 @@ export interface IFlowGraphReceiveCustomEventBlockConfiguration extends IFlowGra
     eventData: {
         [key: string]: {
             type: RichType<any>;
+            value?: any;
         };
     };
 }
+/**
+ * Returns the event-dispatch key for an authored custom event id.
+ * @param eventId authored custom event id
+ * @returns namespaced event key
+ */
+export declare function GetFlowGraphCustomEventKey(eventId: string): string;
 /**
  * A block that receives a custom event.
  * It saves the event data in the data outputs, based on the provided eventData in the configuration. For example, if the event data is
@@ -40,6 +47,8 @@ export declare class FlowGraphReceiveCustomEventBlock extends FlowGraphEventBloc
      * `event` outputs for equality succeeds. The reference format is owned by the host environment.
      */
     readonly eventRef: FlowGraphDataConnection<string>;
+    /** @returns the configured custom event id */
+    get eventKey(): string;
     constructor(
     /**
      * the configuration of the block

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

@@ -4,12 +4,25 @@ import { Logger } from "../../../Misc/logger.js";
 import { getRichTypeByFlowGraphType, RichTypeString } from "../../flowGraphRichTypes.pure.js";
 import { FlowGraphCoordinator } from "../../flowGraphCoordinator.js";
 import { RegisterClass } from "../../../Misc/typeStore.js";
+import { defaultValueSerializationFunction } from "../../serialization.js";
+/**
+ * Returns the event-dispatch key for an authored custom event id.
+ * @param eventId authored custom event id
+ * @returns namespaced event key
+ */
+export function GetFlowGraphCustomEventKey(eventId) {
+    return `custom:${encodeURIComponent(eventId)}`;
+}
 /**
  * A block that receives a custom event.
  * It saves the event data in the data outputs, based on the provided eventData in the configuration. For example, if the event data is
  * `{ x: { type: RichTypeNumber }, y: { type: RichTypeNumber } }`, the block will have two data outputs: x and y.
  */
 export class FlowGraphReceiveCustomEventBlock extends FlowGraphEventBlock {
+    /** @returns the configured custom event id */
+    get eventKey() {
+        return GetFlowGraphCustomEventKey(this.config.eventId);
+    }
     constructor(
     /**
      * the configuration of the block
@@ -19,7 +32,7 @@ export class FlowGraphReceiveCustomEventBlock extends FlowGraphEventBlock {
         this.config = config;
         this.initPriority = 1;
         // use event data to register data outputs
-        for (const key in this.config.eventData) {
+        for (const key of Object.keys(this.config.eventData ?? {})) {
             const entry = this.config.eventData[key];
             // Handle deserialized config where type may be a string typeName, a plain object
             // with a typeName property (from old JSON serialization), or a proper RichType instance.
@@ -37,7 +50,7 @@ export class FlowGraphReceiveCustomEventBlock extends FlowGraphEventBlock {
                 : this.registerDataOutput("event", RichTypeString);
     }
     _updateOutputs(context) {
-        this.eventRef.setValue(context.getEventReference(this.config.eventId), context);
+        this.eventRef.setValue(context.getEventReference(this.eventKey), context);
     }
     _preparePendingTasks(context) {
         const observable = context.configuration.coordinator.getCustomEventObservable(this.config.eventId);
@@ -49,12 +62,12 @@ export class FlowGraphReceiveCustomEventBlock extends FlowGraphEventBlock {
         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);
+            context.configuration.coordinator._beginEventDispatch(this.eventKey, 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) {
+                for (const key of Object.keys(this.config.eventData ?? {})) {
                     const output = this.getDataOutput(key);
                     if (!output) {
                         continue;
@@ -63,7 +76,7 @@ export class FlowGraphReceiveCustomEventBlock extends FlowGraphEventBlock {
                     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.eventRef.setValue(context.getEventReference(this.eventKey), context);
                 this._execute(context);
             }
             finally {
@@ -79,7 +92,9 @@ export class FlowGraphReceiveCustomEventBlock extends FlowGraphEventBlock {
      * @returns the default value for that key
      */
     _getEventDataDefault(key) {
-        const entry = this.config.eventData?.[key];
+        const entry = this.config.eventData && Object.prototype.hasOwnProperty.call(this.config.eventData, key)
+            ? this.config.eventData[key]
+            : undefined;
         return entry?.value !== undefined ? entry.value : entry?.type?.defaultValue;
     }
     _cancelPendingTasks(context) {
@@ -98,9 +113,19 @@ export class FlowGraphReceiveCustomEventBlock extends FlowGraphEventBlock {
     serialize(serializationObject = {}) {
         super.serialize(serializationObject);
         // Override the eventData in config to store typeName strings instead of RichType instances
-        const serializedEventData = {};
-        for (const key in this.config.eventData) {
-            serializedEventData[key] = { type: this.config.eventData[key].type.typeName };
+        const serializedEventData = Object.create(null);
+        for (const key of Object.keys(this.config.eventData ?? {})) {
+            const entry = this.config.eventData[key];
+            const serializedEntry = { type: entry.type.typeName };
+            if (entry.value !== undefined) {
+                defaultValueSerializationFunction("value", entry.value, serializedEntry);
+            }
+            Object.defineProperty(serializedEventData, key, {
+                configurable: true,
+                enumerable: true,
+                value: serializedEntry,
+                writable: true,
+            });
         }
         serializationObject.config.eventData = serializedEventData;
     }

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, 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"]}
+{"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\nimport { defaultValueSerializationFunction } from \"../../serialization\";\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>; value?: any } };\r\n}\r\n\r\n/**\r\n * Returns the event-dispatch key for an authored custom event id.\r\n * @param eventId authored custom event id\r\n * @returns namespaced event key\r\n */\r\nexport function GetFlowGraphCustomEventKey(eventId: string): string {\r\n    return `custom:${encodeURIComponent(eventId)}`;\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    /** @returns the configured custom event id */\r\n    public override get eventKey(): string {\r\n        return GetFlowGraphCustomEventKey(this.config.eventId);\r\n    }\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 of Object.keys(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.eventKey), 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.eventKey, 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 of Object.keys(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.eventKey), 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 =\r\n            this.config.eventData && Object.prototype.hasOwnProperty.call(this.config.eventData, key)\r\n                ? (this.config.eventData[key] as { type: RichType<any>; value?: any })\r\n                : 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 = Object.create(null);\r\n        for (const key of Object.keys(this.config.eventData ?? {})) {\r\n            const entry = this.config.eventData[key];\r\n            const serializedEntry: { type: string; value?: unknown } = { type: entry.type.typeName };\r\n            if (entry.value !== undefined) {\r\n                defaultValueSerializationFunction(\"value\", entry.value, serializedEntry);\r\n            }\r\n            Object.defineProperty(serializedEventData, key, {\r\n                configurable: true,\r\n                enumerable: true,\r\n                value: serializedEntry,\r\n                writable: true,\r\n            });\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

@@ -10,6 +10,8 @@ import { FlowGraphEventType } from "../../flowGraphEventType.js";
 export declare class FlowGraphSceneReadyEventBlock extends FlowGraphEventBlock {
     initPriority: number;
     readonly type: FlowGraphEventType;
+    /** @returns the shared scene-ready event key */
+    get eventKey(): string;
     /**
      * Output: the opaque reference identifying this event source.
      * All instances of this block share the same reference, so comparing the `event` output of two

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

@@ -8,6 +8,10 @@ const EventKey = "sceneReady";
  * Block that triggers when a scene is ready.
  */
 export class FlowGraphSceneReadyEventBlock extends FlowGraphEventBlock {
+    /** @returns the shared scene-ready event key */
+    get eventKey() {
+        return EventKey;
+    }
     constructor() {
         super();
         this.initPriority = -1;

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;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"]}
+{"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;IAIlE,gDAAgD;IAChD,IAAoB,QAAQ;QACxB,OAAO,QAAQ,CAAC;IACpB,CAAC;IASD;QACI,KAAK,EAAE,CAAC;QAhBI,iBAAY,GAAW,CAAC,CAAC,CAAC;QAEjB,SAAI,oDAAqD;QAe9E,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    /** @returns the shared scene-ready event key */\r\n    public override get eventKey(): string {\r\n        return EventKey;\r\n    }\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

@@ -3,12 +3,20 @@ import { FlowGraphEventBlock } from "../../flowGraphEventBlock.js";
 import { type FlowGraphContext } from "../../flowGraphContext.js";
 import { type FlowGraphDataConnection } from "../../flowGraphDataConnection.pure.js";
 import { FlowGraphEventType } from "../../flowGraphEventType.js";
+import { type IFlowGraphBlockConfiguration } from "../../flowGraphBlock.js";
+/**
+ * Configuration for the scene tick event.
+ */
+export interface IFlowGraphSceneTickEventBlockConfiguration extends IFlowGraphBlockConfiguration {
+    /** Whether elapsed time starts at the first tick, whose delta time remains NaN. Defaults to false. */
+    useFirstTickAsStart?: boolean;
+}
 /**
  * Payload for the scene tick event.
  */
 export interface IFlowGraphOnTickEventPayload {
     /**
-     * the time in seconds since the scene started.
+     * The scene's accumulated time in seconds before the current frame interval.
      */
     timeSinceStart: number;
     /**
@@ -21,11 +29,11 @@ export interface IFlowGraphOnTickEventPayload {
  */
 export declare class FlowGraphSceneTickEventBlock extends FlowGraphEventBlock {
     /**
-     * the time in seconds since the scene started.
+     * Time in seconds since the scene started, or since the first tick when useFirstTickAsStart is enabled.
      */
     readonly timeSinceStart: FlowGraphDataConnection<number>;
     /**
-     * the time in seconds since the last frame.
+     * Time in seconds since the last frame. Remains NaN on the first opted-in tick.
      */
     readonly deltaTime: FlowGraphDataConnection<number>;
     /**
@@ -35,7 +43,13 @@ export declare class FlowGraphSceneTickEventBlock extends FlowGraphEventBlock {
      */
     readonly eventRef: FlowGraphDataConnection<string>;
     readonly type: FlowGraphEventType;
-    constructor();
+    /** @returns the shared scene-tick event key */
+    get eventKey(): string;
+    /**
+     * Creates a scene tick event block.
+     * @param config optional clock behavior
+     */
+    constructor(config?: IFlowGraphSceneTickEventBlockConfiguration);
     _updateOutputs(context: FlowGraphContext): void;
     /**
      * @internal

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

@@ -8,11 +8,19 @@ const EventKey = "sceneTick";
  * Block that triggers on scene tick (before each render).
  */
 export class FlowGraphSceneTickEventBlock extends FlowGraphEventBlock {
-    constructor() {
-        super();
+    /** @returns the shared scene-tick event key */
+    get eventKey() {
+        return EventKey;
+    }
+    /**
+     * Creates a scene tick event block.
+     * @param config optional clock behavior
+     */
+    constructor(config) {
+        super(config);
         this.type = "SceneBeforeRender" /* FlowGraphEventType.SceneBeforeRender */;
-        this.timeSinceStart = this.registerDataOutput("timeSinceStart", RichTypeNumber);
-        this.deltaTime = this.registerDataOutput("deltaTime", RichTypeNumber);
+        this.timeSinceStart = this.registerDataOutput("timeSinceStart", RichTypeNumber, config?.useFirstTickAsStart ? NaN : 0);
+        this.deltaTime = this.registerDataOutput("deltaTime", RichTypeNumber, config?.useFirstTickAsStart ? NaN : 0);
         this.eventRef = this.registerDataOutput("event", RichTypeString);
     }
     _updateOutputs(context) {
@@ -28,8 +36,18 @@ export class FlowGraphSceneTickEventBlock extends FlowGraphEventBlock {
      * @internal
      */
     _executeEvent(context, payload) {
-        this.timeSinceStart.setValue(payload.timeSinceStart, context);
-        this.deltaTime.setValue(payload.deltaTime, context);
+        if (this.config?.useFirstTickAsStart) {
+            const firstTick = context._getGlobalContextVariable("firstTickPayload", payload);
+            context._setGlobalContextVariable("firstTickPayload", firstTick);
+            // The scene counter advances after dispatch; elapsed time uses the current tick's interval instead of the first one.
+            const elapsedTime = payload.timeSinceStart - firstTick.timeSinceStart + payload.deltaTime - firstTick.deltaTime;
+            this.timeSinceStart.setValue(payload === firstTick ? 0 : elapsedTime, context);
+            this.deltaTime.setValue(payload === firstTick ? NaN : payload.deltaTime, context);
+        }
+        else {
+            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,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"]}
+{"version":3,"file":"flowGraphSceneTickEventBlock.pure.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FlowGraph/Blocks/Event/flowGraphSceneTickEventBlock.pure.ts"],"names":[],"mappings":"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","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\nimport { type IFlowGraphBlockConfiguration } from \"../../flowGraphBlock\";\r\n\r\n/**\r\n * Configuration for the scene tick event.\r\n */\r\nexport interface IFlowGraphSceneTickEventBlockConfiguration extends IFlowGraphBlockConfiguration {\r\n    /** Whether elapsed time starts at the first tick, whose delta time remains NaN. Defaults to false. */\r\n    useFirstTickAsStart?: boolean;\r\n}\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 scene's accumulated time in seconds before the current frame interval.\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     * Time in seconds since the scene started, or since the first tick when useFirstTickAsStart is enabled.\r\n     */\r\n    public readonly timeSinceStart: FlowGraphDataConnection<number>;\r\n\r\n    /**\r\n     * Time in seconds since the last frame. Remains NaN on the first opted-in tick.\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    /** @returns the shared scene-tick event key */\r\n    public override get eventKey(): string {\r\n        return EventKey;\r\n    }\r\n\r\n    /**\r\n     * Creates a scene tick event block.\r\n     * @param config optional clock behavior\r\n     */\r\n    constructor(config?: IFlowGraphSceneTickEventBlockConfiguration) {\r\n        super(config);\r\n        this.timeSinceStart = this.registerDataOutput(\"timeSinceStart\", RichTypeNumber, config?.useFirstTickAsStart ? NaN : 0);\r\n        this.deltaTime = this.registerDataOutput(\"deltaTime\", RichTypeNumber, config?.useFirstTickAsStart ? NaN : 0);\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        if (this.config?.useFirstTickAsStart) {\r\n            const firstTick = context._getGlobalContextVariable(\"firstTickPayload\", payload);\r\n            context._setGlobalContextVariable(\"firstTickPayload\", firstTick);\r\n            // The scene counter advances after dispatch; elapsed time uses the current tick's interval instead of the first one.\r\n            const elapsedTime = payload.timeSinceStart - firstTick.timeSinceStart + payload.deltaTime - firstTick.deltaTime;\r\n            this.timeSinceStart.setValue(payload === firstTick ? 0 : elapsedTime, context);\r\n            this.deltaTime.setValue(payload === firstTick ? NaN : payload.deltaTime, context);\r\n        } else {\r\n            this.timeSinceStart.setValue(payload.timeSinceStart, context);\r\n            this.deltaTime.setValue(payload.deltaTime, context);\r\n        }\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/flowGraphSendCustomEventBlock.pure.js

@@ -2,6 +2,7 @@
 import { getRichTypeByFlowGraphType } from "../../flowGraphRichTypes.pure.js";
 import { FlowGraphExecutionBlockWithOutSignal } from "../../flowGraphExecutionBlockWithOutSignal.js";
 import { RegisterClass } from "../../../Misc/typeStore.js";
+import { defaultValueSerializationFunction } from "../../serialization.js";
 /**
  * A block that sends a custom event.
  * To receive this event you need to use the ReceiveCustomEvent block.
@@ -16,7 +17,7 @@ export class FlowGraphSendCustomEventBlock extends FlowGraphExecutionBlockWithOu
     config) {
         super(config);
         this.config = config;
-        for (const key in this.config.eventData) {
+        for (const key of Object.keys(this.config.eventData ?? {})) {
             const entry = this.config.eventData[key];
             // Handle deserialized config where type may be a string typeName, a plain object
             // with a typeName property (from old JSON serialization), or a proper RichType instance.
@@ -29,9 +30,14 @@ export class FlowGraphSendCustomEventBlock extends FlowGraphExecutionBlockWithOu
     _execute(context) {
         const eventId = this.config.eventId;
         // eventData is a map with the key being the data input's name, and value being the data input's value
-        const eventData = {};
+        const eventData = Object.create(null);
         for (const port of this.dataInputs) {
-            eventData[port.name] = port.getValue(context);
+            Object.defineProperty(eventData, port.name, {
+                configurable: true,
+                enumerable: true,
+                value: port.getValue(context),
+                writable: true,
+            });
         }
         context.configuration.coordinator.notifyCustomEvent(eventId, eventData);
         this.out._activateSignal(context);
@@ -39,13 +45,19 @@ export class FlowGraphSendCustomEventBlock extends FlowGraphExecutionBlockWithOu
     serialize(serializationObject = {}) {
         super.serialize(serializationObject);
         // Override the eventData in config to store typeName strings instead of RichType instances
-        const serializedEventData = {};
-        for (const key in this.config.eventData) {
+        const serializedEventData = Object.create(null);
+        for (const key of Object.keys(this.config.eventData ?? {})) {
             const entry = this.config.eventData[key];
-            serializedEventData[key] = { type: entry.type.typeName };
+            const serializedEntry = { type: entry.type.typeName };
             if (entry.value !== undefined) {
-                serializedEventData[key].value = entry.value;
+                defaultValueSerializationFunction("value", entry.value, serializedEntry);
             }
+            Object.defineProperty(serializedEventData, key, {
+                configurable: true,
+                enumerable: true,
+                value: serializedEntry,
+                writable: true,
+            });
         }
         serializationObject.config.eventData = serializedEventData;
     }

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

@@ -1 +1 @@
-{"version":3,"file":"flowGraphSendCustomEventBlock.pure.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FlowGraph/Blocks/Event/flowGraphSendCustomEventBlock.pure.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,OAAO,EAAiB,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AACnG,OAAO,EAAE,oCAAoC,EAAE,MAAM,4CAA4C,CAAC;AAIlG,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAgBxD;;;;;GAKG;AACH,MAAM,OAAO,6BAA8B,SAAQ,oCAAoC;IACnF;IACI;;OAEG;IACa,MAAmD;QAEnE,KAAK,CAAC,MAAM,CAAC,CAAC;QAFE,WAAM,GAAN,MAAM,CAA6C;QAGnE,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACzC,iFAAiF;YACjF,yFAAyF;YACzF,MAAM,OAAO,GAAG,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC;YACnF,MAAM,QAAQ,GAAG,OAAO,KAAK,CAAC,IAAI,EAAE,SAAS,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC;YAChH,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC;YACtB,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACvD,CAAC;IACL,CAAC;IAEM,QAAQ,CAAC,OAAyB;QACrC,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QACpC,sGAAsG;QACtG,MAAM,SAAS,GAAQ,EAAE,CAAC;QAC1B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACjC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAClD,CAAC;QAED,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,iBAAiB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAExE,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAEe,SAAS,CAAC,sBAA2B,EAAE;QACnD,KAAK,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;QACrC,2FAA2F;QAC3F,MAAM,mBAAmB,GAAQ,EAAE,CAAC;QACpC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACzC,mBAAmB,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACzD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC5B,mBAAmB,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;YACjD,CAAC;QACL,CAAC;QACD,mBAAmB,CAAC,MAAM,CAAC,SAAS,GAAG,mBAAmB,CAAC;IAC/D,CAAC;IAED;;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 { type RichType, getRichTypeByFlowGraphType } from \"core/FlowGraph/flowGraphRichTypes.pure\";\r\nimport { FlowGraphExecutionBlockWithOutSignal } from \"../../flowGraphExecutionBlockWithOutSignal\";\r\nimport { type FlowGraphContext } from \"../../flowGraphContext\";\r\nimport { type IFlowGraphBlockConfiguration } from \"../../flowGraphBlock\";\r\nimport { FlowGraphBlockNames } from \"../flowGraphBlockNames\";\r\nimport { RegisterClass } from \"../../../Misc/typeStore\";\r\n\r\n/**\r\n * Parameters used to create a FlowGraphSendCustomEventBlock.\r\n */\r\nexport interface IFlowGraphSendCustomEventBlockConfiguration extends IFlowGraphBlockConfiguration {\r\n    /**\r\n     * The id of the event to send.\r\n     * Note - in the glTF specs this is an index to the event array (i.e. - a number)\r\n     */\r\n    eventId: string;\r\n    /**\r\n     * The names of the data inputs for that event.\r\n     */\r\n    eventData: { [key: string]: { type: RichType<any>; value?: any } };\r\n}\r\n/**\r\n * A block that sends a custom event.\r\n * To receive this event you need to use the ReceiveCustomEvent block.\r\n * This block has no output, but does have inputs based on the eventData from the configuration.\r\n * @see FlowGraphReceiveCustomEventBlock\r\n */\r\nexport class FlowGraphSendCustomEventBlock extends FlowGraphExecutionBlockWithOutSignal {\r\n    public constructor(\r\n        /**\r\n         * the configuration of the block\r\n         */\r\n        public override config: IFlowGraphSendCustomEventBlockConfiguration\r\n    ) {\r\n        super(config);\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.registerDataInput(key, richType, entry.value);\r\n        }\r\n    }\r\n\r\n    public _execute(context: FlowGraphContext): void {\r\n        const eventId = this.config.eventId;\r\n        // eventData is a map with the key being the data input's name, and value being the data input's value\r\n        const eventData: any = {};\r\n        for (const port of this.dataInputs) {\r\n            eventData[port.name] = port.getValue(context);\r\n        }\r\n\r\n        context.configuration.coordinator.notifyCustomEvent(eventId, eventData);\r\n\r\n        this.out._activateSignal(context);\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            const entry = this.config.eventData[key];\r\n            serializedEventData[key] = { type: entry.type.typeName };\r\n            if (entry.value !== undefined) {\r\n                serializedEventData[key].value = entry.value;\r\n            }\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.SendCustomEvent;\r\n    }\r\n}\r\n\r\nlet _Registered = false;\r\n/**\r\n * Register side effects for flowGraphSendCustomEventBlock.\r\n * Safe to call multiple times; only the first call has an effect.\r\n */\r\nexport function RegisterFlowGraphSendCustomEventBlock(): void {\r\n    if (_Registered) {\r\n        return;\r\n    }\r\n    _Registered = true;\r\n\r\n    RegisterClass(FlowGraphBlockNames.SendCustomEvent, FlowGraphSendCustomEventBlock);\r\n}\r\n"]}
+{"version":3,"file":"flowGraphSendCustomEventBlock.pure.js","sourceRoot":"","sources":["../../../../../../dev/core/src/FlowGraph/Blocks/Event/flowGraphSendCustomEventBlock.pure.ts"],"names":[],"mappings":"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","sourcesContent":["/** This file must only contain pure code and pure imports */\r\n\r\nimport { type RichType, getRichTypeByFlowGraphType } from \"core/FlowGraph/flowGraphRichTypes.pure\";\r\nimport { FlowGraphExecutionBlockWithOutSignal } from \"../../flowGraphExecutionBlockWithOutSignal\";\r\nimport { type FlowGraphContext } from \"../../flowGraphContext\";\r\nimport { type IFlowGraphBlockConfiguration } from \"../../flowGraphBlock\";\r\nimport { FlowGraphBlockNames } from \"../flowGraphBlockNames\";\r\nimport { RegisterClass } from \"../../../Misc/typeStore\";\r\nimport { defaultValueSerializationFunction } from \"../../serialization\";\r\n\r\n/**\r\n * Parameters used to create a FlowGraphSendCustomEventBlock.\r\n */\r\nexport interface IFlowGraphSendCustomEventBlockConfiguration extends IFlowGraphBlockConfiguration {\r\n    /**\r\n     * The id of the event to send.\r\n     * Note - in the glTF specs this is an index to the event array (i.e. - a number)\r\n     */\r\n    eventId: string;\r\n    /**\r\n     * The names of the data inputs for that event.\r\n     */\r\n    eventData: { [key: string]: { type: RichType<any>; value?: any } };\r\n}\r\n/**\r\n * A block that sends a custom event.\r\n * To receive this event you need to use the ReceiveCustomEvent block.\r\n * This block has no output, but does have inputs based on the eventData from the configuration.\r\n * @see FlowGraphReceiveCustomEventBlock\r\n */\r\nexport class FlowGraphSendCustomEventBlock extends FlowGraphExecutionBlockWithOutSignal {\r\n    public constructor(\r\n        /**\r\n         * the configuration of the block\r\n         */\r\n        public override config: IFlowGraphSendCustomEventBlockConfiguration\r\n    ) {\r\n        super(config);\r\n        for (const key of Object.keys(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.registerDataInput(key, richType, entry.value);\r\n        }\r\n    }\r\n\r\n    public _execute(context: FlowGraphContext): void {\r\n        const eventId = this.config.eventId;\r\n        // eventData is a map with the key being the data input's name, and value being the data input's value\r\n        const eventData: any = Object.create(null);\r\n        for (const port of this.dataInputs) {\r\n            Object.defineProperty(eventData, port.name, {\r\n                configurable: true,\r\n                enumerable: true,\r\n                value: port.getValue(context),\r\n                writable: true,\r\n            });\r\n        }\r\n\r\n        context.configuration.coordinator.notifyCustomEvent(eventId, eventData);\r\n\r\n        this.out._activateSignal(context);\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 = Object.create(null);\r\n        for (const key of Object.keys(this.config.eventData ?? {})) {\r\n            const entry = this.config.eventData[key];\r\n            const serializedEntry: { type: string; value?: unknown } = { type: entry.type.typeName };\r\n            if (entry.value !== undefined) {\r\n                defaultValueSerializationFunction(\"value\", entry.value, serializedEntry);\r\n            }\r\n            Object.defineProperty(serializedEventData, key, {\r\n                configurable: true,\r\n                enumerable: true,\r\n                value: serializedEntry,\r\n                writable: true,\r\n            });\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.SendCustomEvent;\r\n    }\r\n}\r\n\r\nlet _Registered = false;\r\n/**\r\n * Register side effects for flowGraphSendCustomEventBlock.\r\n * Safe to call multiple times; only the first call has an effect.\r\n */\r\nexport function RegisterFlowGraphSendCustomEventBlock(): void {\r\n    if (_Registered) {\r\n        return;\r\n    }\r\n    _Registered = true;\r\n\r\n    RegisterClass(FlowGraphBlockNames.SendCustomEvent, FlowGraphSendCustomEventBlock);\r\n}\r\n"]}

package/FlowGraph/Blocks/Execution/Animation/flowGraphInterpolationBlock.pure.js

@@ -65,16 +65,16 @@ export class FlowGraphInterpolationBlock extends FlowGraphBlock {
         const type = this.initialValue.richType;
         const keys = [];
         // add initial value
-        const currentValue = this.initialValue.getValue(context) || type.defaultValue;
+        const currentValue = this.initialValue.getValue(context) ?? type.defaultValue;
         keys.push({ frame: 0, value: currentValue });
         const numberOfKeyFrames = this.config?.numberOfKeyFrames ?? 1;
         for (let i = 1; i < numberOfKeyFrames + 1; i++) {
             const duration = this.keyFrames[i].duration?.getValue(context);
             let value = this.keyFrames[i].value?.getValue(context);
             if (i === numberOfKeyFrames - 1) {
-                value = value || type.defaultValue;
+                value = value ?? type.defaultValue;
             }
-            if (duration !== undefined && value) {
+            if (duration !== undefined && value !== undefined && value !== null) {
                 // convert duration to frames, based on 60 fps
                 keys.push({ frame: duration * 60, value });
             }

package/FlowGraph/Blocks/Execution/Animation/flowGraphInterpolationBlock.pure.js.map

@@ -1 +1 @@
-{"version":3,"file":"flowGraphInterpolationBlock.pure.js","sourceRoot":"","sources":["../../../../../../../dev/core/src/FlowGraph/Blocks/Execution/Animation/flowGraphInterpolationBlock.pure.ts"],"names":[],"mappings":"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","sourcesContent":["/** This file must only contain pure code and pure imports */\n\nimport { type EasingFunction } from \"core/Animations/easing\";\nimport { Constants } from \"core/Engines/constants\";\nimport { FlowGraphBlock, type IFlowGraphBlockConfiguration } from \"core/FlowGraph/flowGraphBlock\";\nimport { type FlowGraphContext } from \"core/FlowGraph/flowGraphContext\";\nimport { type FlowGraphDataConnection } from \"core/FlowGraph/flowGraphDataConnection.pure\";\nimport { type FlowGraphTypes, getRichTypeByAnimationType, getRichTypeByFlowGraphType, RichTypeAny, RichTypeNumber, RichTypeString } from \"core/FlowGraph/flowGraphRichTypes.pure\";\nimport { type Animation, AnimationCreateAnimation } from \"core/Animations/animation.pure\";\nimport { FlowGraphBlockNames } from \"../../flowGraphBlockNames\";\nimport { RegisterClass } from \"core/Misc/typeStore\";\n\n/**\n * Configuration for the interpolation block.\n */\nexport interface IFlowGraphInterpolationBlockConfiguration extends IFlowGraphBlockConfiguration {\n    /**\n     * The number of keyframes to interpolate between.\n     * Will default to 1 if not provided (i.e. from currentValue to a provided value in the time provided)\n     */\n    keyFramesCount?: number;\n\n    /**\n     * The duration of the interpolation.\n     */\n    duration?: number;\n\n    /**\n     * The name of the property that will be interpolated.\n     */\n    propertyName?: string | string[];\n\n    /**\n     * The type of the animation to create.\n     * Default is ANIMATIONTYPE_FLOAT\n     * This cannot be changed after construction, so make sure to pass the right value.\n     */\n    animationType?: number | FlowGraphTypes;\n}\n\n/**\n * This block is responsible for interpolating between two values.\n * The babylon concept used is Animation, and it is the output of this block.\n *\n * Note that values will be parsed when the in connection is triggered. until then changing the value will not trigger a new interpolation.\n *\n * Internally this block uses the Animation class.\n *\n * Note that if the interpolation is already running a signal will be sent to stop the animation group running it.\n */\nexport class FlowGraphInterpolationBlock<T> extends FlowGraphBlock {\n    /**\n     * Input connection: The value to interpolate from.\n     * Optional. If not provided, the current value will be used.\n     * Note that if provided, every time the animation is created this value will be used!\n     */\n    public readonly initialValue: FlowGraphDataConnection<T>;\n\n    /**\n     * Input connection: The value to interpolate to.\n     * Optional. This can also be set using the KeyFrames input!\n     * If provided it will be set to the last keyframe value.\n     */\n    public readonly endValue: FlowGraphDataConnection<T>;\n\n    /**\n     * output connection: The animation that will be created when in is triggered.\n     */\n    public readonly animation: FlowGraphDataConnection<Animation | Animation[]>;\n\n    /**\n     * Input connection: An optional easing function to use for the interpolation.\n     */\n    public readonly easingFunction: FlowGraphDataConnection<EasingFunction>;\n\n    /**\n     * Input connection: The name of the property that will be set\n     */\n    public readonly propertyName: FlowGraphDataConnection<string | string[]>;\n\n    /**\n     * If provided, this function will be used to create the animation object(s).\n     */\n    public readonly customBuildAnimation: FlowGraphDataConnection<\n        (target: any, propertname: any, context: FlowGraphContext) => (keys: any[], fps: number, animationType: number, easingFunction?: EasingFunction) => Animation | Animation[]\n    >;\n\n    /**\n     * The keyframes to interpolate between.\n     * Each keyframe has a duration input and a value input.\n     */\n    public readonly keyFrames: {\n        duration: FlowGraphDataConnection<number>;\n        value: FlowGraphDataConnection<T>;\n    }[] = [];\n\n    constructor(config: IFlowGraphInterpolationBlockConfiguration = {}) {\n        super(config);\n        const type =\n            typeof config?.animationType === \"string\"\n                ? getRichTypeByFlowGraphType(config.animationType)\n                : getRichTypeByAnimationType(config?.animationType ?? Constants.ANIMATIONTYPE_FLOAT);\n\n        const numberOfKeyFrames = config?.keyFramesCount ?? 1;\n        const duration = this.registerDataInput(`duration_0`, RichTypeNumber, 0);\n        const value = this.registerDataInput(`value_0`, type);\n        this.keyFrames.push({ duration, value });\n        for (let i = 1; i < numberOfKeyFrames + 1; i++) {\n            const duration = this.registerDataInput(`duration_${i}`, RichTypeNumber, i === numberOfKeyFrames ? config.duration : undefined);\n            const value = this.registerDataInput(`value_${i}`, type);\n            this.keyFrames.push({ duration, value });\n        }\n        this.initialValue = this.keyFrames[0].value;\n        this.endValue = this.keyFrames[numberOfKeyFrames].value;\n        this.easingFunction = this.registerDataInput(\"easingFunction\", RichTypeAny);\n        this.animation = this.registerDataOutput(\"animation\", RichTypeAny);\n        this.propertyName = this.registerDataInput(\"propertyName\", RichTypeString, config?.propertyName);\n        this.customBuildAnimation = this.registerDataInput(\"customBuildAnimation\", RichTypeAny);\n    }\n\n    public override _updateOutputs(context: FlowGraphContext): void {\n        const interpolationAnimations = context._getGlobalContextVariable(\"interpolationAnimations\", []) as number[];\n        const propertyName = this.propertyName.getValue(context);\n        const easingFunction = this.easingFunction.getValue(context);\n        const animation = this._createAnimation(context, propertyName, easingFunction);\n        // If an old animation exists, it will be ignored here.\n        // This is because if the animation is running and they both have the same target, the old will be stopped.\n        // This doesn't happen here, it happens in the play animation block.\n        this.animation.setValue(animation, context);\n        // to make sure no 2 interpolations are running on the same target, we will mark the animation in the context\n        if (Array.isArray(animation)) {\n            for (const anim of animation) {\n                interpolationAnimations.push(anim.uniqueId);\n            }\n        } else {\n            interpolationAnimations.push(animation.uniqueId);\n        }\n        context._setGlobalContextVariable(\"interpolationAnimations\", interpolationAnimations);\n    }\n\n    private _createAnimation(context: FlowGraphContext, propertyName: string | string[], easingFunction: EasingFunction): Animation | Animation[] {\n        const type = this.initialValue.richType;\n        const keys: { frame: number; value: T }[] = [];\n        // add initial value\n        const currentValue = this.initialValue.getValue(context) || type.defaultValue;\n        keys.push({ frame: 0, value: currentValue });\n        const numberOfKeyFrames = this.config?.numberOfKeyFrames ?? 1;\n        for (let i = 1; i < numberOfKeyFrames + 1; i++) {\n            const duration = this.keyFrames[i].duration?.getValue(context);\n            let value = this.keyFrames[i].value?.getValue(context);\n            if (i === numberOfKeyFrames - 1) {\n                value = value || type.defaultValue;\n            }\n            if (duration !== undefined && value) {\n                // convert duration to frames, based on 60 fps\n                keys.push({ frame: duration * 60, value });\n            }\n        }\n        const customBuildAnimation = this.customBuildAnimation.getValue(context);\n        if (customBuildAnimation) {\n            return customBuildAnimation(null, null, context)(keys, 60, type.animationType, easingFunction);\n        }\n        if (typeof propertyName === \"string\") {\n            const animation = AnimationCreateAnimation(propertyName, type.animationType, 60, easingFunction);\n            animation.setKeys(keys);\n            return [animation];\n        } else {\n            const animations = propertyName.map((name) => {\n                const animation = AnimationCreateAnimation(name, type.animationType, 60, easingFunction);\n                animation.setKeys(keys);\n                return animation;\n            });\n            return animations;\n        }\n    }\n\n    public override getClassName(): string {\n        return FlowGraphBlockNames.ValueInterpolation;\n    }\n}\n\n// #L54P2C\n\nlet _Registered = false;\n/**\n * Register side effects for flowGraphInterpolationBlock.\n * Safe to call multiple times; only the first call has an effect.\n */\nexport function RegisterFlowGraphInterpolationBlock(): void {\n    if (_Registered) {\n        return;\n    }\n    _Registered = true;\n\n    RegisterClass(FlowGraphBlockNames.ValueInterpolation, FlowGraphInterpolationBlock);\n}\n"]}
+{"version":3,"file":"flowGraphInterpolationBlock.pure.js","sourceRoot":"","sources":["../../../../../../../dev/core/src/FlowGraph/Blocks/Execution/Animation/flowGraphInterpolationBlock.pure.ts"],"names":[],"mappings":"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","sourcesContent":["/** This file must only contain pure code and pure imports */\n\nimport { type EasingFunction } from \"core/Animations/easing\";\nimport { Constants } from \"core/Engines/constants\";\nimport { FlowGraphBlock, type IFlowGraphBlockConfiguration } from \"core/FlowGraph/flowGraphBlock\";\nimport { type FlowGraphContext } from \"core/FlowGraph/flowGraphContext\";\nimport { type FlowGraphDataConnection } from \"core/FlowGraph/flowGraphDataConnection.pure\";\nimport { type FlowGraphTypes, getRichTypeByAnimationType, getRichTypeByFlowGraphType, RichTypeAny, RichTypeNumber, RichTypeString } from \"core/FlowGraph/flowGraphRichTypes.pure\";\nimport { type Animation, AnimationCreateAnimation } from \"core/Animations/animation.pure\";\nimport { FlowGraphBlockNames } from \"../../flowGraphBlockNames\";\nimport { RegisterClass } from \"core/Misc/typeStore\";\n\n/**\n * Configuration for the interpolation block.\n */\nexport interface IFlowGraphInterpolationBlockConfiguration extends IFlowGraphBlockConfiguration {\n    /**\n     * The number of keyframes to interpolate between.\n     * Will default to 1 if not provided (i.e. from currentValue to a provided value in the time provided)\n     */\n    keyFramesCount?: number;\n\n    /**\n     * The duration of the interpolation.\n     */\n    duration?: number;\n\n    /**\n     * The name of the property that will be interpolated.\n     */\n    propertyName?: string | string[];\n\n    /**\n     * The type of the animation to create.\n     * Default is ANIMATIONTYPE_FLOAT\n     * This cannot be changed after construction, so make sure to pass the right value.\n     */\n    animationType?: number | FlowGraphTypes;\n}\n\n/**\n * This block is responsible for interpolating between two values.\n * The babylon concept used is Animation, and it is the output of this block.\n *\n * Note that values will be parsed when the in connection is triggered. until then changing the value will not trigger a new interpolation.\n *\n * Internally this block uses the Animation class.\n *\n * Note that if the interpolation is already running a signal will be sent to stop the animation group running it.\n */\nexport class FlowGraphInterpolationBlock<T> extends FlowGraphBlock {\n    /**\n     * Input connection: The value to interpolate from.\n     * Optional. If not provided, the current value will be used.\n     * Note that if provided, every time the animation is created this value will be used!\n     */\n    public readonly initialValue: FlowGraphDataConnection<T>;\n\n    /**\n     * Input connection: The value to interpolate to.\n     * Optional. This can also be set using the KeyFrames input!\n     * If provided it will be set to the last keyframe value.\n     */\n    public readonly endValue: FlowGraphDataConnection<T>;\n\n    /**\n     * output connection: The animation that will be created when in is triggered.\n     */\n    public readonly animation: FlowGraphDataConnection<Animation | Animation[]>;\n\n    /**\n     * Input connection: An optional easing function to use for the interpolation.\n     */\n    public readonly easingFunction: FlowGraphDataConnection<EasingFunction>;\n\n    /**\n     * Input connection: The name of the property that will be set\n     */\n    public readonly propertyName: FlowGraphDataConnection<string | string[]>;\n\n    /**\n     * If provided, this function will be used to create the animation object(s).\n     */\n    public readonly customBuildAnimation: FlowGraphDataConnection<\n        (target: any, propertname: any, context: FlowGraphContext) => (keys: any[], fps: number, animationType: number, easingFunction?: EasingFunction) => Animation | Animation[]\n    >;\n\n    /**\n     * The keyframes to interpolate between.\n     * Each keyframe has a duration input and a value input.\n     */\n    public readonly keyFrames: {\n        duration: FlowGraphDataConnection<number>;\n        value: FlowGraphDataConnection<T>;\n    }[] = [];\n\n    constructor(config: IFlowGraphInterpolationBlockConfiguration = {}) {\n        super(config);\n        const type =\n            typeof config?.animationType === \"string\"\n                ? getRichTypeByFlowGraphType(config.animationType)\n                : getRichTypeByAnimationType(config?.animationType ?? Constants.ANIMATIONTYPE_FLOAT);\n\n        const numberOfKeyFrames = config?.keyFramesCount ?? 1;\n        const duration = this.registerDataInput(`duration_0`, RichTypeNumber, 0);\n        const value = this.registerDataInput(`value_0`, type);\n        this.keyFrames.push({ duration, value });\n        for (let i = 1; i < numberOfKeyFrames + 1; i++) {\n            const duration = this.registerDataInput(`duration_${i}`, RichTypeNumber, i === numberOfKeyFrames ? config.duration : undefined);\n            const value = this.registerDataInput(`value_${i}`, type);\n            this.keyFrames.push({ duration, value });\n        }\n        this.initialValue = this.keyFrames[0].value;\n        this.endValue = this.keyFrames[numberOfKeyFrames].value;\n        this.easingFunction = this.registerDataInput(\"easingFunction\", RichTypeAny);\n        this.animation = this.registerDataOutput(\"animation\", RichTypeAny);\n        this.propertyName = this.registerDataInput(\"propertyName\", RichTypeString, config?.propertyName);\n        this.customBuildAnimation = this.registerDataInput(\"customBuildAnimation\", RichTypeAny);\n    }\n\n    public override _updateOutputs(context: FlowGraphContext): void {\n        const interpolationAnimations = context._getGlobalContextVariable(\"interpolationAnimations\", []) as number[];\n        const propertyName = this.propertyName.getValue(context);\n        const easingFunction = this.easingFunction.getValue(context);\n        const animation = this._createAnimation(context, propertyName, easingFunction);\n        // If an old animation exists, it will be ignored here.\n        // This is because if the animation is running and they both have the same target, the old will be stopped.\n        // This doesn't happen here, it happens in the play animation block.\n        this.animation.setValue(animation, context);\n        // to make sure no 2 interpolations are running on the same target, we will mark the animation in the context\n        if (Array.isArray(animation)) {\n            for (const anim of animation) {\n                interpolationAnimations.push(anim.uniqueId);\n            }\n        } else {\n            interpolationAnimations.push(animation.uniqueId);\n        }\n        context._setGlobalContextVariable(\"interpolationAnimations\", interpolationAnimations);\n    }\n\n    private _createAnimation(context: FlowGraphContext, propertyName: string | string[], easingFunction: EasingFunction): Animation | Animation[] {\n        const type = this.initialValue.richType;\n        const keys: { frame: number; value: T }[] = [];\n        // add initial value\n        const currentValue = this.initialValue.getValue(context) ?? type.defaultValue;\n        keys.push({ frame: 0, value: currentValue });\n        const numberOfKeyFrames = this.config?.numberOfKeyFrames ?? 1;\n        for (let i = 1; i < numberOfKeyFrames + 1; i++) {\n            const duration = this.keyFrames[i].duration?.getValue(context);\n            let value = this.keyFrames[i].value?.getValue(context);\n            if (i === numberOfKeyFrames - 1) {\n                value = value ?? type.defaultValue;\n            }\n            if (duration !== undefined && value !== undefined && value !== null) {\n                // convert duration to frames, based on 60 fps\n                keys.push({ frame: duration * 60, value });\n            }\n        }\n        const customBuildAnimation = this.customBuildAnimation.getValue(context);\n        if (customBuildAnimation) {\n            return customBuildAnimation(null, null, context)(keys, 60, type.animationType, easingFunction);\n        }\n        if (typeof propertyName === \"string\") {\n            const animation = AnimationCreateAnimation(propertyName, type.animationType, 60, easingFunction);\n            animation.setKeys(keys);\n            return [animation];\n        } else {\n            const animations = propertyName.map((name) => {\n                const animation = AnimationCreateAnimation(name, type.animationType, 60, easingFunction);\n                animation.setKeys(keys);\n                return animation;\n            });\n            return animations;\n        }\n    }\n\n    public override getClassName(): string {\n        return FlowGraphBlockNames.ValueInterpolation;\n    }\n}\n\n// #L54P2C\n\nlet _Registered = false;\n/**\n * Register side effects for flowGraphInterpolationBlock.\n * Safe to call multiple times; only the first call has an effect.\n */\nexport function RegisterFlowGraphInterpolationBlock(): void {\n    if (_Registered) {\n        return;\n    }\n    _Registered = true;\n\n    RegisterClass(FlowGraphBlockNames.ValueInterpolation, FlowGraphInterpolationBlock);\n}\n"]}

package/FlowGraph/Blocks/Execution/Animation/flowGraphPlayAnimationBlock.pure.d.ts

@@ -5,6 +5,17 @@ import { FlowGraphAsyncExecutionBlock } from "../../../flowGraphAsyncExecutionBl
 import { type IFlowGraphBlockConfiguration } from "../../../flowGraphBlock.js";
 import { AnimationGroup } from "../../../../Animations/animationGroup.pure.js";
 import { type Animation } from "../../../../Animations/animation.pure.js";
+import { type IAnimatable } from "../../../../Animations/animatable.interface.js";
+export { RemoveFlowGraphAnimationGroupObservers } from "../../../flowGraphAnimationHelpers.js";
+/**
+ * Configuration for playing an animation.
+ */
+export interface IFlowGraphPlayAnimationBlockConfiguration extends IFlowGraphBlockConfiguration {
+    /**
+     * Whether animation-group playback uses the unbounded KHR_interactivity timeline.
+     */
+    useVirtualTimeline?: boolean;
+}
 /**
  * @experimental
  * A block that plays an animation on an animatable object.
@@ -13,7 +24,7 @@ export declare class FlowGraphPlayAnimationBlock extends FlowGraphAsyncExecution
     /**
      * the configuration of the block
      */
-    config?: IFlowGraphBlockConfiguration | undefined;
+    config?: IFlowGraphPlayAnimationBlockConfiguration | undefined;
     /**
      * Input connection: The speed of the animation.
      */
@@ -51,6 +62,11 @@ export declare class FlowGraphPlayAnimationBlock extends FlowGraphAsyncExecution
      * Input: If provided this animation will be used. Priority will be given to the animation group input.
      */
     readonly animation: FlowGraphDataConnection<Animation | Animation[]>;
+    /**
+     * Input connection: Optional targets matching the animation array in order.
+     * When supplied, these replace the single object target. Ignored when animationGroup is supplied.
+     */
+    readonly animationTargets: FlowGraphDataConnection<IAnimatable[] | undefined>;
     /**
      * Input connection: The target object that will be animated. If animation group is provided this input will be ignored.
      */
@@ -59,7 +75,7 @@ export declare class FlowGraphPlayAnimationBlock extends FlowGraphAsyncExecution
     /**
      * the configuration of the block
      */
-    config?: IFlowGraphBlockConfiguration | undefined);
+    config?: IFlowGraphPlayAnimationBlockConfiguration | undefined);
     /**
      * @internal
      * @param context
@@ -93,6 +109,8 @@ export declare class FlowGraphPlayAnimationBlock extends FlowGraphAsyncExecution
      */
     private _checkInterpolationDuplications;
     private _stopAnimationGroup;
+    /** @internal */
+    _cleanupAfterExternalStop(context: FlowGraphContext, animationGroup: AnimationGroup): void;
     private _removeFromCurrentlyRunning;
     /**
      * @internal