npm - @onerjs/core - Versions diffs - 8.54.3 → 8.54.5 - Mend

@onerjs/core 8.54.3 → 8.54.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (211) hide show

package/FlowGraph/flowGraphContext.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"flowGraphContext.js","sourceRoot":"","sources":["../../../../dev/core/src/FlowGraph/flowGraphContext.ts"],"names":[],"mappings":"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","sourcesContent":["import { serialize } from \"../Misc/decorators\";\r\nimport { RandomGUID } from \"../Misc/guid\";\r\nimport { type Scene } from \"../scene\";\r\nimport { type FlowGraphAsyncExecutionBlock } from \"./flowGraphAsyncExecutionBlock\";\r\nimport { type FlowGraphBlock } from \"./flowGraphBlock\";\r\nimport { type FlowGraphDataConnection } from \"./flowGraphDataConnection\";\r\nimport { type FlowGraph } from \"./flowGraph\";\r\nimport { defaultValueSerializationFunction } from \"./serialization\";\r\nimport { type FlowGraphCoordinator } from \"./flowGraphCoordinator\";\r\nimport { type FlowGraphSceneEventCoordinator } from \"./flowGraphSceneEventCoordinator\";\r\nimport { Observable } from \"../Misc/observable\";\r\nimport { type AssetType, type FlowGraphAssetType, GetFlowGraphAssetWithType } from \"./flowGraphAssetsContext\";\r\nimport { type IAssetContainer } from \"core/IAssetContainer\";\r\nimport { type Nullable } from \"core/types\";\r\nimport { FlowGraphAction, FlowGraphLogger } from \"./flowGraphLogger\";\r\nimport { type IFlowGraphOnTickEventPayload } from \"./Blocks/Event/flowGraphSceneTickEventBlock\";\r\nimport { type FlowGraphExecutionBlock } from \"./flowGraphExecutionBlock\";\r\nimport { type FlowGraphSignalConnection } from \"./flowGraphSignalConnection\";\r\n\r\n/*\r\n Represents a pending signal activation that was paused by a breakpoint.\r\n /\r\nexport interface IFlowGraphPendingActivation {\r\n /* The block that was about to execute /\r\n readonly block: FlowGraphExecutionBlock;\r\n /* The context in which execution was paused /\r\n readonly context: FlowGraphContext;\r\n /* The signal connection that triggered the execution /\r\n readonly signal: FlowGraphSignalConnection;\r\n}\r\n/\r\n Construction parameters for the context.\r\n /\r\nexport interface IFlowGraphContextConfiguration {\r\n /\r\n The scene that the flow graph context belongs to.\r\n /\r\n readonly scene: Scene;\r\n /\r\n The event coordinator used by the flow graph context.\r\n /\r\n readonly coordinator: FlowGraphCoordinator;\r\n\r\n /\r\n The scene event coordinator that tracks runtime event state\r\n * (e.g. currently pressed keyboard keys).\r\n * When not provided, keyboard polling blocks (e.g. IsKeyPressed) will\r\n * report no keys pressed.\r\n /\r\n readonly sceneEventCoordinator?: FlowGraphSceneEventCoordinator;\r\n\r\n /\r\n The assets context used by the flow graph context.\r\n * If none is provided, a default one will be created.\r\n /\r\n readonly assetsContext?: IAssetContainer;\r\n}\r\n\r\n/\r\n Options for parsing a context.\r\n /\r\nexport interface IFlowGraphContextParseOptions {\r\n /\r\n A function that parses a value from a serialization object.\r\n * @param key the key of the value\r\n * @param serializationObject the object containing the value\r\n * @param assetsContainer the assets container\r\n * @param scene the current scene\r\n * @returns\r\n /\r\n readonly valueParseFunction?: (key: string, serializationObject: any, assetsContainer: IAssetContainer, scene: Scene) => any;\r\n /\r\n The graph that the context is being parsed in.\r\n /\r\n readonly graph: FlowGraph;\r\n}\r\n/\r\n The context represents the current state and execution of the flow graph.\r\n * It contains both user-defined variables, which are derived from\r\n * a more general variable definition, and execution variables that\r\n * are set by the blocks.\r\n /\r\nexport class FlowGraphContext {\r\n /\r\n A randomly generated GUID for each context.\r\n /\r\n @serialize()\r\n public uniqueId = RandomGUID();\r\n /\r\n An optional user-facing name for the context.\r\n * Defaults to an empty string; the editor may assign a label like \"Context 0\".\r\n /\r\n @serialize()\r\n public name: string = \"\";\r\n /\r\n These are the variables defined by a user.\r\n /\r\n private _userVariables: { [key: string]: any } = {};\r\n /\r\n Optional type annotations for user variables.\r\n * Keys are variable names; values are type name strings (e.g. \"number\", \"Vector3\", \"Mesh\").\r\n * This map is maintained by the editor and persisted through serialization so\r\n * that a variable's declared type survives even when its value is undefined.\r\n /\r\n private _variableTypes: { [key: string]: string } = {};\r\n /\r\n These are the variables set by the blocks.\r\n /\r\n private _executionVariables: { [key: string]: any } = {};\r\n\r\n /\r\n A context-specific global variables, available to all blocks in the context.\r\n /\r\n private _globalContextVariables: { [key: string]: any } = {};\r\n /\r\n These are the values for the data connection points\r\n /\r\n private _connectionValues: { [key: string]: any } = {};\r\n /\r\n These are the variables set by the graph.\r\n /\r\n private readonly _configuration: IFlowGraphContextConfiguration;\r\n /\r\n These are blocks that have currently pending tasks/listeners that need to be cleaned up.\r\n /\r\n private _pendingBlocks: FlowGraphAsyncExecutionBlock[] = [];\r\n /\r\n A monotonically increasing ID for each execution.\r\n * Incremented for every block executed.\r\n /\r\n private _executionId = 0;\r\n /\r\n Observable that is triggered when a node is executed.\r\n /\r\n public onNodeExecutedObservable: Observable<FlowGraphBlock> = new Observable<FlowGraphBlock>();\r\n\r\n /\r\n Observable triggered when a breakpoint is hit.\r\n * Observers receive the pending activation (block, context, signal) that was paused.\r\n /\r\n public onBreakpointHitObservable: Observable<IFlowGraphPendingActivation> = new Observable<IFlowGraphPendingActivation>();\r\n\r\n /\r\n A predicate called before each execution block runs.\r\n * If it returns true, execution is paused before the block and a\r\n * pending activation is stored, which can be resumed via\r\n * {@link continueExecution} or {@link stepExecution}.\r\n \r\n Set to `null` to disable breakpoint checking.\r\n /\r\n public breakpointPredicate: Nullable<(block: FlowGraphExecutionBlock) => boolean> = null;\r\n\r\n /\r\n The activation that is currently paused due to a breakpoint hit.\r\n * `null` when execution is not paused on a breakpoint.\r\n /\r\n private _pendingActivation: Nullable<IFlowGraphPendingActivation> = null;\r\n\r\n /\r\n When true, the next activation will pause regardless of the breakpoint predicate.\r\n * Set by {@link stepExecution}.\r\n /\r\n private _stepMode: boolean = false;\r\n\r\n /\r\n When set, the breakpoint check is skipped for this specific block uniqueId\r\n * on the very next call to {@link _shouldBreak}. Used by continue/step to avoid\r\n * immediately re-hitting the breakpoint on the block being resumed.\r\n /\r\n private _skipBreakpointForBlockId: Nullable<string> = null;\r\n\r\n /\r\n The assets context used by the flow graph context.\r\n * Note that it can be shared between flow graph contexts.\r\n /\r\n public assetsContext: IAssetContainer;\r\n\r\n /\r\n Whether to treat data as right-handed.\r\n * This is used when serializing data from a right-handed system, while running the context in a left-handed system, for example in glTF parsing.\r\n * Default is false.\r\n /\r\n public treatDataAsRightHanded = false;\r\n\r\n private _enableLogging = false;\r\n\r\n /\r\n The logger used by the context to log actions.\r\n /\r\n public logger: Nullable<FlowGraphLogger>;\r\n\r\n /\r\n Enable logging on this context\r\n /\r\n public get enableLogging() {\r\n return this._enableLogging;\r\n }\r\n\r\n public set enableLogging(value: boolean) {\r\n if (this._enableLogging === value) {\r\n return;\r\n }\r\n this._enableLogging = value;\r\n if (this._enableLogging) {\r\n this.logger = new FlowGraphLogger();\r\n this.logger.logToConsole = true;\r\n } else {\r\n this.logger = null;\r\n }\r\n }\r\n\r\n constructor(params: IFlowGraphContextConfiguration) {\r\n this._configuration = params;\r\n this.assetsContext = params.assetsContext ?? params.scene;\r\n }\r\n\r\n /\r\n Check if a user-defined variable is defined.\r\n * @param name the name of the variable\r\n * @returns true if the variable is defined\r\n /\r\n public hasVariable(name: string) {\r\n return name in this._userVariables;\r\n }\r\n\r\n /\r\n Set a user-defined variable.\r\n * @param name the name of the variable\r\n * @param value the value of the variable\r\n /\r\n public setVariable(name: string, value: any) {\r\n this._userVariables[name] = value;\r\n this.logger?.addLogItem({\r\n time: Date.now(),\r\n className: this.getClassName(),\r\n uniqueId: this.uniqueId,\r\n action: FlowGraphAction.ContextVariableSet,\r\n payload: {\r\n name,\r\n value,\r\n },\r\n });\r\n }\r\n\r\n /\r\n Get an assets from the assets context based on its type and index in the array\r\n * @param type The type of the asset\r\n * @param index The index of the asset\r\n * @returns The asset or null if not found\r\n /\r\n public getAsset<T extends FlowGraphAssetType>(type: T, index: number): Nullable<AssetType<T>> {\r\n return GetFlowGraphAssetWithType(this.assetsContext, type, index);\r\n }\r\n\r\n /\r\n Get a user-defined variable.\r\n * @param name the name of the variable\r\n * @returns the value of the variable\r\n /\r\n public getVariable(name: string): any {\r\n this.logger?.addLogItem({\r\n time: Date.now(),\r\n className: this.getClassName(),\r\n uniqueId: this.uniqueId,\r\n action: FlowGraphAction.ContextVariableGet,\r\n payload: {\r\n name,\r\n value: this._userVariables[name],\r\n },\r\n });\r\n return this._userVariables[name];\r\n }\r\n\r\n /\r\n Gets all user variables map\r\n /\r\n public get userVariables() {\r\n return this._userVariables;\r\n }\r\n\r\n /\r\n Set the declared type annotation for a user variable.\r\n * @param name - the variable name\r\n * @param typeName - the type name string (e.g. \"number\", \"Vector3\", \"Mesh\")\r\n /\r\n public setVariableType(name: string, typeName: string): void {\r\n this._variableTypes[name] = typeName;\r\n }\r\n\r\n /\r\n Get the declared type annotation for a user variable.\r\n * @param name - the variable name\r\n * @returns the type name string, or undefined if no type was declared\r\n /\r\n public getVariableType(name: string): string \| undefined {\r\n return this._variableTypes[name];\r\n }\r\n\r\n /\r\n Gets all variable type annotations.\r\n /\r\n public get variableTypes(): { [key: string]: string } {\r\n return this._variableTypes;\r\n }\r\n\r\n /\r\n Get the scene that the context belongs to.\r\n * @returns the scene\r\n /\r\n public getScene() {\r\n return this._configuration.scene;\r\n }\r\n\r\n private _getUniqueIdPrefixedName(obj: FlowGraphBlock, name: string): string {\r\n return `${obj.uniqueId}_${name}`;\r\n }\r\n\r\n /\r\n @internal\r\n * @param name name of the variable\r\n * @param defaultValue default value to return if the variable is not defined\r\n * @returns the variable value or the default value if the variable is not defined\r\n /\r\n public _getGlobalContextVariable<T>(name: string, defaultValue: T): T {\r\n this.logger?.addLogItem({\r\n time: Date.now(),\r\n className: this.getClassName(),\r\n uniqueId: this.uniqueId,\r\n action: FlowGraphAction.GlobalVariableGet,\r\n payload: {\r\n name,\r\n defaultValue,\r\n possibleValue: this._globalContextVariables[name],\r\n },\r\n });\r\n if (this._hasGlobalContextVariable(name)) {\r\n return this._globalContextVariables[name];\r\n } else {\r\n return defaultValue;\r\n }\r\n }\r\n\r\n /\r\n Set a global context variable\r\n * @internal\r\n * @param name the name of the variable\r\n * @param value the value of the variable\r\n /\r\n public _setGlobalContextVariable<T>(name: string, value: T) {\r\n this.logger?.addLogItem({\r\n time: Date.now(),\r\n className: this.getClassName(),\r\n uniqueId: this.uniqueId,\r\n action: FlowGraphAction.GlobalVariableSet,\r\n payload: { name, value },\r\n });\r\n this._globalContextVariables[name] = value;\r\n }\r\n\r\n /\r\n Delete a global context variable\r\n * @internal\r\n * @param name the name of the variable\r\n /\r\n public _deleteGlobalContextVariable(name: string) {\r\n this.logger?.addLogItem({\r\n time: Date.now(),\r\n className: this.getClassName(),\r\n uniqueId: this.uniqueId,\r\n action: FlowGraphAction.GlobalVariableDelete,\r\n payload: { name },\r\n });\r\n delete this._globalContextVariables[name];\r\n }\r\n\r\n /\r\n Check if a global context variable is defined\r\n * @internal\r\n * @param name the name of the variable\r\n * @returns true if the variable is defined\r\n /\r\n public _hasGlobalContextVariable(name: string) {\r\n return name in this._globalContextVariables;\r\n }\r\n\r\n /\r\n Set an internal execution variable\r\n * @internal\r\n * @param name\r\n * @param value\r\n /\r\n public _setExecutionVariable(block: FlowGraphBlock, name: string, value: any) {\r\n this._executionVariables[this._getUniqueIdPrefixedName(block, name)] = value;\r\n }\r\n\r\n /\r\n Get an internal execution variable\r\n * @internal\r\n * @param name\r\n * @returns\r\n /\r\n public _getExecutionVariable<T>(block: FlowGraphBlock, name: string, defaultValue: T): T {\r\n if (this._hasExecutionVariable(block, name)) {\r\n return this._executionVariables[this._getUniqueIdPrefixedName(block, name)];\r\n } else {\r\n return defaultValue;\r\n }\r\n }\r\n\r\n /\r\n Delete an internal execution variable\r\n * @internal\r\n * @param block\r\n * @param name\r\n /\r\n public _deleteExecutionVariable(block: FlowGraphBlock, name: string) {\r\n delete this._executionVariables[this._getUniqueIdPrefixedName(block, name)];\r\n }\r\n\r\n /\r\n Check if an internal execution variable is defined\r\n * @internal\r\n * @param block\r\n * @param name\r\n * @returns\r\n /\r\n public _hasExecutionVariable(block: FlowGraphBlock, name: string) {\r\n return this._getUniqueIdPrefixedName(block, name) in this._executionVariables;\r\n }\r\n\r\n /\r\n Check if a connection value is defined\r\n * @internal\r\n * @param connectionPoint\r\n * @returns\r\n /\r\n public _hasConnectionValue(connectionPoint: FlowGraphDataConnection<any>) {\r\n return connectionPoint.uniqueId in this._connectionValues;\r\n }\r\n\r\n /\r\n Set a connection value\r\n * @internal\r\n * @param connectionPoint\r\n * @param value\r\n /\r\n public _setConnectionValue<T>(connectionPoint: FlowGraphDataConnection<T>, value: T) {\r\n this._connectionValues[connectionPoint.uniqueId] = value;\r\n this.logger?.addLogItem({\r\n time: Date.now(),\r\n className: this.getClassName(),\r\n uniqueId: this.uniqueId,\r\n action: FlowGraphAction.SetConnectionValue,\r\n payload: {\r\n connectionPointId: connectionPoint.uniqueId,\r\n value,\r\n },\r\n });\r\n }\r\n\r\n /\r\n Set a connection value by key\r\n * @internal\r\n * @param key the key of the connection value\r\n * @param value the value of the connection\r\n /\r\n public _setConnectionValueByKey<T>(key: string, value: T) {\r\n this._connectionValues[key] = value;\r\n }\r\n\r\n /\r\n Get a connection value\r\n * @internal\r\n * @param connectionPoint\r\n * @returns\r\n /\r\n public _getConnectionValue<T>(connectionPoint: FlowGraphDataConnection<T>): T {\r\n this.logger?.addLogItem({\r\n time: Date.now(),\r\n className: this.getClassName(),\r\n uniqueId: this.uniqueId,\r\n action: FlowGraphAction.GetConnectionValue,\r\n payload: {\r\n connectionPointId: connectionPoint.uniqueId,\r\n value: this._connectionValues[connectionPoint.uniqueId],\r\n },\r\n });\r\n return this._connectionValues[connectionPoint.uniqueId];\r\n }\r\n\r\n /\r\n Get the configuration\r\n * @internal\r\n * @param name\r\n * @param value\r\n /\r\n public get configuration() {\r\n return this._configuration;\r\n }\r\n\r\n /\r\n Check if there are any pending blocks in this context\r\n * @returns true if there are pending blocks\r\n /\r\n public get hasPendingBlocks() {\r\n return this._pendingBlocks.length > 0;\r\n }\r\n\r\n /\r\n Add a block to the list of blocks that have pending tasks.\r\n * @internal\r\n * @param block\r\n /\r\n public _addPendingBlock(block: FlowGraphAsyncExecutionBlock) {\r\n // check if block is already in the array\r\n if (this._pendingBlocks.includes(block)) {\r\n return;\r\n }\r\n this._pendingBlocks.push(block);\r\n // sort pending blocks by priority\r\n this._pendingBlocks.sort((a, b) => a.priority - b.priority);\r\n }\r\n\r\n /\r\n Remove a block from the list of blocks that have pending tasks.\r\n * @internal\r\n * @param block\r\n /\r\n public _removePendingBlock(block: FlowGraphAsyncExecutionBlock) {\r\n const index = this._pendingBlocks.indexOf(block);\r\n if (index !== -1) {\r\n this._pendingBlocks.splice(index, 1);\r\n }\r\n }\r\n\r\n /\r\n Clear all pending blocks.\r\n * @internal\r\n /\r\n public _clearPendingBlocks() {\r\n for (const block of this._pendingBlocks) {\r\n block._cancelPendingTasks(this);\r\n }\r\n this._pendingBlocks.length = 0;\r\n }\r\n\r\n /\r\n @internal\r\n * Function that notifies the node executed observable\r\n * @param node\r\n /\r\n public _notifyExecuteNode(node: FlowGraphBlock) {\r\n this.onNodeExecutedObservable.notifyObservers(node);\r\n this.logger?.addLogItem({\r\n time: Date.now(),\r\n className: node.getClassName(),\r\n uniqueId: node.uniqueId,\r\n action: FlowGraphAction.ExecuteBlock,\r\n });\r\n }\r\n\r\n public _notifyOnTick(framePayload: IFlowGraphOnTickEventPayload) {\r\n // set the values as global variables\r\n this._setGlobalContextVariable(\"timeSinceStart\", framePayload.timeSinceStart);\r\n this._setGlobalContextVariable(\"deltaTime\", framePayload.deltaTime);\r\n // iterate the pending blocks and run each one's onFrame function\r\n for (const block of this._pendingBlocks) {\r\n block._executeOnTick?.(this);\r\n }\r\n }\r\n\r\n /\r\n @internal\r\n /\r\n public _increaseExecutionId() {\r\n this._executionId++;\r\n }\r\n /\r\n A monotonically increasing ID for each execution.\r\n * Incremented for every block executed.\r\n /\r\n public get executionId() {\r\n return this._executionId;\r\n }\r\n\r\n // ── Breakpoint API ─────────────────────────────────────────────────\r\n\r\n /\r\n Check whether the given block should break before executing.\r\n * Called by the signal connection infrastructure.\r\n * @internal\r\n * @param block the block about to execute\r\n * @param signal the signal that is triggering the execution\r\n * @returns true if execution should be paused (breakpoint hit)\r\n /\r\n public _shouldBreak(block: FlowGraphExecutionBlock, signal: FlowGraphSignalConnection): boolean {\r\n // If continue/step just resumed this specific block, let it through\r\n if (this._skipBreakpointForBlockId === block.uniqueId) {\r\n this._skipBreakpointForBlockId = null;\r\n return false;\r\n }\r\n\r\n // If already paused on a breakpoint, silently block further execution\r\n // without overwriting the pending activation or re-notifying observers.\r\n if (this._pendingActivation) {\r\n return true;\r\n }\r\n\r\n if (this._stepMode) {\r\n this._stepMode = false;\r\n this._pendingActivation = { block, context: this, signal };\r\n this.onBreakpointHitObservable.notifyObservers(this._pendingActivation);\r\n return true;\r\n }\r\n if (this.breakpointPredicate && this.breakpointPredicate(block)) {\r\n this._pendingActivation = { block, context: this, signal };\r\n this.onBreakpointHitObservable.notifyObservers(this._pendingActivation);\r\n return true;\r\n }\r\n return false;\r\n }\r\n\r\n /\r\n Returns the currently paused activation, or null if not paused.\r\n /\r\n public get pendingActivation(): Nullable<IFlowGraphPendingActivation> {\r\n return this._pendingActivation;\r\n }\r\n\r\n /\r\n Resume execution from a breakpoint hit.\r\n * The paused block and all downstream blocks will execute normally until\r\n * the next breakpoint (if any) is hit.\r\n /\r\n public continueExecution(): void {\r\n const pending = this._pendingActivation;\r\n if (!pending) {\r\n return;\r\n }\r\n this._pendingActivation = null;\r\n // Tell _shouldBreak to skip the breakpoint for this block on re-entry\r\n this._skipBreakpointForBlockId = pending.block.uniqueId;\r\n pending.signal._activateSignal(this);\r\n // Clear in case no re-entry happened (shouldn't linger)\r\n this._skipBreakpointForBlockId = null;\r\n }\r\n\r\n /\r\n Execute exactly the paused block and then pause again before the next\r\n * execution block fires. If no activation is pending, this is a no-op.\r\n /\r\n public stepExecution(): void {\r\n const pending = this._pendingActivation;\r\n if (!pending) {\r\n return;\r\n }\r\n this._pendingActivation = null;\r\n // Enable step mode so the very next input-signal activation will pause\r\n this._stepMode = true;\r\n // Tell _shouldBreak to skip the breakpoint for this block on re-entry\r\n this._skipBreakpointForBlockId = pending.block.uniqueId;\r\n pending.signal._activateSignal(this);\r\n // If nothing further executed (end of chain), clear step mode\r\n this._stepMode = false;\r\n this._skipBreakpointForBlockId = null;\r\n }\r\n\r\n /\r\n Discard any pending breakpoint activation without resuming.\r\n * Used when stopping or resetting the graph.\r\n * @internal\r\n /\r\n public _clearPendingActivation(): void {\r\n this._pendingActivation = null;\r\n this._stepMode = false;\r\n this._skipBreakpointForBlockId = null;\r\n }\r\n\r\n /\r\n Serializes a context\r\n * @param serializationObject the object to write the values in\r\n * @param valueSerializationFunction a function to serialize complex values\r\n /\r\n public serialize(serializationObject: any = {}, valueSerializationFunction: (key: string, value: any, serializationObject: any) => void = defaultValueSerializationFunction) {\r\n serializationObject.uniqueId = this.uniqueId;\r\n serializationObject.name = this.name;\r\n serializationObject._userVariables = {};\r\n for (const key in this._userVariables) {\r\n valueSerializationFunction(key, this._userVariables[key], serializationObject._userVariables);\r\n }\r\n // Persist variable type annotations (editor metadata)\r\n if (Object.keys(this._variableTypes).length > 0) {\r\n serializationObject._variableTypes = { ...this._variableTypes };\r\n }\r\n serializationObject._connectionValues = {};\r\n for (const key in this._connectionValues) {\r\n valueSerializationFunction(key, this._connectionValues[key], serializationObject._connectionValues);\r\n }\r\n // serialize assets context, if not scene\r\n if (this.assetsContext !== this.getScene()) {\r\n serializationObject._assetsContext = {\r\n meshes: this.assetsContext.meshes.map((m) => m.id),\r\n materials: this.assetsContext.materials.map((m) => m.id),\r\n textures: this.assetsContext.textures.map((m) => m.name),\r\n animations: this.assetsContext.animations.map((m) => m.name),\r\n lights: this.assetsContext.lights.map((m) => m.id),\r\n cameras: this.assetsContext.cameras.map((m) => m.id),\r\n sounds: this.assetsContext.sounds?.map((m) => m.name),\r\n skeletons: this.assetsContext.skeletons.map((m) => m.id),\r\n particleSystems: this.assetsContext.particleSystems.map((m) => m.name),\r\n geometries: this.assetsContext.geometries.map((m) => m.id),\r\n multiMaterials: this.assetsContext.multiMaterials.map((m) => m.id),\r\n transformNodes: this.assetsContext.transformNodes.map((m) => m.id),\r\n };\r\n }\r\n }\r\n\r\n /\r\n @returns the class name of the object.\r\n */\r\n public getClassName() {\r\n return \"FlowGraphContext\";\r\n }\r\n}\r\n"]}
1	+ {"version":3,"file":"flowGraphContext.js","sourceRoot":"","sources":["../../../../dev/core/src/FlowGraph/flowGraphContext.ts"],"names":[],"mappings":"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","sourcesContent":["import { serialize } from \"../Misc/decorators\";\r\nimport { RandomGUID } from \"../Misc/guid\";\r\nimport { type Scene } from \"../scene\";\r\nimport { type FlowGraphAsyncExecutionBlock } from \"./flowGraphAsyncExecutionBlock\";\r\nimport { type FlowGraphBlock } from \"./flowGraphBlock\";\r\nimport { type FlowGraphDataConnection } from \"./flowGraphDataConnection\";\r\nimport { type FlowGraph } from \"./flowGraph\";\r\nimport { defaultValueSerializationFunction } from \"./serialization\";\r\nimport { type FlowGraphCoordinator } from \"./flowGraphCoordinator\";\r\nimport { type FlowGraphSceneEventCoordinator } from \"./flowGraphSceneEventCoordinator\";\r\nimport { Observable } from \"../Misc/observable\";\r\nimport { type AssetType, type FlowGraphAssetType, GetFlowGraphAssetWithType } from \"./flowGraphAssetsContext\";\r\nimport { type IAssetContainer } from \"core/IAssetContainer\";\r\nimport { type Nullable } from \"core/types\";\r\nimport { FlowGraphAction, FlowGraphLogger } from \"./flowGraphLogger\";\r\nimport { type IFlowGraphOnTickEventPayload } from \"./Blocks/Event/flowGraphSceneTickEventBlock\";\r\nimport { type FlowGraphExecutionBlock } from \"./flowGraphExecutionBlock\";\r\nimport { type FlowGraphSignalConnection } from \"./flowGraphSignalConnection\";\r\n\r\n/*\r\n Represents a pending signal activation that was paused by a breakpoint.\r\n /\r\nexport interface IFlowGraphPendingActivation {\r\n /* The block that was about to execute /\r\n readonly block: FlowGraphExecutionBlock;\r\n /* The context in which execution was paused /\r\n readonly context: FlowGraphContext;\r\n /* The signal connection that triggered the execution /\r\n readonly signal: FlowGraphSignalConnection;\r\n}\r\n/\r\n Construction parameters for the context.\r\n /\r\nexport interface IFlowGraphContextConfiguration {\r\n /\r\n The scene that the flow graph context belongs to.\r\n /\r\n readonly scene: Scene;\r\n /\r\n The event coordinator used by the flow graph context.\r\n /\r\n readonly coordinator: FlowGraphCoordinator;\r\n\r\n /\r\n The scene event coordinator that tracks runtime event state\r\n * (e.g. currently pressed keyboard keys).\r\n * When not provided, keyboard polling blocks (e.g. IsKeyPressed) will\r\n * report no keys pressed.\r\n /\r\n readonly sceneEventCoordinator?: FlowGraphSceneEventCoordinator;\r\n\r\n /\r\n The assets context used by the flow graph context.\r\n * If none is provided, a default one will be created.\r\n /\r\n readonly assetsContext?: IAssetContainer;\r\n}\r\n\r\n/\r\n Options for parsing a context.\r\n /\r\nexport interface IFlowGraphContextParseOptions {\r\n /\r\n A function that parses a value from a serialization object.\r\n * @param key the key of the value\r\n * @param serializationObject the object containing the value\r\n * @param assetsContainer the assets container\r\n * @param scene the current scene\r\n * @returns\r\n /\r\n readonly valueParseFunction?: (key: string, serializationObject: any, assetsContainer: IAssetContainer, scene: Scene) => any;\r\n /\r\n The graph that the context is being parsed in.\r\n /\r\n readonly graph: FlowGraph;\r\n}\r\n/\r\n The context represents the current state and execution of the flow graph.\r\n * It contains both user-defined variables, which are derived from\r\n * a more general variable definition, and execution variables that\r\n * are set by the blocks.\r\n /\r\nexport class FlowGraphContext {\r\n /\r\n A randomly generated GUID for each context.\r\n /\r\n @serialize()\r\n public uniqueId = RandomGUID();\r\n /\r\n An optional user-facing name for the context.\r\n * Defaults to an empty string; the editor may assign a label like \"Context 0\".\r\n /\r\n @serialize()\r\n public name: string = \"\";\r\n /\r\n These are the variables defined by a user.\r\n /\r\n private _userVariables: { [key: string]: any } = {};\r\n /\r\n Optional type annotations for user variables.\r\n * Keys are variable names; values are type name strings (e.g. \"number\", \"Vector3\", \"Mesh\").\r\n * This map is maintained by the editor and persisted through serialization so\r\n * that a variable's declared type survives even when its value is undefined.\r\n /\r\n private _variableTypes: { [key: string]: string } = {};\r\n /\r\n These are the variables set by the blocks.\r\n /\r\n private _executionVariables: { [key: string]: any } = {};\r\n\r\n /\r\n A context-specific global variables, available to all blocks in the context.\r\n /\r\n private _globalContextVariables: { [key: string]: any } = {};\r\n /\r\n These are the values for the data connection points\r\n /\r\n private _connectionValues: { [key: string]: any } = {};\r\n /\r\n These are the variables set by the graph.\r\n /\r\n private readonly _configuration: IFlowGraphContextConfiguration;\r\n /\r\n These are blocks that have currently pending tasks/listeners that need to be cleaned up.\r\n /\r\n private _pendingBlocks: FlowGraphAsyncExecutionBlock[] = [];\r\n /\r\n A monotonically increasing ID for each execution.\r\n * Incremented for every block executed.\r\n /\r\n private _executionId = 0;\r\n /\r\n Observable that is triggered when a node is executed.\r\n /\r\n public onNodeExecutedObservable: Observable<FlowGraphBlock> = new Observable<FlowGraphBlock>();\r\n\r\n /\r\n Observable triggered when a breakpoint is hit.\r\n * Observers receive the pending activation (block, context, signal) that was paused.\r\n /\r\n public onBreakpointHitObservable: Observable<IFlowGraphPendingActivation> = new Observable<IFlowGraphPendingActivation>();\r\n\r\n /\r\n A predicate called before each execution block runs.\r\n * If it returns true, execution is paused before the block and a\r\n * pending activation is stored, which can be resumed via\r\n * {@link continueExecution} or {@link stepExecution}.\r\n \r\n Set to `null` to disable breakpoint checking.\r\n /\r\n public breakpointPredicate: Nullable<(block: FlowGraphExecutionBlock) => boolean> = null;\r\n\r\n /\r\n The activation that is currently paused due to a breakpoint hit.\r\n * `null` when execution is not paused on a breakpoint.\r\n /\r\n private _pendingActivation: Nullable<IFlowGraphPendingActivation> = null;\r\n\r\n /\r\n When true, the next activation will pause regardless of the breakpoint predicate.\r\n * Set by {@link stepExecution}.\r\n /\r\n private _stepMode: boolean = false;\r\n\r\n /\r\n When set, the breakpoint check is skipped for this specific block uniqueId\r\n * on the very next call to {@link _shouldBreak}. Used by continue/step to avoid\r\n * immediately re-hitting the breakpoint on the block being resumed.\r\n /\r\n private _skipBreakpointForBlockId: Nullable<string> = null;\r\n\r\n /\r\n The assets context used by the flow graph context.\r\n * Note that it can be shared between flow graph contexts.\r\n /\r\n public assetsContext: IAssetContainer;\r\n\r\n /\r\n Whether to treat data as right-handed.\r\n * This is used when serializing data from a right-handed system, while running the context in a left-handed system, for example in glTF parsing.\r\n * Default is false.\r\n /\r\n public treatDataAsRightHanded = false;\r\n\r\n private _enableLogging = false;\r\n\r\n /\r\n The logger used by the context to log actions.\r\n /\r\n public logger: Nullable<FlowGraphLogger>;\r\n\r\n /\r\n Enable logging on this context\r\n /\r\n public get enableLogging() {\r\n return this._enableLogging;\r\n }\r\n\r\n public set enableLogging(value: boolean) {\r\n if (this._enableLogging === value) {\r\n return;\r\n }\r\n this._enableLogging = value;\r\n if (this._enableLogging) {\r\n this.logger = new FlowGraphLogger();\r\n this.logger.logToConsole = true;\r\n } else {\r\n this.logger = null;\r\n }\r\n }\r\n\r\n constructor(params: IFlowGraphContextConfiguration) {\r\n this._configuration = params;\r\n this.assetsContext = params.assetsContext ?? params.scene;\r\n }\r\n\r\n /\r\n Check if a user-defined variable is defined.\r\n * @param name the name of the variable\r\n * @returns true if the variable is defined\r\n /\r\n public hasVariable(name: string) {\r\n return name in this._userVariables;\r\n }\r\n\r\n /\r\n Set a user-defined variable.\r\n * @param name the name of the variable\r\n * @param value the value of the variable\r\n /\r\n public setVariable(name: string, value: any) {\r\n this._userVariables[name] = value;\r\n this.logger?.addLogItem({\r\n time: Date.now(),\r\n className: this.getClassName(),\r\n uniqueId: this.uniqueId,\r\n action: FlowGraphAction.ContextVariableSet,\r\n payload: {\r\n name,\r\n value,\r\n },\r\n });\r\n }\r\n\r\n /\r\n Get an assets from the assets context based on its type and index in the array\r\n * @param type The type of the asset\r\n * @param index The index of the asset\r\n * @returns The asset or null if not found\r\n /\r\n public getAsset<T extends FlowGraphAssetType>(type: T, index: number): Nullable<AssetType<T>> {\r\n return GetFlowGraphAssetWithType(this.assetsContext, type, index);\r\n }\r\n\r\n /\r\n Get a user-defined variable.\r\n * @param name the name of the variable\r\n * @returns the value of the variable\r\n /\r\n public getVariable(name: string): any {\r\n this.logger?.addLogItem({\r\n time: Date.now(),\r\n className: this.getClassName(),\r\n uniqueId: this.uniqueId,\r\n action: FlowGraphAction.ContextVariableGet,\r\n payload: {\r\n name,\r\n value: this._userVariables[name],\r\n },\r\n });\r\n return this._userVariables[name];\r\n }\r\n\r\n /\r\n Gets all user variables map\r\n /\r\n public get userVariables() {\r\n return this._userVariables;\r\n }\r\n\r\n /\r\n Set the declared type annotation for a user variable.\r\n * @param name - the variable name\r\n * @param typeName - the type name string (e.g. \"number\", \"Vector3\", \"Mesh\")\r\n /\r\n public setVariableType(name: string, typeName: string): void {\r\n this._variableTypes[name] = typeName;\r\n }\r\n\r\n /\r\n Get the declared type annotation for a user variable.\r\n * @param name - the variable name\r\n * @returns the type name string, or undefined if no type was declared\r\n /\r\n public getVariableType(name: string): string \| undefined {\r\n return this._variableTypes[name];\r\n }\r\n\r\n /\r\n Gets all variable type annotations.\r\n /\r\n public get variableTypes(): { [key: string]: string } {\r\n return this._variableTypes;\r\n }\r\n\r\n /\r\n Get the scene that the context belongs to.\r\n * @returns the scene\r\n /\r\n public getScene() {\r\n return this._configuration.scene;\r\n }\r\n\r\n /\r\n Encodes an event source key as the opaque reference exposed by event blocks on their `event`\r\n * output. Delegates to the {@link IFlowGraphHostResolver} configured on the coordinator, so the\r\n * reference format is owned by the environment hosting the graph.\r\n * @param key the event source key (e.g. `\"sceneReady\"`, `\"sceneTick\"`, or a custom event id)\r\n * @returns the event reference\r\n /\r\n public getEventReference(key: string): string {\r\n return this._configuration.coordinator._getEventReference(key);\r\n }\r\n\r\n /\r\n Decodes the array index denoted by a reference. Returns `undefined` when no host resolver is\r\n * configured or the host does not recognise the value as an indexed reference.\r\n * @param reference the reference to decode\r\n * @returns the index the reference denotes, or `undefined` when it does not denote one\r\n /\r\n public decodeIndexReference(reference: string): number \| undefined {\r\n return this._configuration.coordinator.config.hostResolver?.decodeIndexReference?.(reference);\r\n }\r\n\r\n /\r\n Maps a runtime object to the reference the host addresses it by. Returns `undefined` when no\r\n * host resolver is configured or the host cannot address the object.\r\n * @param object the runtime object to address\r\n * @param hint optional disambiguation hint telling the host which kind of reference is wanted\r\n * @returns the reference for the object, or `undefined` when it cannot be addressed\r\n /\r\n public getObjectReference(object: object, hint?: string): string \| undefined {\r\n return this._configuration.coordinator.config.hostResolver?.getObjectReference?.(object, hint);\r\n }\r\n\r\n private _getUniqueIdPrefixedName(obj: FlowGraphBlock, name: string): string {\r\n return `${obj.uniqueId}_${name}`;\r\n }\r\n\r\n /\r\n @internal\r\n * @param name name of the variable\r\n * @param defaultValue default value to return if the variable is not defined\r\n * @returns the variable value or the default value if the variable is not defined\r\n /\r\n public _getGlobalContextVariable<T>(name: string, defaultValue: T): T {\r\n this.logger?.addLogItem({\r\n time: Date.now(),\r\n className: this.getClassName(),\r\n uniqueId: this.uniqueId,\r\n action: FlowGraphAction.GlobalVariableGet,\r\n payload: {\r\n name,\r\n defaultValue,\r\n possibleValue: this._globalContextVariables[name],\r\n },\r\n });\r\n if (this._hasGlobalContextVariable(name)) {\r\n return this._globalContextVariables[name];\r\n } else {\r\n return defaultValue;\r\n }\r\n }\r\n\r\n /\r\n Set a global context variable\r\n * @internal\r\n * @param name the name of the variable\r\n * @param value the value of the variable\r\n /\r\n public _setGlobalContextVariable<T>(name: string, value: T) {\r\n this.logger?.addLogItem({\r\n time: Date.now(),\r\n className: this.getClassName(),\r\n uniqueId: this.uniqueId,\r\n action: FlowGraphAction.GlobalVariableSet,\r\n payload: { name, value },\r\n });\r\n this._globalContextVariables[name] = value;\r\n }\r\n\r\n /\r\n Delete a global context variable\r\n * @internal\r\n * @param name the name of the variable\r\n /\r\n public _deleteGlobalContextVariable(name: string) {\r\n this.logger?.addLogItem({\r\n time: Date.now(),\r\n className: this.getClassName(),\r\n uniqueId: this.uniqueId,\r\n action: FlowGraphAction.GlobalVariableDelete,\r\n payload: { name },\r\n });\r\n delete this._globalContextVariables[name];\r\n }\r\n\r\n /\r\n Check if a global context variable is defined\r\n * @internal\r\n * @param name the name of the variable\r\n * @returns true if the variable is defined\r\n /\r\n public _hasGlobalContextVariable(name: string) {\r\n return name in this._globalContextVariables;\r\n }\r\n\r\n /\r\n Set an internal execution variable\r\n * @internal\r\n * @param name\r\n * @param value\r\n /\r\n public _setExecutionVariable(block: FlowGraphBlock, name: string, value: any) {\r\n this._executionVariables[this._getUniqueIdPrefixedName(block, name)] = value;\r\n }\r\n\r\n /\r\n Get an internal execution variable\r\n * @internal\r\n * @param name\r\n * @returns\r\n /\r\n public _getExecutionVariable<T>(block: FlowGraphBlock, name: string, defaultValue: T): T {\r\n if (this._hasExecutionVariable(block, name)) {\r\n return this._executionVariables[this._getUniqueIdPrefixedName(block, name)];\r\n } else {\r\n return defaultValue;\r\n }\r\n }\r\n\r\n /\r\n Delete an internal execution variable\r\n * @internal\r\n * @param block\r\n * @param name\r\n /\r\n public _deleteExecutionVariable(block: FlowGraphBlock, name: string) {\r\n delete this._executionVariables[this._getUniqueIdPrefixedName(block, name)];\r\n }\r\n\r\n /\r\n Check if an internal execution variable is defined\r\n * @internal\r\n * @param block\r\n * @param name\r\n * @returns\r\n /\r\n public _hasExecutionVariable(block: FlowGraphBlock, name: string) {\r\n return this._getUniqueIdPrefixedName(block, name) in this._executionVariables;\r\n }\r\n\r\n /\r\n Check if a connection value is defined\r\n * @internal\r\n * @param connectionPoint\r\n * @returns\r\n /\r\n public _hasConnectionValue(connectionPoint: FlowGraphDataConnection<any>) {\r\n return connectionPoint.uniqueId in this._connectionValues;\r\n }\r\n\r\n /\r\n Set a connection value\r\n * @internal\r\n * @param connectionPoint\r\n * @param value\r\n /\r\n public _setConnectionValue<T>(connectionPoint: FlowGraphDataConnection<T>, value: T) {\r\n this._connectionValues[connectionPoint.uniqueId] = value;\r\n this.logger?.addLogItem({\r\n time: Date.now(),\r\n className: this.getClassName(),\r\n uniqueId: this.uniqueId,\r\n action: FlowGraphAction.SetConnectionValue,\r\n payload: {\r\n connectionPointId: connectionPoint.uniqueId,\r\n value,\r\n },\r\n });\r\n }\r\n\r\n /\r\n Set a connection value by key\r\n * @internal\r\n * @param key the key of the connection value\r\n * @param value the value of the connection\r\n /\r\n public _setConnectionValueByKey<T>(key: string, value: T) {\r\n this._connectionValues[key] = value;\r\n }\r\n\r\n /\r\n Get a connection value\r\n * @internal\r\n * @param connectionPoint\r\n * @returns\r\n /\r\n public _getConnectionValue<T>(connectionPoint: FlowGraphDataConnection<T>): T {\r\n this.logger?.addLogItem({\r\n time: Date.now(),\r\n className: this.getClassName(),\r\n uniqueId: this.uniqueId,\r\n action: FlowGraphAction.GetConnectionValue,\r\n payload: {\r\n connectionPointId: connectionPoint.uniqueId,\r\n value: this._connectionValues[connectionPoint.uniqueId],\r\n },\r\n });\r\n return this._connectionValues[connectionPoint.uniqueId];\r\n }\r\n\r\n /\r\n Get the configuration\r\n * @internal\r\n * @param name\r\n * @param value\r\n /\r\n public get configuration() {\r\n return this._configuration;\r\n }\r\n\r\n /\r\n Check if there are any pending blocks in this context\r\n * @returns true if there are pending blocks\r\n /\r\n public get hasPendingBlocks() {\r\n return this._pendingBlocks.length > 0;\r\n }\r\n\r\n /\r\n Add a block to the list of blocks that have pending tasks.\r\n * @internal\r\n * @param block\r\n /\r\n public _addPendingBlock(block: FlowGraphAsyncExecutionBlock) {\r\n // check if block is already in the array\r\n if (this._pendingBlocks.includes(block)) {\r\n return;\r\n }\r\n this._pendingBlocks.push(block);\r\n // sort pending blocks by priority\r\n this._pendingBlocks.sort((a, b) => a.priority - b.priority);\r\n }\r\n\r\n /\r\n Remove a block from the list of blocks that have pending tasks.\r\n * @internal\r\n * @param block\r\n /\r\n public _removePendingBlock(block: FlowGraphAsyncExecutionBlock) {\r\n const index = this._pendingBlocks.indexOf(block);\r\n if (index !== -1) {\r\n this._pendingBlocks.splice(index, 1);\r\n }\r\n }\r\n\r\n /\r\n Clear all pending blocks.\r\n * @internal\r\n /\r\n public _clearPendingBlocks() {\r\n for (const block of this._pendingBlocks) {\r\n block._cancelPendingTasks(this);\r\n }\r\n this._pendingBlocks.length = 0;\r\n }\r\n\r\n /\r\n @internal\r\n * Function that notifies the node executed observable\r\n * @param node\r\n /\r\n public _notifyExecuteNode(node: FlowGraphBlock) {\r\n this.onNodeExecutedObservable.notifyObservers(node);\r\n this.logger?.addLogItem({\r\n time: Date.now(),\r\n className: node.getClassName(),\r\n uniqueId: node.uniqueId,\r\n action: FlowGraphAction.ExecuteBlock,\r\n });\r\n }\r\n\r\n public _notifyOnTick(framePayload: IFlowGraphOnTickEventPayload) {\r\n // set the values as global variables\r\n this._setGlobalContextVariable(\"timeSinceStart\", framePayload.timeSinceStart);\r\n this._setGlobalContextVariable(\"deltaTime\", framePayload.deltaTime);\r\n // iterate the pending blocks and run each one's onFrame function\r\n for (const block of this._pendingBlocks) {\r\n block._executeOnTick?.(this);\r\n }\r\n }\r\n\r\n /\r\n @internal\r\n /\r\n public _increaseExecutionId() {\r\n this._executionId++;\r\n }\r\n /\r\n A monotonically increasing ID for each execution.\r\n * Incremented for every block executed.\r\n /\r\n public get executionId() {\r\n return this._executionId;\r\n }\r\n\r\n // ── Breakpoint API ─────────────────────────────────────────────────\r\n\r\n /\r\n Check whether the given block should break before executing.\r\n * Called by the signal connection infrastructure.\r\n * @internal\r\n * @param block the block about to execute\r\n * @param signal the signal that is triggering the execution\r\n * @returns true if execution should be paused (breakpoint hit)\r\n /\r\n public _shouldBreak(block: FlowGraphExecutionBlock, signal: FlowGraphSignalConnection): boolean {\r\n // If continue/step just resumed this specific block, let it through\r\n if (this._skipBreakpointForBlockId === block.uniqueId) {\r\n this._skipBreakpointForBlockId = null;\r\n return false;\r\n }\r\n\r\n // If already paused on a breakpoint, silently block further execution\r\n // without overwriting the pending activation or re-notifying observers.\r\n if (this._pendingActivation) {\r\n return true;\r\n }\r\n\r\n if (this._stepMode) {\r\n this._stepMode = false;\r\n this._pendingActivation = { block, context: this, signal };\r\n this.onBreakpointHitObservable.notifyObservers(this._pendingActivation);\r\n return true;\r\n }\r\n if (this.breakpointPredicate && this.breakpointPredicate(block)) {\r\n this._pendingActivation = { block, context: this, signal };\r\n this.onBreakpointHitObservable.notifyObservers(this._pendingActivation);\r\n return true;\r\n }\r\n return false;\r\n }\r\n\r\n /\r\n Returns the currently paused activation, or null if not paused.\r\n /\r\n public get pendingActivation(): Nullable<IFlowGraphPendingActivation> {\r\n return this._pendingActivation;\r\n }\r\n\r\n /\r\n Resume execution from a breakpoint hit.\r\n * The paused block and all downstream blocks will execute normally until\r\n * the next breakpoint (if any) is hit.\r\n /\r\n public continueExecution(): void {\r\n const pending = this._pendingActivation;\r\n if (!pending) {\r\n return;\r\n }\r\n this._pendingActivation = null;\r\n // Tell _shouldBreak to skip the breakpoint for this block on re-entry\r\n this._skipBreakpointForBlockId = pending.block.uniqueId;\r\n pending.signal._activateSignal(this);\r\n // Clear in case no re-entry happened (shouldn't linger)\r\n this._skipBreakpointForBlockId = null;\r\n }\r\n\r\n /\r\n Execute exactly the paused block and then pause again before the next\r\n * execution block fires. If no activation is pending, this is a no-op.\r\n /\r\n public stepExecution(): void {\r\n const pending = this._pendingActivation;\r\n if (!pending) {\r\n return;\r\n }\r\n this._pendingActivation = null;\r\n // Enable step mode so the very next input-signal activation will pause\r\n this._stepMode = true;\r\n // Tell _shouldBreak to skip the breakpoint for this block on re-entry\r\n this._skipBreakpointForBlockId = pending.block.uniqueId;\r\n pending.signal._activateSignal(this);\r\n // If nothing further executed (end of chain), clear step mode\r\n this._stepMode = false;\r\n this._skipBreakpointForBlockId = null;\r\n }\r\n\r\n /\r\n Discard any pending breakpoint activation without resuming.\r\n * Used when stopping or resetting the graph.\r\n * @internal\r\n /\r\n public _clearPendingActivation(): void {\r\n this._pendingActivation = null;\r\n this._stepMode = false;\r\n this._skipBreakpointForBlockId = null;\r\n }\r\n\r\n /\r\n Serializes a context\r\n * @param serializationObject the object to write the values in\r\n * @param valueSerializationFunction a function to serialize complex values\r\n /\r\n public serialize(serializationObject: any = {}, valueSerializationFunction: (key: string, value: any, serializationObject: any) => void = defaultValueSerializationFunction) {\r\n serializationObject.uniqueId = this.uniqueId;\r\n serializationObject.name = this.name;\r\n serializationObject._userVariables = {};\r\n for (const key in this._userVariables) {\r\n valueSerializationFunction(key, this._userVariables[key], serializationObject._userVariables);\r\n }\r\n // Persist variable type annotations (editor metadata)\r\n if (Object.keys(this._variableTypes).length > 0) {\r\n serializationObject._variableTypes = { ...this._variableTypes };\r\n }\r\n serializationObject._connectionValues = {};\r\n for (const key in this._connectionValues) {\r\n valueSerializationFunction(key, this._connectionValues[key], serializationObject._connectionValues);\r\n }\r\n // serialize assets context, if not scene\r\n if (this.assetsContext !== this.getScene()) {\r\n serializationObject._assetsContext = {\r\n meshes: this.assetsContext.meshes.map((m) => m.id),\r\n materials: this.assetsContext.materials.map((m) => m.id),\r\n textures: this.assetsContext.textures.map((m) => m.name),\r\n animations: this.assetsContext.animations.map((m) => m.name),\r\n lights: this.assetsContext.lights.map((m) => m.id),\r\n cameras: this.assetsContext.cameras.map((m) => m.id),\r\n sounds: this.assetsContext.sounds?.map((m) => m.name),\r\n skeletons: this.assetsContext.skeletons.map((m) => m.id),\r\n particleSystems: this.assetsContext.particleSystems.map((m) => m.name),\r\n geometries: this.assetsContext.geometries.map((m) => m.id),\r\n multiMaterials: this.assetsContext.multiMaterials.map((m) => m.id),\r\n transformNodes: this.assetsContext.transformNodes.map((m) => m.id),\r\n };\r\n }\r\n }\r\n\r\n /\r\n @returns the class name of the object.\r\n */\r\n public getClassName() {\r\n return \"FlowGraphContext\";\r\n }\r\n}\r\n"]}

