@recursica/mui-adapter 0.4.0 → 0.6.0

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

@@ -1,3 +1,45 @@
 import { default as React } from 'react';
-export type PaginationProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Pagination: React.FC<PaginationProps>;
+import { Pagination as MuiPagination, PaginationProps as MuiPaginationProps, PaginationRootProps as MuiPaginationRootProps } from '@mui/material';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+import { PaginationIcon } from './Pagination.icons';
+export type PaginationProps = RecursicaOverStyled<MuiPaginationProps> & {
+    /** If set to true, displays text labels alongside the icons for next/previous/first/last edges. */
+    withLabels?: boolean;
+};
+export type PaginationRootProps = RecursicaOverStyled<MuiPaginationRootProps>;
+export type PaginationEdgeProps<T extends React.ElementType> = React.ComponentProps<T> & {
+    /** If set to true, displays text labels alongside the icon. */
+    withLabel?: boolean;
+    icon?: any;
+};
+declare const _PaginationRoot: React.ForwardRefExoticComponent<any>;
+declare const _PaginationNext: React.ForwardRefExoticComponent<any>;
+declare const _PaginationPrevious: React.ForwardRefExoticComponent<any>;
+declare const _PaginationFirst: React.ForwardRefExoticComponent<any>;
+declare const _PaginationLast: React.ForwardRefExoticComponent<any>;
+declare const _Pagination: React.ForwardRefExoticComponent<(Omit<Omit<MuiPaginationProps, "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;
+} & {
+    /** If set to true, displays text labels alongside the icons for next/previous/first/last edges. */
+    withLabels?: boolean;
+}, "ref"> | Omit<MuiPaginationProps & {
+    overStyled: true;
+} & {
+    /** If set to true, displays text labels alongside the icons for next/previous/first/last edges. */
+    withLabels?: boolean;
+}, "ref">) & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Recursica Pagination component wrapping Mui's Pagination.
+ */
+export declare const Pagination: typeof _Pagination & {
+    Root: typeof _PaginationRoot;
+    Items: typeof MuiPagination.Items;
+    Control: typeof MuiPagination.Control;
+    Dots: typeof MuiPagination.Dots;
+    Next: typeof _PaginationNext;
+    Previous: typeof _PaginationPrevious;
+    First: typeof _PaginationFirst;
+    Last: typeof _PaginationLast;
+    Icon: typeof PaginationIcon;
+};
+export {};

package/dist/src/components/Pagination/Pagination.icons.d.ts

@@ -0,0 +1,8 @@
+export type PaginationIconType = "next" | "prev" | "first" | "last";
+export declare const PaginationIcon: ({ type, className, ...props }: React.ComponentProps<"svg"> & {
+    type: PaginationIconType;
+}) => import("react/jsx-runtime").JSX.Element;
+export declare const NextWithLabel: (props: any) => import("react/jsx-runtime").JSX.Element;
+export declare const PrevWithLabel: (props: any) => import("react/jsx-runtime").JSX.Element;
+export declare const FirstWithLabel: (props: any) => import("react/jsx-runtime").JSX.Element;
+export declare const LastWithLabel: (props: any) => import("react/jsx-runtime").JSX.Element;

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

