@recursica/mantine-adapter 0.55.2 → 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.2",
+  "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.28.2"
+    "@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/Checkbox/CHECKBOX_IMPLEMENTATION_NOTES.md

@@ -23,3 +23,16 @@ This calculation ensures that the optical center of the `.inner` checkmark vecto
 ### Checkbox.Group Overrides
 
 To decouple `<CheckboxGroup>` away from `<Input.Wrapper>`, we explicitly extract the raw array execution mapped correctly against our identical `RecursicaFormControlWrapperProps` schema structurally!
+
+### `Checkbox.Group` `controlMaxWidth` bug (fixed 2026-08-31)
+
+`CheckboxGroup` was passing `--recursica_ui-kit_components_checkbox-item_properties_max-width`
+(400px) as its own `controlMaxWidth`. That token caps a single checkbox+its own label — it's
+already applied per-item via `.root` in `Checkbox.module.css`. Passed as the _group's_
+`controlMaxWidth`, `FormControlLayout` applies it to the whole root row (`max-width` on
+`.root`, which contains both `leftSection`/label and `rightSection`/items), so in side-by-side
+layout the group's own label got squeezed into that same 400px alongside the checkboxes. There
+is no group-level max-width token in the schema (`checkbox-group_variants_layouts_*` only
+covers gutter/margin/padding) — fixed by leaving `controlMaxWidth` `undefined`, matching
+`SwitchGroup`'s existing pattern. Same bug existed in `RadioGroup` (`radio-button-item_
+properties_max-width`), fixed the same way.

package/src/components/Checkbox/CheckboxGroup.tsx

@@ -89,7 +89,11 @@ export const CheckboxGroup = forwardRef<HTMLDivElement, CheckboxGroupProps>(
       <WithReadOnlyWrapper
         className={className}
         style={style as React.CSSProperties}
-        controlMaxWidth="var(--recursica_ui-kit_components_checkbox-item_properties_max-width)"
+        // Not the group's own row width: this token caps a single checkbox+its own label
+        // (applied per-item in Checkbox.module.css's `.root`). The group has no max-width token
+        // of its own in the schema, so this must stay undefined or FormControlLayout caps the
+        // whole label+items row (including the group's own label) at 400px in side-by-side layout.
+        controlMaxWidth={undefined}
         controlMinWidth={undefined}
         overStyled={overStyled as true}
         labelElement="div" // Strictly override. ARIA grouping prohibits interactive checkboxes nested natively inside <label>.

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

@@ -118,9 +118,51 @@ 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={() => {}} />,
 };
+
+// A label long enough to exceed the chip's own max-width token — should stay a single line and
+// truncate with an ellipsis, never wrap, even with both a leading icon and a dismiss button
+// competing for space.
+export const MaxWidthEllipsis: Story = {
+  args: {
+    children:
+      "A very long chip label that exceeds the maximum width and should truncate with an ellipsis",
+    checked: false,
+    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>
+    ),
+    onDelete: () => console.log("Removal Action Triggered"),
+  },
+  render: (args: ChipStoryProps) => <Chip {...args} />,
+};

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/Radio/RADIO_IMPLEMENTATION_NOTES.md

@@ -0,0 +1,12 @@
+# Radio Implementation Notes
+
+### `Radio.Group` `controlMaxWidth` bug (fixed 2026-08-31)
+
+`RadioGroup` was passing `--recursica_ui-kit_components_radio-button-item_properties_max-width`
+(400px) as its own `controlMaxWidth`. That token caps a single radio+its own label — it's
+already applied per-item via `.root` in `Radio.module.css`. Passed as the _group's_
+`controlMaxWidth`, `FormControlLayout` applies it to the whole root row, so in side-by-side
+layout the group's own label got squeezed into that same 400px alongside the radios. There is
+no group-level max-width token in the schema — fixed by leaving `controlMaxWidth` `undefined`,
+matching `SwitchGroup`'s existing pattern. Same bug existed in `CheckboxGroup`, fixed the same
+way — see `Checkbox/CHECKBOX_IMPLEMENTATION_NOTES.md`.

package/src/components/Radio/RadioGroup.tsx

@@ -78,7 +78,11 @@ export const RadioGroup = forwardRef<HTMLDivElement, RadioGroupProps>(
       <WithReadOnlyWrapper
         className={className}
         style={style as React.CSSProperties}
-        controlMaxWidth="var(--recursica_ui-kit_components_radio-button-item_properties_max-width)"
+        // Not the group's own row width: this token caps a single radio+its own label (applied
+        // per-item in Radio.module.css's `.root`). The group has no max-width token of its own
+        // in the schema, so this must stay undefined or FormControlLayout caps the whole
+        // label+items row (including the group's own label) at 400px in side-by-side layout.
+        controlMaxWidth={undefined}
         controlMinWidth={undefined}
         overStyled={overStyled as true}
         labelElement="div" // Strictly override. ARIA grouping prohibits interactive radios nested natively inside <label>.

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;