@utsp/core 0.15.0 → 0.16.0-nightly.20260101200530.42ed56f

package/dist/benchmark.d.ts

@@ -1,5 +1,5 @@
 import * as _utsp_types from '@utsp/types';
-import { ScalingModeValue, Vector2, AxisSource, ButtonSource, InputBindingLoadPacket, AxisBinding, ButtonBinding, TouchZoneBinding, SoundInstanceId, AudioConfigCommand, PlaySoundCommand, StopSoundCommand, FadeOutSoundCommand, PauseSoundCommand, ResumeSoundCommand, SetSoundEffectsCommand, IAudioProcessor, VibrationPattern, GamepadVibrationOptions, GamepadVibrationCommand, IGamepadVibrationProcessor, MobileVibrationCommand, IMobileVibrationProcessor, AudioAck, PostProcessConfig, PostProcessCommand, ScalingMode, GridConfig, SoundFormat, SoundLoadType, SoundLoadPacket, SoundExternalLoadPacket, UserRenderState, RenderState } from '@utsp/types';
+import { Vector2, ScalingModeValue, AxisSource, ButtonSource, InputBindingLoadPacket, AxisBinding, ButtonBinding, TouchZoneBinding, SoundInstanceId, AudioConfigCommand, PlaySoundCommand, StopSoundCommand, FadeOutSoundCommand, PauseSoundCommand, ResumeSoundCommand, SetSoundEffectsCommand, IAudioProcessor, VibrationPattern, GamepadVibrationOptions, GamepadVibrationCommand, IGamepadVibrationProcessor, MobileVibrationCommand, IMobileVibrationProcessor, AudioAck, PostProcessConfig, PostProcessCommand, ScalingMode, GridConfig, SoundFormat, SoundLoadType, SoundLoadPacket, SoundExternalLoadPacket, UserRenderState, RenderState } from '@utsp/types';
 export { Vector2 } from '@utsp/types';
 
 /**
@@ -425,6 +425,100 @@ declare class OrderEncoder {
     private encodeFillSpriteMultiColorOrder;
 }
 
+interface RenderPassConfig {
+    id: number;
+    zMin: number;
+    zMax: number;
+    enabled?: boolean;
+}
+/**
+ * Represents a display (camera) in the virtual world
+ *
+ * ARCHITECTURE (new protocol):
+ * - Display = camera looking into the virtual world
+ * - LAYERS are NO LONGER in Display, they are at User level
+ * - Display only defines WHICH PART of the world we see (origin)
+ */
+declare class Display {
+    private id;
+    private origin;
+    private size;
+    private previousOrigin;
+    private previousSize;
+    private toDraw;
+    private renderPasses;
+    constructor(id?: number, sizeX?: number, sizeY?: number);
+    /**
+     * Gets the display ID (0-255)
+     */
+    getId(): number;
+    /**
+     * Gets the origin position in the world
+     */
+    getOrigin(): Vector2;
+    /**
+     * Sets the origin position in the world
+     */
+    setOrigin(origin: Vector2): void;
+    /**
+     * Moves the origin in the world
+     */
+    moveOrigin(deltaX: number, deltaY: number): void;
+    /**
+     * Checks if display origin has changed since last tick
+     * @internal - Used to calculate if update should be sent
+     */
+    hasOriginChanged(): boolean;
+    /**
+     * Checks if display size has changed since last tick
+     * @internal - Used to calculate if update should be sent
+     */
+    hasSizeChanged(): boolean;
+    /**
+     * Checks if display has changed (origin OR size)
+     * @internal
+     */
+    hasChanged(): boolean;
+    /**
+     * Resets change tracking
+     * @internal - Called by Core.endTick() after sending updates
+     */
+    resetChangeTracking(): void;
+    /**
+     * Gets the display size
+     */
+    getSize(): Vector2;
+    /**
+     * Sets the display size
+     */
+    setSize(size: Vector2): void;
+    /**
+     * Returns the validated render passes (undefined = single pass [0,255])
+     */
+    getRenderPasses(): RenderPassConfig[] | undefined;
+    /**
+     * Sets the render passes configuration (0..4 passes). Applies clamping and swap.
+     * Passing undefined resets to single pass behavior.
+     */
+    setRenderPasses(passes: RenderPassConfig[] | undefined): void;
+    private normalizePass;
+    /**
+     * Returns a debug-friendly snapshot of this display (metadata only)
+     */
+    getDebugInfo(): {
+        id: number;
+        origin: {
+            x: number;
+            y: number;
+        };
+        size: {
+            x: number;
+            y: number;
+        };
+        renderPasses?: RenderPassConfig[];
+    };
+}
+
 /**
  * Network representation of a display
  * Layers are NO LONGER under displays - they are at User level
@@ -440,6 +534,8 @@ interface NetworkDisplay {
     sizeX: number;
     /** Display height in cells (1-256) */
     sizeY: number;
+    /** Optional render pass configuration (max 4 passes) */
+    renderPasses?: RenderPassConfig[];
 }
 
 /**
@@ -459,13 +555,15 @@ declare class DisplayEncoder {
      * - OriginY: 2 bytes (big-endian)
      * - SizeX: 1 byte (1-256 encoded as 0-255)
      * - SizeY: 1 byte (1-256 encoded as 0-255)
+     * - PassCount: 1 byte (0-4 render passes)
+     * - RenderPasses (optional): 4 bytes each → Id(1) + zMin(1) + zMax(1) + flags(1)
      *
-     * Total: 7 bytes per display
+     * Total: 8 bytes + (4 * passCount) per display
      */
     encode(display: NetworkDisplay): Uint8Array;
     /**
      * Calculates the size of an encoded display
-     * Always 7 bytes in the new protocol (DisplayId + OriginX + OriginY + SizeX + SizeY)
+     * 8 bytes + 4 * passCount (DisplayId + OriginX + OriginY + SizeX + SizeY + PassCount + RenderPasses)
      */
     calculateSize(_display: NetworkDisplay): number;
 }
