@recursica/mui-adapter 0.5.0 → 0.7.0

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

@@ -1,3 +1,52 @@
-import { default as React } from 'react';
-export type PanelProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Panel: React.FC<PanelProps>;
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+import { RecursicaPanelProps } from '@recursica/adapter-common';
+/**
+ * Recursica Panel root props. Extends Mui Drawer.
+ */
+export type PanelProps = RecursicaOverStyled<RecursicaPanelProps>;
+/**
+ * Recursica Panel component wrapping Mui's Drawer.
+ *
+ * Panels slide in or expand from the edge of the screen to reveal
+ * additional content or functionality. They are commonly used to provide
+ * supplementary information, navigation options, or toolsets without
+ * cluttering the main interface.
+ *
+ * ```tsx
+ * <Panel opened={opened} onClose={close} title="Panel Title" position="right">
+ *   <Panel.Body>
+ *     Content goes here
+ *   </Panel.Body>
+ * </Panel>
+ * ```
+ *
+ * Mui Drawer sub-components available via dot-notation:
+ * - `Panel.Header` — Top section with title and close button
+ * - `Panel.Title` — Title text within the header
+ * - `Panel.CloseButton` — Close button within the header
+ * - `Panel.Body` — Scrollable body content area
+ * - `Panel.Content` — Outer content container
+ * - `Panel.Overlay` — Background overlay
+ * - `Panel.Root` — Root element for advanced composition
+ * - `Panel.Stack` — Stacked drawer context
+ */
+declare const PanelBase: {
+    ({ overStyled, position, keepMounted, wrapHeaderText, ...rest }: PanelProps & {
+        position?: "left" | "right" | "top" | "bottom";
+        opened?: boolean;
+    }): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export type PanelFooterProps = RecursicaOverStyled<React.HTMLAttributes<HTMLDivElement>>;
+/**
+ * Panel footer section with action buttons.
+ * Separated from the body by a divider. Remains fixed at the bottom.
+ * This is a Recursica-specific sub-component; Mui Drawer does not
+ * natively provide a footer.
+ */
+export declare const PanelFooter: import('react').ForwardRefExoticComponent<PanelFooterProps & import('react').RefAttributes<HTMLDivElement>>;
+type PanelComponent = typeof PanelBase & {
+    Footer: typeof PanelFooter;
+};
+export declare const Panel: PanelComponent;
+export {};

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

@@ -1,3 +1,13 @@
-import { default as React } from 'react';
-export type RadioProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Radio: React.FC<RadioProps>;
+import { RadioProps as MuiRadioProps } from '@mui/material';
+import { ReadOnlyControlProps, RequireAccessibleLabel, RecursicaRadioProps } from '@recursica/adapter-common';
+import { RadioGroup } from './RadioGroup';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+import { FormControlLayoutProps } from '../FormControlLayout/FormControlLayout';
+export type RadioWrapperProps = Omit<MuiRadioProps, "size" | "color"> & RecursicaRadioProps & ReadOnlyControlProps & Pick<FormControlLayoutProps, "formLayout" | "labelSize" | "controlMaxWidth" | "controlMinWidth">;
+export type RecursicaRadioPropsAlias = RequireAccessibleLabel<RadioWrapperProps>;
+export type RadioProps = RecursicaOverStyled<RecursicaRadioPropsAlias>;
+type RadioComponent = React.ForwardRefExoticComponent<RadioProps & React.RefAttributes<HTMLInputElement>> & {
+    Group: typeof RadioGroup;
+};
+export declare const Radio: RadioComponent;
+export {};

package/dist/src/components/Radio/RadioGroup.d.ts

@@ -0,0 +1,9 @@
+import { default as React } from 'react';
+import { RadioGroupProps as MuiRadioGroupProps } from '@mui/material';
+import { ReadOnlyControlProps, RecursicaRadioGroupProps as BaseRecursicaRadioGroupProps } from '@recursica/adapter-common';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+import { RecursicaFormControlWrapperProps } from '../FormControlWrapper/FormControlWrapper';
+export interface RecursicaRadioGroupProps extends Omit<MuiRadioGroupProps, "size" | "labelProps" | "classes" | "ref" | "onChange" | "value" | "defaultValue">, Omit<RecursicaFormControlWrapperProps, "controlMaxWidth" | "controlMinWidth" | "classes" | "onChange" | keyof MuiRadioGroupProps>, ReadOnlyControlProps, BaseRecursicaRadioGroupProps {
+}
+export type RadioGroupProps = RecursicaOverStyled<RecursicaRadioGroupProps>;
+export declare const RadioGroup: React.ForwardRefExoticComponent<RadioGroupProps & React.RefAttributes<HTMLDivElement>>;

package/dist/src/components/ReadOnlyField/ReadOnlyBooleanField.d.ts

@@ -0,0 +1,5 @@
+import { default as React } from 'react';
+export declare const ReadOnlyBooleanField: React.FC<{
+    checked: boolean;
+    label?: React.ReactNode;
+}>;

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

@@ -1,3 +1,5 @@
 import { default as React } from 'react';
-export type ReadOnlyFieldProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const ReadOnlyField: React.FC<ReadOnlyFieldProps>;
+import { ReadOnlyControlProps, RecursicaReadOnlyFieldProps as BaseRecursicaReadOnlyFieldProps } from '@recursica/adapter-common';
+import { RecursicaFormControlWrapperProps } from '../FormControlWrapper/FormControlWrapper';
+export type ReadOnlyFieldProps = Omit<RecursicaFormControlWrapperProps, "error" | "focused" | "controlMaxWidth" | "controlMinWidth"> & ReadOnlyControlProps & BaseRecursicaReadOnlyFieldProps;
+export declare const ReadOnlyField: React.ForwardRefExoticComponent<Omit<ReadOnlyFieldProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/src/components/ReadOnlyField/ReadOnlySwitchField.d.ts

@@ -0,0 +1,5 @@
+import { default as React } from 'react';
+export declare const ReadOnlySwitchField: React.FC<{
+    checked: boolean;
+    label?: React.ReactNode;
+}>;

package/dist/src/components/ReadOnlyField/ReadOnlyTextField.d.ts

@@ -0,0 +1,8 @@
+import { default as React } from 'react';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+export interface RecursicaReadOnlyTextFieldProps {
+    /** The value strictly rendered as text output */
+    value?: any;
+}
+export type ReadOnlyTextFieldProps = RecursicaOverStyled<RecursicaReadOnlyTextFieldProps>;
+export declare const ReadOnlyTextField: React.FC<ReadOnlyTextFieldProps>;

package/dist/src/components/ReadOnlyField/WithReadOnlyWrapper.d.ts

@@ -0,0 +1,28 @@
+import { default as React } from 'react';
+import { ReadOnlyFieldType } from '@recursica/adapter-common';
+import { FormControlWrapperProps } from '../FormControlWrapper/FormControlWrapper';
+export interface WithReadOnlyWrapperProps extends Omit<FormControlWrapperProps, "children" | "overStyled"> {
+    /** Injects whether the field defaults to reading mode natively */
+    readOnly?: boolean;
+    /** Explicit React component directly overtaking the baseline text renderer when read-only mode is active */
+    readOnlyComponent?: React.ElementType<any>;
+    /** Custom renderer explicitly responsible for formatting missing/empty value mappings (overriding default 'N/A') */
+    emptyValueComponent?: React.ElementType<{
+        value?: any;
+    }>;
+    /** The full native props dictionary securely forwarded into the custom readOnlyComponent if active */
+    readOnlyNativeProps?: any;
+    /** Instructs the underlying generic ReadOnlyField which raw visual structure to bridge automatically */
+    readOnlyType?: ReadOnlyFieldType;
+    /** The isolated raw data value intercepted explicitly into the ReadOnly formatters */
+    readOnlyValue?: any;
+    /** Safely enables deep overrides transparently bypassing block filters */
+    overStyled?: boolean;
+    /** The nested active node dynamically exposed exclusively when read-only bounds are disabled */
+    activeComponent: React.ReactNode;
+}
+/**
+ * Universal execution barrier trapping readOnly states globally.
+ * Natively delegates active logic down avoiding duplicative internal component bindings dynamically.
+ */
+export declare const WithReadOnlyWrapper: React.ForwardRefExoticComponent<Omit<WithReadOnlyWrapperProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

package/dist/src/components/ReadOnlyField/index.d.ts

@@ -1 +1,2 @@
 export * from './ReadOnlyField';
+export * from './WithReadOnlyWrapper';

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

@@ -1,3 +1,21 @@
-import { default as React } from 'react';
-export type SegmentedControlProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const SegmentedControl: React.FC<SegmentedControlProps>;
+import { ToggleButtonGroupProps as MuiSegmentedControlProps } from '@mui/material';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+import { RecursicaSegmentedControlProps } from '@recursica/adapter-common';
+export type SegmentedControlProps = RecursicaOverStyled<Omit<MuiSegmentedControlProps, "variant" | "size" | "radius" | "color" | "classNames" | "className" | "disabled" | "value" | "onChange"> & {
+    className?: string;
+    classNames?: Partial<Record<string, string>>;
+} & RecursicaSegmentedControlProps>;
+/**
+ * Recursica SegmentedControl component wrapping Mui's SegmentedControl.
+ */
+export declare const SegmentedControl: import('react').ForwardRefExoticComponent<(Omit<Omit<Omit<MuiSegmentedControlProps, "className" | "color" | "value" | "classNames" | "onChange" | "variant" | "disabled" | "size" | "radius"> & {
+    className?: string;
+    classNames?: Partial<Record<string, string>>;
+} & RecursicaSegmentedControlProps, import('@recursica/adapter-common').BlockedStylingKeys> & import('@recursica/adapter-common').ForbiddenStyles & {
+    overStyled?: false | undefined;
+}, "ref"> | Omit<Omit<MuiSegmentedControlProps, "className" | "color" | "value" | "classNames" | "onChange" | "variant" | "disabled" | "size" | "radius"> & {
+    className?: string;
+    classNames?: Partial<Record<string, string>>;
+} & RecursicaSegmentedControlProps & {
+    overStyled: true;
+}, "ref">) & import('react').RefAttributes<HTMLDivElement>>;

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

@@ -1,3 +1,19 @@
 import { default as React } from 'react';
-export type SliderProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Slider: React.FC<SliderProps>;
+import { SliderProps as MuiSliderProps } from '@mui/material';
+import { ReadOnlyControlProps, RecursicaSliderProps as BaseRecursicaSliderProps } from '@recursica/adapter-common';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+import { RecursicaFormControlWrapperProps } from '../FormControlWrapper/FormControlWrapper';
+export interface RecursicaSliderProps extends Omit<MuiSliderProps, "size" | "color" | "classes" | "onChange" | "onChangeCommitted">, Omit<RecursicaFormControlWrapperProps, "controlMaxWidth" | "controlMinWidth" | "error" | "required" | "withAsterisk" | keyof MuiSliderProps>, ReadOnlyControlProps, BaseRecursicaSliderProps {
+}
+export type SliderProps = RecursicaOverStyled<RecursicaSliderProps>;
+/**
+ * Recursica Slider component wrapping Mui's Slider.
+ *
+ * Implements a bidirectional text input field next to the slider track, responsive layouts,
+ * custom typography-bound min/max labels, an optional leading icon, and an explicit read-only layout.
+ */
+export declare const Slider: React.ForwardRefExoticComponent<(Omit<Omit<RecursicaSliderProps, import('@recursica/adapter-common').BlockedStylingKeys> & import('@recursica/adapter-common').ForbiddenStyles & {
+    overStyled?: false | undefined;
+}, "ref"> | Omit<RecursicaSliderProps & {
+    overStyled: true;
+}, "ref">) & React.RefAttributes<HTMLDivElement>>;

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

@@ -1,9 +1,6 @@
 import { default as React } from 'react';
 import { StackProps as MUIStackProps } from '@mui/material';
-import { RecursicaSpacing, OmitSx } from '../../utils/filterStylingProps';
-export interface RecursicaStackProps {
-    children?: React.ReactNode;
-    gap?: MUIStackProps["spacing"] | RecursicaSpacing;
-}
+import { OmitSx } from '../../utils/filterStylingProps';
+import { RecursicaStackProps } from '@recursica/adapter-common';
 export type StackProps = OmitSx<Omit<MUIStackProps, "spacing"> & RecursicaStackProps>;
 export declare const Stack: React.ForwardRefExoticComponent<Omit<StackProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

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

@@ -1,3 +1,42 @@
 import { default as React } from 'react';
-export type StepperProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Stepper: React.FC<StepperProps>;
+import { StepProps as MuiStepProps, StepLabelProps as MuiStepLabelProps, StepButtonProps as MuiStepButtonProps, StepConnectorProps as MuiStepConnectorProps } from '@mui/material';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+import { RecursicaStepperProps } from '@recursica/adapter-common';
+export type StepperProps = RecursicaOverStyled<RecursicaStepperProps>;
+export declare const Stepper: React.ForwardRefExoticComponent<StepperProps & React.RefAttributes<HTMLDivElement>>;
+export type StepProps = RecursicaOverStyled<MuiStepProps>;
+export declare const Step: React.ForwardRefExoticComponent<(Omit<Omit<MuiStepProps, import('@recursica/adapter-common').BlockedStylingKeys> & import('@recursica/adapter-common').ForbiddenStyles & {
+    overStyled?: false | undefined;
+}, "ref"> | Omit<{
+    component?: React.ElementType | undefined;
+} & import('@mui/material').StepOwnProps & import('@mui/material/OverridableComponent').CommonProps & Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "className" | "classes" | "style" | "sx" | "children" | "disabled" | "expanded" | "component" | "last" | "active" | "index" | "completed"> & {
+    component?: React.ElementType | undefined;
+} & {
+    overStyled: true;
+}, "ref">) & React.RefAttributes<HTMLDivElement>>;
+export type StepButtonProps = RecursicaOverStyled<MuiStepButtonProps>;
+export declare const StepButton: React.ForwardRefExoticComponent<(Omit<Omit<MuiStepButtonProps, import('@recursica/adapter-common').BlockedStylingKeys> & import('@recursica/adapter-common').ForbiddenStyles & {
+    overStyled?: false | undefined;
+}, "ref"> | Omit<import('@mui/material').StepButtonOwnProps & Omit<import('@mui/material').ButtonBaseOwnProps, "classes"> & import('@mui/material/OverridableComponent').CommonProps & Omit<React.DetailedHTMLProps<React.ButtonHTMLAttributes<HTMLButtonElement>, HTMLButtonElement>, "className" | "classes" | "style" | "sx" | "tabIndex" | "children" | "disabled" | "action" | "centerRipple" | "disableRipple" | "disableTouchRipple" | "focusRipple" | "focusVisibleClassName" | "LinkComponent" | "onFocusVisible" | "TouchRippleProps" | "touchRippleRef" | "icon" | "optional"> & {
+    component?: React.ElementType | undefined;
+} & {
+    overStyled: true;
+}, "ref">) & React.RefAttributes<HTMLButtonElement>>;
+export type StepLabelProps = RecursicaOverStyled<MuiStepLabelProps & {
+    description?: React.ReactNode;
+}>;
+export declare const StepLabel: React.ForwardRefExoticComponent<(Omit<Omit<MuiStepLabelProps & {
+    description?: React.ReactNode;
+}, import('@recursica/adapter-common').BlockedStylingKeys> & import('@recursica/adapter-common').ForbiddenStyles & {
+    overStyled?: false | undefined;
+}, "ref"> | Omit<MuiStepLabelProps & {
+    description?: React.ReactNode;
+} & {
+    overStyled: true;
+}, "ref">) & React.RefAttributes<HTMLDivElement>>;
+export type StepConnectorProps = RecursicaOverStyled<MuiStepConnectorProps>;
+export declare const StepConnector: React.ForwardRefExoticComponent<(Omit<Omit<MuiStepConnectorProps, import('@recursica/adapter-common').BlockedStylingKeys> & import('@recursica/adapter-common').ForbiddenStyles & {
+    overStyled?: false | undefined;
+}, "ref"> | Omit<MuiStepConnectorProps & {
+    overStyled: true;
+}, "ref">) & React.RefAttributes<HTMLDivElement>>;

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

@@ -1,3 +1,10 @@
-import { default as React } from 'react';
-export type SwitchProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Switch: React.FC<SwitchProps>;
+import { SwitchProps as MuiSwitchProps } from '@mui/material';
+import { ReadOnlyControlProps, RequireAccessibleLabel, RecursicaSwitchProps } from '@recursica/adapter-common';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+import { FormControlLayoutProps } from '../FormControlLayout/FormControlLayout';
+export type SwitchWrapperProps = Omit<MuiSwitchProps, "size" | "color" | "radius" | "variant"> & RecursicaSwitchProps & ReadOnlyControlProps & Pick<FormControlLayoutProps, "formLayout" | "labelSize" | "controlMaxWidth" | "controlMinWidth">;
+export type RecursicaSwitchPropsAlias = RequireAccessibleLabel<SwitchWrapperProps>;
+export type SwitchProps = RecursicaOverStyled<RecursicaSwitchPropsAlias>;
+type SwitchComponent = any;
+export declare const Switch: SwitchComponent;
+export {};

package/dist/src/components/Switch/SwitchGroup.d.ts

@@ -0,0 +1,13 @@
+import { default as React } from 'react';
+import { FormGroupProps as MuiFormGroupProps } from '@mui/material';
+import { ReadOnlyControlProps, RecursicaSwitchGroupProps as BaseRecursicaSwitchGroupProps } from '@recursica/adapter-common';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+import { RecursicaFormControlWrapperProps } from '../FormControlWrapper/FormControlWrapper';
+export interface RecursicaSwitchGroupProps extends Omit<MuiFormGroupProps, "size" | "labelProps" | "onChange" | "classes" | "ref" | "value" | "defaultValue">, Omit<RecursicaFormControlWrapperProps, "controlMaxWidth" | "controlMinWidth" | "classes" | "onChange">, ReadOnlyControlProps, BaseRecursicaSwitchGroupProps {
+}
+export type SwitchGroupProps = RecursicaOverStyled<RecursicaSwitchGroupProps>;
+export declare const SwitchGroup: React.ForwardRefExoticComponent<(Omit<Omit<RecursicaSwitchGroupProps, import('@recursica/adapter-common').BlockedStylingKeys> & import('@recursica/adapter-common').ForbiddenStyles & {
+    overStyled?: false | undefined;
+}, "ref"> | Omit<RecursicaSwitchGroupProps & {
+    overStyled: true;
+}, "ref">) & React.RefAttributes<HTMLDivElement>>;

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

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

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

@@ -1,3 +1,20 @@
-import { default as React } from 'react';
-export type TabsProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Tabs: React.FC<TabsProps>;
+import { TabProps as MuiTabProps } from '@mui/material';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+import { RecursicaTabsProps } from '@recursica/adapter-common';
+import { TabPanelProps as MuiTabPanelProps } from '@mui/lab';
+export type TabsProps = RecursicaOverStyled<RecursicaTabsProps>;
+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<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 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<MuiTabPanelProps & {
+    overStyled: true;
+}, "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, "style" | "className" | "classes" | "border" | "borderTop" | "borderRight" | "borderBottom" | "borderLeft" | "borderColor" | "borderRadius" | "display" | "bgcolor" | "color" | "zIndex" | "position" | "boxShadow" | "typography" | "fontFamily" | "fontSize" | "fontWeight" | "letterSpacing" | "lineHeight" | "textAlign" | "backgroundColor" | "sx"> & 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,3 +1,13 @@
 import { default as React } from 'react';
-export type TextAreaProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const TextArea: React.FC<TextAreaProps>;
+import { TextFieldProps as MuiTextareaProps } from '@mui/material';
+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, BaseRecursicaTextAreaProps {
+}
+export type TextAreaProps = RecursicaOverStyled<RecursicaTextAreaProps>;
+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;
+}, "ref">) & React.RefAttributes<HTMLTextAreaElement>>;

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

