tuiuiu.js 0.1.1

package/dist/organisms/overlay-stack.d.ts.map

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

package/dist/organisms/overlay-stack.js

@@ -0,0 +1,341 @@
+/**
+ * Overlay Stack Manager
+ *
+ * Manages a stack of overlay components (modals, dialogs, menus)
+ * with exclusive focus handling and proper z-ordering.
+ *
+ * Features:
+ * - Push/pop overlay management
+ * - Exclusive focus (only top overlay receives input)
+ * - Named overlays for easy management
+ * - Backdrop/dimming support
+ * - Animation hooks
+ * - Priority levels
+ *
+ * @example
+ * ```typescript
+ * import { createOverlayStack, OverlayContainer } from 'tuiuiu.js';
+ *
+ * const overlays = createOverlayStack();
+ *
+ * // Push an overlay
+ * overlays.push({
+ *   id: 'confirm',
+ *   component: () => ConfirmDialog({ ... }),
+ *   priority: 'normal',
+ *   closeOnEscape: true,
+ * });
+ *
+ * // In your app
+ * Box({},
+ *   MainContent(),
+ *   OverlayContainer({ stack: overlays })
+ * )
+ *
+ * // Handle input
+ * useInput((_, key) => {
+ *   if (overlays.hasOverlay()) {
+ *     if (key.escape && overlays.current()?.closeOnEscape) {
+ *       overlays.pop();
+ *     }
+ *     // Don't propagate input to main content
+ *     return;
+ *   }
+ *   // Normal input handling
+ * });
+ * ```
+ */
+import { Box } from '../primitives/nodes.js';
+import { createSignal } from '../primitives/signal.js';
+// =============================================================================
+// Priority Values
+// =============================================================================
+const PRIORITY_VALUES = {
+    low: 1,
+    normal: 2,
+    high: 3,
+    critical: 4,
+};
+// =============================================================================
+// Implementation
+// =============================================================================
+/**
+ * Create an overlay stack manager
+ */
+export function createOverlayStack() {
+    const [version, setVersion] = createSignal(0);
+    const triggerUpdate = () => setVersion(v => v + 1);
+    const stack = [];
+    const subscribers = new Set();
+    const notify = () => {
+        triggerUpdate();
+        for (const callback of subscribers) {
+            callback();
+        }
+    };
+    const sortStack = () => {
+        // Sort by priority (lower first), then by pushedAt (earlier first)
+        stack.sort((a, b) => {
+            if (a.priorityValue !== b.priorityValue) {
+                return a.priorityValue - b.priorityValue;
+            }
+            return a.pushedAt - b.pushedAt;
+        });
+    };
+    return {
+        all: () => {
+            version(); // Subscribe
+            return [...stack];
+        },
+        current: () => {
+            version();
+            return stack.length > 0 ? stack[stack.length - 1] : null;
+        },
+        hasOverlay: () => {
+            version();
+            return stack.length > 0;
+        },
+        isOpen: (id) => {
+            version();
+            return stack.some(entry => entry.id === id);
+        },
+        get: (id) => {
+            version();
+            return stack.find(entry => entry.id === id) || null;
+        },
+        push: (config) => {
+            // Don't allow duplicate IDs
+            if (stack.some(entry => entry.id === config.id)) {
+                console.warn(`Overlay with id '${config.id}' already exists`);
+                return;
+            }
+            const entry = {
+                ...config,
+                priority: config.priority || 'normal',
+                priorityValue: PRIORITY_VALUES[config.priority || 'normal'],
+                pushedAt: Date.now(),
+                closeOnEscape: config.closeOnEscape ?? true,
+                closeOnClickOutside: config.closeOnClickOutside ?? false,
+                showBackdrop: config.showBackdrop ?? true,
+                backdropChar: config.backdropChar ?? ' ',
+                backdropColor: config.backdropColor ?? undefined,
+            };
+            stack.push(entry);
+            sortStack();
+            entry.onOpen?.();
+            notify();
+        },
+        pop: () => {
+            if (stack.length === 0)
+                return null;
+            const entry = stack[stack.length - 1];
+            // Check beforeClose
+            if (entry.beforeClose && !entry.beforeClose()) {
+                return null;
+            }
+            stack.pop();
+            entry.onClose?.();
+            notify();
+            return entry;
+        },
+        close: (id) => {
+            const index = stack.findIndex(entry => entry.id === id);
+            if (index === -1)
+                return false;
+            const entry = stack[index];
+            // Check beforeClose
+            if (entry.beforeClose && !entry.beforeClose()) {
+                return false;
+            }
+            stack.splice(index, 1);
+            entry.onClose?.();
+            notify();
+            return true;
+        },
+        closeAll: () => {
+            // Close from top to bottom
+            while (stack.length > 0) {
+                const entry = stack.pop();
+                entry.onClose?.();
+            }
+            notify();
+        },
+        replace: (id, config) => {
+            const index = stack.findIndex(entry => entry.id === id);
+            if (index === -1)
+                return false;
+            const oldEntry = stack[index];
+            const newEntry = {
+                ...config,
+                priority: config.priority || 'normal',
+                priorityValue: PRIORITY_VALUES[config.priority || 'normal'],
+                pushedAt: oldEntry.pushedAt, // Keep original position
+                closeOnEscape: config.closeOnEscape ?? true,
+                closeOnClickOutside: config.closeOnClickOutside ?? false,
+                showBackdrop: config.showBackdrop ?? true,
+            };
+            stack[index] = newEntry;
+            sortStack();
+            notify();
+            return true;
+        },
+        bringToTop: (id) => {
+            const index = stack.findIndex(entry => entry.id === id);
+            if (index === -1)
+                return false;
+            const entry = stack[index];
+            entry.pushedAt = Date.now();
+            sortStack();
+            notify();
+            return true;
+        },
+        size: () => {
+            version();
+            return stack.length;
+        },
+        subscribe: (callback) => {
+            subscribers.add(callback);
+            return () => {
+                subscribers.delete(callback);
+            };
+        },
+    };
+}
+/**
+ * Container component that renders all overlays in the stack
+ *
+ * @example
+ * ```typescript
+ * // At the end of your main component
+ * Box({},
+ *   MainContent(),
+ *   OverlayContainer({ stack: overlays })
+ * )
+ * ```
+ */
+export function OverlayContainer(props) {
+    const { stack, renderBackdrop } = props;
+    const overlays = stack.all();
+    if (overlays.length === 0) {
+        return Box({});
+    }
+    const children = [];
+    for (const entry of overlays) {
+        // Backdrop
+        if (entry.showBackdrop && renderBackdrop) {
+            const backdrop = renderBackdrop(entry);
+            if (backdrop) {
+                children.push(backdrop);
+            }
+        }
+        // Overlay component
+        const component = entry.component();
+        if (component) {
+            children.push(component);
+        }
+    }
+    return Box({ flexDirection: 'column' }, ...children);
+}
+/**
+ * Check if input should be blocked (overlay is active)
+ *
+ * @example
+ * ```typescript
+ * const overlays = createOverlayStack();
+ *
+ * useInput((input, key) => {
+ *   // Handle escape for overlays
+ *   if (key.escape && overlays.hasOverlay()) {
+ *     const current = overlays.current();
+ *     if (current?.closeOnEscape) {
+ *       overlays.pop();
+ *     }
+ *     return; // Block further input
+ *   }
+ *
+ *   // Block all input when overlay is active
+ *   if (shouldBlockInput(overlays)) {
+ *     return;
+ *   }
+ *
+ *   // Normal input handling...
+ * });
+ * ```
+ */
+export function shouldBlockInput(stack) {
+    return stack.hasOverlay();
+}
+/**
+ * Handle escape key for overlay stack
+ * Returns true if handled (overlay was closed or blocked)
+ */
+export function handleOverlayEscape(stack) {
+    const current = stack.current();
+    if (!current)
+        return false;
+    if (current.closeOnEscape) {
+        stack.pop();
+        return true;
+    }
+    // Overlay exists but doesn't close on escape - still block
+    return true;
+}
+// =============================================================================
+// Utility: Create common overlays
+// =============================================================================
+/**
+ * Helper to create a modal overlay config
+ */
+export function createModalOverlay(options) {
+    return {
+        id: options.id,
+        component: options.component,
+        priority: 'normal',
+        closeOnEscape: options.closeOnEscape ?? true,
+        showBackdrop: true,
+        onClose: options.onClose,
+    };
+}
+/**
+ * Helper to create a toast overlay config (low priority, no backdrop)
+ */
+export function createToastOverlay(options) {
+    let timeoutId = null;
+    const config = {
+        id: options.id,
+        component: options.component,
+        priority: 'low',
+        closeOnEscape: false,
+        showBackdrop: false,
+        onClose: () => {
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+                timeoutId = null;
+            }
+            options.onClose?.();
+        },
+    };
+    const autoClose = () => {
+        if (options.duration && options.duration > 0) {
+            timeoutId = setTimeout(() => {
+                // This will be called by the stack manager
+                config.onClose?.();
+            }, options.duration);
+        }
+    };
+    return { ...config, autoClose };
+}
+/**
+ * Helper to create a critical overlay config (highest priority)
+ */
+export function createCriticalOverlay(options) {
+    return {
+        id: options.id,
+        component: options.component,
+        priority: 'critical',
+        closeOnEscape: options.closeOnEscape ?? false,
+        showBackdrop: true,
+        onClose: options.onClose,
+    };
+}
+//# sourceMappingURL=overlay-stack.js.map

