@carto/meridian-ds 1.5.0-alpha-virtual-autocomplete.1 → 1.5.0-alpha-virtual-autocomplete.3

package/dist/types/components/molecules/Autocomplete/types.d.ts

@@ -1,25 +1,8 @@
 import { ChipTypeMap, AutocompleteProps as MUIAutocompleteProps } from '@mui/material';
 import { MenuItemProps } from '../Menu/MenuItem';
+import { HTMLAttributes } from 'react';
 type BaseAutocompleteProps<Value, Multiple extends boolean | undefined = undefined, DisableClearable extends boolean | undefined = undefined, FreeSolo extends boolean | undefined = undefined, ChipComponent extends React.ElementType = ChipTypeMap['defaultComponent']> = Omit<MUIAutocompleteProps<Value, Multiple, DisableClearable, FreeSolo, ChipComponent>, 'ref'> & {
     loading?: boolean;
-};
-export type AutocompleteProps<Value, Multiple extends boolean | undefined = false, DisableClearable extends boolean | undefined = undefined, FreeSolo extends boolean | undefined = undefined, ChipComponent extends React.ElementType = ChipTypeMap['defaultComponent']> = Omit<BaseAutocompleteProps<Value, Multiple, DisableClearable, FreeSolo, ChipComponent>, 'multiple'>;
-export type MultipleAutocompleteProps<Value, Multiple extends boolean | undefined = true, DisableClearable extends boolean | undefined = undefined, FreeSolo extends boolean | undefined = undefined, ChipComponent extends React.ElementType = ChipTypeMap['defaultComponent']> = BaseAutocompleteProps<Value, Multiple, DisableClearable, FreeSolo, ChipComponent> & {
-    /**
-     * If true, the popup will display a filter option for multiple selection.
-     * @default false
-     */
-    showFilters?: boolean;
-    /**
-     * If true, the menu will not close when an option is selected.
-     * @default true
-     */
-    disableCloseOnSelect?: boolean;
-    /**
-     * If true, displays a counter (e.g., "3 items selected") instead of individual tags.
-     * @default false
-     */
-    showCounter?: boolean;
     /**
      * Height of each item in pixels when virtualized.
      * @default 32
@@ -35,16 +18,30 @@ export type MultipleAutocompleteProps<Value, Multiple extends boolean | undefine
      * @default false
      */
     extended?: boolean;
-};
-export type CreatableAutocompleteProps<Value, Multiple extends boolean | undefined = undefined, DisableClearable extends boolean | undefined = undefined, FreeSolo extends boolean | undefined = undefined, ChipComponent extends React.ElementType = ChipTypeMap['defaultComponent']> = BaseAutocompleteProps<Value, Multiple, DisableClearable, FreeSolo, ChipComponent> & {
-    /**
-     * Text for "create new item" option. String (used directly), function (for custom formatting), or undefined (uses translated "Add" text).
-     */
-    newItemLabel?: string | ((value: string) => React.ReactNode);
     /**
-     * Icon to display next to the "Create new item" option.
+     * @deprecated since v1.6.0 - This prop breaks virtualization.
+     * Use createAutocompleteGroupByList instead to create a flat list with group headers:
+     *
+     * @example
+     * ```tsx
+     * import { createAutocompleteGroupByList } from "@carto/meridian-ds"
+     *
+     * const groupedOptions = createAutocompleteGroupByList(
+     *   rawOptions,
+     *   (option) => option.category
+     * )
+     *
+     * <MultipleAutocomplete
+     *   options={groupedOptions}
+     *   // ... other props
+     * />
+     * ```
+     *
+     * This approach maintains virtualization performance while providing proper grouping.
      */
-    newItemIcon?: React.ReactNode;
+    groupBy?: (option: Value) => string;
+};
+type BaseMultipleAutocompleteProps<Value, Multiple extends boolean | undefined = true, DisableClearable extends boolean | undefined = undefined, FreeSolo extends boolean | undefined = undefined, ChipComponent extends React.ElementType = ChipTypeMap['defaultComponent']> = BaseAutocompleteProps<Value, Multiple, DisableClearable, FreeSolo, ChipComponent> & {
     /**
      * If true, the popup will display a filter option for multiple selection.
      * @default false
@@ -55,32 +52,52 @@ export type CreatableAutocompleteProps<Value, Multiple extends boolean | undefin
      * @default true
      */
     disableCloseOnSelect?: boolean;
-    /**
-     * If true, the input accepts multiple values. The default is `false`.
-     * @default false
-     */
-    multiple?: Multiple;
     /**
      * If true, displays a counter (e.g., "3 items selected") instead of individual tags.
-     * Only applies when multiple is true.
      * @default false
      */
     showCounter?: boolean;
     /**
-     * Height of each item in pixels when virtualized.
-     * @default 32
+     * Custom formatter function for counter tags. Takes precedence over counterText/allSelectedText.
+     * If not provided, will use counterText and allSelectedText to create a simple formatter.
+     * Only applies when showCounter is true.
      */
-    itemHeight?: number;
+    counterFormatter?: (params: {
+        selectedCount: number;
+        totalCount: number;
+        selectedItems: readonly unknown[];
+        allItems: readonly unknown[];
+        getOptionLabel: (option: unknown) => string;
+    }) => string;
     /**
-     * Maximum height of the listbox in pixels when virtualized.
-     * @default 312
+     * Text to display with the counter (e.g., "selected", "chosen").
+     * Only used if counterFormatter is not provided and showCounter is true.
+     * @default "selected"
      */
-    maxListHeight?: number;
+    counterText?: string;
     /**
-     * If true, uses larger item height (48px) for extended menu items.
+     * Text to display when all items are selected (e.g., "All selected", "All chosen").
+     * Only used if counterFormatter is not provided and showCounter is true.
+     * @default "All selected"
+     */
+    allSelectedText?: string;
+};
+export type AutocompleteProps<Value, Multiple extends boolean | undefined = false, DisableClearable extends boolean | undefined = undefined, FreeSolo extends boolean | undefined = undefined, ChipComponent extends React.ElementType = ChipTypeMap['defaultComponent']> = Omit<BaseAutocompleteProps<Value, Multiple, DisableClearable, FreeSolo, ChipComponent>, 'multiple'>;
+export type MultipleAutocompleteProps<Value, Multiple extends boolean | undefined = true, DisableClearable extends boolean | undefined = undefined, FreeSolo extends boolean | undefined = undefined, ChipComponent extends React.ElementType = ChipTypeMap['defaultComponent']> = BaseAutocompleteProps<Value, Multiple, DisableClearable, FreeSolo, ChipComponent> & BaseMultipleAutocompleteProps<Value, Multiple, DisableClearable, FreeSolo, ChipComponent>;
+export type CreatableAutocompleteProps<Value, Multiple extends boolean | undefined = undefined, DisableClearable extends boolean | undefined = undefined, FreeSolo extends boolean | undefined = undefined, ChipComponent extends React.ElementType = ChipTypeMap['defaultComponent']> = BaseMultipleAutocompleteProps<Value, Multiple, DisableClearable, FreeSolo, ChipComponent> & {
+    /**
+     * Text for "create new item" option. String (used directly), function (for custom formatting), or undefined (uses translated "Add" text).
+     */
+    newItemLabel?: string | ((value: string) => React.ReactNode);
+    /**
+     * Icon to display next to the "Create new item" option.
+     */
+    newItemIcon?: React.ReactNode;
+    /**
+     * If true, the input accepts multiple values. The default is `false`.
      * @default false
      */
-    extended?: boolean;
+    multiple?: Multiple;
 };
 export type CreatableValueProps = {
     inputValue: string;
@@ -96,5 +113,21 @@ export type AutocompleteRenderOptionProps = Pick<MenuItemProps, 'dense' | 'disab
     secondaryText?: string;
     multiple?: boolean;
 };
