@dimaan/ui 0.0.9 → 0.0.10

package/dist/index.d.cts

@@ -2,6 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { HTMLAttributes, ReactNode, ReactElement, ButtonHTMLAttributes, InputHTMLAttributes, ChangeEvent, FieldsetHTMLAttributes, AnchorHTMLAttributes, Ref, TextareaHTMLAttributes } from 'react';
 import { FieldValues, FieldPath, Control } from 'react-hook-form';
+import * as RadixRadioGroup from '@radix-ui/react-radio-group';
 import { ClassValue } from 'clsx';
 
 interface DashboardLayoutContextValue {
@@ -314,47 +315,45 @@ declare const inputBaseClass = "group/input relative inline-flex w-full items-ce
 interface InputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'prefix'> {
     variant?: InputVariant;
     inputSize?: InputSize;
-    /** Optional label rendered above the field. */
-    label?: ReactNode;
-    /** Helper text rendered under the field when not in an error state. */
-    helperText?: ReactNode;
-    /** Error message — renders in destructive style and sets aria-invalid. */
-    error?: ReactNode;
     /** Element rendered before the input (icon, prefix text, etc.). */
     leadingIcon?: ReactNode;
     /** Element rendered after the input (icon, suffix text, etc.). */
     trailingIcon?: ReactNode;
-    /** Stretch the wrapper to fill the parent's inline width. Defaults to `true`. */
-    fullWidth?: boolean;
     /** Class applied to the outer wrapper that holds the icons + input. */
     wrapperClassName?: string;
-    /** Class applied to the field container (`<label>` block). */
-    containerClassName?: string;
 }
 /**
- * Text input with optional label, helper text, error message, and leading/trailing icons.
- * Works standalone (uses `label`/`helperText`/`error` props) OR wrapped inside `<Field>`
- * (id and aria-* are injected by Field via `cloneElement`).
+ * Bare text input — renders the wrapper + native `<input>` + optional leading /
+ * trailing icons. **No label/helperText/error props by design** (per ADR-007:
+ * Field owns all form layout). Wrap in `<Field label="…">` for label, helper,
+ * error rendering and full a11y wiring.
  *
- * @example Standalone with label + helper
+ * @example Inside a Field (RHF + Zod)
  * ```tsx
- * <Input label="Email" helperText="We'll never share it." type="email" />
+ * <Field name="email" label="Email" description="…" required>
+ *   <Input type="email" />
+ * </Field>
  * ```
  *
  * @example With icons
  * ```tsx
- * <Input
- *   label="Search"
- *   leadingIcon={<Search />}
- *   trailingIcon={<X onClick={clear} />}
- * />
+ * <Field label="Search">
+ *   <Input
+ *     leadingIcon={<Search />}
+ *     trailingIcon={<X onClick={clear} />}
+ *     placeholder="Type to search…"
+ *   />
+ * </Field>
  * ```
  *
- * @example Inside a Field (RHF + Zod)
+ * @example Bare in a filter bar (no Field)
  * ```tsx
- * <Field name="email" label="Email" required>
- *   <Input type="email" />
- * </Field>
+ * <Input
+ *   value={search}
+ *   onChange={(e) => setSearch(e.target.value)}
+ *   placeholder="Search…"
+ *   aria-label="Search products"
+ * />
  * ```
  */
 declare const Input: react.ForwardRefExoticComponent<InputProps & react.RefAttributes<HTMLInputElement>>;
@@ -372,6 +371,126 @@ interface LanguageSwitcherProps<TCode extends string = string> extends Omit<Fiel
 }
 declare function LanguageSwitcher<TCode extends string = string>({ languages, value, onChange, ariaLabel, className, ...props }: LanguageSwitcherProps<TCode>): react_jsx_runtime.JSX.Element;
 