@@ -1,3 +1,13 @@
 import { default as React } from 'react';
-export type TextFieldProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const TextField: React.FC<TextFieldProps>;
+import { InputBaseProps } from '@mui/material';
+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, BaseRecursicaTextFieldProps {
+}
+export type TextFieldProps = RecursicaOverStyled<RecursicaTextFieldProps>;
+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;
+}, "ref">) & React.RefAttributes<HTMLInputElement>>;

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

@@ -1,3 +1,16 @@
 import { default as React } from 'react';
-export type TimelineProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Timeline: React.FC<TimelineProps>;
+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"> & RecursicaTimelineProps>;
+interface TimelineComponent extends React.ForwardRefExoticComponent<TimelineProps & React.RefAttributes<HTMLDivElement>> {
+    Item: typeof TimelineItem;
+}
+export declare const Timeline: TimelineComponent;
+export {};

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

@@ -0,0 +1,18 @@
+import { default as React } from 'react';
+import { TimelineItemProps as MuiTimelineItemProps } from '@mui/lab/TimelineItem';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+import { RecursicaTimelineItemProps } from '@recursica/adapter-common';
+export type TimelineItemProps = RecursicaOverStyled<Omit<MuiTimelineItemProps, "radius" | "color" | "lineVariant"> & RecursicaTimelineItemProps>;
+/**
+ * The individual item component for the Timeline.
+ *
+ * **Recursica Abstract:**
+ * The `Timeline.Item` has been extended to support a `timestamp` string natively,
+ * 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, import('@recursica/adapter-common').BlockedStylingKeys> & import('@recursica/adapter-common').ForbiddenStyles & {
+    overStyled?: false | undefined;
+}, "ref"> | Omit<Omit<MuiTimelineItemProps, "color" | "radius" | "lineVariant"> & RecursicaTimelineItemProps & {
+    overStyled: true;
+}, "ref">) & React.RefAttributes<HTMLDivElement>>;

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, "style" | "className" | "classes" | "border" | "borderTop" | "borderRight" | "borderBottom" | "borderLeft" | "borderColor" | "borderRadius" | "display" | "bgcolor" | "color" | "zIndex" | "position" | "boxShadow" | "typography" | "fontFamily" | "fontSize" | "fontWeight" | "letterSpacing" | "lineHeight" | "textAlign" | "backgroundColor" | "sx"> & 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,3 +1,21 @@
 import { default as React } from 'react';
-export type ToastProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Toast: React.FC<ToastProps>;
+import { AlertProps as MuiAlertProps } from '@mui/material';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+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 Alert.
+ *
+ * Can be used as a standalone visual component to display a notification or message.
+ */
+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<MuiAlertProps, "color" | "variant" | "onClose" | "radius"> & RecursicaToastProps & {
+    overStyled: true;
+}, "ref">) & React.RefAttributes<HTMLDivElement>>;

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

