@sayknow-cli/tui 0.3.16 → 0.4.1

package/dist/types/components/input.d.ts

@@ -1,16 +0,0 @@
-import { type Component, type Focusable } from "../tui";
-/**
- * Input component - single-line text input with horizontal scrolling
- */
-export declare class Input implements Component, Focusable {
-    #private;
-    onSubmit?: (value: string) => void;
-    onEscape?: () => void;
-    /** Focusable interface - set by TUI when focus changes */
-    focused: boolean;
-    getValue(): string;
-    setValue(value: string): void;
-    handleInput(data: string): void;
-    invalidate(): void;
-    render(width: number): string[];
-}

package/dist/types/components/loader.d.ts

@@ -1,23 +0,0 @@
-import type { TUI } from "../tui";
-import { Text } from "./text";
-export interface LoaderOptions {
-    timeDependentColor?: boolean;
-}
-/** Test-only performance counters for advisory baseline tests. */
-export declare const __loaderPerfCounters: {
-    liveIntervals: number;
-    startedIntervals: number;
-    reset(): void;
-};
-export declare class Loader extends Text {
-    #private;
-    private spinnerColorFn;
-    private messageColorFn;
-    private message;
-    constructor(ui: TUI, spinnerColorFn: (str: string) => string, messageColorFn: (str: string) => string, message?: string, spinnerFrames?: string[], options?: LoaderOptions);
-    render(width: number): string[];
-    start(): void;
-    stop(): void;
-    dispose(): void;
-    setMessage(message: string): void;
-}

package/dist/types/components/markdown.d.ts

@@ -1,87 +0,0 @@
-import type { SymbolTheme } from "../symbols";
-import type { Component } from "../tui";
-import { type ViewportAnchorSpan } from "../utils";
-/** Test-only clock seam for streaming throttle tests. */
-export declare function __setMarkdownNowForTest(now: (() => number) | undefined): void;
-/** Test/diagnostic seam: number of synchronous highlight invocations since the last reset. */
-export declare function getMarkdownHighlightCallCount(): number;
-export declare function resetMarkdownHighlightCallCount(): void;
-/** Test-only performance counters for advisory baseline tests. */
-export declare const __markdownPerfCounters: {
-    lexerInvocations: number;
-    lexedBytes: number;
-    reset(): void;
-};
-/** Drop all L2 cache entries. Call on theme change to prevent stale styled output. */
-export declare function clearRenderCache(): void;
-export declare function getRenderCacheRetainedBytes(): number;
-/**
- * Default text styling for markdown content.
- * Applied to all text unless overridden by markdown formatting.
- */
-export interface DefaultTextStyle {
-    /** Foreground color function */
-    color?: (text: string) => string;
-    /** Background color function */
-    bgColor?: (text: string) => string;
-    /** Bold text */
-    bold?: boolean;
-    /** Italic text */
-    italic?: boolean;
-    /** Strikethrough text */
-    strikethrough?: boolean;
-    /** Underline text */
-    underline?: boolean;
-}
-/**
- * Theme functions for markdown elements.
- * Each function takes text and returns styled text with ANSI codes.
- */
-export interface MarkdownTheme {
-    heading: (text: string) => string;
-    link: (text: string) => string;
-    linkUrl: (text: string) => string;
-    code: (text: string) => string;
-    codeBlock: (text: string) => string;
-    codeBlockBorder: (text: string) => string;
-    quote: (text: string) => string;
-    quoteBorder: (text: string) => string;
-    hr: (text: string) => string;
-    listBullet: (text: string) => string;
-    bold: (text: string) => string;
-    italic: (text: string) => string;
-    strikethrough: (text: string) => string;
-    underline: (text: string) => string;
-    highlightCode?: (code: string, lang?: string) => string[];
-    /**
-     * Resolve a mermaid ASCII rendering by fenced block source text.
-     * Return null to fall back to fenced code rendering.
-     */
-    resolveMermaidAscii?: (source: string) => string | null;
-    symbols: SymbolTheme;
-}
-export declare class Markdown implements Component {
-    #private;
-    constructor(text: string, paddingX: number, paddingY: number, theme: MarkdownTheme, defaultTextStyle?: DefaultTextStyle, codeBlockIndent?: number);
-    setOnStaleThrottle(callback: (() => void) | undefined): void;
-    setText(text: string, options?: {
-        streaming?: boolean;
-    }): void;
-    setStreaming(streaming: boolean): void;
-    dispose(): void;
-    invalidate(): void;
-    render(width: number): string[];
-    renderWithViewportAnchorSource(width: number, source: {
-        id: string;
-    }): {
-        lines: string[];
-        anchors: Array<({
-            id: string;
-        } & ViewportAnchorSpan) | null>;
-    };
-}
-/**
- * Render inline markdown (bold, italic, code, links, strikethrough) to a styled string.
- * Unlike the full Markdown component, this produces a single line with no block-level elements.
- */
-export declare function renderInlineMarkdown(text: string, mdTheme: MarkdownTheme, baseColor?: (t: string) => string): string;