@@ -1,3 +1,65 @@
-import { default as React } from 'react';
-export type PanelProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Panel: React.FC<PanelProps>;
+import { Drawer as MuiDrawer, DrawerProps as MuiDrawerProps } from '@mui/material';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+export interface RecursicaPanelProps extends MuiDrawerProps {
+    /**
+     * If true, forces the header text to a single line and truncates with an ellipsis.
+     * Note: While the prop is named `wrapHeaderText` for backward compatibility,
+     * setting it to `true` actually PREVENTS wrapping (it forces truncation).
+     */
+    wrapHeaderText?: boolean;
+}
+/**
+ * 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): 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 & {
+    Root: typeof MuiDrawer.Root;
+    Overlay: typeof MuiDrawer.Overlay;
+    Content: typeof MuiDrawer.Content;
+    Header: typeof MuiDrawer.Header;
+    Title: typeof MuiDrawer.Title;
+    CloseButton: typeof MuiDrawer.CloseButton;
+    Body: typeof MuiDrawer.Body;
+    Stack: typeof MuiDrawer.Stack;
+    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 } from '@recursica/adapter-common';
+import { RadioGroup } from './RadioGroup';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+import { RequireAccessibleLabel } from '../../utils/RequireAccessibleLabel';
+import { FormControlLayoutProps } from '../FormControlLayout/FormControlLayout';
+export type RecursicaRadioProps = RequireAccessibleLabel<Omit<MuiRadioProps, "size" | "color"> & ReadOnlyControlProps & Pick<FormControlLayoutProps, "formLayout" | "labelSize" | "controlMaxWidth" | "controlMinWidth">>;
+export type RadioProps = RecursicaOverStyled<RecursicaRadioProps>;
+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,13 @@
+import { default as React } from 'react';
+import { RadioGroupProps as MuiRadioGroupProps } from '@mui/material';
+import { ReadOnlyControlProps } from '@recursica/adapter-common';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+import { RecursicaFormControlWrapperProps } from '../FormControlWrapper/FormControlWrapper';
+export interface RecursicaRadioGroupProps extends Omit<MuiRadioGroupProps, "size" | "labelProps">, Omit<RecursicaFormControlWrapperProps, "controlMaxWidth" | "controlMinWidth">, ReadOnlyControlProps {
+}
+export type RadioGroupProps = RecursicaOverStyled<RecursicaRadioGroupProps>;
+export declare const RadioGroup: React.ForwardRefExoticComponent<(Omit<Omit<RecursicaRadioGroupProps, "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<RecursicaRadioGroupProps & {
+    overStyled: true;
+}, "ref">) & 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,8 @@
 import { default as React } from 'react';
-export type ReadOnlyFieldProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const ReadOnlyField: React.FC<ReadOnlyFieldProps>;
+import { ReadOnlyControlProps } from '@recursica/adapter-common';
+import { RecursicaFormControlWrapperProps } from '../FormControlWrapper/FormControlWrapper';
+export type ReadOnlyFieldProps = Omit<RecursicaFormControlWrapperProps, "error" | "focused"> & ReadOnlyControlProps & {
+    value?: any;
+    type?: "text" | "boolean" | "number" | "switch" | "date";
+};
+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,31 @@
-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';
+export interface RecursicaSegmentedControlProps {
+    /** The orientation of the control */
+    orientation?: "horizontal" | "vertical";
+    /** If true, the control will take up the full width of its container */
+    fullWidth?: boolean;
+    /**
+     * SegmentedControl should NOT be allowed to be disabled by design.
+     * This component explicitly disables the `disabled` prop.
+     */
+    disabled?: never;
+}
+export type SegmentedControlProps = RecursicaOverStyled<Omit<MuiSegmentedControlProps, "variant" | "size" | "radius" | "color" | "classNames" | "className" | "disabled"> & {
+    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" | "variant" | "disabled" | "size" | "radius" | "classNames"> & {
+    className?: string;
+    classNames?: Partial<Record<string, string>>;
+} & RecursicaSegmentedControlProps, "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<MuiSegmentedControlProps, "className" | "color" | "variant" | "disabled" | "size" | "radius" | "classNames"> & {
+    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,29 @@
 import { default as React } from 'react';
-export type SliderProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Slider: React.FC<SliderProps>;
+import { SliderProps as MuiSliderProps, InputWrapperProps } from '@mui/material';
+import { ReadOnlyControlProps } from '@recursica/adapter-common';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+import { RecursicaFormControlWrapperProps } from '../FormControlWrapper/FormControlWrapper';
+export interface RecursicaSliderProps extends Omit<Omit<MuiSliderProps, "size" | "color">, "variant" | "radius" | "wrapperProps" | "classNames" | "styles" | "label">, Omit<RecursicaFormControlWrapperProps, "controlMaxWidth" | "controlMinWidth">, Pick<InputWrapperProps, "error" | "required" | "withAsterisk">, ReadOnlyControlProps {
+    /** The form control label displayed above or beside the slider track. */
+    label?: React.ReactNode;
+    /** Floating tooltip shown above the thumb when dragging. Replaces Mui's `label`. */
+    tooltipLabel?: MuiSliderProps["label"];
+    /** An optional icon rendered to the left of the slider track. */
+    icon?: React.ReactNode;
+    /** Whether to render a numeric input field side-by-side or stacked with the track. Defaults to false. */
+    showInput?: boolean;
+    /** Whether to render min and max labels below the track. Defaults to true. */
+    showMinMaxLabels?: boolean;
+}
+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, "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<RecursicaSliderProps & {
+    overStyled: true;
+}, "ref">) & React.RefAttributes<HTMLDivElement>>;

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

@@ -1,3 +1,22 @@
 import { default as React } from 'react';
