@recursica/mui-adapter 0.4.0 → 0.6.0

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

@@ -1,3 +1,64 @@
 import { default as React } from 'react';
-export type AccordionProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Accordion: React.FC<AccordionProps>;
+import { AccordionProps as MuiAccordionProps, AccordionSummaryProps as MuiAccordionSummaryProps, AccordionDetailsProps as MuiAccordionDetailsProps } from '@mui/material';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+export type AccordionProps = RecursicaOverStyled<React.HTMLAttributes<HTMLDivElement> & {
+    variant?: string;
+    value?: string | string[];
+    defaultValue?: string | string[];
+    onChange?: (value: string | string[] | null) => void;
+    multiple?: boolean;
+}>;
+declare const AccordionBase: React.ForwardRefExoticComponent<AccordionProps & React.RefAttributes<HTMLDivElement>>;
+export type AccordionItemWrapperProps = RecursicaOverStyled<Omit<MuiAccordionProps, "children" | "value"> & {
+    children?: React.ReactNode;
+    title?: React.ReactNode;
+    leftIcon?: React.ReactNode;
+    divider?: boolean;
+    value: string;
+}>;
+export declare const AccordionItem: React.ForwardRefExoticComponent<(Omit<Omit<Omit<MuiAccordionProps, "value" | "children"> & {
+    children?: React.ReactNode;
+    title?: React.ReactNode;
+    leftIcon?: React.ReactNode;
+    divider?: boolean;
+    value: string;
+}, "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<MuiAccordionProps, "value" | "children"> & {
+    children?: React.ReactNode;
+    title?: React.ReactNode;
+    leftIcon?: React.ReactNode;
+    divider?: boolean;
+    value: string;
+} & {
+    overStyled: true;
+}, "ref">) & React.RefAttributes<HTMLDivElement>>;
+export type AccordionControlWrapperProps = RecursicaOverStyled<MuiAccordionSummaryProps & {
+    leftIcon?: React.ReactNode;
+}>;
+export declare const AccordionControl: React.ForwardRefExoticComponent<(Omit<Omit<import('@mui/material').AccordionSummaryOwnProps & Omit<import('@mui/material').ButtonBaseOwnProps, "classes"> & import('@mui/material/OverridableComponent').CommonProps & Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "className" | "classes" | "style" | "sx" | "tabIndex" | "children" | "disabled" | "slots" | "slotProps" | "action" | "centerRipple" | "disableRipple" | "disableTouchRipple" | "focusRipple" | "focusVisibleClassName" | "LinkComponent" | "onFocusVisible" | "TouchRippleProps" | "touchRippleRef" | "expandIcon"> & {
+    component?: React.ElementType | undefined;
+} & {
+    leftIcon?: React.ReactNode;
+}, "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').AccordionSummaryOwnProps & Omit<import('@mui/material').ButtonBaseOwnProps, "classes"> & import('@mui/material/OverridableComponent').CommonProps & Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "className" | "classes" | "style" | "sx" | "tabIndex" | "children" | "disabled" | "slots" | "slotProps" | "action" | "centerRipple" | "disableRipple" | "disableTouchRipple" | "focusRipple" | "focusVisibleClassName" | "LinkComponent" | "onFocusVisible" | "TouchRippleProps" | "touchRippleRef" | "expandIcon"> & {
+    component?: React.ElementType | undefined;
+} & {
+    leftIcon?: React.ReactNode;
+} & {
+    overStyled: true;
+}, "ref">) & React.RefAttributes<HTMLDivElement>>;
+export type AccordionPanelWrapperProps = RecursicaOverStyled<MuiAccordionDetailsProps>;
+export declare const AccordionPanel: React.ForwardRefExoticComponent<(Omit<Omit<MuiAccordionDetailsProps, "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<MuiAccordionDetailsProps & {
+    overStyled: true;
+}, "ref">) & React.RefAttributes<HTMLDivElement>>;
+type AccordionComponent = typeof AccordionBase & {
+    Item: typeof AccordionItem;
+    Control: typeof AccordionControl;
+    Panel: typeof AccordionPanel;
+};
+export declare const Accordion: AccordionComponent;
+export {};

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

