@recursica/mantine-adapter 0.48.1 → 0.49.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @recursica/mantine-adapter
 
+## 0.49.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.48.1
 
 ### Patch Changes

package/dist/index.d.ts

@@ -1073,6 +1073,12 @@ declare const ModalTitle: default_2.ForwardRefExoticComponent<ModalTitleProps &
 
 declare type ModalTitleProps = RecursicaOverStyled<ModalTitleProps_2>;
 
+/**
+ * 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<NumberInputProps_2 & default_2.RefAttributes<HTMLInputElement>>;
@@ -1730,7 +1736,7 @@ declare interface RecursicaAutoCompleteProps extends Omit<AutocompleteProps, "si
  */
 export declare interface RecursicaAutocompleteProps {
     /** 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 */
@@ -1747,6 +1753,9 @@ export declare interface RecursicaAutocompleteProps {
     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;
 }
 
 /**
@@ -1865,6 +1874,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.
  */
@@ -1900,12 +1934,10 @@ export declare interface RecursicaDropdownProps extends Omit<SelectProps, "size"
 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 */
@@ -1914,6 +1946,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;
 }
 
 /**