@@ -1,3 +1,28 @@
-import { default as React } from 'react';
-export type TooltipProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Tooltip: React.FC<TooltipProps>;
+import { TooltipProps as MuiTooltipProps } from '@mui/material';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+import { RecursicaTooltipProps } from '@recursica/adapter-common';
+/**
+ * Recursica Tooltip component wrapping Mui's Tooltip.
+ *
+ * Displays a floating label when the user hovers over or focuses a target element.
+ * Unlike HoverCard, Tooltip is a single component (not composable) — content is
+ * passed via the `label` prop, and the trigger is passed as `children`.
+ *
+ * ```tsx
+ * <Tooltip label="Helpful information" withBeak>
+ *   <Button>Hover me</Button>
+ * </Tooltip>
+ * ```
+ *
+ * Static sub-components available via dot-notation:
+ * - `// Tooltip.Floating` — Tooltip that follows the cursor
+ * - `// Tooltip.Group` — Shared hover delay group for multiple tooltips
+ */
+export type TooltipProps = RecursicaOverStyled<MuiTooltipProps & RecursicaTooltipProps>;
+export declare const Tooltip: {
+    ({ overStyled, withBeak, label, opened, ...rest }: TooltipProps & {
+        label?: React.ReactNode;
+        opened?: boolean;
+    }): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

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;
-}, "style" | "className" | "classes" | "border" | "borderTop" | "borderRight" | "borderBottom" | "borderLeft" | "borderColor" | "borderRadius" | "display" | "bgcolor" | "color" | "zIndex" | "position" | "boxShadow" | "typography" | "fontFamily" | "fontSize" | "fontWeight" | "letterSpacing" | "lineHeight" | "textAlign" | "backgroundColor" | "sx"> & 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)