@recursica/mantine-adapter 0.15.0 → 0.17.0

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

@@ -11,9 +11,15 @@ export type ButtonProps = RecursicaOverStyled<Omit<MantineButtonProps, "variant"
  * Recursica Button component wrapping Mantine's Button.
  *
  * Supports polymorphism via the `component` prop or `renderRoot` for custom element rendering.
+ * This is particularly useful when you need a button that behaves as a hyperlink (rendering an `<a>` tag)
+ * or integrates with a routing library (e.g., `react-router-dom` or Next.js), while preserving full visual styling.
+ *
  * @example
  * ```tsx
- * <Button component="a" href="/dashboard">Navigate</Button>
+ * // Renders as an <a> tag natively
+ * <Button component="a" href="/dashboard" target="_blank">Navigate</Button>
+ *
+ * // Renders using a custom router link
  * <Button renderRoot={(props) => <Link to="/home" {...props} />}>Home</Button>
  * ```
  */

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

@@ -1,6 +1,5 @@
-import { default as React } from 'react';
 import { ContainerProps as MantineContainerProps } from '@mantine/core';
-import { RecursicaOverStyled, RecursicaSpacing } from '../../utils/filterStylingProps';
+import { RecursicaSpacing } from '../../utils/filterStylingProps';
 export interface RecursicaContainerProps {
     /**
      * Children components inside the layout container
@@ -12,7 +11,11 @@ export interface RecursicaContainerProps {
     size?: "xs" | "sm" | "md" | "lg" | "xl" | RecursicaSpacing | (string & {}) | number;
 }
 /**
- * Container layout wrapper
+ * Container layout wrapper.
+ *
+ * Note: Unlike complex UI components, primitive layout components (Flex, Stack, Group, Container)
+ * DO NOT use the `RecursicaOverStyled` gatekeeper. Developers must be able to freely pass
+ * width, height, padding, margins, and flexbox alignment props to construct structural layouts.
  */
-export type ContainerProps = RecursicaOverStyled<Omit<MantineContainerProps, "size"> & RecursicaContainerProps>;
-export declare const Container: React.ForwardRefExoticComponent<ContainerProps & React.RefAttributes<HTMLDivElement>>;
+export type ContainerProps = Omit<MantineContainerProps, "size"> & RecursicaContainerProps;
+export declare const Container: import('react').ForwardRefExoticComponent<Omit<MantineContainerProps, "size"> & RecursicaContainerProps & import('react').RefAttributes<HTMLDivElement>>;

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

@@ -1,6 +1,5 @@
-import { default as React } from 'react';
 import { FlexProps as MantineFlexProps } from '@mantine/core';
-import { RecursicaOverStyled, RecursicaSpacing } from '../../utils/filterStylingProps';
+import { RecursicaSpacing } from '../../utils/filterStylingProps';
 export interface RecursicaFlexProps {
     /**
      * Children components inside the Flex container
@@ -11,9 +10,13 @@ export interface RecursicaFlexProps {
     columnGap?: MantineFlexProps["gap"] | RecursicaSpacing;
 }
 /**
- * Flex layout wrapper
+ * Flex layout wrapper.
+ *
+ * Note: Unlike complex UI components, primitive layout components (Flex, Stack, Group, Container)
+ * DO NOT use the `RecursicaOverStyled` gatekeeper. Developers must be able to freely pass
+ * width, height, padding, margins, and flexbox alignment props to construct structural layouts.
  */
-export type FlexProps = RecursicaOverStyled<MantineFlexProps & RecursicaFlexProps>;
+export type FlexProps = MantineFlexProps & RecursicaFlexProps;
 /**
  * Recursica Flex layout wrapper.
  *
@@ -24,12 +27,12 @@ export type FlexProps = RecursicaOverStyled<MantineFlexProps & RecursicaFlexProp
  * <Flex component="section">...</Flex>
  * ```
  */
-export declare const Flex: (<C = "div">(props: import('@mantine/core').PolymorphicComponentProps<C, FlexProps>) => React.ReactElement) & Omit<React.FunctionComponent<((FlexProps & {
+export declare const Flex: (<C = "div">(props: import('@mantine/core').PolymorphicComponentProps<C, FlexProps>) => React.ReactElement) & Omit<import('react').FunctionComponent<(MantineFlexProps & RecursicaFlexProps & {
     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" | "rowGap" | "columnGap" | "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" | "overStyled" | "justify" | "component" | "direction" | "wrap" | "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" | "rowGap" | "columnGap" | "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" | "direction" | "wrap" | "align"> & {
     ref?: any;
     renderRoot?: (props: any) => any;
-}) | (FlexProps & {
+}) | (MantineFlexProps & RecursicaFlexProps & {
     component: React.ElementType;
     renderRoot?: (props: Record<string, any>) => any;
 })>, never> & Record<string, never>;

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

@@ -1,6 +1,5 @@
-import { default as React } from 'react';
 import { GroupProps as MantineGroupProps } from '@mantine/core';
-import { RecursicaOverStyled, RecursicaSpacing } from '../../utils/filterStylingProps';
+import { RecursicaSpacing } from '../../utils/filterStylingProps';
 export interface RecursicaGroupProps {
     /**
      * Children components inside the group
@@ -11,7 +10,11 @@ export interface RecursicaGroupProps {
     columnGap?: MantineGroupProps["gap"] | RecursicaSpacing;
 }
 /**
- * Group flex layout wrapper
+ * Group flex layout wrapper.
+ *
+ * Note: Unlike complex UI components, primitive layout components (Flex, Stack, Group, Container)
+ * DO NOT use the `RecursicaOverStyled` gatekeeper. Developers must be able to freely pass
+ * width, height, padding, margins, and flexbox alignment props to construct structural layouts.
  */
-export type GroupProps = RecursicaOverStyled<MantineGroupProps & RecursicaGroupProps>;
-export declare const Group: React.ForwardRefExoticComponent<GroupProps & React.RefAttributes<HTMLDivElement>>;
+export type GroupProps = MantineGroupProps & RecursicaGroupProps;
+export declare const Group: import('react').ForwardRefExoticComponent<MantineGroupProps & RecursicaGroupProps & import('react').RefAttributes<HTMLDivElement>>;

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

@@ -1,3 +1,33 @@
 import { default as React } from 'react';
-export type LinkProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Link: React.FC<LinkProps>;
+import { AnchorProps as MantineAnchorProps } from '@mantine/core';
+import { RecursicaOverStyled } from '../../utils/filterStylingProps';
+export interface RecursicaLinkProps {
+    /**
+     * Optional leading icon to display next to the link text.
+     */
+    icon?: React.ReactNode;
+    /**
+     * The text or elements to display inside the link.
+     */
+    children?: React.ReactNode;
+}
+export type LinkProps = RecursicaOverStyled<Omit<MantineAnchorProps, "underline"> & RecursicaLinkProps>;
+/**
+ * Recursica Link component wrapping Mantine's Anchor.
+ *
+ * Supports polymorphism via the `component` prop or `renderRoot` for custom element rendering (e.g. react-router Link).
+ * @example
+ * ```tsx
+ * <Link component="a" href="https://example.com">External Link</Link>
+ * <Link renderRoot={(props) => <RouterLink to="/home" {...props} />}>Home</Link>
+ * ```
+ */
+export declare const Link: (<C = "a">(props: import('@mantine/core').PolymorphicComponentProps<C, LinkProps>) => React.ReactElement) & Omit<React.FunctionComponent<((LinkProps & {
+    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" | "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" | "icon" | "inherit" | "inline" | "size" | "gradient" | "component" | "__staticSelector" | "lineClamp" | "truncate"> & {
+    ref?: any;
+    renderRoot?: (props: any) => any;
+}) | (LinkProps & {
+    component: React.ElementType;
+    renderRoot?: (props: Record<string, any>) => any;
+})>, never> & Record<string, never>;

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

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

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

@@ -1,3 +1,51 @@
 import { default as React } from 'react';
-export type PaginationProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Pagination: React.FC<PaginationProps>;
+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;
+};
+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. */
+    withLabel?: boolean;
+    icon?: any;
+};
+declare const _PaginationRoot: React.ForwardRefExoticComponent<PaginationRootProps & React.RefAttributes<HTMLDivElement>>;
+declare const _PaginationNext: React.ForwardRefExoticComponent<{
+    /** If set to true, displays text labels alongside the icon. */
+    withLabel?: boolean;
+    icon?: any;
+} & React.RefAttributes<HTMLButtonElement>>;
+declare const _PaginationPrevious: React.ForwardRefExoticComponent<{
+    /** If set to true, displays text labels alongside the icon. */
+    withLabel?: boolean;
+    icon?: any;
+} & React.RefAttributes<HTMLButtonElement>>;
+declare const _PaginationFirst: React.ForwardRefExoticComponent<{
+    /** If set to true, displays text labels alongside the icon. */
+    withLabel?: boolean;
+    icon?: any;
+} & React.RefAttributes<HTMLButtonElement>>;
+declare const _PaginationLast: React.ForwardRefExoticComponent<{
+    /** If set to true, displays text labels alongside the icon. */
+    withLabel?: boolean;
+    icon?: any;
+} & React.RefAttributes<HTMLButtonElement>>;
+declare const _Pagination: React.ForwardRefExoticComponent<PaginationProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Recursica Pagination component wrapping Mantine's Pagination.
+ */
+export declare const Pagination: typeof _Pagination & {
+    Root: typeof _PaginationRoot;
+    Items: typeof MantinePagination.Items;
+    Control: typeof MantinePagination.Control;
+    Dots: typeof MantinePagination.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/Pagination/index.d.ts

@@ -0,0 +1 @@
+export { Pagination, type PaginationProps, type PaginationRootProps, } from './Pagination';

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

@@ -1,3 +1,16 @@
-import { default as React } from 'react';
-export type SegmentedControlProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const SegmentedControl: React.FC<SegmentedControlProps>;
+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;
+}
+export type SegmentedControlProps = RecursicaOverStyled<Omit<MantineSegmentedControlProps, "variant" | "size" | "radius" | "color" | "classNames" | "className"> & {
+    className?: string;
+    classNames?: Partial<Record<string, string>>;
+} & RecursicaSegmentedControlProps>;
+/**
+ * Recursica SegmentedControl component wrapping Mantine's SegmentedControl.
+ */
+export declare const SegmentedControl: import('react').ForwardRefExoticComponent<SegmentedControlProps & import('react').RefAttributes<HTMLDivElement>>;

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

@@ -1,6 +1,5 @@
-import { default as React } from 'react';
 import { StackProps as MantineStackProps } from '@mantine/core';
-import { RecursicaOverStyled, RecursicaSpacing } from '../../utils/filterStylingProps';
+import { RecursicaSpacing } from '../../utils/filterStylingProps';
 export interface RecursicaStackProps {
     /**
      * Children components inside the stack
@@ -9,7 +8,11 @@ export interface RecursicaStackProps {
     gap?: MantineStackProps["gap"] | RecursicaSpacing;
 }
 /**
- * Stack flex layout wrapper
+ * Stack flex layout wrapper.
+ *
+ * Note: Unlike complex UI components, primitive layout components (Flex, Stack, Group, Container)
+ * DO NOT use the `RecursicaOverStyled` gatekeeper. Developers must be able to freely pass
+ * width, height, padding, margins, and flexbox alignment props to construct structural layouts.
  */
-export type StackProps = RecursicaOverStyled<MantineStackProps & RecursicaStackProps>;
-export declare const Stack: React.ForwardRefExoticComponent<StackProps & React.RefAttributes<HTMLDivElement>>;
+export type StackProps = MantineStackProps & RecursicaStackProps;
+export declare const Stack: import('react').ForwardRefExoticComponent<MantineStackProps & RecursicaStackProps & import('react').RefAttributes<HTMLDivElement>>;

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

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

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

@@ -1,3 +1,19 @@
-import { default as React } from 'react';
-export type TabsProps = React.HTMLAttributes<HTMLDivElement>;
-export declare const Tabs: React.FC<TabsProps>;
+import { TabsProps as MantineTabsProps, 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";
+}
+export type TabsProps = RecursicaOverStyled<RecursicaTabsProps>;
+declare const _Tabs: import('react').ForwardRefExoticComponent<TabsProps & import('react').RefAttributes<HTMLDivElement>>;
+export type TabsListProps = RecursicaOverStyled<MantineTabsListProps>;
+declare const _TabsList: import('react').ForwardRefExoticComponent<TabsListProps & import('react').RefAttributes<HTMLDivElement>>;
+export type TabsTabProps = RecursicaOverStyled<MantineTabsTabProps>;
+declare const _TabsTab: import('react').ForwardRefExoticComponent<TabsTabProps & import('react').RefAttributes<HTMLButtonElement>>;
+export type TabsPanelProps = RecursicaOverStyled<MantineTabsPanelProps>;
+declare const _TabsPanel: import('react').ForwardRefExoticComponent<TabsPanelProps & import('react').RefAttributes<HTMLDivElement>>;
+export declare const Tabs: typeof _Tabs & {
+    List: typeof _TabsList;
+    Tab: typeof _TabsTab;
+    Panel: typeof _TabsPanel;
+};
+export {};

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

@@ -24,11 +24,9 @@ export * from './Modal/Modal';
 export * from './NumberInput/NumberInput';
 export * from './Pagination/Pagination';
 export * from './Panel/Panel';
-export * from './Popover/Popover';
 export * from './Radio/Radio';
 export * from './Radio/RadioGroup';
 export * from './ReadOnlyField';
-export * from './Search/Search';
 export * from './SegmentedControl/SegmentedControl';
 export * from './Slider/Slider';
 export * from './Stack/Stack';

package/package.json

@@ -11,7 +11,7 @@
     "type": "git",
     "url": "git+https://github.com/borderux/recursica.git"
   },
-  "version": "0.15.0",
+  "version": "0.17.0",
   "type": "module",
   "main": "./dist/mantine-adapter.cjs",
   "module": "./dist/mantine-adapter.js",

package/src/OverStyling.stories.tsx

@@ -133,6 +133,28 @@ const OverStylingInfo = () => {
 
         <Divider mb="xl" />
 
+        <Title order={3} mb="sm">
+          Primitive Layout Components Exemption
+        </Title>
+        <Text mb="sm">
+          Unlike complex UI components (Buttons, Tabs, Inputs) which are
+          strictly protected, <strong>Primitive Layout Components</strong> (
+          <Code>Flex</Code>,<Code>Stack</Code>, <Code>Group</Code>,{" "}
+          <Code>Container</Code>) are entirely exempt from the{" "}
+          <Code>RecursicaOverStyled</Code> gatekeeper.
+        </Text>
+        <Text mb="xl">
+          Because the entire functional purpose of these components is
+          structural layout composition, developers are free to pass any
+          standard Mantine width, height, padding, margin, gap, and alignment
+          property directly to them without needing to flag{" "}
+          <Code>overStyled={`{true}`}</Code>. The internal custom token mapper
+          (such as converting <Code>gap="rec-md"</Code>) is still active
+          natively on these wrappers.
+        </Text>
+
+        <Divider mb="xl" />
+
         <Title order={3} mb="md">
           Live Example
         </Title>

package/src/components/Button/Button.stories.tsx

@@ -101,3 +101,14 @@ export const DisabledSolid: Story = {
     disabled: true,
   },
 };
+
+export const PolymorphicAsLink: Story = {
+  args: {
+    children: "Button as Link",
+    variant: "solid",
+    size: "default",
+    component: "a",
+    href: "https://example.com",
+    target: "_blank",
+  },
+};

package/src/components/Button/Button.tsx

@@ -123,9 +123,15 @@ _Button.displayName = "Button";
  * Recursica Button component wrapping Mantine's Button.
  *
  * Supports polymorphism via the `component` prop or `renderRoot` for custom element rendering.
+ * This is particularly useful when you need a button that behaves as a hyperlink (rendering an `<a>` tag)
+ * or integrates with a routing library (e.g., `react-router-dom` or Next.js), while preserving full visual styling.
+ *
  * @example
  * ```tsx
- * <Button component="a" href="/dashboard">Navigate</Button>
+ * // Renders as an <a> tag natively
+ * <Button component="a" href="/dashboard" target="_blank">Navigate</Button>
+ *
+ * // Renders using a custom router link
  * <Button renderRoot={(props) => <Link to="/home" {...props} />}>Home</Button>
  * ```
  */

package/src/components/Card/Card.tsx

@@ -182,7 +182,7 @@ const PolymorphicCard = createPolymorphicComponent<
 >(CardBase);
 
 // Attach static components for dot-notation access
-const _card = PolymorphicCard as Record<string, unknown>;
+const _card = PolymorphicCard as unknown as Record<string, unknown>;
 _card.Section = CardSection;
 _card.Header = CardHeader;
 _card.Footer = CardFooter;

package/src/components/Container/Container.tsx

@@ -1,13 +1,9 @@
-import React, { forwardRef } from "react";
+import { forwardRef } from "react";
 import {
   Container as MantineContainer,
   type ContainerProps as MantineContainerProps,
 } from "@mantine/core";
-import {
-  filterStylingProps,
-  type RecursicaOverStyled,
-  type RecursicaSpacing,
-} from "../../utils/filterStylingProps";
+import { type RecursicaSpacing } from "../../utils/filterStylingProps";
 import styles from "./Container.module.css";
 
 export interface RecursicaContainerProps {
@@ -30,17 +26,17 @@ export interface RecursicaContainerProps {
 }
 
 /**
- * Container layout wrapper
+ * Container layout wrapper.
+ *
+ * Note: Unlike complex UI components, primitive layout components (Flex, Stack, Group, Container)
+ * DO NOT use the `RecursicaOverStyled` gatekeeper. Developers must be able to freely pass
+ * width, height, padding, margins, and flexbox alignment props to construct structural layouts.
  */
-export type ContainerProps = RecursicaOverStyled<
-  Omit<MantineContainerProps, "size"> & RecursicaContainerProps
->;
+export type ContainerProps = Omit<MantineContainerProps, "size"> &
+  RecursicaContainerProps;
 
 export const Container = forwardRef<HTMLDivElement, ContainerProps>(
-  function Container({ children, size, overStyled = false, ...rest }, ref) {
-    const sanitizedProps = filterStylingProps(rest, overStyled);
-    const restRecord = sanitizedProps as Record<string, unknown>;
-
+  function Container({ children, size, ...rest }, ref) {
     const mapSize: Record<string, string> = {
       "rec-sm": "sm",
       "rec-default": "md",
@@ -57,7 +53,7 @@ export const Container = forwardRef<HTMLDivElement, ContainerProps>(
       root: styles.root,
     };
 
-    const classNamesProp = restRecord.classNames;
+    const classNamesProp = rest.classNames;
     if (
       classNamesProp &&
       typeof classNamesProp === "object" &&
@@ -67,7 +63,7 @@ export const Container = forwardRef<HTMLDivElement, ContainerProps>(
       mergedClassNames.root = o.root ? `${styles.root} ${o.root}` : styles.root;
     }
 
-    const classNameProp = restRecord.className as string | undefined;
+    const classNameProp = rest.className as string | undefined;
     const finalClass = classNameProp
       ? `${styles.root} ${classNameProp}`
       : styles.root;
@@ -78,7 +74,7 @@ export const Container = forwardRef<HTMLDivElement, ContainerProps>(
         size={resolvedSize}
         className={finalClass}
         classNames={mergedClassNames}
-        {...sanitizedProps}
+        {...rest}
       >
         {children}
       </MantineContainer>

package/src/components/Flex/Flex.tsx

@@ -1,14 +1,10 @@
-import React, { forwardRef } from "react";
+import { forwardRef } from "react";
 import {
   Flex as MantineFlex,
   type FlexProps as MantineFlexProps,
   createPolymorphicComponent,
 } from "@mantine/core";
-import {
-  filterStylingProps,
-  type RecursicaOverStyled,
-  type RecursicaSpacing,
-} from "../../utils/filterStylingProps";
+import { type RecursicaSpacing } from "../../utils/filterStylingProps";
 import styles from "./Flex.module.css";
 
 export interface RecursicaFlexProps {
@@ -22,24 +18,23 @@ export interface RecursicaFlexProps {
 }
 
 /**
- * Flex layout wrapper
+ * Flex layout wrapper.
+ *
+ * Note: Unlike complex UI components, primitive layout components (Flex, Stack, Group, Container)
+ * DO NOT use the `RecursicaOverStyled` gatekeeper. Developers must be able to freely pass
+ * width, height, padding, margins, and flexbox alignment props to construct structural layouts.
  */
-export type FlexProps = RecursicaOverStyled<
-  MantineFlexProps & RecursicaFlexProps
->;
+export type FlexProps = MantineFlexProps & RecursicaFlexProps;
 
 const _Flex = forwardRef<HTMLDivElement, FlexProps>(function Flex(
-  { children, overStyled = false, gap = "rec-default", ...rest },
+  { children, gap = "rec-default", ...rest },
   ref,
 ) {
-  const sanitizedProps = filterStylingProps({ ...rest, gap }, overStyled);
-  const restRecord = sanitizedProps as Record<string, unknown>;
-
   const mergedClassNames: Partial<Record<string, string>> = {
     root: styles.root,
   };
 
-  const classNamesProp = restRecord.classNames;
+  const classNamesProp = rest.classNames;
   if (
     classNamesProp &&
     typeof classNamesProp === "object" &&
@@ -49,7 +44,7 @@ const _Flex = forwardRef<HTMLDivElement, FlexProps>(function Flex(
     mergedClassNames.root = o.root ? `${styles.root} ${o.root}` : styles.root;
   }
 
-  const classNameProp = restRecord.className as string | undefined;
+  const classNameProp = rest.className as string | undefined;
   const finalClass = classNameProp
     ? `${styles.root} ${classNameProp}`
     : styles.root;
@@ -59,7 +54,8 @@ const _Flex = forwardRef<HTMLDivElement, FlexProps>(function Flex(
       ref={ref}
       className={finalClass}
       classNames={mergedClassNames}
-      {...sanitizedProps}
+      gap={gap}
+      {...rest}
     >
       {children}
     </MantineFlex>