package/dist/types/components/sayknow-pet.d.ts

@@ -1,128 +0,0 @@
-/**
- * ┌─ SAYKNOW PET SPRITE SPEC ────────────────────────────────────────────────┐
- * The pet is a 16×16 pixel octopus drawn beside the composer. Everything here
- * is data: no PNGs, no assets — each frame is 16 strings of 16 chars, encoded
- * to a sixel or kitty escape at runtime. Author a new frame by drawing a grid.
- *
- * GRID RULES
- * - Exactly 16 rows × 16 columns. Only PALETTE keys below are valid chars.
- * - `.` = transparent. Keep the outer columns transparent so the sprite sits
- *   snug beside the input box (the widget reserves +1 column of slack).
- *
- * PALETTE (char → role) — see PALETTE for exact RGB:
- *   .=transparent  K=dark outline  R=mantle body  r=body highlight
- *   W=eye white    V=pupil         G=eye sparkle  b=underside
- *   w=tear         H h A=reserved (unused by the octopus art)
- *
- * FRAME CATALOG (SayknowPixelFrameName → PIXEL_GRIDS):
- *   base    idle rest; also the dance "drop/settle" beat
- *   gazeL   eyes glance left    ┐ idle loop (see sayknow-pet-widget IDLE_LOOP)
- *   gazeR   eyes glance right   │
- *   flicker eyes blink          ┘
- *   flex    sparkly "yay" eyes; dance accent + random idle flex burst
- *   danceL  tentacles sway left   ┐ work loop (PARA_PARA_STEPS)
- *   danceR  tentacles sway right  ┘
- *   cry1..3 a tear trails from the outer eye corners (BlueOcto sob)
- *
- * RENDERING: buildSayknowPixelFrames({ protocol, cellWidthPx, cellHeightPx,
- * targetRows: 2 }) scales the art to 2 terminal rows and encodes each frame
- * once. Kitty uses a native `Y=` sub-cell drop (set by the widget) to sit on the
- * composer border; sixel uses transparent top padding.
- *
- * BEHAVIOR (timing, positioning, on/off) lives in
- * packages/coding-agent/src/modes/components/sayknow-pet-widget.ts.
- *
- * ADD A FRAME: draw the grid → add its name to SayknowPixelFrameName → register it in
- * PIXEL_GRIDS → reference it from an idle/work loop or a skin burst.
- *
- * ADD A PET (skin): append one entry to PET_SKINS below — { id, label, description,
- * palette, burst }. The id flows into PetSkinId/PetMode automatically, the settings
- * enum, `/pet` command and both selectors derive their options from PET_SKINS, and the
- * widget reads `burst` to animate — no other file needs editing. Recolor with a palette
- * spread (see BLUE_PALETTE); add frames only for poses the catalog lacks.
- * └────────────────────────────────────────────────────────────────────────┘
- */
-type Rgb = readonly [number, number, number];
-export type Palette = Record<string, Rgb | null>;
-export declare const PET_SKIN_IDS: readonly ["red", "blue"];
-export type PetSkinId = (typeof PET_SKIN_IDS)[number];
-/** Every pet mode: "off" plus each skin id, in menu order. */
-export declare const PET_MODE_IDS: readonly ["off", "red", "blue"];
-export type PetMode = (typeof PET_MODE_IDS)[number];
-/** Narrow an arbitrary string to a PetMode. */
-export declare function isPetMode(value: string): value is PetMode;
-/** Logical pixel-pet frame names shared by the overlay state machine. */
-export type SayknowPixelFrameName = "base" | "gazeL" | "gazeR" | "flicker" | "flex" | "danceL" | "danceR" | "cry1" | "cry2" | "cry3";
-/** Para-para work dance beats: the working loop and each skin's burst "work-in" intro. */
-export declare const PARA_PARA_STEPS: ReadonlyArray<readonly [SayknowPixelFrameName, number]>;
-/**
- * A skin's idle burst: a short intro sequence, then an optional looping tail. It drives
- * BOTH the random live show-off AND the selector's preview demo, so give every skin a
- * real animation (reuse PARA_PARA_STEPS for a work-in intro) rather than one held frame.
- */
-export interface PetBurst {
-    /** Frames played once, in order, at the start of the burst. */
-    intro: ReadonlyArray<readonly [SayknowPixelFrameName, number]>;
-    /** Frames cycled every `stepMs` for `ms` after the intro (a held or looping finish). */
-    tail?: {
-        frames: readonly SayknowPixelFrameName[];
-        stepMs: number;
-        ms: number;
-    };
-}
-/** Everything that defines a pet skin: identity, UI copy, colors and behavior. */
-export interface PetSkin {
-    id: PetSkinId;
-    /** Selector/settings label, e.g. "RedOctopus". */
-    label: string;
-    /** One-line selector/settings description. */
-    description: string;
-    palette: Palette;
-    /** Idle burst animation played between quiet idle loops. */
-    burst: PetBurst;
-}
-/** Skin registry — the single source for palettes, behavior and selector/command copy. */
-export declare const PET_SKINS: Record<PetSkinId, PetSkin>;
-/** Total burst duration (intro beats plus the looping tail). */
-export declare function petBurstDurationMs(burst: PetBurst): number;
-/** The frame to show `elapsed` ms into a burst (`now` cycles the looping tail). */
-export declare function petBurstFrame(burst: PetBurst, elapsed: number, now: number): SayknowPixelFrameName;
-/** Test-only access to logical art; production rendering still uses encoded frames. */
-export declare const __sayknowPetTestHooks: {
-    getPixelGrid(name: SayknowPixelFrameName): string[];
-};
-/** Encode a grid as a transparent SIXEL image, optionally bottom-aligned by top padding. */
-export declare function encodeGridSixel(grid: string[], scale: number, topPaddingPx?: number, palette?: Palette): string;
-/** Encode a bottom-aligned grid as kitty raw RGBA at `scale`. */
-export declare function encodeGridKitty(grid: string[], scale: number, imageId: number, cols: number, rows: number, topPaddingPx?: number, cellYOffsetPx?: number, leftPaddingPx?: number, rightPaddingPx?: number, palette?: Palette): string;
-export interface SayknowPixelFrames {
-    /** escape payload per logical frame (drawn at the current cursor cell) */
-    frames: Record<SayknowPixelFrameName, string>;
-    /** protocol the frames were encoded for */
-    protocol: "sixel" | "kitty";
-    widthPx: number;
-    heightPx: number;
-    columns: number;
-    rows: number;
-    /** terminal rows touched by the encoded raster, including pixel offset */
-    rasterRows: number;
-}
-/**
- * Build overlay pixel frames exactly `targetRows` terminal rows tall when the
- * terminal cells permit it. Nearest-neighbor sampling preserves the 16x16 art
- * while allowing fractional scale factors such as 36px / 16px.
- */
-export declare function buildSayknowPixelFrames(options: {
-    protocol: "sixel" | "kitty";
-    cellWidthPx: number;
-    cellHeightPx: number;
-    targetRows?: number;
-    /** Transparent pixel offset above sixel art for sub-cell vertical placement. */
-    sixelTopPaddingPx?: number;
-    /** Native sub-cell `Y=` pixel offset that drops the kitty sprite within its first cell. */
-    kittyCellYOffsetPx?: number;
-    kittyImageId?: number;
-    /** Color skin for the sprite palette (default "red"). */
-    skin?: PetSkinId;
-}): SayknowPixelFrames;
-export {};

