tuiuiu.js 0.1.1

package/dist/utils/cursor.js

@@ -0,0 +1,86 @@
+/**
+ * Reck Cursor Control - Hide/show terminal cursor
+ */
+// ANSI escape codes for cursor control
+const SHOW_CURSOR = '\u001B[?25h';
+const HIDE_CURSOR = '\u001B[?25l';
+let isHidden = false;
+let restoreOnExit = false;
+/**
+ * Ensure cursor is restored on process exit
+ */
+function setupExitHandler() {
+    if (restoreOnExit)
+        return;
+    restoreOnExit = true;
+    const restore = () => {
+        if (isHidden) {
+            process.stdout.write(SHOW_CURSOR);
+            isHidden = false;
+        }
+    };
+    // Handle various exit scenarios
+    process.on('exit', restore);
+    process.on('SIGINT', () => {
+        restore();
+        process.exit(128 + 2);
+    });
+    process.on('SIGTERM', () => {
+        restore();
+        process.exit(128 + 15);
+    });
+    process.on('uncaughtException', (err) => {
+        restore();
+        console.error(err);
+        process.exit(1);
+    });
+}
+/**
+ * Show the terminal cursor
+ */
+export function showCursor(stream = process.stdout) {
+    if (!('isTTY' in stream) || !stream.isTTY) {
+        return;
+    }
+    isHidden = false;
+    stream.write(SHOW_CURSOR);
+}
+/**
+ * Hide the terminal cursor
+ */
+export function hideCursor(stream = process.stdout) {
+    if (!('isTTY' in stream) || !stream.isTTY) {
+        return;
+    }
+    setupExitHandler();
+    isHidden = true;
+    stream.write(HIDE_CURSOR);
+}
+/**
+ * Toggle cursor visibility
+ */
+export function toggleCursor(force, stream = process.stdout) {
+    if (force !== undefined) {
+        isHidden = !force; // force=true means show, so isHidden=false
+    }
+    if (isHidden) {
+        showCursor(stream);
+    }
+    else {
+        hideCursor(stream);
+    }
+}
+/**
+ * Check if cursor is currently hidden
+ */
+export function isCursorHidden() {
+    return isHidden;
+}
+export const cursor = {
+    show: showCursor,
+    hide: hideCursor,
+    toggle: toggleCursor,
+    isHidden: isCursorHidden,
+};
+export default cursor;
+//# sourceMappingURL=cursor.js.map

package/dist/utils/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/utils/cursor.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,uCAAuC;AACvC,MAAM,WAAW,GAAG,aAAa,CAAC;AAClC,MAAM,WAAW,GAAG,aAAa,CAAC;AAElC,IAAI,QAAQ,GAAG,KAAK,CAAC;AACrB,IAAI,aAAa,GAAG,KAAK,CAAC;AAE1B;;GAEG;AACH,SAAS,gBAAgB;IACvB,IAAI,aAAa;QAAE,OAAO;IAC1B,aAAa,GAAG,IAAI,CAAC;IAErB,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAClC,QAAQ,GAAG,KAAK,CAAC;QACnB,CAAC;IACH,CAAC,CAAC;IAEF,gCAAgC;IAChC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACxB,OAAO,EAAE,CAAC;QACV,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QACzB,OAAO,EAAE,CAAC;QACV,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,GAAG,EAAE,EAAE;QACtC,OAAO,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,SAAmB,OAAO,CAAC,MAAM;IAC1D,IAAI,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAE,MAAc,CAAC,KAAK,EAAE,CAAC;QACnD,OAAO;IACT,CAAC;IACD,QAAQ,GAAG,KAAK,CAAC;IACjB,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,SAAmB,OAAO,CAAC,MAAM;IAC1D,IAAI,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAE,MAAc,CAAC,KAAK,EAAE,CAAC;QACnD,OAAO;IACT,CAAC;IACD,gBAAgB,EAAE,CAAC;IACnB,QAAQ,GAAG,IAAI,CAAC;IAChB,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAe,EAAE,SAAmB,OAAO,CAAC,MAAM;IAC7E,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,QAAQ,GAAG,CAAC,KAAK,CAAC,CAAC,2CAA2C;IAChE,CAAC;IACD,IAAI,QAAQ,EAAE,CAAC;QACb,UAAU,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE,YAAY;IACpB,QAAQ,EAAE,cAAc;CACzB,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/utils/fs-storage.d.ts

