poly-weaver 0.5.0 → 0.6.0

package/dist/terminal/layout.js

@@ -0,0 +1,51 @@
+/**
+ * Pure layout computation for the orchestration terminal host.
+ *
+ * The host owns the real terminal during orchestration. The single
+ * source of truth for "how big is the child viewport", "where does the
+ * warning strip go", and "where does the status row go" is
+ * `computeTerminalLayout()`. PTY spawn, virtual-terminal sizing, child
+ * rendering, warning rendering, and status-bar rendering all read from
+ * the same layout object.
+ *
+ * Policy:
+ * - When status is enabled and rows >= 2, reserve exactly 1 status row.
+ * - When rows === 1, reserve 0 status rows; the child gets the only row.
+ * - When status is disabled (non-host or non-TTY), reserve 0 status rows.
+ * - `warningRows` is the host-owned warning strip immediately above the
+ *   status row. It is clamped to 0..3 and capped further so the child
+ *   viewport always keeps at least 1 row.
+ */
+/**
+ * Compute the host layout. Pure: no side effects.
+ *
+ * - `columns` and `rows` are clamped to >= 1 even if the input is 0/negative.
+ * - `statusRows` is 1 only when `statusEnabled` AND `rows >= 2`.
+ * - `warningRows` is clamped to 0..3, then capped so `childRows >= 1`.
+ * - `childRows` is always >= 1.
+ * - `warningStartRow` is the first warning row (1-based) when `warningRows > 0`, else undefined.
+ * - `statusRow` is the 1-based bottom row when reserved, otherwise undefined.
+ */
+export function computeTerminalLayout(input) {
+    const columns = Math.max(1, Math.floor(input.columns));
+    const rows = Math.max(1, Math.floor(input.rows));
+    const statusRows = input.statusEnabled && rows >= 2 ? 1 : 0;
+    const requestedWarning = Math.max(0, Math.min(3, Math.floor(input.warningRows ?? 0)));
+    const availableForWarning = Math.max(0, rows - statusRows - 1);
+    const warningRows = Math.min(requestedWarning, availableForWarning);
+    const childCols = columns;
+    const childRows = Math.max(1, rows - statusRows - warningRows);
+    const warningStartRow = warningRows > 0 ? childRows + 1 : undefined;
+    const statusRow = statusRows === 1 ? rows : undefined;
+    return {
+        columns,
+        rows,
+        statusRows,
+        warningRows,
+        childCols,
+        childRows,
+        warningStartRow,
+        statusRow,
+    };
+}
+//# sourceMappingURL=layout.js.map

