@promptctl/rich-js 0.8.0 → 0.9.0

package/dist/themes/paletteResolver.js

@@ -1,88 +0,0 @@
-import { darken, alphaBlend, contrastFor } from "./colorMath.js";
-const AUTO_NAME = "auto";
-// Modifier matches the trailing "-darken-N" or "-lighten-N" of a name part.
-// Anchored right (`.+` is greedy) because var names themselves contain
-// hyphens — `"primary-background-darken-3"` must split into the var
-// `primary-background` and the modifier `darken-3`, not `primary` /
-// `background-darken-3`.
-const MODIFIER_RE = /^(.+)-(darken|lighten)-(\d+)$/;
-const ALPHA_RE = /^(\d+(?:\.\d+)?)%$/;
-function parse(spec) {
-    const trimmed = spec.trim();
-    if (trimmed === "")
-        return null;
-    const [namePart, alphaPart, ...rest] = trimmed.split(/\s+/);
-    if (namePart === undefined || rest.length > 0)
-        return null;
-    let alpha = null;
-    if (alphaPart !== undefined) {
-        const m = ALPHA_RE.exec(alphaPart);
-        if (m === null)
-            return null;
-        const pct = parseFloat(m[1]);
-        if (pct < 0 || pct > 100)
-            return null;
-        alpha = pct / 100;
-    }
-    const mod = MODIFIER_RE.exec(namePart);
-    if (mod !== null) {
-        const levels = parseInt(mod[3], 10);
-        return {
-            name: mod[1],
-            darkenLevels: mod[2] === "darken" ? levels : -levels,
-            alpha,
-        };
-    }
-    return { name: namePart, darkenLevels: 0, alpha };
-}
-/**
- * Resolves Textual-style spec strings against a Palette into ColorRgba values.
- *
- * Spec grammar:
- *   spec      = name ("-darken-" N | "-lighten-" N)? (" " NN "%")?
- *   name      = "auto" | <palette var name>
- *
- * Examples (against gruvbox):
- *   "primary"                  → palette["primary"]
- *   "primary-background"       → palette["primary-background"] (name has hyphens)
- *   "primary-darken-3"         → darken(palette["primary"], 3)
- *   "primary 50%"              → alphaBlend(palette["primary"], against, 0.5)
- *   "auto 33%"                 → alphaBlend(contrastFor(against), against, 0.33)
- *   "primary-darken-3 50%"     → alphaBlend(darken(palette["primary"], 3), against, 0.5)
- *
- * Returns null on: invalid syntax, missing var, or missing required `against`.
- * Pure: same inputs always yield the same output, no internal state.
- */
-export class PaletteResolver {
-    palette;
-    constructor(palette) {
-        this.palette = palette;
-    }
-    resolve(spec, ctx) {
-        const parsed = parse(spec);
-        if (parsed === null)
-            return null;
-        // [LAW:one-type-per-behavior] `auto` is a synthetic var whose "lookup"
-        // depends on ctx; named vars look up in the palette. Both produce a
-        // ColorRgba | null, so the pipeline downstream is identical.
-        const base = this.lookupBase(parsed.name, ctx);
-        if (base === null)
-            return null;
-        // [LAW:dataflow-not-control-flow] darken at level 0 is a no-op (modulo
-        // ±1 RGB roundtrip); we always run it and let the data (levels) decide
-        // the magnitude. Negative levels lighten — same op, different value.
-        const modified = darken(base, parsed.darkenLevels);
-        if (parsed.alpha === null)
-            return modified;
-        if (!ctx?.against)
-            return null;
-        return alphaBlend(modified, ctx.against, parsed.alpha);
-    }
-    lookupBase(name, ctx) {
-        if (name === AUTO_NAME) {
-            return ctx?.against ? contrastFor(ctx.against) : null;
-        }
-        return this.palette.get(name) ?? null;
-    }
-}
-//# sourceMappingURL=paletteResolver.js.map

