@promptctl/rich-js 0.1.0

package/dist/renderables/flexStrip.js

@@ -0,0 +1,201 @@
+/**
+ * FlexStrip — wrap-to-width horizontal layout for `StyledRenderable` items.
+ *
+ * Pack as many items as fit on a line, then break and continue. Each line is
+ * an independent sub-strip: optional `Joiner` end-caps fire at every line
+ * boundary (not just the strip's first/last position), so a line break looks
+ * the same as an endpoint to the joiner. Composes with the Strip + Joiner
+ * primitive in `core/strip` — same `Joiner` protocol, no new join semantics.
+ *
+ * [LAW:dataflow-not-control-flow] The pack walk is the same shape every
+ * render: measure each item, render every joiner form (start-cap, end-cap,
+ * mid-join) up-front, then sweep items into lines. Line breaks are decided by
+ * width data, not by control-flow special cases.
+ *
+ * [LAW:one-source-of-truth] The Strip primitive owns the join protocol;
+ * FlexStrip reuses it verbatim. There is no second concept of "join."
+ */
+import { Segment } from "../core/segment.js";
+function renderToBlock(r, options) {
+    const segments = [...r.render(options)];
+    let width = 0;
+    for (const s of segments)
+        width += s.cellLength;
+    return { segments, width };
+}
+const EMPTY_BLOCK = { segments: [], width: 0 };
+const PAD_LEFT_BY_ALIGN = {
+    left: () => 0,
+    justify: () => 0,
+    center: (spare) => Math.floor(spare / 2),
+    right: (spare) => spare,
+};
+function computePadLeft(align, spare) {
+    return PAD_LEFT_BY_ALIGN[align](spare);
+}
+// Return per-slot fill widths (length = itemCount - 1, possibly empty).
+// Non-justify cases produce all zeros — the emit loop runs the same way.
+function computeSlotFills(align, isFinalLine, spare, itemCount) {
+    const slots = Math.max(0, itemCount - 1);
+    const distribute = align === "justify" && !isFinalLine && slots > 0 && spare > 0;
+    const totalFill = distribute ? spare : 0;
+    const base = slots > 0 ? Math.floor(totalFill / slots) : 0;
+    const extra = totalFill - base * slots;
+    return Array.from({ length: slots }, (_, k) => base + (k < extra ? 1 : 0));
+}
+export class FlexStrip {
+    items;
+    joiner;
+    gap;
+    align;
+    constructor(items, options) {
+        this.items = items;
+        this.joiner = options?.joiner;
+        this.gap = options?.gap ?? 0;
+        this.align = options?.align ?? "left";
+    }
+    *render(options) {
+        const items = this.items;
+        if (items.length === 0)
+            return;
+        const maxWidth = Math.max(1, options.maxWidth);
+        const gap = this.gap;
+        const joiner = this.joiner;
+        // Pre-render every item and every joiner form we might need. Doing this
+        // up-front turns packing into a pure data computation over widths.
+        const itemBlocks = items.map((it) => renderToBlock(it, options));
+        const startCap = (i) => joiner ? renderToBlock(joiner.join(null, items[i]), options) : EMPTY_BLOCK;
+        const endCap = (i) => joiner ? renderToBlock(joiner.join(items[i], null), options) : EMPTY_BLOCK;
+        const midJoin = (i, j) => joiner ? renderToBlock(joiner.join(items[i], items[j]), options) : EMPTY_BLOCK;
+        const lines = [];
+        let line = null;
+        const gapBlock = gap > 0
+            ? { segments: [new Segment(" ".repeat(gap))], width: gap }
+            : EMPTY_BLOCK;
+        for (let i = 0; i < items.length; i++) {
+            const item = itemBlocks[i];
+            if (line === null) {
+                const sc = startCap(i);
+                const ec = endCap(i);
+                const blocks = sc.width > 0 ? [sc, item] : [item];
+                const itemBlockIndices = [blocks.length - 1];
+                line = { blocks, width: sc.width + item.width, lastIndex: i, itemBlockIndices };
+                // Tentatively reserve space for the line's eventual end-cap by
+                // tracking it separately below — `line.width` is the open width
+                // (without end-cap). We test fit using width + endCap on each step.
+                // Always start a new line with at least the first item (overflow ok
+                // per ticket: graceful fallback when an item is wider than terminal).
+                // Stash end-cap for the close step.
+                line.endCap = ec;
+                continue;
+            }
+            const prev = line.lastIndex;
+            const mid = midJoin(prev, i);
+            const newEndCap = endCap(i);
+            const addCost = (gap > 0 ? gap : 0) + mid.width + (gap > 0 ? gap : 0) + item.width;
+            const closedWidthIfAdded = line.width + addCost + newEndCap.width;
+            if (closedWidthIfAdded <= maxWidth) {
+                if (gap > 0)
+                    line.blocks.push(gapBlock);
+                if (mid.width > 0)
+                    line.blocks.push(mid);
+                if (gap > 0)
+                    line.blocks.push(gapBlock);
+                line.blocks.push(item);
+                line.itemBlockIndices.push(line.blocks.length - 1);
+                line.width += addCost;
+                line.lastIndex = i;
+                line.endCap = newEndCap;
+            }
+            else {
+                // Close current line and start a new one with this item.
+                const closing = line.endCap;
+                if (closing.width > 0)
+                    line.blocks.push(closing);
+                line.width += closing.width;
+                lines.push(line);
+                const sc = startCap(i);
+                const ec = endCap(i);
+                const blocks = sc.width > 0 ? [sc, item] : [item];
+                const itemBlockIndices = [blocks.length - 1];
+                line = { blocks, width: sc.width + item.width, lastIndex: i, itemBlockIndices };
+                line.endCap = ec;
+            }
+        }
+        // Close final line. `line` is non-null here: the loop runs at least once
+        // (items.length > 0 was handled above).
+        const finalLine = line;
+        {
+            const closing = finalLine.endCap;
+            if (closing.width > 0)
+                finalLine.blocks.push(closing);
+            finalLine.width += closing.width;
+            lines.push(finalLine);
+        }
+        // [LAW:dataflow-not-control-flow] Single emission path for every line:
+        // emit pad, walk every block, optionally emit a per-slot fill before each
+        // non-first item. Variability lives in two precomputed value sequences
+        // (`padLeft` and `slotFills`); the emit loop has no per-mode branch.
+        //
+        // - `padLeft` pushes the line right by 0 (left/justify), spare/2 (center),
+        //   or full spare (right). Justify-on-final-line follows the left rule.
+        // - `slotFills[k]` is the cells of fill emitted before the (k+1)-th item.
+        //   Always 0 unless align=justify on a non-final line with ≥2 items.
+        //
+        // Putting the variability in data means the emit loop is the same shape
+        // every render, and "what happens between two items" can never accidentally
+        // become "what happens between joiner halves" — the data decides.
+        const align = this.align;
+        for (let li = 0; li < lines.length; li++) {
+            const ln = lines[li];
+            const isLast = li === lines.length - 1;
+            const spare = Math.max(0, maxWidth - ln.width);
+            const padLeft = computePadLeft(align, spare);
+            const slotFills = computeSlotFills(align, isLast, spare, ln.itemBlockIndices.length);
+            const itemRankOf = new Map();
+            ln.itemBlockIndices.forEach((blockIdx, rank) => itemRankOf.set(blockIdx, rank));
+            if (padLeft > 0)
+                yield new Segment(" ".repeat(padLeft));
+            for (let bi = 0; bi < ln.blocks.length; bi++) {
+                const rank = itemRankOf.get(bi);
+                if (rank !== undefined && rank > 0) {
+                    const fill = slotFills[rank - 1];
+                    if (fill > 0)
+                        yield new Segment(" ".repeat(fill));
+                }
+                yield* ln.blocks[bi].segments;
+            }
+            yield Segment.line();
+        }
+    }
+    measure(options) {
+        const items = this.items;
+        if (items.length === 0)
+            return { minimum: 0, maximum: 0 };
+        let minimum = 0;
+        let maximum = 0;
+        for (let i = 0; i < items.length; i++) {
+            const itemWidth = renderToBlock(items[i], options).width;
+            const sc = this.joiner
+                ? renderToBlock(this.joiner.join(null, items[i]), options).width
+                : 0;
+            const ec = this.joiner
+                ? renderToBlock(this.joiner.join(items[i], null), options).width
+                : 0;
+            minimum = Math.max(minimum, itemWidth + sc + ec);
+            maximum += itemWidth;
+            if (i > 0) {
+                maximum += this.gap * 2;
+                if (this.joiner) {
+                    maximum += renderToBlock(this.joiner.join(items[i - 1], items[i]), options).width;
+                }
+            }
+        }
+        if (this.joiner) {
+            maximum += renderToBlock(this.joiner.join(null, items[0]), options).width;
+            maximum += renderToBlock(this.joiner.join(items[items.length - 1], null), options).width;
+        }
+        return { minimum, maximum };
+    }
+}
+//# sourceMappingURL=flexStrip.js.map

