tuiuiu.js 0.1.1

package/dist/core/layout.js

@@ -0,0 +1,347 @@
+/**
+ * Reck Layout Engine - Simplified flexbox for terminals
+ *
+ * ~300 lines of TypeScript handling 90% of terminal UI needs
+ */
+import { stringWidth } from '../utils/text-utils.js';
+/**
+ * Text measurement cache
+ * Caches text dimensions to avoid recalculating for the same text
+ */
+const textMeasureCache = new Map();
+const TEXT_CACHE_MAX_SIZE = 1000;
+/**
+ * Clear the text measurement cache
+ * Call this when you want to free memory or reset measurements
+ */
+export function clearTextMeasureCache() {
+    textMeasureCache.clear();
+}
+/**
+ * Calculate layout for a VNode tree
+ */
+export function calculateLayout(node, availableWidth, availableHeight = Infinity) {
+    return layoutNode(node, { x: 0, y: 0, width: availableWidth, height: availableHeight });
+}
+/**
+ * Layout a single node and its children
+ */
+function layoutNode(node, ctx) {
+    const style = node.props;
+    // Handle display: 'none' - return zero-sized layout
+    if (style.display === 'none') {
+        return {
+            x: ctx.x,
+            y: ctx.y,
+            width: 0,
+            height: 0,
+            node,
+            children: [],
+        };
+    }
+    // Calculate padding
+    const paddingTop = style.paddingTop ?? style.paddingY ?? style.padding ?? 0;
+    const paddingBottom = style.paddingBottom ?? style.paddingY ?? style.padding ?? 0;
+    const paddingLeft = style.paddingLeft ?? style.paddingX ?? style.padding ?? 0;
+    const paddingRight = style.paddingRight ?? style.paddingX ?? style.padding ?? 0;
+    // Calculate margin (handle 'auto' as 0 for now, centering would need parent context)
+    const resolveMargin = (m) => m === 'auto' ? 0 : (m ?? 0);
+    const marginTop = resolveMargin(style.marginTop) ?? resolveMargin(style.marginY) ?? resolveMargin(style.margin);
+    const marginBottom = resolveMargin(style.marginBottom) ?? resolveMargin(style.marginY) ?? resolveMargin(style.margin);
+    const marginLeft = resolveMargin(style.marginLeft) ?? resolveMargin(style.marginX) ?? resolveMargin(style.margin);
+    const marginRight = resolveMargin(style.marginRight) ?? resolveMargin(style.marginX) ?? resolveMargin(style.margin);
+    // Border takes 1 char each side if present
+    const borderSize = style.borderStyle && style.borderStyle !== 'none' ? 1 : 0;
+    // Available space for content (use ctx.width/height when no explicit size set)
+    const explicitWidth = resolveSize(style.width, ctx.width);
+    const explicitHeight = resolveSize(style.height, ctx.height);
+    const contentWidth = (explicitWidth || ctx.width) - paddingLeft - paddingRight - borderSize * 2;
+    const contentHeight = (explicitHeight || ctx.height) - paddingTop - paddingBottom - borderSize * 2;
+    // Layout children
+    const childLayouts = [];
+    const direction = style.flexDirection ?? 'column';
+    const isRow = direction === 'row' || direction === 'row-reverse';
+    const isReverse = direction === 'row-reverse' || direction === 'column-reverse';
+    // Use columnGap/rowGap if specified, otherwise fall back to gap
+    const currentGap = isRow
+        ? (style.columnGap ?? style.gap ?? 0)
+        : (style.rowGap ?? style.gap ?? 0);
+    if (node.type === 'text' || node.type === 'spacer' || node.type === 'newline') {
+        // Leaf nodes - no children to layout
+    }
+    else if (node.children.length > 0) {
+        // Get children, reversing order if needed
+        const orderedChildren = isReverse ? [...node.children].reverse() : node.children;
+        if (isRow) {
+            childLayouts.push(...layoutRow(orderedChildren, contentWidth, contentHeight, currentGap, style));
+        }
+        else {
+            childLayouts.push(...layoutColumn(orderedChildren, contentWidth, contentHeight, currentGap, style));
+        }
+    }
+    // Calculate total content size from children
+    let totalWidth = 0;
+    let totalHeight = 0;
+    if (isRow) {
+        for (const child of childLayouts) {
+            totalWidth += child.width;
+            totalHeight = Math.max(totalHeight, child.height);
+        }
+        totalWidth += currentGap * Math.max(0, childLayouts.length - 1);
+    }
+    else {
+        for (const child of childLayouts) {
+            totalWidth = Math.max(totalWidth, child.width);
+            totalHeight += child.height;
+        }
+        totalHeight += currentGap * Math.max(0, childLayouts.length - 1);
+    }
+    // Handle text node sizing
+    if (node.type === 'text') {
+        const text = String(node.props.children ?? '');
+        const lines = text.split('\n');
+        totalWidth = Math.max(...lines.map(l => stringWidth(l)));
+        totalHeight = lines.length;
+    }
+    // Handle spacer - takes all available space
+    if (node.type === 'spacer') {
+        totalWidth = ctx.width;
+        totalHeight = 1;
+    }
+    // Handle newline
+    if (node.type === 'newline') {
+        totalWidth = 0;
+        totalHeight = node.props.count ?? 1;
+    }
+    // Check if element should fill available space
+    const flexGrow = style.flexGrow ?? 0;
+    const shouldFillWidth = flexGrow > 0;
+    // Final size
+    // If flexGrow > 0, use context width (fill available space)
+    // Otherwise, use content width
+    const contentBasedWidth = totalWidth + paddingLeft + paddingRight + borderSize * 2;
+    const width = explicitWidth || (shouldFillWidth ? ctx.width : contentBasedWidth);
+    const height = explicitHeight || (totalHeight + paddingTop + paddingBottom + borderSize * 2);
+    return {
+        x: ctx.x + marginLeft,
+        y: ctx.y + marginTop,
+        width: Math.min(width, ctx.width - marginLeft - marginRight),
+        height: Math.min(height, ctx.height - marginTop - marginBottom),
+        node,
+        children: childLayouts,
+    };
+}
+/**
+ * Layout children in a row (horizontal)
+ */
+function layoutRow(children, width, height, gap, parentStyle) {
+    const results = [];
+    // First pass: calculate fixed sizes and count flexible children
+    let fixedWidth = 0;
+    let flexTotal = 0;
+    const childInfos = [];
+    for (const child of children) {
+        const style = child.props;
+        const flex = style.flexGrow ?? (child.type === 'spacer' ? 1 : 0);
+        const minWidth = style.minWidth ?? 0;
+        if (flex > 0) {
+            flexTotal += flex;
+            childInfos.push({ node: child, flex, minWidth });
+        }
+        else {
+            // Fixed width child - layout to get its natural size
+            const layout = layoutNode(child, { x: 0, y: 0, width, height });
+            fixedWidth += layout.width;
+            childInfos.push({ node: child, flex: 0, minWidth: layout.width });
+        }
+    }
+    // Add gaps to fixed width
+    fixedWidth += gap * Math.max(0, children.length - 1);
+    // Calculate flexible space
+    const flexSpace = Math.max(0, width - fixedWidth);
+    const flexUnit = flexTotal > 0 ? flexSpace / flexTotal : 0;
+    // Second pass: layout with final sizes
+    let x = 0;
+    const justifyContent = parentStyle.justifyContent ?? 'flex-start';
+    const usedWidth = fixedWidth + (flexTotal > 0 ? flexSpace : 0);
+    const remainingSpace = width - usedWidth;
+    // Calculate spacing for space-between, space-around, space-evenly
+    let spaceBetween = 0;
+    let spaceAround = 0;
+    if (flexTotal === 0 && childInfos.length > 0) {
+        if (justifyContent === 'space-between' && childInfos.length > 1) {
+            spaceBetween = remainingSpace / (childInfos.length - 1);
+        }
+        else if (justifyContent === 'space-around') {
+            spaceAround = remainingSpace / (childInfos.length * 2);
+            x = spaceAround;
+        }
+        else if (justifyContent === 'space-evenly') {
+            spaceBetween = remainingSpace / (childInfos.length + 1);
+            x = spaceBetween;
+        }
+        else if (justifyContent === 'flex-end') {
+            x = remainingSpace;
+        }
+        else if (justifyContent === 'center') {
+            x = remainingSpace / 2;
+        }
+    }
+    for (let i = 0; i < childInfos.length; i++) {
+        const info = childInfos[i];
+        const childWidth = info.flex > 0 ? Math.floor(flexUnit * info.flex) : info.minWidth;
+        const layout = layoutNode(info.node, { x, y: 0, width: childWidth, height });
+        // Adjust y based on alignItems (or alignSelf if set on child)
+        const childStyle = info.node.props;
+        const alignSelf = childStyle.alignSelf;
+        const alignItems = alignSelf !== 'auto' && alignSelf ? alignSelf : (parentStyle.alignItems ?? 'flex-start');
+        if (alignItems === 'center') {
+            layout.y = Math.floor((height - layout.height) / 2);
+        }
+        else if (alignItems === 'flex-end') {
+            layout.y = height - layout.height;
+        }
+        else if (alignItems === 'baseline') {
+            // For baseline, align to top (simplified - true baseline needs font metrics)
+            layout.y = 0;
+        }
+        // 'stretch' is default - no adjustment needed
+        results.push(layout);
+        // Calculate next x position
+        x += layout.width;
+        if (justifyContent === 'space-between' && i < childInfos.length - 1) {
+            x += spaceBetween;
+        }
+        else if (justifyContent === 'space-around') {
+            x += spaceAround * 2;
+        }
+        else if (justifyContent === 'space-evenly') {
+            x += spaceBetween;
+        }
+        else {
+            x += gap;
+        }
+    }
+    return results;
+}
+/**
+ * Layout children in a column (vertical)
+ */
+function layoutColumn(children, width, height, gap, parentStyle) {
+    const results = [];
+    let y = 0;
+    // First pass: layout all children normally
+    for (let i = 0; i < children.length; i++) {
+        const child = children[i];
+        const layout = layoutNode(child, { x: 0, y, width, height: height - y });
+        // Adjust x based on alignItems (or alignSelf if set on child)
+        const childStyle = child.props;
+        const alignSelf = childStyle.alignSelf;
+        const alignItems = alignSelf !== 'auto' && alignSelf ? alignSelf : (parentStyle.alignItems ?? 'flex-start');
+        if (alignItems === 'center') {
+            layout.x = Math.floor((width - layout.width) / 2);
+        }
+        else if (alignItems === 'flex-end') {
+            layout.x = width - layout.width;
+        }
+        else if (alignItems === 'stretch') {
+            layout.width = width;
+        }
+        results.push(layout);
+        y += layout.height;
+        if (i < children.length - 1) {
+            y += gap;
+        }
+    }
+    // Calculate total content height
+    const contentHeight = y;
+    const remainingSpace = Math.max(0, height - contentHeight);
+    // Apply justifyContent by offsetting all results
+    const justifyContent = parentStyle.justifyContent ?? 'flex-start';
+    if (remainingSpace > 0 && results.length > 0) {
+        let offset = 0;
+        if (justifyContent === 'flex-end') {
+            offset = remainingSpace;
+        }
+        else if (justifyContent === 'center') {
+            offset = Math.floor(remainingSpace / 2);
+        }
+        else if (justifyContent === 'space-between' && results.length > 1) {
+            const spaceBetween = remainingSpace / (results.length - 1);
+            for (let i = 0; i < results.length; i++) {
+                results[i].y += Math.floor(spaceBetween * i);
+            }
+            return results;
+        }
+        else if (justifyContent === 'space-around') {
+            const spaceAround = remainingSpace / (results.length * 2);
+            for (let i = 0; i < results.length; i++) {
+                results[i].y += Math.floor(spaceAround * (2 * i + 1));
+            }
+            return results;
+        }
+        else if (justifyContent === 'space-evenly') {
+            const spaceEvenly = remainingSpace / (results.length + 1);
+            for (let i = 0; i < results.length; i++) {
+                results[i].y += Math.floor(spaceEvenly * (i + 1));
+            }
+            return results;
+        }
+        // Apply simple offset for flex-end and center
+        if (offset > 0) {
+            for (const layout of results) {
+                layout.y += offset;
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Resolve a size value (number, percentage, or undefined)
+ */
+function resolveSize(size, available) {
+    if (size === undefined)
+        return 0;
+    if (typeof size === 'number')
+        return size;
+    if (size.endsWith('%')) {
+        return Math.floor((parseFloat(size) / 100) * available);
+    }
+    return parseInt(size, 10) || 0;
+}
+/**
+ * Get visible width of text (accounting for ANSI codes and wide chars)
+ */
+export function getVisibleWidth(text) {
+    return stringWidth(text);
+}
+/**
+ * Measure text dimensions (with caching for performance)
+ *
+ * @param text - The text to measure (may contain ANSI codes)
+ * @returns Object with width (max line length) and height (line count)
+ */
+export function measureText(text) {
+    // Check cache first
+    const cached = textMeasureCache.get(text);
+    if (cached) {
+        return cached;
+    }
+    // Calculate dimensions
+    const lines = text.split('\n');
+    const result = {
+        width: Math.max(0, ...lines.map(l => stringWidth(l))),
+        height: lines.length,
+    };
+    // Store in cache (with size limit to prevent memory issues)
+    if (textMeasureCache.size >= TEXT_CACHE_MAX_SIZE) {
+        // Remove oldest entry (first key in Map iteration order)
+        const firstKey = textMeasureCache.keys().next().value;
+        if (firstKey !== undefined) {
+            textMeasureCache.delete(firstKey);
+        }
+    }
+    textMeasureCache.set(text, result);
+    return result;
+}
+//# sourceMappingURL=layout.js.map

package/dist/core/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/core/layout.ts"],"names":[],"mappings":"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"}

package/dist/core/overlay.d.ts

@@ -0,0 +1,318 @@
+/**
+ * Overlay System
+ *
+ * Features:
+ * - Layer stack management with z-index ordering
+ * - Modal dialogs with backdrop
+ * - Toast notifications with auto-dismiss
+ * - Popup menus and dropdowns
+ * - Tooltips with positioning
+ * - Focus trap integration
+ *
+ *
+ */
+/** Overlay layer type */
+export type OverlayType = 'modal' | 'toast' | 'popup' | 'tooltip' | 'menu' | 'custom';
+/** Position for overlays */
+export interface OverlayPosition {
+    x: number;
+    y: number;
+}
+/** Anchor position for relative positioning */
+export type AnchorPosition = 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right' | 'center';
+/** Size constraints */
+export interface OverlaySize {
+    width?: number;
+    height?: number;
+    minWidth?: number;
+    minHeight?: number;
+    maxWidth?: number;
+    maxHeight?: number;
+}
+/** Overlay layer */
+export interface OverlayLayer {
+    /** Unique layer ID */
+    id: string;
+    /** Layer type */
+    type: OverlayType;
+    /** Z-index for stacking order */
+    zIndex: number;
+    /** Position on screen */
+    position: OverlayPosition;
+    /** Size constraints */
+    size: OverlaySize;
+    /** Content to render (callback returning string lines) */
+    content: () => string[];
+    /** Whether layer is visible */
+    visible: boolean;
+    /** Whether to show backdrop */
+    backdrop?: boolean;
+    /** Backdrop opacity (0-1) */
+    backdropOpacity?: number;
+    /** Whether to trap focus */
+    trapFocus?: boolean;
+    /** Auto-dismiss timeout (ms) */
+    autoDismiss?: number;
+    /** Dismiss timer handle */
+    dismissTimer?: ReturnType<typeof setTimeout>;
+    /** Callback when layer is dismissed */
+    onDismiss?: () => void;
+    /** Custom data */
+    data?: unknown;
+}
+/** Modal options */
+export interface ModalOptions {
+    /** Modal ID (auto-generated if not provided) */
+    id?: string;
+    /** Modal title */
+    title?: string;
+    /** Modal content lines */
+    content: string[] | (() => string[]);
+    /** Position (default: center) */
+    position?: 'center' | OverlayPosition;
+    /** Size constraints */
+    size?: OverlaySize;
+    /** Show backdrop (default: true) */
+    backdrop?: boolean;
+    /** Trap focus (default: true) */
+    trapFocus?: boolean;
+    /** Close on backdrop click (default: true) */
+    closeOnBackdrop?: boolean;
+    /** Close on escape key (default: true) */
+    closeOnEscape?: boolean;
+    /** Callback when closed */
+    onClose?: () => void;
+    /** Z-index (default: auto) */
+    zIndex?: number;
+}
+/** Toast options */
+export interface ToastOptions {
+    /** Toast message */
+    message: string;
+    /** Toast type for styling */
+    type?: 'info' | 'success' | 'warning' | 'error';
+    /** Duration in ms (default: 3000) */
+    duration?: number;
+    /** Position (default: bottom-right) */
+    position?: AnchorPosition;
+    /** Toast ID */
+    id?: string;
+    /** Show dismiss button */
+    dismissible?: boolean;
+    /** Callback when dismissed */
+    onDismiss?: () => void;
+}
+/** Popup options */
+export interface PopupOptions {
+    /** Popup ID */
+    id?: string;
+    /** Content lines */
+    content: string[] | (() => string[]);
+    /** Anchor position relative to target */
+    anchor?: AnchorPosition;
+    /** Target position to anchor to */
+    target: OverlayPosition;
+    /** Offset from target */
+    offset?: {
+        x?: number;
+        y?: number;
+    };
+    /** Auto-close when clicking outside */
+    closeOnClickOutside?: boolean;
+    /** Callback when closed */
+    onClose?: () => void;
+}
+/** Tooltip options */
+export interface TooltipOptions {
+    /** Tooltip text */
+    text: string;
+    /** Target position */
+    target: OverlayPosition;
+    /** Preferred position (default: top) */
+    position?: 'top' | 'bottom' | 'left' | 'right';
+    /** Delay before showing (ms) */
+    delay?: number;
+    /** Max width for wrapping */
+    maxWidth?: number;
+}
+/** Menu item */
+export interface MenuItem {
+    /** Item label */
+    label: string;
+    /** Item value (returned on selection) */
+    value?: string;
+    /** Shortcut key display */
+    shortcut?: string;
+    /** Is item disabled */
+    disabled?: boolean;
+    /** Is separator */
+    separator?: boolean;
+    /** Submenu items */
+    submenu?: MenuItem[];
+    /** Icon character */
+    icon?: string;
+}
+/** Menu options */
+export interface MenuOptions {
+    /** Menu items */
+    items: MenuItem[];
+    /** Menu position */
+    position: OverlayPosition;
+    /** Initial selected index */
+    selectedIndex?: number;
+    /** Callback when item selected */
+    onSelect?: (item: MenuItem, index: number) => void;
+    /** Callback when closed */
+    onClose?: () => void;
+    /** Min width */
+    minWidth?: number;
+}
+/**
+ * Reset overlay manager state (for testing)
+ */
+export declare function resetOverlayManager(): void;
+/**
+ * Set terminal size for overlay calculations
+ */
+export declare function setOverlayTerminalSize(width: number, height: number): void;
+/**
+ * Get terminal size
+ */
+export declare function getOverlayTerminalSize(): {
+    width: number;
+    height: number;
+};
+/**
+ * Add overlay layer
+ */
+export declare function addLayer(layer: Omit<OverlayLayer, 'zIndex'> & {
+    zIndex?: number;
+}): OverlayLayer;
+/**
+ * Remove overlay layer
+ */
+export declare function removeLayer(id: string): boolean;
+/**
+ * Get layer by ID
+ */
+export declare function getLayer(id: string): OverlayLayer | undefined;
+/**
+ * Get all layers sorted by z-index (ascending)
+ */
+export declare function getLayers(): OverlayLayer[];
+/**
+ * Get visible layers sorted by z-index
+ */
+export declare function getVisibleLayers(): OverlayLayer[];
+/**
+ * Get topmost layer
+ */
+export declare function getTopLayer(): OverlayLayer | undefined;
+/**
+ * Check if any layer has backdrop
+ */
+export declare function hasBackdrop(): boolean;
+/**
+ * Update layer properties
+ */
+export declare function updateLayer(id: string, updates: Partial<OverlayLayer>): boolean;
+/**
+ * Show layer
+ */
+export declare function showLayer(id: string): boolean;
+/**
+ * Hide layer
+ */
+export declare function hideLayer(id: string): boolean;
+/**
+ * Bring layer to front
+ */
+export declare function bringToFront(id: string): boolean;
+/**
+ * Get layer count
+ */
+export declare function getLayerCount(): number;
+/**
+ * Check if layer exists
+ */
+export declare function hasLayer(id: string): boolean;
+/**
+ * Show modal dialog
+ */
+export declare function showModal(options: ModalOptions): string;
+/**
+ * Close modal
+ */
+export declare function closeModal(id: string): boolean;
+/**
+ * Close topmost modal
+ */
+export declare function closeTopModal(): boolean;
+/**
+ * Show toast notification
+ */
+export declare function showToast(options: ToastOptions): string;
+/**
+ * Dismiss toast
+ */
+export declare function dismissToast(id: string): boolean;
+/**
+ * Dismiss all toasts
+ */
+export declare function dismissAllToasts(): void;
+/**
+ * Show popup
+ */
+export declare function showPopup(options: PopupOptions): string;
+/**
+ * Close popup
+ */
+export declare function closePopup(id: string): boolean;
+/**
+ * Show tooltip
+ */
+export declare function showTooltip(options: TooltipOptions): string;
+/**
+ * Hide tooltip
+ */
+export declare function hideTooltip(): void;
+/**
+ * Show context menu
+ */
+export declare function showMenu(options: MenuOptions): string;
+/**
+ * Close menu
+ */
+export declare function closeMenu(id: string): boolean;
+/**
+ * Update menu selection
+ */
+export declare function updateMenuSelection(id: string, selectedIndex: number): boolean;
+/**
+ * Select menu item
+ */
+export declare function selectMenuItem(id: string): MenuItem | undefined;
+/**
+ * Render all visible overlays onto a buffer
+ * Returns array of { x, y, line } for each overlay line
+ */
+export declare function renderOverlays(): Array<{
+    x: number;
+    y: number;
+    line: string;
+}>;
+/**
+ * Check if point is inside any overlay
+ */
+export declare function isPointInOverlay(x: number, y: number): OverlayLayer | undefined;
+/**
+ * Handle click at position
+ * Returns true if click was handled by an overlay
+ */
+export declare function handleOverlayClick(x: number, y: number): boolean;
+/**
+ * Handle escape key
+ * Returns true if escape was handled
+ */
+export declare function handleOverlayEscape(): boolean;
+//# sourceMappingURL=overlay.d.ts.map