@recursica/mui-adapter 0.39.0 → 0.39.2

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @recursica/mui-adapter
 
+## 0.39.2
+
+### Patch Changes
+
+- 46b123a: Breadcrumb now marks its last child `aria-current="page"` and, if it looks interactive (has `href`/`onClick`), strips both and drops it from the tab order — best-effort, not a guarantee for custom Link components with their own internal navigation. Backed by a CSS reset (no color/underline/pointer-events) and the current item now picks up Link's font-family. New shared `markCurrentPageItem` util in adapter-common. mui-adapter's story also gets parity with mantine-adapter's: the last crumb renders as plain text, not a `Link`.
+- 39de7b2: mui-adapter: Dropdown now renders its `placeholder` prop and gains a matching `.placeholder` style; Autocomplete's open menu now has the same input-to-menu gap as mantine; TimePicker's leading icon is no longer offset too far right.
+  mantine-adapter: DatePicker's read-only value is now formatted via `valueFormat` instead of a raw `Date.toString()`; TimePicker's leading icon no longer overlaps the field text.
+- 46b123a: Link now replaces the browser's native focus outline with the recursica focus ring (`--recursica_brand_states_focus_*`), matching Button/every other interactive component instead of falling back to the browser default. Fixes the same incorrect ring on Breadcrumb, since its items are typically Links.
+- 39de7b2: Fix Accordion chevron not rotating on expand, Modal centering instead of anchoring near top, and Toast showing a default icon it shouldn't. Add missing Accordion LayerOne story and exclude the intentional Grid span/size naming divergence from story parity. Fix NumberInput's default MUI focus ring/non-numeric input/icon spacing-color/height/border-radius, and TextArea's oversized autosize height.
+- 39de7b2: mui-adapter: Stepper's connector gap, description content, and button spacing now match mantine; Stepper vertical spacing now matches mantine; Timeline's connector now reaches the next bullet; Tree's chevron-to-label gap now uses the right token; Pagination is now fully wired up (circle size/colors/outline, chevron colors/hover, ripple removed, ellipsis centering, text labels).
+  mantine-adapter: Stepper's completed/current label and description colors now apply (were silently falling back to Mantine's own default gray/black).
+- 39de7b2: mui-adapter: Switch's read-only label and static-variations spacing now match mantine; Label's right-alignment and optional-text parentheses now work; Button's loading state shows only a centered loader (no label); Text's static-variations spacing matches mantine; Tabs' `inverted` variant now actually renders the tab list below the content.
+  mantine-adapter: Button's loader color now matches its label text color; Tabs' `inverted` variant now actually renders the tab list below the content; Grid gains a `ResponsiveSizes` story mirroring mui-adapter's.
+- Updated dependencies [46b123a]
+  - @recursica/adapter-common@0.28.2
+
+## 0.39.1
+
+### Patch Changes
+
+- a104e8a: Removed `searchable` from `Dropdown`'s shared contract — not a supported feature (that's `AutoComplete`'s job). mantine-adapter now strips it at runtime like its other unsupported native props; mui-adapter never wired it up.
+- a104e8a: Fixed `Panel`'s `wrapHeaderText` default (was `false`, contract documents `true`) in both adapters.
+- Updated dependencies [a104e8a]
+- Updated dependencies [a104e8a]
+  - @recursica/adapter-common@0.28.1
+
 ## 0.39.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -41,6 +41,7 @@ import { MenuProps as MenuProps_2 } from '@mui/material';
 import { PaginationProps as PaginationProps_2 } from '@mui/material';
 import { RadioGroupProps as RadioGroupProps_2 } from '@mui/material';
 import { RadioProps } from '@mui/material';
+import { ReactNode } from 'react';
 import { RefAttributes } from 'react';
 import { SelectProps } from '@mui/material';
 import { SliderProps } from '@mui/material';