package/dist/renderables/flexStrip.js.map

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

package/dist/renderables/group.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Group — renders multiple renderables in sequence.
+ * No visual chrome — purely a container.
+ */
+import { Segment } from "../core/segment.js";
+import type { Renderable, RenderOptions } from "../core/protocol.js";
+export declare class Group implements Renderable {
+    readonly renderables: Renderable[];
+    constructor(...renderables: Renderable[]);
+    render(options: RenderOptions): Iterable<Segment>;
+}
+//# sourceMappingURL=group.d.ts.map

package/dist/renderables/group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.d.ts","sourceRoot":"","sources":["../../src/renderables/group.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACd,MAAM,qBAAqB,CAAC;AAE7B,qBAAa,KAAM,YAAW,UAAU;IACtC,QAAQ,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC;gBAEvB,GAAG,WAAW,EAAE,UAAU,EAAE;IAIvC,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC;CAKnD"}

package/dist/renderables/group.js

@@ -0,0 +1,16 @@
+/**
+ * Group — renders multiple renderables in sequence.
+ * No visual chrome — purely a container.
+ */
+export class Group {
+    renderables;
+    constructor(...renderables) {
+        this.renderables = renderables;
+    }
+    *render(options) {
+        for (const renderable of this.renderables) {
+            yield* renderable.render(options);
+        }
+    }
+}
+//# sourceMappingURL=group.js.map

