flagstaff 0.0.1 → 0.1.0

package/dist/plugin.d.ts

@@ -0,0 +1,107 @@
+/** A border style, in cli-boxes' shape exactly, so that corpus imports unchanged. */
+export interface BorderStyle {
+    topLeft: string;
+    top: string;
+    topRight: string;
+    left: string;
+    right: string;
+    bottomLeft: string;
+    bottom: string;
+    bottomRight: string;
+}
+/** A spinner style, in cli-spinners' shape plus the projection a pipe prints. */
+export interface SpinnerDef {
+    frames: string[];
+    interval: number;
+    static: string;
+}
+/** What the loop hoists: a static projection, and optionally the animated form. */
+export interface Component<S = unknown> {
+    name: string;
+    static(state: S): string;
+    frame?(t: number, state: S): string;
+    /** Milliseconds between repaints when `frame` is given; `DEFAULT_INTERVAL` otherwise. */
+    interval?: number;
+    /**
+     * The two states this component is *shown* with by `flagstaff check` and the docs gallery.
+     * The loop never reads it: a component's real state comes from the program. Declared here
+     * because a grader that invents a state renders the wrong thing and says `ok` (#59).
+     */
+    sample?: {
+        running: S;
+        done: S;
+    };
+}
+export declare const CONTRACT = 1;
+/** The whole plugin contract. Keys another package in the family understands are kept for it. */
+export interface Plugin {
+    name: string;
+    contract?: typeof CONTRACT;
+    tokens?: Record<string, `#${string}`>;
+    glyphs?: Record<string, string>;
+    spinners?: Record<string, SpinnerDef>;
+    borders?: Record<string, BorderStyle>;
+    components?: Record<string, Omit<Component, 'name'>>;
+}
+/**
+ * The family's whole refusal vocabulary (plugin-contract R8). One union, and every refusal
+ * any surface of this package prints is a member of it — the registry's five, and the two
+ * `flagstaff check` adds for what only a renderer can discover: a plugin that validates but
+ * contributes nothing renderable, and a component whose `static` throws on the state it is
+ * shown with.
+ *
+ * The last two lived as bare string literals in `cli.ts` until 2026-09-09, which is exactly
+ * the hole R8 exists to close: a second host could spell `E_COMPONENT_THREW` its own way and
+ * nothing would notice. `scripts/plugin-error-vocabulary-lock.test.ts` now reads this
+ * declaration out of the source and refuses any `'E_…'` literal in a host that is not in it.
+ *
+ * It stays a *type* rather than a `const` array on purpose. R3 forbids one layer importing
+ * another, so a runtime list could not be shared with roundel or caique even if it existed —
+ * the lock has to read the source to work across the family, and it does. A `const` array
+ * would therefore buy nothing and cost ~195 B on `./spinner`, which has 82 B of headroom.
+ */
+export type PluginErrorCode = 'E_PLUGIN_SCHEMA' | 'E_NO_STATIC_PROJECTION' | 'E_PLUGIN_CONTRACT' | 'E_UNKNOWN_SPINNER' | 'E_UNKNOWN_BORDER' | 'E_NO_CONTRIBUTION' | 'E_COMPONENT_THREW';
+/** A refused plugin says what is wrong, where, and what to do about it. */
+export declare class PluginError extends Error {
+    readonly code: PluginErrorCode;
+    readonly fix: string;
+    constructor(code: PluginErrorCode, message: string, fix: string);
+}
+/**
+ * Refuse what the schema refuses, and say why. A missing `static` gets its own code and
+ * fix, because it is the one mistake a plugin author makes on purpose (U3).
+ */
+export declare function validate(plugin: unknown): asserts plugin is Plugin;
+/** Maps, not records: a plugin's keys are its author's, and a Map cannot be polluted by one. */
+interface Registry {
+    plugins: string[];
+    tokens: Map<string, `#${string}`>;
+    glyphs: Map<string, string>;
+    spinners: Map<string, SpinnerDef>;
+    borders: Map<string, BorderStyle>;
+    components: Map<string, Component>;
+}
+/**
+ * The only wiring (R4, U9): validate, then keep every key this package understands. A later
+ * plugin's entry replaces an earlier one of the same name, so a user overrides a built-in
+ * by registering their own — the built-ins go through this same door first.
+ */
+export declare function register(plugin: unknown): void;
+/**
+ * A copy of what has been registered — the docs gallery and `flagstaff check` are
+ * projections of this. A copy rather than the registry itself, because `Readonly<T>` freezes
+ * the property bindings and not the `Map`s behind them: handing the live registry out made
+ * `set`, `delete` and `clear` a second door beside `register()`, through which a spinner
+ * with no `static` — or a component with no projection at all — could be put in without
+ * ever meeting `validate()` (#58). U3's refusal has to be structural to mean anything, so
+ * there is one way in. The values are the frozen objects `register()` stored, so nothing
+ * reached through here writes back.
+ */
+export declare function registered(): Readonly<Registry>;
+/** A spinner by name, or a refusal that lists the names that exist. */
+export declare function lookupSpinner(name: string): SpinnerDef;
+/** A border by name, for `box()`; every style the built-ins ship is registered like any other. */
+export declare function lookupBorder(name: string): BorderStyle;
+/** A glyph by meaning; the built-ins define every meaning the built-in components use. */
+export declare function glyph(meaning: string): string;
+export {};

package/dist/plugin.js

