@promptctl/rich-js 0.1.0

package/dist/renderables/progress.js

@@ -0,0 +1,234 @@
+/**
+ * Progress — displays continuously updated progress bars.
+ */
+import { Segment } from "../core/segment.js";
+import { Style } from "../core/style.js";
+import { RichText } from "../core/text.js";
+import { Console } from "../core/console.js";
+import { escape as escapeMarkup, renderMarkup } from "../core/markup.js";
+import { ProgressBar } from "./progressBar.js";
+import { Spinner } from "./spinner.js";
+import { Live } from "./live.js";
+import { Table } from "./table.js";
+export class TextColumn {
+    format;
+    constructor(format) {
+        this.format = format ?? "{task.description}";
+    }
+    *render(options, task) {
+        // [LAW:single-enforcer] Format strings flow through the markup parser so
+        // tags like `[progress.description]` become Style spans, not literal text.
+        // Task descriptions are escaped first to prevent injection of stray tags.
+        const description = escapeMarkup(task?.description ?? "");
+        // Use a callback so `$&`/`$1`/`$$` in the task description aren't
+        // reinterpreted by String.replace as replacement patterns.
+        const formatted = this.format.replace(/\{task\.description\}/g, () => description);
+        yield* renderMarkup(formatted).render(options);
+    }
+}
+export class BarColumn {
+    barWidth;
+    constructor(barWidth) {
+        this.barWidth = barWidth ?? 40;
+    }
+    *render(_options, task) {
+        const bar = new ProgressBar({
+            total: task?.total ?? 100,
+            completed: task?.completed ?? 0,
+            width: this.barWidth,
+        });
+        yield* bar.render(_options);
+    }
+}
+export class TaskProgressColumn {
+    *render(_options, task) {
+        const percent = task && task.total
+            ? Math.min(100, Math.round((task.completed / task.total) * 100))
+            : 0;
+        yield new Segment(`${percent}%`, Style.parse("progress.percentage"));
+    }
+}
+export class TimeRemainingColumn {
+    *render(_options, task) {
+        if (!task || !task.total || !task.started || task.completed <= 0) {
+            yield new Segment("-:--:--", Style.parse("progress.remaining"));
+            return;
+        }
+        const elapsed = (Date.now() - task.startTime) / 1000;
+        const rate = task.completed / elapsed;
+        const remaining = (task.total - task.completed) / rate;
+        yield new Segment(formatTime(remaining), Style.parse("progress.remaining"));
+    }
+}
+export class TimeElapsedColumn {
+    *render(_options, task) {
+        if (!task || !task.started) {
+            yield new Segment("0:00:00", Style.parse("progress.elapsed"));
+            return;
+        }
+        const elapsed = (Date.now() - task.startTime) / 1000;
+        yield new Segment(formatTime(elapsed), Style.parse("progress.elapsed"));
+    }
+}
+export class SpinnerColumn {
+    _spinner;
+    constructor(spinnerName) {
+        this._spinner = new Spinner(spinnerName);
+    }
+    *render(options, _task) {
+        yield* this._spinner.render(options);
+    }
+}
+export class MofNCompleteColumn {
+    *render(_options, task) {
+        const completed = task?.completed ?? 0;
+        const total = task?.total ?? "?";
+        yield new Segment(`${completed}/${total}`);
+    }
+}
+function formatTime(seconds) {
+    const h = Math.floor(seconds / 3600);
+    const m = Math.floor((seconds % 3600) / 60);
+    const s = Math.floor(seconds % 60);
+    return `${h}:${String(m).padStart(2, "0")}:${String(s).padStart(2, "0")}`;
+}
+export class Progress {
+    _columns;
+    _tasks;
+    _nextId;
+    _live;
+    _console;
+    expand;
+    constructor(...columns) {
+        // Last arg might be options
+        let opts = {};
+        const cols = [];
+        for (const arg of columns) {
+            if ("render" in arg) {
+                cols.push(arg);
+            }
+            else {
+                opts = arg;
+            }
+        }
+        if (cols.length === 0) {
+            cols.push(new TextColumn("[progress.description]{task.description}"), new BarColumn(), new TaskProgressColumn(), new TimeRemainingColumn());
+        }
+        this._columns = cols;
+        this._tasks = new Map();
+        this._nextId = 1;
+        this._console = opts.console ?? new Console({ forceTerminal: true });
+        this.expand = opts.expand ?? false;
+        this._live = new Live(this, {
+            console: this._console,
+            refreshPerSecond: opts.refreshPerSecond ?? 10,
+            autoRefresh: opts.autoRefresh,
+            transient: opts.transient,
+        });
+    }
+    get console() {
+        return this._console;
+    }
+    get finished() {
+        for (const task of this._tasks.values()) {
+            if (!task.started || (task.total !== undefined && task.completed < task.total)) {
+                return false;
+            }
+        }
+        return this._tasks.size > 0;
+    }
+    static getDefaultColumns() {
+        return [
+            new TextColumn("[progress.description]{task.description}"),
+            new BarColumn(),
+            new TaskProgressColumn(),
+            new TimeRemainingColumn(),
+        ];
+    }
+    addTask(description, options) {
+        const id = this._nextId++;
+        const task = {
+            id,
+            description,
+            total: options?.total,
+            completed: 0,
+            started: options?.start !== false,
+            visible: options?.visible !== false,
+            startTime: Date.now(),
+            elapsed: 0,
+        };
+        this._tasks.set(id, task);
+        return id;
+    }
+    updateTask(taskId, options) {
+        const task = this._tasks.get(taskId);
+        if (!task)
+            return;
+        if (options.completed !== undefined)
+            task.completed = options.completed;
+        if (options.advance !== undefined)
+            task.completed += options.advance;
+        if (options.description !== undefined)
+            task.description = options.description;
+        if (options.visible !== undefined)
+            task.visible = options.visible;
+        if (options.refresh) {
+            this._live.update(this, { refresh: true });
+        }
+    }
+    startTask(taskId) {
+        const task = this._tasks.get(taskId);
+        if (task) {
+            task.started = true;
+            task.startTime = Date.now();
+        }
+    }
+    start() {
+        this._live.start();
+    }
+    stop() {
+        this._live.stop();
+    }
+    refresh() {
+        this._live.refresh();
+    }
+    *render(options) {
+        const table = Table.grid({ expand: this.expand });
+        for (const _col of this._columns) {
+            table.addColumn();
+        }
+        for (const task of this._tasks.values()) {
+            if (!task.visible)
+                continue;
+            const cells = this._columns.map((col) => {
+                const segs = [...col.render(options, task)];
+                // Build a RichText that preserves segment styles as spans
+                const text = new RichText("", { end: "" });
+                for (const seg of segs) {
+                    text.append(seg.text, seg.style);
+                }
+                return text;
+            });
+            table.addRow(...cells);
+        }
+        yield* table.render(options);
+    }
+}
+// --- track ---
+export function* track(iterable, options) {
+    const items = [...iterable];
+    const total = options?.total ?? items.length;
+    const progress = new Progress({ console: options?.console });
+    const taskId = progress.addTask(options?.description ?? "Working...", { total });
+    progress.start();
+    try {
+        for (let i = 0; i < items.length; i++) {
+            yield items[i];
+            progress.updateTask(taskId, { completed: i + 1 });
+        }
+    }
+    finally {
+        progress.stop();
+    }
+}
+//# sourceMappingURL=progress.js.map

