@sayknow-cli/tui 0.3.16 → 0.4.1

package/dist/types/terminal-capabilities.d.ts

@@ -1,187 +0,0 @@
-export declare enum ImageProtocol {
-    Kitty = "\u001B_G",
-    Iterm2 = "\u001B]1337;File=",
-    Sixel = "\u001BPq"
-}
-export declare enum NotifyProtocol {
-    Bell = "\u0007",
-    Osc99 = "\u001B]99;;",
-    Osc9 = "\u001B]9;"
-}
-export type TerminalId = "kitty" | "ghostty" | "wezterm" | "iterm2" | "vscode" | "alacritty" | "base" | "trueColor";
-/** Terminal capability details used for rendering and protocol selection. */
-export declare class TerminalInfo {
-    readonly id: TerminalId;
-    readonly imageProtocol: ImageProtocol | null;
-    readonly trueColor: boolean;
-    readonly hyperlinks: boolean;
-    readonly notifyProtocol: NotifyProtocol;
-    constructor(id: TerminalId, imageProtocol: ImageProtocol | null, trueColor: boolean, hyperlinks: boolean, notifyProtocol?: NotifyProtocol);
-    isImageLine(line: string): boolean;
-    formatNotification(message: string): string;
-    sendNotification(message: string): void;
-}
-export declare function isNotificationSuppressed(): boolean;
-/**
- * Returns whether the process runs under a terminal multiplexer (tmux, GNU
- * screen, or zellij). Recognizes the same host markers as the renderer's
- * multiplexer predicate in tui.ts so capability selection and viewport-repaint
- * policy agree on what counts as a multiplexed host. Multiplexers intercept
- * graphics escapes and OSC 8 hyperlinks instead of forwarding them to the
- * outer terminal.
- */
-export declare function isUnderTerminalMultiplexer(env?: NodeJS.ProcessEnv): boolean;
-export interface TerminalGraphicsFallbackOptions {
-    /**
-     * Permit cursor-neutral image escapes (kitty `a=p,C=1` placements) to render
-     * inside this fallback scope. Cursor-advancing protocols (iTerm2/SIXEL)
-     * remain suppressed. A nested scope without this option revokes the
-     * permission for its own subtree.
-     */
-    allowCursorNeutralImages?: boolean;
-}
-/**
- * Synchronously suppress terminal graphics while rendering a text-only surface.
- * Nested scopes remain active until the outermost scope exits.
- */
-export declare function withTerminalGraphicsFallback<T>(fn: () => T, options?: TerminalGraphicsFallbackOptions): T;
-/** Returns whether terminal graphics are currently suppressed by a render scope. */
-export declare function isTerminalGraphicsFallbackActive(): boolean;
-/**
- * Returns whether cursor-neutral image escapes may render despite an active
- * graphics-fallback scope. True only when every active fallback scope opted in.
- */
-export declare function isCursorNeutralImagePermittedInFallback(): boolean;
-/**
- * Returns whether PI_FORCE_IMAGE_PROTOCOL explicitly configures the image
- * protocol, including an explicit "off". An explicit configuration is
- * authoritative: runtime capability probes must not override it.
- */
-export declare function isImageProtocolForced(): boolean;
-/**
- * Returns true when running in Windows Terminal with known SIXEL support.
- *
- * Windows Terminal introduced SIXEL support in preview 1.22.
- */
-export declare function isWindowsTerminalPreviewSixelSupported(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): boolean;
-export declare const TERMINAL_ID: TerminalId;
-export declare const TERMINAL: TerminalInfo;
-type ImageProtocolChangeListener = (imageProtocol: ImageProtocol | null) => void;
-/**
- * Subscribe to runtime image-protocol changes (e.g. the asynchronous sixel
- * capability probe enabling graphics after startup). Returns an unsubscribe
- * function. Listeners fire only on actual changes.
- */
-export declare function onImageProtocolChanged(listener: ImageProtocolChangeListener): () => void;
-/**
- * Override terminal image protocol at runtime after capability probes complete.
- */
-export declare function setTerminalImageProtocol(imageProtocol: ImageProtocol | null): void;
-export declare function getTerminalInfo(terminalId: TerminalId): TerminalInfo;
-export interface CellDimensions {
-    widthPx: number;
-    heightPx: number;
-}
-export interface ImageDimensions {
-    widthPx: number;
-    heightPx: number;
-}
-export interface ImageRenderOptions {
-    maxWidthCells?: number;
-    maxHeightCells?: number;
-    preserveAspectRatio?: boolean;
-    /**
-     * Kitty-only: stable placement id (`p=`). Re-emitting the same image id +
-     * placement id *replaces* the existing placement instead of stacking a new
-     * copy, which makes diff-renderer repaints idempotent. Callers that render
-     * a persistent component should allocate one id per component instance.
-     */
-    placementId?: number;
-    /**
-     * Kitty-only: stable image id (`i=`). Defaults to a content hash of the
-     * base64 payload ({@link kittyImageId}). Pass a precomputed id to avoid
-     * re-hashing large payloads on every render.
-     */
-    imageId?: number;
-    /**
-     * Kitty-only: sink for the out-of-band data transmission (`a=t`) emitted
-     * the first time an image id is rendered. Defaults to the process-wide
-     * writer configured via {@link setKittyTransmitWriter} (stdout).
-     */
-    onTransmit?: (sequence: string) => void;
-}
-/**
- * Derive a stable 32-bit non-zero kitty image id (`i=`) from image content
- * (FNV-1a over the base64 payload). Identical content maps to the same id, so
- * retransmission replaces the stored image instead of accumulating copies.
- */
-export declare function kittyImageId(base64Data: string): number;
-export declare function getCellDimensions(): CellDimensions;
-export declare function setCellDimensions(dims: CellDimensions): void;
-export declare function encodeKitty(base64Data: string, options?: {
-    columns?: number;
-    rows?: number;
-    imageId?: number;
-    placementId?: number;
-}): string;
-/** Test hook: forget which kitty image ids were transmitted. */
-export declare function resetKittyTransmissions(): void;
-/**
- * Override where out-of-band kitty data transmissions (`a=t`) are written.
- * The default writes directly to stdout: a transmit-only escape is
- * cursor-neutral (it uploads pixel data without drawing anything), so the
- * only ordering requirement is that it reaches the terminal before the
- * placement escape that references it — which the synchronous write during
- * render guarantees. Tests use this to capture transmissions.
- */
-export declare function setKittyTransmitWriter(writer: (sequence: string) => void): void;
-/**
- * Encode a kitty transmit-only (`a=t`) escape: uploads image data under a
- * stable id without creating a placement. Chunked at 4096 bytes per spec.
- *
- * This is deliberately separate from placement: re-sending data (`a=t`/`a=T`)
- * for an existing image id deletes the image and ALL of its placements, so
- * data must be uploaded exactly once per id and repaints must go through
- * {@link encodeKittyPlacement} only.
- */
-export declare function encodeKittyTransmit(base64Data: string, imageId: number): string;
-/**
- * Encode a kitty placement-only (`a=p`) escape referencing previously
- * transmitted data. Re-emitting the same i=/p= pair replaces that one
- * placement (never stacks, never touches sibling placements), and C=1
- * keeps the cursor where it is so the escape can be emitted from the
- * component's first row without cursor-up tricks.
- */
-export declare function encodeKittyPlacement(options: {
-    imageId: number;
-    placementId: number;
-    columns: number;
-    rows: number;
-}): string;
-export declare function encodeITerm2(base64Data: string, options?: {
-    width?: number | string;
-    height?: number | string;
-    name?: string;
-    preserveAspectRatio?: boolean;
-    inline?: boolean;
-}): string;
-export declare function calculateImageRows(imageDimensions: ImageDimensions, targetWidthCells: number, cellDimensions?: CellDimensions): number;
-export declare function getPngDimensions(base64Data: string): ImageDimensions | null;
-export declare function getJpegDimensions(base64Data: string): ImageDimensions | null;
-export declare function getGifDimensions(base64Data: string): ImageDimensions | null;
-export declare function getWebpDimensions(base64Data: string): ImageDimensions | null;
-export declare function getImageDimensions(base64Data: string, mimeType: string): ImageDimensions | null;
-export interface RenderedImage {
-    sequence: string;
-    rows: number;
-    /**
-     * True when the escape neither moves the cursor nor carries pixel data
-     * (kitty `a=p,C=1` placements). Cursor-neutral sequences can be emitted
-     * from the component's first row; cursor-advancing protocols
-     * (iTerm2/SIXEL) must draw from the last reserved row instead.
-     */
-    cursorNeutral?: boolean;
-}
-export declare function renderImage(base64Data: string, imageDimensions: ImageDimensions, options?: ImageRenderOptions): RenderedImage | null;
-export declare function imageFallback(mimeType: string, dimensions?: ImageDimensions, filename?: string): string;
-export {};