@@ -1,3 +1,10 @@
 import { default as React } from 'react';
-export type AssistiveElementProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const AssistiveElement: React.FC<AssistiveElementProps>;
+import { FormHelperTextProps } from '@mui/material';
+export interface AssistiveElementProps extends FormHelperTextProps {
+    /** Governs the semantic rendering block (changes icon and CSS structural hooks natively). */
+    assistiveVariant?: "help" | "error";
+    /** Renders the structural mapping icon inline beside the text natively. */
+    assistiveWithIcon?: boolean;
+    overStyled?: boolean;
+}
+export declare const AssistiveElement: React.ForwardRefExoticComponent<Omit<AssistiveElementProps, "ref"> & React.RefAttributes<HTMLParagraphElement>>;

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

@@ -0,0 +1,17 @@
+import { default as React } from 'react';
+import { AutocompleteProps as MuiAutocompleteProps, InputWrapperProps } from '@mui/material';
+import { ReadOnlyControlProps } from '@recursica/adapter-common';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+import { RecursicaFormControlWrapperProps } from '../FormControlWrapper/FormControlWrapper';
+export interface RecursicaAutocompleteProps extends Omit<MuiAutocompleteProps<any, any, any, any>, "size" | "variant" | "radius" | "wrapperProps" | "renderInput">, Pick<InputWrapperProps, "label" | "error" | "required" | "withAsterisk" | "id">, Omit<RecursicaFormControlWrapperProps, "controlMaxWidth" | "controlMinWidth">, ReadOnlyControlProps {
+    data?: any[];
+    leftSection?: React.ReactNode;
+    rightSection?: React.ReactNode;
+    placeholder?: string;
+}
+export type AutocompleteProps = RecursicaOverStyled<RecursicaAutocompleteProps>;
+export declare const Autocomplete: React.ForwardRefExoticComponent<(Omit<Omit<RecursicaAutocompleteProps, "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<RecursicaAutocompleteProps & {
+    overStyled: true;
+}, "ref">) & React.RefAttributes<HTMLInputElement>>;

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

@@ -0,0 +1 @@
+export * from './Autocomplete';

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

@@ -1,3 +1,15 @@
 import { default as React } from 'react';
-export type AvatarProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Avatar: React.FC<AvatarProps>;
+import { AvatarProps as MuiAvatarProps } from '@mui/material';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+export interface RecursicaAvatarProps {
+    size?: "small" | "default" | "large";
+    variant?: "solid" | "outline" | "ghost";
+    icon?: React.ReactNode;
+}
+export type AvatarProps = RecursicaOverStyled<Omit<MuiAvatarProps, "variant" | "size" | "color" | "radius"> & RecursicaAvatarProps>;
+/**
+ * Recursica Avatar component wrapping Mui's Avatar.
+ *
+ * Supports polymorphism via the `component` prop or `renderRoot` for custom element rendering.
+ */
+export declare const Avatar: any;

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

@@ -1,3 +1,13 @@
-import { default as React } from 'react';
-export type BadgeProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Badge: React.FC<BadgeProps>;
+import { BadgeProps as MuiBadgeProps } from '@mui/material';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+export interface RecursicaBadgeProps {
+    /** Map to the component styles defined in variables */
+    variant?: "alert" | "primary-color" | "success" | "warning";
+}
+export type BadgeProps = RecursicaOverStyled<Omit<MuiBadgeProps, "variant" | "size" | "color" | "radius"> & RecursicaBadgeProps>;
+/**
+ * Recursica Badge component wrapping Mui's Badge.
+ *
+ * Supports polymorphism via the `component` prop or `renderRoot` for custom element rendering.
+ */
+export declare const Badge: any;

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

