@zephyr3d/scene 0.9.1 → 0.9.3

package/dist/animation/spring2/spring_system.js.map

@@ -1 +1 @@
-{"version":3,"file":"spring_system.js","sources":["../../../src/animation/spring2/spring_system.ts"],"sourcesContent":["import type { Vector3 } from '@zephyr3d/base';\r\nimport { Quaternion } from '@zephyr3d/base';\r\nimport type { SceneNode } from '../../scene';\r\nimport type { ControllerConfig } from './controller';\r\nimport { SpringSystemController } from './controller';\r\nimport type { BoneNode, ColliderR, GrabberR, TransformAccess } from './types';\r\n\r\nconst _quat = new Quaternion();\r\n\r\nexport function createTransformAccess(obj: SceneNode): TransformAccess {\r\n  return {\r\n    getWorldPosition(): Vector3 {\r\n      return obj.getWorldPosition();\r\n    },\r\n    getWorldRotation(): Quaternion {\r\n      const q = new Quaternion();\r\n      obj.worldMatrix.decompose(null, q, null);\r\n      return q;\r\n    },\r\n    getLocalPosition(): Vector3 {\r\n      return obj.position.clone();\r\n    },\r\n    getLocalRotation(): Quaternion {\r\n      return obj.rotation.clone();\r\n    },\r\n    getLocalScale(): Vector3 {\r\n      return obj.scale.clone();\r\n    },\r\n    setWorldPosition(p: Vector3): void {\r\n      if (obj.parent) {\r\n        obj.position = obj.parent.invWorldMatrix.transformPointAffine(p);\r\n      } else {\r\n        obj.position.set(p);\r\n      }\r\n    },\r\n    setWorldRotation(q: Quaternion): void {\r\n      // Convert world rotation to local: localRot = inverse(parentWorldRot) * worldRot\r\n      if (obj.parent) {\r\n        obj.parent.worldMatrix.decompose(null, _quat, null);\r\n        Quaternion.multiply(Quaternion.inverse(_quat), q, obj.rotation);\r\n      } else {\r\n        obj.rotation.set(q);\r\n      }\r\n    },\r\n    setLocalPosition(p: Vector3): void {\r\n      obj.position.set(p);\r\n    },\r\n    setLocalRotation(q: Quaternion): void {\r\n      obj.rotation.set(q);\r\n    },\r\n    setLocalScale(s: Vector3): void {\r\n      obj.scale.set(s);\r\n    }\r\n  };\r\n}\r\n\r\nexport type SpringChainConfig = {\r\n  systemRoot: SceneNode;\r\n  chains: { start: SceneNode; end: SceneNode }[];\r\n};\r\n\r\n/**\r\n * Physics engine for spring-based particle simulation\r\n * Uses Verlet integration and iterative constraint solving\r\n *\r\n * @public\r\n */\r\nexport class SpringSystem2 {\r\n  private _controller: SpringSystemController;\r\n  constructor(\r\n    options: ControllerConfig,\r\n    chainConfig: SpringChainConfig,\r\n    colliders: { r: ColliderR; transform: TransformAccess }[],\r\n    grabbers: {\r\n      r: GrabberR;\r\n      transform: TransformAccess;\r\n      enabled: boolean;\r\n    }[],\r\n    flatPlanes: { up: Vector3; position: Vector3 }[]\r\n  ) {\r\n    const rootPoints: BoneNode[] = [];\r\n    const boneNodes: BoneNode[] = [];\r\n    const pointTransforms: TransformAccess[] = [];\r\n    let index = 0;\r\n    for (const chain of chainConfig.chains) {\r\n      const chainNodes = this.collectChainNodes(chain.start, chain.end);\r\n      for (let i = 0; i < chainNodes.length; i++) {\r\n        const node = chainNodes[i];\r\n        const boneNode = {\r\n          index: index++,\r\n          position: node.getWorldPosition(),\r\n          children: [],\r\n          isFixed: i === 0, // Fix the first bone in the chain\r\n          depth: i\r\n        };\r\n        boneNodes.push(boneNode);\r\n        pointTransforms.push(createTransformAccess(node));\r\n        if (i > 0) {\r\n          boneNodes[boneNodes.length - 2].children.push(boneNode);\r\n        }\r\n        if (i === 0) {\r\n          rootPoints.push(boneNode);\r\n        }\r\n      }\r\n    }\r\n    const systemRoot = createTransformAccess(chainConfig.systemRoot);\r\n    this._controller = new SpringSystemController(options);\r\n    this._controller.initialize(systemRoot, rootPoints, pointTransforms, colliders, grabbers, flatPlanes);\r\n  }\r\n\r\n  get controller() {\r\n    return this._controller;\r\n  }\r\n\r\n  private collectChainNodes(start: SceneNode, end: SceneNode): SceneNode[] {\r\n    if (!start.isParentOf(end)) {\r\n      throw new Error('Invalid chain: end node must be a descendant of start node');\r\n    }\r\n    const nodes: SceneNode[] = [];\r\n    let current: SceneNode = end;\r\n    for (;;) {\r\n      nodes.unshift(current);\r\n      if (current === start) {\r\n        break;\r\n      }\r\n      current = current.parent!;\r\n    }\r\n    return nodes;\r\n  }\r\n  /**\r\n   * Updates the physics simulation\r\n   * @param deltaTime - Time step in seconds\r\n   */\r\n  update(deltaTime: number): void {\r\n    // Clamp deltaTime to prevent instability\r\n    const dt = Math.min(deltaTime, 0.033); // Max 30 FPS\r\n    // simulation\r\n    this._controller.step(dt);\r\n  }\r\n}\r\n"],"names":["_quat","Quaternion","createTransformAccess","obj","getWorldPosition","getWorldRotation","q","worldMatrix","decompose","getLocalPosition","position","clone","getLocalRotation","rotation","getLocalScale","scale","setWorldPosition","p","parent","invWorldMatrix","transformPointAffine","set","setWorldRotation","multiply","inverse","setLocalPosition","setLocalRotation","setLocalScale","s","SpringSystem2","_controller","options","chainConfig","colliders","grabbers","flatPlanes","rootPoints","boneNodes","pointTransforms","index","chain","chains","chainNodes","collectChainNodes","start","end","i","length","node","boneNode","children","isFixed","depth","push","systemRoot","SpringSystemController","initialize","controller","isParentOf","Error","nodes","current","unshift","update","deltaTime","dt","Math","min","step"],"mappings":"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"}
+{"version":3,"file":"spring_system.js","sources":["../../../src/animation/spring2/spring_system.ts"],"sourcesContent":["import type { Vector3 } from '@zephyr3d/base';\nimport { Quaternion } from '@zephyr3d/base';\nimport type { SceneNode } from '../../scene';\nimport type { ControllerConfig } from './controller';\nimport { SpringSystemController } from './controller';\nimport type { BoneNode, ColliderR, GrabberR, TransformAccess } from './types';\n\nconst _quat = new Quaternion();\n\nexport function createTransformAccess(obj: SceneNode): TransformAccess {\n  return {\n    getWorldPosition(): Vector3 {\n      return obj.getWorldPosition();\n    },\n    getWorldRotation(): Quaternion {\n      const q = new Quaternion();\n      obj.worldMatrix.decompose(null, q, null);\n      return q;\n    },\n    getLocalPosition(): Vector3 {\n      return obj.position.clone();\n    },\n    getLocalRotation(): Quaternion {\n      return obj.rotation.clone();\n    },\n    getLocalScale(): Vector3 {\n      return obj.scale.clone();\n    },\n    setWorldPosition(p: Vector3): void {\n      if (obj.parent) {\n        obj.position = obj.parent.invWorldMatrix.transformPointAffine(p);\n      } else {\n        obj.position.set(p);\n      }\n    },\n    setWorldRotation(q: Quaternion): void {\n      // Convert world rotation to local: localRot = inverse(parentWorldRot) * worldRot\n      if (obj.parent) {\n        obj.parent.worldMatrix.decompose(null, _quat, null);\n        Quaternion.multiply(Quaternion.inverse(_quat), q, obj.rotation);\n      } else {\n        obj.rotation.set(q);\n      }\n    },\n    setLocalPosition(p: Vector3): void {\n      obj.position.set(p);\n    },\n    setLocalRotation(q: Quaternion): void {\n      obj.rotation.set(q);\n    },\n    setLocalScale(s: Vector3): void {\n      obj.scale.set(s);\n    }\n  };\n}\n\nexport type SpringChainConfig = {\n  systemRoot: SceneNode;\n  chains: { start: SceneNode; end: SceneNode }[];\n};\n\n/**\n * Physics engine for spring-based particle simulation\n * Uses Verlet integration and iterative constraint solving\n *\n * @public\n */\nexport class SpringSystem2 {\n  private _controller: SpringSystemController;\n  constructor(\n    options: ControllerConfig,\n    chainConfig: SpringChainConfig,\n    colliders: { r: ColliderR; transform: TransformAccess }[],\n    grabbers: {\n      r: GrabberR;\n      transform: TransformAccess;\n      enabled: boolean;\n    }[],\n    flatPlanes: { up: Vector3; position: Vector3 }[]\n  ) {\n    const rootPoints: BoneNode[] = [];\n    const boneNodes: BoneNode[] = [];\n    const pointTransforms: TransformAccess[] = [];\n    let index = 0;\n    for (const chain of chainConfig.chains) {\n      const chainNodes = this.collectChainNodes(chain.start, chain.end);\n      for (let i = 0; i < chainNodes.length; i++) {\n        const node = chainNodes[i];\n        const boneNode = {\n          index: index++,\n          position: node.getWorldPosition(),\n          children: [],\n          isFixed: i === 0, // Fix the first bone in the chain\n          depth: i\n        };\n        boneNodes.push(boneNode);\n        pointTransforms.push(createTransformAccess(node));\n        if (i > 0) {\n          boneNodes[boneNodes.length - 2].children.push(boneNode);\n        }\n        if (i === 0) {\n          rootPoints.push(boneNode);\n        }\n      }\n    }\n    const systemRoot = createTransformAccess(chainConfig.systemRoot);\n    this._controller = new SpringSystemController(options);\n    this._controller.initialize(systemRoot, rootPoints, pointTransforms, colliders, grabbers, flatPlanes);\n  }\n\n  get controller() {\n    return this._controller;\n  }\n\n  private collectChainNodes(start: SceneNode, end: SceneNode): SceneNode[] {\n    if (!start.isParentOf(end)) {\n      throw new Error('Invalid chain: end node must be a descendant of start node');\n    }\n    const nodes: SceneNode[] = [];\n    let current: SceneNode = end;\n    for (;;) {\n      nodes.unshift(current);\n      if (current === start) {\n        break;\n      }\n      current = current.parent!;\n    }\n    return nodes;\n  }\n  /**\n   * Updates the physics simulation\n   * @param deltaTime - Time step in seconds\n   */\n  update(deltaTime: number): void {\n    // Clamp deltaTime to prevent instability\n    const dt = Math.min(deltaTime, 0.033); // Max 30 FPS\n    // simulation\n    this._controller.step(dt);\n  }\n}\n"],"names":["_quat","Quaternion","createTransformAccess","obj","getWorldPosition","getWorldRotation","q","worldMatrix","decompose","getLocalPosition","position","clone","getLocalRotation","rotation","getLocalScale","scale","setWorldPosition","p","parent","invWorldMatrix","transformPointAffine","set","setWorldRotation","multiply","inverse","setLocalPosition","setLocalRotation","setLocalScale","s","SpringSystem2","_controller","options","chainConfig","colliders","grabbers","flatPlanes","rootPoints","boneNodes","pointTransforms","index","chain","chains","chainNodes","collectChainNodes","start","end","i","length","node","boneNode","children","isFixed","depth","push","systemRoot","SpringSystemController","initialize","controller","isParentOf","Error","nodes","current","unshift","update","deltaTime","dt","Math","min","step"],"mappings":"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"}

