@ironbee-ai/cli 0.12.0 → 0.13.0

package/dist/tui/shell/session.js

@@ -0,0 +1,333 @@
+"use strict";
+/**
+ * IronBee — TUI shell: session
+ *
+ * Cross-area state + shared modal helpers. One session per `ironbee tui` run.
+ *
+ *  - `projectDir`            — the resolved project directory all areas read/write against.
+ *  - rerender flag           — any area that changes artifact-affecting config calls
+ *                              `markRerenderNeeded()`; the app re-renders client artifacts
+ *                              ONCE on exit (never mid-session — install stdout would
+ *                              corrupt the screen).
+ *  - `isModalOpen()`         — true while a shared modal (prompt/confirm/message/pick) is
+ *                              up, so the shell's global Esc=back doesn't fire underneath it.
+ *  - modal helpers           — prompt / confirm / message / pick, reused by every area so
+ *                              they don't each reimplement (and so modal tracking + focus
+ *                              restore are uniform).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TuiSession = void 0;
+const blessed = __importStar(require("blessed"));
+const util_1 = require("./util");
+class TuiSession {
+    constructor(screen, projectDir) {
+        /** Project dirs whose artifacts need re-rendering on exit. A Set (not a
+         *  bool) because the active project is switchable — the user can edit
+         *  artifact-affecting config across several projects in one session. */
+        this.rerenderDirs = new Set();
+        this.modalOpen = false;
+        this.screen = screen;
+        this.launchDir = projectDir;
+        this.activeProjectDir = projectDir;
+    }
+    /** The active project — what every project-scoped area reads at mount. */
+    get projectDir() {
+        return this.activeProjectDir;
+    }
+    /** Switch the active project (in-memory, TUI-session only). */
+    setProjectDir(dir) {
+        this.activeProjectDir = dir;
+    }
+    /** Flag `dir`'s artifacts for re-render on exit. */
+    markRerenderNeeded(dir) {
+        this.rerenderDirs.add(dir);
+    }
+    isRerenderNeeded() {
+        return this.rerenderDirs.size > 0;
+    }
+    /** Drain the set of project dirs needing a rerender (clears it). */
+    rerenderProjects() {
+        const dirs = [...this.rerenderDirs];
+        this.rerenderDirs.clear();
+        return dirs;
+    }
+    isModalOpen() {
+        return this.modalOpen;
+    }
+    /** Capture focus + flag a modal as open; returns the restore function. */
+    openModal() {
+        const prev = this.screen.focused;
+        this.modalOpen = true;
+        return () => {
+            // Only restore focus to `prev` if it's still attached. If the area
+            // that opened the modal was torn down meanwhile, `prev` is a detached
+            // widget — focusing it would route keystrokes to a dead element while
+            // a different screen is shown.
+            if (prev !== undefined && prev !== null && prev.detached !== true) {
+                prev.focus();
+            }
+            this.screen.render();
+            // Clear the flag on the NEXT tick, not synchronously: the keypress
+            // that dismissed the modal (e.g. Esc) is still being dispatched, and
+            // the shell's global Esc=back / q=quit handlers check this flag — we
+            // want them to see "modal still open" for that keypress and no-op.
+            setImmediate(() => {
+                this.modalOpen = false;
+            });
+        };
+    }
+    /** Transient auto-dismissing notice (3s or any key). */
+    message(text) {
+        const restore = this.openModal();
+        const msg = blessed.message({
+            parent: this.screen,
+            top: "center",
+            left: "center",
+            width: "60%",
+            height: "shrink",
+            border: { type: "line" },
+            tags: true,
+            style: { border: { fg: "yellow" } },
+        });
+        msg.display((0, util_1.escapeTags)(text), 3, () => {
+            msg.destroy();
+            restore();
+        });
+    }
+    /** Single-line text input. `cb` gets the entered string, or `null` on cancel (Esc). */
+    prompt(label, value, cb) {
+        const restore = this.openModal();
+        const box = blessed.prompt({
+            parent: this.screen,
+            top: "center",
+            left: "center",
+            width: "72%",
+            height: "shrink",
+            border: { type: "line" },
+            tags: true,
+            keys: true,
+            style: { border: { fg: "green" } },
+        });
+        box.input(label, value, (_err, raw) => {
+            box.destroy();
+            restore();
+            cb(typeof raw === "string" ? raw : null);
+        });
+        this.screen.render();
+    }
+    /**
+     * Yes/no question. `cb` gets `true` for yes. Rendered as an arrow-navigable
+     * Yes/No list (NOT blessed's `question` widget, whose OK/Cancel buttons only
+     * respond to y/n/enter/esc keypresses, not ↑/↓ selection). Defaults to "No"
+     * (safer for the destructive confirms — uninstall / clear / purge); `Esc`/`q`
+     * cancels = no.
+     */
+    confirm(question, cb) {
+        const restore = this.openModal();
+        const box = blessed.box({
+            parent: this.screen,
+            top: "center",
+            left: "center",
+            width: "60%",
+            height: 8,
+            border: { type: "line" },
+            tags: true,
+            style: { border: { fg: "cyan" } },
+            content: ` ${(0, util_1.escapeTags)(question)}\n\n {gray-fg}↑/↓ choose · Enter confirm · Esc cancel{/gray-fg}`,
+        });
+        const choices = blessed.list({
+            parent: box,
+            bottom: 0,
+            left: 1,
+            right: 1,
+            height: 2,
+            keys: true,
+            tags: true,
+            style: { selected: { bg: "blue", fg: "white" } },
+            items: ["Yes", "No"],
+        });
+        choices.select(1); // default to No
+        const finish = (yes) => {
+            box.destroy();
+            restore();
+            cb(yes);
+        };
+        choices.on("select", (_item, idx) => finish(idx === 0));
+        choices.key(["escape", "q"], () => finish(false));
+        choices.focus();
+        this.screen.render();
+    }
+    /** Pick one of `items`. `cb` gets the chosen index, or `-1` on cancel. */
+    pick(title, items, cb) {
+        const restore = this.openModal();
+        const list = blessed.list({
+            parent: this.screen,
+            top: "center",
+            left: "center",
+            width: "50%",
+            height: items.length + 2,
+            border: { type: "line" },
+            label: ` ${title} `,
+            tags: true,
+            keys: true,
+            style: { selected: { bg: "blue", fg: "white" }, border: { fg: "yellow" } },
+            items: items.map((s) => (0, util_1.escapeTags)(s)),
+        });
+        list.on("select", (_item, idx) => {
+            list.destroy();
+            restore();
+            cb(idx);
+        });
+        list.key(["escape", "q"], () => {
+            list.destroy();
+            restore();
+            cb(-1);
+        });
+        list.focus();
+        this.screen.render();
+    }
+    /**
+     * Run a synchronous `fn` with stdout/stderr suppressed (discarded), then
+     * restored. For calling noisy library functions (loggers!) during a render
+     * without their output leaking onto — and corrupting — the blessed screen.
+     */
+    silently(fn) {
+        const origOut = process.stdout.write;
+        const origErr = process.stderr.write;
+        const noop = () => true;
+        process.stdout.write = noop;
+        process.stderr.write = noop;
+        try {
+            return fn();
+        }
+        finally {
+            process.stdout.write = origOut;
+            process.stderr.write = origErr;
+        }
+    }
+    /** Bind scroll (↑/↓/PgUp/PgDn) + close (Esc/Enter/q) keys to a pane box. */
+    bindPaneKeys(box, onClose) {
+        box.key(["up", "k"], () => { box.scroll(-1); this.screen.render(); });
+        box.key(["down", "j"], () => { box.scroll(1); this.screen.render(); });
+        box.key(["pageup"], () => { box.scroll(-10); this.screen.render(); });
+        box.key(["pagedown"], () => { box.scroll(10); this.screen.render(); });
+        box.key(["escape", "enter", "q"], () => { box.destroy(); onClose(); });
+        box.focus();
+    }
+    /** Show `content` (must be blessed-tag-safe) in a scrollable modal pane. */
+    showPane(title, content) {
+        const restore = this.openModal();
+        const box = blessed.box({
+            parent: this.screen,
+            top: "center",
+            left: "center",
+            width: "82%",
+            height: "82%",
+            border: { type: "line" },
+            label: ` ${title} `,
+            tags: true,
+            scrollable: true,
+            alwaysScroll: true,
+            scrollbar: { ch: " " },
+            style: { border: { fg: "cyan" } },
+            content: `${content}\n\n{gray-fg}[ ↑/↓ scroll · Esc/Enter close ]{/gray-fg}`,
+        });
+        this.bindPaneKeys(box, restore);
+        this.screen.render();
+    }
+    /**
+     * Run `fn` in the FOREGROUND, blocking TUI interaction until it finishes:
+     * shows a "running" modal, captures everything `fn` writes to stdout/stderr,
+     * then shows the captured output (plus any string `fn` returns) in a
+     * scrollable pane. For install / uninstall / drain / import — operations the
+     * user wants to watch to completion. Resolves when the pane is closed.
+     */
+    runWithOutput(label, fn) {
+        return new Promise((resolve) => {
+            const restore = this.openModal();
+            const box = blessed.box({
+                parent: this.screen,
+                top: "center",
+                left: "center",
+                width: "82%",
+                height: "82%",
+                border: { type: "line" },
+                label: ` ${label} `,
+                tags: true,
+                scrollable: true,
+                alwaysScroll: true,
+                scrollbar: { ch: " " },
+                style: { border: { fg: "green" } },
+                content: "{gray-fg}Running… (the TUI is blocked until this finishes){/gray-fg}",
+            });
+            box.focus();
+            this.screen.render();
+            const chunks = [];
+            const origOut = process.stdout.write;
+            const origErr = process.stderr.write;
+            const capture = (chunk) => {
+                chunks.push(typeof chunk === "string" ? chunk : String(chunk));
+                return true;
+            };
+            process.stdout.write = capture;
+            process.stderr.write = capture;
+            const present = (extra) => {
+                process.stdout.write = origOut;
+                process.stderr.write = origErr;
+                let out = (0, util_1.stripAnsi)(chunks.join(""));
+                if (extra.length > 0) {
+                    out += (out.length > 0 ? "\n" : "") + extra;
+                }
+                out = out.trim();
+                if (out.length === 0) {
+                    out = "(done — no output)";
+                }
+                box.setContent(`${(0, util_1.escapeTags)(out)}\n\n{gray-fg}[ ↑/↓ scroll · Esc/Enter close ]{/gray-fg}`);
+                box.setScroll(0);
+                this.bindPaneKeys(box, () => {
+                    restore();
+                    resolve();
+                });
+                this.screen.render();
+            };
+            Promise.resolve()
+                .then(() => fn())
+                .then((ret) => present(typeof ret === "string" ? ret : ""), (e) => present(`✗ ${e instanceof Error ? e.message : String(e)}`));
+        });
+    }
+}
+exports.TuiSession = TuiSession;
+//# sourceMappingURL=session.js.map

