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

package/dist/index.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 } 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 } from '@utsp/types';
 export { AxisBinding, AxisSource, ButtonBinding, ButtonSource, InputBindingLoadPacket, RenderState, RenderedCell, ScalingModeValue, UserRenderState, Vector2 } from '@utsp/types';
 
 /**
@@ -2497,6 +2497,100 @@ type GamepadVibrationOrder = GamepadVibrateOrder | GamepadCancelOrder;
  */
 type AnyVibrationOrder = MobileVibrateOrder | MobileCancelOrder | GamepadVibrateOrder | GamepadCancelOrder;
 
+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
@@ -2512,6 +2606,8 @@ interface NetworkDisplay {
     sizeX: number;
     /** Display height in cells (1-256) */
     sizeY: number;
+    /** Optional render pass configuration (max 4 passes) */
+    renderPasses?: RenderPassConfig[];
 }
 
 interface NetworkLayer {
@@ -2836,82 +2932,6 @@ interface UpdatePacket {
     };
 }
 
-/**
- * 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;
-        };
-    };
-}
-
 /**
  * Maximum number of orders per layer (encoded as 1 byte)
  * Exceeding this limit will cause packet corruption!
@@ -9328,7 +9348,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)
@@ -9841,4 +9861,4 @@ declare class PostProcessOrderCollector {
 }
 
 export { ASCII_8X8_FONT, AUDIO_CONFIGURE_SPATIAL_SIZE, AUDIO_FADEOUT_SOUND_MIN_SIZE, AUDIO_PAUSE_SOUND_MIN_SIZE, AUDIO_PLAY_GLOBAL_SOUND_MIN_SIZE, AUDIO_PLAY_SOUND_MIN_SIZE, AUDIO_RESUME_SOUND_MIN_SIZE, AUDIO_SET_LISTENER_POSITION_SIZE, AUDIO_SET_SOUND_EFFECTS_MIN_SIZE, AUDIO_STOP_SOUND_MIN_SIZE, AudioOrderCollector, AudioOrderDecoder, AudioOrderType, AudioTargetType, BITMASK16_ORDER_MIN_SIZE, BITMASK4_ORDER_MIN_SIZE, BITMASK_ORDER_MIN_SIZE, BitmapFont, BitmapFontRegistry, CHAR_ORDER_SIZE, CIRCLE_SHAPE_SIZE, CLEAR_ORDER_SIZE, COLORMAP_ORDER_MIN_SIZE, COLOR_SKIP, CellBuffer, CharCodeBuffer, Core, CoreStats, DISPLAY_HEADER_SIZE, DOTCLOUD_MULTICOLOR_ORDER_MIN_SIZE, DOTCLOUD_ORDER_MIN_SIZE, Display, ELLIPSE_SHAPE_SIZE, FILLCHAR_ORDER_MIN_SIZE, FILLSPRITE_MULTICOLOR_ORDER_SIZE, FILLSPRITE_ORDER_SIZE, FULLFRAME_MULTICOLOR_ORDER_MIN_SIZE, FULLFRAME_ORDER_MIN_SIZE, FontType, GamepadVibrateFlags, ImageFont, ImageFontRegistry, InputBindingRegistry, LAYER_CELL_COUNT, LAYER_HEADER_SIZE, LAYER_SIZE, LINE_SHAPE_SIZE, Layer, LoadType, MAX_ORDERS_PER_LAYER, MacroEngine, MacroEventType, MacroOrderType, MacroRegistry, MobileVibrateFlags, OrderBuilder, OrderType, POLYLINE_ORDER_MIN_SIZE, POSTPROCESS_SET_AMBIENT_EFFECT_SIZE, POSTPROCESS_SET_CELL_SIZE_SIZE, POSTPROCESS_SET_CONFIG_MIN_SIZE, POSTPROCESS_SET_GRID_SIZE, POSTPROCESS_SET_SCALING_MODE_SIZE, POSTPROCESS_SET_SCANLINES_SIZE, POSTPROCESS_SWITCH_PALETTE_SIZE, PlaySoundFlags, PostProcessOrderCollector, PostProcessOrderDecoder, PostProcessOrderType, RECTANGLE_SHAPE_SIZE, SHAPE_ORDER_MIN_SIZE, SPRITECLOUD_MULTICOLOR_ORDER_MIN_SIZE, SPRITECLOUD_ORDER_MIN_SIZE, SPRITECLOUD_VARIED_MULTICOLOR_ORDER_MIN_SIZE, SPRITECLOUD_VARIED_ORDER_MIN_SIZE, SPRITE_MULTICOLOR_ORDER_SIZE, SPRITE_ORDER_SIZE, SUBFRAME_MULTICOLOR_ORDER_MIN_SIZE, SUBFRAME_ORDER_MIN_SIZE, ShapeType, SoundEffectsFlags, SoundRegistry, SpriteRegistry, TEXT_MULTILINE_ORDER_MIN_SIZE, TEXT_ORDER_MIN_SIZE, TRIANGLE_SHAPE_SIZE, UPDATE_PACKET_HEADER_SIZE, UpdateFlags, UpdateFlagsHelper, UpdatePacketDecoder, User, UserStats, VibrationOrderCollector, VibrationOrderDecoder, VibrationOrderEncoder, VibrationOrderType, WebFont, WebFontRegistry, charCodeByteSize, createASCII8x8FontLoad, createEmptyCompressedInputPacket, decodeCompressedInput, decodeInt8ToAxis, encodeAxisToInt8, encodeCompressedInput, getASCII8x8FontConfig, getAllCharCodes, getAtlasColumns, getAtlasDimensions, getAudioOrderTypeName, getButtonByteCount, getCharBitmap, getCompressedPacketSize, getMacroEventTypeName, getMacroOrderTypeName, getMaxCharCode, getOrderTypeName, hasChar, isValidAudioOrderType, isValidMacroEventType, isValidMacroOrderType, isValidOrderType };
-export type { AnyAudioOrder, AnyLoad, AnyMacroEvent, AnyMacroOrder, AnyPostProcessOrder, AnyVibrationOrder, AtlasBlocks, AudioOrder, BitmapFontConfig, BitmapFontLoad, Bitmask16Order, Bitmask16Variant, Bitmask4Order, Bitmask4Variant, BitmaskOrder, ButtonBorderStyle, ButtonConfig, ButtonStateColors, Cell, ChangeEvent, CharCodeMode, CircleShape, ClickEvent, Color, ColorPaletteLoad, CompressedInputPacket, ConfigureSpatialOrder, CoreMode, CoreOptions, CreateInstanceConfig, CreateInstanceOrder, DisplayViewport, EffectMacroTemplate, EffectTransform, EllipseShape, FadeOutSoundOrder, GamepadCancelOrder, GamepadVibrateOrder, GamepadVibrationOrder, GlyphSize, ImageFontConfig, ImageFontLoad, ImageFontOptions, LineMacroTemplate, LineShape, MacroEntry, MacroEvent, MacroInstanceEntry, MacroLoad, MacroOrder, MacroTemplate, MacroTemplateBase, MacroType, MacroUpdateResult, MobileCancelOrder, MobileVibrateOrder, MobileVibrationOrder, MulticolorCell, MulticolorSprite, MulticolorSpriteLoad, NetworkDisplay, NetworkLayer, ParticleConfig, ParticleEmitter, ParticleMacroTemplate, PauseSoundOrder, PlayGlobalSoundOrder, PlaySoundOrder, RectangleShape, RemoveInstanceOrder, RenderCommand, ResumeSoundOrder, RevealCellDef, RevealContent, RevealContentType, RevealCursor, RevealDirection, RevealMacroTemplate, RevealPattern, RevealPause, SelectEvent, SetAmbientEffectOrder, SetConfigOrder, SetGridOrder, SetListenerPositionOrder, SetScalingModeOrder, SetScanlinesOrder, SetSoundEffectsOrder, ShapeData, SoundEntry, SoundLoad, SpriteLoad, StopSoundOrder, SubmitEvent, SwitchPaletteOrder, TickStats, TouchPosition, TriangleShape, UIMacroTemplate, UIState, UISubtype, UnicolorSprite, UpdateInstanceOrder, UpdatePacket, UserTickStats, VibrationOrder, WebFontConfig, WebFontLoad };
+export type { AnyAudioOrder, AnyLoad, AnyMacroEvent, AnyMacroOrder, AnyPostProcessOrder, AnyVibrationOrder, AtlasBlocks, AudioOrder, BitmapFontConfig, BitmapFontLoad, Bitmask16Order, Bitmask16Variant, Bitmask4Order, Bitmask4Variant, BitmaskOrder, ButtonBorderStyle, ButtonConfig, ButtonStateColors, Cell, ChangeEvent, CharCodeMode, CircleShape, ClickEvent, Color, ColorPaletteLoad, CompressedInputPacket, ConfigureSpatialOrder, CoreMode, CoreOptions, CreateInstanceConfig, CreateInstanceOrder, DisplayViewport, EffectMacroTemplate, EffectTransform, EllipseShape, FadeOutSoundOrder, GamepadCancelOrder, GamepadVibrateOrder, GamepadVibrationOrder, GlyphSize, ImageFontConfig, ImageFontLoad, ImageFontOptions, LineMacroTemplate, LineShape, MacroEntry, MacroEvent, MacroInstanceEntry, MacroLoad, MacroOrder, MacroTemplate, MacroTemplateBase, MacroType, MacroUpdateResult, MobileCancelOrder, MobileVibrateOrder, MobileVibrationOrder, MulticolorCell, MulticolorSprite, MulticolorSpriteLoad, NetworkDisplay, NetworkLayer, ParticleConfig, ParticleEmitter, ParticleMacroTemplate, PauseSoundOrder, PlayGlobalSoundOrder, PlaySoundOrder, RectangleShape, RemoveInstanceOrder, RenderCommand, RenderPassConfig, ResumeSoundOrder, RevealCellDef, RevealContent, RevealContentType, RevealCursor, RevealDirection, RevealMacroTemplate, RevealPattern, RevealPause, SelectEvent, SetAmbientEffectOrder, SetConfigOrder, SetGridOrder, SetListenerPositionOrder, SetScalingModeOrder, SetScanlinesOrder, SetSoundEffectsOrder, ShapeData, SoundEntry, SoundLoad, SpriteLoad, StopSoundOrder, SubmitEvent, SwitchPaletteOrder, TickStats, TouchPosition, TriangleShape, UIMacroTemplate, UIState, UISubtype, UnicolorSprite, UpdateInstanceOrder, UpdatePacket, UserTickStats, VibrationOrder, WebFontConfig, WebFontLoad };