tuiuiu.js 0.1.1

package/dist/templates/stack.d.ts

@@ -0,0 +1,189 @@
+/**
+ * Stack Layouts - Basic stacking and arrangement components
+ *
+ * Provides simple, composable layout primitives:
+ * - VStack: Vertical stack with configurable gap
+ * - HStack: Horizontal stack with configurable gap
+ * - Center: Centers content horizontally and/or vertically
+ * - FullScreen: Container that fills the terminal
+ * - Spacer: Flexible space that pushes siblings apart
+ */
+import type { VNode } from '../utils/types.js';
+export interface VStackProps {
+    /** Gap between children (in lines) */
+    gap?: number;
+    /** Horizontal alignment */
+    align?: 'left' | 'center' | 'right' | 'stretch';
+    /** Padding inside the stack */
+    padding?: number;
+    /** Padding horizontal */
+    paddingX?: number;
+    /** Padding vertical */
+    paddingY?: number;
+    /** Fixed width */
+    width?: number | string;
+    /** Fixed height */
+    height?: number | string;
+    /** Border around stack */
+    border?: boolean;
+    /** Border style */
+    borderStyle?: 'single' | 'double' | 'round' | 'bold';
+    /** Border color */
+    borderColor?: string;
+    /** Children nodes */
+    children: VNode[];
+}
+/**
+ * Vertical Stack - Arranges children vertically with optional gap
+ *
+ * @example
+ * ```typescript
+ * VStack({ gap: 1 }, [
+ *   Text({}, 'Line 1'),
+ *   Text({}, 'Line 2'),
+ *   Text({}, 'Line 3'),
+ * ])
+ *
+ * // With alignment
+ * VStack({ gap: 1, align: 'center' }, [
+ *   Header(),
+ *   Content(),
+ *   Footer(),
+ * ])
+ * ```
+ */
+export declare function VStack(props: VStackProps): VNode;
+export declare function VStack(children: VNode[]): VNode;
+export interface HStackProps {
+    /** Gap between children (in characters) */
+    gap?: number;
+    /** Vertical alignment */
+    align?: 'top' | 'center' | 'bottom' | 'stretch';
+    /** Horizontal distribution */
+    justify?: 'start' | 'center' | 'end' | 'between' | 'around';
+    /** Padding inside the stack */
+    padding?: number;
+    /** Padding horizontal */
+    paddingX?: number;
+    /** Padding vertical */
+    paddingY?: number;
+    /** Fixed width */
+    width?: number | string;
+    /** Fixed height */
+    height?: number | string;
+    /** Border around stack */
+    border?: boolean;
+    /** Border style */
+    borderStyle?: 'single' | 'double' | 'round' | 'bold';
+    /** Border color */
+    borderColor?: string;
+    /** Children nodes */
+    children: VNode[];
+}
+/**
+ * Horizontal Stack - Arranges children horizontally with optional gap
+ *
+ * @example
+ * ```typescript
+ * HStack({ gap: 2 }, [
+ *   Button({ label: 'Cancel' }),
+ *   Button({ label: 'OK' }),
+ * ])
+ *
+ * // Space between items
+ * HStack({ justify: 'between' }, [
+ *   Logo(),
+ *   Navigation(),
+ *   UserMenu(),
+ * ])
+ * ```
+ */
+export declare function HStack(props: HStackProps): VNode;
+export declare function HStack(children: VNode[]): VNode;
+export interface CenterProps {
+    /** Center horizontally */
+    horizontal?: boolean;
+    /** Center vertically */
+    vertical?: boolean;
+    /** Fixed width (defaults to terminal width) */
+    width?: number;
+    /** Fixed height (defaults to terminal height) */
+    height?: number;
+    /** Child node */
+    children: VNode;
+}
+/**
+ * Center - Centers content horizontally and/or vertically
+ *
+ * @example
+ * ```typescript
+ * // Center both ways (full screen)
+ * Center({ children: Modal({ content: '...' }) })
+ *
+ * // Center only horizontally
+ * Center({ horizontal: true, vertical: false, children: Title() })
+ *
+ * // Center in a specific area
+ * Center({ width: 40, height: 10, children: Spinner() })
+ * ```
+ */
+export declare function Center(props: CenterProps): VNode;
+export interface FullScreenProps {
+    /** Background character */
+    background?: string;
+    /** Background color */
+    backgroundColor?: string;
+    /** Padding from edges */
+    padding?: number;
+    /** Child node */
+    children: VNode;
+}
+/**
+ * FullScreen - Container that fills the entire terminal
+ *
+ * @example
+ * ```typescript
+ * FullScreen({
+ *   padding: 1,
+ *   children: AppContent()
+ * })
+ *
+ * // With background
+ * FullScreen({
+ *   backgroundColor: 'blue',
+ *   children: MainView()
+ * })
+ * ```
+ */
+export declare function FullScreen(props: FullScreenProps): VNode;
+export interface SpacerProps {
+    /** Flex grow value (default: 1) */
+    flex?: number;
+    /** Minimum size */
+    minSize?: number;
+}
+/**
+ * Spacer - Flexible space that pushes siblings apart
+ *
+ * @example
+ * ```typescript
+ * // Push items to opposite ends
+ * HStack({ children: [
+ *   Logo(),
+ *   Spacer(),
+ *   UserMenu(),
+ * ]})
+ *
+ * // Equal spacing
+ * HStack({ children: [
+ *   Item1(),
+ *   Spacer(),
+ *   Item2(),
+ *   Spacer(),
+ *   Item3(),
+ * ]})
+ * ```
+ */
+export declare function Spacer(props?: SpacerProps): VNode;
+export { Divider, type DividerProps } from '../primitives/divider.js';
+//# sourceMappingURL=stack.d.ts.map