package/dist/types/terminal.d.ts

@@ -1,90 +0,0 @@
-/**
- * Whether SKC may reprogram the keyboard with enhanced input protocols
- * (the Kitty keyboard protocol and the xterm modifyOtherKeys fallback).
- *
- * Enabled by default. Set `SKC_TUI_KEYBOARD_PROTOCOL=0` to leave the keyboard in
- * its default mode. Some terminals — notably Android Termius — break IME
- * composition (e.g. Korean/Hangul syllable composition) while these enhanced
- * modes are active, committing every intermediate composing jamo/syllable
- * instead of only the final character. Disabling the protocol restores normal
- * IME behavior, matching how other TUIs that leave the keyboard untouched render
- * Korean correctly.
- */
-export declare function keyboardEnhancementEnabled(): boolean;
-/** Error codes for terminal/pipe write failures that should never crash the process. */
-export declare function isBenignTerminalWriteError(err: unknown): boolean;
-/**
- * Emergency terminal restore - call this from signal/crash handlers
- * Resets terminal state without requiring access to the ProcessTerminal instance
- */
-export declare function emergencyTerminalRestore(): void;
-/** Terminal-reported appearance (dark/light mode). */
-export type TerminalAppearance = "dark" | "light";
-export interface Terminal {
-    start(onInput: (data: string) => void, onResize: () => void): void;
-    stop(): void;
-    /**
-     * Drain stdin before exiting to prevent Kitty key release events from
-     * leaking to the parent shell over slow SSH connections.
-     * @param maxMs - Maximum time to drain (default: 1000ms)
-     * @param idleMs - Exit early if no input arrives within this time (default: 50ms)
-     */
-    drainInput(maxMs?: number, idleMs?: number): Promise<void>;
-    write(data: string): void;
-    get available(): boolean;
-    readonly isProcessTerminal?: boolean;
-    get columns(): number;
-    get rows(): number;
-    get kittyProtocolActive(): boolean;
-    moveBy(lines: number): void;
-    hideCursor(): void;
-    showCursor(): void;
-    clearLine(): void;
-    clearFromCursor(): void;
-    clearScreen(): void;
-    setTitle(title: string): void;
-    setProgress(active: boolean): void;
-    /**
-     * Register a callback for terminal appearance (dark/light) changes.
-     * Detection uses OSC 11 background color query with Mode 2031 as a change trigger.
-     * Fires when the detected appearance changes, including the initial detection.
-     */
-    onAppearanceChange(callback: (appearance: TerminalAppearance) => void): void;
-    /** The last detected terminal appearance, or undefined if not yet known. */
-    get appearance(): TerminalAppearance | undefined;
-}
-interface TerminalSizeStream {
-    columns?: number;
-    rows?: number;
-    getWindowSize?: () => [number, number] | number[];
-}
-export declare function resolveTerminalColumns(stream?: TerminalSizeStream, envColumns?: string | undefined): number;
-export declare function resolveTerminalRows(stream?: TerminalSizeStream, envRows?: string | undefined): number;
-/**
- * Real terminal using process.stdin/stdout
- */
-export declare class ProcessTerminal implements Terminal {
-    #private;
-    get isProcessTerminal(): boolean;
-    get kittyProtocolActive(): boolean;
-    get appearance(): TerminalAppearance | undefined;
-    onAppearanceChange(callback: (appearance: TerminalAppearance) => void): void;
-    start(onInput: (data: string) => void, onResize: () => void): void;
-    drainInput(maxMs?: number, idleMs?: number): Promise<void>;
-    stop(): void;
-    write(data: string): void;
-    /** Invoked by the durable module-level stdout write guard (see installStdoutWriteGuard). */
-    markStdoutUnavailable(err: unknown): void;
-    get available(): boolean;
-    get columns(): number;
-    get rows(): number;
-    moveBy(lines: number): void;
-    hideCursor(): void;
-    showCursor(): void;
-    clearLine(): void;
-    clearFromCursor(): void;
-    clearScreen(): void;
-    setTitle(title: string): void;
-    setProgress(active: boolean): void;
-}
-export {};

