import type { ComponentPropsWithRef, ReactNode } from "react";
export type EmptyStateSize = "md" | "sm";
export type EmptyStateProps = Omit<ComponentPropsWithRef<"div">, "children"> & {
    /** Buttons, usually. Rendered under the description. */
    action?: ReactNode;
    description?: ReactNode;
    /**
     * A real heading element, and the level is the caller's because
     * only the caller knows what it sits under. Getting this wrong
     * breaks a screen reader's document outline, which is how the
     * fleet's `<h2>`-with-a-`<button>`-inside pattern happened.
     *
     * The full `2–6` range because the cap is a guess about document
     * structure the consumer knows better than we do — an empty state
     * nested inside an already-deep section needs `5` or `6`, and
     * `` `h${headingLevel}` `` never cared about the upper bound.
     */
    headingLevel?: 2 | 3 | 4 | 5 | 6;
    heading: string;
    icon?: ReactNode;
    size?: EmptyStateSize;
};
/**
 * **Six repos, eleven-plus copies** — plex-channels alone has five
 * `li.empty`s and castkit six `.idle`s — and not one of them is a
 * component. Every copy is a bare string in a `<div>`, so "no
 * results" and "not started yet" and "the socket died" all look
 * identical, and none of them is findable by role.
 *
 * Designed fresh rather than ported: the two repos that had a real
 * `EmptyState` with typed variants were bambuddy and spoolbuddy,
 * which are upstream projects rather than Kevin's code, so that
 * evidence was withdrawn from the plan.
 *
 * The shape is deliberately flat — icon, heading, description,
 * action — with **no variant enum**. An "empty" and an "error" empty
 * state differ in wording and in whether there is a retry button,
 * both of which are props already; a `variant="error"` that only
 * changes a colour invites callers to encode meaning in the colour
 * alone, which is the one thing a colour cannot carry.
 *
 * The heading is what makes it agent-drivable:
 * `getByRole("heading", { name: "No discs queued" })` works, where
 * `getByText` against eleven copies of "Nothing here" does not.
 */
export declare const EmptyState: ({ action, className, description, heading, headingLevel, icon, size, ...divProps }: EmptyStateProps) => ReactNode;
//# sourceMappingURL=EmptyState.d.ts.map