package/dist/tui/shell/session.js.map

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

package/dist/tui/shell/shell.d.ts

@@ -0,0 +1,16 @@
+/**
+ * IronBee — TUI shell
+ *
+ * Owns the screen frame (breadcrumb + content + status), the home menu (the
+ * area registry), and routing between home and exactly one mounted area.
+ * Global keys: Esc = back to home (when in an area), q / Ctrl-C = quit. Both
+ * no-op while a shared modal is open (the deferred modal-flag flip in
+ * `TuiSession.openModal` keeps the dismissing keypress from leaking here).
+ *
+ * Resolves when the user quits. The caller (command.ts) runs the one-shot
+ * artifact rerender afterwards if any area flagged it.
+ */
+import { TuiSession } from "./session";
+/** Run the TUI shell. `initialAreaId` deep-links straight into an area. */
+export declare function runShell(session: TuiSession, initialAreaId?: string): Promise<void>;
+//# sourceMappingURL=shell.d.ts.map

package/dist/tui/shell/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../src/tui/shell/shell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AASH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAoCvC,2EAA2E;AAC3E,wBAAgB,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqInF"}

package/dist/tui/shell/shell.js

@@ -0,0 +1,213 @@
+"use strict";
+/**
+ * IronBee — TUI shell
+ *
+ * Owns the screen frame (breadcrumb + content + status), the home menu (the
+ * area registry), and routing between home and exactly one mounted area.
+ * Global keys: Esc = back to home (when in an area), q / Ctrl-C = quit. Both
+ * no-op while a shared modal is open (the deferred modal-flag flip in
+ * `TuiSession.openModal` keeps the dismissing keypress from leaking here).
+ *
+ * Resolves when the user quits. The caller (command.ts) runs the one-shot
+ * artifact rerender afterwards if any area flagged it.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runShell = runShell;
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const blessed = __importStar(require("blessed"));
+const frame_1 = require("./frame");
+const registry_1 = require("./registry");
+const HOME_STATUS = " {bold}↑/↓{/bold} move   {bold}Enter{/bold} open   {bold}u{/bold} update CLI   {bold}q{/bold} quit";
+/**
+ * Self-update via npm. This genuinely shells out — there's no in-process way to
+ * npm-install a new global version — so it's the one operation that spawns a
+ * child. `2>&1` folds npm's progress (which it writes to stderr) into the
+ * captured stdout. Blocks the event loop until npm finishes (acceptable: rare,
+ * one-shot, and the "Running…" modal is already on screen).
+ */
+function runUpdate() {
+    const cmd = "npm install -g @ironbee-ai/cli@latest 2>&1";
+    try {
+        const out = (0, child_process_1.execSync)(cmd, { encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"] });
+        return `${out}\n✓ Update complete. Restart any running editor / agent sessions to pick it up.`;
+    }
+    catch (e) {
+        const err = e;
+        return `${err.stdout ?? ""}${err.stderr ?? ""}\n✗ Update failed: ${err.message ?? String(e)}`;
+    }
+}
+/** Read the ASCII brand banner (copied to dist/assets at build time). `""` if absent. */
+function readBanner() {
+    const bannerPath = (0, path_1.join)(__dirname, "..", "..", "assets", "banner.txt");
+    if (!(0, fs_1.existsSync)(bannerPath)) {
+        return "";
+    }
+    try {
+        return (0, fs_1.readFileSync)(bannerPath, "utf-8").replace(/\s+$/, "");
+    }
+    catch {
+        return "";
+    }
+}
+/** Run the TUI shell. `initialAreaId` deep-links straight into an area. */
+function runShell(session, initialAreaId) {
+    return new Promise((resolve) => {
+        const screen = session.screen;
+        const frame = (0, frame_1.buildFrame)(screen, () => session.projectDir);
+        let currentHandle = null;
+        let currentParts = ["IronBee"];
+        function setCrumb(parts) {
+            currentParts = parts;
+            frame.setBreadcrumb(parts);
+        }
+        const banner = readBanner();
+        const bannerHeight = banner.length > 0 ? banner.split("\n").length + 1 : 0;
+        const bannerBox = banner.length > 0
+            ? blessed.box({
+                parent: frame.content,
+                top: 0,
+                left: 0,
+                width: "100%",
+                height: bannerHeight,
+                tags: true,
+                style: { fg: "yellow" },
+                content: banner,
+            })
+            : undefined;
+        const home = blessed.list({
+            parent: frame.content,
+            top: bannerHeight,
+            left: 0,
+            width: "100%",
+            height: `100%-${bannerHeight}`,
+            border: { type: "line" },
+            label: " IronBee TUI ",
+            tags: true,
+            keys: true,
+            mouse: false,
+            scrollbar: { ch: " " },
+            style: { selected: { bg: "blue", fg: "white" }, border: { fg: "cyan" } },
+            items: registry_1.AREAS.map((a) => `{bold}${a.title}{/bold}  {gray-fg}— ${a.summary}{/gray-fg}`),
+        });
+        function goHome() {
+            // Show + focus home BEFORE tearing the area down. blessed runs
+            // `rewindFocus()` when the *currently focused* element is destroyed,
+            // and over repeated mount/unmount cycles its focus history can carry
+            // stale (already-destroyed) area lists — so destroying the focused
+            // area list could leave focus dangling on an old list, routing keys
+            // to it even though home is on screen. Moving focus to home first
+            // means the area widgets are no longer `screen.focused` when removed,
+            // so rewindFocus never fires.
+            if (bannerBox !== undefined) {
+                bannerBox.show();
+            }
+            home.show();
+            home.setFront();
+            home.focus();
+            if (currentHandle !== null) {
+                currentHandle.unmount();
+                currentHandle = null;
+            }
+            setCrumb(["IronBee"]);
+            frame.setStatus(HOME_STATUS);
+            home.focus(); // re-assert after teardown, belt-and-suspenders
+            screen.render();
+        }
+        function quitApp() {
+            if (currentHandle !== null) {
+                currentHandle.unmount();
+                currentHandle = null;
+            }
+            screen.destroy();
+            resolve();
+        }
+        function mountArea(area) {
+            if (bannerBox !== undefined) {
+                bannerBox.hide();
+            }
+            home.hide();
+            setCrumb(["IronBee", area.title]);
+            const ctx = {
+                screen,
+                container: frame.content,
+                session,
+                back: goHome,
+                quit: quitApp,
+                setStatus: frame.setStatus,
+                setActiveProject: (dir) => {
+                    session.setProjectDir(dir);
+                    // refresh breadcrumb so the new active project shows immediately
+                    frame.setBreadcrumb(currentParts);
+                    screen.render();
+                },
+            };
+            currentHandle = area.mount(ctx);
+            screen.render();
+        }
+        home.on("select", (_item, idx) => {
+            if (idx >= 0 && idx < registry_1.AREAS.length) {
+                mountArea(registry_1.AREAS[idx]);
+            }
+        });
+        home.key(["u"], () => {
+            void session.runWithOutput("Update IronBee CLI", () => runUpdate());
+        });
+        screen.key(["q", "C-c"], () => {
+            if (session.isModalOpen()) {
+                return;
+            }
+            quitApp();
+        });
+        screen.key(["escape"], () => {
+            if (session.isModalOpen()) {
+                return;
+            }
+            if (currentHandle !== null) {
+                goHome();
+            }
+        });
+        goHome();
+        if (initialAreaId !== undefined) {
+            const area = (0, registry_1.findArea)(initialAreaId);
+            if (area !== undefined) {
+                mountArea(area);
+            }
+        }
+    });
+}
+//# sourceMappingURL=shell.js.map

package/dist/tui/shell/shell.js.map

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

package/dist/tui/shell/util.d.ts

@@ -0,0 +1,18 @@
+/**
+ * IronBee — TUI shell: small shared helpers (blessed-tag escaping, clamp, ANSI strip).
+ */
+/**
+ * Escape blessed tag braces so arbitrary text/JSON renders literally.
+ *
+ * MUST be a single pass: chaining `.replace(/\{/, "{open}").replace(/\}/, "{close}")`
+ * is buggy — the first pass injects `}` (inside `{open}`) which the second pass
+ * then corrupts into `{open{close}`, and blessed renders that as the literal text
+ * `{open}`. One regex with a callback (same as blessed's own `helpers.escape`)
+ * never re-processes substituted output.
+ */
+export declare function escapeTags(s: string): string;
+/** Clamp `n` into `[lo, hi]`. */
+export declare function clamp(n: number, lo: number, hi: number): number;
+/** Strip ANSI CSI escape sequences (captured console output → plain text for a pane). */
+export declare function stripAnsi(s: string): string;
+//# sourceMappingURL=util.d.ts.map

package/dist/tui/shell/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../src/tui/shell/util.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,iCAAiC;AACjC,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAE/D;AAKD,yFAAyF;AACzF,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3C"}

package/dist/tui/shell/util.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * IronBee — TUI shell: small shared helpers (blessed-tag escaping, clamp, ANSI strip).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.escapeTags = escapeTags;
+exports.clamp = clamp;
+exports.stripAnsi = stripAnsi;
+/**
+ * Escape blessed tag braces so arbitrary text/JSON renders literally.
+ *
+ * MUST be a single pass: chaining `.replace(/\{/, "{open}").replace(/\}/, "{close}")`
+ * is buggy — the first pass injects `}` (inside `{open}`) which the second pass
+ * then corrupts into `{open{close}`, and blessed renders that as the literal text
+ * `{open}`. One regex with a callback (same as blessed's own `helpers.escape`)
+ * never re-processes substituted output.
+ */
+function escapeTags(s) {
+    return s.replace(/[{}]/g, (ch) => (ch === "{" ? "{open}" : "{close}"));
+}
+/** Clamp `n` into `[lo, hi]`. */
+function clamp(n, lo, hi) {
+    return Math.max(lo, Math.min(hi, n));
+}
+/** Matches ANSI CSI escape sequences (ESC [ … final byte). */
+const ANSI_RE = /\x1b\[[0-9;?]*[ -/]*[@-~]/g;
+/** Strip ANSI CSI escape sequences (captured console output → plain text for a pane). */
+function stripAnsi(s) {
+    return s.replace(ANSI_RE, "");
+}
+//# sourceMappingURL=util.js.map

package/dist/tui/shell/util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../../../src/tui/shell/util.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAWH,gCAEC;AAGD,sBAEC;AAMD,8BAEC;AAxBD;;;;;;;;GAQG;AACH,SAAgB,UAAU,CAAC,CAAS;IAChC,OAAO,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,EAAU,EAAU,EAAE,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED,iCAAiC;AACjC,SAAgB,KAAK,CAAC,CAAS,EAAE,EAAU,EAAE,EAAU;IACnD,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,8DAA8D;AAC9D,MAAM,OAAO,GAAW,4BAA4B,CAAC;AAErD,yFAAyF;AACzF,SAAgB,SAAS,CAAC,CAAS;IAC/B,OAAO,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAClC,CAAC"}