@zephyr3d/scene 0.8.2 → 0.9.1

package/dist/scene/scene.js.map

@@ -1 +1 @@
-{"version":3,"file":"scene.js","sources":["../../src/scene/scene.ts"],"sourcesContent":["import type { Matrix4x4, Nullable } from '@zephyr3d/base';\r\nimport { Vector3, Vector4, Ray, DRef, DWeakRef, makeObservable, Disposable } from '@zephyr3d/base';\r\nimport { SceneNode } from './scene_node';\r\nimport { Octree } from './octree';\r\nimport { RaycastVisitor } from './raycast_visitor';\r\nimport { Environment } from './environment';\r\nimport type { GraphNode } from './graph_node';\r\nimport type { Camera } from '../camera/camera';\r\nimport { SceneRenderer } from '../render';\r\nimport type { Compositor } from '../posteffect';\r\nimport type { Metadata } from 'draco3d';\r\nimport { getDevice } from '../app/api';\r\nimport type { IRenderable } from '../app';\r\n\r\n/**\r\n * Represents a renderable world that manages scene graph, spatial indexing, and environment.\r\n *\r\n * Core responsibilities:\r\n * - Owns the root {@link SceneNode} and maintains a spatial {@link Octree} for culling/raycasting.\r\n * - Manages environment/lighting via {@link Environment}.\r\n * - Provides per-frame update queues (global and per-camera) for scene nodes.\r\n * - Offers utilities like ray construction and raycasting.\r\n * - Emits observable events: `update`, `startrender`, `endrender`.\r\n *\r\n * Performance notes:\r\n * - Octree placement is lazily synchronized on demand before reads (e.g., `octree`, `boundingBox`)\r\n *   and during per-frame updates.\r\n * - Update queues use weak references to avoid retaining disposed nodes.\r\n *\r\n * @public\r\n */\r\nexport class Scene\r\n  extends makeObservable(Disposable)<{\r\n    /** Dispatched once per frame before render-related work. */\r\n    update: [Scene];\r\n    /** Dispatched immediately before rendering begins for a camera. */\r\n    startrender: [Scene, Camera, Compositor];\r\n    /** Dispatched immediately after rendering finishes for a camera. */\r\n    endrender: [Scene, Camera, Compositor];\r\n  }>()\r\n  implements IRenderable\r\n{\r\n  /** @internal */\r\n  private static _nextId = 0;\r\n  /** @internal Scene name. */\r\n  protected _name: string;\r\n  /** @internal Root node reference. */\r\n  protected _rootNode: DRef<SceneNode>;\r\n  /** @internal Spatial index for placement/culling. */\r\n  protected _octree: Octree;\r\n  /**\r\n   * @internal Pending nodes whose placement in the octree must be updated.\r\n   * Populated by {@link Scene.invalidateNodePlacement} and drained by {@link Scene.updateNodePlacement}.\r\n   */\r\n  protected _nodePlaceList: Set<GraphNode>;\r\n  /** @internal Environment data (sky/light/IBL). */\r\n  protected _env: Environment;\r\n  /** @internal Frame counter that last updated this scene. */\r\n  protected _updateFrame: number;\r\n  /** @internal Unique scene ID. */\r\n  protected _id: number;\r\n  /** @internal One-shot per-frame update queue (runs before render). */\r\n  protected _nodeUpdateQueue: DWeakRef<SceneNode>[];\r\n  /** @internal One-shot per-frame-per-camera update queue. */\r\n  protected _perCameraUpdateQueue: DWeakRef<SceneNode>[];\r\n  /** @internal Main camera reference. */\r\n  protected _mainCamera: DRef<Camera>;\r\n  /** @internal Arbitrary metadata loaded with the scene (optional). */\r\n  protected _metaData: Nullable<Metadata>;\r\n  /** @internal User-attached script entry (engine-defined). */\r\n  private _script: string;\r\n  /**\r\n   * Creates an instance of Scene.\r\n   *\r\n   * Initializes:\r\n   * - Unique ID\r\n   * - Empty environment\r\n   * - Octree with default depth/leaf capacities\r\n   * - Root scene node named \"Root\"\r\n   *\r\n   * @param name - Optional scene name for diagnostics/UI.\r\n   */\r\n  constructor(name?: string) {\r\n    super();\r\n    this._id = ++Scene._nextId;\r\n    this._name = name ?? '';\r\n    this._octree = new Octree(this, 8, 8);\r\n    this._nodePlaceList = new Set();\r\n    this._nodeUpdateQueue = [];\r\n    this._perCameraUpdateQueue = [];\r\n    this._env = new Environment();\r\n    this._updateFrame = -1;\r\n    this._rootNode = new DRef();\r\n    this._rootNode.set(new SceneNode(this));\r\n    this._rootNode.get()!.name = 'Root';\r\n    this._metaData = null;\r\n    this._script = '';\r\n    this._mainCamera = new DRef();\r\n  }\r\n  /**\r\n   * Gets the unique identifier of the scene.\r\n   */\r\n  get id() {\r\n    return this._id;\r\n  }\r\n  /**\r\n   * Name of the scene\r\n   */\r\n  get name() {\r\n    return this._name;\r\n  }\r\n  set name(val: string) {\r\n    this._name = val ?? '';\r\n  }\r\n  /**\r\n   * Main camera used to render the scene by default.\r\n   */\r\n  get mainCamera() {\r\n    return this._mainCamera.get();\r\n  }\r\n  set mainCamera(camera) {\r\n    this._mainCamera.set(camera);\r\n  }\r\n  /**\r\n   * Gets the root scene node of the scene\r\n   */\r\n  get rootNode() {\r\n    return this._rootNode.get()!;\r\n  }\r\n  /**\r\n   * Gets the octree used for spatial organization and queries.\r\n   *\r\n   * Ensures pending node placements are synchronized before returning.\r\n   */\r\n  get octree() {\r\n    // Make sure the octree state is up to date\r\n    this.updateNodePlacement(this._octree, this._nodePlaceList);\r\n    return this._octree;\r\n  }\r\n  /**\r\n   * Gets the world-axis-aligned bounding box of the scene.\r\n   *\r\n   * Ensures pending node placements are synchronized before computing.\r\n   */\r\n  get boundingBox() {\r\n    this.updateNodePlacement(this._octree, this._nodePlaceList);\r\n    // this._syncBVChangedList();\r\n    return this._octree.getRootNode().getBoxLoosed();\r\n  }\r\n  /**\r\n   * The environment (sky, lights, IBL) of the scene.\r\n   */\r\n  get env() {\r\n    return this._env;\r\n  }\r\n  /**\r\n   * Arbitrary metadata associated with the scene (e.g., imported asset info).\r\n   */\r\n  get metaData() {\r\n    return this._metaData;\r\n  }\r\n  set metaData(val) {\r\n    this._metaData = val;\r\n  }\r\n  /**\r\n   * Attached script filename or identifier (engine-specific).\r\n   *\r\n   * @remarks\r\n   * Integrates with the engine’s scripting system if available.\r\n   */\r\n  get script() {\r\n    return this._script;\r\n  }\r\n  set script(fileName: string) {\r\n    this._script = fileName ?? '';\r\n  }\r\n  /**\r\n   * Finds a scene node by its persistent ID.\r\n   *\r\n   * @typeParam T - Expected node type.\r\n   * @param id - Persistent identifier to match against `SceneNode.persistentId`.\r\n   * @returns The first matching node, or `null` if not found.\r\n   */\r\n  findNodeById<T extends SceneNode>(id: string) {\r\n    return this._rootNode.get()!.findNodeById<T>(id);\r\n  }\r\n  /**\r\n   * Finds a scene node by name.\r\n   *\r\n   * If multiple nodes share the same name, returns the first match encountered\r\n   * during traversal.\r\n   *\r\n   * @typeParam T - Expected node type.\r\n   * @param name - Node name to match.\r\n   * @returns The first matching node, or `null` if not found.\r\n   *\r\n   * @remarks\r\n   * Names are not guaranteed unique. Prefer IDs for stable references.\r\n   */\r\n  findNodeByName<T extends SceneNode>(name: string) {\r\n    return this._rootNode.get()!.findNodeByName<T>(name);\r\n  }\r\n  /**\r\n   * Casts a ray into the scene and returns the closest intersection, if any.\r\n   *\r\n   * @param ray - The ray in world space.\r\n   * @param length - Maximum ray length. Defaults to `Infinity`.\r\n   * @returns Intersection info `{ target, dist, point }`, or `null` if no hit.\r\n   *\r\n   */\r\n  raycast(ray: Ray, length = Infinity) {\r\n    const raycastVisitor = new RaycastVisitor(ray, length);\r\n    this.octree.getRootNode().traverse(raycastVisitor);\r\n    return raycastVisitor.intersected\r\n      ? {\r\n          target: raycastVisitor.intersected,\r\n          dist: raycastVisitor.intersectedDist,\r\n          point: raycastVisitor.intersectedPoint\r\n        }\r\n      : null;\r\n  }\r\n  /**\r\n   * Constructs a world-space ray from a camera and a screen position.\r\n   *\r\n   * @param camera - Camera whose projection/view defines the ray.\r\n   * @param viewportWidth - Current viewport width in pixels.\r\n   * @param viewportHeight - Current viewport height in pixels.\r\n   * @param screenX - Screen-space x (pixels).\r\n   * @param screenY - Screen-space y (pixels).\r\n   * @param invModelMatrix - Optional inverse model matrix to transform the ray into local space.\r\n   * @returns The constructed Ray.\r\n   *\r\n   * @remarks\r\n   * Computes NDC from screen coordinates, unprojects using `invViewProjectionMatrix`,\r\n   * then forms a ray from the camera world position to the unprojected point.\r\n   * If `invModelMatrix` is provided, both origin and direction are transformed.\r\n   */\r\n  constructRay(\r\n    camera: Camera,\r\n    viewportWidth: number,\r\n    viewportHeight: number,\r\n    screenX: number,\r\n    screenY: number,\r\n    invModelMatrix?: Matrix4x4\r\n  ) {\r\n    const vClip = new Vector4((2 * screenX) / viewportWidth - 1, 1 - (2 * screenY) / viewportHeight, 1, 1);\r\n    const vWorld = camera.invViewProjectionMatrix.transform(vClip);\r\n    vWorld.scaleBy(1 / vWorld.w);\r\n    let vEye = camera.getWorldPosition();\r\n    let vDir = Vector3.sub(vWorld.xyz(), vEye).inplaceNormalize();\r\n    if (invModelMatrix) {\r\n      vEye = invModelMatrix.transformPointAffine(vEye);\r\n      vDir = invModelMatrix.transformVectorAffine(vDir);\r\n    }\r\n    return new Ray(vEye, vDir);\r\n  }\r\n  /**\r\n   * Queues a node for a one-shot update before the next render.\r\n   *\r\n   * The node's `update(frame, elapsedSeconds, deltaSeconds)` will be called\r\n   * during Scene.frameUpdate and then the node is removed from the queue.\r\n   *\r\n   * @param node - Node to schedule.\r\n   *\r\n   * @remarks\r\n   * - To update continuously each frame, call `queueUpdateNode(this)` from within the node's `update` method.\r\n   * - Duplicate scheduling within the same frame is prevented.\r\n   */\r\n  queueUpdateNode(node: SceneNode) {\r\n    if (node && this._nodeUpdateQueue.findIndex((val) => val.get() === node) < 0) {\r\n      this._nodeUpdateQueue.push(new DWeakRef(node));\r\n    }\r\n  }\r\n  /**\r\n   * Queues a node for a one-shot per-camera update before render.\r\n   *\r\n   * The node's `updatePerCamera(camera, elapsedSeconds, deltaSeconds)` will be\r\n   * called once for each camera during {@link Scene.frameUpdatePerCamera}, then removed.\r\n   *\r\n   * @param node - Node to schedule.\r\n   *\r\n   * @remarks\r\n   * - To run per-camera work continuously, re-queue from `updatePerCamera`.\r\n   * - Duplicate scheduling within the same frame is prevented.\r\n   */\r\n  queuePerCameraUpdateNode(node: SceneNode) {\r\n    if (node && this._perCameraUpdateQueue.findIndex((val) => val.get() === node) < 0) {\r\n      this._perCameraUpdateQueue.push(new DWeakRef(node));\r\n    }\r\n  }\r\n  /**\r\n   * Renders this scene using the `mainCamera`, if present.\r\n   *\r\n   * Equivalent to `mainCamera.render(this)` when `mainCamera` is set.\r\n   */\r\n  render() {\r\n    if (this.mainCamera) {\r\n      this.mainCamera.render(this);\r\n    }\r\n  }\r\n  /**\r\n   * Marks a graph node as needing placement update in the octree.\r\n   *\r\n   * Called by nodes when their transform/visibility/attachment changes in a way\r\n   * that affects spatial placement.\r\n   *\r\n   * @internal\r\n   */\r\n  invalidateNodePlacement(node: GraphNode) {\r\n    this._nodePlaceList.add(node);\r\n  }\r\n  /**\r\n   * Synchronizes environment light maps (IBL, SH/FB) with the sky as needed.\r\n   *\r\n   * Uses device capabilities to decide between Spherical Harmonics floating-point blending (SHFB)\r\n   * and classic SH textures, and lazily fills missing environment fields from the sky.\r\n   *\r\n   * @internal\r\n   */\r\n  private updateEnvLight() {\r\n    if (this.env.light.type === 'ibl') {\r\n      const useSHFB =\r\n        getDevice().type === 'webgl' || !getDevice().getDeviceCaps().framebufferCaps.supportFloatBlending;\r\n      if (!this.env.light.radianceMap) {\r\n        this.env.light.radianceMap = this.env.sky.radianceMap;\r\n      }\r\n      if (useSHFB && !this.env.light.irradianceSHFB) {\r\n        this.env.light.irradianceSHFB = this.env.sky.irradianceSHFB;\r\n      }\r\n      if (!useSHFB && !this.env.light.irradianceSH) {\r\n        this.env.light.irradianceSH = this.env.sky.irradianceSH;\r\n      }\r\n    }\r\n  }\r\n  /**\r\n   * Returns the renderer class used to render the scene.\r\n   *\r\n   * Override in subclasses to supply a custom renderer.\r\n   *\r\n   * @internal\r\n   */\r\n  getRenderer() {\r\n    return SceneRenderer;\r\n  }\r\n  /**\r\n   * Performs per-frame scene updates, once per device frame.\r\n   *\r\n   * Steps:\r\n   * - Ensure this runs only once per frame (via `frameInfo.frameCounter`).\r\n   * - Update environment light synchronization.\r\n   * - Dispatch `update` event.\r\n   * - Drain the one-shot node update queue and call `node.update(...)`.\r\n   * - Apply pending octree placement updates.\r\n   *\r\n   */\r\n  frameUpdate() {\r\n    const frameInfo = getDevice().frameInfo;\r\n    if (frameInfo.frameCounter !== this._updateFrame) {\r\n      this._updateFrame = frameInfo.frameCounter;\r\n      this.updateEnvLight();\r\n      this.dispatchEvent('update', this);\r\n      this.mainCamera?.updateController();\r\n      if (this._nodeUpdateQueue.length > 0) {\r\n        const elapsedInSeconds = frameInfo.elapsedOverall * 0.001;\r\n        const deltaInSeconds = frameInfo.elapsedFrame * 0.001;\r\n        const queue = this._nodeUpdateQueue;\r\n        this._nodeUpdateQueue = [];\r\n        while (queue.length > 0) {\r\n          const ref = queue.shift()!;\r\n          const node = ref.get();\r\n          if (node?.attached) {\r\n            node.update(frameInfo.frameCounter, elapsedInSeconds, deltaInSeconds);\r\n          }\r\n          ref.dispose();\r\n        }\r\n      }\r\n      this.updateNodePlacement(this._octree, this._nodePlaceList);\r\n    }\r\n  }\r\n  /**\r\n   * Performs per-camera scene updates for the current frame.\r\n   *\r\n   * Steps:\r\n   * - Drain the per-camera update queue and call `node.updatePerCamera(camera, ...)`.\r\n   * - Apply pending octree placement updates.\r\n   *\r\n   * @param camera - The camera being updated for.\r\n   */\r\n  frameUpdatePerCamera(camera: Camera) {\r\n    if (this._perCameraUpdateQueue.length > 0) {\r\n      const frameInfo = getDevice().frameInfo;\r\n      const elapsedInSeconds = frameInfo.elapsedOverall * 0.001;\r\n      const deltaInSeconds = frameInfo.elapsedFrame * 0.001;\r\n      const queue = this._perCameraUpdateQueue;\r\n      this._perCameraUpdateQueue = [];\r\n      while (queue.length > 0) {\r\n        const ref = queue.shift()!;\r\n        ref.get()?.updatePerCamera(camera, elapsedInSeconds, deltaInSeconds);\r\n        ref.dispose();\r\n      }\r\n    }\r\n    this.updateNodePlacement(this._octree, this._nodePlaceList);\r\n  }\r\n  /**\r\n   * Applies placement changes for nodes in `list` to the given `octree`.\r\n   *\r\n   * Rules:\r\n   * - If node is not disposed, attached, not hidden, and `placeToOctree` is true,\r\n   *   it is placed; otherwise removed.\r\n   * - Drains `list` until empty.\r\n   *\r\n   * @param octree - Target spatial index.\r\n   * @param list - Set of nodes awaiting placement evaluation.\r\n   */\r\n  updateNodePlacement(octree: Octree, list: Set<GraphNode>) {\r\n    function placeNode(node: GraphNode) {\r\n      if (!node.disposed && node.attached && !node.hidden && node.placeToOctree) {\r\n        octree.placeNode(node);\r\n      } else {\r\n        octree.removeNode(node);\r\n      }\r\n      list.delete(node);\r\n    }\r\n    if (list.size > 0) {\r\n      while (list.size > 0) {\r\n        const node = list.keys().next().value!;\r\n        if (octree) {\r\n          placeNode(node);\r\n        } else {\r\n          list.delete(node);\r\n        }\r\n      }\r\n    }\r\n  }\r\n  /**\r\n   * Disposes the scene and its owned resources.\r\n   *\r\n   * Disposes:\r\n   * - Environment\r\n   * - Root node (and, by extension, its hierarchy)\r\n   * - Main camera reference wrapper\r\n   *\r\n   */\r\n  protected onDispose() {\r\n    this._env.dispose();\r\n    this._rootNode.dispose();\r\n    this._mainCamera.dispose();\r\n  }\r\n}\r\n"],"names":["Scene","makeObservable","Disposable","_nextId","name","_id","_name","_octree","Octree","_nodePlaceList","Set","_nodeUpdateQueue","_perCameraUpdateQueue","_env","Environment","_updateFrame","_rootNode","DRef","set","SceneNode","get","_metaData","_script","_mainCamera","id","val","mainCamera","camera","rootNode","octree","updateNodePlacement","boundingBox","getRootNode","getBoxLoosed","env","metaData","script","fileName","findNodeById","findNodeByName","raycast","ray","length","Infinity","raycastVisitor","RaycastVisitor","traverse","intersected","target","dist","intersectedDist","point","intersectedPoint","constructRay","viewportWidth","viewportHeight","screenX","screenY","invModelMatrix","vClip","Vector4","vWorld","invViewProjectionMatrix","transform","scaleBy","w","vEye","getWorldPosition","vDir","Vector3","sub","xyz","inplaceNormalize","transformPointAffine","transformVectorAffine","Ray","queueUpdateNode","node","findIndex","push","DWeakRef","queuePerCameraUpdateNode","render","invalidateNodePlacement","add","light","type","useSHFB","getDevice","getDeviceCaps","framebufferCaps","supportFloatBlending","radianceMap","sky","irradianceSHFB","irradianceSH","getRenderer","SceneRenderer","frameUpdate","frameInfo","frameCounter","updateEnvLight","dispatchEvent","updateController","elapsedInSeconds","elapsedOverall","deltaInSeconds","elapsedFrame","queue","ref","shift","attached","update","dispose","frameUpdatePerCamera","updatePerCamera","list","placeNode","disposed","hidden","placeToOctree","removeNode","delete","size","keys","next","value"],"mappings":"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"}
+{"version":3,"file":"scene.js","sources":["../../src/scene/scene.ts"],"sourcesContent":["import type { Matrix4x4, Nullable } from '@zephyr3d/base';\r\nimport { Vector3, Vector4, Ray, DRef, DWeakRef, makeObservable, Disposable } from '@zephyr3d/base';\r\nimport { SceneNode } from './scene_node';\r\nimport { Octree } from './octree';\r\nimport { RaycastVisitor } from './raycast_visitor';\r\nimport { Environment } from './environment';\r\nimport type { GraphNode } from './graph_node';\r\nimport type { Camera } from '../camera/camera';\r\nimport type { Drawable } from '../render';\r\nimport { SceneRenderer } from '../render';\r\nimport type { Compositor } from '../posteffect';\r\nimport type { Metadata } from 'draco3d';\r\nimport { getDevice } from '../app/api';\r\nimport type { IRenderable } from '../app';\r\nimport {\r\n  normalizeScriptAttachmentConfig,\r\n  normalizeScriptAttachments,\r\n  ScriptAttachment\r\n} from './script_attachment';\r\n\r\n/**\r\n * Represents a renderable world that manages scene graph, spatial indexing, and environment.\r\n *\r\n * Core responsibilities:\r\n * - Owns the root {@link SceneNode} and maintains a spatial {@link Octree} for culling/raycasting.\r\n * - Manages environment/lighting via {@link Environment}.\r\n * - Provides per-frame update queues (global and per-camera) for scene nodes.\r\n * - Offers utilities like ray construction and raycasting.\r\n * - Emits observable events: `update`, `startrender`, `endrender`.\r\n *\r\n * Performance notes:\r\n * - Octree placement is lazily synchronized on demand before reads (e.g., `octree`, `boundingBox`)\r\n *   and during per-frame updates.\r\n * - Update queues use weak references to avoid retaining disposed nodes.\r\n *\r\n * @public\r\n */\r\nexport class Scene\r\n  extends makeObservable(Disposable)<{\r\n    /** Dispatched once per frame before render-related work. */\r\n    update: [Scene];\r\n    /** Dispatched immediately before rendering begins for a camera. */\r\n    startrender: [Scene, Camera, Compositor];\r\n    /** Dispatched immediately after rendering finishes for a camera. */\r\n    endrender: [Scene, Camera, Compositor];\r\n  }>()\r\n  implements IRenderable\r\n{\r\n  /** @internal */\r\n  private static _nextId = 0;\r\n  /** @internal Scene name. */\r\n  protected _name: string;\r\n  /** @internal Root node reference. */\r\n  protected _rootNode: DRef<SceneNode>;\r\n  /** @internal Spatial index for placement/culling. */\r\n  protected _octree: Octree;\r\n  /**\r\n   * @internal Pending nodes whose placement in the octree must be updated.\r\n   * Populated by {@link Scene.invalidateNodePlacement} and drained by {@link Scene.updateNodePlacement}.\r\n   */\r\n  protected _nodePlaceList: Set<GraphNode>;\r\n  /** @internal Environment data (sky/light/IBL). */\r\n  protected _env: Environment;\r\n  /** @internal Frame counter that last updated this scene. */\r\n  protected _updateFrame: number;\r\n  /** @internal Unique scene ID. */\r\n  protected _id: number;\r\n  /** @internal One-shot per-frame update queue (runs before render). */\r\n  protected _nodeUpdateQueue: DWeakRef<SceneNode>[];\r\n  /** @internal */\r\n  protected _drawableUpdateQueue: Drawable[];\r\n  /** @internal One-shot per-frame-per-camera update queue. */\r\n  protected _perCameraUpdateQueue: DWeakRef<SceneNode>[];\r\n  /** @internal Main camera reference. */\r\n  protected _mainCamera: DRef<Camera>;\r\n  /** @internal Arbitrary metadata loaded with the scene (optional). */\r\n  protected _metaData: Nullable<Metadata>;\r\n  /** @internal User-attached script entries (engine-defined). */\r\n  private _scripts: ScriptAttachment[];\r\n  /**\r\n   * Creates an instance of Scene.\r\n   *\r\n   * Initializes:\r\n   * - Unique ID\r\n   * - Empty environment\r\n   * - Octree with default depth/leaf capacities\r\n   * - Root scene node named \"Root\"\r\n   *\r\n   * @param name - Optional scene name for diagnostics/UI.\r\n   */\r\n  constructor(name?: string) {\r\n    super();\r\n    this._id = ++Scene._nextId;\r\n    this._name = name ?? '';\r\n    this._octree = new Octree(this, 8, 8);\r\n    this._nodePlaceList = new Set();\r\n    this._nodeUpdateQueue = [];\r\n    this._drawableUpdateQueue = [];\r\n    this._perCameraUpdateQueue = [];\r\n    this._env = new Environment();\r\n    this._updateFrame = -1;\r\n    this._rootNode = new DRef();\r\n    this._rootNode.set(new SceneNode(this));\r\n    this._rootNode.get()!.name = 'Root';\r\n    this._metaData = null;\r\n    this._scripts = [];\r\n    this._mainCamera = new DRef();\r\n  }\r\n  /**\r\n   * Gets the unique identifier of the scene.\r\n   */\r\n  get id() {\r\n    return this._id;\r\n  }\r\n  /**\r\n   * Name of the scene\r\n   */\r\n  get name() {\r\n    return this._name;\r\n  }\r\n  set name(val: string) {\r\n    this._name = val ?? '';\r\n  }\r\n  /**\r\n   * Main camera used to render the scene by default.\r\n   */\r\n  get mainCamera() {\r\n    return this._mainCamera.get();\r\n  }\r\n  set mainCamera(camera) {\r\n    this._mainCamera.set(camera);\r\n  }\r\n  /**\r\n   * Gets the root scene node of the scene\r\n   */\r\n  get rootNode() {\r\n    return this._rootNode.get()!;\r\n  }\r\n  /**\r\n   * Gets the octree used for spatial organization and queries.\r\n   *\r\n   * Ensures pending node placements are synchronized before returning.\r\n   */\r\n  get octree() {\r\n    // Make sure the octree state is up to date\r\n    this.updateNodePlacement(this._octree, this._nodePlaceList);\r\n    return this._octree;\r\n  }\r\n  /**\r\n   * Gets the world-axis-aligned bounding box of the scene.\r\n   *\r\n   * Ensures pending node placements are synchronized before computing.\r\n   */\r\n  get boundingBox() {\r\n    this.updateNodePlacement(this._octree, this._nodePlaceList);\r\n    // this._syncBVChangedList();\r\n    return this._octree.getRootNode().getBoxLoosed();\r\n  }\r\n  /**\r\n   * The environment (sky, lights, IBL) of the scene.\r\n   */\r\n  get env() {\r\n    return this._env;\r\n  }\r\n  /**\r\n   * Arbitrary metadata associated with the scene (e.g., imported asset info).\r\n   */\r\n  get metaData() {\r\n    return this._metaData;\r\n  }\r\n  set metaData(val) {\r\n    this._metaData = val;\r\n  }\r\n  /**\r\n   * Attached script filename or identifier (engine-specific).\r\n   *\r\n   * @remarks\r\n   * Integrates with the engine’s scripting system if available.\r\n   */\r\n  get script() {\r\n    return this._scripts[0]?.script ?? '';\r\n  }\r\n  set script(fileName: string) {\r\n    const script = fileName ?? '';\r\n    if (!script) {\r\n      this._scripts.splice(0, 1);\r\n    } else if (this._scripts[0]) {\r\n      this._scripts[0].script = script;\r\n    } else {\r\n      this._scripts.unshift(new ScriptAttachment(script));\r\n    }\r\n  }\r\n  /**\r\n   * Script component configuration payload used by editor/runtime script components.\r\n   */\r\n  get scriptConfig() {\r\n    return this._scripts[0]?.config ?? null;\r\n  }\r\n  set scriptConfig(value: Nullable<object | unknown[]>) {\r\n    const normalized = normalizeScriptAttachmentConfig(value);\r\n    if (this._scripts[0]) {\r\n      this._scripts[0].config = normalized;\r\n    } else if (normalized != null) {\r\n      this._scripts.unshift(new ScriptAttachment('', normalized));\r\n    }\r\n    if (this._scripts[0] && !this._scripts[0].script && this._scripts[0].config == null) {\r\n      this._scripts.splice(0, 1);\r\n    }\r\n  }\r\n  /**\r\n   * All script attachments on this scene.\r\n   */\r\n  get scripts() {\r\n    return this._scripts;\r\n  }\r\n  set scripts(value: ScriptAttachment[]) {\r\n    this._scripts = normalizeScriptAttachments(value);\r\n  }\r\n  /**\r\n   * Script configs for all script attachments.\r\n   */\r\n  get scriptConfigs() {\r\n    return this._scripts.map((item) => item.config);\r\n  }\r\n  set scriptConfigs(value: unknown[]) {\r\n    const next = Array.isArray(value) ? value : [];\r\n    for (let i = 0; i < Math.max(this._scripts.length, next.length); i++) {\r\n      const config = normalizeScriptAttachmentConfig(next[i]);\r\n      if (this._scripts[i]) {\r\n        this._scripts[i].config = config;\r\n      } else if (config != null) {\r\n        this._scripts.push(new ScriptAttachment('', config));\r\n      }\r\n    }\r\n    this._scripts = this._scripts.filter((item) => item.script || item.config != null);\r\n  }\r\n  /**\r\n   * Finds a scene node by its persistent ID.\r\n   *\r\n   * @typeParam T - Expected node type.\r\n   * @param id - Persistent identifier to match against `SceneNode.persistentId`.\r\n   * @returns The first matching node, or `null` if not found.\r\n   */\r\n  findNodeById<T extends SceneNode>(id: string) {\r\n    return this._rootNode.get()!.findNodeById<T>(id);\r\n  }\r\n  /**\r\n   * Finds a scene node by name.\r\n   *\r\n   * If multiple nodes share the same name, returns the first match encountered\r\n   * during traversal.\r\n   *\r\n   * @typeParam T - Expected node type.\r\n   * @param name - Node name to match.\r\n   * @returns The first matching node, or `null` if not found.\r\n   *\r\n   * @remarks\r\n   * Names are not guaranteed unique. Prefer IDs for stable references.\r\n   */\r\n  findNodeByName<T extends SceneNode>(name: string) {\r\n    return this._rootNode.get()!.findNodeByName<T>(name);\r\n  }\r\n  /**\r\n   * Casts a ray into the scene and returns the closest intersection, if any.\r\n   *\r\n   * @param ray - The ray in world space.\r\n   * @param length - Maximum ray length. Defaults to `Infinity`.\r\n   * @returns Intersection info `{ target, dist, point }`, or `null` if no hit.\r\n   *\r\n   */\r\n  raycast(ray: Ray, length = Infinity) {\r\n    const raycastVisitor = new RaycastVisitor(ray, length);\r\n    this.octree.getRootNode().traverse(raycastVisitor);\r\n    return raycastVisitor.intersected\r\n      ? {\r\n          target: raycastVisitor.intersected,\r\n          dist: raycastVisitor.intersectedDist,\r\n          point: raycastVisitor.intersectedPoint\r\n        }\r\n      : null;\r\n  }\r\n  /**\r\n   * Constructs a world-space ray from a camera and a screen position.\r\n   *\r\n   * @param camera - Camera whose projection/view defines the ray.\r\n   * @param viewportWidth - Current viewport width in pixels.\r\n   * @param viewportHeight - Current viewport height in pixels.\r\n   * @param screenX - Screen-space x (pixels).\r\n   * @param screenY - Screen-space y (pixels).\r\n   * @param invModelMatrix - Optional inverse model matrix to transform the ray into local space.\r\n   * @returns The constructed Ray.\r\n   *\r\n   * @remarks\r\n   * Computes NDC from screen coordinates, unprojects using `invViewProjectionMatrix`,\r\n   * then forms a ray from the camera world position to the unprojected point.\r\n   * If `invModelMatrix` is provided, both origin and direction are transformed.\r\n   */\r\n  constructRay(\r\n    camera: Camera,\r\n    viewportWidth: number,\r\n    viewportHeight: number,\r\n    screenX: number,\r\n    screenY: number,\r\n    invModelMatrix?: Matrix4x4\r\n  ) {\r\n    const vClip = new Vector4((2 * screenX) / viewportWidth - 1, 1 - (2 * screenY) / viewportHeight, 1, 1);\r\n    const vWorld = camera.invViewProjectionMatrix.transform(vClip);\r\n    vWorld.scaleBy(1 / vWorld.w);\r\n    let vEye = camera.getWorldPosition();\r\n    let vDir = Vector3.sub(vWorld.xyz(), vEye).inplaceNormalize();\r\n    if (invModelMatrix) {\r\n      vEye = invModelMatrix.transformPointAffine(vEye);\r\n      vDir = invModelMatrix.transformVectorAffine(vDir);\r\n    }\r\n    return new Ray(vEye, vDir);\r\n  }\r\n  /**\r\n   * Queues a node for a one-shot update before the next render.\r\n   *\r\n   * The node's `update(frame, elapsedSeconds, deltaSeconds)` will be called\r\n   * during Scene.frameUpdate and then the node is removed from the queue.\r\n   *\r\n   * @param node - Node to schedule.\r\n   *\r\n   * @remarks\r\n   * - To update continuously each frame, call `queueUpdateNode(this)` from within the node's `update` method.\r\n   * - Duplicate scheduling within the same frame is prevented.\r\n   */\r\n  queueUpdateNode(node: SceneNode) {\r\n    if (node && this._nodeUpdateQueue.findIndex((val) => val.get() === node) < 0) {\r\n      this._nodeUpdateQueue.push(new DWeakRef(node));\r\n    }\r\n  }\r\n  /**\r\n   * Queues a drawable for a one-shot state update before the next render.\r\n   *\r\n   * The drawable's `updateState()` will be called during Scene.frameUpdate and then the drawable is removed from the queue.\r\n   * @param drawable - Drawable to schedule.\r\n   *\r\n   * @remarks\r\n   * - To update continuously each frame, call `queueUpdateDrawable(this)` from within the drawable's `updateState` method.\r\n   * - Duplicate scheduling within the same frame is prevented.\r\n   */\r\n  queueUpdateDrawable(drawable: Drawable) {\r\n    if (drawable && this._drawableUpdateQueue.indexOf(drawable) < 0) {\r\n      this._drawableUpdateQueue.push(drawable);\r\n    }\r\n  }\r\n  /**\r\n   * Queues a node for a one-shot per-camera update before render.\r\n   *\r\n   * The node's `updatePerCamera(camera, elapsedSeconds, deltaSeconds)` will be\r\n   * called once for each camera during {@link Scene.frameUpdatePerCamera}, then removed.\r\n   *\r\n   * @param node - Node to schedule.\r\n   *\r\n   * @remarks\r\n   * - To run per-camera work continuously, re-queue from `updatePerCamera`.\r\n   * - Duplicate scheduling within the same frame is prevented.\r\n   */\r\n  queuePerCameraUpdateNode(node: SceneNode) {\r\n    if (node && this._perCameraUpdateQueue.findIndex((val) => val.get() === node) < 0) {\r\n      this._perCameraUpdateQueue.push(new DWeakRef(node));\r\n    }\r\n  }\r\n  /**\r\n   * Renders this scene using the `mainCamera`, if present.\r\n   *\r\n   * Equivalent to `mainCamera.render(this)` when `mainCamera` is set.\r\n   */\r\n  render() {\r\n    if (this.mainCamera) {\r\n      this.mainCamera.render(this);\r\n    }\r\n  }\r\n  /**\r\n   * Marks a graph node as needing placement update in the octree.\r\n   *\r\n   * Called by nodes when their transform/visibility/attachment changes in a way\r\n   * that affects spatial placement.\r\n   *\r\n   * @internal\r\n   */\r\n  invalidateNodePlacement(node: GraphNode) {\r\n    this._nodePlaceList.add(node);\r\n  }\r\n  /**\r\n   * Synchronizes environment light maps (IBL, SH/FB) with the sky as needed.\r\n   *\r\n   * Uses device capabilities to decide between Spherical Harmonics floating-point blending (SHFB)\r\n   * and classic SH textures, and lazily fills missing environment fields from the sky.\r\n   *\r\n   * @internal\r\n   */\r\n  private updateEnvLight() {\r\n    if (this.env.light.type === 'ibl') {\r\n      this.env.light.radianceMap = this.env.sky.radianceMap;\r\n      this.env.light.irradianceWindow = this.env.sky.shWindowWeights;\r\n      this.env.light.irradianceSHFB = this.env.sky.irradianceSHFB;\r\n      this.env.light.irradianceSH = null;\r\n    }\r\n  }\r\n  /**\r\n   * Returns the renderer class used to render the scene.\r\n   *\r\n   * Override in subclasses to supply a custom renderer.\r\n   *\r\n   * @internal\r\n   */\r\n  getRenderer() {\r\n    return SceneRenderer;\r\n  }\r\n  /**\r\n   * Performs per-frame scene updates, once per device frame.\r\n   *\r\n   * Steps:\r\n   * - Ensure this runs only once per frame (via `frameInfo.frameCounter`).\r\n   * - Update environment light synchronization.\r\n   * - Dispatch `update` event.\r\n   * - Drain the one-shot node update queue and call `node.update(...)`.\r\n   * - Apply pending octree placement updates.\r\n   *\r\n   */\r\n  frameUpdate() {\r\n    const frameInfo = getDevice().frameInfo;\r\n    if (frameInfo.frameCounter !== this._updateFrame) {\r\n      this._updateFrame = frameInfo.frameCounter;\r\n      this.updateEnvLight();\r\n      this.dispatchEvent('update', this);\r\n      this.mainCamera?.updateController();\r\n      if (this._nodeUpdateQueue.length > 0) {\r\n        const elapsedInSeconds = frameInfo.elapsedOverall * 0.001;\r\n        const deltaInSeconds = frameInfo.elapsedFrame * 0.001;\r\n        const queue = this._nodeUpdateQueue;\r\n        this._nodeUpdateQueue = [];\r\n        while (queue.length > 0) {\r\n          const ref = queue.shift()!;\r\n          const node = ref.get();\r\n          if (node?.attached) {\r\n            node.update(frameInfo.frameCounter, elapsedInSeconds, deltaInSeconds);\r\n          }\r\n          ref.dispose();\r\n        }\r\n      }\r\n      if (this._drawableUpdateQueue.length > 0) {\r\n        for (const drawable of this._drawableUpdateQueue) {\r\n          drawable.updateState();\r\n        }\r\n        this._drawableUpdateQueue = [];\r\n      }\r\n      this.updateNodePlacement(this._octree, this._nodePlaceList);\r\n    }\r\n  }\r\n  /**\r\n   * Performs per-camera scene updates for the current frame.\r\n   *\r\n   * Steps:\r\n   * - Drain the per-camera update queue and call `node.updatePerCamera(camera, ...)`.\r\n   * - Apply pending octree placement updates.\r\n   *\r\n   * @param camera - The camera being updated for.\r\n   */\r\n  frameUpdatePerCamera(camera: Camera) {\r\n    if (this._perCameraUpdateQueue.length > 0) {\r\n      const frameInfo = getDevice().frameInfo;\r\n      const elapsedInSeconds = frameInfo.elapsedOverall * 0.001;\r\n      const deltaInSeconds = frameInfo.elapsedFrame * 0.001;\r\n      const queue = this._perCameraUpdateQueue;\r\n      this._perCameraUpdateQueue = [];\r\n      while (queue.length > 0) {\r\n        const ref = queue.shift()!;\r\n        ref.get()?.updatePerCamera(camera, elapsedInSeconds, deltaInSeconds);\r\n        ref.dispose();\r\n      }\r\n    }\r\n    this.updateNodePlacement(this._octree, this._nodePlaceList);\r\n  }\r\n  /**\r\n   * Applies placement changes for nodes in `list` to the given `octree`.\r\n   *\r\n   * Rules:\r\n   * - If node is not disposed, attached, not hidden, and `placeToOctree` is true,\r\n   *   it is placed; otherwise removed.\r\n   * - Drains `list` until empty.\r\n   *\r\n   * @param octree - Target spatial index.\r\n   * @param list - Set of nodes awaiting placement evaluation.\r\n   */\r\n  updateNodePlacement(octree: Octree, list: Set<GraphNode>) {\r\n    function placeNode(node: GraphNode) {\r\n      if (!node.disposed && node.attached && !node.hidden && node.placeToOctree) {\r\n        octree.placeNode(node);\r\n      } else {\r\n        octree.removeNode(node);\r\n      }\r\n      list.delete(node);\r\n    }\r\n    if (list.size > 0) {\r\n      while (list.size > 0) {\r\n        const node = list.keys().next().value!;\r\n        if (octree) {\r\n          placeNode(node);\r\n        } else {\r\n          list.delete(node);\r\n        }\r\n      }\r\n    }\r\n  }\r\n  /**\r\n   * Disposes the scene and its owned resources.\r\n   *\r\n   * Disposes:\r\n   * - Environment\r\n   * - Root node (and, by extension, its hierarchy)\r\n   * - Main camera reference wrapper\r\n   *\r\n   */\r\n  protected onDispose() {\r\n    this._env.dispose();\r\n    this._rootNode.dispose();\r\n    this._mainCamera.dispose();\r\n  }\r\n}\r\n"],"names":["Scene","makeObservable","Disposable","_nextId","name","_id","_name","_octree","Octree","_nodePlaceList","Set","_nodeUpdateQueue","_drawableUpdateQueue","_perCameraUpdateQueue","_env","Environment","_updateFrame","_rootNode","DRef","set","SceneNode","get","_metaData","_scripts","_mainCamera","id","val","mainCamera","camera","rootNode","octree","updateNodePlacement","boundingBox","getRootNode","getBoxLoosed","env","metaData","script","fileName","splice","unshift","ScriptAttachment","scriptConfig","config","value","normalized","normalizeScriptAttachmentConfig","scripts","normalizeScriptAttachments","scriptConfigs","map","item","next","Array","isArray","i","Math","max","length","push","filter","findNodeById","findNodeByName","raycast","ray","Infinity","raycastVisitor","RaycastVisitor","traverse","intersected","target","dist","intersectedDist","point","intersectedPoint","constructRay","viewportWidth","viewportHeight","screenX","screenY","invModelMatrix","vClip","Vector4","vWorld","invViewProjectionMatrix","transform","scaleBy","w","vEye","getWorldPosition","vDir","Vector3","sub","xyz","inplaceNormalize","transformPointAffine","transformVectorAffine","Ray","queueUpdateNode","node","findIndex","DWeakRef","queueUpdateDrawable","drawable","indexOf","queuePerCameraUpdateNode","render","invalidateNodePlacement","add","light","type","radianceMap","sky","irradianceWindow","shWindowWeights","irradianceSHFB","irradianceSH","getRenderer","SceneRenderer","frameUpdate","frameInfo","getDevice","frameCounter","updateEnvLight","dispatchEvent","updateController","elapsedInSeconds","elapsedOverall","deltaInSeconds","elapsedFrame","queue","ref","shift","attached","update","dispose","updateState","frameUpdatePerCamera","updatePerCamera","list","placeNode","disposed","hidden","placeToOctree","removeNode","delete","size","keys"],"mappings":"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"}