package/dist/renderables/group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group.js","sourceRoot":"","sources":["../../src/renderables/group.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,OAAO,KAAK;IACP,WAAW,CAAe;IAEnC,YAAY,GAAG,WAAyB;QACtC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,CAAC,MAAM,CAAC,OAAsB;QAC5B,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC1C,KAAK,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;CACF"}

package/dist/renderables/json.d.ts

@@ -0,0 +1,23 @@
+/**
+ * JSON — renders JSON data with syntax highlighting and pretty-printing.
+ */
+import { Segment } from "../core/segment.js";
+import { RichText } from "../core/text.js";
+import type { Renderable, Measurable, RenderOptions } from "../core/protocol.js";
+export interface JSONOptions {
+    indent?: number;
+    sortKeys?: boolean;
+    highlight?: boolean;
+}
+export declare class JSONRenderable implements Renderable, Measurable {
+    readonly text: RichText;
+    private constructor();
+    static fromString(jsonString: string, options?: JSONOptions): JSONRenderable;
+    static fromData(data: unknown, options?: JSONOptions): JSONRenderable;
+    render(options: RenderOptions): Iterable<Segment>;
+    measure(options: RenderOptions): {
+        minimum: number;
+        maximum: number;
+    };
+}
+//# sourceMappingURL=json.d.ts.map

package/dist/renderables/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/renderables/json.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACd,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAID,qBAAa,cAAe,YAAW,UAAU,EAAE,UAAU;IAC3D,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAExB,OAAO;IAIP,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,cAAc;IAS5E,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,cAAc;IA4BpE,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC;IAIlD,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAGtE"}

package/dist/renderables/json.js