+export type AutocompleteListProps = HTMLAttributes<HTMLElement> & {
+    showFilters?: boolean;
+    allSelected?: boolean;
+    someSelected?: boolean;
+    handleSelectAll?: () => void;
+    multiple?: boolean;
+    extended?: boolean;
+    /**
+     * Height of each item in pixels
+     */
+    itemHeight?: number;
+    /**
+     * Maximum height of the listbox in pixels
+     */
+    maxListHeight?: number;
+};
 export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/types/components/molecules/Autocomplete/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/components/molecules/Autocomplete/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/components/molecules/Autocomplete/types.ts"],"names":[],"mappings":"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"}

package/dist/types/components/molecules/Autocomplete/useAutocomplete.d.ts

@@ -0,0 +1,11 @@
+type UseAutocompleteProps<Value> = {
+    getOptionLabel?: (option: Value) => string;
+};
+export default function useAutocomplete<Value>({ getOptionLabel, }: UseAutocompleteProps<Value>): {
+    singleRenderOption: (props: React.HTMLAttributes<HTMLLIElement>, option: Value, state: {
+        selected: boolean;
+    }) => import("react/jsx-runtime").JSX.Element;
+    getOptionLabel: (option: Value) => string;
+};
+export {};
+//# sourceMappingURL=useAutocomplete.d.ts.map

