@promptctl/rich-js 0.1.0

package/dist/core/box.js

@@ -0,0 +1,534 @@
+/**
+ * Box-drawing character sets for borders and table grids.
+ */
+import { Segment } from "./segment.js";
+// [LAW:one-type-per-behavior] Box is a single type for all border styles — instances differ by data
+export class Box {
+    topLeft;
+    top;
+    topDivider;
+    topRight;
+    headLeft;
+    headVertical;
+    headRight;
+    midLeft;
+    mid;
+    midVertical;
+    midRight;
+    bottomLeft;
+    bottom;
+    bottomDivider;
+    bottomRight;
+    left;
+    right;
+    vertical;
+    constructor(chars) {
+        this.topLeft = chars.topLeft;
+        this.top = chars.top;
+        this.topDivider = chars.topDivider;
+        this.topRight = chars.topRight;
+        this.headLeft = chars.headLeft;
+        this.headVertical = chars.headVertical;
+        this.headRight = chars.headRight;
+        this.midLeft = chars.midLeft;
+        this.mid = chars.mid;
+        this.midVertical = chars.midVertical;
+        this.midRight = chars.midRight;
+        this.bottomLeft = chars.bottomLeft;
+        this.bottom = chars.bottom;
+        this.bottomDivider = chars.bottomDivider;
+        this.bottomRight = chars.bottomRight;
+        this.left = chars.left;
+        this.right = chars.right;
+        this.vertical = chars.vertical;
+    }
+    /**
+     * Renders the top border row for given column widths.
+     */
+    getTop(widths, style, edge = true) {
+        const segments = [];
+        if (edge)
+            segments.push(new Segment(this.topLeft, style));
+        for (let i = 0; i < widths.length; i++) {
+            if (i > 0)
+                segments.push(new Segment(this.topDivider, style));
+            segments.push(new Segment(this.top.repeat(widths[i]), style));
+        }
+        if (edge)
+            segments.push(new Segment(this.topRight, style));
+        segments.push(Segment.line());
+        return segments;
+    }
+    /**
+     * Renders a separator row.
+     */
+    getRow(widths, level, style, edge = true) {
+        const [left, horizontal, cross, right] = this.getRowChars(level);
+        const segments = [];
+        if (edge)
+            segments.push(new Segment(left, style));
+        for (let i = 0; i < widths.length; i++) {
+            if (i > 0)
+                segments.push(new Segment(cross, style));
+            segments.push(new Segment(horizontal.repeat(widths[i]), style));
+        }
+        if (edge)
+            segments.push(new Segment(right, style));
+        segments.push(Segment.line());
+        return segments;
+    }
+    /**
+     * Renders the bottom border row.
+     */
+    getBottom(widths, style, edge = true) {
+        const segments = [];
+        if (edge)
+            segments.push(new Segment(this.bottomLeft, style));
+        for (let i = 0; i < widths.length; i++) {
+            if (i > 0)
+                segments.push(new Segment(this.bottomDivider, style));
+            segments.push(new Segment(this.bottom.repeat(widths[i]), style));
+        }
+        if (edge)
+            segments.push(new Segment(this.bottomRight, style));
+        segments.push(Segment.line());
+        return segments;
+    }
+    /**
+     * Returns a new Box with characters substituted for ASCII or safe alternatives.
+     * asciiOnly: all characters become ASCII (+, -, |)
+     * safe: problematic characters (e.g. rounded corners) replaced with square equivalents
+     */
+    substitute(options = {}) {
+        if (options.asciiOnly)
+            return ASCII;
+        if (options.safe)
+            return this.safeSubstitute();
+        return this;
+    }
+    safeSubstitute() {
+        // Replace rounded corners and other characters that may not render
+        // on Windows legacy terminal with safe square equivalents
+        const replacements = {
+            "╭": "┌",
+            "╮": "┐",
+            "╰": "└",
+            "╯": "┘",
+        };
+        const replace = (ch) => replacements[ch] ?? ch;
+        return new Box({
+            topLeft: replace(this.topLeft),
+            top: replace(this.top),
+            topDivider: replace(this.topDivider),
+            topRight: replace(this.topRight),
+            headLeft: replace(this.headLeft),
+            headVertical: replace(this.headVertical),
+            headRight: replace(this.headRight),
+            midLeft: replace(this.midLeft),
+            mid: replace(this.mid),
+            midVertical: replace(this.midVertical),
+            midRight: replace(this.midRight),
+            bottomLeft: replace(this.bottomLeft),
+            bottom: replace(this.bottom),
+            bottomDivider: replace(this.bottomDivider),
+            bottomRight: replace(this.bottomRight),
+            left: replace(this.left),
+            right: replace(this.right),
+            vertical: replace(this.vertical),
+        });
+    }
+    getRowChars(level) {
+        switch (level) {
+            case "head":
+                return [this.headLeft, this.mid, this.headVertical, this.headRight];
+            case "row":
+                return [this.midLeft, this.mid, this.midVertical, this.midRight];
+            case "mid":
+                return [this.midLeft, this.mid, this.midVertical, this.midRight];
+            case "foot":
+                return [this.midLeft, this.mid, this.midVertical, this.midRight];
+        }
+    }
+}
+// --- Pre-built box styles ---
+export const ASCII = new Box({
+    topLeft: "+",
+    top: "-",
+    topDivider: "+",
+    topRight: "+",
+    headLeft: "|",
+    headVertical: "|",
+    headRight: "|",
+    midLeft: "|",
+    mid: "-",
+    midVertical: "+",
+    midRight: "|",
+    bottomLeft: "+",
+    bottom: "-",
+    bottomDivider: "+",
+    bottomRight: "+",
+    left: "|",
+    right: "|",
+    vertical: "|",
+});
+export const ASCII2 = new Box({
+    topLeft: "+",
+    top: "-",
+    topDivider: "+",
+    topRight: "+",
+    headLeft: "|",
+    headVertical: "|",
+    headRight: "|",
+    midLeft: "+",
+    mid: "-",
+    midVertical: "+",
+    midRight: "+",
+    bottomLeft: "+",
+    bottom: "-",
+    bottomDivider: "+",
+    bottomRight: "+",
+    left: "|",
+    right: "|",
+    vertical: "|",
+});
+export const ASCII_DOUBLE_HEAD = new Box({
+    topLeft: "+",
+    top: "-",
+    topDivider: "+",
+    topRight: "+",
+    headLeft: "|",
+    headVertical: "|",
+    headRight: "|",
+    midLeft: "+",
+    mid: "=",
+    midVertical: "+",
+    midRight: "+",
+    bottomLeft: "+",
+    bottom: "-",
+    bottomDivider: "+",
+    bottomRight: "+",
+    left: "|",
+    right: "|",
+    vertical: "|",
+});
+export const SQUARE = new Box({
+    topLeft: "┌",
+    top: "─",
+    topDivider: "┬",
+    topRight: "┐",
+    headLeft: "│",
+    headVertical: "│",
+    headRight: "│",
+    midLeft: "├",
+    mid: "─",
+    midVertical: "┼",
+    midRight: "┤",
+    bottomLeft: "└",
+    bottom: "─",
+    bottomDivider: "┴",
+    bottomRight: "┘",
+    left: "│",
+    right: "│",
+    vertical: "│",
+});
+export const SQUARE_DOUBLE_HEAD = new Box({
+    topLeft: "┌",
+    top: "─",
+    topDivider: "┬",
+    topRight: "┐",
+    headLeft: "│",
+    headVertical: "│",
+    headRight: "│",
+    midLeft: "╞",
+    mid: "═",
+    midVertical: "╪",
+    midRight: "╡",
+    bottomLeft: "└",
+    bottom: "─",
+    bottomDivider: "┴",
+    bottomRight: "┘",
+    left: "│",
+    right: "│",
+    vertical: "│",
+});
+export const MINIMAL = new Box({
+    topLeft: " ",
+    top: " ",
+    topDivider: " ",
+    topRight: " ",
+    headLeft: " ",
+    headVertical: " ",
+    headRight: " ",
+    midLeft: " ",
+    mid: "─",
+    midVertical: "─",
+    midRight: " ",
+    bottomLeft: " ",
+    bottom: " ",
+    bottomDivider: " ",
+    bottomRight: " ",
+    left: " ",
+    right: " ",
+    vertical: " ",
+});
+export const MINIMAL_HEAVY_HEAD = new Box({
+    topLeft: " ",
+    top: " ",
+    topDivider: " ",
+    topRight: " ",
+    headLeft: " ",
+    headVertical: " ",
+    headRight: " ",
+    midLeft: " ",
+    mid: "━",
+    midVertical: "━",
+    midRight: " ",
+    bottomLeft: " ",
+    bottom: " ",
+    bottomDivider: " ",
+    bottomRight: " ",
+    left: " ",
+    right: " ",
+    vertical: " ",
+});
+export const MINIMAL_DOUBLE_HEAD = new Box({
+    topLeft: " ",
+    top: " ",
+    topDivider: " ",
+    topRight: " ",
+    headLeft: " ",
+    headVertical: " ",
+    headRight: " ",
+    midLeft: " ",
+    mid: "═",
+    midVertical: "═",
+    midRight: " ",
+    bottomLeft: " ",
+    bottom: " ",
+    bottomDivider: " ",
+    bottomRight: " ",
+    left: " ",
+    right: " ",
+    vertical: " ",
+});
+export const SIMPLE = new Box({
+    topLeft: " ",
+    top: " ",
+    topDivider: " ",
+    topRight: " ",
+    headLeft: " ",
+    headVertical: " ",
+    headRight: " ",
+    midLeft: " ",
+    mid: "─",
+    midVertical: " ",
+    midRight: " ",
+    bottomLeft: " ",
+    bottom: "─",
+    bottomDivider: " ",
+    bottomRight: " ",
+    left: " ",
+    right: " ",
+    vertical: " ",
+});
+export const SIMPLE_HEAD = new Box({
+    topLeft: " ",
+    top: " ",
+    topDivider: " ",
+    topRight: " ",
+    headLeft: " ",
+    headVertical: " ",
+    headRight: " ",
+    midLeft: " ",
+    mid: "─",
+    midVertical: " ",
+    midRight: " ",
+    bottomLeft: " ",
+    bottom: " ",
+    bottomDivider: " ",
+    bottomRight: " ",
+    left: " ",
+    right: " ",
+    vertical: " ",
+});
+export const SIMPLE_HEAVY = new Box({
+    topLeft: " ",
+    top: " ",
+    topDivider: " ",
+    topRight: " ",
+    headLeft: " ",
+    headVertical: " ",
+    headRight: " ",
+    midLeft: " ",
+    mid: "━",
+    midVertical: " ",
+    midRight: " ",
+    bottomLeft: " ",
+    bottom: "━",
+    bottomDivider: " ",
+    bottomRight: " ",
+    left: " ",
+    right: " ",
+    vertical: " ",
+});
+export const HORIZONTALS = new Box({
+    topLeft: " ",
+    top: "─",
+    topDivider: "─",
+    topRight: " ",
+    headLeft: " ",
+    headVertical: " ",
+    headRight: " ",
+    midLeft: " ",
+    mid: "─",
+    midVertical: "─",
+    midRight: " ",
+    bottomLeft: " ",
+    bottom: "─",
+    bottomDivider: "─",
+    bottomRight: " ",
+    left: " ",
+    right: " ",
+    vertical: " ",
+});
+export const ROUNDED = new Box({
+    topLeft: "╭",
+    top: "─",
+    topDivider: "┬",
+    topRight: "╮",
+    headLeft: "│",
+    headVertical: "│",
+    headRight: "│",
+    midLeft: "├",
+    mid: "─",
+    midVertical: "┼",
+    midRight: "┤",
+    bottomLeft: "╰",
+    bottom: "─",
+    bottomDivider: "┴",
+    bottomRight: "╯",
+    left: "│",
+    right: "│",
+    vertical: "│",
+});
+export const HEAVY = new Box({
+    topLeft: "┏",
+    top: "━",
+    topDivider: "┳",
+    topRight: "┓",
+    headLeft: "┃",
+    headVertical: "┃",
+    headRight: "┃",
+    midLeft: "┣",
+    mid: "━",
+    midVertical: "╋",
+    midRight: "┫",
+    bottomLeft: "┗",
+    bottom: "━",
+    bottomDivider: "┻",
+    bottomRight: "┛",
+    left: "┃",
+    right: "┃",
+    vertical: "┃",
+});
+export const HEAVY_EDGE = new Box({
+    topLeft: "┏",
+    top: "━",
+    topDivider: "┯",
+    topRight: "┓",
+    headLeft: "┃",
+    headVertical: "│",
+    headRight: "┃",
+    midLeft: "┠",
+    mid: "─",
+    midVertical: "┼",
+    midRight: "┨",
+    bottomLeft: "┗",
+    bottom: "━",
+    bottomDivider: "┷",
+    bottomRight: "┛",
+    left: "┃",
+    right: "┃",
+    vertical: "│",
+});
+export const HEAVY_HEAD = new Box({
+    topLeft: "┏",
+    top: "━",
+    topDivider: "┳",
+    topRight: "┓",
+    headLeft: "┃",
+    headVertical: "┃",
+    headRight: "┃",
+    midLeft: "┡",
+    mid: "━",
+    midVertical: "╇",
+    midRight: "┩",
+    bottomLeft: "└",
+    bottom: "─",
+    bottomDivider: "┴",
+    bottomRight: "┘",
+    left: "│",
+    right: "│",
+    vertical: "│",
+});
+export const DOUBLE = new Box({
+    topLeft: "╔",
+    top: "═",
+    topDivider: "╦",
+    topRight: "╗",
+    headLeft: "║",
+    headVertical: "║",
+    headRight: "║",
+    midLeft: "╠",
+    mid: "═",
+    midVertical: "╬",
+    midRight: "╣",
+    bottomLeft: "╚",
+    bottom: "═",
+    bottomDivider: "╩",
+    bottomRight: "╝",
+    left: "║",
+    right: "║",
+    vertical: "║",
+});
+export const DOUBLE_EDGE = new Box({
+    topLeft: "╔",
+    top: "═",
+    topDivider: "╤",
+    topRight: "╗",
+    headLeft: "║",
+    headVertical: "│",
+    headRight: "║",
+    midLeft: "╟",
+    mid: "─",
+    midVertical: "┼",
+    midRight: "╢",
+    bottomLeft: "╚",
+    bottom: "═",
+    bottomDivider: "╧",
+    bottomRight: "╝",
+    left: "║",
+    right: "║",
+    vertical: "│",
+});
+export const MARKDOWN = new Box({
+    topLeft: " ",
+    top: " ",
+    topDivider: " ",
+    topRight: " ",
+    headLeft: "|",
+    headVertical: "|",
+    headRight: "|",
+    midLeft: "|",
+    mid: "-",
+    midVertical: "|",
+    midRight: "|",
+    bottomLeft: " ",
+    bottom: " ",
+    bottomDivider: " ",
+    bottomRight: " ",
+    left: "|",
+    right: "|",
+    vertical: "|",
+});
+//# sourceMappingURL=box.js.map

