import type { FieldDef } from "./schema.js";
/**
 * Render a list of items as a TOON table with the given field schema.
 * Returns a raw TOON string (not wrapped in an object) so it can be
 * composed into a larger output.
 *
 * Output shape:
 *   <name>[N]{col1,col2,col3}:
 *     val1,val2,val3
 *     val1,val2,val3
 */
export declare function renderList(name: string, items: Array<Record<string, unknown>>, schema: FieldDef[]): string;
/**
 * Render a simple key/value object as TOON.
 */
export declare function renderObject(value: Record<string, unknown>): string;
/**
 * Render a help array. Returns empty string for empty help to keep output
 * clean.
 */
export declare function renderHelp(suggestions: string[]): string;
/**
 * Join multiple rendered blocks with newlines, dropping empty ones.
 */
export declare function joinBlocks(...blocks: string[]): string;
/**
 * Compose a list response with optional header (e.g. account info),
 * the list itself, and help suggestions. Every block is optional.
 */
export declare function renderListResponse(options: {
    header?: Record<string, unknown>;
    name: string;
    items: Array<Record<string, unknown>>;
    schema: FieldDef[];
    suggestions?: string[];
    /** Emitted after the header but before the list — e.g. "count: 3 of 47 total". */
    summary?: Record<string, unknown>;
    /** Message when items is empty — replaces the list block entirely. */
    emptyMessage?: string;
}): string;