@geomak/ui 5.5.3 → 5.7.0

package/dist/index.d.cts

@@ -1,6 +1,7 @@
 export { C as COLORS, S as SemanticColorKey, a as SemanticSharedKey, V as VarColorKey, b as VarDensityKey, c as VarMotionKey, d as VarRadiusKey, e as VarShadowKey, f as VarTypoKey, g as VarZIndexKey, P as palette, s as semanticTokens, v as vars } from './index-CvyV3YPI.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import React$1 from 'react';
+import * as React$1 from 'react';
+import React__default from 'react';
 import * as TooltipPrimitive from '@radix-ui/react-tooltip';
 
 declare const Icon: {
@@ -252,7 +253,7 @@ declare const Icon: {
 
 interface PortalProps {
     /** Content to render at the target node. */
-    children: React$1.ReactNode;
+    children: React__default.ReactNode;
     /**
      * Where to mount the portal.
      * - omitted / `undefined` → `document.body` (the safe default for viewport-anchored UI)
@@ -337,7 +338,7 @@ interface PortalProps {
  * </Portal>
  * ```
  */
-declare function Portal({ children, target }: PortalProps): React$1.ReactPortal;
+declare function Portal({ children, target }: PortalProps): React__default.ReactPortal;
 
 type Spacing = 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
 type BoxBackground = 'none' | 'background' | 'surface' | 'surface-raised' | 'accent';
@@ -345,7 +346,7 @@ type BoxBorder = 'none' | 'border' | 'border-strong' | 'accent' | 'status-error'
 type BoxRadius = 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | 'full';
 type BoxShadow = 'none' | 'sm' | 'md' | 'lg' | 'xl';
 interface BoxProps {
-    as?: keyof React$1.JSX.IntrinsicElements;
+    as?: keyof React__default.JSX.IntrinsicElements;
     /** Padding shorthand — applies to all sides. */
     p?: Spacing;
     /** Horizontal padding (left + right). */
@@ -373,10 +374,10 @@ interface BoxProps {
     /** Height via Tailwind class or CSS value. */
     height?: string | number;
     /** Click handler — accepts any element-typed handler. */
-    onClick?: React$1.MouseEventHandler<HTMLElement>;
+    onClick?: React__default.MouseEventHandler<HTMLElement>;
     className?: string;
-    style?: React$1.CSSProperties;
-    children?: React$1.ReactNode;
+    style?: React__default.CSSProperties;
+    children?: React__default.ReactNode;
 }
 /**
  * A polymorphic layout primitive — a `<div>` (by default) styled via prop
@@ -498,7 +499,7 @@ interface AvatarProps {
      * - any ReactNode (icon, emoji)
      * - omit entirely — a generic "person" silhouette is used
      */
-    fallback?: React$1.ReactNode;
+    fallback?: React__default.ReactNode;
     /** Size preset. Default `'md'`. */
     size?: AvatarSize;
     /** Circle (default) or rounded square. */
@@ -554,7 +555,7 @@ interface TypographyProps {
      * with `as` when the semantic element should differ from the visual
      * style (e.g. a styled-as-h1 product card heading rendered as `<div>`).
      */
-    as?: keyof React$1.JSX.IntrinsicElements;
+    as?: keyof React__default.JSX.IntrinsicElements;
     color?: TypographyColor;
     weight?: TypographyWeight;
     align?: TypographyAlign;
@@ -563,8 +564,8 @@ interface TypographyProps {
     /** Render the text with reduced opacity (useful for disabled states). */
     muted?: boolean;
     className?: string;
-    style?: React$1.CSSProperties;
-    children?: React$1.ReactNode;
+    style?: React__default.CSSProperties;
+    children?: React__default.ReactNode;
 }
 /**
  * Polymorphic typography primitive. `variant` picks a visual scale; `as`
@@ -643,8 +644,8 @@ interface ModalProps {
     okText?: string;
     cancelText?: string;
     hasFooter?: boolean;
-    title?: React$1.ReactNode;
-    children?: React$1.ReactNode;
+    title?: React__default.ReactNode;
+    children?: React__default.ReactNode;
 }
 /**
  * Centred modal dialog powered by Radix Dialog + Framer Motion.
@@ -671,8 +672,8 @@ interface DrawerProps {
     cancelText?: string;
     onOk?: () => void;
     onCancel?: () => void;
-    title?: React$1.ReactNode;
-    children?: React$1.ReactNode;
+    title?: React__default.ReactNode;
+    children?: React__default.ReactNode;
 }
 /**
  * Side-sliding drawer panel powered by Radix Dialog + Framer Motion.
@@ -689,9 +690,9 @@ interface DrawerProps {
 declare function Drawer({ isOpen, onClose, hasFooter, placement, width, okText, cancelText, onOk, onCancel, title, children, }: DrawerProps): react_jsx_runtime.JSX.Element;
 
 interface TooltipProps {
-    children: React$1.ReactNode;
+    children: React__default.ReactNode;
     /** The text or node shown inside the tooltip */
-    title: React$1.ReactNode;
+    title: React__default.ReactNode;
     /** Which side of the trigger the tooltip appears on */
     placement?: 'top' | 'right' | 'bottom' | 'left';
     /** Delay before showing, ms (default 300) */
@@ -716,12 +717,12 @@ interface TooltipProps {
  */
 declare function Tooltip({ children, title, placement, delayDuration, sideOffset, }: TooltipProps): react_jsx_runtime.JSX.Element;
 
-declare const TooltipProvider: React$1.FC<TooltipPrimitive.TooltipProviderProps>;
+declare const TooltipProvider: React__default.FC<TooltipPrimitive.TooltipProviderProps>;
 
 interface TabItem {
     key: string;
-    title: React$1.ReactNode;
-    content: React$1.ReactNode;
+    title: React__default.ReactNode;
+    content: React__default.ReactNode;
 }
 interface TabsProps {
     tabs?: TabItem[];
@@ -792,8 +793,8 @@ declare function Tree({ nodes, onNodeClick, defaultExpandAll, defaultExpandedKey
 type NotificationType = 'info' | 'success' | 'warning' | 'danger';
 type NotificationPosition = 'top-right' | 'top-left' | 'top-center' | 'bottom-right' | 'bottom-left' | 'bottom-center';
 interface NotificationPayload {
-    title: React$1.ReactNode;
-    description?: React$1.ReactNode;
+    title: React__default.ReactNode;
+    description?: React__default.ReactNode;
     /** Auto-dismiss duration in ms (default 4000). Pass `Infinity` to disable auto-dismiss. */
     duration?: number;
     type?: NotificationType;
@@ -815,7 +816,7 @@ interface NotificationPayload {
  * success({ title: 'Saved', description: 'Changes were stored.' })
  */
 declare function NotificationProvider({ children, position, }: {
-    children: React$1.ReactNode;
+    children: React__default.ReactNode;
     position?: NotificationPosition;
 }): react_jsx_runtime.JSX.Element;
 /** ─────────────────── hook ─────────────────── */
@@ -914,7 +915,7 @@ interface FadingBaseProps {
     className?: string;
     /** Controls mount/unmount with fade transition */
     isMounted?: boolean;
-    children?: React$1.ReactNode;
+    children?: React__default.ReactNode;
 }
 /**
  * Fade-in / fade-out page container.
@@ -936,16 +937,16 @@ interface ListItem {
     /** Stable key for React reconciliation + active-key matching. */
     key: string | number;
     /** Main item text (title). Required. */
-    label: React$1.ReactNode;
+    label: React__default.ReactNode;
     /** Optional description rendered below the label, in foreground-secondary. */
-    description?: React$1.ReactNode;
+    description?: React__default.ReactNode;
     /**
      * Optional leading slot, typically an Avatar. Anything React-renderable
      * is accepted (icon, image, status badge…).
      */
-    avatar?: React$1.ReactNode;
+    avatar?: React__default.ReactNode;
     /** Optional trailing slot, e.g. a badge, count, or action icon. */
-    trailing?: React$1.ReactNode;
+    trailing?: React__default.ReactNode;
     /** Disable interaction for this item only. */
     disabled?: boolean;
 }
@@ -1001,26 +1002,26 @@ declare function List({ items, onItemClick, activeKey, density, }: ListProps): r
 
 interface ScalableContainerProps {
     /** Resting width. Any CSS length / percent. Default `'100%'`. */
-    width?: React$1.CSSProperties['width'];
+    width?: React__default.CSSProperties['width'];
     /** Resting height. Any CSS length / percent. Default `'auto'`. */
-    height?: React$1.CSSProperties['height'];
+    height?: React__default.CSSProperties['height'];
     /** Width when expanded. Default `'100%'` (fills parent). */
-    expandedWidth?: React$1.CSSProperties['width'];
+    expandedWidth?: React__default.CSSProperties['width'];
     /** Height when expanded. Default `'100%'`. Set a concrete value (e.g. 420)
      *  when the container lives in normal flow and should push siblings down. */
-    expandedHeight?: React$1.CSSProperties['height'];
+    expandedHeight?: React__default.CSSProperties['height'];
     /** Controlled expanded state. */
     expanded?: boolean;
     /** Fires when the user toggles. */
     onExpandedChange?: (expanded: boolean) => void;
     /** Content to render inside. */
-    children?: React$1.ReactNode;
+    children?: React__default.ReactNode;
     /** CSS class appended to the expanded children wrapper. */
     assignClassOnClick?: string;
     /** Override the expand-button icon. */
-    expandIcon?: React$1.ReactNode;
+    expandIcon?: React__default.ReactNode;
     /** Override the collapse-button icon. */
-    collapseIcon?: React$1.ReactNode;
+    collapseIcon?: React__default.ReactNode;
     /**
      * Position of the toggle button inside the container.
      * Default `'top-right'` — matches the OS-window convention.
@@ -1056,10 +1057,10 @@ declare function ScalableContainer({ width, height, expandedWidth, expandedHeigh
 
 interface GridCardItem {
     key: string | number;
-    title: React$1.ReactNode;
-    description?: React$1.ReactNode;
+    title: React__default.ReactNode;
+    description?: React__default.ReactNode;
     /** Image URL or JSX element */
-    cover?: string | React$1.ReactNode;
+    cover?: string | React__default.ReactNode;
     enabled?: boolean;
     /** Arbitrary route or payload — passed back to onOpen */
     to?: string;
@@ -1147,10 +1148,10 @@ declare function Catalog({ display, items, buttonText, onOpen }: CatalogProps):
  *   announce them as disabled.
  */
 interface ContextMenuActionItem {
-    key: React$1.Key;
+    key: React__default.Key;
     /** Label shown for the item. May be plain text or a node. */
-    value: React$1.ReactNode;
-    icon?: React$1.ReactNode;
+    value: React__default.ReactNode;
+    icon?: React__default.ReactNode;
     /** Fires when the item is activated. Ignored when `children` is set. */
     onClick?: () => void;
     /** Optional sub-menu items. */
@@ -1166,7 +1167,7 @@ interface ContextMenuProps {
      * subtree underneath becomes the trigger area. Wrap an existing
      * component / div / image — anything you can right-click on.
      */
-    children: React$1.ReactNode;
+    children: React__default.ReactNode;
 }
 /**
  * Right-click context menu, built on `@radix-ui/react-context-menu`.
@@ -1214,9 +1215,9 @@ interface ContextMenuPosition {
 
 interface WizardStep {
     /** Ref to the DOM element to highlight for this step. */
-    stepRef: React$1.RefObject<HTMLElement | null>;
+    stepRef: React__default.RefObject<HTMLElement | null>;
     /** Tooltip body content. */
-    description: React$1.ReactNode;
+    description: React__default.ReactNode;
     /**
      * Tooltip placement relative to the highlighted element.
      * - `'right'`  (default) — to the right of the highlight
@@ -1226,11 +1227,11 @@ interface WizardStep {
      */
     placement?: 'right' | 'left' | 'top' | 'bottom';
     /** Optional heading for the step's tooltip. */
-    title?: React$1.ReactNode;
+    title?: React__default.ReactNode;
 }
 interface WizardProps {
     /** The wrapped subtree — refs in `steps` point into this tree. */
-    children: React$1.ReactNode;
+    children: React__default.ReactNode;
     /** Ordered list of steps to walk the user through. */
     steps: WizardStep[];
     /**
@@ -1314,12 +1315,12 @@ declare function Wizard({ children, steps, storageKey, dismissible, onComplete,
  */
 interface TableColumn<T extends Record<string, any> = Record<string, any>> {
     /** React reconciliation key for the column itself. */
-    key: React$1.Key;
-    label: React$1.ReactNode;
+    key: React__default.Key;
+    label: React__default.ReactNode;
     /** Property on the row to read for this column. */
     keyBind: keyof T & string;
     /** Custom cell renderer. Receives the cell value and the full row. */
-    component?: (cellValue: T[keyof T], row: T) => React$1.ReactNode;
+    component?: (cellValue: T[keyof T], row: T) => React__default.ReactNode;
     /** Explicit column width (CSS length or px number). Optional — defaults to auto. */
     width?: string | number;
     /** Text alignment for both header and cells. Defaults to `'center'`. */
@@ -1346,8 +1347,8 @@ interface PaginationOptions {
 }
 interface ExpandRowOptions<T extends Record<string, any> = Record<string, any>> {
     enabled?: boolean;
-    expandIcon?: React$1.ReactNode;
-    expandComponent?: (row: T) => React$1.ReactNode;
+    expandIcon?: React__default.ReactNode;
+    expandComponent?: (row: T) => React__default.ReactNode;
 }
 interface TableProps<T extends Record<string, any> = Record<string, any>> {
     columns?: TableColumn<T>[];
@@ -1359,12 +1360,12 @@ interface TableProps<T extends Record<string, any> = Record<string, any>> {
      * explicit getter (e.g. `(row) => row.id`) if rows can be reordered or
      * filtered while expand state should persist.
      */
-    getRowKey?: (row: T, index: number) => React$1.Key;
+    getRowKey?: (row: T, index: number) => React__default.Key;
     pagination?: PaginationOptions;
     expandRow?: ExpandRowOptions<T>;
     hasSearch?: boolean;
-    footer?: React$1.ReactNode;
-    header?: React$1.ReactNode;
+    footer?: React__default.ReactNode;
+    header?: React__default.ReactNode;
     /**
      * When `true`, the body renders skeleton rows (one per column with the
      * shared shimmer animation) instead of data. Use during initial data
@@ -1443,17 +1444,17 @@ declare function ThemeSwitch({ checked, onChange, label }: ThemeSwitchProps): re
 
 interface TopBarProps {
     /** Brand area — logo, wordmark, or app name. Rendered on the leading edge. */
-    brand?: React$1.ReactNode;
+    brand?: React__default.ReactNode;
     /**
      * Centre content — primary navigation links, breadcrumb, or page title.
      * On mobile (< md breakpoint) this moves below the brand row.
      */
-    center?: React$1.ReactNode;
+    center?: React__default.ReactNode;
     /**
      * Trailing actions — theme toggle, user avatar, notification bell, etc.
      * Rendered on the trailing edge.
      */
-    actions?: React$1.ReactNode;
+    actions?: React__default.ReactNode;
     /**
      * Height in pixels (default 56). Controls the `h-*` style directly so
      * child scroll-offset calculations can consume it as a CSS var.
@@ -1491,7 +1492,7 @@ declare function TopBar({ brand, center, actions, height, className, }: TopBarPr
 /** ─────────────────── types ─────────────────── */
 interface SidebarItem {
     key: string;
-    icon: React$1.ReactNode;
+    icon: React__default.ReactNode;
     label: string;
     isActive?: boolean;
     onClick?: () => void;
@@ -1513,7 +1514,7 @@ interface SidebarProps {
     /** Collapsed sidebar width in px (default 52) */
     collapsedWidth?: number;
     /** Slot rendered at the bottom of the sidebar (theme switch, user avatar…) */
-    footer?: React$1.ReactNode;
+    footer?: React__default.ReactNode;
 }
 /** ─────────────────── main component ─────────────────── */
 /**
@@ -1541,7 +1542,7 @@ interface AppShellProps {
      * `sidebarSections` is non-empty. The TopBar should leave some leading space
      * (or use its `center` / `actions` props) to avoid overlap.
      */
-    topBar?: React$1.ReactNode;
+    topBar?: React__default.ReactNode;
     /** Sidebar navigation sections */
     sidebarSections?: SidebarSection[];
     /** Expanded width of the sidebar in px (default 220) */
@@ -1553,7 +1554,7 @@ interface AppShellProps {
     /** Slot rendered at the bottom of the sidebar */
     sidebarFooter?: SidebarProps['footer'];
     /** Main page content */
-    children?: React$1.ReactNode;
+    children?: React__default.ReactNode;
     /** Root element className */
     className?: string;
 }
@@ -1678,9 +1679,9 @@ interface ThemeProviderProps {
      * - `'auto'`   — do nothing; inherit from an ancestor (default)
      */
     colorScheme?: 'light' | 'dark' | 'system' | 'auto';
-    children: React$1.ReactNode;
+    children: React__default.ReactNode;
     className?: string;
-    style?: React$1.CSSProperties;
+    style?: React__default.CSSProperties;
 }
 /**
  * Scoped theme provider.
@@ -1718,7 +1719,7 @@ declare function ThemeProvider({ theme, darkTheme, colorScheme, children, classN
 interface SkeletonBaseProps {
     className?: string;
     /** Override inline styles */
-    style?: React$1.CSSProperties;
+    style?: React__default.CSSProperties;
 }
 /** ─────────────────── SkeletonBox ─────────────────── */
 interface SkeletonBoxProps extends SkeletonBaseProps {
@@ -1786,7 +1787,7 @@ interface SkeletonCardProps extends SkeletonBaseProps {
 declare function SkeletonCard({ hasAvatar, lines, className, style }: SkeletonCardProps): react_jsx_runtime.JSX.Element;
 
 interface ButtonProps {
-    content?: React$1.ReactNode;
+    content?: React__default.ReactNode;
     /** Visual style variant */
     variant?: 'primary' | 'secondary' | 'ghost' | 'danger';
     /** Size — controls height, padding, and font size */
@@ -1796,10 +1797,10 @@ interface ButtonProps {
     loading?: boolean;
     disabled?: boolean;
     /** Inline style overrides (width, etc.). Margins/layout belong in the parent. */
-    style?: React$1.CSSProperties;
+    style?: React__default.CSSProperties;
     /** Leading icon — rendered before content */
-    icon?: React$1.ReactNode;
-    onClick?: React$1.MouseEventHandler<HTMLButtonElement>;
+    icon?: React__default.ReactNode;
+    onClick?: React__default.MouseEventHandler<HTMLButtonElement>;
     /**
      * @deprecated Pass `variant` instead. Kept for API compat — currently no-op.
      * Will be removed in the next major version.
@@ -1854,23 +1855,56 @@ interface FieldShellOptions {
  * `focusWithin: true` in that case).
  */
 declare function fieldShell({ size, hasError, disabled, focusWithin, sized, }?: FieldShellOptions): string;
+/**
+ * Small themed "info" affordance shown beside a field label. Hovering or
+ * focusing it reveals `helperText` in a tooltip. Rendered as a `type="button"`
+ * so it never submits an enclosing form, and coloured from semantic tokens so
+ * it follows the active theme.
+ */
+declare function FieldHelpIcon({ text }: {
+    text: React__default.ReactNode;
+}): react_jsx_runtime.JSX.Element;
+interface FieldLabelProps {
+    label?: React__default.ReactNode;
+    htmlFor?: string;
+    required?: boolean;
+    /** Reveals an info icon + tooltip beside the label. */
+    helperText?: React__default.ReactNode;
+    /** Apply horizontal-layout spacing (top margin, no-wrap, shrink). */
+    horizontal?: boolean;
+    style?: React__default.CSSProperties;
+    /** Label column width in horizontal layout. */
+    width?: string | number;
+    className?: string;
+}
+/**
+ * The label row shared by every input — label text + required asterisk +
+ * optional `helperText` info icon. Components that render their own label
+ * outside `<Field>` (Dropdown, DatePicker, Switch, SegmentedControl) use this
+ * so the affordance is pixel-identical everywhere.
+ *
+ * Returns `null` when there's nothing to show (no label and no helperText).
+ */
+declare function FieldLabel({ label, htmlFor, required, helperText, horizontal, style, width, className, }: FieldLabelProps): react_jsx_runtime.JSX.Element;
 interface FieldProps {
-    label?: React$1.ReactNode;
+    label?: React__default.ReactNode;
     /** `id` of the control — links the `<label htmlFor>`. */
     htmlFor?: string;
     /** `id` for the error region — pair with `aria-describedby` on the control. */
     errorId?: string;
-    errorMessage?: React$1.ReactNode;
+    errorMessage?: React__default.ReactNode;
     /** Orientation of label vs control. Default `'vertical'`. */
     layout?: 'horizontal' | 'vertical';
     /** Show a required asterisk after the label. */
     required?: boolean;
-    labelStyle?: React$1.CSSProperties;
+    /** Contextual help revealed via an info icon + tooltip beside the label. */
+    helperText?: React__default.ReactNode;
+    labelStyle?: React__default.CSSProperties;
     /** Width of the label column in horizontal layout (CSS length). */
     labelWidth?: string | number;
     className?: string;
     /** The control itself (input / trigger / dropzone). */
-    children: React$1.ReactNode;
+    children: React__default.ReactNode;
 }
 /**
  * Layout wrapper shared by every input. Renders:
@@ -1887,32 +1921,34 @@ interface FieldProps {
  * medium weight so it reads as the anchor, while the input's placeholder is
  * muted — establishing hierarchy without making the label tiny.
  */
-declare function Field({ label, htmlFor, errorId, errorMessage, layout, required, labelStyle, labelWidth, className, children, }: FieldProps): react_jsx_runtime.JSX.Element;
+declare function Field({ label, htmlFor, errorId, errorMessage, layout, required, helperText, labelStyle, labelWidth, className, children, }: FieldProps): react_jsx_runtime.JSX.Element;
 
 interface TextInputProps {
     value?: string;
-    onChange?: React$1.ChangeEventHandler<HTMLInputElement>;
+    onChange?: React__default.ChangeEventHandler<HTMLInputElement>;
     disabled?: boolean;
-    label?: React$1.ReactNode;
+    label?: React__default.ReactNode;
     htmlFor?: string;
     placeholder?: string;
     name?: string;
     /** Native input type. Defaults to `'text'`. */
     type?: 'text' | 'email' | 'url' | 'tel';
-    inputStyle?: React$1.CSSProperties;
-    style?: React$1.CSSProperties;
+    inputStyle?: React__default.CSSProperties;
+    style?: React__default.CSSProperties;
     /** Label/input orientation. Defaults to `'vertical'`. */
     layout?: 'horizontal' | 'vertical';
     /** Size preset — controls height, padding, and font. Default `'md'`. */
     size?: FieldSize;
-    onBlur?: React$1.FocusEventHandler<HTMLInputElement>;
-    errorMessage?: React$1.ReactNode;
+    onBlur?: React__default.FocusEventHandler<HTMLInputElement>;
+    errorMessage?: React__default.ReactNode;
+    /** Contextual help revealed via an info icon + tooltip beside the label. */
+    helperText?: React__default.ReactNode;
     /** Mark the field required (renders an asterisk after the label). */
     required?: boolean;
     /** Optional leading adornment (icon / prefix). */
-    prefix?: React$1.ReactNode;
+    prefix?: React__default.ReactNode;
     /** Optional trailing adornment (icon / suffix / unit). */
-    suffix?: React$1.ReactNode;
+    suffix?: React__default.ReactNode;
     id?: string;
 }
 /**
@@ -1936,7 +1972,7 @@ interface TextInputProps {
  * />
  * ```
  */
-declare function TextInput({ value, onChange, disabled, label, htmlFor, placeholder, name, type, inputStyle, style, layout, size, onBlur, errorMessage, required, prefix, suffix, }: TextInputProps): react_jsx_runtime.JSX.Element;
+declare function TextInput({ value, onChange, disabled, label, htmlFor, placeholder, name, type, inputStyle, style, layout, size, onBlur, errorMessage, helperText, required, prefix, suffix, }: TextInputProps): react_jsx_runtime.JSX.Element;
 
 interface NumberInputProps {
     /** Step size for the up/down buttons and native arrow-key handling. Default `1`. */
@@ -1951,7 +1987,7 @@ interface NumberInputProps {
             name?: string;
         };
     }) => void;
-    label?: React$1.ReactNode;
+    label?: React__default.ReactNode;
     htmlFor?: string;
     name?: string;
     disabled?: boolean;
@@ -1959,12 +1995,14 @@ interface NumberInputProps {
     layout?: 'horizontal' | 'vertical';
     /** Size preset. Default `'md'`. */
     size?: FieldSize;
-    errorMessage?: React$1.ReactNode;
+    errorMessage?: React__default.ReactNode;
+    /** Contextual help revealed via an info icon + tooltip beside the label. */
+    helperText?: React__default.ReactNode;
     required?: boolean;
-    inputStyle?: React$1.CSSProperties;
-    labelStyle?: React$1.CSSProperties;
+    inputStyle?: React__default.CSSProperties;
+    labelStyle?: React__default.CSSProperties;
     placeholder?: string;
-    style?: React$1.CSSProperties;
+    style?: React__default.CSSProperties;
     min?: number;
     max?: number;
     readOnly?: boolean;
@@ -2003,29 +2041,31 @@ interface NumberInputProps {
  * <NumberInput label="Tonnage" step={0.25} precision={2} />
  * ```
  */
-declare function NumberInput({ step, value, onChange, label, htmlFor, name, disabled, layout, size, errorMessage, required, inputStyle, labelStyle, placeholder, style, min, max, readOnly, precision, }: NumberInputProps): react_jsx_runtime.JSX.Element;
+declare function NumberInput({ step, value, onChange, label, htmlFor, name, disabled, layout, size, errorMessage, helperText, required, inputStyle, labelStyle, placeholder, style, min, max, readOnly, precision, }: NumberInputProps): react_jsx_runtime.JSX.Element;
 
 interface PasswordProps {
     value?: string;
-    onChange?: React$1.ChangeEventHandler<HTMLInputElement>;
+    onChange?: React__default.ChangeEventHandler<HTMLInputElement>;
     disabled?: boolean;
-    label?: React$1.ReactNode;
+    label?: React__default.ReactNode;
     htmlFor?: string;
     placeholder?: string;
     name?: string;
-    inputStyle?: React$1.CSSProperties;
-    style?: React$1.CSSProperties;
+    inputStyle?: React__default.CSSProperties;
+    style?: React__default.CSSProperties;
     /** Label/input orientation. Defaults to `'vertical'`. */
     layout?: 'horizontal' | 'vertical';
     /** Size preset — controls height, padding, and font. Default `'md'`. */
     size?: FieldSize;
-    onBlur?: React$1.FocusEventHandler<HTMLInputElement>;
-    errorMessage?: React$1.ReactNode;
+    onBlur?: React__default.FocusEventHandler<HTMLInputElement>;
+    errorMessage?: React__default.ReactNode;
+    /** Contextual help revealed via an info icon + tooltip beside the label. */
+    helperText?: React__default.ReactNode;
     required?: boolean;
     /** Override the "reveal" (password hidden) icon. */
-    showIcon?: React$1.ReactNode;
+    showIcon?: React__default.ReactNode;
     /** Override the "hide" (password visible) icon. */
-    hideIcon?: React$1.ReactNode;
+    hideIcon?: React__default.ReactNode;
 }
 /**
  * Password input with a show/hide reveal toggle. Full-width by default.
@@ -2036,24 +2076,26 @@ interface PasswordProps {
  * <Password label="Password" value={pw} onChange={(e) => setPw(e.target.value)} />
  * ```
  */
-declare function Password({ value, onChange, disabled, label, htmlFor, placeholder, name, inputStyle, style, layout, size, onBlur, errorMessage, required, showIcon, hideIcon, }: PasswordProps): react_jsx_runtime.JSX.Element;
+declare function Password({ value, onChange, disabled, label, htmlFor, placeholder, name, inputStyle, style, layout, size, onBlur, errorMessage, helperText, required, showIcon, hideIcon, }: PasswordProps): react_jsx_runtime.JSX.Element;
 
 interface SearchInputProps {
     value?: string;
-    onChange?: React$1.ChangeEventHandler<HTMLInputElement>;
+    onChange?: React__default.ChangeEventHandler<HTMLInputElement>;
     disabled?: boolean;
-    label?: React$1.ReactNode;
+    label?: React__default.ReactNode;
     htmlFor?: string;
     placeholder?: string;
     name?: string;
-    inputStyle?: React$1.CSSProperties;
-    style?: React$1.CSSProperties;
+    inputStyle?: React__default.CSSProperties;
+    style?: React__default.CSSProperties;
     /** Label/input orientation. Defaults to `'vertical'`. */
     layout?: 'horizontal' | 'vertical';
     /** Size preset. Default `'md'`. */
     size?: FieldSize;
     /** Override the leading search icon. */
-    icon?: React$1.ReactNode;
+    icon?: React__default.ReactNode;
+    /** Contextual help revealed via an info icon + tooltip beside the label. */
+    helperText?: React__default.ReactNode;
 }
 /**
  * Search field with a leading magnifier icon. Uses `type="search"` for the
@@ -2065,7 +2107,7 @@ interface SearchInputProps {
  * <SearchInput value={q} onChange={(e) => setQ(e.target.value)} placeholder="Search vessels…" />
  * ```
  */
-declare const SearchInput: React$1.ForwardRefExoticComponent<SearchInputProps & React$1.RefAttributes<HTMLInputElement>>;
+declare const SearchInput: React__default.ForwardRefExoticComponent<SearchInputProps & React__default.RefAttributes<HTMLInputElement>>;
 
 interface CheckboxProps {
     /** Controlled checked state */
@@ -2077,11 +2119,11 @@ interface CheckboxProps {
             name?: string;
         };
     }) => void;
-    label?: React$1.ReactNode;
+    label?: React__default.ReactNode;
     name?: string;
     /** `id` for the hidden input and the `<label htmlFor>` link */
     htmlFor?: string;
-    errorMessage?: React$1.ReactNode;
+    errorMessage?: React__default.ReactNode;
     disabled?: boolean;
     /**
      * Box + label arrangement.
@@ -2095,6 +2137,10 @@ interface CheckboxProps {
      * - In vertical: `'right'` (default) → box then label below; `'left'` → label above then box.
      */
     labelPosition?: 'left' | 'right';
+    /** Contextual help revealed via an info icon + tooltip beside the label. */
+    helperText?: React__default.ReactNode;
+    /** Show a required asterisk after the label. */
+    required?: boolean;
     /** @deprecated Use `checked` */
     value?: boolean;
 }
@@ -2113,15 +2159,15 @@ interface CheckboxProps {
  * />
  */
 declare function Checkbox({ checked, value, // legacy alias
-onChange, label, name, htmlFor, errorMessage, disabled, layout, labelPosition, }: CheckboxProps): react_jsx_runtime.JSX.Element;
+onChange, label, name, htmlFor, errorMessage, disabled, layout, labelPosition, helperText, required, }: CheckboxProps): react_jsx_runtime.JSX.Element;
 
 interface RadioOption {
     /** Stable value submitted / reported on change. */
     value: string;
     /** Main label text. */
-    label: React$1.ReactNode;
+    label: React__default.ReactNode;
     /** Optional secondary description rendered under the label. */
-    description?: React$1.ReactNode;
+    description?: React__default.ReactNode;
     /** Disable this option only. */
     disabled?: boolean;
 }
@@ -2133,7 +2179,7 @@ interface RadioGroupProps {
     defaultValue?: string;
     onChange?: (value: string) => void;
     name?: string;
-    label?: React$1.ReactNode;
+    label?: React__default.ReactNode;
     /**
      * Option arrangement. `'vertical'` (default) stacks options in a column;
      * `'horizontal'` lays them in a row. Named `layout` for consistency with
@@ -2149,7 +2195,9 @@ interface RadioGroupProps {
     size?: FieldSize;
     disabled?: boolean;
     required?: boolean;
-    errorMessage?: React$1.ReactNode;
+    /** Contextual help revealed via an info icon + tooltip beside the label. */
+    helperText?: React__default.ReactNode;
+    errorMessage?: React__default.ReactNode;
 }
 /**
  * Radio group built on `@radix-ui/react-radio-group`. Each option can carry
@@ -2174,38 +2222,64 @@ interface RadioGroupProps {
  * />
  * ```
  */
-declare function RadioGroup({ options, value, defaultValue, onChange, name, label, layout, labelPosition, size, disabled, required, errorMessage, }: RadioGroupProps): react_jsx_runtime.JSX.Element;
+declare function RadioGroup({ options, value, defaultValue, onChange, name, label, layout, labelPosition, size, disabled, required, helperText, errorMessage, }: RadioGroupProps): react_jsx_runtime.JSX.Element;
 
 interface SwitchInputProps {
+    /** Controlled on/off state. */
     checked?: boolean;
+    /** Uncontrolled initial state. */
+    defaultChecked?: boolean;
     onChange?: (e: {
         target: {
             checked: boolean;
+            name?: string;
         };
     }) => void;
-    checkedIcon?: React$1.ReactNode;
-    uncheckedIcon?: React$1.ReactNode;
+    /** Thumb icon shown when on. */
+    checkedIcon?: React__default.ReactNode;
+    /** Thumb icon shown when off. */
+    uncheckedIcon?: React__default.ReactNode;
+    /**
+     * Central field label, positioned per `layout` (above in vertical, beside
+     * in horizontal) — the same affordance every other input uses.
+     */
+    label?: React__default.ReactNode;
+    /** Label/control orientation. Default `'horizontal'`. */
+    layout?: 'horizontal' | 'vertical';
+    /** Contextual help revealed via an info icon + tooltip beside the label. */
+    helperText?: React__default.ReactNode;
+    /** Label rendered to the left of the track, emphasised while off. */
+    offLabel?: React__default.ReactNode;
+    /** Label rendered to the right of the track, emphasised while on. */
+    onLabel?: React__default.ReactNode;
+    name?: string;
+    required?: boolean;
+    disabled?: boolean;
+    errorMessage?: React__default.ReactNode;
 }
 /**
  * Form switch (on/off toggle) powered by Radix Switch.
  *
- * Radix handles keyboard activation, focus ring, and `role="switch"` ARIA.
- * Accepts optional icon slots for the thumb in checked/unchecked states.
+ * Two labelling modes, usable together or apart:
+ * - **central `label`** positioned by `layout` (the standard field label), and
+ * - **per-state `offLabel` / `onLabel`** flanking the track, each emphasised
+ *   when its state is active (the "Off ▮ On" pattern).
+ *
+ * Form-ready: pass `name` for native serialisation (Radix emits a hidden
+ * input), `errorMessage` for validation, `required` for the asterisk.
  *
- * Emits `{ target: { checked } }` for compatibility with existing handlers.
+ * Works controlled (`checked` + `onChange`) or uncontrolled (`defaultChecked`).
  *
  * @example
- * <Switch
- *   checked={form.enabled}
- *   onChange={({ target }) => setField('enabled', target.checked)}
- * />
+ * <Switch label="Email notifications" checked={on} onChange={({ target }) => setOn(target.checked)} />
+ * <Switch offLabel="Monthly" onLabel="Yearly" checked={yearly} onChange={...} />
  */
-declare function Switch({ checked, onChange, checkedIcon, uncheckedIcon, }: SwitchInputProps): react_jsx_runtime.JSX.Element;
+declare function Switch({ checked, defaultChecked, onChange, checkedIcon, uncheckedIcon, label, layout, helperText, offLabel, onLabel, name, required, disabled, errorMessage, }: SwitchInputProps): react_jsx_runtime.JSX.Element;
 
 interface DropdownItem {
     key: string | number;
-    label: React$1.ReactNode;
-    icon?: React$1.ReactNode;
+    label: React__default.ReactNode;
+    icon?: React__default.ReactNode;
 }
 /**
  * Item key type — DOM-friendly subset of `React.Key` (no bigint, since UI
@@ -2220,7 +2294,7 @@ type DropdownValue = DropdownKey | DropdownKey[];
 interface DropdownProps {
     isMultiselect?: boolean;
     hasSearch?: boolean;
-    label?: React$1.ReactNode;
+    label?: React__default.ReactNode;
     name?: string;
     value?: DropdownValue;
     onChange?: (e: {
@@ -2230,15 +2304,18 @@ interface DropdownProps {
             name?: string;
         };
     }) => void;
-    onBlur?: React$1.FocusEventHandler;
+    onBlur?: React__default.FocusEventHandler;
     disabled?: boolean;
     /** Label/input orientation. Defaults to `'vertical'`. */
     layout?: 'horizontal' | 'vertical';
-    errorMessage?: React$1.ReactNode;
-    style?: React$1.CSSProperties;
+    /** Contextual help revealed via an info icon + tooltip beside the label. */
+    helperText?: React__default.ReactNode;
+    required?: boolean;
+    errorMessage?: React__default.ReactNode;
+    style?: React__default.CSSProperties;
     htmlFor?: string;
     items?: DropdownItem[];
-    labelStyle?: React$1.CSSProperties;
+    labelStyle?: React__default.CSSProperties;
     placeholder?: string;
     /** Size preset. Default `'md'`. */
     size?: FieldSize;
@@ -2258,21 +2335,21 @@ interface DropdownProps {
  * // Multi-select
  * <Dropdown isMultiselect label="Fuels" items={fuels} value={form.fuels} onChange={handleChange} />
  */
-declare function Dropdown({ isMultiselect, hasSearch, label, name, value, onChange, disabled, layout, errorMessage, style, htmlFor, items, labelStyle, placeholder, size, }: DropdownProps): react_jsx_runtime.JSX.Element;
+declare function Dropdown({ isMultiselect, hasSearch, label, name, value, onChange, disabled, layout, helperText, required, errorMessage, style, htmlFor, items, labelStyle, placeholder, size, }: DropdownProps): react_jsx_runtime.JSX.Element;
 
 interface AutoCompleteItem {
     key: string;
     value: string;
     label: string;
-    icon?: React$1.ReactNode;
+    icon?: React__default.ReactNode;
 }
 interface AutoCompleteProps {
     disabled?: boolean;
-    label?: React$1.ReactNode;
+    label?: React__default.ReactNode;
     placeholder?: string;
     name?: string;
-    inputStyle?: React$1.CSSProperties;
-    style?: React$1.CSSProperties;
+    inputStyle?: React__default.CSSProperties;
+    style?: React__default.CSSProperties;
     /** Label/input orientation. Defaults to `'vertical'`. */
     layout?: 'horizontal' | 'vertical';
     /**
@@ -2301,9 +2378,11 @@ interface AutoCompleteProps {
     /** Size preset. Default `'md'`. */
     size?: FieldSize;
     /** Override the leading search icon (hidden while loading). */
-    icon?: React$1.ReactNode;
+    icon?: React__default.ReactNode;
     /** Validation message — turns the field red and links via aria-describedby. */
-    errorMessage?: React$1.ReactNode;
+    errorMessage?: React__default.ReactNode;
+    /** Contextual help revealed via an info icon + tooltip beside the label. */
+    helperText?: React__default.ReactNode;
     /** Mark required (asterisk after the label). */
     required?: boolean;
     htmlFor?: string;
@@ -2344,12 +2423,12 @@ interface AutoCompleteProps {
  * />
  * ```
  */
-declare function AutoComplete({ disabled, label, placeholder, name, inputStyle, style, layout, items, onSearch, debounce, onItemClick, emptyText, loadingText, size, icon, errorMessage, required, htmlFor, }: AutoCompleteProps): react_jsx_runtime.JSX.Element;
+declare function AutoComplete({ disabled, label, placeholder, name, inputStyle, style, layout, items, onSearch, debounce, onItemClick, emptyText, loadingText, size, icon, errorMessage, helperText, required, htmlFor, }: AutoCompleteProps): react_jsx_runtime.JSX.Element;
 
 interface TreeSelectNode {
     key: string | number;
-    label: React$1.ReactNode;
-    icon?: React$1.ReactNode;
+    label: React__default.ReactNode;
+    icon?: React__default.ReactNode;
     /** Nested children. If present, this node is treated as a parent (branch). */
     children?: TreeSelectNode[];
     /** Render the node disabled — visible but not selectable. */
@@ -2368,16 +2447,20 @@ interface TreeSelectProps {
             name?: string;
         };
     }) => void;
-    label?: React$1.ReactNode;
+    label?: React__default.ReactNode;
     placeholder?: string;
     /** Form control id linkage. */
     htmlFor?: string;
     name?: string;
     /** Label/trigger orientation. Defaults to `'horizontal'`. */
     layout?: 'horizontal' | 'vertical';
+    /** Contextual help revealed via an info icon + tooltip beside the label. */
+    helperText?: React__default.ReactNode;
+    /** Show a required asterisk after the label. */
+    required?: boolean;
     disabled?: boolean;
-    errorMessage?: React$1.ReactNode;
-    style?: React$1.CSSProperties;
+    errorMessage?: React__default.ReactNode;
+    style?: React__default.CSSProperties;
     /**
      * Whether parent (branch) nodes can be selected. When `false`, parents
      * only expand/collapse and only leaves are picked. Default `true`.
@@ -2425,7 +2508,7 @@ interface TreeSelectProps {
  * />
  * ```
  */
-declare function TreeSelect({ label, name, value, onChange, disabled, layout, errorMessage, style, htmlFor, items, placeholder, parentsSelectable, defaultExpandedKeys, size, }: TreeSelectProps): react_jsx_runtime.JSX.Element;
+declare function TreeSelect({ label, name, value, onChange, disabled, layout, helperText, required, errorMessage, style, htmlFor, items, placeholder, parentsSelectable, defaultExpandedKeys, size, }: TreeSelectProps): react_jsx_runtime.JSX.Element;
 
 interface FileInputProps {
     allowMultiple?: boolean;
@@ -2439,20 +2522,22 @@ interface FileInputProps {
     }) => void;
     name?: string;
     htmlFor?: string;
-    label?: React$1.ReactNode;
+    label?: React__default.ReactNode;
     /** Accepted MIME types / extensions, e.g. `'.xlsx,application/pdf'`. */
     accept?: string;
     /** Primary call-to-action copy. Default `'Click to upload or drag and drop'`. */
-    prompt?: React$1.ReactNode;
+    prompt?: React__default.ReactNode;
     /** Secondary hint under the prompt — typically the accepted types / max size. */
-    hint?: React$1.ReactNode;
+    hint?: React__default.ReactNode;
     /** Maximum file size in bytes. Files above this are rejected with an error. */
     maxSize?: number;
-    errorMessage?: React$1.ReactNode;
+    errorMessage?: React__default.ReactNode;
+    /** Contextual help revealed via an info icon + tooltip beside the label. */
+    helperText?: React__default.ReactNode;
     disabled?: boolean;
     required?: boolean;
     /** Override the upload glyph in the empty state. */
-    icon?: React$1.ReactNode;
+    icon?: React__default.ReactNode;
 }
 /**
  * Drag-and-drop file input with an enterprise dropzone aesthetic: a calm
@@ -2474,27 +2559,31 @@ interface FileInputProps {
  * />
  * ```
  */
-declare function FileInput({ allowMultiple, onChange, name, htmlFor, label, accept, prompt, hint, maxSize, errorMessage, disabled, required, icon, }: FileInputProps): react_jsx_runtime.JSX.Element;
+declare function FileInput({ allowMultiple, onChange, name, htmlFor, label, accept, prompt, hint, maxSize, errorMessage, helperText, disabled, required, icon, }: FileInputProps): react_jsx_runtime.JSX.Element;
 
 interface DatePickerProps {
     /** Current date. `null` / `undefined` means "no date selected". */
     value?: Date | null;
     /** Fires with the next date (or `null` if cleared via the clear button). */
     onChange?: (date: Date | null) => void;
-    label?: React$1.ReactNode;
+    label?: React__default.ReactNode;
     /** Text shown in the trigger when no date is selected. Default `"Select a date…"`. */
     placeholder?: string;
     htmlFor?: string;
     name?: string;
     /** Label/trigger orientation. Defaults to `'horizontal'`. */
     layout?: 'horizontal' | 'vertical';
+    /** Contextual help revealed via an info icon + tooltip beside the label. */
+    helperText?: React__default.ReactNode;
+    /** Show a required asterisk after the label. */
+    required?: boolean;
     disabled?: boolean;
-    errorMessage?: React$1.ReactNode;
+    errorMessage?: React__default.ReactNode;
     /** Earliest selectable date. Dates before this render disabled. */
     min?: Date;
     /** Latest selectable date. Dates after this render disabled. */
     max?: Date;
-    style?: React$1.CSSProperties;
+    style?: React__default.CSSProperties;
     /**
      * Custom formatter for the trigger display. Defaults to
      * `YYYY-MM-DD` via `toISOString().slice(0, 10)`.
@@ -2543,14 +2632,14 @@ type TemporalPickerProps = DatePickerProps;
  * />
  * ```
  */
-declare function DatePicker({ value, onChange, label, placeholder, htmlFor, name: _name, layout, disabled, errorMessage, min, max, style, format, weekStartsOn, clearable, size, }: DatePickerProps): react_jsx_runtime.JSX.Element;
+declare function DatePicker({ value, onChange, label, placeholder, htmlFor, name: _name, layout, helperText, required, disabled, errorMessage, min, max, style, format, weekStartsOn, clearable, size, }: DatePickerProps): react_jsx_runtime.JSX.Element;
 
 interface TextAreaProps {
     value?: string;
-    onChange?: React$1.ChangeEventHandler<HTMLTextAreaElement>;
-    onBlur?: React$1.FocusEventHandler<HTMLTextAreaElement>;
+    onChange?: React__default.ChangeEventHandler<HTMLTextAreaElement>;
+    onBlur?: React__default.FocusEventHandler<HTMLTextAreaElement>;
     disabled?: boolean;
-    label?: React$1.ReactNode;
+    label?: React__default.ReactNode;
     htmlFor?: string;
     placeholder?: string;
     name?: string;
@@ -2573,10 +2662,12 @@ interface TextAreaProps {
     showCount?: boolean;
     /** CSS `resize` behaviour. Default `'vertical'` (or `'none'` when autoGrow). */
     resize?: 'none' | 'vertical' | 'horizontal' | 'both';
-    errorMessage?: React$1.ReactNode;
+    errorMessage?: React__default.ReactNode;
+    /** Contextual help revealed via an info icon + tooltip beside the label. */
+    helperText?: React__default.ReactNode;
     required?: boolean;
-    style?: React$1.CSSProperties;
-    inputStyle?: React$1.CSSProperties;
+    style?: React__default.CSSProperties;
+    inputStyle?: React__default.CSSProperties;
 }
 /**
  * Multi-line text input on the shared field foundation. Optional auto-grow
@@ -2594,12 +2685,12 @@ interface TextAreaProps {
  * <TextArea label="Bio" maxLength={280} showCount value={bio} onChange={onChange} />
  * ```
  */
-declare function TextArea({ value, onChange, onBlur, disabled, label, htmlFor, placeholder, name, layout, size, rows, autoGrow, maxRows, maxLength, showCount, resize, errorMessage, required, style, inputStyle, }: TextAreaProps): react_jsx_runtime.JSX.Element;
+declare function TextArea({ value, onChange, onBlur, disabled, label, htmlFor, placeholder, name, layout, size, rows, autoGrow, maxRows, maxLength, showCount, resize, errorMessage, helperText, required, style, inputStyle, }: TextAreaProps): react_jsx_runtime.JSX.Element;
 
 interface SegmentedOption {
     value: string;
-    label: React$1.ReactNode;
-    icon?: React$1.ReactNode;
+    label: React__default.ReactNode;
+    icon?: React__default.ReactNode;
     disabled?: boolean;
 }
 interface SegmentedControlProps {
@@ -2614,6 +2705,16 @@ interface SegmentedControlProps {
     /** Stretch to fill the container, segments share the width equally. */
     fullWidth?: boolean;
     disabled?: boolean;
+    /** Optional label, positioned per `layout`. */
+    label?: React__default.ReactNode;
+    /** Label/control orientation. Default `'vertical'`. */
+    layout?: 'horizontal' | 'vertical';
+    /** Contextual help revealed via an info icon + tooltip beside the label. */
+    helperText?: React__default.ReactNode;
+    /** Native form field name (emits a hidden input carrying the value). */
+    name?: string;
+    required?: boolean;
+    errorMessage?: React__default.ReactNode;
     'aria-label'?: string;
 }
 /**
@@ -2626,9 +2727,13 @@ interface SegmentedControlProps {
  * track, the macOS / iOS segmented-control pattern, rendered with the
  * system's tight radii and accent-colored active text.
  *
+ * Form-ready: optional `label` (positioned via `layout`), `helperText`,
+ * `errorMessage`, and a hidden input emitted when `name` is set.
+ *
  * @example
  * ```tsx
  * <SegmentedControl
+ *   label="View"
  *   value={view}
  *   onChange={setView}
  *   options={[
@@ -2639,7 +2744,7 @@ interface SegmentedControlProps {
  * />
  * ```
  */
-declare function SegmentedControl({ options, value, defaultValue, onChange, size, fullWidth, disabled, 'aria-label': ariaLabel, }: SegmentedControlProps): react_jsx_runtime.JSX.Element;
+declare function SegmentedControl({ options, value, defaultValue, onChange, size, fullWidth, disabled, label, layout, helperText, name, required, errorMessage, 'aria-label': ariaLabel, }: SegmentedControlProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Slider value. A single number for a one-thumb slider, or a `[min, max]`
@@ -2648,7 +2753,7 @@ declare function SegmentedControl({ options, value, defaultValue, onChange, size
 type SliderValue = number | [number, number];
 interface SliderMark {
     value: number;
-    label?: React$1.ReactNode;
+    label?: React__default.ReactNode;
 }
 interface SliderProps {
     value?: SliderValue;
@@ -2659,7 +2764,7 @@ interface SliderProps {
     min?: number;
     max?: number;
     step?: number;
-    label?: React$1.ReactNode;
+    label?: React__default.ReactNode;
     /** Show the current value(s) next to the label. */
     showValue?: boolean;
     /** Format the displayed value (tooltip + value readout). */
@@ -2670,7 +2775,11 @@ interface SliderProps {
     tooltip?: boolean;
     size?: FieldSize;
     disabled?: boolean;
-    errorMessage?: React$1.ReactNode;
+    errorMessage?: React__default.ReactNode;
+    /** Contextual help revealed via an info icon + tooltip beside the label. */
+    helperText?: React__default.ReactNode;
+    /** Show a required asterisk after the label. */
+    required?: boolean;
     name?: string;
     htmlFor?: string;
 }
@@ -2695,7 +2804,7 @@ interface SliderProps {
  * />
  * ```
  */
-declare function Slider({ value, defaultValue, onChange, onChangeEnd, min, max, step, label, showValue, formatValue, marks, tooltip, size, disabled, errorMessage, name, htmlFor, }: SliderProps): react_jsx_runtime.JSX.Element;
+declare function Slider({ value, defaultValue, onChange, onChangeEnd, min, max, step, label, showValue, formatValue, marks, tooltip, size, disabled, errorMessage, helperText, required, name, htmlFor, }: SliderProps): react_jsx_runtime.JSX.Element;
 
 interface TagsInputProps {
     /** Controlled list of tags. */
@@ -2703,14 +2812,16 @@ interface TagsInputProps {
     /** Uncontrolled initial tags. */
     defaultValue?: string[];
     onChange?: (tags: string[]) => void;
-    label?: React$1.ReactNode;
+    label?: React__default.ReactNode;
     htmlFor?: string;
     name?: string;
     placeholder?: string;
     layout?: 'horizontal' | 'vertical';
     size?: FieldSize;
     disabled?: boolean;
-    errorMessage?: React$1.ReactNode;
+    errorMessage?: React__default.ReactNode;
+    /** Contextual help revealed via an info icon + tooltip beside the label. */
+    helperText?: React__default.ReactNode;
     required?: boolean;
     /** Maximum number of tags. Further input is ignored once reached. */
     maxTags?: number;
@@ -2736,7 +2847,7 @@ interface TagsInputProps {
  *   validate={(t) => /.+@.+\..+/.test(t) || 'Not a valid email'} />
  * ```
  */
-declare function TagsInput({ value, defaultValue, onChange, label, htmlFor, name, placeholder, layout, size, disabled, errorMessage, required, maxTags, dedupe, validate, separators, }: TagsInputProps): react_jsx_runtime.JSX.Element;
+declare function TagsInput({ value, defaultValue, onChange, label, htmlFor, name, placeholder, layout, size, disabled, errorMessage, helperText, required, maxTags, dedupe, validate, separators, }: TagsInputProps): react_jsx_runtime.JSX.Element;
 
 interface OtpInputProps {
     /** Number of code boxes. Default `6`. */
@@ -2745,7 +2856,7 @@ interface OtpInputProps {
     onChange?: (code: string) => void;
     /** Fired when every box is filled. */
     onComplete?: (code: string) => void;
-    label?: React$1.ReactNode;
+    label?: React__default.ReactNode;
     htmlFor?: string;
     name?: string;
     /** `'numeric'` (default) restricts to digits; `'alphanumeric'` allows letters too. */
@@ -2754,8 +2865,12 @@ interface OtpInputProps {
     masked?: boolean;
     size?: FieldSize;
     disabled?: boolean;
-    errorMessage?: React$1.ReactNode;
+    errorMessage?: React__default.ReactNode;
     required?: boolean;
+    /** Label/control orientation. Default `'vertical'`. */
+    layout?: 'horizontal' | 'vertical';
+    /** Contextual help revealed via an info icon + tooltip beside the label. */
+    helperText?: React__default.ReactNode;
     /** Render a visual gap after this many boxes (e.g. `3` → `123 456`). */
     groupAfter?: number;
 }
@@ -2769,7 +2884,7 @@ interface OtpInputProps {
  * <OtpInput length={6} value={code} onChange={setCode} onComplete={verify} />
  * ```
  */
-declare function OtpInput({ length, value, onChange, onComplete, label, htmlFor, name, mode, masked, size, disabled, errorMessage, required, groupAfter, }: OtpInputProps): react_jsx_runtime.JSX.Element;
+declare function OtpInput({ length, value, onChange, onComplete, label, htmlFor, name, mode, masked, size, disabled, errorMessage, required, layout, helperText, groupAfter, }: OtpInputProps): react_jsx_runtime.JSX.Element;
 
 interface RatingProps {
     value?: number;
@@ -2783,13 +2898,19 @@ interface RatingProps {
     readOnly?: boolean;
     /** Clicking the current value again clears to 0. Default `true`. */
     clearable?: boolean;
-    label?: React$1.ReactNode;
+    label?: React__default.ReactNode;
     size?: FieldSize;
     disabled?: boolean;
     /** Override the icon. Receives a `filled` flag. Default is a star. */
-    icon?: (filled: boolean) => React$1.ReactNode;
-    errorMessage?: React$1.ReactNode;
+    icon?: (filled: boolean) => React__default.ReactNode;
+    errorMessage?: React__default.ReactNode;
     name?: string;
+    /** Label/control orientation. Default `'vertical'`. */
+    layout?: 'horizontal' | 'vertical';
+    /** Contextual help revealed via an info icon + tooltip beside the label. */
+    helperText?: React__default.ReactNode;
+    /** Show a required asterisk after the label. */
+    required?: boolean;
 }
 /**
  * Star (or custom glyph) rating with optional half-steps, hover preview, and
@@ -2806,13 +2927,13 @@ interface RatingProps {
  * <Rating value={4.5} allowHalf readOnly />
  * ```
  */
-declare function Rating({ value, defaultValue, onChange, count, allowHalf, readOnly, clearable, label, size, disabled, icon, errorMessage, name, }: RatingProps): react_jsx_runtime.JSX.Element;
+declare function Rating({ value, defaultValue, onChange, count, allowHalf, readOnly, clearable, label, size, disabled, icon, errorMessage, name, layout, helperText, required, }: RatingProps): react_jsx_runtime.JSX.Element;
 
 interface TimePickerProps {
     /** Value as `"HH:mm"` (24h) or `"HH:mm:ss"`. `null`/`undefined` = unset. */
     value?: string | null;
     onChange?: (value: string | null) => void;
-    label?: React$1.ReactNode;
+    label?: React__default.ReactNode;
     htmlFor?: string;
     name?: string;
     placeholder?: string;
@@ -2825,9 +2946,11 @@ interface TimePickerProps {
     /** Minute step. Default `1`. Use `5` / `15` for coarse pickers. */
     minuteStep?: number;
     disabled?: boolean;
-    errorMessage?: React$1.ReactNode;
+    errorMessage?: React__default.ReactNode;
+    /** Contextual help revealed via an info icon + tooltip beside the label. */
+    helperText?: React__default.ReactNode;
     required?: boolean;
-    style?: React$1.CSSProperties;
+    style?: React__default.CSSProperties;
 }
 /**
  * Time picker with scrollable hour / minute (/ second) columns in a popover.
@@ -2839,7 +2962,7 @@ interface TimePickerProps {
  * <TimePicker label="Departure" value={time} onChange={setTime} minuteStep={15} use12Hours />
  * ```
  */
-declare function TimePicker({ value, onChange, label, htmlFor, name, placeholder, layout, size, use12Hours, withSeconds, minuteStep, disabled, errorMessage, required, style, }: TimePickerProps): react_jsx_runtime.JSX.Element;
+declare function TimePicker({ value, onChange, label, htmlFor, name, placeholder, layout, size, use12Hours, withSeconds, minuteStep, disabled, errorMessage, helperText, required, style, }: TimePickerProps): react_jsx_runtime.JSX.Element;
 
 interface DateRange {
     start: Date | null;
@@ -2853,7 +2976,7 @@ interface DateRangePreset {
 interface DateRangePickerProps {
     value?: DateRange;
     onChange?: (range: DateRange) => void;
-    label?: React$1.ReactNode;
+    label?: React__default.ReactNode;
     htmlFor?: string;
     placeholder?: string;
     layout?: 'horizontal' | 'vertical';
@@ -2866,9 +2989,11 @@ interface DateRangePickerProps {
     presets?: DateRangePreset[];
     format?: (d: Date) => string;
     disabled?: boolean;
-    errorMessage?: React$1.ReactNode;
+    errorMessage?: React__default.ReactNode;
+    /** Contextual help revealed via an info icon + tooltip beside the label. */
+    helperText?: React__default.ReactNode;
     required?: boolean;
-    style?: React$1.CSSProperties;
+    style?: React__default.CSSProperties;
 }
 /**
  * Two-month range date picker. Click a start date, then an end date; the span
@@ -2887,13 +3012,13 @@ interface DateRangePickerProps {
  * />
  * ```
  */
-declare function DateRangePicker({ value, onChange, label, htmlFor, placeholder, layout, size, min, max, weekStartsOn, presets, format, disabled, errorMessage, required, style, }: DateRangePickerProps): react_jsx_runtime.JSX.Element;
+declare function DateRangePicker({ value, onChange, label, htmlFor, placeholder, layout, size, min, max, weekStartsOn, presets, format, disabled, errorMessage, helperText, required, style, }: DateRangePickerProps): react_jsx_runtime.JSX.Element;
 
 interface ColorPickerProps {
     /** Hex string, e.g. `"#0466c8"`. */
     value?: string;
     onChange?: (hex: string) => void;
-    label?: React$1.ReactNode;
+    label?: React__default.ReactNode;
     htmlFor?: string;
     name?: string;
     layout?: 'horizontal' | 'vertical';
@@ -2903,7 +3028,9 @@ interface ColorPickerProps {
     /** Show the native eyedropper / full picker fallback via `<input type="color">`. Default `true`. */
     allowCustom?: boolean;
     disabled?: boolean;
-    errorMessage?: React$1.ReactNode;
+    errorMessage?: React__default.ReactNode;
+    /** Contextual help revealed via an info icon + tooltip beside the label. */
+    helperText?: React__default.ReactNode;
     required?: boolean;
     placeholder?: string;
 }
@@ -2917,6 +3044,320 @@ interface ColorPickerProps {
  * <ColorPicker label="Brand colour" value={color} onChange={setColor} />
  * ```
  */
-declare function ColorPicker({ value, onChange, label, htmlFor, name, layout, size, swatches, allowCustom, disabled, errorMessage, required, placeholder, }: ColorPickerProps): react_jsx_runtime.JSX.Element;
+declare function ColorPicker({ value, onChange, label, htmlFor, name, layout, size, swatches, allowCustom, disabled, errorMessage, helperText, required, placeholder, }: ColorPickerProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Native, dependency-free validation. A field carries one rule or an array of
+ * rules; rules run in order and the first failure wins. Rules are plain data
+ * (required / pattern / min / max / length) plus an escape hatch `validate`
+ * for anything custom — including async checks (uniqueness, server lookups) and
+ * third-party schemas: `validate: (v) => zodSchema.safeParse(v).success ? undefined : 'msg'`.
+ */
+type FormValues = Record<string, unknown>;
+/** A numeric/length constraint, optionally with its own message. */
+type Bound = number | {
+    value: number;
+    message?: string;
+};
+/** A regex constraint, optionally with its own message. */
+type Pattern = RegExp | {
+    value: RegExp;
+    message?: string;
+};
+interface FieldRule<V = unknown> {
+    /** Reject empty values. Pass a string to set the message. */
+    required?: boolean | string;
+    /** Reject strings that don't match. */
+    pattern?: Pattern;
+    /** Minimum numeric value. */
+    min?: Bound;
+    /** Maximum numeric value. */
+    max?: Bound;
+    /** Minimum length for strings / arrays. */
+    minLength?: Bound;
+    /** Maximum length for strings / arrays. */
+    maxLength?: Bound;
+    /**
+     * Custom validator. Return an error string to fail, or a falsy value to
+     * pass. May be async. Receives the field value and the whole form's values
+     * (for cross-field checks like "confirm password").
+     */
+    validate?: (value: V, values: FormValues) => string | undefined | null | false | Promise<string | undefined | null | false>;
+    /** Fallback message used by required/pattern when they don't set their own. */
+    message?: string;
+}
+type FieldRules<V = unknown> = FieldRule<V> | FieldRule<V>[];
+type RulesMap = Record<string, FieldRules>;
+/** Does this rule set make the field required? (drives the `*` asterisk.) */
+declare function isRequired(rules: FieldRules | undefined): boolean;
+/**
+ * Run a field's rules and resolve the first error message, or `undefined` when
+ * valid. Optional-and-empty fields short-circuit to valid (only `required`
+ * fires on empty).
+ */
+declare function runFieldRules(value: unknown, rules: FieldRules | undefined, values: FormValues): Promise<string | undefined>;
+/** Common ready-made patterns so callers don't re-type regexes. */
+declare const patterns: {
+    readonly email: RegExp;
+    readonly url: RegExp;
+    readonly phone: RegExp;
+    readonly digits: RegExp;
+};
+
+type ValidateTrigger = 'onChange' | 'onBlur' | 'onSubmit';
+interface FormStoreOptions {
+    initialValues?: FormValues;
+    /** Static rules keyed by field name. Dynamic fields register their own. */
+    rules?: RulesMap;
+    /**
+     * When a field revalidates. `'onSubmit'` is always implied. Default
+     * `['onChange', 'onBlur', 'onSubmit']` — error appears once a field is
+     * touched and updates live as the user types.
+     */
+    validateOn?: ValidateTrigger[];
+}
+type ErrorMap = Record<string, string | undefined>;
+/** Stable per-field view handed to subscribers; ref only changes on real change. */
+interface FieldSnapshot {
+    value: unknown;
+    error: string | undefined;
+    /** touched OR the form was submitted — i.e. "should the error be shown". */
+    showError: boolean;
+}
+/**
+ * Framework-agnostic form store. Holds values/errors/touched, runs validation,
+ * and notifies React via `useSyncExternalStore`. Field components subscribe to
+ * a memoized per-field snapshot so a keystroke in one field doesn't re-render
+ * the others.
+ */
+declare class FormStore {
+    private listeners;
+    private fieldCache;
+    values: FormValues;
+    errors: ErrorMap;
+    touched: Record<string, boolean>;
+    submitted: boolean;
+    validating: boolean;
+    readonly initialValues: FormValues;
+    private rules;
+    readonly validateOn: ValidateTrigger[];
+    private keys;
+    private keySeq;
+    private rootSnap;
+    constructor(opts?: FormStoreOptions);
+    subscribe: (l: () => void) => (() => void);
+    private emit;
+    getRootSnapshot: () => {
+        v: number;
+    };
+    getFieldSnapshot: (name: string) => FieldSnapshot;
+    setRule(name: string, rules: FieldRules | undefined): void;
+    removeRule(name: string): void;
+    getRule(name: string): FieldRules | undefined;
+    getValues: () => FormValues;
+    getValue: (name: string) => unknown;
+    get isValid(): boolean;
+    setValue: (name: string, value: unknown, opts?: {
+        validate?: boolean;
+        touch?: boolean;
+    }) => void;
+    setValues: (patch: FormValues, opts?: {
+        validate?: boolean;
+    }) => void;
+    setError: (name: string, error: string | undefined) => void;
+    touch: (name: string, opts?: {
+        validate?: boolean;
+    }) => void;
+    setSubmitted: (v: boolean) => void;
+    validateField(name: string): Promise<string | undefined>;
+    validateAll(): Promise<ErrorMap>;
+    reset: (values?: FormValues) => void;
+    getKeys(name: string): number[];
+    arrayAppend: (name: string, item?: unknown) => void;
+    arrayRemove: (name: string, index: number) => void;
+    arrayMove: (name: string, from: number, to: number) => void;
+    /** Drop any errors/touched flags under `name.` — used when an array shifts. */
+    private clearBranch;
+}
+
+/**
+ * How a control reports changes, so one binder can drive any of our inputs:
+ * - `value`   — `onChange(value)` directly (RadioGroup, Slider, Rating,
+ *               SegmentedControl, TagsInput, OtpInput, DatePicker, ColorPicker…)
+ * - `native`  — `onChange(e)` reading `e.target.value` (TextInput, Password,
+ *               TextArea, NumberInput, SearchInput)
+ * - `checked` — `onChange({target:{checked}})` (Switch, Checkbox)
+ * - `target`  — `onChange({target:{value}})` (Dropdown, TreeSelect)
+ */
+type FieldKind = 'value' | 'native' | 'checked' | 'target';
+interface FieldBindings {
+    name: string;
+    id: string;
+    htmlFor: string;
+    required?: boolean;
+    errorMessage?: React__default.ReactNode;
+    onChange: (arg: unknown) => void;
+    onBlur: () => void;
+    /** `value` or `checked`, depending on the control kind. */
+    [prop: string]: unknown;
+}
+
+interface UseFormReturn {
+    /** The underlying store — pass to `<Form form={...}>` and for imperative use. */
+    store: FormStore;
+    values: FormValues;
+    errors: ErrorMap;
+    touched: Record<string, boolean>;
+    submitted: boolean;
+    isSubmitting: boolean;
+    isValid: boolean;
+    getValue: (name: string) => unknown;
+    getValues: () => FormValues;
+    setValue: (name: string, value: unknown) => void;
+    setValues: (patch: FormValues) => void;
+    setError: (name: string, error: string | undefined) => void;
+    validateField: (name: string) => Promise<string | undefined>;
+    validateAll: () => Promise<ErrorMap>;
+    reset: (values?: FormValues) => void;
+    /**
+     * Bind a control whose `onChange` receives the value directly (RadioGroup,
+     * Slider, DatePicker, SegmentedControl, TagsInput, OtpInput, …).
+     * Spread the result onto the control: `<Slider {...form.field('volume')} />`.
+     */
+    field: (name: string, rules?: FieldRules) => FieldBindings;
+    /** Bind a native input (`e.target.value`): TextInput, Password, TextArea, NumberInput. */
+    fieldNative: (name: string, rules?: FieldRules) => FieldBindings;
+    /** Bind a checkable (`{target:{checked}}`): Switch, Checkbox. */
+    fieldChecked: (name: string, rules?: FieldRules) => FieldBindings;
+    /** Bind a `{target:{value}}` control: Dropdown, TreeSelect. */
+    fieldTarget: (name: string, rules?: FieldRules) => FieldBindings;
+}
+/**
+ * Create a form instance. State lives in a stable {@link FormStore}; the hook
+ * re-renders the calling component on any change so the spread `field()`
+ * bindings stay current. For large forms, isolate re-renders with
+ * `useFormField` / `<FormField>` instead of reading everything here.
+ *
+ * Validation lives at the form level (rules map or per-field `rules` arg), and
+ * the inputs only *receive* their error — they never validate themselves.
+ *
+ * @example
+ * ```tsx
+ * const form = useForm({ initialValues: { email: '' } })
+ * <Form form={form} onFinish={(v) => save(v)}>
+ *   <TextInput label="Email" {...form.fieldNative('email', { required: true, pattern: patterns.email })} />
+ *   <Button type="submit">Save</Button>
+ * </Form>
+ * ```
+ */
+declare function useForm(options?: FormStoreOptions): UseFormReturn;
+
+interface FormProps extends Omit<React__default.FormHTMLAttributes<HTMLFormElement>, 'onSubmit' | 'action'> {
+    /** The instance from `useForm()`. */
+    form: UseFormReturn;
+    /**
+     * SPA submit handler — called with the validated values once all rules
+     * pass. Receiving this puts the form in client mode (`preventDefault`).
+     */
+    onFinish?: (values: FormValues) => void | Promise<void>;
+    /** Called when a submit attempt fails validation. */
+    onFinishFailed?: (errors: ErrorMap, values: FormValues) => void;
+    /**
+     * SSR / progressive-enhancement submit. A function receives the native
+     * `FormData` (React 19 server action style); a string is used as the
+     * native `<form action>` URL. Either way the form validates first and only
+     * proceeds when valid. Async rules are awaited before a native submit.
+     */
+    action?: string | ((data: FormData) => void | Promise<void>);
+    children: React__default.ReactNode;
+}
+/**
+ * Form wrapper. Owns submission: on submit it marks the form submitted, runs
+ * every field's rules, and only then dispatches — to `onFinish(values)` in SPA
+ * mode or to `action` (function or native URL) for SSR. Renders a real
+ * `<form noValidate>` so our inputs' `name`s serialise into `FormData` while we
+ * still show our own validation messages.
+ *
+ * @example SPA
+ * <Form form={form} onFinish={(v) => api.save(v)}>…</Form>
+ * @example Server action (SSR)
+ * <Form form={form} action={saveAction}>…</Form>
+ */
+declare function Form({ form, onFinish, onFinishFailed, action, children, ...rest }: FormProps): react_jsx_runtime.JSX.Element;
+
+interface UseFormFieldOptions {
+    /** How the control reports changes. Default `'value'`. */
+    kind?: FieldKind;
+    /** Rules for this field — registered on the form (and cleaned up on unmount). */
+    rules?: FieldRules;
+}
+/**
+ * Subscribe a single field to the enclosing `<Form>`. Unlike reading bindings
+ * off `useForm()`, this isolates re-renders to just this field via a memoized
+ * per-field snapshot — the right choice for large or dynamic forms. Registering
+ * `rules` here also unregisters them on unmount, which is what makes field
+ * arrays validate correctly as rows come and go.
+ *
+ * @example
+ * const email = useFormField('email', { kind: 'native', rules: { required: true } })
+ * <TextInput label="Email" {...email} />
+ */
+declare function useFormField(name: string, options?: UseFormFieldOptions): FieldBindings;
+
+interface FormFieldProps extends UseFormFieldOptions {
+    name: string;
+    /** Render-prop receiving the bindings to spread onto a control. */
+    children: (field: FieldBindings) => React__default.ReactNode;
+}
+/**
+ * Render-prop wrapper around {@link useFormField}. Isolates a field's
+ * re-renders from the rest of the form.
+ *
+ * @example
+ * <FormField name="role" rules={{ required: 'Pick a role' }}>
+ *   {(field) => <RadioGroup label="Role" options={ROLES} {...field} />}
+ * </FormField>
+ */
+declare function FormField({ name, kind, rules, children }: FormFieldProps): react_jsx_runtime.JSX.Element;
+
+interface FieldArrayItem {
+    /** Stable React key — survives reorders and removals. */
+    key: number;
+    /** Dotted base path for this row, e.g. `"contacts.2"`. */
+    name: string;
+    index: number;
+}
+interface UseFieldArrayReturn {
+    fields: FieldArrayItem[];
+    /** Append a row (optionally seeded with values). */
+    append: (item?: unknown) => void;
+    /** Remove the row at `index` (clears its errors/touched too). */
+    remove: (index: number) => void;
+    /** Reorder a row. */
+    move: (from: number, to: number) => void;
+    /** Replace the entire array. */
+    replace: (items: unknown[]) => void;
+}
+/**
+ * Dynamic, AntD-style repeating fields. Returns rows with stable keys plus
+ * add/remove/move helpers. Build each row's field names from `field.name`,
+ * e.g. `${field.name}.email`.
+ *
+ * @example
+ * const { fields, append, remove } = useFieldArray('contacts')
+ * {fields.map((f, i) => (
+ *   <div key={f.key}>
+ *     <TextInput {...useFormField(`${f.name}.email`, { kind: 'native', rules: { required: true } })} />
+ *     <Button onClick={() => remove(i)}>Remove</Button>
+ *   </div>
+ * ))}
+ * <Button onClick={() => append({ email: '' })}>Add contact</Button>
+ */
+declare function useFieldArray(name: string): UseFieldArrayReturn;
+
+/** The store provided by `<Form>` to descendant fields / field-arrays. */
+declare const FormContext: React$1.Context<FormStore>;
+/** Read the enclosing `<Form>`'s store. Throws if used outside a `<Form>`. */
+declare function useFormStore(): FormStore;
 
-export { AppShell, type AppShellProps, AutoComplete, type AutoCompleteProps, Avatar, type AvatarProps, type AvatarShape, type AvatarSize, type AvatarStatus, Box, type BoxBackground, type BoxBorder, type BoxProps, type BoxRadius, type BoxShadow, Button, type ButtonProps, Catalog, CatalogCarousel, type CatalogCarouselProps, CatalogGrid, type CatalogGridProps, type CatalogProps, Checkbox, type CheckboxProps, ColorPicker, type ColorPickerProps, ContextMenu, type ContextMenuActionItem, type ContextMenuPosition, type ContextMenuProps, type DatePickerProps, type DateRange, DateRangePicker, type DateRangePickerProps, type DateRangePreset, Drawer, type DrawerProps, Dropdown, type DropdownItem, type DropdownProps, type ExpandRowOptions, FadingBase, type FadingBaseProps, Field, type FieldProps, type FieldShellOptions, type FieldSize, FileInput, type FileInputProps, Flex, type FlexAlign, type FlexDirection, type FlexJustify, type FlexProps, type FlexWrap, Grid, GridCard, type GridCardItem, type GridCardProps, type GridProps, Icon, IconButton, type IconButtonProps, List, type ListItem, type ListProps, LoadingSpinner, type LoadingSpinnerProps, Modal, type ModalProps, type NotificationPayload, NotificationProvider, NumberInput, type NumberInputProps, OpaqueGridCard, type OpaqueGridCardProps, OtpInput, type OtpInputProps, type PaginationOptions, Password, type PasswordProps, Portal, type PortalProps, RadioGroup, type RadioGroupProps, type RadioOption, Rating, type RatingProps, ScalableContainer, type ScalableContainerProps, SearchInput, type SearchInputProps, SegmentedControl, type SegmentedControlProps, type SegmentedOption, Sidebar, type SidebarItem, type SidebarProps, type SidebarSection, SkeletonBox, type SkeletonBoxProps, SkeletonCard, type SkeletonCardProps, SkeletonCircle, type SkeletonCircleProps, SkeletonText, type SkeletonTextProps, Slider, type SliderMark, type SliderProps, type SliderValue, type Spacing, Switch, type SwitchInputProps, type TabItem, Table, type TableColumn, type TableProps, Tabs, type TabsProps, TagsInput, type TagsInputProps, DatePicker as Temporal, type TemporalPickerProps, TextArea, type TextAreaProps, TextInput, type TextInputProps, type ThemeColors, type ThemeConfig, type ThemeDensity, type ThemeMotion, ThemeProvider, type ThemeProviderProps, type ThemeRadius, type ThemeShadows, ThemeSwitch, type ThemeSwitchProps, type ThemeTypography, TimePicker, type TimePickerProps, Tooltip, type TooltipProps, TooltipProvider, TopBar, type TopBarProps, Tree, type TreeItemClickPayload, type TreeNode, type TreeProps, TreeSelect, type TreeSelectProps, Typography, type TypographyAlign, type TypographyColor, type TypographyProps, type TypographyVariant, type TypographyWeight, Wizard, type WizardProps, type WizardStep, fieldShell, useNotification };
+export { AppShell, type AppShellProps, AutoComplete, type AutoCompleteProps, Avatar, type AvatarProps, type AvatarShape, type AvatarSize, type AvatarStatus, Box, type BoxBackground, type BoxBorder, type BoxProps, type BoxRadius, type BoxShadow, Button, type ButtonProps, Catalog, CatalogCarousel, type CatalogCarouselProps, CatalogGrid, type CatalogGridProps, type CatalogProps, Checkbox, type CheckboxProps, ColorPicker, type ColorPickerProps, ContextMenu, type ContextMenuActionItem, type ContextMenuPosition, type ContextMenuProps, type DatePickerProps, type DateRange, DateRangePicker, type DateRangePickerProps, type DateRangePreset, Drawer, type DrawerProps, Dropdown, type DropdownItem, type DropdownProps, type ErrorMap, type ExpandRowOptions, FadingBase, type FadingBaseProps, Field, type FieldArrayItem, type FieldBindings, FieldHelpIcon, type FieldKind, FieldLabel, type FieldLabelProps, type FieldProps, type FieldRule, type FieldRules, type FieldShellOptions, type FieldSize, type FieldSnapshot, FileInput, type FileInputProps, Flex, type FlexAlign, type FlexDirection, type FlexJustify, type FlexProps, type FlexWrap, Form, FormContext, FormField, type FormFieldProps, type FormProps, FormStore, type FormStoreOptions, type FormValues, Grid, GridCard, type GridCardItem, type GridCardProps, type GridProps, Icon, IconButton, type IconButtonProps, List, type ListItem, type ListProps, LoadingSpinner, type LoadingSpinnerProps, Modal, type ModalProps, type NotificationPayload, NotificationProvider, NumberInput, type NumberInputProps, OpaqueGridCard, type OpaqueGridCardProps, OtpInput, type OtpInputProps, type PaginationOptions, Password, type PasswordProps, Portal, type PortalProps, RadioGroup, type RadioGroupProps, type RadioOption, Rating, type RatingProps, type RulesMap, ScalableContainer, type ScalableContainerProps, SearchInput, type SearchInputProps, SegmentedControl, type SegmentedControlProps, type SegmentedOption, Sidebar, type SidebarItem, type SidebarProps, type SidebarSection, SkeletonBox, type SkeletonBoxProps, SkeletonCard, type SkeletonCardProps, SkeletonCircle, type SkeletonCircleProps, SkeletonText, type SkeletonTextProps, Slider, type SliderMark, type SliderProps, type SliderValue, type Spacing, Switch, type SwitchInputProps, type TabItem, Table, type TableColumn, type TableProps, Tabs, type TabsProps, TagsInput, type TagsInputProps, DatePicker as Temporal, type TemporalPickerProps, TextArea, type TextAreaProps, TextInput, type TextInputProps, type ThemeColors, type ThemeConfig, type ThemeDensity, type ThemeMotion, ThemeProvider, type ThemeProviderProps, type ThemeRadius, type ThemeShadows, ThemeSwitch, type ThemeSwitchProps, type ThemeTypography, TimePicker, type TimePickerProps, Tooltip, type TooltipProps, TooltipProvider, TopBar, type TopBarProps, Tree, type TreeItemClickPayload, type TreeNode, type TreeProps, TreeSelect, type TreeSelectProps, Typography, type TypographyAlign, type TypographyColor, type TypographyProps, type TypographyVariant, type TypographyWeight, type UseFieldArrayReturn, type UseFormFieldOptions, type UseFormReturn, type ValidateTrigger, Wizard, type WizardProps, type WizardStep, fieldShell, isRequired, patterns, runFieldRules, useFieldArray, useForm, useFormField, useFormStore, useNotification };