@zephyr3d/scene 0.7.0 → 0.8.0

package/dist/animation/spring_modifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spring_modifier.js","sources":["../../src/animation/spring_modifier.ts"],"sourcesContent":["import { SkeletonModifier } from './skeleton_modifier';\r\nimport type { Skeleton } from './skeleton';\r\nimport type { SpringSystem } from './spring/spring_system';\r\n\r\n/**\r\n * Post-processor wrapper for spring physics systems.\r\n *\r\n * Integrates spring-based physics simulation into the skeleton post-processing pipeline.\r\n * The spring system is updated each frame and results are blended with the base animation.\r\n *\r\n * @public\r\n */\r\nexport class SpringModifier extends SkeletonModifier {\r\n  private _springSystem: SpringSystem;\r\n\r\n  /**\r\n   * Create a spring post-processor.\r\n   *\r\n   * @param springSystem - The spring system to integrate\r\n   * @param weight - Blend weight [0-1] (default: 1.0)\r\n   */\r\n  constructor(springSystem: SpringSystem, weight: number = 1.0) {\r\n    super(weight);\r\n    this._springSystem = springSystem;\r\n  }\r\n\r\n  /**\r\n   * Get the spring system.\r\n   */\r\n  get springSystem(): SpringSystem {\r\n    return this._springSystem;\r\n  }\r\n\r\n  /**\r\n   * Apply spring physics to skeleton joints.\r\n   */\r\n  apply(_skeleton: Skeleton, deltaTime: number): void {\r\n    if (!this._enabled || this._weight <= 0) {\r\n      return;\r\n    }\r\n\r\n    // Update spring physics simulation\r\n    this._springSystem.update(deltaTime);\r\n\r\n    // Apply results to scene nodes with blending\r\n    this._springSystem.applyToNodes(this._weight);\r\n  }\r\n\r\n  /**\r\n   * Reset the spring system to initial state.\r\n   */\r\n  reset(): void {\r\n    this._springSystem.reset();\r\n  }\r\n}\r\n"],"names":["SpringModifier","SkeletonModifier","_springSystem","springSystem","weight","apply","_skeleton","deltaTime","_enabled","_weight","update","applyToNodes","reset"],"mappings":";;AAIA;;;;;;;IAQO,MAAMA,cAAuBC,SAAAA,gBAAAA,CAAAA;IAC1BC,aAA4B;AAEpC;;;;;AAKC,MACD,WAAYC,CAAAA,YAA0B,EAAEC,MAAAA,GAAiB,GAAG,CAAE;AAC5D,QAAA,KAAK,CAACA,MAAAA,CAAAA;QACN,IAAI,CAACF,aAAa,GAAGC,YAAAA;AACvB;AAEA;;AAEC,MACD,IAAIA,YAA6B,GAAA;QAC/B,OAAO,IAAI,CAACD,aAAa;AAC3B;AAEA;;AAEC,MACDG,KAAMC,CAAAA,SAAmB,EAAEC,SAAiB,EAAQ;QAClD,IAAI,CAAC,IAAI,CAACC,QAAQ,IAAI,IAAI,CAACC,OAAO,IAAI,CAAG,EAAA;AACvC,YAAA;AACF;;AAGA,QAAA,IAAI,CAACP,aAAa,CAACQ,MAAM,CAACH,SAAAA,CAAAA;;AAG1B,QAAA,IAAI,CAACL,aAAa,CAACS,YAAY,CAAC,IAAI,CAACF,OAAO,CAAA;AAC9C;AAEA;;AAEC,MACDG,KAAc,GAAA;QACZ,IAAI,CAACV,aAAa,CAACU,KAAK,EAAA;AAC1B;AACF;;;;"}

package/dist/animation/spring_postprocessor.js

@@ -0,0 +1,54 @@
+import { SkeletonPostProcessor } from './skeleton_postprocessor.js';
+
+/**
+ * Post-processor wrapper for spring physics systems.
+ *
+ * Integrates spring-based physics simulation into the skeleton post-processing pipeline.
+ * The spring system is updated each frame and results are blended with the base animation.
+ *
+ * @example
+ * ```typescript
+ * const springChain = new SpringChain([joint1, joint2, joint3]);
+ * const springSystem = new SpringSystem(springChain);
+ * const processor = new SpringPostProcessor(springSystem, 1.0);
+ * skeleton.addPostProcessor(processor);
+ * ```
+ *
+ * @public
+ */ class SpringPostProcessor extends SkeletonPostProcessor {
+    _springSystem;
+    /**
+   * Create a spring post-processor.
+   *
+   * @param springSystem - The spring system to integrate
+   * @param weight - Blend weight [0-1] (default: 1.0)
+   * @param priority - Priority for ordering (default: 50)
+   */ constructor(springSystem, weight = 1.0, priority = 50){
+        super(weight, priority);
+        this._springSystem = springSystem;
+    }
+    /**
+   * Get the spring system.
+   */ get springSystem() {
+        return this._springSystem;
+    }
+    /**
+   * Apply spring physics to skeleton joints.
+   */ apply(_skeleton, deltaTime) {
+        if (!this._enabled || this._weight <= 0) {
+            return;
+        }
+        // Update spring physics simulation
+        this._springSystem.update(deltaTime);
+        // Apply results to scene nodes with blending
+        this._springSystem.applyToNodes(this._weight);
+    }
+    /**
+   * Reset the spring system to initial state.
+   */ reset() {
+        this._springSystem.reset();
+    }
+}
+
+export { SpringPostProcessor };
+//# sourceMappingURL=spring_postprocessor.js.map

package/dist/animation/spring_postprocessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spring_postprocessor.js","sources":["../../src/animation/spring_postprocessor.ts"],"sourcesContent":["import { SkeletonPostProcessor } from './skeleton_postprocessor';\r\nimport type { Skeleton } from './skeleton';\r\nimport type { SpringSystem } from './spring/spring_system';\r\n\r\n/**\r\n * Post-processor wrapper for spring physics systems.\r\n *\r\n * Integrates spring-based physics simulation into the skeleton post-processing pipeline.\r\n * The spring system is updated each frame and results are blended with the base animation.\r\n *\r\n * @example\r\n * ```typescript\r\n * const springChain = new SpringChain([joint1, joint2, joint3]);\r\n * const springSystem = new SpringSystem(springChain);\r\n * const processor = new SpringPostProcessor(springSystem, 1.0);\r\n * skeleton.addPostProcessor(processor);\r\n * ```\r\n *\r\n * @public\r\n */\r\nexport class SpringPostProcessor extends SkeletonPostProcessor {\r\n  private _springSystem: SpringSystem;\r\n\r\n  /**\r\n   * Create a spring post-processor.\r\n   *\r\n   * @param springSystem - The spring system to integrate\r\n   * @param weight - Blend weight [0-1] (default: 1.0)\r\n   * @param priority - Priority for ordering (default: 50)\r\n   */\r\n  constructor(springSystem: SpringSystem, weight: number = 1.0, priority: number = 50) {\r\n    super(weight, priority);\r\n    this._springSystem = springSystem;\r\n  }\r\n\r\n  /**\r\n   * Get the spring system.\r\n   */\r\n  get springSystem(): SpringSystem {\r\n    return this._springSystem;\r\n  }\r\n\r\n  /**\r\n   * Apply spring physics to skeleton joints.\r\n   */\r\n  apply(_skeleton: Skeleton, deltaTime: number): void {\r\n    if (!this._enabled || this._weight <= 0) {\r\n      return;\r\n    }\r\n\r\n    // Update spring physics simulation\r\n    this._springSystem.update(deltaTime);\r\n\r\n    // Apply results to scene nodes with blending\r\n    this._springSystem.applyToNodes(this._weight);\r\n  }\r\n\r\n  /**\r\n   * Reset the spring system to initial state.\r\n   */\r\n  reset(): void {\r\n    this._springSystem.reset();\r\n  }\r\n}\r\n"],"names":["SpringPostProcessor","SkeletonPostProcessor","_springSystem","springSystem","weight","priority","apply","_skeleton","deltaTime","_enabled","_weight","update","applyToNodes","reset"],"mappings":";;AAIA;;;;;;;;;;;;;;;IAgBO,MAAMA,mBAA4BC,SAAAA,qBAAAA,CAAAA;IAC/BC,aAA4B;AAEpC;;;;;;MAOA,WAAA,CAAYC,YAA0B,EAAEC,MAAAA,GAAiB,GAAG,EAAEC,QAAAA,GAAmB,EAAE,CAAE;AACnF,QAAA,KAAK,CAACD,MAAQC,EAAAA,QAAAA,CAAAA;QACd,IAAI,CAACH,aAAa,GAAGC,YAAAA;AACvB;AAEA;;AAEC,MACD,IAAIA,YAA6B,GAAA;QAC/B,OAAO,IAAI,CAACD,aAAa;AAC3B;AAEA;;AAEC,MACDI,KAAMC,CAAAA,SAAmB,EAAEC,SAAiB,EAAQ;QAClD,IAAI,CAAC,IAAI,CAACC,QAAQ,IAAI,IAAI,CAACC,OAAO,IAAI,CAAG,EAAA;AACvC,YAAA;AACF;;AAGA,QAAA,IAAI,CAACR,aAAa,CAACS,MAAM,CAACH,SAAAA,CAAAA;;AAG1B,QAAA,IAAI,CAACN,aAAa,CAACU,YAAY,CAAC,IAAI,CAACF,OAAO,CAAA;AAC9C;AAEA;;AAEC,MACDG,KAAc,GAAA;QACZ,IAAI,CAACX,aAAa,CAACW,KAAK,EAAA;AAC1B;AACF;;;;"}

package/dist/animation/translationtrack.js

@@ -10,7 +10,6 @@ import { AnimationTrack } from './animationtrack.js';
     constructor(modeOrInterpolator, keyFramesOrEmbedded, embedded){
         if (modeOrInterpolator === undefined) {
             super(false);
-            this._interpolator = null;
         } else if (modeOrInterpolator instanceof Interpolator) {
             if (modeOrInterpolator.target !== 'vec3') {
                 throw new Error(`TranslationTrack(): interpolator target must be 'vec3'`);

package/dist/animation/translationtrack.js.map

@@ -1 +1 @@
-{"version":3,"file":"translationtrack.js","sources":["../../src/animation/translationtrack.ts"],"sourcesContent":["import type { InterpolationMode } from '@zephyr3d/base';\r\nimport { Interpolator, Vector3 } from '@zephyr3d/base';\r\nimport { AnimationTrack } from './animationtrack';\r\nimport type { SceneNode } from '../scene';\r\n\r\n/**\r\n * Translate animation track\r\n * @public\r\n */\r\nexport class NodeTranslationTrack extends AnimationTrack<Vector3> {\r\n  private readonly _state: Vector3;\r\n  private _interpolator: Interpolator;\r\n  /**\r\n   * Create an instance of TranslationTrack\r\n   */\r\n  constructor();\r\n  /**\r\n   * Create an instance of TranslationTrack from keyframe values\r\n   * @param interpolator - Interpolator object that contains the keyframe values\r\n   * @param embedded - Whether this track be an embedded track\r\n   */\r\n  constructor(interpolator: Interpolator, embedded?: boolean);\r\n  /**\r\n   * Create an instance of TranslationTrack from keyframe values\r\n   * @param mode - The interpolation mode of keyframes\r\n   * @param keyFrames - Keyframe values\r\n   * @param embedded - Whether this track be an embedded track\r\n   */\r\n  constructor(mode: InterpolationMode, keyFrames: { time: number; value: Vector3 }[], embedded?: boolean);\r\n  constructor(\r\n    modeOrInterpolator?: Interpolator | InterpolationMode,\r\n    keyFramesOrEmbedded?: { time: number; value: Vector3 }[] | boolean,\r\n    embedded?: boolean\r\n  ) {\r\n    if (modeOrInterpolator === undefined) {\r\n      super(false);\r\n      this._interpolator = null;\r\n    } else if (modeOrInterpolator instanceof Interpolator) {\r\n      if (modeOrInterpolator.target !== 'vec3') {\r\n        throw new Error(`TranslationTrack(): interpolator target must be 'vec3'`);\r\n      }\r\n      super((keyFramesOrEmbedded as boolean) ?? false);\r\n      this._interpolator = modeOrInterpolator;\r\n    } else {\r\n      const keyFrames = keyFramesOrEmbedded as { time: number; value: Vector3 }[];\r\n      const inputs = new Float32Array(keyFrames.map((val) => val.time));\r\n      const outputs = new Float32Array(keyFrames.length * 3);\r\n      for (let i = 0; i < keyFrames.length; i++) {\r\n        outputs[i * 3 + 0] = keyFrames[i].value.x;\r\n        outputs[i * 3 + 1] = keyFrames[i].value.y;\r\n        outputs[i * 3 + 2] = keyFrames[i].value.z;\r\n      }\r\n      super(embedded ?? false);\r\n      this._interpolator = new Interpolator(modeOrInterpolator, 'vec3', inputs, outputs);\r\n    }\r\n    this._state = new Vector3();\r\n    this._jointIndex = -1;\r\n  }\r\n  get interpolator() {\r\n    return this._interpolator;\r\n  }\r\n  set interpolator(interp: Interpolator) {\r\n    if (interp && interp.target !== 'vec3') {\r\n      throw new Error(`TranslationTrack(): interpolator target must be 'vec3'`);\r\n    }\r\n    this._interpolator = interp ?? null;\r\n  }\r\n  /** {@inheritDoc AnimationTrack.calculateState} */\r\n  calculateState(target: object, currentTime: number): Vector3 {\r\n    this._interpolator.interpolate(currentTime, this._state);\r\n    return this._state;\r\n  }\r\n  /** {@inheritDoc AnimationTrack.applyState} */\r\n  applyState(node: SceneNode, state: Vector3) {\r\n    node.position.set(state);\r\n  }\r\n  /** {@inheritDoc AnimationTrack.mixState} */\r\n  mixState(a: Vector3, b: Vector3, t: number): Vector3 {\r\n    return new Vector3(a.x + t * (b.x - a.x), a.y + t * (b.y - a.y), a.z + t * (b.z - a.z));\r\n  }\r\n  /** {@inheritDoc AnimationTrack.getBlendId} */\r\n  getBlendId(): unknown {\r\n    return 'node-translation';\r\n  }\r\n  /** {@inheritDoc AnimationTrack.getDuration} */\r\n  getDuration(): number {\r\n    return this._interpolator.maxTime;\r\n  }\r\n}\r\n"],"names":["NodeTranslationTrack","AnimationTrack","_state","_interpolator","modeOrInterpolator","keyFramesOrEmbedded","embedded","undefined","Interpolator","target","Error","keyFrames","inputs","Float32Array","map","val","time","outputs","length","i","value","x","y","z","Vector3","_jointIndex","interpolator","interp","calculateState","currentTime","interpolate","applyState","node","state","position","set","mixState","a","b","t","getBlendId","getDuration","maxTime"],"mappings":"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"}
+{"version":3,"file":"translationtrack.js","sources":["../../src/animation/translationtrack.ts"],"sourcesContent":["import type { InterpolationMode } from '@zephyr3d/base';\r\nimport { Interpolator, Vector3 } from '@zephyr3d/base';\r\nimport { AnimationTrack } from './animationtrack';\r\nimport type { SceneNode } from '../scene';\r\n\r\n/**\r\n * Translate animation track\r\n * @public\r\n */\r\nexport class NodeTranslationTrack extends AnimationTrack<Vector3> {\r\n  private readonly _state: Vector3;\r\n  private _interpolator!: Interpolator;\r\n  /**\r\n   * Create an instance of TranslationTrack\r\n   */\r\n  constructor();\r\n  /**\r\n   * Create an instance of TranslationTrack from keyframe values\r\n   * @param interpolator - Interpolator object that contains the keyframe values\r\n   * @param embedded - Whether this track be an embedded track\r\n   */\r\n  constructor(interpolator: Interpolator, embedded?: boolean);\r\n  /**\r\n   * Create an instance of TranslationTrack from keyframe values\r\n   * @param mode - The interpolation mode of keyframes\r\n   * @param keyFrames - Keyframe values\r\n   * @param embedded - Whether this track be an embedded track\r\n   */\r\n  constructor(mode: InterpolationMode, keyFrames: { time: number; value: Vector3 }[], embedded?: boolean);\r\n  constructor(\r\n    modeOrInterpolator?: Interpolator | InterpolationMode,\r\n    keyFramesOrEmbedded?: { time: number; value: Vector3 }[] | boolean,\r\n    embedded?: boolean\r\n  ) {\r\n    if (modeOrInterpolator === undefined) {\r\n      super(false);\r\n    } else if (modeOrInterpolator instanceof Interpolator) {\r\n      if (modeOrInterpolator.target !== 'vec3') {\r\n        throw new Error(`TranslationTrack(): interpolator target must be 'vec3'`);\r\n      }\r\n      super((keyFramesOrEmbedded as boolean) ?? false);\r\n      this._interpolator = modeOrInterpolator;\r\n    } else {\r\n      const keyFrames = keyFramesOrEmbedded as { time: number; value: Vector3 }[];\r\n      const inputs = new Float32Array(keyFrames.map((val) => val.time));\r\n      const outputs = new Float32Array(keyFrames.length * 3);\r\n      for (let i = 0; i < keyFrames.length; i++) {\r\n        outputs[i * 3 + 0] = keyFrames[i].value.x;\r\n        outputs[i * 3 + 1] = keyFrames[i].value.y;\r\n        outputs[i * 3 + 2] = keyFrames[i].value.z;\r\n      }\r\n      super(embedded ?? false);\r\n      this._interpolator = new Interpolator(modeOrInterpolator, 'vec3', inputs, outputs);\r\n    }\r\n    this._state = new Vector3();\r\n    this._jointIndex = -1;\r\n  }\r\n  get interpolator() {\r\n    return this._interpolator;\r\n  }\r\n  set interpolator(interp: Interpolator) {\r\n    if (interp && interp.target !== 'vec3') {\r\n      throw new Error(`TranslationTrack(): interpolator target must be 'vec3'`);\r\n    }\r\n    this._interpolator = interp ?? null;\r\n  }\r\n  /** {@inheritDoc AnimationTrack.calculateState} */\r\n  calculateState(target: object, currentTime: number) {\r\n    this._interpolator.interpolate(currentTime, this._state);\r\n    return this._state;\r\n  }\r\n  /** {@inheritDoc AnimationTrack.applyState} */\r\n  applyState(node: SceneNode, state: Vector3) {\r\n    node.position.set(state);\r\n  }\r\n  /** {@inheritDoc AnimationTrack.mixState} */\r\n  mixState(a: Vector3, b: Vector3, t: number) {\r\n    return new Vector3(a.x + t * (b.x - a.x), a.y + t * (b.y - a.y), a.z + t * (b.z - a.z));\r\n  }\r\n  /** {@inheritDoc AnimationTrack.getBlendId} */\r\n  getBlendId() {\r\n    return 'node-translation';\r\n  }\r\n  /** {@inheritDoc AnimationTrack.getDuration} */\r\n  getDuration() {\r\n    return this._interpolator.maxTime;\r\n  }\r\n}\r\n"],"names":["NodeTranslationTrack","AnimationTrack","_state","_interpolator","modeOrInterpolator","keyFramesOrEmbedded","embedded","undefined","Interpolator","target","Error","keyFrames","inputs","Float32Array","map","val","time","outputs","length","i","value","x","y","z","Vector3","_jointIndex","interpolator","interp","calculateState","currentTime","interpolate","applyState","node","state","position","set","mixState","a","b","t","getBlendId","getDuration","maxTime"],"mappings":"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"}

package/dist/app/api.js

@@ -11,6 +11,15 @@
  */ function getApp() {
     return appInstance;
 }
+/**
+ * Singleton accessor for the current Application instance.
+ *
+ * @returns The Application singleton.
+ *
+ * @public
+ */ function tryGetApp() {
+    return appInstance ?? null;
+}
 /**
  * Singleton accessor for the current engine instance.
  *
@@ -18,7 +27,7 @@
  *
  * @public
  */ function getEngine() {
-    return appInstance?.engine ?? null;
+    return appInstance.engine;
 }
 /**
  * Singleton accessor for the device instance.
@@ -27,7 +36,7 @@
  *
  * @public
  */ function getDevice() {
-    return appInstance?.device ?? null;
+    return appInstance.device;
 }
 /**
  * Singleton accessor for the input manager instance.
@@ -36,8 +45,8 @@
  *
  * @public
  */ function getInput() {
-    return appInstance?.inputManager ?? null;
+    return appInstance.inputManager;
 }
 
-export { appInstance, getApp, getDevice, getEngine, getInput, setApp };
+export { appInstance, getApp, getDevice, getEngine, getInput, setApp, tryGetApp };
 //# sourceMappingURL=api.js.map

package/dist/app/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sources":["../../src/app/api.ts"],"sourcesContent":["import type { AbstractDevice } from '@zephyr3d/device';\r\nimport type { Application } from './app';\r\nimport type { Engine } from './engine';\r\nimport type { InputManager } from '.';\r\n\r\n/** @internal */\r\nexport let appInstance: Application;\r\n\r\n/** @internal */\r\nexport function setApp(app: Application) {\r\n  appInstance = app;\r\n}\r\n\r\n/**\r\n * Singleton accessor for the current Application instance.\r\n *\r\n * @returns The Application singleton.\r\n *\r\n * @public\r\n */\r\n\r\nexport function getApp(): Application {\r\n  return appInstance;\r\n}\r\n\r\n/**\r\n * Singleton accessor for the current engine instance.\r\n *\r\n * @returns The engine singleton.\r\n *\r\n * @public\r\n */\r\nexport function getEngine(): Engine {\r\n  return appInstance?.engine ?? null;\r\n}\r\n\r\n/**\r\n * Singleton accessor for the device instance.\r\n *\r\n * @returns The device singleton.\r\n *\r\n * @public\r\n */\r\nexport function getDevice(): AbstractDevice {\r\n  return appInstance?.device ?? null;\r\n}\r\n\r\n/**\r\n * Singleton accessor for the input manager instance.\r\n *\r\n * @returns The input manager singleton.\r\n *\r\n * @public\r\n */\r\n\r\nexport function getInput(): InputManager {\r\n  return appInstance?.inputManager ?? null;\r\n}\r\n"],"names":["appInstance","setApp","app","getApp","getEngine","engine","getDevice","device","getInput","inputManager"],"mappings":"AAKA,iBACO,IAAIA;AAEX,iBACO,SAASC,MAAAA,CAAOC,GAAgB,EAAA;IACrCF,WAAcE,GAAAA,GAAAA;AAChB;AAEA;;;;;;AAMC,IAEM,SAASC,MAAAA,GAAAA;IACd,OAAOH,WAAAA;AACT;AAEA;;;;;;AAMC,IACM,SAASI,SAAAA,GAAAA;AACd,IAAA,OAAOJ,aAAaK,MAAU,IAAA,IAAA;AAChC;AAEA;;;;;;AAMC,IACM,SAASC,SAAAA,GAAAA;AACd,IAAA,OAAON,aAAaO,MAAU,IAAA,IAAA;AAChC;AAEA;;;;;;AAMC,IAEM,SAASC,QAAAA,GAAAA;AACd,IAAA,OAAOR,aAAaS,YAAgB,IAAA,IAAA;AACtC;;;;"}
+{"version":3,"file":"api.js","sources":["../../src/app/api.ts"],"sourcesContent":["import type { Nullable } from '@zephyr3d/base';\r\nimport type { Application } from './app';\r\n\r\n/** @internal */\r\nexport let appInstance: Application;\r\n\r\n/** @internal */\r\nexport function setApp(app: Application) {\r\n  appInstance = app;\r\n}\r\n\r\n/**\r\n * Singleton accessor for the current Application instance.\r\n *\r\n * @returns The Application singleton.\r\n *\r\n * @public\r\n */\r\nexport function getApp() {\r\n  return appInstance;\r\n}\r\n\r\n/**\r\n * Singleton accessor for the current Application instance.\r\n *\r\n * @returns The Application singleton.\r\n *\r\n * @public\r\n */\r\nexport function tryGetApp(): Nullable<Application> {\r\n  return appInstance ?? null;\r\n}\r\n\r\n/**\r\n * Singleton accessor for the current engine instance.\r\n *\r\n * @returns The engine singleton.\r\n *\r\n * @public\r\n */\r\nexport function getEngine() {\r\n  return appInstance!.engine!;\r\n}\r\n\r\n/**\r\n * Singleton accessor for the device instance.\r\n *\r\n * @returns The device singleton.\r\n *\r\n * @public\r\n */\r\nexport function getDevice() {\r\n  return appInstance!.device!;\r\n}\r\n\r\n/**\r\n * Singleton accessor for the input manager instance.\r\n *\r\n * @returns The input manager singleton.\r\n *\r\n * @public\r\n */\r\n\r\nexport function getInput() {\r\n  return appInstance!.inputManager!;\r\n}\r\n"],"names":["appInstance","setApp","app","getApp","tryGetApp","getEngine","engine","getDevice","device","getInput","inputManager"],"mappings":"AAGA,iBACO,IAAIA;AAEX,iBACO,SAASC,MAAAA,CAAOC,GAAgB,EAAA;IACrCF,WAAcE,GAAAA,GAAAA;AAChB;AAEA;;;;;;AAMC,IACM,SAASC,MAAAA,GAAAA;IACd,OAAOH,WAAAA;AACT;AAEA;;;;;;AAMC,IACM,SAASI,SAAAA,GAAAA;AACd,IAAA,OAAOJ,WAAe,IAAA,IAAA;AACxB;AAEA;;;;;;AAMC,IACM,SAASK,SAAAA,GAAAA;AACd,IAAA,OAAOL,YAAaM,MAAM;AAC5B;AAEA;;;;;;AAMC,IACM,SAASC,SAAAA,GAAAA;AACd,IAAA,OAAOP,YAAaQ,MAAM;AAC5B;AAEA;;;;;;AAMC,IAEM,SAASC,QAAAA,GAAAA;AACd,IAAA,OAAOT,YAAaU,YAAY;AAClC;;;;"}

package/dist/app/app.js

@@ -27,6 +27,7 @@ import { getApp, setApp } from './api.js';
     _device;
     _inputManager;
     _engine;
+    _editorMode;
     _ready;
     /**
    * Construct the Application singleton with the provided options.
@@ -47,10 +48,20 @@ import { getApp, setApp } from './api.js';
             canvas: opt.canvas
         };
         this._inputManager = new InputManager(this);
-        this._engine = new Engine(opt.runtimeOptions?.VFS, opt.runtimeOptions?.scriptsRoot, opt.runtimeOptions?.editorMode, opt.runtimeOptions?.enabled);
+        this._engine = new Engine(opt.runtimeOptions?.VFS, opt.runtimeOptions?.scriptsRoot, opt.runtimeOptions?.enabled);
+        if (opt.runtimeOptions?.screen) {
+            this._engine.screen.config = opt.runtimeOptions.screen;
+        }
+        this._editorMode = opt.runtimeOptions?.editorMode ?? 'none';
+        this._device = null;
         this._ready = false;
     }
     /**
+   * Editor mode
+   */ get editorMode() {
+        return this._editorMode;
+    }
+    /**
    * The input manager instance handling pointer/keyboard event routing.
    */ get inputManager() {
         return this._inputManager;
@@ -101,6 +112,7 @@ import { getApp, setApp } from './api.js';
             await this._engine.init();
             this._inputManager.start();
             this._device.on('resize', (width, height)=>{
+                this._engine.screen.resolveViewport();
                 this.dispatchEvent('resize', width, height);
             });
             this._ready = true;

package/dist/app/app.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.js","sources":["../../src/app/app.ts"],"sourcesContent":["import type { 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\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 * 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 type 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   * 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?: boolean;\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};\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: AppOptions;\r\n  private _device: AbstractDevice;\r\n  private readonly _inputManager: InputManager;\r\n  private readonly _engine: Engine;\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: AppOptions) {\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?.editorMode,\r\n      opt.runtimeOptions?.enabled\r\n    );\r\n    this._ready = false;\r\n  }\r\n  /**\r\n   * The input manager instance handling pointer/keyboard event routing.\r\n   */\r\n  get inputManager(): InputManager {\r\n    return this._inputManager;\r\n  }\r\n  /**\r\n   * Get the instanceof {@link Engine}.\r\n   */\r\n  get engine(): 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(): AppOptions {\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(): AbstractDevice {\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(): string {\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.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","_ready","opt","getApp","Error","setApp","backend","enableMSAA","pixelRatio","window","devicePixelRatio","canvas","InputManager","Engine","runtimeOptions","VFS","scriptsRoot","editorMode","enabled","inputManager","engine","options","device","deviceType","typeName","focus","ready","createDevice","dpr","msaa","init","start","on","width","height","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/** 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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"}

package/dist/app/engine.js

@@ -1,48 +1,30 @@
-import { HttpFS, DRef, MemoryFS } from '@zephyr3d/base';
+import { HttpFS, DRef, MemoryFS, objectEntries } from '@zephyr3d/base';
 import { ScriptingSystem } from './scriptingsystem.js';
-import '../utility/pmrem.js';
-import '../utility/panorama.js';
+import { ResourceManager } from '../utility/serialization/manager.js';
 import '../render/primitive.js';
-import '@zephyr3d/device';
-import '../scene/scene.js';
-import '../values.js';
+import { BoxShape } from '../shapes/box.js';
+import { CylinderShape } from '../shapes/cylinder.js';
+import { TorusShape } from '../shapes/torus.js';
+import { PlaneShape } from '../shapes/plane.js';
+import { SphereShape } from '../shapes/sphere.js';
+import { TetrahedronShape } from '../shapes/tetrahedron.js';
 import '../material/shader/helper.js';
 import { LambertMaterial } from '../material/lambert.js';
 import { BlinnMaterial } from '../material/blinn.js';
 import { UnlitMaterial } from '../material/unlit.js';
 import '../material/particle.js';
+import '@zephyr3d/device';
+import '../values.js';
 import '../material/meshmaterial.js';
 import '../material/grassmaterial.js';
-import '../material/terrainmaterial.js';
 import '../material/terrain-cm.js';
 import { PBRMetallicRoughnessMaterial } from '../material/pbrmr.js';
 import { PBRSpecularGlossinessMaterial } from '../material/pbrsg.js';
 import '../material/pbrblueprint.js';
-import '../render/renderer.js';
-import '../render/sky.js';
-import '../render/clipmap.js';
-import '../shaders/atmosphere.js';
-import '../scene/scene_node.js';
-import '../shadow/shadowmapper.js';
-import '../scene/mesh.js';
-import '../scene/water.js';
-import '../scene/particlesys.js';
-import '../scene/batchgroup.js';
-import '../scene/terrain/patch.js';
-import '../scene/terrain/grass.js';
-import '../scene/terrain-cm/terrain-cm.js';
-import '../scene/terrain-cm/grass.js';
-import '../camera/camera.js';
-import '../animation/eulerrotationtrack.js';
-import '../animation/skeleton.js';
-import { ResourceManager } from '../utility/serialization/manager.js';
+import '../material/sprite.js';
+import { StandardSpriteMaterial } from '../material/sprite_std.js';
 import '../utility/blueprint/material/texture.js';
-import { BoxShape } from '../shapes/box.js';
-import { CylinderShape } from '../shapes/cylinder.js';
-import { TorusShape } from '../shapes/torus.js';
-import { PlaneShape } from '../shapes/plane.js';
-import { SphereShape } from '../shapes/sphere.js';
-import { TetrahedronShape } from '../shapes/tetrahedron.js';
+import { ScreenAdapter } from './screen.js';
 
 /**
  * Core engine class managing scripting, serialization, and rendering.
@@ -65,6 +47,7 @@ import { TetrahedronShape } from '../shapes/tetrahedron.js';
     _scriptingSystem;
     _resourceManager;
     _enabled;
+    _screen;
     _activeRenderables;
     _loadingScenes;
     /**
@@ -72,20 +55,19 @@ import { TetrahedronShape } from '../shapes/tetrahedron.js';
    *
    * @param VFS - Optional virtual file system passed to the internal {@link ScriptingSystem}.
    * @param scriptsRoot - Optional scripts root path within the VFS. Defaults as in `ScriptingSystem`.
-   * @param editorMode - Optional editor mode flag for the underlying `ScriptingSystem`.
    * @param enabled - Whether runtime operations are active. Defaults to `true`.
-   */ constructor(VFS, scriptsRoot, editorMode, enabled){
+   */ constructor(VFS, scriptsRoot, enabled){
         VFS = VFS ?? new HttpFS('./');
         this._builtinsVFS = null;
         this._scriptingSystem = new ScriptingSystem({
             VFS,
-            scriptsRoot,
-            editorMode
+            scriptsRoot
         });
         this._resourceManager = new ResourceManager(VFS);
         this._enabled = enabled ?? true;
         this._activeRenderables = [];
-        this._loadingScenes = [];
+        this._loadingScenes = {};
+        this._screen = new ScreenAdapter();
     }
     /**
    * Exposes the instance of {@link ScriptingSystem}.
@@ -110,6 +92,11 @@ import { TetrahedronShape } from '../shapes/tetrahedron.js';
    */ get resourceManager() {
         return this._resourceManager;
     }
+    /**
+   * Exposes the instanceof {@link Screen}
+   */ get screen() {
+        return this._screen;
+    }
     /** @internal */ async init() {
         await this.ensureBuiltinVFS();
     }
@@ -180,10 +167,11 @@ import { TetrahedronShape } from '../shapes/tetrahedron.js';
     setRenderable(renderable, layer = 0, hook) {
         if (!this._activeRenderables[layer]) {
             this._activeRenderables[layer] = {
-                renderable: new DRef(null)
+                renderable: new DRef(null),
+                hook: null
             };
         }
-        this._activeRenderables[layer].hook = hook;
+        this._activeRenderables[layer].hook = hook ?? null;
         this._activeRenderables[layer].renderable.set(renderable);
     }
     async readFile(path, encoding) {
@@ -216,16 +204,15 @@ import { TetrahedronShape } from '../shapes/tetrahedron.js';
         this.setRenderable(null, splashScreenLayer);
     }
     render() {
-        for (const k of Object.keys(this._activeRenderables)){
-            const info = this._activeRenderables[k];
+        this._activeRenderables.forEach((info)=>{
             const render = info.hook?.beforeRender ? info.hook.beforeRender(info.renderable.get() ?? null) ?? true : true;
-            if (render && info.renderable.get()) {
-                info.renderable.get().render();
+            if (render) {
+                info.renderable.get()?.render();
             }
             if (info.hook?.afterRender) {
                 info.hook.afterRender(info.renderable.get() ?? null);
             }
-        }
+        });
     }
     async ensureBuiltinVFS() {
         if (!this._builtinsVFS) {
@@ -247,9 +234,10 @@ import { TetrahedronShape } from '../shapes/tetrahedron.js';
             '/materials/lambert.zmtl': LambertMaterial,
             '/materials/blinnphong.zmtl': BlinnMaterial,
             '/materials/pbr_metallic_roughness.zmtl': PBRMetallicRoughnessMaterial,
-            '/materials/pbr_specular_glossiness.zmtl': PBRSpecularGlossinessMaterial
+            '/materials/pbr_specular_glossiness.zmtl': PBRSpecularGlossinessMaterial,
+            '/materials/sprite_std.zmtl': StandardSpriteMaterial
         };
-        for (const key of Object.keys(shapeClsMap)){
+        for (const [key] of objectEntries(shapeClsMap)){
             const obj = new shapeClsMap[key]();
             await this.writeSerializableObject(fs, 'Default', obj, key);
             obj.dispose();

package/dist/app/engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine.js","sources":["../../src/app/engine.ts"],"sourcesContent":["import type { IDisposable, ReadOptions } from '@zephyr3d/base';\r\nimport { MemoryFS } 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 } from './runtimescript';\r\nimport { ResourceManager } from '../utility';\r\nimport type { Scene } from '../scene';\r\nimport { BoxShape, CylinderShape, PlaneShape, SphereShape, TetrahedronShape, TorusShape } from '../shapes';\r\nimport {\r\n  BlinnMaterial,\r\n  LambertMaterial,\r\n  PBRMetallicRoughnessMaterial,\r\n  PBRSpecularGlossinessMaterial,\r\n  UnlitMaterial\r\n} from '../material';\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: MemoryFS;\r\n  private _scriptingSystem: ScriptingSystem;\r\n  private _resourceManager: ResourceManager;\r\n  private _enabled: boolean;\r\n  protected _activeRenderables: {\r\n    renderable: DRef<IRenderable>;\r\n    hook?: IRenderHook;\r\n  }[];\r\n  private _loadingScenes: Record<string, Promise<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 editorMode - Optional editor mode flag for the underlying `ScriptingSystem`.\r\n   * @param enabled - Whether runtime operations are active. Defaults to `true`.\r\n   */\r\n  constructor(VFS?: VFS, scriptsRoot?: string, editorMode?: boolean, enabled?: boolean) {\r\n    VFS = VFS ?? new HttpFS('./');\r\n    this._builtinsVFS = null;\r\n    this._scriptingSystem = new ScriptingSystem({ VFS, scriptsRoot, editorMode });\r\n    this._resourceManager = new ResourceManager(VFS);\r\n    this._enabled = enabled ?? true;\r\n    this._activeRenderables = [];\r\n    this._loadingScenes = [];\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  /** @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   * 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>(host: T, module: string): Promise<RuntimeScript<T>> {\r\n    return this._enabled ? await this._scriptingSystem.attachScript(host, module) : 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): T[] {\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): Promise<Scene> {\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: 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      };\r\n    }\r\n    this._activeRenderables[layer].hook = hook;\r\n    this._activeRenderables[layer].renderable.set(renderable);\r\n  }\r\n  async readFile<T extends ReadOptions['encoding'] = 'binary'>(\r\n    path: string,\r\n    encoding?: T\r\n  ): Promise<T extends 'binary' ? ArrayBuffer : string> {\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(startupScene: string, splashScreen: string, startupScript: string) {\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    for (const k of Object.keys(this._activeRenderables)) {\r\n      const info = this._activeRenderables[k];\r\n      const render = info.hook?.beforeRender\r\n        ? (info.hook.beforeRender(info.renderable.get() ?? null) ?? true)\r\n        : true;\r\n      if (render && info.renderable.get()) {\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(): Promise<MemoryFS> {\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      '/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    } as const;\r\n    for (const key of Object.keys(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): Promise<Scene> {\r\n    try {\r\n      const scene = await this._resourceManager.loadScene(path);\r\n      if (scene) {\r\n        if (scene.script) {\r\n          try {\r\n            await this.attachScript(scene, scene.script);\r\n          } catch (err) {\r\n            console.error(`Attach script failed: ${err}`);\r\n          }\r\n        }\r\n        const P: Promise<any>[] = [];\r\n        const scripts: string[] = [];\r\n        scene.rootNode.iterate((node) => {\r\n          if (node.script) {\r\n            scripts.push(node.script);\r\n            P.push(this.attachScript(node, node.script));\r\n          }\r\n        });\r\n        if (P.length > 0) {\r\n          const result = await Promise.allSettled(P);\r\n          for (let i = 0; i < result.length; i++) {\r\n            if (result[i].status === 'rejected') {\r\n              console.error(`Attach script failed: ${scripts[i]}`);\r\n            }\r\n          }\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","_activeRenderables","_loadingScenes","VFS","scriptsRoot","editorMode","enabled","HttpFS","ScriptingSystem","ResourceManager","scriptingSystem","registry","vfs","close","ensureBuiltinVFS","resourceManager","init","detachAllScripts","attachScript","host","module","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","k","Object","keys","info","beforeRender","get","afterRender","createBuiltinVFS","unmount","mount","fs","MemoryFS","shapeClsMap","BoxShape","SphereShape","CylinderShape","PlaneShape","TorusShape","TetrahedronShape","UnlitMaterial","LambertMaterial","BlinnMaterial","PBRMetallicRoughnessMaterial","PBRSpecularGlossinessMaterial","key","obj","writeSerializableObject","dispose","readOnly","type","data","serializeObject","JSON","stringify","writeFile","create","loadScene","script","P","scripts","rootNode","iterate","node","push","length","result","Promise","allSettled","i","status"],"mappings":"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"}
+{"version":3,"file":"engine.js","sources":["../../src/app/engine.ts"],"sourcesContent":["import type { 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 } from './runtimescript';\r\nimport { ResourceManager } from '../utility/serialization/manager';\r\nimport type { Scene } from '../scene';\r\nimport { BoxShape, CylinderShape, PlaneShape, SphereShape, TetrahedronShape, TorusShape } 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   * 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>(host: Nullable<T>, module: string) {\r\n    return this._enabled ? await this._scriptingSystem.attachScript(host, module) : 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      '/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        if (scene.script) {\r\n          try {\r\n            await this.attachScript(scene, scene.script);\r\n          } catch (err) {\r\n            console.error(`Attach script failed: ${err}`);\r\n          }\r\n        }\r\n        const P: Promise<any>[] = [];\r\n        const scripts: string[] = [];\r\n        scene.rootNode.iterate((node) => {\r\n          if (node.script) {\r\n            scripts.push(node.script);\r\n            P.push(this.attachScript(node, node.script));\r\n          }\r\n        });\r\n        if (P.length > 0) {\r\n          const result = await Promise.allSettled(P);\r\n          for (let i = 0; i < result.length; i++) {\r\n            if (result[i].status === 'rejected') {\r\n              console.error(`Attach script failed: ${scripts[i]}`);\r\n            }\r\n          }\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","attachScript","host","module","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","UnlitMaterial","LambertMaterial","BlinnMaterial","PBRMetallicRoughnessMaterial","PBRSpecularGlossinessMaterial","StandardSpriteMaterial","key","objectEntries","obj","writeSerializableObject","dispose","readOnly","type","data","serializeObject","JSON","stringify","writeFile","create","loadScene","script","P","scripts","rootNode","iterate","node","push","length","result","Promise","allSettled","i","status"],"mappings":"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"}