@cjhyy/code-shell 0.3.0 → 0.5.0-rc.2

package/dist/render/styles.d.ts

@@ -1,306 +0,0 @@
-import { type LayoutNode } from './layout/node.js';
-import type { BorderStyle, BorderTextOptions } from './render-border.js';
-export type RGBColor = `rgb(${number},${number},${number})`;
-export type HexColor = `#${string}`;
-export type Ansi256Color = `ansi256(${number})`;
-export type AnsiColor = 'ansi:black' | 'ansi:red' | 'ansi:green' | 'ansi:yellow' | 'ansi:blue' | 'ansi:magenta' | 'ansi:cyan' | 'ansi:white' | 'ansi:blackBright' | 'ansi:redBright' | 'ansi:greenBright' | 'ansi:yellowBright' | 'ansi:blueBright' | 'ansi:magentaBright' | 'ansi:cyanBright' | 'ansi:whiteBright';
-/** Raw color value - not a theme key */
-export type Color = RGBColor | HexColor | Ansi256Color | AnsiColor;
-/**
- * Structured text styling properties.
- * Used to style text without relying on ANSI string transforms.
- * Colors are raw values - theme resolution happens at the component layer.
- */
-export type TextStyles = {
-    readonly color?: Color;
-    readonly backgroundColor?: Color;
-    readonly dim?: boolean;
-    readonly bold?: boolean;
-    readonly italic?: boolean;
-    readonly underline?: boolean;
-    readonly strikethrough?: boolean;
-    readonly inverse?: boolean;
-};
-export type Styles = {
-    readonly textWrap?: 'wrap' | 'wrap-trim' | 'end' | 'middle' | 'truncate-end' | 'truncate' | 'truncate-middle' | 'truncate-start';
-    readonly position?: 'absolute' | 'relative';
-    readonly top?: number | `${number}%`;
-    readonly bottom?: number | `${number}%`;
-    readonly left?: number | `${number}%`;
-    readonly right?: number | `${number}%`;
-    /**
-     * Size of the gap between an element's columns.
-     */
-    readonly columnGap?: number;
-    /**
-     * Size of the gap between element's rows.
-     */
-    readonly rowGap?: number;
-    /**
-     * Size of the gap between an element's columns and rows. Shorthand for `columnGap` and `rowGap`.
-     */
-    readonly gap?: number;
-    /**
-     * Margin on all sides. Equivalent to setting `marginTop`, `marginBottom`, `marginLeft` and `marginRight`.
-     */
-    readonly margin?: number;
-    /**
-     * Horizontal margin. Equivalent to setting `marginLeft` and `marginRight`.
-     */
-    readonly marginX?: number;
-    /**
-     * Vertical margin. Equivalent to setting `marginTop` and `marginBottom`.
-     */
-    readonly marginY?: number;
-    /**
-     * Top margin.
-     */
-    readonly marginTop?: number;
-    /**
-     * Bottom margin.
-     */
-    readonly marginBottom?: number;
-    /**
-     * Left margin.
-     */
-    readonly marginLeft?: number;
-    /**
-     * Right margin.
-     */
-    readonly marginRight?: number;
-    /**
-     * Padding on all sides. Equivalent to setting `paddingTop`, `paddingBottom`, `paddingLeft` and `paddingRight`.
-     */
-    readonly padding?: number;
-    /**
-     * Horizontal padding. Equivalent to setting `paddingLeft` and `paddingRight`.
-     */
-    readonly paddingX?: number;
-    /**
-     * Vertical padding. Equivalent to setting `paddingTop` and `paddingBottom`.
-     */
-    readonly paddingY?: number;
-    /**
-     * Top padding.
-     */
-    readonly paddingTop?: number;
-    /**
-     * Bottom padding.
-     */
-    readonly paddingBottom?: number;
-    /**
-     * Left padding.
-     */
-    readonly paddingLeft?: number;
-    /**
-     * Right padding.
-     */
-    readonly paddingRight?: number;
-    /**
-     * This property defines the ability for a flex item to grow if necessary.
-     * See [flex-grow](https://css-tricks.com/almanac/properties/f/flex-grow/).
-     */
-    readonly flexGrow?: number;
-    /**
-     * It specifies the “flex shrink factor”, which determines how much the flex item will shrink relative to the rest of the flex items in the flex container when there isn’t enough space on the row.
-     * See [flex-shrink](https://css-tricks.com/almanac/properties/f/flex-shrink/).
-     */
-    readonly flexShrink?: number;
-    /**
-     * It establishes the main-axis, thus defining the direction flex items are placed in the flex container.
-     * See [flex-direction](https://css-tricks.com/almanac/properties/f/flex-direction/).
-     */
-    readonly flexDirection?: 'row' | 'column' | 'row-reverse' | 'column-reverse';
-    /**
-     * It specifies the initial size of the flex item, before any available space is distributed according to the flex factors.
-     * See [flex-basis](https://css-tricks.com/almanac/properties/f/flex-basis/).
-     */
-    readonly flexBasis?: number | string;
-    /**
-     * It defines whether the flex items are forced in a single line or can be flowed into multiple lines. If set to multiple lines, it also defines the cross-axis which determines the direction new lines are stacked in.
-     * See [flex-wrap](https://css-tricks.com/almanac/properties/f/flex-wrap/).
-     */
-    readonly flexWrap?: 'nowrap' | 'wrap' | 'wrap-reverse';
-    /**
-     * The align-items property defines the default behavior for how items are laid out along the cross axis (perpendicular to the main axis).
-     * See [align-items](https://css-tricks.com/almanac/properties/a/align-items/).
-     */
-    readonly alignItems?: 'flex-start' | 'center' | 'flex-end' | 'stretch';
-    /**
-     * It makes possible to override the align-items value for specific flex items.
-     * See [align-self](https://css-tricks.com/almanac/properties/a/align-self/).
-     */
-    readonly alignSelf?: 'flex-start' | 'center' | 'flex-end' | 'auto';
-    /**
-     * It defines the alignment along the main axis.
-     * See [justify-content](https://css-tricks.com/almanac/properties/j/justify-content/).
-     */
-    readonly justifyContent?: 'flex-start' | 'flex-end' | 'space-between' | 'space-around' | 'space-evenly' | 'center';
-    /**
-     * Width of the element in spaces.
-     * You can also set it in percent, which will calculate the width based on the width of parent element.
-     */
-    readonly width?: number | string;
-    /**
-     * Height of the element in lines (rows).
-     * You can also set it in percent, which will calculate the height based on the height of parent element.
-     */
-    readonly height?: number | string;
-    /**
-     * Sets a minimum width of the element.
-     */
-    readonly minWidth?: number | string;
-    /**
-     * Sets a minimum height of the element.
-     */
-    readonly minHeight?: number | string;
-    /**
-     * Sets a maximum width of the element.
-     */
-    readonly maxWidth?: number | string;
-    /**
-     * Sets a maximum height of the element.
-     */
-    readonly maxHeight?: number | string;
-    /**
-     * Set this property to `none` to hide the element.
-     */
-    readonly display?: 'flex' | 'none';
-    /**
-     * Add a border with a specified style.
-     * If `borderStyle` is `undefined` (which it is by default), no border will be added.
-     */
-    readonly borderStyle?: BorderStyle;
-    /**
-     * Determines whether top border is visible.
-     *
-     * @default true
-     */
-    readonly borderTop?: boolean;
-    /**
-     * Determines whether bottom border is visible.
-     *
-     * @default true
-     */
-    readonly borderBottom?: boolean;
-    /**
-     * Determines whether left border is visible.
-     *
-     * @default true
-     */
-    readonly borderLeft?: boolean;
-    /**
-     * Determines whether right border is visible.
-     *
-     * @default true
-     */
-    readonly borderRight?: boolean;
-    /**
-     * Change border color.
-     * Shorthand for setting `borderTopColor`, `borderRightColor`, `borderBottomColor` and `borderLeftColor`.
-     */
-    readonly borderColor?: Color;
-    /**
-     * Change top border color.
-     * Accepts raw color values (rgb, hex, ansi).
-     */
-    readonly borderTopColor?: Color;
-    /**
-     * Change bottom border color.
-     * Accepts raw color values (rgb, hex, ansi).
-     */
-    readonly borderBottomColor?: Color;
-    /**
-     * Change left border color.
-     * Accepts raw color values (rgb, hex, ansi).
-     */
-    readonly borderLeftColor?: Color;
-    /**
-     * Change right border color.
-     * Accepts raw color values (rgb, hex, ansi).
-     */
-    readonly borderRightColor?: Color;
-    /**
-     * Dim the border color.
-     * Shorthand for setting `borderTopDimColor`, `borderBottomDimColor`, `borderLeftDimColor` and `borderRightDimColor`.
-     *
-     * @default false
-     */
-    readonly borderDimColor?: boolean;
-    /**
-     * Dim the top border color.
-     *
-     * @default false
-     */
-    readonly borderTopDimColor?: boolean;
-    /**
-     * Dim the bottom border color.
-     *
-     * @default false
-     */
-    readonly borderBottomDimColor?: boolean;
-    /**
-     * Dim the left border color.
-     *
-     * @default false
-     */
-    readonly borderLeftDimColor?: boolean;
-    /**
-     * Dim the right border color.
-     *
-     * @default false
-     */
-    readonly borderRightDimColor?: boolean;
-    /**
-     * Add text within the border. Only applies to top or bottom borders.
-     */
-    readonly borderText?: BorderTextOptions;
-    /**
-     * Background color for the box. Fills the interior with background-colored
-     * spaces and is inherited by child text nodes as their default background.
-     */
-    readonly backgroundColor?: Color;
-    /**
-     * Fill the box's interior (padding included) with spaces before
-     * rendering children, so nothing behind it shows through. Like
-     * `backgroundColor` but without emitting any SGR — the terminal's
-     * default background is used. Useful for absolute-positioned overlays
-     * where Box padding/gaps would otherwise be transparent.
-     */
-    readonly opaque?: boolean;
-    /**
-     * Behavior for an element's overflow in both directions.
-     * 'scroll' constrains the container's size (children do not expand it)
-     * and enables scrollTop-based virtualized scrolling at render time.
-     *
-     * @default 'visible'
-     */
-    readonly overflow?: 'visible' | 'hidden' | 'scroll';
-    /**
-     * Behavior for an element's overflow in horizontal direction.
-     *
-     * @default 'visible'
-     */
-    readonly overflowX?: 'visible' | 'hidden' | 'scroll';
-    /**
-     * Behavior for an element's overflow in vertical direction.
-     *
-     * @default 'visible'
-     */
-    readonly overflowY?: 'visible' | 'hidden' | 'scroll';
-    /**
-     * Exclude this box's cells from text selection in fullscreen mode.
-     * Cells inside this region are skipped by both the selection highlight
-     * and the copied text — useful for fencing off gutters (line numbers,
-     * diff sigils) so click-drag over a diff yields clean copyable code.
-     * Only affects alt-screen text selection; no-op otherwise.
-     *
-     * `'from-left-edge'` extends the exclusion from column 0 to the box's
-     * right edge for every row it occupies — this covers any upstream
-     * indentation (tool message prefix, tree lines) so a multi-row drag
-     * doesn't pick up leading whitespace from middle rows.
-     */
-    readonly noSelect?: boolean | 'from-left-edge';
-};
-declare const styles: (node: LayoutNode, style?: Styles, resolvedStyle?: Styles) => void;
-export default styles;