@@ -0,0 +1,23 @@
+/**
+ * NodeFsStorage - A storage adapter for Node.js file system persistence.
+ *
+ * Implements the `StorageAdapter` interface for `createPersistMiddleware`
+ * using Node.js `fs` module for saving/loading state from files.
+ */
+export interface NodeFsStorageOptions {
+    /** Base directory for storing files (e.g., './data') */
+    dir?: string;
+    /** File extension (e.g., '.json') */
+    ext?: string;
+}
+/**
+ * Creates a Node.js file system storage adapter.
+ *
+ * @param options - Configuration options for the storage.
+ * @returns An object implementing the `StorageAdapter` interface.
+ */
+export declare function createNodeFsStorage(options?: NodeFsStorageOptions): {
+    getItem: (key: string) => Promise<string | null>;
+    setItem: (key: string, value: string) => Promise<void>;
+};
+//# sourceMappingURL=fs-storage.d.ts.map

package/dist/utils/fs-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-storage.d.ts","sourceRoot":"","sources":["../../src/utils/fs-storage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,MAAM,WAAW,oBAAoB;IACnC,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB;mBAQxC,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;mBAQ/B,MAAM,SAAS,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;EAMlE"}

package/dist/utils/fs-storage.js

@@ -0,0 +1,34 @@
+/**
+ * NodeFsStorage - A storage adapter for Node.js file system persistence.
+ *
+ * Implements the `StorageAdapter` interface for `createPersistMiddleware`
+ * using Node.js `fs` module for saving/loading state from files.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Creates a Node.js file system storage adapter.
+ *
+ * @param options - Configuration options for the storage.
+ * @returns An object implementing the `StorageAdapter` interface.
+ */
+export function createNodeFsStorage(options = {}) {
+    const { dir = './.tuiuiu-data', ext = '.json' } = options;
+    // Ensure the directory exists
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const getItem = async (key) => {
+        const filePath = path.join(dir, `${key}${ext}`);
+        if (fs.existsSync(filePath)) {
+            return fs.promises.readFile(filePath, 'utf-8');
+        }
+        return null;
+    };
+    const setItem = async (key, value) => {
+        const filePath = path.join(dir, `${key}${ext}`);
+        await fs.promises.writeFile(filePath, value, 'utf-8');
+    };
+    return { getItem, setItem };
+}
+//# sourceMappingURL=fs-storage.js.map

