blecsd 0.6.0 → 0.6.2

package/dist/mouseParser-CTNGolIA.d.ts

@@ -0,0 +1,177 @@
+import { z } from 'zod';
+
+/**
+ * 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 FocusEvent as F, type MouseEvent as M, type ParseMouseResult as P, type MouseButton as a, type MouseAction as b, FocusEventSchema as c, MouseEventSchema as d, type MouseProtocol as e, isMouseBuffer as i, parseMouseSequence as p };

package/dist/{panelMovement-DGzIQ8Ll.d.ts → panelMovement-DSLYdNOL.d.ts}

@@ -1,11 +1,12 @@
 import { S as Scheduler } from './scheduler-NbHT3-D2.js';
 import { S as System, W as World, E as Entity } from './types-B8LmNkzG.js';
-import { b as EventBus, M as MouseEvent, U as UIEventMap } from './mouseParser-CCqSEUVN.js';
+import { a as EventBus, U as UIEventMap } from './events-CGqK6LGt.js';
 import { K as KeyEvent } from './keyParser-DReXe2j-.js';
+import { M as MouseEvent } from './mouseParser-CTNGolIA.js';
 import { Writable } from 'node:stream';
 import { a as CellChange, S as ScreenBufferData, C as Cell } from './cell-5Ty_3yMs.js';
-import { D as DoubleBufferData } from './doubleBuffer-CWASihKh.js';
-import { a as DirtyTracker } from './dirtyTracking-kCS9-NVF.js';
+import { D as DoubleBufferData } from './doubleBuffer-d9yVNtj1.js';
+import { a as DirtyTracker } from './dirtyTracking-D0SQrEeo.js';
 
 /**
  * Animation system for updating sprite animations.
@@ -1905,4 +1906,4 @@ declare function detectResizeHandle(clickX: number, clickY: number, panelWidth:
  */
 declare function mergeDirtyRects(rects: readonly DirtyRect[]): DirtyRect | undefined;
 