+type RadioGroupSize = 'sm' | 'md' | 'lg';
+/** Outer circle (radio button itself) — sized + bordered. */
+declare const radioItemSizeClass: Record<RadioGroupSize, string>;
+/** Inner indicator (the filled dot when selected). Centred via flex on the parent. */
+declare const radioIndicatorSizeClass: Record<RadioGroupSize, string>;
+/** Label text size that pairs naturally with each radio size. */
+declare const radioLabelSizeClass: Record<RadioGroupSize, string>;
+declare const radioItemBaseClass = "aspect-square shrink-0 rounded-full border border-input bg-background text-primary outline-none transition-colors focus-visible:ring-2 focus-visible:ring-ring/40 focus-visible:ring-offset-2 focus-visible:ring-offset-background hover:border-ring disabled:cursor-not-allowed disabled:opacity-50 aria-[invalid=true]:border-destructive aria-[invalid=true]:focus-visible:ring-destructive/40 data-[state=checked]:border-primary";
+declare const radioIndicatorBaseClass = "flex h-full w-full items-center justify-center";
+declare const radioIndicatorDotClass = "rounded-full bg-primary";
+/** Each option row: radio + label + optional description. */
+declare const radioOptionRowClass = "flex cursor-pointer items-start gap-2 has-[button:disabled]:cursor-not-allowed";
+/** The group container — vertical stack by default, horizontal row when orientation="horizontal". */
+declare const radioGroupBaseClass = "flex gap-3";
+declare const radioGroupOrientationClass: {
+    readonly vertical: "flex-col";
+    readonly horizontal: "flex-row flex-wrap";
+};
+
+interface RadioGroupOption {
+    value: string;
+    /** Visible label rendered next to the radio button. */
+    label: ReactNode;
+    /** Optional secondary text rendered below the label (e.g. plan description). */
+    description?: ReactNode;
+    disabled?: boolean;
+}
+type RadioGroupOrientation = 'vertical' | 'horizontal';
+interface RadioGroupProps {
+    /** Visual size of each radio + label. */
+    radioSize?: RadioGroupSize;
+    /** Layout direction within the group. `'vertical'` (default) stacks options; `'horizontal'` lays them out in a row. */
+    orientation?: RadioGroupOrientation;
+    /** Controlled selected value (Radix-style). */
+    value?: string;
+    /** Initial selected value for uncontrolled usage. */
+    defaultValue?: string;
+    /** Radix-style change handler — receives the new value directly. */
+    onValueChange?: (value: string) => void;
+    /** Synthetic-event handler for `react-hook-form`'s `field.onChange` and other consumers. */
+    onChange?: (event: ChangeEvent<HTMLInputElement>) => void;
+    /** Called when focus leaves the group. */
+    onBlur?: () => void;
+    /** Form name (for native form submission). */
+    name?: string;
+    /** Disables the entire group. */
+    disabled?: boolean;
+    /** Marks the group as required. */
+    required?: boolean;
+    /** Override id (otherwise auto-generated via useId). */
+    id?: string;
+    /** Declarative options. When `children` is provided it wins (escape hatch for custom content). */
+    options?: RadioGroupOption[];
+    /** Class on the outer group container. */
+    className?: string;
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+    'aria-describedby'?: string;
+    'aria-invalid'?: boolean | 'true' | 'false';
+    /** Radix children — used for advanced composition (custom RadioGroupItem layouts). */
+    children?: ReactNode;
+}
+/**
+ * Group of mutually-exclusive radio buttons built on `@radix-ui/react-radio-group`.
+ * Use for **3–5 options** where Select would be overkill (pricing tier, privacy
+ * level, single-choice settings). Bare component — wrap in `<Field label="…">`
+ * for the GROUP label, helper, and error rendering.
+ *
+ * Each option carries its own per-radio `label` (and optional `description`).
+ * The Field's outer label names the group; the option labels name each choice.
+ *
+ * @example Inside a Field (RHF + Zod)
+ * ```tsx
+ * <Field name="plan" label="Subscription plan" description="You can change anytime.">
+ *   <RadioGroup
+ *     options={[
+ *       { value: 'free', label: 'Free', description: 'Up to 3 projects' },
+ *       { value: 'pro', label: 'Pro', description: 'Unlimited projects' },
+ *       { value: 'enterprise', label: 'Enterprise', description: 'Custom limits' },
+ *     ]}
+ *   />
+ * </Field>
+ * ```
+ *
+ * @example Horizontal row in a settings card
+ * ```tsx
+ * <Field label="Visibility" orientation="horizontal">
+ *   <RadioGroup
+ *     orientation="horizontal"
+ *     value={visibility}
+ *     onValueChange={setVisibility}
+ *     options={[
+ *       { value: 'public', label: 'Public' },
+ *       { value: 'private', label: 'Private' },
+ *     ]}
+ *   />
+ * </Field>
+ * ```
+ */
+declare const RadioGroup: react.ForwardRefExoticComponent<RadioGroupProps & react.RefAttributes<HTMLDivElement>>;
+/**
+ * `<RadioGroupItem>` — re-exported for consumers building custom option layouts
+ * (icons, badges, etc.) via the `children` escape hatch.
+ *
+ * @example
+ * ```tsx
+ * <RadioGroup value={plan} onValueChange={setPlan}>
+ *   {plans.map((p) => (
+ *     <label key={p.value} htmlFor={p.value} className="flex items-center gap-2">
+ *       <RadioGroupItem id={p.value} value={p.value} />
+ *       <PlanCard {...p} />
+ *     </label>
+ *   ))}
+ * </RadioGroup>
+ * ```
+ */
+declare const RadioGroupItem: react.ForwardRefExoticComponent<Omit<RadixRadioGroup.RadioGroupItemProps & react.RefAttributes<HTMLButtonElement>, "ref"> & {
+    radioSize?: RadioGroupSize;
+} & react.RefAttributes<HTMLButtonElement>>;
+
 type SelectVariant = 'default' | 'filled' | 'ghost';
 type SelectSize = 'sm' | 'md' | 'lg';
 declare const selectVariantClass: Record<SelectVariant, string>;