package/dist/types/components/molecules/Autocomplete/useAutocomplete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAutocomplete.d.ts","sourceRoot":"","sources":["../../../../../src/components/molecules/Autocomplete/useAutocomplete.tsx"],"names":[],"mappings":"AAGA,KAAK,oBAAoB,CAAC,KAAK,IAAI;IACjC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,KAAK,MAAM,CAAA;CAC3C,CAAA;AAED,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,KAAK,EAAE,EAC7C,cAAsC,GACvC,EAAE,oBAAoB,CAAC,KAAK,CAAC;gCAmBnB,KAAK,CAAC,cAAc,CAAC,aAAa,CAAC,UAClC,KAAK,SACN;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE;6BAhBU,KAAK;EAgC9C"}

package/dist/types/components/molecules/Autocomplete/useAutocompleteRenderOption.d.ts

@@ -1,9 +1,14 @@
 import { HTMLAttributes, Key, ReactNode } from 'react';
+type GroupHeaderOption = {
+    __isGroupHeader: true;
+    title: string;
+};
 export default function useAutocompleteRenderOption<Value>(): {
     renderOption: (props: HTMLAttributes<HTMLLIElement> & {
         key?: Key;
-    }, option: Value, state: {
+    }, option: Value | GroupHeaderOption, state: {
         selected: boolean;
     }, getOptionLabel?: (option: Value) => string, customIcon?: ReactNode) => import("react/jsx-runtime").JSX.Element;
 };
+export {};
 //# sourceMappingURL=useAutocompleteRenderOption.d.ts.map