-export { computeLayoutNow as $, focusPop as A, peekFocusStack as B, getFocusStackDepth as C, type DirtyRect as D, clearFocusStack as E, saveFocus as F, restoreFocus as G, rewindFocus as H, createInputSystem as I, registerInputSystem as J, type InputSystemState as K, queryInputReceivers as L, hitTest as M, pointInEntity as N, getInteractiveEntityAt as O, queueKeyEvent as P, queueMouseEvent as Q, getEventQueue as R, clearEventQueue as S, clearEntityInput as T, getInputEventBus as U, resetInputState as V, captureMouseTo as W, releaseMouse as X, isMouseCaptured as Y, getMouseCaptureEntity as Z, createLayoutSystem as _, animationSystem as a, isOcclusionCullingEnabled as a$, getComputedLayout as a0, getComputedBounds as a1, hasComputedLayout as a2, invalidateLayout as a3, invalidateAllLayouts as a4, createOutputSystem as a5, createOutputState as a6, clearOutputBuffer as a7, clearOutputStream as a8, generateOutput as a9, endSyncOutput as aA, createPanelMoveState as aB, createPanelMoveConfig as aC, createPanelConstraints as aD, beginMove as aE, beginResize as aF, updateMove as aG, updateResize as aH, endMoveOrResize as aI, cancelMoveOrResize as aJ, detectResizeHandle as aK, mergeDirtyRects as aL, keyboardMove as aM, keyboardResize as aN, createRenderSystem as aO, getRenderBuffer as aP, setRenderBuffer as aQ, clearRenderBuffer as aR, markAllDirty as aS, renderContent as aT, renderBackground as aU, renderBorder as aV, renderScrollbar as aW, renderText as aX, renderRect as aY, getViewportBounds as aZ, setViewportBounds as a_, getOutputBuffer as aa, setOutputBuffer as ab, getOutputStream as ac, setOutputStream as ad, getOutputState as ae, resetOutputState as af, writeRaw as ag, hideCursor as ah, showCursor as ai, cursorHome as aj, moveTo as ak, saveCursorPosition as al, restoreCursorPosition as am, setTerminalCursorShape as an, enterAlternateScreen as ao, leaveAlternateScreen as ap, setWindowTitle as aq, resetAttributes as ar, bell as as, enableMouseTracking as at, disableMouseTracking as au, enableBracketedPasteMode as av, disableBracketedPasteMode as aw, enableFocusReporting as ax, disableFocusReporting as ay, beginSyncOutput as az, clearScreen as b, setOcclusionCulling as b0, ComputedLayout as b1, type ComputedLayoutData as b2, type FocusEventData as b3, type FocusEventMap as b4, type FocusEventType as b5, type HitTestResult as b6, type InputEventType as b7, type MoveResult as b8, type OutputState as b9, type PanelConstraints as ba, type PanelMoveConfig as bb, type PanelMoveState as bc, type QueuedInputEvent as bd, type QueuedKeyEvent as be, type QueuedMouseEvent as bf, type RenderContext as bg, type ResizeHandle as bh, inputState as bi, cleanup as c, createAnimationSystem as d, registerAnimationSystem as e, focusSystem as f, createFocusSystem as g, hasAnimationSystem as h, inputSystem as i, focusEntity as j, focusNext as k, layoutSystem as l, focusPrev as m, focusFirst as n, outputSystem as o, focusLast as p, queryAnimation as q, renderSystem as r, focusOffset as s, blurAll as t, updateAnimations as u, getFocused as v, getFocusableEntities as w, getFocusEventBus as x, resetFocusEventBus as y, focusPush as z };
+export { clearEventQueue as $, focusFirst as A, focusLast as B, focusOffset as C, type DirtyRect as D, blurAll as E, getFocused as F, getFocusableEntities as G, getFocusEventBus as H, resetFocusEventBus as I, focusPush as J, focusPop as K, peekFocusStack as L, getFocusStackDepth as M, clearFocusStack as N, saveFocus as O, restoreFocus as P, rewindFocus as Q, createInputSystem as R, registerInputSystem as S, type InputSystemState as T, queryInputReceivers as U, hitTest as V, pointInEntity as W, getInteractiveEntityAt as X, queueKeyEvent as Y, queueMouseEvent as Z, getEventQueue as _, animationSystem as a, isOcclusionCullingEnabled as a$, clearEntityInput as a0, getInputEventBus as a1, resetInputState as a2, captureMouseTo as a3, releaseMouse as a4, isMouseCaptured as a5, getMouseCaptureEntity as a6, createLayoutSystem as a7, computeLayoutNow as a8, getComputedLayout as a9, beginSyncOutput as aA, endSyncOutput as aB, createPanelMoveState as aC, createPanelMoveConfig as aD, createPanelConstraints as aE, beginMove as aF, beginResize as aG, updateMove as aH, updateResize as aI, endMoveOrResize as aJ, cancelMoveOrResize as aK, detectResizeHandle as aL, mergeDirtyRects as aM, keyboardMove as aN, keyboardResize as aO, createRenderSystem as aP, getRenderBuffer as aQ, clearRenderBuffer as aR, markAllDirty as aS, renderContent as aT, renderBackground as aU, renderBorder as aV, renderScrollbar as aW, renderText as aX, renderRect as aY, getViewportBounds as aZ, setViewportBounds as a_, getComputedBounds as aa, hasComputedLayout as ab, invalidateLayout as ac, invalidateAllLayouts as ad, createOutputSystem as ae, createOutputState as af, clearOutputBuffer as ag, clearOutputStream as ah, generateOutput as ai, getOutputBuffer as aj, getOutputStream as ak, getOutputState as al, resetOutputState as am, moveTo as an, saveCursorPosition as ao, restoreCursorPosition as ap, setTerminalCursorShape as aq, setWindowTitle as ar, resetAttributes as as, bell as at, enableMouseTracking as au, disableMouseTracking as av, enableBracketedPasteMode as aw, disableBracketedPasteMode as ax, enableFocusReporting as ay, disableFocusReporting as az, clearScreen as b, setOcclusionCulling as b0, ComputedLayout as b1, type ComputedLayoutData as b2, type FocusEventData as b3, type FocusEventMap as b4, type FocusEventType as b5, type HitTestResult as b6, type InputEventType as b7, type MoveResult as b8, type OutputState as b9, type PanelConstraints as ba, type PanelMoveConfig as bb, type PanelMoveState as bc, type QueuedInputEvent as bd, type QueuedKeyEvent as be, type QueuedMouseEvent as bf, type RenderContext as bg, type ResizeHandle as bh, inputState as bi, cleanup as c, cursorHome as d, enterAlternateScreen as e, focusSystem as f, leaveAlternateScreen as g, hideCursor as h, inputSystem as i, setOutputStream as j, setRenderBuffer as k, layoutSystem as l, showCursor as m, createAnimationSystem as n, outputSystem as o, registerAnimationSystem as p, hasAnimationSystem as q, renderSystem as r, setOutputBuffer as s, queryAnimation as t, updateAnimations as u, createFocusSystem as v, writeRaw as w, focusEntity as x, focusNext as y, focusPrev as z };