@recursica/mantine-adapter 0.23.0 → 0.26.0

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

@@ -2,10 +2,8 @@ import { default as React } from 'react';
 import { Pagination as MantinePagination, PaginationProps as MantinePaginationProps, PaginationRootProps as MantinePaginationRootProps } from '@mantine/core';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
 import { PaginationIcon } from './Pagination.icons';
-export type PaginationProps = RecursicaOverStyled<MantinePaginationProps> & {
-    /** If set to true, displays text labels alongside the icons for next/previous/first/last edges. */
-    withLabels?: boolean;
-};
+import { RecursicaPaginationProps } from '@recursica/adapter-common';
+export type PaginationProps = RecursicaOverStyled<MantinePaginationProps & RecursicaPaginationProps>;
 export type PaginationRootProps = RecursicaOverStyled<MantinePaginationRootProps>;
 export type PaginationEdgeProps<T extends React.ElementType> = React.ComponentProps<T> & {
     /** If set to true, displays text labels alongside the icon. */

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

@@ -1,13 +1,6 @@
-import { Drawer as MantineDrawer, DrawerProps as MantineDrawerProps } from '@mantine/core';
+import { Drawer as MantineDrawer } from '@mantine/core';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
-export interface RecursicaPanelProps extends MantineDrawerProps {
-    /**
-     * 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;
-}
+import { RecursicaPanelProps } from '@recursica/adapter-common';
 /**
  * Recursica Panel root props. Extends Mantine Drawer.
  */

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

@@ -1,16 +1,6 @@
 import { PopoverProps as MantinePopoverProps, PopoverTargetProps as MantinePopoverTargetProps, PopoverDropdownProps as MantinePopoverDropdownProps } from '@mantine/core';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
-/**
- * Recursica-specific props for Popover.
- */
-export interface RecursicaPopoverProps {
-    /**
-     * Whether to display a beak (arrow) pointing from the dropdown to the target.
-     * This is the Recursica equivalent of Mantine's `withArrow`.
-     * When both `withBeak` and `withArrow` are provided, `withBeak` takes precedence.
-     */
-    withBeak?: boolean;
-}
+import { RecursicaPopoverProps } from '@recursica/adapter-common';
 /**
  * Recursica Popover component wrapping Mantine's composable Popover.
  *

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

@@ -1,11 +1,11 @@
 import { RadioProps as MantineRadioProps } from '@mantine/core';
-import { ReadOnlyControlProps } from '@recursica/adapter-common';
+import { ReadOnlyControlProps, RequireAccessibleLabel, RecursicaRadioProps } 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<MantineRadioProps, "size" | "color" | "radius" | "iconColor" | "variant"> & ReadOnlyControlProps & Pick<FormControlLayoutProps, "formLayout" | "labelSize" | "controlMaxWidth" | "controlMinWidth">>;
-export type RadioProps = RecursicaOverStyled<RecursicaRadioProps>;
+export type RadioWrapperProps = Omit<MantineRadioProps, "size" | "color" | "radius" | "iconColor" | "variant"> & 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;
 };

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

@@ -1,9 +1,13 @@
 import { default as React } from 'react';
 import { RadioGroupProps as MantineRadioGroupProps } from '@mantine/core';
-import { ReadOnlyControlProps } from '@recursica/adapter-common';
+import { ReadOnlyControlProps, RecursicaRadioGroupProps as BaseRecursicaRadioGroupProps } from '@recursica/adapter-common';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
 import { RecursicaFormControlWrapperProps } from '../FormControlWrapper/FormControlWrapper';
-export interface RecursicaRadioGroupProps extends Omit<MantineRadioGroupProps, "size" | "labelProps">, Omit<RecursicaFormControlWrapperProps, "controlMaxWidth" | "controlMinWidth">, ReadOnlyControlProps {
+export interface RecursicaRadioGroupProps extends Omit<MantineRadioGroupProps, "size" | "labelProps">, Omit<RecursicaFormControlWrapperProps, "controlMaxWidth" | "controlMinWidth">, ReadOnlyControlProps, BaseRecursicaRadioGroupProps {
 }
 export type RadioGroupProps = RecursicaOverStyled<RecursicaRadioGroupProps>;
-export declare const RadioGroup: React.ForwardRefExoticComponent<RadioGroupProps & React.RefAttributes<HTMLDivElement>>;
+export declare const RadioGroup: React.ForwardRefExoticComponent<(Omit<Omit<RecursicaRadioGroupProps, import('@recursica/adapter-common').BlockedStylingKeys> & import('@recursica/adapter-common').ForbiddenStyles & {
+    overStyled?: false | undefined;
+}, "ref"> | Omit<RecursicaRadioGroupProps & {
+    overStyled: true;
+}, "ref">) & React.RefAttributes<HTMLDivElement>>;

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

@@ -1,16 +1,8 @@
 import { default as React } from 'react';
-import { ReadOnlyFieldType, ReadOnlyControlProps } from '@recursica/adapter-common';
+import { ReadOnlyControlProps, RecursicaReadOnlyFieldProps as BaseRecursicaReadOnlyFieldProps } from '@recursica/adapter-common';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
 import { FormControlWrapperProps } from '../FormControlWrapper/FormControlWrapper';
-export interface RecursicaReadOnlyFieldProps extends Omit<FormControlWrapperProps, "children" | "overStyled" | "controlMaxWidth" | "controlMinWidth">, Pick<ReadOnlyControlProps, "emptyValueComponent"> {
-    /** The specific value to be rendered in read-only mode explicitly matching the original field input */
-    value?: any;
-    /** The data type formatting rules bounding how the string is presented to the user */
-    type?: ReadOnlyFieldType;
-    /** Pass the native maximum width design variable dynamically bounding the specific wrapper width exclusively. */
-    controlMaxWidth?: string | undefined;
-    /** Pass the native minimum width design variable dynamically bounding the specific wrapper width exclusively. */
-    controlMinWidth?: string | undefined;
+export interface RecursicaReadOnlyFieldProps extends Omit<FormControlWrapperProps, "children" | "overStyled" | "controlMaxWidth" | "controlMinWidth">, Pick<ReadOnlyControlProps, "emptyValueComponent">, BaseRecursicaReadOnlyFieldProps {
 }
 export type ReadOnlyFieldProps = RecursicaOverStyled<RecursicaReadOnlyFieldProps>;
 /**

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

@@ -1,16 +1,6 @@
 import { SegmentedControlProps as MantineSegmentedControlProps } from '@mantine/core';
 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;
-}
+import { RecursicaSegmentedControlProps } from '@recursica/adapter-common';
 export type SegmentedControlProps = RecursicaOverStyled<Omit<MantineSegmentedControlProps, "variant" | "size" | "radius" | "color" | "classNames" | "className" | "disabled"> & {
     className?: string;
     classNames?: Partial<Record<string, string>>;

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

@@ -1,19 +1,9 @@
 import { default as React } from 'react';
 import { SliderProps as MantineSliderProps, InputWrapperProps } from '@mantine/core';
-import { ReadOnlyControlProps } from '@recursica/adapter-common';
+import { ReadOnlyControlProps, RecursicaSliderProps as BaseRecursicaSliderProps } from '@recursica/adapter-common';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
 import { RecursicaFormControlWrapperProps } from '../FormControlWrapper/FormControlWrapper';
-export interface RecursicaSliderProps extends Omit<MantineSliderProps, "size" | "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 Mantine's `label`. */
-    tooltipLabel?: MantineSliderProps["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 interface RecursicaSliderProps extends Omit<MantineSliderProps, "size" | "variant" | "radius" | "wrapperProps" | "classNames" | "styles" | "label">, Omit<RecursicaFormControlWrapperProps, "controlMaxWidth" | "controlMinWidth">, Pick<InputWrapperProps, "error" | "required" | "withAsterisk">, ReadOnlyControlProps, BaseRecursicaSliderProps {
 }
 export type SliderProps = RecursicaOverStyled<RecursicaSliderProps>;
 /**
@@ -22,4 +12,8 @@ export type SliderProps = RecursicaOverStyled<RecursicaSliderProps>;
  * 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<SliderProps & React.RefAttributes<HTMLDivElement>>;
+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,12 +1,5 @@
 import { StackProps as MantineStackProps } from '@mantine/core';
-import { RecursicaSpacing } from '../../utils/filterStylingProps';
-export interface RecursicaStackProps {
-    /**
-     * Children components inside the stack
-     */
-    children?: React.ReactNode;
-    gap?: MantineStackProps["gap"] | RecursicaSpacing;
-}
+import { RecursicaStackProps } from '@recursica/adapter-common';
 /**
  * Stack flex layout wrapper.
  *
@@ -17,7 +10,7 @@ export interface RecursicaStackProps {
 export type StackProps = MantineStackProps & RecursicaStackProps;
 export declare const Stack: (<C = "div">(props: import('@mantine/core').PolymorphicComponentProps<C, StackProps>) => React.ReactElement) & Omit<import('react').FunctionComponent<(MantineStackProps & RecursicaStackProps & {
     component?: any;
-} & Omit<Omit<any, "ref">, "className" | "classNames" | "style" | "styles" | "vars" | "p" | "px" | "py" | "pt" | "pb" | "pl" | "pr" | "bg" | "c" | "opacity" | "ff" | "fz" | "fw" | "lts" | "ta" | "lh" | "fs" | "tt" | "td" | "bd" | "w" | "miw" | "maw" | "h" | "mih" | "mah" | "m" | "my" | "mx" | "mt" | "mb" | "ml" | "mr" | "gap" | "top" | "left" | "bottom" | "right" | "key" | "defaultValue" | "onChange" | "slot" | "title" | "defaultChecked" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "autoCapitalize" | "autoFocus" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "enterKeyHint" | "hidden" | "id" | "lang" | "nonce" | "spellCheck" | "tabIndex" | "translate" | "radioGroup" | "role" | "about" | "content" | "datatype" | "inlist" | "prefix" | "property" | "rel" | "resource" | "rev" | "typeof" | "vocab" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "popover" | "popoverTargetAction" | "popoverTarget" | "inert" | "inputMode" | "is" | "exportparts" | "part" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-braillelabel" | "aria-brailleroledescription" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colindextext" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-description" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowindextext" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "children" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerLeave" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onScrollEnd" | "onScrollEndCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onToggle" | "onBeforeToggle" | "onTransitionCancel" | "onTransitionCancelCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "onTransitionRun" | "onTransitionRunCapture" | "onTransitionStart" | "onTransitionStartCapture" | "__vars" | "__size" | "hiddenFrom" | "visibleFrom" | "lightHidden" | "darkHidden" | "mod" | "ms" | "me" | "ps" | "pe" | "bdrs" | "bgsz" | "bgp" | "bgr" | "bga" | "pos" | "inset" | "display" | "flex" | "unstyled" | "variant" | "attributes" | "justify" | "component" | "align"> & {
+} & Omit<Omit<any, "ref">, "className" | "classNames" | "style" | "styles" | "vars" | "p" | "px" | "py" | "pt" | "pb" | "pl" | "pr" | "bg" | "c" | "opacity" | "ff" | "fz" | "fw" | "lts" | "ta" | "lh" | "fs" | "tt" | "td" | "bd" | "w" | "miw" | "maw" | "h" | "mih" | "mah" | "m" | "my" | "mx" | "mt" | "mb" | "ml" | "mr" | "gap" | "top" | "left" | "bottom" | "right" | "key" | "defaultValue" | "onChange" | "variant" | "slot" | "title" | "defaultChecked" | "suppressContentEditableWarning" | "suppressHydrationWarning" | "accessKey" | "autoCapitalize" | "autoFocus" | "contentEditable" | "contextMenu" | "dir" | "draggable" | "enterKeyHint" | "hidden" | "id" | "lang" | "nonce" | "spellCheck" | "tabIndex" | "translate" | "radioGroup" | "role" | "about" | "content" | "datatype" | "inlist" | "prefix" | "property" | "rel" | "resource" | "rev" | "typeof" | "vocab" | "autoCorrect" | "autoSave" | "color" | "itemProp" | "itemScope" | "itemType" | "itemID" | "itemRef" | "results" | "security" | "unselectable" | "popover" | "popoverTargetAction" | "popoverTarget" | "inert" | "inputMode" | "is" | "exportparts" | "part" | "aria-activedescendant" | "aria-atomic" | "aria-autocomplete" | "aria-braillelabel" | "aria-brailleroledescription" | "aria-busy" | "aria-checked" | "aria-colcount" | "aria-colindex" | "aria-colindextext" | "aria-colspan" | "aria-controls" | "aria-current" | "aria-describedby" | "aria-description" | "aria-details" | "aria-disabled" | "aria-dropeffect" | "aria-errormessage" | "aria-expanded" | "aria-flowto" | "aria-grabbed" | "aria-haspopup" | "aria-hidden" | "aria-invalid" | "aria-keyshortcuts" | "aria-label" | "aria-labelledby" | "aria-level" | "aria-live" | "aria-modal" | "aria-multiline" | "aria-multiselectable" | "aria-orientation" | "aria-owns" | "aria-placeholder" | "aria-posinset" | "aria-pressed" | "aria-readonly" | "aria-relevant" | "aria-required" | "aria-roledescription" | "aria-rowcount" | "aria-rowindex" | "aria-rowindextext" | "aria-rowspan" | "aria-selected" | "aria-setsize" | "aria-sort" | "aria-valuemax" | "aria-valuemin" | "aria-valuenow" | "aria-valuetext" | "children" | "dangerouslySetInnerHTML" | "onCopy" | "onCopyCapture" | "onCut" | "onCutCapture" | "onPaste" | "onPasteCapture" | "onCompositionEnd" | "onCompositionEndCapture" | "onCompositionStart" | "onCompositionStartCapture" | "onCompositionUpdate" | "onCompositionUpdateCapture" | "onFocus" | "onFocusCapture" | "onBlur" | "onBlurCapture" | "onChangeCapture" | "onBeforeInput" | "onBeforeInputCapture" | "onInput" | "onInputCapture" | "onReset" | "onResetCapture" | "onSubmit" | "onSubmitCapture" | "onInvalid" | "onInvalidCapture" | "onLoad" | "onLoadCapture" | "onError" | "onErrorCapture" | "onKeyDown" | "onKeyDownCapture" | "onKeyPress" | "onKeyPressCapture" | "onKeyUp" | "onKeyUpCapture" | "onAbort" | "onAbortCapture" | "onCanPlay" | "onCanPlayCapture" | "onCanPlayThrough" | "onCanPlayThroughCapture" | "onDurationChange" | "onDurationChangeCapture" | "onEmptied" | "onEmptiedCapture" | "onEncrypted" | "onEncryptedCapture" | "onEnded" | "onEndedCapture" | "onLoadedData" | "onLoadedDataCapture" | "onLoadedMetadata" | "onLoadedMetadataCapture" | "onLoadStart" | "onLoadStartCapture" | "onPause" | "onPauseCapture" | "onPlay" | "onPlayCapture" | "onPlaying" | "onPlayingCapture" | "onProgress" | "onProgressCapture" | "onRateChange" | "onRateChangeCapture" | "onSeeked" | "onSeekedCapture" | "onSeeking" | "onSeekingCapture" | "onStalled" | "onStalledCapture" | "onSuspend" | "onSuspendCapture" | "onTimeUpdate" | "onTimeUpdateCapture" | "onVolumeChange" | "onVolumeChangeCapture" | "onWaiting" | "onWaitingCapture" | "onAuxClick" | "onAuxClickCapture" | "onClick" | "onClickCapture" | "onContextMenu" | "onContextMenuCapture" | "onDoubleClick" | "onDoubleClickCapture" | "onDrag" | "onDragCapture" | "onDragEnd" | "onDragEndCapture" | "onDragEnter" | "onDragEnterCapture" | "onDragExit" | "onDragExitCapture" | "onDragLeave" | "onDragLeaveCapture" | "onDragOver" | "onDragOverCapture" | "onDragStart" | "onDragStartCapture" | "onDrop" | "onDropCapture" | "onMouseDown" | "onMouseDownCapture" | "onMouseEnter" | "onMouseLeave" | "onMouseMove" | "onMouseMoveCapture" | "onMouseOut" | "onMouseOutCapture" | "onMouseOver" | "onMouseOverCapture" | "onMouseUp" | "onMouseUpCapture" | "onSelect" | "onSelectCapture" | "onTouchCancel" | "onTouchCancelCapture" | "onTouchEnd" | "onTouchEndCapture" | "onTouchMove" | "onTouchMoveCapture" | "onTouchStart" | "onTouchStartCapture" | "onPointerDown" | "onPointerDownCapture" | "onPointerMove" | "onPointerMoveCapture" | "onPointerUp" | "onPointerUpCapture" | "onPointerCancel" | "onPointerCancelCapture" | "onPointerEnter" | "onPointerLeave" | "onPointerOver" | "onPointerOverCapture" | "onPointerOut" | "onPointerOutCapture" | "onGotPointerCapture" | "onGotPointerCaptureCapture" | "onLostPointerCapture" | "onLostPointerCaptureCapture" | "onScroll" | "onScrollCapture" | "onScrollEnd" | "onScrollEndCapture" | "onWheel" | "onWheelCapture" | "onAnimationStart" | "onAnimationStartCapture" | "onAnimationEnd" | "onAnimationEndCapture" | "onAnimationIteration" | "onAnimationIterationCapture" | "onToggle" | "onBeforeToggle" | "onTransitionCancel" | "onTransitionCancelCapture" | "onTransitionEnd" | "onTransitionEndCapture" | "onTransitionRun" | "onTransitionRunCapture" | "onTransitionStart" | "onTransitionStartCapture" | "__vars" | "__size" | "hiddenFrom" | "visibleFrom" | "lightHidden" | "darkHidden" | "mod" | "ms" | "me" | "ps" | "pe" | "bdrs" | "bgsz" | "bgp" | "bgr" | "bga" | "pos" | "inset" | "display" | "flex" | "unstyled" | "attributes" | "justify" | "component" | "align"> & {
     ref?: any;
     renderRoot?: (props: any) => any;
 }) | (MantineStackProps & RecursicaStackProps & {

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

@@ -1,9 +1,7 @@
 import { default as React } from 'react';
-import { Stepper as MantineStepper, StepperProps as MantineStepperProps } from '@mantine/core';
+import { Stepper as MantineStepper } from '@mantine/core';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
-export interface RecursicaStepperProps extends Omit<MantineStepperProps, "size" | "color" | "radius" | "iconSize" | "contentPadding"> {
-    size?: "small" | "large";
-}
+import { RecursicaStepperProps } from '@recursica/adapter-common';
 export type StepperProps = RecursicaOverStyled<RecursicaStepperProps>;
 declare const _Stepper: React.ForwardRefExoticComponent<StepperProps & React.RefAttributes<HTMLDivElement>>;
 export declare const Stepper: typeof _Stepper & {

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

@@ -1,11 +1,11 @@
 import { SwitchProps as MantineSwitchProps } from '@mantine/core';
-import { ReadOnlyControlProps } from '@recursica/adapter-common';
+import { ReadOnlyControlProps, RequireAccessibleLabel, RecursicaSwitchProps } from '@recursica/adapter-common';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
-import { RequireAccessibleLabel } from '../../utils/RequireAccessibleLabel';
 import { FormControlLayoutProps } from '../FormControlLayout/FormControlLayout';
 import { SwitchGroup } from './SwitchGroup';
-export type RecursicaSwitchProps = RequireAccessibleLabel<Omit<MantineSwitchProps, "size" | "color" | "radius" | "variant"> & ReadOnlyControlProps & Pick<FormControlLayoutProps, "formLayout" | "labelSize" | "controlMaxWidth" | "controlMinWidth">>;
-export type SwitchProps = RecursicaOverStyled<RecursicaSwitchProps>;
+export type SwitchWrapperProps = Omit<MantineSwitchProps, "size" | "color" | "radius" | "variant"> & RecursicaSwitchProps & ReadOnlyControlProps & Pick<FormControlLayoutProps, "formLayout" | "labelSize" | "controlMaxWidth" | "controlMinWidth">;
+export type RecursicaSwitchPropsAlias = RequireAccessibleLabel<SwitchWrapperProps>;
+export type SwitchProps = RecursicaOverStyled<RecursicaSwitchPropsAlias>;
 type SwitchComponent = React.ForwardRefExoticComponent<SwitchProps & React.RefAttributes<HTMLInputElement>> & {
     Group: typeof SwitchGroup;
 };

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

@@ -1,9 +1,13 @@
 import { default as React } from 'react';
 import { SwitchGroupProps as MantineSwitchGroupProps } from '@mantine/core';
-import { ReadOnlyControlProps } from '@recursica/adapter-common';
+import { ReadOnlyControlProps, RecursicaSwitchGroupProps as BaseRecursicaSwitchGroupProps } from '@recursica/adapter-common';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
 import { RecursicaFormControlWrapperProps } from '../FormControlWrapper/FormControlWrapper';
-export interface RecursicaSwitchGroupProps extends Omit<MantineSwitchGroupProps, "size" | "labelProps">, Omit<RecursicaFormControlWrapperProps, "controlMaxWidth" | "controlMinWidth">, ReadOnlyControlProps {
+export interface RecursicaSwitchGroupProps extends Omit<MantineSwitchGroupProps, "size" | "labelProps">, Omit<RecursicaFormControlWrapperProps, "controlMaxWidth" | "controlMinWidth">, ReadOnlyControlProps, BaseRecursicaSwitchGroupProps {
 }
 export type SwitchGroupProps = RecursicaOverStyled<RecursicaSwitchGroupProps>;
-export declare const SwitchGroup: React.ForwardRefExoticComponent<SwitchGroupProps & React.RefAttributes<HTMLDivElement>>;
+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,8 +1,6 @@
-import { TabsProps as MantineTabsProps, TabsListProps as MantineTabsListProps, TabsTabProps as MantineTabsTabProps, TabsPanelProps as MantineTabsPanelProps } from '@mantine/core';
+import { TabsListProps as MantineTabsListProps, TabsTabProps as MantineTabsTabProps, TabsPanelProps as MantineTabsPanelProps } from '@mantine/core';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
-export interface RecursicaTabsProps extends Omit<MantineTabsProps, "variant" | "classNames" | "color" | "radius"> {
-    variant?: "default" | "outline" | "pills";
-}
+import { RecursicaTabsProps } from '@recursica/adapter-common';
 export type TabsProps = RecursicaOverStyled<RecursicaTabsProps>;
 declare const _Tabs: import('react').ForwardRefExoticComponent<TabsProps & import('react').RefAttributes<HTMLDivElement>>;
 export type TabsListProps = RecursicaOverStyled<MantineTabsListProps>;

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

@@ -1,14 +1,5 @@
-import { ReactNode } from 'react';
-import { TextProps as MantineTextProps } from '@mantine/core';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
-export type TextVariant = "body" | "body-small" | "caption" | "overline" | "subtitle" | "subtitle-small";
-export type RecursicaTextProps = Omit<MantineTextProps, "variant"> & {
-    /**
-     * The explicit typography hierarchy dictated by Recursica's global design tokens.
-     */
-    variant?: TextVariant;
-    children?: ReactNode;
-};
+import { RecursicaTextProps } from '@recursica/adapter-common';
 export type TextProps = RecursicaOverStyled<RecursicaTextProps>;
 /**
  * A generalized typographical wrapper limiting text properties to bounded Recursica UI-kit tokens inherently.
@@ -23,7 +14,7 @@ export type TextProps = RecursicaOverStyled<RecursicaTextProps>;
  */
 export declare const Text: (<C = "p">(props: import('@mantine/core').PolymorphicComponentProps<C, TextProps>) => React.ReactElement) & Omit<import('react').FunctionComponent<((TextProps & {
     component?: any;
-}) & Omit<Omit<any, "ref">, "className" | "classNames" | "style" | "styles" | "vars" | "p" | "px" | "py" | "pt" | "pb" | "pl" | "pr" | "bg" | "c" | "opacity" | "ff" | "fz" | "fw" | "lts" | "ta" | "lh" | "fs" | "tt" | "td" | "bd" | "w" | "miw" | "maw" | "h" | "mih" | "mah" | "m" | "my" | "mx" | "mt" | "mb" | "ml" | "mr" | "top" | "left" | "bottom" | "right" | "span" | "color" | "children" | "__vars" | "__size" | "hiddenFrom" | "visibleFrom" | "lightHidden" | "darkHidden" | "mod" | "ms" | "me" | "ps" | "pe" | "bdrs" | "bgsz" | "bgp" | "bgr" | "bga" | "pos" | "inset" | "display" | "flex" | "unstyled" | "variant" | "attributes" | "overStyled" | "inherit" | "inline" | "size" | "__staticSelector" | "component" | "gradient" | "lineClamp" | "truncate"> & {
+}) & Omit<Omit<any, "ref">, "variant" | "children" | "overStyled" | "component"> & {
     ref?: any;
     renderRoot?: (props: any) => any;
 }) | (TextProps & {

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

@@ -1,15 +1,9 @@
 import { default as React } from 'react';
 import { TextareaProps as MantineTextareaProps } from '@mantine/core';
-import { ReadOnlyControlProps } from '@recursica/adapter-common';
+import { ReadOnlyControlProps, RecursicaTextAreaProps as BaseRecursicaTextAreaProps } from '@recursica/adapter-common';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
 import { RecursicaFormControlWrapperProps } from '../FormControlWrapper/FormControlWrapper';
-export interface RecursicaTextAreaProps extends Omit<MantineTextareaProps, "size" | "variant" | "radius" | "wrapperProps">, Pick<RecursicaFormControlWrapperProps, "assistiveText" | "assistiveWithIcon" | "formLayout" | "labelSize" | "labelAlignment" | "labelOptionalText" | "labelWithEditIcon" | "onLabelEditClick">, ReadOnlyControlProps {
-    /** Maximum rows for autosize textarea to grow */
-    maxRows?: number;
-    /** Minimum rows of autosize textarea */
-    minRows?: number;
-    /** If set, enables textarea height growing with its content */
-    autosize?: boolean;
+export interface RecursicaTextAreaProps extends Omit<MantineTextareaProps, "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<TextAreaProps & React.RefAttributes<HTMLTextAreaElement>>;

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

@@ -1,9 +1,13 @@
 import { default as React } from 'react';
 import { InputProps, InputWrapperProps } from '@mantine/core';
-import { ReadOnlyControlProps } from '@recursica/adapter-common';
+import { ReadOnlyControlProps, RecursicaTextFieldProps as BaseRecursicaTextFieldProps } from '@recursica/adapter-common';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
 import { RecursicaFormControlWrapperProps } from '../FormControlWrapper/FormControlWrapper';
-export interface RecursicaTextFieldProps extends Omit<InputProps, "size" | "variant" | "radius" | "wrapperProps">, Pick<InputWrapperProps, "label" | "error" | "required" | "withAsterisk" | "id">, Omit<React.ComponentPropsWithoutRef<"input">, "size" | "style" | "className" | "id">, Omit<RecursicaFormControlWrapperProps, "controlMaxWidth" | "controlMinWidth">, ReadOnlyControlProps {
+export interface RecursicaTextFieldProps extends Omit<InputProps, "size" | "variant" | "radius" | "wrapperProps">, Pick<InputWrapperProps, "label" | "error" | "required" | "withAsterisk" | "id">, Omit<React.ComponentPropsWithoutRef<"input">, "size" | "style" | "className" | "id">, Omit<RecursicaFormControlWrapperProps, "controlMaxWidth" | "controlMinWidth">, ReadOnlyControlProps, BaseRecursicaTextFieldProps {
 }
 export type TextFieldProps = RecursicaOverStyled<RecursicaTextFieldProps>;
-export declare const TextField: React.ForwardRefExoticComponent<TextFieldProps & React.RefAttributes<HTMLInputElement>>;
+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

@@ -2,12 +2,13 @@ import { default as React } from 'react';
 import { TimelineProps as MantineTimelineProps } from '@mantine/core';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
 import { TimelineItem } from './TimelineItem';
+import { RecursicaTimelineProps } from '@recursica/adapter-common';
 /**
  * Properties for the strictly-tokenized Timeline component.
  * Native Mantine 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<MantineTimelineProps, "color" | "radius" | "bulletSize" | "lineWidth">>;
+export type TimelineProps = RecursicaOverStyled<Omit<MantineTimelineProps, "color" | "radius" | "bulletSize" | "lineWidth"> & RecursicaTimelineProps>;
 interface TimelineComponent extends React.ForwardRefExoticComponent<TimelineProps & React.RefAttributes<HTMLDivElement>> {
     Item: typeof TimelineItem;
 }

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

@@ -1,18 +1,7 @@
 import { default as React } from 'react';
 import { TimelineItemProps as MantineTimelineItemProps } from '@mantine/core';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
-export interface RecursicaTimelineItemProps {
-    /**
-     * Timestamp text displayed below the description.
-     */
-    timestamp?: React.ReactNode;
-    /**
-     * The structural styling variant of the bullet container.
-     * Maps to the UI Kit structural tokens.
-     * @default "default"
-     */
-    bulletVariant?: "default" | "avatar" | "icon" | "icon-alternative";
-}
+import { RecursicaTimelineItemProps } from '@recursica/adapter-common';
 export type TimelineItemProps = RecursicaOverStyled<Omit<MantineTimelineItemProps, "radius" | "color" | "lineVariant"> & RecursicaTimelineItemProps>;
 /**
  * The individual item component for the Timeline.

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

@@ -1,11 +1,5 @@
-import { TitleProps as MantineTitleProps } from '@mantine/core';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
-export type RecursicaTitleProps = Omit<MantineTitleProps, "order"> & {
-    /**
-     * Enforces semantic HTML headers (h1-h6) cleanly bound to native typographic scaling variables in the design system.
-     */
-    order?: 1 | 2 | 3 | 4 | 5 | 6;
-};
+import { RecursicaTitleProps } from '@recursica/adapter-common';
 export type TitleProps = RecursicaOverStyled<RecursicaTitleProps>;
 /**
  * Enforces highly accessible structural markup utilizing semantic `<h1>` through `<h6>` tags securely bound directly to Recursica typographic scales.

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

@@ -1,18 +1,7 @@
 import { default as React } from 'react';
 import { NotificationProps as MantineNotificationProps } from '@mantine/core';
 import { RecursicaOverStyled } from '../../utils/filterStylingProps';
-export interface RecursicaToastProps {
-    /**
-     * The visual variant of the toast.
-     * @default "default"
-     */
-    variant?: "default" | "error" | "success";
-    /**
-     * Loading state is natively unsupported by Recursica UI Kit.
-     * If a loading state is required, pass a `<Loader size="sm" />` directly into the `icon` prop.
-     */
-    loading?: false;
-}
+import { RecursicaToastProps } from '@recursica/adapter-common';
 /**
  * Toast component wrapping Mantine's Notification.
  *

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

@@ -1,17 +1,6 @@
 import { Tooltip as MantineTooltip, TooltipProps as MantineTooltipProps } from '@mantine/core';
 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 Mantine's `withArrow`.
-     * When both `withBeak` and `withArrow` are provided, `withBeak` takes precedence.
-     * @default true
-     */
-    withBeak?: boolean;
-}
+import { RecursicaTooltipProps } from '@recursica/adapter-common';
 /**
  * Recursica Tooltip component wrapping Mantine's Tooltip.
  *

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/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,17 +22,7 @@
  * @returns Sanitized component props safe for internal styling merging
  */
 export declare const BLOCKED_STYLING_KEYS: readonly ["className", "classNames", "style", "styles", "vars", "p", "px", "py", "pt", "pb", "pl", "pr", "bg", "c", "opacity", "ff", "fz", "fw", "lts", "ta", "lh", "fs", "tt", "td", "bd", "bdw", "bds", "bdc", "bdr", "shadow", "w", "miw", "maw", "h", "mih", "mah"];
