@optiaxiom/react 1.7.12 → 1.8.0

package/dist/index.d.ts

@@ -1,14 +1,14 @@
 import * as react from 'react';
 import { ComponentPropsWithRef, ReactNode, ComponentPropsWithoutRef, ElementType, RefObject, FocusEventHandler, ChangeEventHandler, ReactElement } from 'react';
-import { R as RecipeVariants, B as BoxProps, S as Sprinkles, a as ButtonProps, E as ExcludeProps, F as Flex, b as Button, d as dialogkit, c as ExtendProps, C as Calendar, e as CalendarProps, f as Box, g as ResponsiveArray, P as PopoverContent, h as PopoverContentProps, i as PopoverTrigger, M as ModalListbox, j as ButtonRoot } from './MenuTrigger-C0Ab8gBW.js';
-export { k as DialogContent, D as DialogContentProps, l as FlexProps, L as LonghandProps, o as Menu, q as MenuContent, p as MenuContentProps, m as MenuOption, n as MenuProps, s as MenuTrigger, r as MenuTriggerProps, t as PopoverTriggerProps, y as TableHeaderCell, T as TableHeaderCellProps, w as mapResponsiveValue, x as normalizeResponsiveValue, u as sprinkles, v as vars } from './MenuTrigger-C0Ab8gBW.js';
+import { R as RecipeVariants, B as BoxProps, S as Sprinkles, a as ButtonProps, E as ExcludeProps, G as Group, b as Button, d as dialogkit, c as ExtendProps, C as Calendar, e as CalendarProps, f as Box, g as ResponsiveArray, P as PopoverContent, h as PopoverContentProps, i as PopoverTrigger, M as ModalListbox, j as ButtonRoot } from './MenuTrigger-ByYy6TIu.js';
+export { k as DialogContent, D as DialogContentProps, l as GroupProps, L as LonghandProps, o as Menu, q as MenuContent, p as MenuContentProps, m as MenuOption, n as MenuProps, s as MenuTrigger, r as MenuTriggerProps, t as PopoverTriggerProps, y as TableHeaderCell, T as TableHeaderCellProps, w as mapResponsiveValue, x as normalizeResponsiveValue, u as sprinkles, v as vars } from './MenuTrigger-ByYy6TIu.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as RadixDialog from '@radix-ui/react-dialog';
-import * as RadixTooltip from '@radix-ui/react-tooltip';
 import { createToaster } from '@optiaxiom/globals';
 export { createToaster, theme, toaster, tokens } from '@optiaxiom/globals';
-import * as RadixToast from '@radix-ui/react-toast';
 import * as RadixPortal from '@radix-ui/react-portal';
+import * as RadixToast from '@radix-ui/react-toast';
+import * as RadixTooltip from '@radix-ui/react-tooltip';
 import { Table as Table$1 } from '@tanstack/table-core';
 import * as _radix_ui_react_popover from '@radix-ui/react-popover';
 import * as RadixCollapsible from '@radix-ui/react-collapsible';