package/dist/templates/stack.d.ts.map

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

package/dist/templates/stack.js

@@ -0,0 +1,170 @@
+/**
+ * Stack Layouts - Basic stacking and arrangement components
+ *
+ * Provides simple, composable layout primitives:
+ * - VStack: Vertical stack with configurable gap
+ * - HStack: Horizontal stack with configurable gap
+ * - Center: Centers content horizontally and/or vertically
+ * - FullScreen: Container that fills the terminal
+ * - Spacer: Flexible space that pushes siblings apart
+ */
+import { Box } from '../primitives/nodes.js';
+export function VStack(propsOrChildren) {
+    // Handle both signatures
+    const isArray = Array.isArray(propsOrChildren);
+    const props = isArray ? { children: propsOrChildren } : propsOrChildren;
+    const { gap = 0, align = 'stretch', padding, paddingX, paddingY, width, height, border = false, borderStyle = 'single', borderColor, children, } = props;
+    // Map alignment to flexbox
+    const alignItems = align === 'left' ? 'flex-start'
+        : align === 'right' ? 'flex-end'
+            : align === 'center' ? 'center'
+                : 'stretch';
+    // Insert spacers between children for gap
+    const spacedChildren = [];
+    for (let i = 0; i < children.length; i++) {
+        spacedChildren.push(children[i]);
+        if (gap > 0 && i < children.length - 1) {
+            spacedChildren.push(Box({ height: gap }));
+        }
+    }
+    return Box({
+        flexDirection: 'column',
+        alignItems,
+        padding,
+        paddingX,
+        paddingY,
+        width,
+        height,
+        borderStyle: border ? borderStyle : undefined,
+        borderColor: border ? borderColor : undefined,
+    }, ...spacedChildren);
+}
+export function HStack(propsOrChildren) {
+    const isArray = Array.isArray(propsOrChildren);
+    const props = isArray ? { children: propsOrChildren } : propsOrChildren;
+    const { gap = 0, align = 'stretch', justify = 'start', padding, paddingX, paddingY, width, height, border = false, borderStyle = 'single', borderColor, children, } = props;
+    // Map alignment
+    const alignItems = align === 'top' ? 'flex-start'
+        : align === 'bottom' ? 'flex-end'
+            : align === 'center' ? 'center'
+                : 'stretch';
+    // Map justify
+    const justifyContent = justify === 'start' ? 'flex-start'
+        : justify === 'end' ? 'flex-end'
+            : justify === 'center' ? 'center'
+                : justify === 'between' ? 'space-between'
+                    : justify === 'around' ? 'space-around'
+                        : 'flex-start';
+    // Insert spacers between children for gap
+    const spacedChildren = [];
+    for (let i = 0; i < children.length; i++) {
+        spacedChildren.push(children[i]);
+        if (gap > 0 && i < children.length - 1) {
+            spacedChildren.push(Box({ width: gap }));
+        }
+    }
+    return Box({
+        flexDirection: 'row',
+        alignItems,
+        justifyContent,
+        padding,
+        paddingX,
+        paddingY,
+        width,
+        height,
+        borderStyle: border ? borderStyle : undefined,
+        borderColor: border ? borderColor : undefined,
+    }, ...spacedChildren);
+}
+/**
+ * Center - Centers content horizontally and/or vertically
+ *
+ * @example
+ * ```typescript
+ * // Center both ways (full screen)
+ * Center({ children: Modal({ content: '...' }) })
+ *
+ * // Center only horizontally
+ * Center({ horizontal: true, vertical: false, children: Title() })
+ *
+ * // Center in a specific area
+ * Center({ width: 40, height: 10, children: Spinner() })
+ * ```
+ */
+export function Center(props) {
+    const { horizontal = true, vertical = true, width, height, children, } = props;
+    const termWidth = width ?? (process.stdout.columns || 80);
+    const termHeight = height ?? (process.stdout.rows || 24);
+    return Box({
+        width: termWidth,
+        height: termHeight,
+        flexDirection: 'column',
+        alignItems: horizontal ? 'center' : 'flex-start',
+        justifyContent: vertical ? 'center' : 'flex-start',
+    }, children);
+}
+/**
+ * FullScreen - Container that fills the entire terminal
+ *
+ * @example
+ * ```typescript
+ * FullScreen({
+ *   padding: 1,
+ *   children: AppContent()
+ * })
+ *
+ * // With background
+ * FullScreen({
+ *   backgroundColor: 'blue',
+ *   children: MainView()
+ * })
+ * ```
+ */
+export function FullScreen(props) {
+    const { backgroundColor, padding = 0, children, } = props;
+    const termWidth = process.stdout.columns || 80;
+    const termHeight = process.stdout.rows || 24;
+    return Box({
+        width: termWidth,
+        height: termHeight,
+        padding,
+        backgroundColor,
+        flexDirection: 'column',
+    }, children);
+}
+/**
+ * Spacer - Flexible space that pushes siblings apart
+ *
+ * @example
+ * ```typescript
+ * // Push items to opposite ends
+ * HStack({ children: [
+ *   Logo(),
+ *   Spacer(),
+ *   UserMenu(),
+ * ]})
+ *
+ * // Equal spacing
+ * HStack({ children: [
+ *   Item1(),
+ *   Spacer(),
+ *   Item2(),
+ *   Spacer(),
+ *   Item3(),
+ * ]})
+ * ```
+ */
+export function Spacer(props = {}) {
+    const { flex = 1, minSize = 0 } = props;
+    return Box({
+        flexGrow: flex,
+        flexShrink: 0,
+        minWidth: minSize,
+        minHeight: minSize,
+    });
+}
+// =============================================================================
+// DIVIDER - Re-export from primitives (canonical implementation)
+// =============================================================================
+export { Divider } from '../primitives/divider.js';
+//# sourceMappingURL=stack.js.map