package/dist/types/components/select-list.d.ts

@@ -1,46 +0,0 @@
-import type { SymbolTheme } from "../symbols";
-import type { Component } from "../tui";
-export interface SelectItem {
-    value: string;
-    label: string;
-    description?: string;
-    /** Dim hint text shown inline after cursor when this item is selected */
-    hint?: string;
-}
-export interface SelectListTheme {
-    selectedPrefix: (text: string) => string;
-    selectedText: (text: string) => string;
-    description: (text: string) => string;
-    scrollInfo: (text: string) => string;
-    noMatch: (text: string) => string;
-    symbols: SymbolTheme;
-}
-export interface SelectListTruncatePrimaryContext {
-    text: string;
-    maxWidth: number;
-    columnWidth: number;
-    item: SelectItem;
-    isSelected: boolean;
-}
-export interface SelectListLayoutOptions {
-    minPrimaryColumnWidth?: number;
-    maxPrimaryColumnWidth?: number;
-    truncatePrimary?: (context: SelectListTruncatePrimaryContext) => string;
-}
-export declare class SelectList implements Component {
-    #private;
-    private readonly items;
-    private readonly maxVisible;
-    private readonly theme;
-    private readonly layout;
-    onSelect?: (item: SelectItem) => void;
-    onCancel?: () => void;
-    onSelectionChange?: (item: SelectItem) => void;
-    constructor(items: ReadonlyArray<SelectItem>, maxVisible: number, theme: SelectListTheme, layout?: SelectListLayoutOptions);
-    setFilter(filter: string): void;
-    setSelectedIndex(index: number): void;
-    invalidate(): void;
-    render(width: number): string[];
-    handleInput(keyData: string): void;
-    getSelectedItem(): SelectItem | null;
-}

