@zephyr3d/scene 0.8.1 → 0.9.0

package/dist/camera/base.js

@@ -35,6 +35,7 @@
  * @public
  */ class BaseCameraController {
     /** @internal */ _camera;
+    /** @internal */ _enabled;
     /**
    * Create a base camera controller.
    *
@@ -42,6 +43,7 @@
    * to attach a camera (performed by the owning system), which triggers `reset()`.
    */ constructor(){
         this._camera = null;
+        this._enabled = true;
     }
     /**
    * Get the attached camera.
@@ -64,6 +66,14 @@
         }
     }
     /**
+   * Check if the controller is enabled.
+   */ get enabled() {
+        return this._enabled;
+    }
+    set enabled(value) {
+        this._enabled = value;
+    }
+    /**
    * Convenience method that delegates to `camera.lookAt`.
    *
    * @param from - Camera position.
@@ -84,7 +94,7 @@
    * @param evt - The pointer event.
    * @returns `true` if handled and should stop further processing; otherwise `false`.
    */ onMouseDown(evt) {
-        return this._onMouseDown(evt);
+        return this._enabled ? this._onMouseDown(evt) : false;
     }
     /**
    * Handle pointer up events.
@@ -92,7 +102,7 @@
    * @param evt - The pointer event.
    * @returns `true` if handled; otherwise `false`.
    */ onMouseUp(evt) {
-        return this._onMouseUp(evt);
+        return this._enabled ? this._onMouseUp(evt) : false;
     }
     /**
    * Handle mouse wheel (scroll) events.
@@ -102,7 +112,7 @@
    * @param evt - The wheel event.
    * @returns `true` if handled; otherwise `false`.
    */ onMouseWheel(evt) {
-        return this._onMouseWheel(evt);
+        return this._enabled ? this._onMouseWheel(evt) : false;
     }
     /**
    * Handle pointer move events.
@@ -112,7 +122,7 @@
    * @param evt - The pointer event.
    * @returns `true` if handled; otherwise `false`.
    */ onMouseMove(evt) {
-        return this._onMouseMove(evt);
+        return this._enabled ? this._onMouseMove(evt) : false;
     }
     /**
    * Handle key down events.
@@ -122,7 +132,7 @@
    * @param evt - The keyboard event.
    * @returns `true` if handled; otherwise `false`.
    */ onKeyDown(evt) {
-        return this._onKeyDown(evt);
+        return this._enabled ? this._onKeyDown(evt) : false;
     }
     /**
    * Handle key up events.
@@ -130,7 +140,7 @@
    * @param evt - The keyboard event.
    * @returns `true` if handled; otherwise `false`.
    */ onKeyUp(evt) {
-        return this._onKeyUp(evt);
+        return this._enabled ? this._onKeyUp(evt) : false;
     }
     /**
    * Per-frame update.
@@ -141,7 +151,11 @@
    * - Clamp angles/distances/FOV, etc.
    *
    * Called once per frame by the owning system.
-   */ update() {}
+   */ update() {
+        if (this._enabled) {
+            this._onUpdate();
+        }
+    }
     /**
    * Mouse down event handler
    * @param evt - Mouse event
@@ -189,6 +203,11 @@
    */ _onKeyUp(_evt) {
         return false;
     }
+    /**
+   * Per-frame update handler for subclasses to override.
+   */ _onUpdate() {
+    // Subclasses can override this for per-frame updates.
+    }
 }
 
 export { BaseCameraController };