@@ -0,0 +1,49 @@
+/**
+ * JSON — renders JSON data with syntax highlighting and pretty-printing.
+ */
+import { RichText } from "../core/text.js";
+import { JSONHighlighter } from "../core/highlighter.js";
+const highlighter = new JSONHighlighter();
+export class JSONRenderable {
+    text;
+    constructor(text) {
+        this.text = text;
+    }
+    static fromString(jsonString, options) {
+        const indent = options?.indent ?? 2;
+        const sortKeys = options?.sortKeys ?? false;
+        // Parse and re-serialize for consistent formatting
+        const data = JSON.parse(jsonString);
+        return JSONRenderable.fromData(data, { ...options, indent, sortKeys });
+    }
+    static fromData(data, options) {
+        const indent = options?.indent ?? 2;
+        const sortKeys = options?.sortKeys ?? false;
+        const doHighlight = options?.highlight !== false;
+        const replacer = sortKeys
+            ? (_key, value) => {
+                if (value !== null && typeof value === "object" && !Array.isArray(value)) {
+                    const sorted = {};
+                    for (const k of Object.keys(value).sort()) {
+                        sorted[k] = value[k];
+                    }
+                    return sorted;
+                }
+                return value;
+            }
+            : undefined;
+        const jsonStr = JSON.stringify(data, replacer, indent);
+        const text = new RichText(jsonStr, { end: "" });
+        if (doHighlight) {
+            highlighter.highlight(text);
+        }
+        return new JSONRenderable(text);
+    }
+    *render(options) {
+        yield* this.text.render(options);
+    }
+    measure(options) {
+        return this.text.measure(options);
+    }
+}
+//# sourceMappingURL=json.js.map

package/dist/renderables/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/renderables/json.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAazD,MAAM,WAAW,GAAG,IAAI,eAAe,EAAE,CAAC;AAE1C,MAAM,OAAO,cAAc;IAChB,IAAI,CAAW;IAExB,YAAoB,IAAc;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,UAAkB,EAAE,OAAqB;QACzD,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,KAAK,CAAC;QAE5C,mDAAmD;QACnD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAY,CAAC;QAC/C,OAAO,cAAc,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAAa,EAAE,OAAqB;QAClD,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC;QACpC,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,KAAK,CAAC;QAC5C,MAAM,WAAW,GAAG,OAAO,EAAE,SAAS,KAAK,KAAK,CAAC;QAEjD,MAAM,QAAQ,GAAG,QAAQ;YACvB,CAAC,CAAC,CAAC,IAAY,EAAE,KAAc,EAAE,EAAE;gBAC/B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBACzE,MAAM,MAAM,GAA4B,EAAE,CAAC;oBAC3C,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,KAAgC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;wBACrE,MAAM,CAAC,CAAC,CAAC,GAAI,KAAiC,CAAC,CAAC,CAAC,CAAC;oBACpD,CAAC;oBACD,OAAO,MAAM,CAAC;gBAChB,CAAC;gBACD,OAAO,KAAK,CAAC;YACf,CAAC;YACH,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QACvD,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;QAEhD,IAAI,WAAW,EAAE,CAAC;YAChB,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,CAAC,MAAM,CAAC,OAAsB;QAC5B,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,CAAC,OAAsB;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/renderables/layout.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Layout — divides the screen into rectangular regions.
+ */
+import { Segment } from "../core/segment.js";
+import type { Renderable, Measurable, RenderOptions } from "../core/protocol.js";
+export interface LayoutOptions {
+    name?: string;
+    ratio?: number;
+    size?: number;
+    minimumSize?: number;
+    visible?: boolean;
+}
+export declare class Layout implements Renderable, Measurable {
+    name: string | undefined;
+    ratio: number;
+    size: number | undefined;
+    minimumSize: number;
+    visible: boolean;
+    private _renderable;
+    private _children;
+    private _splitDirection;
+    constructor(renderable?: Renderable | string, options?: LayoutOptions);
+    get children(): Layout[];
+    splitColumn(...layouts: Layout[]): void;
+    splitRow(...layouts: Layout[]): void;
+    update(renderable: Renderable | string): void;
+    getByName(name: string): Layout | undefined;
+    render(options: RenderOptions): Iterable<Segment>;
+    private _renderColumn;
+    private _renderRow;
+    private _distributeSpace;
+    measure(options: RenderOptions): {
+        minimum: number;
+        maximum: number;
+    };
+}
+//# sourceMappingURL=layout.d.ts.map

