@elizaos/tui 2.0.0-alpha.10

package/dist/themes/index.js

@@ -0,0 +1,161 @@
+/**
+ * TUI Themes System
+ *
+ * Provides built-in color schemes and theming utilities.
+ */
+// ANSI color code helpers
+const ansi = {
+    // Reset
+    reset: "\x1b[0m",
+    // Styles
+    bold: (text) => `\x1b[1m${text}\x1b[22m`,
+    dim: (text) => `\x1b[2m${text}\x1b[22m`,
+    italic: (text) => `\x1b[3m${text}\x1b[23m`,
+    underline: (text) => `\x1b[4m${text}\x1b[24m`,
+    // Basic colors (foreground)
+    black: (text) => `\x1b[30m${text}\x1b[39m`,
+    red: (text) => `\x1b[31m${text}\x1b[39m`,
+    green: (text) => `\x1b[32m${text}\x1b[39m`,
+    yellow: (text) => `\x1b[33m${text}\x1b[39m`,
+    blue: (text) => `\x1b[34m${text}\x1b[39m`,
+    magenta: (text) => `\x1b[35m${text}\x1b[39m`,
+    cyan: (text) => `\x1b[36m${text}\x1b[39m`,
+    white: (text) => `\x1b[37m${text}\x1b[39m`,
+    gray: (text) => `\x1b[90m${text}\x1b[39m`,
+    // Bright colors (foreground)
+    brightRed: (text) => `\x1b[91m${text}\x1b[39m`,
+    brightGreen: (text) => `\x1b[92m${text}\x1b[39m`,
+    brightYellow: (text) => `\x1b[93m${text}\x1b[39m`,
+    brightBlue: (text) => `\x1b[94m${text}\x1b[39m`,
+    brightMagenta: (text) => `\x1b[95m${text}\x1b[39m`,
+    brightCyan: (text) => `\x1b[96m${text}\x1b[39m`,
+    brightWhite: (text) => `\x1b[97m${text}\x1b[39m`,
+    // Background colors
+    bgBlack: (text) => `\x1b[40m${text}\x1b[49m`,
+    bgRed: (text) => `\x1b[41m${text}\x1b[49m`,
+    bgGreen: (text) => `\x1b[42m${text}\x1b[49m`,
+    bgYellow: (text) => `\x1b[43m${text}\x1b[49m`,
+    bgBlue: (text) => `\x1b[44m${text}\x1b[49m`,
+    bgMagenta: (text) => `\x1b[45m${text}\x1b[49m`,
+    bgCyan: (text) => `\x1b[46m${text}\x1b[49m`,
+    bgWhite: (text) => `\x1b[47m${text}\x1b[49m`,
+    bgGray: (text) => `\x1b[100m${text}\x1b[49m`,
+    // 256-color support
+    fg256: (code) => (text) => `\x1b[38;5;${code}m${text}\x1b[39m`,
+    bg256: (code) => (text) => `\x1b[48;5;${code}m${text}\x1b[49m`,
+    // True color (24-bit) support
+    fgRgb: (r, g, b) => (text) => `\x1b[38;2;${r};${g};${b}m${text}\x1b[39m`,
+    bgRgb: (r, g, b) => (text) => `\x1b[48;2;${r};${g};${b}m${text}\x1b[49m`,
+};
+// Compose multiple style functions
+const compose = (...fns) => (text) => fns.reduce((t, fn) => fn(t), text);
+/** Identity function for no-op styling */
+const identity = (text) => text;
+/**
+ * Default theme with standard terminal colors.
+ */
+export const defaultTheme = {
+    name: "default",
+    description: "Standard terminal colors",
+    colors: {
+        primary: ansi.cyan,
+        secondary: ansi.blue,
+        accent: ansi.magenta,
+        success: ansi.green,
+        warning: ansi.yellow,
+        error: ansi.red,
+        info: ansi.cyan,
+        text: identity,
+        textMuted: ansi.gray,
+        textBold: ansi.bold,
+        background: identity,
+        backgroundAlt: ansi.bgGray,
+        border: ansi.gray,
+        borderFocused: ansi.cyan,
+    },
+};
+/**
+ * Dark theme with deeper colors.
+ */
+export const darkTheme = {
+    name: "dark",
+    description: "Dark theme with deep colors",
+    colors: {
+        primary: ansi.brightCyan,
+        secondary: ansi.brightBlue,
+        accent: ansi.brightMagenta,
+        success: ansi.brightGreen,
+        warning: ansi.brightYellow,
+        error: ansi.brightRed,
+        info: ansi.brightCyan,
+        text: ansi.white,
+        textMuted: ansi.gray,
+        textBold: compose(ansi.white, ansi.bold),
+        background: ansi.bgBlack,
+        backgroundAlt: ansi.bgGray,
+        border: ansi.gray,
+        borderFocused: ansi.brightCyan,
+    },
+};
+/**
+ * Minimal theme with subtle styling.
+ */
+export const minimalTheme = {
+    name: "minimal",
+    description: "Minimal theme with subtle styling",
+    colors: {
+        primary: ansi.white,
+        secondary: ansi.gray,
+        accent: ansi.white,
+        success: ansi.green,
+        warning: ansi.yellow,
+        error: ansi.red,
+        info: ansi.gray,
+        text: identity,
+        textMuted: ansi.dim,
+        textBold: ansi.bold,
+        background: identity,
+        backgroundAlt: identity,
+        border: ansi.gray,
+        borderFocused: ansi.white,
+    },
+};
+/**
+ * Ocean theme with blue tones.
+ */
+export const oceanTheme = {
+    name: "ocean",
+    description: "Ocean-inspired blue tones",
+    colors: {
+        primary: ansi.fg256(39),
+        secondary: ansi.fg256(75),
+        accent: ansi.fg256(45),
+        success: ansi.fg256(42),
+        warning: ansi.fg256(214),
+        error: ansi.fg256(203),
+        info: ansi.fg256(39),
+        text: ansi.fg256(255),
+        textMuted: ansi.fg256(245),
+        textBold: compose(ansi.fg256(255), ansi.bold),
+        background: ansi.bg256(17),
+        backgroundAlt: ansi.bg256(24),
+        border: ansi.fg256(39),
+        borderFocused: ansi.fg256(45),
+    },
+};
+/**
+ * Available built-in themes.
+ */
+export const themes = {
+    default: defaultTheme,
+    dark: darkTheme,
+    minimal: minimalTheme,
+    ocean: oceanTheme,
+};
+export function getTheme(name) {
+    return themes[name];
+}
+/**
+ * Export ANSI helpers for custom theme creation.
+ */
+export { ansi, compose };