package/dist/render/supports-hyperlinks.d.ts

@@ -1,13 +0,0 @@
-export declare const ADDITIONAL_HYPERLINK_TERMINALS: string[];
-type EnvLike = Record<string, string | undefined>;
-type SupportsHyperlinksOptions = {
-    env?: EnvLike;
-    stdoutSupported?: boolean;
-};
-/**
- * Returns whether stdout supports OSC 8 hyperlinks.
- * Extends the supports-hyperlinks library with additional terminal detection.
- * @param options Optional overrides for testing (env, stdoutSupported)
- */
-export declare function supportsHyperlinks(options?: SupportsHyperlinksOptions): boolean;
-export {};

package/dist/render/tabstops.d.ts

@@ -1 +0,0 @@
-export declare function expandTabs(text: string, interval?: number): string;

package/dist/render/terminal-focus-state.d.ts

@@ -1,6 +0,0 @@
-export type TerminalFocusState = 'focused' | 'blurred' | 'unknown';
-export declare function setTerminalFocused(v: boolean): void;
-export declare function getTerminalFocused(): boolean;
-export declare function getTerminalFocusState(): TerminalFocusState;
-export declare function subscribeTerminalFocus(cb: () => void): () => void;
-export declare function resetTerminalFocusState(): void;

package/dist/render/terminal-querier.d.ts

