@utsp/core 0.7.0-nightly.20251207021518.b0c5521 → 0.7.0-nightly.20251208141647.137af20

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as _utsp_types from '@utsp/types';
-import { Vector2, AxisSource, ButtonSource, InputBindingLoadPacket, AxisBinding, ButtonBinding, SoundInstanceId, AudioConfigCommand, PlaySoundCommand, StopSoundCommand, FadeOutSoundCommand, PauseSoundCommand, ResumeSoundCommand, SetSoundEffectsCommand, IAudioProcessor, AudioAck, SoundFormat, SoundLoadType, SoundLoadPacket, SoundExternalLoadPacket, UserRenderState } from '@utsp/types';
-export { AxisBinding, AxisSource, ButtonBinding, ButtonSource, InputBindingLoadPacket, RenderState, RenderedCell, UserRenderState, Vector2 } from '@utsp/types';
+import { ScalingModeValue, Vector2, AxisSource, ButtonSource, InputBindingLoadPacket, AxisBinding, ButtonBinding, SoundInstanceId, AudioConfigCommand, PlaySoundCommand, StopSoundCommand, FadeOutSoundCommand, PauseSoundCommand, ResumeSoundCommand, SetSoundEffectsCommand, IAudioProcessor, 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';
 
 /**
  * Font system for UTSP Core
@@ -2051,6 +2051,196 @@ interface NetworkLayer {
     orders: AnyNetworkOrder[];
 }
 
+/**
+ * UTSP Post-Process Order Types Enumeration
+ *
+ * Post-process orders control visual effects like scanlines and ambient effect.
+ * They are included in the UpdatePacket and processed by the renderer.
+ *
+ * This separation ensures:
+ * - Clear distinction between render, audio, and post-process orders
+ * - Independent type numbering
+ * - Perfect frame-level synchronization
+ */
+declare enum PostProcessOrderType {
+    /**
+     * 0x01 - SetConfig: Set full post-process configuration
+     *
+     * Parameters: flags, scanlines config?, ambient effect config?
+     */
+    SetConfig = 1,
+    /**
+     * 0x02 - SetScanlines: Set scanlines configuration only
+     *
+     * Parameters: enabled, opacity?, pattern?, colorR?, colorG?, colorB?
+     */
+    SetScanlines = 2,
+    /**
+     * 0x03 - SetAmbientEffect: Set ambient effect configuration only
+     *
+     * Parameters: enabled, blur?, scale?, opacity?
+     */
+    SetAmbientEffect = 3,
+    /**
+     * 0x04 - SetScalingMode: Set pixel-perfect scaling mode
+     *
+     * Parameters: mode (ScalingMode enum value)
+     */
+    SetScalingMode = 4,
+    /**
+     * 0x05 - SetGrid: Set debug grid overlay configuration
+     *
+     * Parameters: enabled, colorR?, colorG?, colorB?, colorA?, lineWidth?
+     */
+    SetGrid = 5
+}
+
+/**
+ * UTSP Post-Process Order Interfaces
+ *
+ * Defines the data structures for post-process orders sent over the network.
+ * These orders control visual effects like scanlines and ambient effect.
+ */
+
+/**
+ * Scanlines pattern type (2 bits)
+ */
+declare enum ScanlinesPatternType {
+    Horizontal = 0,
+    Vertical = 1,
+    Grid = 2
+}
+/**
+ * Base interface for all post-process orders
+ */
+interface PostProcessOrderBase {
+    type: PostProcessOrderType;
+}
+/**
+ * SetConfig Order (0x01)
+ *
+ * Sets the full post-process configuration.
+ * Flags indicate which optional sections are present.
+ *
+ * Binary format:
+ * - type: 1 byte (0x01)
+ * - flags: 1 byte (PostProcessConfigFlags)
+ * - [if HasScanlines]:
+ *   - enabled: 1 byte (0 or 1)
+ *   - opacity: 1 byte (0-255, scaled from 0.0-1.0)
+ *   - pattern: 1 byte (ScanlinesPatternType)
+ *   - colorR: 1 byte (0-255)
+ *   - colorG: 1 byte (0-255)
+ *   - colorB: 1 byte (0-255)
+ * - [if HasAmbientEffect]:
+ *   - enabled: 1 byte (0 or 1)
+ *   - blur: 1 byte (0-255 pixels)
+ *   - scale: 1 byte (100-255, scaled from 1.0-2.55)
+ *   - opacity: 1 byte (0-255, scaled from 0.0-1.0)
+ */
+interface SetConfigOrder extends PostProcessOrderBase {
+    type: PostProcessOrderType.SetConfig;
+    flags: number;
+    /** Scanlines config (if HasScanlines flag set) */
+    scanlines?: {
+        enabled: boolean;
+        opacity: number;
+        pattern: ScanlinesPatternType;
+        colorR: number;
+        colorG: number;
+        colorB: number;
+    };
+    /** Ambient effect config (if HasAmbientEffect flag set) */
+    ambientEffect?: {
+        enabled: boolean;
+        blur: number;
+        scale: number;
+        opacity: number;
+    };
+}
+/**
+ * SetScanlines Order (0x02)
+ *
+ * Sets only the scanlines configuration.
+ *
+ * Binary format:
+ * - type: 1 byte (0x02)
+ * - enabled: 1 byte (0 or 1)
+ * - opacity: 1 byte (0-255, scaled from 0.0-1.0)
+ * - pattern: 1 byte (ScanlinesPatternType)
+ * - colorR: 1 byte (0-255)
+ * - colorG: 1 byte (0-255)
+ * - colorB: 1 byte (0-255)
+ */
+interface SetScanlinesOrder extends PostProcessOrderBase {
+    type: PostProcessOrderType.SetScanlines;
+    enabled: boolean;
+    opacity: number;
+    pattern: ScanlinesPatternType;
+    colorR: number;
+    colorG: number;
+    colorB: number;
+}
+/**
+ * SetAmbientEffect Order (0x03)
+ *
+ * Sets only the ambient effect configuration.
+ *
+ * Binary format:
+ * - type: 1 byte (0x03)
+ * - enabled: 1 byte (0 or 1)
+ * - blur: 1 byte (0-255 pixels)
+ * - scale: 1 byte (100-255, scaled from 1.0-2.55)
+ * - opacity: 1 byte (0-255, scaled from 0.0-1.0)
+ */
+interface SetAmbientEffectOrder extends PostProcessOrderBase {
+    type: PostProcessOrderType.SetAmbientEffect;
+    enabled: boolean;
+    blur: number;
+    scale: number;
+    opacity: number;
+}
+/**
+ * SetScalingMode Order (0x04)
+ *
+ * Sets the pixel-perfect scaling mode.
+ *
+ * Binary format:
+ * - type: 1 byte (0x04)
+ * - mode: 1 byte (ScalingModeValue)
+ */
+interface SetScalingModeOrder extends PostProcessOrderBase {
+    type: PostProcessOrderType.SetScalingMode;
+    mode: ScalingModeValue;
+}
+/**
+ * SetGrid Order (0x05)
+ *
+ * Sets the debug grid overlay configuration.
+ *
+ * Binary format:
+ * - type: 1 byte (0x05)
+ * - enabled: 1 byte (0 or 1)
+ * - colorR: 1 byte (0-255)
+ * - colorG: 1 byte (0-255)
+ * - colorB: 1 byte (0-255)
+ * - colorA: 1 byte (0-255, alpha as 0-255)
+ * - lineWidth: 1 byte (1-10 pixels)
+ */
+interface SetGridOrder extends PostProcessOrderBase {
+    type: PostProcessOrderType.SetGrid;
+    enabled: boolean;
+    colorR: number;
+    colorG: number;
+    colorB: number;
+    colorA: number;
+    lineWidth: number;
+}
+/**
+ * Union type for all post-process orders
+ */
+type AnyPostProcessOrder = SetConfigOrder | SetScanlinesOrder | SetAmbientEffectOrder | SetScalingModeOrder | SetGridOrder;
+
 /**
  * Update packet according to the new UTSP protocol
  *
@@ -2060,9 +2250,10 @@ interface NetworkLayer {
  * - Layers: Render orders for visual output
  * - Audio Orders: Audio commands synchronized with the frame
  * - Macro Orders: Macro instance commands (create, update, remove)
+ * - PostProcess Orders: Visual effects commands (scanlines, ambient effect)
  *
- * Audio orders are in the same packet as render orders to ensure
- * perfect frame-level synchronization between visuals and sound.
+ * Audio and PostProcess orders are in the same packet as render orders to ensure
+ * perfect frame-level synchronization between visuals, sound, and effects.
  */
 interface UpdatePacket {
     /** Tick counter (8 bytes) */
@@ -2083,6 +2274,10 @@ interface UpdatePacket {
     macroOrderCount: number;
     /** List of macro orders (create, update, remove instances) */
     macroOrders: AnyMacroOrder[];
+    /** Number of post-process orders (1 byte) */
+    postProcessOrderCount: number;
+    /** List of post-process orders (scanlines, ambient effect) */
+    postProcessOrders: AnyPostProcessOrder[];
 }
 
 /**
@@ -2914,6 +3109,8 @@ declare class User<TData = Record<string, any>> {
     private macroRegistry;
     private macroEngine;
     private macroEventHandlers;
+    private postProcessCommands;
+    private currentPostProcessConfig;
     /**
      * Application-specific data storage
      * Use this to store game state, player data, or any custom information
@@ -4140,6 +4337,13 @@ declare class User<TData = Record<string, any>> {
      * @returns Update result with events and sounds to play
      */
     updateMacros(): MacroUpdateResult;
+    /**
+     * Process macro events from MacroUpdateResult
+     * Dispatches events to registered handlers (used in standalone mode)
+     *
+     * @param result - The result from updateMacros()
+     */
+    processMacroEvents(result: MacroUpdateResult): void;
     /**
      * Update mouse state for the macro engine
      * Converts display-local coordinates to world coordinates using the display's origin
@@ -4183,6 +4387,231 @@ declare class User<TData = Record<string, any>> {
      * Activate the currently focused macro element
      */
     macroActivateFocused(): void;
+    /**
+     * Set post-processing configuration
+     *
+     * The post-process overlay is rendered ONCE when this is called.
+     * No per-frame cost - only updates when you call this method.
+     *
+     * @param config - Post-processing configuration (or null to disable)
+     *
+     * @example
+     * ```typescript
+     * // Enable scanlines effect
+     * user.setPostProcess({
+     *   scanlines: {
+     *     enabled: true,
+     *     opacity: 0.15,
+     *     pattern: 'horizontal'
+     *   }
+     * });
+     *
+     * // Disable all post-processing
+     * user.setPostProcess(null);
+     * ```
+     */
+    setPostProcess(config: PostProcessConfig | null): void;
+    /**
+     * Enable or disable scanlines effect with default/current settings
+     *
+     * @param enabled - Whether to enable scanlines
+     *
+     * @example
+     * ```typescript
+     * user.setScanlinesEnabled(true);  // Enable with defaults
+     * user.setScanlinesEnabled(false); // Disable
+     * ```
+     */
+    setScanlinesEnabled(enabled: boolean): void;
+    /**
+     * Set scanlines opacity (0-1)
+     *
+     * Also enables scanlines if not already enabled.
+     *
+     * @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
+     * ```
+     */
+    setScanlinesOpacity(opacity: number): void;
+    /**
+     * Set scanlines pattern
+     *
+     * @param pattern - Pattern type: 'horizontal', 'vertical', or 'grid'
+     */
+    setScanlinesPattern(pattern: 'horizontal' | 'vertical' | 'grid'): void;
+    /**
+     * Enable or configure ambient effect
+     *
+     * 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 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);
+     *
+     * // Disable
+     * user.setAmbientEffect(false);
+     *
+     * // Custom settings
+     * user.setAmbientEffect({ blur: 50, scale: 1.5 });
+     * ```
+     */
+    setAmbientEffect(config: boolean | {
+        blur?: number;
+        scale?: number;
+    }): void;
+    /**
+     * Enable or disable ambient effect
+     *
+     * @param enabled - Whether to enable ambient effect
+     *
+     * @example
+     * ```typescript
+     * user.setAmbientEffectEnabled(true);  // Enable with defaults
+     * user.setAmbientEffectEnabled(false); // Disable
+     * ```
+     */
+    setAmbientEffectEnabled(enabled: boolean): void;
+    /**
+     * Set ambient effect blur intensity
+     *
+     * @param blur - Blur intensity in pixels (default: 30)
+     *
+     * @example
+     * ```typescript
+     * user.setAmbientEffectBlur(50); // More blur
+     * user.setAmbientEffectBlur(15); // Less blur
+     * ```
+     */
+    setAmbientEffectBlur(blur: number): void;
+    /**
+     * Set ambient effect scale factor
+     *
+     * @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
+     * ```
+     */
+    setAmbientEffectScale(scale: number): void;
+    /**
+     * Check if ambient effect is currently enabled
+     */
+    isAmbientEffectEnabled(): boolean;
+    /**
+     * Get current ambient effect configuration
+     */
+    getAmbientEffectConfig(): {
+        enabled: boolean;
+        blur: number;
+        scale: number;
+    } | null;
+    /**
+     * Get current post-process configuration
+     */
+    getPostProcessConfig(): PostProcessConfig | null;
+    /**
+     * Check if there are pending post-process commands
+     * @internal
+     */
+    hasPostProcessCommands(): boolean;
+    /**
+     * Flush post-process commands (returns and clears the queue)
+     * @internal
+     */
+    flushPostProcessCommands(): PostProcessCommand[];
+    /** Current scaling mode */
+    private currentScalingMode;
+    /**
+     * Set the pixel-perfect scaling mode
+     *
+     * Controls how the terminal canvas is scaled to fit the available space.
+     * Stricter modes produce crisper pixels but may leave empty space.
+     *
+     * @param mode - Scaling mode:
+     *   - `'none'`: Fill space, may have sub-pixel artifacts (default)
+     *   - `'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...)
+     *   - `'integer'`: Crisp pixels, integer scaling only (1x, 2x, 3x...)
+     *
+     * @example
+     * ```typescript
+     * // For crisp retro-style pixels
+     * user.setScalingMode('integer');
+     *
+     * // For balanced quality
+     * user.setScalingMode('quarter');
+     *
+     * // Fill all available space
+     * user.setScalingMode('none');
+     * ```
+     */
+    setScalingMode(mode: ScalingMode): void;
+    /**
+     * Get current scaling mode
+     *
+     * @returns Current scaling mode or null if not set
+     */
+    getScalingMode(): ScalingMode | null;
+    /** Current grid configuration */
+    private currentGridConfig;
+    /**
+     * Enable or configure the debug grid overlay
+     *
+     * The grid shows cell boundaries aligned with the terminal grid.
+     * Useful for debugging layout and alignment issues.
+     *
+     * @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);
+     *
+     * // Disable
+     * user.setGrid(false);
+     *
+     * // Custom green grid
+     * user.setGrid({ enabled: true, color: 'rgba(0, 255, 0, 0.5)' });
+     *
+     * // Custom with thicker lines
+     * user.setGrid({ enabled: true, color: '#ff0000', lineWidth: 2 });
+     * ```
+     */
+    setGrid(config: boolean | GridConfig): void;
+    /**
+     * Enable or disable the grid
+     *
+     * @param enabled - Whether to show the grid
+     *
+     * @example
+     * ```typescript
+     * user.setGridEnabled(true);  // Show grid
+     * user.setGridEnabled(false); // Hide grid
+     * ```
+     */
+    setGridEnabled(enabled: boolean): void;
+    /**
+     * Check if grid is currently enabled
+     */
+    isGridEnabled(): boolean;
+    /**
+     * Get current grid configuration
+     */
+    getGridConfig(): GridConfig | null;
 }
 
 /**
@@ -4659,6 +5088,7 @@ declare class Core {
     private bitmapFontRegistry;
     private soundRegistry;
     private audioOrderCollector;
+    private postProcessOrderCollector;
     private activeWebFontId;
     private _renderCallCount;
     private onPaletteChangedCallback?;
@@ -5233,11 +5663,14 @@ declare class Core {
      * ```typescript
      * // Simplified version for runtime
      * websocket.on('update', (buffer: Uint8Array) => {
-     *   core.applyUpdatePacketBuffer('user1', buffer);
+     *   const packet = core.applyUpdatePacketBuffer('user1', buffer);
+     *   if (packet) {
+     *     // Handle post-process orders, etc.
+     *   }
      * });
      * ```
      */
-    applyUpdatePacketBuffer(userId: string, buffer: Uint8Array): boolean;
+    applyUpdatePacketBuffer(userId: string, buffer: Uint8Array): UpdatePacket | null;
     /**
      * Applies a LoadPacket received from the server (CLIENT-SIDE)
      *
@@ -6853,6 +7286,11 @@ 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;
 
 /**
  * UTSP Order Types Enumeration
@@ -7164,6 +7602,7 @@ declare class UpdatePacketDecoder {
     private layerDecoder;
     private audioOrderDecoder;
     private macroOrderDecoder;
+    private postProcessOrderDecoder;
     constructor();
     /**
      * Decodes an UpdatePacket from binary buffer
@@ -7178,8 +7617,10 @@ declare class UpdatePacketDecoder {
      * - AudioOrders: variable (encoded audio orders)
      * - MacroOrderCount: 1 byte (max 255 macro orders)
      * - MacroOrders: variable (encoded macro orders)
+     * - PostProcessOrderCount: 1 byte (max 255 post-process orders)
+     * - PostProcessOrders: variable (encoded post-process orders)
      *
-     * Minimum packet size: 13 bytes (Tick + DisplayCount + LayerCount + AudioOrderCount + MacroOrderCount)
+     * Minimum packet size: 14 bytes (Tick + DisplayCount + LayerCount + AudioOrderCount + MacroOrderCount + PostProcessOrderCount)
      */
     decode(data: Uint8Array, offset?: number): UpdatePacket;
     /**
@@ -7442,5 +7883,110 @@ declare class AudioOrderCollector {
     private encodeReverb;
 }
 
-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, InputBindingRegistry, LAYER_CELL_COUNT, LAYER_HEADER_SIZE, LAYER_SIZE, LINE_SHAPE_SIZE, Layer, LoadType, MacroEngine, MacroEventType, MacroOrderType, MacroRegistry, OrderBuilder, OrderType, POLYLINE_ORDER_MIN_SIZE, PlaySoundFlags, 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, TRIGGERGLOBALSOUND_ORDER_SIZE, TRIGGERSOUND_ORDER_SIZE, UPDATE_PACKET_HEADER_SIZE, UpdateFlags, UpdateFlagsHelper, UpdatePacketDecoder, User, UserStats, WebFont, WebFontRegistry, createASCII8x8FontLoad, createEmptyCompressedInputPacket, decodeCompressedInput, decodeInt8ToAxis, encodeAxisToInt8, encodeCompressedInput, getASCII8x8FontConfig, getAllCharCodes, getAudioOrderTypeName, getButtonByteCount, getCharBitmap, getCompressedPacketSize, getMacroEventTypeName, getMacroOrderTypeName, getOrderTypeName, hasChar, isValidAudioOrderType, isValidMacroEventType, isValidMacroOrderType, isValidOrderType };
-export type { AnyAudioOrder, AnyLoad, AnyMacroEvent, AnyMacroOrder, AudioOrder, BitmapFontConfig, BitmapFontLoad, Bitmask16Order, Bitmask16Variant, Bitmask4Order, Bitmask4Variant, BitmaskOrder, ButtonBorderStyle, ButtonConfig, ButtonStateColors, Cell, ChangeEvent, CircleShape, ClickEvent, Color, ColorPaletteLoad, CompressedInputPacket, ConfigureSpatialOrder, CoreMode, CoreOptions, CreateInstanceConfig, CreateInstanceOrder, EffectMacroTemplate, EffectTransform, EllipseShape, FadeOutSoundOrder, LineMacroTemplate, LineShape, MacroEntry, MacroEvent, MacroInstanceEntry, MacroLoad, MacroOrder, MacroTemplate, MacroTemplateBase, MacroType, MacroUpdateResult, MulticolorCell, MulticolorSprite, MulticolorSpriteLoad, NetworkDisplay, NetworkLayer, ParticleConfig, ParticleEmitter, ParticleMacroTemplate, PauseSoundOrder, PlayGlobalSoundOrder, PlaySoundOrder, RectangleShape, RemoveInstanceOrder, RenderCommand, ResumeSoundOrder, RevealCellDef, RevealContent, RevealContentType, RevealCursor, RevealDirection, RevealMacroTemplate, RevealPattern, RevealPause, SelectEvent, SetListenerPositionOrder, SetSoundEffectsOrder, ShapeData, SoundEntry, SoundLoad, SpriteLoad, StopSoundOrder, SubmitEvent, TickStats, TriangleShape, UIMacroTemplate, UIState, UISubtype, UnicolorSprite, UpdateInstanceOrder, UpdatePacket, UserTickStats, WebFontConfig, WebFontLoad };
+/**
+ * UTSP Post-Process Order Decoder
+ *
+ * Decodes binary post-process orders received over the network.
+ * Post-process orders control visual effects like scanlines and ambient effect.
+ */
+
+/**
+ * Decoder for UTSP post-process orders
+ * Converts binary buffers to post-process order interfaces
+ */
+declare class PostProcessOrderDecoder {
+    /**
+     * Main entry point - decodes a post-process order from buffer
+     * Returns the decoded order and bytes consumed
+     */
+    decode(buffer: Uint8Array, offset: number): {
+        order: AnyPostProcessOrder;
+        bytesRead: number;
+    };
+    private decodeSetConfigOrder;
+    private decodeSetScanlinesOrder;
+    private decodeSetAmbientEffectOrder;
+    private decodeSetScalingModeOrder;
+    private decodeSetGridOrder;
+}
+
+/**
+ * PostProcessOrderCollector - Converts high-level post-process commands to binary PostProcessOrders
+ *
+ * This class bridges the gap between the User's high-level post-process API
+ * (setPostProcess, setAmbientEffect, etc.) and the binary PostProcessOrder protocol.
+ *
+ * It converts PostProcessCommands to PostProcessOrders ready for binary encoding in UpdatePacket.
+ *
+ * @example
+ * ```typescript
+ * const collector = new PostProcessOrderCollector();
+ *
+ * // Convert User's pending commands to orders
+ * const postProcessOrders = collector.collectFromUser(user);
+ *
+ * // postProcessOrders can now be added to UpdatePacket
+ * ```
+ */
+
+/**
+ * Collects and converts post-process commands to binary PostProcessOrders
+ */
+declare class PostProcessOrderCollector {
+    /**
+     * Collect all pending post-process orders from a user
+     *
+     * This flushes the user's post-process command queue,
+     * converts them to binary PostProcessOrders, and returns them.
+     *
+     * @param user - The user to collect orders from
+     * @returns Array of PostProcessOrders ready for encoding
+     */
+    collectFromUser(user: User): AnyPostProcessOrder[];
+    /**
+     * Convert an array of post-process commands to PostProcessOrders
+     *
+     * This is the core conversion logic used by both:
+     * - Server: collectFromUser() → encode → network
+     * - Local: convertCommands() → applyPostProcessOrders() (no encoding)
+     *
+     * @param commands - Array of PostProcessCommands to convert
+     * @returns Array of PostProcessOrders
+     */
+    convertCommands(commands: PostProcessCommand[]): AnyPostProcessOrder[];
+    /**
+     * Convert a post-process command to a PostProcessOrder
+     */
+    private convertCommand;
+    /**
+     * Convert a full set-config command to a SetConfigOrder
+     */
+    private convertSetConfig;
+    /**
+     * Create a SetScanlinesOrder with given parameters
+     */
+    private createSetScanlinesOrder;
+    /**
+     * Create a SetAmbientEffectOrder with given parameters
+     */
+    private createSetAmbientEffectOrder;
+    /**
+     * Convert pattern string to ScanlinesPatternType
+     */
+    private patternToType;
+    /**
+     * Create a SetScalingModeOrder with given scaling mode
+     */
+    private createSetScalingModeOrder;
+    /**
+     * Create a SetGridOrder with given grid configuration
+     */
+    private createSetGridOrder;
+    /**
+     * 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, InputBindingRegistry, LAYER_CELL_COUNT, LAYER_HEADER_SIZE, LAYER_SIZE, LINE_SHAPE_SIZE, Layer, LoadType, MacroEngine, MacroEventType, MacroOrderType, MacroRegistry, 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, 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, TRIGGERGLOBALSOUND_ORDER_SIZE, TRIGGERSOUND_ORDER_SIZE, UPDATE_PACKET_HEADER_SIZE, UpdateFlags, UpdateFlagsHelper, UpdatePacketDecoder, User, UserStats, WebFont, WebFontRegistry, createASCII8x8FontLoad, createEmptyCompressedInputPacket, decodeCompressedInput, decodeInt8ToAxis, encodeAxisToInt8, encodeCompressedInput, getASCII8x8FontConfig, getAllCharCodes, getAudioOrderTypeName, getButtonByteCount, getCharBitmap, getCompressedPacketSize, getMacroEventTypeName, getMacroOrderTypeName, getOrderTypeName, hasChar, isValidAudioOrderType, isValidMacroEventType, isValidMacroOrderType, isValidOrderType };
+export type { AnyAudioOrder, AnyLoad, AnyMacroEvent, AnyMacroOrder, AnyPostProcessOrder, AudioOrder, BitmapFontConfig, BitmapFontLoad, Bitmask16Order, Bitmask16Variant, Bitmask4Order, Bitmask4Variant, BitmaskOrder, ButtonBorderStyle, ButtonConfig, ButtonStateColors, Cell, ChangeEvent, CircleShape, ClickEvent, Color, ColorPaletteLoad, CompressedInputPacket, ConfigureSpatialOrder, CoreMode, CoreOptions, CreateInstanceConfig, CreateInstanceOrder, EffectMacroTemplate, EffectTransform, EllipseShape, FadeOutSoundOrder, LineMacroTemplate, LineShape, MacroEntry, MacroEvent, MacroInstanceEntry, MacroLoad, MacroOrder, MacroTemplate, MacroTemplateBase, MacroType, MacroUpdateResult, 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, TickStats, TriangleShape, UIMacroTemplate, UIState, UISubtype, UnicolorSprite, UpdateInstanceOrder, UpdatePacket, UserTickStats, WebFontConfig, WebFontLoad };