package/dist/themes/paletteResolver.js.map

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

package/dist/widgets/host-stream.d.ts

@@ -1,31 +0,0 @@
-/**
- * hostStream — adapt a `TerminalHost` into the narrow Writable surface that
- * Console (and Live) actually exercise.
- *
- * [LAW:types-are-the-program] The return type matches Console's `ConsoleSink`
- * exactly: a single `.write(chunk)` method whose return value Console never
- * inspects (so the type leaves it as `unknown`; this implementation happens
- * to return `true` to mirror Node's stream contract, but callers may not
- * rely on that). Anything wider would lie about what this adapter
- * implements; anything narrower would force a cast at the call site.
- * Calling `.pipe()`, `.cork()`, `.on('error')`, etc. is a programming error
- * that TypeScript will reject at compile time.
- *
- * [LAW:locality-or-seam] Console + Live access their sink only via `.write()`
- * — verified in src/core/console.ts (one `_file.write` call) and
- * src/renderables/live.ts (every `this._console.file.write(...)` site). So
- * this narrow surface is the entire contract they need.
- */
-import type { ConsoleSink } from "../core/console.js";
-import type { TerminalHost } from "./terminal-host.js";
-/**
- * Wrap a `TerminalHost` so its output can be threaded into `Console` via the
- * existing `file:` option. The returned object implements `.write()` only —
- * exactly the surface Console + Live touch.
- *
- * Pair with `forceTerminal: true` on the Console — without it, Console treats
- * any non-undefined `file` option as non-TTY and disables color, which
- * defeats the point.
- */
-export declare function hostStream(host: TerminalHost): ConsoleSink;
-//# sourceMappingURL=host-stream.d.ts.map

package/dist/widgets/host-stream.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"host-stream.d.ts","sourceRoot":"","sources":["../../src/widgets/host-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,WAAW,CAO1D"}

package/dist/widgets/host-stream.js

@@ -1,36 +0,0 @@
-/**
- * hostStream — adapt a `TerminalHost` into the narrow Writable surface that
- * Console (and Live) actually exercise.
- *
- * [LAW:types-are-the-program] The return type matches Console's `ConsoleSink`
- * exactly: a single `.write(chunk)` method whose return value Console never
- * inspects (so the type leaves it as `unknown`; this implementation happens
- * to return `true` to mirror Node's stream contract, but callers may not
- * rely on that). Anything wider would lie about what this adapter
- * implements; anything narrower would force a cast at the call site.
- * Calling `.pipe()`, `.cork()`, `.on('error')`, etc. is a programming error
- * that TypeScript will reject at compile time.
- *
- * [LAW:locality-or-seam] Console + Live access their sink only via `.write()`
- * — verified in src/core/console.ts (one `_file.write` call) and
- * src/renderables/live.ts (every `this._console.file.write(...)` site). So
- * this narrow surface is the entire contract they need.
- */
-/**
- * Wrap a `TerminalHost` so its output can be threaded into `Console` via the
- * existing `file:` option. The returned object implements `.write()` only —
- * exactly the surface Console + Live touch.
- *
- * Pair with `forceTerminal: true` on the Console — without it, Console treats
- * any non-undefined `file` option as non-TTY and disables color, which
- * defeats the point.
- */
-export function hostStream(host) {
-    return {
-        write(chunk) {
-            host.write(chunk);
-            return true;
-        },
-    };
-}
-//# sourceMappingURL=host-stream.js.map