-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 RecursicaOverStyled<T> = (Omit<T, BlockedStylingKeys> & ForbiddenStyles & {
-    overStyled?: false | undefined;
-}) | (T & {
-    overStyled: true;
-});
 export declare function mapLayoutProps<T extends Record<string, unknown>>(props: T): T;
 export declare function filterStylingProps<T extends Record<string, unknown>>(props: T, overStyled?: boolean): Partial<T>;

package/llms.txt

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

package/package.json

@@ -13,7 +13,7 @@
     "url": "git+https://github.com/borderux/recursica.git",
     "directory": "packages/mantine-adapter"
   },
-  "version": "0.23.0",
+  "version": "0.26.0",
   "type": "module",
   "main": "./dist/mantine-adapter.cjs",
   "module": "./dist/mantine-adapter.js",
@@ -30,7 +30,11 @@
     "dist",
     "src",
     "CHANGELOG.md",
-    ".storybook/commonArgTypes.ts"
+    ".storybook/commonArgTypes.ts",
+    "llms.txt",
+    "USAGE.md",
+    "ARCHITECTURE.md",
+    "SETUP.md"
   ],
   "keywords": [
     "react",
@@ -88,6 +92,9 @@
     "vite-plugin-svgr": "^4.3.0",
     "vitest": "^3.2.4"
   },
+  "dependencies": {
+    "@recursica/official-release": "*"
+  },
   "peerDependencies": {
     "@mantine/core": "^8.0.0",
     "@mantine/dates": "^8.0.0",

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

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