package/FlowGraph/flowGraphCoordinator.d.ts CHANGED Viewed

@@ -1,9 +1,10 @@
-import { type IReadonlyObservable, Observable } from "../Misc/observable.js";
+import { type EventState, type IReadonlyObservable, Observable } from "../Misc/observable.js";
 import { type Scene } from "../scene.js";
 import { FlowGraph } from "./flowGraph.js";
 import { type IPathToObjectConverter } from "../ObjectModel/objectModelInterfaces.js";
 import { type IObjectAccessor } from "./typeDefinitions.js";
 import { type IAssetContainer } from "../IAssetContainer.js";
+import { type IFlowGraphHostResolver } from "./flowGraphHostResolver.js";
 /**
  * Parameters used to create a flow graph engine.
  */
@@ -12,6 +13,11 @@ export interface IFlowGraphCoordinatorConfiguration {
      * The scene that the flow graph engine belongs to.
      */
     scene: Scene;
+    /**
+     * Optional resolver letting the environment hosting the graphs decide how runtime entities are
+     * represented as opaque reference values. When omitted, a neutral built-in representation is used.
+     */
+    hostResolver?: IFlowGraphHostResolver;
 }
 /**
  * Parameters used to parse a flow graph coordinator.
@@ -84,6 +90,18 @@ export declare class FlowGraphCoordinator {
     private _onBeforeRenderObserver;
     private _executeOnNextFrame;
     private _eventUniqueId;
+    /**
+     * Stack of custom-event dispatches currently in progress. Each entry pairs the
+     * dispatched event id with the Observable's EventState so that
+     * `event/stopPropagation` can stop the remaining handlers of an in-flight
+     * dispatch. A stack (rather than a single value) tolerates re-entrant
+     * dispatching, e.g. an event handler synchronously sending another event.
+     * @internal
+     */
+    _eventDispatchStack: {
+        eventId: string;
+        state: EventState;
+    }[];
     constructor(
     /**
      * the configuration of the block
@@ -131,4 +149,43 @@ export declare class FlowGraphCoordinator {
      * @param async if true, the event will be dispatched asynchronously
      */
     notifyCustomEvent(id: string, data: any, async?: boolean): void;
+    /**
+     * @internal
+     * Marks the beginning of a custom-event dispatch. Called by event receiver
+     * blocks from within their Observable callback so that the dispatch's
+     * EventState becomes reachable by `event/stopPropagation` while the receiver
+     * flow executes synchronously.
+     * @param eventId the id of the event being dispatched
+     * @param state the Observable EventState for this dispatch
+     */
+    _beginEventDispatch(eventId: string, state: EventState): void;
+    /**
+     * @internal
+     * Marks the end of the most recent custom-event dispatch started with
+     * {@link _beginEventDispatch}.
+     */
+    _endEventDispatch(): void;
+    /**
+     * Stops the propagation of an in-flight custom event, preventing any event
+     * handler nodes that have not been activated yet from running for the current
+     * dispatch.
+     *
+     * The `event` argument is the opaque event reference produced by an event block on its `event`
+     * output. If it does not reference an event that is currently being dispatched, this is a no-op.
+     *
+     * Babylon custom events have no scene-graph propagation layer, so there are
+     * no transitive activations to cancel when `stopImmediate` is false. When it
+     * is true, the remaining handlers in the Observable dispatch are skipped.
+     * @param event the event reference to stop propagation for
+     * @param stopImmediate whether to also stop remaining immediate handlers
+     */
+    stopEventPropagation(event: string, stopImmediate: boolean): void;
+    /**
+     * @internal
+     * Encodes an event source key as the opaque reference exposed on an event block's `event`
+     * output, delegating to the host resolver when one is configured.
+     * @param key the event source key
+     * @returns the event reference
+     */
+    _getEventReference(key: string): string;
 }

