@recursica/mui-adapter 0.21.1 → 0.22.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,57 @@
 # @recursica/mui-adapter
 
+## 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;
 
@@ -1078,6 +1085,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 +1177,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 +1187,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 +1202,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 +1234,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 +1243,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 +1285,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 */
@@ -1697,8 +1738,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 +1876,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 +2318,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 +2341,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>;