@flood-md/react 0.2.2 → 0.2.4

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { type ButtonHTMLAttributes, type InputHTMLAttributes, type TextareaHTMLAttributes, type AnchorHTMLAttributes, type ReactNode, type HTMLAttributes } from "react";
+import { type ButtonHTMLAttributes, type InputHTMLAttributes, type TextareaHTMLAttributes, type SelectHTMLAttributes, type AnchorHTMLAttributes, type ReactNode, type HTMLAttributes, type CSSProperties, type LabelHTMLAttributes, type FieldsetHTMLAttributes, type RefCallback, type RefObject, type TableHTMLAttributes, type ImgHTMLAttributes } from "react";
 export type ControlSize = "2xs" | "xs" | "sm" | "md" | "lg" | "xl" | "2xl";
 export interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
     variant?: "solid" | "subtle" | "outline" | "ghost";
@@ -6,39 +6,389 @@ export interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
     loading?: boolean;
 }
 export declare const Button: import("react").ForwardRefExoticComponent<ButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
+export type FieldStatus = "error" | "warning" | "success" | "info";
+export type ContentSize = "sm" | "md" | "lg";
+export interface KbdProps extends HTMLAttributes<HTMLElement> {
+    size?: ContentSize;
+}
+/** @since 0.2.4 */
+export declare const Kbd: import("react").ForwardRefExoticComponent<KbdProps & import("react").RefAttributes<HTMLElement>>;
+export interface ToolbarProps extends Omit<HTMLAttributes<HTMLDivElement>, "role"> {
+    label: string;
+    orientation?: "horizontal" | "vertical";
+    loop?: boolean;
+}
+/** @since 0.2.4 */
+export declare const Toolbar: import("react").ForwardRefExoticComponent<ToolbarProps & import("react").RefAttributes<HTMLDivElement>>;
+export type DataDensity = "compact" | "comfortable";
+export interface DescriptionItem {
+    id: string;
+    term: string;
+    description: ReactNode;
+}
+export interface DescriptionListProps extends Omit<HTMLAttributes<HTMLDListElement>, "children"> {
+    items: readonly DescriptionItem[];
+    layout?: "inline" | "stacked";
+    density?: DataDensity;
+    dividers?: boolean;
+}
+/** @since 0.2.4 */
+export declare const DescriptionList: import("react").ForwardRefExoticComponent<DescriptionListProps & import("react").RefAttributes<HTMLDListElement>>;
+export interface TableProps extends Omit<TableHTMLAttributes<HTMLTableElement>, "children"> {
+    caption: string;
+    children: ReactNode;
+    hideCaption?: boolean;
+    density?: DataDensity;
+    striped?: boolean;
+    scrollLabel?: string;
+}
+/** @since 0.2.4 */
+export declare const Table: import("react").ForwardRefExoticComponent<TableProps & import("react").RefAttributes<HTMLTableElement>>;
+export type SemanticTone = "neutral" | "accent" | "error" | "warning" | "success" | "info";
+export type BadgeTone = SemanticTone;
+export interface BadgeProps extends HTMLAttributes<HTMLSpanElement> {
+    size?: ContentSize;
+    tone?: BadgeTone;
+    variant?: "subtle" | "outline";
+}
+/** @since 0.2.4 */
+export declare const Badge: import("react").ForwardRefExoticComponent<BadgeProps & import("react").RefAttributes<HTMLSpanElement>>;
+export interface SpinnerProps extends Omit<HTMLAttributes<HTMLSpanElement>, "children" | "role" | "aria-label" | "aria-hidden"> {
+    size?: ContentSize;
+    label?: string;
+    decorative?: boolean;
+}
+/** @since 0.2.4 */
+export declare const Spinner: import("react").ForwardRefExoticComponent<SpinnerProps & import("react").RefAttributes<HTMLSpanElement>>;
+export interface SkeletonProps extends Omit<HTMLAttributes<HTMLSpanElement>, "children" | "role" | "tabIndex" | "aria-label" | "aria-hidden"> {
+    shape?: "text" | "rounded" | "circle";
+    width?: CSSProperties["width"];
+    height?: CSSProperties["height"];
+    animate?: boolean;
+}
+/** @since 0.2.4 */
+export declare const Skeleton: import("react").ForwardRefExoticComponent<SkeletonProps & import("react").RefAttributes<HTMLSpanElement>>;
+export interface AvatarProps extends Omit<HTMLAttributes<HTMLSpanElement>, "children" | "role" | "aria-label" | "aria-hidden"> {
+    name: string;
+    src?: string;
+    fallback?: string;
+    size?: ContentSize;
+    shape?: "circle" | "rounded";
+    decorative?: boolean;
+}
+/** @since 0.2.4 */
+export declare const Avatar: import("react").ForwardRefExoticComponent<AvatarProps & import("react").RefAttributes<HTMLSpanElement>>;
+export interface ProgressProps extends Omit<HTMLAttributes<HTMLDivElement>, "children" | "role"> {
+    label: string;
+    value?: number;
+    max?: number;
+    valueText?: string;
+    size?: ContentSize;
+    tone?: SemanticTone;
+    hideLabel?: boolean;
+}
+/** @since 0.2.4 */
+export declare const Progress: import("react").ForwardRefExoticComponent<ProgressProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface MeterProps extends Omit<ProgressProps, "value"> {
+    value: number;
+    min?: number;
+}
+/** @since 0.2.4 */
+export declare const Meter: import("react").ForwardRefExoticComponent<MeterProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface AlertProps extends Omit<HTMLAttributes<HTMLDivElement>, "title" | "role" | "aria-live"> {
+    title?: string;
+    tone?: "neutral" | FieldStatus;
+    icon?: ReactNode;
+    announcement?: "off" | "polite" | "assertive";
+}
+/** @since 0.2.4 */
+export declare const Alert: import("react").ForwardRefExoticComponent<AlertProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface TabItem {
+    value: string;
+    label: string;
+    content: ReactNode;
+    icon?: ReactNode;
+    disabled?: boolean;
+}
+export interface TabsProps extends Omit<HTMLAttributes<HTMLDivElement>, "children" | "defaultValue" | "onChange"> {
+    label: string;
+    items: readonly TabItem[];
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+    activationMode?: "automatic" | "manual";
+    orientation?: "horizontal" | "vertical";
+    controlSize?: "sm" | "md" | "lg" | "xl";
+    disabled?: boolean;
+    iconOnly?: boolean;
+}
+export declare const Tabs: import("react").ForwardRefExoticComponent<TabsProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface BreadcrumbItem {
+    label: string;
+    href?: string;
+}
+export interface BreadcrumbProps extends Omit<HTMLAttributes<HTMLElement>, "children"> {
+    items: readonly BreadcrumbItem[];
+    label?: string;
+    separator?: string;
+}
+export declare const Breadcrumb: import("react").ForwardRefExoticComponent<BreadcrumbProps & import("react").RefAttributes<HTMLElement>>;
+export interface PaginationProps extends Omit<HTMLAttributes<HTMLElement>, "children" | "onChange"> {
+    page: number;
+    pageCount: number;
+    onPageChange?: (page: number) => void;
+    getHref?: (page: number) => string;
+    siblingCount?: 0 | 1 | 2;
+    controlSize?: "sm" | "md" | "lg" | "xl";
+    disabled?: boolean;
+    label?: string;
+    previousLabel?: string;
+    nextLabel?: string;
+    pageLabel?: (page: number) => string;
+}
+export declare const Pagination: import("react").ForwardRefExoticComponent<PaginationProps & import("react").RefAttributes<HTMLElement>>;
+export interface OverlayTriggerProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    ref: RefCallback<HTMLButtonElement>;
+}
+export interface MenuActionItem {
+    id: string;
+    type?: "item";
+    label: string;
+    icon?: ReactNode;
+    shortcut?: string;
+    disabled?: boolean;
+    tone?: "default" | "danger";
+}
+export interface MenuSeparator {
+    id: string;
+    type: "separator";
+}
+export type MenuItem = MenuActionItem | MenuSeparator;
+export interface MenuProps extends Omit<HTMLAttributes<HTMLDivElement>, "children" | "role"> {
+    label: string;
+    trigger: (props: OverlayTriggerProps) => ReactNode;
+    items: readonly MenuItem[];
+    onAction?: (id: string) => void;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    disabled?: boolean;
+    side?: "top" | "bottom" | "left" | "right";
+    align?: "start" | "center" | "end";
+    controlSize?: "sm" | "md" | "lg" | "xl";
+}
+/** @since 0.2.4 */
+export declare const Menu: import("react").ForwardRefExoticComponent<MenuProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface TooltipProps extends Omit<HTMLAttributes<HTMLDivElement>, "children" | "content" | "title" | "role"> {
+    content: string;
+    trigger: (props: OverlayTriggerProps) => ReactNode;
+    side?: "top" | "bottom" | "left" | "right";
+    align?: "start" | "center" | "end";
+    delay?: number;
+    disabled?: boolean;
+}
+export declare const Tooltip: import("react").ForwardRefExoticComponent<TooltipProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface PopoverProps extends Omit<HTMLAttributes<HTMLDivElement>, "children" | "title" | "role"> {
+    title: string;
+    trigger: (props: OverlayTriggerProps) => ReactNode;
+    children?: ReactNode;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    disabled?: boolean;
+    side?: "top" | "bottom" | "left" | "right";
+    align?: "start" | "center" | "end";
+    closeLabel?: string;
+    initialFocusRef?: RefObject<HTMLElement | null>;
+}
+export declare const Popover: import("react").ForwardRefExoticComponent<PopoverProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface DialogProps extends Omit<HTMLAttributes<HTMLDialogElement>, "children" | "title" | "role"> {
+    title: string;
+    description?: string;
+    trigger: (props: OverlayTriggerProps) => ReactNode;
+    children?: ReactNode;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    disabled?: boolean;
+    closeLabel?: string;
+    closeOnOutsideClick?: boolean;
+    initialFocusRef?: RefObject<HTMLElement | null>;
+}
+export declare const Dialog: import("react").ForwardRefExoticComponent<DialogProps & import("react").RefAttributes<HTMLDialogElement>>;
+export interface CollapsibleProps extends Omit<HTMLAttributes<HTMLDivElement>, "title" | "onChange"> {
+    title: string;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    disabled?: boolean;
+    controlSize?: "sm" | "md" | "lg" | "xl";
+    headingLevel?: 2 | 3 | 4 | 5 | 6;
+}
+export declare const Collapsible: import("react").ForwardRefExoticComponent<CollapsibleProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface AccordionItem {
+    value: string;
+    title: string;
+    content: ReactNode;
+    disabled?: boolean;
+}
+export interface AccordionProps extends Omit<HTMLAttributes<HTMLDivElement>, "children" | "role" | "defaultValue" | "onChange"> {
+    label: string;
+    items: readonly AccordionItem[];
+    expansionMode?: "single" | "multiple";
+    value?: readonly string[];
+    defaultValue?: readonly string[];
+    onValueChange?: (value: string[]) => void;
+    disabled?: boolean;
+    controlSize?: "sm" | "md" | "lg" | "xl";
+    headingLevel?: 2 | 3 | 4 | 5 | 6;
+}
+export declare const Accordion: import("react").ForwardRefExoticComponent<AccordionProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface ToggleProps extends Omit<ButtonProps, "aria-pressed" | "type" | "role" | "defaultValue"> {
+    pressed?: boolean;
+    defaultPressed?: boolean;
+    onPressedChange?: (pressed: boolean) => void;
+    iconOnly?: boolean;
+}
+/** A native toggle button; its accessible name stays stable when pressed. */
+export declare const Toggle: import("react").ForwardRefExoticComponent<ToggleProps & import("react").RefAttributes<HTMLButtonElement>>;
+export interface ToggleOption {
+    value: string;
+    label: string;
+    icon?: ReactNode;
+    disabled?: boolean;
+}
+export interface ToggleGroupProps extends Omit<HTMLAttributes<HTMLDivElement>, "role" | "children" | "defaultValue" | "onChange"> {
+    label: string;
+    options: readonly ToggleOption[];
+    selectionMode?: "single" | "multiple";
+    value?: readonly string[];
+    defaultValue?: readonly string[];
+    onValueChange?: (value: string[]) => void;
+    orientation?: "horizontal" | "vertical";
+    size?: ControlSize;
+    variant?: "solid" | "subtle" | "outline" | "ghost";
+    disabled?: boolean;
+    iconOnly?: boolean;
+}
+/** Optional selections exposed as pressed buttons, not radios, tabs or a toolbar. */
+export declare const ToggleGroup: import("react").ForwardRefExoticComponent<ToggleGroupProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface ButtonGroupProps extends Omit<HTMLAttributes<HTMLDivElement>, "role"> {
+    label: string;
+    orientation?: "horizontal" | "vertical";
+}
+/** Connected actions keep their ordinary Tab order; this is not a toolbar. */
+export declare const ButtonGroup: import("react").ForwardRefExoticComponent<ButtonGroupProps & import("react").RefAttributes<HTMLDivElement>>;
 export interface InputProps extends InputHTMLAttributes<HTMLInputElement> {
+    status?: FieldStatus;
     invalid?: boolean;
     controlSize?: "sm" | "md" | "lg" | "xl";
 }
 export declare const Input: import("react").ForwardRefExoticComponent<InputProps & import("react").RefAttributes<HTMLInputElement>>;