package/dist/renderables/progress.js.map

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

package/dist/renderables/progressBar.d.ts

@@ -0,0 +1,32 @@
+/**
+ * ProgressBar — a visual progress bar rendered with block characters.
+ */
+import { Segment } from "../core/segment.js";
+import { Style } from "../core/style.js";
+import type { Renderable, Measurable, RenderOptions } from "../core/protocol.js";
+export interface ProgressBarOptions {
+    total?: number;
+    completed?: number;
+    width?: number;
+    pulse?: boolean;
+    style?: string | Style;
+    completeStyle?: string | Style;
+    finishedStyle?: string | Style;
+}
+export declare class ProgressBar implements Renderable, Measurable {
+    total: number;
+    completed: number;
+    readonly width: number | undefined;
+    readonly pulse: boolean;
+    readonly style: Style;
+    readonly completeStyle: Style;
+    readonly finishedStyle: Style;
+    constructor(options?: ProgressBarOptions);
+    get percentComplete(): number;
+    render(options: RenderOptions): Iterable<Segment>;
+    measure(_options: RenderOptions): {
+        minimum: number;
+        maximum: number;
+    };
+}
+//# sourceMappingURL=progressBar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"progressBar.d.ts","sourceRoot":"","sources":["../../src/renderables/progressBar.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAc,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACd,MAAM,qBAAqB,CAAC;AAK7B,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CAChC;AAQD,qBAAa,WAAY,YAAW,UAAU,EAAE,UAAU;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,KAAK,CAAC;gBAElB,OAAO,CAAC,EAAE,kBAAkB;IAUxC,IAAI,eAAe,IAAI,MAAM,CAG5B;IAEA,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC;IAoBlD,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAIvE"}