package/dist/camera/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sources":["../../src/camera/base.ts"],"sourcesContent":["import type { Nullable, Vector3 } from '@zephyr3d/base';\r\nimport type { Camera } from './camera';\r\n\r\n/**\r\n * Base structure for all controller events.\r\n *\r\n * Represents a typed event emitted or handled by a camera controller.\r\n *\r\n * @public\r\n */\r\nexport interface IBaseEvent<T extends string> {\r\n  /** Event type identifier. */\r\n  type: T;\r\n  /**\r\n   * Optional method to cancel the default event behavior.\r\n   * May be provided by the event source.\r\n   */\r\n  preventDefault?: () => void;\r\n}\r\n\r\n/**\r\n * Standard modifier key set for mouse/keyboard events.\r\n *\r\n * Encapsulates common modifier keys such as Ctrl, Alt, Shift, and Meta.\r\n *\r\n * @public\r\n */\r\nexport interface IModKey {\r\n  /** Whether the Control key is pressed. */\r\n  readonly ctrlKey: boolean;\r\n  /** Whether the Meta (Command on macOS) key is pressed. */\r\n  readonly metaKey: boolean;\r\n  /** Whether the Shift key is pressed. */\r\n  readonly shiftKey: boolean;\r\n  /** Whether the Alt/Option key is pressed. */\r\n  readonly altKey: boolean;\r\n}\r\n\r\n/**\r\n * Base interface for all controller mouse and pointer events.\r\n *\r\n * Extends the base event with positional and button information, as well as modifier keys.\r\n *\r\n * @public\r\n */\r\nexport interface IControllerMouseEvent<T extends string> extends IBaseEvent<T>, IModKey {\r\n  /** Pointer offset along the X-axis, typically relative to the event target. */\r\n  readonly offsetX: number;\r\n  /** Pointer offset along the Y-axis, typically relative to the event target. */\r\n  readonly offsetY: number;\r\n  /** Mouse button index: `0` for left, `1` for middle, `2` for right, etc. */\r\n  readonly button: number;\r\n}\r\n\r\n/**\r\n * Pointer down event for camera controllers.\r\n *\r\n * Triggered when a mouse, pen, or touch pointer is pressed down.\r\n *\r\n * @public\r\n */\r\nexport interface IControllerPointerDownEvent extends IControllerMouseEvent<'pointerdown'> {}\r\n\r\n/**\r\n * Pointer up event for camera controllers.\r\n *\r\n * Triggered when a mouse, pen, or touch pointer is released.\r\n *\r\n * @public\r\n */\r\nexport interface IControllerPointerUpEvent extends IControllerMouseEvent<'pointerup'> {}\r\n\r\n/**\r\n * Pointer move event for camera controllers.\r\n *\r\n * Triggered when the pointer (mouse, pen, or touch) moves across the viewport.\r\n *\r\n * @public\r\n */\r\nexport interface IControllerPointerMoveEvent extends IControllerMouseEvent<'pointermove'> {}\r\n\r\n/**\r\n * Pointer cancel event for camera controllers.\r\n *\r\n * Triggered when the pointer operation is canceled (e.g., touch canceled, system interruption).\r\n *\r\n * @public\r\n */\r\nexport interface IControllerPointerCancelEvent extends IControllerMouseEvent<'pointercancel'> {}\r\n\r\n/**\r\n * Wheel (scroll) event for camera controllers.\r\n *\r\n * Extends a mouse event with wheel delta values for scroll-based input (e.g., zoom).\r\n *\r\n * @public\r\n */\r\nexport interface IControllerWheelEvent extends IControllerMouseEvent<'wheel'> {\r\n  /** Horizontal wheel scroll delta. */\r\n  readonly deltaX: number;\r\n  /** Vertical wheel scroll delta. */\r\n  readonly deltaY: number;\r\n  /** Delta mode */\r\n  readonly deltaMode: number;\r\n}\r\n\r\n/**\r\n * Base interface for all controller keyboard events.\r\n *\r\n * Provides key identification along with standard modifier flags.\r\n *\r\n * @public\r\n */\r\nexport interface IControllerKeyboardEvent<T extends string> extends IBaseEvent<T>, IModKey {\r\n  /** key code */\r\n  readonly code: string;\r\n  /** Character value */\r\n  readonly key: string;\r\n}\r\n\r\n/**\r\n * Key down event for camera controllers.\r\n *\r\n * Triggered when a keyboard key is pressed down.\r\n *\r\n * @public\r\n */\r\nexport interface IControllerKeydownEvent extends IControllerKeyboardEvent<'keydown'> {}\r\n\r\n/**\r\n * Key up event for camera controllers.\r\n *\r\n * Triggered when a keyboard key is released.\r\n *\r\n * @public\r\n */\r\nexport interface IControllerKeyupEvent extends IControllerKeyboardEvent<'keyup'> {}\r\n\r\n/**\r\n * Key press event for camera controllers.\r\n *\r\n * Triggered when a key is pressed and generates a character value (legacy usage).\r\n *\r\n * @public\r\n */\r\nexport interface IControllerKeypressEvent extends IControllerKeyboardEvent<'keypress'> {}\r\n\r\n/**\r\n * Base class for camera controllers.\r\n *\r\n * Provides a common lifecycle and event-handling surface for concrete camera controllers\r\n * (e.g., orbit, fly, FPS). Subclasses implement protected handler methods to react to\r\n * mouse/keyboard input, and update camera transforms in `update()`.\r\n *\r\n * Responsibilities:\r\n * - Holds a reference to a `Camera` and resets internal state when the camera changes.\r\n * - Offers a `lookAt(from, to, up)` helper that delegates to the camera.\r\n * - Exposes public event entry points (`onMouseDown`, `onMouseUp`, `onMouseMove`,\r\n *   `onMouseWheel`, `onKeyDown`, `onKeyUp`) that forward to protected handlers which\r\n *   subclasses can override.\r\n * - Defines `reset()` and `update()` lifecycle methods for state initialization and per-frame updates.\r\n *\r\n * Event handling contract:\r\n * - Each public `onXxx` method returns a boolean that indicates whether the event\r\n *   was handled by the controller. Returning `true` allows upstream dispatchers to\r\n *   stop propagation if desired.\r\n *\r\n * Subclassing guidelines:\r\n * - Override the protected `_onXxx` handlers rather than the public `onXxx` methods.\r\n * - Override `reset()` to reinitialize controller state when a new camera is attached.\r\n * - Override `update()` to advance state each frame (e.g., apply accumulated deltas with damping).\r\n *\r\n * Lifecycle:\r\n * 1. A camera is attached via internal `_setCamera(camera)`, which calls `reset()`.\r\n * 2. Input events are passed in through the public `onXxx` methods.\r\n * 3. Per-frame, `update()` is called to apply state changes to the camera.\r\n *\r\n * Thread-safety/assumptions:\r\n * - Designed for use on the main thread in a browser environment.\r\n * - Pointer events are used for mouse input; keyboard events for key input.\r\n *\r\n * @public\r\n */\r\nexport class BaseCameraController {\r\n  /** @internal */\r\n  private _camera: Nullable<Camera>;\r\n  /**\r\n   * Create a base camera controller.\r\n   *\r\n   * The controller starts without an attached camera. Call the internal `_setCamera`\r\n   * to attach a camera (performed by the owning system), which triggers `reset()`.\r\n   */\r\n  constructor() {\r\n    this._camera = null;\r\n  }\r\n  /**\r\n   * Get the attached camera.\r\n   *\r\n   * @returns The current camera or `null` if none is attached.\r\n   */\r\n  _getCamera() {\r\n    return this._camera;\r\n  }\r\n  /**\r\n   * Attach a camera to the controller.\r\n   *\r\n   * If the camera changes, the controller will call `reset()` so subclasses can\r\n   * reinitialize state that depends on the camera.\r\n   *\r\n   * @param camera - The camera to attach.\r\n   */\r\n  _setCamera(camera: Nullable<Camera>) {\r\n    if (this._camera !== camera) {\r\n      this._camera = camera;\r\n      this.reset();\r\n    }\r\n  }\r\n  /**\r\n   * Convenience method that delegates to `camera.lookAt`.\r\n   *\r\n   * @param from - Camera position.\r\n   * @param to - Look-at target.\r\n   * @param up - Up direction.\r\n   */\r\n  lookAt(from: Vector3, to: Vector3, up: Vector3) {\r\n    this._camera?.lookAt(from, to, up);\r\n  }\r\n  /**\r\n   * Reset the controller's internal state.\r\n   *\r\n   * Called automatically when a camera is attached via `_setCamera`. Subclasses\r\n   * should override this to reset accumulators, velocities, targets, etc.\r\n   */\r\n  reset() {}\r\n  /**\r\n   * Handle pointer down (mouse/touch/pen) events.\r\n   *\r\n   * @param evt - The pointer event.\r\n   * @returns `true` if handled and should stop further processing; otherwise `false`.\r\n   */\r\n  onMouseDown(evt: IControllerPointerDownEvent) {\r\n    return this._onMouseDown(evt);\r\n  }\r\n  /**\r\n   * Handle pointer up events.\r\n   *\r\n   * @param evt - The pointer event.\r\n   * @returns `true` if handled; otherwise `false`.\r\n   */\r\n  onMouseUp(evt: IControllerPointerUpEvent) {\r\n    return this._onMouseUp(evt);\r\n  }\r\n  /**\r\n   * Handle mouse wheel (scroll) events.\r\n   *\r\n   * Typical usage: zoom/dolly control, FOV adjustments.\r\n   *\r\n   * @param evt - The wheel event.\r\n   * @returns `true` if handled; otherwise `false`.\r\n   */\r\n  onMouseWheel(evt: IControllerWheelEvent) {\r\n    return this._onMouseWheel(evt);\r\n  }\r\n  /**\r\n   * Handle pointer move events.\r\n   *\r\n   * Typical usage: orbit, pan, or look controls based on button/modifier state.\r\n   *\r\n   * @param evt - The pointer event.\r\n   * @returns `true` if handled; otherwise `false`.\r\n   */\r\n  onMouseMove(evt: IControllerPointerMoveEvent) {\r\n    return this._onMouseMove(evt);\r\n  }\r\n  /**\r\n   * Handle key down events.\r\n   *\r\n   * Typical usage: WASD navigation, modifiers for speed, toggling modes.\r\n   *\r\n   * @param evt - The keyboard event.\r\n   * @returns `true` if handled; otherwise `false`.\r\n   */\r\n  onKeyDown(evt: IControllerKeydownEvent) {\r\n    return this._onKeyDown(evt);\r\n  }\r\n  /**\r\n   * Handle key up events.\r\n   *\r\n   * @param evt - The keyboard event.\r\n   * @returns `true` if handled; otherwise `false`.\r\n   */\r\n  onKeyUp(evt: IControllerKeyupEvent) {\r\n    return this._onKeyUp(evt);\r\n  }\r\n  /**\r\n   * Per-frame update.\r\n   *\r\n   * Subclasses should override this to:\r\n   * - Integrate velocities/accelerations and apply damping.\r\n   * - Smoothly interpolate camera transforms.\r\n   * - Clamp angles/distances/FOV, etc.\r\n   *\r\n   * Called once per frame by the owning system.\r\n   */\r\n  update() {}\r\n  /**\r\n   * Mouse down event handler\r\n   * @param evt - Mouse event\r\n   * @returns Boolean value indices whether this event was handled\r\n   */\r\n  protected _onMouseDown(_evt: IControllerPointerDownEvent): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Pointer up handler for subclasses to override.\r\n   *\r\n   * @param _evt - Pointer event.\r\n   * @returns `true` if handled; otherwise `false`.\r\n   */\r\n  protected _onMouseUp(_evt: IControllerPointerUpEvent): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Mouse wheel handler for subclasses to override.\r\n   *\r\n   * @param _evt - Wheel event.\r\n   * @returns `true` if handled; otherwise `false`.\r\n   */\r\n  protected _onMouseWheel(_evt: IControllerWheelEvent): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Pointer move handler for subclasses to override.\r\n   *\r\n   * @param _evt - Pointer event.\r\n   * @returns `true` if handled; otherwise `false`.\r\n   */\r\n  protected _onMouseMove(_evt: IControllerPointerMoveEvent): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Key down handler for subclasses to override.\r\n   *\r\n   * @param _evt - Keyboard event.\r\n   * @returns `true` if handled; otherwise `false`.\r\n   */\r\n  protected _onKeyDown(_evt: IControllerKeydownEvent): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Key up handler for subclasses to override.\r\n   *\r\n   * @param _evt - Keyboard event.\r\n   * @returns `true` if handled; otherwise `false`.\r\n   */\r\n  protected _onKeyUp(_evt: IControllerKeyupEvent): boolean {\r\n    return false;\r\n  }\r\n}\r\n"],"names":["BaseCameraController","_camera","_getCamera","_setCamera","camera","reset","lookAt","from","to","up","onMouseDown","evt","_onMouseDown","onMouseUp","_onMouseUp","onMouseWheel","_onMouseWheel","onMouseMove","_onMouseMove","onKeyDown","_onKeyDown","onKeyUp","_onKeyUp","update","_evt"],"mappings":"AAmJA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCC,IACM,MAAMA,oBAAAA,CAAAA;qBAEX,OAAkC;AAClC;;;;;AAKC,MACD,WAAc,EAAA;QACZ,IAAI,CAACC,OAAO,GAAG,IAAA;AACjB;AACA;;;;AAIC,MACDC,UAAa,GAAA;QACX,OAAO,IAAI,CAACD,OAAO;AACrB;AACA;;;;;;;MAQAE,UAAAA,CAAWC,MAAwB,EAAE;AACnC,QAAA,IAAI,IAAI,CAACH,OAAO,KAAKG,MAAQ,EAAA;YAC3B,IAAI,CAACH,OAAO,GAAGG,MAAAA;AACf,YAAA,IAAI,CAACC,KAAK,EAAA;AACZ;AACF;AACA;;;;;;AAMC,MACDC,OAAOC,IAAa,EAAEC,EAAW,EAAEC,EAAW,EAAE;AAC9C,QAAA,IAAI,CAACR,OAAO,EAAEK,MAAAA,CAAOC,MAAMC,EAAIC,EAAAA,EAAAA,CAAAA;AACjC;AACA;;;;;AAKC,MACDJ,QAAQ;AACR;;;;;MAMAK,WAAAA,CAAYC,GAAgC,EAAE;QAC5C,OAAO,IAAI,CAACC,YAAY,CAACD,GAAAA,CAAAA;AAC3B;AACA;;;;;MAMAE,SAAAA,CAAUF,GAA8B,EAAE;QACxC,OAAO,IAAI,CAACG,UAAU,CAACH,GAAAA,CAAAA;AACzB;AACA;;;;;;;MAQAI,YAAAA,CAAaJ,GAA0B,EAAE;QACvC,OAAO,IAAI,CAACK,aAAa,CAACL,GAAAA,CAAAA;AAC5B;AACA;;;;;;;MAQAM,WAAAA,CAAYN,GAAgC,EAAE;QAC5C,OAAO,IAAI,CAACO,YAAY,CAACP,GAAAA,CAAAA;AAC3B;AACA;;;;;;;MAQAQ,SAAAA,CAAUR,GAA4B,EAAE;QACtC,OAAO,IAAI,CAACS,UAAU,CAACT,GAAAA,CAAAA;AACzB;AACA;;;;;MAMAU,OAAAA,CAAQV,GAA0B,EAAE;QAClC,OAAO,IAAI,CAACW,QAAQ,CAACX,GAAAA,CAAAA;AACvB;AACA;;;;;;;;;AASC,MACDY,SAAS;AACT;;;;MAKUX,YAAaY,CAAAA,IAAiC,EAAW;QACjE,OAAO,KAAA;AACT;AACA;;;;;MAMUV,UAAWU,CAAAA,IAA+B,EAAW;QAC7D,OAAO,KAAA;AACT;AACA;;;;;MAMUR,aAAcQ,CAAAA,IAA2B,EAAW;QAC5D,OAAO,KAAA;AACT;AACA;;;;;MAMUN,YAAaM,CAAAA,IAAiC,EAAW;QACjE,OAAO,KAAA;AACT;AACA;;;;;MAMUJ,UAAWI,CAAAA,IAA6B,EAAW;QAC3D,OAAO,KAAA;AACT;AACA;;;;;MAMUF,QAASE,CAAAA,IAA2B,EAAW;QACvD,OAAO,KAAA;AACT;AACF;;;;"}
+{"version":3,"file":"base.js","sources":["../../src/camera/base.ts"],"sourcesContent":["import type { Nullable, Vector3 } from '@zephyr3d/base';\r\nimport type { Camera } from './camera';\r\n\r\n/**\r\n * Base structure for all controller events.\r\n *\r\n * Represents a typed event emitted or handled by a camera controller.\r\n *\r\n * @public\r\n */\r\nexport interface IBaseEvent<T extends string> {\r\n  /** Event type identifier. */\r\n  type: T;\r\n  /**\r\n   * Optional method to cancel the default event behavior.\r\n   * May be provided by the event source.\r\n   */\r\n  preventDefault?: () => void;\r\n}\r\n\r\n/**\r\n * Standard modifier key set for mouse/keyboard events.\r\n *\r\n * Encapsulates common modifier keys such as Ctrl, Alt, Shift, and Meta.\r\n *\r\n * @public\r\n */\r\nexport interface IModKey {\r\n  /** Whether the Control key is pressed. */\r\n  readonly ctrlKey: boolean;\r\n  /** Whether the Meta (Command on macOS) key is pressed. */\r\n  readonly metaKey: boolean;\r\n  /** Whether the Shift key is pressed. */\r\n  readonly shiftKey: boolean;\r\n  /** Whether the Alt/Option key is pressed. */\r\n  readonly altKey: boolean;\r\n}\r\n\r\n/**\r\n * Base interface for all controller mouse and pointer events.\r\n *\r\n * Extends the base event with positional and button information, as well as modifier keys.\r\n *\r\n * @public\r\n */\r\nexport interface IControllerMouseEvent<T extends string> extends IBaseEvent<T>, IModKey {\r\n  /** Pointer offset along the X-axis, typically relative to the event target. */\r\n  readonly offsetX: number;\r\n  /** Pointer offset along the Y-axis, typically relative to the event target. */\r\n  readonly offsetY: number;\r\n  /** Mouse button index: `0` for left, `1` for middle, `2` for right, etc. */\r\n  readonly button: number;\r\n}\r\n\r\n/**\r\n * Pointer down event for camera controllers.\r\n *\r\n * Triggered when a mouse, pen, or touch pointer is pressed down.\r\n *\r\n * @public\r\n */\r\nexport interface IControllerPointerDownEvent extends IControllerMouseEvent<'pointerdown'> {}\r\n\r\n/**\r\n * Pointer up event for camera controllers.\r\n *\r\n * Triggered when a mouse, pen, or touch pointer is released.\r\n *\r\n * @public\r\n */\r\nexport interface IControllerPointerUpEvent extends IControllerMouseEvent<'pointerup'> {}\r\n\r\n/**\r\n * Pointer move event for camera controllers.\r\n *\r\n * Triggered when the pointer (mouse, pen, or touch) moves across the viewport.\r\n *\r\n * @public\r\n */\r\nexport interface IControllerPointerMoveEvent extends IControllerMouseEvent<'pointermove'> {}\r\n\r\n/**\r\n * Pointer cancel event for camera controllers.\r\n *\r\n * Triggered when the pointer operation is canceled (e.g., touch canceled, system interruption).\r\n *\r\n * @public\r\n */\r\nexport interface IControllerPointerCancelEvent extends IControllerMouseEvent<'pointercancel'> {}\r\n\r\n/**\r\n * Wheel (scroll) event for camera controllers.\r\n *\r\n * Extends a mouse event with wheel delta values for scroll-based input (e.g., zoom).\r\n *\r\n * @public\r\n */\r\nexport interface IControllerWheelEvent extends IControllerMouseEvent<'wheel'> {\r\n  /** Horizontal wheel scroll delta. */\r\n  readonly deltaX: number;\r\n  /** Vertical wheel scroll delta. */\r\n  readonly deltaY: number;\r\n  /** Delta mode */\r\n  readonly deltaMode: number;\r\n}\r\n\r\n/**\r\n * Base interface for all controller keyboard events.\r\n *\r\n * Provides key identification along with standard modifier flags.\r\n *\r\n * @public\r\n */\r\nexport interface IControllerKeyboardEvent<T extends string> extends IBaseEvent<T>, IModKey {\r\n  /** key code */\r\n  readonly code: string;\r\n  /** Character value */\r\n  readonly key: string;\r\n}\r\n\r\n/**\r\n * Key down event for camera controllers.\r\n *\r\n * Triggered when a keyboard key is pressed down.\r\n *\r\n * @public\r\n */\r\nexport interface IControllerKeydownEvent extends IControllerKeyboardEvent<'keydown'> {}\r\n\r\n/**\r\n * Key up event for camera controllers.\r\n *\r\n * Triggered when a keyboard key is released.\r\n *\r\n * @public\r\n */\r\nexport interface IControllerKeyupEvent extends IControllerKeyboardEvent<'keyup'> {}\r\n\r\n/**\r\n * Key press event for camera controllers.\r\n *\r\n * Triggered when a key is pressed and generates a character value (legacy usage).\r\n *\r\n * @public\r\n */\r\nexport interface IControllerKeypressEvent extends IControllerKeyboardEvent<'keypress'> {}\r\n\r\n/**\r\n * Base class for camera controllers.\r\n *\r\n * Provides a common lifecycle and event-handling surface for concrete camera controllers\r\n * (e.g., orbit, fly, FPS). Subclasses implement protected handler methods to react to\r\n * mouse/keyboard input, and update camera transforms in `update()`.\r\n *\r\n * Responsibilities:\r\n * - Holds a reference to a `Camera` and resets internal state when the camera changes.\r\n * - Offers a `lookAt(from, to, up)` helper that delegates to the camera.\r\n * - Exposes public event entry points (`onMouseDown`, `onMouseUp`, `onMouseMove`,\r\n *   `onMouseWheel`, `onKeyDown`, `onKeyUp`) that forward to protected handlers which\r\n *   subclasses can override.\r\n * - Defines `reset()` and `update()` lifecycle methods for state initialization and per-frame updates.\r\n *\r\n * Event handling contract:\r\n * - Each public `onXxx` method returns a boolean that indicates whether the event\r\n *   was handled by the controller. Returning `true` allows upstream dispatchers to\r\n *   stop propagation if desired.\r\n *\r\n * Subclassing guidelines:\r\n * - Override the protected `_onXxx` handlers rather than the public `onXxx` methods.\r\n * - Override `reset()` to reinitialize controller state when a new camera is attached.\r\n * - Override `update()` to advance state each frame (e.g., apply accumulated deltas with damping).\r\n *\r\n * Lifecycle:\r\n * 1. A camera is attached via internal `_setCamera(camera)`, which calls `reset()`.\r\n * 2. Input events are passed in through the public `onXxx` methods.\r\n * 3. Per-frame, `update()` is called to apply state changes to the camera.\r\n *\r\n * Thread-safety/assumptions:\r\n * - Designed for use on the main thread in a browser environment.\r\n * - Pointer events are used for mouse input; keyboard events for key input.\r\n *\r\n * @public\r\n */\r\nexport class BaseCameraController {\r\n  /** @internal */\r\n  private _camera: Nullable<Camera>;\r\n  /** @internal */\r\n  private _enabled: boolean;\r\n  /**\r\n   * Create a base camera controller.\r\n   *\r\n   * The controller starts without an attached camera. Call the internal `_setCamera`\r\n   * to attach a camera (performed by the owning system), which triggers `reset()`.\r\n   */\r\n  constructor() {\r\n    this._camera = null;\r\n    this._enabled = true;\r\n  }\r\n  /**\r\n   * Get the attached camera.\r\n   *\r\n   * @returns The current camera or `null` if none is attached.\r\n   */\r\n  _getCamera() {\r\n    return this._camera;\r\n  }\r\n  /**\r\n   * Attach a camera to the controller.\r\n   *\r\n   * If the camera changes, the controller will call `reset()` so subclasses can\r\n   * reinitialize state that depends on the camera.\r\n   *\r\n   * @param camera - The camera to attach.\r\n   */\r\n  _setCamera(camera: Nullable<Camera>) {\r\n    if (this._camera !== camera) {\r\n      this._camera = camera;\r\n      this.reset();\r\n    }\r\n  }\r\n  /**\r\n   * Check if the controller is enabled.\r\n   */\r\n  get enabled() {\r\n    return this._enabled;\r\n  }\r\n  set enabled(value: boolean) {\r\n    this._enabled = value;\r\n  }\r\n  /**\r\n   * Convenience method that delegates to `camera.lookAt`.\r\n   *\r\n   * @param from - Camera position.\r\n   * @param to - Look-at target.\r\n   * @param up - Up direction.\r\n   */\r\n  lookAt(from: Vector3, to: Vector3, up: Vector3) {\r\n    this._camera?.lookAt(from, to, up);\r\n  }\r\n  /**\r\n   * Reset the controller's internal state.\r\n   *\r\n   * Called automatically when a camera is attached via `_setCamera`. Subclasses\r\n   * should override this to reset accumulators, velocities, targets, etc.\r\n   */\r\n  reset() {}\r\n  /**\r\n   * Handle pointer down (mouse/touch/pen) events.\r\n   *\r\n   * @param evt - The pointer event.\r\n   * @returns `true` if handled and should stop further processing; otherwise `false`.\r\n   */\r\n  onMouseDown(evt: IControllerPointerDownEvent) {\r\n    return this._enabled ? this._onMouseDown(evt) : false;\r\n  }\r\n  /**\r\n   * Handle pointer up events.\r\n   *\r\n   * @param evt - The pointer event.\r\n   * @returns `true` if handled; otherwise `false`.\r\n   */\r\n  onMouseUp(evt: IControllerPointerUpEvent) {\r\n    return this._enabled ? this._onMouseUp(evt) : false;\r\n  }\r\n  /**\r\n   * Handle mouse wheel (scroll) events.\r\n   *\r\n   * Typical usage: zoom/dolly control, FOV adjustments.\r\n   *\r\n   * @param evt - The wheel event.\r\n   * @returns `true` if handled; otherwise `false`.\r\n   */\r\n  onMouseWheel(evt: IControllerWheelEvent) {\r\n    return this._enabled ? this._onMouseWheel(evt) : false;\r\n  }\r\n  /**\r\n   * Handle pointer move events.\r\n   *\r\n   * Typical usage: orbit, pan, or look controls based on button/modifier state.\r\n   *\r\n   * @param evt - The pointer event.\r\n   * @returns `true` if handled; otherwise `false`.\r\n   */\r\n  onMouseMove(evt: IControllerPointerMoveEvent) {\r\n    return this._enabled ? this._onMouseMove(evt) : false;\r\n  }\r\n  /**\r\n   * Handle key down events.\r\n   *\r\n   * Typical usage: WASD navigation, modifiers for speed, toggling modes.\r\n   *\r\n   * @param evt - The keyboard event.\r\n   * @returns `true` if handled; otherwise `false`.\r\n   */\r\n  onKeyDown(evt: IControllerKeydownEvent) {\r\n    return this._enabled ? this._onKeyDown(evt) : false;\r\n  }\r\n  /**\r\n   * Handle key up events.\r\n   *\r\n   * @param evt - The keyboard event.\r\n   * @returns `true` if handled; otherwise `false`.\r\n   */\r\n  onKeyUp(evt: IControllerKeyupEvent) {\r\n    return this._enabled ? this._onKeyUp(evt) : false;\r\n  }\r\n  /**\r\n   * Per-frame update.\r\n   *\r\n   * Subclasses should override this to:\r\n   * - Integrate velocities/accelerations and apply damping.\r\n   * - Smoothly interpolate camera transforms.\r\n   * - Clamp angles/distances/FOV, etc.\r\n   *\r\n   * Called once per frame by the owning system.\r\n   */\r\n  update() {\r\n    if (this._enabled) {\r\n      this._onUpdate();\r\n    }\r\n  }\r\n  /**\r\n   * Mouse down event handler\r\n   * @param evt - Mouse event\r\n   * @returns Boolean value indices whether this event was handled\r\n   */\r\n  protected _onMouseDown(_evt: IControllerPointerDownEvent): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Pointer up handler for subclasses to override.\r\n   *\r\n   * @param _evt - Pointer event.\r\n   * @returns `true` if handled; otherwise `false`.\r\n   */\r\n  protected _onMouseUp(_evt: IControllerPointerUpEvent): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Mouse wheel handler for subclasses to override.\r\n   *\r\n   * @param _evt - Wheel event.\r\n   * @returns `true` if handled; otherwise `false`.\r\n   */\r\n  protected _onMouseWheel(_evt: IControllerWheelEvent): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Pointer move handler for subclasses to override.\r\n   *\r\n   * @param _evt - Pointer event.\r\n   * @returns `true` if handled; otherwise `false`.\r\n   */\r\n  protected _onMouseMove(_evt: IControllerPointerMoveEvent): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Key down handler for subclasses to override.\r\n   *\r\n   * @param _evt - Keyboard event.\r\n   * @returns `true` if handled; otherwise `false`.\r\n   */\r\n  protected _onKeyDown(_evt: IControllerKeydownEvent): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Key up handler for subclasses to override.\r\n   *\r\n   * @param _evt - Keyboard event.\r\n   * @returns `true` if handled; otherwise `false`.\r\n   */\r\n  protected _onKeyUp(_evt: IControllerKeyupEvent): boolean {\r\n    return false;\r\n  }\r\n  /**\r\n   * Per-frame update handler for subclasses to override.\r\n   */\r\n  protected _onUpdate() {\r\n    // Subclasses can override this for per-frame updates.\r\n  }\r\n}\r\n"],"names":["BaseCameraController","_camera","_enabled","_getCamera","_setCamera","camera","reset","enabled","value","lookAt","from","to","up","onMouseDown","evt","_onMouseDown","onMouseUp","_onMouseUp","onMouseWheel","_onMouseWheel","onMouseMove","_onMouseMove","onKeyDown","_onKeyDown","onKeyUp","_onKeyUp","update","_onUpdate","_evt"],"mappings":"AAmJA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmCC,IACM,MAAMA,oBAAAA,CAAAA;qBAEX,OAAkC;qBAElC,QAA0B;AAC1B;;;;;AAKC,MACD,WAAc,EAAA;QACZ,IAAI,CAACC,OAAO,GAAG,IAAA;QACf,IAAI,CAACC,QAAQ,GAAG,IAAA;AAClB;AACA;;;;AAIC,MACDC,UAAa,GAAA;QACX,OAAO,IAAI,CAACF,OAAO;AACrB;AACA;;;;;;;MAQAG,UAAAA,CAAWC,MAAwB,EAAE;AACnC,QAAA,IAAI,IAAI,CAACJ,OAAO,KAAKI,MAAQ,EAAA;YAC3B,IAAI,CAACJ,OAAO,GAAGI,MAAAA;AACf,YAAA,IAAI,CAACC,KAAK,EAAA;AACZ;AACF;AACA;;AAEC,MACD,IAAIC,OAAU,GAAA;QACZ,OAAO,IAAI,CAACL,QAAQ;AACtB;IACA,IAAIK,OAAAA,CAAQC,KAAc,EAAE;QAC1B,IAAI,CAACN,QAAQ,GAAGM,KAAAA;AAClB;AACA;;;;;;AAMC,MACDC,OAAOC,IAAa,EAAEC,EAAW,EAAEC,EAAW,EAAE;AAC9C,QAAA,IAAI,CAACX,OAAO,EAAEQ,MAAAA,CAAOC,MAAMC,EAAIC,EAAAA,EAAAA,CAAAA;AACjC;AACA;;;;;AAKC,MACDN,QAAQ;AACR;;;;;MAMAO,WAAAA,CAAYC,GAAgC,EAAE;QAC5C,OAAO,IAAI,CAACZ,QAAQ,GAAG,IAAI,CAACa,YAAY,CAACD,GAAO,CAAA,GAAA,KAAA;AAClD;AACA;;;;;MAMAE,SAAAA,CAAUF,GAA8B,EAAE;QACxC,OAAO,IAAI,CAACZ,QAAQ,GAAG,IAAI,CAACe,UAAU,CAACH,GAAO,CAAA,GAAA,KAAA;AAChD;AACA;;;;;;;MAQAI,YAAAA,CAAaJ,GAA0B,EAAE;QACvC,OAAO,IAAI,CAACZ,QAAQ,GAAG,IAAI,CAACiB,aAAa,CAACL,GAAO,CAAA,GAAA,KAAA;AACnD;AACA;;;;;;;MAQAM,WAAAA,CAAYN,GAAgC,EAAE;QAC5C,OAAO,IAAI,CAACZ,QAAQ,GAAG,IAAI,CAACmB,YAAY,CAACP,GAAO,CAAA,GAAA,KAAA;AAClD;AACA;;;;;;;MAQAQ,SAAAA,CAAUR,GAA4B,EAAE;QACtC,OAAO,IAAI,CAACZ,QAAQ,GAAG,IAAI,CAACqB,UAAU,CAACT,GAAO,CAAA,GAAA,KAAA;AAChD;AACA;;;;;MAMAU,OAAAA,CAAQV,GAA0B,EAAE;QAClC,OAAO,IAAI,CAACZ,QAAQ,GAAG,IAAI,CAACuB,QAAQ,CAACX,GAAO,CAAA,GAAA,KAAA;AAC9C;AACA;;;;;;;;;AASC,MACDY,MAAS,GAAA;QACP,IAAI,IAAI,CAACxB,QAAQ,EAAE;AACjB,YAAA,IAAI,CAACyB,SAAS,EAAA;AAChB;AACF;AACA;;;;MAKUZ,YAAaa,CAAAA,IAAiC,EAAW;QACjE,OAAO,KAAA;AACT;AACA;;;;;MAMUX,UAAWW,CAAAA,IAA+B,EAAW;QAC7D,OAAO,KAAA;AACT;AACA;;;;;MAMUT,aAAcS,CAAAA,IAA2B,EAAW;QAC5D,OAAO,KAAA;AACT;AACA;;;;;MAMUP,YAAaO,CAAAA,IAAiC,EAAW;QACjE,OAAO,KAAA;AACT;AACA;;;;;MAMUL,UAAWK,CAAAA,IAA6B,EAAW;QAC3D,OAAO,KAAA;AACT;AACA;;;;;MAMUH,QAASG,CAAAA,IAA2B,EAAW;QACvD,OAAO,KAAA;AACT;AACA;;AAEC,MACD,SAAsB,GAAA;;AAEtB;AACF;;;;"}