@@ -719,41 +838,26 @@ interface TextareaProps extends Omit<TextareaHTMLAttributes<HTMLTextAreaElement>
     textareaSize?: TextareaSize;
     /** Controls the native CSS `resize` behaviour. Defaults to `'vertical'`. */
     resize?: TextareaResize;
-    /** Optional label rendered above the field. */
-    label?: ReactNode;
-    /** Helper text rendered under the field when not in an error state. */
-    helperText?: ReactNode;
-    /** Error message — renders in destructive style and sets aria-invalid. */
-    error?: ReactNode;
-    /** Stretch the wrapper to fill the parent's inline width. Defaults to `true`. */
-    fullWidth?: boolean;
     /** Class applied to the outer wrapper that frames the textarea. */
     wrapperClassName?: string;
-    /** Class applied to the field container (`<label>` block). */
-    containerClassName?: string;
 }
 /**
- * Multi-line text input with the same label/helper/error/aria contract as `<Input>`.
- * Works standalone OR wrapped inside `<Field>`.
+ * Bare multi-line text input — renders the wrapper + native `<textarea>`. **No
+ * label/helperText/error props by design** (per ADR-007: Field owns all form
+ * layout). Wrap in `<Field label="…">` for label, helper, error rendering and
+ * full a11y wiring.
  *
- * @example Standalone
- * ```tsx
- * <Textarea label="Bio" helperText="Up to 280 characters." rows={4} />
- * ```
- *
- * @example With error + custom resize
+ * @example Inside a Field (RHF + Zod)
  * ```tsx
- * <Textarea
- *   label="Notes"
- *   error={errors.notes?.message}
- *   resize="vertical"
- * />
+ * <Field name="bio" label="Bio" description="Up to 280 characters.">
+ *   <Textarea rows={4} />
+ * </Field>
  * ```
  *
- * @example Inside a Field (RHF + Zod)
+ * @example Custom resize behaviour
  * ```tsx
- * <Field name="bio" label="Bio">
- *   <Textarea rows={4} />
+ * <Field label="Notes">
+ *   <Textarea resize="none" rows={6} />
  * </Field>
  * ```
  */