@@ -0,0 +1,163 @@
+import { builtins } from './builtins.js';
+import schema from './schema.json' with { type: 'json' };
+export const CONTRACT = 1;
+export class PluginError extends Error {
+    code;
+    fix;
+    constructor(code, message, fix) {
+        super(message);
+        this.code = code;
+        this.fix = fix;
+        this.name = 'PluginError';
+    }
+}
+const DEFS_PREFIX = '#/$defs/';
+const ROOT = schema;
+function typeOf(value) {
+    if (Array.isArray(value))
+        return 'array';
+    if (value === null)
+        return 'null';
+    if (typeof value === 'number')
+        return Number.isInteger(value) ? 'integer' : 'number';
+    return typeof value;
+}
+function checkScalar(value, node, path) {
+    if (node.const !== undefined && value !== node.const)
+        return `${path}: expected ${JSON.stringify(node.const)}, got ${JSON.stringify(value)}`;
+    if (typeof value === 'string') {
+        if (node.minLength !== undefined && value.length < node.minLength)
+            return `${path}: must not be empty`;
+        if (node.pattern !== undefined && !new RegExp(node.pattern).test(value))
+            return `${path}: ${JSON.stringify(value)} does not match ${node.pattern}`;
+    }
+    if (typeof value === 'number' && node.minimum !== undefined && value < node.minimum)
+        return `${path}: must be at least ${node.minimum}`;
+    return undefined;
+}
+function checkArray(value, node, path) {
+    if (node.minItems !== undefined && value.length < node.minItems)
+        return `${path}: needs at least ${node.minItems} item(s)`;
+    const { items } = node;
+    if (items === undefined)
+        return undefined;
+    for (const [i, item] of value.entries()) {
+        const problem = check(item, items, `${path}[${i}]`);
+        if (problem !== undefined)
+            return problem;
+    }
+    return undefined;
+}
+const isSchema = (x) => typeof x === 'object' && x !== null;
+function checkObject(record, node, path) {
+    for (const key of node.required ?? []) {
+        if (!(key in record))
+            return `${path}.${key}: required`;
+    }
+    for (const [key, child] of Object.entries(record)) {
+        const rule = node.properties?.[key] ?? (isSchema(node.additionalProperties) ? node.additionalProperties : undefined);
+        if (rule === undefined) {
+            if (node.additionalProperties === false)
+                return `${path}.${key}: not allowed`;
+            continue;
+        }
+        const problem = check(child, rule, `${path}.${key}`);
+        if (problem !== undefined)
+            return problem;
+    }
+    return undefined;
+}
+function check(value, node, path) {
+    if (node.$ref !== undefined) {
+        const def = ROOT.$defs[node.$ref.slice(DEFS_PREFIX.length)];
+        return def === undefined ? `${path}: unknown $ref ${node.$ref}` : check(value, def, path);
+    }
+    const actual = typeOf(value);
+    if (node.type !== undefined && actual !== node.type && !(node.type === 'number' && actual === 'integer')) {
+        return `${path}: expected ${node.type}, got ${actual}`;
+    }
+    if (Array.isArray(value))
+        return checkArray(value, node, path);
+    if (actual === 'object')
+        return checkObject(value, node, path);
+    return checkScalar(value, node, path);
+}
+const NO_STATIC = /\.(?:spinners|components)\.([^.]+)\.static: required$/;
+export function validate(plugin) {
+    const problem = check(plugin, ROOT, 'plugin');
+    if (problem !== undefined) {
+        const missing = NO_STATIC.exec(problem);
+        if (missing) {
+            throw new PluginError('E_NO_STATIC_PROJECTION', `${missing[1]} has no static projection`, 'give it a `static`: the text a pipe, an agent or a screen reader gets instead of the animation');
+        }
+        throw new PluginError('E_PLUGIN_SCHEMA', problem, 'compare the object against flagstaff/schema.json');
+    }
+    const { contract, components = {} } = plugin;
+    if (contract !== undefined && contract > CONTRACT) {
+        throw new PluginError('E_PLUGIN_CONTRACT', `plugin declares contract ${contract}; this flagstaff knows ${CONTRACT}`, `upgrade flagstaff, or set contract: ${CONTRACT}`);
+    }
+    for (const [name, component] of Object.entries(components)) {
+        if (typeof component.static !== 'function') {
+            throw new PluginError('E_NO_STATIC_PROJECTION', `${name} has no static projection`, 'make `static` a function of the state that returns the text a pipe prints');
+        }
+    }
+}
+const registry = { plugins: [], tokens: new Map(), glyphs: new Map(), spinners: new Map(), borders: new Map(), components: new Map() };
+function frozen(value) {
+    Object.freeze(value);
+    return value;
+}
+function deepFrozen(value, seen = new WeakMap()) {
+    if (value === null || typeof value !== 'object')
+        return value;
+    const already = seen.get(value);
+    if (already !== undefined)
+        return already;
+    const copy = (Array.isArray(value) ? [] : {});
+    seen.set(value, copy);
+    for (const [k, v] of Object.entries(value))
+        copy[k] = deepFrozen(v, seen);
+    return frozen(copy);
+}
+export function register(plugin) {
+    validate(plugin);
+    if (!registry.plugins.includes(plugin.name))
+        registry.plugins.push(plugin.name);
+    for (const [name, hex] of Object.entries(plugin.tokens ?? {}))
+        registry.tokens.set(name, hex);
+    for (const [name, text] of Object.entries(plugin.glyphs ?? {}))
+        registry.glyphs.set(name, text);
+    for (const [name, def] of Object.entries(plugin.spinners ?? {}))
+        registry.spinners.set(name, frozen({ ...def, frames: frozen([...def.frames]) }));
+    for (const [name, style] of Object.entries(plugin.borders ?? {}))
+        registry.borders.set(name, frozen({ ...style }));
+    for (const [name, component] of Object.entries(plugin.components ?? {}))
+        registry.components.set(name, frozen({ ...deepFrozen(component), name }));
+}
+export function registered() {
+    return {
+        plugins: [...registry.plugins],
+        tokens: new Map(registry.tokens),
+        glyphs: new Map(registry.glyphs),
+        spinners: new Map(registry.spinners),
+        borders: new Map(registry.borders),
+        components: new Map(registry.components),
+    };
+}
+function lookup(from, kind, code, name) {
+    const found = from.get(name);
+    if (found === undefined) {
+        throw new PluginError(code, `no ${kind} named ${JSON.stringify(name)}`, `use one of ${[...from.keys()].join(', ')}, or register a plugin that defines it`);
+    }
+    return found;
+}
+export function lookupSpinner(name) {
+    return lookup(registry.spinners, 'spinner', 'E_UNKNOWN_SPINNER', name);
+}
+export function lookupBorder(name) {
+    return lookup(registry.borders, 'border', 'E_UNKNOWN_BORDER', name);
+}
+export function glyph(meaning) {
+    return registry.glyphs.get(meaning) ?? '';
+}
+register(builtins);