package/dist/camera/camera.js

@@ -8,8 +8,11 @@ import { FXAA } from '../posteffect/fxaa.js';
 import { Bloom } from '../posteffect/bloom.js';
 import { SAO } from '../posteffect/sao.js';
 import { MotionBlur } from '../posteffect/motionblur.js';
+import { ColorAdjust } from '../posteffect/coloradjust.js';
 import { getDevice } from '../app/api.js';
 import { ScreenAdapter } from '../app/screen.js';
+import { ABufferOIT } from '../render/abuffer_oit.js';
+import { WeightedBlendedOIT } from '../render/weightedblended_oit.js';
 
 /**
  * A renderable camera node that manages view/projection math, frusta,
@@ -31,7 +34,7 @@ import { ScreenAdapter } from '../app/screen.js';
  * @public
  */ class Camera extends SceneNode {
     /** @internal Halton 2-3 sequence used for TAA jittering. */ static _halton23 = halton23(16);
-    /** @internal Per-camera history resources. */ static _historyData = new WeakMap();
+    /** @internal Per-camera history resource manager. */ static _historyResourceManager = new WeakMap();
     /** @internal Screen adapter for this camera */ _screenAdapter;
     /** @internal Whether the camera is adapted */ _adapted;
     /** @internal Adapted viewport */ _adaptedViewport;
@@ -54,6 +57,8 @@ import { ScreenAdapter } from '../app/screen.js';
     /** @internal Scissor rectangle [x, y, w, h]; null uses viewport. */ _scissor;
     /** @internal Clip plane mask for custom clipping schemes. */ _clipMask;
     /** @internal Order-Independent Transparency reference. */ _oit;
+    /** @internal OIT algorithm selection mode. */ _oitMode;
+    /** @internal ABuffer OIT layer budget. */ _oitABufferLayers;
     /** @internal Whether to perform a depth pre-pass. */ _depthPrePass;
     /** @internal Whether command buffers may be reused for optimization. */ _commandBufferReuse;
     /** @internal Hi-Z acceleration enable (primarily for SSR). */ _HiZ;
@@ -71,6 +76,12 @@ import { ScreenAdapter } from '../app/screen.js';
     /** @internal Bloom threshold. */ _bloomThreshold;
     /** @internal Bloom threshold knee (soft thresholding). */ _bloomThresholdKnee;
     /** @internal Bloom intensity. */ _bloomIntensity;
+    /** @internal Color adjustment enable flag (via post effect). */ _colorAdjustEnabled;
+    /** @internal Color adjustment post effect reference. */ _postEffectColorAdjust;
+    /** @internal Color adjustment saturation. */ _colorAdjustSaturation;
+    /** @internal Color adjustment contrast. */ _colorAdjustContrast;
+    /** @internal Color adjustment hue (degrees). */ _colorAdjustHue;
+    /** @internal Color adjustment sharpen amount. */ _colorAdjustSharpen;
     /** @internal FXAA enable flag (via post effect). */ _FXAA;
     /** @internal FXAA post effect reference. */ _postEffectFXAA;
     /** @internal TAA enable flag (via post effect). */ _TAA;
@@ -139,6 +150,8 @@ import { ScreenAdapter } from '../app/screen.js';
         this._frustum = null;
         this._frustumV = null;
         this._oit = new DRef();
+        this._oitMode = 'none';
+        this._oitABufferLayers = 20;
         this._depthPrePass = false;
         this._screenAdapter = new ScreenAdapter();
         this._adapted = false;
@@ -157,6 +170,12 @@ import { ScreenAdapter } from '../app/screen.js';
         this._bloomThreshold = 0.8;
         this._bloomThresholdKnee = 0;
         this._bloomIntensity = 1;
+        this._colorAdjustEnabled = false;
+        this._postEffectColorAdjust = new DRef();
+        this._colorAdjustSaturation = 1;
+        this._colorAdjustContrast = 1;
+        this._colorAdjustHue = 0;
+        this._colorAdjustSharpen = 0;
         this._FXAA = false;
         this._postEffectFXAA = new DRef();
         this._TAA = false;
@@ -346,6 +365,48 @@ import { ScreenAdapter } from '../app/screen.js';
             this._postEffectBloom.get().intensity = val;
         }
     }