-export type StepperProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Stepper: React.FC<StepperProps>;
+import { StepperProps as MuiStepperProps } from '@mui/material';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+export interface RecursicaStepperProps extends Omit<MuiStepperProps, "size" | "color" | "radius" | "iconSize" | "contentPadding" | "activeStep"> {
+    size?: "small" | "large";
+    active?: number;
+    onStepClick?: (stepIndex: number) => void;
+    orientation?: "horizontal" | "vertical";
+}
+export type StepperProps = RecursicaOverStyled<RecursicaStepperProps>;
+export declare const StepperStep: React.FC<any>;
+export declare const StepperCompleted: React.FC<any>;
+declare const _Stepper: React.ForwardRefExoticComponent<(Omit<Omit<RecursicaStepperProps, "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<RecursicaStepperProps & {
+    overStyled: true;
+}, "ref">) & React.RefAttributes<HTMLDivElement>>;
+export declare const Stepper: typeof _Stepper & {
+    Step: typeof StepperStep;
+    Completed: typeof StepperCompleted;
+};
+export {};

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 } from '@recursica/adapter-common';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+import { RequireAccessibleLabel } from '../../utils/RequireAccessibleLabel';
+import { FormControlLayoutProps } from '../FormControlLayout/FormControlLayout';
+export type RecursicaSwitchProps = RequireAccessibleLabel<Omit<MuiSwitchProps, "size" | "color" | "radius" | "variant"> & ReadOnlyControlProps & Pick<FormControlLayoutProps, "formLayout" | "labelSize" | "controlMaxWidth" | "controlMinWidth">>;
+export type SwitchProps = RecursicaOverStyled<RecursicaSwitchProps>;
+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 { SwitchGroupProps as MuiSwitchGroupProps } from '@mui/material';
+import { ReadOnlyControlProps } from '@recursica/adapter-common';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+import { RecursicaFormControlWrapperProps } from '../FormControlWrapper/FormControlWrapper';
+export interface RecursicaSwitchGroupProps extends Omit<MuiSwitchGroupProps, "size" | "labelProps">, Omit<RecursicaFormControlWrapperProps, "controlMaxWidth" | "controlMinWidth">, ReadOnlyControlProps {
+}
+export type SwitchGroupProps = RecursicaOverStyled<RecursicaSwitchGroupProps>;
+export declare const SwitchGroup: React.ForwardRefExoticComponent<(Omit<Omit<RecursicaSwitchGroupProps, "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<RecursicaSwitchGroupProps & {
+    overStyled: true;
+}, "ref">) & React.RefAttributes<HTMLDivElement>>;

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

@@ -1,3 +1,35 @@
-import { default as React } from 'react';
-export type TabsProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Tabs: React.FC<TabsProps>;
+import { TabsProps as MuiTabsProps, ListProps as MuiTabsListProps, TabsProps as MuiTabsTabProps } from '@mui/material';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+export interface RecursicaTabsProps extends Omit<MuiTabsProps, "variant" | "classNames" | "color" | "radius"> {
+    variant?: "default" | "outline" | "pills";
+}
+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 & {
+    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"> & {
+    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 & {
+    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;
+} & {
+    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 {};

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

@@ -8,7 +8,7 @@ export type RecursicaTextProps = Omit<MuiTypographyProps, "variant"> & {
     component?: React.ElementType;
 };
 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 & {
+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;

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

@@ -1,3 +1,19 @@
 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 } 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 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 & {
+    overStyled?: false | undefined;
+}, "ref"> | Omit<RecursicaTextAreaProps & {
+    overStyled: true;
+}, "ref">) & React.RefAttributes<HTMLTextAreaElement>>;

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

@@ -1,3 +1,17 @@
 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 } 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 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 & {
+    overStyled?: false | undefined;
+}, "ref"> | Omit<RecursicaTextFieldProps & {
+    overStyled: true;
+}, "ref">) & React.RefAttributes<HTMLInputElement>>;

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

@@ -1,3 +1,15 @@
 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';
+/**
+ * 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">>;
+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,29 @@
+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";
+}
+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, "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<MuiTimelineItemProps, "color" | "radius" | "lineVariant"> & RecursicaTimelineItemProps & {
+    overStyled: true;
+}, "ref">) & React.RefAttributes<HTMLDivElement>>;

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

@@ -7,7 +7,7 @@ export type RecursicaTitleProps = Omit<MuiTypographyProps, "variant"> & {
     component?: React.ElementType;
 };
 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 & {
+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;

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

@@ -1,3 +1,26 @@
 import { default as React } from 'react';
-export type ToastProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Toast: React.FC<ToastProps>;
+import { SnackbarProps as MuiNotificationProps } 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;
+}
+/**
+ * Toast component wrapping Mui's Notification.
+ *
+ * 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 & {
+    overStyled?: false | undefined;
+}, "ref"> | Omit<Omit<MuiNotificationProps, "color" | "variant" | "radius" | "loading"> & RecursicaToastProps & {
+    overStyled: true;
+}, "ref">) & React.RefAttributes<HTMLDivElement>>;

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

@@ -1,3 +1,42 @@
-import { default as React } from 'react';
-export type TooltipProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Tooltip: React.FC<TooltipProps>;
+import { Tooltip as MuiTooltip, 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;
+}
+/**
+ * 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>;
+declare const TooltipBase: {
+    ({ overStyled, withBeak, ...rest }: TooltipProps): 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 {};