package/dist/templates/stack.js.map

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

package/dist/utils/batcher.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Update Batcher - Throttle high-frequency updates
+ *
+ * When rendering rapidly changing content (like job outputs),
+ * we need to throttle updates to prevent excessive re-renders
+ * and flickering.
+ *
+ * This utility batches updates into intervals, only flushing
+ * to the screen at fixed intervals (default: 200ms).
+ *
+ * @example
+ * ```typescript
+ * const batcher = createUpdateBatcher(() => {
+ *   // This runs at most every 200ms
+ *   renderOutput(currentOutput);
+ * });
+ *
+ * // Called many times rapidly
+ * onJobOutput((chunk) => {
+ *   currentOutput += chunk;
+ *   batcher.schedule(); // Batches updates
+ * });
+ *
+ * // When job completes, flush immediately
+ * onJobComplete(() => {
+ *   batcher.flush();
+ * });
+ * ```
+ */
+export interface UpdateBatcher {
+    /** Schedule a batched update */
+    schedule: () => void;
+    /** Flush immediately, canceling any pending update */
+    flush: () => void;
+    /** Cancel any pending update without flushing */
+    cancel: () => void;
+    /** Check if an update is pending */
+    isPending: () => boolean;
+}
+/**
+ * Create an update batcher for throttling high-frequency updates
+ *
+ * @param flushFn - Function to call when flushing updates
+ * @param interval - Minimum time between updates (default: 200ms)
+ */
+export declare function createUpdateBatcher(flushFn: () => void, interval?: number): UpdateBatcher;
+/**
+ * Create a debounced function that delays execution
+ * until after the specified wait time has passed since
+ * the last call.
+ *
+ * Unlike batcher, this resets the timer on each call.
+ *
+ * @example
+ * ```typescript
+ * const debouncedSearch = createDebounced((query: string) => {
+ *   performSearch(query);
+ * }, 300);
+ *
+ * // Only the last call within 300ms window executes
+ * input.onKeyPress((key) => {
+ *   debouncedSearch(input.value);
+ * });
+ * ```
+ */
+export declare function createDebounced<T extends (...args: any[]) => void>(fn: T, wait: number): T & {
+    cancel: () => void;
+    flush: () => void;
+};
+/**
+ * Create a throttled function that executes at most once
+ * per specified interval.
+ *
+ * @example
+ * ```typescript
+ * const throttledResize = createThrottled(() => {
+ *   recalculateLayout();
+ * }, 100);
+ *
+ * window.onResize(() => {
+ *   throttledResize(); // Max 10 times per second
+ * });
+ * ```
+ */
+export declare function createThrottled<T extends (...args: any[]) => void>(fn: T, interval: number): T & {
+    cancel: () => void;
+};
+//# sourceMappingURL=batcher.d.ts.map