+    /** Whether color adjustment is enabled. */ get colorAdjust() {
+        return this._postEffectColorAdjust.get().enabled;
+    }
+    set colorAdjust(val) {
+        this._postEffectColorAdjust.get().enabled = !!val;
+    }
+    /** Color adjustment saturation, 1 means unchanged. */ get colorAdjustSaturation() {
+        return this._colorAdjustSaturation;
+    }
+    set colorAdjustSaturation(val) {
+        this._colorAdjustSaturation = val;
+        if (this._postEffectColorAdjust.get()) {
+            this._postEffectColorAdjust.get().saturation = val;
+        }
+    }
+    /** Color adjustment contrast, 1 means unchanged. */ get colorAdjustContrast() {
+        return this._colorAdjustContrast;
+    }
+    set colorAdjustContrast(val) {
+        this._colorAdjustContrast = val;
+        if (this._postEffectColorAdjust.get()) {
+            this._postEffectColorAdjust.get().contrast = val;
+        }
+    }
+    /** Color adjustment hue in degrees. */ get colorAdjustHue() {
+        return this._colorAdjustHue;
+    }
+    set colorAdjustHue(val) {
+        this._colorAdjustHue = val;
+        if (this._postEffectColorAdjust.get()) {
+            this._postEffectColorAdjust.get().hue = val;
+        }
+    }
+    /** Color adjustment sharpen amount, 0 means disabled. */ get colorAdjustSharpen() {
+        return this._colorAdjustSharpen;
+    }
+    set colorAdjustSharpen(val) {
+        this._colorAdjustSharpen = val;
+        if (this._postEffectColorAdjust.get()) {
+            this._postEffectColorAdjust.get().sharpen = val;
+        }
+    }
     /**
    * Gets whether FXAA is enabled.
    */ get FXAA() {
@@ -572,6 +633,32 @@ import { ScreenAdapter } from '../app/screen.js';
     }
     set oit(val) {
         this._oit.set(val);
+        const inferredMode = this.inferOITMode(val);
+        if (inferredMode) {
+            this._oitMode = inferredMode;
+        }
+    }
+    /** OIT mode */ get oitMode() {
+        return this._oitMode;
+    }
+    set oitMode(val) {
+        const mode = val ?? 'none';
+        if (mode !== this._oitMode) {
+            this._oitMode = mode;
+            this._oit.set(this.createOITForMode(mode));
+        }
+    }
+    /** ABuffer OIT layer budget. */ get oitABufferLayers() {
+        return this._oitABufferLayers;
+    }
+    set oitABufferLayers(val) {
+        const layers = Math.max(1, Math.floor(val || 0));
+        if (layers !== this._oitABufferLayers) {
+            this._oitABufferLayers = layers;
+            if (this._oitMode === 'abuffer') {
+                this._oit.set(this.createOITForMode('abuffer'));
+            }
+        }
     }
     /** Clip plane mask */ get clipMask() {
         return this._clipMask;
@@ -664,10 +751,12 @@ import { ScreenAdapter } from '../app/screen.js';
    *
    * @param x - The x-component of the screen coordinates, relative to the top-left corner of the viewport.
    * @param y - The y-component of the screen coordinates, relative to the top-left corner of the viewport.
+   * @param viewportWidth - Optional width of the viewport for normalizing screen coordinates. If not provided, it will be derived from the camera's viewport or the device's viewport.
+   * @param viewportHeight - Optional height of the viewport for normalizing screen coordinates. If not provided, it will be derived from the camera's viewport or the device's viewport.
    * @returns The ray originating from the camera position and passing through the given screen coordinates.
-   */ constructRay(x, y) {
-        const width = this.viewport ? this.viewport[2] : getDevice().getViewport().width;
-        const height = this.viewport ? this.viewport[3] : getDevice().getViewport().height;
+   */ constructRay(x, y, viewportWidth, viewportHeight) {
+        const width = viewportWidth ?? (this.viewport ? this.viewport[2] : getDevice().getViewport().width);
+        const height = viewportHeight ?? (this.viewport ? this.viewport[3] : getDevice().getViewport().height);
         const ndcX = 2 * x / width - 1;
         const ndcY = 1 - 2 * y / height;
         const nearClip = new Vector4(ndcX, ndcY, -1, 1);
@@ -840,31 +929,31 @@ import { ScreenAdapter } from '../app/screen.js';
         return this.getProjectionMatrix().isOrtho();
     }
     /**
-   * Gets the camera history data which is used in temporal reprojection
-   * @returns Camera history data
-   */ getHistoryData() {
-        let data = Camera._historyData.get(this);
-        if (!data) {
-            data = {
-                prevColorTex: null,
-                prevMotionVectorTex: null
-            };
-            Camera._historyData.set(this, data);
+   * Gets the camera history resource manager for temporal effects
+   * @returns History resource manager
+   */ getHistoryResourceManager() {
+        let manager = Camera._historyResourceManager.get(this);
+        if (!manager) {
+            // Import dynamically to avoid circular dependency
+            // The actual import happens in forward_plus_builder.ts
+            return null;
         }
-        return data;
+        return manager;
+    }
+    /**
+   * Sets the camera history resource manager for temporal effects
+   * @internal
+   */ setHistoryResourceManager(manager) {
+        Camera._historyResourceManager.set(this, manager);
     }
     /**
    * Clears the camera history data which is used in temporal reprojection
    */ clearHistoryData() {
-        const data = Camera._historyData.get(this);
-        if (data) {
-            if (data.prevColorTex) {
-                getDevice().pool.releaseTexture(data.prevColorTex);
-            }
-            if (data.prevMotionVectorTex) {
-                getDevice().pool.releaseTexture(data.prevMotionVectorTex);
-            }
-            Camera._historyData.delete(this);
+        // Clear history resource manager
+        const manager = Camera._historyResourceManager.get(this);
+        if (manager) {
+            manager.dispose();
+            Camera._historyResourceManager.delete(this);
         }
         this._prevVPMatrix = null;
         this._prevPosition = null;
@@ -910,6 +999,16 @@ import { ScreenAdapter } from '../app/screen.js';
             this._postEffectTonemap.set(tonemap);
             this._compositor.appendPostEffect(tonemap);
         }
+        if (!this._postEffectColorAdjust.get()) {
+            const colorAdjust = new ColorAdjust();
+            colorAdjust.enabled = false;
+            colorAdjust.saturation = this._colorAdjustSaturation;
+            colorAdjust.contrast = this._colorAdjustContrast;
+            colorAdjust.hue = this._colorAdjustHue;
+            colorAdjust.sharpen = this._colorAdjustSharpen;
+            this._postEffectColorAdjust.set(colorAdjust);
+            this._compositor.appendPostEffect(colorAdjust);
+        }
         if (!this._postEffectFXAA.get()) {
             const fxaa = new FXAA();
             fxaa.enabled = false;
@@ -1080,8 +1179,31 @@ import { ScreenAdapter } from '../app/screen.js';
         this._postEffectSSR.dispose();
         this._postEffectTAA.dispose();
         this._postEffectTonemap.dispose();
+        this._postEffectColorAdjust.dispose();
         this._oit.dispose();
     }
+    /** @internal */ createOITForMode(mode) {
+        if (mode === 'abuffer') {
+            return new ABufferOIT(this._oitABufferLayers);
+        }
+        if (mode === 'weighted') {
+            return new WeightedBlendedOIT();
+        }
+        return null;
+    }
+    /** @internal */ inferOITMode(oit) {
+        if (!oit) {
+            return 'none';
+        }
+        const type = oit.getType();
+        if (type === ABufferOIT.type) {
+            return 'abuffer';
+        }
+        if (type === WeightedBlendedOIT.type) {
+            return 'weighted';
+        }
+        return null;
+    }
     /** @internal */ posInViewport(x, y) {
         let rect = this._interactionRect;
         if (!rect && this.viewport) {