@onerjs/core 9.0.1 → 9.0.3

package/FlowGraph/flowGraphCoordinator.js.map

@@ -1 +1 @@
-{"version":3,"file":"flowGraphCoordinator.js","sourceRoot":"","sources":["../../../../dev/core/src/FlowGraph/flowGraphCoordinator.ts"],"names":[],"mappings":"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","sourcesContent":["import { type EventState, type IReadonlyObservable, type Observer, Observable } from \"core/Misc/observable\";\r\nimport { type Scene } from \"../scene\";\r\nimport { FlowGraph } from \"./flowGraph\";\r\nimport { type IPathToObjectConverter } from \"../ObjectModel/objectModelInterfaces\";\r\nimport { type IObjectAccessor } from \"./typeDefinitions\";\r\nimport { type IAssetContainer } from \"core/IAssetContainer\";\r\nimport { Logger } from \"core/Misc/logger\";\r\nimport { type IFlowGraphHostResolver, GetDefaultEventReferenceKey, GetDefaultEventReference } from \"./flowGraphHostResolver\";\r\n\r\n/**\r\n * Parameters used to create a flow graph engine.\r\n */\r\nexport interface IFlowGraphCoordinatorConfiguration {\r\n    /**\r\n     * The scene that the flow graph engine belongs to.\r\n     */\r\n    scene: Scene;\r\n    /**\r\n     * Optional resolver letting the environment hosting the graphs decide how runtime entities are\r\n     * represented as opaque reference values. When omitted, a neutral built-in representation is used.\r\n     */\r\n    hostResolver?: IFlowGraphHostResolver;\r\n}\r\n\r\n/**\r\n * Parameters used to parse a flow graph coordinator.\r\n */\r\nexport interface IFlowGraphCoordinatorParseOptions {\r\n    /**\r\n     * A function that will be called to parse the value of a property.\r\n     * @param key the key of the property\r\n     * @param serializationObject the serialization object where the property is located\r\n     * @param assetsContainer the assets container\r\n     * @param scene the scene that the block is being parsed in\r\n     */\r\n    valueParseFunction?: (key: string, serializationObject: any, assetsContainer: IAssetContainer, scene: Scene) => any;\r\n    /**\r\n     * The path converter to use to convert the path to an object accessor.\r\n     */\r\n    pathConverter?: IPathToObjectConverter<IObjectAccessor>;\r\n    /**\r\n     * The scene that the flow graph coordinator belongs to.\r\n     */\r\n    scene: Scene;\r\n}\r\n/**\r\n * This class holds all of the existing flow graphs and is responsible for creating new ones.\r\n * It also handles starting/stopping multiple graphs and communication between them through an Event Coordinator\r\n * This is the entry point for the flow graph system.\r\n * @experimental This class is still in development and is subject to change.\r\n */\r\nexport class FlowGraphCoordinator {\r\n    /**\r\n     * The maximum number of events per type.\r\n     * This is used to limit the number of events that can be created in a single scene.\r\n     * This is to prevent infinite loops.\r\n     */\r\n    public static MaxEventsPerType: number = 30;\r\n\r\n    /**\r\n     * The maximum number of execution of a specific event in a single frame.\r\n     */\r\n    public static MaxEventTypeExecutionPerFrame: number = 30;\r\n    /**\r\n     * @internal\r\n     * A list of all the coordinators per scene. Will be used by the inspector\r\n     */\r\n    public static readonly SceneCoordinators: Map<Scene, FlowGraphCoordinator[]> = new Map();\r\n\r\n    /**\r\n     * Observable raised when a flow graph is added to any coordinator. Used by the inspector to keep\r\n     * the flow graph list in sync. The payload is the newly added flow graph.\r\n     */\r\n    public static get OnFlowGraphAddedObservable(): IReadonlyObservable<FlowGraph> {\r\n        return this._OnFlowGraphAddedObservable;\r\n    }\r\n    private static readonly _OnFlowGraphAddedObservable = new Observable<FlowGraph>();\r\n\r\n    /**\r\n     * Observable raised when a flow graph is removed from any coordinator. Used by the inspector to keep\r\n     * the flow graph list in sync. The payload is the removed flow graph.\r\n     */\r\n    public static get OnFlowGraphRemovedObservable(): IReadonlyObservable<FlowGraph> {\r\n        return this._OnFlowGraphRemovedObservable;\r\n    }\r\n    private static readonly _OnFlowGraphRemovedObservable = new Observable<FlowGraph>();\r\n\r\n    /**\r\n     * When set to true (default) custom events will be dispatched synchronously.\r\n     * This means that the events will be dispatched immediately when they are triggered.\r\n     */\r\n    public dispatchEventsSynchronously: boolean = true;\r\n\r\n    private readonly _flowGraphs: FlowGraph[] = [];\r\n\r\n    private _customEventsMap: Map<string, Observable<any>> = new Map();\r\n\r\n    private _eventExecutionCounter: Map<string, number> = new Map();\r\n\r\n    private _disposeObserver!: Observer<Scene>;\r\n    private _onBeforeRenderObserver!: Observer<Scene>;\r\n    private _executeOnNextFrame: { id: string; data?: any; uniqueId: number }[] = [];\r\n    private _eventUniqueId: number = 0;\r\n\r\n    /**\r\n     * Stack of custom-event dispatches currently in progress. Each entry pairs the\r\n     * dispatched event id with the Observable's EventState so that\r\n     * `event/stopPropagation` can stop the remaining handlers of an in-flight\r\n     * dispatch. A stack (rather than a single value) tolerates re-entrant\r\n     * dispatching, e.g. an event handler synchronously sending another event.\r\n     * @internal\r\n     */\r\n    public _eventDispatchStack: { eventId: string; state: EventState; propagationStopped: boolean }[] = [];\r\n\r\n    public constructor(\r\n        /**\r\n         * the configuration of the block\r\n         */\r\n        public config: IFlowGraphCoordinatorConfiguration\r\n    ) {\r\n        this._attachToScene(this.config.scene);\r\n    }\r\n\r\n    private _attachToScene(scene: Scene): void {\r\n        // When the scene is disposed, dispose all graphs currently running on it.\r\n        this._disposeObserver = scene.onDisposeObservable.add(() => {\r\n            this.dispose();\r\n        });\r\n\r\n        this._onBeforeRenderObserver = scene.onBeforeRenderObservable.add(() => {\r\n            // Reset the event execution counter at the beginning of each frame.\r\n            this._eventExecutionCounter.clear();\r\n            // duplicate the _executeOnNextFrame array to avoid modifying it while iterating over it\r\n            const executeOnNextFrame = this._executeOnNextFrame.slice(0);\r\n            if (executeOnNextFrame.length) {\r\n                // Execute the events that were triggered on the next frame.\r\n                for (const event of executeOnNextFrame) {\r\n                    this.notifyCustomEvent(event.id, event.data, false);\r\n                    // remove the event from the array\r\n                    const index = this._executeOnNextFrame.findIndex((e) => e.uniqueId === event.uniqueId);\r\n                    if (index !== -1) {\r\n                        this._executeOnNextFrame.splice(index, 1);\r\n                    }\r\n                }\r\n            }\r\n        });\r\n\r\n        // Add itself to the SceneCoordinators list for the Inspector.\r\n        let coordinators = FlowGraphCoordinator.SceneCoordinators.get(scene);\r\n        if (!coordinators) {\r\n            coordinators = [];\r\n            FlowGraphCoordinator.SceneCoordinators.set(scene, coordinators);\r\n        }\r\n        coordinators.push(this);\r\n    }\r\n\r\n    private _detachFromScene(scene: Scene): void {\r\n        this._disposeObserver.remove();\r\n        this._onBeforeRenderObserver.remove();\r\n        const coordinators = FlowGraphCoordinator.SceneCoordinators.get(scene);\r\n        if (!coordinators) {\r\n            return;\r\n        }\r\n        const index = coordinators.indexOf(this);\r\n        if (index !== -1) {\r\n            coordinators.splice(index, 1);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Reattaches this coordinator's lifecycle observers to another scene.\r\n     * @param scene new scene owned by the coordinator\r\n     * @param updateGraphs whether existing graphs should also be reattached\r\n     * @internal\r\n     */\r\n    public _setScene(scene: Scene, updateGraphs = true): void {\r\n        const previousScene = this.config.scene;\r\n        if (scene === previousScene) {\r\n            return;\r\n        }\r\n        this._detachFromScene(previousScene);\r\n        this.config.scene = scene;\r\n        if (updateGraphs) {\r\n            for (const graph of this._flowGraphs) {\r\n                graph.setScene(scene);\r\n            }\r\n        }\r\n        this._attachToScene(scene);\r\n    }\r\n\r\n    /**\r\n     * Creates a new flow graph and adds it to the list of existing flow graphs\r\n     * @param name - optional name for the new graph. If not provided, an auto-generated name is used.\r\n     * @returns a new flow graph\r\n     */\r\n    public createGraph(name?: string): FlowGraph {\r\n        const graphName = name ?? `Graph ${this._flowGraphs.length + 1}`;\r\n        const graph = new FlowGraph({ scene: this.config.scene, coordinator: this, name: graphName });\r\n        this._flowGraphs.push(graph);\r\n        FlowGraphCoordinator._OnFlowGraphAddedObservable.notifyObservers(graph);\r\n        return graph;\r\n    }\r\n\r\n    /**\r\n     * Removes a flow graph from the list of existing flow graphs and disposes it\r\n     * @param graph the graph to remove\r\n     */\r\n    public removeGraph(graph: FlowGraph) {\r\n        const index = this._flowGraphs.indexOf(graph);\r\n        if (index !== -1) {\r\n            graph.dispose();\r\n            this._flowGraphs.splice(index, 1);\r\n            FlowGraphCoordinator._OnFlowGraphRemovedObservable.notifyObservers(graph);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Starts all graphs\r\n     */\r\n    public start() {\r\n        for (const graph of this._flowGraphs) {\r\n            graph.start();\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Disposes all graphs\r\n     */\r\n    public dispose() {\r\n        for (const graph of this._flowGraphs) {\r\n            graph.dispose();\r\n            FlowGraphCoordinator._OnFlowGraphRemovedObservable.notifyObservers(graph);\r\n        }\r\n        this._flowGraphs.length = 0;\r\n        this._detachFromScene(this.config.scene);\r\n    }\r\n\r\n    /**\r\n     * Serializes this coordinator to a JSON object.\r\n     * @param serializationObject the object to serialize to\r\n     * @param valueSerializeFunction the function to use to serialize the value\r\n     */\r\n    public serialize(serializationObject: any, valueSerializeFunction?: (key: string, value: any, serializationObject: any) => void) {\r\n        serializationObject._flowGraphs = [];\r\n        for (const graph of this._flowGraphs) {\r\n            const serializedGraph = {};\r\n            graph.serialize(serializedGraph, valueSerializeFunction);\r\n            serializationObject._flowGraphs.push(serializedGraph);\r\n        }\r\n        serializationObject.dispatchEventsSynchronously = this.dispatchEventsSynchronously;\r\n    }\r\n\r\n    /**\r\n     * Gets the list of flow graphs\r\n     */\r\n    public get flowGraphs() {\r\n        return this._flowGraphs;\r\n    }\r\n\r\n    /**\r\n     * Get an observable that will be notified when the event with the given id is fired.\r\n     * @param id the id of the event\r\n     * @returns the observable for the event\r\n     */\r\n    public getCustomEventObservable(id: string): Observable<any> {\r\n        let observable = this._customEventsMap.get(id);\r\n        if (!observable) {\r\n            // receive event is initialized before scene start, so no need to notify if triggered. but possible!\r\n            observable = new Observable<any>(/*undefined, true*/);\r\n            this._customEventsMap.set(id, observable);\r\n        }\r\n        return observable;\r\n    }\r\n\r\n    /**\r\n     * Notifies the observable for the given event id with the given data.\r\n     * @param id the id of the event\r\n     * @param data the data to send with the event\r\n     * @param async if true, the event will be dispatched asynchronously\r\n     */\r\n    public notifyCustomEvent(id: string, data: any, async: boolean = !this.dispatchEventsSynchronously) {\r\n        if (async) {\r\n            this._executeOnNextFrame.push({ id, data, uniqueId: this._eventUniqueId++ });\r\n            return;\r\n        }\r\n        // check if we are not exceeding the max number of events\r\n        if (this._eventExecutionCounter.has(id)) {\r\n            const count = this._eventExecutionCounter.get(id)!;\r\n            this._eventExecutionCounter.set(id, count + 1);\r\n            if (count >= FlowGraphCoordinator.MaxEventTypeExecutionPerFrame) {\r\n                if (count === FlowGraphCoordinator.MaxEventTypeExecutionPerFrame) {\r\n                    Logger.Warn(`FlowGraphCoordinator: Too many executions of event \"${id}\".`);\r\n                }\r\n                return;\r\n            }\r\n        } else {\r\n            this._eventExecutionCounter.set(id, 1);\r\n        }\r\n        const observable = this._customEventsMap.get(id);\r\n        if (observable) {\r\n            observable.notifyObservers(data);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * @internal\r\n     * Marks the beginning of a custom-event dispatch. Called by event receiver\r\n     * blocks from within their Observable callback so that the dispatch's\r\n     * EventState becomes reachable by `event/stopPropagation` while the receiver\r\n     * flow executes synchronously.\r\n     * @param eventId the id of the event being dispatched\r\n     * @param state the Observable EventState for this dispatch\r\n     */\r\n    public _beginEventDispatch(eventId: string, state: EventState): void {\r\n        this._eventDispatchStack.push({ eventId, state, propagationStopped: false });\r\n    }\r\n\r\n    /**\r\n     * @internal\r\n     * Marks the end of the most recent custom-event dispatch started with\r\n     * {@link _beginEventDispatch}.\r\n     */\r\n    public _endEventDispatch(): { eventId: string; state: EventState; propagationStopped: boolean } | undefined {\r\n        return this._eventDispatchStack.pop();\r\n    }\r\n\r\n    /**\r\n     * Stops the propagation of an in-flight custom event, preventing any event\r\n     * handler nodes that have not been activated yet from running for the current\r\n     * dispatch.\r\n     *\r\n     * The `event` argument is the opaque event reference produced by an event block on its `event`\r\n     * output. If it does not reference an event that is currently being dispatched, this is a no-op.\r\n     *\r\n     * Babylon custom events have no scene-graph propagation layer, so there are\r\n     * no transitive activations to cancel when `stopImmediate` is false. When it\r\n     * is true, the remaining handlers in the Observable dispatch are skipped.\r\n     * @param event the event reference to stop propagation for\r\n     * @param stopImmediate whether to also stop remaining immediate handlers\r\n     */\r\n    public stopEventPropagation(event: string, stopImmediate: boolean): void {\r\n        if (typeof event !== \"string\") {\r\n            return;\r\n        }\r\n        const decode = this.config.hostResolver?.decodeEventReference ?? GetDefaultEventReferenceKey;\r\n        const eventId = decode(event);\r\n        if (eventId === undefined) {\r\n            return;\r\n        }\r\n        // Find the most recent matching in-flight dispatch and skip its remaining observers.\r\n        for (let i = this._eventDispatchStack.length - 1; i >= 0; i--) {\r\n            if (this._eventDispatchStack[i].eventId === eventId) {\r\n                this._eventDispatchStack[i].propagationStopped = true;\r\n                if (stopImmediate) {\r\n                    this._eventDispatchStack[i].state.skipNextObservers = true;\r\n                }\r\n                return;\r\n            }\r\n        }\r\n    }\r\n\r\n    /**\r\n     * @internal\r\n     * Encodes an event source key as the opaque reference exposed on an event block's `event`\r\n     * output, delegating to the host resolver when one is configured.\r\n     * @param key the event source key\r\n     * @returns the event reference\r\n     */\r\n    public _getEventReference(key: string): string {\r\n        const encode = this.config.hostResolver?.encodeEventReference;\r\n        return encode ? encode(key) : GetDefaultEventReference(key);\r\n    }\r\n}\r\n"]}
+{"version":3,"file":"flowGraphCoordinator.js","sourceRoot":"","sources":["../../../../dev/core/src/FlowGraph/flowGraphCoordinator.ts"],"names":[],"mappings":"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","sourcesContent":["import { type EventState, type IReadonlyObservable, type Observer, Observable } from \"core/Misc/observable\";\r\nimport { type Scene } from \"../scene\";\r\nimport { FlowGraph } from \"./flowGraph\";\r\nimport { type IPathToObjectConverter } from \"../ObjectModel/objectModelInterfaces\";\r\nimport { type IObjectAccessor } from \"./typeDefinitions\";\r\nimport { type IAssetContainer } from \"core/IAssetContainer\";\r\nimport { Logger } from \"core/Misc/logger\";\r\nimport { type Nullable } from \"core/types\";\r\nimport { type AudioEngineV2 } from \"../AudioV2/abstractAudio/audioEngineV2\";\r\nimport { type StaticSound } from \"../AudioV2/abstractAudio/staticSound\";\r\nimport { type IFlowGraphHostResolver, GetDefaultEventReferenceKey, GetDefaultEventReference } from \"./flowGraphHostResolver\";\r\nimport { type IFlowGraphSoundAsset } from \"./flowGraphSoundAssets\";\r\n\r\ninterface ISoundAssetEntry {\r\n    asset: IFlowGraphSoundAsset;\r\n    sound: Nullable<StaticSound>;\r\n}\r\n\r\n/**\r\n * Audio engine created by coordinators when no audio engine exists. It is shared by all coordinators\r\n * that need a fallback engine and disposed when the last of them is disposed.\r\n */\r\nlet FallbackAudioEnginePromise: Nullable<Promise<AudioEngineV2>> = null;\r\nlet FallbackAudioEngine: Nullable<AudioEngineV2> = null;\r\nlet FallbackAudioEngineUsers = 0;\r\n\r\nfunction DisposeUnusedFallbackAudioEngine(): void {\r\n    if (FallbackAudioEngineUsers > 0 || !FallbackAudioEngine) {\r\n        return;\r\n    }\r\n    const engine = FallbackAudioEngine;\r\n    FallbackAudioEngine = null;\r\n    FallbackAudioEnginePromise = null;\r\n    engine.dispose();\r\n}\r\n\r\nasync function GetFallbackAudioEngineAsync(): Promise<AudioEngineV2> {\r\n    if (!FallbackAudioEnginePromise) {\r\n        FallbackAudioEnginePromise = (async () => {\r\n            try {\r\n                const { CreateAudioEngineAsync } = await import(\"../AudioV2/webAudio/webAudioEngine\");\r\n                const engine = await CreateAudioEngineAsync();\r\n                FallbackAudioEngine = engine;\r\n                // All users may have been disposed while the engine was being created.\r\n                DisposeUnusedFallbackAudioEngine();\r\n                return engine;\r\n            } catch (e) {\r\n                FallbackAudioEnginePromise = null;\r\n                throw e;\r\n            }\r\n        })();\r\n    }\r\n    return await FallbackAudioEnginePromise;\r\n}\r\n\r\n/**\r\n * Parameters used to create a flow graph engine.\r\n */\r\nexport interface IFlowGraphCoordinatorConfiguration {\r\n    /**\r\n     * The scene that the flow graph engine belongs to.\r\n     */\r\n    scene: Scene;\r\n    /**\r\n     * Optional resolver letting the environment hosting the graphs decide how runtime entities are\r\n     * represented as opaque reference values. When omitted, a neutral built-in representation is used.\r\n     */\r\n    hostResolver?: IFlowGraphHostResolver;\r\n}\r\n\r\n/**\r\n * Parameters used to parse a flow graph coordinator.\r\n */\r\nexport interface IFlowGraphCoordinatorParseOptions {\r\n    /**\r\n     * A function that will be called to parse the value of a property.\r\n     * @param key the key of the property\r\n     * @param serializationObject the serialization object where the property is located\r\n     * @param assetsContainer the assets container\r\n     * @param scene the scene that the block is being parsed in\r\n     */\r\n    valueParseFunction?: (key: string, serializationObject: any, assetsContainer: IAssetContainer, scene: Scene) => any;\r\n    /**\r\n     * The path converter to use to convert the path to an object accessor.\r\n     */\r\n    pathConverter?: IPathToObjectConverter<IObjectAccessor>;\r\n    /**\r\n     * The scene that the flow graph coordinator belongs to.\r\n     */\r\n    scene: Scene;\r\n    /**\r\n     * The audio engine used to load the serialized sound assets.\r\n     * When omitted, the most recently created audio engine is used, and a new one is created if none exists.\r\n     */\r\n    audioEngine?: AudioEngineV2;\r\n}\r\n/**\r\n * This class holds all of the existing flow graphs and is responsible for creating new ones.\r\n * It also handles starting/stopping multiple graphs and communication between them through an Event Coordinator\r\n * This is the entry point for the flow graph system.\r\n * @experimental This class is still in development and is subject to change.\r\n */\r\nexport class FlowGraphCoordinator {\r\n    /**\r\n     * The maximum number of events per type.\r\n     * This is used to limit the number of events that can be created in a single scene.\r\n     * This is to prevent infinite loops.\r\n     */\r\n    public static MaxEventsPerType: number = 30;\r\n\r\n    /**\r\n     * The maximum number of execution of a specific event in a single frame.\r\n     */\r\n    public static MaxEventTypeExecutionPerFrame: number = 30;\r\n    /**\r\n     * @internal\r\n     * A list of all the coordinators per scene. Will be used by the inspector\r\n     */\r\n    public static readonly SceneCoordinators: Map<Scene, FlowGraphCoordinator[]> = new Map();\r\n\r\n    /**\r\n     * Observable raised when a flow graph is added to any coordinator. Used by the inspector to keep\r\n     * the flow graph list in sync. The payload is the newly added flow graph.\r\n     */\r\n    public static get OnFlowGraphAddedObservable(): IReadonlyObservable<FlowGraph> {\r\n        return this._OnFlowGraphAddedObservable;\r\n    }\r\n    private static readonly _OnFlowGraphAddedObservable = new Observable<FlowGraph>();\r\n\r\n    /**\r\n     * Observable raised when a flow graph is removed from any coordinator. Used by the inspector to keep\r\n     * the flow graph list in sync. The payload is the removed flow graph.\r\n     */\r\n    public static get OnFlowGraphRemovedObservable(): IReadonlyObservable<FlowGraph> {\r\n        return this._OnFlowGraphRemovedObservable;\r\n    }\r\n    private static readonly _OnFlowGraphRemovedObservable = new Observable<FlowGraph>();\r\n\r\n    /**\r\n     * When set to true (default) custom events will be dispatched synchronously.\r\n     * This means that the events will be dispatched immediately when they are triggered.\r\n     */\r\n    public dispatchEventsSynchronously: boolean = true;\r\n\r\n    private readonly _flowGraphs: FlowGraph[] = [];\r\n\r\n    private _customEventsMap: Map<string, Observable<any>> = new Map();\r\n\r\n    private readonly _soundAssets = new Map<string, ISoundAssetEntry>();\r\n\r\n    private _usesFallbackAudioEngine = false;\r\n\r\n    /**\r\n     * Observable raised with the name of a sound asset when its loaded sound changes,\r\n     * i.e. when the asset finishes loading, is replaced or is removed.\r\n     */\r\n    public readonly onSoundAssetChangedObservable = new Observable<string>();\r\n\r\n    private _eventExecutionCounter: Map<string, number> = new Map();\r\n\r\n    private _disposeObserver!: Observer<Scene>;\r\n    private _onBeforeRenderObserver!: Observer<Scene>;\r\n    private _executeOnNextFrame: { id: string; data?: any; uniqueId: number }[] = [];\r\n    private _eventUniqueId: number = 0;\r\n\r\n    /**\r\n     * Stack of custom-event dispatches currently in progress. Each entry pairs the\r\n     * dispatched event id with the Observable's EventState so that\r\n     * `event/stopPropagation` can stop the remaining handlers of an in-flight\r\n     * dispatch. A stack (rather than a single value) tolerates re-entrant\r\n     * dispatching, e.g. an event handler synchronously sending another event.\r\n     * @internal\r\n     */\r\n    public _eventDispatchStack: { eventId: string; state: EventState; propagationStopped: boolean }[] = [];\r\n\r\n    public constructor(\r\n        /**\r\n         * the configuration of the block\r\n         */\r\n        public config: IFlowGraphCoordinatorConfiguration\r\n    ) {\r\n        this._attachToScene(this.config.scene);\r\n    }\r\n\r\n    private _attachToScene(scene: Scene): void {\r\n        // When the scene is disposed, dispose all graphs currently running on it.\r\n        this._disposeObserver = scene.onDisposeObservable.add(() => {\r\n            this.dispose();\r\n        });\r\n\r\n        this._onBeforeRenderObserver = scene.onBeforeRenderObservable.add(() => {\r\n            // Reset the event execution counter at the beginning of each frame.\r\n            this._eventExecutionCounter.clear();\r\n            // duplicate the _executeOnNextFrame array to avoid modifying it while iterating over it\r\n            const executeOnNextFrame = this._executeOnNextFrame.slice(0);\r\n            if (executeOnNextFrame.length) {\r\n                // Execute the events that were triggered on the next frame.\r\n                for (const event of executeOnNextFrame) {\r\n                    this.notifyCustomEvent(event.id, event.data, false);\r\n                    // remove the event from the array\r\n                    const index = this._executeOnNextFrame.findIndex((e) => e.uniqueId === event.uniqueId);\r\n                    if (index !== -1) {\r\n                        this._executeOnNextFrame.splice(index, 1);\r\n                    }\r\n                }\r\n            }\r\n        });\r\n\r\n        // Add itself to the SceneCoordinators list for the Inspector.\r\n        let coordinators = FlowGraphCoordinator.SceneCoordinators.get(scene);\r\n        if (!coordinators) {\r\n            coordinators = [];\r\n            FlowGraphCoordinator.SceneCoordinators.set(scene, coordinators);\r\n        }\r\n        coordinators.push(this);\r\n    }\r\n\r\n    private _detachFromScene(scene: Scene): void {\r\n        this._disposeObserver.remove();\r\n        this._onBeforeRenderObserver.remove();\r\n        const coordinators = FlowGraphCoordinator.SceneCoordinators.get(scene);\r\n        if (!coordinators) {\r\n            return;\r\n        }\r\n        const index = coordinators.indexOf(this);\r\n        if (index !== -1) {\r\n            coordinators.splice(index, 1);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Reattaches this coordinator's lifecycle observers to another scene.\r\n     * @param scene new scene owned by the coordinator\r\n     * @param updateGraphs whether existing graphs should also be reattached\r\n     * @internal\r\n     */\r\n    public _setScene(scene: Scene, updateGraphs = true): void {\r\n        const previousScene = this.config.scene;\r\n        if (scene === previousScene) {\r\n            return;\r\n        }\r\n        this._detachFromScene(previousScene);\r\n        this.config.scene = scene;\r\n        if (updateGraphs) {\r\n            for (const graph of this._flowGraphs) {\r\n                graph.setScene(scene);\r\n            }\r\n        }\r\n        this._attachToScene(scene);\r\n    }\r\n\r\n    /**\r\n     * Creates a new flow graph and adds it to the list of existing flow graphs\r\n     * @param name - optional name for the new graph. If not provided, an auto-generated name is used.\r\n     * @returns a new flow graph\r\n     */\r\n    public createGraph(name?: string): FlowGraph {\r\n        const graphName = name ?? `Graph ${this._flowGraphs.length + 1}`;\r\n        const graph = new FlowGraph({ scene: this.config.scene, coordinator: this, name: graphName });\r\n        this._flowGraphs.push(graph);\r\n        FlowGraphCoordinator._OnFlowGraphAddedObservable.notifyObservers(graph);\r\n        return graph;\r\n    }\r\n\r\n    /**\r\n     * Removes a flow graph from the list of existing flow graphs and disposes it\r\n     * @param graph the graph to remove\r\n     */\r\n    public removeGraph(graph: FlowGraph) {\r\n        const index = this._flowGraphs.indexOf(graph);\r\n        if (index !== -1) {\r\n            graph.dispose();\r\n            this._flowGraphs.splice(index, 1);\r\n            FlowGraphCoordinator._OnFlowGraphRemovedObservable.notifyObservers(graph);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Starts all graphs\r\n     */\r\n    public start() {\r\n        for (const graph of this._flowGraphs) {\r\n            graph.start();\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Disposes all graphs\r\n     */\r\n    public dispose() {\r\n        for (const graph of this._flowGraphs) {\r\n            graph.dispose();\r\n            FlowGraphCoordinator._OnFlowGraphRemovedObservable.notifyObservers(graph);\r\n        }\r\n        this._flowGraphs.length = 0;\r\n        for (const entry of this._soundAssets.values()) {\r\n            entry.sound?.dispose();\r\n        }\r\n        this._soundAssets.clear();\r\n        this.onSoundAssetChangedObservable.clear();\r\n        if (this._usesFallbackAudioEngine) {\r\n            this._usesFallbackAudioEngine = false;\r\n            FallbackAudioEngineUsers--;\r\n            DisposeUnusedFallbackAudioEngine();\r\n        }\r\n        this._detachFromScene(this.config.scene);\r\n    }\r\n\r\n    /**\r\n     * Gets the sound assets declared on this coordinator.\r\n     * Declared sound assets are serialized with the coordinator.\r\n     */\r\n    public get soundAssets(): IFlowGraphSoundAsset[] {\r\n        return Array.from(this._soundAssets.values(), (entry) => ({ ...entry.asset }));\r\n    }\r\n\r\n    /**\r\n     * Gets the loaded sound of a declared sound asset.\r\n     * @param name the name of the sound asset\r\n     * @returns the loaded sound, or null if the asset is not declared or not loaded yet\r\n     */\r\n    public getSoundAsset(name: string): Nullable<StaticSound> {\r\n        return this._soundAssets.get(name)?.sound ?? null;\r\n    }\r\n\r\n    /**\r\n     * Declares a sound asset on this coordinator and loads its sound.\r\n     * An existing asset with the same name is replaced and its sound is disposed, so audio blocks that\r\n     * reference the asset by name will play the new sound.\r\n     * If loading fails, the asset stays declared (and serialized) without a sound, and the error is rethrown.\r\n     * @param asset the sound asset to declare\r\n     * @param audioEngine the audio engine used to load the sound. When omitted, the most recently created audio engine is used.\r\n     * If no audio engine exists, a fallback engine is created; it is shared between coordinators and disposed with the last coordinator using it.\r\n     * @returns a promise that resolves with the loaded sound\r\n     */\r\n    public async addSoundAssetAsync(asset: IFlowGraphSoundAsset, audioEngine?: AudioEngineV2): Promise<StaticSound> {\r\n        // Copy the descriptor so that changes made by the caller while the sound loads do not affect this load.\r\n        const entry: ISoundAssetEntry = { asset: { name: asset.name, url: asset.url }, sound: null };\r\n        const { name, url } = entry.asset;\r\n        this.removeSoundAsset(name);\r\n        this._soundAssets.set(name, entry);\r\n\r\n        const { CreateSoundAsync, LastCreatedAudioEngine } = await import(\"../AudioV2/abstractAudio/audioEngineV2\");\r\n        this._throwIfSoundAssetChanged(entry);\r\n        let engine: AudioEngineV2;\r\n        if (audioEngine && audioEngine !== FallbackAudioEngine) {\r\n            engine = audioEngine;\r\n        } else {\r\n            // A fallback engine is already listed by LastCreatedAudioEngine while it initializes, so join a pending\r\n            // fallback before treating the last created engine as owned by someone else. Once the fallback is ready,\r\n            // an engine created later by the application takes precedence.\r\n            const isFallbackPending = !!FallbackAudioEnginePromise && !FallbackAudioEngine;\r\n            const lastEngine = audioEngine ?? (isFallbackPending ? null : LastCreatedAudioEngine());\r\n            if (lastEngine && lastEngine !== FallbackAudioEngine) {\r\n                engine = lastEngine;\r\n            } else {\r\n                if (!this._usesFallbackAudioEngine) {\r\n                    this._usesFallbackAudioEngine = true;\r\n                    FallbackAudioEngineUsers++;\r\n                }\r\n                engine = await GetFallbackAudioEngineAsync();\r\n                this._throwIfSoundAssetChanged(entry);\r\n            }\r\n        }\r\n\r\n        const sound = await CreateSoundAsync(name, url, {}, engine);\r\n        if (this._soundAssets.get(name) !== entry) {\r\n            sound.dispose();\r\n            this._throwIfSoundAssetChanged(entry);\r\n        }\r\n        entry.sound = sound;\r\n        this.onSoundAssetChangedObservable.notifyObservers(name);\r\n        return sound;\r\n    }\r\n\r\n    private _throwIfSoundAssetChanged(entry: ISoundAssetEntry): void {\r\n        if (this._soundAssets.get(entry.asset.name) !== entry) {\r\n            throw new Error(`Sound asset \"${entry.asset.name}\" was removed or replaced before it finished loading.`);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Removes a declared sound asset and disposes its sound.\r\n     * @param name the name of the sound asset to remove\r\n     */\r\n    public removeSoundAsset(name: string): void {\r\n        const entry = this._soundAssets.get(name);\r\n        if (!entry) {\r\n            return;\r\n        }\r\n        entry.sound?.dispose();\r\n        this._soundAssets.delete(name);\r\n        this.onSoundAssetChangedObservable.notifyObservers(name);\r\n    }\r\n\r\n    /**\r\n     * Serializes this coordinator to a JSON object.\r\n     * @param serializationObject the object to serialize to\r\n     * @param valueSerializeFunction the function to use to serialize the value\r\n     */\r\n    public serialize(serializationObject: any, valueSerializeFunction?: (key: string, value: any, serializationObject: any) => void) {\r\n        serializationObject._flowGraphs = [];\r\n        for (const graph of this._flowGraphs) {\r\n            const serializedGraph: any = {};\r\n            graph.serialize(serializedGraph, valueSerializeFunction);\r\n            serializationObject._flowGraphs.push(serializedGraph);\r\n        }\r\n        serializationObject.dispatchEventsSynchronously = this.dispatchEventsSynchronously;\r\n        if (this._soundAssets.size > 0) {\r\n            serializationObject.soundAssets = this.soundAssets;\r\n        } else {\r\n            delete serializationObject.soundAssets;\r\n        }\r\n        delete serializationObject.referenceProvenance;\r\n    }\r\n\r\n    /**\r\n     * Gets the list of flow graphs\r\n     */\r\n    public get flowGraphs() {\r\n        return this._flowGraphs;\r\n    }\r\n\r\n    /**\r\n     * Get an observable that will be notified when the event with the given id is fired.\r\n     * @param id the id of the event\r\n     * @returns the observable for the event\r\n     */\r\n    public getCustomEventObservable(id: string): Observable<any> {\r\n        let observable = this._customEventsMap.get(id);\r\n        if (!observable) {\r\n            // receive event is initialized before scene start, so no need to notify if triggered. but possible!\r\n            observable = new Observable<any>(/*undefined, true*/);\r\n            this._customEventsMap.set(id, observable);\r\n        }\r\n        return observable;\r\n    }\r\n\r\n    /**\r\n     * Notifies the observable for the given event id with the given data.\r\n     * @param id the id of the event\r\n     * @param data the data to send with the event\r\n     * @param async if true, the event will be dispatched asynchronously\r\n     */\r\n    public notifyCustomEvent(id: string, data: any, async: boolean = !this.dispatchEventsSynchronously) {\r\n        if (async) {\r\n            this._executeOnNextFrame.push({ id, data, uniqueId: this._eventUniqueId++ });\r\n            return;\r\n        }\r\n        // check if we are not exceeding the max number of events\r\n        if (this._eventExecutionCounter.has(id)) {\r\n            const count = this._eventExecutionCounter.get(id)!;\r\n            this._eventExecutionCounter.set(id, count + 1);\r\n            if (count >= FlowGraphCoordinator.MaxEventTypeExecutionPerFrame) {\r\n                if (count === FlowGraphCoordinator.MaxEventTypeExecutionPerFrame) {\r\n                    Logger.Warn(`FlowGraphCoordinator: Too many executions of event \"${id}\".`);\r\n                }\r\n                return;\r\n            }\r\n        } else {\r\n            this._eventExecutionCounter.set(id, 1);\r\n        }\r\n        const observable = this._customEventsMap.get(id);\r\n        if (observable) {\r\n            observable.notifyObservers(data);\r\n        }\r\n    }\r\n\r\n    /**\r\n     * @internal\r\n     * Marks the beginning of a custom-event dispatch. Called by event receiver\r\n     * blocks from within their Observable callback so that the dispatch's\r\n     * EventState becomes reachable by `event/stopPropagation` while the receiver\r\n     * flow executes synchronously.\r\n     * @param eventId the id of the event being dispatched\r\n     * @param state the Observable EventState for this dispatch\r\n     */\r\n    public _beginEventDispatch(eventId: string, state: EventState): void {\r\n        this._eventDispatchStack.push({ eventId, state, propagationStopped: false });\r\n    }\r\n\r\n    /**\r\n     * @internal\r\n     * Marks the end of the most recent custom-event dispatch started with\r\n     * {@link _beginEventDispatch}.\r\n     */\r\n    public _endEventDispatch(): { eventId: string; state: EventState; propagationStopped: boolean } | undefined {\r\n        return this._eventDispatchStack.pop();\r\n    }\r\n\r\n    /**\r\n     * Stops the propagation of an in-flight custom event, preventing any event\r\n     * handler nodes that have not been activated yet from running for the current\r\n     * dispatch.\r\n     *\r\n     * The `event` argument is the opaque event reference produced by an event block on its `event`\r\n     * output. If it does not reference an event that is currently being dispatched, this is a no-op.\r\n     *\r\n     * Babylon custom events have no scene-graph propagation layer, so there are\r\n     * no transitive activations to cancel when `stopImmediate` is false. When it\r\n     * is true, the remaining handlers in the Observable dispatch are skipped.\r\n     * @param event the event reference to stop propagation for\r\n     * @param stopImmediate whether to also stop remaining immediate handlers\r\n     */\r\n    public stopEventPropagation(event: string, stopImmediate: boolean): void {\r\n        if (typeof event !== \"string\") {\r\n            return;\r\n        }\r\n        const decode = this.config.hostResolver?.decodeEventReference ?? GetDefaultEventReferenceKey;\r\n        const eventId = decode(event);\r\n        if (eventId === undefined) {\r\n            return;\r\n        }\r\n        // Find the most recent matching in-flight dispatch and skip its remaining observers.\r\n        for (let i = this._eventDispatchStack.length - 1; i >= 0; i--) {\r\n            if (this._eventDispatchStack[i].eventId === eventId) {\r\n                this._eventDispatchStack[i].propagationStopped = true;\r\n                if (stopImmediate) {\r\n                    this._eventDispatchStack[i].state.skipNextObservers = true;\r\n                }\r\n                return;\r\n            }\r\n        }\r\n    }\r\n\r\n    /**\r\n     * @internal\r\n     * Encodes an event source key as the opaque reference exposed on an event block's `event`\r\n     * output, delegating to the host resolver when one is configured.\r\n     * @param key the event source key\r\n     * @returns the event reference\r\n     */\r\n    public _getEventReference(key: string): string {\r\n        const encode = this.config.hostResolver?.encodeEventReference;\r\n        return encode ? encode(key) : GetDefaultEventReference(key);\r\n    }\r\n}\r\n"]}