@@ -764,4 +868,4 @@ declare function useDirection(): Direction;
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { AppShell, type AppShellBrand, type AppShellNavGroup, type AppShellNavItem, type AppShellProps, Avatar, type AvatarProps, Button, type ButtonProps, type ButtonSize, type ButtonVariant, Checkbox, type CheckboxProps, type CheckboxSize, type Column, type ColumnAlign, DashboardContent, type DashboardContentProps, DashboardHeader, type DashboardHeaderProps, DashboardLayout, type DashboardLayoutContextValue, type DashboardLayoutProps, DashboardMain, type DashboardMainProps, type Direction, Field, type FieldOrientation, type FieldProps, type FieldRHFProps, HeaderActions, type HeaderActionsProps, HeaderCollapseTrigger, type HeaderCollapseTriggerProps, HeaderMobileTrigger, type HeaderMobileTriggerProps, HeaderSearch, type HeaderSearchProps, HeaderTitle, type HeaderTitleProps, Input, type InputProps, type InputSize, type InputVariant, type LanguageOption, LanguageSwitcher, type LanguageSwitcherProps, type PaginationState, type RowSelectionState, Select, type SelectOption, type SelectProps, type SelectSize, type SelectVariant, Sidebar, SidebarFooter, type SidebarFooterProps, SidebarGroup, type SidebarGroupProps, SidebarHeader, type SidebarHeaderProps, SidebarNav, SidebarNavGroup, type SidebarNavGroupProps, SidebarNavItem, type SidebarNavItemProps, type SidebarNavItemRenderProps, type SidebarNavProps, type SidebarProps, type SortDirection, type SortState, type SortableValue, Switch, type SwitchProps, type SwitchSize, Table, type TableProps, type TableSize, type TableSizeClasses, Textarea, type TextareaProps, type TextareaResize, type TextareaSize, type TextareaVariant, buttonBaseClass, buttonSizeClass, buttonVariantClass, cn, inputBaseClass, inputSizeClass, inputVariantClass, selectBaseClass, selectSizeClass, selectVariantClass, switchThumbBaseClass, switchThumbClass, switchTrackBaseClass, switchTrackClass, alignClass as tableAlignClass, tableBaseClass, selectedRowClass as tableSelectedRowClass, tableSizeClass, sortIconClass as tableSortIconClass, textareaBaseClass, textareaResizeClass, textareaSizeClass, textareaVariantClass, useDashboardLayout, useDirection };
+export { AppShell, type AppShellBrand, type AppShellNavGroup, type AppShellNavItem, type AppShellProps, Avatar, type AvatarProps, Button, type ButtonProps, type ButtonSize, type ButtonVariant, Checkbox, type CheckboxProps, type CheckboxSize, type Column, type ColumnAlign, DashboardContent, type DashboardContentProps, DashboardHeader, type DashboardHeaderProps, DashboardLayout, type DashboardLayoutContextValue, type DashboardLayoutProps, DashboardMain, type DashboardMainProps, type Direction, Field, type FieldOrientation, type FieldProps, type FieldRHFProps, HeaderActions, type HeaderActionsProps, HeaderCollapseTrigger, type HeaderCollapseTriggerProps, HeaderMobileTrigger, type HeaderMobileTriggerProps, HeaderSearch, type HeaderSearchProps, HeaderTitle, type HeaderTitleProps, Input, type InputProps, type InputSize, type InputVariant, type LanguageOption, LanguageSwitcher, type LanguageSwitcherProps, type PaginationState, RadioGroup, RadioGroupItem, type RadioGroupOption, type RadioGroupOrientation, type RadioGroupProps, type RadioGroupSize, type RowSelectionState, Select, type SelectOption, type SelectProps, type SelectSize, type SelectVariant, Sidebar, SidebarFooter, type SidebarFooterProps, SidebarGroup, type SidebarGroupProps, SidebarHeader, type SidebarHeaderProps, SidebarNav, SidebarNavGroup, type SidebarNavGroupProps, SidebarNavItem, type SidebarNavItemProps, type SidebarNavItemRenderProps, type SidebarNavProps, type SidebarProps, type SortDirection, type SortState, type SortableValue, Switch, type SwitchProps, type SwitchSize, Table, type TableProps, type TableSize, type TableSizeClasses, Textarea, type TextareaProps, type TextareaResize, type TextareaSize, type TextareaVariant, buttonBaseClass, buttonSizeClass, buttonVariantClass, cn, inputBaseClass, inputSizeClass, inputVariantClass, radioGroupBaseClass, radioGroupOrientationClass, radioIndicatorBaseClass, radioIndicatorDotClass, radioIndicatorSizeClass, radioItemBaseClass, radioItemSizeClass, radioLabelSizeClass, radioOptionRowClass, selectBaseClass, selectSizeClass, selectVariantClass, switchThumbBaseClass, switchThumbClass, switchTrackBaseClass, switchTrackClass, alignClass as tableAlignClass, tableBaseClass, selectedRowClass as tableSelectedRowClass, tableSizeClass, sortIconClass as tableSortIconClass, textareaBaseClass, textareaResizeClass, textareaSizeClass, textareaVariantClass, useDashboardLayout, useDirection };

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
 import { HTMLAttributes, ReactNode, ReactElement, ButtonHTMLAttributes, InputHTMLAttributes, ChangeEvent, FieldsetHTMLAttributes, AnchorHTMLAttributes, Ref, TextareaHTMLAttributes } from 'react';
 import { FieldValues, FieldPath, Control } from 'react-hook-form';
