@travisennis/acai 0.0.6 → 0.0.8

package/dist/terminal/string-width.js

@@ -1,25 +1,32 @@
 import { eastAsianWidth } from "./east-asian-width.js";
+import { getSegmenter } from "./segmenter.js";
 import stripAnsi from "./strip-ansi.js";
-const segmenter = new Intl.Segmenter();
+// Precompile regexes (these are already at module level, which is good)
 // Whole-cluster zero-width
 const zeroWidthClusterRegex = /^(?:\p{Default_Ignorable_Code_Point}|\p{Control}|\p{Mark}|\p{Surrogate})+$/v;
 // Pick the base scalar if the cluster starts with Prepend/Format/Marks
 const leadingNonPrintingRegex = /^[\p{Default_Ignorable_Code_Point}\p{Control}\p{Format}\p{Mark}\p{Surrogate}]+/v;
 // RGI emoji sequences
 const rgiEmojiRegex = /^\p{RGI_Emoji}$/v;
-function baseVisible(segment) {
-    return segment.replace(leadingNonPrintingRegex, "");
-}
-function isZeroWidthCluster(segment) {
-    return zeroWidthClusterRegex.test(segment);
-}
+// Halfwidth/Fullwidth range constants
+const HALFWIDTH_START = 0xff00;
+const HALFWIDTH_END = 0xffef;
 function trailingHalfwidthWidth(segment, eastAsianWidthOptions) {
+    const len = segment.length;
+    if (len <= 1) {
+        return 0;
+    }
     let extra = 0;
-    if (segment.length > 1) {
-        for (const char of segment.slice(1)) {
-            const codePoint = char.codePointAt(0);
-            if (codePoint !== undefined && char >= "\\uFF00" && char <= "\\uFFEF") {
-                extra += eastAsianWidth(codePoint, eastAsianWidthOptions);
+    // Use for loop with index for better performance
+    for (let i = 1; i < len; i++) {
+        const codePoint = segment.codePointAt(i);
+        if (codePoint !== undefined &&
+            codePoint >= HALFWIDTH_START &&
+            codePoint <= HALFWIDTH_END) {
+            extra += eastAsianWidth(codePoint, eastAsianWidthOptions);
+            // Skip next char if this was a surrogate pair
+            if (codePoint > 0xffff) {
+                i++;
             }
         }
     }
@@ -33,15 +40,17 @@ export default function stringWidth(input, options = {}) {
     let string = input;
     if (!countAnsiEscapeCodes) {
         string = stripAnsi(string);
-    }
-    if (string.length === 0) {
-        return 0;
+        if (string.length === 0) {
+            return 0;
+        }
     }
     let width = 0;
     const eastAsianWidthOptions = { ambiguousAsWide: !ambiguousIsNarrow };
+    // Use lazy segmenter initialization
+    const segmenter = getSegmenter();
     for (const { segment } of segmenter.segment(string)) {
-        // Zero-width / non-printing clusters
-        if (isZeroWidthCluster(segment)) {
+        // Zero-width clusters - inline test for hot path
+        if (zeroWidthClusterRegex.test(segment)) {
             continue;
         }
         // Emoji width logic
@@ -49,12 +58,22 @@ export default function stringWidth(input, options = {}) {
             width += 2;
             continue;
         }
-        // Everything else: EAW of the cluster’s first visible scalar
-        const codePoint = baseVisible(segment).codePointAt(0);
+        // Get first code point directly, avoiding intermediate string
+        const firstCodePoint = segment.codePointAt(0);
+        if (firstCodePoint === undefined) {
+            continue;
+        }
+        // Check if we need to strip leading non-printing characters
+        const hasLeadingNonPrinting = leadingNonPrintingRegex.test(segment);
+        const codePoint = hasLeadingNonPrinting
+            ? segment.replace(leadingNonPrintingRegex, "").codePointAt(0)
+            : firstCodePoint;
         if (codePoint !== undefined) {
             width += eastAsianWidth(codePoint, eastAsianWidthOptions);
-            // Add width for trailing Halfwidth and Fullwidth Forms (e.g., ﾞ, ﾟ, ｰ)
-            width += trailingHalfwidthWidth(segment, eastAsianWidthOptions);
+            // Only check trailing width if segment has multiple characters
+            if (segment.length > 1) {
+                width += trailingHalfwidthWidth(segment, eastAsianWidthOptions);
+            }
         }
     }
     return width;

package/dist/terminal/strip-ansi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"strip-ansi.d.ts","sourceRoot":"","sources":["../../source/terminal/strip-ansi.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CASxD"}
+{"version":3,"file":"strip-ansi.d.ts","sourceRoot":"","sources":["../../source/terminal/strip-ansi.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKxD"}

package/dist/terminal/strip-ansi.js

@@ -1,20 +1,14 @@
-// Inline from sindresorhus/strip-ansi v7.1.0
-const ansiRegex = ({ onlyFirst = false } = {}) => {
-    // Valid string terminator sequences are BEL, ESC\, and 0x9c
-    const St = "(?:\\\\u0007|\\\\u001B\\\\u005C|\\\\u009C)";
-    // OSC sequences only: ESC ] ... ST (non-greedy until the first ST)
-    const osc = `(?:\\\\u001B\\\\][\\\\s\\\\S]*?${St})`;
-    // CSI and related: ESC/C1, optional intermediates, optional params (supports ; and :) then final byte
-    const csi = "[\\\\u001B\\\\u009B][[\\\\]()#;?]*(?:\\\\d{1,4}(?:[;:]\\\\d{0,4})*)?[\\\\dA-PR-TZcf-nq-uy=>~]";
-    const pattern = `${osc}|${csi}`;
-    return new RegExp(pattern, onlyFirst ? undefined : "g");
-};
+// Pre-compile the regex outside the function to avoid recreation on every call
+const ANSI_REGEX = (() => {
+    const St = "(?:\u0007|\u001B\u005C|\u009C)";
+    // biome-ignore lint/suspicious/noUselessEscapeInString: later
+    const osc = `(?:\u001B\][\\s\\S]*?${St})`;
+    const csi = "[\u001B\u009B][[\\]()#;?]*(?:\\d{1,4}(?:[;:]\\d{0,4})*)?[\\dA-PR-TZcf-nq-uy=><~]";
+    return new RegExp(`${osc}|${csi}`, "g");
+})();
 export default function stripAnsi(string) {
     if (typeof string !== "string") {
         throw new TypeError(`Expected a \`string\`, got \`${typeof string}\``);
     }
-    // Even though the regex is global, we don't need to reset the `.lastIndex`
-    // because unlike `.exec()` and `.test()`, `.replace()` does it automatically
-    // and doing it manually has a performance penalty.
-    return string.replace(ansiRegex(), "");
+    return string.replace(ANSI_REGEX, "");
 }

package/dist/terminal/table/cell.d.ts

@@ -0,0 +1,114 @@
+import { type CellOptions, type CharName, type HorizontalAlignment, type TableInstanceOptions, type VerticalAlignment } from "./utils.ts";
+export declare class Cell {
+    options: CellOptions;
+    content: string;
+    colSpan: number;
+    rowSpan: number;
+    x: number | null;
+    y: number | null;
+    chars: Record<CharName, string>;
+    truncate: string;
+    paddingLeft: number;
+    paddingRight: number;
+    head: string[];
+    border: string[];
+    fixedWidth: number | null;
+    lines: string[];
+    desiredWidth: number;
+    desiredHeight: number;
+    widths: number[];
+    heights: number[];
+    width: number;
+    height: number;
+    hAlign: HorizontalAlignment;
+    vAlign: VerticalAlignment;
+    drawRight: boolean;
+    cells: Cell[][] | null;
+    /**
+     * A representation of a cell within the table.
+     * Implementations must have `init` and `draw` methods,
+     * as well as `colSpan`, `rowSpan`, `desiredHeight` and `desiredWidth` properties.
+     */
+    constructor(options: CellOptions | string | number | boolean | bigint);
+    setOptions(options: CellOptions | string | number | boolean | bigint): void;
+    mergeTableOptions(tableOptions: TableInstanceOptions, cells: Cell[][]): void;
+    computeLines(tableOptions: TableInstanceOptions): string[];
+    wrapLines(computedLines: string[]): string[];
+    /**
+     * Initializes the Cells data structure.
+     *
+     * @param tableOptions - A fully populated set of tableOptions.
+     * In addition to the standard default values, tableOptions must have fully populated the
+     * `colWidths` and `rowWidths` arrays. Those arrays must have lengths equal to the number
+     * of columns or rows (respectively) in this table, and each array item must be a Number.
+     */
+    init(tableOptions: TableInstanceOptions): void;
+    /**
+     * Draws the given line of the cell.
+     * This default implementation defers to methods `drawTop`, `drawBottom`, `drawLine` and `drawEmpty`.
+     * @param lineNum - can be `top`, `bottom` or a numerical line number.
+     * @param spanningCell - will be a number if being called from a RowSpanCell, and will represent how
+     * many rows below it's being called from. Otherwise it's undefined.
+     * @returns {String} The representation of this line.
+     */
+    draw(lineNum: "top" | "bottom" | number, spanningCell?: number): string;
+    /**
+     * Renders the top line of the cell.
+     * @param drawRight - true if this method should render the right edge of the cell.
+     * @returns {String}
+     */
+    drawTop(drawRight: boolean): string;
+    _topLeftChar(offset: number): string;
+    wrapWithStyleColors(styleProperty: "head" | "border", content: string): string;
+    /**
+     * Renders a line of text.
+     * @param lineNum - Which line of text to render. This is not necessarily the line within the cell.
+     * There may be top-padding above the first line of text.
+     * @param drawRight - true if this method should render the right edge of the cell.
+     * @param forceTruncationSymbol - `true` if the rendered text should end with the truncation symbol even
+     * if the text fits. This is used when the cell is vertically truncated. If `false` the text should
+     * only include the truncation symbol if the text will not fit horizontally within the cell width.
+     * @param spanningCell - a number of if being called from a RowSpanCell. (how many rows below). otherwise undefined.
+     * @returns {String}
+     */
+    drawLine(lineNum: number, drawRight: boolean, forceTruncationSymbol: boolean, spanningCell?: number): string;
+    stylizeLine(left: string, content: string, right: string): string;
+    /**
+     * Renders the bottom line of the cell.
+     * @param drawRight - true if this method should render the right edge of the cell.
+     * @returns {String}
+     */
+    drawBottom(drawRight: boolean): string;
+    /**
+     * Renders a blank line of text within the cell. Used for top and/or bottom padding.
+     * @param drawRight - true if this method should render the right edge of the cell.
+     * @param spanningCell - a number of if being called from a RowSpanCell. (how many rows below). otherwise undefined.
+     * @returns {String}
+     */
+    drawEmpty(drawRight: boolean, spanningCell?: number): string;
+}
+export declare class ColSpanCell {
+    x: number | null;
+    y: number | null;
+    colSpan: number;
+    draw(lineNum: "top" | "bottom" | number): string;
+    init(): void;
+    mergeTableOptions(): void;
+}
+export declare class RowSpanCell {
+    originalCell: Cell;
+    x: number | null;
+    y: number | null;
+    colSpan: number;
+    cellOffset: number;
+    offset: number;
+    /**
+     * A placeholder Cell for a Cell that spans multiple rows.
+     * It delegates rendering to the original cell, but adds the appropriate offset.
+     */
+    constructor(originalCell: Cell);
+    init(tableOptions: TableInstanceOptions): void;
+    draw(lineNum: "top" | "bottom" | number): string;
+    mergeTableOptions(): void;
+}
+//# sourceMappingURL=cell.d.ts.map

package/dist/terminal/table/cell.d.ts.map

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

package/dist/terminal/table/cell.js

@@ -0,0 +1,407 @@
+import debug from "./debug.js";
+import { colorizeLines, hyperlink, multiLineWordWrap, pad, repeat, strlen, truncate, } from "./utils.js";
+const CHAR_NAMES = [
+    "top",
+    "topMid",
+    "topLeft",
+    "topRight",
+    "bottom",
+    "bottomMid",
+    "bottomLeft",
+    "bottomRight",
+    "left",
+    "leftMid",
+    "mid",
+    "midMid",
+    "right",
+    "rightMid",
+    "middle",
+];
+export class Cell {
+    options;
+    content;
+    colSpan;
+    rowSpan;
+    x = null;
+    y = null;
+    chars = {};
+    truncate = "…";
+    paddingLeft = 1;
+    paddingRight = 1;
+    head = [];
+    border = [];
+    fixedWidth = null;
+    lines = [];
+    desiredWidth = 0;
+    desiredHeight = 0;
+    widths = [];
+    heights = [];
+    width = 0;
+    height = 0;
+    hAlign = "left";
+    vAlign = "top";
+    drawRight = false;
+    cells = null;
+    /**
+     * A representation of a cell within the table.
+     * Implementations must have `init` and `draw` methods,
+     * as well as `colSpan`, `rowSpan`, `desiredHeight` and `desiredWidth` properties.
+     */
+    constructor(options) {
+        this.setOptions(options);
+    }
+    setOptions(options) {
+        let processedOptions = options;
+        if (["boolean", "number", "bigint", "string"].indexOf(typeof processedOptions) !== -1) {
+            processedOptions = { content: `${processedOptions}` };
+        }
+        const opts = (processedOptions || {});
+        this.options = opts;
+        const content = opts.content;
+        if (["boolean", "number", "bigint", "string"].indexOf(typeof content) !== -1) {
+            this.content = String(content);
+        }
+        else if (!content) {
+            this.content = this.options.href || "";
+        }
+        else {
+            throw new Error(`Content needs to be a primitive, got: ${typeof content}`);
+        }
+        this.colSpan = opts.colSpan || 1;
+        this.rowSpan = opts.rowSpan || 1;
+    }
+    mergeTableOptions(tableOptions, cells) {
+        this.cells = cells;
+        const optionsChars = this.options.chars || {};
+        const tableChars = tableOptions.chars;
+        const chars = this.chars;
+        CHAR_NAMES.forEach((name) => {
+            setOption(optionsChars, tableChars, name, chars);
+        });
+        this.truncate = this.options.truncate || tableOptions.truncate;
+        const style = this.options.style || {};
+        const tableStyle = tableOptions.style;
+        setOption(style, tableStyle, "padding-left", this);
+        setOption(style, tableStyle, "padding-right", this);
+        this.head = style.head || tableStyle.head;
+        this.border = style.border || tableStyle.border;
+        this.fixedWidth = this.x !== null ? tableOptions.colWidths[this.x] : null;
+        this.lines = this.computeLines(tableOptions);
+        this.desiredWidth =
+            strlen(this.content) + this.paddingLeft + this.paddingRight;
+        this.desiredHeight = this.lines.length;
+    }
+    computeLines(tableOptions) {
+        const tableWordWrap = tableOptions.wordWrap || tableOptions.textWrap;
+        const { wordWrap = tableWordWrap } = this.options;
+        if (this.fixedWidth && wordWrap) {
+            let fixedWidth = this.fixedWidth - this.paddingLeft - this.paddingRight;
+            if (this.colSpan && this.x !== null) {
+                let i = 1;
+                while (i < this.colSpan) {
+                    fixedWidth += tableOptions.colWidths[this.x + i] || 0;
+                    i++;
+                }
+            }
+            const { wrapOnWordBoundary: tableWrapOnWordBoundary = true } = tableOptions;
+            const { wrapOnWordBoundary = tableWrapOnWordBoundary } = this.options;
+            return this.wrapLines(multiLineWordWrap(fixedWidth, this.content, wrapOnWordBoundary));
+        }
+        return this.wrapLines(this.content.split("\n"));
+    }
+    wrapLines(computedLines) {
+        const lines = colorizeLines(computedLines);
+        const href = this.options.href;
+        if (href) {
+            return lines.map((line) => hyperlink(href, line));
+        }
+        return lines;
+    }
+    /**
+     * Initializes the Cells data structure.
+     *
+     * @param tableOptions - A fully populated set of tableOptions.
+     * In addition to the standard default values, tableOptions must have fully populated the
+     * `colWidths` and `rowWidths` arrays. Those arrays must have lengths equal to the number
+     * of columns or rows (respectively) in this table, and each array item must be a Number.
+     */
+    init(tableOptions) {
+        if (this.x === null || this.y === null) {
+            throw new Error("Cell x and y must be initialized before calling init");
+        }
+        const x = this.x;
+        const y = this.y;
+        this.widths = tableOptions.colWidths.slice(x, x + this.colSpan).filter((w) => w !== null);
+        this.heights = tableOptions.rowHeights.slice(y, y + this.rowSpan).filter((h) => h !== null);
+        this.width = this.widths.reduce(sumPlusOne, -1);
+        this.height = this.heights.reduce(sumPlusOne, -1);
+        this.hAlign = this.options.hAlign || tableOptions.colAligns[x];
+        this.vAlign = this.options.vAlign || tableOptions.rowAligns[y];
+        this.drawRight = x + this.colSpan === tableOptions.colWidths.length;
+    }
+    /**
+     * Draws the given line of the cell.
+     * This default implementation defers to methods `drawTop`, `drawBottom`, `drawLine` and `drawEmpty`.
+     * @param lineNum - can be `top`, `bottom` or a numerical line number.
+     * @param spanningCell - will be a number if being called from a RowSpanCell, and will represent how
+     * many rows below it's being called from. Otherwise it's undefined.
+     * @returns {String} The representation of this line.
+     */
+    draw(lineNum, spanningCell) {
+        if (lineNum === "top")
+            return this.drawTop(this.drawRight);
+        if (lineNum === "bottom")
+            return this.drawBottom(this.drawRight);
+        const content = truncate(this.content, 10, this.truncate);
+        if (!lineNum) {
+            debug.info(`${this.y}-${this.x}: ${this.rowSpan - lineNum}x${this.colSpan} Cell ${content}`);
+        }
+        else {
+            // debug.debug(`${lineNum}-${this.x}: 1x${this.colSpan} RowSpanCell ${content}`);
+        }
+        const padLen = Math.max(this.height - this.lines.length, 0);
+        let padTop;
+        switch (this.vAlign) {
+            case "center":
+                padTop = Math.ceil(padLen / 2);
+                break;
+            case "bottom":
+                padTop = padLen;
+                break;
+            default:
+                padTop = 0;
+        }
+        if (lineNum < padTop || lineNum >= padTop + this.lines.length) {
+            return this.drawEmpty(this.drawRight, spanningCell);
+        }
+        const forceTruncation = this.lines.length > this.height && lineNum + 1 >= this.height;
+        return this.drawLine(lineNum - padTop, this.drawRight, forceTruncation, spanningCell);
+    }
+    /**
+     * Renders the top line of the cell.
+     * @param drawRight - true if this method should render the right edge of the cell.
+     * @returns {String}
+     */
+    drawTop(drawRight) {
+        const content = [];
+        if (this.cells) {
+            // TODO: cells should always exist - some tests don't fill it in though
+            this.widths.forEach((width, index) => {
+                content.push(this._topLeftChar(index));
+                content.push(repeat(this.chars[this.y === 0 ? "top" : "mid"], width));
+            }, this);
+        }
+        else {
+            content.push(this._topLeftChar(0));
+            content.push(repeat(this.chars[this.y === 0 ? "top" : "mid"], this.width));
+        }
+        if (drawRight) {
+            content.push(this.chars[this.y === 0 ? "topRight" : "rightMid"]);
+        }
+        return this.wrapWithStyleColors("border", content.join(""));
+    }
+    _topLeftChar(offset) {
+        if (this.x === null) {
+            throw new Error("Cell x must be initialized before calling _topLeftChar");
+        }
+        const x = this.x + offset;
+        let leftChar;
+        if (this.y === 0) {
+            leftChar = x === 0 ? "topLeft" : offset === 0 ? "topMid" : "top";
+        }
+        else {
+            if (x === 0) {
+                leftChar = "leftMid";
+            }
+            else {
+                leftChar = offset === 0 ? "midMid" : "bottomMid";
+                if (this.cells && this.y !== null) {
+                    // TODO: cells should always exist - some tests don't fill it in though
+                    const spanAbove = this.cells[this.y - 1]?.[x] instanceof ColSpanCell;
+                    if (spanAbove) {
+                        leftChar = offset === 0 ? "topMid" : "mid";
+                    }
+                    if (offset === 0) {
+                        let i = 1;
+                        while (this.cells[this.y]?.[x - i] instanceof ColSpanCell) {
+                            i++;
+                        }
+                        if (this.cells[this.y]?.[x - i] instanceof RowSpanCell) {
+                            leftChar = "leftMid";
+                        }
+                    }
+                }
+            }
+        }
+        return this.chars[leftChar];
+    }
+    wrapWithStyleColors(styleProperty, content) {
+        if (this[styleProperty]?.length) {
+            try {
+                // Use basic ANSI color codes
+                const colorMap = {
+                    red: "\x1b[31m",
+                    grey: "\x1b[90m",
+                    gray: "\x1b[90m",
+                };
+                let styledContent = content;
+                for (const colorName of this[styleProperty]) {
+                    if (colorName in colorMap) {
+                        styledContent = `${colorMap[colorName] + styledContent}\x1b[0m`;
+                    }
+                }
+                return styledContent;
+            }
+            catch (_e) {
+                return content;
+            }
+        }
+        else {
+            return content;
+        }
+    }
+    /**
+     * Renders a line of text.
+     * @param lineNum - Which line of text to render. This is not necessarily the line within the cell.
+     * There may be top-padding above the first line of text.
+     * @param drawRight - true if this method should render the right edge of the cell.
+     * @param forceTruncationSymbol - `true` if the rendered text should end with the truncation symbol even
+     * if the text fits. This is used when the cell is vertically truncated. If `false` the text should
+     * only include the truncation symbol if the text will not fit horizontally within the cell width.
+     * @param spanningCell - a number of if being called from a RowSpanCell. (how many rows below). otherwise undefined.
+     * @returns {String}
+     */
+    drawLine(lineNum, drawRight, forceTruncationSymbol, spanningCell) {
+        let left = this.chars[this.x === 0 ? "left" : "middle"];
+        if (this.x && this.x > 0 && spanningCell && this.cells && this.y !== null) {
+            let cellLeft = this.cells[this.y + spanningCell]?.[this.x - 1];
+            while (cellLeft instanceof ColSpanCell &&
+                cellLeft.y !== null &&
+                cellLeft.x !== null) {
+                cellLeft = this.cells[cellLeft.y]?.[cellLeft.x - 1];
+            }
+            if (!(cellLeft instanceof RowSpanCell)) {
+                left = this.chars["rightMid"];
+            }
+        }
+        const leftPadding = repeat(" ", this.paddingLeft);
+        const right = drawRight ? this.chars["right"] : "";
+        const rightPadding = repeat(" ", this.paddingRight);
+        let line = this.lines[lineNum];
+        const len = this.width - (this.paddingLeft + this.paddingRight);
+        if (forceTruncationSymbol)
+            line += this.truncate || "…";
+        let content = truncate(line, len, this.truncate);
+        content = pad(content, len, " ", this.hAlign);
+        content = leftPadding + content + rightPadding;
+        return this.stylizeLine(left, content, right);
+    }
+    stylizeLine(left, content, right) {
+        const processedLeft = this.wrapWithStyleColors("border", left);
+        const processedRight = this.wrapWithStyleColors("border", right);
+        let processedContent = content;
+        if (this.y === 0) {
+            processedContent = this.wrapWithStyleColors("head", processedContent);
+        }
+        return processedLeft + processedContent + processedRight;
+    }
+    /**
+     * Renders the bottom line of the cell.
+     * @param drawRight - true if this method should render the right edge of the cell.
+     * @returns {String}
+     */
+    drawBottom(drawRight) {
+        const left = this.chars[this.x === 0 ? "bottomLeft" : "bottomMid"];
+        const content = repeat(this.chars.bottom, this.width);
+        const right = drawRight ? this.chars["bottomRight"] : "";
+        return this.wrapWithStyleColors("border", left + content + right);
+    }
+    /**
+     * Renders a blank line of text within the cell. Used for top and/or bottom padding.
+     * @param drawRight - true if this method should render the right edge of the cell.
+     * @param spanningCell - a number of if being called from a RowSpanCell. (how many rows below). otherwise undefined.
+     * @returns {String}
+     */
+    drawEmpty(drawRight, spanningCell) {
+        let left = this.chars[this.x === 0 ? "left" : "middle"];
+        if (this.x && this.x > 0 && spanningCell && this.cells && this.y !== null) {
+            let cellLeft = this.cells[this.y + spanningCell]?.[this.x - 1];
+            while (cellLeft instanceof ColSpanCell &&
+                cellLeft.y !== null &&
+                cellLeft.x !== null) {
+                cellLeft = this.cells[cellLeft.y]?.[cellLeft.x - 1];
+            }
+            if (!(cellLeft instanceof RowSpanCell)) {
+                left = this.chars["rightMid"];
+            }
+        }
+        const right = drawRight ? this.chars["right"] : "";
+        const content = repeat(" ", this.width);
+        return this.stylizeLine(left, content, right);
+    }
+}
+export class ColSpanCell {
+    x = null;
+    y = null;
+    colSpan = 1;
+    draw(lineNum) {
+        if (typeof lineNum === "number") {
+            debug.debug(`${this.y}-${this.x}: 1x1 ColSpanCell`);
+        }
+        return "";
+    }
+    init() { }
+    mergeTableOptions() { }
+}
+export class RowSpanCell {
+    originalCell;
+    x = null;
+    y = null;
+    colSpan = 1;
+    cellOffset = 0;
+    offset = 0;
+    /**
+     * A placeholder Cell for a Cell that spans multiple rows.
+     * It delegates rendering to the original cell, but adds the appropriate offset.
+     */
+    constructor(originalCell) {
+        this.originalCell = originalCell;
+    }
+    init(tableOptions) {
+        if (this.y === null || this.originalCell.y === null) {
+            throw new Error("RowSpanCell y and originalCell.y must be initialized before calling init");
+        }
+        const y = this.y;
+        const originalY = this.originalCell.y;
+        this.cellOffset = y - originalY;
+        this.offset = findDimension(tableOptions.rowHeights, originalY, this.cellOffset);
+    }
+    draw(lineNum) {
+        if (lineNum === "top") {
+            return this.originalCell.draw(this.offset, this.cellOffset);
+        }
+        if (lineNum === "bottom") {
+            return this.originalCell.draw("bottom");
+        }
+        debug.debug(`${this.y}-${this.x}: 1x${this.colSpan} RowSpanCell for ${this.originalCell.content}`);
+        return this.originalCell.draw(this.offset + 1 + lineNum);
+    }
+    mergeTableOptions() { }
+}
+function firstDefined(...args) {
+    return args.filter((v) => v !== undefined && v !== null).shift();
+}
+// HELPER FUNCTIONS
+function setOption(objA, objB, nameB, targetObj) {
+    targetObj[nameB] = firstDefined(objA[nameB], objB[nameB]);
+}
+function findDimension(dimensionTable, startingIndex, span) {
+    let ret = dimensionTable[startingIndex];
+    for (let i = 1; i < span; i++) {
+        ret += 1 + dimensionTable[startingIndex + i];
+    }
+    return ret;
+}
+function sumPlusOne(a, b) {
+    return a + b + 1;
+}

package/dist/terminal/table/debug.d.ts

@@ -0,0 +1,15 @@
+type DebugLevel = 0 | 1 | 2 | 3;
+declare const debug: {
+    (msg: string, min: DebugLevel): void;
+    WARN: 1;
+    INFO: 2;
+    DEBUG: 3;
+    reset(): void;
+    setDebugLevel(v: number | string | boolean): void;
+    warn(msg: string): void;
+    info(msg: string): void;
+    debug(msg: string): void;
+    debugMessages(): string[];
+};
+export default debug;
+//# sourceMappingURL=debug.d.ts.map

package/dist/terminal/table/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../../source/terminal/table/debug.ts"],"names":[],"mappings":"AAAA,KAAK,UAAU,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAKhC,QAAA,MAAM,KAAK;UAAS,MAAM,OAAO,UAAU,GAAG,IAAI;;;;aAUhC,IAAI;qBAII,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI;cAYvC,MAAM,GAAG,IAAI;cACb,MAAM,GAAG,IAAI;eACZ,MAAM,GAAG,IAAI;qBAEP,MAAM,EAAE;CA1BjC,CAAC;AA4BF,eAAe,KAAK,CAAC"}