@recursica/mui-adapter 0.6.0 → 0.7.0

package/dist/src/components/Tabs/Tabs.d.ts

@@ -1,35 +1,20 @@
-import { TabsProps as MuiTabsProps, ListProps as MuiTabsListProps, TabsProps as MuiTabsTabProps } from '@mui/material';
+import { TabProps as MuiTabProps } from '@mui/material';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
-export interface RecursicaTabsProps extends Omit<MuiTabsProps, "variant" | "classNames" | "color" | "radius"> {
-    variant?: "default" | "outline" | "pills";
-}
+import { RecursicaTabsProps } from '@recursica/adapter-common';
+import { TabPanelProps as MuiTabPanelProps } from '@mui/lab';
 export type TabsProps = RecursicaOverStyled<RecursicaTabsProps>;
-declare const _Tabs: import('react').ForwardRefExoticComponent<(Omit<Omit<RecursicaTabsProps, "className" | "classes" | "style" | "sx" | "color" | "bgcolor" | "backgroundColor" | "typography" | "fontFamily" | "fontSize" | "fontWeight" | "lineHeight" | "letterSpacing" | "textAlign" | "border" | "borderTop" | "borderBottom" | "borderLeft" | "borderRight" | "borderColor" | "borderRadius" | "boxShadow" | "display" | "position" | "zIndex"> & import('../../utils/filterStylingProps').ForbiddenStyles & {
+export declare const Tabs: import('react').ForwardRefExoticComponent<TabsProps & import('react').RefAttributes<HTMLDivElement>>;
+export type TabProps = RecursicaOverStyled<MuiTabProps>;
+export declare const Tab: import('react').ForwardRefExoticComponent<(Omit<Omit<MuiTabProps, import('@recursica/adapter-common').BlockedStylingKeys> & import('@recursica/adapter-common').ForbiddenStyles & {
     overStyled?: false | undefined;
-}, "ref"> | Omit<RecursicaTabsProps & {
-    overStyled: true;
-}, "ref">) & import('react').RefAttributes<HTMLDivElement>>;
-export type TabsListProps = RecursicaOverStyled<MuiTabsListProps>;
-declare const _TabsList: import('react').ForwardRefExoticComponent<(Omit<Omit<MuiTabsListProps, "className" | "classes" | "style" | "sx" | "color" | "bgcolor" | "backgroundColor" | "typography" | "fontFamily" | "fontSize" | "fontWeight" | "lineHeight" | "letterSpacing" | "textAlign" | "border" | "borderTop" | "borderBottom" | "borderLeft" | "borderRight" | "borderColor" | "borderRadius" | "boxShadow" | "display" | "position" | "zIndex"> & import('../../utils/filterStylingProps').ForbiddenStyles & {
-    overStyled?: false | undefined;
-}, "ref"> | Omit<import('@mui/material').ListOwnProps & import('@mui/material/OverridableComponent').CommonProps & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLUListElement>, HTMLUListElement>, "className" | "classes" | "style" | "sx" | "children" | "dense" | "disablePadding" | "subheader"> & {
+}, "ref"> | Omit<import('@mui/material').TabOwnProps & Omit<import('@mui/material').ButtonBaseOwnProps, "classes"> & import('@mui/material/OverridableComponent').CommonProps & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "className" | "classes" | "style" | "sx" | "value" | "tabIndex" | "children" | "disabled" | "label" | "action" | "centerRipple" | "disableRipple" | "disableTouchRipple" | "focusRipple" | "focusVisibleClassName" | "LinkComponent" | "onFocusVisible" | "TouchRippleProps" | "touchRippleRef" | "icon" | "disableFocusRipple" | "iconPosition" | "wrapped"> & {
     component?: React.ElementType | undefined;
 } & {
     overStyled: true;
 }, "ref">) & import('react').RefAttributes<HTMLDivElement>>;
-export type TabsTabProps = RecursicaOverStyled<MuiTabsTabProps>;
-declare const _TabsTab: import('react').ForwardRefExoticComponent<(Omit<Omit<MuiTabsProps, "className" | "classes" | "style" | "sx" | "color" | "bgcolor" | "backgroundColor" | "typography" | "fontFamily" | "fontSize" | "fontWeight" | "lineHeight" | "letterSpacing" | "textAlign" | "border" | "borderTop" | "borderBottom" | "borderLeft" | "borderRight" | "borderColor" | "borderRadius" | "boxShadow" | "display" | "position" | "zIndex"> & import('../../utils/filterStylingProps').ForbiddenStyles & {
+export type TabPanelProps = RecursicaOverStyled<MuiTabPanelProps>;
+export declare const TabPanel: import('react').ForwardRefExoticComponent<(Omit<Omit<MuiTabPanelProps, import('@recursica/adapter-common').BlockedStylingKeys> & import('@recursica/adapter-common').ForbiddenStyles & {
     overStyled?: false | undefined;
-}, "ref"> | Omit<import('@mui/material').TabsOwnProps & import('@mui/material/OverridableComponent').CommonProps & Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "className" | "classes" | "style" | "sx" | "value" | "aria-label" | "aria-labelledby" | "children" | "onChange" | "variant" | "slots" | "slotProps" | "action" | "orientation" | "allowScrollButtonsMobile" | "centered" | "indicatorColor" | "ScrollButtonComponent" | "scrollButtons" | "selectionFollowsFocus" | "TabIndicatorProps" | "TabScrollButtonProps" | "textColor" | "visibleScrollbar"> & {
-    component?: React.ElementType | undefined;
-} & {
+}, "ref"> | Omit<MuiTabPanelProps & {
     overStyled: true;
-}, "ref">) & import('react').RefAttributes<HTMLButtonElement>>;
-export type TabsPanelProps = RecursicaOverStyled<MuiTabsPanelProps>;
-declare const _TabsPanel: import('react').ForwardRefExoticComponent<any>;
-export declare const Tabs: typeof _Tabs & {
-    List: typeof _TabsList;
-    Tab: typeof _TabsTab;
-    Panel: typeof _TabsPanel;
-};
-export {};
+}, "ref">) & import('react').RefAttributes<HTMLDivElement>>;

package/dist/src/components/Text/Text.d.ts

@@ -1,19 +1,5 @@
 import { default as React } from 'react';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
-import { TypographyProps as MuiTypographyProps } from '@mui/material';
-export type TextVariant = "body" | "body-small" | "caption" | "overline" | "subtitle" | "subtitle-small";
-export type RecursicaTextProps = Omit<MuiTypographyProps, "variant"> & {
-    variant?: TextVariant;
-    children?: React.ReactNode;
-    component?: React.ElementType;
-};
+import { RecursicaTextProps } from '@recursica/adapter-common';
 export type TextProps = RecursicaOverStyled<RecursicaTextProps>;
-export declare const Text: React.ForwardRefExoticComponent<(Omit<Omit<RecursicaTextProps, "className" | "classes" | "style" | "sx" | "color" | "bgcolor" | "backgroundColor" | "typography" | "fontFamily" | "fontSize" | "fontWeight" | "lineHeight" | "letterSpacing" | "textAlign" | "border" | "borderTop" | "borderBottom" | "borderLeft" | "borderRight" | "borderColor" | "borderRadius" | "boxShadow" | "display" | "position" | "zIndex"> & import('../../utils/filterStylingProps').ForbiddenStyles & {
-    overStyled?: false | undefined;
-}, "ref"> | Omit<Omit<MuiTypographyProps, "variant"> & {
-    variant?: TextVariant;
-    children?: React.ReactNode;
-    component?: React.ElementType;
-} & {
-    overStyled: true;
-}, "ref">) & React.RefAttributes<HTMLElement>>;
+export declare const Text: React.ForwardRefExoticComponent<TextProps & React.RefAttributes<HTMLElement>>;

package/dist/src/components/TextArea/TextArea.d.ts

@@ -1,18 +1,12 @@
 import { default as React } from 'react';
 import { TextFieldProps as MuiTextareaProps } from '@mui/material';
-import { ReadOnlyControlProps } from '@recursica/adapter-common';
+import { ReadOnlyControlProps, RecursicaTextAreaProps as BaseRecursicaTextAreaProps } from '@recursica/adapter-common';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
 import { RecursicaFormControlWrapperProps } from '../FormControlWrapper/FormControlWrapper';
-export interface RecursicaTextAreaProps extends Omit<MuiTextareaProps, "size" | "variant" | "radius" | "wrapperProps">, Pick<RecursicaFormControlWrapperProps, "assistiveText" | "assistiveWithIcon" | "formLayout" | "labelSize" | "labelAlignment" | "labelOptionalText" | "labelWithEditIcon" | "onLabelEditClick">, ReadOnlyControlProps {
-    /** Maximum rows for autosize textarea to grow */
-    maxRows?: number;
-    /** Minimum rows of autosize textarea */
-    minRows?: number;
-    /** If set, enables textarea height growing with its content */
-    autosize?: boolean;
+export interface RecursicaTextAreaProps extends Omit<MuiTextareaProps, "size" | "variant" | "radius" | "wrapperProps">, Pick<RecursicaFormControlWrapperProps, "assistiveText" | "assistiveWithIcon" | "formLayout" | "labelSize" | "labelAlignment" | "labelOptionalText" | "labelWithEditIcon" | "onLabelEditClick">, ReadOnlyControlProps, BaseRecursicaTextAreaProps {
 }
 export type TextAreaProps = RecursicaOverStyled<RecursicaTextAreaProps>;
-export declare const TextArea: React.ForwardRefExoticComponent<(Omit<Omit<RecursicaTextAreaProps, "className" | "classes" | "style" | "sx" | "color" | "bgcolor" | "backgroundColor" | "typography" | "fontFamily" | "fontSize" | "fontWeight" | "lineHeight" | "letterSpacing" | "textAlign" | "border" | "borderTop" | "borderBottom" | "borderLeft" | "borderRight" | "borderColor" | "borderRadius" | "boxShadow" | "display" | "position" | "zIndex"> & import('../../utils/filterStylingProps').ForbiddenStyles & {
+export declare const TextArea: React.ForwardRefExoticComponent<(Omit<Omit<RecursicaTextAreaProps, import('@recursica/adapter-common').BlockedStylingKeys> & import('@recursica/adapter-common').ForbiddenStyles & {
     overStyled?: false | undefined;
 }, "ref"> | Omit<RecursicaTextAreaProps & {
     overStyled: true;

package/dist/src/components/TextField/TextField.d.ts

@@ -1,16 +1,12 @@
 import { default as React } from 'react';
 import { InputBaseProps } from '@mui/material';
-import { ReadOnlyControlProps } from '@recursica/adapter-common';
+import { ReadOnlyControlProps, RecursicaTextFieldProps as BaseRecursicaTextFieldProps } from '@recursica/adapter-common';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
 import { RecursicaFormControlWrapperProps } from '../FormControlWrapper/FormControlWrapper';
-export interface RecursicaTextFieldProps extends Omit<InputBaseProps, "color" | "size" | "startAdornment" | "endAdornment" | "autoComplete">, Omit<React.ComponentPropsWithoutRef<"input">, keyof InputBaseProps | "size" | "color" | "style" | "className" | "id">, Pick<RecursicaFormControlWrapperProps, "label" | "error" | "required" | "id" | "assistiveText" | "assistiveWithIcon" | "formLayout" | "labelSize" | "labelAlignment" | "labelOptionalText" | "labelWithEditIcon" | "onLabelEditClick">, ReadOnlyControlProps {
-    /** Renders a section on the left side of the input (e.g. icon). Maps to Mantine's leftSection natively. */
-    leftSection?: React.ReactNode;
-    /** Renders a section on the right side of the input (e.g. clear button). Maps to Mantine's rightSection natively. */
-    rightSection?: React.ReactNode;
+export interface RecursicaTextFieldProps extends Omit<InputBaseProps, "color" | "size" | "startAdornment" | "endAdornment" | "autoComplete">, Omit<React.ComponentPropsWithoutRef<"input">, keyof InputBaseProps | "size" | "color" | "style" | "className" | "id">, Pick<RecursicaFormControlWrapperProps, "label" | "error" | "required" | "id" | "assistiveText" | "assistiveWithIcon" | "formLayout" | "labelSize" | "labelAlignment" | "labelOptionalText" | "labelWithEditIcon" | "onLabelEditClick">, ReadOnlyControlProps, BaseRecursicaTextFieldProps {
 }
 export type TextFieldProps = RecursicaOverStyled<RecursicaTextFieldProps>;
-export declare const TextField: React.ForwardRefExoticComponent<(Omit<Omit<RecursicaTextFieldProps, "className" | "classes" | "style" | "sx" | "color" | "bgcolor" | "backgroundColor" | "typography" | "fontFamily" | "fontSize" | "fontWeight" | "lineHeight" | "letterSpacing" | "textAlign" | "border" | "borderTop" | "borderBottom" | "borderLeft" | "borderRight" | "borderColor" | "borderRadius" | "boxShadow" | "display" | "position" | "zIndex"> & import('../../utils/filterStylingProps').ForbiddenStyles & {
+export declare const TextField: React.ForwardRefExoticComponent<(Omit<Omit<RecursicaTextFieldProps, import('@recursica/adapter-common').BlockedStylingKeys> & import('@recursica/adapter-common').ForbiddenStyles & {
     overStyled?: false | undefined;
 }, "ref"> | Omit<RecursicaTextFieldProps & {
     overStyled: true;

package/dist/src/components/TimePicker/TimePicker.d.ts

@@ -1,3 +1,4 @@
 import { default as React } from 'react';
-export type TimePickerProps = React.HTMLAttributes<HTMLDivElement>;
+import { RecursicaTimePickerProps } from '@recursica/adapter-common';
+export type TimePickerProps = React.HTMLAttributes<HTMLDivElement> & RecursicaTimePickerProps;
 export declare const TimePicker: React.FC<TimePickerProps>;

package/dist/src/components/Timeline/Timeline.d.ts

@@ -2,12 +2,13 @@ import { default as React } from 'react';
 import { TimelineProps as MuiTimelineProps } from '@mui/lab/Timeline';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
 import { TimelineItem } from './TimelineItem';
+import { RecursicaTimelineProps } from '@recursica/adapter-common';
 /**
  * Properties for the strictly-tokenized Timeline component.
  * Native Mui abstract properties like `color`, `radius`, `bulletSize`, and `lineWidth`
  * have been stripped out to strictly enforce the structural mappings of the Recursica UI Kit.
  */
-export type TimelineProps = RecursicaOverStyled<Omit<MuiTimelineProps, "color" | "radius" | "bulletSize" | "lineWidth">>;
+export type TimelineProps = RecursicaOverStyled<Omit<MuiTimelineProps, "color" | "radius" | "bulletSize" | "lineWidth"> & RecursicaTimelineProps>;
 interface TimelineComponent extends React.ForwardRefExoticComponent<TimelineProps & React.RefAttributes<HTMLDivElement>> {
     Item: typeof TimelineItem;
 }

package/dist/src/components/Timeline/TimelineItem.d.ts

@@ -1,18 +1,7 @@
 import { default as React } from 'react';
 import { TimelineItemProps as MuiTimelineItemProps } from '@mui/lab/TimelineItem';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
-export interface RecursicaTimelineItemProps {
-    /**
-     * Timestamp text displayed below the description.
-     */
-    timestamp?: React.ReactNode;
-    /**
-     * The structural styling variant of the bullet container.
-     * Maps to the UI Kit structural tokens.
-     * @default "default"
-     */
-    bulletVariant?: "default" | "avatar" | "icon" | "icon-alternative";
-}
+import { RecursicaTimelineItemProps } from '@recursica/adapter-common';
 export type TimelineItemProps = RecursicaOverStyled<Omit<MuiTimelineItemProps, "radius" | "color" | "lineVariant"> & RecursicaTimelineItemProps>;
 /**
  * The individual item component for the Timeline.
@@ -22,7 +11,7 @@ export type TimelineItemProps = RecursicaOverStyled<Omit<MuiTimelineItemProps, "
  * rendering it below the body content. It also accepts a `bulletVariant` to morph
  * the structural dimensions of the node circle automatically.
  */
-export declare const TimelineItem: React.ForwardRefExoticComponent<(Omit<Omit<Omit<MuiTimelineItemProps, "color" | "radius" | "lineVariant"> & RecursicaTimelineItemProps, "className" | "classes" | "style" | "sx" | "color" | "bgcolor" | "backgroundColor" | "typography" | "fontFamily" | "fontSize" | "fontWeight" | "lineHeight" | "letterSpacing" | "textAlign" | "border" | "borderTop" | "borderBottom" | "borderLeft" | "borderRight" | "borderColor" | "borderRadius" | "boxShadow" | "display" | "position" | "zIndex"> & import('../../utils/filterStylingProps').ForbiddenStyles & {
+export declare const TimelineItem: React.ForwardRefExoticComponent<(Omit<Omit<Omit<MuiTimelineItemProps, "color" | "radius" | "lineVariant"> & RecursicaTimelineItemProps, import('@recursica/adapter-common').BlockedStylingKeys> & import('@recursica/adapter-common').ForbiddenStyles & {
     overStyled?: false | undefined;
 }, "ref"> | Omit<Omit<MuiTimelineItemProps, "color" | "radius" | "lineVariant"> & RecursicaTimelineItemProps & {
     overStyled: true;

package/dist/src/components/Title/Title.d.ts

@@ -1,18 +1,5 @@
 import { default as React } from 'react';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
-import { TypographyProps as MuiTypographyProps } from '@mui/material';
-export type RecursicaTitleProps = Omit<MuiTypographyProps, "variant"> & {
-    order?: 1 | 2 | 3 | 4 | 5 | 6;
-    children?: React.ReactNode;
-    component?: React.ElementType;
-};
+import { RecursicaTitleProps } from '@recursica/adapter-common';
 export type TitleProps = RecursicaOverStyled<RecursicaTitleProps>;
-export declare const Title: React.ForwardRefExoticComponent<(Omit<Omit<RecursicaTitleProps, "className" | "classes" | "style" | "sx" | "color" | "bgcolor" | "backgroundColor" | "typography" | "fontFamily" | "fontSize" | "fontWeight" | "lineHeight" | "letterSpacing" | "textAlign" | "border" | "borderTop" | "borderBottom" | "borderLeft" | "borderRight" | "borderColor" | "borderRadius" | "boxShadow" | "display" | "position" | "zIndex"> & import('../../utils/filterStylingProps').ForbiddenStyles & {
-    overStyled?: false | undefined;
-}, "ref"> | Omit<Omit<MuiTypographyProps, "variant"> & {
-    order?: 1 | 2 | 3 | 4 | 5 | 6;
-    children?: React.ReactNode;
-    component?: React.ElementType;
-} & {
-    overStyled: true;
-}, "ref">) & React.RefAttributes<HTMLElement>>;
+export declare const Title: React.ForwardRefExoticComponent<TitleProps & React.RefAttributes<HTMLElement>>;

package/dist/src/components/Toast/Toast.d.ts

@@ -1,26 +1,21 @@
 import { default as React } from 'react';
-import { SnackbarProps as MuiNotificationProps } from '@mui/material';
+import { AlertProps as MuiAlertProps } from '@mui/material';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
-export interface RecursicaToastProps {
-    /**
-     * The visual variant of the toast.
-     * @default "default"
-     */
-    variant?: "default" | "error" | "success";
-    /**
-     * Loading state is natively unsupported by Recursica UI Kit.
-     * If a loading state is required, pass a `<Loader size="sm" />` directly into the `icon` prop.
-     */
-    loading?: false;
+import { RecursicaToastProps as BaseRecursicaToastProps } from '@recursica/adapter-common';
+export interface RecursicaToastProps extends BaseRecursicaToastProps {
+    withCloseButton?: boolean;
+    title?: React.ReactNode;
+    icon?: React.ReactNode;
+    onClose?: () => void;
 }
 /**
- * Toast component wrapping Mui's Notification.
+ * Toast component wrapping Mui's Alert.
  *
  * Can be used as a standalone visual component to display a notification or message.
  */
-export type ToastProps = RecursicaOverStyled<Omit<MuiNotificationProps, "color" | "radius" | "variant" | "loading"> & RecursicaToastProps>;
-export declare const Toast: React.ForwardRefExoticComponent<(Omit<Omit<Omit<MuiNotificationProps, "color" | "variant" | "radius" | "loading"> & RecursicaToastProps, "className" | "classes" | "style" | "sx" | "color" | "bgcolor" | "backgroundColor" | "typography" | "fontFamily" | "fontSize" | "fontWeight" | "lineHeight" | "letterSpacing" | "textAlign" | "border" | "borderTop" | "borderBottom" | "borderLeft" | "borderRight" | "borderColor" | "borderRadius" | "boxShadow" | "display" | "position" | "zIndex"> & import('../../utils/filterStylingProps').ForbiddenStyles & {
+export type ToastProps = RecursicaOverStyled<Omit<MuiAlertProps, "color" | "radius" | "variant" | "onClose"> & RecursicaToastProps>;
+export declare const Toast: React.ForwardRefExoticComponent<(Omit<Omit<Omit<MuiAlertProps, "color" | "variant" | "onClose" | "radius"> & RecursicaToastProps, import('@recursica/adapter-common').BlockedStylingKeys> & import('@recursica/adapter-common').ForbiddenStyles & {
     overStyled?: false | undefined;
-}, "ref"> | Omit<Omit<MuiNotificationProps, "color" | "variant" | "radius" | "loading"> & RecursicaToastProps & {
+}, "ref"> | Omit<Omit<MuiAlertProps, "color" | "variant" | "onClose" | "radius"> & RecursicaToastProps & {
     overStyled: true;
 }, "ref">) & React.RefAttributes<HTMLDivElement>>;

package/dist/src/components/Tooltip/Tooltip.d.ts

@@ -1,17 +1,6 @@
-import { Tooltip as MuiTooltip, TooltipProps as MuiTooltipProps } from '@mui/material';
+import { TooltipProps as MuiTooltipProps } from '@mui/material';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
-/**
- * Recursica-specific props for Tooltip.
- */
-export interface RecursicaTooltipProps {
-    /**
-     * Whether to display a beak (arrow) pointing from the tooltip to the target.
-     * This is the Recursica equivalent of Mui's `withArrow`.
-     * When both `withBeak` and `withArrow` are provided, `withBeak` takes precedence.
-     * @default true
-     */
-    withBeak?: boolean;
-}
+import { RecursicaTooltipProps } from '@recursica/adapter-common';
 /**
  * Recursica Tooltip component wrapping Mui's Tooltip.
  *
@@ -30,13 +19,10 @@ export interface RecursicaTooltipProps {
  * - `// Tooltip.Group` — Shared hover delay group for multiple tooltips
  */
 export type TooltipProps = RecursicaOverStyled<MuiTooltipProps & RecursicaTooltipProps>;
-declare const TooltipBase: {
-    ({ overStyled, withBeak, ...rest }: TooltipProps): import("react/jsx-runtime").JSX.Element;
+export declare const Tooltip: {
+    ({ overStyled, withBeak, label, opened, ...rest }: TooltipProps & {
+        label?: React.ReactNode;
+        opened?: boolean;
+    }): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };
-type TooltipComponent = typeof TooltipBase & {
-    Floating: typeof MuiTooltip.Floating;
-    Group: typeof MuiTooltip.Group;
-};
-export declare const Tooltip: TooltipComponent;
-export {};

package/dist/src/components/TransferList/TransferList.d.ts

@@ -1,3 +1,4 @@
 import { default as React } from 'react';
-export type TransferListProps = React.HTMLAttributes<HTMLDivElement>;
+import { RecursicaTransferListProps } from '@recursica/adapter-common';
+export type TransferListProps = React.HTMLAttributes<HTMLDivElement> & RecursicaTransferListProps;
 export declare const TransferList: React.FC<TransferListProps>;

package/dist/src/components/Typography/Typography.d.ts

@@ -14,7 +14,7 @@ export declare const Typography: React.ForwardRefExoticComponent<(Omit<Omit<Omit
      */
     typographyClass: string;
     component?: React.ElementType;
-}, "className" | "classes" | "style" | "sx" | "color" | "bgcolor" | "backgroundColor" | "typography" | "fontFamily" | "fontSize" | "fontWeight" | "lineHeight" | "letterSpacing" | "textAlign" | "border" | "borderTop" | "borderBottom" | "borderLeft" | "borderRight" | "borderColor" | "borderRadius" | "boxShadow" | "display" | "position" | "zIndex"> & import('../../utils/filterStylingProps').ForbiddenStyles & {
+}, import('@recursica/adapter-common').BlockedStylingKeys> & import('@recursica/adapter-common').ForbiddenStyles & {
     overStyled?: false | undefined;
 }, "ref"> | Omit<Omit<MuiTypographyProps, "variant"> & {
     /**

package/dist/src/utils/RequireAccessibleLabel.d.ts

@@ -1,18 +1 @@
-import { ReactNode } from 'react';
-/**
- * Enforces accessibility by strictly requiring at least one form of labeling:
- * either a visual \`label\`, an \`aria-label\`, or an \`aria-labelledby\`.
- */
-export type RequireAccessibleLabel<T> = T & ({
-    label: ReactNode;
-    "aria-label"?: string;
-    "aria-labelledby"?: string;
-} | {
-    label?: ReactNode;
-    "aria-label": string;
-    "aria-labelledby"?: string;
-} | {
-    label?: ReactNode;
-    "aria-label"?: string;
-    "aria-labelledby": string;
-});
+export { type RequireAccessibleLabel } from '@recursica/adapter-common';

package/dist/src/utils/filterStylingProps.d.ts

@@ -22,18 +22,8 @@
  * @returns Sanitized component props safe for internal styling merging
  */
 export declare const BLOCKED_STYLING_KEYS: readonly ["className", "classes", "style", "sx", "color", "bgcolor", "backgroundColor", "typography", "fontFamily", "fontSize", "fontWeight", "lineHeight", "letterSpacing", "textAlign", "border", "borderTop", "borderBottom", "borderLeft", "borderRight", "borderColor", "borderRadius", "boxShadow", "display", "position", "zIndex"];
-export type BlockedStylingKeys = (typeof BLOCKED_STYLING_KEYS)[number];
-export type RecursicaSpacing = "rec-none" | "rec-sm" | "rec-default" | "rec-md" | "rec-lg" | "rec-xl" | "rec-2xl";
-export type RecursicaSize = "small" | "default" | "large";
+export { type RecursicaSpacing, type RecursicaSize, type RecursicaOverStyled, type BlockedStylingKeys, type ForbiddenStyles, } from '@recursica/adapter-common';
 export declare const SPACING_MAP: Record<string, string>;
-export type ForbiddenStyles = {
-    [K in BlockedStylingKeys]?: never;
-};
 export type OmitSx<T> = Omit<T, "sx">;
 export declare function filterSxProp<T extends Record<string, unknown>>(props: T): Omit<T, "sx">;
-export type RecursicaOverStyled<T> = (Omit<T, BlockedStylingKeys> & ForbiddenStyles & {
-    overStyled?: false | undefined;
-}) | (T & {
-    overStyled: true;
-});
 export declare function filterStylingProps<T extends Record<string, unknown>>(props: T, overStyled?: boolean): Partial<T>;

package/llms.txt

@@ -0,0 +1,16 @@
+# @recursica/mui-adapter
+
+> Reusable UI components for Recursica applications based on Material UI (MUI) v7.
+
+This adapter converts Recursica design tokens into MUI-specific themes and components.
+
+## Usage Guidelines
+
+- Relies on `@mui/material`, `@emotion/react`, and `@emotion/styled` peer dependencies.
+- When building UI in consumer applications, prioritize using components exported by this package to adhere to the Recursica design system.
+
+## Documentation
+
+- [USAGE](USAGE.md): Detailed usage instructions.
+- [ARCHITECTURE](ARCHITECTURE.md): Package architecture and dependencies.
+- [README](README.md)

package/package.json

@@ -13,7 +13,7 @@
     "url": "git+https://github.com/borderux/recursica.git",
     "directory": "packages/mui-adapter"
   },
-  "version": "0.6.0",
+  "version": "0.7.0",
   "publishConfig": {
     "access": "public"
   },
@@ -33,7 +33,11 @@
     "dist",
     "src",
     "CHANGELOG.md",
-    ".storybook/commonArgTypes.ts"
+    ".storybook/commonArgTypes.ts",
+    "llms.txt",
+    "USAGE.md",
+    "ARCHITECTURE.md",
+    "SETUP.md"
   ],
   "keywords": [
     "react",

package/src/components/Accordion/Accordion.module.css

@@ -160,8 +160,7 @@
 }
 .control:hover:not(:disabled)::after {
   opacity: var(
-    --recursica_ui-kit_components_accordion-item_properties_hover-opacity,
-    0.1
+    --recursica_ui-kit_components_accordion-item_properties_hover-opacity
   );
 }
 

package/src/components/Accordion/Accordion.stories.tsx

@@ -143,21 +143,3 @@ export const LayerOne: StoryObj<typeof Accordion> = {
     );
   },
 };
-
-export const Docs: StoryObj<typeof Accordion> = {
-  render: () => {
-    return (
-      <Layer layer={0} style={{ padding: "24px" }}>
-        <Accordion defaultValue="docs-1">
-          <Accordion.Item value="docs-1">
-            <Accordion.Control>Documentation Content</Accordion.Control>
-            <Accordion.Panel>
-              This is the explicitly requested Docs story for automated layout
-              testing.
-            </Accordion.Panel>
-          </Accordion.Item>
-        </Accordion>
-      </Layer>
-    );
-  },
-};

package/src/components/Accordion/Accordion.tsx

@@ -13,6 +13,12 @@ import {
 } from "../../utils/filterStylingProps";
 import styles from "./Accordion.module.css";
 
+import {
+  type RecursicaAccordionProps,
+  type RecursicaAccordionItemProps,
+  type RecursicaAccordionControlProps,
+} from "@recursica/adapter-common";
+
 const ChevronIcon = () => (
   <svg
     viewBox="0 0 24 24"
@@ -35,13 +41,7 @@ const AccordionContext = createContext<{
 
 // ==== ACCORDION CONTAINER ====
 export type AccordionProps = RecursicaOverStyled<
-  React.HTMLAttributes<HTMLDivElement> & {
-    variant?: string;
-    value?: string | string[];
-    defaultValue?: string | string[];
-    onChange?: (value: string | string[] | null) => void;
-    multiple?: boolean;
-  }
+  React.HTMLAttributes<HTMLDivElement> & RecursicaAccordionProps
 >;
 
 const AccordionBase = forwardRef<HTMLDivElement, AccordionProps>(
@@ -106,15 +106,11 @@ const AccordionBase = forwardRef<HTMLDivElement, AccordionProps>(
 );
 AccordionBase.displayName = "Accordion";
 
-// ==== ACCORDION ITEM ====
 export type AccordionItemWrapperProps = RecursicaOverStyled<
   Omit<MuiAccordionProps, "children" | "value"> & {
     children?: React.ReactNode;
-    title?: React.ReactNode;
-    leftIcon?: React.ReactNode;
-    divider?: boolean;
     value: string;
-  }
+  } & RecursicaAccordionItemProps
 >;
 
 export const AccordionItem = forwardRef<
@@ -171,14 +167,16 @@ export const AccordionItem = forwardRef<
         "expanded" | "onChange"
       >)}
     >
-      {title ? (
-        <>
-          <AccordionControl leftIcon={leftIcon}>{title}</AccordionControl>
-          <AccordionPanel>{children}</AccordionPanel>
-        </>
-      ) : (
-        children
-      )}
+      {
+        (title ? (
+          <>
+            <AccordionControl leftIcon={leftIcon}>{title}</AccordionControl>
+            <AccordionPanel>{children}</AccordionPanel>
+          </>
+        ) : (
+          children
+        )) as any
+      }
     </MuiAccordion>
   );
 });
@@ -186,9 +184,7 @@ AccordionItem.displayName = "AccordionItem";
 
 // ==== ACCORDION CONTROL ====
 export type AccordionControlWrapperProps = RecursicaOverStyled<
-  MuiAccordionSummaryProps & {
-    leftIcon?: React.ReactNode;
-  }
+  MuiAccordionSummaryProps & RecursicaAccordionControlProps
 >;
 
 export const AccordionControl = forwardRef<

package/src/components/AssistiveElement/AssistiveElement.module.css

@@ -5,15 +5,21 @@
 
 .root {
   /* Override MUI FormHelperText native resets structurally safely */
-  display: flex;
-  align-items: flex-start; /* Forces the icon to align with the first line of text */
-  margin: 0; /* HARDCODE: structural reset */
-  padding: 0; /* HARDCODE: structural reset */
+  display: flex !important;
+  align-items: flex-start !important; /* Forces the icon to align with the first line of text */
+  margin: 0 !important; /* HARDCODE: structural reset */
+  padding: 0 !important; /* HARDCODE: structural reset */
   width: 100%;
 
   gap: var(
     --recursica_ui-kit_components_assistive-element_properties_icon-text-gap
   );
+  margin-top: var(
+    --recursica_ui-kit_components_assistive-element_properties_top-margin
+  ) !important;
+  max-width: var(
+    --recursica_ui-kit_components_assistive-element_properties_max-width
+  );
 
   font-family: var(
     --recursica_ui-kit_components_assistive-element_properties_text_font-family
@@ -42,40 +48,37 @@
 }
 
 .text {
-  flex: 1; /* Consume remaining space causing native flex wrap */
+  overflow-wrap: break-word;
+  white-space: normal;
 }
 
 /* Base Icon Architecture */
 .icon {
-  flex-shrink: 0; /* Prevent squishing */
-  display: flex;
-  align-items: center;
-  justify-content: center;
+  flex-shrink: 0 !important; /* Prevent squishing */
+  display: flex !important;
+  align-items: center !important;
+  justify-content: center !important;
+
   width: var(
     --recursica_ui-kit_components_assistive-element_properties_icon-size
-  );
-  height: var(
-    --recursica_ui-kit_components_assistive-element_properties_icon-size
-  );
-
-  /* Mathematical vertical centering bounds to the first line of typography explicitly */
-  margin-top: calc(
-    (
-        var(
-            --recursica_ui-kit_components_assistive-element_properties_text_line-height
-          ) -
-          var(
-            --recursica_ui-kit_components_assistive-element_properties_icon-size
-          )
-      ) /
-      2
-  ); /* Forces exact centering bounds within the first text line vertically */
+  ) !important;
+  height: calc(
+    var(
+        --recursica_ui-kit_components_assistive-element_properties_text_line-height
+      ) *
+      var(
+        --recursica_ui-kit_components_assistive-element_properties_text_font-size
+      )
+  ) !important; /* Forces exact centering bounds within the first text line vertically */
 }
 
 .icon :global(svg) {
-  width: 100%;
-  height: 100%;
-  stroke-width: 2px;
+  width: var(
+    --recursica_ui-kit_components_assistive-element_properties_icon-size
+  ) !important;
+  height: var(
+    --recursica_ui-kit_components_assistive-element_properties_icon-size
+  ) !important;
 }
 
 /* =========================================