package/dist/core/box.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"box.js","sourceRoot":"","sources":["../../src/core/box.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AA+BvC,oGAAoG;AACpG,MAAM,OAAO,GAAG;IACL,OAAO,CAAS;IAChB,GAAG,CAAS;IACZ,UAAU,CAAS;IACnB,QAAQ,CAAS;IACjB,QAAQ,CAAS;IACjB,YAAY,CAAS;IACrB,SAAS,CAAS;IAClB,OAAO,CAAS;IAChB,GAAG,CAAS;IACZ,WAAW,CAAS;IACpB,QAAQ,CAAS;IACjB,UAAU,CAAS;IACnB,MAAM,CAAS;IACf,aAAa,CAAS;IACtB,WAAW,CAAS;IACpB,IAAI,CAAS;IACb,KAAK,CAAS;IACd,QAAQ,CAAS;IAE1B,YAAY,KAAe;QACzB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;QACzC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;QACrC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAgB,EAAE,KAAa,EAAE,IAAI,GAAG,IAAI;QACjD,MAAM,QAAQ,GAAc,EAAE,CAAC;QAC/B,IAAI,IAAI;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QAC1D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,IAAI,CAAC,GAAG,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;YAC9D,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,IAAI;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;QAC3D,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,MAAgB,EAChB,KAAe,EACf,KAAa,EACb,IAAI,GAAG,IAAI;QAEX,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjE,MAAM,QAAQ,GAAc,EAAE,CAAC;QAC/B,IAAI,IAAI;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,IAAI,CAAC,GAAG,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;YACpD,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,IAAI;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QACnD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAgB,EAAE,KAAa,EAAE,IAAI,GAAG,IAAI;QACpD,MAAM,QAAQ,GAAc,EAAE,CAAC;QAC/B,IAAI,IAAI;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;QAC7D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACvC,IAAI,CAAC,GAAG,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC;YACjE,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,IAAI;YAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;QAC9D,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9B,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,UAA6B,EAAE;QACxC,IAAI,OAAO,CAAC,SAAS;YAAE,OAAO,KAAK,CAAC;QACpC,IAAI,OAAO,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,cAAc;QACpB,mEAAmE;QACnE,0DAA0D;QAC1D,MAAM,YAAY,GAA2B;YAC3C,GAAG,EAAE,GAAG;YACR,GAAG,EAAE,GAAG;YACR,GAAG,EAAE,GAAG;YACR,GAAG,EAAE,GAAG;SACT,CAAC;QACF,MAAM,OAAO,GAAG,CAAC,EAAU,EAAU,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QAC/D,OAAO,IAAI,GAAG,CAAC;YACb,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;YAC9B,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;YACtB,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;YACpC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;YAChC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;YAChC,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC;YACxC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;YAClC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;YAC9B,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC;YACtB,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;YACtC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;YAChC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;YACpC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC;YAC5B,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC;YAC1C,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC;YACtC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YACxB,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;YAC1B,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;SACjC,CAAC,CAAC;IACL,CAAC;IAEO,WAAW,CACjB,KAAe;QAEf,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,MAAM;gBACT,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YACtE,KAAK,KAAK;gBACR,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YACnE,KAAK,KAAK;gBACR,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YACnE,KAAK,MAAM;gBACT,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF;AAED,+BAA+B;AAE/B,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC;IAC3B,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;IACd,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;IACf,MAAM,EAAE,GAAG;IACX,aAAa,EAAE,GAAG;IAClB,WAAW,EAAE,GAAG;IAChB,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC;IAC5B,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;IACd,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;IACf,MAAM,EAAE,GAAG;IACX,aAAa,EAAE,GAAG;IAClB,WAAW,EAAE,GAAG;IAChB,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IACvC,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;IACd,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;IACf,MAAM,EAAE,GAAG;IACX,aAAa,EAAE,GAAG;IAClB,WAAW,EAAE,GAAG;IAChB,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC;IAC5B,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;IACd,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;IACf,MAAM,EAAE,GAAG;IACX,aAAa,EAAE,GAAG;IAClB,WAAW,EAAE,GAAG;IAChB,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACxC,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;IACd,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;IACf,MAAM,EAAE,GAAG;IACX,aAAa,EAAE,GAAG;IAClB,WAAW,EAAE,GAAG;IAChB,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC;IAC7B,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;IACd,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;IACf,MAAM,EAAE,GAAG;IACX,aAAa,EAAE,GAAG;IAClB,WAAW,EAAE,GAAG;IAChB,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACxC,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;IACd,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;IACf,MAAM,EAAE,GAAG;IACX,aAAa,EAAE,GAAG;IAClB,WAAW,EAAE,GAAG;IAChB,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IACzC,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;IACd,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;IACf,MAAM,EAAE,GAAG;IACX,aAAa,EAAE,GAAG;IAClB,WAAW,EAAE,GAAG;IAChB,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC;IAC5B,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;IACd,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;IACf,MAAM,EAAE,GAAG;IACX,aAAa,EAAE,GAAG;IAClB,WAAW,EAAE,GAAG;IAChB,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IACjC,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;IACd,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;IACf,MAAM,EAAE,GAAG;IACX,aAAa,EAAE,GAAG;IAClB,WAAW,EAAE,GAAG;IAChB,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;IAClC,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;IACd,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;IACf,MAAM,EAAE,GAAG;IACX,aAAa,EAAE,GAAG;IAClB,WAAW,EAAE,GAAG;IAChB,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IACjC,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;IACd,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;IACf,MAAM,EAAE,GAAG;IACX,aAAa,EAAE,GAAG;IAClB,WAAW,EAAE,GAAG;IAChB,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC;IAC7B,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;IACd,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;IACf,MAAM,EAAE,GAAG;IACX,aAAa,EAAE,GAAG;IAClB,WAAW,EAAE,GAAG;IAChB,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC;IAC3B,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;IACd,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;IACf,MAAM,EAAE,GAAG;IACX,aAAa,EAAE,GAAG;IAClB,WAAW,EAAE,GAAG;IAChB,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IAChC,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;IACd,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;IACf,MAAM,EAAE,GAAG;IACX,aAAa,EAAE,GAAG;IAClB,WAAW,EAAE,GAAG;IAChB,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IAChC,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;IACd,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;IACf,MAAM,EAAE,GAAG;IACX,aAAa,EAAE,GAAG;IAClB,WAAW,EAAE,GAAG;IAChB,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC;IAC5B,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;IACd,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;IACf,MAAM,EAAE,GAAG;IACX,aAAa,EAAE,GAAG;IAClB,WAAW,EAAE,GAAG;IAChB,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IACjC,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;IACd,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;IACf,MAAM,EAAE,GAAG;IACX,aAAa,EAAE,GAAG;IAClB,WAAW,EAAE,GAAG;IAChB,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC;IAC9B,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,GAAG;IACb,QAAQ,EAAE,GAAG;IACb,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,GAAG;IACd,OAAO,EAAE,GAAG;IACZ,GAAG,EAAE,GAAG;IACR,WAAW,EAAE,GAAG;IAChB,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;IACf,MAAM,EAAE,GAAG;IACX,aAAa,EAAE,GAAG;IAClB,WAAW,EAAE,GAAG;IAChB,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;IACV,QAAQ,EAAE,GAAG;CACd,CAAC,CAAC"}

