import type { ColorSchemeMode } from "@charcuterie/logic";
import type { ControlSize, IntentName } from "@charcuterie/tokens";
import type { ReactNode } from "react";
import type { IntentAppearance } from "../intentStyles.ts";
/**
 * One `ReactNode` per mode. The library ships **no icons** — lucide
 * (ISC) is the fleet recommendation — so an app passes its own
 * `Sun` / `Moon` / `Monitor`, exactly as `IconButton` takes its
 * glyph as `children`
 * ([decision](../../../../docs/decisions/2026-07-29-ship-no-icons-and-no-symbol-glyphs.md)).
 */
export type ColorSchemeIcons = Record<ColorSchemeMode, ReactNode>;
export type ColorSchemeToggleProps = {
    appearance?: IntentAppearance;
    className?: string;
    icons: ColorSchemeIcons;
    /**
     * The intent (tone) forwarded to the underlying `IconButton` — the
     * same union `Button`/`IconButton` accept. **Defaults to `neutral`**,
     * not `accent`: a scheme switcher is toolbar chrome, so its ghost
     * hover reads as `hover:bg-intent-neutral-surface` and its icon as
     * `text-intent-neutral-content` rather than accent-violet. Pass
     * `intent="accent"` (or any tone) to make it an accent action.
     */
    intent?: IntentName;
    isDisabled?: boolean;
    /**
     * Builds the accessible name from the current and next mode.
     * Default announces the current mode and where a press goes —
     * "Colour scheme: dark. Activate to switch to system." — so the
     * name updates as the control cycles and
     * `getByRole("button", { name: /colour scheme/i })` resolves.
     */
    label?: (mode: ColorSchemeMode, nextMode: ColorSchemeMode) => string;
    mode: ColorSchemeMode;
    /**
     * Called with the next mode on activation. **Controlled**: this
     * component stores nothing — it renders `mode` and reports intent,
     * which is what keeps it free of `matchMedia`/`document` and
     * usable in any runtime. `<ColorSchemeSwitcher>` wires this to the
     * `useColorScheme` hook; a plain consumer wires it to its own
     * state.
     */
    onCycle: (nextMode: ColorSchemeMode) => void;
    order?: readonly ColorSchemeMode[];
    size?: ControlSize;
};
/**
 * The cycling colour-scheme button — light → dark → system → light.
 *
 * Layer 2 of the three: presentational and controlled, with no
 * browser coupling. It is an `IconButton`, so it inherits the one
 * rule that makes the fleet agent-drivable — a glyph is not a name,
 * and this control's name states the current mode rather than
 * leaving a screen reader to read a sun path as nothing.
 *
 * A *segmented* all-three-visible form was considered and deferred
 * (owner chose cycling-only, 2026-08-03); `icons` and `order` are
 * shaped so a `ColorSchemePicker` could join later without changing
 * this API.
 */
export declare const ColorSchemeToggle: ({ appearance, className, icons, intent, isDisabled, label, mode, onCycle, order, size, }: ColorSchemeToggleProps) => ReactNode;
//# sourceMappingURL=ColorSchemeToggle.d.ts.map