pixelize-design-library 2.4.2-beta.64 → 2.4.2-beta.66

package/dist/Components/Select/SelectPopup.js

@@ -58,6 +58,7 @@ const FieldMessage_1 = __importDefault(require("../Common/FieldMessage"));
 const useExclusiveOverlay_1 = require("../../Hooks/useExclusiveOverlay");
 const FormLabel_1 = require("../Common/FormLabel");
 const Tag_1 = __importDefault(require("../Tag/Tag"));
+const groupedWindow_1 = require("./groupedWindow");
 const ROW_TRANSITION = (0, motion_1.transitionFor)(["background-color", "color"]);
 const CHEVRON_TRANSITION = (0, motion_1.transitionFor)(["transform"], "base");
 const PAGE_STEP = 8;
@@ -65,6 +66,13 @@ const LOAD_MORE_THRESHOLD_PX = 8;
 const DEFAULT_MAX_VISIBLE_CHIPS = 6;
 const VIRTUAL_OVERSCAN = 4;
 const DECORATIVE_CHECKBOX_SX = { "& input": { visibility: "hidden" } };
+const GROUP_HEADER_ESTIMATE_PX = 29;
+const LIST_PADDING_PX = 4;
+const NO_ROW = -1;
+const SELECT_ALL_ROW = -2;
+const CREATE_ROW = -3;
+const FOOTER_ROW = -4;
+const truncateLabel = (label, max) => max !== undefined && label.length > max ? `${label.slice(0, max)}…` : label;
 const asIdSet = (values) => new Set((values !== null && values !== void 0 ? values : []).map((v) => v.toString()));
 /** Regression-guarded id scheme — tickets e2e (`e2e/tests/helpers/selectV2.ts`) resolves it verbatim. */
 const optionDomId = (listboxId, id) => `${listboxId}-option-${id.toString().replace(/[^a-zA-Z0-9_-]/g, "-")}`;