package/dist/core/cells.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Terminal cell width calculation.
+ * Handles ASCII, CJK (double-width), and emoji characters.
+ */
+/**
+ * Returns the terminal cell width of a string.
+ */
+export declare function cellLen(text: string): number;
+/**
+ * Pads or crops a string to exactly `totalWidth` terminal cells.
+ * Invariant: cellLen(setCellSize(text, n)) === n (unless n is 0)
+ */
+export declare function setCellSize(text: string, totalWidth: number): string;
+/**
+ * Splits text at a cell position. Returns [left, right].
+ * When the position falls mid-wide-character, the left side is padded
+ * to reach exactly `position` cells. The wide char remains in the right side.
+ */
+export declare function splitText(text: string, position: number): [string, string];
+/**
+ * Wraps text into lines of at most `maxWidth` cells.
+ */
+export declare function chopCells(text: string, maxWidth: number): string[];
+//# sourceMappingURL=cells.d.ts.map

package/dist/core/cells.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cells.d.ts","sourceRoot":"","sources":["../../src/core/cells.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAa5C;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CASpE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,CAAC,MAAM,EAAE,MAAM,CAAC,CAuBlB;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAkBlE"}

package/dist/core/cells.js

@@ -0,0 +1,114 @@
+/**
+ * Terminal cell width calculation.
+ * Handles ASCII, CJK (double-width), and emoji characters.
+ */
+import stringWidth from "string-width";
+// [LAW:one-source-of-truth] string-width is the single authority for cell width
+const cellLenCache = new Map();
+const CACHE_MAX = 4096;
+/**
+ * Returns the terminal cell width of a string.
+ */
+export function cellLen(text) {
+    if (text.length === 0)
+        return 0;
+    // Fast path for pure ASCII
+    if (text.length <= 64) {
+        const cached = cellLenCache.get(text);
+        if (cached !== undefined)
+            return cached;
+    }
+    const width = stringWidth(text);
+    if (text.length <= 64) {
+        if (cellLenCache.size >= CACHE_MAX)
+            cellLenCache.clear();
+        cellLenCache.set(text, width);
+    }
+    return width;
+}
+/**
+ * Pads or crops a string to exactly `totalWidth` terminal cells.
+ * Invariant: cellLen(setCellSize(text, n)) === n (unless n is 0)
+ */
+export function setCellSize(text, totalWidth) {
+    if (totalWidth === 0)
+        return "";
+    const currentWidth = cellLen(text);
+    if (currentWidth === totalWidth)
+        return text;
+    if (currentWidth < totalWidth) {
+        return text + " ".repeat(totalWidth - currentWidth);
+    }
+    // Crop: walk characters, tracking cell width
+    return cropToWidth(text, totalWidth);
+}
+/**
+ * Splits text at a cell position. Returns [left, right].
+ * When the position falls mid-wide-character, the left side is padded
+ * to reach exactly `position` cells. The wide char remains in the right side.
+ */
+export function splitText(text, position) {
+    if (position <= 0)
+        return ["", text];
+    const totalWidth = cellLen(text);
+    if (position >= totalWidth)
+        return [text, ""];
+    // Walk characters tracking cell width and source char index
+    let width = 0;
+    let charIndex = 0;
+    for (const char of text) {
+        const charWidth = cellLen(char);
+        if (width + charWidth > position)
+            break;
+        width += charWidth;
+        charIndex += char.length;
+    }
+    const left = text.slice(0, charIndex);
+    const right = text.slice(charIndex);
+    // If we stopped short of position (mid-wide-char), pad left with spaces
+    if (width < position) {
+        return [left + " ".repeat(position - width), right];
+    }
+    return [left, right];
+}
+/**
+ * Wraps text into lines of at most `maxWidth` cells.
+ */
+export function chopCells(text, maxWidth) {
+    if (maxWidth <= 0 || text.length === 0)
+        return [text];
+    const totalWidth = cellLen(text);
+    if (totalWidth <= maxWidth)
+        return [text];
+    const lines = [];
+    let remaining = text;
+    while (remaining.length > 0) {
+        const remainingWidth = cellLen(remaining);
+        if (remainingWidth <= maxWidth) {
+            lines.push(remaining);
+            break;
+        }
+        const [line, rest] = splitText(remaining, maxWidth);
+        lines.push(line);
+        remaining = rest;
+    }
+    return lines;
+}
+// --- internal ---
+function cropToWidth(text, targetWidth) {
+    let width = 0;
+    let i = 0;
+    // Use the string's code point iterator to handle surrogate pairs
+    for (const char of text) {
+        const charWidth = cellLen(char);
+        if (width + charWidth > targetWidth)
+            break;
+        width += charWidth;
+        i += char.length;
+    }
+    const cropped = text.slice(0, i);
+    // Pad if we couldn't hit the exact width (wide char boundary)
+    const diff = targetWidth - width;
+    return diff > 0 ? cropped + " ".repeat(diff) : cropped;
+}
+//# sourceMappingURL=cells.js.map