package/FlowGraph/flowGraphCoordinator.js CHANGED Viewed

@@ -1,6 +1,7 @@
 import { Observable } from "../Misc/observable.js";
 import { FlowGraph } from "./flowGraph.js";
 import { Logger } from "../Misc/logger.js";
+import { GetDefaultEventReferenceKey, GetDefaultEventReference } from "./flowGraphHostResolver.js";
 /**
  * This class holds all of the existing flow graphs and is responsible for creating new ones.
  * It also handles starting/stopping multiple graphs and communication between them through an Event Coordinator
@@ -38,6 +39,15 @@ export class FlowGraphCoordinator {
         this._eventExecutionCounter = new Map();
         this._executeOnNextFrame = [];
         this._eventUniqueId = 0;
+        /**
+         * Stack of custom-event dispatches currently in progress. Each entry pairs the
+         * dispatched event id with the Observable's EventState so that
+         * `event/stopPropagation` can stop the remaining handlers of an in-flight
+         * dispatch. A stack (rather than a single value) tolerates re-entrant
+         * dispatching, e.g. an event handler synchronously sending another event.
+         * @internal
+         */
+        this._eventDispatchStack = [];
         // When the scene is disposed, dispose all graphs currently running on it.
         this._disposeObserver = this.config.scene.onDisposeObservable.add(() => {
             this.dispose();
@@ -181,6 +191,68 @@ export class FlowGraphCoordinator {
             observable.notifyObservers(data);
         }
     }
+    /**
+     * @internal
+     * Marks the beginning of a custom-event dispatch. Called by event receiver
+     * blocks from within their Observable callback so that the dispatch's
+     * EventState becomes reachable by `event/stopPropagation` while the receiver
+     * flow executes synchronously.
+     * @param eventId the id of the event being dispatched
+     * @param state the Observable EventState for this dispatch
+     */
+    _beginEventDispatch(eventId, state) {
+        this._eventDispatchStack.push({ eventId, state });
+    }
+    /**
+     * @internal
+     * Marks the end of the most recent custom-event dispatch started with
+     * {@link _beginEventDispatch}.
+     */
+    _endEventDispatch() {
+        this._eventDispatchStack.pop();
+    }
+    /**
+     * Stops the propagation of an in-flight custom event, preventing any event
+     * handler nodes that have not been activated yet from running for the current
+     * dispatch.
+     *
+     * The `event` argument is the opaque event reference produced by an event block on its `event`
+     * output. If it does not reference an event that is currently being dispatched, this is a no-op.
+     *
+     * Babylon custom events have no scene-graph propagation layer, so there are
+     * no transitive activations to cancel when `stopImmediate` is false. When it
+     * is true, the remaining handlers in the Observable dispatch are skipped.
+     * @param event the event reference to stop propagation for
+     * @param stopImmediate whether to also stop remaining immediate handlers
+     */
+    stopEventPropagation(event, stopImmediate) {
+        if (typeof event !== "string" || !stopImmediate) {
+            return;
+        }
+        const decode = this.config.hostResolver?.decodeEventReference ?? GetDefaultEventReferenceKey;
+        const eventId = decode(event);
+        if (eventId === undefined) {
+            return;
+        }
+        // Find the most recent matching in-flight dispatch and skip its remaining observers.
+        for (let i = this._eventDispatchStack.length - 1; i >= 0; i--) {
+            if (this._eventDispatchStack[i].eventId === eventId) {
+                this._eventDispatchStack[i].state.skipNextObservers = true;
+                return;
+            }
+        }
+    }
+    /**
+     * @internal
+     * Encodes an event source key as the opaque reference exposed on an event block's `event`
+     * output, delegating to the host resolver when one is configured.
+     * @param key the event source key
+     * @returns the event reference
+     */
+    _getEventReference(key) {
+        const encode = this.config.hostResolver?.encodeEventReference;
+        return encode ? encode(key) : GetDefaultEventReference(key);
+    }
 }
 /**
  * The maximum number of events per type.

package/FlowGraph/flowGraphCoordinator.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"flowGraphCoordinator.js","sourceRoot":"","sources":["../../../../dev/core/src/FlowGraph/flowGraphCoordinator.ts"],"names":[],"mappings":"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","sourcesContent":["import { type Observer, type IReadonlyObservable, 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\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\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 public constructor(\r\n /\r\n the configuration of the block\r\n /\r\n public config: IFlowGraphCoordinatorConfiguration\r\n ) {\r\n // When the scene is disposed, dispose all graphs currently running on it.\r\n this._disposeObserver = this.config.scene.onDisposeObservable.add(() => {\r\n this.dispose();\r\n });\r\n\r\n this._onBeforeRenderObserver = this.config.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(this.config.scene);\r\n if (!coordinators) {\r\n coordinators = [];\r\n FlowGraphCoordinator.SceneCoordinators.set(this.config.scene, coordinators);\r\n }\r\n coordinators.push(this);\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._disposeObserver?.remove();\r\n this._onBeforeRenderObserver?.remove();\r\n\r\n // Remove itself from the SceneCoordinators list for the Inspector.\r\n const coordinators = FlowGraphCoordinator.SceneCoordinators.get(this.config.scene) ?? [];\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 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"]}
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 }[] = [];\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 // When the scene is disposed, dispose all graphs currently running on it.\r\n this._disposeObserver = this.config.scene.onDisposeObservable.add(() => {\r\n this.dispose();\r\n });\r\n\r\n this._onBeforeRenderObserver = this.config.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(this.config.scene);\r\n if (!coordinators) {\r\n coordinators = [];\r\n FlowGraphCoordinator.SceneCoordinators.set(this.config.scene, coordinators);\r\n }\r\n coordinators.push(this);\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._disposeObserver?.remove();\r\n this._onBeforeRenderObserver?.remove();\r\n\r\n // Remove itself from the SceneCoordinators list for the Inspector.\r\n const coordinators = FlowGraphCoordinator.SceneCoordinators.get(this.config.scene) ?? [];\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 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 });\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(): void {\r\n 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\" \|\| !stopImmediate) {\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].state.skipNextObservers = true;\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/flowGraphDelayRegistry.d.ts ADDED Viewed

@@ -0,0 +1,31 @@
+/**
+ * Tracking of the delays that are currently scheduled in a flow graph context.
+ *
+ * `flow/setDelay` produces a unique integer handle for every delayed activation it schedules.
+ * This module records which of those handles are still pending — i.e. scheduled and not yet fired
+ * or cancelled — per {@link FlowGraphContext}, so that a host can answer "is this delay handle
+ * still valid?" for a reference it was handed earlier.
+ */
+import { type FlowGraphContext } from "./flowGraphContext.js";
+/**
+ * Marks the given delay handle as active (scheduled and pending) in the context.
+ * Called by `flow/setDelay` when it schedules a new delayed activation.
+ * @param context the flow graph context owning the delay.
+ * @param index the unique delay handle produced by `flow/setDelay`.
+ */
+export declare function MarkDelayActive(context: FlowGraphContext, index: number): void;
+/**
+ * Marks the given delay handle as no longer active. Called when a delay fires, is cancelled via
+ * the `cancel` input, or is cancelled by `flow/cancelDelay`.
+ * @param context the flow graph context owning the delay.
+ * @param index the unique delay handle to clear.
+ */
+export declare function MarkDelayInactive(context: FlowGraphContext, index: number): void;
+/**
+ * Returns whether the given delay handle is currently active, i.e. scheduled and not yet fired or
+ * cancelled.
+ * @param context the flow graph context to query.
+ * @param index the delay handle to test.
+ * @returns true if the delay is currently scheduled and has not yet fired or been cancelled.
+ */
+export declare function IsDelayActive(context: FlowGraphContext, index: number): boolean;

