@sigrun/tui 0.1.1 → 0.2.1

package/dist/blocks/log.js

@@ -1,111 +0,0 @@
-/**
- * The `log` block (UI-blocks spec §5.3): bound `{at?, level?, text}[]`
- * lines in a block-local viewport of {@link LOG_VIEWPORT_ROWS} rows.
- *
- * With `follow` the viewport pins to the tail until the user scrolls
- * up; scrolling back to the bottom re-arms the following (the
- * transcript convention). Per-level tones default `error`→bad,
- * `warn`→warn, `info`→neutral, `debug`→info (the muted token);
- * `tones` overrides per level. `wrap` folds long lines instead of
- * truncating them.
- */
-import { formatValue } from "@sigrun/shared/blocks";
-import { bindRaw } from "./context.js";
-import { truncate } from "./width.js";
-import { toneFg } from "./tones.js";
-/** The viewport height in rows. */
-export const LOG_VIEWPORT_ROWS = 10;
-/** The default per-level tones (spec §5.3's table; `debug` mutes). */
-const LEVEL_TONES = {
-    error: "bad",
-    warn: "warn",
-    info: "neutral",
-    debug: "info",
-};
-/** Read the bound lines, dropping malformed entries. */
-function logLines(block, ctx) {
-    const raw = bindRaw(block.lines, ctx);
-    if (!Array.isArray(raw))
-        return [];
-    const out = [];
-    for (const entry of raw) {
-        if (entry === null || typeof entry !== "object" || Array.isArray(entry))
-            continue;
-        const record = entry;
-        if (typeof record.text !== "string")
-            continue;
-        out.push({
-            at: typeof record.at === "number" || typeof record.at === "string" ? record.at : undefined,
-            level: typeof record.level === "string" ? record.level : undefined,
-            text: record.text,
-        });
-    }
-    return out;
-}
-/** The head of one line: `time [level] ` (each part optional). */
-function lineHead(line, ctx) {
-    const at = line.at === undefined
-        ? ""
-        : formatValue(line.at, "time", ctx.locale, ctx.timeZone);
-    const level = line.level === undefined ? "" : `[${line.level}]`;
-    return [at, level].filter((part) => part !== "").join(" ");
-}
-/** `log`: the follow-tail viewport. */
-export class LogComponent {
-    #block;
-    #ctx;
-    /** The first visible row in the stream; `undefined` = the tail. */
-    #offset;
-    constructor(block, ctx) {
-        this.#block = block;
-        this.#ctx = ctx;
-    }
-    /** Every display row: one source line plus its wrapped folds. */
-    #rows(width) {
-        const rows = [];
-        for (const line of logLines(this.#block, this.#ctx)) {
-            const head = lineHead(line, this.#ctx);
-            const text = head === "" ? line.text : `${head} ${line.text}`;
-            const tone = this.#block.tones?.[line.level ?? ""] ??
-                (line.level === undefined ? undefined : LEVEL_TONES[line.level]);
-            const paint = tone === undefined ? (s) => s : toneFg(this.#ctx.theme, tone);
-            if (this.#block.wrap === true) {
-                // Hard-fold at the cell budget (logs are not prose).
-                for (let at = 0; at < text.length; at += Math.max(1, width)) {
-                    rows.push(paint(text.slice(at, at + Math.max(1, width))));
-                }
-            }
-            else {
-                rows.push(truncate(paint(text), width));
-            }
-        }
-        return rows;
-    }
-    render(width) {
-        const rows = this.#rows(width);
-        if (rows.length <= LOG_VIEWPORT_ROWS)
-            return rows;
-        const tail = this.#block.follow === true ? rows.length - LOG_VIEWPORT_ROWS : 0;
-        const start = Math.max(0, Math.min(this.#offset ?? tail, rows.length - LOG_VIEWPORT_ROWS));
-        return rows.slice(start, start + LOG_VIEWPORT_ROWS);
-    }
-    handleInput(data) {
-        // The viewport moves by display rows within the last render's
-        // stream; `render` clamps the offset back into range.
-        const tail = Math.max(0, logLines(this.#block, this.#ctx).length - LOG_VIEWPORT_ROWS);
-        if (data === "\x1b[A") {
-            const current = this.#offset ?? tail;
-            this.#offset = Math.max(0, current - 1);
-        }
-        else if (data === "\x1b[B") {
-            if (this.#offset !== undefined) {
-                this.#offset += 1;
-                if (this.#offset >= tail)
-                    this.#offset = undefined; // re-arm follow
-            }
-        }
-    }
-    invalidate() {
-        // The viewport offset is the only mutable state.
-    }
-}

package/dist/blocks/meter.d.ts

@@ -1,16 +0,0 @@
-/**
- * The `meter` block (UI-blocks spec §5.3): `label value` plus a bar
- * filling the rest of the line — `█`/`░` on a Unicode terminal,
- * `#`/`-` without one. A crossed threshold's tone paints the bar and
- * the value (the LAST crossed threshold wins, matching the webui).
- */
-import type { Component } from "@earendil-works/pi-tui";
-import type { MeterBlock } from "@sigrun/shared/blocks";
-import { type BlockCtx } from "./context.js";
-/** `meter`: one line, `label value bar` exactly `width` cells. */
-export declare function renderMeter(block: MeterBlock, ctx: BlockCtx): Component;
-/**
- * The bare meter bar (no label): `filled`/`empty` cells of the 0–1
- * `level`, for inline cells (the collection table's `meter` column).
- */
-export declare function meterBar(level: number, cells: number, ascii: boolean): string;

package/dist/blocks/meter.js

@@ -1,50 +0,0 @@
-/**
- * The `meter` block (UI-blocks spec §5.3): `label value` plus a bar
- * filling the rest of the line — `█`/`░` on a Unicode terminal,
- * `#`/`-` without one. A crossed threshold's tone paints the bar and
- * the value (the LAST crossed threshold wins, matching the webui).
- */
-import { visibleWidth } from "@earendil-works/pi-tui";
-import { formatValue } from "@sigrun/shared/blocks";
-import { bindRaw, bindText } from "./context.js";
-import { truncate } from "./width.js";
-import { toneFg } from "./tones.js";
-import { Lines } from "./layout.js";
-/** The highest threshold the value crosses, if any. */
-function crossedTone(block, value) {
-    let tone;
-    for (const threshold of block.thresholds ?? []) {
-        if (value >= threshold.at)
-            tone = threshold.tone;
-    }
-    return tone;
-}
-/** `meter`: one line, `label value bar` exactly `width` cells. */
-export function renderMeter(block, ctx) {
-    return new Lines((width) => {
-        const raw = bindRaw(block.value, ctx);
-        const value = typeof raw === "number" ? raw : 0;
-        const min = block.min ?? 0;
-        const max = block.max ?? 1;
-        const label = bindText(block.label, ctx);
-        const text = formatValue(value, block.format, ctx.locale);
-        const head = label === "" ? text : `${label} ${text}`;
-        const tone = crossedTone(block, value);
-        const paint = tone === undefined ? (s) => s : toneFg(ctx.theme, tone);
-        const barCells = Math.max(1, width - visibleWidth(head) - 1);
-        const t = max === min ? 0 : Math.max(0, Math.min(1, (value - min) / (max - min)));
-        const bar = meterBar(t, barCells, !ctx.unicode);
-        return [truncate(`${paint(head)} ${paint(bar)}`, width)];
-    });
-}
-/**
- * The bare meter bar (no label): `filled`/`empty` cells of the 0–1
- * `level`, for inline cells (the collection table's `meter` column).
- */
-export function meterBar(level, cells, ascii) {
-    const fill = ascii ? "#" : "█";
-    const empty = ascii ? "-" : "░";
-    const t = Math.max(0, Math.min(1, level));
-    const filled = Math.floor(cells * t);
-    return fill.repeat(filled) + empty.repeat(cells - filled);
-}

package/dist/blocks/page.d.ts

@@ -1,54 +0,0 @@
-/**
- * The `page` shell (UI-blocks U2 Task 5, spec §5.1/§12.3 — the TUI port
- * of U1's `Page.tsx`): a header line (title, subtitle), sidebar, main
- * and detail regions — the channel draws them, the extension never
- * positions them.
- *
- * - `empty` replaces MAIN ONLY when main's first collection binds to a
- *   missing path, `null` or `[]`; the sidebar and detail keep rendering.
- * - At ≥ 100 columns the sidebar is a focusable pane beside main
- *   (Tab cycles sidebar → main); below 100 it is a toggled overlay
- *   (Tab toggles it; Esc closes it).
- * - `ctrl+s` opens the header switcher (a `choice` field): Up/Down
- *   pick, Enter dispatches a `navigate` action with `{<name>: id}`.
- * - `.` opens the actions menu: Up/Down pick, Enter dispatches the
- *   action, Esc closes. (Access `read` hides edit/answer actions.)
- * - The detail region is a pushed view: Enter on main pushes it, Esc
- *   pops back. At ≥ 100 columns it renders beside main once pushed.
- * - Esc with nothing open resolves at THIS layer (Task 4's host note:
- *   the app-level Esc handling for a surface with no pick-up and no
- *   open menu is the page's "unfocus" — the host routes it; the page
- *   reports `hasOverlay` so the host knows when Esc is already spoken
- *   for).
- */
-import type { Component } from "@earendil-works/pi-tui";
-import type { Block, CollectionBlock, JsonObject, PageBlock } from "@sigrun/shared/blocks";
-import { type BlockCtx } from "./context.js";
-import { type RenderOptions } from "./render.js";
-/** The sidebar-pane minimum (spec §5.1/brief: ≥ 100 columns). */
-export declare const SIDEBAR_PANE_MIN = 100;
-/** The sidebar's pane width at the side-by-side layout. */
-export declare const SIDEBAR_CELLS = 30;
-/** The first `collection` block in a slot list, depth-first (mirrors
- *  U1's `firstCollection`). */
-export declare function firstCollection(blocks: readonly Block[]): CollectionBlock | undefined;
-/** Whether `empty` replaces main (spec §5.1): the first collection's
- *  `items` binding resolves missing, null or an empty array. */
-export declare function isMainEmpty(block: PageBlock, data: JsonObject): boolean;
-export declare class PageComponent implements Component {
-    #private;
-    constructor(block: PageBlock, ctx: BlockCtx, options?: RenderOptions);
-    /** True while an overlay (menu, sidebar drawer, pushed detail) owns Esc. */
-    get hasOverlay(): boolean;
-    render(width: number): string[];
-    handleInput(data: string): void;
-    /** The host tells the page the current pane width's layout class
-     *  (render computes it too; this setter keeps Tab consistent when
-     *  input arrives between renders). */
-    setSideBySide(sideBySide: boolean): void;
-    invalidate(): void;
-    /** Test introspection: the pushed detail / overlay state. */
-    get detailPushed(): boolean;
-    get sidebarOpen(): boolean;
-    get menuKind(): "switcher" | "actions" | null;
-}

package/dist/blocks/page.js

@@ -1,355 +0,0 @@
-/**
- * The `page` shell (UI-blocks U2 Task 5, spec §5.1/§12.3 — the TUI port
- * of U1's `Page.tsx`): a header line (title, subtitle), sidebar, main
- * and detail regions — the channel draws them, the extension never
- * positions them.
- *
- * - `empty` replaces MAIN ONLY when main's first collection binds to a
- *   missing path, `null` or `[]`; the sidebar and detail keep rendering.
- * - At ≥ 100 columns the sidebar is a focusable pane beside main
- *   (Tab cycles sidebar → main); below 100 it is a toggled overlay
- *   (Tab toggles it; Esc closes it).
- * - `ctrl+s` opens the header switcher (a `choice` field): Up/Down
- *   pick, Enter dispatches a `navigate` action with `{<name>: id}`.
- * - `.` opens the actions menu: Up/Down pick, Enter dispatches the
- *   action, Esc closes. (Access `read` hides edit/answer actions.)
- * - The detail region is a pushed view: Enter on main pushes it, Esc
- *   pops back. At ≥ 100 columns it renders beside main once pushed.
- * - Esc with nothing open resolves at THIS layer (Task 4's host note:
- *   the app-level Esc handling for a surface with no pick-up and no
- *   open menu is the page's "unfocus" — the host routes it; the page
- *   reports `hasOverlay` so the host knows when Esc is already spoken
- *   for).
- */
-import { resolvePointer } from "@sigrun/shared/blocks";
-import { bindText } from "./context.js";
-import { iconGlyph } from "./icons.js";
-import { renderBlock } from "./render.js";
-import { pad, truncate, wrapPlain } from "./width.js";
-/** The sidebar-pane minimum (spec §5.1/brief: ≥ 100 columns). */
-export const SIDEBAR_PANE_MIN = 100;
-/** The sidebar's pane width at the side-by-side layout. */
-export const SIDEBAR_CELLS = 30;
-/** The first `collection` block in a slot list, depth-first (mirrors
- *  U1's `firstCollection`). */
-export function firstCollection(blocks) {
-    for (const block of blocks) {
-        if (block.type === "collection")
-            return block;
-        if (block.type === "stack") {
-            const found = firstCollection(block.children);
-            if (found !== undefined)
-                return found;
-        }
-        if (block.type === "section") {
-            const found = firstCollection(block.children.filter((child) => child.type === "collection" ||
-                child.type === "stack" ||
-                child.type === "columns" ||
-                child.type === "grid" ||
-                child.type === "section"));
-            if (found !== undefined)
-                return found;
-        }
-        if (block.type === "columns" || block.type === "grid") {
-            for (const child of block.children) {
-                const found = firstCollection([child.block]);
-                if (found !== undefined)
-                    return found;
-            }
-        }
-    }
-    return undefined;
-}
-/** Whether `empty` replaces main (spec §5.1): the first collection's
- *  `items` binding resolves missing, null or an empty array. */
-export function isMainEmpty(block, data) {
-    if (block.empty === undefined)
-        return false;
-    const collection = firstCollection(block.main);
-    if (collection === undefined)
-        return false;
-    const items = resolvePointer(data, collection.items.$);
-    return !Array.isArray(items) || items.length === 0;
-}
-export class PageComponent {
-    #block;
-    #ctx;
-    #options;
-    /** The open overlay: the switcher or the actions menu. */
-    #menu = null;
-    /** The pushed detail view (spec §12.3: detail → pushed page, Esc back). */
-    #detailPushed = false;
-    /** The sidebar overlay (compact) / focused pane (side-by-side). */
-    #sidebarOpen = false;
-    #region = "main";
-    /** The rendered region components (input forwards to the focused one). */
-    #main;
-    #sidebar;
-    #detail;
-    constructor(block, ctx, options = {}) {
-        this.#block = block;
-        this.#ctx = ctx;
-        this.#options = options;
-        this.#main = block.main.map((child) => renderBlock(child, ctx, options));
-        this.#sidebar = (block.sidebar ?? []).map((child) => renderBlock(child, ctx, options));
-        this.#detail = (block.detail ?? []).map((child) => renderBlock(child, ctx, options));
-    }
-    get #hasSidebar() {
-        return this.#sidebar.length > 0;
-    }
-    get #hasDetail() {
-        return this.#detail.length > 0;
-    }
-    /** True while an overlay (menu, sidebar drawer, pushed detail) owns Esc. */
-    get hasOverlay() {
-        return this.#menu !== null || this.#detailPushed || this.#sidebarOpen;
-    }
-    /** The header line: title (+ subtitle), switcher/actions hints. */
-    #headerLines(width) {
-        const title = bindText(this.#block.title, this.#ctx);
-        const subtitle = bindText(this.#block.subtitle, this.#ctx);
-        const hints = [];
-        if (this.#block.switcher !== undefined)
-            hints.push("ctrl+s switch");
-        if ((this.#block.actions ?? []).length > 0)
-            hints.push(". actions");
-        const hint = hints.length > 0 ? this.#ctx.theme.dim(`  (${hints.join(" · ")})`) : "";
-        const lines = [truncate(`${this.#ctx.theme.bold(title)}${hint}`, width)];
-        if (subtitle !== "")
-            lines.push(truncate(this.#ctx.theme.dim(subtitle), width));
-        return lines;
-    }
-    #emptyLines(width) {
-        const empty = this.#block.empty;
-        if (empty === undefined)
-            return [];
-        const icon = iconGlyph(empty.icon, !this.#ctx.unicode);
-        const lines = [`${icon} ${empty.title}`];
-        if (empty.hint !== undefined && empty.hint !== "") {
-            for (const line of wrapPlain(empty.hint, width))
-                lines.push(this.#ctx.theme.dim(line));
-        }
-        return lines.map((line) => truncate(line, width));
-    }
-    #menuLines(width) {
-        const menu = this.#menu;
-        if (menu === null)
-            return [];
-        if (menu.kind === "switcher") {
-            const field = this.#block.switcher;
-            if (field === undefined)
-                return [];
-            const options = this.#switcherOptions(field);
-            return [
-                truncate(this.#ctx.theme.bold("Switch"), width),
-                ...options.map((option, index) => {
-                    const cursor = index === menu.cursor ? "> " : "  ";
-                    return truncate(`${cursor}${bindText(option.label, this.#ctx) || option.id}`, width);
-                }),
-                truncate(this.#ctx.theme.dim("Enter selects · Esc closes"), width),
-            ];
-        }
-        const actions = this.#visibleActions();
-        return [
-            truncate(this.#ctx.theme.bold("Actions"), width),
-            ...actions.map((button, index) => {
-                const cursor = index === menu.cursor ? "> " : "  ";
-                const icon = button.icon === undefined ? "" : `${iconGlyph(button.icon, !this.#ctx.unicode)} `;
-                return truncate(`${cursor}${icon}${bindText(button.label, this.#ctx) || button.id}`, width);
-            }),
-            truncate(this.#ctx.theme.dim("Enter runs · Esc closes"), width),
-        ];
-    }
-    #switcherOptions(field) {
-        const raw = field.options;
-        if (Array.isArray(raw))
-            return raw;
-        if (typeof raw === "object" && raw !== null && typeof raw.$ === "string") {
-            const resolved = resolvePointer(this.#ctx.data, raw.$);
-            if (Array.isArray(resolved))
-                return resolved;
-        }
-        return [];
-    }
-    /** The header actions the principal may run (access read hides
-     *  edit/answer actions; navigate/open/copy stay — §6.5's read rule). */
-    #visibleActions() {
-        if (this.#ctx.access === "write")
-            return this.#block.actions ?? [];
-        return (this.#block.actions ?? []).filter((button) => button.action.type === "navigate" ||
-            button.action.type === "open" ||
-            button.action.type === "copy");
-    }
-    render(width) {
-        const lines = this.#headerLines(width);
-        if (this.#menu !== null) {
-            return [...lines, ...this.#menuLines(width)];
-        }
-        if (this.#detailPushed && this.#hasDetail) {
-            lines.push(truncate(this.#ctx.theme.dim("Esc back"), width));
-            for (const component of this.#detail) {
-                lines.push(...component.render(width));
-            }
-            return lines;
-        }
-        const empty = isMainEmpty(this.#block, this.#ctx.data);
-        const mainLines = empty
-            ? this.#emptyLines(width)
-            : this.#main.flatMap((component) => component.render(this.#mainWidth(width)));
-        const sideBySide = width >= SIDEBAR_PANE_MIN && this.#hasSidebar;
-        if (!sideBySide) {
-            // Compact/regular below the pane minimum: the sidebar is a
-            // toggled overlay (rendered above main while open).
-            if (this.#sidebarOpen && this.#hasSidebar) {
-                lines.push(truncate(this.#ctx.theme.dim("Esc closes the sidebar"), width));
-                for (const component of this.#sidebar) {
-                    lines.push(...component.render(width));
-                }
-                return lines;
-            }
-            return [...lines, ...mainLines];
-        }
-        // The side-by-side layout: sidebar pane, gutter, main.
-        const sidebarLines = this.#sidebar.flatMap((component) => component.render(SIDEBAR_CELLS));
-        const height = Math.max(sidebarLines.length, mainLines.length);
-        for (let row = 0; row < height; row++) {
-            const left = pad(sidebarLines[row] ?? "", SIDEBAR_CELLS);
-            const right = mainLines[row] ?? "";
-            lines.push(truncate(`${left} ${right}`, width));
-        }
-        return lines;
-    }
-    #mainWidth(width) {
-        return width >= SIDEBAR_PANE_MIN && this.#hasSidebar
-            ? Math.max(1, width - SIDEBAR_CELLS - 1)
-            : width;
-    }
-    handleInput(data) {
-        // An open menu owns the keys.
-        if (this.#menu !== null) {
-            if (data === "\x1b") {
-                this.#menu = null;
-                return;
-            }
-            if (this.#menu.kind === "switcher") {
-                const field = this.#block.switcher;
-                if (field === undefined)
-                    return;
-                const options = this.#switcherOptions(field);
-                if (data === "\x1b[A") {
-                    this.#menu.cursor = Math.max(0, this.#menu.cursor - 1);
-                    return;
-                }
-                if (data === "\x1b[B") {
-                    this.#menu.cursor = Math.min(options.length - 1, this.#menu.cursor + 1);
-                    return;
-                }
-                if (data === "\r") {
-                    const option = options[this.#menu.cursor];
-                    if (option !== undefined) {
-                        // The switcher navigates (spec §5.1): params carry the id.
-                        this.#ctx.dispatch({ type: "navigate", params: { [field.name]: option.id } }, { [field.name]: option.id });
-                    }
-                    this.#menu = null;
-                    return;
-                }
-                return;
-            }
-            const actions = this.#visibleActions();
-            if (data === "\x1b[A") {
-                this.#menu.cursor = Math.max(0, this.#menu.cursor - 1);
-                return;
-            }
-            if (data === "\x1b[B") {
-                this.#menu.cursor = Math.min(actions.length - 1, this.#menu.cursor + 1);
-                return;
-            }
-            if (data === "\r") {
-                const button = actions[this.#menu.cursor];
-                if (button !== undefined)
-                    this.#ctx.dispatch(button.action, {});
-                this.#menu = null;
-                return;
-            }
-            return;
-        }
-        // The pushed detail owns Esc (back).
-        if (this.#detailPushed) {
-            if (data === "\x1b") {
-                this.#detailPushed = false;
-                return;
-            }
-            for (const component of this.#detail)
-                component.handleInput?.(data);
-            return;
-        }
-        // The compact sidebar overlay owns Esc (close).
-        if (this.#sidebarOpen) {
-            if (data === "\x1b") {
-                this.#sidebarOpen = false;
-                return;
-            }
-            for (const component of this.#sidebar)
-                component.handleInput?.(data);
-            return;
-        }
-        if (data === "\x13") {
-            // ctrl+s opens the switcher.
-            if (this.#block.switcher !== undefined) {
-                this.#menu = { kind: "switcher", cursor: 0 };
-            }
-            return;
-        }
-        if (data === ".") {
-            if (this.#visibleActions().length > 0)
-                this.#menu = { kind: "actions", cursor: 0 };
-            return;
-        }
-        if (data === "\t") {
-            // Tab cycles the sidebar (a focused pane at ≥ 100 columns, a
-            // toggled overlay below).
-            if (this.#hasSidebar) {
-                if (this.#sideBySideKnown === true) {
-                    this.#region = this.#region === "sidebar" ? "main" : "sidebar";
-                }
-                else {
-                    this.#sidebarOpen = !this.#sidebarOpen;
-                }
-            }
-            return;
-        }
-        if (data === "\r" && this.#hasDetail && !this.#detailPushed) {
-            this.#detailPushed = true;
-            return;
-        }
-        // Forward to the focused region.
-        const target = this.#region === "sidebar" && this.#hasSidebar ? this.#sidebar : this.#main;
-        for (const component of target)
-            component.handleInput?.(data);
-    }
-    /** Whether the last render was the side-by-side layout (Tab's
-     *  pane-vs-overlay decision — set by the host when it knows; the
-     *  render path computes it from the width). */
-    #sideBySideKnown;
-    /** The host tells the page the current pane width's layout class
-     *  (render computes it too; this setter keeps Tab consistent when
-     *  input arrives between renders). */
-    setSideBySide(sideBySide) {
-        this.#sideBySideKnown = sideBySide;
-    }
-    invalidate() {
-        for (const component of [...this.#main, ...this.#sidebar, ...this.#detail]) {
-            component.invalidate();
-        }
-    }
-    /** Test introspection: the pushed detail / overlay state. */
-    get detailPushed() {
-        return this.#detailPushed;
-    }
-    get sidebarOpen() {
-        return this.#sidebarOpen;
-    }
-    get menuKind() {
-        return this.#menu?.kind ?? null;
-    }
-}

package/dist/blocks/render.d.ts

@@ -1,31 +0,0 @@
-/**
- * The renderer's front door (UI-blocks U2 Task 1): one pi-tui
- * component per block, dispatched on `block.type`. Layout blocks come
- * from `layout.ts`, the simple content blocks from `content.ts`; later
- * tasks slot their blocks into the same dispatch.
- *
- * - `visibleAt` (spec §12.2) gates here so every block inherits it:
- *   `atLeast:regular` renders nothing in a compact pane. An unknown
- *   condition fails visible, matching §4.4's lean (a newer spec's
- *   blocks stay on screen).
- * - A type this client can't render yet (spec §4.4) shows the block's
- *   `fallback` text plus "Not supported in this client" — never
- *   dropped silently.
- */
-import type { Component } from "@earendil-works/pi-tui";
-import type { Block } from "@sigrun/shared/blocks";
-import { type BlockCtx } from "./context.js";
-import type { ImageOptions } from "./image.js";
-export { widthClassOf } from "./width.js";
-export type { WidthClass } from "./width.js";
-export type { BlockCtx, ViewState } from "./context.js";
-export type { ImageOptions } from "./image.js";
-/** The fallback notice (spec §4.4's exact words). */
-export declare const NOT_SUPPORTED = "Not supported in this client";
-/** The seams `renderBlock` threads to the blocks that need them. */
-export type RenderOptions = ImageOptions & {
-    /** Whether the form sits in an interaction placement (§9.1 stepper). */
-    interaction?: boolean;
-};
-/** Render any block as a pi-tui component (the renderer's dispatch). */
-export declare function renderBlock(block: Block, ctx: BlockCtx, options?: RenderOptions): Component;