package/dist/types/components/settings-list.d.ts

@@ -1,39 +0,0 @@
-import type { Component } from "../tui";
-export interface SettingItem {
-    /** Unique identifier for this setting */
-    id: string;
-    /** Display label (left side) */
-    label: string;
-    /** Optional description shown when selected */
-    description?: string;
-    /** Current value to display (right side) */
-    currentValue: string;
-    /** If provided, Enter/Space cycles through these values */
-    values?: string[];
-    /** If provided, Enter opens this submenu. Receives current value and done callback. */
-    submenu?: (currentValue: string, done: (selectedValue?: string) => void) => Component;
-}
-export interface SettingsListTheme {
-    label: (text: string, selected: boolean) => string;
-    value: (text: string, selected: boolean) => string;
-    description: (text: string) => string;
-    cursor: string;
-    hint: (text: string) => string;
-}
-export declare class SettingsList implements Component {
-    #private;
-    constructor(items: SettingItem[], maxVisible: number, theme: SettingsListTheme, onChange: (id: string, newValue: string) => void, onCancel: () => void, onSelectionChange?: (item: SettingItem | undefined) => void);
-    /** Update an item's currentValue */
-    updateValue(id: string, newValue: string): void;
-    /**
-     * Replace the entire items array. Selection is preserved when the prior
-     * index is still valid, otherwise clamped to the last item (or 0 if the
-     * list is now empty). An open submenu is left untouched — its lifetime
-     * is bounded by its own done callback, and `#closeSubmenu` re-clamps the
-     * restored index against the new list on the way out.
-     */
-    setItems(items: SettingItem[]): void;
-    invalidate(): void;
-    render(width: number): string[];
-    handleInput(data: string): void;
-}

package/dist/types/components/spacer.d.ts

@@ -1,11 +0,0 @@
-import type { Component } from "../tui";
-/**
- * Spacer component that renders empty lines
- */
-export declare class Spacer implements Component {
-    #private;
-    constructor(lines?: number);
-    setLines(lines: number): void;
-    invalidate(): void;
-    render(_width: number): string[];
-}

package/dist/types/components/tab-bar.d.ts

@@ -1,56 +0,0 @@
-import type { Component } from "../tui";
-/** Tab definition */
-export interface Tab {
-    /** Unique identifier for the tab */
-    id: string;
-    /** Display label shown in the tab bar */
-    label: string;
-}
-/** Theme for styling the tab bar */
-export interface TabBarTheme {
-    /** Style for the label prefix (e.g., "Settings:") */
-    label: (text: string) => string;
-    /** Style for the currently active tab */
-    activeTab: (text: string) => string;
-    /** Style for inactive tabs */
-    inactiveTab: (text: string) => string;
-    /** Style for the hint text (e.g., "(tab to cycle)") */
-    hint: (text: string) => string;
-}
-/**
- * Horizontal tab bar component.
- *
- * @example
- * ```ts
- * const tabs = [
- *   { id: "config", label: "Config" },
- *   { id: "tools", label: "Tools" },
- * ];
- * const tabBar = new TabBar("Settings", tabs, theme);
- * tabBar.onTabChange = (tab) => console.log(`Switched to ${tab.id}`);
- * ```
- */
-export declare class TabBar implements Component {
-    #private;
-    /** Callback fired when the active tab changes */
-    onTabChange?: (tab: Tab, index: number) => void;
-    constructor(label: string, tabs: Tab[], theme: TabBarTheme, initialIndex?: number);
-    /** Get the currently active tab */
-    getActiveTab(): Tab;
-    /** Get the index of the currently active tab */
-    getActiveIndex(): number;
-    /** Set the active tab by index (clamped to valid range) */
-    setActiveIndex(index: number): void;
-    /** Move to the next tab (wraps to first tab after last) */
-    nextTab(): void;
-    /** Move to the previous tab (wraps to last tab before first) */
-    prevTab(): void;
-    invalidate(): void;
-    /**
-     * Handle keyboard input for tab navigation.
-     * @returns true if the input was handled, false otherwise
-     */
-    handleInput(data: string): boolean;
-    /** Render the tab bar, wrapping to multiple lines if needed */
-    render(width: number): string[];
-}