+export interface InputGroupProps extends Omit<InputProps, "children" | "type"> {
+    type?: "text" | "email" | "password" | "search" | "tel" | "url" | "number";
+    start?: ReactNode;
+    end?: ReactNode;
+}
+/** One real Input with host-owned logical start/end adornments. Ref and native attributes target the input. */
+export declare const InputGroup: import("react").ForwardRefExoticComponent<InputGroupProps & import("react").RefAttributes<HTMLInputElement>>;
 export interface TextareaProps extends TextareaHTMLAttributes<HTMLTextAreaElement> {
+    status?: FieldStatus;
     invalid?: boolean;
     controlSize?: "sm" | "md" | "lg" | "xl";
 }
 export declare const Textarea: import("react").ForwardRefExoticComponent<TextareaProps & import("react").RefAttributes<HTMLTextAreaElement>>;
+export interface SelectProps extends SelectHTMLAttributes<HTMLSelectElement> {
+    status?: FieldStatus;
+    invalid?: boolean;
+    controlSize?: "sm" | "md" | "lg" | "xl";
+}
+/** Native select and option semantics with an independent visual control size. */
+export declare const Select: import("react").ForwardRefExoticComponent<SelectProps & import("react").RefAttributes<HTMLSelectElement>>;
 export interface ChoiceProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "size"> {
     label: ReactNode;
 }