package/dist/widgets/host-stream.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"host-stream.js","sourceRoot":"","sources":["../../src/widgets/host-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,IAAkB;IAC3C,OAAO;QACL,KAAK,CAAC,KAA0B;YAC9B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/widgets/terminal-host.d.ts

@@ -1,138 +0,0 @@
-/**
- * TerminalHost — the capability seam between the interactive runtime and its
- * I/O environment.
- *
- * [LAW:locality-or-seam] The missing seam *was* the missing type. Before this
- * type existed, Screen and EventRouter reached for ambient `process.stdin`/
- * `process.stdout`, which crystallised them to node. With a `TerminalHost`
- * value flowing across one boundary, the same runtime code runs against any
- * implementation — node's TTY (`NodeTerminalHost`, on the `node/terminal-host`
- * subpath) or a browser xterm.js terminal (`BrowserTerminalHost`, below).
- *
- * [LAW:dataflow-not-control-flow] The runtime never branches on "am I in
- * node or browser." The host is the value that differs; the code path is
- * the same. Variability lives in which host is constructed at the program
- * entry, not in any `if` inside the runtime.
- *
- * [LAW:one-way-deps] The interface and the browser host live here, in the
- * barrel; the node host lives in `src/node/terminal-host.ts`, behind an
- * explicit subpath, because it reads `process.stdin` / `process.stdout`. The
- * dependency runs one way — the node adapter imports this seam; nothing here
- * imports the adapter — so importing the main barrel in a browser cannot
- * reach the ambient `process` global by any path, rather than merely not
- * reaching it in practice. `test/seam/browser-safe.test.ts` is what holds
- * that direction; who reads the host at all is `HOST_ACCESS` in
- * `test/seam/ambient-process.ts`, and neither list is repeated here.
- *
- * [boundaries: capabilities over context] A `TerminalHost` grants exactly
- * the I/O capabilities the runtime needs: write bytes, read input, query
- * size, observe resize, switch raw mode, lifecycle. It is not an
- * omniscient handle to "the process."
- */
-import type { Unsubscribe } from "./types.js";
-export interface TerminalSize {
-    readonly cols: number;
-    readonly rows: number;
-}
-export type DataHandler = (chunk: Uint8Array | string) => void;
-export type ResizeHandler = (size: TerminalSize) => void;
-export interface TerminalHost {
-    /**
-     * Write raw bytes (or UTF-8 text) to the terminal. The byte sequence is
-     * written verbatim; no escape interpretation, no framing.
-     */
-    write(data: Uint8Array | string): void;
-    /**
-     * Subscribe to input data. The host emits whatever its underlying
-     * transport produces (Buffer on node, string on browser xterm.js); the
-     * runtime's parser accepts either.
-     */
-    onData(handler: DataHandler): Unsubscribe;
-    /**
-     * Subscribe to terminal resize events. The handler fires with the new
-     * size after a resize is observed.
-     */
-    onResize(handler: ResizeHandler): Unsubscribe;
-    /** Current terminal size in cells. Always returns a valid size. */
-    size(): TerminalSize;
-    /**
-     * Enable or disable raw mode on the input side. Implementations whose
-     * transport has no "cooked" mode (xterm.js, non-TTY pipes) silently
-     * no-op so callers don't need to branch on capability.
-     */
-    setRawMode(raw: boolean): void;
-    /**
-     * Whether the host is connected to a real interactive terminal. Drives
-     * default option values (e.g. `manageCursor`, `manageRawMode`) in the
-     * runtime; non-TTY hosts default those features off.
-     */
-    readonly isTTY: boolean;
-    /**
-     * Begin the host's lifecycle. Implementations attach whatever resources
-     * they own — or no-op when there is nothing to attach. Idempotent. See
-     * the concrete host's own JSDoc for what its `start()` actually does:
-     * `NodeTerminalHost` and `BrowserTerminalHost` both no-op because their
-     * underlying transports (process streams; a caller-managed xterm.js
-     * Terminal) are already live by the time the host is constructed.
-     */
-    start(): void;
-    /**
-     * Stop the host's lifecycle. Pairs with `start`. Idempotent. After
-     * `stop()`, the host releases its own subscriptions to the underlying
-     * transport and clears its handler sets; the transport itself is not
-     * torn down (that is the caller's concern — process streams persist;
-     * an xterm.js Terminal is disposed by the caller). Re-subscribing via
-     * `onData` / `onResize` after `stop()` re-engages the host.
-     */
-    stop(): void;
-}
-/**
- * Subset of xterm.js's `Terminal` surface the browser host depends on.
- *
- * [LAW:locality-or-seam] Declaring the dependency by *shape* — rather than
- * importing xterm.js's types — keeps this package free of an xterm.js
- * dev-dep at the type level, lets the browser-bundle pipeline (downstream
- * ticket) pin whichever xterm.js version it wants, and lets unit tests
- * pass a hand-built fake: ask for exactly the capabilities the host uses,
- * no more.
- */
-export interface XtermDisposable {
-    dispose(): void;
-}
-export interface XtermResizeEvent {
-    cols: number;
-    rows: number;
-}
-export interface XtermTerminal {
-    readonly cols: number;
-    readonly rows: number;
-    write(data: Uint8Array | string): void;
-    onData(handler: (data: string) => void): XtermDisposable;
-    onResize(handler: (size: XtermResizeEvent) => void): XtermDisposable;
-}
-export interface BrowserTerminalHostOptions {
-    /**
-     * The xterm.js `Terminal` instance to wrap. The caller is responsible
-     * for its DOM lifecycle (`terminal.open(element)`, `terminal.dispose()`)
-     * — the host only owns its own subscriber lifecycle, exactly mirroring
-     * `NodeTerminalHost`'s relationship to `process.stdin`/`process.stdout`.
-     */
-    terminal: XtermTerminal;
-}
-export declare class BrowserTerminalHost implements TerminalHost {
-    private readonly terminal;
-    private readonly dataHandlers;
-    private readonly resizeHandlers;
-    private dataSubscription;
-    private resizeSubscription;
-    constructor(options: BrowserTerminalHostOptions);
-    get isTTY(): boolean;
-    write(data: Uint8Array | string): void;
-    size(): TerminalSize;
-    setRawMode(_raw: boolean): void;
-    onData(handler: DataHandler): Unsubscribe;
-    onResize(handler: ResizeHandler): Unsubscribe;
-    start(): void;
-    stop(): void;
-}
-//# sourceMappingURL=terminal-host.d.ts.map

package/dist/widgets/terminal-host.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"terminal-host.d.ts","sourceRoot":"","sources":["../../src/widgets/terminal-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAS9C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,KAAK,IAAI,CAAC;AAC/D,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC;IAEvC;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CAAC;IAE1C;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,WAAW,CAAC;IAE9C,mEAAmE;IACnE,IAAI,IAAI,YAAY,CAAC;IAErB;;;;OAIG;IACH,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IAE/B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IAExB;;;;;;;OAOG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;;;;;;OAOG;IACH,IAAI,IAAI,IAAI,CAAC;CACd;AAMD;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC;IACvC,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,eAAe,CAAC;IACzD,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,GAAG,eAAe,CAAC;CACtE;AAED,MAAM,WAAW,0BAA0B;IACzC;;;;;OAKG;IACH,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED,qBAAa,mBAAoB,YAAW,YAAY;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA0B;IACvD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4B;IAC3D,OAAO,CAAC,gBAAgB,CAA8B;IACtD,OAAO,CAAC,kBAAkB,CAA8B;gBAE5C,OAAO,EAAE,0BAA0B;IAQ/C,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IAItC,IAAI,IAAI,YAAY;IAUpB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAO/B,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW;IAgBzC,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,WAAW;IAiB7C,KAAK,IAAI,IAAI;IASb,IAAI,IAAI,IAAI;CAmBb"}

package/dist/widgets/terminal-host.js

@@ -1,127 +0,0 @@
-/**
- * TerminalHost — the capability seam between the interactive runtime and its
- * I/O environment.
- *
- * [LAW:locality-or-seam] The missing seam *was* the missing type. Before this
- * type existed, Screen and EventRouter reached for ambient `process.stdin`/
- * `process.stdout`, which crystallised them to node. With a `TerminalHost`
- * value flowing across one boundary, the same runtime code runs against any
- * implementation — node's TTY (`NodeTerminalHost`, on the `node/terminal-host`
- * subpath) or a browser xterm.js terminal (`BrowserTerminalHost`, below).
- *
- * [LAW:dataflow-not-control-flow] The runtime never branches on "am I in
- * node or browser." The host is the value that differs; the code path is
- * the same. Variability lives in which host is constructed at the program
- * entry, not in any `if` inside the runtime.
- *
- * [LAW:one-way-deps] The interface and the browser host live here, in the
- * barrel; the node host lives in `src/node/terminal-host.ts`, behind an
- * explicit subpath, because it reads `process.stdin` / `process.stdout`. The
- * dependency runs one way — the node adapter imports this seam; nothing here
- * imports the adapter — so importing the main barrel in a browser cannot
- * reach the ambient `process` global by any path, rather than merely not
- * reaching it in practice. `test/seam/browser-safe.test.ts` is what holds
- * that direction; who reads the host at all is `HOST_ACCESS` in
- * `test/seam/ambient-process.ts`, and neither list is repeated here.
- *
- * [boundaries: capabilities over context] A `TerminalHost` grants exactly
- * the I/O capabilities the runtime needs: write bytes, read input, query
- * size, observe resize, switch raw mode, lifecycle. It is not an
- * omniscient handle to "the process."
- */
-export class BrowserTerminalHost {
-    terminal;
-    dataHandlers = new Set();
-    resizeHandlers = new Set();
-    dataSubscription;
-    resizeSubscription;
-    constructor(options) {
-        this.terminal = options.terminal;
-    }
-    // [LAW:dataflow-not-control-flow] xterm.js is always an interactive
-    // terminal — there is no "non-TTY" code path in the browser. The
-    // runtime never branches on the value; this is the only sensible
-    // constant for this host.
-    get isTTY() {
-        return true;
-    }
-    write(data) {
-        this.terminal.write(data);
-    }
-    size() {
-        return { cols: this.terminal.cols, rows: this.terminal.rows };
-    }
-    // [LAW:dataflow-not-control-flow] xterm.js delivers keystrokes raw
-    // unconditionally — there is no cooked mode to toggle. The no-op
-    // matches the TerminalHost contract's documented "silently no-op when
-    // the transport has no cooked mode," so callers stay uniform across
-    // hosts. (Mirror: NodeTerminalHost on a non-TTY stream takes the same
-    // no-op path via the optional-chain in `applyRawMode`.)
-    setRawMode(_raw) { }
-    // [LAW:single-enforcer] One underlying `terminal.onData` subscription
-    // fans out to every host-level handler — the same lazy-attach,
-    // last-unsubscribe-detaches shape as NodeTerminalHost.onData. The
-    // runtime never sees the underlying subscription; it sees a single
-    // uniform `(handler) => Unsubscribe` API across hosts.
-    onData(handler) {
-        this.dataHandlers.add(handler);
-        if (!this.dataSubscription) {
-            this.dataSubscription = this.terminal.onData((chunk) => {
-                for (const h of this.dataHandlers)
-                    h(chunk);
-            });
-        }
-        return () => {
-            this.dataHandlers.delete(handler);
-            if (this.dataHandlers.size === 0 && this.dataSubscription) {
-                this.dataSubscription.dispose();
-                this.dataSubscription = undefined;
-            }
-        };
-    }
-    onResize(handler) {
-        this.resizeHandlers.add(handler);
-        if (!this.resizeSubscription) {
-            this.resizeSubscription = this.terminal.onResize((size) => {
-                const snapshot = { cols: size.cols, rows: size.rows };
-                for (const h of this.resizeHandlers)
-                    h(snapshot);
-            });
-        }
-        return () => {
-            this.resizeHandlers.delete(handler);
-            if (this.resizeHandlers.size === 0 && this.resizeSubscription) {
-                this.resizeSubscription.dispose();
-                this.resizeSubscription = undefined;
-            }
-        };
-    }
-    start() {
-        // [LAW:one-source-of-truth] The host does NOT own the terminal's DOM
-        // lifecycle (`terminal.open` / `terminal.dispose`). That is the
-        // caller's responsibility, exactly as NodeTerminalHost does not own
-        // `process.stdin`/`process.stdout`. start() is here so the runtime
-        // can call it uniformly across hosts; for this host there is
-        // nothing to do at this seam.
-    }
-    stop() {
-        // [LAW:one-source-of-truth] Symmetric teardown mirroring
-        // NodeTerminalHost.stop: drop every host-level subscriber and
-        // dispose the underlying terminal subscriptions. The terminal
-        // itself stays alive — re-subscribing via onData/onResize after
-        // stop() works, since the lazy-attach path re-creates the
-        // subscription on next subscribe. Calling stop() repeatedly is
-        // safe — the subscription guards make later calls no-ops.
-        if (this.dataSubscription) {
-            this.dataSubscription.dispose();
-            this.dataSubscription = undefined;
-        }
-        if (this.resizeSubscription) {
-            this.resizeSubscription.dispose();
-            this.resizeSubscription = undefined;
-        }
-        this.dataHandlers.clear();
-        this.resizeHandlers.clear();
-    }
-}
-//# sourceMappingURL=terminal-host.js.map

package/dist/widgets/terminal-host.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"terminal-host.js","sourceRoot":"","sources":["../../src/widgets/terminal-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAsHH,MAAM,OAAO,mBAAmB;IACb,QAAQ,CAAgB;IACxB,YAAY,GAAG,IAAI,GAAG,EAAe,CAAC;IACtC,cAAc,GAAG,IAAI,GAAG,EAAiB,CAAC;IACnD,gBAAgB,CAA8B;IAC9C,kBAAkB,CAA8B;IAExD,YAAY,OAAmC;QAC7C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IACnC,CAAC;IAED,oEAAoE;IACpE,iEAAiE;IACjE,iEAAiE;IACjE,0BAA0B;IAC1B,IAAI,KAAK;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,IAAyB;QAC7B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI;QACF,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChE,CAAC;IAED,mEAAmE;IACnE,iEAAiE;IACjE,sEAAsE;IACtE,oEAAoE;IACpE,sEAAsE;IACtE,wDAAwD;IACxD,UAAU,CAAC,IAAa,IAAS,CAAC;IAElC,sEAAsE;IACtE,+DAA+D;IAC/D,kEAAkE;IAClE,mEAAmE;IACnE,uDAAuD;IACvD,MAAM,CAAC,OAAoB;QACzB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC3B,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAa,EAAE,EAAE;gBAC7D,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,YAAY;oBAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YAC9C,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAClC,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;gBAC1D,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;gBAChC,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;YACpC,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,OAAsB;QAC7B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC7B,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAsB,EAAE,EAAE;gBAC1E,MAAM,QAAQ,GAAiB,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;gBACpE,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,cAAc;oBAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;YACnD,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACpC,IAAI,IAAI,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBAC9D,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,CAAC;gBAClC,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;YACtC,CAAC;QACH,CAAC,CAAC;IACJ,CAAC;IAED,KAAK;QACH,qEAAqE;QACrE,gEAAgE;QAChE,oEAAoE;QACpE,mEAAmE;QACnE,6DAA6D;QAC7D,8BAA8B;IAChC,CAAC;IAED,IAAI;QACF,yDAAyD;QACzD,8DAA8D;QAC9D,8DAA8D;QAC9D,gEAAgE;QAChE,0DAA0D;QAC1D,+DAA+D;QAC/D,0DAA0D;QAC1D,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC1B,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;YAChC,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;QACpC,CAAC;QACD,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC5B,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,CAAC,kBAAkB,GAAG,SAAS,CAAC;QACtC,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;CACF"}