@recursica/mui-adapter 0.21.1 → 0.23.0

package/ARCHITECTURE.md

@@ -13,3 +13,6 @@ This document describes the high-level architecture and philosophy of the `@recu
 
 - Components map closely to Material UI's structure but enforce Recursica design tokens.
 - We avoid over-styling; components only diverge from MUI defaults when dictated by the Recursica design system.
+- Each component adheres to the underlying UI-kit prop signature so that they can easily replace components in the existing code-base
+- Recursica defines a set of common props that are shared across all framework adapters. These sometimes serve the same purpose as existing UI-kit props. In that case, the Recursica prop takes precedence and are the preferred way to achieve the desired effect.
+- Adapter props are removed from the underlying UI-kit when it leads to behavior that Recursica does not support. Recursica is opinionated about the behavior of its components and does not support all of the behavior of the underlying UI-kit.

package/CHANGELOG.md

@@ -1,5 +1,80 @@
 # @recursica/mui-adapter
 
+## 0.23.0
+
+### Minor Changes
+
+- 1c317a3: Implement the `FileUpload` component (drag-and-drop dropzone, browse-button fallback, removable file-chip list) in `mantine-adapter` and `mui-adapter`, replacing the "coming soon" stub, with a shared `RecursicaFileUploadProps`/`RecursicaFileUploadItem` contract in `adapter-common`. Also fixes `mui-adapter`'s `Chip` component's public type to allow `children` (a pre-existing type-only gap; the component already accepted them at runtime).
+
+### Patch Changes
+
+- 1c317a3: `FileUpload` now surfaces a built-in error message ("File type not accepted", overridable via the new `invalidFileTypeMessage` prop) when a dropped/picked file doesn't match `accept`, shown through the standard assistive-text error slot instead of requiring the integrator to wire up `onFilesRejected` themselves. Also reverts `FileUpload`'s assistive/error rendering back to `FormControlWrapper` (file list renders above the assistive/error text again, matching every other form control).
+
+  Fixes `Chip` clipping the descender (e.g. the "g" in "image.png") off long labels — `overflow: hidden` was clipping vertically as well as horizontally, cutting off glyph ink whenever the line-height token was tighter than the font's natural ascent+descent.
+
+- 1c317a3: `FileUpload` now supports a `maxFiles` prop (with an overridable `maxFilesMessage`, defaulting to "Maximum of {maxFiles} files allowed") that rejects files past a total-count cap the same way `accept`/`maxSize` already do.
+
+  Fixes `Chip` rendered without a real handler (`onRemove`/`onClick`/`onChange`) — such as `FileUpload`'s `readOnly` file list — still showing a pointer cursor on hover and picking up a phantom, un-styled keyboard Tab stop on its truncated label text. Both were general `Chip` bugs, not specific to `FileUpload`.
+
+- 1c317a3: Fix `Button` showing the native browser focus outline instead of the recursica focus ring, and fix `Chip` losing its remove (X) icon behind an overflowing long label instead of truncating with an ellipsis. Adds optional `removeTabIndex`/`removeIconRef` props to `Chip` for building keyboard-navigable chip groups. Also fixes the remove icon's own focus ring rendering in the chip's neutral border color instead of the recursica focus-ring color, making it barely visible.
+- Updated dependencies [1c317a3]
+- Updated dependencies [1c317a3]
+- Updated dependencies [1c317a3]
+- Updated dependencies [1c317a3]
+  - @recursica/adapter-common@0.16.0
+
+## 0.22.0
+
+### Minor Changes
+
+- 106bc34: Accordion: closed silent prop-contract conflicts where native `expanded`/`onChange`/`expandIcon`/`icon` could override Recursica's own computed state, made `variant` a real predefined union instead of a bare string, and formally supported a per-item `disabled` prop in both adapters.
+  Also documented `children` across all Accordion sub-components in `RecursicaAccordionProps.ts`, including a new `RecursicaAccordionPanelProps` interface for the Panel.
+- 106bc34: AssistiveElement: `assistiveVariant="error"` now defaults `role="alert"` in both adapters so
+  error text is announced by assistive tech as it appears or changes (an explicit `role` still
+  wins). Also (MUI only) closed a prop-contract conflict where native `error`/`component` could
+  silently override Recursica's own computed values, added the missing `RecursicaOverStyled`
+  wrapper, and hardened a CSS specificity tie against MUI's own `.Mui-error` color. Documented
+  `children` in `RecursicaAssistiveElementProps.ts` and added implementation notes to both adapters.
+
+### Patch Changes
+
+- 106bc34: Autocomplete (MUI): fixed four bugs, all traced to `renderInput` discarding MUI's `InputProps` (dropping the `classes.inputRoot` className, the anchor ref, and adornment slots). Restored `InputProps` so the design-system border/padding actually applies instead of MUI's default underline chrome; wired `leftSection`/`rightSection` into `startAdornment`/`endAdornment` (previously destructured but never rendered, so icons never showed); and stopped coercing `error` to a boolean before the wrapper, which was discarding the error message string (ErrorState story showed no assistive text).
+- 106bc34: Avatar (MUI): fixed `variant` being fed into MUI's native shape prop instead of a color treatment, making it a silent no-op. Also documented `children` in the shared prop types and added missing mui-adapter implementation notes.
+- 106bc34: Checkbox (MUI): fixed the checkmark never appearing on click — `checked` was always
+  forced onto MUI's native input even for plain uncontrolled usage (no `checked`/only
+  `defaultChecked`), pinning it to a value that never updates after the initial render.
+  Now only forced when grouped (CheckboxGroup owns state) or the caller explicitly passes
+  `checked`, matching the existing `Switch` pattern. Also fixed the label rendering
+  vertically offset from the checkbox (`.labelWrapper` needed `display: flex` to blockify
+  the native inline `<label>`, mirroring Mantine's own wrapper) and the checkmark icon
+  rendering off-center inside the box in both standalone Checkbox and CheckboxGroup
+  (`.input` now centers its icon child directly).
+- 106bc34: Disabled Checkbox/Switch's MUI-default click ripple (not present in Mantine) and made their description/error text mutually exclusive (error wins), matching the same fixes just made to Radio.
+- 106bc34: Chip (MUI): fixed three visual bugs vs `mantine-adapter` — extra right padding on short-text chips (duplicate `min-width`/`max-width` applied on both `.root` and `.label`, now only on `.root`), delete/leading icon color and spacing leaking MUI's own default styles (fixed via CSS specificity match on `.leadingIcon`/`.removeIconWrapper`), and a missing icon-text gap on the leading icon (accidental blanket `margin: 0` collapsed it — restored `margin-right` for the gap, matching the selected-state check icon).
+- 106bc34: FormControlWrapper (MUI): fixed ARIA wiring to match the Mantine adapter — a self-generated
+  `id` fallback (via `useId`) now fires by default instead of only when a caller supplies their
+  own `id`, and help/error text each get their own id (`aria-describedby`/`aria-errormessage`)
+  instead of sharing one. Neither attribute is set if the child already has its own explicit
+  value.
+- 106bc34: Label (MUI): fixed focused descendant controls (e.g. a grouped Switch/Checkbox) bleeding MUI's default blue into the label text, mirroring the existing `.Mui-error` override with a matching `.Mui-focused` one.
+- 106bc34: Label (MUI): fixed optional text rendering inline next to the label instead of on its own line — `innerLayout` now wraps and `optionalText` is forced onto a full-width row, matching `mantine-adapter`.
+- 106bc34: Audited every component for the "spread after computed props" ordering bug (caller props silently overriding internal className/classes/icon/sx/onChange) and reordered spread-first in ~25 components. See COMPONENT_DEV_GUIDE.md §3.2 (adapter-common) for the rule.
+- 106bc34: Removed leftover literal Mantine references from mui-adapter CSS/types (dead `:global(.mantine-*)` selectors, unused classes wiring, a stray `@mantine/core` type augmentation) and swapped a hardcoded Mantine red for the real error-text token in Radio/Checkbox/Switch.
+- 106bc34: Radio/Checkbox/Switch description and error text now render through the shared `AssistiveElement` component instead of locally styled divs, removing the last hardcoded hex values (Mantine's default dimmed gray) from mui-adapter CSS.
+- 106bc34: Fixed Radio rendering no visible circle (only the label) — `classes` was being read as `classNames` with Mantine-shaped slot names MUI doesn't support, so the circle's styling was silently dropped. Also fixed the label rendering vertically offset from the circle, disabled MUI's default click ripple, made description/error mutually exclusive (error wins), and reordered the props spread so it can no longer silently override the render-critical props placed after it.
+- 106bc34: Fixed RadioGroup selection not updating in mui-adapter — its onChange was typed and wired as MUI's native `(event, value)`, but Mantine's RadioGroup (the cross-adapter source of truth) only ever calls back with `(value)`. Normalized the shared contract and mui-adapter's wiring to single-argument.
+- 106bc34: Switch: attached `SwitchGroup` as the `Switch.Group` compound export (it existed standalone but was never attached), and tightened `RecursicaSwitchGroupProps` value types from `unknown[]` to `string[]`.
+- 106bc34: Switch (MUI): `SwitchGroup` now actually controls its children via a `SwitchGroupContext` (same pattern as `Checkbox`/`CheckboxGroup`) — previously `value`/`defaultValue`/`onChange` were destructured and discarded, so grouped switches never checked or updated.
+- 106bc34: SwitchGroup: fixed `side-by-side` layout always rendering as if stacked — the group was capped to the switch-item label's own 200px max-width, narrower than the mandatory 224px label column, guaranteeing a wrap.
+- 106bc34: Switch (MUI): fixed track/thumb geometry, checked-state color and opacity, thumb icon, disabled-state opacity, the focus ring target/color, and a `classes`/`classNames` prop bug — bringing it to visual parity with `mantine-adapter`.
+- 106bc34: Tabs (MUI): fixed missing `value` on `Tabs` (never read `TabContext`, so no tab was ever selected), the panel rendering beside instead of below the tab list, and dead `.Mui-selected`/`.panel` CSS selectors.
+- Updated dependencies [106bc34]
+- Updated dependencies [106bc34]
+- Updated dependencies [106bc34]
+- Updated dependencies [106bc34]
+- Updated dependencies [106bc34]
+  - @recursica/adapter-common@0.15.0
+
 ## 0.21.1
 
 ### Patch Changes

package/dist/index.d.ts

@@ -1,6 +1,5 @@
 import { AccordionDetailsProps } from '@mui/material';
 import { AccordionProps as AccordionProps_2 } from '@mui/material';
-import { AccordionSummaryOwnProps } from '@mui/material';
 import { AccordionSummaryProps } from '@mui/material';
 import { AlertProps } from '@mui/material';
 import { AutocompleteProps } from '@mui/material';
@@ -8,7 +7,6 @@ import { AvatarProps as AvatarProps_2 } from '@mui/material';
 import { BadgeProps as BadgeProps_2 } from '@mui/material';
 import { BoxProps as BoxProps_2 } from '@mui/material';
 import { BreadcrumbsProps } from '@mui/material';
-import { ButtonBaseOwnProps } from '@mui/material';
 import { ButtonProps as ButtonProps_2 } from '@mui/material';
 import { CardOwnProps } from '@mui/material';
 import { CardProps as CardProps_2 } from '@mui/material';
@@ -85,13 +83,9 @@ declare type AccordionComponent = typeof AccordionBase & {
 
 export declare const AccordionControl: typeof rawComponents.AccordionControl;
 
-declare const AccordionControl_2: default_2.ForwardRefExoticComponent<(Omit<Omit<WithRecursicaSpacing<AccordionSummaryOwnProps & Omit<ButtonBaseOwnProps, "classes"> & CommonProps & Omit<default_2.DetailedHTMLProps<default_2.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "className" | "classes" | "style" | "sx" | "tabIndex" | "children" | "disabled" | "slots" | "slotProps" | "action" | "centerRipple" | "disableRipple" | "disableTouchRipple" | "focusRipple" | "focusVisibleClassName" | "LinkComponent" | "onFocusVisible" | "TouchRippleProps" | "touchRippleRef" | "expandIcon"> & {
-component?: default_2.ElementType | undefined;
-} & RecursicaAccordionControlProps>, BlockedStylingKeys> & ForbiddenStyles & {
+declare const AccordionControl_2: default_2.ForwardRefExoticComponent<(Omit<Omit<WithRecursicaSpacing<Omit<AccordionSummaryProps, "expandIcon"> & RecursicaAccordionControlProps>, BlockedStylingKeys> & ForbiddenStyles & {
     overStyled?: false | undefined;
-}, "ref"> | Omit<Omit<AccordionSummaryOwnProps & Omit<ButtonBaseOwnProps, "classes"> & CommonProps & Omit<default_2.DetailedHTMLProps<default_2.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "className" | "classes" | "style" | "sx" | "tabIndex" | "children" | "disabled" | "slots" | "slotProps" | "action" | "centerRipple" | "disableRipple" | "disableTouchRipple" | "focusRipple" | "focusVisibleClassName" | "LinkComponent" | "onFocusVisible" | "TouchRippleProps" | "touchRippleRef" | "expandIcon"> & {
-    component?: default_2.ElementType | undefined;
-} & RecursicaAccordionControlProps, "m" | "my" | "mx" | "mt" | "mb" | "ml" | "mr" | "gap" | "rowGap" | "columnGap"> & {
+}, "ref"> | Omit<Omit<Omit<AccordionSummaryProps, "expandIcon"> & RecursicaAccordionControlProps, "m" | "my" | "mx" | "mt" | "mb" | "ml" | "mr" | "gap" | "rowGap" | "columnGap"> & {
     m?: string | number | RecursicaSpacing;
     mx?: string | number | RecursicaSpacing;
     my?: string | number | RecursicaSpacing;
@@ -106,16 +100,16 @@ component?: default_2.ElementType | undefined;
     overStyled: true;
 }, "ref">) & default_2.RefAttributes<HTMLDivElement>>;
 
-declare type AccordionControlWrapperProps = RecursicaOverStyled<AccordionSummaryProps & RecursicaAccordionControlProps>;
+declare type AccordionControlWrapperProps = RecursicaOverStyled<Omit<AccordionSummaryProps, "expandIcon"> & RecursicaAccordionControlProps>;
 
 export declare const AccordionItem: typeof rawComponents.AccordionItem;
 
-declare const AccordionItem_2: default_2.ForwardRefExoticComponent<(Omit<Omit<WithRecursicaSpacing<Omit<AccordionProps_2, "value" | "children"> & {
+declare const AccordionItem_2: default_2.ForwardRefExoticComponent<(Omit<Omit<WithRecursicaSpacing<Omit<AccordionProps_2, "value" | "children" | "onChange" | "defaultExpanded" | "expanded"> & {
 children?: default_2.ReactNode;
 value: string;
 } & RecursicaAccordionItemProps>, BlockedStylingKeys> & ForbiddenStyles & {
     overStyled?: false | undefined;
-}, "ref"> | Omit<Omit<Omit<AccordionProps_2, "value" | "children"> & {
+}, "ref"> | Omit<Omit<Omit<AccordionProps_2, "value" | "children" | "onChange" | "defaultExpanded" | "expanded"> & {
     children?: default_2.ReactNode;
     value: string;
 } & RecursicaAccordionItemProps, "m" | "my" | "mx" | "mt" | "mb" | "ml" | "mr" | "gap" | "rowGap" | "columnGap"> & {
@@ -133,16 +127,16 @@ value: string;
     overStyled: true;
 }, "ref">) & default_2.RefAttributes<HTMLDivElement>>;
 
-declare type AccordionItemWrapperProps = RecursicaOverStyled<Omit<AccordionProps_2, "children" | "value"> & {
+declare type AccordionItemWrapperProps = RecursicaOverStyled<Omit<AccordionProps_2, "children" | "value" | "expanded" | "onChange" | "defaultExpanded"> & {
     children?: default_2.ReactNode;
     value: string;
 } & RecursicaAccordionItemProps>;
 
 export declare const AccordionPanel: typeof rawComponents.AccordionPanel;
 
-declare const AccordionPanel_2: default_2.ForwardRefExoticComponent<(Omit<Omit<WithRecursicaSpacing<AccordionDetailsProps>, BlockedStylingKeys> & ForbiddenStyles & {
+declare const AccordionPanel_2: default_2.ForwardRefExoticComponent<(Omit<Omit<WithRecursicaSpacing<AccordionDetailsProps & RecursicaAccordionPanelProps>, BlockedStylingKeys> & ForbiddenStyles & {
     overStyled?: false | undefined;
-}, "ref"> | Omit<Omit<AccordionDetailsProps, "m" | "my" | "mx" | "mt" | "mb" | "ml" | "mr" | "gap" | "rowGap" | "columnGap"> & {
+}, "ref"> | Omit<Omit<AccordionDetailsProps & RecursicaAccordionPanelProps, "m" | "my" | "mx" | "mt" | "mb" | "ml" | "mr" | "gap" | "rowGap" | "columnGap"> & {
     m?: string | number | RecursicaSpacing;
     mx?: string | number | RecursicaSpacing;
     my?: string | number | RecursicaSpacing;
@@ -157,17 +151,30 @@ declare const AccordionPanel_2: default_2.ForwardRefExoticComponent<(Omit<Omit<W
     overStyled: true;
 }, "ref">) & default_2.RefAttributes<HTMLDivElement>>;
 
-declare type AccordionPanelWrapperProps = RecursicaOverStyled<AccordionDetailsProps>;
+declare type AccordionPanelWrapperProps = RecursicaOverStyled<AccordionDetailsProps & RecursicaAccordionPanelProps>;
 
 declare type AccordionProps = RecursicaOverStyled<default_2.HTMLAttributes<HTMLDivElement> & RecursicaAccordionProps>;
 
 export declare const AssistiveElement: typeof rawComponents.AssistiveElement;
 
-declare const AssistiveElement_2: default_2.ForwardRefExoticComponent<Omit<AssistiveElementProps, "ref"> & default_2.RefAttributes<HTMLParagraphElement>>;
+declare const AssistiveElement_2: default_2.ForwardRefExoticComponent<(Omit<Omit<WithRecursicaSpacing<Omit<FormHelperTextProps, "component" | "error"> & RecursicaAssistiveElementProps>, BlockedStylingKeys> & ForbiddenStyles & {
+    overStyled?: false | undefined;
+}, "ref"> | Omit<Omit<Omit<FormHelperTextProps, "component" | "error"> & RecursicaAssistiveElementProps, "m" | "my" | "mx" | "mt" | "mb" | "ml" | "mr" | "gap" | "rowGap" | "columnGap"> & {
+    m?: string | number | RecursicaSpacing;
+    mx?: string | number | RecursicaSpacing;
+    my?: string | number | RecursicaSpacing;
+    mt?: string | number | RecursicaSpacing;
+    mb?: string | number | RecursicaSpacing;
+    ml?: string | number | RecursicaSpacing;
+    mr?: string | number | RecursicaSpacing;
+    gap?: string | number | RecursicaSpacing;
+    rowGap?: string | number | RecursicaSpacing;
+    columnGap?: string | number | RecursicaSpacing;
+} & {
+    overStyled: true;
+}, "ref">) & default_2.RefAttributes<HTMLParagraphElement>>;
 
-declare interface AssistiveElementProps extends FormHelperTextProps, RecursicaAssistiveElementProps {
-    overStyled?: boolean;
-}
+declare type AssistiveElementProps = RecursicaOverStyled<Omit<FormHelperTextProps, "error" | "component"> & RecursicaAssistiveElementProps>;
 
 export declare const Autocomplete: typeof rawComponents.Autocomplete;
 
@@ -197,9 +204,9 @@ export declare const Avatar: typeof rawComponents.Avatar;
  *
  * Supports polymorphism via the `component` prop or `renderRoot` for custom element rendering.
  */
-declare const Avatar_2: ForwardRefExoticComponent<(Omit<Omit<WithRecursicaSpacing<Omit<AvatarProps_2, "color" | "variant" | "size" | "radius"> & RecursicaAvatarProps>, BlockedStylingKeys> & ForbiddenStyles & {
+declare const Avatar_2: ForwardRefExoticComponent<(Omit<Omit<WithRecursicaSpacing<Omit<AvatarProps_2, "variant"> & RecursicaAvatarProps>, BlockedStylingKeys> & ForbiddenStyles & {
 overStyled?: false | undefined;
-}, "ref"> | Omit<Omit<Omit<AvatarProps_2, "color" | "variant" | "size" | "radius"> & RecursicaAvatarProps, "m" | "my" | "mx" | "mt" | "mb" | "ml" | "mr" | "gap" | "rowGap" | "columnGap"> & {
+}, "ref"> | Omit<Omit<Omit<AvatarProps_2, "variant"> & RecursicaAvatarProps, "m" | "my" | "mx" | "mt" | "mb" | "ml" | "mr" | "gap" | "rowGap" | "columnGap"> & {
 m?: string | number | RecursicaSpacing;
 mx?: string | number | RecursicaSpacing;
 my?: string | number | RecursicaSpacing;
@@ -214,7 +221,7 @@ columnGap?: string | number | RecursicaSpacing;
 overStyled: true;
 }, "ref">) & RefAttributes<HTMLDivElement>>;
 
-declare type AvatarProps = RecursicaOverStyled<Omit<AvatarProps_2, "variant" | "size" | "color" | "radius"> & RecursicaAvatarProps>;
+declare type AvatarProps = RecursicaOverStyled<Omit<AvatarProps_2, "variant"> & RecursicaAvatarProps>;
 
 export declare const Badge: typeof rawComponents.Badge;
 
@@ -399,9 +406,13 @@ declare type CheckboxWrapperProps = Omit<CheckboxProps_2, "size" | "color"> & Re
 
 export declare const Chip: typeof rawComponents.Chip;
 
-declare const Chip_2: default_2.ForwardRefExoticComponent<(Omit<Omit<WithRecursicaSpacing<Omit<ChipProps_2, "color" | "variant" | "size" | "radius"> & RecursicaChipProps>, BlockedStylingKeys> & ForbiddenStyles & {
+declare const Chip_2: default_2.ForwardRefExoticComponent<(Omit<Omit<WithRecursicaSpacing<Omit<ChipProps_2, "color" | "children" | "variant" | "size" | "radius"> & RecursicaChipProps & {
+children?: default_2.ReactNode;
+}>, BlockedStylingKeys> & ForbiddenStyles & {
     overStyled?: false | undefined;
-}, "ref"> | Omit<Omit<Omit<ChipProps_2, "color" | "variant" | "size" | "radius"> & RecursicaChipProps, "m" | "my" | "mx" | "mt" | "mb" | "ml" | "mr" | "gap" | "rowGap" | "columnGap"> & {
+}, "ref"> | Omit<Omit<Omit<ChipProps_2, "color" | "children" | "variant" | "size" | "radius"> & RecursicaChipProps & {
+    children?: default_2.ReactNode;
+}, "m" | "my" | "mx" | "mt" | "mb" | "ml" | "mr" | "gap" | "rowGap" | "columnGap"> & {
     m?: string | number | RecursicaSpacing;
     mx?: string | number | RecursicaSpacing;
     my?: string | number | RecursicaSpacing;
@@ -416,7 +427,9 @@ declare const Chip_2: default_2.ForwardRefExoticComponent<(Omit<Omit<WithRecursi
     overStyled: true;
 }, "ref">) & default_2.RefAttributes<HTMLInputElement>>;
 
-declare type ChipProps = RecursicaOverStyled<Omit<ChipProps_2, "variant" | "size" | "color" | "radius"> & RecursicaChipProps>;
+declare type ChipProps = RecursicaOverStyled<Omit<ChipProps_2, "variant" | "size" | "color" | "radius" | "children"> & RecursicaChipProps & {
+    children?: default_2.ReactNode;
+}>;
 
 export declare const Container: ForwardRefExoticComponent<Omit<rawComponents.ContainerProps, "ref"> & RefAttributes<HTMLDivElement>>;
 
@@ -494,11 +507,47 @@ declare const FileInput_2: default_2.FC<FileInputProps>;
 
 declare type FileInputProps = default_2.HTMLAttributes<HTMLDivElement>;
 
-export declare const FileUpload: FC<rawComponents.FileUploadProps>;
+/**
+ * Mirrors the semantics of the native HTML `accept` attribute (comma-separated file extensions,
+ * MIME types, or MIME wildcards like `image/*`) so drag-and-drop can be validated the same way —
+ * the browser only applies `accept` to its own file-picker dialog, never to a `drop` event, so
+ * without this a dropped file bypasses the restriction entirely.
+ */
+export declare function fileMatchesAccept(file: File, accept?: string): boolean;
+
+export declare const FileUpload: typeof rawComponents.FileUpload;
 