-export declare const Checkbox: import("react").ForwardRefExoticComponent<ChoiceProps & import("react").RefAttributes<HTMLInputElement>>;
+export interface CheckboxProps extends ChoiceProps {
+    indeterminate?: boolean;
+}
+export declare const Checkbox: import("react").ForwardRefExoticComponent<CheckboxProps & import("react").RefAttributes<HTMLInputElement>>;
 export declare const Radio: import("react").ForwardRefExoticComponent<ChoiceProps & import("react").RefAttributes<HTMLInputElement>>;
 export declare const Switch: import("react").ForwardRefExoticComponent<ChoiceProps & import("react").RefAttributes<HTMLInputElement>>;
+export interface LabelProps extends LabelHTMLAttributes<HTMLLabelElement> {
+    required?: boolean;
+}
+/** A native label; the required marker never substitutes for the control's required prop. */
+export declare const Label: import("react").ForwardRefExoticComponent<LabelProps & import("react").RefAttributes<HTMLLabelElement>>;
+export interface FieldsetProps extends FieldsetHTMLAttributes<HTMLFieldSetElement> {
+    legend: ReactNode;
+    /** @since 0.2.3 */
+    hideLabel?: boolean;
+    hint?: ReactNode;
+    error?: ReactNode;
+    message?: ReactNode;
+    status?: FieldStatus;
+}
+/** A native group: disabled, form ownership and nested fieldsets retain browser behavior. */
+export declare const Fieldset: import("react").ForwardRefExoticComponent<FieldsetProps & import("react").RefAttributes<HTMLFieldSetElement>>;
+export interface ChoiceOption {
+    value: string;
+    label: ReactNode;
+    disabled?: boolean;
+}
+export interface RadioGroupProps extends Omit<FieldsetProps, "children" | "defaultValue" | "role"> {
+    name: string;
+    options: readonly ChoiceOption[];
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+    orientation?: "vertical" | "horizontal";
+    required?: boolean;
+}
+export declare const RadioGroup: import("react").ForwardRefExoticComponent<RadioGroupProps & import("react").RefAttributes<HTMLFieldSetElement>>;
+export interface SegmentedControlProps extends Omit<RadioGroupProps, "legend" | "options"> {
+    label: string;
+    options: readonly ToggleOption[];
+    controlSize?: "sm" | "md" | "lg" | "xl";
+    iconOnly?: boolean;
+    fullWidth?: boolean;
+}
+/** A segmented presentation of native single-choice inputs, retaining forms and reset. */
+export declare const SegmentedControl: import("react").ForwardRefExoticComponent<SegmentedControlProps & import("react").RefAttributes<HTMLFieldSetElement>>;
+export interface CheckboxGroupProps extends Omit<FieldsetProps, "children" | "defaultValue" | "role"> {
+    name: string;
+    options: readonly ChoiceOption[];
+    value?: readonly string[];
+    defaultValue?: readonly string[];
+    onValueChange?: (value: string[]) => void;
+    orientation?: "vertical" | "horizontal";
+}
+export declare const CheckboxGroup: import("react").ForwardRefExoticComponent<CheckboxGroupProps & import("react").RefAttributes<HTMLFieldSetElement>>;
 export interface FieldControlProps {
     id: string;
     "aria-describedby"?: string;
     "aria-invalid"?: true;
+    status?: FieldStatus;
     required?: boolean;
 }
 export interface FieldProps {
+    status?: FieldStatus;
+    message?: ReactNode;
     id?: string;
     label: ReactNode;
+    /** @since 0.2.3 */
+    hideLabel?: boolean;
     hint?: ReactNode;
     error?: ReactNode;
     required?: boolean;
     describedBy?: string;
     children: (props: FieldControlProps) => ReactNode;
 }
