blecsd 0.1.1 → 0.3.0

package/dist/{virtualViewport-Dx2iJliO.d.ts → virtualViewport-Bpv6jlKt.d.ts}

@@ -1,84 +1,255 @@
-import { U as Unsubscribe, W as World, E as Entity } from './types-BcsvoKzf.js';
+import { W as World, E as Entity } from './types-CPB4CpbH.js';
 import { z } from 'zod';
 import { A as Attribute } from './parser-iMHmQuUh.js';
 import { S as ScreenBufferData, C as Cell } from './cell-DwIu2ryP.js';
-import { S as ScrollbackBuffer } from './virtualScrollback-DvZTRU8a.js';
+import { S as ScrollbackBuffer } from './virtualScrollback-D9uLFe8l.js';
 
 /**
- * Configurable state machine framework
- * @module core/stateMachine
- * @internal This module is for internal use by widgets
+ * Dimensions component for entity sizing in the terminal grid.
+ * @module components/dimensions
  */
 
 /**
- * Action function executed on state transitions.
- * Receives the state machine context for side effects.
+ * Special value indicating "auto" (content-based) dimension.
+ * When used, the dimension is calculated based on content.
  */
-type Action<Context = unknown> = (context: Context) => void;
+declare const AUTO_DIMENSION = -1;
 /**
- * Transition target with optional actions.
+ * Encodes a percentage value for storage in typed arrays.
+ * Percentages are stored as negative values: -2 = 0%, -102 = 100%
+ *
+ * @param percent - Percentage value (0-100)
+ * @returns Encoded value for storage
+ *
+ * @example
+ * ```typescript
+ * const encoded = encodePercentage(50); // Returns -52
+ * ```
+ */
+declare function encodePercentage(percent: number): number;
+/**
+ * Decodes a percentage value from typed array storage.
+ *
+ * @param value - Encoded value from storage
+ * @returns Percentage value (0-100) or null if not a percentage
+ *
+ * @example
+ * ```typescript
+ * const percent = decodePercentage(-52); // Returns 50
+ * const notPercent = decodePercentage(100); // Returns null
+ * ```
+ */
+declare function decodePercentage(value: number): number | null;
+/**
+ * Checks if a value represents a percentage.
+ *
+ * @param value - Value to check
+ * @returns true if the value is an encoded percentage
+ */
+declare function isPercentage(value: number): boolean;
+/**
+ * Dimensions component store using SoA (Structure of Arrays) for performance.
+ *
+ * - `width`, `height`: Size in terminal cells (floats), or encoded percentages
+ * - `minWidth`, `minHeight`: Minimum size constraints
+ * - `maxWidth`, `maxHeight`: Maximum size constraints
+ * - `shrink`: Whether to shrink to content (0=no, 1=yes)
+ *
+ * Percentage values are encoded as negative numbers: -2 = 0%, -102 = 100%
+ * Use `encodePercentage()` and `decodePercentage()` for conversion.
+ *
+ * @example
+ * ```typescript
+ * import { Dimensions, setDimensions, getDimensions } from 'blecsd';
+ *
+ * setDimensions(world, entity, 80, 24);
+ *
+ * const dims = getDimensions(world, entity);
+ * console.log(dims.width, dims.height); // 80, 24
+ * ```
+ */
+declare const Dimensions: {
+    /** Width in terminal cells (or encoded percentage) */
+    width: Float32Array<ArrayBuffer>;
+    /** Height in terminal cells (or encoded percentage) */
+    height: Float32Array<ArrayBuffer>;
+    /** Minimum width constraint */
+    minWidth: Float32Array<ArrayBuffer>;
+    /** Minimum height constraint */
+    minHeight: Float32Array<ArrayBuffer>;
+    /** Maximum width constraint */
+    maxWidth: Float32Array<ArrayBuffer>;
+    /** Maximum height constraint */
+    maxHeight: Float32Array<ArrayBuffer>;
+    /** 0 = fixed size, 1 = shrink to content */
+    shrink: Uint8Array<ArrayBuffer>;
+};
+/**
+ * Dimension value that can be a number, percentage string, or 'auto'.
  */