package/dist/scene/scene_node.js

@@ -1,9 +1,7 @@
 import { makeObservable, Disposable, randomUUID, DRef, ObservableVector3, ObservableQuaternion, Matrix4x4, Vector3, Vector4 } from '@zephyr3d/base';
 import { AnimationSet } from '../animation/animationset.js';
-import '../animation/eulerrotationtrack.js';
-import '../values.js';
 import { getEngine } from '../app/api.js';
-import '../animation/skeleton.js';
+import { ScriptAttachment, normalizeScriptAttachmentConfig, normalizeScriptAttachments } from './script_attachment.js';
 
 /**
  * The base class of all scene graph objects.
@@ -70,8 +68,8 @@ import '../animation/skeleton.js';
     /** @internal Monotonically increasing tag for transform changes. */ _transformTag;
     /** @internal Shared callback used by observables on transform mutation. */ _transformChangeCallback;
     /** @internal Arbitrary metadata payload for this node. */ _metaData;
-    /** @internal If true, suppress transform-change callbacks (during bulk updates). */ _disableCallback;
-    /** @internal User-attached script entry (engine-defined). */ _script;
+    /** @internal If greater than zero, suppress transform-change callbacks (during bulk updates). */ _disableCallback;
+    /** @internal User-attached script entries (engine-defined). */ _scripts;
     /**
    * Construct a scene node.
    *
@@ -112,10 +110,10 @@ import '../animation/skeleton.js';
         this._invWorldMatrix = null;
         this._localMatrix = null;
         this._transformTag = 0;
-        this._disableCallback = false;
+        this._disableCallback = 0;
         this._tmpLocalMatrix = Matrix4x4.identity();
         this._tmpWorldMatrix = Matrix4x4.identity();
-        this._script = '';
+        this._scripts = [];
         this._metaData = null;
         this._parent = null;
         this.reparent(scene?.rootNode ?? null);
@@ -219,10 +217,58 @@ import '../animation/skeleton.js';
    * @remarks
    * Integrates with the engine’s scripting system if available.
    */ get script() {
-        return this._script;
+        return this._scripts[0]?.script ?? '';
     }
     set script(fileName) {
-        this._script = fileName ?? '';
+        const script = fileName ?? '';
+        if (!script) {
+            this._scripts.splice(0, 1);
+        } else if (this._scripts[0]) {
+            this._scripts[0].script = script;
+        } else {
+            this._scripts.unshift(new ScriptAttachment(script));
+        }
+    }
+    /**
+   * Script component configuration payload used by editor/runtime script components.
+   */ get scriptConfig() {
+        return this._scripts[0]?.config ?? null;
+    }
+    set scriptConfig(value) {
+        const normalized = normalizeScriptAttachmentConfig(value);
+        if (this._scripts[0]) {
+            this._scripts[0].config = normalized;
+        } else if (normalized != null) {
+            this._scripts.unshift(new ScriptAttachment('', normalized));
+        }
+        if (this._scripts[0] && !this._scripts[0].script && this._scripts[0].config == null) {
+            this._scripts.splice(0, 1);
+        }
+    }
+    /**
+   * All script attachments on this node.
+   */ get scripts() {
+        return this._scripts;
+    }
+    set scripts(value) {
+        this._scripts = normalizeScriptAttachments(value);
+    }
+    /**
+   * Script configs for all script attachments.
+   */ get scriptConfigs() {
+        return this._scripts.map((item)=>item.config);
+    }
+    set scriptConfigs(value) {
+        const next = Array.isArray(value) ? value : [];
+        for(let i = 0; i < Math.max(this._scripts.length, next.length); i++){
+            const config = normalizeScriptAttachmentConfig(next[i]);
+            if (this._scripts[i]) {
+                this._scripts[i].config = config;
+            } else if (config != null) {
+                this._scripts.push(new ScriptAttachment('', config));
+            }
+        }
+        this._scripts = this._scripts.filter((item)=>item.script || item.config != null);
     }
     /**
    * Display name of the node (for UI/debugging).
@@ -593,6 +639,9 @@ import '../animation/skeleton.js';
     set boundingBoxDrawMode(mode) {
         this._boxDrawMode = mode;
     }
+    invalidateTransform(invalidateLocal = true) {
+        this._onTransformChanged(invalidateLocal);
+    }
     /** Get called when the node was just created by cloning from other node */ onPostClone() {}
     /** Disposes the node */ onDispose() {
         super.onDispose();
@@ -615,7 +664,7 @@ import '../animation/skeleton.js';
             }
             if (this._parent) {
                 const index = this._parent._children.findIndex((val)=>val.get() === this);
-                this._parent.children[index].dispose();
+                this._parent._children[index].dispose();
                 this._parent._children.splice(index, 1);
             }
             this._parent = p;
