@recursica/mantine-adapter 0.55.3 → 0.55.4

package/package.json

@@ -13,7 +13,7 @@
     "url": "git+https://github.com/borderux/recursica.git",
     "directory": "packages/mantine-adapter"
   },
-  "version": "0.55.3",
+  "version": "0.55.4",
   "type": "module",
   "main": "./dist/mantine-adapter.cjs",
   "module": "./dist/mantine-adapter.js",
@@ -103,7 +103,7 @@
     "vitest": "^3.2.4"
   },
   "dependencies": {
-    "@recursica/adapter-common": "^0.29.0"
+    "@recursica/adapter-common": "^0.29.1"
   },
   "peerDependencies": {
     "@mantine/core": "^8.0.0",

package/src/components/AssistiveElement/AssistiveElement.stories.tsx

@@ -1,6 +1,5 @@
 import type { Meta, StoryObj } from "@storybook/react";
 import { AssistiveElement } from "./AssistiveElement";
-import { Layer } from "@recursica/adapter-common";
 
 const meta: Meta<typeof AssistiveElement> = {
   title: "UI-Kit/AssistiveElement",

package/src/components/Chip/Chip.stories.tsx

@@ -118,9 +118,23 @@ export const WithLeadingIcon: Story = {
 // matches MUI's native behavior of the check icon overlaying the leading icon.
 export const WithLeadingIconSelected: Story = {
   args: {
-    ...WithLeadingIcon.args,
     children: "Leading Icon Selected",
     checked: true,
+    icon: (
+      <svg
+        xmlns="http://www.w3.org/2000/svg"
+        viewBox="0 0 24 24"
+        fill="none"
+        stroke="currentColor"
+        strokeWidth="2"
+        strokeLinecap="round"
+        strokeLinejoin="round"
+      >
+        <circle cx="12" cy="12" r="10"></circle>
+        <path d="M12 8v4"></path>
+        <path d="M12 16h.01"></path>
+      </svg>
+    ),
   },
   render: (args: ChipStoryProps) => <Chip {...args} onChange={() => {}} />,
 };

package/src/components/EmptyValueRenderer/USAGE.md

@@ -0,0 +1,37 @@
+# EmptyValueRenderer - Usage Guide
+
+This document describes how to integrate and use the `EmptyValueRenderer` component in your projects using `@recursica/mantine-adapter`.
+
+> [!NOTE] > `EmptyValueRenderer` is defined once in `@recursica/adapter-common` and re-exported here so it shares the exact same behavior across every Recursica adapter.
+
+---
+
+## 1. Import Reference
+
+```tsx
+import { EmptyValueRenderer } from "@recursica/mantine-adapter";
+```
+
+---
+
+## 2. Basic Example
+
+`EmptyValueRenderer` renders a fallback (`"N/A"` by default) in place of an empty value, and exposes a static `EmptyValueRenderer.check(value)` helper that flags `null`, `undefined`, `""`, and `[]` as empty:
+
+```tsx
+import { EmptyValueRenderer, ReadOnlyField } from "@recursica/mantine-adapter";
+
+function Example({ value }: { value?: string }) {
+  return EmptyValueRenderer.check(value) ? (
+    <EmptyValueRenderer emptyText="No value set" />
+  ) : (
+    <ReadOnlyField value={value} />
+  );
+}
+```
+
+---
+
+## 3. Design System Integration
+
+`EmptyValueRenderer` has no visual variants and does not accept `overStyled` — it is a plain text fallback, not a styled component. Use it wherever a read-only or empty-state surface needs a consistent "no value" treatment instead of ad hoc strings.

package/src/components/EmptyValueRenderer/index.ts

@@ -0,0 +1,5 @@
+export { EmptyValueRenderer } from "@recursica/adapter-common";
+export type {
+  EmptyValueRendererProps,
+  RecursicaEmptyValueRendererProps,
+} from "@recursica/adapter-common";

package/src/components/Layer/index.ts

@@ -0,0 +1,5 @@
+export { Layer } from "@recursica/adapter-common";
+export type {
+  RecursicaLayerProps,
+  LayerProps,
+} from "@recursica/adapter-common";

package/src/components/RecursicaThemeProvider/index.ts

@@ -0,0 +1,2 @@
+export { RecursicaThemeProvider } from "@recursica/adapter-common";
+export type { RecursicaThemeProviderProps } from "@recursica/adapter-common";

package/src/components/index.ts

@@ -12,6 +12,7 @@ export * from "./Chip/Chip";
 export * from "./Container/Container";
 export * from "./DatePicker/DatePicker";
 export * from "./Dropdown/Dropdown";
+export * from "./EmptyValueRenderer";
 export * from "./FileInput/FileInput";
 export * from "./FileUpload/FileUpload";
 export * from "./Flex/Flex";
@@ -20,6 +21,7 @@ export * from "./Grid/Grid";
 export * from "./Group/Group";
 export * from "./Heading/Heading";
 export * from "./HoverCard/HoverCard";
+export * from "./Layer";
 export * from "./Link/Link";
 export * from "./Loader/Loader";
 export * from "./Label";
@@ -32,6 +34,7 @@ export * from "./Popover";
 export * from "./Radio/Radio";
 export * from "./Radio/RadioGroup";
 export * from "./ReadOnlyField";
+export * from "./RecursicaThemeProvider";
 export * from "./SegmentedControl/SegmentedControl";
 export * from "./Slider/Slider";
 export * from "./Stack/Stack";

package/src/index.ts

@@ -2,7 +2,111 @@ import "@recursica/adapter-common/style.css";
 import * as rawComponents from "./components";
 import { wrapComponent } from "@recursica/adapter-common";
 
-export * from "@recursica/adapter-common";
+// Pass-through components that have no mantine-specific implementation — each is
+// redeclared in its own components/ folder and re-exported from adapter-common there.
+export {
+  Layer,
+  EmptyValueRenderer,
+  RecursicaThemeProvider,
+} from "./components";
+export type {
+  RecursicaLayerProps,
+  LayerProps,
+  EmptyValueRendererProps,
+  RecursicaEmptyValueRendererProps,
+  RecursicaThemeProviderProps,
+} from "./components";
+export { markCurrentPageItem } from "@recursica/adapter-common";
+
+// Foundational types and utilities re-exported explicitly from @recursica/adapter-common
+export type {
+  RecursicaSpacing,
+  RecursicaSize,
+  RequireAccessibleLabel,
+  BlockedStylingKeys,
+  ForbiddenStyles,
+  WithRecursicaSpacing,
+  RecursicaOverStyled,
+  RecursicaLabelProps,
+  RecursicaFormControlWrapperProps,
+  RecursicaComponent,
+} from "@recursica/adapter-common";
+export { RECURSICA_COMPONENTS } from "@recursica/adapter-common";
+export {
+  copyToClipboard,
+  fileMatchesAccept,
+  mergeClassNames,
+  mergeStyles,
+  normalizeComboboxData,
+  omitUnsupportedProps,
+  withCallerOverride,
+  wrapComponent,
+  IS_DEV,
+  toggleGlobalOverStyled,
+  isGlobalOverStyledActive,
+  useGlobalOverStyled,
+  injectOverStyledStyles,
+  registerOverStyledConsoleCommand,
+} from "@recursica/adapter-common";
+
+// Shared Recursica prop types that have no mantine-specific extension — re-exported
+// explicitly since each component only imports these internally, never by name.
+export type {
+  ReadOnlyControlProps,
+  ReadOnlyFieldType,
+  RecursicaAccordionProps,
+  RecursicaAccordionItemProps,
+  RecursicaAccordionControlProps,
+  RecursicaAccordionPanelProps,
+  RecursicaAssistiveElementProps,
+  RecursicaAutocompleteProps,
+  RecursicaAvatarProps,
+  RecursicaBadgeProps,
+  RecursicaBreadcrumbProps,
+  RecursicaButtonProps,
+  RecursicaCardProps,
+  RecursicaCardSectionProps,
+  RecursicaCheckboxProps,
+  RecursicaChipProps,
+  RecursicaComboboxItem,
+  RecursicaComboboxData,
+  RecursicaComboboxItemWithLabel,
+  RecursicaContainerProps,
+  RecursicaFileInputProps,
+  RecursicaFileInputItem,
+  RecursicaFileUploadProps,
+  RecursicaFileUploadItem,
+  RecursicaFormControlLayoutProps,
+  RecursicaHeadingProps,
+  RecursicaHoverCardProps,
+  RecursicaLinkProps,
+  RecursicaLoaderProps,
+  RecursicaMenuProps,
+  RecursicaModalProps,
+  RecursicaPaginationProps,
+  RecursicaPanelProps,
+  RecursicaPopoverProps,
+  RecursicaRadioProps,
+  RecursicaSegmentedControlProps,
+  RecursicaStepperProps,
+  RecursicaSwitchProps,
+  RecursicaTableProps,
+  RecursicaTableRowProps,
+  RecursicaTableHeaderCellProps,
+  RecursicaTableCellProps,
+  RecursicaTabsProps,
+  TextVariant,
+  RecursicaTextProps,
+  RecursicaTimelineProps,
+  RecursicaTimelineItemProps,
+  RecursicaToastProps,
+  RecursicaTooltipProps,
+  RecursicaTransferListProps,
+  RecursicaTransferListItem,
+  RecursicaTransferListData,
+  RecursicaTreeProps,
+  RecursicaTreeNode,
+} from "@recursica/adapter-common";
 
 // Expose unwrapped structural layout primitives to preserve their polymorphic types
 export const Flex = rawComponents.Flex;