@@ -1736,6 +1834,8 @@ interface UpdatePacket {
  *   - OriginY: 2 bytes (big-endian)
  *   - SizeX: 1 byte (1-256, encoded as 0-255)
  *   - SizeY: 1 byte (1-256, encoded as 0-255)
+ *   - PassCount: 1 byte (0-4 render passes)
+ *   - RenderPasses: 4 bytes each (Id + zMin + zMax + flags)
  * - LayerCount: 2 bytes (big-endian)
  * - For each Layer: (encoded by LayerEncoder)
  * - AudioOrderCount: 1 byte (max 255 audio orders per frame)
@@ -1753,6 +1853,7 @@ declare class UpdatePacketEncoder {
     private vibrationOrderEncoder;
     private macroOrderEncoder;
     private postProcessOrderEncoder;
+    private displayEncoder;
     constructor();
     /**
      * Encodes an UpdatePacket to binary buffer
@@ -2543,8 +2644,10 @@ declare class DisplayDecoder {
      * - OriginY: 2 bytes (big-endian)
      * - SizeX: 1 byte (encoded as 0-255, actual value 1-256)
      * - SizeY: 1 byte (encoded as 0-255, actual value 1-256)
+     * - PassCount: 1 byte (0-4 render passes)
+     * - RenderPasses (optional): 4 bytes each → Id(1) + zMin(1) + zMax(1) + flags(1)
      *
-     * Total: 7 bytes per display
+     * Total: 8 bytes + (4 * passCount) per display
      */
     decode(buffer: BufferCompat, offset?: number): DisplayDecodeResult;
     private checkSize;
@@ -2602,7 +2705,7 @@ declare class UpdatePacketDecoder {
      * Structure (NEW PROTOCOL):
      * - Tick: 8 bytes (big-endian, 64-bit unsigned integer)
      * - DisplayCount: 1 byte (8-bit unsigned integer, max 255 displays)
-     * - Displays: variable (DisplayId + OriginX + OriginY + SizeX + SizeY = 7 bytes each)
+     * - Displays: variable (DisplayId + OriginX + OriginY + SizeX + SizeY + PassCount + RenderPasses)
      * - LayerCount: 2 bytes (big-endian, 16-bit unsigned integer)
      * - Layers: variable (encoded layers)
      * - AudioOrderCount: 1 byte (max 255 audio orders)
@@ -3675,82 +3778,6 @@ declare class MacroEngine {
     clear(): void;
 }
 
-/**
- * Represents a display (camera) in the virtual world
- *
- * ARCHITECTURE (new protocol):
- * - Display = camera looking into the virtual world
- * - LAYERS are NO LONGER in Display, they are at User level
- * - Display only defines WHICH PART of the world we see (origin)
- */
-declare class Display {
-    private id;
-    private origin;
-    private size;
-    private previousOrigin;
-    private previousSize;
-    private toDraw;
-    constructor(id?: number, sizeX?: number, sizeY?: number);
-    /**
-     * Gets the display ID (0-255)
-     */
-    getId(): number;
-    /**
-     * Gets the origin position in the world
-     */
-    getOrigin(): Vector2;
-    /**
-     * Sets the origin position in the world
-     */
-    setOrigin(origin: Vector2): void;
-    /**
-     * Moves the origin in the world
-     */
-    moveOrigin(deltaX: number, deltaY: number): void;
-    /**
-     * Checks if display origin has changed since last tick
-     * @internal - Used to calculate if update should be sent
-     */
-    hasOriginChanged(): boolean;
-    /**
-     * Checks if display size has changed since last tick
-     * @internal - Used to calculate if update should be sent
-     */
-    hasSizeChanged(): boolean;
-    /**
-     * Checks if display has changed (origin OR size)
-     * @internal
-     */
-    hasChanged(): boolean;
-    /**
-     * Resets change tracking
-     * @internal - Called by Core.endTick() after sending updates
-     */
-    resetChangeTracking(): void;
-    /**
-     * Gets the display size
-     */
-    getSize(): Vector2;
-    /**
-     * Sets the display size
-     */
-    setSize(size: Vector2): void;
-    /**
-     * Returns a debug-friendly snapshot of this display (metadata only)
-     */
-    getDebugInfo(): {
-        id: number;
-        origin: {
-            x: number;
-            y: number;
-        };
-        size: {
-            x: number;
-            y: number;
-        };
-    };
-}
-
 /**
  * MacroRegistry - Registry for macro templates and instances
  *
@@ -9053,6 +9080,8 @@ declare class DisplayRasterizer {
     private opacityBuffer;
     private visibleLayersBuffer;
     private visibleLayerIdsBuffer;
+    private passCellsBuffers;
+    private passOpacityBuffers;
     /**
      * Last computed visible layer IDs (sorted in actual composition order).
      * Updated on every rasterize() call.
@@ -9085,7 +9114,13 @@ declare class DisplayRasterizer {
      * @param layers - All user layers
      * @returns Render state with palette indices + RGB palette
      */
-    rasterize(origin: DisplayOrigin, layers: Layer[]): RenderState;
+    rasterize(origin: DisplayOrigin, layers: Layer[], renderPasses?: RenderPassConfig[]): RenderState;
+    private rasterizeSinglePass;
+    private rasterizeMultiPass;
+    private composePass;
+    private preparePassBuffers;
+    private ensurePassBuffers;
+    private normalizePasses;
     /**
      * Variant that accepts an already sorted layer array (optimization)
      * Note: Still applies visibility filtering for optimization