@utsp/core 0.14.0-nightly.20251219144833.1c27cfe → 0.14.0

package/dist/index.d.ts

@@ -2580,7 +2580,13 @@ declare enum PostProcessOrderType {
      *
      * Parameters: slotId (0-255)
      */
-    SwitchPalette = 6
+    SwitchPalette = 6,
+    /**
+     * 0x07 - SetCellSize: Set cell dimensions in pixels
+     *
+     * Parameters: cellWidth (1-255), cellHeight (1-255)
+     */
+    SetCellSize = 7
 }
 
 /**
@@ -2600,18 +2606,25 @@ declare enum ScanlinesPatternType {
 }
 /**
  * Base interface for all post-process orders
+ *
+ * All post-process orders are scoped to a specific display.
+ * The displayId identifies which display the order applies to.
  */
 interface PostProcessOrderBase {
+    /** Order type identifier */
     type: PostProcessOrderType;
+    /** Display ID this order applies to (0-255) */
+    displayId: number;
 }
 /**
  * SetConfig Order (0x01)
  *
- * Sets the full post-process configuration.
+ * Sets the full post-process configuration for a specific display.
  * Flags indicate which optional sections are present.
  *
  * Binary format:
  * - type: 1 byte (0x01)
+ * - displayId: 1 byte (0-255)
  * - flags: 1 byte (PostProcessConfigFlags)
  * - [if HasScanlines]:
  *   - enabled: 1 byte (0 or 1)
@@ -2649,10 +2662,11 @@ interface SetConfigOrder extends PostProcessOrderBase {
 /**
  * SetScanlines Order (0x02)
  *
- * Sets only the scanlines configuration.
+ * Sets only the scanlines configuration for a specific display.
  *
  * Binary format:
  * - type: 1 byte (0x02)
+ * - displayId: 1 byte (0-255)
  * - enabled: 1 byte (0 or 1)
  * - opacity: 1 byte (0-255, scaled from 0.0-1.0)
  * - pattern: 1 byte (ScanlinesPatternType)
@@ -2672,10 +2686,11 @@ interface SetScanlinesOrder extends PostProcessOrderBase {
 /**
  * SetAmbientEffect Order (0x03)
  *
- * Sets only the ambient effect configuration.
+ * Sets only the ambient effect configuration for a specific display.
  *
  * Binary format:
  * - type: 1 byte (0x03)
+ * - displayId: 1 byte (0-255)
  * - enabled: 1 byte (0 or 1)
  * - blur: 1 byte (0-255 pixels)
  * - scale: 1 byte (100-255, scaled from 1.0-2.55)
@@ -2691,10 +2706,11 @@ interface SetAmbientEffectOrder extends PostProcessOrderBase {
 /**
  * SetScalingMode Order (0x04)
  *
- * Sets the pixel-perfect scaling mode.
+ * Sets the pixel-perfect scaling mode for a specific display.
  *
  * Binary format:
  * - type: 1 byte (0x04)
+ * - displayId: 1 byte (0-255)
  * - mode: 1 byte (ScalingModeValue)
  */
 interface SetScalingModeOrder extends PostProcessOrderBase {
@@ -2704,10 +2720,11 @@ interface SetScalingModeOrder extends PostProcessOrderBase {
 /**
  * SetGrid Order (0x05)
  *
- * Sets the debug grid overlay configuration.
+ * Sets the debug grid overlay configuration for a specific display.
  *
  * Binary format:
  * - type: 1 byte (0x05)
+ * - displayId: 1 byte (0-255)
  * - enabled: 1 byte (0 or 1)
  * - colorR: 1 byte (0-255)
  * - colorG: 1 byte (0-255)
@@ -2727,21 +2744,39 @@ interface SetGridOrder extends PostProcessOrderBase {
 /**
  * SwitchPalette Order (0x06)
  *
- * Switches to a pre-loaded palette slot.
+ * Switches to a pre-loaded palette slot for a specific display.
  * The palette must have been loaded to the Core via loadPaletteToSlot() first.
  *
  * Binary format:
  * - type: 1 byte (0x06)
+ * - displayId: 1 byte (0-255)
  * - slotId: 1 byte (0-255)
  */
 interface SwitchPaletteOrder extends PostProcessOrderBase {
     type: PostProcessOrderType.SwitchPalette;
     slotId: number;
 }
+/**
+ * SetCellSize Order (0x07)
+ *
+ * Sets the cell dimensions in pixels for a specific display.
+ * Used to configure the renderer's native cell size.
+ *
+ * Binary format:
+ * - type: 1 byte (0x07)
+ * - displayId: 1 byte (0-255)
+ * - cellWidth: 1 byte (1-255 pixels)
+ * - cellHeight: 1 byte (1-255 pixels)
+ */
+interface SetCellSizeOrder extends PostProcessOrderBase {
+    type: PostProcessOrderType.SetCellSize;
+    cellWidth: number;
+    cellHeight: number;
+}
 /**
  * Union type for all post-process orders
  */
-type AnyPostProcessOrder = SetConfigOrder | SetScanlinesOrder | SetAmbientEffectOrder | SetScalingModeOrder | SetGridOrder | SwitchPaletteOrder;
+type AnyPostProcessOrder = SetConfigOrder | SetScanlinesOrder | SetAmbientEffectOrder | SetScalingModeOrder | SetGridOrder | SwitchPaletteOrder | SetCellSizeOrder;
 
 /**
  * Update packet according to the new UTSP protocol
@@ -3669,6 +3704,7 @@ declare class User<TData = Record<string, any>> {
     private bytesTickRate;
     private currentTickBytesSent;
     private currentTickBytesReceived;
+    private availableViewports;
     /**
      * Application-specific data storage
      * Use this to store game state, player data, or any custom information
@@ -3698,6 +3734,78 @@ declare class User<TData = Record<string, any>> {
      * Removes all displays from the user
      */
     clearDisplays(): void;
+    /**
+     * Sets the available viewport size (in pixels) for a display
+     *
+     * Called by the server when receiving viewport information from the client.
+     * The application can use this to adapt display resolution.
+     *
+     * @param displayId - Display ID (0-255)
+     * @param pixelWidth - Available width in pixels (0-65535)
+     * @param pixelHeight - Available height in pixels (0-65535)
+     *
+     * @example
+     * ```typescript
+     * // Called automatically by decodeAndApplyCompressedInput()
+     * user.setDisplayViewport(0, 800, 600);
+     * ```
+     */
+    setDisplayViewport(displayId: number, pixelWidth: number, pixelHeight: number): void;
+    /**
+     * Gets the available viewport size (in pixels) for a display
+     *
+     * @param displayId - Display ID (0-255)
+     * @returns Viewport size in pixels, or null if not set
+     *
+     * @example
+     * ```typescript
+     * const viewport = user.getDisplayViewport(0);
+     * if (viewport) {
+     *   console.log(`Available: ${viewport.pixelWidth}x${viewport.pixelHeight}px`);
+     * }
+     * ```
+     */
+    getDisplayViewport(displayId: number): {
+        pixelWidth: number;
+        pixelHeight: number;
+    } | null;
+    /**
+     * Gets all available viewports (in pixels)
+     *
+     * @returns Map of displayId → viewport size
+     */
+    getAllDisplayViewports(): Map<number, {
+        pixelWidth: number;
+        pixelHeight: number;
+    }>;
+    /**
+     * Calculates the maximum number of cells that fit in a display's available viewport
+     *
+     * Helper method that divides pixel dimensions by cell size to get max cells.
+     * The application can use this to decide the optimal display resolution.
+     *
+     * @param displayId - Display ID (0-255)
+     * @param cellWidth - Width of a cell in pixels (e.g., 8 for 8px font)
+     * @param cellHeight - Height of a cell in pixels (e.g., 16 for 16px font)
+     * @returns Max cells { cols, rows }, or null if viewport not set
+     *
+     * @example
+     * ```typescript
+     * // With 8x16 font, calculate how many cells fit in available space
+     * const maxCells = user.calculateMaxCells(0, 8, 16);
+     * if (maxCells) {
+     *   const display = user.getDisplays()[0];
+     *   display.setSize(new Vector2(
+     *     Math.min(maxCells.cols, 120),  // Cap at 120 columns
+     *     Math.min(maxCells.rows, 40)    // Cap at 40 rows
+     *   ));
+     * }
+     * ```
+     */
+    calculateMaxCells(displayId: number, cellWidth: number, cellHeight: number): {
+        cols: number;
+        rows: number;
+    } | null;
     getLayers(): Layer[];
     /**
      * Gets a layer by its ID
@@ -4356,6 +4464,12 @@ declare class User<TData = Record<string, any>> {
      *   // Values are now available
      *   const move = user.getAxis("MoveHorizontal");
      *   if (user.getButton("Jump")) { ... }
+     *
+     *   // Viewport info is available via:
+     *   const viewport = user.getDisplayViewport(0);
+     *   if (viewport) {
+     *     console.log(`Available: ${viewport.pixelWidth}x${viewport.pixelHeight}px`);
+     *   }
      * });
      * ```
      */
@@ -5207,17 +5321,18 @@ declare class User<TData = Record<string, any>> {
      */
     macroActivateFocused(): void;
     /**
-     * Set post-processing configuration
+     * Set post-processing configuration for a specific display
      *
      * The post-process overlay is rendered ONCE when this is called.
      * No per-frame cost - only updates when you call this method.
      *
+     * @param displayId - Display ID (0-255) this setting applies to
      * @param config - Post-processing configuration (or null to disable)
      *
      * @example
      * ```typescript
-     * // Enable scanlines effect
-     * user.setPostProcess({
+     * // Enable scanlines effect on display 0
+     * user.setPostProcess(0, {
      *   scanlines: {
      *     enabled: true,
      *     opacity: 0.15,
@@ -5225,105 +5340,112 @@ declare class User<TData = Record<string, any>> {
      *   }
      * });
      *
-     * // Disable all post-processing
-     * user.setPostProcess(null);
+     * // Disable all post-processing on display 0
+     * user.setPostProcess(0, null);
      * ```
      */
-    setPostProcess(config: PostProcessConfig | null): void;
+    setPostProcess(displayId: number, config: PostProcessConfig | null): void;
     /**
-     * Enable or disable scanlines effect with default/current settings
+     * Enable or disable scanlines effect with default/current settings for a specific display
      *
+     * @param displayId - Display ID (0-255)
      * @param enabled - Whether to enable scanlines
      *
      * @example
      * ```typescript
-     * user.setScanlinesEnabled(true);  // Enable with defaults
-     * user.setScanlinesEnabled(false); // Disable
+     * user.setScanlinesEnabled(0, true);  // Enable with defaults on display 0
+     * user.setScanlinesEnabled(0, false); // Disable on display 0
      * ```
      */
-    setScanlinesEnabled(enabled: boolean): void;
+    setScanlinesEnabled(displayId: number, enabled: boolean): void;
     /**
-     * Set scanlines opacity (0-1)
+     * Set scanlines opacity (0-1) for a specific display
      *
      * Also enables scanlines if not already enabled.
      *
+     * @param displayId - Display ID (0-255)
      * @param opacity - Opacity of dark lines (0 = invisible, 1 = fully opaque)
      *
      * @example
      * ```typescript
-     * user.setScanlinesOpacity(0.2); // Subtle effect
-     * user.setScanlinesOpacity(0.5); // Strong effect
+     * user.setScanlinesOpacity(0, 0.2); // Subtle effect on display 0
+     * user.setScanlinesOpacity(0, 0.5); // Strong effect on display 0
      * ```
      */
-    setScanlinesOpacity(opacity: number): void;
+    setScanlinesOpacity(displayId: number, opacity: number): void;
     /**
-     * Set scanlines pattern
+     * Set scanlines pattern for a specific display
      *
+     * @param displayId - Display ID (0-255)
      * @param pattern - Pattern type: 'horizontal', 'vertical', or 'grid'
      */
-    setScanlinesPattern(pattern: 'horizontal' | 'vertical' | 'grid'): void;
+    setScanlinesPattern(displayId: number, pattern: 'horizontal' | 'vertical' | 'grid'): void;
     /**
-     * Enable or configure ambient effect
+     * Enable or configure ambient effect for a specific display
      *
      * Ambient effect creates a blurred glow around the terminal canvas,
      * filling the unused space with colors from the terminal content.
      * This effect is GPU-accelerated (CSS blur) and has zero CPU cost.
      *
+     * @param displayId - Display ID (0-255)
      * @param config - true to enable with defaults, false to disable,
      *                 or object with blur and scale settings
      *
      * @example
      * ```typescript
-     * // Enable with defaults (blur: 30px, scale: 1.3)
-     * user.setAmbientEffect(true);
+     * // Enable with defaults (blur: 30px, scale: 1.3) on display 0
+     * user.setAmbientEffect(0, true);
      *
-     * // Disable
-     * user.setAmbientEffect(false);
+     * // Disable on display 0
+     * user.setAmbientEffect(0, false);
      *
-     * // Custom settings
-     * user.setAmbientEffect({ blur: 50, scale: 1.5 });
+     * // Custom settings on display 1
+     * user.setAmbientEffect(1, { blur: 50, scale: 1.5 });
      * ```
      */
-    setAmbientEffect(config: boolean | {
+    setAmbientEffect(displayId: number, config: boolean | {
         blur?: number;
         scale?: number;
     }): void;
     /**
-     * Enable or disable ambient effect
+     * Enable or disable ambient effect for a specific display
      *
+     * @param displayId - Display ID (0-255)
      * @param enabled - Whether to enable ambient effect
      *
      * @example
      * ```typescript
-     * user.setAmbientEffectEnabled(true);  // Enable with defaults
-     * user.setAmbientEffectEnabled(false); // Disable
+     * user.setAmbientEffectEnabled(0, true);  // Enable with defaults on display 0
+     * user.setAmbientEffectEnabled(0, false); // Disable on display 0
      * ```
      */
-    setAmbientEffectEnabled(enabled: boolean): void;
+    setAmbientEffectEnabled(displayId: number, enabled: boolean): void;
     /**
-     * Set ambient effect blur intensity
+     * Set ambient effect blur intensity for a specific display
      *
+     * @param displayId - Display ID (0-255)
      * @param blur - Blur intensity in pixels (default: 30)
      *
      * @example
      * ```typescript
-     * user.setAmbientEffectBlur(50); // More blur
-     * user.setAmbientEffectBlur(15); // Less blur
+     * user.setAmbientEffectBlur(0, 50); // More blur on display 0
+     * user.setAmbientEffectBlur(0, 15); // Less blur on display 0
      * ```
      */
-    setAmbientEffectBlur(blur: number): void;
+    setAmbientEffectBlur(displayId: number, blur: number): void;
     /**
-     * Set ambient effect scale factor
+     * Set ambient effect scale factor for a specific display
      *
+     * @param displayId - Display ID (0-255)
      * @param scale - Scale factor for the glow (default: 1.3)
      *
      * @example
      * ```typescript
-     * user.setAmbientEffectScale(1.5); // Larger glow area
-     * user.setAmbientEffectScale(1.1); // Smaller glow area
+     * user.setAmbientEffectScale(0, 1.5); // Larger glow area on display 0
+     * user.setAmbientEffectScale(0, 1.1); // Smaller glow area on display 0
      * ```
      */
-    setAmbientEffectScale(scale: number): void;
+    setAmbientEffectScale(displayId: number, scale: number): void;
     /**
      * Check if ambient effect is currently enabled
      */
@@ -5350,16 +5472,18 @@ declare class User<TData = Record<string, any>> {
      * @internal
      */
     flushPostProcessCommands(): PostProcessCommand[];
-    /** Current scaling mode */
-    private currentScalingMode;
+    /** Current scaling mode per display (Map<displayId, mode>) */
+    private currentScalingModes;
     /**
-     * Set the pixel-perfect scaling mode
+     * Set the pixel-perfect scaling mode for a specific display
      *
      * Controls how the terminal canvas is scaled to fit the available space.
      * Stricter modes produce crisper pixels but may leave empty space.
      *
+     * @param displayId - Display ID (0-255) this setting applies to
      * @param mode - Scaling mode:
      *   - `'none'`: Fill space, may have sub-pixel artifacts (default)
+     *   - `'responsive'`: Fixed cell size, cols/rows adapt to fill space
      *   - `'eighth'`: Snap to 0.125 increments (1.0, 1.125, 1.25...)
      *   - `'quarter'`: Snap to 0.25 increments (1.0, 1.25, 1.5...)
      *   - `'half'`: Snap to 0.5 increments (1.0, 1.5, 2.0...)
@@ -5367,74 +5491,120 @@ declare class User<TData = Record<string, any>> {
      *
      * @example
      * ```typescript
-     * // For crisp retro-style pixels
-     * user.setScalingMode('integer');
+     * // For crisp retro-style pixels on display 0
+     * user.setScalingMode(0, 'integer');
      *
-     * // For balanced quality
-     * user.setScalingMode('quarter');
+     * // For balanced quality on display 1
+     * user.setScalingMode(1, 'quarter');
      *
-     * // Fill all available space
-     * user.setScalingMode('none');
+     * // Fill all available space on display 0
+     * user.setScalingMode(0, 'none');
      * ```
      */
-    setScalingMode(mode: ScalingMode): void;
+    setScalingMode(displayId: number, mode: ScalingMode): void;
     /**
-     * Get current scaling mode
+     * Get current scaling mode for a display
      *
+     * @param displayId - Display ID (0-255)
+     * @param displayId - Display ID (0-255)
      * @returns Current scaling mode or null if not set
      */
-    getScalingMode(): ScalingMode | null;
-    /** Current grid configuration */
-    private currentGridConfig;
+    getScalingMode(displayId: number): ScalingMode | null;
+    /** Current cell size configuration per display (Map<displayId, {width, height}>) */
+    private currentCellSizes;
     /**
-     * Enable or configure the debug grid overlay
+     * Set the cell dimensions in pixels for a specific display (for Responsive mode)
+     *
+     * This is only relevant when using `setScalingMode(displayId, 'responsive')`.
+     * In responsive mode, the cell size is fixed and the number of cols/rows
+     * adapts to fill the available space.
+     *
+     * In other scaling modes (integer, quarter, half, none), the cell size
+     * comes from the font/atlas and CSS scaling is applied to fill space.
+     *
+     * @param displayId - Display ID (0-255) this setting applies to
+     * @param width - Cell width in pixels (1-255, default: 8)
+     * @param height - Cell height in pixels (1-255, default: 8)
+     *
+     * @example
+     * ```typescript
+     * // Responsive mode with 8x8 cells on display 0
+     * user.setScalingMode(0, 'responsive');
+     * user.setCellSize(0, 8, 8);
+     *
+     * // Responsive mode with larger 16x16 tiles on display 1
+     * user.setScalingMode(1, 'responsive');
+     * user.setCellSize(1, 16, 16);
+     * ```
+     */
+    setCellSize(displayId: number, width: number, height: number): void;
+    /**
+     * Get current cell size for a display
+     *
+     * @param displayId - Display ID (0-255)
+     * @returns Object with cellWidth and cellHeight in pixels, or default 8x8 if not set
+     */
+    getCellSize(displayId: number): {
+        cellWidth: number;
+        cellHeight: number;
+    };
+    /** Current grid configuration per display (Map<displayId, GridConfig>) */
+    private currentGridConfigs;
+    /**
+     * Enable or configure the debug grid overlay for a specific display
      *
      * The grid shows cell boundaries aligned with the terminal grid.
      * Useful for debugging layout and alignment issues.
      *
+     * @param displayId - Display ID (0-255) this setting applies to
      * @param config - true to enable with defaults, false to disable,
      *                 or object with color and lineWidth settings
      *
      * @example
      * ```typescript
-     * // Enable with default red grid
-     * user.setGrid(true);
+     * // Enable with default red grid on display 0
+     * user.setGrid(0, true);
      *
-     * // Disable
-     * user.setGrid(false);
+     * // Disable on display 0
+     * user.setGrid(0, false);
      *
-     * // Custom green grid
-     * user.setGrid({ enabled: true, color: 'rgba(0, 255, 0, 0.5)' });
+     * // Custom green grid on display 1
+     * user.setGrid(1, { enabled: true, color: 'rgba(0, 255, 0, 0.5)' });
      *
-     * // Custom with thicker lines
-     * user.setGrid({ enabled: true, color: '#ff0000', lineWidth: 2 });
+     * // Custom with thicker lines on display 0
+     * user.setGrid(0, { enabled: true, color: '#ff0000', lineWidth: 2 });
      * ```
      */
-    setGrid(config: boolean | GridConfig): void;
+    setGrid(displayId: number, config: boolean | GridConfig): void;
     /**
-     * Enable or disable the grid
+     * Enable or disable the grid for a specific display
      *
+     * @param displayId - Display ID (0-255)
      * @param enabled - Whether to show the grid
      *
      * @example
      * ```typescript
-     * user.setGridEnabled(true);  // Show grid
-     * user.setGridEnabled(false); // Hide grid
+     * user.setGridEnabled(0, true);  // Show grid on display 0
+     * user.setGridEnabled(0, false); // Hide grid on display 0
      * ```
      */
-    setGridEnabled(enabled: boolean): void;
+    setGridEnabled(displayId: number, enabled: boolean): void;
     /**
-     * Check if grid is currently enabled
+     * Check if grid is currently enabled for a display
+     *
+     * @param displayId - Display ID (0-255)
      */
-    isGridEnabled(): boolean;
+    isGridEnabled(displayId: number): boolean;
     /**
-     * Get current grid configuration
+     * Get current grid configuration for a display
+     *
+     * @param displayId - Display ID (0-255)
      */
-    getGridConfig(): GridConfig | null;
-    /** Currently active palette slot ID */
-    private currentPaletteSlotId;
+    getGridConfig(displayId: number): GridConfig | null;
+    /** Currently active palette slot ID per display (Map<displayId, slotId>) */
+    private currentPaletteSlotIds;
     /**
-     * Switch to a pre-loaded palette slot
+     * Switch to a pre-loaded palette slot for a specific display
      *
      * The palette must have been loaded to the Core via `core.loadPaletteToSlot()` first.
      * This allows instant palette switching without re-sending palette data over the network.
@@ -5445,6 +5615,7 @@ declare class User<TData = Record<string, any>> {
      * - Accessibility options (high contrast)
      * - Visual effects (damage flash, power-up)
      *
+     * @param displayId - Display ID (0-255) this setting applies to
      * @param slotId - Palette slot ID (0-255)
      *
      * @example
@@ -5456,24 +5627,24 @@ declare class User<TData = Record<string, any>> {
      *
      * // In IApplication.updateUser() - switch based on game state
      * if (gameState.isNight) {
-     *   user.switchPalette(1);
+     *   user.switchPalette(0, 1); // display 0, night palette
      * } else {
-     *   user.switchPalette(0);
+     *   user.switchPalette(0, 0); // display 0, day palette
      * }
      *
-     * // Zone-based switching
-     * if (player.enteredDungeon) {
-     *   user.switchPalette(2);
-     * }
+     * // Different palettes for different displays (split-screen)
+     * user.switchPalette(0, dayPalette);    // Player 1 display
+     * user.switchPalette(1, nightPalette);  // Player 2 display
      * ```
      */
-    switchPalette(slotId: number): void;
+    switchPalette(displayId: number, slotId: number): void;
     /**
-     * Get the currently active palette slot ID
+     * Get the currently active palette slot ID for a display
      *
+     * @param displayId - Display ID (0-255)
      * @returns The active slot ID, or null if no palette has been switched yet
      */
-    getCurrentPaletteSlotId(): number | null;
+    getCurrentPaletteSlotId(displayId: number): number | null;
     /**
      * Send data through the bridge channel to the client application
      *
@@ -7880,29 +8051,43 @@ declare function getASCII8x8FontConfig(): {
 };
 
 /**
- * CompressedInputPacket - Ultra-compact binary format for inputs (V3)
+ * CompressedInputPacket - Ultra-compact binary format for inputs (V4)
  *
  * Architecture:
  * - CLIENT: Evaluates sources → Compresses → Sends
  * - SERVER: Receives → Decompresses → Stores in axes/buttons Maps
  *
- * MINIMALIST Format (V3):
- * ┌────────┬───────────┬─────────────┬────────┬──────────┬─────────────┐
- * │ Tick   │ Axes      │ Buttons     │ Mouse  │ Flags    │ MacroEvents │
- * │ 8 bytes│ N bytes   │ M bytes     │ 3 bytes│ 1 byte   │ variable    │
- * └────────┴───────────┴─────────────┴────────┴──────────┴─────────────┘
+ * MINIMALIST Format (V4):
+ * ┌────────┬───────────┬─────────────┬────────┬──────────┬─────────────┬─────────────┬──────────────────┐
+ * │ Tick   │ Axes      │ Buttons     │ Mouse  │ Flags    │ TextInputs  │ MacroEvents │ DisplayViewports │
+ * │ 8 bytes│ N bytes   │ M bytes     │ 3 bytes│ 1 byte   │ variable    │ variable    │ 1 + 5×count bytes│
+ * └────────┴───────────┴─────────────┴────────┴──────────┴─────────────┴─────────────┴──────────────────┘
  *
  * Tick (8 bytes)       : Frame number (uint64, little-endian)
  * Axes (N bytes)       : 1 byte per axis (int8, -127 to +127)
  * Buttons (M bytes)    : Bitpacking (8 buttons per byte, ⌈ButtonCount/8⌉)
  * Mouse (3 bytes)      : displayId (1) + mouseX (1) + mouseY (1)
  * Flags (1 byte)       : Bit 0 = mouseOverDisplay
+ * TextInputs (var)     : 1 byte count + length-prefixed UTF-8 strings
  * MacroEvents (var)    : 1 byte count + encoded events (see MacroEventEncoder)
+ * DisplayViewports (var): 1 byte count + per display: id(1) + pixelWidth(2) + pixelHeight(2)
  *
  * Note: axisCount and buttonCount are known in advance via InputBindingRegistry
- * Example: 5 axes + 12 buttons = 8 + 5 + 2 + 3 + 1 = 19 bytes (+ macro events)
+ * Example: 5 axes + 12 buttons = 8 + 5 + 2 + 3 + 1 = 19 bytes (+ text + macro + viewports)
  */
 
+/**
+ * Represents a display viewport available on the client side (in pixels)
+ * Used for responsive display sizing
+ */
+interface DisplayViewport {
+    /** Display ID (0-255) */
+    displayId: number;
+    /** Available width in pixels (0-65535) */
+    pixelWidth: number;
+    /** Available height in pixels (0-65535) */
+    pixelHeight: number;
+}
 /**
  * Represents a compressed input on the server side (after decoding)
  *
@@ -7912,6 +8097,7 @@ declare function getASCII8x8FontConfig(): {
  * - Mouse: position + display + flags
  * - TextInputs: array of key strings for text input (e.g., ['a', 'Backspace', 'Enter'])
  * - MacroEvents: array of macro events (clicks, changes, submits, selects)
+ * - DisplayViewports: array of available viewport sizes in pixels per display
  */
 interface CompressedInputPacket {
     /** Frame number (tick) - uint64 */
@@ -7932,6 +8118,8 @@ interface CompressedInputPacket {
     textInputs: string[];
     /** Macro events (clicks, changes, submits, selects) from client-side macros */
     macroEvents: AnyMacroEvent[];
+    /** Display viewports available on client side (in pixels) - for responsive display sizing */
+    displayViewports: DisplayViewport[];
 }
 /**
  * Creates an empty CompressedInputPacket
@@ -8013,7 +8201,7 @@ declare function getCompressedPacketSize(axisCount: number, buttonCount: number)
  * 2. Client encodes final values in compact binary
  * 3. Client sends buffer to server via WebSocket
  *
- * MINIMALIST V3 Format (without counts):
+ * MINIMALIST V4 Format (without counts):
  * - Tick: uint64 (8 bytes)
  * - Axes: float (-1.0 to +1.0) → int8 (-127 to +127) = 1 byte per axis
  * - Buttons: boolean → bitpacking = 8 buttons per byte
@@ -8021,14 +8209,15 @@ declare function getCompressedPacketSize(axisCount: number, buttonCount: number)
  * - Mouse: mouseX/Y (uint8) + flags = 3 bytes
  * - TextInputs: 1 byte count + length-prefixed strings
  * - MacroEvents: 1 byte count + encoded events
+ * - DisplayViewports: 1 byte count + per display: id(1) + pixelWidth(2) + pixelHeight(2)
  *
  * PREREQUISITE: Client and server must have the SAME bindings defined!
  *
- * Example: 5 axes + 12 buttons + mouse = 19 bytes total (+ text inputs + macro events)
+ * Example: 5 axes + 12 buttons + mouse = 19 bytes total (+ text inputs + macro events + viewports)
  */
 
 /**
- * Encodes inputs in compact binary format v3 (CLIENT-SIDE)
+ * Encodes inputs in compact binary format v4 (CLIENT-SIDE)
  *
  * @param tick - Frame number (bigint for uint64)
  * @param axes - Map of axis values (bindingId → float between -1.0 and +1.0)
@@ -8039,17 +8228,18 @@ declare function getCompressedPacketSize(axisCount: number, buttonCount: number)
  * @param mouseOverDisplay - Is the mouse over a display?
  * @param textInputs - Array of text input strings
  * @param macroEvents - Array of macro events (clicks, changes, submits, selects)
+ * @param displayViewports - Array of display viewports (pixels) that have changed
  * @returns Encoded buffer (without counts, minimalist format)
  *
  * @example
  * ```typescript
  * const axes = new Map([[0, -0.7], [1, 0.5]]);
  * const buttons = new Map([[0, true], [1, false], [2, true]]);
- * const buffer = encodeCompressedInput(42n, axes, buttons, 0, 128, 64, true);
- * // buffer.length = 8 + 2 + 1 + 4 = 15 bytes (+ text inputs + macro events)
+ * const viewports = [{ displayId: 0, pixelWidth: 800, pixelHeight: 600 }];
+ * const buffer = encodeCompressedInput(42n, axes, buttons, 0, 128, 64, true, [], [], viewports);
  * ```
  */
-declare function encodeCompressedInput(tick: bigint, axes: Map<number, number>, buttons: Map<number, boolean>, displayId: number, mouseX: number, mouseY: number, mouseOverDisplay: boolean, textInputs?: string[], macroEvents?: AnyMacroEvent[]): Uint8Array;
+declare function encodeCompressedInput(tick: bigint, axes: Map<number, number>, buttons: Map<number, boolean>, displayId: number, mouseX: number, mouseY: number, mouseOverDisplay: boolean, textInputs?: string[], macroEvents?: AnyMacroEvent[], displayViewports?: DisplayViewport[]): Uint8Array;
 
 /**
  * CompressedInputDecoder - Decodes inputs from compact binary format
@@ -8058,10 +8248,10 @@ declare function encodeCompressedInput(tick: bigint, axes: Map<number, number>,
  *
  * Workflow:
  * 1. Server receives binary buffer from client via WebSocket
- * 2. Server decodes values (MINIMALIST V3 format - without counts)
+ * 2. Server decodes values (MINIMALIST V4 format - without counts)
  * 3. Server stores in user.axes and user.buttons Maps
  *
- * MINIMALIST V3 Format (without counts):
+ * MINIMALIST V4 Format (without counts):
  * - PREREQUISITE: Client and server must have the SAME bindings defined!
  * - Buffer does NOT contain AxisCount nor ButtonCount
  * - Server must pass its registry to know expected structure
@@ -8072,15 +8262,16 @@ declare function encodeCompressedInput(tick: bigint, axes: Map<number, number>,
  * - Mouse: uint8 → mouseX/Y + flags (mouseOverDisplay)
  * - TextInputs: 1 byte count + length-prefixed strings
  * - MacroEvents: 1 byte count + encoded events
+ * - DisplayViewports: 1 byte count + per display: id(1) + pixelWidth(2) + pixelHeight(2)
  *
  * Example (2 axes, 3 buttons):
- * - Tick (8) + Axes (2) + Buttons (1) + DisplayId (1) + Mouse (3) = 15 bytes (+ text inputs + macro events)
+ * - Tick (8) + Axes (2) + Buttons (1) + DisplayId (1) + Mouse (3) = 15 bytes (+ text + macro + viewports)
  */
 
 /**
- * Decodes a binary buffer to CompressedInputPacket v3 (SERVER-SIDE)
+ * Decodes a binary buffer to CompressedInputPacket v4 (SERVER-SIDE)
  *
- * MINIMALIST v3 format: buffer does NOT contain counters!
+ * MINIMALIST v4 format: buffer does NOT contain counters!
  * Server MUST pass its registry to know axisCount and buttonCount.
  *
  * IMPORTANT: Client and server must have the SAME bindings defined
@@ -8088,7 +8279,7 @@ declare function encodeCompressedInput(tick: bigint, axes: Map<number, number>,
  *
  * @param buffer - Encoded buffer received from client
  * @param registry - Server registry to know expected structure
- * @returns Decoded packet with tick (bigint), axes, buttons, displayId, mouse
+ * @returns Decoded packet with tick (bigint), axes, buttons, displayId, mouse, viewports
  *
  * @throws Error if buffer is too small or invalid
  *
@@ -8100,6 +8291,7 @@ declare function encodeCompressedInput(tick: bigint, axes: Map<number, number>,
  * // packet.buttons.get(0) → true
  * // packet.displayId → 0
  * // packet.mouseOverDisplay → true
+ * // packet.displayViewports → [{ displayId: 0, pixelWidth: 800, pixelHeight: 600 }]
  * ```
  */
 declare function decodeCompressedInput(buffer: Uint8Array, registry: InputBindingRegistry): CompressedInputPacket;
@@ -8577,12 +8769,13 @@ declare const AUDIO_RESUME_SOUND_MIN_SIZE = 2;
 declare const AUDIO_SET_LISTENER_POSITION_SIZE = 5;
 declare const AUDIO_CONFIGURE_SPATIAL_SIZE = 5;
 declare const AUDIO_SET_SOUND_EFFECTS_MIN_SIZE = 4;
-declare const POSTPROCESS_SET_CONFIG_MIN_SIZE = 2;
-declare const POSTPROCESS_SET_SCANLINES_SIZE = 7;
-declare const POSTPROCESS_SET_AMBIENT_EFFECT_SIZE = 5;
-declare const POSTPROCESS_SET_SCALING_MODE_SIZE = 2;
-declare const POSTPROCESS_SET_GRID_SIZE = 7;
-declare const POSTPROCESS_SWITCH_PALETTE_SIZE = 2;
+declare const POSTPROCESS_SET_CONFIG_MIN_SIZE = 3;
+declare const POSTPROCESS_SET_SCANLINES_SIZE = 8;
+declare const POSTPROCESS_SET_AMBIENT_EFFECT_SIZE = 6;
+declare const POSTPROCESS_SET_SCALING_MODE_SIZE = 3;
+declare const POSTPROCESS_SET_GRID_SIZE = 8;
+declare const POSTPROCESS_SWITCH_PALETTE_SIZE = 3;
+declare const POSTPROCESS_SET_CELL_SIZE_SIZE = 4;
 
 /**
  * UTSP Order Types Enumeration
@@ -9315,6 +9508,7 @@ declare class PostProcessOrderDecoder {
     private decodeSetScalingModeOrder;
     private decodeSetGridOrder;
     private decodeSwitchPaletteOrder;
+    private decodeSetCellSizeOrder;
 }
 
 /**
@@ -9393,11 +9587,15 @@ declare class PostProcessOrderCollector {
      * Create a SwitchPaletteOrder with given slot ID
      */
     private createSwitchPaletteOrder;
+    /**
+     * Create a SetCellSizeOrder with given dimensions
+     */
+    private createSetCellSizeOrder;
     /**
      * Parse CSS color string to RGBA components
      */
     private parseColor;
 }
 
-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, MacroEngine, MacroEventType, MacroOrderType, MacroRegistry, MobileVibrateFlags, OrderBuilder, OrderType, POLYLINE_ORDER_MIN_SIZE, POSTPROCESS_SET_AMBIENT_EFFECT_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, 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, TriangleShape, UIMacroTemplate, UIState, UISubtype, UnicolorSprite, UpdateInstanceOrder, UpdatePacket, UserTickStats, VibrationOrder, WebFontConfig, WebFontLoad };
+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, 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, TriangleShape, UIMacroTemplate, UIState, UISubtype, UnicolorSprite, UpdateInstanceOrder, UpdatePacket, UserTickStats, VibrationOrder, WebFontConfig, WebFontLoad };