-interface TransitionConfig<S extends string, Context = unknown> {
-    target: S;
-    actions?: Action<Context>[];
-    guard?: (context: Context) => boolean;
+type DimensionValue = number | `${number}%` | 'auto';
+/**
+ * Dimensions data returned by getDimensions.
+ */
+interface DimensionsData {
+    readonly width: number;
+    readonly height: number;
+    readonly minWidth: number;
+    readonly minHeight: number;
+    readonly maxWidth: number;
+    readonly maxHeight: number;
+    readonly shrink: boolean;
 }
 /**
- * State configuration with entry/exit actions and transitions.
+ * Constraints data for min/max dimensions.
  */
-interface StateConfig<S extends string, E extends string, Context = unknown> {
-    /** Actions to run when entering this state */
-    entry?: Action<Context>[];
-    /** Actions to run when exiting this state */
-    exit?: Action<Context>[];
-    /** Event handlers mapping events to target states */
-    on?: Partial<Record<E, S | TransitionConfig<S, Context>>>;
+interface DimensionConstraints {
+    readonly minWidth?: number;
+    readonly minHeight?: number;
+    readonly maxWidth?: number;
+    readonly maxHeight?: number;
 }
 /**
- * Full state machine configuration.
+ * Sets the dimensions of an entity.
+ * Adds the Dimensions component if not already present.
  *
- * @typeParam S - Union type of all state names
- * @typeParam E - Union type of all event names
- * @typeParam Context - Optional context object passed to actions
+ * @param world - The ECS world
+ * @param eid - The entity ID
+ * @param width - Width value (number, percentage string like "50%", or "auto")
+ * @param height - Height value (number, percentage string like "50%", or "auto")
+ * @returns The entity ID for chaining
+ *
+ * @example
+ * ```typescript
+ * import { createWorld, addEntity } from '../core/ecs';
+ * import { setDimensions } from 'blecsd';
+ *
+ * const world = createWorld();
+ * const entity = addEntity(world);
+ *
+ * // Fixed size
+ * setDimensions(world, entity, 80, 24);
+ *
+ * // Percentage width
+ * setDimensions(world, entity, '50%', 24);
+ *
+ * // Auto height
+ * setDimensions(world, entity, 80, 'auto');
+ * ```
  */
-interface StateMachineConfig<S extends string, E extends string, Context = unknown> {
-    /** Initial state when machine starts */
-    initial: S;
-    /** State definitions */
-    states: Record<S, StateConfig<S, E, Context>>;
-    /** Optional initial context */
-    context?: Context;
-}
+declare function setDimensions(world: World, eid: Entity, width: DimensionValue, height: DimensionValue): Entity;
+/**
+ * Gets the dimensions data of an entity.
+ * Returns undefined if the entity doesn't have a Dimensions component.
+ *
+ * @param world - The ECS world
+ * @param eid - The entity ID
+ * @returns Dimensions data or undefined
+ *
+ * @example
+ * ```typescript
+ * import { getDimensions } from 'blecsd';
+ *
+ * const dims = getDimensions(world, entity);
+ * if (dims) {
+ *   console.log(`Size: ${dims.width}x${dims.height}`);
+ * }
+ * ```
+ */
+declare function getDimensions(world: World, eid: Entity): DimensionsData | undefined;
+/**
+ * Sets dimension constraints (min/max) for an entity.
+ *
+ * @param world - The ECS world
+ * @param eid - The entity ID
+ * @param constraints - Constraint values to set
+ * @returns The entity ID for chaining
+ *
+ * @example
+ * ```typescript
+ * import { setConstraints } from 'blecsd';
+ *
+ * setConstraints(world, entity, {
+ *   minWidth: 10,
+ *   maxWidth: 100,
+ *   minHeight: 5,
+ * });
+ * ```
+ */
+declare function setConstraints(world: World, eid: Entity, constraints: DimensionConstraints): Entity;
+/**
+ * Sets the shrink-to-content flag for an entity.
+ *
+ * @param world - The ECS world
+ * @param eid - The entity ID
+ * @param shrink - true to shrink to content, false for fixed size
+ * @returns The entity ID for chaining
+ *
+ * @example
+ * ```typescript
+ * import { setShrink } from 'blecsd';
+ *
+ * // Enable shrink-to-content
+ * setShrink(world, entity, true);
+ * ```
+ */
+declare function setShrink(world: World, eid: Entity, shrink: boolean): Entity;
 /**
- * State change listener function.
+ * Checks if an entity should shrink to content.
+ *
+ * @param world - The ECS world
+ * @param eid - The entity ID
+ * @returns true if shrink is enabled, false otherwise
  */
-type StateListener<S extends string> = (current: S, previous: S) => void;
+declare function shouldShrink(world: World, eid: Entity): boolean;
 /**
- * StateMachine interface for type-safe access.
+ * Checks if an entity has a Dimensions component.
  *
- * @typeParam S - Union type of all state names
- * @typeParam E - Union type of all event names
- * @typeParam Context - Optional context object passed to actions
+ * @param world - The ECS world
+ * @param eid - The entity ID
+ * @returns true if entity has Dimensions component
  */
-interface StateMachine<S extends string, E extends string, Context = unknown> {
-    readonly current: S;
-    readonly context: Context;
-    send(event: E): boolean;
-    can(event: E): boolean;
-    matches(state: S): boolean;
-    subscribe(listener: StateListener<S>): Unsubscribe;
-    validEvents(): E[];
-    reset(): void;
-}
-
+declare function hasDimensions(world: World, eid: Entity): boolean;
+/**
+ * Gets the width of an entity, resolving percentages against a container width.
+ *
+ * @param world - The ECS world
+ * @param eid - The entity ID
+ * @param containerWidth - Container width to resolve percentages against
+ * @returns Resolved width value, or undefined if no Dimensions component
+ *
+ * @example
+ * ```typescript
+ * import { getResolvedWidth, setDimensions } from 'blecsd';
+ *
+ * setDimensions(world, entity, '50%', 24);
+ * const width = getResolvedWidth(world, entity, 100); // Returns 50
+ * ```
+ */
+declare function getResolvedWidth(world: World, eid: Entity, containerWidth: number): number | undefined;
 /**
- * List Component
+ * Gets the height of an entity, resolving percentages against a container height.
+ *
+ * @param world - The ECS world
+ * @param eid - The entity ID
+ * @param containerHeight - Container height to resolve percentages against
+ * @returns Resolved height value, or undefined if no Dimensions component
  *
- * Provides list/item selection functionality with keyboard and mouse support.
+ * @example
+ * ```typescript
+ * import { getResolvedHeight, setDimensions } from 'blecsd';
  *
- * @module components/list
+ * setDimensions(world, entity, 80, '25%');
+ * const height = getResolvedHeight(world, entity, 80); // Returns 20
+ * ```
  */
+declare function getResolvedHeight(world: World, eid: Entity, containerHeight: number): number | undefined;
 
+/**
+ * List Component Types
+ *
+ * @module components/list/types
+ */
 /**
  * List state type.
  */
@@ -211,6 +382,8 @@ type ListAction = {
     type: 'confirm';
 } | {
     type: 'cancel';
+} | {
+    type: 'toggleSelect';
 } | {
     type: 'startSearch';
 } | {
@@ -223,690 +396,6 @@ type ListAction = {
 } | {
     type: 'searchNextMatch';
 };
-/** Default selected prefix character */
-declare const DEFAULT_SELECTED_PREFIX = "> ";
-/** Default unselected prefix character */
-declare const DEFAULT_UNSELECTED_PREFIX = "  ";
-/** Default selected foreground color */
-declare const DEFAULT_SELECTED_FG = 4294967295;
-/** Default selected background color */
-declare const DEFAULT_SELECTED_BG = 6750207;
-/** Default item foreground color */
-declare const DEFAULT_ITEM_FG = 3435973887;
-/** Default item background color */
-declare const DEFAULT_ITEM_BG = 255;
-/** Default disabled foreground color */
-declare const DEFAULT_DISABLED_FG = 1717987071;
-/**
- * Store for list component data.
- */
-declare const listStore: ListStore;
-/**
- * State machine configuration for list widgets.
- *
- * States:
- * - idle: List is not focused
- * - focused: List has focus, ready for navigation
- * - selecting: User is actively selecting (e.g., during mouse drag)
- * - searching: User is typing to search/filter items
- * - disabled: List is disabled and cannot be interacted with
- */
-declare const LIST_STATE_MACHINE_CONFIG: StateMachineConfig<ListState, ListEvent>;
-/**
- * Attaches list behavior to an entity.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param items - Initial items
- * @param options - List options
- *
- * @example
- * ```typescript
- * import { attachListBehavior } from 'blecsd';
- *
- * attachListBehavior(world, eid, [
- *   { text: 'Option 1', value: 'opt1' },
- *   { text: 'Option 2', value: 'opt2' },
- * ], { interactive: true, keys: true });
- * ```
- */
-declare function attachListBehavior(world: World, eid: Entity, items?: ListItem[], options?: {
-    interactive?: boolean;
-    mouse?: boolean;
-    keys?: boolean;
-    search?: boolean;
-    selectedIndex?: number;
-    visibleCount?: number;
-}): void;
-/**
- * Checks if an entity is a list.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns true if entity is a list
- */
-declare function isList(world: World, eid: Entity): boolean;
-/**
- * Gets the current state of a list.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns The current state
- */
-declare function getListState(world: World, eid: Entity): ListState;
-/**
- * Checks if list is in a specific state.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param state - The state to check
- * @returns true if list is in the specified state
- */
-declare function isListInState(world: World, eid: Entity, state: ListState): boolean;
-/**
- * Checks if list is focused.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns true if list is focused
- */
-declare function isListFocused(world: World, eid: Entity): boolean;
-/**
- * Checks if list is disabled.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns true if list is disabled
- */
-declare function isListDisabled(world: World, eid: Entity): boolean;
-/**
- * Sends an event to the list state machine.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param event - The event to send
- * @returns true if transition occurred
- */
-declare function sendListEvent(world: World, eid: Entity, event: ListEvent): boolean;
-/**
- * Focuses the list.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns true if focused successfully
- */
-declare function focusList(world: World, eid: Entity): boolean;
-/**
- * Blurs the list.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns true if blurred successfully
- */
-declare function blurList(world: World, eid: Entity): boolean;
-/**
- * Disables the list.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns true if disabled successfully
- */
-declare function disableList(world: World, eid: Entity): boolean;
-/**
- * Enables the list.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns true if enabled successfully
- */
-declare function enableList(world: World, eid: Entity): boolean;
-/**
- * Gets all items from a list.
- *
- * @param eid - The entity ID
- * @returns Array of list items
- */
-declare function getItems(eid: Entity): readonly ListItem[];
-/**
- * Sets all items in a list.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param items - The items to set
- */
-declare function setItems(world: World, eid: Entity, items: ListItem[]): void;
-/**
- * Adds an item to the list.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param item - The item to add
- * @param index - Optional index to insert at (defaults to end)
- */
-declare function addItem(world: World, eid: Entity, item: ListItem, index?: number): void;
-/**
- * Removes an item from the list.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param index - The index to remove
- * @returns The removed item or undefined
- */
-declare function removeItem(world: World, eid: Entity, index: number): ListItem | undefined;
-/**
- * Gets an item by index.
- *
- * @param eid - The entity ID
- * @param index - The item index
- * @returns The item or undefined
- */
-declare function getItem(eid: Entity, index: number): ListItem | undefined;
-/**
- * Updates an item at a specific index.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param index - The item index
- * @param item - The new item data
- * @returns true if updated successfully
- */
-declare function updateItem(world: World, eid: Entity, index: number, item: ListItem): boolean;
-/**
- * Gets the number of items in the list.
- *
- * @param eid - The entity ID
- * @returns Number of items
- */
-declare function getItemCount(eid: Entity): number;
-/**
- * Clears all items from the list.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- */
-declare function clearItems(world: World, eid: Entity): void;
-/**
- * Gets the selected index.
- *
- * @param eid - The entity ID
- * @returns Selected index or -1 if none
- */
-declare function getSelectedIndex(eid: Entity): number;
-/**
- * Gets the selected item.
- *
- * @param eid - The entity ID
- * @returns Selected item or undefined
- */
-declare function getSelectedItem(eid: Entity): ListItem | undefined;
-declare function setSelectedIndex(world: World, eid: Entity, index: number): boolean;
-/**
- * Selects the previous item.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param wrap - Whether to wrap around (default: true)
- * @returns true if selection changed
- */
-declare function selectPrev(world: World, eid: Entity, wrap?: boolean): boolean;
-/**
- * Selects the next item.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param wrap - Whether to wrap around (default: true)
- * @returns true if selection changed
- */
-declare function selectNext(world: World, eid: Entity, wrap?: boolean): boolean;
-/**
- * Selects the first item.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns true if selection changed
- */
-declare function selectFirst(world: World, eid: Entity): boolean;
-/**
- * Selects the last item.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns true if selection changed
- */
-declare function selectLast(world: World, eid: Entity): boolean;
-/**
- * Selects an item by value.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param value - The value to select
- * @returns true if selection changed
- */
-declare function selectByValue(world: World, eid: Entity, value: string): boolean;
-/**
- * Clears the selection.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- */
-declare function clearSelection(world: World, eid: Entity): void;
-/**
- * Activates (confirms) the currently selected item.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns true if an item was activated
- */
-declare function activateSelected(_world: World, eid: Entity): boolean;
-/**
- * Gets the first visible item index.
- *
- * @param eid - The entity ID
- * @returns First visible index
- */
-declare function getFirstVisible(eid: Entity): number;
-/**
- * Sets the first visible item index.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param index - The first visible index
- */
-declare function setFirstVisible(world: World, eid: Entity, index: number): void;
-/**
- * Gets the number of visible items.
- *
- * @param eid - The entity ID
- * @returns Number of visible items
- */
-declare function getVisibleCount(eid: Entity): number;
-/**
- * Sets the number of visible items.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param count - The number of visible items
- */
-declare function setVisibleCount(world: World, eid: Entity, count: number): void;
-/**
- * Ensures an index is visible by scrolling if necessary.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param index - The index to make visible
- */
-declare function ensureVisible(world: World, eid: Entity, index: number): void;
-/**
- * Scrolls the list by a page (visibleCount items).
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param direction - 1 for down, -1 for up
- * @returns true if scrolled
- */
-declare function scrollPage(world: World, eid: Entity, direction: 1 | -1): boolean;
-/**
- * Gets the visible items for rendering.
- *
- * @param eid - The entity ID
- * @returns Array of visible items with their indices
- */
-declare function getVisibleItems(eid: Entity): Array<{
-    index: number;
-    item: ListItem;
-}>;
-/**
- * Sets the total item count for virtualized lists.
- * This can be larger than the actual loaded items count for infinite scroll.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param count - Total item count
- */
-declare function setTotalCount(world: World, eid: Entity, count: number): void;
-/**
- * Gets the total item count (may be larger than loaded items).
- *
- * @param eid - The entity ID
- * @returns Total item count
- */
-declare function getTotalCount(eid: Entity): number;
-/**
- * Sets the lazy load callback for loading items on demand.
- *
- * @param eid - The entity ID
- * @param callback - Callback function to load items
- */
-declare function setLazyLoadCallback(eid: Entity, callback: ListLazyLoadCallback): void;
-/**
- * Gets the lazy load callback.
- *
- * @param eid - The entity ID
- * @returns Lazy load callback or undefined
- */
-declare function getLazyLoadCallback(eid: Entity): ListLazyLoadCallback | undefined;
-/**
- * Clears the lazy load callback.
- *
- * @param eid - The entity ID
- */
-declare function clearLazyLoadCallback(eid: Entity): void;
-/**
- * Registers a scroll callback for detecting scroll events.
- *
- * @param eid - The entity ID
- * @param callback - Callback function
- * @returns Unsubscribe function
- */
-declare function onListScroll(eid: Entity, callback: ListScrollCallback): () => void;
-/**
- * Sets the loading state for a list.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param loading - Whether items are loading
- */
-declare function setListLoading(world: World, eid: Entity, loading: boolean): void;
-/**
- * Checks if a list is currently loading items.
- *
- * @param eid - The entity ID
- * @returns true if loading
- */
-declare function isListLoading(eid: Entity): boolean;
-/**
- * Sets the loading placeholder text.
- *
- * @param eid - The entity ID
- * @param text - Placeholder text to show while loading
- */
-declare function setLoadingPlaceholder(eid: Entity, text: string): void;
-/**
- * Gets the loading placeholder text.
- *
- * @param eid - The entity ID
- * @returns Loading placeholder text
- */
-declare function getLoadingPlaceholder(eid: Entity): string;
-/**
- * Loads items for a range using the lazy load callback.
- * Returns immediately if no callback is set or already loading.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param startIndex - First item to load
- * @param count - Number of items to load
- * @returns Promise that resolves when loading completes
- */
-declare function loadItems(world: World, eid: Entity, startIndex: number, count: number): Promise<void>;
-/**
- * Checks if items need to be loaded for the current visible range.
- *
- * @param eid - The entity ID
- * @returns Object with needsLoad flag and range to load
- */
-declare function checkNeedsLoad(eid: Entity): {
-    needsLoad: boolean;
-    startIndex: number;
-    count: number;
-};
-/**
- * Gets scroll info for the list.
- *
- * @param eid - The entity ID
- * @param threshold - Items from end to trigger nearEnd (default: visibleCount)
- * @returns Scroll information
- */
-declare function getScrollInfo$1(eid: Entity, threshold?: number): ListScrollInfo;
-/**
- * Appends items to the list (useful for infinite scroll).
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param newItems - Items to append
- */
-declare function appendItems(world: World, eid: Entity, newItems: readonly ListItem[]): void;
-/**
- * Sets the list display configuration.
- *
- * @param eid - The entity ID
- * @param options - Display options
- */
-declare function setListDisplay(eid: Entity, options: ListDisplayOptions): void;
-/**
- * Gets the list display configuration.
- *
- * @param eid - The entity ID
- * @returns Display configuration
- */
-declare function getListDisplay(eid: Entity): ListDisplay;
-/**
- * Clears the list display configuration.
- *
- * @param eid - The entity ID
- */
-declare function clearListDisplay(eid: Entity): void;
-/**
- * Checks if list is interactive.
- *
- * @param eid - The entity ID
- * @returns true if interactive
- */
-declare function isListInteractive(eid: Entity): boolean;
-/**
- * Sets list interactive mode.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param interactive - Whether list is interactive
- */
-declare function setListInteractive(world: World, eid: Entity, interactive: boolean): void;
-/**
- * Checks if list responds to mouse.
- *
- * @param eid - The entity ID
- * @returns true if mouse enabled
- */
-declare function isListMouseEnabled(eid: Entity): boolean;
-/**
- * Sets list mouse mode.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param mouse - Whether mouse is enabled
- */
-declare function setListMouse(world: World, eid: Entity, mouse: boolean): void;
-/**
- * Checks if list responds to keyboard.
- *
- * @param eid - The entity ID
- * @returns true if keys enabled
- */
-declare function isListKeysEnabled(eid: Entity): boolean;
-/**
- * Sets list keys mode.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param keys - Whether keys are enabled
- */
-declare function setListKeys(world: World, eid: Entity, keys: boolean): void;
-/**
- * Checks if search mode is enabled for the list.
- *
- * @param eid - The entity ID
- * @returns true if search is enabled
- */
-declare function isListSearchEnabled(eid: Entity): boolean;
-/**
- * Sets whether search mode is enabled for the list.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param enabled - Whether search is enabled
- */
-declare function setListSearchEnabled(world: World, eid: Entity, enabled: boolean): void;
-/**
- * Checks if list is currently in search mode.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns true if list is in searching state
- */
-declare function isListSearching(world: World, eid: Entity): boolean;
-/**
- * Starts search mode for the list.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns true if search mode was started
- */
-declare function startListSearch(world: World, eid: Entity): boolean;
-/**
- * Ends search mode for the list.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns true if search mode was ended
- */
-declare function endListSearch(world: World, eid: Entity): boolean;
-/**
- * Gets the current search query.
- *
- * @param eid - The entity ID
- * @returns The current search query or empty string
- */
-declare function getListSearchQuery(eid: Entity): string;
-/**
- * Sets the search query and finds matching items.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param query - The search query
- * @returns true if a match was found and selected
- */
-declare function setListSearchQuery(world: World, eid: Entity, query: string): boolean;
-/**
- * Appends a character to the search query.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param char - The character to append
- * @returns true if a match was found and selected
- */
-declare function appendToSearchQuery(world: World, eid: Entity, char: string): boolean;
-/**
- * Removes the last character from the search query.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns true if a match was found and selected
- */
-declare function backspaceSearchQuery(world: World, eid: Entity): boolean;
-/**
- * Clears the search query.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- */
-declare function clearSearchQuery(world: World, eid: Entity): void;
-/**
- * Finds and selects the first item matching the text (case-insensitive).
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param text - The text to search for
- * @returns true if a match was found and selected
- */
-declare function findAndSelectByText(world: World, eid: Entity, text: string): boolean;
-/**
- * Finds the next item matching the current search query.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns true if a match was found and selected
- */
-declare function findNextMatch(world: World, eid: Entity): boolean;
-/**
- * Registers a callback for when search query changes.
- *
- * @param eid - The entity ID
- * @param callback - The callback function
- * @returns Unsubscribe function
- *
- * @example
- * ```typescript
- * const unsubscribe = onListSearchChange(eid, (query) => {
- *   console.log(`Search: ${query}`);
- * });
- * ```
- */
-declare function onListSearchChange(eid: Entity, callback: (query: string) => void): () => void;
-/**
- * Registers a callback for when selection changes.
- *
- * @param eid - The entity ID
- * @param callback - The callback function
- * @returns Unsubscribe function
- *
- * @example
- * ```typescript
- * const unsubscribe = onListSelect(eid, (index, item) => {
- *   console.log(`Selected: ${item.text}`);
- * });
- * ```
- */
-declare function onListSelect(eid: Entity, callback: ListSelectCallback): () => void;
-/**
- * Registers a callback for when an item is activated (confirmed).
- *
- * @param eid - The entity ID
- * @param callback - The callback function
- * @returns Unsubscribe function
- *
- * @example
- * ```typescript
- * const unsubscribe = onListActivate(eid, (index, item) => {
- *   console.log(`Activated: ${item.text}`);
- * });
- * ```
- */
-declare function onListActivate(eid: Entity, callback: ListSelectCallback): () => void;
-/**
- * Clears all callbacks for a list.
- *
- * @param eid - The entity ID
- */
-declare function clearListCallbacks(eid: Entity): void;
-/**
- * Handles key press for list widget.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param key - The key name
- * @returns Action to perform or null
- *
- * @example
- * ```typescript
- * const action = handleListKeyPress(world, eid, 'down');
- * if (action?.type === 'selectNext') {
- *   selectNext(world, eid);
- * }
- * ```
- */
-declare function handleListKeyPress(world: World, eid: Entity, key: string): ListAction | null;
-/**
- * Renders list items as strings for display.
- *
- * @param eid - The entity ID
- * @param width - Available width
- * @returns Array of rendered line strings
- */
-declare function renderListItems(eid: Entity, width: number): string[];
-/**
- * Resets the list store. Used for testing.
- */
-declare function resetListStore(): void;
 
 /**
  * Scrollable component for scrolling support.
@@ -1258,13 +747,13 @@ interface TableColumn {
     /** Column header text */
     readonly header: string;
     /** Column width (characters) */
-    readonly width?: number;
+    readonly width?: number | undefined;
     /** Column minimum width */
-    readonly minWidth?: number;
+    readonly minWidth?: number | undefined;
     /** Column maximum width */
-    readonly maxWidth?: number;
+    readonly maxWidth?: number | undefined;
     /** Column alignment */
-    readonly align?: CellAlign;
+    readonly align?: CellAlign | undefined;
 }
 /**
  * Table store for managing table-specific data.
@@ -1429,17 +918,19 @@ declare function setData(world: World, eid: Entity, rows: ReadonlyArray<Readonly
 /**
  * Gets the table data.
  *
+ * @param world - The ECS world (unused, kept for API consistency)
  * @param eid - The entity ID
  * @returns Table data as array of rows
  */
-declare function getData(eid: Entity): TableData;
+declare function getData(_world: World, eid: Entity): TableData;
 /**
  * Gets the table data as a string array.
  *
+ * @param world - The ECS world (unused, kept for API consistency)
  * @param eid - The entity ID
  * @returns Table data as string[][]
  */
-declare function getDataAsStrings(eid: Entity): string[][];
+declare function getDataAsStrings(_world: World, eid: Entity): string[][];
 /**
  * Sets a single cell value.
  *
@@ -1460,51 +951,57 @@ declare function setCell(world: World, eid: Entity, row: number, col: number, va
 /**
  * Gets a single cell value.
  *
+ * @param world - The ECS world (unused, kept for API consistency)
  * @param eid - The entity ID
  * @param row - Row index (0-based)
  * @param col - Column index (0-based)
  * @returns Cell data or undefined if out of bounds
  */
-declare function getCell(eid: Entity, row: number, col: number): TableCell | undefined;
+declare function getCell(_world: World, eid: Entity, row: number, col: number): TableCell | undefined;
 /**
  * Gets a cell's string value.
  *
+ * @param world - The ECS world (unused, kept for API consistency)
  * @param eid - The entity ID
  * @param row - Row index (0-based)
  * @param col - Column index (0-based)
  * @returns Cell value string or undefined if out of bounds
  */
-declare function getCellValue(eid: Entity, row: number, col: number): string | undefined;
+declare function getCellValue(world: World, eid: Entity, row: number, col: number): string | undefined;
 /**
  * Gets a specific row.
  *
+ * @param world - The ECS world (unused, kept for API consistency)
  * @param eid - The entity ID
  * @param row - Row index (0-based)
  * @returns Row data or undefined if out of bounds
  */
-declare function getRow(eid: Entity, row: number): TableRow | undefined;
+declare function getRow(_world: World, eid: Entity, row: number): TableRow | undefined;
 /**
  * Gets a specific column.
  *
+ * @param world - The ECS world (unused, kept for API consistency)
  * @param eid - The entity ID
  * @param col - Column index (0-based)
  * @returns Column data as array of cells
  */
-declare function getColumn(eid: Entity, col: number): readonly TableCell[];
+declare function getColumn(_world: World, eid: Entity, col: number): readonly TableCell[];
 /**
  * Gets the number of rows.
  *
+ * @param world - The ECS world (unused, kept for API consistency)
  * @param eid - The entity ID
  * @returns Number of rows
  */
-declare function getRowCount(eid: Entity): number;
+declare function getRowCount(_world: World, eid: Entity): number;
 /**
  * Gets the number of columns.
  *
+ * @param world - The ECS world (unused, kept for API consistency)
  * @param eid - The entity ID
  * @returns Number of columns
  */
-declare function getColCount(eid: Entity): number;
+declare function getColCount(_world: World, eid: Entity): number;
 /**
  * Appends a row to the table.
  *
@@ -1558,24 +1055,27 @@ declare function setHeaders(world: World, eid: Entity, columns: readonly TableCo
 /**
  * Gets the column configuration.
  *
+ * @param world - The ECS world (unused, kept for API consistency)
  * @param eid - The entity ID
  * @returns Column configuration
  */
-declare function getColumns(eid: Entity): readonly TableColumn[];
+declare function getColumns(_world: World, eid: Entity): readonly TableColumn[];
 /**
  * Gets the header row(s).
  *
+ * @param world - The ECS world (unused, kept for API consistency)
  * @param eid - The entity ID
  * @returns Header row data
  */
-declare function getHeaderRows(eid: Entity): readonly TableRow[];
+declare function getHeaderRows(_world: World, eid: Entity): readonly TableRow[];
 /**
  * Gets the data rows (excluding headers).
  *
+ * @param world - The ECS world (unused, kept for API consistency)
  * @param eid - The entity ID
  * @returns Data rows
  */
-declare function getDataRows(eid: Entity): readonly TableRow[];
+declare function getDataRows(_world: World, eid: Entity): readonly TableRow[];
 /**
  * Sets the number of header rows.
  *
@@ -1587,37 +1087,42 @@ declare function setHeaderRowCount(world: World, eid: Entity, count: number): vo
 /**
  * Gets the number of header rows.
  *
+ * @param world - The ECS world (unused, kept for API consistency)
  * @param eid - The entity ID
  * @returns Number of header rows
  */
-declare function getHeaderRowCount(eid: Entity): number;
+declare function getHeaderRowCount(_world: World, eid: Entity): number;
 /**
  * Sets the table display configuration.
  *
+ * @param world - The ECS world (unused, kept for API consistency)
  * @param eid - The entity ID
  * @param options - Display options
  */
-declare function setTableDisplay(eid: Entity, options: TableDisplayOptions): void;
+declare function setTableDisplay(_world: World, eid: Entity, options: TableDisplayOptions): void;
 /**
  * Gets the table display configuration.
  *
+ * @param world - The ECS world (unused, kept for API consistency)
  * @param eid - The entity ID
  * @returns Display configuration
  */
-declare function getTableDisplay(eid: Entity): TableDisplay;
+declare function getTableDisplay(_world: World, eid: Entity): TableDisplay;
 /**
  * Clears the table display configuration.
  *
+ * @param world - The ECS world (unused, kept for API consistency)
  * @param eid - The entity ID
  */
-declare function clearTableDisplay(eid: Entity): void;
+declare function clearTableDisplay(_world: World, eid: Entity): void;
 /**
  * Gets the cell padding.
  *
+ * @param world - The ECS world (unused, kept for API consistency)
  * @param eid - The entity ID
  * @returns Cell padding (spaces)
  */
-declare function getCellPadding(eid: Entity): number;
+declare function getCellPadding(_world: World, eid: Entity): number;
 /**
  * Sets the cell padding.
  *
@@ -1629,10 +1134,11 @@ declare function setCellPadding(world: World, eid: Entity, padding: number): voi
 /**
  * Checks if cell borders are enabled.
  *
+ * @param world - The ECS world (unused, kept for API consistency)
  * @param eid - The entity ID
  * @returns true if cell borders are enabled
  */
-declare function hasCellBorders(eid: Entity): boolean;
+declare function hasCellBorders(_world: World, eid: Entity): boolean;
 /**
  * Sets whether cell borders are enabled.
  *
@@ -1641,8 +1147,24 @@ declare function hasCellBorders(eid: Entity): boolean;
  * @param enabled - Whether to show cell borders
  */
 declare function setCellBorders(world: World, eid: Entity, enabled: boolean): void;
-declare function calculateColumnWidths(eid: Entity, maxTotalWidth?: number): number[];
-declare function renderTableLines(eid: Entity, width: number): string[];
+/**
+ * Calculates column widths based on content.
+ *
+ * @param world - The ECS world (unused, kept for API consistency)
+ * @param eid - The entity ID
+ * @param maxTotalWidth - Maximum total width (optional)
+ * @returns Array of column widths
+ */
+declare function calculateColumnWidths(_world: World, eid: Entity, maxTotalWidth?: number): number[];
+/**
+ * Renders table as an array of strings (one per line).
+ *
+ * @param world - The ECS world (unused, kept for API consistency)
+ * @param eid - The entity ID
+ * @param width - Available width
+ * @returns Array of rendered line strings
+ */
+declare function renderTableLines(world: World, eid: Entity, width: number): string[];
 /**
  * Resets the table store. Used for testing.
  */
@@ -2331,4 +1853,4 @@ declare function clearViewportDirty(world: World, eid: Entity): Entity;
  */
 declare function invalidateViewport(world: World, eid: Entity): Entity;
 
-export { type ScrollInfo as $, type ScrollPercentage as A, type ScrollPosition as B, type CellAlign as C, DEFAULT_CELL_BG as D, Scrollable as E, type ScrollableData as F, type ScrollableOptions as G, ScrollbarVisibility as H, type TableCell as I, type TableColumn as J, type TableData as K, LIST_STATE_MACHINE_CONFIG as L, type TableDisplay as M, type TableDisplayOptions as N, type TableRow as O, type TableStore as P, TerminalBuffer as Q, type TerminalBufferConfig as R, ScrollInfoSchema as S, Table as T, TerminalBufferConfigSchema as U, type CursorShape as V, type TerminalState as W, VirtualViewport as X, type VirtualViewportData as Y, type VirtualViewportOptions as Z, VirtualViewportOptionsSchema as _, DEFAULT_CELL_FG as a, getTerminalBuffer as a$, type VisibleRange as a0, VisibleRangeSchema as a1, activateSelected as a2, addItem as a3, appendItems as a4, appendRow as a5, appendToSearchQuery as a6, attachListBehavior as a7, attachTableBehavior as a8, backspaceSearchQuery as a9, getColumn as aA, getColumns as aB, getCursorLine as aC, getData as aD, getDataAsStrings as aE, getDataRows as aF, getFirstVisible as aG, getHeaderRowCount as aH, getHeaderRows as aI, getItem as aJ, getItemCount as aK, getItems as aL, getLazyLoadCallback as aM, getListDisplay as aN, getListSearchQuery as aO, getSelectedIndex as aP, getListState as aQ, getLoadingPlaceholder as aR, getRow as aS, getRowCount as aT, getScroll as aU, getScrollInfo$1 as aV, getScrollPercentage as aW, getScrollable as aX, getSelectedItem as aY, getSelectedLine as aZ, getTableDisplay as a_, blurList as aa, calculateColumnWidths as ab, canScroll as ac, checkNeedsLoad as ad, clearData as ae, clearItems as af, clearLazyLoadCallback as ag, clearListCallbacks as ah, clearListDisplay as ai, clearSelection as aj, clearSearchQuery as ak, clearTableDisplay as al, clearTerminal as am, clearViewportDirty as an, detachTableBehavior as ao, disableList as ap, enableList as aq, endListSearch as ar, ensureCursorVisible as as, ensureVisible as at, findAndSelectByText as au, findNextMatch as av, focusList as aw, getCellPadding as ax, getCellValue as ay, getColCount as az, DEFAULT_DISABLED_FG as b, selectByValue as b$, getTerminalCells as b0, getTerminalState as b1, getTotalCount as b2, getScrollInfo as b3, getVirtualViewport as b4, getVisibleCount as b5, getVisibleItems as b6, getVisibleRange as b7, handleListKeyPress as b8, hasCellBorders as b9, onListSearchChange as bA, onListSelect as bB, removeItem as bC, removeRow as bD, removeTerminalBuffer as bE, renderListItems as bF, renderTableLines as bG, renderTerminalToAnsi as bH, resetListStore as bI, resetTableStore as bJ, resetTerminal as bK, resetTerminalBufferStore as bL, resizeTerminalBuffer as bM, scrollBy as bN, scrollByLines as bO, scrollByPages as bP, scrollPage as bQ, scrollTerminalDown as bR, scrollTerminalToBottom as bS, scrollTerminalToTop as bT, scrollTerminalUp as bU, scrollTo as bV, scrollToBottom$1 as bW, scrollToLine as bX, scrollToTop$1 as bY, scrollToBottom as bZ, scrollToTop as b_, hasScrollable as ba, hasTerminalBuffer as bb, hasVirtualViewport as bc, insertRow as bd, invalidateViewport as be, isAtBottom as bf, isAtTop as bg, isLineInRenderRange as bh, isLineVisible as bi, isList as bj, isListDisabled as bk, isListFocused as bl, isListInState as bm, isListInteractive as bn, isListKeysEnabled as bo, isListLoading as bp, isListMouseEnabled as bq, isListSearchEnabled as br, isListSearching as bs, isTable as bt, isViewportDirty as bu, listStore as bv, loadItems as bw, moveCursor as bx, onListActivate as by, onListScroll as bz, DEFAULT_HEADER_BG as c, selectFirst as c0, selectLast as c1, selectNext as c2, selectPrev as c3, sendListEvent as c4, setCellBorders as c5, setCellPadding as c6, setCursorLine as c7, setCursorPosition as c8, setData as c9, setVisibleCount as cA, setVisibleLineCount as cB, startListSearch as cC, tableStore as cD, updateItem as cE, writeToTerminal as cF, type StateMachineConfig as cG, type StateMachine as cH, getCell as cI, setCell as cJ, setCursorVisible as cK, writeChar as cL, setFirstVisible as ca, setHeaderRowCount as cb, setHeaders as cc, setItems as cd, setLazyLoadCallback as ce, setListDisplay as cf, setListInteractive as cg, setListKeys as ch, setListLoading as ci, setListMouse as cj, setListSearchEnabled as ck, setListSearchQuery as cl, setSelectedIndex as cm, setLoadingPlaceholder as cn, setOverscan as co, setScroll as cp, setScrollSize as cq, setScrollable as cr, setScrollbarVisibility as cs, setSelectedLine as ct, setTableDisplay as cu, setTerminalBuffer as cv, setTotalCount as cw, setTotalLineCount as cx, setViewportStart as cy, setVirtualViewport as cz, DEFAULT_HEADER_FG as d, DEFAULT_ITEM_BG as e, DEFAULT_ITEM_FG as f, DEFAULT_SCROLLBACK_LINES as g, DEFAULT_SELECTED_BG as h, DEFAULT_SELECTED_FG as i, DEFAULT_SELECTED_PREFIX as j, DEFAULT_BORDER_BG as k, DEFAULT_BORDER_FG as l, DEFAULT_TERMINAL_HEIGHT as m, DEFAULT_TERMINAL_WIDTH as n, DEFAULT_UNSELECTED_PREFIX as o, type ListAction as p, type ListDisplay as q, type ListDisplayOptions as r, type ListEvent as s, type ListItem as t, type ListLazyLoadCallback as u, type ListScrollCallback as v, type ListScrollInfo as w, type ListSelectCallback as x, type ListState as y, type ListStore as z };
+export { appendRow as $, AUTO_DIMENSION as A, type ScrollableOptions as B, type CellAlign as C, DEFAULT_CELL_BG as D, ScrollbarVisibility as E, type TableCell as F, type TableColumn as G, type TableData as H, type TableDisplay as I, type TableDisplayOptions as J, type TableRow as K, type ListAction as L, type TableStore as M, TerminalBuffer as N, type TerminalBufferConfig as O, TerminalBufferConfigSchema as P, type CursorShape as Q, type TerminalState as R, ScrollInfoSchema as S, Table as T, type VirtualViewportData as U, VirtualViewport as V, type VirtualViewportOptions as W, VirtualViewportOptionsSchema as X, type ScrollInfo as Y, type VisibleRange as Z, VisibleRangeSchema as _, DEFAULT_CELL_FG as a, scrollByPages as a$, attachTableBehavior as a0, calculateColumnWidths as a1, canScroll as a2, clearData as a3, clearTableDisplay as a4, clearTerminal as a5, clearViewportDirty as a6, decodePercentage as a7, detachTableBehavior as a8, encodePercentage as a9, getVirtualViewport as aA, getVisibleRange as aB, hasCellBorders as aC, hasDimensions as aD, hasScrollable as aE, hasTerminalBuffer as aF, hasVirtualViewport as aG, insertRow as aH, invalidateViewport as aI, isAtBottom as aJ, isAtTop as aK, isLineInRenderRange as aL, isLineVisible as aM, isPercentage as aN, isTable as aO, isViewportDirty as aP, moveCursor as aQ, removeRow as aR, removeTerminalBuffer as aS, renderTableLines as aT, renderTerminalToAnsi as aU, resetTableStore as aV, resetTerminal as aW, resetTerminalBufferStore as aX, resizeTerminalBuffer as aY, scrollBy as aZ, scrollByLines as a_, ensureCursorVisible as aa, getCellPadding as ab, getCellValue as ac, getColCount as ad, getColumn as ae, getColumns as af, getCursorLine as ag, getData as ah, getDataAsStrings as ai, getDataRows as aj, getDimensions as ak, getHeaderRowCount as al, getHeaderRows as am, getResolvedHeight as an, getResolvedWidth as ao, getRow as ap, getRowCount as aq, getScroll as ar, getScrollPercentage as as, getScrollable as at, getSelectedLine as au, getTableDisplay as av, getTerminalBuffer as aw, getTerminalCells as ax, getTerminalState as ay, getScrollInfo as az, DEFAULT_HEADER_BG as b, scrollTerminalDown as b0, scrollTerminalToBottom as b1, scrollTerminalToTop as b2, scrollTerminalUp as b3, scrollTo as b4, scrollToBottom$1 as b5, scrollToLine as b6, scrollToTop$1 as b7, scrollToBottom as b8, scrollToTop as b9, getCell as bA, setCell as bB, setCursorVisible as bC, setCellBorders as ba, setCellPadding as bb, setConstraints as bc, setCursorLine as bd, setCursorPosition as be, setData as bf, setDimensions as bg, setHeaderRowCount as bh, setHeaders as bi, setOverscan as bj, setScroll as bk, setScrollSize as bl, setScrollable as bm, setScrollbarVisibility as bn, setSelectedLine as bo, setShrink as bp, setTableDisplay as bq, setTerminalBuffer as br, setTotalLineCount as bs, setViewportStart as bt, setVirtualViewport as bu, setVisibleLineCount as bv, shouldShrink as bw, tableStore as bx, writeChar as by, writeToTerminal as bz, DEFAULT_HEADER_FG as c, DEFAULT_SCROLLBACK_LINES as d, DEFAULT_BORDER_BG as e, DEFAULT_BORDER_FG as f, DEFAULT_TERMINAL_HEIGHT as g, DEFAULT_TERMINAL_WIDTH as h, type DimensionConstraints as i, type DimensionValue as j, Dimensions as k, type DimensionsData as l, type ListDisplay as m, type ListDisplayOptions as n, type ListEvent as o, type ListItem as p, type ListLazyLoadCallback as q, type ListScrollCallback as r, type ListScrollInfo as s, type ListSelectCallback as t, type ListState as u, type ListStore as v, type ScrollPercentage as w, type ScrollPosition as x, Scrollable as y, type ScrollableData as z };