package/FlowGraph/flowGraphDataConnection.pure.js

@@ -1,8 +1,35 @@
 /** This file must only contain pure code and pure imports */
 import { FlowGraphConnection } from "./flowGraphConnection.js";
 import { Observable } from "../Misc/observable.pure.js";
-import { defaultValueSerializationFunction, GetSceneNodeFromSerializedReference } from "./serialization.js";
+import { defaultValueSerializationFunction, GetSceneNodeFromSerializedReference, _IsSerializedNodeReference } from "./serialization.js";
 import { RegisterClass } from "../Misc/typeStore.js";
+/**
+ * Resolves a node or a serialized node reference against a scene.
+ * @param value a scene node, or a serialized node reference left by the parser
+ * @param scene the scene to resolve the reference against
+ * @returns the matching node in the scene, or undefined when the value does not need to (or cannot) be rebound
+ */
+function _ReresolveNodeReference(value, scene) {
+    if (!value || typeof value !== "object") {
+        return undefined;
+    }
+    let reference;
+    if (typeof value.getClassName === "function" && typeof value.getScene === "function") {
+        // A scene node — only rebind when it belongs to a different scene.
+        if (value.getScene() === scene) {
+            return undefined;
+        }
+        reference = { id: value.id, name: value.name, className: value.getClassName(), uniqueId: value.uniqueId };
+    }
+    else if (_IsSerializedNodeReference(value)) {
+        // An unresolved serialized node reference left by the parser.
+        reference = value;
+    }
+    else {
+        return undefined;
+    }
+    return GetSceneNodeFromSerializedReference(reference, scene);
+}
 /**
  * Represents a connection point for data.
  * An unconnected input point can have a default value.
@@ -120,22 +147,22 @@ export class FlowGraphDataConnection extends FlowGraphConnection {
         if (!value || typeof value !== "object") {
             return;
         }
-        let reference;
-        if (typeof value.getClassName === "function" && typeof value.getScene === "function") {
-            // A scene node — only rebind when it belongs to a different scene.
-            if (value.getScene() === scene) {
-                return;
+        if (Array.isArray(value)) {
+            let changed = false;
+            const resolved = value.map((entry) => {
+                const node = _ReresolveNodeReference(entry, scene);
+                if (node) {
+                    changed = true;
+                    return node;
+                }
+                return entry;
+            });
+            if (changed) {
+                this._defaultValue = resolved;
             }
-            reference = { id: value.id, name: value.name, className: value.getClassName(), uniqueId: value.uniqueId };
-        }
-        else if (typeof value.className === "string" && (value.id || value.name) && value.value === undefined) {
-            // An unresolved serialized node reference left by the parser.
-            reference = value;
-        }
-        else {
             return;
         }
-        const node = GetSceneNodeFromSerializedReference(reference, scene);
+        const node = _ReresolveNodeReference(value, scene);
         if (node) {
             this._defaultValue = node;
         }

package/FlowGraph/flowGraphDataConnection.pure.js.map

@@ -1 +1 @@
-{"version":3,"file":"flowGraphDataConnection.pure.js","sourceRoot":"","sources":["../../../../dev/core/src/FlowGraph/flowGraphDataConnection.pure.ts"],"names":[],"mappings":"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","sourcesContent":["/** This file must only contain pure code and pure imports */\r\n\r\nimport { type Nullable } from \"core/types\";\r\nimport { type FlowGraphBlock } from \"./flowGraphBlock\";\r\nimport { FlowGraphConnection, FlowGraphConnectionType } from \"./flowGraphConnection\";\r\nimport { type FlowGraphContext } from \"./flowGraphContext\";\r\nimport { type RichType } from \"./flowGraphRichTypes.pure\";\r\nimport { Observable } from \"core/Misc/observable.pure\";\r\nimport { defaultValueSerializationFunction, GetSceneNodeFromSerializedReference } from \"./serialization\";\r\nimport { RegisterClass } from \"../Misc/typeStore\";\r\nimport { type Scene } from \"core/scene\";\r\n/**\r\n * Represents a connection point for data.\r\n * An unconnected input point can have a default value.\r\n * An output point will only have a value if it is connected to an input point. Furthermore,\r\n * if the point belongs to a \"function\" node, the node will run its function to update the value.\r\n */\r\nexport class FlowGraphDataConnection<T> extends FlowGraphConnection<FlowGraphBlock, FlowGraphDataConnection<T>> {\r\n    private _isDisabled: boolean = false;\r\n    /**\r\n     * This is used for debugging purposes! It is the last value that was set to this connection with ANY context.\r\n     * Do not use this value for anything else, as it might be wrong if used in a different context.\r\n     */\r\n    private _lastValue: Nullable<T> = null;\r\n\r\n    /**\r\n     * a data transformer function, if needed.\r\n     * This can be used, for example, to force seconds into milliseconds output, if it makes sense in your case.\r\n     */\r\n    public dataTransformer: Nullable<(value: T) => T> = null;\r\n\r\n    /**\r\n     * An observable that is triggered when the value of the connection changes.\r\n     */\r\n    public onValueChangedObservable = new Observable<T>();\r\n    /**\r\n     * Create a new data connection point.\r\n     * @param name the name of the connection\r\n     * @param connectionType the type of the connection\r\n     * @param ownerBlock the block that owns this connection\r\n     * @param richType the type of the data in this block\r\n     * @param _defaultValue the default value of the connection\r\n     * @param _optional if the connection is optional\r\n     */\r\n    public constructor(\r\n        name: string,\r\n        connectionType: FlowGraphConnectionType,\r\n        ownerBlock: FlowGraphBlock,\r\n        /**\r\n         * the type of the data in this block\r\n         */\r\n        public richType: RichType<T>,\r\n        /**\r\n         * [any] the default value of the connection\r\n         */\r\n        private _defaultValue: T = richType.defaultValue,\r\n        /**\r\n         * [false] if the connection is optional\r\n         */\r\n        private _optional: boolean = false\r\n    ) {\r\n        super(name, connectionType, ownerBlock);\r\n    }\r\n\r\n    /**\r\n     * Whether or not the connection is optional.\r\n     * Currently only used for UI control.\r\n     */\r\n    public get optional(): boolean {\r\n        return this._optional;\r\n    }\r\n\r\n    /**\r\n     * is this connection disabled\r\n     * If the connection is disabled you will not be able to connect anything to it.\r\n     */\r\n    public get isDisabled(): boolean {\r\n        return this._isDisabled;\r\n    }\r\n\r\n    public set isDisabled(value: boolean) {\r\n        if (this._isDisabled === value) {\r\n            return;\r\n        }\r\n        this._isDisabled = value;\r\n        if (this._isDisabled) {\r\n            this.disconnectFromAll();\r\n        }\r\n    }\r\n\r\n    /**\r\n     * An output data block can connect to multiple input data blocks,\r\n     * but an input data block can only connect to one output data block.\r\n     * @returns true if the connection is singular\r\n     */\r\n    public override _isSingularConnection(): boolean {\r\n        return this.connectionType === FlowGraphConnectionType.Input;\r\n    }\r\n\r\n    /**\r\n     * Set the value of the connection in a specific context.\r\n     * @param value the value to set\r\n     * @param context the context to which the value is set\r\n     */\r\n    public setValue(value: T, context: FlowGraphContext): void {\r\n        // check if the value is different\r\n        if (context._getConnectionValue(this) === value) {\r\n            return;\r\n        }\r\n        context._setConnectionValue(this, value);\r\n        this.onValueChangedObservable.notifyObservers(value);\r\n    }\r\n\r\n    /**\r\n     * Reset the value of the connection to the default value.\r\n     * @param context the context in which the value is reset\r\n     */\r\n    public resetToDefaultValue(context: FlowGraphContext): void {\r\n        context._setConnectionValue(this, this._defaultValue);\r\n    }\r\n\r\n    /**\r\n     * Re-resolves this input's default value against a (new) scene when the value is a node reference.\r\n     * This handles two cases that occur when a graph is moved to a different scene (see\r\n     * {@link FlowGraph.setScene}):\r\n     * - the value is still an unresolved serialized reference (`{ id, name, className, uniqueId }`)\r\n     *   because the node did not yet exist in the scene at parse time, or\r\n     * - the value is a node that belongs to a different (e.g. disposed) scene.\r\n     * Values that are not node references (numbers, vectors, matrices, etc.) are left untouched, and\r\n     * the default value is only replaced when a matching node is found in the new scene.\r\n     * @param scene the scene to resolve the reference against\r\n     * @internal\r\n     */\r\n    public _reresolveDefaultValueForScene(scene: Scene): void {\r\n        const value = this._defaultValue as any;\r\n        if (!value || typeof value !== \"object\") {\r\n            return;\r\n        }\r\n\r\n        let reference: { id?: string; name?: string; className?: string; uniqueId?: number } | undefined;\r\n        if (typeof value.getClassName === \"function\" && typeof value.getScene === \"function\") {\r\n            // A scene node — only rebind when it belongs to a different scene.\r\n            if (value.getScene() === scene) {\r\n                return;\r\n            }\r\n            reference = { id: value.id, name: value.name, className: value.getClassName(), uniqueId: value.uniqueId };\r\n        } else if (typeof value.className === \"string\" && (value.id || value.name) && value.value === undefined) {\r\n            // An unresolved serialized node reference left by the parser.\r\n            reference = value;\r\n        } else {\r\n            return;\r\n        }\r\n\r\n        const node = GetSceneNodeFromSerializedReference(reference, scene);\r\n        if (node) {\r\n            this._defaultValue = node as unknown as T;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Connect this point to another point.\r\n     * @param point the point to connect to.\r\n     */\r\n    public override connectTo(point: FlowGraphDataConnection<T>): void {\r\n        if (this._isDisabled) {\r\n            return;\r\n        }\r\n        super.connectTo(point);\r\n    }\r\n\r\n    private _getValueOrDefault(context: FlowGraphContext): T {\r\n        const val = context._getConnectionValue(this) ?? this._defaultValue;\r\n        return this.dataTransformer ? this.dataTransformer(val) : val;\r\n    }\r\n\r\n    /**\r\n     * Gets the value of the connection in a specific context.\r\n     * @param context the context from which the value is retrieved\r\n     * @returns the value of the connection\r\n     */\r\n    public getValue(context: FlowGraphContext): T {\r\n        if (this.connectionType === FlowGraphConnectionType.Output) {\r\n            context._notifyExecuteNode(this._ownerBlock);\r\n            this._ownerBlock._updateOutputs(context);\r\n            const value = this._getValueOrDefault(context);\r\n            this._lastValue = value;\r\n            return this.richType.typeTransformer ? this.richType.typeTransformer(value) : value;\r\n        }\r\n        const value = !this.isConnected() ? this._getValueOrDefault(context) : this._connectedPoint[0].getValue(context);\r\n        this._lastValue = value;\r\n        return this.richType.typeTransformer ? this.richType.typeTransformer(value) : value;\r\n    }\r\n\r\n    /**\r\n     * @internal\r\n     */\r\n    public _getLastValue(): Nullable<T> {\r\n        return this._lastValue;\r\n    }\r\n\r\n    /**\r\n     * @returns class name of the object.\r\n     */\r\n    public override getClassName(): string {\r\n        return \"FlowGraphDataConnection\";\r\n    }\r\n\r\n    /**\r\n     * Serializes this object.\r\n     * @param serializationObject the object to serialize to\r\n     */\r\n    public override serialize(serializationObject: any = {}) {\r\n        super.serialize(serializationObject);\r\n        serializationObject.richType = {};\r\n        this.richType.serialize(serializationObject.richType);\r\n        serializationObject.optional = this._optional;\r\n        defaultValueSerializationFunction(\"defaultValue\", this._defaultValue, serializationObject);\r\n    }\r\n}\r\n\r\nlet _Registered = false;\r\n/**\r\n * Register side effects for flowGraphDataConnection.\r\n * Safe to call multiple times; only the first call has an effect.\r\n */\r\nexport function RegisterFlowGraphDataConnection(): void {\r\n    if (_Registered) {\r\n        return;\r\n    }\r\n    _Registered = true;\r\n\r\n    RegisterClass(\"FlowGraphDataConnection\", FlowGraphDataConnection);\r\n}\r\n"]}
+{"version":3,"file":"flowGraphDataConnection.pure.js","sourceRoot":"","sources":["../../../../dev/core/src/FlowGraph/flowGraphDataConnection.pure.ts"],"names":[],"mappings":"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","sourcesContent":["/** This file must only contain pure code and pure imports */\r\n\r\nimport { type Nullable } from \"core/types\";\r\nimport { type FlowGraphBlock } from \"./flowGraphBlock\";\r\nimport { FlowGraphConnection, FlowGraphConnectionType } from \"./flowGraphConnection\";\r\nimport { type FlowGraphContext } from \"./flowGraphContext\";\r\nimport { type RichType } from \"./flowGraphRichTypes.pure\";\r\nimport { Observable } from \"core/Misc/observable.pure\";\r\nimport { defaultValueSerializationFunction, GetSceneNodeFromSerializedReference, _IsSerializedNodeReference } from \"./serialization\";\r\nimport { RegisterClass } from \"../Misc/typeStore\";\r\nimport { type Scene } from \"core/scene\";\r\nimport { type Node } from \"core/node\";\r\n\r\n/**\r\n * Resolves a node or a serialized node reference against a scene.\r\n * @param value a scene node, or a serialized node reference left by the parser\r\n * @param scene the scene to resolve the reference against\r\n * @returns the matching node in the scene, or undefined when the value does not need to (or cannot) be rebound\r\n */\r\nfunction _ReresolveNodeReference(value: any, scene: Scene): Node | undefined {\r\n    if (!value || typeof value !== \"object\") {\r\n        return undefined;\r\n    }\r\n    let reference: { id?: string; name?: string; className?: string; uniqueId?: number };\r\n    if (typeof value.getClassName === \"function\" && typeof value.getScene === \"function\") {\r\n        // A scene node — only rebind when it belongs to a different scene.\r\n        if (value.getScene() === scene) {\r\n            return undefined;\r\n        }\r\n        reference = { id: value.id, name: value.name, className: value.getClassName(), uniqueId: value.uniqueId };\r\n    } else if (_IsSerializedNodeReference(value)) {\r\n        // An unresolved serialized node reference left by the parser.\r\n        reference = value;\r\n    } else {\r\n        return undefined;\r\n    }\r\n    return GetSceneNodeFromSerializedReference(reference, scene);\r\n}\r\n/**\r\n * Represents a connection point for data.\r\n * An unconnected input point can have a default value.\r\n * An output point will only have a value if it is connected to an input point. Furthermore,\r\n * if the point belongs to a \"function\" node, the node will run its function to update the value.\r\n */\r\nexport class FlowGraphDataConnection<T> extends FlowGraphConnection<FlowGraphBlock, FlowGraphDataConnection<T>> {\r\n    private _isDisabled: boolean = false;\r\n    /**\r\n     * This is used for debugging purposes! It is the last value that was set to this connection with ANY context.\r\n     * Do not use this value for anything else, as it might be wrong if used in a different context.\r\n     */\r\n    private _lastValue: Nullable<T> = null;\r\n\r\n    /**\r\n     * a data transformer function, if needed.\r\n     * This can be used, for example, to force seconds into milliseconds output, if it makes sense in your case.\r\n     */\r\n    public dataTransformer: Nullable<(value: T) => T> = null;\r\n\r\n    /**\r\n     * An observable that is triggered when the value of the connection changes.\r\n     */\r\n    public onValueChangedObservable = new Observable<T>();\r\n    /**\r\n     * Create a new data connection point.\r\n     * @param name the name of the connection\r\n     * @param connectionType the type of the connection\r\n     * @param ownerBlock the block that owns this connection\r\n     * @param richType the type of the data in this block\r\n     * @param _defaultValue the default value of the connection\r\n     * @param _optional if the connection is optional\r\n     */\r\n    public constructor(\r\n        name: string,\r\n        connectionType: FlowGraphConnectionType,\r\n        ownerBlock: FlowGraphBlock,\r\n        /**\r\n         * the type of the data in this block\r\n         */\r\n        public richType: RichType<T>,\r\n        /**\r\n         * [any] the default value of the connection\r\n         */\r\n        private _defaultValue: T = richType.defaultValue,\r\n        /**\r\n         * [false] if the connection is optional\r\n         */\r\n        private _optional: boolean = false\r\n    ) {\r\n        super(name, connectionType, ownerBlock);\r\n    }\r\n\r\n    /**\r\n     * Whether or not the connection is optional.\r\n     * Currently only used for UI control.\r\n     */\r\n    public get optional(): boolean {\r\n        return this._optional;\r\n    }\r\n\r\n    /**\r\n     * is this connection disabled\r\n     * If the connection is disabled you will not be able to connect anything to it.\r\n     */\r\n    public get isDisabled(): boolean {\r\n        return this._isDisabled;\r\n    }\r\n\r\n    public set isDisabled(value: boolean) {\r\n        if (this._isDisabled === value) {\r\n            return;\r\n        }\r\n        this._isDisabled = value;\r\n        if (this._isDisabled) {\r\n            this.disconnectFromAll();\r\n        }\r\n    }\r\n\r\n    /**\r\n     * An output data block can connect to multiple input data blocks,\r\n     * but an input data block can only connect to one output data block.\r\n     * @returns true if the connection is singular\r\n     */\r\n    public override _isSingularConnection(): boolean {\r\n        return this.connectionType === FlowGraphConnectionType.Input;\r\n    }\r\n\r\n    /**\r\n     * Set the value of the connection in a specific context.\r\n     * @param value the value to set\r\n     * @param context the context to which the value is set\r\n     */\r\n    public setValue(value: T, context: FlowGraphContext): void {\r\n        // check if the value is different\r\n        if (context._getConnectionValue(this) === value) {\r\n            return;\r\n        }\r\n        context._setConnectionValue(this, value);\r\n        this.onValueChangedObservable.notifyObservers(value);\r\n    }\r\n\r\n    /**\r\n     * Reset the value of the connection to the default value.\r\n     * @param context the context in which the value is reset\r\n     */\r\n    public resetToDefaultValue(context: FlowGraphContext): void {\r\n        context._setConnectionValue(this, this._defaultValue);\r\n    }\r\n\r\n    /**\r\n     * Re-resolves this input's default value against a (new) scene when the value is a node reference.\r\n     * This handles two cases that occur when a graph is moved to a different scene (see\r\n     * {@link FlowGraph.setScene}):\r\n     * - the value is still an unresolved serialized reference (`{ id, name, className, uniqueId }`)\r\n     *   because the node did not yet exist in the scene at parse time, or\r\n     * - the value is a node that belongs to a different (e.g. disposed) scene.\r\n     * Values that are not node references (numbers, vectors, matrices, etc.) are left untouched, and\r\n     * the default value is only replaced when a matching node is found in the new scene.\r\n     * @param scene the scene to resolve the reference against\r\n     * @internal\r\n     */\r\n    public _reresolveDefaultValueForScene(scene: Scene): void {\r\n        const value = this._defaultValue as any;\r\n        if (!value || typeof value !== \"object\") {\r\n            return;\r\n        }\r\n\r\n        if (Array.isArray(value)) {\r\n            let changed = false;\r\n            const resolved = value.map((entry) => {\r\n                const node = _ReresolveNodeReference(entry, scene);\r\n                if (node) {\r\n                    changed = true;\r\n                    return node;\r\n                }\r\n                return entry;\r\n            });\r\n            if (changed) {\r\n                this._defaultValue = resolved as unknown as T;\r\n            }\r\n            return;\r\n        }\r\n\r\n        const node = _ReresolveNodeReference(value, scene);\r\n        if (node) {\r\n            this._defaultValue = node as unknown as T;\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Connect this point to another point.\r\n     * @param point the point to connect to.\r\n     */\r\n    public override connectTo(point: FlowGraphDataConnection<T>): void {\r\n        if (this._isDisabled) {\r\n            return;\r\n        }\r\n        super.connectTo(point);\r\n    }\r\n\r\n    private _getValueOrDefault(context: FlowGraphContext): T {\r\n        const val = context._getConnectionValue(this) ?? this._defaultValue;\r\n        return this.dataTransformer ? this.dataTransformer(val) : val;\r\n    }\r\n\r\n    /**\r\n     * Gets the value of the connection in a specific context.\r\n     * @param context the context from which the value is retrieved\r\n     * @returns the value of the connection\r\n     */\r\n    public getValue(context: FlowGraphContext): T {\r\n        if (this.connectionType === FlowGraphConnectionType.Output) {\r\n            context._notifyExecuteNode(this._ownerBlock);\r\n            this._ownerBlock._updateOutputs(context);\r\n            const value = this._getValueOrDefault(context);\r\n            this._lastValue = value;\r\n            return this.richType.typeTransformer ? this.richType.typeTransformer(value) : value;\r\n        }\r\n        const value = !this.isConnected() ? this._getValueOrDefault(context) : this._connectedPoint[0].getValue(context);\r\n        this._lastValue = value;\r\n        return this.richType.typeTransformer ? this.richType.typeTransformer(value) : value;\r\n    }\r\n\r\n    /**\r\n     * @internal\r\n     */\r\n    public _getLastValue(): Nullable<T> {\r\n        return this._lastValue;\r\n    }\r\n\r\n    /**\r\n     * @returns class name of the object.\r\n     */\r\n    public override getClassName(): string {\r\n        return \"FlowGraphDataConnection\";\r\n    }\r\n\r\n    /**\r\n     * Serializes this object.\r\n     * @param serializationObject the object to serialize to\r\n     */\r\n    public override serialize(serializationObject: any = {}) {\r\n        super.serialize(serializationObject);\r\n        serializationObject.richType = {};\r\n        this.richType.serialize(serializationObject.richType);\r\n        serializationObject.optional = this._optional;\r\n        defaultValueSerializationFunction(\"defaultValue\", this._defaultValue, serializationObject);\r\n    }\r\n}\r\n\r\nlet _Registered = false;\r\n/**\r\n * Register side effects for flowGraphDataConnection.\r\n * Safe to call multiple times; only the first call has an effect.\r\n */\r\nexport function RegisterFlowGraphDataConnection(): void {\r\n    if (_Registered) {\r\n        return;\r\n    }\r\n    _Registered = true;\r\n\r\n    RegisterClass(\"FlowGraphDataConnection\", FlowGraphDataConnection);\r\n}\r\n"]}