package/dist/utils/batcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batcher.d.ts","sourceRoot":"","sources":["../../src/utils/batcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,QAAQ,EAAE,MAAM,IAAI,CAAC;IACrB,sDAAsD;IACtD,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,iDAAiD;IACjD,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,oCAAoC;IACpC,SAAS,EAAE,MAAM,OAAO,CAAC;CAC1B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,IAAI,EACnB,QAAQ,GAAE,MAAY,GACrB,aAAa,CAmCf;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,EAChE,EAAE,EAAE,CAAC,EACL,IAAI,EAAE,MAAM,GACX,CAAC,GAAG;IAAE,MAAM,EAAE,MAAM,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,IAAI,CAAA;CAAE,CAsC/C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,EAChE,EAAE,EAAE,CAAC,EACL,QAAQ,EAAE,MAAM,GACf,CAAC,GAAG;IAAE,MAAM,EAAE,MAAM,IAAI,CAAA;CAAE,CAqC5B"}

package/dist/utils/batcher.js

@@ -0,0 +1,172 @@
+/**
+ * Update Batcher - Throttle high-frequency updates
+ *
+ * When rendering rapidly changing content (like job outputs),
+ * we need to throttle updates to prevent excessive re-renders
+ * and flickering.
+ *
+ * This utility batches updates into intervals, only flushing
+ * to the screen at fixed intervals (default: 200ms).
+ *
+ * @example
+ * ```typescript
+ * const batcher = createUpdateBatcher(() => {
+ *   // This runs at most every 200ms
+ *   renderOutput(currentOutput);
+ * });
+ *
+ * // Called many times rapidly
+ * onJobOutput((chunk) => {
+ *   currentOutput += chunk;
+ *   batcher.schedule(); // Batches updates
+ * });
+ *
+ * // When job completes, flush immediately
+ * onJobComplete(() => {
+ *   batcher.flush();
+ * });
+ * ```
+ */
+/**
+ * Create an update batcher for throttling high-frequency updates
+ *
+ * @param flushFn - Function to call when flushing updates
+ * @param interval - Minimum time between updates (default: 200ms)
+ */
+export function createUpdateBatcher(flushFn, interval = 200) {
+    let scheduled = false;
+    let timeoutId = null;
+    return {
+        schedule: () => {
+            if (!scheduled) {
+                scheduled = true;
+                timeoutId = setTimeout(() => {
+                    scheduled = false;
+                    timeoutId = null;
+                    flushFn();
+                }, interval);
+            }
+        },
+        flush: () => {
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+                timeoutId = null;
+            }
+            scheduled = false;
+            flushFn();
+        },
+        cancel: () => {
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+                timeoutId = null;
+            }
+            scheduled = false;
+        },
+        isPending: () => scheduled,
+    };
+}
+/**
+ * Create a debounced function that delays execution
+ * until after the specified wait time has passed since
+ * the last call.
+ *
+ * Unlike batcher, this resets the timer on each call.
+ *
+ * @example
+ * ```typescript
+ * const debouncedSearch = createDebounced((query: string) => {
+ *   performSearch(query);
+ * }, 300);
+ *
+ * // Only the last call within 300ms window executes
+ * input.onKeyPress((key) => {
+ *   debouncedSearch(input.value);
+ * });
+ * ```
+ */
+export function createDebounced(fn, wait) {
+    let timeoutId = null;
+    let lastArgs = null;
+    const debounced = ((...args) => {
+        lastArgs = args;
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+        }
+        timeoutId = setTimeout(() => {
+            timeoutId = null;
+            if (lastArgs) {
+                fn(...lastArgs);
+                lastArgs = null;
+            }
+        }, wait);
+    });
+    debounced.cancel = () => {
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+            timeoutId = null;
+        }
+        lastArgs = null;
+    };
+    debounced.flush = () => {
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+            timeoutId = null;
+        }
+        if (lastArgs) {
+            fn(...lastArgs);
+            lastArgs = null;
+        }
+    };
+    return debounced;
+}
+/**
+ * Create a throttled function that executes at most once
+ * per specified interval.
+ *
+ * @example
+ * ```typescript
+ * const throttledResize = createThrottled(() => {
+ *   recalculateLayout();
+ * }, 100);
+ *
+ * window.onResize(() => {
+ *   throttledResize(); // Max 10 times per second
+ * });
+ * ```
+ */
+export function createThrottled(fn, interval) {
+    let lastExecution = 0;
+    let timeoutId = null;
+    let lastArgs = null;
+    const throttled = ((...args) => {
+        const now = Date.now();
+        const elapsed = now - lastExecution;
+        if (elapsed >= interval) {
+            lastExecution = now;
+            fn(...args);
+        }
+        else {
+            // Schedule trailing call
+            lastArgs = args;
+            if (!timeoutId) {
+                timeoutId = setTimeout(() => {
+                    lastExecution = Date.now();
+                    timeoutId = null;
+                    if (lastArgs) {
+                        fn(...lastArgs);
+                        lastArgs = null;
+                    }
+                }, interval - elapsed);
+            }
+        }
+    });
+    throttled.cancel = () => {
+        if (timeoutId) {
+            clearTimeout(timeoutId);
+            timeoutId = null;
+        }
+        lastArgs = null;
+    };
+    return throttled;
+}
+//# sourceMappingURL=batcher.js.map

package/dist/utils/batcher.js.map

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

package/dist/utils/cursor.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Reck Cursor Control - Hide/show terminal cursor
+ */
+import { Writable } from 'node:stream';
+/**
+ * Show the terminal cursor
+ */
+export declare function showCursor(stream?: Writable): void;
+/**
+ * Hide the terminal cursor
+ */
+export declare function hideCursor(stream?: Writable): void;
+/**
+ * Toggle cursor visibility
+ */
+export declare function toggleCursor(force?: boolean, stream?: Writable): void;
+/**
+ * Check if cursor is currently hidden
+ */
+export declare function isCursorHidden(): boolean;
+export declare const cursor: {
+    show: typeof showCursor;
+    hide: typeof hideCursor;
+    toggle: typeof toggleCursor;
+    isHidden: typeof isCursorHidden;
+};
+export default cursor;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/utils/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/utils/cursor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAwCvC;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,GAAE,QAAyB,GAAG,IAAI,CAMlE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,GAAE,QAAyB,GAAG,IAAI,CAOlE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,MAAM,GAAE,QAAyB,GAAG,IAAI,CASrF;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED,eAAO,MAAM,MAAM;;;;;CAKlB,CAAC;AAEF,eAAe,MAAM,CAAC"}