package/dist/types/components/molecules/Autocomplete/useAutocompleteRenderOption.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAutocompleteRenderOption.d.ts","sourceRoot":"","sources":["../../../../../src/components/molecules/Autocomplete/useAutocompleteRenderOption.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAY,cAAc,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAQhE,MAAM,CAAC,OAAO,UAAU,2BAA2B,CAAC,KAAK;0BAE9C,cAAc,CAAC,aAAa,CAAC,GAAG;QAAE,GAAG,CAAC,EAAE,GAAG,CAAA;KAAE,UAC5C,KAAK,SACN;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,mBACX,CAAC,MAAM,EAAE,KAAK,KAAK,MAAM,eAC7B,SAAS;EAmGzB"}
+{"version":3,"file":"useAutocompleteRenderOption.d.ts","sourceRoot":"","sources":["../../../../../src/components/molecules/Autocomplete/useAutocompleteRenderOption.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAY,cAAc,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAQhE,KAAK,iBAAiB,GAAG;IAAE,eAAe,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjE,MAAM,CAAC,OAAO,UAAU,2BAA2B,CAAC,KAAK;0BAE9C,cAAc,CAAC,aAAa,CAAC,GAAG;QAAE,GAAG,CAAC,EAAE,GAAG,CAAA;KAAE,UAC5C,KAAK,GAAG,iBAAiB,SAC1B;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,mBACX,CAAC,MAAM,EAAE,KAAK,KAAK,MAAM,eAC7B,SAAS;EAyHzB"}

package/dist/types/components/molecules/Autocomplete/useMultipleAutocomplete.d.ts

@@ -6,8 +6,31 @@ type UseMultipleAutocompleteProps<Value, Multiple extends boolean | undefined =
     onChange?: (event: SyntheticEvent, value: AutocompleteValue<Value, Multiple, DisableClearable, FreeSolo>, reason: AutocompleteChangeReason, details?: AutocompleteChangeDetails<Value>) => void;
     getOptionLabel?: (option: Value) => string;
     size?: 'small' | 'medium';
+    /**
+     * Custom formatter function for counter tags. Takes precedence over counterText/allSelectedText.
+     * If not provided, will use counterText and allSelectedText to create a simple formatter.
+     */
+    counterFormatter?: (params: {
+        selectedCount: number;
+        totalCount: number;
+        selectedItems: readonly unknown[];
+        allItems: readonly unknown[];
+        getOptionLabel: (option: unknown) => string;
+    }) => string;
+    /**
+     * Text to display with the counter (e.g., "selected", "chosen").
+     * Only used if counterFormatter is not provided.
+     * @default Localized string from 'c4r.form.selected'
+     */
+    counterText?: string;
+    /**
+     * Text to display when all items are selected (e.g., "All selected", "All chosen").
+     * Only used if counterFormatter is not provided.
+     * @default Localized string from 'c4r.form.allSelected'
+     */
+    allSelectedText?: string;
 };