package/FlowGraph/flowGraphDelayRegistry.js ADDED Viewed

@@ -0,0 +1,50 @@
+/**
+ * Tracking of the delays that are currently scheduled in a flow graph context.
+ *
+ * `flow/setDelay` produces a unique integer handle for every delayed activation it schedules.
+ * This module records which of those handles are still pending — i.e. scheduled and not yet fired
+ * or cancelled — per {@link FlowGraphContext}, so that a host can answer "is this delay handle
+ * still valid?" for a reference it was handed earlier.
+ */
+/**
+ * Name of the global context variable holding the set of active delay handles.
+ * @internal
+ */
+const ActiveDelayIndicesKey = "activeDelayIndices";
+function GetActiveDelaySet(context) {
+    let set = context._getGlobalContextVariable(ActiveDelayIndicesKey, null);
+    if (!set) {
+        set = new Set();
+        context._setGlobalContextVariable(ActiveDelayIndicesKey, set);
+    }
+    return set;
+}
+/**
+ * Marks the given delay handle as active (scheduled and pending) in the context.
+ * Called by `flow/setDelay` when it schedules a new delayed activation.
+ * @param context the flow graph context owning the delay.
+ * @param index the unique delay handle produced by `flow/setDelay`.
+ */
+export function MarkDelayActive(context, index) {
+    GetActiveDelaySet(context).add(index);
+}
+/**
+ * Marks the given delay handle as no longer active. Called when a delay fires, is cancelled via
+ * the `cancel` input, or is cancelled by `flow/cancelDelay`.
+ * @param context the flow graph context owning the delay.
+ * @param index the unique delay handle to clear.
+ */
+export function MarkDelayInactive(context, index) {
+    context._getGlobalContextVariable(ActiveDelayIndicesKey, null)?.delete(index);
+}
+/**
+ * Returns whether the given delay handle is currently active, i.e. scheduled and not yet fired or
+ * cancelled.
+ * @param context the flow graph context to query.
+ * @param index the delay handle to test.
+ * @returns true if the delay is currently scheduled and has not yet fired or been cancelled.
+ */
+export function IsDelayActive(context, index) {
+    return context._getGlobalContextVariable(ActiveDelayIndicesKey, null)?.has(index) ?? false;
+}
+//# sourceMappingURL=flowGraphDelayRegistry.js.map

