import type { CategoricalIndex, ControlSize } from "@charcuterie/tokens";
import type { ReactNode } from "react";
export type ActionTileItem = {
    /**
     * Which of the ten hues this tile wears, overriding the one its
     * position would have given it.
     *
     * Reach for it when a tile's colour means something outside the
     * set — a destination that is red everywhere else in the app, a
     * pair that must not drift apart when a third tile is inserted
     * between them. An overridden tile keeps its hue and the rest go
     * on walking `CATEGORICAL_SEQUENCE` from their own positions, so
     * naming one does not force naming all of them.
     *
     * Ignored when the set is `accent="none"`.
     */
    categorical?: CategoricalIndex;
    /**
     * A line of help under the name. Drawn one step down the type ramp
     * in `content-muted`, **inside** the tile — so `getByRole` computes
     * it into the accessible name. A hint a screen reader never reads
     * is a hint half the audience does not have.
     */
    hint?: ReactNode;
    /**
     * Makes this tile a real `<a href>`: middle-click, ctrl-click,
     * "open in new tab", "copy link address" and the status bar all
     * come from the element rather than from the paint. Routed through
     * the injected `RouterLink` when the destination is same-origin and
     * not a fragment.
     *
     * Without one, the tile is a `<button>` that calls the set's
     * `onChoose`. A set may mix the two.
     */
    href?: string;
    /**
     * Leading content, drawn **beside** the name rather than above it.
     * A glyph, a `Badge`, a count.
     *
     * Takes the tile's hue, so an app passes a `stroke="currentColor"`
     * path and states no colour of its own. Size is the app's: around
     * 22px at `md` and 30px at `lg` reads the way the fleet's
     * hand-rolled tool cards did.
     *
     * `aria-hidden` by construction: the name it sits beside is inside
     * the same tile, so an announced icon is the label read twice.
     */
    icon?: ReactNode;
    isDisabled?: boolean;
    /** Opens in a new tab, and says so to a screen reader. `href` only. */
    isExternal?: boolean;
    label: ReactNode;
    /**
     * Identity. The React key, and what `onChoose` is handed.
     *
     * Required even on a tile that navigates, so a set can mix the two
     * without one half losing its key — the same reason `RadioItem`
     * carries one.
     */
    value: string;
};
/**
 * Where a tile's colour comes from.
 *
 *  - `auto` — the set walks the ten-hue categorical palette in
 *    order, so eight tiles get eight colours and no call site does
 *    any work. An item may still name its own with `categorical`.
 *  - `none` — no bar, no hue, and the neutral `border-strong`
 *    hover every other box uses.
 */
export type ActionTilesAccent = "auto" | "none";
export type ActionTilesProps = {
    /**
     * Whether the set colours itself. `auto` by default — see
     * {@link ActionTilesAccent}.
     */
    accent?: ActionTilesAccent;
    className?: string;
    items: readonly ActionTileItem[];
    /** The set's accessible name. Required. */
    label: string;
    /**
     * The narrowest a tile track may be, in CSS px.
     *
     * It is the grid's floor and not the tile's width: tracks below it
     * are not created, and the ones that are share the row evenly.
     */
    minTileInlineSize?: number;
    /** Fired by a tile that carries no `href`. */
    onChoose?: (value: string) => void;
    /** What `isExternal` announces. Not shown. */
    newTabLabel?: string;
    size?: ControlSize;
};
/**
 * A set of ACTIONS drawn as tiles — a bordered card carrying a
 * colour bar, an icon beside its name, and a line of help, in a
 * grid that gains columns with its container.
 *
 * This is `RadioGroup`'s `itemShape="tile"` with the radio taken
 * away. The
 * [2026-08-25 record](../../../../docs/decisions/2026-08-25-a-choice-tile-is-a-radiogroup-shape-not-a-third-component.md)
 * that made the choice tile a `RadioGroup` shape named this case
 * under *"What this deliberately does not cover"* — mux-magic's "Pick
 * a tool" tiles are `<a href>` and points-market's are `<Link>`, and
 * *"a link is not a radio, and giving one `aria-checked` would be
 * worse than the paint it replaced"*. So the box is shared through
 * `tileStyles.ts` and nothing else is.
 *
 * ### Which of the two you want
 *
 * Ask what a press does.
 *
 *  - It **records a value** the user will then submit, or that
 *    filters what is below it — `RadioGroup itemShape="tile"`. The
 *    set announces "3 of 6", the arrow keys move the choice, and one
 *    tile stays selected.
 *  - It **goes somewhere or starts something** — this. Nothing stays
 *    selected, because nothing was chosen: the page moved on. Tab
 *    reaches each tile, Enter and Space press it, and a `href` tile
 *    is a real anchor.
 *
 * A first step that opens the next step is the second kind, which is
 * why QueuePilot's "Queue type" chooser is here and its Tonight
 * activity filter is not.
 *
 * ### The colour is the point, and it is not decoration
 *
 * The first version of this component was neutral, and the owner's
 * verdict on it was *"very boring, not colorful"*. Three apps had
 * already answered the question themselves — mux-magic, Gallery
 * Downloader and points-market all colour their tiles by hand — so
 * the paint is now the library's and every one of them can stop.
 *
 * A tile wears a **bar down its leading edge**, drawn by `Card`'s
 * accent-edge pseudo-element so a tile and a card on the same page
 * are the same bar rather than two that nearly match. Its icon takes
 * the same hue, and the box hovers in it too. The hue comes from the
 * ten-wide categorical palette, walked in `CATEGORICAL_SEQUENCE`
 * rather than 1..10 — the ring is hue-ordered for the swatch
 * picker's sake, so taking it in order would hand a two-tile set
 * red and orange. The walk starts on Teal and Purple. A set of
 * eight needs no colour props at all. See
 * [the tile paint record](../../../../docs/decisions/2026-09-02-an-action-tile-is-coloured-and-the-icon-sits-beside-the-name.md)
 * for the four other paints that were drawn and rejected.
 *
 * `categorical` and not `intent`, for the reason
 * [`cardAccentEdge.ts`](../Card/cardAccentEdge.ts) gives: an intent
 * is a *claim* — `danger` says what happens if you press the thing —
 * and "Builder" beside "Jobs" is making no claim about either. Ten
 * numbered hues say only "these are different from each other",
 * which is exactly what a tile set means.
 *
 * ### Why this is not a `Button` with a `className`
 *
 * A `Button` is sized by `h-(--control-height-md)` and carries **no
 * block padding at all** — one line of text, by contract. An app that
 * wants a wrapping two-line card reaches for `height: auto`, which
 * deletes the height and leaves `padding: 0` down the block axis:
 * a title flush against the top border and a description flush
 * against the bottom one, with nothing to report it. That shipped in
 * QueuePilot and is what this component exists to have made
 * impossible.
 *
 * ### `role="group"`, and no roving tabindex
 *
 * These are ordinary buttons and anchors, so the platform already
 * owns the keyboard: Tab reaches each one, Enter and Space press it,
 * and a link opens in a new tab on ctrl-click. A radio group borrows
 * one tab stop and moves the choice with the arrow keys because
 * exactly one of its options is true at a time; nothing here is
 * true, so imposing that model would only cost a keyboard user the
 * ability to Tab to the second tile.
 */
export declare const ActionTiles: ({ accent, className, items, label, minTileInlineSize, newTabLabel, onChoose, size, }: ActionTilesProps) => ReactNode;
//# sourceMappingURL=ActionTiles.d.ts.map