-export default function useMultipleAutocomplete<Value, Multiple extends boolean | undefined = undefined, DisableClearable extends boolean | undefined = undefined, FreeSolo extends boolean | undefined = undefined>({ options, value, onChange, getOptionLabel, size, }: UseMultipleAutocompleteProps<Value, Multiple, DisableClearable, FreeSolo>): {
+export default function useMultipleAutocomplete<Value, Multiple extends boolean | undefined = undefined, DisableClearable extends boolean | undefined = undefined, FreeSolo extends boolean | undefined = undefined>({ options, value, onChange, getOptionLabel, size, counterFormatter, counterText, allSelectedText, }: UseMultipleAutocompleteProps<Value, Multiple, DisableClearable, FreeSolo>): {
     multipleValue: AutocompleteValue<Value, Multiple, DisableClearable, FreeSolo>;
     allSelected: boolean;
     someSelected: boolean;

package/dist/types/components/molecules/Autocomplete/useMultipleAutocomplete.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useMultipleAutocomplete.d.ts","sourceRoot":"","sources":["../../../../../src/components/molecules/Autocomplete/useMultipleAutocomplete.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAuB,MAAM,OAAO,CAAA;AAC3D,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,eAAe,CAAA;AAKtB,KAAK,4BAA4B,CAC/B,KAAK,EACL,QAAQ,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,EAChD,gBAAgB,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,EACxD,QAAQ,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,IAC9C;IACF,OAAO,EAAE,SAAS,KAAK,EAAE,CAAA;IACzB,KAAK,CAAC,EAAE,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAA;IACtE,QAAQ,CAAC,EAAE,CACT,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,CAAC,EACrE,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,yBAAyB,CAAC,KAAK,CAAC,KACvC,IAAI,CAAA;IACT,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,KAAK,MAAM,CAAA;IAC1C,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;CAC1B,CAAA;AAED,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAC7C,KAAK,EACL,QAAQ,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,EAChD,gBAAgB,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,EACxD,QAAQ,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,EAChD,EACA,OAAO,EACP,KAAK,EACL,QAAQ,EACR,cAAc,EACd,IAAI,GACL,EAAE,4BAA4B,CAAC,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,CAAC;mBA6ExC,iBAAiB,CAC/C,KAAK,EACL,QAAQ,EACR,gBAAgB,EAChB,QAAQ,CACT;;;6BA5D6B,cAAc;0BAkBrC,cAAc,YACX,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,CAAC,UAChE,wBAAwB;kCASzB,KAAK,CAAC,cAAc,CAAC,aAAa,CAAC,UAClC,KAAK,SACN;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE;;EAqC/B"}
+{"version":3,"file":"useMultipleAutocomplete.d.ts","sourceRoot":"","sources":["../../../../../src/components/molecules/Autocomplete/useMultipleAutocomplete.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAuB,MAAM,OAAO,CAAA;AAC3D,OAAO,EACL,iBAAiB,EACjB,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,eAAe,CAAA;AAWtB,KAAK,4BAA4B,CAC/B,KAAK,EACL,QAAQ,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,EAChD,gBAAgB,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,EACxD,QAAQ,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,IAC9C;IACF,OAAO,EAAE,SAAS,KAAK,EAAE,CAAA;IACzB,KAAK,CAAC,EAAE,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,CAAC,CAAA;IACtE,QAAQ,CAAC,EAAE,CACT,KAAK,EAAE,cAAc,EACrB,KAAK,EAAE,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,CAAC,EACrE,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,yBAAyB,CAAC,KAAK,CAAC,KACvC,IAAI,CAAA;IACT,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,KAAK,MAAM,CAAA;IAC1C,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAA;IACzB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE;QAC1B,aAAa,EAAE,MAAM,CAAA;QACrB,UAAU,EAAE,MAAM,CAAA;QAClB,aAAa,EAAE,SAAS,OAAO,EAAE,CAAA;QACjC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;QAC5B,cAAc,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAA;KAC5C,KAAK,MAAM,CAAA;IACZ;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAC7C,KAAK,EACL,QAAQ,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,EAChD,gBAAgB,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,EACxD,QAAQ,SAAS,OAAO,GAAG,SAAS,GAAG,SAAS,EAChD,EACA,OAAO,EACP,KAAK,EACL,QAAQ,EACR,cAAc,EACd,IAAI,EACJ,gBAAgB,EAChB,WAAW,EACX,eAAe,GAChB,EAAE,4BAA4B,CAAC,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,CAAC;mBA2FxC,iBAAiB,CAC/C,KAAK,EACL,QAAQ,EACR,gBAAgB,EAChB,QAAQ,CACT;;;6BAjE6B,cAAc;0BAkBrC,cAAc,YACX,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,CAAC,UAChE,wBAAwB;kCASzB,KAAK,CAAC,cAAc,CAAC,aAAa,CAAC,UAClC,KAAK,SACN;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE;;EA0C/B"}

package/dist/types/components/molecules/Autocomplete/utils.d.ts

@@ -3,11 +3,66 @@ export declare const createOptionWithMultiple: <Value>(option: Value, multiple:
 export declare const getDefaultLimitTagsText: (more: number) => import("react/jsx-runtime").JSX.Element;
 /**
  * Creates a renderTags function that displays a counter instead of individual tags
- * @param counterText - Text to display with the counter (e.g., "selected")
+ * @param formatCounter - Function that receives selection state and returns the display text
  * @param options - Array of all available options to determine total count
  * @param size - Size variant for typography ('small' or 'medium')
  * @param getOptionLabel - Function to get the label for an option
- * @returns renderTags function that shows "X items selected", "All selected", or the item text for single selection
+ * @returns renderTags function that shows custom formatted text based on selection state
+ */
+export declare function createCounterRenderTags(formatCounter: (params: {
+    selectedCount: number;
+    totalCount: number;
+    selectedItems: readonly unknown[];
+    allItems: readonly unknown[];
+    getOptionLabel: (option: unknown) => string;
+}) => string, options?: readonly unknown[], size?: 'small' | 'medium', getOptionLabel?: (option: unknown) => string): (value: readonly unknown[]) => import("react/jsx-runtime").JSX.Element | null;
+/**
+ * Helper function that creates a simple counter formatter
+ * @param counterText - Text to display with the counter (e.g., "selected")
+ * @param allText - Text to display when all items are selected (e.g., "All selected")
+ * @param showSingleItemText - Whether to show the actual item text for single selection
+ * @returns A formatter function that can be used with createCounterRenderTags
+ *
+ * @example
+ * // Basic usage with custom text
+ * const formatter = createCounterFormatter('items', 'All items')
+ * const renderTags = createCounterRenderTags(formatter, options)
+ *
+ * @example
+ * // I18N-friendly usage
+ * const formatter = createCounterFormatter(
+ *   intl.formatMessage({ id: 'autocomplete.selected' }),
+ *   intl.formatMessage({ id: 'autocomplete.allSelected' })
+ * )
+ * const renderTags = createCounterRenderTags(formatter, options)
+ *
+ * @example
+ * // Using with useMultipleAutocomplete hook
+ * const { getCounterRenderTags } = useMultipleAutocomplete({
+ *   options,
+ *   counterText: intl.formatMessage({ id: 'autocomplete.selected' }),
+ *   allSelectedText: intl.formatMessage({ id: 'autocomplete.allSelected' })
+ * })
+ */
+export declare function createCounterFormatter(counterText: string, allText: string, showSingleItemText?: boolean): ({ selectedCount, totalCount, selectedItems, getOptionLabel, }: {
+    selectedCount: number;
+    totalCount: number;
+    selectedItems: readonly unknown[];
+    getOptionLabel: (option: unknown) => string;
+}) => string;
+/**
+ * Creates a grouped options list with group headers for direct use in autocomplete options
+ * @param options - Array of options to group
+ * @param groupBy - Function that returns the group key for each option
+ * @returns Flat array with group headers and options ready for autocomplete
+ */
+export declare function createAutocompleteGroupByList<T>(options: T[], groupBy: (option: T) => string): (T | {
+    __isGroupHeader: true;
+    title: string;
+})[];
+/**
+ * Shows a runtime warning for deprecated groupBy prop usage
+ * @param componentName - Name of the component (e.g., 'Autocomplete', 'MultipleAutocomplete')
  */
-export declare function createCounterRenderTags(counterText?: string, options?: readonly unknown[], size?: 'small' | 'medium', getOptionLabel?: (option: unknown) => string): (value: readonly unknown[]) => import("react/jsx-runtime").JSX.Element | null;
+export declare function warnDeprecatedGroupBy(componentName: string): void;
 //# sourceMappingURL=utils.d.ts.map

package/dist/types/components/molecules/Autocomplete/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/molecules/Autocomplete/utils.tsx"],"names":[],"mappings":"AAGA,eAAO,MAAM,qBAAqB,GAAI,KAAK,UAAW,KAAK,KAAG,MAI7D,CAAA;AAGD,eAAO,MAAM,wBAAwB,GAAI,KAAK,UACpC,KAAK,YACH,OAAO,KAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAIxB,CAAA;AAGD,eAAO,MAAM,uBAAuB,SAAU,MAAM,4CAEnD,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,SAAa,EACxB,OAAO,GAAE,SAAS,OAAO,EAAO,EAChC,IAAI,GAAE,OAAO,GAAG,QAAkB,EAClC,cAAc,GAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAA8B,WAEjC,SAAS,OAAO,EAAE,oDAkCrD"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/molecules/Autocomplete/utils.tsx"],"names":[],"mappings":"AAIA,eAAO,MAAM,qBAAqB,GAAI,KAAK,UAAW,KAAK,KAAG,MAI7D,CAAA;AAGD,eAAO,MAAM,wBAAwB,GAAI,KAAK,UACpC,KAAK,YACH,OAAO,KAChB,MAAM,CAAC,MAAM,EAAE,OAAO,CAIxB,CAAA;AAGD,eAAO,MAAM,uBAAuB,SAAU,MAAM,4CAEnD,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,CAAC,MAAM,EAAE;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,SAAS,OAAO,EAAE,CAAA;IACjC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAA;IAC5B,cAAc,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAA;CAC5C,KAAK,MAAM,EACZ,OAAO,GAAE,SAAS,OAAO,EAAO,EAChC,IAAI,GAAE,OAAO,GAAG,QAAkB,EAClC,cAAc,GAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAA8B,WAEjC,SAAS,OAAO,EAAE,oDA+BrD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,kBAAkB,UAAO,mEAOtB;IACD,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,SAAS,OAAO,EAAE,CAAA;IACjC,cAAc,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAA;CAC5C,YASF;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,CAAC,EAC7C,OAAO,EAAE,CAAC,EAAE,EACZ,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,GAC7B,CAAC,CAAC,GAAG;IAAE,eAAe,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EAAE,CA+BlD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAejE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carto/meridian-ds",
-  "version": "1.5.0-alpha-virtual-autocomplete.1",
+  "version": "1.5.0-alpha-virtual-autocomplete.3",
   "description": "CARTO Meridian Design System",
   "type": "module",
   "scripts": {

package/dist/types/components/molecules/Autocomplete/ListBoxWithFilter.d.ts

@@ -1,35 +0,0 @@
-import { HTMLAttributes } from 'react';
-export type ListboxWithFilterProps = HTMLAttributes<HTMLElement> & {
-    showFilters?: boolean;
-    allSelected?: boolean;
-    someSelected?: boolean;
-    handleSelectAll?: () => void;
-    multiple?: boolean;
-    extended?: boolean;
-    /**
-     * Height of each item in pixels
-     */
-    itemHeight?: number;
-    /**
-     * Maximum height of the listbox in pixels
-     */
-    maxListHeight?: number;
-};
-declare const ListboxWithFilter: import('react').ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & {
-    showFilters?: boolean;
-    allSelected?: boolean;
-    someSelected?: boolean;
-    handleSelectAll?: () => void;
-    multiple?: boolean;
-    extended?: boolean;
-    /**
-     * Height of each item in pixels
-     */
-    itemHeight?: number;
-    /**
-     * Maximum height of the listbox in pixels
-     */
-    maxListHeight?: number;
-} & import('react').RefAttributes<HTMLUListElement>>;
-export default ListboxWithFilter;
-//# sourceMappingURL=ListBoxWithFilter.d.ts.map

package/dist/types/components/molecules/Autocomplete/ListBoxWithFilter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ListBoxWithFilter.d.ts","sourceRoot":"","sources":["../../../../../src/components/molecules/Autocomplete/ListBoxWithFilter.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA4B,cAAc,EAAW,MAAM,OAAO,CAAA;AAUzE,MAAM,MAAM,sBAAsB,GAAG,cAAc,CAAC,WAAW,CAAC,GAAG;IACjE,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,IAAI,CAAA;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB,CAAA;AA2FD,QAAA,MAAM,iBAAiB;kBAzGP,OAAO;kBACP,OAAO;mBACN,OAAO;sBACJ,MAAM,IAAI;eACjB,OAAO;eACP,OAAO;IAClB;;OAEG;iBACU,MAAM;IACnB;;OAEG;oBACa,MAAM;oDA4FgC,CAAA;AACxD,eAAe,iBAAiB,CAAA"}