package/FlowGraph/flowGraphParser.js

@@ -6,6 +6,69 @@ import { _GetDefaultEventDataParseCount, defaultValueParseFunction, needsPathCon
 import { getRichTypeByFlowGraphType, RichType } from "./flowGraphRichTypes.pure.js";
 
 import { WebRequest } from "../Misc/webRequest.js";
+import { Logger } from "../Misc/logger.js";
+function _CreateReferenceProvenanceParseFunction(baseValueParseFunction, provenance) {
+    const locations = new Map();
+    const provenanceIndexes = new Map();
+    for (let provenanceIndex = 0; provenanceIndex < provenance.length; provenanceIndex++) {
+        const [uniqueId, location] = provenance[provenanceIndex];
+        const matchingLocations = locations.get(uniqueId) ?? [];
+        matchingLocations.push(location);
+        locations.set(uniqueId, matchingLocations);
+        provenanceIndexes.set(location, provenanceIndex);
+    }
+    const resolve = (serializedValue, parsedValue, scene) => {
+        if (Array.isArray(serializedValue)) {
+            if (!Array.isArray(parsedValue) ||
+                !serializedValue.every((entry) => entry && typeof entry === "object" && typeof entry.uniqueId === "number" && typeof entry.className === "string")) {
+                return parsedValue;
+            }
+            let changed = false;
+            const resolved = serializedValue.map((entry, index) => {
+                const resolvedEntry = resolve(entry, parsedValue[index], scene);
+                changed || (changed = resolvedEntry !== parsedValue[index]);
+                return resolvedEntry;
+            });
+            return changed ? resolved : parsedValue;
+        }
+        if (!serializedValue || typeof serializedValue !== "object" || typeof serializedValue.uniqueId !== "number" || typeof serializedValue.className !== "string") {
+            return parsedValue;
+        }
+        const matchingLocations = locations.get(serializedValue.uniqueId);
+        const location = matchingLocations?.find((candidate) => candidate.className === serializedValue.className && candidate.id === serializedValue.id && candidate.name === serializedValue.name) ??
+            matchingLocations?.find((candidate) => candidate.className === serializedValue.className && candidate.id === serializedValue.id) ??
+            matchingLocations?.find((candidate) => candidate.className === serializedValue.className && candidate.name === serializedValue.name) ??
+            (matchingLocations?.length === 1 ? matchingLocations[0] : undefined);
+        if (!location) {
+            return parsedValue;
+        }
+        const nodes = scene.getNodes().filter((node) => node.getClassName() === location.className);
+        let candidates = nodes.filter((node) => node.id === location.id);
+        let index = location.idIndex;
+        if (candidates.length === 0) {
+            candidates = nodes.filter((node) => node.name === location.name);
+            index = location.nameIndex;
+        }
+        const resolved = (location.sceneUid === scene.uid ? candidates.find((node) => node.uniqueId === serializedValue.uniqueId) : undefined) ?? candidates[index];
+        if (!resolved) {
+            return serializedValue;
+        }
+        const resolvedNodes = scene.getNodes().filter((node) => node.getClassName() === resolved.getClassName());
+        provenance[provenanceIndexes.get(location)] = [
+            resolved.uniqueId,
+            {
+                id: resolved.id,
+                name: resolved.name,
+                className: resolved.getClassName(),
+                idIndex: resolvedNodes.filter((node) => node.id === resolved.id).indexOf(resolved),
+                nameIndex: resolvedNodes.filter((node) => node.name === resolved.name).indexOf(resolved),
+                sceneUid: scene.uid,
+            },
+        ];
+        return resolved;
+    };
+    return (key, serializationObject, assetsContainer, scene) => resolve(serializationObject[key], baseValueParseFunction(key, serializationObject, assetsContainer, scene), scene);
+}
 function ParseCustomEventData(serializedEventData, valueParseFunction, assetsContainer, scene) {
     const eventData = Object.create(null);
     if (Array.isArray(serializedEventData)) {
@@ -71,6 +134,20 @@ function ApplyCoordinatorSerializationSettings(serializedObject, coordinator) {
         }
     }
 }
+async function LoadSerializedSoundAssetsAsync(serializedObject, coordinator, audioEngine) {
+    const soundAssets = serializedObject.soundAssets;
+    if (!Array.isArray(soundAssets) || soundAssets.length === 0) {
+        return;
+    }
+    await Promise.all(soundAssets.map(async (asset) => {
+        try {
+            await coordinator.addSoundAssetAsync(asset, audioEngine);
+        }
+        catch (e) {
+            Logger.Warn(`FlowGraph: unable to load sound asset "${asset.name}": ${e}`);
+        }
+    }));
+}
 /**
  * Given a list of blocks, find an output data connection that has a specific unique id
  * @param blocks a list of flow graph blocks
@@ -115,9 +192,14 @@ export async function ParseCoordinatorAsync(serializedObject, options) {
     const valueParseFunction = options.valueParseFunction ?? defaultValueParseFunction;
     const coordinator = new FlowGraphCoordinator({ scene: options.scene });
     ApplyCoordinatorSerializationSettings(serializedObject, coordinator);
-    await options.scene.whenReadyAsync();
+    await Promise.all([options.scene.whenReadyAsync(), LoadSerializedSoundAssetsAsync(serializedObject, coordinator, options.audioEngine)]);
     // async-parse the flow graphs. This can be done in parallel
-    await Promise.all(serializedObject._flowGraphs?.map(async (serializedGraph) => await ParseFlowGraphAsync(serializedGraph, { coordinator, valueParseFunction, pathConverter: options.pathConverter })));
+    await Promise.all(serializedObject._flowGraphs?.map(async (serializedGraph) => await ParseFlowGraphAsync(serializedGraph, {
+        coordinator,
+        valueParseFunction,
+        pathConverter: options.pathConverter,
+        referenceProvenance: serializedObject.referenceProvenance,
+    })));
     return coordinator;
 }
 /**
@@ -134,7 +216,12 @@ export async function ParseFlowGraphCoordinatorFromSnippetAsync(snippetId, optio
     const valueParseFunction = options.valueParseFunction ?? defaultValueParseFunction;
     const coordinator = new FlowGraphCoordinator({ scene: options.scene });
     await options.scene.whenReadyAsync();
-    await ParseFlowGraphAsync(serializedObject, { coordinator, valueParseFunction, pathConverter: options.pathConverter });
+    await ParseFlowGraphAsync(serializedObject, {
+        coordinator,
+        valueParseFunction,
+        pathConverter: options.pathConverter,
+        referenceProvenance: serializedObject.referenceProvenance,
+    });
     return coordinator;
 }
 /**
@@ -151,10 +238,17 @@ export async function ParseFlowGraphFromSnippetAsync(snippetId, options) {
         return await ParseFlowGraphAsync(serializedObject, options);
     }
     ApplyCoordinatorSerializationSettings(serializedObject, options.coordinator);
+    await LoadSerializedSoundAssetsAsync(serializedObject, options.coordinator);
     const parsedGraphs = [];
     for (const serializedGraph of serializedObject._flowGraphs) {
+        parsedGraphs.push(
         // eslint-disable-next-line no-await-in-loop -- graph order matters for the active graph index.
-        parsedGraphs.push(await ParseFlowGraphAsync(serializedGraph, { coordinator: options.coordinator, valueParseFunction, pathConverter: options.pathConverter }));
+        await ParseFlowGraphAsync(serializedGraph, {
+            coordinator: options.coordinator,
+            valueParseFunction,
+            pathConverter: options.pathConverter,
+            referenceProvenance: serializedObject.referenceProvenance,
+        }));
     }
     const activeGraphIndex = serializedObject.activeGraphIndex ?? 0;
     return parsedGraphs[activeGraphIndex] ?? parsedGraphs[0];
@@ -192,7 +286,13 @@ export function ParseFlowGraph(serializationObject, options, resolvedClasses) {
     }
     graph.metadata = serializationObject.metadata;
     const blocks = [];
-    const valueParseFunction = options.valueParseFunction ?? defaultValueParseFunction;
+    const baseValueParseFunction = options.valueParseFunction ?? defaultValueParseFunction;
+    const serializedReferenceProvenance = options.referenceProvenance ?? serializationObject.referenceProvenance;
+    const referenceProvenance = serializedReferenceProvenance?.map(([uniqueId, location]) => [uniqueId, { ...location }]);
+    const valueParseFunction = referenceProvenance ? _CreateReferenceProvenanceParseFunction(baseValueParseFunction, referenceProvenance) : baseValueParseFunction;
+    if (referenceProvenance) {
+        graph._setReferenceProvenance(referenceProvenance);
+    }
     // Parse all blocks
     // for (const serializedBlock of serializationObject.allBlocks) {
     for (let i = 0; i < serializationObject.allBlocks.length; i++) {