package/dist/renderables/progressBar.js

@@ -0,0 +1,59 @@
+/**
+ * ProgressBar — a visual progress bar rendered with block characters.
+ */
+import { Segment } from "../core/segment.js";
+import { Style, NULL_STYLE } from "../core/style.js";
+const FULL_BLOCK = "━";
+const EMPTY_BLOCK = "━";
+function resolveStyle(style) {
+    if (style === undefined)
+        return NULL_STYLE;
+    if (typeof style === "string")
+        return Style.parse(style);
+    return style;
+}
+export class ProgressBar {
+    total;
+    completed;
+    width;
+    pulse;
+    style;
+    completeStyle;
+    finishedStyle;
+    constructor(options) {
+        this.total = options?.total ?? 100;
+        this.completed = options?.completed ?? 0;
+        this.width = options?.width;
+        this.pulse = options?.pulse ?? false;
+        this.style = resolveStyle(options?.style);
+        this.completeStyle = resolveStyle(options?.completeStyle ?? "bar.complete");
+        this.finishedStyle = resolveStyle(options?.finishedStyle ?? "bar.finished");
+    }
+    get percentComplete() {
+        if (this.total <= 0)
+            return 0;
+        return Math.min(1, Math.max(0, this.completed / this.total));
+    }
+    *render(options) {
+        const barWidth = this.width ?? Math.min(40, options.maxWidth);
+        const percent = this.percentComplete;
+        const isFinished = percent >= 1;
+        const filledWidth = Math.round(barWidth * percent);
+        const emptyWidth = barWidth - filledWidth;
+        const fillStyle = isFinished
+            ? (this.finishedStyle.isNull ? undefined : this.finishedStyle)
+            : (this.completeStyle.isNull ? undefined : this.completeStyle);
+        const bgStyle = this.style.isNull ? undefined : this.style;
+        if (filledWidth > 0) {
+            yield new Segment(FULL_BLOCK.repeat(filledWidth), fillStyle);
+        }
+        if (emptyWidth > 0) {
+            yield new Segment(EMPTY_BLOCK.repeat(emptyWidth), bgStyle);
+        }
+    }
+    measure(_options) {
+        const w = this.width ?? 40;
+        return { minimum: 4, maximum: w };
+    }
+}
+//# sourceMappingURL=progressBar.js.map

package/dist/renderables/progressBar.js.map

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

package/dist/renderables/prompt.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Prompt — interactive prompts for user input.
+ */
+import { Console } from "../core/console.js";
+export interface PromptOptions<T> {
+    default?: T;
+    choices?: string[];
+    caseSensitive?: boolean;
+    console?: Console;
+    showChoices?: boolean;
+    showDefault?: boolean;
+}
+export declare class Prompt {
+    static ask(promptText: string, options?: PromptOptions<string>): Promise<string>;
+}
+export declare class IntPrompt {
+    static ask(promptText: string, options?: PromptOptions<number>): Promise<number>;
+}
+export declare class FloatPrompt {
+    static ask(promptText: string, options?: PromptOptions<number>): Promise<number>;
+}
+export declare class Confirm {
+    static ask(promptText: string, options?: PromptOptions<boolean>): Promise<boolean>;
+}
+//# sourceMappingURL=prompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/renderables/prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAK7C,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAwBD,qBAAa,MAAM;WACJ,GAAG,CACd,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC;CAkCnB;AAED,qBAAa,SAAS;WACP,GAAG,CACd,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC;CAqBnB;AAED,qBAAa,WAAW;WACT,GAAG,CACd,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,GAC9B,OAAO,CAAC,MAAM,CAAC;CAoBnB;AAED,qBAAa,OAAO;WACL,GAAG,CACd,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,GAC/B,OAAO,CAAC,OAAO,CAAC;CAcpB"}