+import * as RadixRadioGroup from '@radix-ui/react-radio-group';
 import { ClassValue } from 'clsx';
 
 interface DashboardLayoutContextValue {
@@ -314,47 +315,45 @@ declare const inputBaseClass = "group/input relative inline-flex w-full items-ce
 interface InputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'prefix'> {
     variant?: InputVariant;
     inputSize?: InputSize;
-    /** Optional label rendered above the field. */
-    label?: ReactNode;
-    /** Helper text rendered under the field when not in an error state. */
-    helperText?: ReactNode;
-    /** Error message — renders in destructive style and sets aria-invalid. */
-    error?: ReactNode;
     /** Element rendered before the input (icon, prefix text, etc.). */
     leadingIcon?: ReactNode;
     /** Element rendered after the input (icon, suffix text, etc.). */
     trailingIcon?: ReactNode;
-    /** Stretch the wrapper to fill the parent's inline width. Defaults to `true`. */
-    fullWidth?: boolean;
     /** Class applied to the outer wrapper that holds the icons + input. */
     wrapperClassName?: string;
-    /** Class applied to the field container (`<label>` block). */
-    containerClassName?: string;
 }
 /**
- * Text input with optional label, helper text, error message, and leading/trailing icons.
- * Works standalone (uses `label`/`helperText`/`error` props) OR wrapped inside `<Field>`
- * (id and aria-* are injected by Field via `cloneElement`).
+ * Bare text input — renders the wrapper + native `<input>` + optional leading /
+ * trailing icons. **No label/helperText/error props by design** (per ADR-007:
+ * Field owns all form layout). Wrap in `<Field label="…">` for label, helper,
+ * error rendering and full a11y wiring.
  *
- * @example Standalone with label + helper
+ * @example Inside a Field (RHF + Zod)
  * ```tsx
- * <Input label="Email" helperText="We'll never share it." type="email" />
+ * <Field name="email" label="Email" description="…" required>
+ *   <Input type="email" />
+ * </Field>
  * ```
  *
  * @example With icons
  * ```tsx
- * <Input
- *   label="Search"
- *   leadingIcon={<Search />}
- *   trailingIcon={<X onClick={clear} />}
- * />
+ * <Field label="Search">
+ *   <Input
+ *     leadingIcon={<Search />}
+ *     trailingIcon={<X onClick={clear} />}
+ *     placeholder="Type to search…"
+ *   />
+ * </Field>
  * ```
  *
- * @example Inside a Field (RHF + Zod)
+ * @example Bare in a filter bar (no Field)
  * ```tsx
- * <Field name="email" label="Email" required>
- *   <Input type="email" />
- * </Field>
+ * <Input
+ *   value={search}
+ *   onChange={(e) => setSearch(e.target.value)}
+ *   placeholder="Search…"
+ *   aria-label="Search products"
+ * />
  * ```
  */
 declare const Input: react.ForwardRefExoticComponent<InputProps & react.RefAttributes<HTMLInputElement>>;
@@ -372,6 +371,126 @@ interface LanguageSwitcherProps<TCode extends string = string> extends Omit<Fiel
 }
 declare function LanguageSwitcher<TCode extends string = string>({ languages, value, onChange, ariaLabel, className, ...props }: LanguageSwitcherProps<TCode>): react_jsx_runtime.JSX.Element;
 