@@ -27,8 +27,8 @@ import 'react-day-picker';
 declare const sprinklesMerge: (...classNames: Array<string | undefined>) => string;
 
 declare function extractBoxProps<S extends Record<string, unknown>>(props: S): {
-    boxProps: Pick<S, ("animation" | "fontFamily" | "fontSize" | "size" | "backgroundImage" | "borderColor" | "color" | "cursor" | "fontWeight" | "objectFit" | "overflowX" | "overflowY" | "pointerEvents" | "textAlign" | "textTransform" | "transition" | "whiteSpace" | "bg" | "border" | "borderB" | "borderL" | "borderR" | "borderT" | "m" | "mx" | "my" | "mb" | "ml" | "mr" | "mt" | "overflow" | "p" | "px" | "py" | "pb" | "pl" | "pr" | "pt" | "rounded" | "shadow" | "z" | "gap" | "alignItems" | "alignSelf" | "display" | "flex" | "flexDirection" | "flexWrap" | "gridColumn" | "gridTemplateColumns" | "justifyContent" | "justifyItems" | "placeItems" | "maxH" | "maxW" | "h" | "w" | "styles" | "className") & keyof S>;
-    restProps: Omit<S, "animation" | "fontFamily" | "fontSize" | "size" | "backgroundImage" | "borderColor" | "color" | "cursor" | "fontWeight" | "objectFit" | "overflowX" | "overflowY" | "pointerEvents" | "textAlign" | "textTransform" | "transition" | "whiteSpace" | "bg" | "border" | "borderB" | "borderL" | "borderR" | "borderT" | "m" | "mx" | "my" | "mb" | "ml" | "mr" | "mt" | "overflow" | "p" | "px" | "py" | "pb" | "pl" | "pr" | "pt" | "rounded" | "shadow" | "z" | "gap" | "alignItems" | "alignSelf" | "display" | "flex" | "flexDirection" | "flexWrap" | "gridColumn" | "gridTemplateColumns" | "justifyContent" | "justifyItems" | "placeItems" | "maxH" | "maxW" | "h" | "w" | "styles" | "className">;
+    boxProps: Pick<S, ("animation" | "fontFamily" | "fontSize" | "size" | "backgroundImage" | "borderColor" | "color" | "cursor" | "fontWeight" | "objectFit" | "overflowX" | "overflowY" | "pointerEvents" | "textAlign" | "textTransform" | "transition" | "whiteSpace" | "bg" | "border" | "borderB" | "borderL" | "borderR" | "borderT" | "m" | "mx" | "my" | "mb" | "ml" | "mr" | "mt" | "overflow" | "p" | "px" | "py" | "pb" | "pl" | "pr" | "pt" | "rounded" | "shadow" | "z" | "gap" | "alignItems" | "alignSelf" | "display" | "flex" | "flexDirection" | "flexWrap" | "gridColumn" | "gridTemplateColumns" | "justifyContent" | "justifyItems" | "placeItems" | "maxH" | "maxW" | "h" | "w" | "className" | "style") & keyof S>;
+    restProps: Omit<S, "animation" | "fontFamily" | "fontSize" | "size" | "backgroundImage" | "borderColor" | "color" | "cursor" | "fontWeight" | "objectFit" | "overflowX" | "overflowY" | "pointerEvents" | "textAlign" | "textTransform" | "transition" | "whiteSpace" | "bg" | "border" | "borderB" | "borderL" | "borderR" | "borderT" | "m" | "mx" | "my" | "mb" | "ml" | "mr" | "mt" | "overflow" | "p" | "px" | "py" | "pb" | "pl" | "pr" | "pt" | "rounded" | "shadow" | "z" | "gap" | "alignItems" | "alignSelf" | "display" | "flex" | "flexDirection" | "flexWrap" | "gridColumn" | "gridTemplateColumns" | "justifyContent" | "justifyItems" | "placeItems" | "maxH" | "maxW" | "h" | "w" | "className" | "style">;
 };
 
 declare const alert: (props?: {
@@ -44,6 +44,18 @@ type AlertProps = BoxProps<"div", AlertVariants & {
      */
     onDismiss?: () => void;
 }>;
+/**
+ * Keeps users informed of important and sometimes time-sensitive changes.
+ *
+ * Important Notes:
+ * - The `intent` prop uses "information" (not "info") for the blue
+ *   informational style
+ * - Default intent is "neutral" - only set intent when you need a specific
+ *   color/emphasis
+ *
+ * @category feedback
+ * @since 0.1.0
+ */
 declare const Alert: react.ForwardRefExoticComponent<{
     intent?: "information" | "success" | "warning" | "danger" | "neutral" | "opal" | undefined;
 } & {
@@ -71,6 +83,36 @@ type AlertDialogProps = {
      */
     open?: boolean;
 };
+/**
+ * Display a modal with important content that expects confirmation from the
+ * user.
+ *
+ * IMPORTANT: AlertDialog does NOT have a close (X) button in the header - users
+ * must explicitly choose an action. This is intentional for confirmation
+ * dialogs to prevent accidental dismissal of critical actions.
+ *
+ * Key differences from Dialog:
+ * - No automatic close button (requires explicit user choice)
+ * - AlertDialogCancel: Cancel/dismiss button (defaults to "Cancel" text)
+ * - AlertDialogAction: Primary/destructive action button
+ * - Use for: Confirmations, destructive actions, critical decisions
+ * - DO NOT use for: General forms, informational content (use Dialog instead)
+ *
+ * Basic structure:
+ * - AlertDialog: Root component for managing state
+ * - AlertDialogTrigger: Button that opens the alert
+ * - AlertDialogContent: Container with backdrop
+ * - AlertDialogHeader: Title (no close button)
+ * - AlertDialogBody: Warning/confirmation message
+ * - AlertDialogFooter: Action buttons (Cancel + Action)
+ *
+ * For async operations, use event.preventDefault() in AlertDialogAction onClick
+ * to prevent auto-close, then manually close after completion.
+ *
+ * @category overlay
+ * @group AlertDialog
+ * @since 0.1.0
+ */
 declare function AlertDialog(props: AlertDialogProps): react_jsx_runtime.JSX.Element;
 declare namespace AlertDialog {
     var displayName: string;
@@ -82,6 +124,9 @@ type ButtonGroupProps = BoxProps<"div", {
      */
     orientation?: "horizontal" | "vertical";
 }>;
+/**
+ * @group Button
+ */
 declare const ButtonGroup: react.ForwardRefExoticComponent<{
     /**
      * The orientation/layout of the buttons inside the group.
@@ -93,6 +138,11 @@ declare const ButtonGroup: react.ForwardRefExoticComponent<{
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLDivElement>>;
 
 type AlertDialogActionProps = ButtonProps<typeof RadixDialog.Close>;
+/**
+ * @group AlertDialog
+
+ * @extends Button
+ */
 declare const AlertDialogAction: react.ForwardRefExoticComponent<Omit<{
     addonAfter?: react.ReactNode;
     addonBefore?: react.ReactNode;
@@ -113,12 +163,19 @@ declare const AlertDialogAction: react.ForwardRefExoticComponent<Omit<{
 }>, "size"> & Omit<Omit<RadixDialog.DialogCloseProps & react.RefAttributes<HTMLButtonElement>, "ref">, "color" | "disabled" | "asChild" | "className"> & react.RefAttributes<HTMLButtonElement>>;
 
 type AlertDialogBodyProps = BoxProps<typeof RadixDialog.Description>;
+/**
+ * @group AlertDialog
+ */
 declare const AlertDialogBody: react.ForwardRefExoticComponent<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
 }>, never> & Omit<Omit<RadixDialog.DialogDescriptionProps & react.RefAttributes<HTMLParagraphElement>, "ref">, "color" | "asChild" | "className"> & react.RefAttributes<HTMLDivElement>>;
 
 type AlertDialogCancelProps = ButtonProps<typeof RadixDialog.Close>;
+/**
+ * @group AlertDialog
+ * @extends Button
+ */
 declare const AlertDialogCancel: react.ForwardRefExoticComponent<Omit<{
     addonAfter?: react.ReactNode;
     addonBefore?: react.ReactNode;
@@ -146,15 +203,22 @@ declare const content$1: (props?: {
 type DialogVariants = RecipeVariants<typeof content$1>;
 
 type AlertDialogContentProps = ExcludeProps<BoxProps<typeof RadixDialog.Content, DialogVariants>, "forceMount">;
+/**
+ * @group AlertDialog
+ */
 declare const AlertDialogContent: react.ForwardRefExoticComponent<AlertDialogContentProps & react.RefAttributes<HTMLDivElement>>;
 
-type AlertDialogFooterProps = ComponentPropsWithRef<typeof Flex>;
-declare const AlertDialogFooter: react.ForwardRefExoticComponent<Omit<Omit<Omit<Omit<Omit<NonNullable<Sprinkles & {
+type AlertDialogFooterProps = ComponentPropsWithRef<typeof Group>;
+/**
+ * @group AlertDialog
+ */
+declare const AlertDialogFooter: react.ForwardRefExoticComponent<Omit<Omit<{
+    alignItems?: BoxProps["alignItems"];
+    flexDirection?: BoxProps["flexDirection"];
+} & Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
-}>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLDivElement>, "ref"> & {
-    ref?: ((instance: HTMLDivElement | null) => void | react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | react.RefObject<HTMLDivElement> | null | undefined;
-}, "ref"> & react.RefAttributes<HTMLDivElement>, "ref"> & {
+}>, "alignItems" | "flexDirection"> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLDivElement>, "ref"> & {
     ref?: ((instance: HTMLDivElement | null) => void | react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | react.RefObject<HTMLDivElement> | null | undefined;
 }, "ref"> & react.RefAttributes<HTMLDivElement>>;
 
@@ -164,6 +228,9 @@ type AlertDialogHeaderProps = BoxProps<"div", {
      */
     addonBefore?: ReactNode;
 }>;
+/**
+ * @group AlertDialog
+ */
 declare const AlertDialogHeader: react.ForwardRefExoticComponent<{
     /**
      * We show an alert icon before the title by default but this can be replaced with any other icon.
@@ -175,6 +242,10 @@ declare const AlertDialogHeader: react.ForwardRefExoticComponent<{
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLHeadingElement>>;
 
 type AlertDialogTriggerProps = ButtonProps<typeof RadixDialog.Trigger>;
+/**
+ * @group AlertDialog
+ * @extends Button
+ */
 declare const AlertDialogTrigger: react.ForwardRefExoticComponent<Omit<{
     addonAfter?: react.ReactNode;
     addonBefore?: react.ReactNode;
@@ -195,6 +266,14 @@ declare const AlertDialogTrigger: react.ForwardRefExoticComponent<Omit<{
 }>, "size"> & Omit<Omit<RadixDialog.DialogTriggerProps & react.RefAttributes<HTMLButtonElement>, "ref">, "color" | "disabled" | "asChild" | "className"> & react.RefAttributes<HTMLButtonElement>>;
 
 type AngleMenuButtonProps = ComponentPropsWithoutRef<typeof Button>;
+/**
+ * Button with trailing chevron icon for opening dropdowns and popovers.
+ *
+ * For Menu dropdowns, MenuTrigger uses this component automatically. For other
+ * dropdown patterns (like Popover), use AngleMenuButton as the trigger.
+ *
+ * @group Button
+ */
 declare const AngleMenuButton: react.ForwardRefExoticComponent<Omit<Omit<{
     addonAfter?: react.ReactNode;
     addonBefore?: react.ReactNode;
@@ -229,6 +308,12 @@ type AuthProviderProps = {
      */
     token: string;
 };
+/**
+ * `AuthProvider` is used to pass down the user credentials to all components. It should be rendered near the root of your application and should be used only once.
+ *
+ * @category provider
+ * @since 1.6.2
+ */
 declare function AuthProvider({ children, instance, refresh: refreshProp, token, }: AuthProviderProps): react_jsx_runtime.JSX.Element;
 declare namespace AuthProvider {
     var displayName: string;
@@ -267,6 +352,13 @@ declare const mapFallbackToIcon: {
     team: react_jsx_runtime.JSX.Element;
     user: react_jsx_runtime.JSX.Element;
 };
+/**
+ * Displays a user profile picture or initials. For multiple avatars, use
+ * AvatarGroup.
+ *
+ * @category data-display
+ * @since 0.1.0
+ */
 declare const Avatar: react.ForwardRefExoticComponent<{
     colorScheme?: "neutral" | "purple" | undefined;
     size?: "xs" | "sm" | "md" | "lg" | "xl" | "3xl" | "2xs" | undefined;
@@ -294,6 +386,25 @@ type AvatarGroupProps = BoxProps<"div", {
      */
     size?: ComponentPropsWithoutRef<typeof Avatar>["size"];
 }>;
+/**
+ * Displays a group of avatars representing multiple users with automatic layout
+ * and overflow handling.
+ *
+ * Use this component whenever you have 2 or more Avatar components together,
+ * even if they're not overlapping in the design. AvatarGroup handles consistent
+ * sizing, spacing, overflow indicators (+N), and semantic grouping
+ * automatically.
+ *
+ * Don't manually layout multiple Avatars in a Flex - use AvatarGroup instead.
+ *
+ * When to use:
+ * - Multiple assignees on a task
+ * - Team members or collaborators
+ * - Participants in a conversation
+ * - Any group of users
+ *
+ * @group Avatar
+ */
 declare const AvatarGroup: react.ForwardRefExoticComponent<{
     /**
      * Control the size of the avatars.
@@ -315,36 +426,6 @@ declare namespace DialogKitProvider {
     var displayName: string;
 }
 
-declare const root: (props?: {
-    intent?: "information" | "success" | "warning" | "danger" | "neutral" | undefined;
-} | undefined, className?: string) => {
-    className: string;
-};
-type RootVariants = RecipeVariants<typeof root>;
-
-type ToastProps = ExcludeProps<BoxProps<typeof RadixToast.Root, RootVariants>, "forceMount" | "open">;
-declare const Toast: react.ForwardRefExoticComponent<ToastProps & react.RefAttributes<HTMLLIElement>>;
-
-type ToastActionProps = ButtonProps<typeof RadixToast.Action>;
-declare const ToastAction: react.ForwardRefExoticComponent<Omit<{
-    addonAfter?: react.ReactNode;
-    addonBefore?: react.ReactNode;
-    icon?: react.ReactNode;
-    iconPosition?: "end" | "start";
-}, never> & Omit<NonNullable<Omit<{
-    intent?: "danger" | "neutral" | "primary" | undefined;
-    size?: "sm" | "md" | "lg" | undefined;
-    square?: boolean | undefined;
-    variant?: "strong" | "outline" | "outline-opal" | "strong-opal" | "subtle" | undefined;
-}, "intent" | "variant"> & {
-    appearance?: "default" | "danger" | "primary" | "subtle" | "danger-outline" | "default-opal" | "inverse" | "primary-opal";
-    disabled?: boolean;
-    loading?: boolean;
-}>, never> & Omit<NonNullable<Sprinkles & {
-    asChild?: boolean;
-    className?: string;
-}>, "size"> & Omit<Omit<RadixToast.ToastActionProps & react.RefAttributes<HTMLButtonElement>, "ref">, "color" | "disabled" | "asChild" | "className"> & react.RefAttributes<HTMLButtonElement>>;
-
 declare const Portal: react.ForwardRefExoticComponent<Omit<RadixPortal.PortalProps & react.RefAttributes<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
 
 declare const viewport: (props?: {
@@ -361,6 +442,16 @@ type ToastProviderProps$1 = BoxProps<typeof RadixToast.Viewport, ComponentPropsW
      */
     toaster?: ReturnType<typeof createToaster>;
 }>;
+/**
+ * Provider component for toast notifications. This is included in AxiomProvider
+ * by default - you only need to use this component directly for advanced
+ * customization. Use `toaster.create()` to display toast messages.
+ *
+ * @category provider
+ * @category feedback
+ * @category overlay
+ * @since 0.1.0
+ */
 declare const ToastProvider: react.ForwardRefExoticComponent<RadixToast.ToastProviderProps & Pick<Omit<Omit<RadixPortal.PortalProps & react.RefAttributes<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>, "ref">, "container"> & {
     position?: "top" | "bottom-right" | "top-right" | "bottom" | "bottom-left" | "top-left" | undefined;
 } & {
@@ -374,32 +465,6 @@ declare const ToastProvider: react.ForwardRefExoticComponent<RadixToast.ToastPro
     className?: string;
 }>, never> & Omit<Omit<RadixToast.ToastViewportProps & react.RefAttributes<HTMLOListElement>, "ref">, "color" | "asChild" | "className" | "label" | "children"> & react.RefAttributes<HTMLOListElement>>;
 
-declare const text: (props?: {
-    lineClamp?: "1" | "2" | "3" | "4" | undefined;
-    truncate?: boolean | undefined;
-} | undefined, className?: string) => {
-    className: string;
-};
-type TextVariants = RecipeVariants<typeof text>;
-
-type TextProps<T extends ElementType = "p", P = unknown> = BoxProps<T, ExtendProps<TextVariants, P>>;
-declare const Text: react.ForwardRefExoticComponent<Omit<{
-    lineClamp?: "1" | "2" | "3" | "4" | undefined;
-    truncate?: boolean | undefined;
-}, never> & Omit<NonNullable<Sprinkles & {
-    asChild?: boolean;
-    className?: string;
-}>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLParagraphElement>, HTMLParagraphElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLParagraphElement>>;
-
-type ToastTitleProps = TextProps<typeof RadixToast.Title>;
-declare const ToastTitle: react.ForwardRefExoticComponent<Omit<{
-    lineClamp?: "1" | "2" | "3" | "4" | undefined;
-    truncate?: boolean | undefined;
-}, never> & Omit<NonNullable<Sprinkles & {
-    asChild?: boolean;
-    className?: string;
-}>, never> & Omit<Omit<RadixToast.ToastTitleProps & react.RefAttributes<HTMLDivElement>, "ref">, "color" | "asChild" | "className"> & react.RefAttributes<HTMLDivElement>>;
-
 declare const content: (props?: {
     disableHoverableContent?: boolean | undefined;
 } | undefined, className?: string) => {
@@ -408,6 +473,9 @@ declare const content: (props?: {
 type ContentVariants = RecipeVariants<typeof content>;
 
 type TooltipContentProps = ExcludeProps<BoxProps<typeof RadixTooltip.Content, ContentVariants>, "alignOffset" | "arrowPadding" | "avoidCollisions" | "collisionBoundary" | "collisionPadding" | "forceMount" | "hideWhenDetached" | "sideOffset" | "sticky" | "updatePositionStrategy">;
+/**
+ * @group TooltipRoot
+ */
 declare const TooltipContent: react.ForwardRefExoticComponent<TooltipContentProps & react.RefAttributes<HTMLDivElement>>;
 
 type TooltipRootProps = ComponentPropsWithoutRef<typeof RadixTooltip.Root> & {
@@ -444,6 +512,13 @@ type TooltipProps = ExcludeProps<BoxProps<typeof TooltipContent, Pick<ComponentP
      */
     open?: boolean;
 }>, "asChild">;
+/**
+ * Popup with brief information shown when user interacts with an element using
+ * keyboard focus or mouse hover.
+ *
+ * @category overlay
+ * @since 0.1.0
+ */
 declare function Tooltip({ auto, children, content, defaultOpen, delayDuration, disabled, disableHoverableContent, onOpenChange, open, ...props }: TooltipProps): react_jsx_runtime.JSX.Element;
 declare namespace Tooltip {
     var displayName: string;
@@ -455,12 +530,20 @@ type TooltipProviderProps$1 = ExtendProps<ComponentPropsWithoutRef<typeof RadixT
      */
     disableHoverableContent?: boolean;
 }>;
+/**
+ * Provider component for tooltips. This is included in AxiomProvider by default - you only need to use this component directly for advanced customization.
+ *
+ * @group Tooltip
+ */
 declare function TooltipProvider({ disableHoverableContent, ...props }: TooltipProviderProps$1): react_jsx_runtime.JSX.Element;
 declare namespace TooltipProvider {
     var displayName: string;
 }
 
 type TooltipTriggerProps = ComponentPropsWithoutRef<typeof RadixTooltip.Trigger>;
+/**
+ * @group TooltipRoot
+ */
 declare const TooltipTrigger: react.ForwardRefExoticComponent<Omit<RadixTooltip.TooltipTriggerProps & react.RefAttributes<HTMLButtonElement>, "ref"> & react.RefAttributes<HTMLButtonElement>>;
 
 type AxiomProviderProps = {
@@ -490,11 +573,53 @@ interface ToastProviderProps extends ComponentPropsWithoutRef<typeof ToastProvid
 }
 interface TooltipProviderProps extends ComponentPropsWithoutRef<typeof TooltipProvider> {
 }
+/**
+ * `AxiomProvider` provides all the context managers required for our components to work. It must be rendered at the root of your application and should be used only once.
+ *
+ * @category provider
+ * @since 0.1.0
+ */
 declare function AxiomProvider({ children, dialog, toast, tooltip, }: AxiomProviderProps): react_jsx_runtime.JSX.Element;
 declare namespace AxiomProvider {
     var displayName: string;
 }
 
+declare const text: (props?: {
+    lineClamp?: "1" | "2" | "3" | "4" | undefined;
+    truncate?: boolean | undefined;
+} | undefined, className?: string) => {
+    className: string;
+};
+type TextVariants = RecipeVariants<typeof text>;
+
+type TextProps<T extends ElementType = "p", P = unknown> = BoxProps<T, ExtendProps<TextVariants, P>>;
+/**
+ * Renders text content for body copy, descriptions, and general text without
+ * semantic meaning.
+ *
+ * 🚨 Renders a `<p>` tag by default, which cannot be nested inside another
+ * `<p>` tag. For inline text styling within a paragraph, use `asChild` with a
+ * `<span>` element.
+ *
+ * Use this for paragraphs, captions, descriptions, and non-heading text.
+ *
+ * When not to use:
+ * - For headings and titles use Heading instead.
+ * - For form labels use Label instead.
+ * - Don't combine large fontSize ('xl'+) with bold fontWeight ('500'+) - that
+ *   indicates a heading.
+ *
+ * @since 0.1.0
+ * @category typography
+ */
+declare const Text: react.ForwardRefExoticComponent<Omit<{
+    lineClamp?: "1" | "2" | "3" | "4" | undefined;
+    truncate?: boolean | undefined;
+}, never> & Omit<NonNullable<Sprinkles & {
+    asChild?: boolean;
+    className?: string;
+}>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLParagraphElement>, HTMLParagraphElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLParagraphElement>>;
+
 declare const badge: (props?: {
     intent?: "information" | "success" | "warning" | "danger" | "neutral" | "primary" | undefined;
     variant?: "strong" | "subtle" | undefined;
@@ -504,6 +629,13 @@ declare const badge: (props?: {
 type BadgeVariants = RecipeVariants<typeof badge>;
 
 type BadgeProps = TextProps<"span", BadgeVariants>;
+/**
+ * Use to emphasize a status, count, state or value.
+ *
+ * @since 0.1.0
+ * @category data-display
+ * @category feedback
+ */
 declare const Badge: react.ForwardRefExoticComponent<{
     intent?: "information" | "success" | "warning" | "danger" | "neutral" | "primary" | undefined;
     variant?: "strong" | "subtle" | undefined;
@@ -528,6 +660,13 @@ type BannerProps = BoxProps<"div", BannerVariants & {
      */
     onDismiss?: () => void;
 }>;
+/**
+ * Display a prominent message at the top of the screen.
+ *
+ * @category feedback
+ * @category layout
+ * @since 0.1.0
+ */
 declare const Banner: react.ForwardRefExoticComponent<{
     intent?: "information" | "success" | "warning" | "danger" | "neutral" | undefined;
 } & {
@@ -567,6 +706,12 @@ type BreadcrumbProps = BoxProps<"nav", {
      */
     maxItems?: number;
 }>;
+/**
+ * Display a list of links showing the location of the current page in the navigational hierarchy.
+ *
+ * @category navigation
+ * @since 1.6.0
+ */
 declare const Breadcrumb: react.ForwardRefExoticComponent<{
     /**
      * The items we want to render.
@@ -598,9 +743,14 @@ declare const Breadcrumb: react.ForwardRefExoticComponent<{
     className?: string;
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLElement>, HTMLElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLElement>>;
 
-type BreadcrumbItem = BreadcrumbProps["items"][number];
-
 type CardProps = BoxProps<"div">;
+/**
+ * Generic container for grouping related components together.
+ *
+ * @group Card
+ * @since 1.6.0
+ * @category container
+ */
 declare const Card: react.ForwardRefExoticComponent<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
@@ -614,6 +764,9 @@ declare const ActionsContent: react.ForwardRefExoticComponent<{
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLDivElement>>;
 
 type CardActionProps = ComponentPropsWithoutRef<typeof ActionsContent>;
+/**
+ * @group Card
+ */
 declare const CardAction: react.ForwardRefExoticComponent<Omit<{
     visible?: "always" | "if-needed" | undefined;
 } & Omit<NonNullable<Sprinkles & {
@@ -659,6 +812,12 @@ declare const CheckboxControl: react.ForwardRefExoticComponent<{
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLDivElement>, "ref">, "animation" | "fontFamily" | "fontSize" | "size" | "backgroundImage" | "borderColor" | "color" | "cursor" | "fontWeight" | "objectFit" | "overflowX" | "overflowY" | "pointerEvents" | "textAlign" | "textTransform" | "transition" | "whiteSpace" | "bg" | "border" | "borderB" | "borderL" | "borderR" | "borderT" | "m" | "mx" | "my" | "mb" | "ml" | "mr" | "mt" | "overflow" | "p" | "px" | "py" | "pb" | "pl" | "pr" | "pt" | "rounded" | "shadow" | "z" | "gap" | "alignItems" | "alignSelf" | "display" | "flex" | "flexDirection" | "flexWrap" | "gridColumn" | "gridTemplateColumns" | "justifyContent" | "justifyItems" | "placeItems" | "maxH" | "maxW" | "h" | "w" | "asChild" | "className"> & react.RefAttributes<HTMLInputElement>>;
 
 type CheckboxProps = BoxProps<typeof ToggleInputHiddenInput, Pick<ComponentPropsWithoutRef<typeof CheckboxContent>, "description"> & Pick<ComponentPropsWithoutRef<typeof CheckboxControl>, "indeterminate">>;
+/**
+ * Basic control to allow selecting one or more items from a set.
+ *
+ * @since 0.1.0
+ * @category form
+ */
 declare const Checkbox: react.ForwardRefExoticComponent<Pick<Omit<{
     description?: react.ReactNode;
 } & Omit<NonNullable<Sprinkles & {
@@ -683,9 +842,16 @@ declare const Checkbox: react.ForwardRefExoticComponent<Pick<Omit<{
 } & Omit<Omit<react.DetailedHTMLProps<react.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, never> & react.RefAttributes<HTMLInputElement>, "ref">, "size" | "color" | "className"> & react.RefAttributes<HTMLInputElement>>;
 
 type CardCheckboxProps = ExcludeProps<ComponentPropsWithoutRef<typeof Checkbox>, "description">;
+/**
+ * @extends Checkbox
+ * @group Card
+ */
 declare const CardCheckbox: react.ForwardRefExoticComponent<CardCheckboxProps & react.RefAttributes<HTMLInputElement>>;
 
 type CardFooterProps = BoxProps<"div">;
+/**
+ * @group Card
+ */
 declare const CardFooter: react.ForwardRefExoticComponent<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
@@ -705,6 +871,9 @@ type CardHeaderProps = BoxProps<"div", {
      */
     description?: ReactNode;
 }>;
+/**
+ * @group Card
+ */
 declare const CardHeader: react.ForwardRefExoticComponent<{
     /**
      * Display content inside the header after `children`.
@@ -724,6 +893,9 @@ declare const CardHeader: react.ForwardRefExoticComponent<{
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLDivElement>>;
 
 type CardImageProps = BoxProps<"img">;
+/**
+ * @group Card
+ */
 declare const CardImage: react.ForwardRefExoticComponent<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
@@ -750,6 +922,12 @@ type LinkProps = BoxProps<"a", LinkVariants & {
      */
     external?: boolean;
 }>;
+/**
+ * Anchor element for creating hyperlinks.
+ *
+ * @category navigation
+ * @since 0.1.0
+ */
 declare const Link: react.ForwardRefExoticComponent<{
     appearance?: "default" | "subtle" | "inverse" | undefined;
 } & {
@@ -771,6 +949,10 @@ declare const Link: react.ForwardRefExoticComponent<{
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.AnchorHTMLAttributes<HTMLAnchorElement>, HTMLAnchorElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLAnchorElement>>;
 
 type CardLinkProps = ComponentPropsWithoutRef<typeof Link>;
+/**
+ * @extends Link
+ * @group Card
+ */
 declare const CardLink: react.ForwardRefExoticComponent<Omit<{
     appearance?: "default" | "subtle" | "inverse" | undefined;
 } & {
@@ -800,6 +982,9 @@ type CardPreviewProps = BoxProps<"div", {
      */
     addonTopRight?: ReactNode;
 }>;
+/**
+ * @group Card
+ */
 declare const CardPreview: react.ForwardRefExoticComponent<{
     /**
      * Display content in the bottom-left corner of the preview panel.
@@ -825,6 +1010,12 @@ declare const CardPreview: react.ForwardRefExoticComponent<{
 declare function cleanup(): void;
 
 type CodeProps = BoxProps<"code">;
+/**
+ * Display inline code.
+ *
+ * @since 0.1.0
+ * @category data-display
+ */
 declare const Code: react.ForwardRefExoticComponent<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
@@ -839,6 +1030,13 @@ declare const cover: (props?: {
 type CoverVariants = RecipeVariants<typeof cover>;
 
 type CoverProps = BoxProps<"div", CoverVariants>;
+/**
+ * Use `Cover` to to expand and fill up the whole area of the parent which has `position: relative` using the `::before` pseudo element.
+ *
+ * @since 1.4.0
+ * @category container
+ * @category layout
+ */
 declare const Cover: react.ForwardRefExoticComponent<{
     disabled?: boolean | undefined;
     inset?: boolean | undefined;
@@ -853,6 +1051,13 @@ type DataTableProps = BoxProps<"div", {
      */
     table: Table$1<any>;
 }>;
+/**
+ * Easy to use table and datagrids built using [TanStack Table](https://tanstack.com/table/latest).
+ *
+ * @category data-display
+ * @group DataTable
+ * @since 1.4.0
+ */
 declare const DataTable: react.ForwardRefExoticComponent<{
     /**
      * Pass the table instance returned from `useReactTable()` hook.
@@ -870,15 +1075,41 @@ declare const table: (props?: {
 };
 type TableVariants = RecipeVariants<typeof table>;
 
-type TableProps = BoxProps<"table", TableVariants>;
+type TableProps = BoxProps<"div", TableVariants>;
+/**
+ * Display tabular data using rows and columns.
+ *
+ * ⚠️ **IMPORTANT**: Consider using `DataTable` instead for displaying tabular
+ * data.
+ *
+ * `DataTable` provides built-in support for:
+ * - Sorting (client-side and server-side)
+ * - Pagination (client-side and server-side)
+ * - Row selection with checkboxes
+ * - Column pinning (sticky columns)
+ * - Row expansion
+ * - Loading states
+ * - Virtualization for large datasets
+ *
+ * `Table` is a low-level primitive and should only be used for very specific
+ * custom table layouts. For most use cases, `DataTable` is the recommended
+ * choice.
+ *
+ * @group Table
+ * @since 1.4.0
+ * @category data-display
+ */
 declare const Table: react.ForwardRefExoticComponent<{
     layout?: "auto" | "fixed" | undefined;
 } & Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
-}>, never> & Omit<Omit<react.DetailedHTMLProps<react.TableHTMLAttributes<HTMLTableElement>, HTMLTableElement>, "ref">, "color" | "border" | "className"> & react.RefAttributes<HTMLDivElement>>;
+}>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLDivElement>>;
 
 type TableActionProps = BoxProps<typeof ActionsContent>;
+/**
+ * @group Table
+ */
 declare const TableAction: react.ForwardRefExoticComponent<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
@@ -890,6 +1121,9 @@ declare const TableAction: react.ForwardRefExoticComponent<Omit<NonNullable<Spri
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLDivElement>, "ref">, "animation" | "fontFamily" | "fontSize" | "size" | "backgroundImage" | "borderColor" | "color" | "cursor" | "fontWeight" | "objectFit" | "overflowX" | "overflowY" | "pointerEvents" | "textAlign" | "textTransform" | "transition" | "whiteSpace" | "bg" | "border" | "borderB" | "borderL" | "borderR" | "borderT" | "m" | "mx" | "my" | "mb" | "ml" | "mr" | "mt" | "overflow" | "p" | "px" | "py" | "pb" | "pl" | "pr" | "pt" | "rounded" | "shadow" | "z" | "gap" | "alignItems" | "alignSelf" | "display" | "flex" | "flexDirection" | "flexWrap" | "gridColumn" | "gridTemplateColumns" | "justifyContent" | "justifyItems" | "placeItems" | "maxH" | "maxW" | "h" | "w" | "asChild" | "className"> & react.RefAttributes<HTMLDivElement>>;
 
 type TableBodyProps = BoxProps<"tbody">;
+/**
+ * @group Table
+ */
 declare const TableBody: react.ForwardRefExoticComponent<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
@@ -903,6 +1137,9 @@ declare const cell: (props?: {
 type CellVariants = RecipeVariants<typeof cell>;
 
 type TableCellProps = BoxProps<"td", NonNullable<CellVariants>>;
+/**
+ * @group Table
+ */
 declare const TableCell: react.ForwardRefExoticComponent<{
     pinned?: boolean | undefined;
 } & Omit<NonNullable<Sprinkles & {
@@ -918,6 +1155,9 @@ declare const header: (props?: {
 type HeaderVariants = RecipeVariants<typeof header>;
 
 type TableHeaderProps = BoxProps<"thead", NonNullable<HeaderVariants>>;
+/**
+ * @group Table
+ */
 declare const TableHeader: react.ForwardRefExoticComponent<{
     pinned?: boolean | undefined;
 } & Omit<NonNullable<Sprinkles & {
@@ -926,6 +1166,9 @@ declare const TableHeader: react.ForwardRefExoticComponent<{
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLTableSectionElement>, HTMLTableSectionElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLTableSectionElement>>;
 
 type TableRowProps = BoxProps<"tr">;
+/**
+ * @group Table
+ */
 declare const TableRow: react.ForwardRefExoticComponent<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
@@ -937,6 +1180,9 @@ type DataTableActionProps = BoxProps<typeof TableAction, {
      */
     primary?: boolean;
 }>;
+/**
+ * @group DataTable
+ */
 declare const DataTableAction: react.ForwardRefExoticComponent<{
     /**
      * Whether this is the primary action within the row.
@@ -963,8 +1209,11 @@ type DataTableBodyProps = BoxProps<"div", {
     /**
      * Whether to show skeleton for the whole table or specific rows.
      */
-    loading?: boolean | Record<string, "sub-rows" | boolean>;
+    loading?: boolean | Record<string, "sub-rows" | false>;
 }>;
+/**
+ * @group DataTable
+ */
 declare const DataTableBody: react.ForwardRefExoticComponent<{
     /**
      * The estimated height of rows in pixels when virtualization is enabled.
@@ -973,13 +1222,16 @@ declare const DataTableBody: react.ForwardRefExoticComponent<{
     /**
      * Whether to show skeleton for the whole table or specific rows.
      */
-    loading?: boolean | Record<string, "sub-rows" | boolean>;
+    loading?: boolean | Record<string, "sub-rows" | false>;
 } & Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLDivElement>>;
 
 type DataTableCheckboxProps = ComponentPropsWithoutRef<typeof Checkbox> & Pick<ComponentPropsWithoutRef<typeof DataTableAction>, "visible">;
+/**
+ * @group DataTable
+ */
 declare const DataTableCheckbox: react.ForwardRefExoticComponent<Omit<Pick<Omit<{
     description?: react.ReactNode;
 } & Omit<NonNullable<Sprinkles & {
@@ -1035,6 +1287,9 @@ type DataTableFooterProps = BoxProps<"div", {
      */
     showPageSizeOptions?: boolean;
 }>;
+/**
+ * @group DataTable
+ */
 declare const DataTableFooter: react.ForwardRefExoticComponent<{
     /**
      * Specify a custom set of page size options.
@@ -1059,6 +1314,9 @@ declare const DataTableFooter: react.ForwardRefExoticComponent<{
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLDivElement>>;
 
 type DataTableLabelProps = BoxProps;
+/**
+ * @group DataTable
+ */
 declare const DataTableLabel: react.ForwardRefExoticComponent<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
@@ -1085,7 +1343,8 @@ type InputControlProps<T extends ElementType = "input" | "textarea", P = unknown
      */
     disabled?: boolean;
     /**
-     * Whether to show the input error state.
+     * Whether to show the input error state. Automatically set when used
+     * inside a Field component with an error prop.
      */
     error?: boolean;
     /**
@@ -1093,6 +1352,9 @@ type InputControlProps<T extends ElementType = "input" | "textarea", P = unknown
      */
     onValueChange?: (value: string) => void;
 }, P>>;
+/**
+ * @group InputRoot
+ */
 declare const InputControl: react.ForwardRefExoticComponent<Omit<NonNullable<{
     size?: "md" | "lg" | "xl" | undefined;
 } & {
@@ -1101,7 +1363,8 @@ declare const InputControl: react.ForwardRefExoticComponent<Omit<NonNullable<{
      */
     disabled?: boolean;
     /**
-     * Whether to show the input error state.
+     * Whether to show the input error state. Automatically set when used
+     * inside a Field component with an error prop.
      */
     error?: boolean;
     /**
@@ -1149,6 +1412,12 @@ type InputProps$1 = InputControlProps<"input", Pick<ComponentPropsWithoutRef<typ
      */
     htmlSize?: number;
 }>;
+/**
+ * Basic text field for capturing user input.
+ *
+ * @category form
+ * @since 0.1.0
+ */
 declare const Input: react.ForwardRefExoticComponent<Pick<Omit<Pick<{
     addonPointerEvents?: "auto" | "none";
     inputRef: react.RefObject<HTMLInputElement & HTMLTextAreaElement>;
@@ -1185,18 +1454,68 @@ declare const Input: react.ForwardRefExoticComponent<Pick<Omit<Pick<{
 }>, "size"> & Omit<Omit<react.DetailedHTMLProps<react.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "size" | "color" | "disabled" | "className"> & react.RefAttributes<HTMLInputElement>>;
 
 type InputAddonProps = BoxProps<"div">;
+/**
+ * @group InputRoot
+ */
 declare const InputAddon: react.ForwardRefExoticComponent<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLDivElement>>;
 
 type DateInputProps = ExtendProps<ComponentPropsWithoutRef<typeof Input>, Pick<ComponentPropsWithoutRef<typeof Calendar>, "holiday" | "placeholder" | "weekend"> & {
+    /**
+     * The default date and time to use in the calendar picker when no value has
+     * been selected.
+     *
+     * **NOTE:** This is NOT a placeholder hint text for the input field. Native
+     * date inputs do not support placeholder text. The value format must be an
+     * Instant, PlainDate, PlainDateTime, or PlainTime (e.g., "2024-01-01",
+     * "2024-01-01T12:00", "12:00").
+     *
+     * @example
+     * // Set default time to noon when picking dates
+     * <DateInput placeholder="12:00" />
+     *
+     * // Set default date to a specific date
+     * <DateInput placeholder="2024-01-01" />
+     */
+    placeholder?: string;
     /**
      * Control whether the input allows only date or both date and time.
      */
     type?: "date" | "datetime-local";
 }>;
-declare const DateInput: react.ForwardRefExoticComponent<Pick<ComponentPropsWithoutRef<react.ForwardRefExoticComponent<CalendarProps & react.RefAttributes<HTMLDivElement>>>, "holiday" | "placeholder" | "weekend"> & {
+/**
+ * Input field with calendar that lets user enter dates.
+ *
+ * Important Notes:
+ * - The `placeholder` prop sets the default date/time in the calendar picker,
+ *   NOT hint text for the input field (native date inputs don't support that)
+ * - Don't use `addonBefore` as it will override the calendar icon that opens
+ *   the date picker popover
+ *
+ * @category form
+ * @category date
+ * @since 1.4.0
+ */
+declare const DateInput: react.ForwardRefExoticComponent<Pick<ComponentPropsWithoutRef<react.ForwardRefExoticComponent<CalendarProps & react.RefAttributes<HTMLDivElement>>>, "placeholder" | "holiday" | "weekend"> & {
+    /**
+     * The default date and time to use in the calendar picker when no value has
+     * been selected.
+     *
+     * **NOTE:** This is NOT a placeholder hint text for the input field. Native
+     * date inputs do not support placeholder text. The value format must be an
+     * Instant, PlainDate, PlainDateTime, or PlainTime (e.g., "2024-01-01",
+     * "2024-01-01T12:00", "12:00").
+     *
+     * @example
+     * // Set default time to noon when picking dates
+     * <DateInput placeholder="12:00" />
+     *
+     * // Set default date to a specific date
+     * <DateInput placeholder="2024-01-01" />
+     */
+    placeholder?: string;
     /**
      * Control whether the input allows only date or both date and time.
      */
@@ -1225,7 +1544,7 @@ declare const DateInput: react.ForwardRefExoticComponent<Pick<ComponentPropsWith
 }>, "size"> & Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
-}>, "size"> & Omit<Omit<react.DetailedHTMLProps<react.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "size" | "color" | "disabled" | "className"> & react.RefAttributes<HTMLInputElement>, "ref">, "placeholder" | "type"> & react.RefAttributes<HTMLInputElement>>;
+}>, "size"> & Omit<Omit<react.DetailedHTMLProps<react.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "size" | "color" | "disabled" | "className"> & react.RefAttributes<HTMLInputElement>, "ref">, "type" | "placeholder"> & react.RefAttributes<HTMLInputElement>>;
 
 type PopoverProps = {
     children?: React.ReactNode;
@@ -1246,6 +1565,13 @@ type PopoverProps = {
      */
     open?: boolean;
 };
+/**
+ * Display arbitrary rich content inside a non-modal dialog triggered by a button.
+ *
+ * @category overlay
+ * @group Popover
+ * @since 0.1.0
+ */
 declare function Popover({ children, defaultOpen, modal, onOpenChange, open: openProp, }: PopoverProps): react_jsx_runtime.JSX.Element;
 declare namespace Popover {
     var displayName: string;
@@ -1258,6 +1584,9 @@ type PopoverAnchorProps = BoxProps<typeof RadixPopper.Anchor, {
      */
     staticRef?: RefObject<HTMLElement>;
 }>;
+/**
+ * @group Popover
+ */
 declare const PopoverAnchor: react.ForwardRefExoticComponent<{
     /**
      * Use a static virtual ref to anchor the content instead of updating the
@@ -1300,6 +1629,9 @@ type ListboxItemProps<T extends ElementType = "div", P = unknown> = BoxProps<T,
      */
     icon?: ReactNode;
 }, P>>;
+/**
+ * @group Listbox
+ */
 declare const ListboxItem: react.ForwardRefExoticComponent<Omit<NonNullable<{
     intent?: "danger" | "neutral" | undefined;
 } & {
@@ -1325,6 +1657,9 @@ declare const ListboxItem: react.ForwardRefExoticComponent<Omit<NonNullable<{
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLDivElement>>;
 
 type ListboxCheckboxItemProps = ComponentPropsWithoutRef<typeof ListboxItem> & Pick<ComponentPropsWithoutRef<typeof Checkbox>, "onCheckedChange">;
+/**
+ * @group Listbox
+ */
 declare const ListboxCheckboxItem: react.ForwardRefExoticComponent<Omit<Omit<NonNullable<{
     intent?: "danger" | "neutral" | undefined;
 } & {
@@ -1359,12 +1694,18 @@ declare const ListboxCheckboxItem: react.ForwardRefExoticComponent<Omit<Omit<Non
 } & Omit<Omit<react.DetailedHTMLProps<react.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, never> & react.RefAttributes<HTMLInputElement>, "ref">, "size" | "color" | "className"> & react.RefAttributes<HTMLInputElement>, "ref">, "onCheckedChange"> & react.RefAttributes<HTMLDivElement>>;
 
 type ListboxEmptyProps = BoxProps;
+/**
+ * @group Listbox
+ */
 declare const ListboxEmpty: react.ForwardRefExoticComponent<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLDivElement>>;
 
 type ListboxGroupProps = ComponentPropsWithoutRef<typeof Box>;
+/**
+ * @group Listbox
+ */
 declare const ListboxGroup: react.ForwardRefExoticComponent<Omit<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
@@ -1378,6 +1719,9 @@ type ListboxItemIndicatorProps = BoxProps<typeof IconCheck, {
      */
     active?: boolean;
 }>;
+/**
+ * @group Listbox
+ */
 declare const ListboxItemIndicator: react.ForwardRefExoticComponent<{
     /**
      * Whether to display a tick to indicate if the item is active or not.
@@ -1416,6 +1760,9 @@ type ListboxItemizedProps = BoxProps<"div", {
      */
     onPlacedChange?: (placed: boolean) => void;
 }>;
+/**
+ * @group Listbox
+ */
 declare const ListboxItemized: react.ForwardRefExoticComponent<{
     children?: // eslint-disable-next-line @typescript-eslint/no-explicit-any
     ((item: any, index: number, prevItem: any) => ReactNode) | ReactNode;
@@ -1449,12 +1796,18 @@ declare const ListboxItemized: react.ForwardRefExoticComponent<{
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className" | "children"> & react.RefAttributes<HTMLDivElement>>;
 
 type ListboxLabelProps = ComponentPropsWithoutRef<typeof Box>;
+/**
+ * @group Listbox
+ */
 declare const ListboxLabel: react.ForwardRefExoticComponent<Omit<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
 
 type ListboxRadioItemProps = ComponentPropsWithoutRef<typeof ListboxItem>;
+/**
+ * @group Listbox
+ */
 declare const ListboxRadioItem: react.ForwardRefExoticComponent<Omit<Omit<NonNullable<{
     intent?: "danger" | "neutral" | undefined;
 } & {
@@ -1479,6 +1832,12 @@ declare const separator: ((props: {
 type SeparatorVariants = Parameters<typeof separator>[0];
 
 type SeparatorProps = BoxProps<typeof RadixSeparator.Root, SeparatorVariants>;
+/**
+ * `Separator` component is used to visually separate items in a list or group. By default the orientation is set to `horizontal`.
+ *
+ * @since 0.1.0
+ * @category layout
+ */
 declare const Separator: react.ForwardRefExoticComponent<{
     orientation?: ("vertical" | "horizontal" | {
         readonly base?: "vertical" | "horizontal" | undefined;
@@ -1491,6 +1850,9 @@ declare const Separator: react.ForwardRefExoticComponent<{
 }>, never> & Omit<Omit<RadixSeparator.SeparatorProps & react.RefAttributes<HTMLDivElement>, "ref">, "color" | "asChild" | "className" | "orientation"> & react.RefAttributes<HTMLDivElement>>;
 
 type ListboxSeparatorProps = BoxProps<typeof Separator>;
+/**
+ * @group Listbox
+ */
 declare const ListboxSeparator: react.ForwardRefExoticComponent<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
@@ -1518,6 +1880,12 @@ type SwitchProps = BoxProps<typeof ToggleInputHiddenInput, SwitchVariants & {
      */
     description?: ReactNode;
 }>;
+/**
+ * Control to allow toggling between checked and not checked state.
+ *
+ * @category form
+ * @since 0.1.0
+ */
 declare const Switch: react.ForwardRefExoticComponent<{
     size?: "md" | "lg" | undefined;
 } & {
@@ -1533,6 +1901,9 @@ declare const Switch: react.ForwardRefExoticComponent<{
 } & Omit<Omit<react.DetailedHTMLProps<react.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, never> & react.RefAttributes<HTMLInputElement>, "ref">, "size" | "color" | "className"> & react.RefAttributes<HTMLInputElement>>;
 
 type ListboxSwitchItemProps = ComponentPropsWithoutRef<typeof ListboxItem> & Pick<ComponentPropsWithoutRef<typeof Switch>, "onCheckedChange">;
+/**
+ * @group Listbox
+ */
 declare const ListboxSwitchItem: react.ForwardRefExoticComponent<Omit<Omit<NonNullable<{
     intent?: "danger" | "neutral" | undefined;
 } & {
@@ -1576,6 +1947,14 @@ type DateRange = {
     from: Date;
     to: Date;
 };
+/**
+ * Calendar popover that lets user pick date ranges.
+ *
+ * @category date
+ * @group DateRangePicker
+ * @since 1.4.0
+ * @extends Popover
+ */
 declare function DateRangePicker({ children, defaultOpen, defaultValue, disabled, onOpenChange, onValueChange, open: openProp, value: valueProp, ...props }: DateRangePickerProps): react_jsx_runtime.JSX.Element;
 declare namespace DateRangePicker {
     var displayName: string;
@@ -1591,6 +1970,9 @@ type DateRangePickerContentProps = ComponentPropsWithoutRef<typeof PopoverConten
      */
     addonBefore?: ReactNode;
 };
+/**
+ * @group DateRangePicker
+ */
 declare const DateRangePickerContent: react.ForwardRefExoticComponent<Omit<PopoverContentProps & react.RefAttributes<HTMLDivElement>, "ref"> & Pick<ComponentPropsWithoutRef<react.ForwardRefExoticComponent<CalendarProps & react.RefAttributes<HTMLDivElement>>>, "max" | "min" | "today" | "holiday" | "weekend"> & {
     /**
      * Display content inside the popover after the calendar.
@@ -1612,6 +1994,10 @@ type DateRangePickerTriggerProps = ComponentPropsWithoutRef<typeof PopoverTrigge
      */
     placeholder?: string;
 };
+/**
+ * @group DateRangePicker
+ * @extends Button
+ */
 declare const DateRangePickerTrigger: react.ForwardRefExoticComponent<Omit<Omit<{
     addonAfter?: react.ReactNode;
     addonBefore?: react.ReactNode;
@@ -1655,12 +2041,45 @@ type DialogProps = {
      */
     open?: boolean;
 };
+/**
+ * Display a modal dialog box.
+ *
+ * DialogHeader automatically includes a close button (X) in the top-right
+ * corner - do not manually add a close button to the header.
+ *
+ * Use Dialog for:
+ * - Forms and data entry
+ * - General content display
+ * - Multi-step workflows
+ * - Non-critical interactions
+ *
+ * For confirmations/destructive actions, use AlertDialog instead (which has no
+ * close button and requires explicit user choice).
+ *
+ * Basic structure:
+ * - Dialog: Root component for managing open/close state
+ * - DialogTrigger: Button that opens the dialog
+ * - DialogContent: Container with backdrop and positioning
+ * - DialogHeader: Title with built-in close button (X)
+ * - DialogBody: Main content area
+ * - DialogFooter: Action buttons (use DialogClose for cancel/close actions)
+ *
+ * For forms, wrap DialogBody and DialogFooter in DialogForm and use
+ * type="submit" on the primary action button.
+ *
+ * @category overlay
+ * @group Dialog
+ * @since 0.1.0
+ */
 declare function Dialog({ children, defaultOpen, onOpenChange, open: openProp, ...props }: DialogProps): react_jsx_runtime.JSX.Element;
 declare namespace Dialog {
     var displayName: string;
 }
 
 type DialogBodyProps = ComponentPropsWithRef<typeof Box>;
+/**
+ * @group Dialog
+ */
 declare const DialogBody: react.ForwardRefExoticComponent<Omit<Omit<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
@@ -1669,6 +2088,10 @@ declare const DialogBody: react.ForwardRefExoticComponent<Omit<Omit<Omit<NonNull
 }, "ref"> & react.RefAttributes<HTMLDivElement>>;
 
 type DialogCloseProps = ButtonProps<typeof RadixDialog.Close>;
+/**
+ * @extends Button
+ * @group Dialog
+ */
 declare const DialogClose: react.ForwardRefExoticComponent<Omit<{
     addonAfter?: react.ReactNode;
     addonBefore?: react.ReactNode;
@@ -1688,17 +2111,24 @@ declare const DialogClose: react.ForwardRefExoticComponent<Omit<{
     className?: string;
 }>, "size"> & Omit<Omit<RadixDialog.DialogCloseProps & react.RefAttributes<HTMLButtonElement>, "ref">, "color" | "disabled" | "asChild" | "className"> & react.RefAttributes<HTMLButtonElement>>;
 
-type DialogFooterProps = ComponentPropsWithRef<typeof Flex>;
-declare const DialogFooter: react.ForwardRefExoticComponent<Omit<Omit<Omit<Omit<Omit<NonNullable<Sprinkles & {
+type DialogFooterProps = ComponentPropsWithRef<typeof Group>;
+/**
+ * @group Dialog
+ */
+declare const DialogFooter: react.ForwardRefExoticComponent<Omit<Omit<{
+    alignItems?: BoxProps["alignItems"];
+    flexDirection?: BoxProps["flexDirection"];
+} & Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
-}>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLDivElement>, "ref"> & {
-    ref?: ((instance: HTMLDivElement | null) => void | react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | react.RefObject<HTMLDivElement> | null | undefined;
-}, "ref"> & react.RefAttributes<HTMLDivElement>, "ref"> & {
+}>, "alignItems" | "flexDirection"> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLDivElement>, "ref"> & {
     ref?: ((instance: HTMLDivElement | null) => void | react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES[keyof react.DO_NOT_USE_OR_YOU_WILL_BE_FIRED_CALLBACK_REF_RETURN_VALUES]) | react.RefObject<HTMLDivElement> | null | undefined;
 }, "ref"> & react.RefAttributes<HTMLDivElement>>;
 
 type DialogFormProps = BoxProps<"form">;
+/**
+ * @group Dialog
+ */
 declare const DialogForm: react.ForwardRefExoticComponent<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
@@ -1714,6 +2144,9 @@ type DialogHeaderProps = BoxProps<"div", {
      */
     description?: ReactNode;
 }>;
+/**
+ * @group Dialog
+ */
 declare const DialogHeader: react.ForwardRefExoticComponent<{
     /**
      * Display content inside the header after `children`.
@@ -1729,6 +2162,10 @@ declare const DialogHeader: react.ForwardRefExoticComponent<{
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLDivElement>>;
 
 type DialogTriggerProps = ButtonProps<typeof RadixDialog.Trigger>;
+/**
+ * @extends Button
+ * @group Dialog
+ */
 declare const DialogTrigger: react.ForwardRefExoticComponent<Omit<{
     addonAfter?: react.ReactNode;
     addonBefore?: react.ReactNode;
@@ -1762,6 +2199,26 @@ type DisclosureProps = BoxProps<typeof RadixCollapsible.Root, {
      */
     open?: boolean;
 }>;
+/**
+ * Interactive component for expanding and collapsing content panels with
+ * built-in state management.
+ *
+ * Use this for collapsible sections with expand/collapse triggers. Disclosure
+ * handles the toggle state, animations, and accessibility automatically.
+ *
+ * When to use:
+ * - FAQ sections
+ * - Expandable content panels
+ * - Show/hide details sections
+ * - Any expand/collapse pattern with a chevron icon
+ *
+ * Don't manually build with Button + chevron icon + useState - use Disclosure
+ * instead.
+ *
+ * @group Disclosure
+ * @category actions
+ * @since 0.1.0
+ */
 declare const Disclosure: react.ForwardRefExoticComponent<{
     /**
      * The initial open state in uncontrolled mode.
@@ -1787,6 +2244,9 @@ type DisclosureContentProps = ExcludeProps<BoxProps<typeof RadixCollapsible.Cont
      */
     hiddenUntilFound?: boolean;
 }>, "forceMount">;
+/**
+ * @group Disclosure
+ */
 declare const DisclosureContent: react.ForwardRefExoticComponent<DisclosureContentProps & react.RefAttributes<HTMLDivElement>>;
 
 type DisclosureTriggerProps = BoxProps<"div", {
@@ -1803,6 +2263,9 @@ type DisclosureTriggerProps = BoxProps<"div", {
      */
     chevronPosition?: "end" | "start";
 }>;
+/**
+ * @group Disclosure
+ */
 declare const DisclosureTrigger: react.ForwardRefExoticComponent<{
     /**
      * Display content after the button.
@@ -1841,7 +2304,12 @@ type DropdownMenuProps = {
     open?: boolean;
 };
 /**
- * @deprecated use {@link Menu} instead
+ * Display a dropdown menu.
+ *
+ * @category overlay
+ * @since 0.1.0
+ * @deprecated since 1.6.0 use {@link Menu} instead
+ * @see Menu
  */
 declare function DropdownMenu({ children, defaultOpen, onOpenChange, open: openProp, ...props }: DropdownMenuProps): react_jsx_runtime.JSX.Element;
 declare namespace DropdownMenu {
@@ -1895,6 +2363,9 @@ declare const DropdownMenuLabel: react.ForwardRefExoticComponent<Omit<NonNullabl
 }>, never> & Omit<Omit<RadixMenu.DropdownMenuLabelProps & react.RefAttributes<HTMLDivElement>, "ref">, "color" | "asChild" | "className"> & react.RefAttributes<HTMLDivElement>>;
 
 type DropdownMenuSeparatorProps = BoxProps<typeof RadixMenu.Separator>;
+/**
+ * @extends Separator
+ */
 declare const DropdownMenuSeparator: react.ForwardRefExoticComponent<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
@@ -1937,6 +2408,9 @@ declare const DropdownMenuSubTrigger: react.ForwardRefExoticComponent<Omit<NonNu
 }>, never> & Omit<Omit<RadixMenu.DropdownMenuSubTriggerProps & react.RefAttributes<HTMLDivElement>, "ref">, "color" | "asChild" | "className"> & react.RefAttributes<HTMLDivElement>>;
 
 type DropdownMenuTriggerProps = ComponentPropsWithoutRef<typeof Button>;
+/**
+ * @extends Button
+ */
 declare const DropdownMenuTrigger: react.ForwardRefExoticComponent<Omit<Omit<{
     addonAfter?: react.ReactNode;
     addonBefore?: react.ReactNode;
@@ -1957,6 +2431,16 @@ declare const DropdownMenuTrigger: react.ForwardRefExoticComponent<Omit<Omit<{
 }>, "size"> & Omit<Omit<react.DetailedHTMLProps<react.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref">, "color" | "disabled" | "className"> & react.RefAttributes<HTMLButtonElement>, "ref"> & react.RefAttributes<HTMLButtonElement>>;
 
 type EllipsisMenuButtonProps = ComponentPropsWithoutRef<typeof Button>;
+/**
+ * Button with ellipsis icon for opening overflow menus and dropdowns.
+ *
+ * Use with MenuTrigger asChild for overflow menus.
+ *
+ * @example
+ * <MenuTrigger asChild><EllipsisMenuButton /></MenuTrigger>
+ *
+ * @group Button
+ */
 declare const EllipsisMenuButton: react.ForwardRefExoticComponent<Omit<Omit<{
     addonAfter?: react.ReactNode;
     addonBefore?: react.ReactNode;
@@ -1994,6 +2478,9 @@ type FieldLabelProps = BoxProps<"div", {
      */
     required?: boolean;
 }>;
+/**
+ * @group Field
+ */
 declare const FieldLabel: react.ForwardRefExoticComponent<{
     /**
      * Display a help icon with additional context for the input.
@@ -2030,6 +2517,12 @@ type FieldProps = BoxProps<"div", Pick<ComponentPropsWithoutRef<typeof FieldLabe
      */
     label?: ReactNode;
 }>;
+/**
+ * Wrapper for inputs to provide context such as label/help/required etc.
+ *
+ * @category form
+ * @since 0.1.0
+ */
 declare const Field: react.ForwardRefExoticComponent<Pick<Omit<{
     info?: ReactNode;
     inputId?: string;
@@ -2056,7 +2549,73 @@ declare const Field: react.ForwardRefExoticComponent<Pick<Omit<{
     className?: string;
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLDivElement>>;
 
+type FlexProps = BoxProps<"div", {
+    /**
+     * Set the element's `align-items` CSS property. Defaults to `center` when
+     * `flexDirection='row'`, and `stretch` when `flexDirection='column'`.
+     */
+    alignItems?: BoxProps["alignItems"];
+    /**
+     * Set the element's `flex-direction` CSS property.
+     *
+     * ⚠️ DEFAULTS TO 'column' (vertical stacking) - NOT 'row' like standard CSS!
+     *
+     * - Default: 'column'
+     * - For horizontal layouts: explicitly set flexDirection='row'
+     * - When direction is 'row', alignItems defaults to 'center'
+     * - When direction is 'column', alignItems defaults to 'stretch'
+     */
+    flexDirection?: BoxProps["flexDirection"];
+}>;
+/**
+ * Stack items vertically or horizontally in a flex container.
+ *
+ * 🚨 Use `<Flex>` for vertical stacking and `<Flex flexDirection="row">` for
+ * horizontal stacking, as our component does NOT use the standard CSS `row`
+ * default.
+ *
+ * Best Practices:
+ * - Use Flex for layout direction (flexDirection, gap, alignment)
+ * - Use Box for simpler styling needs (padding, margin, borders, colors)
+ * - Box is a lighter primitive; Flex adds flexbox-specific defaults
+ *
+ * Default Props:
+ * - flexDirection: 'column' (NOT 'row' like CSS!)
+ * - gap: '16'
+ * - alignItems: 'stretch' (when column) or 'center' (when row)
+ *
+ * @category layout
+ * @extends Box
+ */
+declare const Flex: react.ForwardRefExoticComponent<{
+    /**
+     * Set the element's `align-items` CSS property. Defaults to `center` when
+     * `flexDirection='row'`, and `stretch` when `flexDirection='column'`.
+     */
+    alignItems?: BoxProps["alignItems"];
+    /**
+     * Set the element's `flex-direction` CSS property.
+     *
+     * ⚠️ DEFAULTS TO 'column' (vertical stacking) - NOT 'row' like standard CSS!
+     *
+     * - Default: 'column'
+     * - For horizontal layouts: explicitly set flexDirection='row'
+     * - When direction is 'row', alignItems defaults to 'center'
+     * - When direction is 'column', alignItems defaults to 'stretch'
+     */
+    flexDirection?: BoxProps["flexDirection"];
+} & Omit<NonNullable<Sprinkles & {
+    asChild?: boolean;
+    className?: string;
+}>, "alignItems" | "flexDirection"> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLDivElement>>;
+
 type GridProps = ComponentPropsWithRef<typeof Box>;
+/**
+ * Use `Grid` component to place items in a grid using equal width columns.
+ *
+ * @since 0.1.0
+ * @category layout
+ */
 declare const Grid: react.ForwardRefExoticComponent<Omit<Omit<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
@@ -2066,7 +2625,13 @@ declare const Grid: react.ForwardRefExoticComponent<Omit<Omit<Omit<NonNullable<S
 
 type HeadingProps<T extends ElementType = "h1", P = unknown> = TextProps<T, ExtendProps<{
     /**
-     * Switch between the different h1-h6 levels.
+     * Heading level (1-4) that controls both the semantic HTML tag and font size.
+     * - `level="1"`: renders `<h1>` with `fontSize="4xl"` (default)
+     * - `level="2"`: renders `<h2>` with `fontSize="3xl"`
+     * - `level="3"`: renders `<h3>` with `fontSize="2xl"`
+     * - `level="4"`: renders `<h4>` with `fontSize="xl"`
+     *
+     * Use `asChild` to decouple the semantic level from visual appearance.
      */
     level?: keyof typeof mapLevelToTag;
 }, P>>;
@@ -2076,9 +2641,39 @@ declare const mapLevelToTag: {
     readonly "3": "h3";
     readonly "4": "h4";
 };
+/**
+ * Renders semantic heading elements (h1-h4) for document structure and
+ * accessibility.
+ *
+ * Use this for page titles, section headings, and any text that represents a
+ * heading in the document outline. Don't use Text with large fontSize and bold
+ * fontWeight for headings - Heading provides proper semantics for screen
+ * readers and improves accessibility.
+ *
+ * When to use:
+ * - Page titles
+ * - Section headings
+ * - Card/panel titles
+ * - Any text with fontSize='xl'+ and fontWeight='500'+
+ *
+ * ⚠️ All heading levels (1-4) default to fontWeight="700". If your design shows
+ * lighter headings, explicitly set fontWeight="500" or "600".
+ *
+ * Don't use Text component for headings - it lacks semantic meaning.
+ *
+ * @category typography
+ * @since 0.1.0
+ * @extends Text
+ */
 declare const Heading: react.ForwardRefExoticComponent<Omit<{
     /**
-     * Switch between the different h1-h6 levels.
+     * Heading level (1-4) that controls both the semantic HTML tag and font size.
+     * - `level="1"`: renders `<h1>` with `fontSize="4xl"` (default)
+     * - `level="2"`: renders `<h2>` with `fontSize="3xl"`
+     * - `level="3"`: renders `<h3>` with `fontSize="2xl"`
+     * - `level="4"`: renders `<h4>` with `fontSize="xl"`
+     *
+     * Use `asChild` to decouple the semantic level from visual appearance.
      */
     level?: keyof typeof mapLevelToTag;
 }, never> & Omit<{
@@ -2111,6 +2706,13 @@ type IndicatorProps = BoxProps<typeof Badge, {
      */
     position?: "bottom-right" | "top-right";
 }>;
+/**
+ * Display a badge at the corner of another element.
+ *
+ * @category data-display
+ * @category feedback
+ * @since 0.1.0
+ */
 declare const Indicator: react.ForwardRefExoticComponent<{
     /**
      * Set the content of the badge.
@@ -2175,6 +2777,13 @@ declare const mapModifierToCode: {
         shift: string;
     };
 };
+/**
+ * Inline text representing keyboard input.
+ *
+ * @category data-display
+ * @since 0.1.0
+ * @extends Code
+ */
 declare const Kbd: react.ForwardRefExoticComponent<{
     variant?: "outline" | "subtle" | undefined;
 } & {
@@ -2195,6 +2804,12 @@ type LabelMenuButtonProps = ComponentPropsWithoutRef<typeof ButtonRoot> & {
     label: string;
     size?: never;
 };
+/**
+ * Button displaying both a label and value, used as the trigger for Select
+ * components.
+ *
+ * @group Button
+ */
 declare const LabelMenuButton: react.ForwardRefExoticComponent<Omit<Omit<NonNullable<Omit<{
     intent?: "danger" | "neutral" | "primary" | undefined;
     size?: "sm" | "md" | "lg" | undefined;
@@ -2240,6 +2855,12 @@ declare namespace layers_css {
 type ModalLayerProps = Pick<ComponentPropsWithoutRef<typeof Box>, "asChild"> & Pick<ComponentPropsWithoutRef<typeof DismissableLayer>, "onEscapeKeyDown"> & {
     children?: ReactNode;
 };
+/**
+ * `ModalLayer` is a helper component intended to wrap components that are
+ * rendered inside portals inside other dialogs or popovers.
+ *
+ * @since 0.7.8
+ */
 declare const ModalLayer: react.ForwardRefExoticComponent<Pick<Omit<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
@@ -2261,6 +2882,12 @@ type NavProps = BoxProps<"nav", {
      */
     onExpandedChange?: (expanded: boolean) => void;
 }>;
+/**
+ * Primary navigation menu that includes support for branding, links, and other navigation items.
+ *
+ * @group Sidebar
+ * @since 0.4.0
+ */
 declare const Nav: react.ForwardRefExoticComponent<{
     /**
      * The initial expanded state in uncontrolled mode.
@@ -2293,6 +2920,9 @@ type NavAccountItemProps = BoxProps<"div", {
      */
     src?: string;
 }>;
+/**
+ * @group Sidebar
+ */
 declare const NavAccountItem: react.ForwardRefExoticComponent<{
     /**
      * The name of the user.
@@ -2312,12 +2942,18 @@ declare const NavAccountItem: react.ForwardRefExoticComponent<{
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLButtonElement>>;
 
 type NavBodyProps = BoxProps<"div">;
+/**
+ * @group Sidebar
+ */
 declare const NavBody: react.ForwardRefExoticComponent<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLDivElement>>;
 
 type NavFooterProps = BoxProps<"div">;
+/**
+ * @group Sidebar
+ */
 declare const NavFooter: react.ForwardRefExoticComponent<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
@@ -2329,6 +2965,10 @@ type NavGroupProps = ComponentPropsWithoutRef<typeof Disclosure> & {
      */
     collapsible?: boolean;
 };
+/**
+ * @extends Disclosure
+ * @group Sidebar
+ */
 declare const NavGroup: react.ForwardRefExoticComponent<Omit<{
     defaultOpen?: boolean;
     onOpenChange?: (open: boolean) => void;
@@ -2344,12 +2984,18 @@ declare const NavGroup: react.ForwardRefExoticComponent<Omit<{
 } & react.RefAttributes<HTMLDivElement>>;
 
 type NavGroupContentProps = BoxProps<"div">;
+/**
+ * @group Sidebar
+ */
 declare const NavGroupContent: react.ForwardRefExoticComponent<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLUListElement>>;
 
 type NavGroupTriggerProps = ComponentPropsWithoutRef<typeof DisclosureTrigger>;
+/**
+ * @group Sidebar
+ */
 declare const NavGroupTrigger: react.ForwardRefExoticComponent<Omit<{
     addonAfter?: react.ReactNode;
     addonBefore?: react.ReactNode;
@@ -2360,6 +3006,9 @@ declare const NavGroupTrigger: react.ForwardRefExoticComponent<Omit<{
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
 
 type NavHeaderProps = BoxProps<"div">;
+/**
+ * @group Sidebar
+ */
 declare const NavHeader: react.ForwardRefExoticComponent<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
@@ -2379,6 +3028,9 @@ type NavItemProps = BoxProps<"button", {
      */
     icon?: ReactNode;
 }>;
+/**
+ * @group Sidebar
+ */
 declare const NavItem: react.ForwardRefExoticComponent<{
     /**
      * Whether the nav item is currently active.
@@ -2398,12 +3050,19 @@ declare const NavItem: react.ForwardRefExoticComponent<{
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLButtonElement>>;
 
 type NavListProps = BoxProps<"div">;
+/**
+ * @group Sidebar
+ */
 declare const NavList: react.ForwardRefExoticComponent<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLUListElement>>;
 
 type NavSeparatorProps = BoxProps<typeof Separator>;
+/**
+ * @extends Separator
+ * @group Sidebar
+ */
 declare const NavSeparator: react.ForwardRefExoticComponent<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
@@ -2440,6 +3099,12 @@ type PaginationProps = BoxProps<"nav", {
      */
     total: number;
 }>;
+/**
+ * Display active page and navigate between multiple pages.
+ *
+ * @category navigation
+ * @since 0.1.0
+ */
 declare const Pagination: react.ForwardRefExoticComponent<{
     /**
      * The default active page in uncontrolled mode.
@@ -2474,6 +3139,11 @@ declare const paper: (props?: {
 type PaperVariants = RecipeVariants<typeof paper>;
 
 type PaperProps = BoxProps<"div", PaperVariants>;
+/**
+ * Paper component for elevated surfaces
+ *
+ * @category layout
+ */
 declare const Paper: react.ForwardRefExoticComponent<{
     elevation?: "dialog" | "menu" | "screen" | undefined;
 } & Omit<NonNullable<Sprinkles & {
@@ -2489,6 +3159,13 @@ declare const indicator: (props?: {
 type ProgressVariants = RecipeVariants<typeof indicator>;
 
 type ProgressProps = BoxProps<typeof ProgressPrimitive.Root> & ProgressVariants;
+/**
+ * Display feedback on status of task or length of a process.
+ *
+ * @since 0.1.0
+ * @category feedback
+ * @category data-display
+ */
 declare const Progress: react.ForwardRefExoticComponent<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
@@ -2502,6 +3179,12 @@ type RadioProps = BoxProps<typeof ToggleInputHiddenInput, {
      */
     description?: ReactNode;
 }>;
+/**
+ * Basic control to allow selecting only one item from a set.
+ *
+ * @since 0.1.0
+ * @group RadioGroup
+ */
 declare const Radio: react.ForwardRefExoticComponent<{
     /**
      * Add secondary text after the label.
@@ -2549,6 +3232,12 @@ type RadioGroupProps = BoxProps<"div", {
     value?: string;
 }>;
 type InputProps = ComponentPropsWithoutRef<"input">;
+/**
+ * Basic control to allow selecting only one item from a set.
+ *
+ * @category form
+ * @since 0.1.0
+ */
 declare const RadioGroup: react.ForwardRefExoticComponent<{
     /**
      * The initial selected value in uncontrolled mode.
@@ -2593,6 +3282,13 @@ type SearchInputProps = ComponentPropsWithRef<typeof Input> & {
      */
     onValueClear?: () => void;
 };
+/**
+ * Basic search input field with clear button.
+ *
+ * @category form
+ * @since 0.1.0
+ * @extends Input
+ */
 declare const SearchInput: react.ForwardRefExoticComponent<Omit<SearchInputProps, "ref"> & react.RefAttributes<HTMLInputElement>>;
 
 type SegmentedControlProps = BoxProps<typeof RadixSegmentedControl.Root, {
@@ -2601,6 +3297,14 @@ type SegmentedControlProps = BoxProps<typeof RadixSegmentedControl.Root, {
      */
     type?: "multiple" | "single";
 }>;
+/**
+ * Toggle buttons for switching between different values or views.
+ *
+ * @group SegmentedControl
+ * @category actions
+ * @category form
+ * @since 0.2.0
+ */
 declare const SegmentedControl: react.ForwardRefExoticComponent<{
     /**
      * Whether to allow multiple values or only activate one item at a time.
@@ -2612,6 +3316,10 @@ declare const SegmentedControl: react.ForwardRefExoticComponent<{
 }>, never> & Omit<NonNullable<Omit<RadixSegmentedControl.ToggleGroupSingleProps & react.RefAttributes<HTMLDivElement>, "ref"> | Omit<RadixSegmentedControl.ToggleGroupMultipleProps & react.RefAttributes<HTMLDivElement>, "ref">>, "color" | "asChild" | "className" | "type"> & react.RefAttributes<HTMLDivElement>>;
 
 type SegmentedControlItemProps = ButtonProps<typeof RadixSegmentedControl.Item>;
+/**
+ * @group SegmentedControl
+ * @extends Button
+ */
 declare const SegmentedControlItem: react.ForwardRefExoticComponent<Omit<{
     addonAfter?: react.ReactNode;
     addonBefore?: react.ReactNode;
@@ -2731,11 +3439,25 @@ type SelectProps = {
      */
     value?: string;
 };
+/**
+ * Form input for selecting a value from a dropdown list. Use this to capture
+ * user input in forms as an alternative to radios when you have many options.
+ *
+ * Use this for form inputs only. For action menus or multi-select dropdowns,
+ * use Menu instead.
+ *
+ * @group Select
+ * @category form
+ * @since 1.4.0
+ */
 declare const Select: react.ForwardRefExoticComponent<SelectProps & react.RefAttributes<HTMLSelectElement>>;
 
 type SelectContentProps = ExcludeProps<BoxProps<typeof PopperContent, Pick<ComponentPropsWithoutRef<typeof ModalListbox>, "maxH" | "minW"> & {
     children?: ((item: SelectOption) => ReactNode) | ReactNode;
 }>, "alignOffset" | "arrowPadding" | "avoidCollisions" | "collisionBoundary" | "collisionPadding" | "hideWhenDetached" | "onPlaced" | "sideOffset" | "sticky" | "updatePositionStrategy">;
+/**
+ * @group Select
+ */
 declare const SelectContent: react.ForwardRefExoticComponent<SelectContentProps & react.RefAttributes<HTMLDivElement>>;
 
 type SelectTriggerProps = ExcludeProps<ButtonProps<"button", {
@@ -2744,6 +3466,10 @@ type SelectTriggerProps = ExcludeProps<ButtonProps<"button", {
      */
     placeholder?: string;
 }>, "disabled">;
+/**
+ * @group Select
+ * @extends Button
+ */
 declare const SelectTrigger: react.ForwardRefExoticComponent<SelectTriggerProps & react.RefAttributes<HTMLButtonElement>>;
 
 type SidebarProps = BoxProps<"div", {
@@ -2760,6 +3486,13 @@ type SidebarProps = BoxProps<"div", {
      */
     onExpandedChange?: (expanded: boolean) => void;
 }>;
+/**
+ * Primary navigation menu for left side of the page that includes support for branding, links, etc.
+ *
+ * @group Sidebar
+ * @category navigation
+ * @since 0.4.0
+ */
 declare const Sidebar: react.ForwardRefExoticComponent<{
     /**
      * The initial expanded state in uncontrolled mode.
@@ -2781,25 +3514,47 @@ declare const Sidebar: react.ForwardRefExoticComponent<{
 type SidebarToggleProps = Omit<ComponentPropsWithRef<typeof NavItem>, "aria-label"> & {
     "aria-label"?: string;
 };
+/**
+ * @group Sidebar
+ */
 declare const SidebarToggle: react.ForwardRefExoticComponent<Omit<SidebarToggleProps, "ref"> & react.RefAttributes<HTMLButtonElement>>;
 
 type SkeletonProps = BoxProps<"span", {
     children?: ReactElement;
     /**
-     * Render skeleton as a circle if `true`.
+     * Render skeleton as a circle if `true`. When enabled, automatically sets
+     * rounded="full".
      */
     circle?: boolean;
+    /**
+     * Border radius of the skeleton. Defaults to "sm" for regular shapes,
+     * automatically set to "full" when circle={true}.
+     */
+    rounded?: BoxProps["rounded"];
 }>;
+/**
+ * Display placeholder content while data is loading.
+ *
+ * @category feedback
+ * @category layout
+ * @since 0.1.0
+ */
 declare const Skeleton: react.ForwardRefExoticComponent<{
     children?: ReactElement;
     /**
-     * Render skeleton as a circle if `true`.
+     * Render skeleton as a circle if `true`. When enabled, automatically sets
+     * rounded="full".
      */
     circle?: boolean;
+    /**
+     * Border radius of the skeleton. Defaults to "sm" for regular shapes,
+     * automatically set to "full" when circle={true}.
+     */
+    rounded?: BoxProps["rounded"];
 } & Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
-}>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, "ref">, "color" | "className" | "children"> & react.RefAttributes<HTMLSpanElement>>;
+}>, "rounded"> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, "ref">, "color" | "className" | "children"> & react.RefAttributes<HTMLSpanElement>>;
 
 type SpinnerProps = BoxProps<"div", {
     /**
@@ -2807,6 +3562,12 @@ type SpinnerProps = BoxProps<"div", {
      */
     appearance?: "default" | "inverse";
 }>;
+/**
+ * Used for indicating an unspecified wait time.
+ *
+ * @category feedback
+ * @since 0.1.0
+ */
 declare const Spinner: react.ForwardRefExoticComponent<{
     /**
      * Control the appearance depending on whether the spinner is placed on a light/dark background.
@@ -2818,21 +3579,45 @@ declare const Spinner: react.ForwardRefExoticComponent<{
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLDivElement>>;
 
 type SubNavProps = BoxProps<"nav">;
+/**
+ * @group Sidebar
+ */
 declare const SubNav: react.ForwardRefExoticComponent<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
 }>, never> & Omit<Omit<react.DetailedHTMLProps<react.HTMLAttributes<HTMLElement>, HTMLElement>, "ref">, "color" | "className"> & react.RefAttributes<HTMLDivElement>>;
 
 type TabsProps = BoxProps<typeof RadixTabs.Root>;
+/**
+ * Tabs organize content into multiple sections with horizontal navigation.
+ *
+ * Use this component when users need to switch between different views of
+ * related content. Don't manually build tab navigation with multiple Buttons in
+ * a Flex - Tabs handles state management, active states, keyboard navigation,
+ * and accessibility automatically.
+ *
+ * When not to use:
+ * - For primary/vertical navigation use Sidebar instead.
+ *
+ * @group Tabs
+ * @since 0.1.0
+ * @category navigation
+ */
 declare const Tabs: react.ForwardRefExoticComponent<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
 }>, never> & Omit<Omit<RadixTabs.TabsProps & react.RefAttributes<HTMLDivElement>, "ref">, "color" | "asChild" | "className"> & react.RefAttributes<HTMLDivElement>>;
 
 type TabsContentProps = ExcludeProps<BoxProps<typeof RadixTabs.TabsContent>, "forceMount">;
+/**
+ * @group Tabs
+ */
 declare const TabsContent: react.ForwardRefExoticComponent<TabsContentProps & react.RefAttributes<HTMLDivElement>>;
 
 type TabsListProps = BoxProps<typeof RadixTabs.List>;
+/**
+ * @group Tabs
+ */
 declare const TabsList: react.ForwardRefExoticComponent<Omit<NonNullable<Sprinkles & {
     asChild?: boolean;
     className?: string;
@@ -2848,6 +3633,10 @@ type TabsTriggerProps = BoxProps<typeof RadixTabs.Trigger, {
      */
     addonBefore?: ReactNode;
 }>;
+/**
+ * @extends Button
+ * @group Tabs
+ */
 declare const TabsTrigger: react.ForwardRefExoticComponent<{
     /**
      * Display content inside the button after `children`.
@@ -2881,6 +3670,12 @@ type TextareaProps = InputControlProps<typeof TextareaAutosize, Pick<ComponentPr
     addonBefore?: ReactNode;
     size?: never;
 }>;
+/**
+ * Multi-line text field for capturing user input.
+ *
+ * @category form
+ * @since 0.1.0
+ */
 declare const Textarea: react.ForwardRefExoticComponent<Pick<Omit<Pick<{
     addonPointerEvents?: "auto" | "none";
     inputRef: react.RefObject<HTMLInputElement & HTMLTextAreaElement>;
@@ -2927,6 +3722,13 @@ declare const Textarea: react.ForwardRefExoticComponent<Pick<Omit<Pick<{
 type ThemeProviderProps = {
     children?: ReactNode;
 };
+/**
+ * Provider component for theme tokens and styles. This is included in
+ * AxiomProvider by default - you only need to use this component directly for
+ * advanced customization.
+ *
+ * @category provider
+ */
 declare function ThemeProvider({ children }: ThemeProviderProps): react_jsx_runtime.JSX.Element;
 declare namespace ThemeProvider {
     var displayName: string;
@@ -2938,6 +3740,13 @@ type ToggleButtonProps = ButtonProps<typeof RadixToggle.Root, {
      */
     appearance?: "default" | "subtle";
 }>;
+/**
+ * `ToggleButton` component represents a button that can be toggled on or off.
+ *
+ * @category actions
+ * @since 0.1.0
+ * @extends Button
+ */
 declare const ToggleButton: react.ForwardRefExoticComponent<{
     /**
      * Control the appearance by selecting between the different button types.
@@ -2984,6 +3793,11 @@ type TransitionProps = TransitionVariants & {
      */
     type?: "fade" | "pop";
 };
+/**
+ * Component for animating element transitions with fade and pop effects.
+ *
+ * @category animation
+ */
 declare const Transition: react.ForwardRefExoticComponent<{
     duration?: "sm" | "md" | "lg" | undefined;
 } & {
@@ -3006,6 +3820,11 @@ declare const TransitionGlobalConfig: {
     skipAnimations: boolean;
 };
 
+/**
+ * Manages the presence and animation lifecycle of children during transitions.
+ *
+ * @category animation
+ */
 declare function TransitionGroup({ children, forceMount, onPresenceChange, open: openProp, presence: presenceProp, }: {
     children?: ReactNode;
     forceMount?: boolean;
@@ -3017,5 +3836,5 @@ declare namespace TransitionGroup {
     var displayName: string;
 }
 
-export { Alert, AlertDialog, AlertDialogAction, AlertDialogBody, AlertDialogCancel, AlertDialogContent, AlertDialogFooter, AlertDialogHeader, AlertDialogTrigger, AngleMenuButton, AuthProvider, Avatar, AvatarGroup, AxiomProvider, Badge, Banner, Box, BoxProps, Breadcrumb, Button, ButtonGroup, ButtonProps, Card, CardAction, CardCheckbox, CardFooter, CardHeader, CardImage, CardLink, CardPreview, Checkbox, Code, Cover, DataTable, DataTableAction, DataTableBody, DataTableCheckbox, DataTableFooter, DataTableLabel, DateInput, DateRangePicker, DateRangePickerContent, DateRangePickerTrigger, Dialog, DialogBody, DialogClose, DialogFooter, DialogForm, DialogHeader, DialogTrigger, Disclosure, DisclosureContent, DisclosureTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EllipsisMenuButton, Field, FieldLabel, Flex, Grid, Heading, Indicator, Input, InputAddon, InputControl, InputRoot, Kbd, LabelMenuButton, Link, Listbox, ListboxCheckboxItem, ListboxEmpty, ListboxGroup, ListboxItem, ListboxItemIndicator, ListboxItemized, ListboxLabel, ListboxRadioItem, ListboxSeparator, ListboxSwitchItem, ModalLayer, Nav, NavAccountItem, NavBody, NavFooter, NavGroup, NavGroupContent, NavGroupTrigger, NavHeader, NavItem, NavList, NavSeparator, Pagination, Paper, Popover, PopoverAnchor, PopoverContent, PopoverContentProps, PopoverTrigger, Progress, Radio, RadioGroup, SearchInput, SegmentedControl, SegmentedControlItem, Select, SelectContent, SelectTrigger, Separator, Sidebar, SidebarToggle, Skeleton, Spinner, Sprinkles, SubNav, Switch, Table, TableAction, TableBody, TableCell, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Text, Textarea, ThemeProvider, Toast, ToastAction, ToastProvider, ToastTitle, ToggleButton, Tooltip, TooltipContent, TooltipProvider, TooltipRoot, TooltipTrigger, Transition, TransitionGlobalConfig, TransitionGroup, cleanup, extractBoxProps, layers_css as layers, sprinklesMerge, useAuthContext };
-export type { AlertDialogActionProps, AlertDialogBodyProps, AlertDialogCancelProps, AlertDialogContentProps, AlertDialogFooterProps, AlertDialogHeaderProps, AlertDialogProps, AlertDialogTriggerProps, AlertProps, AngleMenuButtonProps, AuthProviderProps, AvatarGroupProps, AvatarProps, AxiomProviderProps, BadgeProps, BannerProps, BreadcrumbItem, BreadcrumbProps, ButtonGroupProps, CardActionProps, CardCheckboxProps, CardFooterProps, CardHeaderProps, CardImageProps, CardLinkProps, CardPreviewProps, CardProps, CheckboxProps, CodeProps, CoverProps, DataTableActionProps, DataTableBodyProps, DataTableCheckboxProps, DataTableFooterProps, DataTableLabelProps, DataTableProps, DateInputProps, DateRangePickerContentProps, DateRangePickerProps, DateRangePickerTriggerProps, DialogBodyProps, DialogCloseProps, DialogFooterProps, DialogFormProps, DialogHeaderProps, DialogProps, DialogTriggerProps, DisclosureContentProps, DisclosureProps, DisclosureTriggerProps, DropdownMenuCheckboxItemProps, DropdownMenuContentProps, DropdownMenuGroupProps, DropdownMenuItemProps, DropdownMenuLabelProps, DropdownMenuProps, DropdownMenuSeparatorProps, DropdownMenuSubContentProps, DropdownMenuSubProps, DropdownMenuSubTriggerProps, DropdownMenuTriggerProps, EllipsisMenuButtonProps, FieldLabelProps, FieldProps, GridProps, HeadingProps, IndicatorProps, InputAddonProps, InputControlProps, InputProps$1 as InputProps, InputRootProps, KbdProps, LabelMenuButtonProps, LinkProps, ListboxCheckboxItemProps, ListboxEmptyProps, ListboxGroupProps, ListboxItemIndicatorProps, ListboxItemProps, ListboxItemizedProps, ListboxLabelProps, ListboxProps, ListboxRadioItemProps, ListboxSeparatorProps, ListboxSwitchItemProps, ModalLayerProps, NavAccountItemProps, NavBodyProps, NavFooterProps, NavGroupContentProps, NavGroupProps, NavGroupTriggerProps, NavHeaderProps, NavItemProps, NavListProps, NavProps, NavSeparatorProps, PaginationProps, PaperProps, PopoverAnchorProps, PopoverProps, ProgressProps, RadioGroupProps, RadioProps, SearchInputProps, SegmentedControlItemProps, SegmentedControlProps, SelectContentProps, SelectProps, SelectTriggerProps, SeparatorProps, SidebarProps, SidebarToggleProps, SkeletonProps, SpinnerProps, SubNavProps, SwitchProps, TableActionProps, TableBodyProps, TableCellProps, TableHeaderProps, TableProps, TableRowProps, TabsContentProps, TabsListProps, TabsProps, TabsTriggerProps, TextProps, TextareaProps, ThemeProviderProps, ToastActionProps, ToastProps, ToastProviderProps$1 as ToastProviderProps, ToastTitleProps, ToggleButtonProps, TooltipContentProps, TooltipProps, TooltipProviderProps$1 as TooltipProviderProps, TooltipRootProps, TooltipTriggerProps, TransitionProps };
+export { Alert, AlertDialog, AlertDialogAction, AlertDialogBody, AlertDialogCancel, AlertDialogContent, AlertDialogFooter, AlertDialogHeader, AlertDialogTrigger, AngleMenuButton, AuthProvider, Avatar, AvatarGroup, AxiomProvider, Badge, Banner, Box, BoxProps, Breadcrumb, Button, ButtonGroup, ButtonProps, Card, CardAction, CardCheckbox, CardFooter, CardHeader, CardImage, CardLink, CardPreview, Checkbox, Code, Cover, DataTable, DataTableAction, DataTableBody, DataTableCheckbox, DataTableFooter, DataTableLabel, DateInput, DateRangePicker, DateRangePickerContent, DateRangePickerTrigger, Dialog, DialogBody, DialogClose, DialogFooter, DialogForm, DialogHeader, DialogTrigger, Disclosure, DisclosureContent, DisclosureTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EllipsisMenuButton, Field, FieldLabel, Flex, Grid, Group, Heading, Indicator, Input, InputAddon, InputControl, InputRoot, Kbd, LabelMenuButton, Link, Listbox, ListboxCheckboxItem, ListboxEmpty, ListboxGroup, ListboxItem, ListboxItemIndicator, ListboxItemized, ListboxLabel, ListboxRadioItem, ListboxSeparator, ListboxSwitchItem, ModalLayer, Nav, NavAccountItem, NavBody, NavFooter, NavGroup, NavGroupContent, NavGroupTrigger, NavHeader, NavItem, NavList, NavSeparator, Pagination, Paper, Popover, PopoverAnchor, PopoverContent, PopoverContentProps, PopoverTrigger, Progress, Radio, RadioGroup, SearchInput, SegmentedControl, SegmentedControlItem, Select, SelectContent, SelectTrigger, Separator, Sidebar, SidebarToggle, Skeleton, Spinner, Sprinkles, SubNav, Switch, Table, TableAction, TableBody, TableCell, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Text, Textarea, ThemeProvider, ToastProvider, ToggleButton, Tooltip, TooltipContent, TooltipProvider, TooltipRoot, TooltipTrigger, Transition, TransitionGlobalConfig, TransitionGroup, cleanup, extractBoxProps, layers_css as layers, sprinklesMerge, useAuthContext };
+export type { AlertDialogActionProps, AlertDialogBodyProps, AlertDialogCancelProps, AlertDialogContentProps, AlertDialogFooterProps, AlertDialogHeaderProps, AlertDialogProps, AlertDialogTriggerProps, AlertProps, AngleMenuButtonProps, AuthProviderProps, AvatarGroupProps, AvatarProps, AxiomProviderProps, BadgeProps, BannerProps, BreadcrumbProps, ButtonGroupProps, CardActionProps, CardCheckboxProps, CardFooterProps, CardHeaderProps, CardImageProps, CardLinkProps, CardPreviewProps, CardProps, CheckboxProps, CodeProps, CoverProps, DataTableActionProps, DataTableBodyProps, DataTableCheckboxProps, DataTableFooterProps, DataTableLabelProps, DataTableProps, DateInputProps, DateRangePickerContentProps, DateRangePickerProps, DateRangePickerTriggerProps, DialogBodyProps, DialogCloseProps, DialogFooterProps, DialogFormProps, DialogHeaderProps, DialogProps, DialogTriggerProps, DisclosureContentProps, DisclosureProps, DisclosureTriggerProps, DropdownMenuCheckboxItemProps, DropdownMenuContentProps, DropdownMenuGroupProps, DropdownMenuItemProps, DropdownMenuLabelProps, DropdownMenuProps, DropdownMenuSeparatorProps, DropdownMenuSubContentProps, DropdownMenuSubProps, DropdownMenuSubTriggerProps, DropdownMenuTriggerProps, EllipsisMenuButtonProps, FieldLabelProps, FieldProps, FlexProps, GridProps, HeadingProps, IndicatorProps, InputAddonProps, InputControlProps, InputProps$1 as InputProps, InputRootProps, KbdProps, LabelMenuButtonProps, LinkProps, ListboxCheckboxItemProps, ListboxEmptyProps, ListboxGroupProps, ListboxItemIndicatorProps, ListboxItemProps, ListboxItemizedProps, ListboxLabelProps, ListboxProps, ListboxRadioItemProps, ListboxSeparatorProps, ListboxSwitchItemProps, ModalLayerProps, NavAccountItemProps, NavBodyProps, NavFooterProps, NavGroupContentProps, NavGroupProps, NavGroupTriggerProps, NavHeaderProps, NavItemProps, NavListProps, NavProps, NavSeparatorProps, PaginationProps, PaperProps, PopoverAnchorProps, PopoverProps, ProgressProps, RadioGroupProps, RadioProps, SearchInputProps, SegmentedControlItemProps, SegmentedControlProps, SelectContentProps, SelectProps, SelectTriggerProps, SeparatorProps, SidebarProps, SidebarToggleProps, SkeletonProps, SpinnerProps, SubNavProps, SwitchProps, TableActionProps, TableBodyProps, TableCellProps, TableHeaderProps, TableProps, TableRowProps, TabsContentProps, TabsListProps, TabsProps, TabsTriggerProps, TextProps, TextareaProps, ThemeProviderProps, ToastProviderProps$1 as ToastProviderProps, ToggleButtonProps, TooltipContentProps, TooltipProps, TooltipProviderProps$1 as TooltipProviderProps, TooltipRootProps, TooltipTriggerProps, TransitionProps };