package/dist/progress.d.ts

@@ -0,0 +1,19 @@
+import { type Component } from './plugin.js';
+export interface ProgressState {
+    /** Units done so far; clamped into `[0, total]` on the way out. */
+    done: number;
+    total: number;
+    /** What is being counted, e.g. `files`. Read in both projections. */
+    label?: string;
+}
+export interface ProgressOptions {
+    /** Cells the bar occupies on a terminal. Default 24. */
+    width?: number;
+    /** The two characters the bar is drawn with. Default `█` and `░`. */
+    glyphs?: {
+        filled: string;
+        empty: string;
+    };
+}
+/** A progress bar: `12/30 files · 40%` off a terminal, a drawn bar on one. */
+export declare function progress({ width, glyphs }?: ProgressOptions): Component<ProgressState>;

package/dist/progress.js

@@ -0,0 +1,25 @@
+import { muted, ok } from 'roundel/tokens';
+const DEFAULT_WIDTH = 24;
+const PERCENT = 100;
+const FILLED = '█';
+const EMPTY = '░';
+function ratio(state) {
+    if (state.total <= 0)
+        return 1;
+    return Math.min(1, Math.max(0, state.done / state.total));
+}
+function suffix(state) {
+    const label = state.label === undefined || state.label === '' ? '' : ` ${state.label}`;
+    return `${state.done}/${state.total}${label}`;
+}
+export function progress({ width = DEFAULT_WIDTH, glyphs = { filled: FILLED, empty: EMPTY } } = {}) {
+    const percentage = (state) => `${Math.round(ratio(state) * PERCENT)}%`;
+    return {
+        name: 'progress',
+        static: (state) => `${suffix(state)} · ${percentage(state)}`,
+        frame: (_t, state) => {
+            const filled = Math.round(ratio(state) * width);
+            return `${ok(glyphs.filled.repeat(filled))}${muted(glyphs.empty.repeat(Math.max(0, width - filled)))} ${suffix(state)}`;
+        },
+    };
+}

package/dist/projection.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The per-mode writers (R1). This is the only module in the package that emits a cursor
+ * operation, and it does so only in `tty`; every other projection is text and a newline,
+ * which is what R5 greps for. Streams and time come in as arguments — nothing here knows
+ * `process` exists. The three sequences are written by hand rather than through
+ * `node:readline`, whose helpers want a `Writable` where the loop only has a `Writer`.
+ */
+import { HIDE_CURSOR, SHOW_CURSOR } from './cursor.js';
+import { type Component } from './plugin.js';
+export interface Writer {
+    write(chunk: string): unknown;
+}
+/** Time as the loop sees it: burgee's `Runtime.clock` satisfies it, so does `manualClock()`. */
+export interface Clock {
+    now(): number;
+    schedule(fn: () => void, ms: number): () => void;
+}
+/** One hoisted component's lifecycle, as a mode sees it. */
+export interface Projection<S> {
+    open(state: S): void;
+    change(state: S): void;
+    close(state: S): void;
+}
+export declare const DEFAULT_INTERVAL = 80;
+export declare function ttyProjection<S>(component: Component<S>, out: Writer, clock: Clock): Projection<S>;
+/**
+ * A pipe, CI, or a screen reader: the static projection, once per change, and nothing else.
+ *
+ * "Once per change" is finer than "when the text differs". A component whose projection is
+ * a list — `tasks`, whose static is every task that has settled — grows it a line at a
+ * time, and printing the whole list on every change repeats every line already in the log:
+ *
+ *     ✔ install          ← install settled
+ *     ✔ install          ← build settled, and install is printed again
+ *     ✔ build
+ *
+ * So what is written is the lines *past the common prefix* with what was written last. A
+ * component whose text replaces itself rather than growing shares no prefix and is printed
+ * whole, which is the ordinary case; one that grows is appended to, which is what a log
+ * wants. An empty projection writes nothing at all — a component with nothing to say yet
+ * should not cost a blank line.
+ */
+export declare function staticProjection<S>(component: Component<S>, out: Writer): Projection<S>;
+/** `--json`: one NDJSON event per transition on stderr, so stdout stays the envelope's (R1). */
+export declare function jsonProjection<S>(component: Component<S>, err: Writer): Projection<S>;
+export { HIDE_CURSOR, SHOW_CURSOR };

package/dist/projection.js

@@ -0,0 +1,83 @@
+import { HIDE_CURSOR, restoreCursorOnExit, SHOW_CURSOR } from './cursor.js';
+export const DEFAULT_INTERVAL = 80;
+const CSI = '\u001B[';
+const NO_NET = () => undefined;
+function erase(lines) {
+    if (lines === 0)
+        return '';
+    return `${CSI}1G${lines > 1 ? `${CSI}${lines - 1}A` : ''}${CSI}0J`;
+}
+class TtyProjection {
+    #component;
+    #out;
+    #clock;
+    #interval;
+    #started;
+    #current;
+    #lines = 0;
+    #cancel = () => undefined;
+    #dropCursorNet = NO_NET;
+    constructor(component, out, clock) {
+        this.#component = component;
+        this.#out = out;
+        this.#clock = clock;
+        this.#interval = component.interval ?? DEFAULT_INTERVAL;
+        this.#started = clock.now();
+    }
+    open(state) {
+        this.#current = state;
+        this.#out.write(HIDE_CURSOR);
+        this.#dropCursorNet = restoreCursorOnExit((s) => void this.#out.write(s));
+        this.#paint();
+        if (this.#component.frame !== undefined)
+            this.#cancel = this.#clock.schedule(() => this.#repaint(), this.#interval);
+    }
+    change(state) {
+        this.#current = state;
+        this.#paint();
+    }
+    close(state) {
+        this.#cancel();
+        this.#out.write(`${erase(this.#lines)}${this.#component.static(state)}\n${SHOW_CURSOR}`);
+        this.#dropCursorNet();
+        this.#dropCursorNet = NO_NET;
+        this.#lines = 0;
+    }
+    #paint() {
+        const { frame } = this.#component;
+        const text = frame === undefined ? this.#component.static(this.#current) : frame(this.#clock.now() - this.#started, this.#current);
+        this.#out.write(erase(this.#lines) + text);
+        this.#lines = text.split('\n').length;
+    }
+    #repaint() {
+        this.#paint();
+        this.#cancel = this.#clock.schedule(() => this.#repaint(), this.#interval);
+    }
+}
+export function ttyProjection(component, out, clock) {
+    return new TtyProjection(component, out, clock);
+}
+export function staticProjection(component, out) {
+    let written = [];
+    const emit = (state) => {
+        const text = component.static(state);
+        if (text === '')
+            return;
+        const lines = text.split('\n');
+        let shared = 0;
+        while (shared < written.length && shared < lines.length && written[shared] === lines[shared])
+            shared += 1;
+        const fresh = lines.slice(shared);
+        written = lines;
+        if (fresh.length > 0)
+            out.write(`${fresh.join('\n')}\n`);
+    };
+    return { open: emit, change: emit, close: emit };
+}
+export function jsonProjection(component, err) {
+    const emit = (state) => {
+        err.write(`${JSON.stringify({ event: component.name, state })}\n`);
+    };
+    return { open: emit, change: emit, close: emit };
+}
+export { HIDE_CURSOR, SHOW_CURSOR };