+type RadioGroupSize = 'sm' | 'md' | 'lg';
+/** Outer circle (radio button itself) — sized + bordered. */
+declare const radioItemSizeClass: Record<RadioGroupSize, string>;
+/** Inner indicator (the filled dot when selected). Centred via flex on the parent. */
+declare const radioIndicatorSizeClass: Record<RadioGroupSize, string>;
+/** Label text size that pairs naturally with each radio size. */
+declare const radioLabelSizeClass: Record<RadioGroupSize, string>;
+declare const radioItemBaseClass = "aspect-square shrink-0 rounded-full border border-input bg-background text-primary outline-none transition-colors focus-visible:ring-2 focus-visible:ring-ring/40 focus-visible:ring-offset-2 focus-visible:ring-offset-background hover:border-ring disabled:cursor-not-allowed disabled:opacity-50 aria-[invalid=true]:border-destructive aria-[invalid=true]:focus-visible:ring-destructive/40 data-[state=checked]:border-primary";
+declare const radioIndicatorBaseClass = "flex h-full w-full items-center justify-center";
+declare const radioIndicatorDotClass = "rounded-full bg-primary";
+/** Each option row: radio + label + optional description. */
+declare const radioOptionRowClass = "flex cursor-pointer items-start gap-2 has-[button:disabled]:cursor-not-allowed";
+/** The group container — vertical stack by default, horizontal row when orientation="horizontal". */
+declare const radioGroupBaseClass = "flex gap-3";
+declare const radioGroupOrientationClass: {
+    readonly vertical: "flex-col";
+    readonly horizontal: "flex-row flex-wrap";
+};
+
+interface RadioGroupOption {
+    value: string;
+    /** Visible label rendered next to the radio button. */
+    label: ReactNode;
+    /** Optional secondary text rendered below the label (e.g. plan description). */
+    description?: ReactNode;
+    disabled?: boolean;
+}
+type RadioGroupOrientation = 'vertical' | 'horizontal';
+interface RadioGroupProps {
+    /** Visual size of each radio + label. */
+    radioSize?: RadioGroupSize;
+    /** Layout direction within the group. `'vertical'` (default) stacks options; `'horizontal'` lays them out in a row. */
+    orientation?: RadioGroupOrientation;
+    /** Controlled selected value (Radix-style). */
+    value?: string;
+    /** Initial selected value for uncontrolled usage. */
+    defaultValue?: string;
+    /** Radix-style change handler — receives the new value directly. */
+    onValueChange?: (value: string) => void;
+    /** Synthetic-event handler for `react-hook-form`'s `field.onChange` and other consumers. */
+    onChange?: (event: ChangeEvent<HTMLInputElement>) => void;
+    /** Called when focus leaves the group. */
+    onBlur?: () => void;
+    /** Form name (for native form submission). */
+    name?: string;
+    /** Disables the entire group. */
+    disabled?: boolean;
+    /** Marks the group as required. */
+    required?: boolean;
+    /** Override id (otherwise auto-generated via useId). */
+    id?: string;
+    /** Declarative options. When `children` is provided it wins (escape hatch for custom content). */
+    options?: RadioGroupOption[];
+    /** Class on the outer group container. */
+    className?: string;
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+    'aria-describedby'?: string;
+    'aria-invalid'?: boolean | 'true' | 'false';
+    /** Radix children — used for advanced composition (custom RadioGroupItem layouts). */
+    children?: ReactNode;
+}
+/**
+ * Group of mutually-exclusive radio buttons built on `@radix-ui/react-radio-group`.
+ * Use for **3–5 options** where Select would be overkill (pricing tier, privacy
+ * level, single-choice settings). Bare component — wrap in `<Field label="…">`
+ * for the GROUP label, helper, and error rendering.
+ *
+ * Each option carries its own per-radio `label` (and optional `description`).
+ * The Field's outer label names the group; the option labels name each choice.
+ *
+ * @example Inside a Field (RHF + Zod)
+ * ```tsx
+ * <Field name="plan" label="Subscription plan" description="You can change anytime.">
+ *   <RadioGroup
+ *     options={[
+ *       { value: 'free', label: 'Free', description: 'Up to 3 projects' },
+ *       { value: 'pro', label: 'Pro', description: 'Unlimited projects' },
+ *       { value: 'enterprise', label: 'Enterprise', description: 'Custom limits' },
+ *     ]}
+ *   />
+ * </Field>
+ * ```
+ *
+ * @example Horizontal row in a settings card
+ * ```tsx
+ * <Field label="Visibility" orientation="horizontal">
+ *   <RadioGroup
+ *     orientation="horizontal"
+ *     value={visibility}
+ *     onValueChange={setVisibility}
+ *     options={[
+ *       { value: 'public', label: 'Public' },
+ *       { value: 'private', label: 'Private' },
+ *     ]}
+ *   />
+ * </Field>
+ * ```
+ */
+declare const RadioGroup: react.ForwardRefExoticComponent<RadioGroupProps & react.RefAttributes<HTMLDivElement>>;
+/**
+ * `<RadioGroupItem>` — re-exported for consumers building custom option layouts
+ * (icons, badges, etc.) via the `children` escape hatch.
+ *
+ * @example
+ * ```tsx
+ * <RadioGroup value={plan} onValueChange={setPlan}>
+ *   {plans.map((p) => (
+ *     <label key={p.value} htmlFor={p.value} className="flex items-center gap-2">
+ *       <RadioGroupItem id={p.value} value={p.value} />
+ *       <PlanCard {...p} />
+ *     </label>
+ *   ))}
+ * </RadioGroup>
+ * ```
+ */
+declare const RadioGroupItem: react.ForwardRefExoticComponent<Omit<RadixRadioGroup.RadioGroupItemProps & react.RefAttributes<HTMLButtonElement>, "ref"> & {
+    radioSize?: RadioGroupSize;
+} & react.RefAttributes<HTMLButtonElement>>;
+
 type SelectVariant = 'default' | 'filled' | 'ghost';
 type SelectSize = 'sm' | 'md' | 'lg';
 declare const selectVariantClass: Record<SelectVariant, string>;
