blecsd 0.3.0 → 0.6.0

package/dist/{keyParser-BnHbg2iD.d.ts → keyParser-DReXe2j-.d.ts}

@@ -58,72 +58,61 @@ declare const KeyEventSchema: z.ZodObject<{
     sequence: z.ZodString;
     name: z.ZodEnum<{
         undefined: "undefined";
+        0: "0";
+        up: "up";
+        down: "down";
+        1: "1";
         x: "x";
         y: "y";
+        z: "z";
+        2: "2";
+        left: "left";
+        right: "right";
+        "#": "#";
         r: "r";
         g: "g";
         b: "b";
         a: "a";
-        0: "0";
-        1: "1";
-        2: "2";
-        3: "3";
-        4: "4";
-        escape: "escape";
-        5: "5";
-        6: "6";
-        7: "7";
-        "!": "!";
-        "#": "#";
-        ";": ";";
-        $: "$";
-        "-": "-";
-        left: "left";
-        z: "z";
-        "/": "/";
-        v: "v";
-        f: "f";
-        o: "o";
-        right: "right";
-        up: "up";
-        down: "down";
         return: "return";
         enter: "enter";
         space: "space";
         "*": "*";
-        end: "end";
         insert: "insert";
         delete: "delete";
         home: "home";
+        end: "end";
         backspace: "backspace";
+        escape: "escape";
         tab: "tab";
-        k: "k";
-        j: "j";
         pageup: "pageup";
         pagedown: "pagedown";
-        s: "s";
-        "|": "|";
-        "\\": "\\";
-        8: "8";
-        9: "9";
-        "[": "[";
-        "]": "]";
-        c: "c";
-        m: "m";
-        h: "h";
-        l: "l";
-        u: "u";
-        "?": "?";
-        ",": ",";
         "%": "%";
+        c: "c";
         d: "d";
         e: "e";
+        f: "f";
+        h: "h";
         i: "i";
+        j: "j";
+        k: "k";
+        l: "l";
+        m: "m";
         n: "n";
+        o: "o";
         p: "p";
         q: "q";
+        s: "s";
         t: "t";
+        u: "u";
+        v: "v";
         w: "w";
+        3: "3";
+        4: "4";
+        5: "5";
+        6: "6";
+        7: "7";
+        8: "8";
+        9: "9";
         f1: "f1";
         f2: "f2";
         f3: "f3";
@@ -137,22 +126,33 @@ declare const KeyEventSchema: z.ZodObject<{
         f11: "f11";
         f12: "f12";
         clear: "clear";
+        "!": "!";
         "@": "@";
+        $: "$";
         "^": "^";
         "&": "&";
         "(": "(";
         ")": ")";
+        "-": "-";
         _: "_";
         "=": "=";
         "+": "+";
+        "[": "[";
+        "]": "]";
         "{": "{";
         "}": "}";
+        "\\": "\\";
+        "|": "|";
+        ";": ";";
         ":": ":";
         "'": "'";
         "\"": "\"";
+        ",": ",";
         ".": ".";
         "<": "<";
         ">": ">";
+        "/": "/";
+        "?": "?";
         "`": "`";
         "~": "~";
     }>;
@@ -226,4 +226,4 @@ declare function parseKeySequence(buffer: Uint8Array): KeyEvent | null;
  */
 declare function parseKeyBuffer(buffer: Uint8Array): readonly KeyEvent[];
 
-export { type KeyName as K, KeyEventSchema as a, type KeyEvent as b, parseKeySequence as c, isMouseSequence as i, parseKeyBuffer as p };
+export { type KeyEvent as K, type KeyName as a, parseKeySequence as b, KeyEventSchema as c, isMouseSequence as i, parseKeyBuffer as p };

package/dist/{events-9ForpTfM.d.ts → mouseParser-CCqSEUVN.d.ts}

@@ -1,4 +1,5 @@
-import { U as Unsubscribe, W as World, E as Entity } from './types-CPB4CpbH.js';
+import { W as World, E as Entity, U as Unsubscribe } from './types-B8LmNkzG.js';
+import { z } from 'zod';
 
 /**
  * Typed EventEmitter implementation for type-safe event handling
@@ -195,4 +196,178 @@ interface EntityEventBusStore<T extends EventMap> {
  */
 declare function createEntityEventBusStore<T extends EventMap>(): EntityEventBusStore<T>;
 
-export { type EntityEventBusStore as E, type GetEntityEventBus as G, type ScreenEventMap as S, type UIEventMap as U, type EventBus as a, type EventHandler as b, type EventMap as c, createEntityEventBusStore as d, createEventBus as e };
+/**
+ * Mouse event parser for terminal mouse protocols.
+ * Supports X10, SGR, URXVT, DEC, and VT300 protocols.
+ * @module terminal/mouseParser
+ */
+
+/**
+ * Mouse button identifiers.
+ */
+type MouseButton = 'left' | 'middle' | 'right' | 'wheelUp' | 'wheelDown' | 'unknown';
+/**
+ * Mouse action types.
+ */
+type MouseAction = 'press' | 'release' | 'move' | 'wheel';
+/**
+ * Mouse protocol types.
+ */
+type MouseProtocol = 'x10' | 'sgr' | 'urxvt' | 'dec' | 'vt300';
+/**
+ * Parsed mouse event with position and modifiers.
+ *
+ * @example
+ * ```typescript
+ * import { parseMouseSequence, MouseEvent } from 'blecsd';
+ *
+ * const event = parseMouseSequence(Buffer.from('\x1b[<0;10;20M'));
+ * if (event) {
+ *   console.log(event.x);      // 10
+ *   console.log(event.y);      // 20
+ *   console.log(event.button); // 'left'
+ *   console.log(event.action); // 'press'
+ * }
+ * ```
+ */
+interface MouseEvent {
+    /** X coordinate (0-indexed) */
+    readonly x: number;
+    /** Y coordinate (0-indexed) */
+    readonly y: number;
+    /** Mouse button */
+    readonly button: MouseButton;
+    /** Action type */
+    readonly action: MouseAction;
+    /** Ctrl modifier was pressed */
+    readonly ctrl: boolean;
+    /** Alt/Meta modifier was pressed */
+    readonly meta: boolean;
+    /** Shift modifier was pressed */
+    readonly shift: boolean;
+    /** Protocol used to encode this event */
+    readonly protocol: MouseProtocol;
+    /** Raw buffer data */
+    readonly raw: Uint8Array;
+}
+/**
+ * Zod schema for MouseEvent validation.
+ *
+ * @example
+ * ```typescript
+ * import { MouseEventSchema } from 'blecsd';
+ *
+ * const result = MouseEventSchema.safeParse(event);
+ * if (result.success) {
+ *   console.log('Valid mouse event');
+ * }
+ * ```
+ */
+declare const MouseEventSchema: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    button: z.ZodEnum<{
+        unknown: "unknown";
+        left: "left";
+        right: "right";
+        middle: "middle";
+        wheelUp: "wheelUp";
+        wheelDown: "wheelDown";
+    }>;
+    action: z.ZodEnum<{
+        press: "press";
+        release: "release";
+        move: "move";
+        wheel: "wheel";
+    }>;
+    ctrl: z.ZodBoolean;
+    meta: z.ZodBoolean;
+    shift: z.ZodBoolean;
+    protocol: z.ZodEnum<{
+        x10: "x10";
+        sgr: "sgr";
+        urxvt: "urxvt";
+        dec: "dec";
+        vt300: "vt300";
+    }>;
+    raw: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+}, z.core.$strip>;
+/**
+ * Focus event result (not a full mouse event).
+ */
+interface FocusEvent {
+    /** Whether the terminal gained or lost focus */
+    readonly focused: boolean;
+    /** Raw buffer data */
+    readonly raw: Uint8Array;
+}
+/**
+ * Zod schema for FocusEvent validation.
+ */
+declare const FocusEventSchema: z.ZodObject<{
+    focused: z.ZodBoolean;
+    raw: z.ZodCustom<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>;
+}, z.core.$strip>;
+/**
+ * Result of parsing a mouse/focus sequence.
+ */
+type ParseMouseResult = {
+    type: 'mouse';
+    event: MouseEvent;
+} | {
+    type: 'focus';
+    event: FocusEvent;
+} | null;
+/**
+ * Parse a mouse or focus sequence from a buffer.
+ *
+ * Supports multiple mouse protocols:
+ * - X10/X11: Basic mouse reporting (ESC [ M ...)
+ * - SGR: Extended mouse reporting with release info (ESC [ < ...)
+ * - URXVT: rxvt-unicode mouse format (ESC [ ... M)
+ * - DEC: DEC locator format (ESC [ < ... & w)
+ * - VT300: VT300 locator format (ESC [ 24X ~ ...)
+ *
+ * Also handles terminal focus events (ESC [ I/O).
+ *
+ * @param buffer - Raw input buffer to parse
+ * @returns Parsed result or null if not a mouse sequence
+ *
+ * @example
+ * ```typescript
+ * import { parseMouseSequence } from 'blecsd';
+ *
+ * // Parse SGR mouse press at (10, 20)
+ * const result = parseMouseSequence(Buffer.from('\x1b[<0;10;20M'));
+ * if (result?.type === 'mouse') {
+ *   console.log(result.event.x);      // 9 (0-indexed)
+ *   console.log(result.event.y);      // 19 (0-indexed)
+ *   console.log(result.event.button); // 'left'
+ *   console.log(result.event.action); // 'press'
+ * }
+ *
+ * // Parse focus event
+ * const focus = parseMouseSequence(Buffer.from('\x1b[I'));
+ * if (focus?.type === 'focus') {
+ *   console.log(focus.event.focused); // true
+ * }
+ * ```
+ */
+declare function parseMouseSequence(buffer: Uint8Array): ParseMouseResult;
+/**
+ * Check if a buffer contains a mouse sequence.
+ *
+ * @param buffer - Input buffer to check
+ * @returns true if buffer contains a mouse sequence
+ *
+ * @example
+ * ```typescript
+ * import { isMouseBuffer } from 'blecsd';
+ *
+ * const buffer = Buffer.from('\x1b[<0;10;20M');
+ * console.log(isMouseBuffer(buffer)); // true
+ * ```
+ */
+declare function isMouseBuffer(buffer: Uint8Array): boolean;
+
+export { type EventMap as E, type FocusEvent as F, type GetEntityEventBus as G, type MouseEvent as M, type ParseMouseResult as P, type ScreenEventMap as S, type UIEventMap as U, type MouseButton as a, type EventBus as b, type EntityEventBusStore as c, type EventHandler as d, createEntityEventBusStore as e, createEventBus as f, type MouseAction as g, FocusEventSchema as h, isMouseBuffer as i, MouseEventSchema as j, type MouseProtocol as k, parseMouseSequence as p };

package/dist/{packedStore-BgvnEdE7.d.ts → packedStore-480t2X74.d.ts}

@@ -188,4 +188,4 @@ declare function getStoreSize<T>(store: PackedStore<T>): number;
  */
 declare function getStoreCapacity<T>(store: PackedStore<T>): number;
 
-export { type PackedStore as P, type PackedHandle as a, addToStore as b, clearStore as c, createPackedStore as d, getStoreCapacity as e, forEachInStore as f, getFromStore as g, getStoreData as h, getStoreSize as i, isValidHandle as j, mapStore as m, removeFromStore as r, setInStore as s };
+export { type PackedHandle as P, type PackedStore as a, addToStore as b, clearStore as c, createPackedStore as d, getStoreCapacity as e, forEachInStore as f, getFromStore as g, getStoreData as h, getStoreSize as i, isValidHandle as j, mapStore as m, removeFromStore as r, setInStore as s };