package/dist/renderables/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/renderables/layout.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACd,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,MAAO,YAAW,UAAU,EAAE,UAAU;IACnD,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,eAAe,CAA+B;gBAE1C,UAAU,CAAC,EAAE,UAAU,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa;IAerE,IAAI,QAAQ,IAAI,MAAM,EAAE,CAEvB;IAED,WAAW,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAKvC,QAAQ,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI;IAKpC,MAAM,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI;IAM7C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAS1C,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC;IAqBlD,OAAO,CAAE,aAAa;IAmBtB,OAAO,CAAE,UAAU;IAsCnB,OAAO,CAAC,gBAAgB;IAoCxB,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAGtE"}

package/dist/renderables/layout.js

@@ -0,0 +1,151 @@
+/**
+ * Layout — divides the screen into rectangular regions.
+ */
+import { Segment } from "../core/segment.js";
+import { RichText } from "../core/text.js";
+export class Layout {
+    name;
+    ratio;
+    size;
+    minimumSize;
+    visible;
+    _renderable;
+    _children;
+    _splitDirection;
+    constructor(renderable, options) {
+        if (renderable !== undefined) {
+            this._renderable = typeof renderable === "string"
+                ? new RichText(renderable, { end: "" })
+                : renderable;
+        }
+        this.name = options?.name;
+        this.ratio = options?.ratio ?? 1;
+        this.size = options?.size;
+        this.minimumSize = options?.minimumSize ?? 1;
+        this.visible = options?.visible !== false;
+        this._children = [];
+        this._splitDirection = undefined;
+    }
+    get children() {
+        return this._children;
+    }
+    splitColumn(...layouts) {
+        this._children = layouts;
+        this._splitDirection = "column";
+    }
+    splitRow(...layouts) {
+        this._children = layouts;
+        this._splitDirection = "row";
+    }
+    update(renderable) {
+        this._renderable = typeof renderable === "string"
+            ? new RichText(renderable, { end: "" })
+            : renderable;
+    }
+    getByName(name) {
+        if (this.name === name)
+            return this;
+        for (const child of this._children) {
+            const found = child.getByName(name);
+            if (found)
+                return found;
+        }
+        return undefined;
+    }
+    *render(options) {
+        if (!this.visible)
+            return;
+        if (this._children.length === 0) {
+            // Leaf node — render content
+            if (this._renderable) {
+                yield* this._renderable.render(options);
+            }
+            return;
+        }
+        const visibleChildren = this._children.filter((c) => c.visible);
+        if (visibleChildren.length === 0)
+            return;
+        if (this._splitDirection === "row") {
+            yield* this._renderRow(visibleChildren, options);
+        }
+        else {
+            yield* this._renderColumn(visibleChildren, options);
+        }
+    }
+    *_renderColumn(children, options) {
+        // Vertical stacking: each child gets full width, proportional height
+        const totalHeight = options.maxHeight ?? options.height ?? 24;
+        const heights = this._distributeSpace(children, totalHeight);
+        for (let i = 0; i < children.length; i++) {
+            const child = children[i];
+            const childOptions = {
+                ...options,
+                maxHeight: heights[i],
+                height: heights[i],
+            };
+            yield* child.render(childOptions);
+        }
+    }
+    *_renderRow(children, options) {
+        // Horizontal side-by-side: distribute width
+        const widths = this._distributeSpace(children, options.maxWidth);
+        // Render each child and collect their lines
+        const childLines = [];
+        let maxLines = 0;
+        for (let i = 0; i < children.length; i++) {
+            const child = children[i];
+            const childWidth = widths[i];
+            const childOptions = { ...options, maxWidth: childWidth };
+            const segs = [...child.render(childOptions)];
+            const lines = Segment.splitLines(segs);
+            childLines.push(lines);
+            maxLines = Math.max(maxLines, lines.length);
+        }
+        // Merge lines side by side
+        for (let lineIdx = 0; lineIdx < maxLines; lineIdx++) {
+            for (let childIdx = 0; childIdx < children.length; childIdx++) {
+                const lines = childLines[childIdx];
+                const width = widths[childIdx];
+                const line = lines[lineIdx];
+                if (line) {
+                    const adjusted = Segment.adjustLineLength(line, width);
+                    yield* adjusted;
+                }
+                else {
+                    yield new Segment(" ".repeat(width));
+                }
+            }
+            yield Segment.line();
+        }
+    }
+    _distributeSpace(children, totalSpace) {
+        const sizes = new Array(children.length).fill(0);
+        let remaining = totalSpace;
+        // Fixed-size children first
+        const flexChildren = [];
+        for (let i = 0; i < children.length; i++) {
+            const child = children[i];
+            if (child.size !== undefined) {
+                sizes[i] = Math.min(child.size, remaining);
+                remaining -= sizes[i];
+            }
+            else {
+                flexChildren.push(i);
+            }
+        }
+        // Distribute remaining by ratio
+        if (flexChildren.length > 0 && remaining > 0) {
+            const totalRatio = flexChildren.reduce((s, idx) => s + children[idx].ratio, 0);
+            for (const idx of flexChildren) {
+                const child = children[idx];
+                const allocated = Math.max(child.minimumSize, Math.floor(remaining * child.ratio / totalRatio));
+                sizes[idx] = allocated;
+            }
+        }
+        return sizes;
+    }
+    measure(options) {
+        return { minimum: this.minimumSize, maximum: options.maxWidth };
+    }
+}
+//# sourceMappingURL=layout.js.map

