import type { ElementType, ReactNode } from "react";
import type { ControlSize } from "../../Theme/tokens/primitives/controlSizes";
/** Visual treatment; follows the repo's solid/subtle/outline/ghost/line vocabulary. Defaults to "line". */
export type TabsVariant = "solid" | "subtle" | "outline" | "ghost" | "line";
/** Arrow-key direction and tablist layout axis. */
export type TabsOrientation = "horizontal" | "vertical";
/** "automatic" (default) selects a tab as focus reaches it; "manual" only selects on Enter/Space/click. */
export type TabActivationMode = "automatic" | "manual";
/** Category colour for the selected tab's ink/fill and its count badge. */
export type TabsColorScheme = "primary" | "secondary" | "tertiary" | "gray" | "red" | "orange" | "yellow" | "green" | "teal" | "blue" | "cyan" | "purple" | "pink";
/** One entry in the declarative `items` API; omit `content` when panels are rendered elsewhere (e.g. a route). With `href` on every item it is a navigation link, not a tab. */
export interface TabItem {
    /** Unique value of the tab; what `value` and `onChange` use. */
    id: string;
    /** Tab text or node. */
    label: ReactNode;
    /** Decorative — rendered aria-hidden, never a substitute for `label`. */
    icon?: ReactNode;
    /** Renders a soft count badge after the label; omit for no badge. */
    count?: number | string;
    /** Dims the tab and makes it unselectable; also skipped when picking the default selection. */
    isDisabled?: boolean;
    /** Panel body for this tab; if no item in `items` sets one, no panel container is rendered at all. */
    content?: ReactNode;
    /** Makes the item a link. When every item has one, `Tabs` renders a `<nav>` of links instead of a tablist. */
    href?: string;
}
/** Themed, accessible tabs. Pass `items` for the declarative API, or `children` (TabList/Tab/TabPanels/TabPanel) to compose by hand. */
export interface TabsProps {
    /** Declarative API — builds TabList/Tab/TabPanels/TabPanel for you. Ignored when `children` is passed. */
    items?: TabItem[];
    /** Composed API — render TabList/Tab/TabPanels/TabPanel yourself; `items` is ignored. */
    children?: ReactNode;
    /** Controlled selected tab id; pass with `onChange`. */
    value?: string;
    /** Uncontrolled initial tab id; with `items` and neither this nor `value`, the first enabled tab is selected. */
    defaultValue?: string;
    /** Called with the new tab value on selection, controlled or not. */
    onChange?: (value: string) => void;
    /** Visual treatment; defaults to "line". */
    variant?: TabsVariant;
    /** Defaults to "sm", on the button control scale (sm 32 · md 40 · lg 48px), not form fields. */
    size?: ControlSize;
    /** Colour of the selected tab and count badges; defaults to "primary". */
    colorScheme?: TabsColorScheme;
    /** Layout axis and arrow-key direction; defaults to "horizontal". */
    orientation?: TabsOrientation;
    /** Whether focus alone selects a tab; defaults to "automatic". */
    activationMode?: TabActivationMode;
    /** Keeps an unselected panel unmounted until its tab is first selected; stays mounted after that. */
    isLazy?: boolean;
    /** Tabs share the tablist's width/height equally instead of sizing to their own content. */
    isFitted?: boolean;
    /** Stable id prefix for the generated tab/panel ids; auto-generated via useId() when omitted. */
    id?: string;
    /** Accessible name of the tablist, or of the nav in link mode. */
    "aria-label"?: string;
    /** Id of an element that names the tablist, or the nav in link mode. */
    "aria-labelledby"?: string;
    /** Anchor-like component for `href` items, e.g. a router link. Defaults to "a"; link mode only. */
    linkAs?: ElementType;
}
/** Composed-API tablist wrapper; renders `Tab` children and owns keyboard navigation + overflow scroll. */
export interface TabListProps {
    /** `Tab` elements in order. */
    children: ReactNode;
    /** Accessible name of the tablist. */
    "aria-label"?: string;
    /** Id of an element that names the tablist. */
    "aria-labelledby"?: string;
}
/** Composed-API single tab button; read from the nearest `<Tabs>` context for variant/size/colours. */
export interface TabProps {
    /** Must match a TabPanel's `value` to be controllable/reachable by aria-controls. */
    value: string;
    /** Tab label. */
    children: ReactNode;
    /** Decorative — rendered aria-hidden. */
    icon?: ReactNode;
    /** Soft count badge after the label; omit for none. */
    count?: number | string;
    /** Dims the tab and makes it unselectable. */
    isDisabled?: boolean;
}
/** Composed-API panel wrapper; renders `TabPanel` children and registers that this Tabs instance has panels. */
export interface TabPanelsProps {
    /** `TabPanel` elements. */
    children: ReactNode;
}
/** Composed-API panel body; hidden (and, with isLazy, unmounted) whenever its `value` isn't selected. */
export interface TabPanelProps {
    /** Must match the Tab's `value` this panel belongs to. */
    value: string;
    /** Panel content. */
    children?: ReactNode;
}