flagstaff/table

import { table, tableComponent } from 'flagstaff/table';

function table(rows: Row[], options?: TableOptions): string;

function tableComponent(options?: TableOptions): Component<TableState>;

interface ColumnOptions {
    /**
     * How far the fit may narrow the column while another can still give way. A whole number
     * from 0. It bounds the shrink and is not a width: a column narrower than it stays so.
     */
    min?: number;
    /** A cap no content pushes the column past. A whole number from 1, and at least `min`. */
    max?: number;
    /**
     * What a cell wider than its column does (R3): `'wrap'` onto more physical rows, the
     * default and the only behaviour before this option, or `'truncate'` to one row ending in
     * `…`. A person's view only: the static projection carries the full cell either way (R4).
     */
    overflow?: 'wrap' | 'truncate';
}

interface Linked {
    readonly text: string;
    readonly href: string;
}

interface TableOptions {
    /** Column headers. Omitted, the table is drawn without a header row. */
    head?: string[];
    /** Columns the whole table may occupy. Default 80. */
    width?: number;
    /** Alignment per column; `left` for any column not named. */
    align?: ('left' | 'right')[];
    /**
     * Bounds per column, positional like `align`; a hole or a missing entry is unbounded. Both
     * are content widths, as `width()` measures them, padding not counted.
     */
    columns?: (ColumnOptions | undefined)[];
    /**
     * The terminal a linked cell is rendered for. Omitted, the real process is read through
     * this package's seam. Supply one and the whole path is pure — which is how `link.test.ts`
     * grades both branches without a terminal in sight.
     */
    terminal?: Terminal;
}

interface TableState {
    head?: string[];
    rows: Row[];
}

type Cell = string | Linked;

type Row = Cell[];