package/dist/utils/fs-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-storage.js","sourceRoot":"","sources":["../../src/utils/fs-storage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAS7B;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAgC,EAAE;IACpE,MAAM,EAAE,GAAG,GAAG,gBAAgB,EAAE,GAAG,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC;IAE1D,8BAA8B;IAC9B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,EAAE,GAAW,EAA0B,EAAE;QAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC;QAChD,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5B,OAAO,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,KAAK,EAAE,GAAW,EAAE,KAAa,EAAiB,EAAE;QAClE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC;QAChD,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Utilities module exports
+ */
+export type { VNode, ReckNode, ReckChild, BoxProps, TextProps, SpacerProps, NewlineProps, BoxStyle, BoxStyleProps, TextStyle, TextStyleProps, ColorValue, LayoutNode, RenderContext, ForegroundColorName, VNodeType, Component, BorderChars, BorderStyleName, MouseButton, MouseEventData, MouseEventHandler, MouseEventProps, } from './types.js';
+export { BORDER_STYLES, getBorderChars, listBorderStyles, } from './types.js';
+export { stripAnsi, stringWidth, wrapText, truncateText, sliceAnsi, skipAnsi, takeAnsi, padAnsi, splitLines, joinLines, normalizeLines, compositeHorizontal, compositeVertical, colorToAnsi, colorize, style, hyperlink, styles, } from './text-utils.js';
+export type { WrapOptions, TruncateOptions, TruncatePosition, ColorType, } from './text-utils.js';
+export { showCursor, hideCursor, toggleCursor, isCursorHidden, cursor, } from './cursor.js';
+export { createLogUpdate, } from './log-update.js';
+export type { LogUpdate, LogUpdateOptions, } from './log-update.js';
+export { createUpdateBatcher, createDebounced, createThrottled, } from './batcher.js';
+export type { UpdateBatcher, } from './batcher.js';
+export { createNodeFsStorage } from './fs-storage.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,KAAK,EACL,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,SAAS,EACT,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,aAAa,EACb,SAAS,EACT,cAAc,EACd,UAAU,EACV,UAAU,EACV,aAAa,EACb,mBAAmB,EACnB,SAAS,EACT,SAAS,EACT,WAAW,EACX,eAAe,EAEf,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,SAAS,EACT,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,UAAU,EACV,SAAS,EACT,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACX,QAAQ,EACR,KAAK,EACL,SAAS,EACT,MAAM,GACP,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,WAAW,EACX,eAAe,EACf,gBAAgB,EAChB,SAAS,GACV,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,UAAU,EACV,UAAU,EACV,YAAY,EACZ,cAAc,EACd,MAAM,GACP,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,SAAS,EACT,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,aAAa,GACd,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,mBAAmB,EACpB,MAAM,iBAAiB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,15 @@
+/**
+ * Utilities module exports
+ */
+export { BORDER_STYLES, getBorderChars, listBorderStyles, } from './types.js';
+// Text utilities
+export { stripAnsi, stringWidth, wrapText, truncateText, sliceAnsi, skipAnsi, takeAnsi, padAnsi, splitLines, joinLines, normalizeLines, compositeHorizontal, compositeVertical, colorToAnsi, colorize, style, hyperlink, styles, } from './text-utils.js';
+// Cursor control
+export { showCursor, hideCursor, toggleCursor, isCursorHidden, cursor, } from './cursor.js';
+// Log update (incremental rendering)
+export { createLogUpdate, } from './log-update.js';
+// Update batching (throttle high-frequency updates)
+export { createUpdateBatcher, createDebounced, createThrottled, } from './batcher.js';
+// Node.js FS Storage for persistence
+export { createNodeFsStorage } from './fs-storage.js';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AA8BH,OAAO,EACL,aAAa,EACb,cAAc,EACd,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,iBAAiB;AACjB,OAAO,EACL,SAAS,EACT,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,UAAU,EACV,SAAS,EACT,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACX,QAAQ,EACR,KAAK,EACL,SAAS,EACT,MAAM,GACP,MAAM,iBAAiB,CAAC;AASzB,iBAAiB;AACjB,OAAO,EACL,UAAU,EACV,UAAU,EACV,YAAY,EACZ,cAAc,EACd,MAAM,GACP,MAAM,aAAa,CAAC;AAErB,qCAAqC;AACrC,OAAO,EACL,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAOzB,oDAAoD;AACpD,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,eAAe,GAChB,MAAM,cAAc,CAAC;AAMtB,qCAAqC;AACrC,OAAO,EACL,mBAAmB,EACpB,MAAM,iBAAiB,CAAC"}

