/** CardList — one branded card per record, its fields as label/value rows (W2 §The Kit). */
import type { ReactNode } from "react";
import { type KitDensity, type KitStyled } from "../tokens.js";
export interface CardField {
    key: string;
    label?: string;
    /** Kit elements rendered as this field's VALUE (the label stays). Written as a
     *  function of the item, it arrives as ONE element per item in `items` order. */
    cell?: ReactNode | readonly ReactNode[];
}
export interface CardListProps extends KitStyled {
    /** Items from a tool call. */
    items: Array<Record<string, unknown>>;
    /** Field used as each card's title. */
    titleField?: string;
    /** Optional field rendered as a status pill (EnumBadge). */
    badgeField?: string;
    /** Fields shown as label/value rows; a bare string is its key. Omitted, they
     *  are the item's own keys, less the two the card already shows. */
    fields?: Array<CardField | string>;
    /** Columns of cards (defaults to a responsive auto-fit grid). */
    columns?: number;
    /** Text shown when there are no items. */
    emptyState?: string;
    /** Kit elements shown in place of `emptyState` when there are no items. */
    empty?: ReactNode;
    /** Kit elements in a row above the cards — what the list as a whole does. */
    actions?: ReactNode;
    /** Spacing scale for this list's subtree. */
    density?: KitDensity;
}
export declare function CardList({ items: rawItems, titleField, badgeField, fields: rawFields, columns, emptyState, empty, actions, density, style }: CardListProps): import("react").JSX.Element;