@evalops/maestro 0.10.51 → 0.10.53

package/dist/node_modules/@evalops/tui/dist/tui.d.ts

@@ -1,263 +0,0 @@
-import type { Terminal } from "./terminal.js";
-import { visibleWidth } from "./utils.js";
-import { type TerminalFeatures } from "./utils/terminal-features.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;
-    /**
-     * Optional method to invalidate any cached rendering state.
-     * Called when theme changes or when component needs to re-render from scratch.
-     * Components that cache rendered output should clear their caches here.
-     */
-    invalidate?(): void;
-    /**
-     * Optional lifecycle method called when component is mounted/shown.
-     * Use for subscribing to events, starting timers, etc.
-     */
-    onMount?(): void;
-    /**
-     * Optional lifecycle method called when component is unmounted/hidden.
-     * Use for unsubscribing from events, stopping timers, cleaning up resources.
-     */
-    onUnmount?(): void;
-    /**
-     * Optional cleanup method called when component is permanently destroyed.
-     * Alias for onUnmount for compatibility with dispose() pattern.
-     */
-    dispose?(): void;
-}
-/**
- * Helper type for components with full lifecycle support
- */
-export interface LifecycleComponent extends Component {
-    onMount(): void;
-    onUnmount(): void;
-}
-export { visibleWidth };
-export type RenderPath = "first" | "full" | "diff";
-export interface RenderStats {
-    totalRenders: number;
-    totalFullRenders: number;
-    totalDiffRenders: number;
-    totalRenderMs: number;
-    totalBytesWritten: number;
-    totalLinesWritten: number;
-    lastRenderMs: number;
-    lastRenderAt: number;
-    lastRenderType: RenderPath;
-    lastRenderComputeMs: number;
-    lastRenderWrapMs: number;
-    lastRenderBufferMs: number;
-    lastRenderWriteMs: number;
-    lastLinesRendered: number;
-    lastLinesWritten: number;
-    lastBytesWritten: number;
-    wrapCacheHits: number;
-    wrapCacheMisses: number;
-    avgRenderMs: number;
-    wrapCacheHitRate: number;
-}
-/**
- * Container - a component that contains other components
- */
-export declare class Container implements Component {
-    children: Component[];
-    addChild(component: Component): void;
-    removeChild(component: Component): void;
-    clear(): void;
-    /**
-     * Invalidate all children's cached rendering state.
-     * Call this when theme changes or when all components need to re-render from scratch.
-     */
-    invalidate(): void;
-    render(width: number): string[];
-}
-/**
- * TUI - Main class for managing terminal UI with differential rendering.
- *
- * ## Rendering Architecture
- *
- * The TUI uses differential rendering to minimize terminal writes:
- * 1. Components render to string[] lines
- * 2. Lines are wrapped to terminal width (cached)
- * 3. If content exceeds viewport, clip to bottom N lines (overflow)
- * 4. Compare newLines vs previousLines to find changes
- * 5. Only redraw changed lines (or full redraw if layout shifted)
- *
- * ## Render Strategies
- *
- * - **First render**: Write all lines, no clear needed
- * - **Full re-render**: Clear screen + write all (width change, overflow change, shrink)
- * - **Differential**: Move cursor to first changed line, clear+write only changes
- *
- * ## Critical Invariant
- *
- * `previousLines[i]` must always correspond to the same screen position as `newLines[i]`.
- * When overflow state changes, this invariant breaks (clipping shifts indices), so we
- * MUST do a full re-render to reset the mapping.
- */
-export declare class TUI extends Container {
-    private terminal;
-    /**
-     * Lines rendered in the previous frame. Used for diffing to determine what changed.
-     * After overflow clipping, this contains only the visible (bottom N) lines.
-     */
-    private previousLines;
-    /** Terminal width from the previous render. Used to detect resize. */
-    private previousWidth;
-    /**
-     * Whether the previous render was clipped due to overflow.
-     * When this changes, line indices shift and we must do a full re-render.
-     */
-    private overflowedLastRender;
-    /** Currently focused component that receives keyboard input. */
-    private focusedComponent;
-    /** Global callback for debug key (Shift+Ctrl+D). */
-    onDebug?: () => void;
-    /** Flag to coalesce multiple render requests into one. */
-    private renderRequested;
-    /**
-     * Current cursor row position (0-indexed, relative to TUI's first line).
-     * Used to calculate cursor movement for differential rendering.
-     * After each render, this is set to the last line rendered.
-     */
-    private cursorRow;
-    /** Minimum milliseconds between renders. Higher over SSH to reduce "repaint storms". */
-    private minRenderIntervalMs;
-    /** Baseline throttle interval (set by SSH detection or user override). */
-    private baseRenderIntervalMs;
-    /** Extra interval computed from recent render cost. */
-    private adaptiveRenderIntervalMs;
-    /** Whether to adapt throttle based on render cost. */
-    private adaptiveThrottle;
-    /** Max adaptive delay to avoid stalls. */
-    private static readonly MAX_ADAPTIVE_INTERVAL_MS;
-    private static readonly MAX_DIFF_LINES;
-    private static readonly MAX_DIFF_CHANGED_LINES;
-    private static readonly MAX_DIFF_CHANGE_RATIO;
-    /** Timestamp of the last render (for throttling). */
-    private lastRenderTs;
-    /** Timestamp of the last full re-render (cleared screen). */
-    private lastFullRenderTs;
-    /** Timer for throttled render scheduling. */
-    private renderTimer;
-    /** Detected terminal capabilities (SSH, sync output support, etc). */
-    private features;
-    /** Whether to use synchronized output (DECSET 2026) to prevent tearing. */
-    private syncOutput;
-    /** Handler called on Ctrl+C or Esc for interrupt behavior. */
-    private interruptHandler?;
-    /** Optional callback invoked after each render with the rendered lines. */
-    private onRender?;
-    /** Whether an overlay (alt screen) is currently active. */
-    private overlayActive;
-    /**
-     * Cache for line wrapping results. Map<width, Map<lineContent, wrappedLines[]>>.
-     * Avoids re-wrapping unchanged lines on every render.
-     */
-    private wrapCache;
-    /** Maximum entries per width in the wrap cache to prevent unbounded growth. */
-    private static readonly MAX_WRAP_CACHE_ENTRIES;
-    private renderStats;
-    /**
-     * When true, disables automatic overflow clipping.
-     * Use this when a ScrollContainer handles viewport clipping.
-     */
-    private disableAutoClip;
-    constructor(terminal: Terminal, features?: TerminalFeatures);
-    setInterruptHandler(handler?: () => void): void;
-    /**
-     * Set a callback to be invoked after each render.
-     * Useful for forwarding rendered content to native TUI.
-     */
-    setRenderCallback(callback?: (lines: string[], width: number) => void): void;
-    setMinRenderInterval(ms: number): void;
-    setAdaptiveThrottle(enabled: boolean): void;
-    /**
-     * Toggle synchronized output (DECSET 2026) at runtime. Useful for live user toggles
-     * without restarting the TUI. The feature flag still gates support detection.
-     */
-    setSyncOutput(enabled: boolean): void;
-    /**
-     * Disables automatic overflow clipping, allowing a ScrollContainer
-     * to handle viewport management instead.
-     *
-     * When enabled, the TUI will render all content lines without clipping,
-     * expecting the content itself (via ScrollContainer) to manage what's visible.
-     */
-    setAutoClip(enabled: boolean): void;
-    /**
-     * Returns the current terminal dimensions.
-     * Useful for ScrollContainer to know viewport size.
-     */
-    getTerminalSize(): {
-        columns: number;
-        rows: number;
-    };
-    getRenderStats(): RenderStats;
-    resetRenderStats(): void;
-    setFocus(component: Component | null): void;
-    /**
-     * Invalidate all cached rendering state and force a full re-render.
-     *
-     * Call this when:
-     * - Theme changes (colors, styles need to be re-applied)
-     * - Global state changes that affect all components
-     * - After hot-reloading component code
-     *
-     * This clears the TUI's wrap cache and calls invalidate() on all child
-     * components, then triggers a render.
-     */
-    invalidateAll(): void;
-    start(): void;
-    /**
-     * Render a transient overlay in an alternate screen, then restore the inline view.
-     * Useful for pagers/diffs when running over SSH so scrollback is preserved.
-     */
-    renderOverlay(render: (width: number, height: number) => string[]): void;
-    stop(): void;
-    requestRender(priority?: "normal" | "interactive"): void;
-    private handleInput;
-    /**
-     * Core rendering method. Chooses between full and differential rendering strategies.
-     *
-     * ## Algorithm Overview
-     *
-     * 1. Render all components to lines, wrap to terminal width
-     * 2. If content exceeds viewport height, clip to bottom N lines (overflow)
-     * 3. Detect if layout changed significantly (width, overflow state, shrink)
-     * 4. If significant change → full re-render (clear screen, write all)
-     * 5. Otherwise → differential render (find changed lines, update only those)
-     *
-     * ## Why Overflow Changes Require Full Re-render
-     *
-     * When overflow state changes, the clipping shifts which lines are visible:
-     *
-     * ```
-     * Before (5 lines, no overflow):    After (15 lines, clipped to 10):
-     * previousLines[0] = actual line 0   newLines[0] = actual line 5 (!)
-     * previousLines[1] = actual line 1   newLines[1] = actual line 6
-     * ...                                ...
-     * ```
-     *
-     * If we did differential rendering, we'd compare previousLines[0] to newLines[0],
-     * but they represent DIFFERENT content positions. The cursor movement would be
-     * wrong, causing duplicated/overlapping content. Hence: always full re-render
-     * when overflow state changes.
-     */
-    private doRender;
-    private wrapWithCache;
-    private updateAdaptiveInterval;
-}
-//# sourceMappingURL=tui.d.ts.map

package/dist/node_modules/@evalops/tui/dist/tui.d.ts.map

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