indusagi 0.12.23 → 0.12.26

package/dist/ui/tui.d.ts

@@ -1,250 +0,0 @@
-/**
- * Minimal TUI implementation with differential rendering
- */
-import type { Terminal } from "./terminal.js";
-import { visibleWidth } from "./utils.js";
-/**
- * Component interface - all components must implement this
- */
-export interface Component {
-    /**
-     * Render the component to lines for the given viewport width
-     * @param width - Current viewport width
-     * @returns Array of strings, each representing a line
-     */
-    render(width: number): string[];
-    /**
-     * Optional handler for keyboard input when component has focus
-     */
-    handleInput?(data: string): void;
-    /**
-     * If true, component receives key release events (Kitty protocol).
-     * Default is false - release events are filtered out.
-     */
-    wantsKeyRelease?: boolean;
-    /**
-     * Invalidate any cached rendering state.
-     * Called when theme changes or when component needs to re-render from scratch.
-     */
-    invalidate(): void;
-    onMount?(): void;
-    onUnmount?(): void;
-    onFocus?(): void;
-    onBlur?(): void;
-}
-export declare abstract class ComponentBase implements Component {
-    private _cachedWidth?;
-    private _cachedRender?;
-    wantsKeyRelease?: boolean;
-    abstract render(width: number): string[];
-    handleInput?(data: string): void;
-    onMount?(): void;
-    onUnmount?(): void;
-    onFocus?(): void;
-    onBlur?(): void;
-    invalidate(): void;
-    protected renderCached(width: number, renderFn: () => string[]): string[];
-}
-/**
- * Interface for components that can receive focus and display a hardware cursor.
- * When focused, the component should emit CURSOR_MARKER at the cursor position
- * in its render output. TUI will find this marker and position the hardware
- * cursor there for proper IME candidate window positioning.
- */
-export interface Focusable {
-    /** Set by TUI when focus changes. Component should emit CURSOR_MARKER when true. */
-    focused: boolean;
-}
-/** Type guard to check if a component implements Focusable */
-export declare function isFocusable(component: Component | null): component is Component & Focusable;
-/**
- * Cursor position marker - APC (Application Program Command) sequence.
- * This is a zero-width escape sequence that terminals ignore.
- * Components emit this at the cursor position when focused.
- * TUI finds and strips this marker, then positions the hardware cursor there.
- */
-export declare const CURSOR_MARKER = "\u001B_pi:c\u0007";
-type InputListenerResult = {
-    consume?: boolean;
-    data?: string;
-} | undefined;
-type InputListener = (data: string) => InputListenerResult;
-export { visibleWidth };
-/**
- * Anchor position for overlays
- */
-export type OverlayAnchor = "center" | "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top-center" | "bottom-center" | "left-center" | "right-center";
-/**
- * Margin configuration for overlays
- */
-export interface OverlayMargin {
-    top?: number;
-    right?: number;
-    bottom?: number;
-    left?: number;
-}
-/** Value that can be absolute (number) or percentage (string like "50%") */
-export type SizeValue = number | `${number}%`;
-/**
- * Options for overlay positioning and sizing.
- * Values can be absolute numbers or percentage strings (e.g., "50%").
- */
-export interface OverlayOptions {
-    /** Width in columns, or percentage of terminal width (e.g., "50%") */
-    width?: SizeValue;
-    /** Minimum width in columns */
-    minWidth?: number;
-    /** Maximum height in rows, or percentage of terminal height (e.g., "50%") */
-    maxHeight?: SizeValue;
-    /** Anchor point for positioning (default: 'center') */
-    anchor?: OverlayAnchor;
-    /** Horizontal offset from anchor position (positive = right) */
-    offsetX?: number;
-    /** Vertical offset from anchor position (positive = down) */
-    offsetY?: number;
-    /** Row position: absolute number, or percentage (e.g., "25%" = 25% from top) */
-    row?: SizeValue;
-    /** Column position: absolute number, or percentage (e.g., "50%" = centered horizontally) */
-    col?: SizeValue;
-    /** Margin from terminal edges. Number applies to all sides. */
-    margin?: OverlayMargin | number;
-    /**
-     * Control overlay visibility based on terminal dimensions.
-     * If provided, overlay is only rendered when this returns true.
-     * Called each render cycle with current terminal dimensions.
-     */
-    visible?: (termWidth: number, termHeight: number) => boolean;
-}
-/**
- * Handle returned by showOverlay for controlling the overlay
- */
-export interface OverlayHandle {
-    /** Permanently remove the overlay (cannot be shown again) */
-    hide(): void;
-    /** Temporarily hide or show the overlay */
-    setHidden(hidden: boolean): void;
-    /** Check if overlay is temporarily hidden */
-    isHidden(): boolean;
-}
-export declare class FocusManager {
-    private focused;
-    setFocus(component: Component | null): {
-        previous: Component | null;
-        current: Component | null;
-    };
-    getFocus(): Component | null;
-}
-export declare class RenderEngine {
-    diffLines(oldLines: string[], newLines: string[]): {
-        firstChanged: number;
-        lastChanged: number;
-        appended: boolean;
-    };
-}
-export declare class LayoutEngine {
-    resolveOverlayLayout(options: OverlayOptions | undefined, overlayHeight: number, termWidth: number, termHeight: number): {
-        width: number;
-        row: number;
-        col: number;
-        maxHeight: number | undefined;
-    };
-    private resolveAnchorRow;
-    private resolveAnchorCol;
-}
-/**
- * Container - a component that contains other components
- */
-export declare class Container extends ComponentBase {
-    children: Component[];
-    addChild(component: Component): void;
-    removeChild(component: Component): void;
-    clear(): void;
-    invalidate(): void;
-    render(width: number): string[];
-}
-/**
- * TUI - Main class for managing terminal UI with differential rendering
- */
-export declare class TUI extends Container {
-    terminal: Terminal;
-    private previousLines;
-    private previousWidth;
-    private focusedComponent;
-    private inputListeners;
-    private readonly focusManager;
-    private readonly renderEngine;
-    private readonly layoutEngine;
-    private readonly inputDispatcher;
-    private readonly overlayRegistry;
-    /** 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 maxLinesRendered;
-    private previousViewportTop;
-    private fullRedrawCount;
-    constructor(terminal: Terminal, showHardwareCursor?: boolean);
-    get fullRedraws(): number;
-    getShowHardwareCursor(): boolean;
-    setShowHardwareCursor(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;
-    addInputListener(listener: InputListener): () => void;
-    removeInputListener(listener: InputListener): void;
-    private queryCellSize;
-    stop(): void;
-    requestRender(force?: boolean): void;
-    handleInput(data: string): void;
-    private parseCellSizeResponse;
-    private containsImage;
-    /**
-     * Resolve overlay layout from options.
-     * Returns { width, row, col, maxHeight } for rendering.
-     */
-    private resolveOverlayLayout;
-    /** Composite all overlays into content lines (in stack order, later = on top). */
-    private compositeOverlays;
-    private collectRenderedOverlays;
-    private ensureOverlayWorkingHeight;
-    private compositeRenderedOverlays;
-    private clampCompositeWidth;
-    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.
-     * @returns Cursor position { row, col } or null if no marker found
-     */
-    private extractCursorPosition;
-    private renderFullFrame;
-    private prepareRenderFrame;
-    private computeRenderDiff;
-    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/ui/tui.d.ts.map

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