package/dist/app/app.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.js","sources":["../../src/app/app.ts"],"sourcesContent":["import type { Nullable, RequireOptionals, VFS } from '@zephyr3d/base';\r\nimport { Observable, flushPendingDisposals } from '@zephyr3d/base';\r\nimport type { AbstractDevice, DeviceBackend } from '@zephyr3d/device';\r\nimport { InputManager } from './inputmgr';\r\nimport { Engine } from './engine';\r\nimport { getApp, setApp } from './api';\r\nimport type { ScreenConfig } from './screen';\r\n\r\ntype appEventMap = {\r\n  /**\r\n   * Emitted when the drawing surface (canvas/device) is resized.\r\n   *\r\n   * @param width - New drawable width in device pixels.\r\n   * @param height - New drawable height in device pixels.\r\n   */\r\n  resize: [width: number, height: number];\r\n  /**\r\n   * Emitted every frame with timing information.\r\n   *\r\n   * @param deltaTimeMs - Elapsed time since last frame in milliseconds.\r\n   * @param elapsedTimeMs - Elapsed time since app start in milliseconds.\r\n   */\r\n  tick: [deltaTimeMs: number, elapsedTimeMs: number];\r\n  /** Pointer/mouse and keyboard input events forwarded by the Application. */\r\n  click: [evt: PointerEvent];\r\n  dblclick: [evt: PointerEvent];\r\n  pointerdown: [evt: PointerEvent];\r\n  pointerup: [evt: PointerEvent];\r\n  pointermove: [evt: PointerEvent];\r\n  pointercancel: [evt: PointerEvent];\r\n  pointerenter: [evt: PointerEvent];\r\n  pointerleave: [evt: PointerEvent];\r\n  pointerover: [evt: PointerEvent];\r\n  pointerout: [evt: PointerEvent];\r\n  wheel: [evt: WheelEvent];\r\n  keydown: [evt: KeyboardEvent];\r\n  keyup: [evt: KeyboardEvent];\r\n  keypress: [evt: KeyboardEvent];\r\n  drag: [evt: DragEvent];\r\n  dragenter: [evt: DragEvent];\r\n  dragleave: [evt: DragEvent];\r\n  dragover: [evt: DragEvent];\r\n  dragstart: [evt: DragEvent];\r\n  dragend: [evt: DragEvent];\r\n  drop: [evt: DragEvent];\r\n};\r\n\r\n/** Editor Mode */\r\nexport type EditorMode = 'editor' | 'editor-preview' | 'none';\r\n\r\n/**\r\n * Options for Application.\r\n *\r\n * @public\r\n */\r\nexport interface AppOptions {\r\n  /**\r\n   * Target canvas element to attach the rendering device to.\r\n   */\r\n  canvas: HTMLCanvasElement;\r\n  /**\r\n   * Device backend implementation to use for GPU creation (e.g., WebGL/WebGPU backend).\r\n   */\r\n  backend: DeviceBackend;\r\n  /**\r\n   * Whether to enable multi-sample anti-aliasing (MSAA) if supported by the backend.\r\n   * Defaults to false.\r\n   */\r\n  enableMSAA?: boolean;\r\n  /**\r\n   * Device pixel ratio used when creating the device. Defaults to `window.devicePixelRatio` or 1.\r\n   */\r\n  pixelRatio?: number;\r\n}\r\n\r\n/**\r\n * Creation options for Application.\r\n *\r\n * Provides the canvas, device backend, and optional runtime and device configuration.\r\n * @public\r\n */\r\nexport interface AppCreationOptions extends AppOptions {\r\n  /**\r\n   * Options for the runtime scripting system.\r\n   */\r\n  runtimeOptions?: {\r\n    /**\r\n     * Virtual file system used to load scripts. Defaults to HttpFS at '.' if not provided.\r\n     */\r\n    VFS?: VFS;\r\n    /**\r\n     * Root directory for script files. Defaults to '/'.\r\n     */\r\n    scriptsRoot?: string;\r\n    /**\r\n     * Whether the application is running in editor mode. Should be true for user applications.\r\n     */\r\n    editorMode?: EditorMode;\r\n    /**\r\n     * Whether the runtime scripting system is enabled. Should be true for user applications.\r\n     */\r\n    enabled?: boolean;\r\n    /**\r\n     * Screen configuration\r\n     */\r\n    screen?: ScreenConfig;\r\n  };\r\n}\r\n\r\n/**\r\n * Log severity levels.\r\n * @public\r\n */\r\nexport type LogMode = 'info' | 'warn' | 'error' | 'debug';\r\n\r\n/**\r\n * Application\r\n *\r\n * Entry-point and lifecycle coordinator for the engine. Responsible for:\r\n * - Creating and owning the rendering device from a chosen backend.\r\n * - Managing the per-frame loop, including timing and viewport setup.\r\n * - Forwarding device/DOM input events via an observable event map.\r\n * - Hosting the runtime scripting system and input manager.\r\n *\r\n * Singleton:\r\n * - Only one instance may exist at a time. Access via `{@link getApp}`.\r\n *\r\n * Events:\r\n * - See `appEventMap` for all emitted events (resize, tick, pointer/keyboard/drag).\r\n *\r\n * Usage:\r\n * - Construct with `AppOptions`, await `ready()`, then call `run()` to start the loop.\r\n *\r\n * @public\r\n */\r\nexport class Application extends Observable<appEventMap> {\r\n  private readonly _options: RequireOptionals<AppOptions>;\r\n  private _device: Nullable<AbstractDevice>;\r\n  private readonly _inputManager: InputManager;\r\n  private readonly _engine: Engine;\r\n  private readonly _editorMode: EditorMode;\r\n  private _ready: boolean;\r\n  /**\r\n   * Construct the Application singleton with the provided options.\r\n   *\r\n   * Throws if an instance already exists.\r\n   *\r\n   * @param opt - Application creation options (canvas, backend, and optional runtime/device settings).\r\n   */\r\n  constructor(opt: AppCreationOptions) {\r\n    super();\r\n    if (getApp()) {\r\n      throw new Error('It is not allowed to have multiple Application instances');\r\n    }\r\n    setApp(this);\r\n\r\n    this._options = {\r\n      backend: opt.backend,\r\n      enableMSAA: opt.enableMSAA ?? false,\r\n      pixelRatio: opt.pixelRatio ?? window.devicePixelRatio ?? 1,\r\n      canvas: opt.canvas\r\n    };\r\n    this._inputManager = new InputManager(this);\r\n    this._engine = new Engine(\r\n      opt.runtimeOptions?.VFS,\r\n      opt.runtimeOptions?.scriptsRoot,\r\n      opt.runtimeOptions?.enabled\r\n    );\r\n    if (opt.runtimeOptions?.screen) {\r\n      this._engine.screen.config = opt.runtimeOptions.screen;\r\n    }\r\n    this._editorMode = opt.runtimeOptions?.editorMode ?? 'none';\r\n    this._device = null;\r\n    this._ready = false;\r\n  }\r\n  /**\r\n   * Editor mode\r\n   */\r\n  get editorMode() {\r\n    return this._editorMode;\r\n  }\r\n  /**\r\n   * The input manager instance handling pointer/keyboard event routing.\r\n   */\r\n  get inputManager() {\r\n    return this._inputManager;\r\n  }\r\n  /**\r\n   * Get the instanceof {@link Engine}.\r\n   */\r\n  get engine() {\r\n    return this._engine;\r\n  }\r\n  /**\r\n   * The (sanitized) options used to create this application.\r\n   *\r\n   * Note: Defaults are applied for `enableMSAA` and `pixelRatio` if omitted.\r\n   */\r\n  get options() {\r\n    return this._options;\r\n  }\r\n  /**\r\n   * The initialized rendering device.\r\n   *\r\n   * Available after `await ready()`.\r\n   */\r\n  get device() {\r\n    return this._device!;\r\n  }\r\n  /**\r\n   * Convenience accessor for the device type name provided by the backend.\r\n   */\r\n  get deviceType() {\r\n    return this._options.backend.typeName();\r\n  }\r\n  /**\r\n   * Set keyboard focus to the device's canvas element.\r\n   */\r\n  focus() {\r\n    this._device!.canvas.focus();\r\n  }\r\n  /**\r\n   * Initialize the rendering device and start input processing.\r\n   *\r\n   * @throws If device creation fails.\r\n   */\r\n  async ready() {\r\n    if (!this._ready) {\r\n      this._device = await this._options.backend.createDevice(this._options.canvas, {\r\n        dpr: this._options.pixelRatio,\r\n        msaa: !!this._options.enableMSAA\r\n      });\r\n      if (!this._device) {\r\n        throw new Error('App.init(): create device failed');\r\n      }\r\n      this._device.canvas.focus();\r\n      await this._engine.init();\r\n      this._inputManager.start();\r\n      this._device.on('resize', (width, height) => {\r\n        this._engine.screen.resolveViewport();\r\n        this.dispatchEvent('resize', width, height);\r\n      });\r\n      this._ready = true;\r\n    }\r\n  }\r\n  /**\r\n   * Render a single frame.\r\n   *\r\n   * Steps:\r\n   * - Flushes pending disposals from the previous frame.\r\n   * - Clears device state (framebuffer, viewport, scissor).\r\n   * - Queries frame timing from the device (`elapsedFrame`, `elapsedOverall`).\r\n   * - Updates the runtime manager (scripting/behaviors).\r\n   * - Emits `tick` with delta/elapsed times.\r\n   *\r\n   * Safe to call manually; also used by the run loop.\r\n   */\r\n  frame() {\r\n    // Processes all pending disposals from the previous frame.\r\n    flushPendingDisposals();\r\n    if (this._ready) {\r\n      this.device.setFramebuffer(null);\r\n      this.device.setViewport(null);\r\n      this.device.setScissor(null);\r\n      const dt = this.device.frameInfo.elapsedFrame;\r\n      const elapsed = this.device.frameInfo.elapsedOverall;\r\n      this.dispatchEvent('tick', dt, elapsed);\r\n      this._engine.update(dt * 0.001, elapsed * 0.001);\r\n      this._engine.render();\r\n    }\r\n  }\r\n  /**\r\n   * Start the application's render loop.\r\n   *\r\n   * Uses the device's internal scheduling (`device.runLoop`) to repeatedly call `frame()`.\r\n   */\r\n  run() {\r\n    this.device.runLoop(() => {\r\n      this.frame();\r\n    });\r\n  }\r\n  /**\r\n   * Stop the application's render loop.\r\n   *\r\n   * Uses `device.exitLoop()` to end the scheduling started by `run()`.\r\n   */\r\n  stop() {\r\n    this.device.exitLoop();\r\n  }\r\n}\r\n"],"names":["Application","Observable","_options","_device","_inputManager","_engine","_editorMode","_ready","opt","getApp","Error","setApp","backend","enableMSAA","pixelRatio","window","devicePixelRatio","canvas","InputManager","Engine","runtimeOptions","VFS","scriptsRoot","enabled","screen","config","editorMode","inputManager","engine","options","device","deviceType","typeName","focus","ready","createDevice","dpr","msaa","init","start","on","width","height","resolveViewport","dispatchEvent","frame","flushPendingDisposals","setFramebuffer","setViewport","setScissor","dt","frameInfo","elapsedFrame","elapsed","elapsedOverall","update","render","run","runLoop","stop","exitLoop"],"mappings":"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"}
+{"version":3,"file":"app.js","sources":["../../src/app/app.ts"],"sourcesContent":["import type { Nullable, RequireOptionals, VFS } from '@zephyr3d/base';\r\nimport { Observable, flushPendingDisposals } from '@zephyr3d/base';\r\nimport type { AbstractDevice, DeviceBackend } from '@zephyr3d/device';\r\nimport { InputManager } from './inputmgr';\r\nimport { Engine } from './engine';\r\nimport { getApp, setApp } from './api';\r\nimport type { ScreenConfig } from './screen';\r\n\r\ntype appEventMap = {\r\n  /**\r\n   * Emitted when the drawing surface (canvas/device) is resized.\r\n   *\r\n   * @param width - New drawable width in device pixels.\r\n   * @param height - New drawable height in device pixels.\r\n   */\r\n  resize: [width: number, height: number];\r\n  /**\r\n   * Emitted every frame with timing information.\r\n   *\r\n   * @param deltaTimeMs - Elapsed time since last frame in milliseconds.\r\n   * @param elapsedTimeMs - Elapsed time since app start in milliseconds.\r\n   */\r\n  tick: [deltaTimeMs: number, elapsedTimeMs: number];\r\n  /** Pointer/mouse and keyboard input events forwarded by the Application. */\r\n  click: [evt: PointerEvent];\r\n  dblclick: [evt: PointerEvent];\r\n  pointerdown: [evt: PointerEvent];\r\n  pointerup: [evt: PointerEvent];\r\n  pointermove: [evt: PointerEvent];\r\n  pointercancel: [evt: PointerEvent];\r\n  pointerenter: [evt: PointerEvent];\r\n  pointerleave: [evt: PointerEvent];\r\n  pointerover: [evt: PointerEvent];\r\n  pointerout: [evt: PointerEvent];\r\n  wheel: [evt: WheelEvent];\r\n  keydown: [evt: KeyboardEvent];\r\n  keyup: [evt: KeyboardEvent];\r\n  keypress: [evt: KeyboardEvent];\r\n  drag: [evt: DragEvent];\r\n  dragenter: [evt: DragEvent];\r\n  dragleave: [evt: DragEvent];\r\n  dragover: [evt: DragEvent];\r\n  dragstart: [evt: DragEvent];\r\n  dragend: [evt: DragEvent];\r\n  drop: [evt: DragEvent];\r\n};\r\n\r\n/**\r\n * Application editor/runtime mode.\r\n *\r\n * @public\r\n */\r\nexport type EditorMode = 'editor' | 'editor-preview' | 'none';\r\n\r\n/**\r\n * Options for Application.\r\n *\r\n * @public\r\n */\r\nexport interface AppOptions {\r\n  /**\r\n   * Target canvas element to attach the rendering device to.\r\n   */\r\n  canvas: HTMLCanvasElement;\r\n  /**\r\n   * Device backend implementation to use for GPU creation (e.g., WebGL/WebGPU backend).\r\n   */\r\n  backend: DeviceBackend;\r\n  /**\r\n   * Whether to enable multi-sample anti-aliasing (MSAA) if supported by the backend.\r\n   * Defaults to false.\r\n   */\r\n  enableMSAA?: boolean;\r\n  /**\r\n   * Device pixel ratio used when creating the device. Defaults to `window.devicePixelRatio` or `1`.\r\n   */\r\n  pixelRatio?: number;\r\n}\r\n\r\n/**\r\n * Creation options for Application.\r\n *\r\n * Provides the canvas, device backend, and optional runtime and device configuration.\r\n * @public\r\n */\r\nexport interface AppCreationOptions extends AppOptions {\r\n  /**\r\n   * Options for the runtime scripting system.\r\n   */\r\n  runtimeOptions?: {\r\n    /**\r\n     * Virtual file system used to load scripts. Defaults to HttpFS at '.' if not provided.\r\n     */\r\n    VFS?: VFS;\r\n    /**\r\n     * Root directory for script files. Defaults to '/'.\r\n     */\r\n    scriptsRoot?: string;\r\n    /**\r\n     * Whether the application is running in editor mode. Should be true for user applications.\r\n     */\r\n    editorMode?: EditorMode;\r\n    /**\r\n     * Whether the runtime scripting system is enabled. Should be true for user applications.\r\n     */\r\n    enabled?: boolean;\r\n    /**\r\n     * Screen configuration\r\n     */\r\n    screen?: ScreenConfig;\r\n  };\r\n}\r\n\r\n/**\r\n * Log severity levels.\r\n * @public\r\n */\r\nexport type LogMode = 'info' | 'warn' | 'error' | 'debug';\r\n\r\n/**\r\n * Application\r\n *\r\n * Entry-point and lifecycle coordinator for the engine. Responsible for:\r\n * - Creating and owning the rendering device from a chosen backend.\r\n * - Managing the per-frame loop, including timing and viewport setup.\r\n * - Forwarding device/DOM input events via an observable event map.\r\n * - Hosting the runtime scripting system and input manager.\r\n *\r\n * Singleton:\r\n * - Only one instance may exist at a time. Access via `{@link getApp}`.\r\n *\r\n * Events:\r\n * - See `appEventMap` for all emitted events (resize, tick, pointer/keyboard/drag).\r\n *\r\n * Usage:\r\n * - Construct with `AppOptions`, await `ready()`, then call `run()` to start the loop.\r\n *\r\n * @public\r\n */\r\nexport class Application extends Observable<appEventMap> {\r\n  private readonly _options: RequireOptionals<AppOptions>;\r\n  private _device: Nullable<AbstractDevice>;\r\n  private readonly _inputManager: InputManager;\r\n  private readonly _engine: Engine;\r\n  private readonly _editorMode: EditorMode;\r\n  private _ready: boolean;\r\n  /**\r\n   * Construct the Application singleton with the provided options.\r\n   *\r\n   * Throws if an instance already exists.\r\n   *\r\n   * @param opt - Application creation options (canvas, backend, and optional runtime/device settings).\r\n   */\r\n  constructor(opt: AppCreationOptions) {\r\n    super();\r\n    if (getApp()) {\r\n      throw new Error('It is not allowed to have multiple Application instances');\r\n    }\r\n    setApp(this);\r\n\r\n    this._options = {\r\n      backend: opt.backend,\r\n      enableMSAA: opt.enableMSAA ?? false,\r\n      pixelRatio: opt.pixelRatio ?? window.devicePixelRatio ?? 1,\r\n      canvas: opt.canvas\r\n    };\r\n    this._inputManager = new InputManager(this);\r\n    this._engine = new Engine(\r\n      opt.runtimeOptions?.VFS,\r\n      opt.runtimeOptions?.scriptsRoot,\r\n      opt.runtimeOptions?.enabled\r\n    );\r\n    if (opt.runtimeOptions?.screen) {\r\n      this._engine.screen.config = opt.runtimeOptions.screen;\r\n    }\r\n    this._editorMode = opt.runtimeOptions?.editorMode ?? 'none';\r\n    this._device = null;\r\n    this._ready = false;\r\n  }\r\n  /**\r\n   * Editor mode\r\n   */\r\n  get editorMode() {\r\n    return this._editorMode;\r\n  }\r\n  /**\r\n   * The input manager instance handling pointer/keyboard event routing.\r\n   */\r\n  get inputManager() {\r\n    return this._inputManager;\r\n  }\r\n  /**\r\n   * Get the instanceof {@link Engine}.\r\n   */\r\n  get engine() {\r\n    return this._engine;\r\n  }\r\n  /**\r\n   * The (sanitized) options used to create this application.\r\n   *\r\n   * Note: Defaults are applied for `enableMSAA` and `pixelRatio` if omitted.\r\n   */\r\n  get options() {\r\n    return this._options;\r\n  }\r\n  /**\r\n   * The initialized rendering device.\r\n   *\r\n   * Available after `await ready()`.\r\n   */\r\n  get device() {\r\n    return this._device!;\r\n  }\r\n  /**\r\n   * Convenience accessor for the device type name provided by the backend.\r\n   */\r\n  get deviceType() {\r\n    return this._options.backend.typeName();\r\n  }\r\n  /**\r\n   * Set keyboard focus to the device's canvas element.\r\n   */\r\n  focus() {\r\n    this._device!.canvas.focus();\r\n  }\r\n  /**\r\n   * Initialize the rendering device and start input processing.\r\n   *\r\n   * @throws If device creation fails.\r\n   */\r\n  async ready() {\r\n    if (!this._ready) {\r\n      this._device = await this._options.backend.createDevice(this._options.canvas, {\r\n        dpr: this._options.pixelRatio,\r\n        msaa: !!this._options.enableMSAA\r\n      });\r\n      if (!this._device) {\r\n        throw new Error('App.init(): create device failed');\r\n      }\r\n      this._device.canvas.focus();\r\n      await this._engine.init();\r\n      this._inputManager.start();\r\n      this._device.on('resize', (width, height) => {\r\n        this._engine.screen.resolveViewport();\r\n        this.dispatchEvent('resize', width, height);\r\n      });\r\n      this._ready = true;\r\n    }\r\n  }\r\n  /**\r\n   * Render a single frame.\r\n   *\r\n   * Steps:\r\n   * - Flushes pending disposals from the previous frame.\r\n   * - Clears device state (framebuffer, viewport, scissor).\r\n   * - Queries frame timing from the device (`elapsedFrame`, `elapsedOverall`).\r\n   * - Updates the runtime manager (scripting/behaviors).\r\n   * - Emits `tick` with delta/elapsed times.\r\n   *\r\n   * Safe to call manually; also used by the run loop.\r\n   */\r\n  frame() {\r\n    // Processes all pending disposals from the previous frame.\r\n    flushPendingDisposals();\r\n    if (this._ready) {\r\n      this.device.setFramebuffer(null);\r\n      this.device.setViewport(null);\r\n      this.device.setScissor(null);\r\n      const dt = this.device.frameInfo.elapsedFrame;\r\n      const elapsed = this.device.frameInfo.elapsedOverall;\r\n      this.dispatchEvent('tick', dt, elapsed);\r\n      this._engine.update(dt * 0.001, elapsed * 0.001);\r\n      this._engine.render();\r\n    }\r\n  }\r\n  /**\r\n   * Start the application's render loop.\r\n   *\r\n   * Uses the device's internal scheduling (`device.runLoop`) to repeatedly call `frame()`.\r\n   */\r\n  run() {\r\n    this.device.runLoop(() => {\r\n      this.frame();\r\n    });\r\n  }\r\n  /**\r\n   * Stop the application's render loop.\r\n   *\r\n   * Uses `device.exitLoop()` to end the scheduling started by `run()`.\r\n   */\r\n  stop() {\r\n    this.device.exitLoop();\r\n  }\r\n}\r\n"],"names":["Application","Observable","_options","_device","_inputManager","_engine","_editorMode","_ready","opt","getApp","Error","setApp","backend","enableMSAA","pixelRatio","window","devicePixelRatio","canvas","InputManager","Engine","runtimeOptions","VFS","scriptsRoot","enabled","screen","config","editorMode","inputManager","engine","options","device","deviceType","typeName","focus","ready","createDevice","dpr","msaa","init","start","on","width","height","resolveViewport","dispatchEvent","frame","flushPendingDisposals","setFramebuffer","setViewport","setScissor","dt","frameInfo","elapsedFrame","elapsed","elapsedOverall","update","render","run","runLoop","stop","exitLoop"],"mappings":"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"}

package/dist/app/engine.js

@@ -94,7 +94,7 @@ import { ScreenAdapter } from './screen.js';
         return this._resourceManager;
     }
     /**
-   * Exposes the instanceof {@link Screen}
+   * Exposes the active {@link ScreenAdapter}.
    */ get screen() {
         return this._screen;
     }

package/dist/app/engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine.js","sources":["../../src/app/engine.ts"],"sourcesContent":["import type { GenericConstructor, IDisposable, Nullable, ReadOptions } from '@zephyr3d/base';\r\nimport { MemoryFS, objectEntries } from '@zephyr3d/base';\r\nimport { DRef } from '@zephyr3d/base';\r\nimport { HttpFS, type VFS } from '@zephyr3d/base';\r\nimport { ScriptingSystem } from './scriptingsystem';\r\nimport type { Host } from './scriptingsystem';\r\nimport type { RuntimeScript, RuntimeScriptConfig } from './runtimescript';\r\nimport { ResourceManager } from '../utility/serialization/manager';\r\nimport type { Scene } from '../scene';\r\nimport {\r\n  BoxShape,\r\n  CapsuleShape,\r\n  CylinderShape,\r\n  PlaneShape,\r\n  SphereShape,\r\n  TetrahedronShape,\r\n  TorusShape\r\n} from '../shapes';\r\nimport {\r\n  BlinnMaterial,\r\n  LambertMaterial,\r\n  PBRMetallicRoughnessMaterial,\r\n  PBRSpecularGlossinessMaterial,\r\n  UnlitMaterial\r\n} from '../material';\r\nimport { StandardSpriteMaterial } from '../material/sprite_std';\r\nimport { ScreenAdapter } from './screen';\r\n\r\n/**\r\n * Interface for objects that can be rendered.\r\n *\r\n * @public\r\n */\r\nexport interface IRenderable extends IDisposable {\r\n  render(): void;\r\n}\r\n\r\n/**\r\n * Interface for render hooks to customize rendering behavior.\r\n *\r\n * @public\r\n */\r\nexport interface IRenderHook {\r\n  // If presents, called before rendering the renderable. Return `false` to skip rendering.\r\n  beforeRender?: (renderable: any) => boolean | void;\r\n  // If presents, called after rendering the renderable.\r\n  afterRender?: (renderable: any) => void;\r\n}\r\n\r\n/**\r\n * Core engine class managing scripting, serialization, and rendering.\r\n *\r\n * Responsibilities:\r\n * - Manages a {@link ScriptingSystem} for dynamic script attachment and lifecycle.\r\n * - Manages a {@link ResourceManager} for loading scenes and assets.\r\n * - Maintains a list of active renderable objects to be rendered each frame.\r\n * - Provides methods to attach/detach scripts, update scripts, load scenes, and read files.\r\n * - Supports enabling/disabling of runtime operations.\r\n *\r\n * @remarks\r\n * The engine can be configured with a virtual file system (VFS) and script root path.\r\n * It exposes methods to manage scripts on host objects, update scripts each frame,\r\n * load scenes from files, and render active objects.\r\n *\r\n * @public\r\n */\r\nexport class Engine {\r\n  private _builtinsVFS: Nullable<MemoryFS>;\r\n  private _scriptingSystem: ScriptingSystem;\r\n  private _resourceManager: ResourceManager;\r\n  private _enabled: boolean;\r\n  private _screen: ScreenAdapter;\r\n  protected _activeRenderables: {\r\n    renderable: DRef<IRenderable>;\r\n    hook: Nullable<IRenderHook>;\r\n  }[];\r\n  private _loadingScenes: Partial<Record<string, Promise<Nullable<Scene>>>>;\r\n  /**\r\n   * Creates a new runtime manager.\r\n   *\r\n   * @param VFS - Optional virtual file system passed to the internal {@link ScriptingSystem}.\r\n   * @param scriptsRoot - Optional scripts root path within the VFS. Defaults as in `ScriptingSystem`.\r\n   * @param enabled - Whether runtime operations are active. Defaults to `true`.\r\n   */\r\n  constructor(VFS?: VFS, scriptsRoot?: string, enabled?: boolean) {\r\n    VFS = VFS ?? new HttpFS('./');\r\n    this._builtinsVFS = null;\r\n    this._scriptingSystem = new ScriptingSystem({ VFS, scriptsRoot });\r\n    this._resourceManager = new ResourceManager(VFS);\r\n    this._enabled = enabled ?? true;\r\n    this._activeRenderables = [];\r\n    this._loadingScenes = {};\r\n    this._screen = new ScreenAdapter();\r\n  }\r\n  /**\r\n   * Exposes the instance of {@link ScriptingSystem}.\r\n   */\r\n  get scriptingSystem() {\r\n    return this._scriptingSystem;\r\n  }\r\n  /**\r\n   * Exposes the virtual file system used by the underlying {@link ScriptingSystem}'s registry.\r\n   */\r\n  get VFS() {\r\n    return this._scriptingSystem.registry.VFS;\r\n  }\r\n  set VFS(vfs: VFS) {\r\n    if (vfs !== this._resourceManager.VFS) {\r\n      this._resourceManager.VFS?.close();\r\n      this._resourceManager.VFS = vfs;\r\n      this._scriptingSystem.registry.VFS = vfs;\r\n      this.ensureBuiltinVFS();\r\n    }\r\n  }\r\n  /**\r\n   * Exposes the instance of {@link ResourceManager}.\r\n   */\r\n  get resourceManager() {\r\n    return this._resourceManager;\r\n  }\r\n  /**\r\n   * Exposes the instanceof {@link Screen}\r\n   */\r\n  get screen() {\r\n    return this._screen;\r\n  }\r\n  /** @internal */\r\n  async init() {\r\n    await this.ensureBuiltinVFS();\r\n  }\r\n  /**\r\n   * Detaches all scripts from all hosts, if enabled.\r\n   *\r\n   * No-op when `enabled === false`.\r\n   */\r\n  detachAllScripts() {\r\n    if (this._enabled) {\r\n      this._scriptingSystem.detachAllScripts();\r\n    }\r\n  }\r\n  /**\r\n   * Loads a runtime script class from file\r\n   * @param module - file path\r\n   * @returns The runtime script class or null\r\n   */\r\n  async loadRuntimeScriptClass<T extends Host = Host>(\r\n    module: string\r\n  ): Promise<Nullable<{ url: string; cls: GenericConstructor<RuntimeScript<T>> }>> {\r\n    return await this._scriptingSystem.loadRuntimeScriptClass(module);\r\n  }\r\n  /**\r\n   * Attaches a script module to the given host, if enabled.\r\n   *\r\n   * When disabled, this method resolves to `null` without side effects.\r\n   *\r\n   * @typeParam T - Host type.\r\n   * @param host - Host object to attach the script to.\r\n   * @param module - Module identifier to resolve and load.\r\n   * @returns The `RuntimeScript<T>` instance, or `null` if disabled or on failure.\r\n   */\r\n  async attachScript<T extends Host>(\r\n    host: Nullable<T>,\r\n    module: string,\r\n    config?: Nullable<RuntimeScriptConfig>\r\n  ) {\r\n    return this._enabled ? await this._scriptingSystem.attachScript(host, module, config) : null;\r\n  }\r\n  /**\r\n   * Detaches a script from a host, by module ID or instance, if enabled.\r\n   *\r\n   * No-op when disabled.\r\n   *\r\n   * @typeParam T - Host type.\r\n   * @param host - Host to detach from.\r\n   * @param idOrInstance - Target script by module ID or instance reference.\r\n   */\r\n  detachScript<T extends Host>(host: T, idOrInstance: string | RuntimeScript<T>) {\r\n    if (this._enabled) {\r\n      this._scriptingSystem.detachScript(host, idOrInstance);\r\n    }\r\n  }\r\n  /**\r\n   * Gets all scripts attached to a host.\r\n   *\r\n   * Delegates to {@link ScriptingSystem.getScriptObjects}.\r\n   *\r\n   * @typeParam T - Expected script type.\r\n   * @param host - Host object to query.\r\n   * @returns Script instances attached to the host, or an empty array.\r\n   */\r\n  getScriptObjects<T extends RuntimeScript<any>>(host: unknown) {\r\n    return this._scriptingSystem.getScriptObjects(host) as T[];\r\n  }\r\n  /**\r\n   * Ticks all attached scripts by calling their `onUpdate` hooks, if enabled.\r\n   *\r\n   * Delegates to {@link ScriptingSystem.update}. No-op when disabled.\r\n   *\r\n   * @param deltaTime - Time since last update in Seconds.\r\n   * @param elapsedTime - Total elapsed time in Seconds.\r\n   */\r\n  update(deltaTime: number, elapsedTime: number) {\r\n    if (this._enabled) {\r\n      this._scriptingSystem.update(deltaTime, elapsedTime);\r\n    }\r\n  }\r\n  async loadSceneFromFile(path: string) {\r\n    path = this.VFS.normalizePath(path);\r\n    if (!this._loadingScenes[path]) {\r\n      this._loadingScenes[path] = this._loadScene(path);\r\n    }\r\n    return this._loadingScenes[path]!;\r\n  }\r\n  setRenderable(renderable: Nullable<IRenderable>, layer = 0, hook?: IRenderHook) {\r\n    if (!this._activeRenderables[layer]) {\r\n      this._activeRenderables[layer] = {\r\n        renderable: new DRef<IRenderable>(null),\r\n        hook: null\r\n      };\r\n    }\r\n    this._activeRenderables[layer].hook = hook ?? null;\r\n    this._activeRenderables[layer].renderable.set(renderable);\r\n  }\r\n  async readFile<T extends ReadOptions['encoding'] = 'binary'>(path: string, encoding?: T) {\r\n    try {\r\n      const content = await this.VFS.readFile(path, { encoding: encoding ?? 'binary' });\r\n      return content as T extends 'binary' ? ArrayBuffer : string;\r\n    } catch (err) {\r\n      console.error(`Read file '${path}' failed: ${err}`);\r\n      return null;\r\n    }\r\n  }\r\n  async startup(\r\n    startupScene?: Nullable<string>,\r\n    splashScreen?: Nullable<string>,\r\n    startupScript?: Nullable<string>\r\n  ) {\r\n    const splashScreenLayer = 9999;\r\n    if (splashScreen) {\r\n      const splashScreenScene = await this.loadSceneFromFile(splashScreen);\r\n      if (splashScreenScene) {\r\n        this.setRenderable(splashScreenScene, splashScreenLayer);\r\n      }\r\n    }\r\n    if (startupScript) {\r\n      const path =\r\n        startupScript.toLowerCase().endsWith('.ts') || startupScript.toLowerCase().endsWith('.js')\r\n          ? startupScript.slice(0, -3)\r\n          : startupScript;\r\n      await this.attachScript(null, path);\r\n    }\r\n    if (startupScene) {\r\n      const scene = await this.loadSceneFromFile(startupScene);\r\n      this.setRenderable(scene, 0);\r\n    }\r\n    this.setRenderable(null, splashScreenLayer);\r\n  }\r\n  render() {\r\n    this._activeRenderables.forEach((info) => {\r\n      const render = info.hook?.beforeRender\r\n        ? (info.hook.beforeRender(info.renderable.get() ?? null) ?? true)\r\n        : true;\r\n      if (render) {\r\n        info.renderable.get()?.render();\r\n      }\r\n      if (info.hook?.afterRender) {\r\n        info.hook.afterRender(info.renderable.get() ?? null);\r\n      }\r\n    });\r\n  }\r\n  private async ensureBuiltinVFS() {\r\n    if (!this._builtinsVFS) {\r\n      this._builtinsVFS = await this.createBuiltinVFS();\r\n    }\r\n    this.VFS.unmount('/assets/@builtins');\r\n    this.VFS.mount('/assets/@builtins', this._builtinsVFS);\r\n  }\r\n  private async createBuiltinVFS() {\r\n    const fs = new MemoryFS();\r\n    const shapeClsMap = {\r\n      '/primitives/box.zmsh': BoxShape,\r\n      '/primitives/sphere.zmsh': SphereShape,\r\n      '/primitives/cylinder.zmsh': CylinderShape,\r\n      '/primitives/plane.zmsh': PlaneShape,\r\n      '/primitives/torus.zmsh': TorusShape,\r\n      '/primitives/tetrahedron.zmsh': TetrahedronShape,\r\n      '/primitives/capsule.zmsh': CapsuleShape,\r\n      '/materials/unlit.zmtl': UnlitMaterial,\r\n      '/materials/lambert.zmtl': LambertMaterial,\r\n      '/materials/blinnphong.zmtl': BlinnMaterial,\r\n      '/materials/pbr_metallic_roughness.zmtl': PBRMetallicRoughnessMaterial,\r\n      '/materials/pbr_specular_glossiness.zmtl': PBRSpecularGlossinessMaterial,\r\n      '/materials/sprite_std.zmtl': StandardSpriteMaterial\r\n    } as const;\r\n    for (const [key] of objectEntries(shapeClsMap)) {\r\n      const obj = new shapeClsMap[key]();\r\n      await this.writeSerializableObject(fs, 'Default', obj, key);\r\n      obj.dispose();\r\n    }\r\n    fs.readOnly = true;\r\n    return fs;\r\n  }\r\n  private async writeSerializableObject(VFS: VFS, type: string, obj: any, path: string) {\r\n    try {\r\n      const data = await this.resourceManager.serializeObject(obj);\r\n      const content = JSON.stringify({ type, data }, null, 2);\r\n      await VFS.writeFile(path, content, { encoding: 'utf8', create: true });\r\n    } catch (err) {\r\n      console.error(`Write file '${path}' failed: ${err}`);\r\n    }\r\n  }\r\n  private async _loadScene(path: string) {\r\n    try {\r\n      const scene = await this._resourceManager.loadScene(path);\r\n      if (scene) {\r\n        const sceneScripts =\r\n          scene.scripts.length > 0\r\n            ? scene.scripts\r\n            : scene.script\r\n              ? [{ script: scene.script, config: scene.scriptConfig }]\r\n              : [];\r\n        for (const attachment of sceneScripts) {\r\n          if (!attachment.script) {\r\n            continue;\r\n          }\r\n          try {\r\n            await this.attachScript(\r\n              scene,\r\n              attachment.script,\r\n              (attachment.config ?? null) as RuntimeScriptConfig | null\r\n            );\r\n          } catch (err) {\r\n            console.error(`Attach script failed: ${err}`);\r\n          }\r\n        }\r\n        const nodes: (typeof scene.rootNode)[] = [];\r\n        scene.rootNode.iterate((node) => {\r\n          nodes.push(node);\r\n        });\r\n        const attachTasks = nodes.map(async (node) => {\r\n          const attachments =\r\n            node.scripts.length > 0\r\n              ? node.scripts\r\n              : node.script\r\n                ? [{ script: node.script, config: node.scriptConfig }]\r\n                : [];\r\n          for (const attachment of attachments) {\r\n            if (!attachment.script) {\r\n              continue;\r\n            }\r\n            try {\r\n              await this.attachScript(\r\n                node,\r\n                attachment.script,\r\n                (attachment.config ?? null) as RuntimeScriptConfig | null\r\n              );\r\n            } catch (err) {\r\n              console.error(`Attach script failed: ${err}`);\r\n            }\r\n          }\r\n        });\r\n        if (attachTasks.length > 0) {\r\n          await Promise.allSettled(attachTasks);\r\n        }\r\n      }\r\n      return scene;\r\n    } catch (err) {\r\n      console.error(`Load scene from '${path}' failed: ${err}`);\r\n      return null;\r\n    }\r\n  }\r\n}\r\n"],"names":["Engine","_builtinsVFS","_scriptingSystem","_resourceManager","_enabled","_screen","_activeRenderables","_loadingScenes","VFS","scriptsRoot","enabled","HttpFS","ScriptingSystem","ResourceManager","ScreenAdapter","scriptingSystem","registry","vfs","close","ensureBuiltinVFS","resourceManager","screen","init","detachAllScripts","loadRuntimeScriptClass","module","attachScript","host","config","detachScript","idOrInstance","getScriptObjects","update","deltaTime","elapsedTime","loadSceneFromFile","path","normalizePath","_loadScene","setRenderable","renderable","layer","hook","DRef","set","readFile","encoding","content","err","console","error","startup","startupScene","splashScreen","startupScript","splashScreenLayer","splashScreenScene","toLowerCase","endsWith","slice","scene","render","forEach","info","beforeRender","get","afterRender","createBuiltinVFS","unmount","mount","fs","MemoryFS","shapeClsMap","BoxShape","SphereShape","CylinderShape","PlaneShape","TorusShape","TetrahedronShape","CapsuleShape","UnlitMaterial","LambertMaterial","BlinnMaterial","PBRMetallicRoughnessMaterial","PBRSpecularGlossinessMaterial","StandardSpriteMaterial","key","objectEntries","obj","writeSerializableObject","dispose","readOnly","type","data","serializeObject","JSON","stringify","writeFile","create","loadScene","sceneScripts","scripts","length","script","scriptConfig","attachment","nodes","rootNode","iterate","node","push","attachTasks","map","attachments","Promise","allSettled"],"mappings":"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"}
+{"version":3,"file":"engine.js","sources":["../../src/app/engine.ts"],"sourcesContent":["import type { GenericConstructor, IDisposable, Nullable, ReadOptions } from '@zephyr3d/base';\r\nimport { MemoryFS, objectEntries } from '@zephyr3d/base';\r\nimport { DRef } from '@zephyr3d/base';\r\nimport { HttpFS, type VFS } from '@zephyr3d/base';\r\nimport { ScriptingSystem } from './scriptingsystem';\r\nimport type { Host } from './scriptingsystem';\r\nimport type { RuntimeScript, RuntimeScriptConfig } from './runtimescript';\r\nimport { ResourceManager } from '../utility/serialization/manager';\r\nimport type { Scene } from '../scene';\r\nimport {\r\n  BoxShape,\r\n  CapsuleShape,\r\n  CylinderShape,\r\n  PlaneShape,\r\n  SphereShape,\r\n  TetrahedronShape,\r\n  TorusShape\r\n} from '../shapes';\r\nimport {\r\n  BlinnMaterial,\r\n  LambertMaterial,\r\n  PBRMetallicRoughnessMaterial,\r\n  PBRSpecularGlossinessMaterial,\r\n  UnlitMaterial\r\n} from '../material';\r\nimport { StandardSpriteMaterial } from '../material/sprite_std';\r\nimport { ScreenAdapter } from './screen';\r\n\r\n/**\r\n * Interface for objects that can be rendered.\r\n *\r\n * @public\r\n */\r\nexport interface IRenderable extends IDisposable {\r\n  render(): void;\r\n}\r\n\r\n/**\r\n * Interface for render hooks to customize rendering behavior.\r\n *\r\n * @public\r\n */\r\nexport interface IRenderHook {\r\n  // If presents, called before rendering the renderable. Return `false` to skip rendering.\r\n  beforeRender?: (renderable: any) => boolean | void;\r\n  // If presents, called after rendering the renderable.\r\n  afterRender?: (renderable: any) => void;\r\n}\r\n\r\n/**\r\n * Core engine class managing scripting, serialization, and rendering.\r\n *\r\n * Responsibilities:\r\n * - Manages a {@link ScriptingSystem} for dynamic script attachment and lifecycle.\r\n * - Manages a {@link ResourceManager} for loading scenes and assets.\r\n * - Maintains a list of active renderable objects to be rendered each frame.\r\n * - Provides methods to attach/detach scripts, update scripts, load scenes, and read files.\r\n * - Supports enabling/disabling of runtime operations.\r\n *\r\n * @remarks\r\n * The engine can be configured with a virtual file system (VFS) and script root path.\r\n * It exposes methods to manage scripts on host objects, update scripts each frame,\r\n * load scenes from files, and render active objects.\r\n *\r\n * @public\r\n */\r\nexport class Engine {\r\n  private _builtinsVFS: Nullable<MemoryFS>;\r\n  private _scriptingSystem: ScriptingSystem;\r\n  private _resourceManager: ResourceManager;\r\n  private _enabled: boolean;\r\n  private _screen: ScreenAdapter;\r\n  protected _activeRenderables: {\r\n    renderable: DRef<IRenderable>;\r\n    hook: Nullable<IRenderHook>;\r\n  }[];\r\n  private _loadingScenes: Partial<Record<string, Promise<Nullable<Scene>>>>;\r\n  /**\r\n   * Creates a new runtime manager.\r\n   *\r\n   * @param VFS - Optional virtual file system passed to the internal {@link ScriptingSystem}.\r\n   * @param scriptsRoot - Optional scripts root path within the VFS. Defaults as in `ScriptingSystem`.\r\n   * @param enabled - Whether runtime operations are active. Defaults to `true`.\r\n   */\r\n  constructor(VFS?: VFS, scriptsRoot?: string, enabled?: boolean) {\r\n    VFS = VFS ?? new HttpFS('./');\r\n    this._builtinsVFS = null;\r\n    this._scriptingSystem = new ScriptingSystem({ VFS, scriptsRoot });\r\n    this._resourceManager = new ResourceManager(VFS);\r\n    this._enabled = enabled ?? true;\r\n    this._activeRenderables = [];\r\n    this._loadingScenes = {};\r\n    this._screen = new ScreenAdapter();\r\n  }\r\n  /**\r\n   * Exposes the instance of {@link ScriptingSystem}.\r\n   */\r\n  get scriptingSystem() {\r\n    return this._scriptingSystem;\r\n  }\r\n  /**\r\n   * Exposes the virtual file system used by the underlying {@link ScriptingSystem}'s registry.\r\n   */\r\n  get VFS() {\r\n    return this._scriptingSystem.registry.VFS;\r\n  }\r\n  set VFS(vfs: VFS) {\r\n    if (vfs !== this._resourceManager.VFS) {\r\n      this._resourceManager.VFS?.close();\r\n      this._resourceManager.VFS = vfs;\r\n      this._scriptingSystem.registry.VFS = vfs;\r\n      this.ensureBuiltinVFS();\r\n    }\r\n  }\r\n  /**\r\n   * Exposes the instance of {@link ResourceManager}.\r\n   */\r\n  get resourceManager() {\r\n    return this._resourceManager;\r\n  }\r\n  /**\r\n   * Exposes the active {@link ScreenAdapter}.\r\n   */\r\n  get screen() {\r\n    return this._screen;\r\n  }\r\n  /** @internal */\r\n  async init() {\r\n    await this.ensureBuiltinVFS();\r\n  }\r\n  /**\r\n   * Detaches all scripts from all hosts, if enabled.\r\n   *\r\n   * No-op when `enabled === false`.\r\n   */\r\n  detachAllScripts() {\r\n    if (this._enabled) {\r\n      this._scriptingSystem.detachAllScripts();\r\n    }\r\n  }\r\n  /**\r\n   * Loads a runtime script class from file\r\n   * @param module - file path\r\n   * @returns The runtime script class or null\r\n   */\r\n  async loadRuntimeScriptClass<T extends Host = Host>(\r\n    module: string\r\n  ): Promise<Nullable<{ url: string; cls: GenericConstructor<RuntimeScript<T>> }>> {\r\n    return await this._scriptingSystem.loadRuntimeScriptClass(module);\r\n  }\r\n  /**\r\n   * Attaches a script module to the given host, if enabled.\r\n   *\r\n   * When disabled, this method resolves to `null` without side effects.\r\n   *\r\n   * @typeParam T - Host type.\r\n   * @param host - Host object to attach the script to.\r\n   * @param module - Module identifier to resolve and load.\r\n   * @returns The `RuntimeScript<T>` instance, or `null` if disabled or on failure.\r\n   */\r\n  async attachScript<T extends Host>(\r\n    host: Nullable<T>,\r\n    module: string,\r\n    config?: Nullable<RuntimeScriptConfig>\r\n  ) {\r\n    return this._enabled ? await this._scriptingSystem.attachScript(host, module, config) : null;\r\n  }\r\n  /**\r\n   * Detaches a script from a host, by module ID or instance, if enabled.\r\n   *\r\n   * No-op when disabled.\r\n   *\r\n   * @typeParam T - Host type.\r\n   * @param host - Host to detach from.\r\n   * @param idOrInstance - Target script by module ID or instance reference.\r\n   */\r\n  detachScript<T extends Host>(host: T, idOrInstance: string | RuntimeScript<T>) {\r\n    if (this._enabled) {\r\n      this._scriptingSystem.detachScript(host, idOrInstance);\r\n    }\r\n  }\r\n  /**\r\n   * Gets all scripts attached to a host.\r\n   *\r\n   * Delegates to {@link ScriptingSystem.getScriptObjects}.\r\n   *\r\n   * @typeParam T - Expected script type.\r\n   * @param host - Host object to query.\r\n   * @returns Script instances attached to the host, or an empty array.\r\n   */\r\n  getScriptObjects<T extends RuntimeScript<any>>(host: unknown) {\r\n    return this._scriptingSystem.getScriptObjects(host) as T[];\r\n  }\r\n  /**\r\n   * Ticks all attached scripts by calling their `onUpdate` hooks, if enabled.\r\n   *\r\n   * Delegates to {@link ScriptingSystem.update}. No-op when disabled.\r\n   *\r\n   * @param deltaTime - Time since last update in Seconds.\r\n   * @param elapsedTime - Total elapsed time in Seconds.\r\n   */\r\n  update(deltaTime: number, elapsedTime: number) {\r\n    if (this._enabled) {\r\n      this._scriptingSystem.update(deltaTime, elapsedTime);\r\n    }\r\n  }\r\n  async loadSceneFromFile(path: string) {\r\n    path = this.VFS.normalizePath(path);\r\n    if (!this._loadingScenes[path]) {\r\n      this._loadingScenes[path] = this._loadScene(path);\r\n    }\r\n    return this._loadingScenes[path]!;\r\n  }\r\n  setRenderable(renderable: Nullable<IRenderable>, layer = 0, hook?: IRenderHook) {\r\n    if (!this._activeRenderables[layer]) {\r\n      this._activeRenderables[layer] = {\r\n        renderable: new DRef<IRenderable>(null),\r\n        hook: null\r\n      };\r\n    }\r\n    this._activeRenderables[layer].hook = hook ?? null;\r\n    this._activeRenderables[layer].renderable.set(renderable);\r\n  }\r\n  async readFile<T extends ReadOptions['encoding'] = 'binary'>(path: string, encoding?: T) {\r\n    try {\r\n      const content = await this.VFS.readFile(path, { encoding: encoding ?? 'binary' });\r\n      return content as T extends 'binary' ? ArrayBuffer : string;\r\n    } catch (err) {\r\n      console.error(`Read file '${path}' failed: ${err}`);\r\n      return null;\r\n    }\r\n  }\r\n  async startup(\r\n    startupScene?: Nullable<string>,\r\n    splashScreen?: Nullable<string>,\r\n    startupScript?: Nullable<string>\r\n  ) {\r\n    const splashScreenLayer = 9999;\r\n    if (splashScreen) {\r\n      const splashScreenScene = await this.loadSceneFromFile(splashScreen);\r\n      if (splashScreenScene) {\r\n        this.setRenderable(splashScreenScene, splashScreenLayer);\r\n      }\r\n    }\r\n    if (startupScript) {\r\n      const path =\r\n        startupScript.toLowerCase().endsWith('.ts') || startupScript.toLowerCase().endsWith('.js')\r\n          ? startupScript.slice(0, -3)\r\n          : startupScript;\r\n      await this.attachScript(null, path);\r\n    }\r\n    if (startupScene) {\r\n      const scene = await this.loadSceneFromFile(startupScene);\r\n      this.setRenderable(scene, 0);\r\n    }\r\n    this.setRenderable(null, splashScreenLayer);\r\n  }\r\n  render() {\r\n    this._activeRenderables.forEach((info) => {\r\n      const render = info.hook?.beforeRender\r\n        ? (info.hook.beforeRender(info.renderable.get() ?? null) ?? true)\r\n        : true;\r\n      if (render) {\r\n        info.renderable.get()?.render();\r\n      }\r\n      if (info.hook?.afterRender) {\r\n        info.hook.afterRender(info.renderable.get() ?? null);\r\n      }\r\n    });\r\n  }\r\n  private async ensureBuiltinVFS() {\r\n    if (!this._builtinsVFS) {\r\n      this._builtinsVFS = await this.createBuiltinVFS();\r\n    }\r\n    this.VFS.unmount('/assets/@builtins');\r\n    this.VFS.mount('/assets/@builtins', this._builtinsVFS);\r\n  }\r\n  private async createBuiltinVFS() {\r\n    const fs = new MemoryFS();\r\n    const shapeClsMap = {\r\n      '/primitives/box.zmsh': BoxShape,\r\n      '/primitives/sphere.zmsh': SphereShape,\r\n      '/primitives/cylinder.zmsh': CylinderShape,\r\n      '/primitives/plane.zmsh': PlaneShape,\r\n      '/primitives/torus.zmsh': TorusShape,\r\n      '/primitives/tetrahedron.zmsh': TetrahedronShape,\r\n      '/primitives/capsule.zmsh': CapsuleShape,\r\n      '/materials/unlit.zmtl': UnlitMaterial,\r\n      '/materials/lambert.zmtl': LambertMaterial,\r\n      '/materials/blinnphong.zmtl': BlinnMaterial,\r\n      '/materials/pbr_metallic_roughness.zmtl': PBRMetallicRoughnessMaterial,\r\n      '/materials/pbr_specular_glossiness.zmtl': PBRSpecularGlossinessMaterial,\r\n      '/materials/sprite_std.zmtl': StandardSpriteMaterial\r\n    } as const;\r\n    for (const [key] of objectEntries(shapeClsMap)) {\r\n      const obj = new shapeClsMap[key]();\r\n      await this.writeSerializableObject(fs, 'Default', obj, key);\r\n      obj.dispose();\r\n    }\r\n    fs.readOnly = true;\r\n    return fs;\r\n  }\r\n  private async writeSerializableObject(VFS: VFS, type: string, obj: any, path: string) {\r\n    try {\r\n      const data = await this.resourceManager.serializeObject(obj);\r\n      const content = JSON.stringify({ type, data }, null, 2);\r\n      await VFS.writeFile(path, content, { encoding: 'utf8', create: true });\r\n    } catch (err) {\r\n      console.error(`Write file '${path}' failed: ${err}`);\r\n    }\r\n  }\r\n  private async _loadScene(path: string) {\r\n    try {\r\n      const scene = await this._resourceManager.loadScene(path);\r\n      if (scene) {\r\n        const sceneScripts =\r\n          scene.scripts.length > 0\r\n            ? scene.scripts\r\n            : scene.script\r\n              ? [{ script: scene.script, config: scene.scriptConfig }]\r\n              : [];\r\n        for (const attachment of sceneScripts) {\r\n          if (!attachment.script) {\r\n            continue;\r\n          }\r\n          try {\r\n            await this.attachScript(\r\n              scene,\r\n              attachment.script,\r\n              (attachment.config ?? null) as RuntimeScriptConfig | null\r\n            );\r\n          } catch (err) {\r\n            console.error(`Attach script failed: ${err}`);\r\n          }\r\n        }\r\n        const nodes: (typeof scene.rootNode)[] = [];\r\n        scene.rootNode.iterate((node) => {\r\n          nodes.push(node);\r\n        });\r\n        const attachTasks = nodes.map(async (node) => {\r\n          const attachments =\r\n            node.scripts.length > 0\r\n              ? node.scripts\r\n              : node.script\r\n                ? [{ script: node.script, config: node.scriptConfig }]\r\n                : [];\r\n          for (const attachment of attachments) {\r\n            if (!attachment.script) {\r\n              continue;\r\n            }\r\n            try {\r\n              await this.attachScript(\r\n                node,\r\n                attachment.script,\r\n                (attachment.config ?? null) as RuntimeScriptConfig | null\r\n              );\r\n            } catch (err) {\r\n              console.error(`Attach script failed: ${err}`);\r\n            }\r\n          }\r\n        });\r\n        if (attachTasks.length > 0) {\r\n          await Promise.allSettled(attachTasks);\r\n        }\r\n      }\r\n      return scene;\r\n    } catch (err) {\r\n      console.error(`Load scene from '${path}' failed: ${err}`);\r\n      return null;\r\n    }\r\n  }\r\n}\r\n"],"names":["Engine","_builtinsVFS","_scriptingSystem","_resourceManager","_enabled","_screen","_activeRenderables","_loadingScenes","VFS","scriptsRoot","enabled","HttpFS","ScriptingSystem","ResourceManager","ScreenAdapter","scriptingSystem","registry","vfs","close","ensureBuiltinVFS","resourceManager","screen","init","detachAllScripts","loadRuntimeScriptClass","module","attachScript","host","config","detachScript","idOrInstance","getScriptObjects","update","deltaTime","elapsedTime","loadSceneFromFile","path","normalizePath","_loadScene","setRenderable","renderable","layer","hook","DRef","set","readFile","encoding","content","err","console","error","startup","startupScene","splashScreen","startupScript","splashScreenLayer","splashScreenScene","toLowerCase","endsWith","slice","scene","render","forEach","info","beforeRender","get","afterRender","createBuiltinVFS","unmount","mount","fs","MemoryFS","shapeClsMap","BoxShape","SphereShape","CylinderShape","PlaneShape","TorusShape","TetrahedronShape","CapsuleShape","UnlitMaterial","LambertMaterial","BlinnMaterial","PBRMetallicRoughnessMaterial","PBRSpecularGlossinessMaterial","StandardSpriteMaterial","key","objectEntries","obj","writeSerializableObject","dispose","readOnly","type","data","serializeObject","JSON","stringify","writeFile","create","loadScene","sceneScripts","scripts","length","script","scriptConfig","attachment","nodes","rootNode","iterate","node","push","attachTasks","map","attachments","Promise","allSettled"],"mappings":"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"}

package/dist/app/screen.js

@@ -16,7 +16,7 @@ import { getDevice } from './api.js';
    * Creates a new {@link ScreenAdapter}.
    *
    * @param config - Optional initial screen configuration. If omitted,
-   *   a default of 1280×720 with 'cover' mode is used.
+   *   a default of `1280 x 720` with `cover` mode is used.
    */ constructor(config){
         this._viewport = null;
         this._transform = null;
@@ -250,7 +250,7 @@ import { getDevice } from './api.js';
    *
    * @param canvasPos - Point in canvas coordinates (CSS pixels).
    * @param viewportPosOut - Optional output vector. If provided, it will be
-   *   written into and returned; otherwise a new {@link Vector2} is allocated.
+   *   written into and returned; otherwise a new `Vector2` is allocated.
    * @returns The point in viewport-local coordinates.
    */ canvasPosToViewport(canvasPos, viewportPosOut) {
         return this.transformPoint(this.transform.canvasToViewport, canvasPos, viewportPosOut);
@@ -265,7 +265,7 @@ import { getDevice } from './api.js';
    *
    * @param canvasPos - Point in canvas coordinates (CSS pixels).
    * @param logicPosOut - Optional output vector. If provided, it will be
-   *   written into and returned; otherwise a new {@link Vector2} is allocated.
+   *   written into and returned; otherwise a new `Vector2` is allocated.
    * @returns The point in logical (design resolution) coordinates.
    */ canvasPosToLogic(canvasPos, logicPosOut) {
         return this.transformPoint(this.transform.canvasToLogic, canvasPos, logicPosOut);
@@ -281,7 +281,7 @@ import { getDevice } from './api.js';
    * @param transform - Transform parameters (scale and offset).
    * @param pointIn - Input point.
    * @param pointOut - Optional output vector. If provided, it will be
-   *   written into and returned; otherwise a new {@link Vector2} is allocated.
+   *   written into and returned; otherwise a new `Vector2` is allocated.
    * @returns The transformed point.
    */ transformPoint(transform, pointIn, pointOut) {
         const out = pointOut ?? new Vector2();

package/dist/app/screen.js.map

@@ -1 +1 @@
-{"version":3,"file":"screen.js","sources":["../../src/app/screen.ts"],"sourcesContent":["import type { Immutable, Nullable, Rect } from '@zephyr3d/base';\r\nimport { Vector2 } from '@zephyr3d/base';\r\nimport { getDevice } from './api';\r\n\r\n/**\r\n * Scaling mode used to adapt the design resolution to the viewport.\r\n *\r\n * - 'fit'    – Preserve aspect ratio, show whole design area, may add letterboxing (black bars).\r\n * - 'fit-width'  – Match viewport width exactly; height follows aspect ratio (may crop or letterbox vertically).\r\n * - 'fit-height' – Match viewport height exactly; width follows aspect ratio (may crop or letterbox horizontall\r\n * - 'cover'  – Preserve aspect ratio, fill the entire viewport, design area may be cropped.\r\n * - 'stretch' – Do not preserve aspect ratio, stretch to fill the viewport.\r\n *\r\n * @public\r\n */\r\nexport type ScreenScaleMode = 'fit' | 'fit-width' | 'fit-height' | 'cover' | 'stretch';\r\n\r\n/**\r\n * Screen adapter configuration\r\n *\r\n * @public\r\n */\r\nexport type ScreenConfig = {\r\n  /** Logical width in the design resolution coordinate system. */\r\n  designWidth: number;\r\n  /** Logical height in the design resolution coordinate system. */\r\n  designHeight: number;\r\n  /** Scaling mode used to adapt the design resolution to the viewport. */\r\n  scaleMode: ScreenScaleMode;\r\n};\r\n\r\n/**\r\n * Parameters used to describe a 2D affine transform in the form:\r\n *\r\n *  outX = inX * scaleX + offsetX\r\n *  outY = inY * scaleY + offsetY\r\n */\r\nexport type PointTransform = {\r\n  scaleX: number;\r\n  scaleY: number;\r\n  offsetX: number;\r\n  offsetY: number;\r\n};\r\n\r\n/**\r\n * Resolution transform information derived from a {@link ScreenConfig}\r\n * and a concrete viewport rectangle.\r\n */\r\nexport type ResolutionTransform = {\r\n  /**\r\n   * X position of the adjusted viewport in canvas coordinates (CSS pixels).\r\n   */\r\n  viewportX: number;\r\n  /**\r\n   * Y position of the adjusted viewport in canvas coordinates (CSS pixels).\r\n   */\r\n  viewportY: number;\r\n  /**\r\n   * Width of the adjusted viewport in canvas coordinates (CSS pixels).\r\n   */\r\n  viewportWidth: number;\r\n  /**\r\n   * Height of the adjusted viewport in canvas coordinates (CSS pixels).\r\n   */\r\n  viewportHeight: number;\r\n  /**\r\n   * Visible part of the adjusted viewport, i.e. intersection with original viewport.\r\n   **/\r\n  croppedViewport: Rect;\r\n  /**\r\n   * Transform from canvas coordinates to the adjusted viewport's local coordinates.\r\n   *\r\n   * Typically used to convert mouse / pointer positions into the active rendering region.\r\n   */\r\n  canvasToViewport: PointTransform;\r\n  /**\r\n   * Transform from canvas coordinates to logical coordinates in the\r\n   * design resolution space.\r\n   *\r\n   * Typically used for UI editing and interaction, so that logic consistently\r\n   * works in designWidth × designHeight space.\r\n   */\r\n  canvasToLogic: PointTransform;\r\n};\r\n\r\n/**\r\n * Adapts a given physical viewport to a logical design resolution,\r\n * and provides coordinate transforms between canvas and logical spaces.\r\n *\r\n * @public\r\n */\r\nexport class ScreenAdapter {\r\n  private _config!: ScreenConfig;\r\n  private _transform: Nullable<ResolutionTransform>;\r\n  private _viewport: Nullable<Immutable<number[]>>;\r\n  private _resolvedViewport: Nullable<Immutable<number[]>>;\r\n  private _version: number;\r\n  /**\r\n   * Creates a new {@link ScreenAdapter}.\r\n   *\r\n   * @param config - Optional initial screen configuration. If omitted,\r\n   *   a default of 1280×720 with 'cover' mode is used.\r\n   */\r\n  constructor(config?: Immutable<ScreenConfig>) {\r\n    this._viewport = null;\r\n    this._transform = null;\r\n    this._resolvedViewport = null;\r\n    this._version = 1;\r\n    this._config = { ...this.getDefaultConfig(), ...config };\r\n  }\r\n  /**\r\n   * Returns the current design resolution configuration.\r\n   */\r\n  get config(): Immutable<ScreenConfig> {\r\n    return this._config;\r\n  }\r\n  set config(config: Immutable<ScreenConfig>) {\r\n    this._config = { ...this.getDefaultConfig(), ...config };\r\n    this._transform = null;\r\n    this._version++;\r\n  }\r\n  /**\r\n   * Returns the viewport of the screen\r\n   */\r\n  get viewport(): Nullable<Immutable<number[]>> {\r\n    return this._viewport;\r\n  }\r\n  set viewport(vp: Nullable<Immutable<number[]>>) {\r\n    if (this._viewport !== vp) {\r\n      this._viewport = vp?.slice() ?? null;\r\n      this.resolveViewport();\r\n    }\r\n  }\r\n  /**\r\n   * Returns the version of the screen adapter\r\n   */\r\n  get version() {\r\n    this.resolveViewport();\r\n    return this._version;\r\n  }\r\n  /**\r\n   * Returns the calculated resolution transform\r\n   */\r\n  get transform(): Immutable<ResolutionTransform> {\r\n    this.resolveViewport();\r\n    if (!this._transform) {\r\n      this._transform = this.calculateResolutionTransform(\r\n        this._resolvedViewport![0],\r\n        this._resolvedViewport![1],\r\n        this._resolvedViewport![2],\r\n        this._resolvedViewport![3]\r\n      );\r\n    }\r\n    return this._transform;\r\n  }\r\n  /**\r\n   * Computes the resolution transform for a given viewport in canvas coordinates.\r\n   *\r\n   * @param viewportX - X position of the provided viewport (CSS pixels).\r\n   * @param viewportY - Y position of the provided viewport (CSS pixels).\r\n   * @param viewportWidth - Width of the provided viewport (CSS pixels).\r\n   * @param viewportHeight - Height of the provided viewport (CSS pixels).\r\n   * @returns A {@link ResolutionTransform} describing the adjusted viewport\r\n   *   and coordinate transforms. If any dimension is non-positive, a\r\n   *   transform with zero-sized viewport and identity-like transforms is returned.\r\n   */\r\n  calculateResolutionTransform(\r\n    viewportX: number,\r\n    viewportY: number,\r\n    viewportWidth: number,\r\n    viewportHeight: number\r\n  ) {\r\n    const { designWidth, designHeight, scaleMode } = this._config;\r\n\r\n    // Guard against invalid dimensions.\r\n    if (viewportWidth <= 0 || viewportHeight <= 0 || designWidth <= 0 || designHeight <= 0) {\r\n      return {\r\n        viewportX,\r\n        viewportY,\r\n        viewportWidth: 0,\r\n        viewportHeight: 0,\r\n        croppedViewport: { x: viewportX, y: viewportY, width: 0, height: 0 },\r\n        canvasToViewport: { scaleX: 1, scaleY: 1, offsetX: 0, offsetY: 0 },\r\n        canvasToLogic: { scaleX: 1, scaleY: 1, offsetX: 0, offsetY: 0 }\r\n      };\r\n    }\r\n\r\n    const sx = viewportWidth / designWidth;\r\n    const sy = viewportHeight / designHeight;\r\n\r\n    let scaleX = 1;\r\n    let scaleY = 1;\r\n    let finalViewportWidth = viewportWidth;\r\n    let finalViewportHeight = viewportHeight;\r\n    let finalViewportX = viewportX;\r\n    let finalViewportY = viewportY;\r\n\r\n    switch (scaleMode) {\r\n      case 'fit': {\r\n        // Uniform scale, entire design area visible, may add letterboxing.\r\n        const s = Math.min(sx, sy);\r\n        scaleX = scaleY = s;\r\n        finalViewportWidth = designWidth * s;\r\n        finalViewportHeight = designHeight * s;\r\n        finalViewportX = viewportX + (viewportWidth - finalViewportWidth) * 0.5;\r\n        finalViewportY = viewportY + (viewportHeight - finalViewportHeight) * 0.5;\r\n        break;\r\n      }\r\n      case 'cover': {\r\n        // Uniform scale, viewport fully covered, design area may be cropped.\r\n        const s = Math.max(sx, sy);\r\n        scaleX = scaleY = s;\r\n        finalViewportWidth = designWidth * s;\r\n        finalViewportHeight = designHeight * s;\r\n        finalViewportX = viewportX + (viewportWidth - finalViewportWidth) * 0.5;\r\n        finalViewportY = viewportY + (viewportHeight - finalViewportHeight) * 0.5;\r\n        break;\r\n      }\r\n      case 'stretch': {\r\n        // Non-uniform scale, stretch to fill the viewport.\r\n        scaleX = sx;\r\n        scaleY = sy;\r\n        finalViewportWidth = viewportWidth;\r\n        finalViewportHeight = viewportHeight;\r\n        finalViewportX = viewportX;\r\n        finalViewportY = viewportY;\r\n        break;\r\n      }\r\n      case 'fit-width': {\r\n        // Match width exactly; height follows aspect ratio.\r\n        const s = sx; // width-driven\r\n        scaleX = scaleY = s;\r\n        finalViewportWidth = designWidth * s; // == viewportWidth\r\n        finalViewportHeight = designHeight * s; // may be > or < viewportHeight\r\n        finalViewportX = viewportX;\r\n        finalViewportY = viewportY + (viewportHeight - finalViewportHeight) * 0.5;\r\n        break;\r\n      }\r\n      case 'fit-height': {\r\n        // Match height exactly; width follows aspect ratio.\r\n        const s = sy; // height-driven\r\n        scaleX = scaleY = s;\r\n        finalViewportHeight = designHeight * s; // == viewportHeight\r\n        finalViewportWidth = designWidth * s; // may be > or < viewportWidth\r\n        finalViewportY = viewportY;\r\n        finalViewportX = viewportX + (viewportWidth - finalViewportWidth) * 0.5;\r\n        break;\r\n      }\r\n    }\r\n\r\n    // calculate cropped viewport\r\n    const adjLeft = finalViewportX;\r\n    const adjTop = finalViewportY;\r\n    const adjRight = finalViewportX + finalViewportWidth;\r\n    const adjBottom = finalViewportY + finalViewportHeight;\r\n\r\n    const rawLeft = viewportX;\r\n    const rawTop = viewportY;\r\n    const rawRight = viewportX + viewportWidth;\r\n    const rawBottom = viewportY + viewportHeight;\r\n\r\n    const cropLeft = Math.max(adjLeft, rawLeft);\r\n    const cropTop = Math.max(adjTop, rawTop);\r\n    const cropRight = Math.min(adjRight, rawRight);\r\n    const cropBottom = Math.min(adjBottom, rawBottom);\r\n\r\n    let croppedViewport: Rect;\r\n    if (cropRight <= cropLeft || cropBottom <= cropTop) {\r\n      // No intersection\r\n      croppedViewport = {\r\n        x: viewportX,\r\n        y: viewportY,\r\n        width: 0,\r\n        height: 0\r\n      };\r\n    } else {\r\n      croppedViewport = {\r\n        x: cropLeft,\r\n        y: cropTop,\r\n        width: cropRight - cropLeft,\r\n        height: cropBottom - cropTop\r\n      };\r\n    }\r\n\r\n    // Transform: canvas -> viewport-local\r\n    //   viewportLocalX = canvasX - finalViewportX\r\n    //   viewportLocalY = canvasY - finalViewportY\r\n    const canvasToViewport: PointTransform = {\r\n      scaleX: 1,\r\n      scaleY: 1,\r\n      offsetX: -finalViewportX,\r\n      offsetY: -finalViewportY\r\n    };\r\n\r\n    // Transform: canvas -> logic (design space)\r\n    //\r\n    // canvas -> viewport-local:\r\n    //   vx = canvasX - finalViewportX\r\n    //   vy = canvasY - finalViewportY\r\n    //\r\n    // viewport-local -> logic:\r\n    //   logicX = vx / scaleX\r\n    //   logicY = vy / scaleY\r\n    //\r\n    // Combined:\r\n    //   logicX = (canvasX - finalViewportX) / scaleX\r\n    //          = (1 / scaleX) * canvasX + (-finalViewportX / scaleX)\r\n    //   logicY = (canvasY - finalViewportY) / scaleY\r\n    //          = (1 / scaleY) * canvasY + (-finalViewportY / scaleY)\r\n    const canvasToLogic: PointTransform = {\r\n      scaleX: 1 / scaleX,\r\n      scaleY: 1 / scaleY,\r\n      offsetX: -finalViewportX / scaleX,\r\n      offsetY: -finalViewportY / scaleY\r\n    };\r\n\r\n    return {\r\n      viewportX: finalViewportX,\r\n      viewportY: finalViewportY,\r\n      viewportWidth: finalViewportWidth,\r\n      viewportHeight: finalViewportHeight,\r\n      croppedViewport,\r\n      canvasToViewport,\r\n      canvasToLogic\r\n    };\r\n  }\r\n  /**\r\n   * Converts canvas coordinates into adjusted viewport-local coordinates.\r\n   *\r\n   * @remarks\r\n   * This is mainly intended for picking / hit testing within the active\r\n   * rendering region, where (0, 0) corresponds to the top-left of the\r\n   * adapted viewport.\r\n   *\r\n   * @param canvasPos - Point in canvas coordinates (CSS pixels).\r\n   * @param viewportPosOut - Optional output vector. If provided, it will be\r\n   *   written into and returned; otherwise a new {@link Vector2} is allocated.\r\n   * @returns The point in viewport-local coordinates.\r\n   */\r\n  canvasPosToViewport(canvasPos: Vector2, viewportPosOut?: Vector2) {\r\n    return this.transformPoint(this.transform.canvasToViewport, canvasPos, viewportPosOut);\r\n  }\r\n  /**\r\n   * Converts canvas coordinates into logical coordinates in the design\r\n   * resolution space.\r\n   *\r\n   * @remarks\r\n   * This is mainly intended for UI editing and interaction, so that logic\r\n   * works consistently in the designWidth × designHeight coordinate system.\r\n   *\r\n   * @param canvasPos - Point in canvas coordinates (CSS pixels).\r\n   * @param logicPosOut - Optional output vector. If provided, it will be\r\n   *   written into and returned; otherwise a new {@link Vector2} is allocated.\r\n   * @returns The point in logical (design resolution) coordinates.\r\n   */\r\n  canvasPosToLogic(canvasPos: Vector2, logicPosOut?: Vector2) {\r\n    return this.transformPoint(this.transform.canvasToLogic, canvasPos, logicPosOut);\r\n  }\r\n  /**\r\n   * Applies a 2D affine transform to a point.\r\n   *\r\n   * The transform is applied as:\r\n   *\r\n   *  out.x = in.x * scaleX + offsetX\r\n   *  out.y = in.y * scaleY + offsetY\r\n   *\r\n   * @param transform - Transform parameters (scale and offset).\r\n   * @param pointIn - Input point.\r\n   * @param pointOut - Optional output vector. If provided, it will be\r\n   *   written into and returned; otherwise a new {@link Vector2} is allocated.\r\n   * @returns The transformed point.\r\n   */\r\n  transformPoint(transform: PointTransform, pointIn: Vector2, pointOut?: Vector2) {\r\n    const out = pointOut ?? new Vector2();\r\n    out.x = pointIn.x * transform.scaleX + transform.offsetX;\r\n    out.y = pointIn.y * transform.scaleY + transform.offsetY;\r\n    return out;\r\n  }\r\n  /**\r\n   * Resolves the current viewport, updating internal state as needed.\r\n   */\r\n  resolveViewport() {\r\n    const device = getDevice();\r\n    const vp = this._viewport ?? [\r\n      0,\r\n      0,\r\n      device.deviceXToScreen(device.getDrawingBufferWidth()),\r\n      device.deviceYToScreen(device.getDrawingBufferHeight())\r\n    ];\r\n    if (\r\n      !this._resolvedViewport ||\r\n      this._resolvedViewport[0] !== vp[0] ||\r\n      this._resolvedViewport[1] !== vp[1] ||\r\n      this._resolvedViewport[2] !== vp[2] ||\r\n      this._resolvedViewport[3] !== vp[3]\r\n    ) {\r\n      this._resolvedViewport = vp.slice();\r\n      this._version++;\r\n      this._transform = null;\r\n    }\r\n  }\r\n  private getDefaultConfig(): ScreenConfig {\r\n    return {\r\n      designWidth: 1280,\r\n      designHeight: 720,\r\n      scaleMode: 'cover'\r\n    };\r\n  }\r\n}\r\n"],"names":["ScreenAdapter","_config","_transform","_viewport","_resolvedViewport","_version","config","getDefaultConfig","viewport","vp","slice","resolveViewport","version","transform","calculateResolutionTransform","viewportX","viewportY","viewportWidth","viewportHeight","designWidth","designHeight","scaleMode","croppedViewport","x","y","width","height","canvasToViewport","scaleX","scaleY","offsetX","offsetY","canvasToLogic","sx","sy","finalViewportWidth","finalViewportHeight","finalViewportX","finalViewportY","s","Math","min","max","adjLeft","adjTop","adjRight","adjBottom","rawLeft","rawTop","rawRight","rawBottom","cropLeft","cropTop","cropRight","cropBottom","canvasPosToViewport","canvasPos","viewportPosOut","transformPoint","canvasPosToLogic","logicPosOut","pointIn","pointOut","out","Vector2","device","getDevice","deviceXToScreen","getDrawingBufferWidth","deviceYToScreen","getDrawingBufferHeight"],"mappings":"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"}
+{"version":3,"file":"screen.js","sources":["../../src/app/screen.ts"],"sourcesContent":["import type { Immutable, Nullable, Rect } from '@zephyr3d/base';\r\nimport { Vector2 } from '@zephyr3d/base';\r\nimport { getDevice } from './api';\r\n\r\n/**\r\n * Scaling mode used to adapt the design resolution to the viewport.\r\n *\r\n * - 'fit'    – Preserve aspect ratio, show whole design area, may add letterboxing (black bars).\r\n * - 'fit-width'  – Match viewport width exactly; height follows aspect ratio (may crop or letterbox vertically).\r\n * - 'fit-height' – Match viewport height exactly; width follows aspect ratio (may crop or letterbox horizontall\r\n * - 'cover'  – Preserve aspect ratio, fill the entire viewport, design area may be cropped.\r\n * - 'stretch' – Do not preserve aspect ratio, stretch to fill the viewport.\r\n *\r\n * @public\r\n */\r\nexport type ScreenScaleMode = 'fit' | 'fit-width' | 'fit-height' | 'cover' | 'stretch';\r\n\r\n/**\r\n * Screen adapter configuration\r\n *\r\n * @public\r\n */\r\nexport type ScreenConfig = {\r\n  /** Logical width in the design resolution coordinate system. */\r\n  designWidth: number;\r\n  /** Logical height in the design resolution coordinate system. */\r\n  designHeight: number;\r\n  /** Scaling mode used to adapt the design resolution to the viewport. */\r\n  scaleMode: ScreenScaleMode;\r\n};\r\n\r\n/**\r\n * Parameters used to describe a 2D affine transform in the form:\r\n *\r\n *  outX = inX * scaleX + offsetX\r\n *  outY = inY * scaleY + offsetY\r\n *\r\n * @public\r\n */\r\nexport type PointTransform = {\r\n  scaleX: number;\r\n  scaleY: number;\r\n  offsetX: number;\r\n  offsetY: number;\r\n};\r\n\r\n/**\r\n * Resolution transform information derived from a {@link ScreenConfig}\r\n * and a concrete viewport rectangle.\r\n *\r\n * @public\r\n */\r\nexport type ResolutionTransform = {\r\n  /**\r\n   * X position of the adjusted viewport in canvas coordinates (CSS pixels).\r\n   */\r\n  viewportX: number;\r\n  /**\r\n   * Y position of the adjusted viewport in canvas coordinates (CSS pixels).\r\n   */\r\n  viewportY: number;\r\n  /**\r\n   * Width of the adjusted viewport in canvas coordinates (CSS pixels).\r\n   */\r\n  viewportWidth: number;\r\n  /**\r\n   * Height of the adjusted viewport in canvas coordinates (CSS pixels).\r\n   */\r\n  viewportHeight: number;\r\n  /**\r\n   * Visible part of the adjusted viewport, i.e. intersection with original viewport.\r\n   **/\r\n  croppedViewport: Rect;\r\n  /**\r\n   * Transform from canvas coordinates to the adjusted viewport's local coordinates.\r\n   *\r\n   * Typically used to convert mouse / pointer positions into the active rendering region.\r\n   */\r\n  canvasToViewport: PointTransform;\r\n  /**\r\n   * Transform from canvas coordinates to logical coordinates in the\r\n   * design resolution space.\r\n   *\r\n   * Typically used for UI editing and interaction, so that logic consistently\r\n   * works in designWidth × designHeight space.\r\n   */\r\n  canvasToLogic: PointTransform;\r\n};\r\n\r\n/**\r\n * Adapts a given physical viewport to a logical design resolution,\r\n * and provides coordinate transforms between canvas and logical spaces.\r\n *\r\n * @public\r\n */\r\nexport class ScreenAdapter {\r\n  private _config!: ScreenConfig;\r\n  private _transform: Nullable<ResolutionTransform>;\r\n  private _viewport: Nullable<Immutable<number[]>>;\r\n  private _resolvedViewport: Nullable<Immutable<number[]>>;\r\n  private _version: number;\r\n  /**\r\n   * Creates a new {@link ScreenAdapter}.\r\n   *\r\n   * @param config - Optional initial screen configuration. If omitted,\r\n   *   a default of `1280 x 720` with `cover` mode is used.\r\n   */\r\n  constructor(config?: Immutable<ScreenConfig>) {\r\n    this._viewport = null;\r\n    this._transform = null;\r\n    this._resolvedViewport = null;\r\n    this._version = 1;\r\n    this._config = { ...this.getDefaultConfig(), ...config };\r\n  }\r\n  /**\r\n   * Returns the current design resolution configuration.\r\n   */\r\n  get config(): Immutable<ScreenConfig> {\r\n    return this._config;\r\n  }\r\n  set config(config: Immutable<ScreenConfig>) {\r\n    this._config = { ...this.getDefaultConfig(), ...config };\r\n    this._transform = null;\r\n    this._version++;\r\n  }\r\n  /**\r\n   * Returns the viewport of the screen\r\n   */\r\n  get viewport(): Nullable<Immutable<number[]>> {\r\n    return this._viewport;\r\n  }\r\n  set viewport(vp: Nullable<Immutable<number[]>>) {\r\n    if (this._viewport !== vp) {\r\n      this._viewport = vp?.slice() ?? null;\r\n      this.resolveViewport();\r\n    }\r\n  }\r\n  /**\r\n   * Returns the version of the screen adapter\r\n   */\r\n  get version() {\r\n    this.resolveViewport();\r\n    return this._version;\r\n  }\r\n  /**\r\n   * Returns the calculated resolution transform\r\n   */\r\n  get transform(): Immutable<ResolutionTransform> {\r\n    this.resolveViewport();\r\n    if (!this._transform) {\r\n      this._transform = this.calculateResolutionTransform(\r\n        this._resolvedViewport![0],\r\n        this._resolvedViewport![1],\r\n        this._resolvedViewport![2],\r\n        this._resolvedViewport![3]\r\n      );\r\n    }\r\n    return this._transform;\r\n  }\r\n  /**\r\n   * Computes the resolution transform for a given viewport in canvas coordinates.\r\n   *\r\n   * @param viewportX - X position of the provided viewport (CSS pixels).\r\n   * @param viewportY - Y position of the provided viewport (CSS pixels).\r\n   * @param viewportWidth - Width of the provided viewport (CSS pixels).\r\n   * @param viewportHeight - Height of the provided viewport (CSS pixels).\r\n   * @returns A {@link ResolutionTransform} describing the adjusted viewport\r\n   *   and coordinate transforms. If any dimension is non-positive, a\r\n   *   transform with zero-sized viewport and identity-like transforms is returned.\r\n   */\r\n  calculateResolutionTransform(\r\n    viewportX: number,\r\n    viewportY: number,\r\n    viewportWidth: number,\r\n    viewportHeight: number\r\n  ) {\r\n    const { designWidth, designHeight, scaleMode } = this._config;\r\n\r\n    // Guard against invalid dimensions.\r\n    if (viewportWidth <= 0 || viewportHeight <= 0 || designWidth <= 0 || designHeight <= 0) {\r\n      return {\r\n        viewportX,\r\n        viewportY,\r\n        viewportWidth: 0,\r\n        viewportHeight: 0,\r\n        croppedViewport: { x: viewportX, y: viewportY, width: 0, height: 0 },\r\n        canvasToViewport: { scaleX: 1, scaleY: 1, offsetX: 0, offsetY: 0 },\r\n        canvasToLogic: { scaleX: 1, scaleY: 1, offsetX: 0, offsetY: 0 }\r\n      };\r\n    }\r\n\r\n    const sx = viewportWidth / designWidth;\r\n    const sy = viewportHeight / designHeight;\r\n\r\n    let scaleX = 1;\r\n    let scaleY = 1;\r\n    let finalViewportWidth = viewportWidth;\r\n    let finalViewportHeight = viewportHeight;\r\n    let finalViewportX = viewportX;\r\n    let finalViewportY = viewportY;\r\n\r\n    switch (scaleMode) {\r\n      case 'fit': {\r\n        // Uniform scale, entire design area visible, may add letterboxing.\r\n        const s = Math.min(sx, sy);\r\n        scaleX = scaleY = s;\r\n        finalViewportWidth = designWidth * s;\r\n        finalViewportHeight = designHeight * s;\r\n        finalViewportX = viewportX + (viewportWidth - finalViewportWidth) * 0.5;\r\n        finalViewportY = viewportY + (viewportHeight - finalViewportHeight) * 0.5;\r\n        break;\r\n      }\r\n      case 'cover': {\r\n        // Uniform scale, viewport fully covered, design area may be cropped.\r\n        const s = Math.max(sx, sy);\r\n        scaleX = scaleY = s;\r\n        finalViewportWidth = designWidth * s;\r\n        finalViewportHeight = designHeight * s;\r\n        finalViewportX = viewportX + (viewportWidth - finalViewportWidth) * 0.5;\r\n        finalViewportY = viewportY + (viewportHeight - finalViewportHeight) * 0.5;\r\n        break;\r\n      }\r\n      case 'stretch': {\r\n        // Non-uniform scale, stretch to fill the viewport.\r\n        scaleX = sx;\r\n        scaleY = sy;\r\n        finalViewportWidth = viewportWidth;\r\n        finalViewportHeight = viewportHeight;\r\n        finalViewportX = viewportX;\r\n        finalViewportY = viewportY;\r\n        break;\r\n      }\r\n      case 'fit-width': {\r\n        // Match width exactly; height follows aspect ratio.\r\n        const s = sx; // width-driven\r\n        scaleX = scaleY = s;\r\n        finalViewportWidth = designWidth * s; // == viewportWidth\r\n        finalViewportHeight = designHeight * s; // may be > or < viewportHeight\r\n        finalViewportX = viewportX;\r\n        finalViewportY = viewportY + (viewportHeight - finalViewportHeight) * 0.5;\r\n        break;\r\n      }\r\n      case 'fit-height': {\r\n        // Match height exactly; width follows aspect ratio.\r\n        const s = sy; // height-driven\r\n        scaleX = scaleY = s;\r\n        finalViewportHeight = designHeight * s; // == viewportHeight\r\n        finalViewportWidth = designWidth * s; // may be > or < viewportWidth\r\n        finalViewportY = viewportY;\r\n        finalViewportX = viewportX + (viewportWidth - finalViewportWidth) * 0.5;\r\n        break;\r\n      }\r\n    }\r\n\r\n    // calculate cropped viewport\r\n    const adjLeft = finalViewportX;\r\n    const adjTop = finalViewportY;\r\n    const adjRight = finalViewportX + finalViewportWidth;\r\n    const adjBottom = finalViewportY + finalViewportHeight;\r\n\r\n    const rawLeft = viewportX;\r\n    const rawTop = viewportY;\r\n    const rawRight = viewportX + viewportWidth;\r\n    const rawBottom = viewportY + viewportHeight;\r\n\r\n    const cropLeft = Math.max(adjLeft, rawLeft);\r\n    const cropTop = Math.max(adjTop, rawTop);\r\n    const cropRight = Math.min(adjRight, rawRight);\r\n    const cropBottom = Math.min(adjBottom, rawBottom);\r\n\r\n    let croppedViewport: Rect;\r\n    if (cropRight <= cropLeft || cropBottom <= cropTop) {\r\n      // No intersection\r\n      croppedViewport = {\r\n        x: viewportX,\r\n        y: viewportY,\r\n        width: 0,\r\n        height: 0\r\n      };\r\n    } else {\r\n      croppedViewport = {\r\n        x: cropLeft,\r\n        y: cropTop,\r\n        width: cropRight - cropLeft,\r\n        height: cropBottom - cropTop\r\n      };\r\n    }\r\n\r\n    // Transform: canvas -> viewport-local\r\n    //   viewportLocalX = canvasX - finalViewportX\r\n    //   viewportLocalY = canvasY - finalViewportY\r\n    const canvasToViewport: PointTransform = {\r\n      scaleX: 1,\r\n      scaleY: 1,\r\n      offsetX: -finalViewportX,\r\n      offsetY: -finalViewportY\r\n    };\r\n\r\n    // Transform: canvas -> logic (design space)\r\n    //\r\n    // canvas -> viewport-local:\r\n    //   vx = canvasX - finalViewportX\r\n    //   vy = canvasY - finalViewportY\r\n    //\r\n    // viewport-local -> logic:\r\n    //   logicX = vx / scaleX\r\n    //   logicY = vy / scaleY\r\n    //\r\n    // Combined:\r\n    //   logicX = (canvasX - finalViewportX) / scaleX\r\n    //          = (1 / scaleX) * canvasX + (-finalViewportX / scaleX)\r\n    //   logicY = (canvasY - finalViewportY) / scaleY\r\n    //          = (1 / scaleY) * canvasY + (-finalViewportY / scaleY)\r\n    const canvasToLogic: PointTransform = {\r\n      scaleX: 1 / scaleX,\r\n      scaleY: 1 / scaleY,\r\n      offsetX: -finalViewportX / scaleX,\r\n      offsetY: -finalViewportY / scaleY\r\n    };\r\n\r\n    return {\r\n      viewportX: finalViewportX,\r\n      viewportY: finalViewportY,\r\n      viewportWidth: finalViewportWidth,\r\n      viewportHeight: finalViewportHeight,\r\n      croppedViewport,\r\n      canvasToViewport,\r\n      canvasToLogic\r\n    };\r\n  }\r\n  /**\r\n   * Converts canvas coordinates into adjusted viewport-local coordinates.\r\n   *\r\n   * @remarks\r\n   * This is mainly intended for picking / hit testing within the active\r\n   * rendering region, where (0, 0) corresponds to the top-left of the\r\n   * adapted viewport.\r\n   *\r\n   * @param canvasPos - Point in canvas coordinates (CSS pixels).\r\n   * @param viewportPosOut - Optional output vector. If provided, it will be\r\n   *   written into and returned; otherwise a new `Vector2` is allocated.\r\n   * @returns The point in viewport-local coordinates.\r\n   */\r\n  canvasPosToViewport(canvasPos: Vector2, viewportPosOut?: Vector2) {\r\n    return this.transformPoint(this.transform.canvasToViewport, canvasPos, viewportPosOut);\r\n  }\r\n  /**\r\n   * Converts canvas coordinates into logical coordinates in the design\r\n   * resolution space.\r\n   *\r\n   * @remarks\r\n   * This is mainly intended for UI editing and interaction, so that logic\r\n   * works consistently in the designWidth × designHeight coordinate system.\r\n   *\r\n   * @param canvasPos - Point in canvas coordinates (CSS pixels).\r\n   * @param logicPosOut - Optional output vector. If provided, it will be\r\n   *   written into and returned; otherwise a new `Vector2` is allocated.\r\n   * @returns The point in logical (design resolution) coordinates.\r\n   */\r\n  canvasPosToLogic(canvasPos: Vector2, logicPosOut?: Vector2) {\r\n    return this.transformPoint(this.transform.canvasToLogic, canvasPos, logicPosOut);\r\n  }\r\n  /**\r\n   * Applies a 2D affine transform to a point.\r\n   *\r\n   * The transform is applied as:\r\n   *\r\n   *  out.x = in.x * scaleX + offsetX\r\n   *  out.y = in.y * scaleY + offsetY\r\n   *\r\n   * @param transform - Transform parameters (scale and offset).\r\n   * @param pointIn - Input point.\r\n   * @param pointOut - Optional output vector. If provided, it will be\r\n   *   written into and returned; otherwise a new `Vector2` is allocated.\r\n   * @returns The transformed point.\r\n   */\r\n  transformPoint(transform: PointTransform, pointIn: Vector2, pointOut?: Vector2) {\r\n    const out = pointOut ?? new Vector2();\r\n    out.x = pointIn.x * transform.scaleX + transform.offsetX;\r\n    out.y = pointIn.y * transform.scaleY + transform.offsetY;\r\n    return out;\r\n  }\r\n  /**\r\n   * Resolves the current viewport, updating internal state as needed.\r\n   */\r\n  resolveViewport() {\r\n    const device = getDevice();\r\n    const vp = this._viewport ?? [\r\n      0,\r\n      0,\r\n      device.deviceXToScreen(device.getDrawingBufferWidth()),\r\n      device.deviceYToScreen(device.getDrawingBufferHeight())\r\n    ];\r\n    if (\r\n      !this._resolvedViewport ||\r\n      this._resolvedViewport[0] !== vp[0] ||\r\n      this._resolvedViewport[1] !== vp[1] ||\r\n      this._resolvedViewport[2] !== vp[2] ||\r\n      this._resolvedViewport[3] !== vp[3]\r\n    ) {\r\n      this._resolvedViewport = vp.slice();\r\n      this._version++;\r\n      this._transform = null;\r\n    }\r\n  }\r\n  private getDefaultConfig(): ScreenConfig {\r\n    return {\r\n      designWidth: 1280,\r\n      designHeight: 720,\r\n      scaleMode: 'cover'\r\n    };\r\n  }\r\n}\r\n"],"names":["ScreenAdapter","_config","_transform","_viewport","_resolvedViewport","_version","config","getDefaultConfig","viewport","vp","slice","resolveViewport","version","transform","calculateResolutionTransform","viewportX","viewportY","viewportWidth","viewportHeight","designWidth","designHeight","scaleMode","croppedViewport","x","y","width","height","canvasToViewport","scaleX","scaleY","offsetX","offsetY","canvasToLogic","sx","sy","finalViewportWidth","finalViewportHeight","finalViewportX","finalViewportY","s","Math","min","max","adjLeft","adjTop","adjRight","adjBottom","rawLeft","rawTop","rawRight","rawBottom","cropLeft","cropTop","cropRight","cropBottom","canvasPosToViewport","canvasPos","viewportPosOut","transformPoint","canvasPosToLogic","logicPosOut","pointIn","pointOut","out","Vector2","device","getDevice","deviceXToScreen","getDrawingBufferWidth","deviceYToScreen","getDrawingBufferHeight"],"mappings":"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"}

package/dist/app/scriptingsystem.js

@@ -2,6 +2,25 @@ import { HttpFS } from '@zephyr3d/base';
 import { ScriptRegistry } from './scriptregistry.js';
 import { RuntimeScript, applyRuntimeScriptConfig } from './runtimescript.js';
 
+function resolveCreatedHook(instance) {
+    if (instance.onCreated !== RuntimeScript.prototype.onCreated) {
+        return {
+            legacy: false,
+            hook: ()=>instance.onCreated()
+        };
+    }
+    const legacyHook = instance.onCreate;
+    if (typeof legacyHook === 'function') {
+        return {
+            legacy: true,
+            hook: ()=>legacyHook.call(instance)
+        };
+    }
+    return {
+        legacy: false,
+        hook: ()=>instance.onCreated()
+    };
+}
 /**
  * Script system that resolves, loads, and manages lifecycle of runtime scripts.
  *
@@ -83,7 +102,11 @@ import { RuntimeScript, applyRuntimeScriptConfig } from './runtimescript.js';
             if (instance instanceof RuntimeScript) {
                 applyRuntimeScriptConfig(instance, config);
                 if (!this._scriptHosts.has(instance)) {
-                    const P = instance.onCreated();
+                    const createdHook = resolveCreatedHook(instance);
+                    if (createdHook.legacy) {
+                        console.warn(`Script '${id}' uses deprecated onCreate(); rename it to onCreated().`);
+                    }
+                    const P = createdHook.hook();
                     if (P instanceof Promise) {
                         await P;
                     }

package/dist/app/scriptingsystem.js.map

@@ -1 +1 @@
-{"version":3,"file":"scriptingsystem.js","sources":["../../src/app/scriptingsystem.ts"],"sourcesContent":["import type { GenericConstructor, IDisposable, Nullable, VFS } from '@zephyr3d/base';\r\nimport { HttpFS } from '@zephyr3d/base';\r\nimport { ScriptRegistry } from './scriptregistry';\r\nimport { applyRuntimeScriptConfig, RuntimeScript, type RuntimeScriptConfig } from './runtimescript';\r\n\r\n/**\r\n * A host object that supports disposal.\r\n *\r\n * Hosts are objects to which scripts can be attached. They are expected to\r\n * emit a `'dispose'` event compatible with `IDisposable` so that scripts\r\n * can be automatically detached when the host is destroyed.\r\n *\r\n * @public\r\n */\r\nexport type Host = IDisposable;\r\n\r\n/**\r\n * Options for configuring a `ScriptingSystem`.\r\n *\r\n * @public\r\n */\r\nexport type ScriptingSystemOptions = {\r\n  /** Virtual file system used by the script registry. Defaults to `new HttpFS('./')`. */\r\n  VFS?: VFS;\r\n  /** Root path for scripts within the VFS. Defaults to `/`. */\r\n  scriptsRoot?: string;\r\n  /**\r\n   * Optional string appended to dynamic import URLs (e.g., for cache busting).\r\n   * Example: `'?v=' + Date.now()`\r\n   */\r\n  importComment?: string;\r\n  /**\r\n   * Optional callback invoked when a module fails to load.\r\n   * @param e - The error that occurred.\r\n   * @param id - The module ID that failed to load.\r\n   */\r\n  onLoadError?: (e: unknown, id: string) => void;\r\n};\r\n\r\n/**\r\n * Information about a script attached to a host.\r\n *\r\n * @public\r\n */\r\nexport interface IAttachedScript {\r\n  /** The logical module identifier used to resolve the script. */\r\n  id: string;\r\n  /** The resolved runtime URL used for dynamic import. */\r\n  url: string;\r\n  /** The instantiated runtime script. */\r\n  instance: RuntimeScript<any>;\r\n}\r\n\r\n/**\r\n * Script system that resolves, loads, and manages lifecycle of runtime scripts.\r\n *\r\n * Responsibilities:\r\n * - Resolves module IDs to URLs via {@link ScriptRegistry}\r\n * - Dynamically imports modules and instantiates a `RuntimeScript` (default export)\r\n * - Tracks attachments between hosts and script instances\r\n * - Bridges script lifecycle hooks: `onCreated`, `onAttached`, `onDetached`, `onDestroy`, `onUpdate`\r\n * - Auto-detaches scripts when a host is disposed\r\n *\r\n * Notes:\r\n * - Multiple hosts can reference the same `RuntimeScript` instance; destruction\r\n *   occurs when the last host detaches.\r\n * - Errors during load/attach/update are caught and logged; an optional\r\n *   `onLoadError` callback can be provided.\r\n *\r\n * @public\r\n */\r\nexport class ScriptingSystem {\r\n  private _registry: ScriptRegistry;\r\n  private _hostScripts: Map<Nullable<Host>, IAttachedScript[]>;\r\n  private _scriptHosts: Map<RuntimeScript<any>, Nullable<Host>[]>;\r\n  private _onLoadError?: (e: unknown, id: string) => void;\r\n  private _importComment?: string;\r\n\r\n  /**\r\n   * Constructs a new scripting system.\r\n   *\r\n   * @param opts - Optional configuration.\r\n   */\r\n  constructor(opts: ScriptingSystemOptions = {}) {\r\n    this._registry = new ScriptRegistry(opts.VFS ?? new HttpFS('./'), opts.scriptsRoot ?? '/');\r\n    this._hostScripts = new Map();\r\n    this._scriptHosts = new Map();\r\n    this._importComment = opts.importComment;\r\n    this._onLoadError = opts.onLoadError;\r\n  }\r\n\r\n  /**\r\n   * Accessor for the underlying script registry used for module resolution.\r\n   */\r\n  get registry() {\r\n    return this._registry;\r\n  }\r\n  /**\r\n   * Loads a runtime script class from file\r\n   * @param module - file path\r\n   * @returns The runtime script class or null\r\n   */\r\n  async loadRuntimeScriptClass<T extends Host = Host>(\r\n    module: string\r\n  ): Promise<\r\n    Nullable<{\r\n      url: string;\r\n      id: string;\r\n      cls: GenericConstructor<RuntimeScript<T>>;\r\n    }>\r\n  > {\r\n    let mod: any = null;\r\n    const moduleName = module ? String(module).slice(0, 64) : '';\r\n    let url = '';\r\n    try {\r\n      url = await this._registry.resolveRuntimeUrl(module);\r\n      if (!url) {\r\n        return null;\r\n      }\r\n      mod = await import(url + (this._importComment ?? ''));\r\n    } catch (e) {\r\n      console.error(`Load module '${moduleName}' failed: ${e}`);\r\n    }\r\n    if (mod && typeof mod.default === 'function') {\r\n      return { url, id: module, cls: mod.default as GenericConstructor<RuntimeScript<T>> };\r\n    } else {\r\n      console.error(`No runtime class exported from '${moduleName}'`);\r\n      return null;\r\n    }\r\n  }\r\n  /**\r\n   * Creates a script from a dynamic loaded class and attachs it to a host and returns the `RuntimeScript` instance.\r\n   *\r\n   * @typeParam T - Host type.\r\n   * @param host - The host object to attach the script to.\r\n   * @param classInfo - The dynamic loaded class information\r\n   * @returns The instantiated `RuntimeScript<T>` or `null` on failure.\r\n   */\r\n  async attachScriptIndirect<T extends Host>(\r\n    host: Nullable<T>,\r\n    classInfo: {\r\n      url: string;\r\n      id: string;\r\n      cls: GenericConstructor<RuntimeScript<T>>;\r\n    },\r\n    config?: Nullable<RuntimeScriptConfig>\r\n  ): Promise<Nullable<RuntimeScript<T>>> {\r\n    try {\r\n      const { url, id, cls } = classInfo;\r\n      let instance: Nullable<RuntimeScript<T>> = new cls();\r\n      if (instance instanceof RuntimeScript) {\r\n        applyRuntimeScriptConfig(instance, config);\r\n        if (!this._scriptHosts.has(instance)) {\r\n          const P = instance.onCreated();\r\n          if (P instanceof Promise) {\r\n            await P;\r\n          }\r\n        }\r\n      } else {\r\n        instance = null;\r\n      }\r\n      if (!instance) {\r\n        console.warn(`Script '${url}' does not have RuntimeScript class exported as default`);\r\n        return null;\r\n      }\r\n\r\n      let hostList = this._scriptHosts.get(instance);\r\n      if (!hostList) {\r\n        hostList = [];\r\n        this._scriptHosts.set(instance, hostList);\r\n      }\r\n      if (hostList.includes(host)) {\r\n        console.warn(`Script '${url}' already attached`);\r\n        return instance;\r\n      }\r\n      hostList.push(host);\r\n\r\n      const P = instance.onAttached(host);\r\n      if (P instanceof Promise) {\r\n        await P;\r\n      }\r\n\r\n      const attached: IAttachedScript = {\r\n        id,\r\n        url,\r\n        instance\r\n      };\r\n\r\n      let list = this._hostScripts.get(host);\r\n      if (!list) {\r\n        list = [];\r\n        this._hostScripts.set(host, list);\r\n        if (host) {\r\n          host.on('dispose', () => {\r\n            this.detachScript(host);\r\n          });\r\n        }\r\n      }\r\n      list.push(attached);\r\n\r\n      return attached.instance;\r\n    } catch (e) {\r\n      const moduleName = classInfo.id ? String(classInfo.id).slice(0, 64) : '';\r\n      console.error(`Load module '${moduleName}' failed: ${e}`);\r\n      this._onLoadError?.(e, classInfo.id);\r\n      return null;\r\n    }\r\n  }\r\n  /**\r\n   * Attaches a script to a host and returns the `RuntimeScript` instance.\r\n   *\r\n   * Process:\r\n   * 1. Resolve module ID to a runtime URL via the registry.\r\n   * 2. Dynamically import the module.\r\n   * 3. Instantiate the default export if it is a constructor.\r\n   * 4. If this is the first time the instance is seen, call `onCreated()`.\r\n   * 5. Link the instance to the host, and call `onAttached(host)`.\r\n   * 6. Subscribe to the host's `'dispose'` event to auto-detach.\r\n   *\r\n   * If the module cannot be resolved or does not export a default `RuntimeScript`\r\n   * subclass, a warning is logged and `null` is returned.\r\n   *\r\n   * @typeParam T - Host type.\r\n   * @param host - The host object to attach the script to.\r\n   * @param module - Module identifier used by the registry (logical ID or path).\r\n   * @returns The instantiated `RuntimeScript<T>` or `null` on failure.\r\n   */\r\n  async attachScript<T extends Host>(\r\n    host: Nullable<T>,\r\n    module: string,\r\n    config?: Nullable<RuntimeScriptConfig>\r\n  ): Promise<Nullable<RuntimeScript<T>>> {\r\n    const info = await this.loadRuntimeScriptClass(module);\r\n    return info ? await this.attachScriptIndirect(host, info, config) : null;\r\n  }\r\n\r\n  /**\r\n   * Detaches script(s) from a host.\r\n   *\r\n   * Behavior:\r\n   * - If `idOrInstance` is omitted, detaches all scripts from the host.\r\n   * - If a module ID is provided, detaches only the matching script.\r\n   * - If a `RuntimeScript` instance is provided, detaches that instance.\r\n   * - Invokes `onDetached(host)` on each detached instance.\r\n   * - If the instance has no remaining hosts, invokes `onDestroy()` and disposes tracking.\r\n   *\r\n   * @typeParam T - Host type.\r\n   * @param host - The host to detach from.\r\n   * @param idOrInstance - Optional module ID or script instance to target.\r\n   */\r\n  detachScript<T extends Host>(host: T, idOrInstance?: string | RuntimeScript<T>) {\r\n    const list = this._hostScripts.get(host);\r\n    if (!list || list.length === 0) {\r\n      return;\r\n    }\r\n    for (let i = list.length - 1; i >= 0; i--) {\r\n      const it = list[i];\r\n      const hit =\r\n        !idOrInstance || typeof idOrInstance === 'string'\r\n          ? it.id === idOrInstance\r\n          : it.instance === idOrInstance;\r\n      if (hit) {\r\n        list.splice(i, 1);\r\n        try {\r\n          it.instance.onDetached(host);\r\n        } catch (err) {\r\n          console.error(`Error occured at onDetach() of module '${it.id}': ${err}`);\r\n        }\r\n\r\n        const hostList = this._scriptHosts.get(it.instance);\r\n        if (hostList) {\r\n          const index = hostList.indexOf(host);\r\n          if (index >= 0) {\r\n            hostList.splice(index, 1);\r\n          }\r\n        }\r\n        if (!hostList || hostList.length === 0) {\r\n          try {\r\n            it.instance.onDestroy();\r\n          } catch (err) {\r\n            console.error(`Error occured at onDestroy() of module '${it.id}': ${err}`);\r\n          } finally {\r\n            this._scriptHosts.delete(it.instance);\r\n          }\r\n        }\r\n      }\r\n    }\r\n    if (list.length === 0) {\r\n      this._hostScripts.delete(host);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Get all script instances attached to a host.\r\n   *\r\n   * @typeParam T - Expected script type.\r\n   * @param host - The host whose scripts to retrieve.\r\n   * @returns Script instances attached to the host, or an empty array if none.\r\n   */\r\n  getScriptObjects<T extends RuntimeScript<any>>(host: unknown): T[] {\r\n    return (this._hostScripts.get(host as Host) as unknown as T[]) || [];\r\n  }\r\n\r\n  /**\r\n   * Ticks all attached script instances.\r\n   *\r\n   * Calls `onUpdate(deltaTime, elapsedTime)` on every attached script instance\r\n   * across all hosts. Exceptions thrown by a script are caught and logged,\r\n   * allowing other scripts to continue updating.\r\n   *\r\n   * @param deltaTime - Time in seconds since last update.\r\n   * @param elapsedTime - Total time in seconds since start.\r\n   */\r\n  update(deltaTime: number, elapsedTime: number) {\r\n    if (this._hostScripts.size === 0) {\r\n      return;\r\n    }\r\n    for (const list of this._hostScripts.values()) {\r\n      for (const s of list) {\r\n        try {\r\n          s.instance.onUpdate(deltaTime, elapsedTime);\r\n        } catch (err) {\r\n          console.error(`Error occured at onUpdate() of module '${s.id}': ${err}`);\r\n        }\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Detaches all scripts from all hosts.\r\n   *\r\n   * Iteratively calls {@link ScriptingSystem.detachScript} on each host until no attachments remain.\r\n   */\r\n  detachAllScripts() {\r\n    while (this._hostScripts.size > 0) {\r\n      for (const entry of this._hostScripts) {\r\n        if (entry[0]) {\r\n          this.detachScript(entry[0]);\r\n        }\r\n      }\r\n    }\r\n  }\r\n}\r\n"],"names":["ScriptingSystem","_registry","_hostScripts","_scriptHosts","_onLoadError","_importComment","opts","ScriptRegistry","VFS","HttpFS","scriptsRoot","Map","importComment","onLoadError","registry","loadRuntimeScriptClass","module","mod","moduleName","String","slice","url","resolveRuntimeUrl","e","console","error","default","id","cls","attachScriptIndirect","host","classInfo","config","instance","RuntimeScript","applyRuntimeScriptConfig","has","P","onCreated","Promise","warn","hostList","get","set","includes","push","onAttached","attached","list","on","detachScript","attachScript","info","idOrInstance","length","i","it","hit","splice","onDetached","err","index","indexOf","onDestroy","delete","getScriptObjects","update","deltaTime","elapsedTime","size","values","s","onUpdate","detachAllScripts","entry"],"mappings":"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"}
+{"version":3,"file":"scriptingsystem.js","sources":["../../src/app/scriptingsystem.ts"],"sourcesContent":["import type { GenericConstructor, IDisposable, Nullable, VFS } from '@zephyr3d/base';\r\nimport { HttpFS } from '@zephyr3d/base';\r\nimport { ScriptRegistry } from './scriptregistry';\r\nimport { applyRuntimeScriptConfig, RuntimeScript, type RuntimeScriptConfig } from './runtimescript';\r\n\r\nfunction resolveCreatedHook(instance: RuntimeScript<any>) {\r\n  if (instance.onCreated !== RuntimeScript.prototype.onCreated) {\r\n    return {\r\n      legacy: false,\r\n      hook: () => instance.onCreated()\r\n    };\r\n  }\r\n  const legacyHook = (instance as RuntimeScript<any> & { onCreate?: () => void | Promise<void> }).onCreate;\r\n  if (typeof legacyHook === 'function') {\r\n    return {\r\n      legacy: true,\r\n      hook: () => legacyHook.call(instance)\r\n    };\r\n  }\r\n  return {\r\n    legacy: false,\r\n    hook: () => instance.onCreated()\r\n  };\r\n}\r\n\r\n/**\r\n * A host object that supports disposal.\r\n *\r\n * Hosts are objects to which scripts can be attached. They are expected to\r\n * emit a `'dispose'` event compatible with `IDisposable` so that scripts\r\n * can be automatically detached when the host is destroyed.\r\n *\r\n * @public\r\n */\r\nexport type Host = IDisposable;\r\n\r\n/**\r\n * Options for configuring a `ScriptingSystem`.\r\n *\r\n * @public\r\n */\r\nexport type ScriptingSystemOptions = {\r\n  /** Virtual file system used by the script registry. Defaults to `new HttpFS('./')`. */\r\n  VFS?: VFS;\r\n  /** Root path for scripts within the VFS. Defaults to `/`. */\r\n  scriptsRoot?: string;\r\n  /**\r\n   * Optional string appended to dynamic import URLs (e.g., for cache busting).\r\n   * Example: `'?v=' + Date.now()`\r\n   */\r\n  importComment?: string;\r\n  /**\r\n   * Optional callback invoked when a module fails to load.\r\n   * @param e - The error that occurred.\r\n   * @param id - The module ID that failed to load.\r\n   */\r\n  onLoadError?: (e: unknown, id: string) => void;\r\n};\r\n\r\n/**\r\n * Information about a script attached to a host.\r\n *\r\n * @public\r\n */\r\nexport interface IAttachedScript {\r\n  /** The logical module identifier used to resolve the script. */\r\n  id: string;\r\n  /** The resolved runtime URL used for dynamic import. */\r\n  url: string;\r\n  /** The instantiated runtime script. */\r\n  instance: RuntimeScript<any>;\r\n}\r\n\r\n/**\r\n * Script system that resolves, loads, and manages lifecycle of runtime scripts.\r\n *\r\n * Responsibilities:\r\n * - Resolves module IDs to URLs via {@link ScriptRegistry}\r\n * - Dynamically imports modules and instantiates a `RuntimeScript` (default export)\r\n * - Tracks attachments between hosts and script instances\r\n * - Bridges script lifecycle hooks: `onCreated`, `onAttached`, `onDetached`, `onDestroy`, `onUpdate`\r\n * - Auto-detaches scripts when a host is disposed\r\n *\r\n * Notes:\r\n * - Multiple hosts can reference the same `RuntimeScript` instance; destruction\r\n *   occurs when the last host detaches.\r\n * - Errors during load/attach/update are caught and logged; an optional\r\n *   `onLoadError` callback can be provided.\r\n *\r\n * @public\r\n */\r\nexport class ScriptingSystem {\r\n  private _registry: ScriptRegistry;\r\n  private _hostScripts: Map<Nullable<Host>, IAttachedScript[]>;\r\n  private _scriptHosts: Map<RuntimeScript<any>, Nullable<Host>[]>;\r\n  private _onLoadError?: (e: unknown, id: string) => void;\r\n  private _importComment?: string;\r\n\r\n  /**\r\n   * Constructs a new scripting system.\r\n   *\r\n   * @param opts - Optional configuration.\r\n   */\r\n  constructor(opts: ScriptingSystemOptions = {}) {\r\n    this._registry = new ScriptRegistry(opts.VFS ?? new HttpFS('./'), opts.scriptsRoot ?? '/');\r\n    this._hostScripts = new Map();\r\n    this._scriptHosts = new Map();\r\n    this._importComment = opts.importComment;\r\n    this._onLoadError = opts.onLoadError;\r\n  }\r\n\r\n  /**\r\n   * Accessor for the underlying script registry used for module resolution.\r\n   */\r\n  get registry() {\r\n    return this._registry;\r\n  }\r\n  /**\r\n   * Loads a runtime script class from file\r\n   * @param module - file path\r\n   * @returns The runtime script class or null\r\n   */\r\n  async loadRuntimeScriptClass<T extends Host = Host>(\r\n    module: string\r\n  ): Promise<\r\n    Nullable<{\r\n      url: string;\r\n      id: string;\r\n      cls: GenericConstructor<RuntimeScript<T>>;\r\n    }>\r\n  > {\r\n    let mod: any = null;\r\n    const moduleName = module ? String(module).slice(0, 64) : '';\r\n    let url = '';\r\n    try {\r\n      url = await this._registry.resolveRuntimeUrl(module);\r\n      if (!url) {\r\n        return null;\r\n      }\r\n      mod = await import(url + (this._importComment ?? ''));\r\n    } catch (e) {\r\n      console.error(`Load module '${moduleName}' failed: ${e}`);\r\n    }\r\n    if (mod && typeof mod.default === 'function') {\r\n      return { url, id: module, cls: mod.default as GenericConstructor<RuntimeScript<T>> };\r\n    } else {\r\n      console.error(`No runtime class exported from '${moduleName}'`);\r\n      return null;\r\n    }\r\n  }\r\n  /**\r\n   * Creates a script from a dynamic loaded class and attachs it to a host and returns the `RuntimeScript` instance.\r\n   *\r\n   * @typeParam T - Host type.\r\n   * @param host - The host object to attach the script to.\r\n   * @param classInfo - The dynamic loaded class information\r\n   * @returns The instantiated `RuntimeScript<T>` or `null` on failure.\r\n   */\r\n  async attachScriptIndirect<T extends Host>(\r\n    host: Nullable<T>,\r\n    classInfo: {\r\n      url: string;\r\n      id: string;\r\n      cls: GenericConstructor<RuntimeScript<T>>;\r\n    },\r\n    config?: Nullable<RuntimeScriptConfig>\r\n  ): Promise<Nullable<RuntimeScript<T>>> {\r\n    try {\r\n      const { url, id, cls } = classInfo;\r\n      let instance: Nullable<RuntimeScript<T>> = new cls();\r\n      if (instance instanceof RuntimeScript) {\r\n        applyRuntimeScriptConfig(instance, config);\r\n        if (!this._scriptHosts.has(instance)) {\r\n          const createdHook = resolveCreatedHook(instance);\r\n          if (createdHook.legacy) {\r\n            console.warn(`Script '${id}' uses deprecated onCreate(); rename it to onCreated().`);\r\n          }\r\n          const P = createdHook.hook();\r\n          if (P instanceof Promise) {\r\n            await P;\r\n          }\r\n        }\r\n      } else {\r\n        instance = null;\r\n      }\r\n      if (!instance) {\r\n        console.warn(`Script '${url}' does not have RuntimeScript class exported as default`);\r\n        return null;\r\n      }\r\n\r\n      let hostList = this._scriptHosts.get(instance);\r\n      if (!hostList) {\r\n        hostList = [];\r\n        this._scriptHosts.set(instance, hostList);\r\n      }\r\n      if (hostList.includes(host)) {\r\n        console.warn(`Script '${url}' already attached`);\r\n        return instance;\r\n      }\r\n      hostList.push(host);\r\n\r\n      const P = instance.onAttached(host);\r\n      if (P instanceof Promise) {\r\n        await P;\r\n      }\r\n\r\n      const attached: IAttachedScript = {\r\n        id,\r\n        url,\r\n        instance\r\n      };\r\n\r\n      let list = this._hostScripts.get(host);\r\n      if (!list) {\r\n        list = [];\r\n        this._hostScripts.set(host, list);\r\n        if (host) {\r\n          host.on('dispose', () => {\r\n            this.detachScript(host);\r\n          });\r\n        }\r\n      }\r\n      list.push(attached);\r\n\r\n      return attached.instance;\r\n    } catch (e) {\r\n      const moduleName = classInfo.id ? String(classInfo.id).slice(0, 64) : '';\r\n      console.error(`Load module '${moduleName}' failed: ${e}`);\r\n      this._onLoadError?.(e, classInfo.id);\r\n      return null;\r\n    }\r\n  }\r\n  /**\r\n   * Attaches a script to a host and returns the `RuntimeScript` instance.\r\n   *\r\n   * Process:\r\n   * 1. Resolve module ID to a runtime URL via the registry.\r\n   * 2. Dynamically import the module.\r\n   * 3. Instantiate the default export if it is a constructor.\r\n   * 4. If this is the first time the instance is seen, call `onCreated()`.\r\n   * 5. Link the instance to the host, and call `onAttached(host)`.\r\n   * 6. Subscribe to the host's `'dispose'` event to auto-detach.\r\n   *\r\n   * If the module cannot be resolved or does not export a default `RuntimeScript`\r\n   * subclass, a warning is logged and `null` is returned.\r\n   *\r\n   * @typeParam T - Host type.\r\n   * @param host - The host object to attach the script to.\r\n   * @param module - Module identifier used by the registry (logical ID or path).\r\n   * @returns The instantiated `RuntimeScript<T>` or `null` on failure.\r\n   */\r\n  async attachScript<T extends Host>(\r\n    host: Nullable<T>,\r\n    module: string,\r\n    config?: Nullable<RuntimeScriptConfig>\r\n  ): Promise<Nullable<RuntimeScript<T>>> {\r\n    const info = await this.loadRuntimeScriptClass(module);\r\n    return info ? await this.attachScriptIndirect(host, info, config) : null;\r\n  }\r\n\r\n  /**\r\n   * Detaches script(s) from a host.\r\n   *\r\n   * Behavior:\r\n   * - If `idOrInstance` is omitted, detaches all scripts from the host.\r\n   * - If a module ID is provided, detaches only the matching script.\r\n   * - If a `RuntimeScript` instance is provided, detaches that instance.\r\n   * - Invokes `onDetached(host)` on each detached instance.\r\n   * - If the instance has no remaining hosts, invokes `onDestroy()` and disposes tracking.\r\n   *\r\n   * @typeParam T - Host type.\r\n   * @param host - The host to detach from.\r\n   * @param idOrInstance - Optional module ID or script instance to target.\r\n   */\r\n  detachScript<T extends Host>(host: T, idOrInstance?: string | RuntimeScript<T>) {\r\n    const list = this._hostScripts.get(host);\r\n    if (!list || list.length === 0) {\r\n      return;\r\n    }\r\n    for (let i = list.length - 1; i >= 0; i--) {\r\n      const it = list[i];\r\n      const hit =\r\n        !idOrInstance || typeof idOrInstance === 'string'\r\n          ? it.id === idOrInstance\r\n          : it.instance === idOrInstance;\r\n      if (hit) {\r\n        list.splice(i, 1);\r\n        try {\r\n          it.instance.onDetached(host);\r\n        } catch (err) {\r\n          console.error(`Error occured at onDetach() of module '${it.id}': ${err}`);\r\n        }\r\n\r\n        const hostList = this._scriptHosts.get(it.instance);\r\n        if (hostList) {\r\n          const index = hostList.indexOf(host);\r\n          if (index >= 0) {\r\n            hostList.splice(index, 1);\r\n          }\r\n        }\r\n        if (!hostList || hostList.length === 0) {\r\n          try {\r\n            it.instance.onDestroy();\r\n          } catch (err) {\r\n            console.error(`Error occured at onDestroy() of module '${it.id}': ${err}`);\r\n          } finally {\r\n            this._scriptHosts.delete(it.instance);\r\n          }\r\n        }\r\n      }\r\n    }\r\n    if (list.length === 0) {\r\n      this._hostScripts.delete(host);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Get all script instances attached to a host.\r\n   *\r\n   * @typeParam T - Expected script type.\r\n   * @param host - The host whose scripts to retrieve.\r\n   * @returns Script instances attached to the host, or an empty array if none.\r\n   */\r\n  getScriptObjects<T extends RuntimeScript<any>>(host: unknown): T[] {\r\n    return (this._hostScripts.get(host as Host) as unknown as T[]) || [];\r\n  }\r\n\r\n  /**\r\n   * Ticks all attached script instances.\r\n   *\r\n   * Calls `onUpdate(deltaTime, elapsedTime)` on every attached script instance\r\n   * across all hosts. Exceptions thrown by a script are caught and logged,\r\n   * allowing other scripts to continue updating.\r\n   *\r\n   * @param deltaTime - Time in seconds since last update.\r\n   * @param elapsedTime - Total time in seconds since start.\r\n   */\r\n  update(deltaTime: number, elapsedTime: number) {\r\n    if (this._hostScripts.size === 0) {\r\n      return;\r\n    }\r\n    for (const list of this._hostScripts.values()) {\r\n      for (const s of list) {\r\n        try {\r\n          s.instance.onUpdate(deltaTime, elapsedTime);\r\n        } catch (err) {\r\n          console.error(`Error occured at onUpdate() of module '${s.id}': ${err}`);\r\n        }\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Detaches all scripts from all hosts.\r\n   *\r\n   * Iteratively calls {@link ScriptingSystem.detachScript} on each host until no attachments remain.\r\n   */\r\n  detachAllScripts() {\r\n    while (this._hostScripts.size > 0) {\r\n      for (const entry of this._hostScripts) {\r\n        if (entry[0]) {\r\n          this.detachScript(entry[0]);\r\n        }\r\n      }\r\n    }\r\n  }\r\n}\r\n"],"names":["resolveCreatedHook","instance","onCreated","RuntimeScript","prototype","legacy","hook","legacyHook","onCreate","call","ScriptingSystem","_registry","_hostScripts","_scriptHosts","_onLoadError","_importComment","opts","ScriptRegistry","VFS","HttpFS","scriptsRoot","Map","importComment","onLoadError","registry","loadRuntimeScriptClass","module","mod","moduleName","String","slice","url","resolveRuntimeUrl","e","console","error","default","id","cls","attachScriptIndirect","host","classInfo","config","applyRuntimeScriptConfig","has","createdHook","warn","P","Promise","hostList","get","set","includes","push","onAttached","attached","list","on","detachScript","attachScript","info","idOrInstance","length","i","it","hit","splice","onDetached","err","index","indexOf","onDestroy","delete","getScriptObjects","update","deltaTime","elapsedTime","size","values","s","onUpdate","detachAllScripts","entry"],"mappings":"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"}

package/dist/app/scriptregistry.js

@@ -83,6 +83,27 @@ import { getApp } from './api.js';
         this._scriptsRoot = path;
     }
     /**
+   * Invalidates cached built module output for one logical module id, or clears the full cache.
+   *
+   * Pass the same logical id shape that callers use with {@link ScriptRegistry.resolveRuntimeUrl},
+   * for example `/assets/scripts/foo.ts`, `/assets/scripts/foo.js`, or `/assets/scripts/foo`.
+   *
+   * @param moduleId - Optional logical module id to invalidate. Omit to clear the entire build cache.
+   */ invalidate(moduleId) {
+        if (!moduleId) {
+            this._built.clear();
+            return;
+        }
+        const normalized = String(moduleId);
+        this._built.delete(normalized);
+        if (normalized.endsWith('.ts') || normalized.endsWith('.js')) {
+            this._built.delete(normalized.slice(0, -3));
+        } else {
+            this._built.delete(`${normalized}.ts`);
+            this._built.delete(`${normalized}.js`);
+        }
+    }
+    /**
    * Fetches raw source for a logical module id by probing known extensions.
    *
    * Search order:
@@ -325,7 +346,7 @@ import { getApp } from './api.js';
                 const depId = await this.resolveLogicalId(spec, String(fromId));
                 replacement = await this.build(depId); // recursively build as dataURL
             }
-            out += replacement; // 不加引号
+            out += replacement; // Do not wrap in quotes
             last = im.e;
         }
         out += code.slice(last);