package/dist/organisms/overlay-stack.js.map

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

package/dist/organisms/scroll-area.d.ts

@@ -0,0 +1,188 @@
+/**
+ * ScrollArea - Scrollable content with scrollbar
+ *
+ * Features:
+ * - Vertical scrolling
+ * - Scrollbar indicator
+ * - Keyboard scrolling (arrows, page up/down)
+ * - Scroll position tracking
+ * - Auto-scroll to bottom (optional)
+ */
+import type { VNode, ColorValue } from '../utils/types.js';
+export interface ScrollAreaOptions {
+    /** Visible height (lines) */
+    height: number;
+    /** Content to scroll */
+    content: string[] | VNode[];
+    /** Initial scroll position */
+    initialScrollTop?: number;
+    /** Auto-scroll to bottom on content change */
+    autoScroll?: boolean;
+    /** Show scrollbar */
+    showScrollbar?: boolean;
+    /** Scrollbar color */
+    scrollbarColor?: ColorValue;
+    /** Track color */
+    trackColor?: ColorValue;
+    /** Enable wrapping at width */
+    wrapWidth?: number;
+    /** Scroll step size */
+    scrollStep?: number;
+    /** Page scroll size (default: height - 1) */
+    pageSize?: number;
+    /** Callbacks */
+    onScroll?: (scrollTop: number) => void;
+    /** Is active */
+    isActive?: boolean;
+}
+export interface ScrollAreaState {
+    scrollTop: () => number;
+    maxScroll: () => number;
+    visibleItems: () => (string | VNode)[];
+    scrollTo: (position: number) => void;
+    scrollBy: (delta: number) => void;
+    scrollToTop: () => void;
+    scrollToBottom: () => void;
+    pageUp: () => void;
+    pageDown: () => void;
+}
+/**
+ * Create a ScrollArea state manager
+ */
+export declare function createScrollArea(options: ScrollAreaOptions): ScrollAreaState;
+export interface ScrollAreaProps extends ScrollAreaOptions {
+    /** Pre-created state */
+    state?: ScrollAreaState;
+    /** Width of content area */
+    width?: number;
+}
+/**
+ * ScrollArea - Scrollable content with scrollbar
+ *
+ * @example
+ * // Basic scroll area
+ * ScrollArea({
+ *   height: 10,
+ *   content: longText.split('\n'),
+ * })
+ *
+ * @example
+ * // With auto-scroll and custom scrollbar
+ * ScrollArea({
+ *   height: 20,
+ *   content: logLines,
+ *   autoScroll: true,
+ *   scrollbarColor: 'cyan',
+ * })
+ */
+export declare function ScrollArea(props: ScrollAreaProps): VNode;
+export interface VirtualListItem<T = unknown> {
+    key: string;
+    data: T;
+}
+export interface VirtualListOptions<T = unknown> {
+    /** List items */
+    items: VirtualListItem<T>[];
+    /** Visible height (items) */
+    height: number;
+    /** Render function for each item */
+    renderItem: (item: VirtualListItem<T>, index: number, isSelected: boolean) => VNode;
+    /** Initial selected index */
+    initialSelected?: number;
+    /** Selection color */
+    selectionColor?: ColorValue;
+    /** Show scrollbar */
+    showScrollbar?: boolean;
+    /** Callbacks */
+    onSelect?: (item: VirtualListItem<T>, index: number) => void;
+    onActivate?: (item: VirtualListItem<T>, index: number) => void;
+    /** Is active */
+    isActive?: boolean;
+}
+export interface VirtualListState<T = unknown> {
+    selectedIndex: () => number;
+    scrollTop: () => number;
+    visibleItems: () => {
+        item: VirtualListItem<T>;
+        index: number;
+    }[];
+    selectIndex: (index: number) => void;
+    selectPrev: () => void;
+    selectNext: () => void;
+    selectFirst: () => void;
+    selectLast: () => void;
+    pageUp: () => void;
+    pageDown: () => void;
+    activate: () => void;
+}
+/**
+ * Create a VirtualList state manager
+ */
+export declare function createVirtualList<T = unknown>(options: VirtualListOptions<T>): VirtualListState<T>;
+export interface VirtualListProps<T = unknown> extends VirtualListOptions<T> {
+    /** Pre-created state */
+    state?: VirtualListState<T>;
+    /** Width */
+    width?: number;
+}
+/**
+ * VirtualList - Virtualized list for large datasets
+ *
+ * @example
+ * VirtualList({
+ *   items: files.map((f, i) => ({ key: f.name, data: f })),
+ *   height: 20,
+ *   renderItem: (item, index, selected) =>
+ *     Text({ color: selected ? 'cyan' : 'white' }, item.data.name),
+ *   onActivate: (item) => openFile(item.data),
+ * })
+ */
+export declare function VirtualList<T = unknown>(props: VirtualListProps<T>): VNode;
+export interface ScrollableTextProps {
+    /** Text content */
+    text: string;
+    /** Visible height */
+    height: number;
+    /** Width (for wrapping) */
+    width?: number;
+    /** Text color */
+    color?: ColorValue;
+    /** Show scrollbar */
+    showScrollbar?: boolean;
+    /** Is active */
+    isActive?: boolean;
+}
+/**
+ * ScrollableText - Simple scrollable text
+ */
+export declare function ScrollableText(props: ScrollableTextProps): VNode;
+export interface LogViewerOptions {
+    /** Log lines */
+    lines: string[];
+    /** Visible height */
+    height: number;
+    /** Auto-scroll to bottom */
+    autoScroll?: boolean;
+    /** Show line numbers */
+    showLineNumbers?: boolean;
+    /** Highlight pattern (regex) */
+    highlightPattern?: RegExp;
+    /** Highlight color */
+    highlightColor?: ColorValue;
+    /** Is active */
+    isActive?: boolean;
+}
+/**
+ * LogViewer - Auto-scrolling log viewer
+ *
+ * @example
+ * LogViewer({
+ *   lines: logBuffer,
+ *   height: 20,
+ *   autoScroll: true,
+ *   highlightPattern: /error|warning/i,
+ *   highlightColor: 'red',
+ * })
+ */
+export declare function LogViewer(props: LogViewerOptions): VNode;
+//# sourceMappingURL=scroll-area.d.ts.map

package/dist/organisms/scroll-area.d.ts.map

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