-export declare function Field({ id: explicitId, label, hint, error, required, describedBy, children, }: FieldProps): import("react").JSX.Element;
-export declare const Link: import("react").ForwardRefExoticComponent<AnchorHTMLAttributes<HTMLAnchorElement> & import("react").RefAttributes<HTMLAnchorElement>>;
+export declare function Field({ status, message, id: explicitId, label, hideLabel, hint, error, required, describedBy, children, }: FieldProps): import("react").JSX.Element;
+export interface LinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
+    variant?: "text" | "solid" | "subtle" | "outline" | "ghost";
+    size?: ControlSize;
+}
+export declare const Link: import("react").ForwardRefExoticComponent<LinkProps & import("react").RefAttributes<HTMLAnchorElement>>;
 /** Explicit opt-in to the dark foundations profile; no global theme mutation. */
 export declare const FloodRoot: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & import("react").RefAttributes<HTMLDivElement>>;
 export interface TextProps extends HTMLAttributes<HTMLElement> {
@@ -66,6 +416,66 @@ export interface SurfaceProps extends HTMLAttributes<HTMLDivElement> {
     padding?: Space;
 }
 export declare const Surface: import("react").ForwardRefExoticComponent<SurfaceProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface ContainerProps extends HTMLAttributes<HTMLDivElement> {
+    size?: "sm" | "md" | "lg" | "full";
+    gutter?: Space;
+}
+/** Centered content with logical gutters; max width includes padding. @since 0.2.4 */
+export declare const Container: import("react").ForwardRefExoticComponent<ContainerProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface GridProps extends HTMLAttributes<HTMLDivElement> {
+    columns?: 1 | 2 | 3 | 4 | 6 | 12;
+    minItemWidth?: string;
+    gap?: Space;
+}
+/** Auto-fit by default; explicit columns retain their count at every width. @since 0.2.4 */
+export declare const Grid: import("react").ForwardRefExoticComponent<GridProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface VisuallyHiddenProps extends HTMLAttributes<HTMLElement> {
+    as?: "span" | "div";
+    focusable?: boolean;
+}
+/** Nonvisual content, with optional reveal when a descendant receives focus. @since 0.2.4 */
+export declare const VisuallyHidden: import("react").ForwardRefExoticComponent<VisuallyHiddenProps & import("react").RefAttributes<HTMLElement>>;
+export interface AspectRatioProps extends HTMLAttributes<HTMLDivElement> {
+    ratio?: number;
+}
+/** Reserve media geometry. Child content may overflow rather than being clipped. @since 0.2.4 */
+export declare const AspectRatio: import("react").ForwardRefExoticComponent<AspectRatioProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface ImageProps extends Omit<ImgHTMLAttributes<HTMLImageElement>, "alt"> {
+    alt: string;
+    fit?: "cover" | "contain";
+}
+/** Native image semantics, explicit alternative text and bounded media fitting. @since 0.2.4 */
+export declare const Image: import("react").ForwardRefExoticComponent<ImageProps & import("react").RefAttributes<HTMLImageElement>>;
+export interface ListProps extends Omit<HTMLAttributes<HTMLUListElement | HTMLOListElement>, "role"> {
+    ordered?: boolean;
+    start?: number;
+    reversed?: boolean;
+    marker?: boolean;
+    gap?: Space;
+}
+/** Native list items supplied by the host; hidden markers retain list semantics. @since 0.2.4 */
+export declare const List: import("react").ForwardRefExoticComponent<ListProps & import("react").RefAttributes<HTMLOListElement | HTMLUListElement>>;
+export interface EmptyStateProps extends Omit<HTMLAttributes<HTMLDivElement>, "title" | "children"> {
+    title: string;
+    description?: ReactNode;
+    icon?: ReactNode;
+    actions?: ReactNode;
+    headingLevel?: 2 | 3 | 4 | 5 | 6;
+    density?: "compact" | "comfortable";
+}
+/** Static empty content, not loading, an error boundary or a live announcement. @since 0.2.4 */
+export declare const EmptyState: import("react").ForwardRefExoticComponent<EmptyStateProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface CardProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
+    title?: ReactNode;
+    description?: ReactNode;
+    actions?: ReactNode;
+    footer?: ReactNode;
+    headingLevel?: 2 | 3 | 4 | 5 | 6;
+    density?: "compact" | "comfortable";
+    elevation?: "default" | "raised";
+}
+/** A structured content surface, not an interactive wrapper. @since 0.2.4 */
+export declare const Card: import("react").ForwardRefExoticComponent<CardProps & import("react").RefAttributes<HTMLDivElement>>;
 export interface IconSlotProps extends HTMLAttributes<HTMLSpanElement> {
     size?: ControlSize;
     label?: string;
@@ -79,7 +489,14 @@ export declare const IconButton: import("react").ForwardRefExoticComponent<IconB
 export declare const Divider: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLHRElement> & import("react").RefAttributes<HTMLHRElement>>;
 export interface CodeSnippetProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
     code: string;
+    codeDirection?: "ltr" | "rtl" | "auto";
     action?: ReactNode;
 }
 /** Selectable code with an optional host-owned action; no clipboard side effects. */
 export declare const CodeSnippet: import("react").ForwardRefExoticComponent<CodeSnippetProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface ScrollAreaProps extends HTMLAttributes<HTMLDivElement> {
+    orientation?: "vertical" | "horizontal" | "both";
+    contentInset?: "none" | "scrollbar";
+}
+/** Native scrolling with inset overlay tracks; the ref targets the scrollable viewport. */
+export declare const ScrollArea: import("react").ForwardRefExoticComponent<ScrollAreaProps & import("react").RefAttributes<HTMLDivElement>>;