blecsd 0.3.0 → 0.6.0

package/dist/virtualViewport-Bpv6jlKt.d.ts

@@ -1,1856 +0,0 @@
-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-D9uLFe8l.js';
-
-/**
- * Dimensions component for entity sizing in the terminal grid.
- * @module components/dimensions
- */
-
-/**
- * Special value indicating "auto" (content-based) dimension.
- * When used, the dimension is calculated based on content.
- */
-declare const AUTO_DIMENSION = -1;
-/**
- * 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'.
- */
-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;
-}
-/**
- * Constraints data for min/max dimensions.
- */
-interface DimensionConstraints {
-    readonly minWidth?: number;
-    readonly minHeight?: number;
-    readonly maxWidth?: number;
-    readonly maxHeight?: number;
-}
-/**
- * Sets the dimensions of an entity.
- * Adds the Dimensions component if not already present.
- *
- * @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');
- * ```
- */
-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;
-/**
- * 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
- */
-declare function shouldShrink(world: World, eid: Entity): boolean;
-/**
- * Checks if an entity has a Dimensions component.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns true if entity has Dimensions component
- */
-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;
-/**
- * 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
- *
- * @example
- * ```typescript
- * import { getResolvedHeight, setDimensions } from 'blecsd';
- *
- * 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.
- */
-type ListState = 'idle' | 'focused' | 'selecting' | 'searching' | 'disabled';
-/**
- * List event type.
- */
-type ListEvent = 'focus' | 'blur' | 'startSelect' | 'endSelect' | 'startSearch' | 'endSearch' | 'disable' | 'enable';
-/**
- * List item data.
- */
-interface ListItem {
-    /** Display text */
-    readonly text: string;
-    /** Optional value associated with the item */
-    readonly value?: string;
-    /** Whether the item is disabled */
-    readonly disabled?: boolean;
-}
-/**
- * List store for managing list-specific data.
- */
-interface ListStore {
-    /** Whether entity is a list */
-    isList: Uint8Array;
-    /** Currently selected index (-1 if none) */
-    selectedIndex: Int32Array;
-    /** Number of items in the list */
-    itemCount: Uint32Array;
-    /** First visible item index (for virtualization) */
-    firstVisible: Uint32Array;
-    /** Number of visible items */
-    visibleCount: Uint32Array;
-    /** Whether list is interactive */
-    interactive: Uint8Array;
-    /** Whether list responds to mouse */
-    mouse: Uint8Array;
-    /** Whether list responds to keyboard */
-    keys: Uint8Array;
-    /** Whether search mode is enabled */
-    searchEnabled: Uint8Array;
-    /** Total item count for virtualized lists (may be > itemCount) */
-    totalCount: Uint32Array;
-    /** Whether items are currently loading */
-    isLoading: Uint8Array;
-}
-/**
- * Lazy load callback for virtualized lists.
- * Called when items need to be loaded for a range.
- *
- * @param startIndex - First item index to load
- * @param count - Number of items to load
- * @returns Promise that resolves when items are loaded
- */
-type ListLazyLoadCallback = (startIndex: number, count: number) => Promise<ListItem[]>;
-/**
- * Scroll event callback for infinite scroll detection.
- *
- * @param scrollInfo - Information about current scroll state
- */
-type ListScrollCallback = (scrollInfo: ListScrollInfo) => void;
-/**
- * Scroll information for infinite scroll.
- */
-interface ListScrollInfo {
-    /** First visible item index */
-    readonly firstVisible: number;
-    /** Number of visible items */
-    readonly visibleCount: number;
-    /** Total loaded items */
-    readonly loadedCount: number;
-    /** Total items (may be larger than loaded for infinite scroll) */
-    readonly totalCount: number;
-    /** Whether we're near the end (within threshold) */
-    readonly nearEnd: boolean;
-    /** Whether we're near the start (within threshold) */
-    readonly nearStart: boolean;
-}
-/**
- * List display configuration.
- */
-interface ListDisplay {
-    /** Character shown before selected item */
-    readonly selectedPrefix: string;
-    /** Character shown before unselected items */
-    readonly unselectedPrefix: string;
-    /** Selected item foreground color */
-    readonly selectedFg: number;
-    /** Selected item background color */
-    readonly selectedBg: number;
-    /** Item foreground color */
-    readonly itemFg: number;
-    /** Item background color */
-    readonly itemBg: number;
-    /** Disabled item foreground color */
-    readonly disabledFg: number;
-}
-/**
- * List display options for configuration.
- */
-interface ListDisplayOptions {
-    selectedPrefix?: string;
-    unselectedPrefix?: string;
-    selectedFg?: number;
-    selectedBg?: number;
-    itemFg?: number;
-    itemBg?: number;
-    disabledFg?: number;
-}
-/**
- * List selection callback function type.
- */
-type ListSelectCallback = (index: number, item: ListItem) => void;
-/**
- * List action returned from key press handling.
- */
-type ListAction = {
-    type: 'selectPrev';
-} | {
-    type: 'selectNext';
-} | {
-    type: 'selectFirst';
-} | {
-    type: 'selectLast';
-} | {
-    type: 'pageUp';
-} | {
-    type: 'pageDown';
-} | {
-    type: 'confirm';
-} | {
-    type: 'cancel';
-} | {
-    type: 'toggleSelect';
-} | {
-    type: 'startSearch';
-} | {
-    type: 'endSearch';
-} | {
-    type: 'searchChar';
-    char: string;
-} | {
-    type: 'searchBackspace';
-} | {
-    type: 'searchNextMatch';
-};
-
-/**
- * Scrollable component for scrolling support.
- * @module components/scrollable
- */
-
-/**
- * Scrollbar visibility mode.
- */
-declare enum ScrollbarVisibility {
-    /** Always hidden */
-    Hidden = 0,
-    /** Always visible */
-    Visible = 1,
-    /** Visible only when content overflows */
-    Auto = 2
-}
-/**
- * Scrollable component store using SoA (Structure of Arrays) for performance.
- *
- * - `scrollX`, `scrollY`: Current scroll offset
- * - `scrollWidth`, `scrollHeight`: Total scrollable content size
- * - `scrollbarVisible`: Scrollbar visibility mode
- * - `trackVisible`: Whether scroll track is visible
- * - `alwaysScroll`: Always show scrollbar even when not needed
- *
- * @example
- * ```typescript
- * import { Scrollable, setScroll, getScroll, scrollBy } from 'blecsd';
- *
- * setScroll(world, entity, 0, 100);
- * scrollBy(world, entity, 0, 50);
- *
- * const scroll = getScroll(world, entity);
- * console.log(scroll.y); // 150
- * ```
- */
-declare const Scrollable: {
-    /** Horizontal scroll offset */
-    scrollX: Float32Array<ArrayBuffer>;
-    /** Vertical scroll offset */
-    scrollY: Float32Array<ArrayBuffer>;
-    /** Total scrollable width */
-    scrollWidth: Float32Array<ArrayBuffer>;
-    /** Total scrollable height */
-    scrollHeight: Float32Array<ArrayBuffer>;
-    /** Viewport width (visible area) - used for clamping */
-    viewportWidth: Float32Array<ArrayBuffer>;
-    /** Viewport height (visible area) - used for clamping */
-    viewportHeight: Float32Array<ArrayBuffer>;
-    /** Scrollbar visibility mode (0=hidden, 1=visible, 2=auto) */
-    scrollbarVisible: Uint8Array<ArrayBuffer>;
-    /** Whether scroll track is visible */
-    trackVisible: Uint8Array<ArrayBuffer>;
-    /** Always show scrollbar (0=no, 1=yes) */
-    alwaysScroll: Uint8Array<ArrayBuffer>;
-    /** Whether clamping is enabled (0=no, 1=yes) - default yes */
-    clampEnabled: Uint8Array<ArrayBuffer>;
-};
-/**
- * Scrollable configuration options.
- */
-interface ScrollableOptions {
-    /** Initial horizontal scroll offset */
-    scrollX?: number;
-    /** Initial vertical scroll offset */
-    scrollY?: number;
-    /** Total scrollable width */
-    scrollWidth?: number;
-    /** Total scrollable height */
-    scrollHeight?: number;
-    /** Viewport width (visible area) */
-    viewportWidth?: number;
-    /** Viewport height (visible area) */
-    viewportHeight?: number;
-    /** Scrollbar visibility mode */
-    scrollbarVisible?: ScrollbarVisibility;
-    /** Whether scroll track is visible */
-    trackVisible?: boolean;
-    /** Always show scrollbar */
-    alwaysScroll?: boolean;
-    /** Whether scroll clamping is enabled (default: true) */
-    clampEnabled?: boolean;
-}
-/**
- * Scroll position data.
- */
-interface ScrollPosition {
-    readonly x: number;
-    readonly y: number;
-}
-/**
- * Scroll percentage data.
- */
-interface ScrollPercentage {
-    readonly x: number;
-    readonly y: number;
-}
-/**
- * Full scrollable data returned by getScrollable.
- */
-interface ScrollableData {
-    readonly scrollX: number;
-    readonly scrollY: number;
-    readonly scrollWidth: number;
-    readonly scrollHeight: number;
-    readonly viewportWidth: number;
-    readonly viewportHeight: number;
-    readonly scrollbarVisible: ScrollbarVisibility;
-    readonly trackVisible: boolean;
-    readonly alwaysScroll: boolean;
-    readonly clampEnabled: boolean;
-}
-/**
- * Makes an entity scrollable with the given options.
- * Adds the Scrollable component if not already present.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param options - Scrollable configuration options
- * @returns The entity ID for chaining
- *
- * @example
- * ```typescript
- * import { createWorld, addEntity } from '../core/ecs';
- * import { setScrollable, ScrollbarVisibility } from 'blecsd';
- *
- * const world = createWorld();
- * const entity = addEntity(world);
- *
- * setScrollable(world, entity, {
- *   scrollHeight: 1000,
- *   scrollbarVisible: ScrollbarVisibility.Auto,
- * });
- * ```
- */
-declare function setScrollable(world: World, eid: Entity, options: ScrollableOptions): Entity;
-/**
- * Sets the scroll position of an entity.
- * Adds the Scrollable component if not already present.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param x - Horizontal scroll offset
- * @param y - Vertical scroll offset
- * @returns The entity ID for chaining
- *
- * @example
- * ```typescript
- * import { setScroll } from 'blecsd';
- *
- * setScroll(world, entity, 0, 100);
- * ```
- */
-declare function setScroll(world: World, eid: Entity, x: number, y: number): Entity;
-/**
- * Gets the scroll position of an entity.
- * Returns { x: 0, y: 0 } if no Scrollable component.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns Scroll position
- *
- * @example
- * ```typescript
- * import { getScroll } from 'blecsd';
- *
- * const scroll = getScroll(world, entity);
- * console.log(`Scroll: ${scroll.x}, ${scroll.y}`);
- * ```
- */
-declare function getScroll(world: World, eid: Entity): ScrollPosition;
-/**
- * Scrolls an entity by the given delta values.
- * Adds the Scrollable component if not already present.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param dx - Horizontal scroll delta
- * @param dy - Vertical scroll delta
- * @returns The entity ID for chaining
- *
- * @example
- * ```typescript
- * import { scrollBy } from 'blecsd';
- *
- * // Scroll down by 50 pixels
- * scrollBy(world, entity, 0, 50);
- *
- * // Scroll right by 100 pixels
- * scrollBy(world, entity, 100, 0);
- * ```
- */
-declare function scrollBy(world: World, eid: Entity, dx: number, dy: number): Entity;
-/**
- * Scrolls an entity to the given position.
- * Alias for setScroll for semantic clarity.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param x - Target horizontal scroll offset
- * @param y - Target vertical scroll offset
- * @returns The entity ID for chaining
- *
- * @example
- * ```typescript
- * import { scrollTo } from 'blecsd';
- *
- * scrollTo(world, entity, 0, 0); // Scroll to top
- * ```
- */
-declare function scrollTo(world: World, eid: Entity, x: number, y: number): Entity;
-/**
- * Gets the scroll percentage of an entity.
- * Takes viewport size into account: percentage is based on scrollable range
- * (scrollSize - viewportSize), not total content size.
- * Returns { x: 0, y: 0 } if no scrollable area or content fits in viewport.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns Scroll percentage (0-100 for each axis)
- *
- * @example
- * ```typescript
- * import { getScrollPercentage } from 'blecsd';
- *
- * const percent = getScrollPercentage(world, entity);
- * console.log(`Scrolled: ${percent.y}%`);
- * ```
- */
-declare function getScrollPercentage(world: World, eid: Entity): ScrollPercentage;
-/**
- * Gets the full scrollable data of an entity.
- * Returns undefined if no Scrollable component.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns Scrollable data or undefined
- */
-declare function getScrollable(world: World, eid: Entity): ScrollableData | undefined;
-/**
- * Checks if an entity has a Scrollable component.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns true if entity has Scrollable component
- */
-declare function hasScrollable(world: World, eid: Entity): boolean;
-/**
- * Sets the scrollable content size.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param width - Total scrollable width
- * @param height - Total scrollable height
- * @returns The entity ID for chaining
- */
-declare function setScrollSize(world: World, eid: Entity, width: number, height: number): Entity;
-/**
- * Sets the scrollbar visibility mode.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param visibility - Scrollbar visibility mode
- * @returns The entity ID for chaining
- */
-declare function setScrollbarVisibility(world: World, eid: Entity, visibility: ScrollbarVisibility): Entity;
-/**
- * Scrolls an entity to the top.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns The entity ID for chaining
- */
-declare function scrollToTop$1(world: World, eid: Entity): Entity;
-/**
- * Scrolls an entity to the bottom.
- * Takes viewport height into account: scrollY = scrollHeight - viewportHeight.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns The entity ID for chaining
- */
-declare function scrollToBottom$1(world: World, eid: Entity): Entity;
-/**
- * Checks if an entity can scroll (has content larger than visible area).
- * If viewport is set, checks if content exceeds viewport size.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns true if entity has scrollable content
- */
-declare function canScroll(world: World, eid: Entity): boolean;
-/**
- * Checks if an entity is scrolled to the top.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns true if scrolled to top
- */
-declare function isAtTop(world: World, eid: Entity): boolean;
-/**
- * Checks if an entity is scrolled to the bottom.
- * Takes viewport height into account: true when scrollY >= scrollHeight - viewportHeight.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns true if scrolled to bottom
- */
-declare function isAtBottom(world: World, eid: Entity): boolean;
-
-/**
- * Table Component
- *
- * Provides table/grid data management functionality with cell-based data storage.
- *
- * @module components/table
- */
-
-/**
- * Table cell alignment.
- */
-type CellAlign = 'left' | 'center' | 'right';
-/**
- * Table cell data.
- */
-interface TableCell {
-    /** Cell text value */
-    readonly value: string;
-    /** Cell foreground color (optional) */
-    readonly fg?: number;
-    /** Cell background color (optional) */
-    readonly bg?: number;
-    /** Cell alignment (optional, defaults to left) */
-    readonly align?: CellAlign;
-}
-/**
- * Table row data.
- */
-type TableRow = readonly TableCell[];
-/**
- * Table data (array of rows).
- */
-type TableData = readonly TableRow[];
-/**
- * Table column configuration.
- */
-interface TableColumn {
-    /** Column header text */
-    readonly header: string;
-    /** Column width (characters) */
-    readonly width?: number | undefined;
-    /** Column minimum width */
-    readonly minWidth?: number | undefined;
-    /** Column maximum width */
-    readonly maxWidth?: number | undefined;
-    /** Column alignment */
-    readonly align?: CellAlign | undefined;
-}
-/**
- * Table store for managing table-specific data.
- */
-interface TableStore {
-    /** Whether entity is a table */
-    isTable: Uint8Array;
-    /** Number of rows in table */
-    rowCount: Uint32Array;
-    /** Number of columns in table */
-    colCount: Uint16Array;
-    /** Number of header rows */
-    headerRows: Uint8Array;
-    /** Cell padding */
-    pad: Uint8Array;
-    /** Whether to show cell borders */
-    cellBorders: Uint8Array;
-}
-/**
- * Table display configuration.
- */
-interface TableDisplay {
-    /** Header foreground color */
-    readonly headerFg: number;
-    /** Header background color */
-    readonly headerBg: number;
-    /** Cell foreground color */
-    readonly cellFg: number;
-    /** Cell background color */
-    readonly cellBg: number;
-    /** Alternate row background color (for striping) */
-    readonly altRowBg?: number;
-    /** Border foreground color */
-    readonly borderFg: number;
-    /** Border background color */
-    readonly borderBg: number;
-    /** Selected row foreground color */
-    readonly selectedFg?: number;
-    /** Selected row background color */
-    readonly selectedBg?: number;
-}
-/**
- * Table display options for configuration.
- */
-interface TableDisplayOptions {
-    headerFg?: number;
-    headerBg?: number;
-    cellFg?: number;
-    cellBg?: number;
-    altRowBg?: number;
-    borderFg?: number;
-    borderBg?: number;
-    selectedFg?: number;
-    selectedBg?: number;
-}
-/** Default header foreground color */
-declare const DEFAULT_HEADER_FG = 4294967295;
-/** Default header background color */
-declare const DEFAULT_HEADER_BG = 858993663;
-/** Default cell foreground color */
-declare const DEFAULT_CELL_FG = 3435973887;
-/** Default cell background color */
-declare const DEFAULT_CELL_BG = 255;
-/** Default border foreground color */
-declare const DEFAULT_BORDER_FG = 1717987071;
-/** Default border background color */
-declare const DEFAULT_BORDER_BG = 255;
-/**
- * Table component store using SoA (Structure of Arrays) for performance.
- *
- * Stores table grid metadata.
- *
- * @example
- * ```typescript
- * import { Table, attachTableBehavior, setData } from 'blecsd';
- *
- * attachTableBehavior(world, eid);
- * setData(world, eid, [
- *   ['Name', 'Age'],
- *   ['Alice', '30'],
- * ]);
- * ```
- */
-declare const Table: {
-    /** Number of data rows (excluding headers) */
-    rowCount: Uint32Array<ArrayBuffer>;
-    /** Number of columns */
-    colCount: Uint16Array<ArrayBuffer>;
-    /** Number of header rows */
-    headerRows: Uint8Array<ArrayBuffer>;
-    /** Cell padding (spaces) */
-    pad: Uint8Array<ArrayBuffer>;
-    /** Whether to render cell borders (0 = no, 1 = yes) */
-    cellBorders: Uint8Array<ArrayBuffer>;
-};
-/**
- * Store for table component data.
- */
-declare const tableStore: TableStore;
-/**
- * Attaches table behavior to an entity.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param options - Table options
- *
- * @example
- * ```typescript
- * import { attachTableBehavior } from 'blecsd';
- *
- * attachTableBehavior(world, eid, {
- *   headerRows: 1,
- *   pad: 1,
- *   cellBorders: true,
- * });
- * ```
- */
-declare function attachTableBehavior(_world: World, eid: Entity, options?: {
-    headerRows?: number;
-    pad?: number;
-    cellBorders?: boolean;
-}): void;
-/**
- * Checks if an entity is a table.
- *
- * @param _world - The ECS world (unused, kept for API consistency)
- * @param eid - The entity ID
- * @returns true if entity is a table
- */
-declare function isTable(_world: World, eid: Entity): boolean;
-/**
- * Detaches table behavior from an entity.
- *
- * @param _world - The ECS world
- * @param eid - The entity ID
- */
-declare function detachTableBehavior(_world: World, eid: Entity): void;
-/**
- * Sets the table data.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param rows - Array of row arrays (string[][] or TableCell[][])
- *
- * @example
- * ```typescript
- * // With string arrays
- * setData(world, eid, [
- *   ['Name', 'Age', 'City'],
- *   ['Alice', '30', 'NYC'],
- *   ['Bob', '25', 'LA'],
- * ]);
- *
- * // With TableCell objects
- * setData(world, eid, [
- *   [{ value: 'Name', fg: 0xffffffff }, { value: 'Age' }, { value: 'City' }],
- *   [{ value: 'Alice' }, { value: '30' }, { value: 'NYC' }],
- * ]);
- * ```
- */
-declare function setData(world: World, eid: Entity, rows: ReadonlyArray<ReadonlyArray<string | TableCell>>): void;
-/**
- * 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(_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(_world: World, eid: Entity): string[][];
-/**
- * Sets a single cell value.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param row - Row index (0-based)
- * @param col - Column index (0-based)
- * @param value - Cell value (string or TableCell)
- * @returns true if cell was set successfully
- *
- * @example
- * ```typescript
- * setCell(world, eid, 1, 2, 'Updated value');
- * setCell(world, eid, 1, 2, { value: 'Styled', fg: 0xff0000ff });
- * ```
- */
-declare function setCell(world: World, eid: Entity, row: number, col: number, value: string | TableCell): boolean;
-/**
- * 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(_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(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(_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(_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(_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(_world: World, eid: Entity): number;
-/**
- * Appends a row to the table.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param row - Row data
- */
-declare function appendRow(world: World, eid: Entity, row: ReadonlyArray<string | TableCell>): void;
-/**
- * Inserts a row at a specific index.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param index - Row index to insert at
- * @param row - Row data
- */
-declare function insertRow(world: World, eid: Entity, index: number, row: ReadonlyArray<string | TableCell>): void;
-/**
- * Removes a row from the table.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param index - Row index to remove
- * @returns The removed row or undefined
- */
-declare function removeRow(world: World, eid: Entity, index: number): TableRow | undefined;
-/**
- * Clears all table data.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- */
-declare function clearData(world: World, eid: Entity): void;
-/**
- * Sets table headers using column configuration.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param columns - Column configuration
- *
- * @example
- * ```typescript
- * setHeaders(world, eid, [
- *   { header: 'Name', width: 20, align: 'left' },
- *   { header: 'Age', width: 5, align: 'right' },
- *   { header: 'City', width: 15, align: 'left' },
- * ]);
- * ```
- */
-declare function setHeaders(world: World, eid: Entity, columns: readonly TableColumn[]): void;
-/**
- * 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(_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(_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(_world: World, eid: Entity): readonly TableRow[];
-/**
- * Sets the number of header rows.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param count - Number of header rows (0-255)
- */
-declare function setHeaderRowCount(world: World, eid: Entity, count: number): void;
-/**
- * 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(_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(_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(_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(_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(_world: World, eid: Entity): number;
-/**
- * Sets the cell padding.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param padding - Cell padding (0-255)
- */
-declare function setCellPadding(world: World, eid: Entity, padding: number): void;
-/**
- * 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(_world: World, eid: Entity): boolean;
-/**
- * Sets whether cell borders are enabled.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param enabled - Whether to show cell borders
- */
-declare function setCellBorders(world: World, eid: Entity, enabled: boolean): void;
-/**
- * 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.
- */
-declare function resetTableStore(): void;
-
-/**
- * TerminalBuffer Component
- *
- * ECS component for terminal emulator buffers. Stores a 2D grid of cells
- * with per-cell styling, cursor state, and scrollback history.
- *
- * @module components/terminalBuffer
- *
- * @example
- * ```typescript
- * import { createWorld, addEntity } from 'blecsd';
- * import {
- *   setTerminalBuffer,
- *   writeToTerminal,
- *   getTerminalState,
- *   clearTerminal,
- * } from 'blecsd/components';
- *
- * const world = createWorld();
- * const eid = addEntity(world);
- *
- * // Initialize a terminal buffer
- * setTerminalBuffer(world, eid, { width: 80, height: 24 });
- *
- * // Write ANSI content
- * writeToTerminal(world, eid, '\x1b[31mHello\x1b[0m World');
- *
- * // Get current state
- * const state = getTerminalState(eid);
- * console.log(state?.cursorX, state?.cursorY);
- *
- * // Clear the terminal
- * clearTerminal(world, eid);
- * ```
- */
-
-/** Default terminal width in columns */
-declare const DEFAULT_TERMINAL_WIDTH = 80;
-/** Default terminal height in rows */
-declare const DEFAULT_TERMINAL_HEIGHT = 24;
-/** Default scrollback lines */
-declare const DEFAULT_SCROLLBACK_LINES = 1000;
-/**
- * TerminalBuffer component for scalar state.
- * Complex state (cells, scrollback, parser state) is stored in a Map.
- */
-declare const TerminalBuffer: {
-    /** Tag indicating this is a terminal buffer (1 = yes) */
-    isTerminal: Uint8Array<ArrayBuffer>;
-    /** Terminal width in columns */
-    width: Uint16Array<ArrayBuffer>;
-    /** Terminal height in rows */
-    height: Uint16Array<ArrayBuffer>;
-    /** Cursor X position (column) */
-    cursorX: Uint16Array<ArrayBuffer>;
-    /** Cursor Y position (row) */
-    cursorY: Uint16Array<ArrayBuffer>;
-    /** Cursor visible flag (1 = visible) */
-    cursorVisible: Uint8Array<ArrayBuffer>;
-    /** Scroll offset from top (for viewing history) */
-    scrollOffset: Uint32Array<ArrayBuffer>;
-    /** Alternate screen buffer active (1 = yes) */
-    altScreenActive: Uint8Array<ArrayBuffer>;
-};
-/**
- * Terminal state stored in a Map for complex data.
- */
-interface TerminalState {
-    /** Cell buffer (2D grid in row-major order) */
-    readonly buffer: ScreenBufferData;
-    /** Scrollback history */
-    readonly scrollback: ScrollbackBuffer;
-    /** Current text attributes for new characters */
-    currentAttr: Attribute;
-    /** Partial escape sequence buffer */
-    escapeBuffer: string;
-    /** Whether we're in the middle of parsing an escape sequence */
-    inEscape: boolean;
-    /** Saved cursor position X */
-    savedCursorX: number;
-    /** Saved cursor position Y */
-    savedCursorY: number;
-    /** Saved attributes */
-    savedAttr: Attribute;
-    /** Alternate screen buffer (for full-screen apps) */
-    altBuffer: ScreenBufferData | null;
-    /** Cursor shape: 'block' | 'underline' | 'bar' */
-    cursorShape: CursorShape;
-    /** Cursor blink enabled */
-    cursorBlink: boolean;
-}
-/**
- * Cursor shape types.
- */
-type CursorShape = 'block' | 'underline' | 'bar';
-/**
- * Terminal buffer configuration schema.
- */
-declare const TerminalBufferConfigSchema: z.ZodObject<{
-    width: z.ZodDefault<z.ZodNumber>;
-    height: z.ZodDefault<z.ZodNumber>;
-    scrollbackLines: z.ZodDefault<z.ZodNumber>;
-    cursorVisible: z.ZodDefault<z.ZodBoolean>;
-    cursorShape: z.ZodDefault<z.ZodEnum<{
-        underline: "underline";
-        block: "block";
-        bar: "bar";
-    }>>;
-    cursorBlink: z.ZodDefault<z.ZodBoolean>;
-}, z.core.$strip>;
-/**
- * Terminal buffer configuration type.
- */
-type TerminalBufferConfig = z.input<typeof TerminalBufferConfigSchema>;
-/**
- * Sets up a terminal buffer on an entity.
- *
- * @param world - The ECS world
- * @param eid - Entity ID
- * @param config - Terminal buffer configuration
- *
- * @example
- * ```typescript
- * setTerminalBuffer(world, eid, {
- *   width: 80,
- *   height: 24,
- *   scrollbackLines: 1000,
- * });
- * ```
- */
-declare function setTerminalBuffer(world: World, eid: Entity, config?: TerminalBufferConfig): void;
-/**
- * Checks if an entity has a terminal buffer.
- *
- * @param eid - Entity ID
- * @returns true if the entity has a terminal buffer
- */
-declare function hasTerminalBuffer(eid: Entity): boolean;
-/**
- * Gets the terminal state for an entity.
- *
- * @param eid - Entity ID
- * @returns Terminal state or undefined
- */
-declare function getTerminalState(eid: Entity): TerminalState | undefined;
-/**
- * Gets terminal buffer data (scalar values).
- *
- * @param eid - Entity ID
- * @returns Terminal buffer data
- */
-declare function getTerminalBuffer(eid: Entity): {
-    width: number;
-    height: number;
-    cursorX: number;
-    cursorY: number;
-    cursorVisible: boolean;
-    scrollOffset: number;
-} | undefined;
-/**
- * Writes a character to the terminal at the current cursor position.
- *
- * @param world - The ECS world
- * @param eid - Entity ID
- * @param char - Character to write
- */
-declare function writeChar(world: World, eid: Entity, char: string): void;
-/**
- * Writes a string to the terminal (processes escape sequences).
- *
- * @param world - The ECS world
- * @param eid - Entity ID
- * @param data - String to write
- */
-declare function writeToTerminal(world: World, eid: Entity, data: string): void;
-/**
- * Clears the terminal buffer.
- *
- * @param world - The ECS world
- * @param eid - Entity ID
- */
-declare function clearTerminal(world: World, eid: Entity): void;
-/**
- * Resets the terminal to initial state.
- *
- * @param world - The ECS world
- * @param eid - Entity ID
- */
-declare function resetTerminal(world: World, eid: Entity): void;
-/**
- * Sets cursor position.
- *
- * @param world - The ECS world
- * @param eid - Entity ID
- * @param x - Column (0-indexed)
- * @param y - Row (0-indexed)
- */
-declare function setCursorPosition(world: World, eid: Entity, x: number, y: number): void;
-/**
- * Sets cursor visibility.
- *
- * @param world - The ECS world
- * @param eid - Entity ID
- * @param visible - Cursor visibility
- */
-declare function setCursorVisible(world: World, eid: Entity, visible: boolean): void;
-/**
- * Scrolls the terminal view up.
- *
- * @param world - The ECS world
- * @param eid - Entity ID
- * @param lines - Number of lines to scroll
- */
-declare function scrollTerminalUp(world: World, eid: Entity, lines: number): void;
-/**
- * Scrolls the terminal view down.
- *
- * @param world - The ECS world
- * @param eid - Entity ID
- * @param lines - Number of lines to scroll
- */
-declare function scrollTerminalDown(world: World, eid: Entity, lines: number): void;
-/**
- * Scrolls to the top of history.
- *
- * @param world - The ECS world
- * @param eid - Entity ID
- */
-declare function scrollTerminalToTop(world: World, eid: Entity): void;
-/**
- * Scrolls to the bottom (current view).
- *
- * @param world - The ECS world
- * @param eid - Entity ID
- */
-declare function scrollTerminalToBottom(world: World, eid: Entity): void;
-/**
- * Resizes the terminal buffer.
- *
- * @param world - The ECS world
- * @param eid - Entity ID
- * @param width - New width in columns
- * @param height - New height in rows
- */
-declare function resizeTerminalBuffer(world: World, eid: Entity, width: number, height: number): void;
-/**
- * Removes a terminal buffer from an entity.
- *
- * @param eid - Entity ID
- */
-declare function removeTerminalBuffer(eid: Entity): void;
-/**
- * Renders terminal buffer to an ANSI string (for display).
- *
- * @param eid - Entity ID
- * @returns ANSI string representation of the terminal
- */
-declare function renderTerminalToAnsi(eid: Entity): string;
-/**
- * Gets the cells for rendering.
- *
- * @param eid - Entity ID
- * @returns Readonly array of cells
- */
-declare function getTerminalCells(eid: Entity): readonly Cell[] | undefined;
-/**
- * Resets the terminal buffer store (for testing).
- * @internal
- */
-declare function resetTerminalBufferStore(): void;
-
-/**
- * VirtualViewport Component for Viewport Windowing
- *
- * ECS component that tracks which portion of a large dataset is currently visible.
- * Works with VirtualizedLineStore for text, or any other indexed content.
- *
- * @module components/virtualViewport
- *
- * @example
- * ```typescript
- * import { createWorld, addEntity } from '../core/ecs';
- * import { setVirtualViewport, scrollToLine, getVisibleRange } from 'blecsd';
- *
- * const world = createWorld();
- * const entity = addEntity(world);
- *
- * // Configure viewport for a list with 1000 items
- * setVirtualViewport(world, entity, {
- *   totalLineCount: 1000,
- *   visibleLineCount: 25,
- *   overscanBefore: 5,
- *   overscanAfter: 5,
- * });
- *
- * // Scroll to line 500
- * scrollToLine(world, entity, 500);
- *
- * // Get visible range (includes overscan)
- * const range = getVisibleRange(world, entity);
- * // range = { start: 495, end: 530 }
- * ```
- */
-
-/**
- * Schema for VirtualViewport configuration options.
- *
- * @example
- * ```typescript
- * import { VirtualViewportOptionsSchema } from 'blecsd';
- *
- * const options = VirtualViewportOptionsSchema.parse({
- *   totalLineCount: 10000,
- *   visibleLineCount: 25,
- *   overscanBefore: 5,
- * });
- * ```
- */
-declare const VirtualViewportOptionsSchema: z.ZodObject<{
-    firstVisibleLine: z.ZodOptional<z.ZodNumber>;
-    visibleLineCount: z.ZodOptional<z.ZodNumber>;
-    totalLineCount: z.ZodOptional<z.ZodNumber>;
-    overscanBefore: z.ZodOptional<z.ZodNumber>;
-    overscanAfter: z.ZodOptional<z.ZodNumber>;
-    estimatedLineHeight: z.ZodOptional<z.ZodNumber>;
-    isVariableHeight: z.ZodOptional<z.ZodBoolean>;
-    selectedLine: z.ZodOptional<z.ZodNumber>;
-    cursorLine: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
-/**
- * Schema for visible range output.
- */
-declare const VisibleRangeSchema: z.ZodObject<{
-    start: z.ZodNumber;
-    end: z.ZodNumber;
-    visibleStart: z.ZodNumber;
-    visibleEnd: z.ZodNumber;
-    count: z.ZodNumber;
-}, z.core.$strip>;
-/**
- * Schema for scroll info output.
- */
-declare const ScrollInfoSchema: z.ZodObject<{
-    currentLine: z.ZodNumber;
-    totalLines: z.ZodNumber;
-    viewportSize: z.ZodNumber;
-    maxScrollLine: z.ZodNumber;
-    scrollPercent: z.ZodNumber;
-    atTop: z.ZodBoolean;
-    atBottom: z.ZodBoolean;
-}, z.core.$strip>;
-/**
- * VirtualViewport component store using SoA (Structure of Arrays).
- *
- * Tracks viewport windowing for virtualized content rendering.
- * Only the visible portion (plus overscan) should be rendered.
- */
-declare const VirtualViewport: {
-    /** First visible line index in the viewport */
-    firstVisibleLine: Uint32Array<ArrayBuffer>;
-    /** Number of lines visible in the viewport */
-    visibleLineCount: Uint32Array<ArrayBuffer>;
-    /** Total number of lines in the content */
-    totalLineCount: Uint32Array<ArrayBuffer>;
-    /** Extra lines to render above viewport for smooth scrolling */
-    overscanBefore: Uint8Array<ArrayBuffer>;
-    /** Extra lines to render below viewport for smooth scrolling */
-    overscanAfter: Uint8Array<ArrayBuffer>;
-    /** Estimated height of each line in rows (for variable height estimation) */
-    estimatedLineHeight: Uint8Array<ArrayBuffer>;
-    /** Whether lines have variable height (0=fixed, 1=variable) */
-    isVariableHeight: Uint8Array<ArrayBuffer>;
-    /** Whether viewport needs re-render (dirty flag) */
-    isDirty: Uint8Array<ArrayBuffer>;
-    /** Selected line index (-1 = none) using Int32 to allow -1 */
-    selectedLine: Int32Array<ArrayBuffer>;
-    /** Cursor line for interactive lists (-1 = none) */
-    cursorLine: Int32Array<ArrayBuffer>;
-};
-/**
- * Configuration options for VirtualViewport.
- */
-interface VirtualViewportOptions {
-    /** First visible line index */
-    firstVisibleLine?: number;
-    /** Number of visible lines */
-    visibleLineCount?: number;
-    /** Total line count in content */
-    totalLineCount?: number;
-    /** Overscan lines before viewport */
-    overscanBefore?: number;
-    /** Overscan lines after viewport */
-    overscanAfter?: number;
-    /** Estimated line height (for variable height) */
-    estimatedLineHeight?: number;
-    /** Whether lines have variable height */
-    isVariableHeight?: boolean;
-    /** Selected line index */
-    selectedLine?: number;
-    /** Cursor line index */
-    cursorLine?: number;
-}
-/**
- * Visible range including overscan.
- */
-interface VisibleRange {
-    /** Start line index (with overscan) */
-    readonly start: number;
-    /** End line index (exclusive, with overscan) */
-    readonly end: number;
-    /** First actually visible line (without overscan) */
-    readonly visibleStart: number;
-    /** Last actually visible line (exclusive, without overscan) */
-    readonly visibleEnd: number;
-    /** Total lines in range */
-    readonly count: number;
-}
-/**
- * Full viewport data.
- */
-interface VirtualViewportData {
-    readonly firstVisibleLine: number;
-    readonly visibleLineCount: number;
-    readonly totalLineCount: number;
-    readonly overscanBefore: number;
-    readonly overscanAfter: number;
-    readonly estimatedLineHeight: number;
-    readonly isVariableHeight: boolean;
-    readonly isDirty: boolean;
-    readonly selectedLine: number;
-    readonly cursorLine: number;
-}
-/**
- * Scroll position info.
- */
-interface ScrollInfo {
-    /** Current line */
-    readonly currentLine: number;
-    /** Total lines */
-    readonly totalLines: number;
-    /** Viewport size */
-    readonly viewportSize: number;
-    /** Maximum scrollable line */
-    readonly maxScrollLine: number;
-    /** Scroll percentage (0-100) */
-    readonly scrollPercent: number;
-    /** Whether at top */
-    readonly atTop: boolean;
-    /** Whether at bottom */
-    readonly atBottom: boolean;
-}
-/**
- * Sets up a VirtualViewport on an entity.
- * Input is validated against VirtualViewportOptionsSchema.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param options - Viewport configuration
- * @returns The entity ID for chaining
- * @throws {z.ZodError} If options are invalid
- *
- * @example
- * ```typescript
- * setVirtualViewport(world, entity, {
- *   totalLineCount: 10000,
- *   visibleLineCount: 25,
- * });
- * ```
- */
-declare function setVirtualViewport(world: World, eid: Entity, options: VirtualViewportOptions): Entity;
-/**
- * Gets VirtualViewport data for an entity.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns Viewport data or undefined if no component
- */
-declare function getVirtualViewport(world: World, eid: Entity): VirtualViewportData | undefined;
-/**
- * Checks if entity has VirtualViewport.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns true if has component
- */
-declare function hasVirtualViewport(world: World, eid: Entity): boolean;
-/**
- * Sets the first visible line (viewport start).
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param lineIndex - Line index to scroll to
- * @returns The entity ID for chaining
- */
-declare function setViewportStart(world: World, eid: Entity, lineIndex: number): Entity;
-/**
- * Gets the visible range including overscan.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns Visible range or undefined if no component
- *
- * @example
- * ```typescript
- * const range = getVisibleRange(world, entity);
- * // Render lines from range.start to range.end
- * const lines = getLineRange(store, range.start, range.end);
- * ```
- */
-declare function getVisibleRange(world: World, eid: Entity): VisibleRange | undefined;
-/**
- * Checks if a line is currently visible (in viewport, not just overscan).
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param lineIndex - Line index to check
- * @returns true if line is visible
- */
-declare function isLineVisible(world: World, eid: Entity, lineIndex: number): boolean;
-/**
- * Checks if a line is in the render range (visible + overscan).
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param lineIndex - Line index to check
- * @returns true if line should be rendered
- */
-declare function isLineInRenderRange(world: World, eid: Entity, lineIndex: number): boolean;
-/**
- * Scrolls to a specific line, centering it if possible.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param lineIndex - Target line index
- * @returns The entity ID for chaining
- */
-declare function scrollToLine(world: World, eid: Entity, lineIndex: number): Entity;
-/**
- * Scrolls by a number of lines.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param delta - Lines to scroll (positive = down, negative = up)
- * @returns The entity ID for chaining
- */
-declare function scrollByLines(world: World, eid: Entity, delta: number): Entity;
-/**
- * Scrolls by pages.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param pages - Pages to scroll (positive = down, negative = up)
- * @returns The entity ID for chaining
- */
-declare function scrollByPages(world: World, eid: Entity, pages: number): Entity;
-/**
- * Scrolls to the top.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns The entity ID for chaining
- */
-declare function scrollToTop(world: World, eid: Entity): Entity;
-/**
- * Scrolls to the bottom.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns The entity ID for chaining
- */
-declare function scrollToBottom(world: World, eid: Entity): Entity;
-/**
- * Gets scroll information.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns Scroll info or undefined if no component
- */
-declare function getScrollInfo(world: World, eid: Entity): ScrollInfo | undefined;
-/**
- * Updates the total line count (when content changes).
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param totalLines - New total line count
- * @returns The entity ID for chaining
- */
-declare function setTotalLineCount(world: World, eid: Entity, totalLines: number): Entity;
-/**
- * Updates the viewport size (when container resizes).
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param visibleLines - New visible line count
- * @returns The entity ID for chaining
- */
-declare function setVisibleLineCount(world: World, eid: Entity, visibleLines: number): Entity;
-/**
- * Sets overscan values.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param before - Lines to render before viewport
- * @param after - Lines to render after viewport
- * @returns The entity ID for chaining
- */
-declare function setOverscan(world: World, eid: Entity, before: number, after: number): Entity;
-/**
- * Sets the selected line.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param lineIndex - Selected line (-1 for none)
- * @returns The entity ID for chaining
- */
-declare function setSelectedLine(world: World, eid: Entity, lineIndex: number): Entity;
-/**
- * Gets the selected line.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns Selected line index or -1 if none
- */
-declare function getSelectedLine(world: World, eid: Entity): number;
-/**
- * Sets the cursor line (for keyboard navigation).
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param lineIndex - Cursor line (-1 for none)
- * @returns The entity ID for chaining
- */
-declare function setCursorLine(world: World, eid: Entity, lineIndex: number): Entity;
-/**
- * Gets the cursor line.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns Cursor line index or -1 if none
- */
-declare function getCursorLine(world: World, eid: Entity): number;
-/**
- * Moves cursor up/down and auto-scrolls to keep it visible.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @param delta - Lines to move (negative = up, positive = down)
- * @returns The entity ID for chaining
- */
-declare function moveCursor(world: World, eid: Entity, delta: number): Entity;
-/**
- * Ensures the cursor is visible, scrolling if needed.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns The entity ID for chaining
- */
-declare function ensureCursorVisible(world: World, eid: Entity): Entity;
-/**
- * Checks if viewport needs re-render.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns true if dirty
- */
-declare function isViewportDirty(world: World, eid: Entity): boolean;
-/**
- * Clears the dirty flag after rendering.
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns The entity ID for chaining
- */
-declare function clearViewportDirty(world: World, eid: Entity): Entity;
-/**
- * Forces viewport to be dirty (triggers re-render).
- *
- * @param world - The ECS world
- * @param eid - The entity ID
- * @returns The entity ID for chaining
- */
-declare function invalidateViewport(world: World, eid: Entity): Entity;
-
-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 };