package/dist/renderables/prompt.js

@@ -0,0 +1,109 @@
+/**
+ * Prompt — interactive prompts for user input.
+ */
+import * as readline from "node:readline";
+import { render as renderMarkup } from "../core/markup.js";
+// --- Base ---
+function ask(promptText, _options) {
+    const rendered = renderMarkup(promptText);
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        rl.question(rendered.plain + " ", (answer) => {
+            rl.close();
+            resolve(answer);
+        });
+    });
+}
+// --- Prompt ---
+export class Prompt {
+    static async ask(promptText, options) {
+        const showDefault = options?.showDefault !== false;
+        const showChoices = options?.showChoices !== false;
+        let display = promptText;
+        if (showChoices && options?.choices) {
+            display += ` [${options.choices.join("/")}]`;
+        }
+        if (showDefault && options?.default !== undefined) {
+            display += ` (${options.default})`;
+        }
+        display += ":";
+        while (true) {
+            const answer = await ask(display, { console: options?.console });
+            const value = answer.trim();
+            if (value === "" && options?.default !== undefined) {
+                return options.default;
+            }
+            if (options?.choices) {
+                const caseSensitive = options.caseSensitive !== false;
+                const match = options.choices.find((c) => caseSensitive ? c === value : c.toLowerCase() === value.toLowerCase());
+                if (match)
+                    return match;
+                // Invalid choice — retry
+                continue;
+            }
+            return value;
+        }
+    }
+}
+export class IntPrompt {
+    static async ask(promptText, options) {
+        const showDefault = options?.showDefault !== false;
+        let display = promptText;
+        if (showDefault && options?.default !== undefined) {
+            display += ` (${options.default})`;
+        }
+        display += ":";
+        while (true) {
+            const answer = await ask(display, { console: options?.console });
+            const value = answer.trim();
+            if (value === "" && options?.default !== undefined) {
+                return options.default;
+            }
+            const num = parseInt(value, 10);
+            if (!isNaN(num) && String(num) === value)
+                return num;
+            // Invalid — retry
+        }
+    }
+}
+export class FloatPrompt {
+    static async ask(promptText, options) {
+        const showDefault = options?.showDefault !== false;
+        let display = promptText;
+        if (showDefault && options?.default !== undefined) {
+            display += ` (${options.default})`;
+        }
+        display += ":";
+        while (true) {
+            const answer = await ask(display, { console: options?.console });
+            const value = answer.trim();
+            if (value === "" && options?.default !== undefined) {
+                return options.default;
+            }
+            const num = parseFloat(value);
+            if (!isNaN(num))
+                return num;
+        }
+    }
+}
+export class Confirm {
+    static async ask(promptText, options) {
+        const defaultVal = options?.default;
+        const yesNo = defaultVal === true ? "Y/n" : defaultVal === false ? "y/N" : "y/n";
+        const display = `${promptText} [${yesNo}]:`;
+        while (true) {
+            const answer = await ask(display, { console: options?.console });
+            const value = answer.trim().toLowerCase();
+            if (value === "" && defaultVal !== undefined)
+                return defaultVal;
+            if (value === "y" || value === "yes")
+                return true;
+            if (value === "n" || value === "no")
+                return false;
+        }
+    }
+}
+//# sourceMappingURL=prompt.js.map

package/dist/renderables/prompt.js.map

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

