@recursica/mui-adapter 0.32.1 → 0.34.0

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @recursica/mui-adapter
 
+## 0.34.0
+
+### Minor Changes
+
+- 2369301: Add optional `maxHeight` prop to Menu, overriding the token-driven dropdown max-height with an explicit pixel value.
+
+### Patch Changes
+
+- Updated dependencies [2369301]
+  - @recursica/adapter-common@0.25.0
+
+## 0.33.0
+
+### Minor Changes
+
+- bc70636: Add optional `leadingIcon`/`supportingText` fields to Autocomplete/Dropdown `data` items, rendered inside the option row by default. Add a `wrapItemText` prop (default `false`) to wrap label/supportingText instead of truncating with an ellipsis.
+
+### Patch Changes
+
+- bc70636: Fix Dropdown/Autocomplete selected-option background highlight. mantine-adapter was keying off `data-combobox-selected` (Mantine's transient keyboard-nav highlight) instead of `data-combobox-active` (the real "matches current value" attribute), so the highlight only showed while arrow-key navigating. mui-adapter's Autocomplete had no selected-state rule at all; now keys off MUI's own `aria-selected`.
+- Updated dependencies [bc70636]
+  - @recursica/adapter-common@0.24.0
+
 ## 0.32.1
 
 ### Patch Changes

package/dist/index.d.ts

@@ -892,6 +892,12 @@ declare const ModalTitle: default_2.ForwardRefExoticComponent<(Omit<Omit<WithRec
 
 declare type ModalTitleProps = RecursicaOverStyled<DialogTitleProps>;
 
+/**
+ * Backfills `label` (falling back to `value`) on every item, so downstream rendering can always
+ * read a real `label` string instead of re-deriving the same fallback at every call site.
+ */
+export declare function normalizeComboboxData(data: RecursicaComboboxData | undefined): (string | RecursicaComboboxItemWithLabel)[] | undefined;
+
 export declare const NumberInput: typeof rawComponents.NumberInput;
 
 declare const NumberInput_2: default_2.ForwardRefExoticComponent<(Omit<Omit<WithRecursicaSpacing<RecursicaNumberInputProps>, BlockedStylingKeys> & ForbiddenStyles & {
@@ -1473,7 +1479,7 @@ export declare interface RecursicaAutocompleteProps extends Omit<AutocompletePro
  */
 declare interface RecursicaAutocompleteProps_2 {
     /** Data options to show in the dropdown */
-    data?: unknown[];
+    data?: RecursicaComboboxData;
     /** Error message or toggle state */
     error?: boolean | default_2.ReactNode;
     /** Marks input as required */
@@ -1490,6 +1496,9 @@ declare interface RecursicaAutocompleteProps_2 {
     rightSection?: default_2.ReactNode;
     /** Placeholder text */
     placeholder?: string;
+    /** Wrap `label`/`supportingText` onto additional lines instead of truncating with an ellipsis.
+     * Defaults to `false` (single-line, truncated). */
+    wrapItemText?: boolean;
 }
 
 /**
@@ -1609,6 +1618,31 @@ export declare interface RecursicaChipProps {
     deleteIconRef?: default_2.Ref<HTMLSpanElement>;
 }
 
+/** `data` accepted by Autocomplete/Dropdown: a plain string, or a `RecursicaComboboxItem`. */
+export declare type RecursicaComboboxData = (string | RecursicaComboboxItem)[];
+
+/**
+ * A single item in Autocomplete/Dropdown's `data`. Shared between both components — and both
+ * adapters, via this package — since their item vocabulary is identical (see
+ * MANTINE_ADAPTER_RICH_OPTION_DATA.md at the repo root).
+ */
+export declare interface RecursicaComboboxItem {
+    value: string;
+    /** Displayed/matched text; falls back to `value` when omitted. */
+    label?: string;
+    disabled?: boolean;
+    /** Rendered before the label inside the option row. */
+    leadingIcon?: default_2.ReactNode;
+    /** Rendered as a secondary line under the label inside the option row. */
+    supportingText?: string;
+}
+
+/** Same shape as `RecursicaComboboxItem`, but with `label` guaranteed present — the result of
+ * `normalizeComboboxData` (see `../../utils/normalizeComboboxData`). */
+export declare interface RecursicaComboboxItemWithLabel extends RecursicaComboboxItem {
+    label: string;
+}
+
 /**
  * Union type of all Recursica components.
  */
@@ -1657,12 +1691,10 @@ export declare interface RecursicaDropdownProps extends Omit<SelectProps, keyof
 declare interface RecursicaDropdownProps_2 {
     /** Internal hook for Selects to override raw layout width properties */
     containerWidth?: default_2.CSSProperties["width"];
-    /** Data options array */
-    data?: (string | {
-        value: string;
-        label: default_2.ReactNode;
-        disabled?: boolean;
-    })[];
+    /** Data options array. `label` is matched against typed text and written into the input as the
+     * 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 */
@@ -1671,6 +1703,9 @@ declare interface RecursicaDropdownProps_2 {
     withAsterisk?: boolean;
     /** Placeholder text when value is empty */
     placeholder?: string;
+    /** Wrap `label`/`supportingText` onto additional lines instead of truncating with an ellipsis.
+     * Defaults to `false` (single-line, truncated). */
+    wrapItemText?: boolean;
 }
 
 /**
@@ -2084,6 +2119,12 @@ export declare interface RecursicaLoaderProps {
  * Props for the Recursica Menu component.
  */
 export declare interface RecursicaMenuProps {
+    /**
+     * Overrides the dropdown's token-driven max-height with an explicit pixel (or other CSS
+     * length) value. Escape hatch for callers that need an arbitrary menu height the design
+     * tokens don't express; leave unset to use the token default.
+     */
+    maxHeight?: default_2.CSSProperties["maxHeight"];
 }
 
 /**