package/dist/schema.json

@@ -0,0 +1 @@
+{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://github.com/ofri-peretz/burgee/blob/main/packages/flagstaff/src/schema.json","title":"flagstaff plugin","description":"A plugin is one plain object. Everything in it is data that can be read without running it; the only functions allowed are a component's `static` (required) and `frame` (optional). A spinner or component without a static projection is refused at register().","type":"object","required":["name"],"additionalProperties":true,"properties":{"name":{"type":"string","minLength":1,"description":"The plugin's name; also the prefix a host may use when two plugins contribute the same key."},"contract":{"type":"integer","minimum":1,"description":"The plugin contract this object follows. A host refuses a newer contract than it knows."},"tokens":{"type":"object","description":"A roundel theme: semantic token name to a hex colour, contrast-checked when flown.","additionalProperties":{"type":"string","pattern":"^#[0-9a-fA-F]{6}$"}},"glyphs":{"type":"object","description":"Symbols by meaning: `ok`, `fail`, `warn`, `info`, `running`. A plugin that ships glyphs changes every built-in that draws one.","additionalProperties":{"type":"string","minLength":1}},"spinners":{"type":"object","description":"Spinner styles by name, in cli-spinners' shape plus the static projection.","additionalProperties":{"$ref":"#/$defs/spinner"}},"borders":{"type":"object","description":"Border styles a box can be drawn with, by name.","additionalProperties":{"$ref":"#/$defs/border"}},"components":{"type":"object","description":"Components by name: `static(state)` returns the text a pipe, an agent or a screen reader gets; `frame(t, state)` is the optional animated form.","additionalProperties":{"$ref":"#/$defs/component"}}},"$defs":{"spinner":{"type":"object","required":["frames","interval","static"],"properties":{"frames":{"type":"array","items":{"type":"string"},"minItems":1},"interval":{"type":"integer","minimum":1,"description":"Milliseconds between frames on a terminal."},"static":{"type":"string","description":"What a pipe prints instead of the animation."}}},"component":{"type":"object","required":["static"],"properties":{"static":{"description":"(state) => string. Required: the projection every non-terminal mode prints."},"frame":{"description":"(t, state) => string. Optional: the frame at t milliseconds since hoisting."},"sample":{"type":"object","required":["running","done"],"description":"Two states to *show* this component with: `flagstaff check` and the docs gallery render `running` then `done`. Omitted, they assume `{ phase: 'running' }` and `{ phase: 'done' }` and say so in the output. The loop never reads it — a running program's state comes from the program.","properties":{"running":{"description":"The state to open with."},"done":{"description":"The state to close with."}}},"interval":{"type":"integer","minimum":1,"description":"Milliseconds between repaints when `frame` is given; 80 when omitted."}}},"border":{"type":"object","required":["topLeft","top","topRight","left","right","bottomLeft","bottom","bottomRight"],"description":"cli-boxes' shape exactly, so that corpus imports unchanged.","properties":{"topLeft":{"type":"string"},"top":{"type":"string"},"topRight":{"type":"string"},"left":{"type":"string"},"right":{"type":"string"},"bottomLeft":{"type":"string"},"bottom":{"type":"string"},"bottomRight":{"type":"string"}}}}}

package/dist/spinner.d.ts

@@ -0,0 +1,9 @@
+import { type Component } from './plugin.js';
+export type SpinnerStatus = 'running' | 'ok' | 'fail' | 'warn' | 'info';
+export interface SpinnerState {
+    text: string;
+    /** `running` when omitted. */
+    status?: SpinnerStatus;
+}
+/** A spinner in the named style (`dots` by default); every style is a registered plugin's. */
+export declare function spinner(style?: string): Component<SpinnerState>;

package/dist/spinner.js

@@ -0,0 +1,24 @@
+import { error, hint, ok, warn } from 'roundel/tokens';
+import { glyph, lookupSpinner } from './plugin.js';
+const PAINT = { ok, fail: error, warn, info: hint };
+function symbol(status, def) {
+    if (status === 'running')
+        return def.static || glyph('running');
+    return PAINT[status](glyph(status));
+}
+export function spinner(style = 'dots') {
+    const def = lookupSpinner(style);
+    const line = (status, text) => `${symbol(status, def)} ${text}`;
+    return {
+        name: 'spinner',
+        interval: def.interval,
+        static: (state) => line(state.status ?? 'running', state.text),
+        frame: (t, state) => {
+            const status = state.status ?? 'running';
+            if (status !== 'running')
+                return line(status, state.text);
+            const at = Math.floor(t / def.interval) % def.frames.length;
+            return `${def.frames[at] ?? ''} ${state.text}`;
+        },
+    };
+}

package/dist/spinners.json

@@ -0,0 +1 @@
+{"dots":{"interval":80,"frames":["⠋","⠙","⠹","⠸","⠼","⠴","⠦","⠧","⠇","⠏"]},"dots2":{"interval":80,"frames":["⣾","⣽","⣻","⢿","⡿","⣟","⣯","⣷"]},"dots3":{"interval":80,"frames":["⠋","⠙","⠚","⠞","⠖","⠦","⠴","⠲","⠳","⠓"]},"dots4":{"interval":80,"frames":["⠄","⠆","⠇","⠋","⠙","⠸","⠰","⠠","⠰","⠸","⠙","⠋","⠇","⠆"]},"dots5":{"interval":80,"frames":["⠋","⠙","⠚","⠒","⠂","⠂","⠒","⠲","⠴","⠦","⠖","⠒","⠐","⠐","⠒","⠓","⠋"]},"dots6":{"interval":80,"frames":["⠁","⠉","⠙","⠚","⠒","⠂","⠂","⠒","⠲","⠴","⠤","⠄","⠄","⠤","⠴","⠲","⠒","⠂","⠂","⠒","⠚","⠙","⠉","⠁"]},"dots7":{"interval":80,"frames":["⠈","⠉","⠋","⠓","⠒","⠐","⠐","⠒","⠖","⠦","⠤","⠠","⠠","⠤","⠦","⠖","⠒","⠐","⠐","⠒","⠓","⠋","⠉","⠈"]},"dots8":{"interval":80,"frames":["⠁","⠁","⠉","⠙","⠚","⠒","⠂","⠂","⠒","⠲","⠴","⠤","⠄","⠄","⠤","⠠","⠠","⠤","⠦","⠖","⠒","⠐","⠐","⠒","⠓","⠋","⠉","⠈","⠈"]},"dots9":{"interval":80,"frames":["⢹","⢺","⢼","⣸","⣇","⡧","⡗","⡏"]},"dots10":{"interval":80,"frames":["⢄","⢂","⢁","⡁","⡈","⡐","⡠"]},"dots11":{"interval":100,"frames":["⠁","⠂","⠄","⡀","⢀","⠠","⠐","⠈"]},"dots12":{"interval":80,"frames":["⢀⠀","⡀⠀","⠄⠀","⢂⠀","⡂⠀","⠅⠀","⢃⠀","⡃⠀","⠍⠀","⢋⠀","⡋⠀","⠍⠁","⢋⠁","⡋⠁","⠍⠉","⠋⠉","⠋⠉","⠉⠙","⠉⠙","⠉⠩","⠈⢙","⠈⡙","⢈⠩","⡀⢙","⠄⡙","⢂⠩","⡂⢘","⠅⡘","⢃⠨","⡃⢐","⠍⡐","⢋⠠","⡋⢀","⠍⡁","⢋⠁","⡋⠁","⠍⠉","⠋⠉","⠋⠉","⠉⠙","⠉⠙","⠉⠩","⠈⢙","⠈⡙","⠈⠩","⠀⢙","⠀⡙","⠀⠩","⠀⢘","⠀⡘","⠀⠨","⠀⢐","⠀⡐","⠀⠠","⠀⢀","⠀⡀"]},"dots13":{"interval":80,"frames":["⣼","⣹","⢻","⠿","⡟","⣏","⣧","⣶"]},"dots14":{"interval":80,"frames":["⠉⠉","⠈⠙","⠀⠹","⠀⢸","⠀⣰","⢀⣠","⣀⣀","⣄⡀","⣆⠀","⡇⠀","⠏⠀","⠋⠁"]},"dots8Bit":{"interval":80,"frames":["⠀","⠁","⠂","⠃","⠄","⠅","⠆","⠇","⡀","⡁","⡂","⡃","⡄","⡅","⡆","⡇","⠈","⠉","⠊","⠋","⠌","⠍","⠎","⠏","⡈","⡉","⡊","⡋","⡌","⡍","⡎","⡏","⠐","⠑","⠒","⠓","⠔","⠕","⠖","⠗","⡐","⡑","⡒","⡓","⡔","⡕","⡖","⡗","⠘","⠙","⠚","⠛","⠜","⠝","⠞","⠟","⡘","⡙","⡚","⡛","⡜","⡝","⡞","⡟","⠠","⠡","⠢","⠣","⠤","⠥","⠦","⠧","⡠","⡡","⡢","⡣","⡤","⡥","⡦","⡧","⠨","⠩","⠪","⠫","⠬","⠭","⠮","⠯","⡨","⡩","⡪","⡫","⡬","⡭","⡮","⡯","⠰","⠱","⠲","⠳","⠴","⠵","⠶","⠷","⡰","⡱","⡲","⡳","⡴","⡵","⡶","⡷","⠸","⠹","⠺","⠻","⠼","⠽","⠾","⠿","⡸","⡹","⡺","⡻","⡼","⡽","⡾","⡿","⢀","⢁","⢂","⢃","⢄","⢅","⢆","⢇","⣀","⣁","⣂","⣃","⣄","⣅","⣆","⣇","⢈","⢉","⢊","⢋","⢌","⢍","⢎","⢏","⣈","⣉","⣊","⣋","⣌","⣍","⣎","⣏","⢐","⢑","⢒","⢓","⢔","⢕","⢖","⢗","⣐","⣑","⣒","⣓","⣔","⣕","⣖","⣗","⢘","⢙","⢚","⢛","⢜","⢝","⢞","⢟","⣘","⣙","⣚","⣛","⣜","⣝","⣞","⣟","⢠","⢡","⢢","⢣","⢤","⢥","⢦","⢧","⣠","⣡","⣢","⣣","⣤","⣥","⣦","⣧","⢨","⢩","⢪","⢫","⢬","⢭","⢮","⢯","⣨","⣩","⣪","⣫","⣬","⣭","⣮","⣯","⢰","⢱","⢲","⢳","⢴","⢵","⢶","⢷","⣰","⣱","⣲","⣳","⣴","⣵","⣶","⣷","⢸","⢹","⢺","⢻","⢼","⢽","⢾","⢿","⣸","⣹","⣺","⣻","⣼","⣽","⣾","⣿"]},"dotsCircle":{"interval":80,"frames":["⢎ ","⠎⠁","⠊⠑","⠈⠱"," ⡱","⢀⡰","⢄⡠","⢆⡀"]},"sand":{"interval":80,"frames":["⠁","⠂","⠄","⡀","⡈","⡐","⡠","⣀","⣁","⣂","⣄","⣌","⣔","⣤","⣥","⣦","⣮","⣶","⣷","⣿","⡿","⠿","⢟","⠟","⡛","⠛","⠫","⢋","⠋","⠍","⡉","⠉","⠑","⠡","⢁"]},"line":{"interval":130,"frames":["-","\\","|","/"]},"line2":{"interval":100,"frames":["⠂","-","–","—","–","-"]},"pipe":{"interval":100,"frames":["┤","┘","┴","└","├","┌","┬","┐"]},"simpleDots":{"interval":400,"frames":[".  ",".. ","...","   "]},"simpleDotsScrolling":{"interval":200,"frames":[".  ",".. ","..."," ..","  .","   "]},"star":{"interval":70,"frames":["✶","✸","✹","✺","✹","✷"]},"star2":{"interval":80,"frames":["+","x","*"]},"flip":{"interval":70,"frames":["_","_","_","-","`","`","'","´","-","_","_","_"]},"hamburger":{"interval":100,"frames":["☱","☲","☴"]},"growVertical":{"interval":120,"frames":["▁","▃","▄","▅","▆","▇","▆","▅","▄","▃"]},"growHorizontal":{"interval":120,"frames":["▏","▎","▍","▌","▋","▊","▉","▊","▋","▌","▍","▎"]},"balloon":{"interval":140,"frames":[" ",".","o","O","@","*"," "]},"balloon2":{"interval":120,"frames":[".","o","O","°","O","o","."]},"noise":{"interval":100,"frames":["▓","▒","░"]},"bounce":{"interval":120,"frames":["⠁","⠂","⠄","⠂"]},"boxBounce":{"interval":120,"frames":["▖","▘","▝","▗"]},"boxBounce2":{"interval":100,"frames":["▌","▀","▐","▄"]},"triangle":{"interval":50,"frames":["◢","◣","◤","◥"]},"binary":{"interval":80,"frames":["010010","001100","100101","111010","111101","010111","101011","111000","110011","110101"]},"arc":{"interval":100,"frames":["◜","◠","◝","◞","◡","◟"]},"circle":{"interval":120,"frames":["◡","⊙","◠"]},"squareCorners":{"interval":180,"frames":["◰","◳","◲","◱"]},"circleQuarters":{"interval":120,"frames":["◴","◷","◶","◵"]},"circleHalves":{"interval":50,"frames":["◐","◓","◑","◒"]},"squish":{"interval":100,"frames":["╫","╪"]},"toggle":{"interval":250,"frames":["⊶","⊷"]},"toggle2":{"interval":80,"frames":["▫","▪"]},"toggle3":{"interval":120,"frames":["□","■"]},"toggle4":{"interval":100,"frames":["■","□","▪","▫"]},"toggle5":{"interval":100,"frames":["▮","▯"]},"toggle6":{"interval":300,"frames":["ဝ","၀"]},"toggle7":{"interval":80,"frames":["⦾","⦿"]},"toggle8":{"interval":100,"frames":["◍","◌"]},"toggle9":{"interval":100,"frames":["◉","◎"]},"toggle10":{"interval":100,"frames":["㊂","㊀","㊁"]},"toggle11":{"interval":50,"frames":["⧇","⧆"]},"toggle12":{"interval":120,"frames":["☗","☖"]},"toggle13":{"interval":80,"frames":["=","*","-"]},"arrow":{"interval":100,"frames":["←","↖","↑","↗","→","↘","↓","↙"]},"arrow2":{"interval":80,"frames":["⬆️ ","↗️ ","➡️ ","↘️ ","⬇️ ","↙️ ","⬅️ ","↖️ "]},"arrow3":{"interval":120,"frames":["▹▹▹▹▹","▸▹▹▹▹","▹▸▹▹▹","▹▹▸▹▹","▹▹▹▸▹","▹▹▹▹▸"]},"bouncingBar":{"interval":80,"frames":["[    ]","[=   ]","[==  ]","[=== ]","[====]","[ ===]","[  ==]","[   =]","[    ]","[   =]","[  ==]","[ ===]","[====]","[=== ]","[==  ]","[=   ]"]},"bouncingBall":{"interval":80,"frames":["( ●    )","(  ●   )","(   ●  )","(    ● )","(     ●)","(    ● )","(   ●  )","(  ●   )","( ●    )","(●     )"]},"smiley":{"interval":200,"frames":["😄 ","😝 "]},"monkey":{"interval":300,"frames":["🙈 ","🙈 ","🙉 ","🙊 "]},"hearts":{"interval":100,"frames":["💛 ","💙 ","💜 ","💚 ","❤️ "]},"clock":{"interval":100,"frames":["🕛 ","🕐 ","🕑 ","🕒 ","🕓 ","🕔 ","🕕 ","🕖 ","🕗 ","🕘 ","🕙 ","🕚 "]},"earth":{"interval":180,"frames":["🌍 ","🌎 ","🌏 "]},"material":{"interval":17,"frames":["█▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁","██▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁","███▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁","████▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁","██████▁▁▁▁▁▁▁▁▁▁▁▁▁▁","██████▁▁▁▁▁▁▁▁▁▁▁▁▁▁","███████▁▁▁▁▁▁▁▁▁▁▁▁▁","████████▁▁▁▁▁▁▁▁▁▁▁▁","█████████▁▁▁▁▁▁▁▁▁▁▁","█████████▁▁▁▁▁▁▁▁▁▁▁","██████████▁▁▁▁▁▁▁▁▁▁","███████████▁▁▁▁▁▁▁▁▁","█████████████▁▁▁▁▁▁▁","██████████████▁▁▁▁▁▁","██████████████▁▁▁▁▁▁","▁██████████████▁▁▁▁▁","▁██████████████▁▁▁▁▁","▁██████████████▁▁▁▁▁","▁▁██████████████▁▁▁▁","▁▁▁██████████████▁▁▁","▁▁▁▁█████████████▁▁▁","▁▁▁▁██████████████▁▁","▁▁▁▁██████████████▁▁","▁▁▁▁▁██████████████▁","▁▁▁▁▁██████████████▁","▁▁▁▁▁██████████████▁","▁▁▁▁▁▁██████████████","▁▁▁▁▁▁██████████████","▁▁▁▁▁▁▁█████████████","▁▁▁▁▁▁▁█████████████","▁▁▁▁▁▁▁▁████████████","▁▁▁▁▁▁▁▁████████████","▁▁▁▁▁▁▁▁▁███████████","▁▁▁▁▁▁▁▁▁███████████","▁▁▁▁▁▁▁▁▁▁██████████","▁▁▁▁▁▁▁▁▁▁██████████","▁▁▁▁▁▁▁▁▁▁▁▁████████","▁▁▁▁▁▁▁▁▁▁▁▁▁███████","▁▁▁▁▁▁▁▁▁▁▁▁▁▁██████","▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█████","▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█████","█▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁████","██▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁███","██▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁███","███▁▁▁▁▁▁▁▁▁▁▁▁▁▁███","████▁▁▁▁▁▁▁▁▁▁▁▁▁▁██","█████▁▁▁▁▁▁▁▁▁▁▁▁▁▁█","█████▁▁▁▁▁▁▁▁▁▁▁▁▁▁█","██████▁▁▁▁▁▁▁▁▁▁▁▁▁█","████████▁▁▁▁▁▁▁▁▁▁▁▁","█████████▁▁▁▁▁▁▁▁▁▁▁","█████████▁▁▁▁▁▁▁▁▁▁▁","█████████▁▁▁▁▁▁▁▁▁▁▁","█████████▁▁▁▁▁▁▁▁▁▁▁","███████████▁▁▁▁▁▁▁▁▁","████████████▁▁▁▁▁▁▁▁","████████████▁▁▁▁▁▁▁▁","██████████████▁▁▁▁▁▁","██████████████▁▁▁▁▁▁","▁██████████████▁▁▁▁▁","▁██████████████▁▁▁▁▁","▁▁▁█████████████▁▁▁▁","▁▁▁▁▁████████████▁▁▁","▁▁▁▁▁████████████▁▁▁","▁▁▁▁▁▁███████████▁▁▁","▁▁▁▁▁▁▁▁█████████▁▁▁","▁▁▁▁▁▁▁▁█████████▁▁▁","▁▁▁▁▁▁▁▁▁█████████▁▁","▁▁▁▁▁▁▁▁▁█████████▁▁","▁▁▁▁▁▁▁▁▁▁█████████▁","▁▁▁▁▁▁▁▁▁▁▁████████▁","▁▁▁▁▁▁▁▁▁▁▁████████▁","▁▁▁▁▁▁▁▁▁▁▁▁███████▁","▁▁▁▁▁▁▁▁▁▁▁▁███████▁","▁▁▁▁▁▁▁▁▁▁▁▁▁███████","▁▁▁▁▁▁▁▁▁▁▁▁▁███████","▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█████","▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁████","▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁████","▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁████","▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁███","▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁███","▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁██","▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁██","▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁██","▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█","▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█","▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁█","▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁","▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁","▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁","▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁▁"]},"moon":{"interval":80,"frames":["🌑 ","🌒 ","🌓 ","🌔 ","🌕 ","🌖 ","🌗 ","🌘 "]},"runner":{"interval":140,"frames":["🚶 ","🏃 "]},"pong":{"interval":80,"frames":["▐⠂       ▌","▐⠈       ▌","▐ ⠂      ▌","▐ ⠠      ▌","▐  ⡀     ▌","▐  ⠠     ▌","▐   ⠂    ▌","▐   ⠈    ▌","▐    ⠂   ▌","▐    ⠠   ▌","▐     ⡀  ▌","▐     ⠠  ▌","▐      ⠂ ▌","▐      ⠈ ▌","▐       ⠂▌","▐       ⠠▌","▐       ⡀▌","▐      ⠠ ▌","▐      ⠂ ▌","▐     ⠈  ▌","▐     ⠂  ▌","▐    ⠠   ▌","▐    ⡀   ▌","▐   ⠠    ▌","▐   ⠂    ▌","▐  ⠈     ▌","▐  ⠂     ▌","▐ ⠠      ▌","▐ ⡀      ▌","▐⠠       ▌"]},"shark":{"interval":120,"frames":["▐|\\____________▌","▐_|\\___________▌","▐__|\\__________▌","▐___|\\_________▌","▐____|\\________▌","▐_____|\\_______▌","▐______|\\______▌","▐_______|\\_____▌","▐________|\\____▌","▐_________|\\___▌","▐__________|\\__▌","▐___________|\\_▌","▐____________|\\▌","▐____________/|▌","▐___________/|_▌","▐__________/|__▌","▐_________/|___▌","▐________/|____▌","▐_______/|_____▌","▐______/|______▌","▐_____/|_______▌","▐____/|________▌","▐___/|_________▌","▐__/|__________▌","▐_/|___________▌","▐/|____________▌"]},"dqpb":{"interval":100,"frames":["d","q","p","b"]},"weather":{"interval":100,"frames":["☀️ ","☀️ ","☀️ ","🌤 ","⛅️ ","🌥 ","☁️ ","🌧 ","🌨 ","🌧 ","🌨 ","🌧 ","🌨 ","⛈ ","🌨 ","🌧 ","🌨 ","☁️ ","🌥 ","⛅️ ","🌤 ","☀️ ","☀️ "]},"christmas":{"interval":400,"frames":["🌲","🎄"]},"grenade":{"interval":80,"frames":["،  ","′  "," ´ "," ‾ ","  ⸌","  ⸊","  |","  ⁎","  ⁕"," ෴ ","  ⁓","   ","   ","   "]},"point":{"interval":125,"frames":["∙∙∙","●∙∙","∙●∙","∙∙●","∙∙∙"]},"layer":{"interval":150,"frames":["-","=","≡"]},"betaWave":{"interval":80,"frames":["ρββββββ","βρβββββ","ββρββββ","βββρβββ","ββββρββ","βββββρβ","ββββββρ"]},"fingerDance":{"interval":160,"frames":["🤘 ","🤟 ","🖖 ","✋ ","🤚 ","👆 "]},"fistBump":{"interval":80,"frames":["🤜　　　　🤛 ","🤜　　　　🤛 ","🤜　　　　🤛 ","　🤜　　🤛　 ","　　🤜🤛　　 ","　🤜✨🤛　　 ","🤜　✨　🤛　 "]},"soccerHeader":{"interval":80,"frames":[" 🧑⚽️       🧑 ","🧑  ⚽️      🧑 ","🧑   ⚽️     🧑 ","🧑    ⚽️    🧑 ","🧑     ⚽️   🧑 ","🧑      ⚽️  🧑 ","🧑       ⚽️🧑  ","🧑      ⚽️  🧑 ","🧑     ⚽️   🧑 ","🧑    ⚽️    🧑 ","🧑   ⚽️     🧑 ","🧑  ⚽️      🧑 "]},"mindblown":{"interval":160,"frames":["😐 ","😐 ","😮 ","😮 ","😦 ","😦 ","😧 ","😧 ","🤯 ","💥 ","✨ ","　 ","　 ","　 "]},"speaker":{"interval":160,"frames":["🔈 ","🔉 ","🔊 ","🔉 "]},"orangePulse":{"interval":100,"frames":["🔸 ","🔶 ","🟠 ","🟠 ","🔶 "]},"bluePulse":{"interval":100,"frames":["🔹 ","🔷 ","🔵 ","🔵 ","🔷 "]},"orangeBluePulse":{"interval":100,"frames":["🔸 ","🔶 ","🟠 ","🟠 ","🔶 ","🔹 ","🔷 ","🔵 ","🔵 ","🔷 "]},"timeTravel":{"interval":100,"frames":["🕛 ","🕚 ","🕙 ","🕘 ","🕗 ","🕖 ","🕕 ","🕔 ","🕓 ","🕒 ","🕑 ","🕐 "]},"aesthetic":{"interval":80,"frames":["▰▱▱▱▱▱▱","▰▰▱▱▱▱▱","▰▰▰▱▱▱▱","▰▰▰▰▱▱▱","▰▰▰▰▰▱▱","▰▰▰▰▰▰▱","▰▰▰▰▰▰▰","▰▱▱▱▱▱▱"]},"dwarfFortress":{"interval":80,"frames":[" ██████£££  ","☺██████£££  ","☺██████£££  ","☺▓█████£££  ","☺▓█████£££  ","☺▒█████£££  ","☺▒█████£££  ","☺░█████£££  ","☺░█████£££  ","☺ █████£££  "," ☺█████£££  "," ☺█████£££  "," ☺▓████£££  "," ☺▓████£££  "," ☺▒████£££  "," ☺▒████£££  "," ☺░████£££  "," ☺░████£££  "," ☺ ████£££  ","  ☺████£££  ","  ☺████£££  ","  ☺▓███£££  ","  ☺▓███£££  ","  ☺▒███£££  ","  ☺▒███£££  ","  ☺░███£££  ","  ☺░███£££  ","  ☺ ███£££  ","   ☺███£££  ","   ☺███£££  ","   ☺▓██£££  ","   ☺▓██£££  ","   ☺▒██£££  ","   ☺▒██£££  ","   ☺░██£££  ","   ☺░██£££  ","   ☺ ██£££  ","    ☺██£££  ","    ☺██£££  ","    ☺▓█£££  ","    ☺▓█£££  ","    ☺▒█£££  ","    ☺▒█£££  ","    ☺░█£££  ","    ☺░█£££  ","    ☺ █£££  ","     ☺█£££  ","     ☺█£££  ","     ☺▓£££  ","     ☺▓£££  ","     ☺▒£££  ","     ☺▒£££  ","     ☺░£££  ","     ☺░£££  ","     ☺ £££  ","      ☺£££  ","      ☺£££  ","      ☺▓££  ","      ☺▓££  ","      ☺▒££  ","      ☺▒££  ","      ☺░££  ","      ☺░££  ","      ☺ ££  ","       ☺££  ","       ☺££  ","       ☺▓£  ","       ☺▓£  ","       ☺▒£  ","       ☺▒£  ","       ☺░£  ","       ☺░£  ","       ☺ £  ","        ☺£  ","        ☺£  ","        ☺▓  ","        ☺▓  ","        ☺▒  ","        ☺▒  ","        ☺░  ","        ☺░  ","        ☺   ","        ☺  &","        ☺ ☼&","       ☺ ☼ &","       ☺☼  &","      ☺☼  & ","      ‼   & ","     ☺   &  ","    ‼    &  ","   ☺    &   ","  ‼     &   "," ☺     &    ","‼      &    ","      &     ","      &     ","     &   ░  ","     &   ▒  ","    &    ▓  ","    &    £  ","   &    ░£  ","   &    ▒£  ","  &     ▓£  ","  &     ££  "," &     ░££  "," &     ▒££  ","&      ▓££  ","&      £££  ","      ░£££  ","      ▒£££  ","      ▓£££  ","      █£££  ","     ░█£££  ","     ▒█£££  ","     ▓█£££  ","     ██£££  ","    ░██£££  ","    ▒██£££  ","    ▓██£££  ","    ███£££  ","   ░███£££  ","   ▒███£££  ","   ▓███£££  ","   ████£££  ","  ░████£££  ","  ▒████£££  ","  ▓████£££  ","  █████£££  "," ░█████£££  "," ▒█████£££  "," ▓█████£££  "," ██████£££  "," ██████£££  "]}}

package/dist/table.d.ts

@@ -0,0 +1,18 @@
+import { type Component } from './plugin.js';
+export type Row = string[];
+export 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')[];
+}
+/** Draw `rows` as a table, as a string. */
+export declare function table(rows: Row[], options?: TableOptions): string;
+export interface TableState {
+    head?: string[];
+    rows: Row[];
+}
+/** A table as a component: `header: value` pairs off a terminal, the grid on one (R1). */
+export declare function tableComponent(options?: TableOptions): Component<TableState>;