@@ -719,41 +838,26 @@ interface TextareaProps extends Omit<TextareaHTMLAttributes<HTMLTextAreaElement>
     textareaSize?: TextareaSize;
     /** Controls the native CSS `resize` behaviour. Defaults to `'vertical'`. */
     resize?: TextareaResize;
-    /** Optional label rendered above the field. */
-    label?: ReactNode;
-    /** Helper text rendered under the field when not in an error state. */
-    helperText?: ReactNode;
-    /** Error message — renders in destructive style and sets aria-invalid. */
-    error?: ReactNode;
-    /** Stretch the wrapper to fill the parent's inline width. Defaults to `true`. */
-    fullWidth?: boolean;
     /** Class applied to the outer wrapper that frames the textarea. */
     wrapperClassName?: string;
-    /** Class applied to the field container (`<label>` block). */
-    containerClassName?: string;
 }
 /**
- * Multi-line text input with the same label/helper/error/aria contract as `<Input>`.
- * Works standalone OR wrapped inside `<Field>`.
+ * Bare multi-line text input — renders the wrapper + native `<textarea>`. **No
+ * label/helperText/error props by design** (per ADR-007: Field owns all form
+ * layout). Wrap in `<Field label="…">` for label, helper, error rendering and
+ * full a11y wiring.
  *
- * @example Standalone
- * ```tsx
- * <Textarea label="Bio" helperText="Up to 280 characters." rows={4} />
- * ```
- *
- * @example With error + custom resize
+ * @example Inside a Field (RHF + Zod)
  * ```tsx
- * <Textarea
- *   label="Notes"
- *   error={errors.notes?.message}
- *   resize="vertical"
- * />
+ * <Field name="bio" label="Bio" description="Up to 280 characters.">
+ *   <Textarea rows={4} />
+ * </Field>
  * ```
  *
- * @example Inside a Field (RHF + Zod)
+ * @example Custom resize behaviour
  * ```tsx
- * <Field name="bio" label="Bio">
- *   <Textarea rows={4} />
+ * <Field label="Notes">
+ *   <Textarea resize="none" rows={6} />
  * </Field>
  * ```
  */
