@utsp/core 0.1.1 → 0.1.3

package/dist/index.d.ts

@@ -442,6 +442,50 @@ interface BitmaskOrder extends NetworkOrder {
     override: boolean;
     mask: Uint8Array;
 }
+/**
+ * Cell variant definition for Bitmask4 order
+ */
+interface Bitmask4Variant {
+    charCode: number;
+    bgColorCode: number;
+    fgColorCode: number;
+}
+/**
+ * 0x12 - Bitmask4: Renders a rectangular region with 2-bit packed mask
+ * Each 2-bit value represents: 0 = absence, 1-3 = variant index
+ */
+interface Bitmask4Order extends NetworkOrder {
+    type: 0x12;
+    posX: number;
+    posY: number;
+    sizeX: number;
+    sizeY: number;
+    override: boolean;
+    variants: [Bitmask4Variant, Bitmask4Variant, Bitmask4Variant];
+    mask: Uint8Array;
+}
+/**
+ * Cell variant definition for Bitmask16 order
+ */
+interface Bitmask16Variant {
+    charCode: number;
+    bgColorCode: number;
+    fgColorCode: number;
+}
+/**
+ * 0x18 - Bitmask16: Renders a rectangular region with 4-bit packed mask
+ * Each 4-bit value represents: 0 = absence, 1-15 = variant index
+ */
+interface Bitmask16Order extends NetworkOrder {
+    type: 0x18;
+    posX: number;
+    posY: number;
+    sizeX: number;
+    sizeY: number;
+    override: boolean;
+    variants: Bitmask16Variant[];
+    mask: Uint8Array;
+}
 /**
  * 0x13 - Clear: Fills entire layer with single character and colors
  */
@@ -496,7 +540,7 @@ interface TriggerGlobalSoundOrder extends NetworkOrder {
     soundId: number;
     loop: boolean;
 }
-type AnyNetworkOrder = CharOrder | TextOrder | TextMultilineOrder | SubFrameOrder | SubFrameMultiColorOrder | FullFrameOrder | FullFrameMultiColorOrder | SpriteOrder | SpriteMultiColorOrder | ColorMapOrder | ShapeOrder | DotCloudOrder | DotCloudMultiColorOrder | BitmaskOrder | SpriteCloudOrder | SpriteCloudMultiColorOrder | SpriteCloudVariedOrder | SpriteCloudVariedMultiColorOrder | ClearOrder | FillCharOrder | FillSpriteOrder | FillSpriteMultiColorOrder | TriggerSoundOrder | TriggerGlobalSoundOrder;
+type AnyNetworkOrder = CharOrder | TextOrder | TextMultilineOrder | SubFrameOrder | SubFrameMultiColorOrder | FullFrameOrder | FullFrameMultiColorOrder | SpriteOrder | SpriteMultiColorOrder | ColorMapOrder | ShapeOrder | DotCloudOrder | DotCloudMultiColorOrder | BitmaskOrder | Bitmask4Order | Bitmask16Order | SpriteCloudOrder | SpriteCloudMultiColorOrder | SpriteCloudVariedOrder | SpriteCloudVariedMultiColorOrder | ClearOrder | FillCharOrder | FillSpriteOrder | FillSpriteMultiColorOrder | TriggerSoundOrder | TriggerGlobalSoundOrder;
 
 interface NetworkLayer {
     id: number;
@@ -4282,6 +4326,50 @@ declare class OrderBuilder {
      * ], '#', 15, 0, false)
      */
     static bitmask(x: number, y: number, width: number, height: number, mask: boolean[], char: string | number, fgColor?: number, bgColor?: number, override?: boolean): BitmaskOrder;