package/dist/renderables/layout.js.map

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

package/dist/renderables/live.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Live — animates a portion of the terminal by continuously re-rendering.
+ *
+ * Two modes:
+ * - **Inline** (default): clears and redraws N lines in the current scroll
+ *   region. Good for spinners/progress bars below other output.
+ * - **Alt-screen** (`altScreen: true`): enters the alternate screen buffer
+ *   on start, cursor-homes on each refresh (no clear flicker), and restores
+ *   the original buffer on stop. Good for full-screen TUI apps.
+ */
+import { Console } from "../core/console.js";
+import type { Renderable } from "../core/protocol.js";
+export interface LiveOptions {
+    refreshPerSecond?: number;
+    autoRefresh?: boolean;
+    transient?: boolean;
+    console?: Console;
+    verticalOverflow?: "crop" | "ellipsis" | "visible";
+    /** When true, Live enters the alternate screen buffer on start() and
+     *  restores the original on stop(). Refresh uses cursor-home instead of
+     *  cursor-up-and-clear, eliminating flicker for full-screen layouts. */
+    altScreen?: boolean;
+}
+export declare class Live {
+    private _renderable;
+    private _console;
+    private _refreshPerSecond;
+    private _autoRefresh;
+    private _transient;
+    private _verticalOverflow;
+    private _altScreen;
+    private _timer;
+    private _lastLineCount;
+    private _started;
+    private _firstRefresh;
+    constructor(renderable?: Renderable, options?: LiveOptions);
+    get console(): Console;
+    get renderable(): Renderable | undefined;
+    start(): void;
+    stop(): void;
+    update(renderable?: Renderable, options?: {
+        refresh?: boolean;
+    }): void;
+    refresh(): void;
+    private _clearLast;
+    private _writeCursorControl;
+}
+//# sourceMappingURL=live.d.ts.map

package/dist/renderables/live.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live.d.ts","sourceRoot":"","sources":["../../src/renderables/live.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,MAAM,WAAW,WAAW;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACnD;;4EAEwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,IAAI;IACf,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,UAAU,CAAU;IAC5B,OAAO,CAAC,MAAM,CAA6C;IAC3D,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,aAAa,CAAU;gBAEnB,UAAU,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,WAAW;IAa1D,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,UAAU,IAAI,UAAU,GAAG,SAAS,CAEvC;IAED,KAAK,IAAI,IAAI;IAiBb,IAAI,IAAI,IAAI;IAqBZ,MAAM,CAAC,UAAU,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAStE,OAAO,IAAI,IAAI;IAyCf,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,mBAAmB;CAG5B"}