@@ -1,129 +0,0 @@
-/**
- * Query the terminal and await responses without timeouts.
- *
- * Terminal queries (DECRQM, DA1, OSC 11, etc.) share the stdin stream
- * with keyboard input. Response sequences are syntactically
- * distinguishable from key events, so the input parser recognizes them
- * and dispatches them here.
- *
- * To avoid timeouts, each query batch is terminated by a DA1 sentinel
- * (CSI c) — every terminal since VT100 responds to DA1, and terminals
- * answer queries in order. So: if your query's response arrives before
- * DA1's, the terminal supports it; if DA1 arrives first, it doesn't.
- *
- * Usage:
- *   const [sync, grapheme] = await Promise.all([
- *     querier.send(decrqm(2026)),
- *     querier.send(decrqm(2027)),
- *     querier.flush(),
- *   ])
- *   // sync and grapheme are DECRPM responses or undefined if unsupported
- */
-import type { TerminalResponse } from './parse-keypress.js';
-/** A terminal query: an outbound request sequence paired with a matcher
- *  that recognizes the expected inbound response. Built by `decrqm()`,
- *  `oscColor()`, `kittyKeyboard()`, etc. */
-export type TerminalQuery<T extends TerminalResponse = TerminalResponse> = {
-    /** Escape sequence to write to stdout */
-    request: string;
-    /** Recognizes the expected response in the inbound stream */
-    match: (r: TerminalResponse) => r is T;
-};
-type DecrpmResponse = Extract<TerminalResponse, {
-    type: 'decrpm';
-}>;
-type Da1Response = Extract<TerminalResponse, {
-    type: 'da1';
-}>;
-type Da2Response = Extract<TerminalResponse, {
-    type: 'da2';
-}>;
-type KittyResponse = Extract<TerminalResponse, {
-    type: 'kittyKeyboard';
-}>;
-type CursorPosResponse = Extract<TerminalResponse, {
-    type: 'cursorPosition';
-}>;
-type OscResponse = Extract<TerminalResponse, {
-    type: 'osc';
-}>;
-type XtversionResponse = Extract<TerminalResponse, {
-    type: 'xtversion';
-}>;
-/** DECRQM: request DEC private mode status (CSI ? mode $ p).
- *  Terminal replies with DECRPM (CSI ? mode ; status $ y) or ignores. */
-export declare function decrqm(mode: number): TerminalQuery<DecrpmResponse>;
-/** Primary Device Attributes query (CSI c). Every terminal answers this —
- *  used internally by flush() as a universal sentinel. Call directly if
- *  you want the DA1 params. */
-export declare function da1(): TerminalQuery<Da1Response>;
-/** Secondary Device Attributes query (CSI > c). Returns terminal version. */
-export declare function da2(): TerminalQuery<Da2Response>;
-/** Query current Kitty keyboard protocol flags (CSI ? u).
- *  Terminal replies with CSI ? flags u or ignores. */
-export declare function kittyKeyboard(): TerminalQuery<KittyResponse>;
-/** DECXCPR: request cursor position with DEC-private marker (CSI ? 6 n).
- *  Terminal replies with CSI ? row ; col R. The `?` marker is critical —
- *  the plain DSR form (CSI 6 n → CSI row;col R) is ambiguous with
- *  modified F3 keys (Shift+F3 = CSI 1;2 R, etc.). */
-export declare function cursorPosition(): TerminalQuery<CursorPosResponse>;
-/** OSC dynamic color query (e.g. OSC 11 for bg color, OSC 10 for fg).
- *  The `?` data slot asks the terminal to reply with the current value. */
-export declare function oscColor(code: number): TerminalQuery<OscResponse>;
-/** XTVERSION: request terminal name/version (CSI > 0 q).
- *  Terminal replies with DCS > | name ST (e.g. "xterm.js(5.5.0)") or ignores.
- *  This survives SSH — the query goes through the pty, not the environment,
- *  so it identifies the *client* terminal even when TERM_PROGRAM isn't
- *  forwarded. Used to detect xterm.js for wheel-scroll compensation. */
-export declare function xtversion(): TerminalQuery<XtversionResponse>;
-export declare class TerminalQuerier {
-    private stdout;
-    /**
-     * Interleaved queue of queries and sentinels in send order. Terminals
-     * respond in order, so each flush() barrier only drains queries queued
-     * before it — concurrent batches from independent callers stay isolated.
-     */
-    private queue;
-    constructor(stdout: NodeJS.WriteStream);
-    /**
-     * Send a query and wait for its response.
-     *
-     * Resolves with the response when `query.match` matches an incoming
-     * TerminalResponse, or with `undefined` when a flush() sentinel arrives
-     * before any matching response (meaning the terminal ignored the query).
-     *
-     * Never rejects; never times out on its own. If you never call flush()
-     * and the terminal doesn't respond, the promise remains pending.
-     */
-    send<T extends TerminalResponse>(query: TerminalQuery<T>): Promise<T | undefined>;
-    /**
-     * Send the DA1 sentinel. Resolves when DA1's response arrives.
-     *
-     * As a side effect, all queries still pending when DA1 arrives are
-     * resolved with `undefined` (terminal didn't respond → doesn't support
-     * the query). This is the barrier that makes send() timeout-free.
-     *
-     * Safe to call with no pending queries — still waits for a round-trip.
-     */
-    flush(): Promise<void>;
-    /**
-     * Dispatch a response parsed from stdin. Called by App.tsx's
-     * processKeysInBatch for every `kind: 'response'` item.
-     *
-     * Matching strategy:
-     * - First, try to match a pending query (FIFO, first match wins).
-     *   This lets callers send(da1()) explicitly if they want the DA1
-     *   params — a separate DA1 write means the terminal sends TWO DA1
-     *   responses. The first matches the explicit query; the second
-     *   (unmatched) fires the sentinel.
-     * - Otherwise, if this is a DA1, fire the FIRST pending sentinel:
-     *   resolve any queries queued before that sentinel with undefined
-     *   (the terminal answered DA1 without answering them → unsupported)
-     *   and signal its flush() completion. Only draining up to the first
-     *   sentinel keeps later batches intact when multiple callers have
-     *   concurrent queries in flight.
-     * - Unsolicited responses (no match, no sentinel) are silently dropped.
-     */
-    onResponse(r: TerminalResponse): void;
-}
-export {};