package/dist/types/ttyid.d.ts

@@ -1,9 +0,0 @@
-/** Resolve the TTY device path for stdin (fd 0) via POSIX `ttyname(3)`. */
-export declare function getTtyPath(): string | null;
-/**
- * Get a stable identifier for the current terminal.
- * Uses the TTY device path (e.g., /dev/pts/3), falling back to environment
- * variables for terminal multiplexers or terminal emulators.
- * Returns null if no terminal can be identified (e.g., piped input).
- */
-export declare function getTerminalId(): string | null;

package/dist/types/tui.d.ts

@@ -1,269 +0,0 @@
-import type { Terminal } from "./terminal";
-import { visibleWidth } from "./utils";
-type InputListenerResult = {
-    consume?: boolean;
-    data?: string;
-} | undefined;
-type InputListener = (data: string) => InputListenerResult;
-/**
- * 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;
-    /**
-     * Optional cleanup hook. Called once when the component is permanently
-     * removed from the tree via removeChild/clear/dispose. Implementations MUST
-     * be idempotent. Components meant to be re-added should be detached, not
-     * removed/cleared.
-     */
-    dispose?(): void;
-}
-/**
- * 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";
-export { visibleWidth };
-/** Durable source identifier for a semantically anchored viewport row. */
-export type ViewportAnchorId = string;
-export interface ViewportAnchorRow {
-    id: ViewportAnchorId;
-    graphemeStart: number;
-    graphemeEnd: number;
-    cellStart: number;
-    cellEnd: number;
-}
-export interface ViewportAnchorRender {
-    lines: string[];
-    anchors: Array<ViewportAnchorRow | null>;
-}
-export interface ViewportAnchorProvider extends Component {
-    renderWithViewportAnchors(width: number): ViewportAnchorRender;
-}
-export interface ViewportAnchorSource {
-    id: ViewportAnchorId;
-}
-export interface ViewportAnchorSourceRenderer extends Component {
-    renderWithViewportAnchorSource(width: number, source: ViewportAnchorSource): ViewportAnchorRender;
-}
-export declare function isViewportAnchorProvider(component: Component): component is ViewportAnchorProvider;
-export declare function isViewportAnchorSourceRenderer(component: Component): component is ViewportAnchorSourceRenderer;
-export declare function renderComponentWithViewportAnchors(component: Component, width: number): ViewportAnchorRender;
-export declare function renderComponentWithViewportAnchorSource(component: Component, width: number, source: ViewportAnchorSource): ViewportAnchorRender;
-/**
- * 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}%`;
-/**
- * Startup sixel capability probe policy (pure; exported for tests):
- * - Never probe when PI_FORCE_IMAGE_PROTOCOL is set — an explicit
- *   configuration (including "off") is authoritative.
- * - Never probe inside a terminal multiplexer: tmux advertises DA1 ";4"
- *   whenever it was compiled with sixel support, regardless of whether the
- *   attached client terminal can render sixel, so a positive reply is not
- *   end-to-end evidence. Graphics under a multiplexer are strictly opt-in
- *   via PI_FORCE_IMAGE_PROTOCOL=sixel.
- * - Probe Windows Terminal (>=1.22 renders sixel but exposes no env marker).
- */
-export declare function shouldProbeSixelCapability(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): boolean;
-/**
- * True when repainting only the live viewport is safer than clearing/replaying
- * the full transcript. Native Windows console hosts are included even when
- * WT_SESSION is absent because PowerShell/ConPTY launch chains can drop terminal
- * identity variables while keeping the same scroll-jump behavior.
- */
-export declare function shouldUseViewportRepaintForHost(env?: Record<string, string | undefined>, platform?: NodeJS.Platform, options?: {
-    includeNativeWindows?: boolean;
-}): boolean;
-/**
- * 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;
-}
-/**
- * Container - a component that contains other components
- */
-export declare class Container implements ViewportAnchorProvider {
-    #private;
-    children: Component[];
-    addChild(component: Component): void;
-    removeChild(component: Component): void;
-    /** Remove a child without disposing it (for detach-then-readd reuse). */
-    detachChild(component: Component): void;
-    clear(): void;
-    /** Remove all children without disposing them (for detach-then-readd reuse). */
-    detachAll(): void;
-    /** Registers a direct child as eligible for semantic viewport anchoring. */
-    setViewportAnchorSource(component: Component, source: ViewportAnchorSource | null): void;
-    dispose(): void;
-    invalidate(): void;
-    render(width: number): string[];
-    renderWithViewportAnchors(width: number): ViewportAnchorRender;
-}
-type TuiRenderCounterSnapshot = {
-    debugRedrawEnvReads: number;
-    debugRedrawAppendWrites: number;
-    differentialGuardVisibleWidthCalls: number;
-};
-/**
- * TUI - Main class for managing terminal UI with differential rendering
- */
-export declare class TUI extends Container {
-    #private;
-    terminal: Terminal;
-    /** Global callback for debug key (Shift+Ctrl+D). Called before input is forwarded to focused component. */
-    onDebug?: () => void;
-    static resetRenderCountersForTest(): void;
-    static getRenderCountersForTest(): TuiRenderCounterSnapshot;
-    overlayStack: {
-        component: Component;
-        options?: OverlayOptions;
-        preFocus: Component | null;
-        hidden: boolean;
-    }[];
-    constructor(terminal: Terminal, showHardwareCursor?: boolean);
-    dispose(): void;
-    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;
-    setBottomPinnedComponent(component: Component | null): void;
-    /** Register the direct child whose rows are eligible for semantic viewport anchoring. */
-    setViewportAnchorComponent(component: Component | null): void;
-    /** Clear manual viewport ownership before replacing the transcript identity namespace. */
-    resetViewportAnchorIntent(): void;
-    /** Allow one semantic-neighbor reconciliation after a definitive same-transcript rebuild. */
-    prepareViewportAnchorForTranscriptRebuild(): void;
-    scrollViewportPages(direction: -1 | 1): boolean;
-    followLiveViewport(): boolean;
-    /**
-     * 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;
-    invalidate(): void;
-    start(): void;
-    get terminalAvailable(): boolean;
-    addInputListener(listener: InputListener): () => void;
-    removeInputListener(listener: InputListener): void;
-    stop(): void;
-    /**
-     * Viewport-repaint-aware resize render request.
-     *
-     * A forced full redraw (`requestRender(true)`) resets `#previousWidth`/`#previousHeight`
-     * to -1, which makes `#doRender` treat the frame as a width change and fall into the
-     * `fullRender` path. In terminal multiplexers that path skips the scrollback-clearing
-     * `3J` escape (users navigate scrollback history), so replaying every transcript line
-     * piles it back on top of scrollback — the "top of screen scrolls down to the prompt at
-     * high speed" resize storm. Windows Terminal/ConPTY can also visibly jump to
-     * the transcript top during streaming redraws, so viewport-repaint sessions
-     * keep force off and let `#doRender` repaint only the live viewport. Set
-     * `PI_TUI_LEGACY_MULTIPLEXER_FULL_RENDER=1` to restore the legacy tmux redraw.
-     */
-    requestResizeRender(): void;
-    requestRender(force?: boolean, source?: string): void;
-    getLineRenderCacheStats(): {
-        normalizationSize: number;
-        truncationSize: number;
-        normalizationLimit: number;
-        truncationLimit: number;
-    };
-    /**
-     * Register an emitter whose escape payload is appended to every render
-     * write (inside its own synchronized-output block, cursor saved/restored).
-     * Used for absolute-positioned overlays such as pixel-image pets that live
-     * outside the line-based component model. Return null to emit nothing.
-     */
-    setPostRenderEmitter(emitter: (() => string | null) | undefined): void;
-}