package/FlowGraph/flowGraphDelayRegistry.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"flowGraphDelayRegistry.js","sourceRoot":"","sources":["../../../../dev/core/src/FlowGraph/flowGraphDelayRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;GAGG;AACH,MAAM,qBAAqB,GAAG,oBAAoB,CAAC;AAEnD,SAAS,iBAAiB,CAAC,OAAyB;IAChD,IAAI,GAAG,GAAG,OAAO,CAAC,yBAAyB,CAAqB,qBAAqB,EAAE,IAAI,CAAC,CAAC;IAC7F,IAAI,CAAC,GAAG,EAAE,CAAC;QACP,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;QACxB,OAAO,CAAC,yBAAyB,CAAC,qBAAqB,EAAE,GAAG,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAyB,EAAE,KAAa;IACpE,iBAAiB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAyB,EAAE,KAAa;IACtE,OAAO,CAAC,yBAAyB,CAAqB,qBAAqB,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;AACtG,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,OAAyB,EAAE,KAAa;IAClE,OAAO,OAAO,CAAC,yBAAyB,CAAqB,qBAAqB,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;AACnH,CAAC","sourcesContent":["/**\r\n * Tracking of the delays that are currently scheduled in a flow graph context.\r\n *\r\n * `flow/setDelay` produces a unique integer handle for every delayed activation it schedules.\r\n * This module records which of those handles are still pending — i.e. scheduled and not yet fired\r\n * or cancelled — per {@link FlowGraphContext}, so that a host can answer \"is this delay handle\r\n * still valid?\" for a reference it was handed earlier.\r\n */\r\n\r\nimport { type FlowGraphContext } from \"./flowGraphContext\";\r\n\r\n/**\r\n * Name of the global context variable holding the set of active delay handles.\r\n * @internal\r\n */\r\nconst ActiveDelayIndicesKey = \"activeDelayIndices\";\r\n\r\nfunction GetActiveDelaySet(context: FlowGraphContext): Set<number> {\r\n let set = context._getGlobalContextVariable<Set<number> | null>(ActiveDelayIndicesKey, null);\r\n if (!set) {\r\n set = new Set<number>();\r\n context._setGlobalContextVariable(ActiveDelayIndicesKey, set);\r\n }\r\n return set;\r\n}\r\n\r\n/**\r\n * Marks the given delay handle as active (scheduled and pending) in the context.\r\n * Called by `flow/setDelay` when it schedules a new delayed activation.\r\n * @param context the flow graph context owning the delay.\r\n * @param index the unique delay handle produced by `flow/setDelay`.\r\n */\r\nexport function MarkDelayActive(context: FlowGraphContext, index: number): void {\r\n GetActiveDelaySet(context).add(index);\r\n}\r\n\r\n/**\r\n * Marks the given delay handle as no longer active. Called when a delay fires, is cancelled via\r\n * the `cancel` input, or is cancelled by `flow/cancelDelay`.\r\n * @param context the flow graph context owning the delay.\r\n * @param index the unique delay handle to clear.\r\n */\r\nexport function MarkDelayInactive(context: FlowGraphContext, index: number): void {\r\n context._getGlobalContextVariable<Set<number> | null>(ActiveDelayIndicesKey, null)?.delete(index);\r\n}\r\n\r\n/**\r\n * Returns whether the given delay handle is currently active, i.e. scheduled and not yet fired or\r\n * cancelled.\r\n * @param context the flow graph context to query.\r\n * @param index the delay handle to test.\r\n * @returns true if the delay is currently scheduled and has not yet fired or been cancelled.\r\n */\r\nexport function IsDelayActive(context: FlowGraphContext, index: number): boolean {\r\n return context._getGlobalContextVariable<Set<number> | null>(ActiveDelayIndicesKey, null)?.has(index) ?? false;\r\n}\r\n"]}