package/dist/render/terminal.d.ts

@@ -1,46 +0,0 @@
-import type { Writable } from 'stream';
-import type { Diff } from './frame.js';
-export type Progress = {
-    state: 'running' | 'completed' | 'error' | 'indeterminate';
-    percentage?: number;
-};
-/**
- * Checks if the terminal supports OSC 9;4 progress reporting.
- * Supported terminals:
- * - ConEmu (Windows) - all versions
- * - Ghostty 1.2.0+
- * - iTerm2 3.6.6+
- *
- * Note: Windows Terminal interprets OSC 9;4 as notifications, not progress.
- */
-export declare function isProgressReportingAvailable(): boolean;
-/**
- * Checks if the terminal supports DEC mode 2026 (synchronized output).
- * When supported, BSU/ESU sequences prevent visible flicker during redraws.
- */
-export declare function isSynchronizedOutputSupported(): boolean;
-/** Record the XTVERSION response. Called once from App.tsx when the reply
- *  arrives on stdin. No-op if already set (defend against re-probe). */
-export declare function setXtversionName(name: string): void;
-/** True if running in an xterm.js-based terminal (VS Code, Cursor, Windsurf
- *  integrated terminals). Combines TERM_PROGRAM env check (fast, sync, but
- *  not forwarded over SSH) with the XTVERSION probe result (async, survives
- *  SSH — query/reply goes through the pty). Early calls may miss the probe
- *  reply — call lazily (e.g. in an event handler) if SSH detection matters. */
-export declare function isXtermJs(): boolean;
-/** True if this terminal correctly handles extended key reporting
- *  (Kitty keyboard protocol + xterm modifyOtherKeys). */
-export declare function supportsExtendedKeys(): boolean;
-/** True if the terminal scrolls the viewport when it receives cursor-up
- *  sequences that reach above the visible area. On Windows, conhost's
- *  SetConsoleCursorPosition follows the cursor into scrollback
- *  (microsoft/terminal#14774), yanking users to the top of their buffer
- *  mid-stream. WT_SESSION catches WSL-in-Windows-Terminal where platform
- *  is linux but output still routes through conhost. */
-export declare function hasCursorUpViewportYankBug(): boolean;
-export declare const SYNC_OUTPUT_SUPPORTED: boolean;
-export type Terminal = {
-    stdout: Writable;
-    stderr: Writable;
-};
-export declare function writeDiffToTerminal(terminal: Terminal, diff: Diff, skipSyncMarkers?: boolean): void;