@@ -76,23 +84,10 @@ const OptionRow = react_1.default.memo(function OptionRow({ option, index, listb
     const isSingleSelected = isSelected && !isMulti;
     return ((0, jsx_runtime_1.jsxs)(react_2.Box, { id: optionDomId(listboxId, option.id), "data-index": index, role: "option", "aria-selected": isSelected, "aria-disabled": option.isDisabled, onMouseEnter: () => onActivate(index), onClick: () => onSelect(option), mx: spec.mx, px: spec.px, py: spec.py, minH: spec.minH, borderRadius: "md", cursor: option.isDisabled ? "not-allowed" : "pointer", opacity: option.isDisabled ? 0.4 : 1, display: "flex", alignItems: "center", gap: spec.gap, fontSize: spec.fontSize, fontWeight: (0, optionRowInk_1.optionRowWeight)(isSingleSelected), color: (0, optionRowInk_1.optionRowInk)(theme.colors, isSingleSelected), bg: (0, optionRowInk_1.optionRowFill)(backgrounds, isActive), transition: ROW_TRANSITION, sx: (0, motion_2.reducedMotionSx)(), children: [isMulti ? ((0, jsx_runtime_1.jsx)(react_2.Checkbox, { id: `${optionDomId(listboxId, option.id)}-checkbox`, isChecked: isSelected, isDisabled: option.isDisabled, pointerEvents: "none", tabIndex: -1, sx: DECORATIVE_CHECKBOX_SX })) : null, renderOption ? ((0, jsx_runtime_1.jsx)(react_2.Box, { flex: 1, minW: 0, children: renderOption(option, { isSelected, isActive }) })) : ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [option.icon ? ((0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", display: "inline-flex", flexShrink: 0, children: option.icon })) : null, (0, jsx_runtime_1.jsxs)(react_2.Box, { flex: 1, minW: 0, isTruncated: true, children: [(0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", isTruncated: true, children: option.label }), option.description ? ((0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", display: "block", fontSize: spec.descriptionFontSize, color: (0, optionRowInk_1.optionRowDescriptionInk)(theme.colors), isTruncated: true, children: option.description })) : null] })] })), isSingleSelected ? ((0, jsx_runtime_1.jsx)(react_2.Box, { as: lucide_react_1.Check, size: spec.iconSize, color: theme.colors.accentText, flexShrink: 0 })) : null] }));
 });
-const buildGroupedRows = (options) => {
-    const rows = [];
-    let currentGroup;
-    options.forEach((option, index) => {
-        if (option.group !== currentGroup) {
-            currentGroup = option.group;
-            if (option.group)
-                rows.push({ kind: "header", key: `group-${option.group}-${index}`, group: option.group });
-        }
-        rows.push({ kind: "option", key: option.id, option, index });
-    });
-    return rows;
-};
 /** The unified `Select`'s popup mode (`native={false}`) — absorbs SelectV2's behaviour, plus clear/create/groups/virtualization. */
 const SelectPopup = (0, react_1.forwardRef)(function SelectPopup(props, ref) {
-    var _a, _b, _c, _d, _e;
-    const { options = [], id, name, placeholder = "Select Option", label, error = false, errorMessage, helperText, isDisabled = false, isReadOnly = false, isRequired = false, isInformation = false, informationMessage, size = controlSizes_1.DEFAULT_CONTROL_SIZE, isSearchable = true, width, formControlStyle, onBlur, onFocus, renderOption, renderValue, maxMenuHeight = "16rem", defaultOpen = false, isLoading = false, loadingText = "Loading...", onLoadMore, hasMore, onSearchChange, searchValue, defaultSearchValue, searchDebounceMs = 0, filterOptions, isClearable = false, onClear, noOptionsMessage, onCreate, createLabel, virtualizeAfter, "data-testid": dataTestId, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, } = props;
+    var _a, _b, _c, _d, _e, _f;
+    const { options = [], id, name, placeholder = "Select Option", label, error = false, errorMessage, helperText, isDisabled = false, isReadOnly = false, isRequired = false, isInformation = false, informationMessage, size = controlSizes_1.DEFAULT_CONTROL_SIZE, isSearchable = true, width, formControlStyle, onBlur, onFocus, renderOption, renderValue, maxMenuHeight = "16rem", defaultOpen = false, isLoading = false, loadingText = "Loading...", onLoadMore, hasMore, onSearchChange, searchValue, defaultSearchValue, searchDebounceMs = 0, filterOptions, isClearable = false, onClear, noOptionsMessage, onCreate, createLabel, createWhen = "no-options", footerAction, searchFields, filterOption, isFieldLoading = false, rightIcon, virtualizeAfter, "data-testid": dataTestId, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, } = props;
     const theme = (0, useCustomTheme_1.useCustomTheme)();
     const { colors } = theme;
     const { isOpen, onOpen, onClose } = (0, react_2.useDisclosure)({ defaultIsOpen: defaultOpen });
@@ -109,6 +104,8 @@ const SelectPopup = (0, react_1.forwardRef)(function SelectPopup(props, ref) {
     const listboxId = `${ids.inputId}-listbox`;
     const filterInputId = `${listboxId}-filter`;
     const createRowId = `${listboxId}-create`;
+    const selectAllId = `${listboxId}-select-all`;
+    const footerId = `${listboxId}-footer`;
     const isInteractive = !isDisabled && !isReadOnly;
     const isValueControlled = props.value !== undefined;
     const [uncontrolledValue, setUncontrolledValue] = (0, react_1.useState)(props.defaultValue);
@@ -137,12 +134,18 @@ const SelectPopup = (0, react_1.forwardRef)(function SelectPopup(props, ref) {
             .filter((option) => option !== undefined);
     }, [options, selectedIds]);
     const shouldFilterLocally = filterOptions !== null && filterOptions !== void 0 ? filterOptions : !onSearchChange;
+    const searchesLabel = searchFields ? searchFields.includes("label") : true;
+    const searchesDescription = !!searchFields && searchFields.includes("description");
     const filteredOptions = (0, react_1.useMemo)(() => {
-        if (!isSearchable || !currentSearch.trim() || !shouldFilterLocally)
+        const query = currentSearch.trim();
+        if (!isSearchable || !query || !shouldFilterLocally)
             return options;
-        const needle = currentSearch.trim().toLowerCase();
-        return options.filter((option) => option.label.toString().toLowerCase().includes(needle));
-    }, [options, currentSearch, isSearchable, shouldFilterLocally]);
+        if (filterOption)
+            return options.filter((option) => filterOption(option, query));
+        const needle = query.toLowerCase();
+        return options.filter((option) => (searchesLabel && option.label.toString().toLowerCase().includes(needle)) ||
+            (searchesDescription && !!option.description && option.description.toLowerCase().includes(needle)));
+    }, [options, currentSearch, isSearchable, shouldFilterLocally, filterOption, searchesLabel, searchesDescription]);
     const hasGroups = (0, react_1.useMemo)(() => options.some((option) => option.group), [options]);
     const resetAndClose = (0, react_1.useCallback)((opts) => {
         if (props.isMulti && (opts === null || opts === void 0 ? void 0 : opts.keepOpenForMulti))
@@ -198,6 +201,29 @@ const SelectPopup = (0, react_1.forwardRef)(function SelectPopup(props, ref) {
         onCreate(currentSearch.trim());
         resetAndClose();
     }, [onCreate, currentSearch, resetAndClose]);
+    const handleFooterAction = (0, react_1.useCallback)(() => {
+        if (!footerAction)
+            return;
+        footerAction.onSelect(currentSearch.trim());
+        resetAndClose();
+    }, [footerAction, currentSearch, resetAndClose]);
+    const hasSelectAllRow = !!props.isMulti && !!props.isSelectAll;
+    const selectableFiltered = (0, react_1.useMemo)(() => (hasSelectAllRow ? filteredOptions.filter((option) => !option.isDisabled) : []), [hasSelectAllRow, filteredOptions]);
+    const showSelectAllRow = selectableFiltered.length > 0;
+    const allFilteredSelected = showSelectAllRow && selectableFiltered.every((o) => selectedIds.has(o.id.toString()));
+    const handleSelectAll = () => {
+        var _a;
+        if (!props.isMulti || !showSelectAllRow)
+            return;
+        const shown = new Set(selectableFiltered.map((option) => option.id.toString()));
+        const next = allFilteredSelected
+            ? selectedOptions.filter((selected) => !shown.has(selected.id.toString()))
+            : [...selectedOptions, ...selectableFiltered.filter((option) => !selectedIds.has(option.id.toString()))];
+        if (!isValueControlled)
+            setUncontrolledValue(next.map((o) => o.id));
+        props.onChange(next);
+        (_a = filterInputRef.current) === null || _a === void 0 ? void 0 : _a.focus();
+    };
     const handleClear = (0, react_1.useCallback)((event) => {
         event.stopPropagation();
         if (!isInteractive)
@@ -231,31 +257,50 @@ const SelectPopup = (0, react_1.forwardRef)(function SelectPopup(props, ref) {
     }, [isOpen, isSearchable]);
     const spec = (0, react_1.useMemo)(() => (0, optionRowSizes_1.optionRowSpec)(size), [size]);
     const maxMenuHeightPx = (0, react_1.useMemo)(() => parseRemToPx(maxMenuHeight, 256), [maxMenuHeight]);
-    const shouldVirtualize = !!virtualizeAfter && !hasGroups && filteredOptions.length > virtualizeAfter;
+    const shouldVirtualize = !!virtualizeAfter && filteredOptions.length > virtualizeAfter;
     const [scrollTop, setScrollTop] = (0, react_1.useState)(0);
     // A description, an avatar or a renderOption row outgrows the spec's single-line height.
     const [rowHeightPx, setRowHeightPx] = (0, react_1.useState)(spec.virtualRowHeightPx);
+    const [headerHeightPx, setHeaderHeightPx] = (0, react_1.useState)(GROUP_HEADER_ESTIMATE_PX);
+    const selectAllLeadPx = showSelectAllRow ? rowHeightPx : 0;
+    const windowTop = Math.max(0, scrollTop - selectAllLeadPx);
     const visibleCount = Math.ceil(maxMenuHeightPx / rowHeightPx) + VIRTUAL_OVERSCAN * 2;
+    const groupedRows = (0, react_1.useMemo)(() => (hasGroups ? (0, groupedWindow_1.buildGroupedRows)(filteredOptions) : []), [hasGroups, filteredOptions]);
+    const groupedLayout = (0, react_1.useMemo)(() => (hasGroups && shouldVirtualize ? (0, groupedWindow_1.layoutGroupedRows)(groupedRows, headerHeightPx, rowHeightPx) : null), [hasGroups, shouldVirtualize, groupedRows, headerHeightPx, rowHeightPx]);
+    const groupedRange = groupedLayout
+        ? (0, groupedWindow_1.groupedWindow)(groupedLayout.tops, windowTop, maxMenuHeightPx, VIRTUAL_OVERSCAN)
+        : null;
     const startIndex = shouldVirtualize
-        ? Math.max(0, Math.floor(scrollTop / rowHeightPx) - VIRTUAL_OVERSCAN)
+        ? Math.max(0, Math.floor(windowTop / rowHeightPx) - VIRTUAL_OVERSCAN)
         : 0;
     const endIndex = shouldVirtualize
         ? Math.min(filteredOptions.length, startIndex + visibleCount)
         : filteredOptions.length;
     const renderedOptions = shouldVirtualize ? filteredOptions.slice(startIndex, endIndex) : filteredOptions;
-    const topPadPx = shouldVirtualize ? startIndex * rowHeightPx : 0;
-    const bottomPadPx = shouldVirtualize ? (filteredOptions.length - endIndex) * rowHeightPx : 0;
+    const topPadPx = groupedLayout && groupedRange
+        ? groupedLayout.tops[groupedRange.start]
+        : shouldVirtualize ? startIndex * rowHeightPx : 0;
+    const bottomPadPx = groupedLayout && groupedRange
+        ? groupedLayout.tops[groupedLayout.tops.length - 1] - groupedLayout.tops[groupedRange.end]
+        : shouldVirtualize ? (filteredOptions.length - endIndex) * rowHeightPx : 0;
+    const renderedGroupedRows = groupedRange ? groupedRows.slice(groupedRange.start, groupedRange.end) : groupedRows;
     (0, react_1.useLayoutEffect)(() => {
-        var _a;
+        var _a, _b;
         if (!isOpen)
             return;
-        const row = (_a = listRef.current) === null || _a === void 0 ? void 0 : _a.querySelector('[role="option"]');
-        if (!row)
-            return;
-        const measured = row.getBoundingClientRect().height;
-        if (measured > 0 && Math.abs(measured - rowHeightPx) > 0.5)
-            setRowHeightPx(measured);
-    }, [isOpen, rowHeightPx, filteredOptions.length]);
+        const row = (_a = listRef.current) === null || _a === void 0 ? void 0 : _a.querySelector('[role="option"][data-index]');
+        if (row) {
+            const measured = row.getBoundingClientRect().height;
+            if (measured > 0 && Math.abs(measured - rowHeightPx) > 0.5)
+                setRowHeightPx(measured);
+        }
+        const header = (_b = listRef.current) === null || _b === void 0 ? void 0 : _b.querySelector("[data-group-header]");
+        if (header) {
+            const measured = header.getBoundingClientRect().height;
+            if (measured > 0 && Math.abs(measured - headerHeightPx) > 0.5)
+                setHeaderHeightPx(measured);
+        }
+    }, [isOpen, rowHeightPx, headerHeightPx, filteredOptions.length]);
     // Windowing starts mid-list, so the window must open where the user already is.
     (0, react_1.useLayoutEffect)(() => {
         var _a, _b;
@@ -264,16 +309,29 @@ const SelectPopup = (0, react_1.forwardRef)(function SelectPopup(props, ref) {
         wasVirtualized.current = shouldVirtualize;
     }, [shouldVirtualize]);
     (0, react_1.useEffect)(() => {
-        var _a, _b;
-        if (activeIndex < 0 || !listRef.current)
+        var _a, _b, _c, _d;
+        if (activeIndex === NO_ROW || !listRef.current)
             return;
         if (lastActiveIndex.current === activeIndex)
             return;
         lastActiveIndex.current = activeIndex;
         const el = listRef.current;
+        if (activeIndex < 0) {
+            const extraId = activeIndex === SELECT_ALL_ROW ? selectAllId : activeIndex === CREATE_ROW ? createRowId : footerId;
+            (_b = (_a = el.ownerDocument.getElementById(extraId)) === null || _a === void 0 ? void 0 : _a.scrollIntoView) === null || _b === void 0 ? void 0 : _b.call(_a, { block: "nearest" });
+            return;
+        }
         if (shouldVirtualize) {
-            const targetTop = activeIndex * rowHeightPx;
-            const targetBottom = targetTop + rowHeightPx;
+            let targetTop = activeIndex * rowHeightPx;
+            let targetBottom = targetTop + rowHeightPx;
+            const rowIndex = groupedLayout === null || groupedLayout === void 0 ? void 0 : groupedLayout.optionRows[activeIndex];
+            if (groupedLayout && rowIndex !== undefined) {
+                const startsGroup = rowIndex > 0 && groupedRows[rowIndex - 1].kind === "header";
+                targetTop = groupedLayout.tops[startsGroup ? rowIndex - 1 : rowIndex];
+                targetBottom = groupedLayout.tops[rowIndex + 1];
+            }
+            targetTop += selectAllLeadPx + LIST_PADDING_PX;
+            targetBottom += selectAllLeadPx + LIST_PADDING_PX;
             if (targetTop < el.scrollTop) {
                 el.scrollTop = targetTop;
                 setScrollTop(targetTop);
@@ -285,8 +343,8 @@ const SelectPopup = (0, react_1.forwardRef)(function SelectPopup(props, ref) {
             }
             return;
         }
-        (_b = (_a = el.querySelector(`[data-index="${activeIndex}"]`)) === null || _a === void 0 ? void 0 : _a.scrollIntoView) === null || _b === void 0 ? void 0 : _b.call(_a, { block: "nearest" });
-    }, [activeIndex, shouldVirtualize, maxMenuHeightPx, rowHeightPx]);
+        (_d = (_c = el.querySelector(`[data-index="${activeIndex}"]`)) === null || _c === void 0 ? void 0 : _c.scrollIntoView) === null || _d === void 0 ? void 0 : _d.call(_c, { block: "nearest" });
+    }, [activeIndex, shouldVirtualize, maxMenuHeightPx, rowHeightPx, groupedLayout, groupedRows, selectAllLeadPx, selectAllId, createRowId, footerId]);
     const loadMoreInFlightRef = (0, react_1.useRef)(false);
     const prevOptionsLengthRef = (0, react_1.useRef)(options.length);
     const prevIsLoadingRef = (0, react_1.useRef)(isLoading);
@@ -307,23 +365,57 @@ const SelectPopup = (0, react_1.forwardRef)(function SelectPopup(props, ref) {
         loadMoreInFlightRef.current = true;
         onLoadMore();
     }, [onLoadMore, hasMore, isLoading]);
+    const trimmedSearch = currentSearch.trim();
+    const hasExactMatch = (0, react_1.useMemo)(() => {
+        if (createWhen !== "no-exact-match" || !trimmedSearch)
+            return false;
+        const needle = trimmedSearch.toLowerCase();
+        return options.some((option) => option.label.toString().trim().toLowerCase() === needle);
+    }, [createWhen, trimmedSearch, options]);
+    const showCreateRow = !!onCreate &&
+        isSearchable &&
+        trimmedSearch !== "" &&
+        !isLoading &&
+        (createWhen === "no-exact-match" ? !hasExactMatch : filteredOptions.length === 0);
+    const isCreateImplicit = showCreateRow && filteredOptions.length === 0;
+    const hasFooter = !!footerAction;
+    const leadingStops = showSelectAllRow ? 1 : 0;
+    const optionsEndStop = leadingStops + filteredOptions.length - 1;
+    const stopCount = optionsEndStop + 1 + (showCreateRow ? 1 : 0) + (hasFooter ? 1 : 0);
+    const rowToStop = (row) => {
+        if (row === SELECT_ALL_ROW)
+            return showSelectAllRow ? 0 : -1;
+        if (row === CREATE_ROW)
+            return showCreateRow ? optionsEndStop + 1 : -1;
+        if (row === FOOTER_ROW)
+            return hasFooter ? stopCount - 1 : -1;
+        return row >= 0 && row < filteredOptions.length ? leadingStops + row : -1;
+    };
+    const stopToRow = (stop) => {
+        if (showSelectAllRow && stop === 0)
+            return SELECT_ALL_ROW;
+        if (stop <= optionsEndStop)
+            return stop - leadingStops;
+        return showCreateRow && stop === optionsEndStop + 1 ? CREATE_ROW : FOOTER_ROW;
+    };
     const moveActive = (delta) => {
-        if (!filteredOptions.length)
+        if (!stopCount)
             return;
-        const next = activeIndex + delta;
-        if (delta > 0 && next >= filteredOptions.length) {
-            if (canLoadMore) {
-                triggerLoadMore();
-                return;
-            }
-            setActiveIndex(0);
+        const current = rowToStop(activeIndex);
+        const next = current + delta;
+        const isPaging = delta > 0 && canLoadMore && filteredOptions.length > 0 && current === optionsEndStop;
+        if (isPaging)
+            triggerLoadMore();
+        if (delta > 0 && next >= stopCount) {
+            if (!isPaging)
+                setActiveIndex(stopToRow(0));
             return;
         }
         if (next < 0) {
-            setActiveIndex(filteredOptions.length - 1);
+            setActiveIndex(stopToRow(stopCount - 1));
             return;
         }
-        setActiveIndex(next);
+        setActiveIndex(stopToRow(next));
     };
     const moveActiveBy = (delta) => {
         if (!filteredOptions.length)
@@ -335,7 +427,6 @@ const SelectPopup = (0, react_1.forwardRef)(function SelectPopup(props, ref) {
             return;
         setActiveIndex(edge === "start" ? 0 : filteredOptions.length - 1);
     };
-    const showCreateRow = !!onCreate && isSearchable && currentSearch.trim() !== "" && filteredOptions.length === 0 && !isLoading;
     const handleListKeyDown = (event) => {
         var _a, _b;
         const isTextInput = ((_a = event.target) === null || _a === void 0 ? void 0 : _a.tagName) === "INPUT";
@@ -371,9 +462,15 @@ const SelectPopup = (0, react_1.forwardRef)(function SelectPopup(props, ref) {
             case "Enter": {
                 event.preventDefault();
                 const activeOption = filteredOptions[activeIndex];
-                if (activeOption)
+                if (activeIndex === SELECT_ALL_ROW && showSelectAllRow)
+                    handleSelectAll();
+                else if (activeIndex === FOOTER_ROW && hasFooter)
+                    handleFooterAction();
+                else if (activeIndex === CREATE_ROW && showCreateRow)
+                    handleCreate();
+                else if (activeOption)
                     handleSelect(activeOption);
-                else if (showCreateRow)
+                else if (isCreateImplicit)
                     handleCreate();
                 break;
             }
@@ -392,7 +489,9 @@ const SelectPopup = (0, react_1.forwardRef)(function SelectPopup(props, ref) {
     const handleTriggerKeyDown = (event) => {
         if (!isInteractive)
             return;
-        if (props.isMulti && !isOpen && event.key === "Backspace" && selectedOptions.length) {
+        if (event.target !== event.currentTarget && (event.key === "Enter" || event.key === " "))
+            return;
+        if (props.isMulti && props.isChipRemovable !== false && !isOpen && event.key === "Backspace" && selectedOptions.length) {
             event.preventDefault();
             handleSelect(selectedOptions[selectedOptions.length - 1]);
             return;
@@ -428,16 +527,22 @@ const SelectPopup = (0, react_1.forwardRef)(function SelectPopup(props, ref) {
         searchDebounceTimer.current = setTimeout(() => onSearchChange(nextText), searchDebounceMs);
     };
     const activeOption = filteredOptions[activeIndex];
-    const activeDescendantId = activeOption
-        ? optionDomId(listboxId, activeOption.id)
-        : showCreateRow
-            ? createRowId
-            : undefined;
+    const activeDescendantId = activeIndex === SELECT_ALL_ROW && showSelectAllRow
+        ? selectAllId
+        : activeIndex === FOOTER_ROW && hasFooter
+            ? footerId
+            : activeOption
+                ? optionDomId(listboxId, activeOption.id)
+                : showCreateRow && (isCreateImplicit || activeIndex === CREATE_ROW)
+                    ? createRowId
+                    : undefined;
     const listScrollStyles = (0, react_1.useMemo)(() => (0, scrollbar_1.scrollbarStyles)(colors, "overlay"), [colors]);
     const rowBackgrounds = (0, react_1.useMemo)(() => (0, rowStates_1.listRowBackgrounds)(colors), [colors]);
     const showChips = !!props.isMulti && !renderValue && selectedOptions.length > 0;
     const chipSize = size === "xs" ? "xs" : "sm";
     const maxVisibleChips = props.isMulti ? ((_a = props.maxVisibleChips) !== null && _a !== void 0 ? _a : DEFAULT_MAX_VISIBLE_CHIPS) : 0;
+    const chipMaxLength = props.isMulti ? props.chipMaxLength : undefined;
+    const canRemoveChips = isInteractive && !!props.isMulti && props.isChipRemovable !== false;
     const visibleChipOptions = showChips ? selectedOptions.slice(0, maxVisibleChips) : [];
     const overflowChipCount = showChips ? selectedOptions.length - visibleChipOptions.length : 0;
     const showClear = isClearable && isInteractive && selectedOptions.length > 0;
@@ -472,15 +577,17 @@ const SelectPopup = (0, react_1.forwardRef)(function SelectPopup(props, ref) {
     const triggerIcon = !props.isMulti && ((_b = selectedOptions[0]) === null || _b === void 0 ? void 0 : _b.icon) ? selectedOptions[0].icon : null;
     const selectedValueIds = selectedOptions.map((option) => option.id.toString());
     const hiddenValues = !name ? [] : props.isMulti ? selectedValueIds : [(_c = selectedValueIds[0]) !== null && _c !== void 0 ? _c : ""];
-    const groupedRows = (0, react_1.useMemo)(() => (hasGroups ? buildGroupedRows(filteredOptions) : []), [hasGroups, filteredOptions]);
-    return ((0, jsx_runtime_1.jsxs)(react_2.FormControl, { isInvalid: error, isDisabled: isDisabled, isReadOnly: isReadOnly, style: formControlStyle, width: width, children: [label && ((0, jsx_runtime_1.jsx)(FormLabel_1.TextLabel, { label: label, id: ids.inputId, isRequired: isRequired, isInformation: isInformation, informationMessage: informationMessage })), (0, jsx_runtime_1.jsxs)(react_2.Popover, { isOpen: isOpen, onClose: () => resetAndClose(), placement: "bottom-start", autoFocus: false, returnFocusOnClose: false, gutter: 4, children: [(0, jsx_runtime_1.jsx)(react_2.PopoverAnchor, { children: (0, jsx_runtime_1.jsxs)(react_2.Box, { as: "div", ref: mergedTriggerRef, ...ids.controlProps, role: "combobox", tabIndex: isDisabled ? -1 : 0, "aria-haspopup": "listbox", "aria-expanded": isOpen, "aria-controls": listboxId, "aria-owns": `${listboxId} ${filterInputId}`, "aria-activedescendant": activeDescendantId, "aria-disabled": isDisabled || undefined, "data-readonly": isReadOnly || undefined, "aria-required": isRequired || undefined, "aria-label": triggerAriaLabel(), "aria-labelledby": ariaLabelledBy, onClick: handleOpen, onKeyDown: handleTriggerKeyDown, display: "flex", alignItems: "center", justifyContent: "space-between", width: "100%", textAlign: "left", cursor: isDisabled ? "not-allowed" : isReadOnly ? "default" : "pointer", "data-testid": dataTestId, sx: triggerSx, children: [(0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", display: "inline-flex", flexWrap: showChips ? "wrap" : "nowrap", alignItems: "center", gap: showChips ? 1 : 1.5, minW: 0, flex: 1, isTruncated: !showChips, children: showChips ? ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [visibleChipOptions.map((option) => ((0, jsx_runtime_1.jsx)(Tag_1.default, { label: String(option.label), size: chipSize, variant: "subtle", icon: isInteractive ? lucide_react_1.X : undefined, onIconClick: isInteractive ? () => handleSelect(option) : undefined }, option.id))), overflowChipCount > 0 && ((0, jsx_runtime_1.jsx)(Tag_1.default, { label: `+${overflowChipCount}`, size: chipSize, variant: "subtle", colorScheme: "gray" }))] })) : ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [triggerIcon ? ((0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", display: "inline-flex", flexShrink: 0, children: triggerIcon })) : null, (0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", isTruncated: true, children: renderValue ? renderValue(selectedOptions) : defaultTriggerContent() })] })) }), showClear && ((0, jsx_runtime_1.jsx)(react_2.Box, { as: "button", type: "button", "aria-label": "Clear selection", onClick: handleClear, display: "inline-flex", alignItems: "center", justifyContent: "center", flexShrink: 0, ml: 2, color: colors.textMuted, _hover: { color: colors.text[700] }, children: (0, jsx_runtime_1.jsx)(lucide_react_1.X, { size: controlSizes_1.CONTROL_SIZES[size].iconSize }) })), (0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", display: "inline-flex", flexShrink: 0, ml: 2, transition: CHEVRON_TRANSITION, transform: isOpen ? "rotate(180deg)" : "rotate(0deg)", color: colors.textMuted, sx: (0, motion_2.reducedMotionSx)(), children: (0, jsx_runtime_1.jsx)(lucide_react_1.ChevronDown, { size: controlSizes_1.CONTROL_SIZES[size].iconSize }) })] }) }), (0, jsx_runtime_1.jsx)(react_2.Portal, { children: (0, jsx_runtime_1.jsxs)(react_2.PopoverContent, { "aria-label": (_d = label !== null && label !== void 0 ? label : ariaLabel) !== null && _d !== void 0 ? _d : placeholder, width: "max-content", minWidth: triggerWidth ? `${triggerWidth}px` : undefined, maxWidth: "min(24rem, calc(100vw - 2rem))", borderRadius: "xl", boxShadow: theme.shadows.lg, overflow: "hidden", onKeyDown: handleListKeyDown, children: [(0, jsx_runtime_1.jsx)(react_2.Box, { p: spec.mx, borderBottom: `${borderWidths_1.BORDER_WIDTHS.hairline} solid ${(0, surfaceRaised_1.raisedRule)(colors)}`, display: isSearchable ? undefined : "none", children: (0, jsx_runtime_1.jsx)(react_2.Input, { ref: filterInputRef, id: filterInputId, size: size, px: spec.px, placeholder: "Type to filter...", value: currentSearch, onChange: handleFilterChange, "aria-activedescendant": activeDescendantId, "aria-controls": listboxId, "aria-label": "Filter options", tabIndex: isSearchable ? undefined : -1 }) }), (0, jsx_runtime_1.jsxs)(react_2.Box, { id: listboxId, ref: listRef, role: "listbox", "aria-label": (_e = label !== null && label !== void 0 ? label : ariaLabel) !== null && _e !== void 0 ? _e : placeholder, "aria-multiselectable": props.isMulti || undefined, "aria-busy": isLoading || undefined, maxH: maxMenuHeight, overflowY: "auto", py: 1, sx: listScrollStyles, onScroll: handleListScroll, children: [filteredOptions.length === 0 && !isLoading && !showCreateRow && ((0, jsx_runtime_1.jsx)(react_2.Box, { mx: spec.mx, px: spec.px, py: spec.py, fontSize: spec.fontSize, color: colors.textMuted, children: noOptionsMessage !== null && noOptionsMessage !== void 0 ? noOptionsMessage : "No Options" })), showCreateRow && ((0, jsx_runtime_1.jsx)(react_2.Box, { id: createRowId, role: "option", "aria-selected": false, "data-index": -1, onClick: handleCreate, mx: spec.mx, px: spec.px, py: spec.py, minH: spec.minH, borderRadius: "md", cursor: "pointer", fontSize: spec.fontSize, fontWeight: 600, color: colors.primary[600], bg: activeDescendantId === createRowId ? rowBackgrounds.active : "transparent", children: createLabel ? createLabel(currentSearch.trim()) : `Create "${currentSearch.trim()}"` })), hasGroups
-                                            ? groupedRows.map((row) => {
-                                                var _a;
-                                                return row.kind === "header" ? ((0, jsx_runtime_1.jsx)(react_2.Box, { mx: spec.mx, px: spec.px, pt: 2, pb: 1, fontSize: "xs-minus", fontWeight: 600, textTransform: "uppercase", letterSpacing: "0.03em", color: colors.textMuted, children: row.group }, row.key)) : ((0, jsx_runtime_1.jsx)(OptionRow, { option: row.option, index: row.index, listboxId: listboxId, isSelected: selectedIds.has(row.option.id.toString()), isActive: row.index === activeIndex, isMulti: (_a = props.isMulti) !== null && _a !== void 0 ? _a : false, theme: theme, backgrounds: rowBackgrounds, spec: spec, renderOption: renderOption, onSelect: handleSelect, onActivate: setActiveIndex }, row.key));
-                                            })
+    return ((0, jsx_runtime_1.jsxs)(react_2.FormControl, { isInvalid: error, isDisabled: isDisabled, isReadOnly: isReadOnly, style: formControlStyle, width: width, children: [label && ((0, jsx_runtime_1.jsx)(FormLabel_1.TextLabel, { label: label, id: ids.inputId, isRequired: isRequired, isInformation: isInformation, informationMessage: informationMessage })), (0, jsx_runtime_1.jsxs)(react_2.Popover, { isOpen: isOpen, onClose: () => resetAndClose(), placement: "bottom-start", autoFocus: false, returnFocusOnClose: false, gutter: 4, children: [(0, jsx_runtime_1.jsx)(react_2.PopoverAnchor, { children: (0, jsx_runtime_1.jsxs)(react_2.Box, { as: "div", ref: mergedTriggerRef, ...ids.controlProps, role: "combobox", tabIndex: isDisabled ? -1 : 0, "aria-haspopup": "listbox", "aria-expanded": isOpen, "aria-controls": listboxId, "aria-owns": `${listboxId} ${filterInputId}`, "aria-activedescendant": activeDescendantId, "aria-disabled": isDisabled || undefined, "aria-busy": isFieldLoading || undefined, "data-readonly": isReadOnly || undefined, "aria-required": isRequired || undefined, "aria-label": triggerAriaLabel(), "aria-labelledby": ariaLabelledBy, onClick: handleOpen, onKeyDown: handleTriggerKeyDown, display: "flex", alignItems: "center", justifyContent: "space-between", width: "100%", textAlign: "left", cursor: isDisabled ? "not-allowed" : isReadOnly ? "default" : "pointer", "data-testid": dataTestId, sx: triggerSx, children: [(0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", display: "inline-flex", flexWrap: showChips ? "wrap" : "nowrap", alignItems: "center", gap: showChips ? 1 : 1.5, minW: 0, flex: 1, isTruncated: !showChips, children: showChips ? ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [visibleChipOptions.map((option) => ((0, jsx_runtime_1.jsx)(Tag_1.default, { label: truncateLabel(String(option.label), chipMaxLength), size: chipSize, variant: "subtle", icon: canRemoveChips ? lucide_react_1.X : undefined, onIconClick: canRemoveChips ? () => handleSelect(option) : undefined }, option.id))), overflowChipCount > 0 && ((0, jsx_runtime_1.jsx)(Tag_1.default, { label: `+${overflowChipCount}`, size: chipSize, variant: "subtle", colorScheme: "gray" }))] })) : ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [triggerIcon ? ((0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", display: "inline-flex", flexShrink: 0, children: triggerIcon })) : null, (0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", isTruncated: true, children: renderValue ? renderValue(selectedOptions) : defaultTriggerContent() })] })) }), showClear && ((0, jsx_runtime_1.jsx)(react_2.Box, { as: "button", type: "button", "aria-label": "Clear selection", onClick: handleClear, display: "inline-flex", alignItems: "center", justifyContent: "center", flexShrink: 0, ml: 2, color: colors.textMuted, _hover: { color: colors.text[700] }, children: (0, jsx_runtime_1.jsx)(lucide_react_1.X, { size: controlSizes_1.CONTROL_SIZES[size].iconSize }) })), isFieldLoading ? ((0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", "aria-hidden": true, display: "inline-flex", flexShrink: 0, ml: 2, children: (0, jsx_runtime_1.jsx)(react_2.Spinner, { size: "xs", label: "" }) })) : rightIcon ? ("onClick" in rightIcon && isInteractive ? ((0, jsx_runtime_1.jsx)(react_2.Box, { as: "button", type: "button", "aria-label": rightIcon.ariaLabel, onClick: (event) => {
+                                        event.stopPropagation();
+                                        rightIcon.onClick();
+                                    }, onKeyDown: (event) => event.stopPropagation(), display: "inline-flex", alignItems: "center", justifyContent: "center", flexShrink: 0, ml: 2, color: colors.textMuted, _hover: { color: colors.text[700] }, children: rightIcon.icon })) : ((0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", "aria-hidden": true, display: "inline-flex", flexShrink: 0, ml: 2, color: colors.textMuted, children: rightIcon.icon }))) : ((0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", display: "inline-flex", flexShrink: 0, ml: 2, transition: CHEVRON_TRANSITION, transform: isOpen ? "rotate(180deg)" : "rotate(0deg)", color: colors.textMuted, sx: (0, motion_2.reducedMotionSx)(), children: (0, jsx_runtime_1.jsx)(lucide_react_1.ChevronDown, { size: controlSizes_1.CONTROL_SIZES[size].iconSize }) }))] }) }), (0, jsx_runtime_1.jsx)(react_2.Portal, { children: (0, jsx_runtime_1.jsxs)(react_2.PopoverContent, { "aria-label": (_d = label !== null && label !== void 0 ? label : ariaLabel) !== null && _d !== void 0 ? _d : placeholder, width: "max-content", minWidth: triggerWidth ? `${triggerWidth}px` : undefined, maxWidth: "min(24rem, calc(100vw - 2rem))", borderRadius: "xl", boxShadow: theme.shadows.lg, overflow: "hidden", onKeyDown: handleListKeyDown, children: [(0, jsx_runtime_1.jsx)(react_2.Box, { p: spec.mx, borderBottom: `${borderWidths_1.BORDER_WIDTHS.hairline} solid ${(0, surfaceRaised_1.raisedRule)(colors)}`, display: isSearchable ? undefined : "none", children: (0, jsx_runtime_1.jsx)(react_2.Input, { ref: filterInputRef, id: filterInputId, size: size, px: spec.px, placeholder: "Type to filter...", value: currentSearch, onChange: handleFilterChange, "aria-activedescendant": activeDescendantId, "aria-controls": listboxId, "aria-label": "Filter options", tabIndex: isSearchable ? undefined : -1 }) }), (0, jsx_runtime_1.jsxs)(react_2.Box, { id: listboxId, ref: listRef, role: "listbox", "aria-label": (_e = label !== null && label !== void 0 ? label : ariaLabel) !== null && _e !== void 0 ? _e : placeholder, "aria-multiselectable": props.isMulti || undefined, "aria-busy": isLoading || undefined, maxH: maxMenuHeight, overflowY: "auto", py: 1, sx: listScrollStyles, onScroll: handleListScroll, children: [filteredOptions.length === 0 && !isLoading && !showCreateRow && ((0, jsx_runtime_1.jsx)(react_2.Box, { mx: spec.mx, px: spec.px, py: spec.py, fontSize: spec.fontSize, color: colors.textMuted, children: noOptionsMessage !== null && noOptionsMessage !== void 0 ? noOptionsMessage : "No Options" })), showSelectAllRow && ((0, jsx_runtime_1.jsxs)(react_2.Box, { id: selectAllId, role: "option", "aria-selected": allFilteredSelected, onClick: handleSelectAll, onMouseEnter: () => setActiveIndex(SELECT_ALL_ROW), mx: spec.mx, px: spec.px, py: spec.py, minH: spec.minH, borderRadius: "md", cursor: "pointer", display: "flex", alignItems: "center", gap: spec.gap, fontSize: spec.fontSize, color: (0, optionRowInk_1.optionRowInk)(colors, false), bg: (0, optionRowInk_1.optionRowFill)(rowBackgrounds, activeIndex === SELECT_ALL_ROW), transition: ROW_TRANSITION, sx: (0, motion_2.reducedMotionSx)(), children: [(0, jsx_runtime_1.jsx)(react_2.Checkbox, { isChecked: allFilteredSelected, pointerEvents: "none", tabIndex: -1, sx: DECORATIVE_CHECKBOX_SX }), allFilteredSelected ? "Unselect All" : "Select All"] })), hasGroups
+                                            ? ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [topPadPx > 0 && (0, jsx_runtime_1.jsx)(react_2.Box, { height: `${topPadPx}px` }), renderedGroupedRows.map((row) => {
+                                                        var _a;
+                                                        return row.kind === "header" ? ((0, jsx_runtime_1.jsx)(react_2.Box, { "data-group-header": shouldVirtualize ? "" : undefined, mx: spec.mx, px: spec.px, pt: 2, pb: 1, fontSize: "xs-minus", fontWeight: 600, textTransform: "uppercase", letterSpacing: "0.03em", color: colors.textMuted, children: row.group }, row.key)) : ((0, jsx_runtime_1.jsx)(OptionRow, { option: row.option, index: row.index, listboxId: listboxId, isSelected: selectedIds.has(row.option.id.toString()), isActive: row.index === activeIndex, isMulti: (_a = props.isMulti) !== null && _a !== void 0 ? _a : false, theme: theme, backgrounds: rowBackgrounds, spec: spec, renderOption: renderOption, onSelect: handleSelect, onActivate: setActiveIndex }, row.key));
+                                                    }), bottomPadPx > 0 && (0, jsx_runtime_1.jsx)(react_2.Box, { height: `${bottomPadPx}px` })] }))
                                             : ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [topPadPx > 0 && (0, jsx_runtime_1.jsx)(react_2.Box, { height: `${topPadPx}px` }), renderedOptions.map((option, i) => {
                                                         var _a;
                                                         return ((0, jsx_runtime_1.jsx)(OptionRow, { option: option, index: startIndex + i, listboxId: listboxId, isSelected: selectedIds.has(option.id.toString()), isActive: startIndex + i === activeIndex, isMulti: (_a = props.isMulti) !== null && _a !== void 0 ? _a : false, theme: theme, backgrounds: rowBackgrounds, spec: spec, renderOption: renderOption, onSelect: handleSelect, onActivate: setActiveIndex }, option.id));
-                                                    }), bottomPadPx > 0 && (0, jsx_runtime_1.jsx)(react_2.Box, { height: `${bottomPadPx}px` })] })), isLoading && ((0, jsx_runtime_1.jsxs)(react_2.Box, { mx: spec.mx, px: spec.px, py: spec.py, display: "flex", alignItems: "center", gap: spec.gap, fontSize: spec.fontSize, color: colors.textMuted, children: [(0, jsx_runtime_1.jsx)(react_2.Spinner, { size: "xs" }), loadingText] }))] })] }) })] }), hiddenValues.map((value) => ((0, jsx_runtime_1.jsx)("input", { type: "hidden", name: name, value: value }, value))), (0, jsx_runtime_1.jsx)(FieldMessage_1.default, { error: error, errorMessage: errorMessage, helperText: helperText, helperId: ids.helperId, errorId: ids.errorId })] }));
+                                                    }), bottomPadPx > 0 && (0, jsx_runtime_1.jsx)(react_2.Box, { height: `${bottomPadPx}px` })] })), showCreateRow && ((0, jsx_runtime_1.jsx)(react_2.Box, { id: createRowId, role: "option", "aria-selected": false, "data-index": -1, onClick: handleCreate, mx: spec.mx, px: spec.px, py: spec.py, minH: spec.minH, borderRadius: "md", cursor: "pointer", fontSize: spec.fontSize, fontWeight: 600, color: colors.primary[600], bg: activeDescendantId === createRowId ? rowBackgrounds.active : "transparent", children: createLabel ? createLabel(currentSearch.trim()) : `Create "${currentSearch.trim()}"` })), isLoading && ((0, jsx_runtime_1.jsxs)(react_2.Box, { mx: spec.mx, px: spec.px, py: spec.py, display: "flex", alignItems: "center", gap: spec.gap, fontSize: spec.fontSize, color: colors.textMuted, children: [(0, jsx_runtime_1.jsx)(react_2.Spinner, { size: "xs" }), loadingText] })), footerAction && ((0, jsx_runtime_1.jsx)(react_2.Box, { id: footerId, role: "option", "aria-selected": false, onClick: handleFooterAction, onMouseEnter: () => setActiveIndex(FOOTER_ROW), position: "sticky", bottom: -1, pt: 1, bg: colors.surfaceRaised, borderTop: `${borderWidths_1.BORDER_WIDTHS.hairline} solid ${(0, surfaceRaised_1.raisedRule)(colors)}`, children: (0, jsx_runtime_1.jsxs)(react_2.Box, { mx: spec.mx, px: spec.px, py: spec.py, minH: spec.minH, borderRadius: "md", cursor: "pointer", display: "flex", alignItems: "center", gap: spec.gap, fontSize: spec.fontSize, fontWeight: 500, color: colors.accentText, bg: activeIndex === FOOTER_ROW ? rowBackgrounds.active : "transparent", children: [(_f = footerAction.icon) !== null && _f !== void 0 ? _f : (0, jsx_runtime_1.jsx)(lucide_react_1.Plus, { size: spec.iconSize }), footerAction.label] }) }))] })] }) })] }), hiddenValues.map((value) => ((0, jsx_runtime_1.jsx)("input", { type: "hidden", name: name, value: value }, value))), (0, jsx_runtime_1.jsx)(FieldMessage_1.default, { error: error, errorMessage: errorMessage, helperText: helperText, helperId: ids.helperId, errorId: ids.errorId })] }));
 });
 exports.default = SelectPopup;

package/dist/Components/Select/SelectProps.d.ts

@@ -7,7 +7,7 @@ export type OptionProp = {
     label: string | number;
     /** Popup mode only — leading icon/avatar for this option's row (and the trigger, when selected). */
     icon?: ReactNode;
-    /** Popup mode only — secondary line under the label; not matched by the search filter. */
+    /** Popup mode only — secondary line under the label; searched only when `searchFields` includes "description". */
     description?: string;
     /** Row is dimmed and unselectable. Native mode emits a disabled `<option>`. */
     isDisabled?: boolean;
@@ -72,6 +72,10 @@ type SelectCommonProps = {
     onSearchChange?: (query: string) => void;
     /** Debounce for `onSearchChange`, in ms. Defaults to 0 — every keystroke, matching SelectV2 today. */
     searchDebounceMs?: number;
+    /** Option fields the local filter matches (case-insensitive substring). Defaults to `["label"]`. Popup mode only. */
+    searchFields?: ("label" | "description")[];
+    /** Replaces the built-in substring match; receives the trimmed query and wins over `searchFields`. Popup mode only. */
+    filterOption?: (option: OptionProp, query: string) => boolean;
     /** Applies the local label-substring filter. Defaults to false once `onSearchChange` is set (server owns matching), true otherwise. */
     filterOptions?: boolean;
     /** Shows a clear (x) control once a value is selected. Popup mode only. */
@@ -82,6 +86,16 @@ type SelectCommonProps = {
     isLoading?: boolean;
     /** Text of the loading row. Defaults to "Loading...". Popup mode only. */
     loadingText?: string;
+    /** Swaps the trailing chevron for a spinner and marks the field aria-busy, even while the popup is closed. Popup mode only. */
+    isFieldLoading?: boolean;
+    /** Trailing slot replacing the chevron; with `onClick` it renders a button (so `ariaLabel` is required) that does not toggle the popup. Popup mode only. */
+    rightIcon?: {
+        icon: ReactNode;
+    } | {
+        icon: ReactNode;
+        onClick: () => void;
+        ariaLabel: string;
+    };
     /** Empty-list message. Native mode stringifies it (plain `<option>` text); popup mode accepts any node. */
     noOptionsMessage?: ReactNode;
     /** Fires when the list is scrolled to its end and not loading — append the next page. Popup mode only. */
@@ -99,11 +113,19 @@ type SelectCommonProps = {
     onCreate?: (label: string) => void;
     /** Overrides the default `Create "«query»"` row content. Popup mode only. */
     createLabel?: (query: string) => ReactNode;
+    /** When the Create row shows: only with zero matches (default), or whenever no option's label equals the query exactly. Popup mode only. */
+    createWhen?: "no-options" | "no-exact-match";
+    /** A persistent last row ("Add new…") shown whatever the filter; `onSelect` gets the trimmed query and the popup closes. Popup mode only. */
+    footerAction?: {
+        label: ReactNode;
+        onSelect: (query: string) => void;
+        icon?: ReactNode;
+    };
     /** Max popup height before the option list scrolls. Defaults to "16rem". Popup mode only. */
     maxMenuHeight?: string;
     /** Opens the popup on mount, for inline-edit cells. Popup mode only. */
     defaultOpen?: boolean;
-    /** Windows the list once it holds more options than this. Off by default; ignored when any option has a `group`. */
+    /** Windows the list once it holds more options than this. Off by default; works with grouped options too. */
     virtualizeAfter?: number;
 };
 /** Single-select arm of `SelectFieldProps`; `isMulti` false/absent discriminates it from the multi variant. */
@@ -127,6 +149,12 @@ export type SelectMultiProps = SelectCommonProps & {
     maxVisibleChips?: number;
     /** Feeds the trigger's aria-label summary once chips collapse. Defaults to 2. */
     maxLabelsBeforeSummary?: number;
+    /** Truncates each chip label to this many characters, adding an ellipsis. */
+    chipMaxLength?: number;
+    /** Set false to hide the chips' remove (x) and disable Backspace-removal. Defaults to true. */
+    isChipRemovable?: boolean;
+    /** Adds a Select All / Unselect All row that toggles every enabled option the filter currently shows. */
+    isSelectAll?: boolean;
 };
 /** Props for the unified `Select` — a discriminated union on `isMulti` between the single and multi variants. */
 export type SelectFieldProps = SelectSingleProps | SelectMultiProps;

package/dist/Components/Select/groupedWindow.d.ts

@@ -0,0 +1,21 @@
+import type { OptionProp } from "./SelectProps";
+export type GroupedRow = {
+    kind: "header";
+    key: string;
+    group: string;
+} | {
+    kind: "option";
+    key: string | number;
+    option: OptionProp;
+    index: number;
+};
+export type GroupedLayout = {
+    tops: number[];
+    optionRows: number[];
+};
+export declare const buildGroupedRows: (options: OptionProp[]) => GroupedRow[];
+export declare const layoutGroupedRows: (rows: GroupedRow[], headerPx: number, optionPx: number) => GroupedLayout;
+export declare const groupedWindow: (tops: number[], scrollTop: number, viewportPx: number, overscan: number) => {
+    start: number;
+    end: number;
+};

package/dist/Components/Select/groupedWindow.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.groupedWindow = exports.layoutGroupedRows = exports.buildGroupedRows = void 0;
+const buildGroupedRows = (options) => {
+    const rows = [];
+    let currentGroup;
+    options.forEach((option, index) => {
+        if (option.group !== currentGroup) {
+            currentGroup = option.group;
+            if (option.group)
+                rows.push({ kind: "header", key: `group-${option.group}-${index}`, group: option.group });
+        }
+        rows.push({ kind: "option", key: option.id, option, index });
+    });
+    return rows;
+};
+exports.buildGroupedRows = buildGroupedRows;
+const layoutGroupedRows = (rows, headerPx, optionPx) => {
+    const tops = new Array(rows.length + 1);
+    const optionRows = [];
+    let top = 0;
+    rows.forEach((row, i) => {
+        tops[i] = top;
+        if (row.kind === "option")
+            optionRows.push(i);
+        top += row.kind === "header" ? headerPx : optionPx;
+    });
+    tops[rows.length] = top;
+    return { tops, optionRows };
+};
+exports.layoutGroupedRows = layoutGroupedRows;
+const firstIndex = (count, isBefore) => {
+    let lo = 0;
+    let hi = count;
+    while (lo < hi) {
+        const mid = (lo + hi) >> 1;
+        if (isBefore(mid))
+            lo = mid + 1;
+        else
+            hi = mid;
+    }
+    return lo;
+};
+const groupedWindow = (tops, scrollTop, viewportPx, overscan) => {
+    const count = tops.length - 1;
+    const first = firstIndex(count, (i) => tops[i + 1] <= scrollTop);
+    const last = firstIndex(count, (i) => tops[i] < scrollTop + viewportPx);
+    return { start: Math.max(0, first - overscan), end: Math.min(count, last + overscan) };
+};
+exports.groupedWindow = groupedWindow;

package/dist/Components/SelectSearch/SelectSearch.d.ts

@@ -1,3 +1,3 @@
 import { SelectSearchProps } from "./SelectSearchProps";
-/** Prefer `Select` with `native={false}` for new work — not yet a drop-in; see select-absorption-spec.md. */
+/** Prefer `Select` (`native={false}`): onOptionSelect→onChange, inputOnchange→onSearchChange, the footer row→footerAction. */
 export default function SelectSearch({ options, initialSelectedOption, onOptionSelect, inputOnchange, id, name, label, inputStyle, isOptionLoading, loadingText, boxStyle, placeholder, searchQuery, isInformation, informationMessage, rightIcon, rightElementStyle, isMultipleSelect, isRequired, onOptionMultiSelect, error, isProfile, isBottomIcon, errorMessage, helperText, size, BottomIcon, BottomText, handleBottomClick, BottomTextColor, isColorOptions, }: Readonly<SelectSearchProps>): import("react/jsx-runtime").JSX.Element;