-declare const FileUpload_2: default_2.FC<FileUploadProps>;
+/**
+ * A dropzone for uploading files, with a native browse-button fallback and a
+ * removable-chip list of the currently selected files.
+ *
+ * @example
+ * <FileUpload
+ *   label="Upload Files"
+ *   assistiveText="Max file size 5MB"
+ *   files={files}
+ *   onFilesAdded={(added) => setFiles((f) => [...f, ...added.map((file) => ({ file }))])}
+ *   onFileRemove={(id) => setFiles((f) => f.filter((item) => (item.id ?? item.file.name) !== id))}
+ * />
+ */
+declare const FileUpload_2: default_2.ForwardRefExoticComponent<(Omit<Omit<WithRecursicaSpacing<RecursicaFileUploadProps_2>, BlockedStylingKeys> & ForbiddenStyles & {
+    overStyled?: false | undefined;
+}, "ref"> | Omit<Omit<RecursicaFileUploadProps_2, "m" | "my" | "mx" | "mt" | "mb" | "ml" | "mr" | "gap" | "rowGap" | "columnGap"> & {
+    m?: string | number | RecursicaSpacing;
+    mx?: string | number | RecursicaSpacing;
+    my?: string | number | RecursicaSpacing;
+    mt?: string | number | RecursicaSpacing;
+    mb?: string | number | RecursicaSpacing;
+    ml?: string | number | RecursicaSpacing;
+    mr?: string | number | RecursicaSpacing;
+    gap?: string | number | RecursicaSpacing;
+    rowGap?: string | number | RecursicaSpacing;
+    columnGap?: string | number | RecursicaSpacing;
+} & {
+    overStyled: true;
+}, "ref">) & default_2.RefAttributes<HTMLDivElement>>;
 