package/dist/render/termio/ansi.d.ts

@@ -1,65 +0,0 @@
-/**
- * ANSI Control Characters and Escape Sequence Introducers
- *
- * Based on ECMA-48 / ANSI X3.64 standards.
- */
-/**
- * C0 (7-bit) control characters
- */
-export declare const C0: {
-    readonly NUL: 0;
-    readonly SOH: 1;
-    readonly STX: 2;
-    readonly ETX: 3;
-    readonly EOT: 4;
-    readonly ENQ: 5;
-    readonly ACK: 6;
-    readonly BEL: 7;
-    readonly BS: 8;
-    readonly HT: 9;
-    readonly LF: 10;
-    readonly VT: 11;
-    readonly FF: 12;
-    readonly CR: 13;
-    readonly SO: 14;
-    readonly SI: 15;
-    readonly DLE: 16;
-    readonly DC1: 17;
-    readonly DC2: 18;
-    readonly DC3: 19;
-    readonly DC4: 20;
-    readonly NAK: 21;
-    readonly SYN: 22;
-    readonly ETB: 23;
-    readonly CAN: 24;
-    readonly EM: 25;
-    readonly SUB: 26;
-    readonly ESC: 27;
-    readonly FS: 28;
-    readonly GS: 29;
-    readonly RS: 30;
-    readonly US: 31;
-    readonly DEL: 127;
-};
-export declare const ESC = "\u001B";
-export declare const BEL = "\u0007";
-export declare const SEP = ";";
-/**
- * Escape sequence type introducers (byte after ESC)
- */
-export declare const ESC_TYPE: {
-    readonly CSI: 91;
-    readonly OSC: 93;
-    readonly DCS: 80;
-    readonly APC: 95;
-    readonly PM: 94;
-    readonly SOS: 88;
-    readonly ST: 92;
-};
-/** Check if a byte is a C0 control character */
-export declare function isC0(byte: number): boolean;
-/**
- * Check if a byte is an ESC sequence final byte (0-9, :, ;, <, =, >, ?, @ through ~)
- * ESC sequences have a wider final byte range than CSI
- */
-export declare function isEscFinal(byte: number): boolean;