package/dist/renderables/rule.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Rule — a horizontal divider line, optionally with a centered title.
+ */
+import { Segment } from "../core/segment.js";
+import { Style } from "../core/style.js";
+import type { Renderable, Measurable, RenderOptions } from "../core/protocol.js";
+export type RuleAlign = "left" | "center" | "right";
+export interface RuleOptions {
+    characters?: string;
+    align?: RuleAlign;
+    style?: string | Style;
+}
+export declare class Rule implements Renderable, Measurable {
+    readonly title: string | undefined;
+    readonly characters: string;
+    readonly align: RuleAlign;
+    readonly style: Style;
+    constructor(title?: string, options?: RuleOptions);
+    render(options: RenderOptions): Iterable<Segment>;
+    measure(_options: RenderOptions): {
+        minimum: number;
+        maximum: number;
+    };
+}
+//# sourceMappingURL=rule.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rule.d.ts","sourceRoot":"","sources":["../../src/renderables/rule.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,KAAK,EAAc,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACd,MAAM,qBAAqB,CAAC;AAE7B,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;CACxB;AAKD,qBAAa,IAAK,YAAW,UAAU,EAAE,UAAU;IACjD,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;gBAEV,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW;IAgBhD,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC;IA4ClD,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAGvE"}

package/dist/renderables/rule.js

@@ -0,0 +1,96 @@
+/**
+ * Rule — a horizontal divider line, optionally with a centered title.
+ */
+import { cellLen } from "../core/cells.js";
+import { Segment } from "../core/segment.js";
+import { Style, NULL_STYLE } from "../core/style.js";
+const ASCII_RULE_CHAR = "-";
+const DEFAULT_RULE_CHAR = "\u2500"; // ─
+export class Rule {
+    title;
+    characters;
+    align;
+    style;
+    constructor(title, options) {
+        const chars = options?.characters ?? DEFAULT_RULE_CHAR;
+        if (chars.length === 0) {
+            throw new Error("Rule characters must not be empty");
+        }
+        const align = options?.align;
+        if (align !== undefined && align !== "left" && align !== "center" && align !== "right") {
+            throw new Error(`Invalid align value: "${align}"`);
+        }
+        this.title = title;
+        this.characters = chars;
+        this.align = align ?? "center";
+        this.style = resolveStyle(options?.style);
+    }
+    *render(options) {
+        const maxWidth = options.maxWidth;
+        const ruleChar = options.asciiOnly ? ASCII_RULE_CHAR : this.characters;
+        const ruleStyle = this.style.isNull ? undefined : this.style;
+        if (!this.title) {
+            // No title — just a line of repeated characters
+            yield new Segment(repeatToWidth(ruleChar, maxWidth), ruleStyle);
+            yield Segment.line();
+            return;
+        }
+        // With title
+        const titleText = ` ${this.title} `;
+        const titleWidth = cellLen(titleText);
+        if (titleWidth >= maxWidth) {
+            // Title fills the whole width
+            yield new Segment(titleText.slice(0, maxWidth), ruleStyle);
+            yield Segment.line();
+            return;
+        }
+        const remaining = maxWidth - titleWidth;
+        // [LAW:dataflow-not-control-flow] Always compute both sides; alignment determines distribution
+        const leftWidth = this.align === "right"
+            ? remaining
+            : this.align === "center"
+                ? Math.floor(remaining / 2)
+                : 0;
+        const rightWidth = remaining - leftWidth;
+        if (leftWidth > 0) {
+            yield new Segment(repeatToWidth(ruleChar, leftWidth), ruleStyle);
+        }
+        yield new Segment(titleText, ruleStyle);
+        if (rightWidth > 0) {
+            yield new Segment(repeatToWidth(ruleChar, rightWidth), ruleStyle);
+        }
+        yield Segment.line();
+    }
+    measure(_options) {
+        return { minimum: 1, maximum: _options.maxWidth };
+    }
+}
+function repeatToWidth(char, width) {
+    const charWidth = cellLen(char);
+    if (charWidth === 0)
+        return " ".repeat(width);
+    const repeats = Math.ceil(width / charWidth);
+    const full = char.repeat(repeats);
+    // Trim to exact width
+    let w = 0;
+    let i = 0;
+    for (const c of full) {
+        const cw = cellLen(c);
+        if (w + cw > width)
+            break;
+        w += cw;
+        i += c.length;
+    }
+    const result = full.slice(0, i);
+    // Pad if needed (wide char couldn't fill exact width)
+    const gap = width - w;
+    return gap > 0 ? result + " ".repeat(gap) : result;
+}
+function resolveStyle(style) {
+    if (style === undefined)
+        return NULL_STYLE;
+    if (typeof style === "string")
+        return Style.parse(style);
+    return style;
+}
+//# sourceMappingURL=rule.js.map

package/dist/renderables/rule.js.map

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