-declare type FileUploadProps = default_2.HTMLAttributes<HTMLDivElement>;
+declare type FileUploadProps = RecursicaOverStyled<RecursicaFileUploadProps_2>;
 
 export declare const Flex: ForwardRefExoticComponent<Omit<rawComponents.FlexProps, "ref"> & RefAttributes<HTMLDivElement>>;
 
@@ -999,6 +1048,8 @@ declare namespace rawComponents {
         Dropdown_2 as Dropdown,
         FileInputProps,
         FileInput_2 as FileInput,
+        RecursicaFileUploadItem,
+        RecursicaFileUploadProps_2 as RecursicaFileUploadProps,
         FileUploadProps,
         FileUpload_2 as FileUpload,
         FlexProps,
@@ -1078,6 +1129,7 @@ declare namespace rawComponents {
         RecursicaSwitchPropsAlias,
         SwitchProps_2 as SwitchProps,
         Switch_2 as Switch,
+        SwitchGroupContext,
         RecursicaSwitchGroupProps_2 as RecursicaSwitchGroupProps,
         SwitchGroupProps,
         SwitchGroup_2 as SwitchGroup,
@@ -1169,6 +1221,8 @@ export declare const RECURSICA_COMPONENTS: readonly ["Accordion", "AssistiveElem
  * Props for the Recursica Accordion Control component.
  */
 export declare interface RecursicaAccordionControlProps {
+    /** The control's label content */
+    children?: default_2.ReactNode;
     /** Leading icon displayed inside the control boundary */
     leftIcon?: default_2.ReactNode;
 }
@@ -1177,7 +1231,14 @@ export declare interface RecursicaAccordionControlProps {
  * Props for the Recursica Accordion Item component.
  */
 export declare interface RecursicaAccordionItemProps {
-    /** The text or element label for the item control */
+    /**
+     * When `title` is set, this is the panel content — the control and panel are constructed
+     * automatically, with `children` becoming the panel body. When `title` is omitted, this is
+     * expected to be a manually composed `Accordion.Control`/`Accordion.Panel` pair instead.
+     */
+    children?: default_2.ReactNode;
+    /** The text or element label for the item control. When set, the control and panel are
+     * constructed automatically; omit it to compose the control and panel manually instead. */
     title?: default_2.ReactNode;
     /** Leading icon for the item control */
     leftIcon?: default_2.ReactNode;
@@ -1185,14 +1246,30 @@ export declare interface RecursicaAccordionItemProps {
     divider?: boolean;
     /** Unique value identifier for this item */
     value?: string;
+    /** Disables interaction with this item — it can't be expanded or collapsed, and is dimmed */
+    disabled?: boolean;
+}
+
+/**
+ * Props for the Recursica Accordion Panel component.
+ */
+export declare interface RecursicaAccordionPanelProps {
+    /** The panel's content, shown when the item is expanded */
+    children?: default_2.ReactNode;
 }
 
 /**
  * Props for the Recursica Accordion container component.
  */
 export declare interface RecursicaAccordionProps {
-    /** The styling variant of the accordion */
-    variant?: string;
+    /** The `Accordion.Item` elements that make up the accordion */
+    children?: default_2.ReactNode;
+    /**
+     * The styling variant of the accordion. `"default"` is the only variant with dedicated
+     * Recursica styling today; any other string is accepted for advanced/custom theming but
+     * has no guaranteed styling.
+     */
+    variant?: "default" | (string & {});
     /** Current expanded value(s) in controlled mode */
     value?: string | string[];
     /** Initial expanded value(s) in uncontrolled mode */
@@ -1201,7 +1278,8 @@ export declare interface RecursicaAccordionProps {
     onChange?: (value: string | string[] | null) => void;
     /** Allow multiple panels to be open simultaneously */
     multiple?: boolean;
-    /** Custom chevron icon to replace the default expand/collapse indicator */
+    /** Custom chevron icon to replace the default expand/collapse indicator. Applies to every
+     * item; a single item's control can still override it individually. */
     chevron?: default_2.ReactNode;
 }
 
@@ -1209,9 +1287,14 @@ export declare interface RecursicaAccordionProps {
  * Props for the Recursica AssistiveElement component.
  */
 export declare interface RecursicaAssistiveElementProps {
-    /** The semantic variant driving the icon and text colors */
+    /** The helper or error text content */
+    children?: default_2.ReactNode;
+    /** The semantic variant driving the icon and text colors. `"error"` also defaults the
+     * element's `role` to `"alert"` so assistive tech announces it as it appears or changes —
+     * pass an explicit `role` to override. */
     assistiveVariant?: "help" | "error";
-    /** Explicitly toggle the rendering of the variant-specific SVG icon */
+    /** Explicitly toggle the rendering of the variant-specific SVG icon. There is no slot for a
+     * custom icon — the icon is always the fixed one belonging to the current `assistiveVariant`. */
     assistiveWithIcon?: boolean;
 }
 
@@ -1246,6 +1329,8 @@ declare interface RecursicaAutocompleteProps_2 {
  * Props for the Recursica Avatar component.
  */
 export declare interface RecursicaAvatarProps {
+    /** Initials or other text fallback, shown when neither `src` nor `icon` is set */
+    children?: default_2.ReactNode;
     /** Size of the avatar */
     size?: "small" | "default" | "large";
     /** Visual variant style */
@@ -1347,6 +1432,17 @@ export declare interface RecursicaChipProps {
     removeLabel?: string;
     /** Checked state for the chip (acts as a checkbox) */
     checked?: boolean;
+    /**
+     * Tab index for the remove (X) icon. Defaults to `0`. Lets a parent implement a roving-tabindex
+     * pattern across a group of chips (e.g. FileUpload's file list) by setting this to `-1` on every
+     * chip except the currently-active one.
+     */
+    removeTabIndex?: number;
+    /**
+     * Ref to the remove (X) icon element, so a parent can move focus to it imperatively — e.g.
+     * arrow-key navigation across a group of chips.
+     */
+    removeIconRef?: default_2.Ref<HTMLSpanElement>;
 }
 
 /**
@@ -1397,6 +1493,102 @@ declare interface RecursicaDropdownProps_2 {
     placeholder?: string;
 }
 
+/**
+ * A single file entry rendered as a removable chip in the FileUpload's file list.
+ */
+export declare interface RecursicaFileUploadItem {
+    /** The underlying browser File object. */
+    file: File;
+    /**
+     * Stable identifier for this entry, used as the React key and passed back to
+     * `onFileRemove`. Defaults to the file's `name` when not provided.
+     */
+    id?: string;
+}
+
+/**
+ * Props for the Recursica FileUpload component.
+ */
+export declare interface RecursicaFileUploadProps {
+    /**
+     * Files currently selected, rendered as removable chips below the dropzone.
+     * This is a controlled list — `onFilesAdded`/`onFileRemove` report changes, but
+     * `FileUpload` never mutates this array itself; merge the reported changes into
+     * your own state and pass the updated list back in.
+     */
+    files?: RecursicaFileUploadItem[];
+    /**
+     * Called with the files the user just dropped onto the dropzone or picked via
+     * the browse button. Only the newly added files are passed — merge them into
+     * `files` yourself (e.g. to assign an `id`, dedupe, or reject some of them).
+     */
+    onFilesAdded?: (files: File[]) => void;
+    /**
+     * Called when a file chip's remove (X) icon is activated, identified by its
+     * `id` (or `file.name` when no `id` was given for that entry).
+     */
+    onFileRemove?: (id: string) => void;
+    /**
+     * Native `accept` attribute for the underlying file input (e.g. `".pdf,.png"`
+     * or `"image/*"`) — constrains the browse-button file picker natively. Also
+     * enforced against files dropped onto the dropzone: the browser only applies
+     * `accept` to its own file-picker dialog, never to a `drop` event, so files
+     * that don't match are rejected the same way (see `onFilesRejected`) rather
+     * than silently bypassing the restriction.
+     */
+    accept?: string;
+    /** Whether more than one file can be selected/dropped at once. Defaults to `true`. */
+    multiple?: boolean;
+    /**
+     * Maximum size per file, in bytes. Files exceeding this are passed to
+     * `onFilesRejected` instead of `onFilesAdded`.
+     */
+    maxSize?: number;
+    /**
+     * Maximum total number of files allowed in `files`. Once reached, further
+     * dropped/picked files are passed to `onFilesRejected` instead of
+     * `onFilesAdded`.
+     */
+    maxFiles?: number;
+    /**
+     * Called with any files rejected for exceeding `maxSize`/`maxFiles` or not
+     * matching `accept`.
+     */
+    onFilesRejected?: (files: File[]) => void;
+    /**
+     * Error message shown (via the standard assistive-text error slot) when a
+     * dropped/picked file's extension or MIME type doesn't match `accept`.
+     * Defaults to `"File type not accepted"`.
+     */
+    invalidFileTypeMessage?: default_2.ReactNode;
+    /**
+     * Error message shown (via the standard assistive-text error slot) when a
+     * dropped/picked file would exceed `maxFiles`. Defaults to
+     * `"Maximum of {maxFiles} files allowed"`.
+     */
+    maxFilesMessage?: default_2.ReactNode;
+    /** Icon shown above the dropzone label. Defaults to the built-in upload icon. */
+    icon?: default_2.ReactNode;
+    /** Text shown inside the dropzone. Defaults to `"Drag and drop files here to upload"`. */
+    dropzoneLabel?: default_2.ReactNode;
+    /** Label for the button that opens the native file picker. Defaults to `"Browse files"`. */
+    browseButtonLabel?: default_2.ReactNode;
+    /** Screen-reader label for each file chip's remove button. Defaults to `"Remove"`. */
+    removeFileLabel?: string;
+    /** Disables the dropzone, browse button, and every file chip's remove icon. */
+    disabled?: boolean;
+    /**
+     * Renders `files` as a static list of chips with no remove icon, and omits
+     * the dropzone/browse button entirely.
+     */
+    readOnly?: boolean;
+}
+
+declare interface RecursicaFileUploadProps_2 extends Omit<default_2.HTMLAttributes<HTMLDivElement>, "children" | "onDrop" | "onChange">, Omit<RecursicaFormControlWrapperProps, "controlMaxWidth" | "controlMinWidth">, RecursicaFileUploadProps {
+    /** Visually forces the mandatory asterisk. Accepted for API parity with other adapters; MUI's own `required` already renders the asterisk, so this has no separate effect here. */
+    withAsterisk?: boolean;
+}
+
 /**
  * Props for the Recursica Flex layout component.
  */
@@ -1697,8 +1889,13 @@ export declare interface RecursicaRadioGroupProps {
     value?: unknown;
     /** Initial selected value in uncontrolled mode */
     defaultValue?: unknown;
-    /** Callback triggered when active value changes */
-    onChange?: (event: any, value: string) => void;
+    /**
+     * Callback triggered when active value changes.
+     * Single-argument by design (no event): matches Mantine's native RadioGroup
+     * onChange, the cross-adapter source of truth. mui-adapter's RadioGroup
+     * normalizes MUI's native two-argument (event, value) callback down to this.
+     */
+    onChange?: (value: string) => void;
 }
 
 declare interface RecursicaRadioGroupProps_2 extends Omit<RadioGroupProps_2, "size" | "labelProps" | "classes" | "ref" | "onChange" | "value" | "defaultValue">, Omit<RecursicaFormControlWrapperProps, "controlMaxWidth" | "controlMinWidth" | "classes" | "onChange" | keyof RadioGroupProps_2>, ReadOnlyControlProps, RecursicaRadioGroupProps {
@@ -1830,12 +2027,12 @@ declare interface RecursicaStepperPropsExtended extends Omit<Partial<StepperProp
  * Props for the Recursica SwitchGroup component.
  */
 export declare interface RecursicaSwitchGroupProps {
-    /** Checked values list in controlled mode */
-    value?: unknown[];
+    /** Checked values list in controlled mode — each entry matches a child Switch's own `value` */
+    value?: string[];
     /** Checked default values list in uncontrolled mode */
-    defaultValue?: unknown[];
+    defaultValue?: string[];
     /** Callback triggered when any switch toggles state */
-    onChange?: (value: unknown[]) => void;
+    onChange?: (value: string[]) => void;
 }
 
 declare interface RecursicaSwitchGroupProps_2 extends Omit<FormGroupProps, "size" | "labelProps" | "onChange" | "classes" | "ref" | "value" | "defaultValue">, Omit<RecursicaFormControlWrapperProps, "controlMaxWidth" | "controlMinWidth" | "classes" | "onChange" | "defaultValue">, ReadOnlyControlProps, RecursicaSwitchGroupProps {
@@ -2272,7 +2469,9 @@ export declare const Switch: typeof rawComponents.Switch;
 
 declare const Switch_2: SwitchComponent;
 
-declare type SwitchComponent = React.ComponentType<SwitchProps_2>;
+declare type SwitchComponent = React.ForwardRefExoticComponent<SwitchProps_2 & React.RefAttributes<HTMLInputElement>> & {
+    Group: typeof SwitchGroup_2;
+};
 
 export declare const SwitchGroup: typeof rawComponents.SwitchGroup;
 
@@ -2293,6 +2492,13 @@ declare const SwitchGroup_2: default_2.ForwardRefExoticComponent<(Omit<Omit<With
     overStyled: true;
 }, "ref">) & default_2.RefAttributes<HTMLDivElement>>;
 
+declare const SwitchGroupContext: default_2.Context<{
+    value?: string[];
+    onChange?: (event: default_2.SyntheticEvent, value: string[]) => void;
+    name?: string;
+    readOnly?: boolean;
+} | null>;
+
 declare type SwitchGroupProps = RecursicaOverStyled<RecursicaSwitchGroupProps_2>;
 
 declare type SwitchProps_2 = RecursicaOverStyled<RecursicaSwitchPropsAlias>;