@@ -764,4 +868,4 @@ declare function useDirection(): Direction;
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { AppShell, type AppShellBrand, type AppShellNavGroup, type AppShellNavItem, type AppShellProps, Avatar, type AvatarProps, Button, type ButtonProps, type ButtonSize, type ButtonVariant, Checkbox, type CheckboxProps, type CheckboxSize, type Column, type ColumnAlign, DashboardContent, type DashboardContentProps, DashboardHeader, type DashboardHeaderProps, DashboardLayout, type DashboardLayoutContextValue, type DashboardLayoutProps, DashboardMain, type DashboardMainProps, type Direction, Field, type FieldOrientation, type FieldProps, type FieldRHFProps, HeaderActions, type HeaderActionsProps, HeaderCollapseTrigger, type HeaderCollapseTriggerProps, HeaderMobileTrigger, type HeaderMobileTriggerProps, HeaderSearch, type HeaderSearchProps, HeaderTitle, type HeaderTitleProps, Input, type InputProps, type InputSize, type InputVariant, type LanguageOption, LanguageSwitcher, type LanguageSwitcherProps, type PaginationState, type RowSelectionState, Select, type SelectOption, type SelectProps, type SelectSize, type SelectVariant, Sidebar, SidebarFooter, type SidebarFooterProps, SidebarGroup, type SidebarGroupProps, SidebarHeader, type SidebarHeaderProps, SidebarNav, SidebarNavGroup, type SidebarNavGroupProps, SidebarNavItem, type SidebarNavItemProps, type SidebarNavItemRenderProps, type SidebarNavProps, type SidebarProps, type SortDirection, type SortState, type SortableValue, Switch, type SwitchProps, type SwitchSize, Table, type TableProps, type TableSize, type TableSizeClasses, Textarea, type TextareaProps, type TextareaResize, type TextareaSize, type TextareaVariant, buttonBaseClass, buttonSizeClass, buttonVariantClass, cn, inputBaseClass, inputSizeClass, inputVariantClass, selectBaseClass, selectSizeClass, selectVariantClass, switchThumbBaseClass, switchThumbClass, switchTrackBaseClass, switchTrackClass, alignClass as tableAlignClass, tableBaseClass, selectedRowClass as tableSelectedRowClass, tableSizeClass, sortIconClass as tableSortIconClass, textareaBaseClass, textareaResizeClass, textareaSizeClass, textareaVariantClass, useDashboardLayout, useDirection };
+export { AppShell, type AppShellBrand, type AppShellNavGroup, type AppShellNavItem, type AppShellProps, Avatar, type AvatarProps, Button, type ButtonProps, type ButtonSize, type ButtonVariant, Checkbox, type CheckboxProps, type CheckboxSize, type Column, type ColumnAlign, DashboardContent, type DashboardContentProps, DashboardHeader, type DashboardHeaderProps, DashboardLayout, type DashboardLayoutContextValue, type DashboardLayoutProps, DashboardMain, type DashboardMainProps, type Direction, Field, type FieldOrientation, type FieldProps, type FieldRHFProps, HeaderActions, type HeaderActionsProps, HeaderCollapseTrigger, type HeaderCollapseTriggerProps, HeaderMobileTrigger, type HeaderMobileTriggerProps, HeaderSearch, type HeaderSearchProps, HeaderTitle, type HeaderTitleProps, Input, type InputProps, type InputSize, type InputVariant, type LanguageOption, LanguageSwitcher, type LanguageSwitcherProps, type PaginationState, RadioGroup, RadioGroupItem, type RadioGroupOption, type RadioGroupOrientation, type RadioGroupProps, type RadioGroupSize, type RowSelectionState, Select, type SelectOption, type SelectProps, type SelectSize, type SelectVariant, Sidebar, SidebarFooter, type SidebarFooterProps, SidebarGroup, type SidebarGroupProps, SidebarHeader, type SidebarHeaderProps, SidebarNav, SidebarNavGroup, type SidebarNavGroupProps, SidebarNavItem, type SidebarNavItemProps, type SidebarNavItemRenderProps, type SidebarNavProps, type SidebarProps, type SortDirection, type SortState, type SortableValue, Switch, type SwitchProps, type SwitchSize, Table, type TableProps, type TableSize, type TableSizeClasses, Textarea, type TextareaProps, type TextareaResize, type TextareaSize, type TextareaVariant, buttonBaseClass, buttonSizeClass, buttonVariantClass, cn, inputBaseClass, inputSizeClass, inputVariantClass, radioGroupBaseClass, radioGroupOrientationClass, radioIndicatorBaseClass, radioIndicatorDotClass, radioIndicatorSizeClass, radioItemBaseClass, radioItemSizeClass, radioLabelSizeClass, radioOptionRowClass, selectBaseClass, selectSizeClass, selectVariantClass, switchThumbBaseClass, switchThumbClass, switchTrackBaseClass, switchTrackClass, alignClass as tableAlignClass, tableBaseClass, selectedRowClass as tableSelectedRowClass, tableSizeClass, sortIconClass as tableSortIconClass, textareaBaseClass, textareaResizeClass, textareaSizeClass, textareaVariantClass, useDashboardLayout, useDirection };