package/dist/types/utils.d.ts

@@ -1,110 +0,0 @@
-import { Ellipsis, type ExtractSegmentsResult, type SliceResult } from "@sayknow-cli/natives";
-export { Ellipsis } from "@sayknow-cli/natives";
-export { getDefaultTabWidth, getIndentation } from "@sayknow-cli/utils";
-/** Test-only performance counters for advisory baseline tests. */
-export declare const __textHelperPerfCounters: {
-    truncateToWidthCalls: number;
-    wrapTextWithAnsiCalls: number;
-    truncateLinesToWidthCalls: number;
-    visibleWidthsCalls: number;
-    reset(): void;
-};
-export declare function invalidateTabWidthCache(): void;
-export declare function isPrintableAscii(text: string): boolean;
-export declare function sliceWithWidth(line: string, startCol: number, length: number, strict?: boolean | null): SliceResult;
-export declare function truncateToWidth(text: string, maxWidth: number, ellipsisKind?: Ellipsis | null, pad?: boolean | null): string;
-export declare function truncateLinesToWidth(lines: readonly string[], maxWidth: number, ellipsisKind?: Ellipsis | null, pad?: boolean | null): string[];
-export declare function wrapTextWithAnsi(text: string, width: number): string[];
-export declare function extractSegments(line: string, beforeEnd: number, afterStart: number, afterLen: number, strictAfter: boolean): ExtractSegmentsResult;
-/**
- * Tab width in columns for `file`, using `process.cwd()` as the project root for relative paths.
- */
-export declare function getIndentationNoescape(file?: string): number;
-export declare function replaceTabs(text: string, file?: string): string;
-/**
- * Returns a string of n spaces. Uses a pre-allocated buffer for efficiency.
- */
-export declare function padding(n: number): string;
-/**
- * Get the shared grapheme segmenter instance.
- */
-export declare function getSegmenter(): Intl.Segmenter;
-export interface ViewportAnchorSpan {
-    graphemeStart: number;
-    graphemeEnd: number;
-    cellStart: number;
-    cellEnd: number;
-}
-export interface ViewportAnchorAnnotation {
-    text: string;
-    nextGrapheme: number;
-    nextCell: number;
-    token: string;
-}
-export declare const VIEWPORT_ANCHOR_PREFIX = "\u001B_ASKC_ANCHOR:";
-/**
- * Tag every visible grapheme with an APC marker that survives ANSI-aware
- * wrapping. The marker contains source grapheme and monotonic cell offsets.
- */
-export declare function annotateViewportAnchorGraphemes(text: string, startGrapheme?: number, startCell?: number, token?: `${string}-${string}-${string}-${string}-${string}`): ViewportAnchorAnnotation;
-/** Remove viewport anchor markers and return the exact marked span for each row. */
-export declare function extractViewportAnchorRows(lines: readonly string[], token: string): {
-    lines: string[];
-    spans: Array<ViewportAnchorSpan | null>;
-};
-export declare function visibleWidthRaw(str: string): number;
-/**
- * Calculate the visible width of a string in terminal columns.
- */
-export declare function visibleWidth(str: string): number;
-export declare function visibleWidthsNative(lines: readonly string[]): number[];
-export declare function visibleWidths(lines: readonly string[]): number[];
-/**
- * Normalize text for terminal output without changing logical editor content.
- * Some terminals render canonically decomposed Hangul jamo or precomposed
- * Thai/Lao AM vowels inconsistently during differential repaint. Emit a stable
- * terminal form while keeping the component/source strings unchanged.
- */
-export declare function normalizeTerminalOutput(str: string): string;
-/**
- * Check if a character is whitespace.
- */
-export declare function isWhitespaceChar(char: string): boolean;
-/**
- * Check if a character is punctuation.
- */
-export declare function isPunctuationChar(char: string): boolean;
-export type WordNavKind = "whitespace" | "delimiter" | "cjk" | "word" | "other";
-/**
- * Coarse Unicode-aware character classification for word navigation (Option/Alt + Left/Right).
- * This intentionally avoids language-specific word segmentation for predictability across scripts.
- */
-export declare function getWordNavKind(grapheme: string): WordNavKind;
-export declare function isWordNavJoiner(grapheme: string): boolean;
-/**
- * Move the cursor one "word" to the left using Unicode-aware coarse navigation.
- *
- * Returns a new cursor index in the range [0, text.length].
- */
-export declare function moveWordLeft(text: string, cursor: number): number;
-/**
- * Move the cursor one "word" to the right using Unicode-aware coarse navigation.
- *
- * Returns a new cursor index in the range [0, text.length].
- */
-export declare function moveWordRight(text: string, cursor: number): number;
-/**
- * Apply background color to a line, padding to full width.
- *
- * @param line - Line of text (may contain ANSI codes)
- * @param width - Total width to pad to
- * @param bgFn - Background color function
- * @returns Line with background applied and padded to width
- */
-export declare function applyBackgroundToLine(line: string, width: number, bgFn: (text: string) => string): string;
-/**
- * Extract a range of visible columns from a line. Handles ANSI codes and wide chars.
- *
- * @param strict - If true, exclude wide chars at boundary that would extend past the range
- */
-export declare function sliceByColumn(line: string, startCol: number, length: number, strict?: boolean): string;