package/dist/utils/log-update.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Reck Log Update - Incremental terminal rendering
+ *
+ * Provides efficient terminal updates by only redrawing changed lines
+ */
+import { Writable } from 'node:stream';
+export interface LogUpdateOptions {
+    /** Show cursor during rendering (default: false) */
+    showCursor?: boolean;
+    /** Use incremental rendering for better performance (default: true) */
+    incremental?: boolean;
+}
+export interface LogUpdate {
+    /** Render new content, replacing previous output */
+    (content: string): void;
+    /** Clear all previous output */
+    clear(): void;
+    /** Finish rendering, restore cursor */
+    done(): void;
+    /** Sync internal state without rendering (for external writes) */
+    sync(content: string): void;
+}
+/**
+ * Create a log updater
+ */
+export declare function createLogUpdate(stream?: Writable, options?: LogUpdateOptions): LogUpdate;
+declare const _default: {
+    create: typeof createLogUpdate;
+};
+export default _default;
+//# sourceMappingURL=log-update.d.ts.map

package/dist/utils/log-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-update.d.ts","sourceRoot":"","sources":["../../src/utils/log-update.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAuBvC,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,uEAAuE;IACvE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,oDAAoD;IACpD,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gCAAgC;IAChC,KAAK,IAAI,IAAI,CAAC;IACd,uCAAuC;IACvC,IAAI,IAAI,IAAI,CAAC;IACb,kEAAkE;IAClE,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AA2ID;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,GAAE,QAAyB,EACjC,OAAO,GAAE,gBAAqB,GAC7B,SAAS,CAQX;;;;AAED,wBAA2C"}

package/dist/utils/log-update.js

@@ -0,0 +1,147 @@
+/**
+ * Reck Log Update - Incremental terminal rendering
+ *
+ * Provides efficient terminal updates by only redrawing changed lines
+ */
+import { hideCursor, showCursor } from './cursor.js';
+// ANSI escape sequences
+const ESC = '\u001B[';
+const eraseLines = (count) => {
+    let result = '';
+    for (let i = 0; i < count; i++) {
+        result += ESC + '2K'; // Erase line
+        if (i < count - 1) {
+            result += ESC + '1A'; // Move cursor up
+        }
+    }
+    if (count > 0) {
+        result += '\r'; // Return to start of line
+    }
+    return result;
+};
+const cursorUp = (count) => count > 0 ? `${ESC}${count}A` : '';
+const cursorNextLine = `${ESC}1E`;
+const eraseLine = `${ESC}2K`;
+/**
+ * Create a standard log updater (full redraw)
+ */
+function createStandard(stream, options = {}) {
+    const { showCursor: showCursorOption = false } = options;
+    let previousLineCount = 0;
+    let previousOutput = '';
+    let hasHiddenCursor = false;
+    const render = (content) => {
+        if (!showCursorOption && !hasHiddenCursor) {
+            hideCursor(stream);
+            hasHiddenCursor = true;
+        }
+        const output = content + '\n';
+        if (output === previousOutput) {
+            return;
+        }
+        previousOutput = output;
+        stream.write(eraseLines(previousLineCount) + output);
+        previousLineCount = output.split('\n').length;
+    };
+    render.clear = () => {
+        stream.write(eraseLines(previousLineCount));
+        previousOutput = '';
+        previousLineCount = 0;
+    };
+    render.done = () => {
+        previousOutput = '';
+        previousLineCount = 0;
+        if (!showCursorOption && hasHiddenCursor) {
+            showCursor(stream);
+            hasHiddenCursor = false;
+        }
+    };
+    render.sync = (content) => {
+        const output = content + '\n';
+        previousOutput = output;
+        previousLineCount = output.split('\n').length;
+    };
+    return render;
+}
+/**
+ * Create an incremental log updater (only redraws changed lines)
+ * This reduces flickering and improves performance
+ */
+function createIncremental(stream, options = {}) {
+    const { showCursor: showCursorOption = false } = options;
+    let previousLines = [];
+    let previousOutput = '';
+    let hasHiddenCursor = false;
+    const render = (content) => {
+        if (!showCursorOption && !hasHiddenCursor) {
+            hideCursor(stream);
+            hasHiddenCursor = true;
+        }
+        const output = content + '\n';
+        if (output === previousOutput) {
+            return;
+        }
+        const previousCount = previousLines.length;
+        const nextLines = output.split('\n');
+        const nextCount = nextLines.length;
+        const visibleCount = nextCount - 1; // Last line is empty after split
+        // Full redraw if first render or content was empty
+        if (output === '\n' || previousOutput.length === 0) {
+            stream.write(eraseLines(previousCount) + output);
+            previousOutput = output;
+            previousLines = nextLines;
+            return;
+        }
+        // Build incremental update buffer
+        const buffer = [];
+        // Clear extra lines if new content is shorter
+        if (nextCount < previousCount) {
+            buffer.push(eraseLines(previousCount - nextCount + 1), cursorUp(visibleCount));
+        }
+        else {
+            buffer.push(cursorUp(previousCount - 1));
+        }
+        // Only redraw lines that changed
+        for (let i = 0; i < visibleCount; i++) {
+            if (nextLines[i] === previousLines[i]) {
+                buffer.push(cursorNextLine);
+                continue;
+            }
+            buffer.push(eraseLine + nextLines[i] + '\n');
+        }
+        stream.write(buffer.join(''));
+        previousOutput = output;
+        previousLines = nextLines;
+    };
+    render.clear = () => {
+        stream.write(eraseLines(previousLines.length));
+        previousOutput = '';
+        previousLines = [];
+    };
+    render.done = () => {
+        previousOutput = '';
+        previousLines = [];
+        if (!showCursorOption && hasHiddenCursor) {
+            showCursor(stream);
+            hasHiddenCursor = false;
+        }
+    };
+    render.sync = (content) => {
+        const output = content + '\n';
+        previousOutput = output;
+        previousLines = output.split('\n');
+    };
+    return render;
+}
+/**
+ * Create a log updater
+ */
+export function createLogUpdate(stream = process.stdout, options = {}) {
+    const { incremental = true } = options;
+    if (incremental) {
+        return createIncremental(stream, options);
+    }
+    return createStandard(stream, options);
+}
+export default { create: createLogUpdate };
+//# sourceMappingURL=log-update.js.map