+    /**
+     * 0x12 - Bitmask4: 2-bit packed mask with 3 visual variants
+     * @param mask - Flat array of values 0-3 (row-major order: sizeX × sizeY)
+     *               0 = absence, 1-3 = variant index
+     * @param variants - Array of up to 3 variants { char, fgColor, bgColor } for values 1, 2, 3
+     * @param override - true: clear absences (transparent), false: preserve existing cells
+     * @example Create a 3×3 pattern with 3 variants
+     * OrderBuilder.bitmask4(10, 10, 3, 3, [
+     *   0, 1, 0,
+     *   2, 3, 2,
+     *   0, 1, 0
+     * ], [
+     *   { char: 'a', fgColor: 15, bgColor: 0 },
+     *   { char: 'b', fgColor: 14, bgColor: 0 },
+     *   { char: 'c', fgColor: 13, bgColor: 0 }
+     * ], false)
+     */
+    static bitmask4(x: number, y: number, width: number, height: number, mask: number[], variants: Array<{
+        char: string | number;
+        fgColor: number;
+        bgColor: number;
+    }>, override?: boolean): Bitmask4Order;
+    /**
+     * 0x18 - Bitmask16: 4-bit packed mask with 15 visual variants
+     * @param mask - Flat array of values 0-15 (row-major order: sizeX × sizeY)
+     *               0 = absence, 1-15 = variant index
+     * @param variants - Array of up to 15 variants { char, fgColor, bgColor } for values 1-15
+     * @param override - true: clear absences (transparent), false: preserve existing cells
+     * @example Create a 3×3 pattern with multiple variants
+     * OrderBuilder.bitmask16(10, 10, 3, 3, [
+     *   0,  1,  0,
+     *   2, 15,  2,
+     *   0,  1,  0
+     * ], [
+     *   { char: 'a', fgColor: 15, bgColor: 0 },
+     *   { char: 'b', fgColor: 14, bgColor: 0 },
+     *   // ... up to 15 variants
+     * ], false)
+     */
+    static bitmask16(x: number, y: number, width: number, height: number, mask: number[], variants: Array<{
+        char: string | number;
+        fgColor: number;
+        bgColor: number;
+    }>, override?: boolean): Bitmask16Order;
     /**
      * 0x0D - SpriteCloud: Same single-color sprite at multiple positions
      */
@@ -4394,6 +4482,8 @@ declare const TRIANGLE_SHAPE_SIZE = 10;
 declare const DOTCLOUD_ORDER_MIN_SIZE = 6;
 declare const DOTCLOUD_MULTICOLOR_ORDER_MIN_SIZE = 3;
 declare const BITMASK_ORDER_MIN_SIZE = 9;
+declare const BITMASK4_ORDER_MIN_SIZE = 15;
+declare const BITMASK16_ORDER_MIN_SIZE = 51;
 declare const SPRITECLOUD_ORDER_MIN_SIZE = 6;
 declare const SPRITECLOUD_MULTICOLOR_ORDER_MIN_SIZE = 4;
 declare const SPRITECLOUD_VARIED_ORDER_MIN_SIZE = 3;
@@ -4491,8 +4581,19 @@ declare enum OrderType {
     SpriteCloudVariedMultiColor = 16,
     /**
      * 0x11 - Bitmask: Bitpacked presence/absence mask with uniform character and colors
+     * 1 bit per cell: 0 = absence, 1 = presence
      */
     Bitmask = 17,
+    /**
+     * 0x12 - Bitmask4: Bitpacked 2-bit mask with 3 visual variants
+     * 2 bits per cell: 0 = absence, 1-3 = variant index
+     */
+    Bitmask4 = 18,
+    /**
+     * 0x18 - Bitmask16: Bitpacked 4-bit mask with 15 visual variants
+     * 4 bits per cell: 0 = absence, 1-15 = variant index
+     */
+    Bitmask16 = 24,
     /**
      * 0x13 - Clear: Fills entire layer with single character and colors
      */
@@ -4728,5 +4829,5 @@ declare class UpdatePacketDecoder {
     private checkSize;
 }
 
-export { ASCII_8X8_FONT, 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, OrderBuilder, OrderType, 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, 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, getButtonByteCount, getCharBitmap, getCompressedPacketSize, getOrderTypeName, hasChar, isValidOrderType };
-export type { AnyLoad, BitmapFontConfig, BitmapFontLoad, Cell, CircleShape, Color, ColorPaletteLoad, CompressedInputPacket, CoreMode, CoreOptions, EllipseShape, LineShape, MulticolorCell, MulticolorSprite, MulticolorSpriteLoad, NetworkDisplay, NetworkLayer, RectangleShape, ShapeData, SoundLoad, SpriteLoad, TickStats, TriangleShape, UnicolorSprite, UpdatePacket, UserTickStats, WebFontConfig, WebFontLoad };
+export { ASCII_8X8_FONT, 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, OrderBuilder, OrderType, 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, 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, getButtonByteCount, getCharBitmap, getCompressedPacketSize, getOrderTypeName, hasChar, isValidOrderType };
+export type { AnyLoad, BitmapFontConfig, BitmapFontLoad, Bitmask16Order, Bitmask16Variant, Bitmask4Order, Bitmask4Variant, BitmaskOrder, Cell, CircleShape, Color, ColorPaletteLoad, CompressedInputPacket, CoreMode, CoreOptions, EllipseShape, LineShape, MulticolorCell, MulticolorSprite, MulticolorSpriteLoad, NetworkDisplay, NetworkLayer, RectangleShape, ShapeData, SoundLoad, SpriteLoad, TickStats, TriangleShape, UnicolorSprite, UpdatePacket, UserTickStats, WebFontConfig, WebFontLoad };