package/dist/types/components/text.d.ts

@@ -1,22 +0,0 @@
-import type { Component } from "../tui";
-import { type ViewportAnchorSpan } from "../utils";
-/**
- * Text component - displays multi-line text with word wrapping
- */
-export declare class Text implements Component {
-    #private;
-    constructor(text?: string, paddingX?: number, paddingY?: number, customBgFn?: (text: string) => string);
-    getText(): string;
-    setText(text: string): void;
-    setCustomBgFn(customBgFn?: (text: string) => string): void;
-    invalidate(): void;
-    render(width: number): string[];
-    renderWithViewportAnchorSource(width: number, source: {
-        id: string;
-    }): {
-        lines: string[];
-        anchors: Array<({
-            id: string;
-        } & ViewportAnchorSpan) | null>;
-    };
-}

package/dist/types/components/truncated-text.d.ts

@@ -1,10 +0,0 @@
-import type { Component } from "../tui";
-/**
- * Text component that truncates to fit viewport width
- */
-export declare class TruncatedText implements Component {
-    #private;
-    constructor(text: string, paddingX?: number, paddingY?: number);
-    invalidate(): void;
-    render(width: number): string[];
-}

package/dist/types/editor-component.d.ts

@@ -1,36 +0,0 @@
-import type { AutocompleteProvider } from "./autocomplete";
-import type { Component } from "./tui";
-/**
- * Interface for custom editor components.
- *
- * This allows extensions to provide their own editor implementation
- * (e.g., vim mode, emacs mode, custom keybindings) while maintaining
- * compatibility with the core application.
- */
-export interface EditorComponent extends Component {
-    /** Get the current text content */
-    getText(): string;
-    /** Set the text content */
-    setText(text: string): void;
-    /** Handle raw terminal input (key presses, paste sequences, etc.) */
-    handleInput(data: string): void;
-    /** Called when user submits (e.g., Enter key) */
-    onSubmit?: (text: string) => void;
-    /** Called when text changes */
-    onChange?: (text: string) => void;
-    /** Add text to history for up/down navigation */
-    addToHistory?(text: string): void;
-    /** Insert text at current cursor position */
-    insertTextAtCursor?(text: string): void;
-    /**
-     * Get text with any markers expanded (e.g., paste markers).
-     * Falls back to getText() if not implemented.
-     */
-    getExpandedText?(): string;
-    /** Set the autocomplete provider */
-    setAutocompleteProvider?(provider: AutocompleteProvider): void;
-    /** Border color function */
-    borderColor?: (str: string) => string;
-    /** Set horizontal padding */
-    setPaddingX?(padding: number): void;
-}

package/dist/types/fuzzy.d.ts

@@ -1,15 +0,0 @@
-/**
- * Fuzzy matching utilities.
- * Matches if all query characters appear in order (not necessarily consecutive).
- * Lower score = better match.
- */
-export interface FuzzyMatch {
-    matches: boolean;
-    score: number;
-}
-export declare function fuzzyMatch(query: string, text: string): FuzzyMatch;
-/**
- * Filter and sort items by fuzzy match quality (best matches first).
- * Supports space-separated tokens: all tokens must match.
- */
-export declare function fuzzyFilter<T>(items: T[], query: string, getText: (item: T) => string): T[];

package/dist/types/index.d.ts

@@ -1,28 +0,0 @@
-export * from "./animation-scheduler";
-export * from "./autocomplete";
-export * from "./components/box";
-export * from "./components/cancellable-loader";
-export * from "./components/editor";
-export * from "./components/image";
-export * from "./components/input";
-export * from "./components/loader";
-export * from "./components/markdown";
-export * from "./components/sayknow-pet";
-export * from "./components/select-list";
-export * from "./components/settings-list";
-export * from "./components/spacer";
-export * from "./components/tab-bar";
-export * from "./components/text";
-export * from "./components/truncated-text";
-export type * from "./editor-component";
-export * from "./fuzzy";
-export * from "./keybindings";
-export * from "./keys";
-export * from "./metrics";
-export * from "./stdin-buffer";
-export type * from "./symbols";
-export * from "./terminal";
-export * from "./terminal-capabilities";
-export * from "./ttyid";
-export * from "./tui";
-export * from "./utils";