package/dist/utils/log-update.js.map

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

package/dist/utils/text-utils.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Reck Text Utilities - ANSI-aware text manipulation
+ *
+ * Features:
+ * - Text wrapping with ANSI preservation
+ * - Text truncation (start, middle, end)
+ * - Advanced color support (named, hex, RGB, ANSI256)
+ */
+/**
+ * Strip ANSI escape codes from text
+ */
+export declare function stripAnsi(text: string): string;
+/**
+ * Get visible width of text (excluding ANSI codes)
+ * Handles wide characters (CJK, emoji) as width 2
+ */
+export declare function stringWidth(text: string): number;
+export interface WrapOptions {
+    /** Hard wrap (break words) or soft wrap (keep words intact) */
+    hard?: boolean;
+    /** Trim leading/trailing whitespace */
+    trim?: boolean;
+    /** Preserve word boundaries */
+    wordWrap?: boolean;
+}
+/**
+ * Wrap text to fit within a given width
+ * Preserves ANSI escape codes across line breaks
+ */
+export declare function wrapText(text: string, columns: number, options?: WrapOptions): string;
+export type TruncatePosition = 'start' | 'middle' | 'end';
+export interface TruncateOptions {
+    /** Where to truncate: 'start', 'middle', or 'end' */
+    position?: TruncatePosition;
+    /** Truncation character (default: '...') */
+    truncationCharacter?: string;
+    /** Add space around truncation character */
+    space?: boolean;
+    /** Prefer truncating at word boundaries */
+    preferTruncationOnSpace?: boolean;
+}
+/**
+ * Truncate text to fit within a given width
+ * Preserves ANSI escape codes
+ */
+export declare function truncateText(text: string, columns: number, options?: TruncateOptions): string;
+/**
+ * Slice ANSI string by visible character positions
+ * Preserves ANSI escape codes
+ */
+export declare function sliceAnsi(text: string, start: number, end?: number): string;
+/**
+ * Skip (remove) N visible characters from the start of ANSI string
+ * Preserves ANSI escape codes and reapplies active styles
+ *
+ *
+ *
+ * @example
+ * ```typescript
+ * skipAnsi('\u001B[31mHello\u001B[0m World', 3)
+ * // Returns: '\u001B[31mlo\u001B[0m World'
+ * ```
+ */
+export declare function skipAnsi(text: string, count: number): string;
+/**
+ * Take only N visible characters from the start of ANSI string
+ * Alias for sliceAnsi(text, 0, count) - useful for transition APIs
+ *
+ * @example
+ * ```typescript
+ * takeAnsi('\u001B[31mHello\u001B[0m World', 3)
+ * // Returns: '\u001B[31mHel\u001B[0m'
+ * ```
+ */
+export declare function takeAnsi(text: string, count: number): string;
+/**
+ * Pad string to width, preserving ANSI codes
+ * Useful for aligning columns in tables and transitions
+ */
+export declare function padAnsi(text: string, width: number, align?: 'left' | 'right' | 'center', char?: string): string;
+/**
+ * Split text into lines, handling both \n and \r\n
+ */
+export declare function splitLines(text: string): string[];
+/**
+ * Join lines with newline character
+ */
+export declare function joinLines(lines: string[]): string;
+/**
+ * Ensure text has exactly N lines (pad with empty or truncate)
+ */
+export declare function normalizeLines(text: string, lineCount: number): string[];
+/**
+ * Composite two texts horizontally for transition effects
+ * Each text is split into lines and combined side by side
+ *
+ * Used for swipe/slide transitions where both prev and next content
+ * are visible during the animation
+ *
+ * @example
+ * ```typescript
+ * // During swipe left animation at 50%
+ * const prev = 'Hello\nWorld';
+ * const next = 'Goodbye\nEarth';
+ * compositeHorizontal(prev, next, 40, 20) // 20 chars from each
+ * ```
+ */
+export declare function compositeHorizontal(left: string, right: string, totalWidth: number, splitPoint: number, gap?: number): string;
+/**
+ * Composite two texts vertically for slide up/down transitions
+ */
+export declare function compositeVertical(top: string, bottom: string, totalHeight: number, splitPoint: number, gap?: number): string;
+export type ColorType = 'foreground' | 'background';
+/**
+ * Parse a color value and return ANSI codes
+ * Supports:
+ * - Named colors (red, green, blue, etc.)
+ * - Hex colors (#fff, #ffffff)
+ * - RGB colors (rgb(255, 0, 0))
+ * - ANSI 256 colors (ansi256(196))
+ */
+export declare function colorToAnsi(color: string, type?: ColorType): string;
+/**
+ * Apply color to text
+ */
+export declare function colorize(text: string, color: string, type?: ColorType): string;
+declare const styles: {
+    reset: string;
+    bold: string;
+    dim: string;
+    italic: string;
+    underline: string;
+    inverse: string;
+    strikethrough: string;
+    boldOff: string;
+    dimOff: string;
+    italicOff: string;
+    underlineOff: string;
+    inverseOff: string;
+    strikethroughOff: string;
+};
+/**
+ * Apply text style
+ */
+export declare function style(text: string, ...styleNames: (keyof typeof styles)[]): string;
+/**
+ * Create a hyperlink (OSC 8)
+ */
+export declare function hyperlink(text: string, url: string): string;
+export { styles };
+//# sourceMappingURL=text-utils.d.ts.map

package/dist/utils/text-utils.d.ts.map

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