@@ -1,3 +1,10 @@
-import { default as React } from 'react';
-export type BreadcrumbProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Breadcrumb: React.FC<BreadcrumbProps>;
+import { BreadcrumbsProps as MuiBreadcrumbsProps } from '@mui/material';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+export interface RecursicaBreadcrumbProps {
+}
+export type BreadcrumbProps = RecursicaOverStyled<Omit<MuiBreadcrumbsProps, "variant" | "size"> & RecursicaBreadcrumbProps>;
+export declare const Breadcrumb: import('react').ForwardRefExoticComponent<(Omit<Omit<Omit<MuiBreadcrumbsProps, "variant" | "size"> & RecursicaBreadcrumbProps, "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<MuiBreadcrumbsProps, "variant" | "size"> & RecursicaBreadcrumbProps & {
+    overStyled: true;
+}, "ref">) & import('react').RefAttributes<HTMLDivElement>>;

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

@@ -34,7 +34,7 @@ export type ButtonProps = RecursicaOverStyled<Omit<MuiButtonProps, "variant" | "
  * <Button component={Link} to="/home">Home</Button>
  * ```
  */
-export declare const Button: React.ForwardRefExoticComponent<(Omit<Omit<Omit<MuiButtonProps, "color" | "variant" | "size" | "fullWidth"> & RecursicaButtonProps, "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 Button: React.ForwardRefExoticComponent<(Omit<Omit<Omit<MuiButtonProps, "color" | "variant" | "size" | "fullWidth"> & RecursicaButtonProps, "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<MuiButtonProps, "color" | "variant" | "size" | "fullWidth"> & RecursicaButtonProps & {
     overStyled: true;

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

@@ -1,3 +1,40 @@
-import { default as React } from 'react';
-export type CardProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Card: React.FC<CardProps>;
+import { CardProps as MuiCardProps } from '@mui/material';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+export type CardProps = RecursicaOverStyled<MuiCardProps>;
+export type RecursicaCardSectionProps = React.HTMLAttributes<HTMLDivElement> & {
+    children?: React.ReactNode;
+};
+export type CardSectionProps = RecursicaOverStyled<RecursicaCardSectionProps>;
+/**
+ * A generalized edge-to-edge structural wrapper native to Mui. Strips typical boundary padding via negative margins to allow content (like maps or header images) to touch the border seamlessly.
+ */
+export declare const CardSection: import('react').ForwardRefExoticComponent<CardSectionProps & import('react').RefAttributes<HTMLDivElement>>;
+export type CardHeaderProps = RecursicaOverStyled<RecursicaCardSectionProps>;
+/**
+ * Replaces standard generic Mui `<Card.Section>` wrappers by directly injecting the strict Recursica design tokens for header sizing, background drops, and intrinsic padding limits.
+ */
+export declare const CardHeader: import('react').ForwardRefExoticComponent<CardHeaderProps & import('react').RefAttributes<HTMLDivElement>>;
+export type CardFooterProps = RecursicaOverStyled<RecursicaCardSectionProps>;
+/**
+ * Counterpart to `Card.Header`, applying specific footer elevation margins, sizes, and padding natively.
+ */
+export declare const CardFooter: import('react').ForwardRefExoticComponent<CardFooterProps & import('react').RefAttributes<HTMLDivElement>>;
+export type CardContentProps = RecursicaOverStyled<React.HTMLAttributes<HTMLDivElement>>;
+/**
+ * Internal container that safely binds typography and structural flex gaps driven by the active UI kit tokens natively, preserving correct padding blocks compared to rigid `Card.Section` edges.
+ */
+export declare const CardContent: import('react').ForwardRefExoticComponent<CardContentProps & import('react').RefAttributes<HTMLDivElement>>;
+/**
+ * Recursica Card component wrapping Mui's Card (Paper).
+ *
+ * Supports polymorphism via the `component` prop or `renderRoot` for custom element rendering.
+ * Use dot-notation sub-components for structured card layouts.
+ */
+declare const PolymorphicCard: any;
+export declare const Card: typeof PolymorphicCard & {
+    Section: typeof CardSection;
+    Header: typeof CardHeader;
+    Footer: typeof CardFooter;
+    Content: typeof CardContent;
+};
+export {};

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

@@ -1,3 +1,16 @@
 import { default as React } from 'react';
-export type CheckboxProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Checkbox: React.FC<CheckboxProps>;
+import { CheckboxProps as MuiCheckboxProps } from '@mui/material';
+import { ReadOnlyControlProps } from '@recursica/adapter-common';
+import { CheckboxGroup } from './CheckboxGroup';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+import { RequireAccessibleLabel } from '../../utils/RequireAccessibleLabel';
+import { FormControlLayoutProps } from '../FormControlLayout/FormControlLayout';
+export type RecursicaCheckboxProps = RequireAccessibleLabel<Omit<MuiCheckboxProps, "size" | "color"> & {
+    label?: React.ReactNode;
+} & ReadOnlyControlProps & Pick<FormControlLayoutProps, "formLayout" | "labelSize" | "controlMaxWidth" | "controlMinWidth">>;
+export type CheckboxProps = RecursicaOverStyled<RecursicaCheckboxProps>;
+type CheckboxComponent = React.ForwardRefExoticComponent<CheckboxProps & React.RefAttributes<HTMLButtonElement>> & {
+    Group: typeof CheckboxGroup;
+};
+export declare const Checkbox: CheckboxComponent;
+export {};

package/dist/src/components/Checkbox/CheckboxGroup.d.ts

@@ -0,0 +1,16 @@
+import { default as React } from 'react';
+import { FormGroupProps } from '@mui/material';
+import { ReadOnlyControlProps } from '@recursica/adapter-common';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+import { RecursicaFormControlWrapperProps } from '../FormControlWrapper/FormControlWrapper';
+export interface RecursicaCheckboxGroupProps extends Omit<FormGroupProps, "size" | "onChange">, Omit<RecursicaFormControlWrapperProps, "controlMaxWidth" | "controlMinWidth">, ReadOnlyControlProps {
+    value?: any[];
+    defaultValue?: any[];
+    onChange?: (value: any[]) => void;
+}
+export type CheckboxGroupProps = RecursicaOverStyled<RecursicaCheckboxGroupProps>;
+export declare const CheckboxGroup: React.ForwardRefExoticComponent<(Omit<Omit<RecursicaCheckboxGroupProps, "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<RecursicaCheckboxGroupProps & {
+    overStyled: true;
+}, "ref">) & React.RefAttributes<HTMLDivElement>>;

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

@@ -1 +1,5 @@
-export * from './Checkbox';
+import { CheckboxGroup } from './CheckboxGroup';
+export { Checkbox } from './Checkbox';
+export type { CheckboxProps } from './Checkbox';
+export { CheckboxGroup };
+export type { CheckboxGroupProps } from './CheckboxGroup';

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

@@ -1,3 +1,19 @@
 import { default as React } from 'react';
-export type ChipProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Chip: React.FC<ChipProps>;
+import { ChipProps as MuiChipProps } from '@mui/material';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+export interface RecursicaChipProps {
+    /** Enables the error state styling */
+    error?: boolean;
+    /** Leading icon content */
+    icon?: React.ReactNode;
+    /** Called when the remove (X) icon is clicked. If provided, the remove icon will be displayed. */
+    onRemove?: (e: React.MouseEvent<HTMLSpanElement, MouseEvent>) => void;
+    /** Screen reader label for the remove button. Defaults to 'Remove' */
+    removeLabel?: string;
+}
+export type ChipProps = RecursicaOverStyled<Omit<MuiChipProps, "variant" | "size" | "color" | "radius"> & RecursicaChipProps>;
+export declare const Chip: React.ForwardRefExoticComponent<(Omit<Omit<Omit<MuiChipProps, "color" | "variant" | "size" | "radius"> & RecursicaChipProps, "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<MuiChipProps, "color" | "variant" | "size" | "radius"> & RecursicaChipProps & {
+    overStyled: true;
+}, "ref">) & React.RefAttributes<HTMLInputElement>>;

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

@@ -1,3 +1,23 @@
-import { default as React } from 'react';
-export type DropdownProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Dropdown: React.FC<DropdownProps>;
+import { default as React, ReactNode } from 'react';
+import { SelectProps as MuiSelectProps } from '@mui/material';
+import { ReadOnlyControlProps } from '@recursica/adapter-common';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+import { RecursicaFormControlWrapperProps } from '../FormControlWrapper/FormControlWrapper';
+export interface RecursicaDropdownProps extends Omit<MuiSelectProps, "size" | "variant" | "classes" | "inputProps" | "SelectDisplayProps">, Pick<RecursicaFormControlWrapperProps, "assistiveText" | "assistiveWithIcon" | "formLayout" | "labelSize" | "labelAlignment" | "labelOptionalText" | "labelWithEditIcon" | "onLabelEditClick">, ReadOnlyControlProps {
+    /** Internal hook for Selects to override raw layout width properties when necessary */
+    containerWidth?: React.CSSProperties["width"];
+    data?: (string | {
+        value: string;
+        label: ReactNode;
+        disabled?: boolean;
+    })[];
+    searchable?: boolean;
+    clearable?: boolean;
+    withAsterisk?: boolean;
+}
+export type DropdownProps = RecursicaOverStyled<RecursicaDropdownProps>;
+export declare const Dropdown: React.ForwardRefExoticComponent<(Omit<Omit<RecursicaDropdownProps, "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<RecursicaDropdownProps & {
+    overStyled: true;
+}, "ref">) & React.RefAttributes<HTMLInputElement>>;

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

@@ -1,3 +1,11 @@
 import { default as React } from 'react';
-export type FormControlLayoutProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const FormControlLayout: React.FC<FormControlLayoutProps>;
+export interface FormControlLayoutProps extends React.HTMLAttributes<HTMLDivElement> {
+    overStyled?: boolean;
+    formLayout?: "stacked" | "side-by-side";
+    labelSize?: "small" | "default" | "md";
+    controlMaxWidth?: string;
+    controlMinWidth?: string;
+    leftSection?: React.ReactNode;
+    children: React.ReactNode;
+}
+export declare const FormControlLayout: React.ForwardRefExoticComponent<FormControlLayoutProps & React.RefAttributes<HTMLDivElement>>;

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

@@ -1,3 +1,25 @@
 import { default as React } from 'react';
-export type FormControlWrapperProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const FormControlWrapper: React.FC<FormControlWrapperProps>;
+import { FormControlProps } from '@mui/material';
+export interface RecursicaFormControlWrapperProps extends Omit<FormControlProps, "margin" | "variant" | "size" | "color"> {
+    overStyled?: boolean;
+    label?: React.ReactNode;
+    /** Primary assistive description bound natively to the component footer. Maps to MUI's 'helperText' dynamically. */
+    assistiveText?: React.ReactNode;
+    /** Secondary parameter fallback identical to assistiveText to match MUI / Mantine native APIs safely. */
+    description?: React.ReactNode;
+    /** Fallback mapping for MUI's native helperText */
+    helperText?: React.ReactNode;
+    assistiveWithIcon?: boolean;
+    formLayout?: "stacked" | "side-by-side";
+    labelSize?: "small" | "default" | "md";
+    labelAlignment?: "left" | "right";
+    labelOptionalText?: React.ReactNode | true;
+    labelWithEditIcon?: boolean;
+    onLabelEditClick?: (e: React.MouseEvent<HTMLButtonElement>) => void;
+    labelActionArea?: React.ReactNode;
+    /** Allows layout mapping to limit the input's bounding box without impacting the label */
+    controlMaxWidth?: string;
+    controlMinWidth?: string;
+}
+export type FormControlWrapperProps = RecursicaFormControlWrapperProps;
+export declare const FormControlWrapper: React.ForwardRefExoticComponent<Omit<RecursicaFormControlWrapperProps, "ref"> & React.RefAttributes<HTMLDivElement>>;

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

@@ -1,3 +1,55 @@
-import { default as React } from 'react';
-export type HoverCardProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const HoverCard: React.FC<HoverCardProps>;
+import { PopoverProps as MuiHoverCardProps } from '@mui/material';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+/**
+ * Recursica-specific props for HoverCard.
+ */
+export interface RecursicaHoverCardProps {
+    /**
+     * Whether to display a beak (arrow) pointing from the dropdown to the target.
+     * This is the Recursica equivalent of Mui's `withArrow`.
+     * When both `withBeak` and `withArrow` are provided, `withBeak` takes precedence.
+     */
+    withBeak?: boolean;
+}
+/**
+ * Recursica HoverCard component wrapping Mui's composable HoverCard.
+ *
+ * Displays a dropdown panel when the user hovers over a target element.
+ * Uses the composable dot-notation pattern:
+ * ```tsx
+ * <HoverCard withBeak>
+ *   <HoverCard.Target>
+ *     <Button>Hover me</Button>
+ *   </HoverCard.Target>
+ *   <HoverCard.Dropdown>
+ *     Content displayed on hover
+ *   </HoverCard.Dropdown>
+ * </HoverCard>
+ * ```
+ */
+export type HoverCardProps = RecursicaOverStyled<MuiHoverCardProps & RecursicaHoverCardProps>;
+declare const HoverCardBase: {
+    ({ overStyled, withBeak, ...rest }: HoverCardProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/**
+ * Wrapper for the element that triggers the hover card.
+ * Requires a single child element that supports ref forwarding.
+ */
+export type HoverCardTargetProps = any;
+declare const HoverCardTarget: {
+    (props: HoverCardTargetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/** The dropdown panel displayed when hovering over the target. */
+export type HoverCardDropdownProps = RecursicaOverStyled<any>;
+declare const HoverCardDropdown: {
+    ({ overStyled, ...rest }: HoverCardDropdownProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+type HoverCardComponent = typeof HoverCardBase & {
+    Target: typeof HoverCardTarget;
+    Dropdown: typeof HoverCardDropdown;
+};
+export declare const HoverCard: HoverCardComponent;
+export {};

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

@@ -1,3 +1,14 @@
 import { default as React } from 'react';
-export type LabelProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Label: React.FC<LabelProps>;
+import { InputLabelProps } from '@mui/material';
+export interface LabelProps extends InputLabelProps {
+    overStyled?: boolean;
+    /** Explicit optional text to render safely mapping alongside the label. Hidden natively if 'required' is flagged true. */
+    labelOptionalText?: React.ReactNode | true;
+    /** Triggers the inline edit action icon native layout hook beside the label element. */
+    labelWithEditIcon?: boolean;
+    /** Fires specifically on icon click natively. */
+    onLabelEditClick?: (e: React.MouseEvent<HTMLButtonElement>) => void;
+    /** Replaces the right side optional text block natively with any custom React node (e.g. actions, toggles). */
+    labelActionArea?: React.ReactNode;
+}
+export declare const Label: React.ForwardRefExoticComponent<Omit<LabelProps, "ref"> & React.RefAttributes<HTMLLabelElement>>;

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

@@ -7,7 +7,7 @@ export interface RecursicaLinkProps {
     component?: React.ElementType;
 }
 export type LinkProps = RecursicaOverStyled<Omit<MUILinkProps, "underline"> & RecursicaLinkProps>;
-export declare const Link: React.ForwardRefExoticComponent<(Omit<Omit<Omit<MUILinkProps, "underline"> & RecursicaLinkProps, "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 Link: React.ForwardRefExoticComponent<(Omit<Omit<Omit<MUILinkProps, "underline"> & RecursicaLinkProps, "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<MUILinkProps, "underline"> & RecursicaLinkProps & {
     overStyled: true;

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

@@ -1,3 +1,99 @@
-import { default as React } from 'react';
-export type MenuProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Menu: React.FC<MenuProps>;
+import { MenuProps as MuiMenuProps } from '@mui/material';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+/**
+ * Recursica Menu component wrapping Mui's composable Menu.
+ *
+ * Usage follows the composable dot-notation pattern:
+ * ```tsx
+ * <Menu>
+ *   <Menu.Target><Button>Open</Button></Menu.Target>
+ *   <Menu.Dropdown>
+ *     <Menu.Label>Section</Menu.Label>
+ *     <Menu.Item>Action</Menu.Item>
+ *     <Menu.Divider />
+ *     <Menu.Item>Another action</Menu.Item>
+ *   </Menu.Dropdown>
+ * </Menu>
+ * ```
+ */
+export type MenuProps = RecursicaOverStyled<MuiMenuProps>;
+declare const MenuBase: {
+    ({ overStyled, ...rest }: MenuProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/**
+ * Wrapper for the element that triggers the menu.
+ * Requires a single child element that supports ref forwarding.
+ */
+export type MenuTargetProps = any;
+declare const MenuTarget: {
+    (props: MenuTargetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/** The dropdown panel containing menu items, dividers, and labels. */
+export type MenuDropdownProps = RecursicaOverStyled<any>;
+declare const MenuDropdown: import('react').ForwardRefExoticComponent<Omit<any, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+/**
+ * An individual actionable item within the menu dropdown.
+ *
+ * **Note:** Mui's `color` prop is stripped in strict mode to enforce
+ * design token adherence. Use `overStyled={true}` if you need to bypass.
+ */
+export type MenuItemProps = RecursicaOverStyled<Omit<any, "color">>;
+/**
+ * An individual actionable item within the menu dropdown.
+ *
+ * Supports polymorphism via the `component` prop for link-style items.
+ * @example
+ * ```tsx
+ * <Menu.Item component="a" href="/settings">Settings</Menu.Item>
+ * ```
+ */
+declare const MenuItem: any;
+/** A visual separator between groups of menu items. */
+export type MenuDividerProps = RecursicaOverStyled<any>;
+declare const MenuDivider: import('react').ForwardRefExoticComponent<Omit<any, "ref"> & import('react').RefAttributes<HTMLHRElement>>;
+/** A non-interactive section label used to categorize groups of menu items. */
+export type MenuLabelProps = RecursicaOverStyled<any>;
+declare const MenuLabel: import('react').ForwardRefExoticComponent<Omit<any, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+/** Container for a submenu, wrapping Menu.Sub.Target and Menu.Sub.Dropdown. */
+export type MenuSubProps = any;
+declare const MenuSubBase: {
+    (props: MenuSubProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/** Wrapper for the element that triggers the submenu. */
+export type MenuSubTargetProps = any;
+declare const MenuSubTarget: {
+    (props: MenuSubTargetProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+/**
+ * A menu item that acts as a submenu trigger.
+ * Renders within Menu.Sub.Target and displays a chevron indicator.
+ */
+export type MenuSubItemProps = RecursicaOverStyled<Omit<any, "color">>;
+/**
+ * A menu item that acts as a submenu trigger.
+ *
+ * Supports polymorphism via the `component` prop.
+ */
+declare const MenuSubItem: any;
+/** The dropdown panel for a submenu. */
+export type MenuSubDropdownProps = RecursicaOverStyled<any>;
+declare const MenuSubDropdown: import('react').ForwardRefExoticComponent<Omit<any, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
+type MenuSubComponent = typeof MenuSubBase & {
+    Target: typeof MenuSubTarget;
+    Item: typeof MenuSubItem;
+    Dropdown: typeof MenuSubDropdown;
+};
+type MenuComponent = typeof MenuBase & {
+    Target: typeof MenuTarget;
+    Dropdown: typeof MenuDropdown;
+    Item: typeof MenuItem;
+    Divider: typeof MenuDivider;
+    Label: typeof MenuLabel;
+    Sub: MenuSubComponent;
+};
+export declare const Menu: MenuComponent;
+export {};

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

@@ -1,3 +1,37 @@
 import { default as React } from 'react';
-export type ModalProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Modal: React.FC<ModalProps>;
+import { Modal as MuiModal, ModalProps as MuiModalProps } from '@mui/material';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+/**
+ * Properties for the strictly-tokenized Modal component.
+ * Native Mui abstract properties like `size`, `radius`, and `shadow` have been stripped out
+ * because they directly conflict with the non-negotiable pixel boundaries defined in the Recursica UI Kit.
+ */
+export type ModalProps = RecursicaOverStyled<Omit<MuiModalProps, "size" | "radius" | "shadow">>;
+/**
+ * The `Modal.Footer` provides a perfectly padded container for modal actions.
+ *
+ * **Recursica Abstract:**
+ * By default, this container aligns its children to the right (`justify-content: flex-end`)
+ * and applies the standard Figma button-gap spacing.
+ *
+ * > [!IMPORTANT]
+ * > **Button Hierarchy:** Recursica design language explicitly requires that the
+ * > primary action button MUST be the right-most element, with the secondary
+ * > (outline variant) action placed immediately to the left of it.
+ */
+declare const ModalFooter: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
+declare const ModalBody: React.ForwardRefExoticComponent<any>;
+interface ModalComponent extends React.ForwardRefExoticComponent<ModalProps & React.RefAttributes<HTMLDivElement>> {
+    Root: typeof MuiModal.Root;
+    Overlay: typeof MuiModal.Overlay;
+    Content: typeof MuiModal.Content;
+    Header: typeof MuiModal.Header;
+    Title: typeof MuiModal.Title;
+    CloseButton: typeof MuiModal.CloseButton;
+    Body: typeof ModalBody;
+    Footer: typeof ModalFooter;
+}
+export declare const Modal: ModalComponent & {
+    Footer: typeof ModalFooter;
+};
+export {};

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

@@ -1,3 +1,15 @@
 import { default as React } from 'react';
-export type NumberInputProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const NumberInput: React.FC<NumberInputProps>;
+import { TextFieldProps as MuiNumberInputProps } from '@mui/material';
+import { ReadOnlyControlProps } from '@recursica/adapter-common';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+import { RecursicaFormControlWrapperProps } from '../FormControlWrapper/FormControlWrapper';
+export interface RecursicaNumberInputProps extends Omit<MuiNumberInputProps, "size" | "variant" | "radius" | "wrapperProps" | "classNames" | "styles">, Pick<RecursicaFormControlWrapperProps, "assistiveText" | "assistiveWithIcon" | "formLayout" | "labelSize" | "labelAlignment" | "labelOptionalText" | "labelWithEditIcon" | "onLabelEditClick">, ReadOnlyControlProps {
+    /** Enables/disables the controls to increment and decrement the value */
+    hideControls?: boolean;
+}
+export type NumberInputProps = RecursicaOverStyled<RecursicaNumberInputProps>;
+export declare const NumberInput: React.ForwardRefExoticComponent<(Omit<Omit<RecursicaNumberInputProps, "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<RecursicaNumberInputProps & {
+    overStyled: true;
+}, "ref">) & React.RefAttributes<HTMLInputElement>>;