package/dist/tui.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Minimal TUI implementation with differential rendering
+ */
+import type { Terminal } from "./terminal.js";
+import { visibleWidth } from "./utils.js";
+export type { Component, Focusable, OverlayAnchor, OverlayEntry, OverlayHandle, OverlayMargin, OverlayOptions, SizeValue, } from "./core/types.js";
+export { CURSOR_MARKER, isFocusable } from "./core/types.js";
+export { Container } from "./core/container.js";
+export { isOverlayVisible, parseSizeValue, resolveAnchorCol, resolveAnchorRow, resolveOverlayLayout, } from "./core/overlay.js";
+export { visibleWidth };
+import type { Component, OverlayHandle, OverlayOptions } from "./core/types.js";
+import { Container } from "./core/container.js";
+/**
+ * TUI - Main class for managing terminal UI with differential rendering
+ */
+export declare class TUI extends Container {
+    terminal: Terminal;
+    private previousLines;
+    private previousWidth;
+    private focusedComponent;
+    /** Global callback for debug key (Shift+Ctrl+D). Called before input is forwarded to focused component. */
+    onDebug?: () => void;
+    private renderRequested;
+    private cursorRow;
+    private hardwareCursorRow;
+    private inputBuffer;
+    private cellSizeQueryPending;
+    private showHardwareCursor;
+    private clearOnShrink;
+    private maxLinesRendered;
+    private previousViewportTop;
+    private fullRedrawCount;
+    private stopped;
+    private overlayStack;
+    constructor(terminal: Terminal, showHardwareCursor?: boolean);
+    get fullRedraws(): number;
+    getShowHardwareCursor(): boolean;
+    setShowHardwareCursor(enabled: boolean): void;
+    getClearOnShrink(): boolean;
+    /**
+     * Set whether to trigger full re-render when content shrinks.
+     * When true (default), empty rows are cleared when content shrinks.
+     * When false, empty rows remain (reduces redraws on slower terminals).
+     */
+    setClearOnShrink(enabled: boolean): void;
+    setFocus(component: Component | null): void;
+    /**
+     * Show an overlay component with configurable positioning and sizing.
+     * Returns a handle to control the overlay's visibility.
+     */
+    showOverlay(component: Component, options?: OverlayOptions): OverlayHandle;
+    /** Hide the topmost overlay and restore previous focus. */
+    hideOverlay(): void;
+    /** Check if there are any visible overlays */
+    hasOverlay(): boolean;
+    /** Check if an overlay entry is currently visible */
+    private isOverlayVisible;
+    /** Find the topmost visible overlay, if any */
+    private getTopmostVisibleOverlay;
+    invalidate(): void;
+    start(): void;
+    private queryCellSize;
+    stop(): void;
+    requestRender(force?: boolean): void;
+    private handleInput;
+    private parseCellSizeResponse;
+    /** Composite all overlays into content lines (in stack order, later = on top). */
+    private compositeOverlays;
+    private static readonly SEGMENT_RESET;
+    private applyLineResets;
+    /** Splice overlay content into a base line at a specific column. Single-pass optimized. */
+    private compositeLineAt;
+    /**
+     * Find and extract cursor position from rendered lines.
+     * Searches for CURSOR_MARKER, calculates its position, and strips it from the output.
+     * Only scans the bottom terminal height lines (visible viewport).
+     * @param lines - Rendered lines to search
+     * @param height - Terminal height (visible viewport size)
+     * @returns Cursor position { row, col } or null if no marker found
+     */
+    private extractCursorPosition;
+    private doRender;
+    /**
+     * Position the hardware cursor for IME candidate window.
+     * @param cursorPos The cursor position extracted from rendered output, or null
+     * @param totalLines Total number of rendered lines
+     */
+    private positionHardwareCursor;
+}
+//# sourceMappingURL=tui.d.ts.map