@@ -637,21 +686,23 @@ import '../animation/skeleton.js';
         }
     }
     /** @internal */ _onTransformChanged(invalidateLocal) {
-        if (this._disableCallback) {
+        if (this._disableCallback > 0) {
             return;
         }
         if (invalidateLocal) {
             this._localMatrix = null;
         }
-        this._worldMatrix = null;
-        this._invWorldMatrix = null;
-        this._worldMatrixDet = null;
-        this._transformTag++;
-        for (const child of this._children){
-            child.get()._onTransformChanged(false);
-        }
         this.invalidateWorldBoundingVolume(true);
         this.dispatchEvent('transformchanged', this);
+        if (this._worldMatrix) {
+            this._transformTag++;
+            this._worldMatrix = null;
+            this._invWorldMatrix = null;
+            this._worldMatrixDet = null;
+            for (const child of this._children){
+                child.get()._onTransformChanged(false);
+            }
+        }
     }
     /**
    * Get called when this node is attached to scene
@@ -688,7 +739,7 @@ import '../animation/skeleton.js';
         }
     }
     /** Children of this xform */ get children() {
-        return this._children;
+        return this._children.map((child)=>child.get());
     }
     /**
    * Position of the xform relative to it's parent
@@ -769,9 +820,9 @@ import '../animation/skeleton.js';
    * @param matrix - The transform matrix to set
    * @returns self
    */ setLocalTransform(matrix) {
-        this._disableCallback = true;
+        this._disableCallback++;
         matrix.decompose(this._scaling, this._rotation, this._position);
-        this._disableCallback = false;
+        this._disableCallback--;
         this._onTransformChanged(true);
         return this;
     }
@@ -786,22 +837,15 @@ import '../animation/skeleton.js';
         this.setLocalTransform(matrix);
     }
     /** World transformation matrix of the xform */ get worldMatrix() {
-        if (!this._worldMatrix) {
-            this._worldMatrix = this._tmpWorldMatrix;
-            this.calculateWorldTransform(this._worldMatrix);
-        }
+        this.syncTransform();
         return this._worldMatrix;
     }
     /** The determinant of world matrix */ get worldMatrixDet() {
-        if (this._worldMatrixDet === null) {
-            this._worldMatrixDet = this.worldMatrix.det();
-        }
+        this.syncTransform();
         return this._worldMatrixDet;
     }
     /** Inverse of the world transformation matrix of the xform */ get invWorldMatrix() {
-        if (!this._invWorldMatrix) {
-            this._invWorldMatrix = Matrix4x4.invertAffine(this.worldMatrix);
-        }
+        this.syncTransform();
         return this._invWorldMatrix;
     }
     /**
@@ -866,6 +910,18 @@ import '../animation/skeleton.js';
     /** @internal */ get transformTag() {
         return this._transformTag;
     }
+    /** @internal */ syncTransform() {
+        if (!this._worldMatrix) {
+            this._worldMatrix = this._tmpWorldMatrix;
+            this.calculateWorldTransform(this._worldMatrix);
+        }
+        if (this._worldMatrixDet === null) {
+            this._worldMatrixDet = this._worldMatrix.det();
+        }
+        if (!this._invWorldMatrix) {
+            this._invWorldMatrix = Matrix4x4.invertAffine(this._worldMatrix);
+        }
+    }
 }
 
 export { SceneNode };