@@ -275,6 +276,14 @@ export declare type BlockedStylingKeys = "className" | "classNames" | "classes"
 
 export declare const Breadcrumb: typeof rawComponents.Breadcrumb;
 
+/**
+ * The last child should always be plain, non-interactive text (e.g. a `<span>`) — it represents
+ * the current page and shouldn't be a link. Breadcrumb tries to correct for a Link/anchor passed
+ * there anyway via `markCurrentPageItem` (aria-current, stripped href/onClick, CSS reset in
+ * Breadcrumb.module.css), but that's a best-effort safety net, not a guarantee — it can't stop a
+ * custom Link component (e.g. a router Link) that navigates from its own internal handler. See
+ * BREADCRUMB_IMPLEMENTATION_NOTES.md.
+ */
 declare const Breadcrumb_2: ForwardRefExoticComponent<(Omit<Omit<WithRecursicaSpacing<Omit<BreadcrumbsProps, "variant" | "size"> & RecursicaBreadcrumbProps>, BlockedStylingKeys> & ForbiddenStyles & {
 overStyled?: false | undefined;
 }, "ref"> | Omit<Omit<Omit<BreadcrumbsProps, "variant" | "size"> & RecursicaBreadcrumbProps, "m" | "my" | "mx" | "mt" | "mb" | "ml" | "mr" | "gap" | "rowGap" | "columnGap" | "gutter" | "spacing"> & {
@@ -794,6 +803,18 @@ declare const Loader_2: default_2.ForwardRefExoticComponent<LoaderProps & defaul
 
 declare type LoaderProps = RecursicaOverStyled<default_2.HTMLAttributes<HTMLSpanElement> & RecursicaLoaderProps>;
 
+/**
+ * Marks the last Breadcrumb child as the current page: adds `aria-current="page"`, and — if the
+ * element looks interactive (has `href` or `onClick`) — strips those props and sets `tabIndex={-1}`
+ * so it drops out of the tab order.
+ *
+ * This is best-effort, not a guarantee. `cloneElement` can only override props the element
+ * actually reads. A custom Link component (e.g. React Router's) that drives navigation from its
+ * own internal handler rather than a passed-through `onClick` will keep navigating regardless.
+ * The last crumb should really just be plain text — see BREADCRUMB_IMPLEMENTATION_NOTES.md.
+ */
+export declare function markCurrentPageItem(children: ReactNode): ReactNode;
+
 export declare const Menu: typeof rawComponents.Menu;
 
 declare const Menu_2: ForwardRefExoticComponent<(Omit<Omit<WithRecursicaSpacing<MenuProps_2 & RecursicaMenuProps>, BlockedStylingKeys> & ForbiddenStyles & {
@@ -1108,7 +1129,7 @@ declare const Panel_2: PanelComponent;
  * - `Panel.Stack` — Stacked drawer context
  */
 declare const PanelBase: {
-    ({ overStyled, placement, keepMounted, wrapHeaderText, opened, ...rest }: PanelProps): JSX.Element;
+    ({ overStyled, placement, keepMounted, wrapHeaderText, opened, title, withOverlay, withCloseButton, onClose, children, ...rest }: PanelProps): JSX.Element;
     displayName: string;
 };
 
@@ -1525,8 +1546,11 @@ export declare interface RecursicaAccordionItemProps {
     leftIcon?: default_2.ReactNode;
     /** Toggle visibility of the divider below the item */
     divider?: boolean;
-    /** Unique value identifier for this item */
-    value?: string;
+    /** Unique value identifier for this item. Required — omitting it on multiple items collapses
+     * them to the same identity and they toggle together (see beam-adapter's
+     * docs/OPEN_DECISIONS.md #23b). Was optional in the type until 2026-08-29 even though every
+     * real consumer already supplied it. */
+    value: string;
     /** Disables interaction with this item — it can't be expanded or collapsed, and is dimmed */
     disabled?: boolean;
 }
@@ -1801,8 +1825,6 @@ declare interface RecursicaDropdownProps_2 {
      * selected display text — stays a real string (a whole subtree can't be matched/written),
      * unlike the `ReactNode` this was previously typed as. Falls back to `value` when omitted. */
     data?: RecursicaComboboxData;
-    /** Enable autocomplete search functionality */
-    searchable?: boolean;
     /** Show input clear option button */
     clearable?: boolean;
     /** Marks field with visual asterisk */
@@ -2009,8 +2031,9 @@ declare interface RecursicaFileUploadProps_2 extends Omit<default_2.HTMLAttribut
 export declare interface RecursicaFormControlLayoutProps {
     /** Layout structure direction */
     formLayout?: "stacked" | "side-by-side";
-    /** Label sizing constraint */
-    labelSize?: "small" | "default" | "md";
+    /** Label sizing constraint. Only `small`/`default` are defined by Recursica's Label tokens —
+     * `md` was never a real design size and has been removed. */
+    labelSize?: "small" | "default";
     /** Optional left section element (usually Label) */
     leftSection?: default_2.ReactNode;
     /** Main wrapper bounding maximum width */
@@ -2089,8 +2112,10 @@ export declare interface RecursicaHoverCardProps {
  * Base properties for Recursica label indicators.
  */
 export declare interface RecursicaLabelProps {
-    /** Specifies the sizing metrics natively mapping the Label boundaries. */
-    labelSize?: "default" | "small" | "md";
+    /** Specifies the sizing metrics natively mapping the Label boundaries. Only `default`/`small`
+     * are defined by Recursica's Label tokens — `md` was never a real design size (no adapter had
+     * a width rule for it) and has been removed; see docs/OPEN_DECISIONS.md #41 in beam-adapter. */
+    labelSize?: "default" | "small";
     /**
      * Overall alignment directive for the label strings natively forcing Left/Right justification.
      * Not renamed to Forge's `labelAlign`: our own vocabulary, not either kit's native term.
@@ -2183,7 +2208,7 @@ export declare interface RecursicaModalProps {
     title?: default_2.ReactNode;
 }
 
-export declare interface RecursicaNumberInputProps extends Omit<TextFieldProps, "size" | "variant" | "radius" | "wrapperProps" | "classNames" | "styles">, Pick<RecursicaFormControlWrapperProps, "assistiveText" | "assistiveWithIcon" | "formLayout" | "labelSize" | "labelAlignment" | "labelOptionalText" | "labelWithEditIcon" | "onLabelEditClick">, ReadOnlyControlProps, RecursicaNumberInputProps_2 {
+export declare interface RecursicaNumberInputProps extends Omit<InputBaseProps, "color" | "size" | "startAdornment" | "endAdornment" | "autoComplete" | "error">, Pick<RecursicaFormControlWrapperProps, "label" | "error" | "required" | "id" | "assistiveText" | "assistiveWithIcon" | "formLayout" | "labelSize" | "labelAlignment" | "labelOptionalText" | "labelWithEditIcon" | "onLabelEditClick">, ReadOnlyControlProps, RecursicaNumberInputProps_2 {
 }
 
 /**
@@ -2246,7 +2271,13 @@ export declare interface RecursicaPanelProps {
 /**
  * Recursica Panel root props. Extends Mui Drawer.
  */
-declare interface RecursicaPanelProps_2 extends Omit<DrawerProps, "classes" | "position" | "style" | "anchor" | "open">, RecursicaPanelProps {
+declare interface RecursicaPanelProps_2 extends Omit<DrawerProps, "classes" | "position" | "style" | "anchor" | "open" | "title">, RecursicaPanelProps {
+    /** Panel header title label. */
+    title?: ReactNode;
+    /** Whether to display a background overlay. Default true. */
+    withOverlay?: boolean;
+    /** Whether to display the close button in the header. Default true. */
+    withCloseButton?: boolean;
 }
 
 /**