package/dist/tui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../src/tui.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAkD,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1F,YAAY,EACX,SAAS,EACT,SAAS,EACT,aAAa,EACb,YAAY,EACZ,aAAa,EACb,aAAa,EACb,cAAc,EACd,SAAS,GACT,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EACN,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,YAAY,EAAE,CAAC;AAGxB,OAAO,KAAK,EAAE,SAAS,EAAgB,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE9F,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAQhD;;GAEG;AACH,qBAAa,GAAI,SAAQ,SAAS;IAC1B,QAAQ,EAAE,QAAQ,CAAC;IAC1B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,gBAAgB,CAA0B;IAElD,2GAA2G;IACpG,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,kBAAkB,CAA2C;IACrE,OAAO,CAAC,aAAa,CAA2C;IAChE,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,OAAO,CAAS;IAGxB,OAAO,CAAC,YAAY,CAAsB;gBAE9B,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,CAAC,EAAE,OAAO;IAQ5D,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,qBAAqB,IAAI,OAAO;IAIhC,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAS7C,gBAAgB,IAAI,OAAO;IAI3B;;;;OAIG;IACH,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIxC,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,GAAG,IAAI;IAc3C;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,aAAa;IA+C1E,2DAA2D;IAC3D,WAAW,IAAI,IAAI;IAUnB,8CAA8C;IAC9C,UAAU,IAAI,OAAO;IAIrB,qDAAqD;IACrD,OAAO,CAAC,gBAAgB;IAIxB,+CAA+C;IAC/C,OAAO,CAAC,wBAAwB;IASvB,UAAU,IAAI,IAAI;IAK3B,KAAK,IAAI,IAAI;IAWb,OAAO,CAAC,aAAa;IAWrB,IAAI,IAAI,IAAI;IAkBZ,aAAa,CAAC,KAAK,UAAQ,GAAG,IAAI;IAiBlC,OAAO,CAAC,WAAW;IAyCnB,OAAO,CAAC,qBAAqB;IA4C7B,kFAAkF;IAClF,OAAO,CAAC,iBAAiB;IAuEzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAyB;IAE9D,OAAO,CAAC,eAAe;IAWvB,2FAA2F;IAC3F,OAAO,CAAC,eAAe;IAkDvB;;;;;;;OAOG;IACH,OAAO,CAAC,qBAAqB;IAoB7B,OAAO,CAAC,QAAQ;IA6ShB;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;CAgC9B"}