package/dist/terminal/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../src/terminal/layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA6BH;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAkB;IACtD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACjD,MAAM,UAAU,GAAU,KAAK,CAAC,aAAa,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACtF,MAAM,mBAAmB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;IACpE,MAAM,SAAS,GAAG,OAAO,CAAC;IAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,UAAU,GAAG,WAAW,CAAC,CAAC;IAC/D,MAAM,eAAe,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,MAAM,SAAS,GAAG,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACtD,OAAO;QACL,OAAO;QACP,IAAI;QACJ,UAAU;QACV,WAAW;QACX,SAAS;QACT,SAAS;QACT,eAAe;QACf,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/terminal/output.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Parent-owned orchestration output sink.
+ *
+ * While the orchestration host owns the alternate screen, code must not
+ * call `console.*`, `process.stdout.write`, or `process.stderr.write`
+ * for orchestration logs — direct writes shift the child viewport and
+ * overwrite the status row. Use this sink instead.
+ *
+ * Two implementations:
+ *   - `ConsoleOrchestrationOutput` for non-host paths (non-TTY, programmatic
+ *     callers, pre-orchestration CLI failures).
+ *   - `BufferOrchestrationOutput` for host-backed orchestration. The host
+ *     reads the buffer when it composes a frame and renders messages in
+ *     the parent-owned region above the status bar.
+ */
+export type OrchestrationMessageKind = "phase" | "warn" | "error" | "append";
+export interface OrchestrationMessage {
+    kind: OrchestrationMessageKind;
+    /** Phase label when kind === "phase". */
+    phase?: string;
+    /** Body text. May contain ANSI styling. */
+    text: string;
+    /** Monotonic timestamp for de-duplication and ordering. */
+    ts: number;
+}
+export interface OrchestrationOutput {
+    phase(phase: string, message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    append(message: string): void;
+    /**
+     * Drop all buffered messages. The host-backed sink shrinks its warning
+     * strip on the next repaint; the console-backed sink is a no-op.
+     * Used by the executor to clear stale retry warnings on step boundaries.
+     */
+    clear(): void;
+}
+/**
+ * Console-backed sink used outside the orchestration host (non-TTY,
+ * programmatic callers). Mirrors the legacy `logPhase()` formatting.
+ */
+export declare class ConsoleOrchestrationOutput implements OrchestrationOutput {
+    phase(phase: string, message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    append(message: string): void;
+    clear(): void;
+}
+/**
+ * Host-backed sink. Stores messages in memory and notifies the host so it
+ * can repaint. The host is responsible for clipping to its message area
+ * and dropping older messages when it runs out of room.
+ */
+export declare class BufferOrchestrationOutput implements OrchestrationOutput {
+    private readonly messages;
+    private readonly maxMessages;
+    private onChange?;
+    constructor(opts?: {
+        maxMessages?: number;
+        onChange?: () => void;
+    });
+    /** Set or replace the change-notification callback. */
+    setOnChange(cb: (() => void) | undefined): void;
+    phase(phase: string, message: string): void;
+    warn(message: string): void;
+    error(message: string): void;
+    append(message: string): void;
+    /** Snapshot of buffered messages, oldest first. */
+    snapshot(): readonly OrchestrationMessage[];
+    /**
+     * Drop all buffered messages. Fires `onChange` only when messages were
+     * actually removed, so the host can shrink its warning strip without
+     * paying a repaint when the buffer was already empty.
+     */
+    clear(): void;
+    private push;
+}
+/**
+ * Format a single message for one-row rendering. Styling matches the legacy
+ * `logPhase()` output where possible.
+ */
+export declare function formatOrchestrationMessage(msg: OrchestrationMessage): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/terminal/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/terminal/output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE7E,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B;;;;OAIG;IACH,KAAK,IAAI,IAAI,CAAC;CACf;AAID;;;GAGG;AACH,qBAAa,0BAA2B,YAAW,mBAAmB;IACpE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAG3C,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAG3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAG5B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAG7B,KAAK,IAAI,IAAI;CAGd;AAED;;;;GAIG;AACH,qBAAa,yBAA0B,YAAW,mBAAmB;IACnE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,CAAa;gBAElB,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE;IAKlE,uDAAuD;IACvD,WAAW,CAAC,EAAE,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI;IAI/C,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3C,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI5B,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI7B,mDAAmD;IACnD,QAAQ,IAAI,SAAS,oBAAoB,EAAE;IAI3C;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,IAAI;CAOb;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,oBAAoB,GAAG,MAAM,CAY5E"}

package/dist/terminal/output.js

@@ -0,0 +1,107 @@
+/**
+ * Parent-owned orchestration output sink.
+ *
+ * While the orchestration host owns the alternate screen, code must not
+ * call `console.*`, `process.stdout.write`, or `process.stderr.write`
+ * for orchestration logs — direct writes shift the child viewport and
+ * overwrite the status row. Use this sink instead.
+ *
+ * Two implementations:
+ *   - `ConsoleOrchestrationOutput` for non-host paths (non-TTY, programmatic
+ *     callers, pre-orchestration CLI failures).
+ *   - `BufferOrchestrationOutput` for host-backed orchestration. The host
+ *     reads the buffer when it composes a frame and renders messages in
+ *     the parent-owned region above the status bar.
+ */
+import { dim, reset, cyan, yellow, red } from "../ansi.js";
+/**
+ * Console-backed sink used outside the orchestration host (non-TTY,
+ * programmatic callers). Mirrors the legacy `logPhase()` formatting.
+ */
+export class ConsoleOrchestrationOutput {
+    phase(phase, message) {
+        console.log(`\n${dim}[poly-weaver]${reset} ${cyan}${phase}${reset}: ${message}\n`);
+    }
+    warn(message) {
+        console.warn(`${yellow}[poly-weaver]${reset} ${message}`);
+    }
+    error(message) {
+        console.error(`${red}[poly-weaver]${reset} ${message}`);
+    }
+    append(message) {
+        console.log(message);
+    }
+    clear() {
+        // No-op for the console sink — there is no buffer to drop.
+    }
+}
+/**
+ * Host-backed sink. Stores messages in memory and notifies the host so it
+ * can repaint. The host is responsible for clipping to its message area
+ * and dropping older messages when it runs out of room.
+ */
+export class BufferOrchestrationOutput {
+    messages = [];
+    maxMessages;
+    onChange;
+    constructor(opts) {
+        this.maxMessages = opts?.maxMessages ?? 200;
+        this.onChange = opts?.onChange;
+    }
+    /** Set or replace the change-notification callback. */
+    setOnChange(cb) {
+        this.onChange = cb;
+    }
+    phase(phase, message) {
+        this.push({ kind: "phase", phase, text: message, ts: Date.now() });
+    }
+    warn(message) {
+        this.push({ kind: "warn", text: message, ts: Date.now() });
+    }
+    error(message) {
+        this.push({ kind: "error", text: message, ts: Date.now() });
+    }
+    append(message) {
+        this.push({ kind: "append", text: message, ts: Date.now() });
+    }
+    /** Snapshot of buffered messages, oldest first. */
+    snapshot() {
+        return this.messages;
+    }
+    /**
+     * Drop all buffered messages. Fires `onChange` only when messages were
+     * actually removed, so the host can shrink its warning strip without
+     * paying a repaint when the buffer was already empty.
+     */
+    clear() {
+        if (this.messages.length === 0)
+            return;
+        this.messages.length = 0;
+        this.onChange?.();
+    }
+    push(msg) {
+        this.messages.push(msg);
+        if (this.messages.length > this.maxMessages) {
+            this.messages.splice(0, this.messages.length - this.maxMessages);
+        }
+        this.onChange?.();
+    }
+}
+/**
+ * Format a single message for one-row rendering. Styling matches the legacy
+ * `logPhase()` output where possible.
+ */
+export function formatOrchestrationMessage(msg) {
+    const tag = `${dim}[poly-weaver]${reset}`;
+    switch (msg.kind) {
+        case "phase":
+            return `${tag} ${cyan}${msg.phase ?? ""}${reset}: ${msg.text}`;
+        case "warn":
+            return `${tag} ${yellow}${msg.text}${reset}`;
+        case "error":
+            return `${tag} ${red}${msg.text}${reset}`;
+        case "append":
+            return msg.text;
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/terminal/output.js.map

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

package/dist/terminal/render.d.ts

@@ -0,0 +1,36 @@
+import type { IBufferCell, IBufferLine } from "@xterm/headless";
+import type { VirtualTerminal } from "./virtual-terminal.js";
+import type { TerminalLayout } from "./layout.js";
+/**
+ * Render a single child buffer line as ANSI, using `\x1b[K` to clear
+ * stale cells to the right.
+ *
+ * The returned string assumes the cursor is at column 1 of the target
+ * row when written to stdout.
+ */
+declare function renderLine(line: IBufferLine, cols: number, scratch: IBufferCell): string;
+/**
+ * Render the child viewport into a single ANSI string.
+ *
+ * The string positions the cursor at home, paints `childRows` lines from
+ * the active buffer, and clears any rows below it that lie inside the
+ * non-status region. The status row (when reserved by the layout) is
+ * **not** touched here — the host paints it last, on top of this output.
+ */
+export declare function renderChildViewport(vt: VirtualTerminal, layout: TerminalLayout): string;
+/**
+ * Render an in-band ANSI fragment that paints the status string at
+ * `layout.statusRow` with inverse video, padded/truncated to `columns`.
+ *
+ * Returns `""` if the layout does not reserve a status row.
+ */
+export declare function renderStatusLine(layout: TerminalLayout, text: string): string;
+declare function visibleLength(s: string): number;
+declare function padOrClip(text: string, width: number): string;
+export declare const __test: {
+    padOrClip: typeof padOrClip;
+    visibleLength: typeof visibleLength;
+    renderLine: typeof renderLine;
+};
+export {};
+//# sourceMappingURL=render.d.ts.map

package/dist/terminal/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/terminal/render.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AA6IlD;;;;;;GAMG;AACH,iBAAS,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,MAAM,CAmCjF;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,eAAe,EACnB,MAAM,EAAE,cAAc,GACrB,MAAM,CAkBR;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,GACX,MAAM,CAYR;AAED,iBAAS,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGxC;AAED,iBAAS,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAuBtD;AAED,eAAO,MAAM,MAAM;;;;CAA2C,CAAC"}

package/dist/terminal/render.js

@@ -0,0 +1,233 @@
+const RESET = "\x1b[0m";
+const CLEAR_LINE_RIGHT = "\x1b[K";
+function defaultState() {
+    return {
+        bold: false,
+        dim: false,
+        italic: false,
+        underline: false,
+        blink: false,
+        inverse: false,
+        invisible: false,
+        strikethrough: false,
+        fgMode: "default",
+        fgValue: 0,
+        bgMode: "default",
+        bgValue: 0,
+    };
+}
+function readCellState(cell) {
+    const fgMode = cell.isFgRGB() ? "rgb" : cell.isFgPalette() ? "palette" : "default";
+    const bgMode = cell.isBgRGB() ? "rgb" : cell.isBgPalette() ? "palette" : "default";
+    return {
+        bold: cell.isBold() !== 0,
+        dim: cell.isDim() !== 0,
+        italic: cell.isItalic() !== 0,
+        underline: cell.isUnderline() !== 0,
+        blink: cell.isBlink() !== 0,
+        inverse: cell.isInverse() !== 0,
+        invisible: cell.isInvisible() !== 0,
+        strikethrough: cell.isStrikethrough() !== 0,
+        fgMode,
+        fgValue: cell.getFgColor(),
+        bgMode,
+        bgValue: cell.getBgColor(),
+    };
+}
+function sgrCodes(prev, next) {
+    // Cheap path: identical state — emit nothing.
+    if (prev.bold === next.bold &&
+        prev.dim === next.dim &&
+        prev.italic === next.italic &&
+        prev.underline === next.underline &&
+        prev.blink === next.blink &&
+        prev.inverse === next.inverse &&
+        prev.invisible === next.invisible &&
+        prev.strikethrough === next.strikethrough &&
+        prev.fgMode === next.fgMode &&
+        prev.fgValue === next.fgValue &&
+        prev.bgMode === next.bgMode &&
+        prev.bgValue === next.bgValue) {
+        return "";
+    }
+    // Any attribute that flipped from on to off forces a full reset, since
+    // there's no per-attribute "off" code that's universally portable
+    // (e.g. CSI 22 covers both bold and dim). Keep it correct over clever.
+    const turnedOff = (prev.bold && !next.bold) ||
+        (prev.dim && !next.dim) ||
+        (prev.italic && !next.italic) ||
+        (prev.underline && !next.underline) ||
+        (prev.blink && !next.blink) ||
+        (prev.inverse && !next.inverse) ||
+        (prev.invisible && !next.invisible) ||
+        (prev.strikethrough && !next.strikethrough) ||
+        (prev.fgMode !== "default" && next.fgMode === "default") ||
+        (prev.bgMode !== "default" && next.bgMode === "default");
+    const codes = [];
+    if (turnedOff) {
+        codes.push(0);
+    }
+    const baseline = turnedOff ? defaultState() : prev;
+    if (next.bold && !baseline.bold)
+        codes.push(1);
+    if (next.dim && !baseline.dim)
+        codes.push(2);
+    if (next.italic && !baseline.italic)
+        codes.push(3);
+    if (next.underline && !baseline.underline)
+        codes.push(4);
+    if (next.blink && !baseline.blink)
+        codes.push(5);
+    if (next.inverse && !baseline.inverse)
+        codes.push(7);
+    if (next.invisible && !baseline.invisible)
+        codes.push(8);
+    if (next.strikethrough && !baseline.strikethrough)
+        codes.push(9);
+    let out = "";
+    if (codes.length > 0) {
+        out += `\x1b[${codes.join(";")}m`;
+    }
+    if (next.fgMode !== baseline.fgMode ||
+        (next.fgMode !== "default" && next.fgValue !== baseline.fgValue)) {
+        if (next.fgMode === "palette") {
+            out += `\x1b[38;5;${next.fgValue}m`;
+        }
+        else if (next.fgMode === "rgb") {
+            const r = (next.fgValue >> 16) & 0xff;
+            const g = (next.fgValue >> 8) & 0xff;
+            const b = next.fgValue & 0xff;
+            out += `\x1b[38;2;${r};${g};${b}m`;
+        }
+    }
+    if (next.bgMode !== baseline.bgMode ||
+        (next.bgMode !== "default" && next.bgValue !== baseline.bgValue)) {
+        if (next.bgMode === "palette") {
+            out += `\x1b[48;5;${next.bgValue}m`;
+        }
+        else if (next.bgMode === "rgb") {
+            const r = (next.bgValue >> 16) & 0xff;
+            const g = (next.bgValue >> 8) & 0xff;
+            const b = next.bgValue & 0xff;
+            out += `\x1b[48;2;${r};${g};${b}m`;
+        }
+    }
+    return out;
+}
+/**
+ * Render a single child buffer line as ANSI, using `\x1b[K` to clear
+ * stale cells to the right.
+ *
+ * The returned string assumes the cursor is at column 1 of the target
+ * row when written to stdout.
+ */
+function renderLine(line, cols, scratch) {
+    let out = "";
+    let state = defaultState();
+    let col = 0;
+    while (col < cols) {
+        const cell = line.getCell(col, scratch);
+        if (!cell) {
+            break;
+        }
+        const width = cell.getWidth();
+        if (width === 0) {
+            // Trailing half of a wide character — skip; the cell with width 2
+            // already wrote the glyph that occupies this column.
+            col += 1;
+            continue;
+        }
+        const next = readCellState(cell);
+        const transition = sgrCodes(state, next);
+        if (transition) {
+            out += transition;
+            state = next;
+        }
+        const chars = cell.getChars() || " ";
+        out += chars;
+        col += width;
+    }
+    if (state.fgMode !== "default" || state.bgMode !== "default" ||
+        state.bold || state.dim || state.italic || state.underline ||
+        state.blink || state.inverse || state.invisible || state.strikethrough) {
+        out += RESET;
+    }
+    out += CLEAR_LINE_RIGHT;
+    return out;
+}
+/**
+ * Render the child viewport into a single ANSI string.
+ *
+ * The string positions the cursor at home, paints `childRows` lines from
+ * the active buffer, and clears any rows below it that lie inside the
+ * non-status region. The status row (when reserved by the layout) is
+ * **not** touched here — the host paints it last, on top of this output.
+ */
+export function renderChildViewport(vt, layout) {
+    const buffer = vt.buffer;
+    const scratch = vt.newCell();
+    const top = buffer.viewportY;
+    const childRows = layout.childRows;
+    const cols = layout.childCols;
+    let out = "\x1b[H"; // home (row 1, col 1)
+    for (let row = 0; row < childRows; row++) {
+        const line = buffer.getLine(top + row);
+        out += `\x1b[${row + 1};1H`;
+        if (line) {
+            out += renderLine(line, cols, scratch);
+        }
+        else {
+            out += CLEAR_LINE_RIGHT;
+        }
+    }
+    return out;
+}
+/**
+ * Render an in-band ANSI fragment that paints the status string at
+ * `layout.statusRow` with inverse video, padded/truncated to `columns`.
+ *
+ * Returns `""` if the layout does not reserve a status row.
+ */
+export function renderStatusLine(layout, text) {
+    if (layout.statusRow === undefined) {
+        return "";
+    }
+    const padded = padOrClip(text, layout.columns);
+    return (`\x1b[${layout.statusRow};1H` +
+        `\x1b[2K` +
+        `\x1b[0m\x1b[7m` +
+        padded +
+        `\x1b[27m\x1b[0m`);
+}
+function visibleLength(s) {
+    // eslint-disable-next-line no-control-regex
+    return s.replace(/\x1b\[[0-9;]*m/g, "").length;
+}
+function padOrClip(text, width) {
+    const vis = visibleLength(text);
+    if (vis === width)
+        return text;
+    if (vis < width)
+        return text + " ".repeat(width - vis);
+    // Width exceeded: hard-clip on visible characters. Strips any trailing SGR
+    // truncation; the caller controls styling explicitly via render wrapping.
+    let out = "";
+    let count = 0;
+    let i = 0;
+    while (i < text.length && count < width) {
+        if (text[i] === "\x1b" && text[i + 1] === "[") {
+            const m = text.slice(i).match(/^\x1b\[[0-9;]*m/);
+            if (m) {
+                out += m[0];
+                i += m[0].length;
+                continue;
+            }
+        }
+        out += text[i];
+        count += 1;
+        i += 1;
+    }
+    return out;
+}
+export const __test = { padOrClip, visibleLength, renderLine };
+//# sourceMappingURL=render.js.map

package/dist/terminal/render.js.map

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

package/dist/terminal/virtual-terminal.d.ts

@@ -0,0 +1,54 @@
+import type { IBuffer, IBufferCell } from "@xterm/headless";
+/**
+ * Wraps `@xterm/headless` so the rest of the host doesn't need to
+ * know xterm-specific details. Owns:
+ *
+ * - Construction and disposal of the headless terminal.
+ * - Feeding raw PTY bytes into the parser via `write()`.
+ * - Resizing the terminal in lockstep with the host layout.
+ * - Buffer access for the renderer.
+ * - Host-managed scrollback viewport (the real terminal is in the host's
+ *   alternate screen and no longer owns native scrollback).
+ *
+ * The wrapper keeps the API minimal — alternate-screen sequences
+ * are interpreted internally by xterm and never leak out.
+ *
+ * Scroll APIs use directional names (`scrollBack`, `scrollForward`) so
+ * callers do not depend on xterm's signed `scrollLines()` convention.
+ */
+export declare class VirtualTerminal {
+    private readonly term;
+    constructor(cols: number, rows: number);
+    write(data: string | Uint8Array, callback?: () => void): void;
+    resize(cols: number, rows: number): void;
+    get cols(): number;
+    get rows(): number;
+    /** Active buffer (normal or alternate, transparently). */
+    get buffer(): IBuffer;
+    /** Cursor X within the viewport (0-based). */
+    get cursorX(): number;
+    /** Cursor Y within the viewport (0-based). */
+    get cursorY(): number;
+    /** True when the alternate buffer is active. */
+    get isAlternate(): boolean;
+    /** Viewport top row index in scrollback coordinates. */
+    get viewportY(): number;
+    /** Buffer base Y — the row where the live tail begins. */
+    get baseY(): number;
+    /** True when the viewport is showing scrollback (older lines), not the tail. */
+    get isScrolledBack(): boolean;
+    /** Scroll the viewport back by `lines` (older content). */
+    scrollBack(lines: number): void;
+    /** Scroll the viewport forward by `lines` (newer content). */
+    scrollForward(lines: number): void;
+    /** Scroll by N pages. Positive = forward (newer), negative = back (older). */
+    scrollPages(pageCount: number): void;
+    /** Jump the viewport to the very top of scrollback. */
+    scrollToTop(): void;
+    /** Jump the viewport to the live tail (bottom). */
+    scrollToBottom(): void;
+    /** Reusable cell scratch object — avoids per-cell allocation in render hot path. */
+    newCell(): IBufferCell;
+    dispose(): void;
+}
+//# sourceMappingURL=virtual-terminal.d.ts.map

package/dist/terminal/virtual-terminal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-terminal.d.ts","sourceRoot":"","sources":["../../src/terminal/virtual-terminal.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAA6B,MAAM,iBAAiB,CAAC;AAIvF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;gBAEzB,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAUtC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,IAAI;IAQ7D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,0DAA0D;IAC1D,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,8CAA8C;IAC9C,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,8CAA8C;IAC9C,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,gDAAgD;IAChD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,wDAAwD;IACxD,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,0DAA0D;IAC1D,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,gFAAgF;IAChF,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,2DAA2D;IAC3D,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK/B,8DAA8D;IAC9D,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKlC,8EAA8E;IAC9E,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKpC,uDAAuD;IACvD,WAAW,IAAI,IAAI;IAInB,mDAAmD;IACnD,cAAc,IAAI,IAAI;IAItB,oFAAoF;IACpF,OAAO,IAAI,WAAW;IAItB,OAAO,IAAI,IAAI;CAGhB"}