blecsd 0.1.0

package/dist/input/index.d.ts

@@ -0,0 +1,158 @@
+import { b as KeyEvent } from '../keyParser-Bwm8-l7v.js';
+import 'zod';
+
+/**
+ * Vi-style navigation mode for scrollable elements.
+ *
+ * Provides vi key bindings for scrolling, cursor movement,
+ * and search within scrollable content. Enable with vi: true.
+ * Compatible with existing key bindings.
+ *
+ * @module input/viMode
+ */
+
+/**
+ * Vi mode state.
+ */
+type ViModeState = 'normal' | 'search' | 'command';
+/**
+ * Vi navigation action produced by key processing.
+ */
+type ViAction = {
+    readonly type: 'scroll';
+    readonly direction: 'up' | 'down' | 'left' | 'right';
+    readonly amount: number;
+} | {
+    readonly type: 'jump';
+    readonly target: 'top' | 'bottom' | 'high' | 'middle' | 'low';
+} | {
+    readonly type: 'page';
+    readonly direction: 'up' | 'down';
+    readonly amount: 'half' | 'full';
+} | {
+    readonly type: 'search';
+    readonly query: string;
+    readonly direction: 'forward' | 'backward';
+} | {
+    readonly type: 'searchNext';
+    readonly direction: 'forward' | 'backward';
+} | {
+    readonly type: 'enterSearch';
+} | {
+    readonly type: 'exitSearch';
+} | {
+    readonly type: 'searchInput';
+    readonly char: string;
+} | {
+    readonly type: 'none';
+};
+/**
+ * Configuration for vi navigation mode.
+ */
+interface ViModeConfig {
+    /** Enable vi mode (default: false) */
+    readonly enabled: boolean;
+    /** Scroll amount for j/k (default: 1) */
+    readonly scrollStep: number;
+    /** Scroll amount for h/l (default: 1) */
+    readonly horizontalStep: number;
+    /** Number of visible lines for H/M/L calculations */
+    readonly viewportHeight: number;
+}
+/**
+ * Vi mode internal state.
+ */
+interface ViState {
+    /** Current vi mode */
+    readonly mode: ViModeState;
+    /** Current search query buffer */
+    readonly searchBuffer: string;
+    /** Last search query */
+    readonly lastSearch: string;
+    /** Last search direction */
+    readonly lastSearchDirection: 'forward' | 'backward';
+    /** Count prefix (e.g., "5j" = move down 5) */
+    readonly countPrefix: number;
+    /** Whether g was pressed (for gg) */
+    readonly gPending: boolean;
+}
+/**
+ * Creates initial vi mode state.
+ *
+ * @returns Fresh vi state
+ *
+ * @example
+ * ```typescript
+ * import { createViState } from 'blecsd';
+ *
+ * const viState = createViState();
+ * ```
+ */
+declare function createViState(): ViState;
+/**
+ * Creates a vi mode configuration with defaults.
+ *
+ * @param config - Partial configuration overrides
+ * @returns Full vi configuration
+ */
+declare function createViConfig(config?: Partial<ViModeConfig>): ViModeConfig;
+/**
+ * Processes a key event in vi mode and returns the resulting action and new state.
+ *
+ * @param key - The key event to process
+ * @param state - Current vi state
+ * @param config - Vi mode configuration
+ * @returns Tuple of [action, newState]
+ *
+ * @example
+ * ```typescript
+ * import { createViState, createViConfig, processViKey } from 'blecsd';
+ *
+ * const state = createViState();
+ * const config = createViConfig({ enabled: true, viewportHeight: 40 });
+ *
+ * // Process a 'j' key press
+ * const [action, newState] = processViKey(keyEvent, state, config);
+ * if (action.type === 'scroll') {
+ *   scrollBy(world, eid, 0, action.amount);
+ * }
+ * ```
+ */
+declare function processViKey(key: KeyEvent, state: ViState, config: ViModeConfig): [ViAction, ViState];
+/**
+ * Checks if a key event should be consumed by vi mode.
+ * Use this to prevent vi keys from bubbling to other handlers.
+ *
+ * @param key - The key event
+ * @param state - Current vi state
+ * @param config - Vi configuration
+ * @returns Whether vi mode wants this key
+ */
+declare function isViKey(key: KeyEvent, state: ViState, config: ViModeConfig): boolean;
+/**
+ * Resolves a vi page action to a concrete scroll amount.
+ *
+ * @param action - The page action
+ * @param viewportHeight - Number of visible lines
+ * @returns Scroll amount in lines
+ *
+ * @example
+ * ```typescript
+ * import { resolvePageAmount } from 'blecsd';
+ *
+ * const lines = resolvePageAmount('half', 40); // 20
+ * ```
+ */
+declare function resolvePageAmount(amount: 'half' | 'full', viewportHeight: number): number;
+/**
+ * Resolves a vi jump target to a line number.
+ *
+ * @param target - The jump target
+ * @param scrollTop - Current scroll top position
+ * @param viewportHeight - Viewport height in lines
+ * @param totalLines - Total content lines
+ * @returns Target line number (0-based)
+ */
+declare function resolveJumpTarget(target: 'top' | 'bottom' | 'high' | 'middle' | 'low', scrollTop: number, viewportHeight: number, totalLines: number): number;
+
+export { type ViAction, type ViModeConfig, type ViModeState, type ViState, createViConfig, createViState, isViKey, processViKey, resolveJumpTarget, resolvePageAmount };

package/dist/input/index.js

@@ -0,0 +1 @@
+export{b as createViConfig,a as createViState,d as isViKey,c as processViKey,f as resolveJumpTarget,e as resolvePageAmount}from'../chunk-GYHI26UE.js';import'../chunk-5PELJRUQ.js';