package/FlowGraph/flowGraphHostResolver.d.ts ADDED Viewed

@@ -0,0 +1,69 @@
+/** This file must only contain pure code and pure imports */
+/**
+ * Prefix used by the default event-reference format.
+ *
+ * A host that maps behavior graphs onto its own object model (for example the glTF
+ * `KHR_interactivity` loader) supplies its own format through {@link IFlowGraphHostResolver}.
+ */
+export declare const FlowGraphDefaultEventReferencePrefix = "flowgraph://events/";
+/**
+ * Builds the default reference for an event source key.
+ * @param key the event source key (e.g. `"sceneReady"`, `"sceneTick"`, or a custom event id)
+ * @returns the event reference
+ */
+export declare function GetDefaultEventReference(key: string): string;
+/**
+ * Extracts the event source key from a default-format event reference.
+ * @param reference the value to decode
+ * @returns the event source key, or `undefined` when the value is not an event reference
+ */
+export declare function GetDefaultEventReferenceKey(reference: string): string | undefined;
+/**
+ * Lets the environment hosting a flow graph decide how runtime entities are represented as opaque
+ * reference values, so the graph engine itself stays agnostic of the host's object model.
+ *
+ * A host (e.g. a glTF loader extension) provides an implementation through
+ * {@link IFlowGraphCoordinatorConfiguration.hostResolver}. Every member is optional; the engine
+ * falls back to a neutral built-in representation for anything the host does not provide.
+ */
+export interface IFlowGraphHostResolver {
+    /**
+     * Encodes an event source key as the opaque reference exposed by event blocks on their
+     * `event` output.
+     *
+     * References must be stable: two calls with the same key must produce equal values so that
+     * equality comparisons of two `event` outputs of the same source succeed.
+     * @param key the event source key
+     * @returns the reference representing the event source
+     */
+    encodeEventReference?(key: string): string;
+    /**
+     * Decodes an event reference produced by {@link IFlowGraphHostResolver.encodeEventReference}
+     * back into its event source key. Must return `undefined` for values that are not event
+     * references.
+     * @param reference the reference to decode
+     * @returns the event source key, or `undefined` when the value is not an event reference
+     */
+    decodeEventReference?(reference: string): string | undefined;
+    /**
+     * Decodes the array index denoted by a reference, for cases where a reference addresses an
+     * element of one of the host's collections. Must return `undefined` for values the host does
+     * not recognise as an indexed reference.
+     * @param reference the reference to decode
+     * @returns the index the reference denotes, or `undefined` when it does not denote one
+     */
+    decodeIndexReference?(reference: string): number | undefined;
+    /**
+     * Maps a runtime object to the reference the host addresses it by, for example the JSON
+     * Pointer of the resource a loaded object originates from.
+     *
+     * Used when an object value is supplied to a templated path input. Returning `undefined`
+     * means the host cannot address the object, and the value is rejected.
+     * @param object the runtime object to address
+     * @param hint optional disambiguation hint, taken from the path segment preceding the template
+     * parameter being resolved. A single object may be addressable in several ways, and the hint
+     * tells the host which kind of reference the graph is asking for.
+     * @returns the reference for the object, or `undefined` when it cannot be addressed
+     */
+    getObjectReference?(object: object, hint?: string): string | undefined;
+}