pixelize-design-library 2.4.2-beta.5 → 2.4.2-beta.51

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

@@ -0,0 +1,65 @@
+import React from "react";
+import { OptionProp } from "./SelectProps";
+/** Native `<select>` renderer — today's `Select`, unchanged, plus optgroup/disabled from `option.group`/`isDisabled`. */
+declare const SelectNative: React.ForwardRefExoticComponent<{
+    options: OptionProp[];
+    native?: boolean;
+    id?: string;
+    name?: string;
+    label?: string;
+    placeholder?: string;
+    size?: import("../../Theme/tokens/primitives/controlSizes").ControlSize;
+    width?: string | number;
+    height?: string | number;
+    error?: boolean;
+    errorMessage?: string;
+    helperText?: string;
+    isDisabled?: boolean;
+    isReadOnly?: boolean;
+    isRequired?: boolean;
+    isInformation?: boolean;
+    informationMessage?: string;
+    formControlStyle?: React.CSSProperties;
+    "aria-label"?: string;
+    "aria-labelledby"?: string;
+    "data-testid"?: string;
+    variant?: import("@chakra-ui/react").SelectProps["variant"];
+    colorScheme?: import("@chakra-ui/react").SelectProps["colorScheme"];
+    icon?: import("@chakra-ui/react").SelectProps["icon"];
+    bg?: import("@chakra-ui/react").SelectProps["bg"];
+    borderColor?: import("@chakra-ui/react").SelectProps["borderColor"];
+    color?: import("@chakra-ui/react").SelectProps["color"];
+    errorBorderColor?: import("@chakra-ui/react").SelectProps["errorBorderColor"];
+    selectStyle?: React.CSSProperties;
+    onBlur?: (event?: React.FocusEvent<HTMLElement>) => void;
+    onFocus?: (event?: React.FocusEvent<HTMLElement>) => void;
+    isSearchable?: boolean;
+    searchValue?: string;
+    defaultSearchValue?: string;
+    onSearchChange?: (query: string) => void;
+    searchDebounceMs?: number;
+    filterOptions?: boolean;
+    isClearable?: boolean;
+    onClear?: () => void;
+    isLoading?: boolean;
+    loadingText?: string;
+    noOptionsMessage?: React.ReactNode;
+    onLoadMore?: () => void;
+    hasMore?: boolean;
+    renderOption?: (option: OptionProp, state: {
+        isSelected: boolean;
+        isActive: boolean;
+    }) => React.ReactNode;
+    renderValue?: (selected: OptionProp[]) => React.ReactNode;
+    onCreate?: (label: string) => void;
+    createLabel?: (query: string) => React.ReactNode;
+    maxMenuHeight?: string;
+    defaultOpen?: boolean;
+    virtualizeAfter?: number;
+} & {
+    isMulti?: false;
+    value?: string | number;
+    defaultValue?: string | number;
+    onChange: (selectedOption: OptionProp | undefined) => void;
+} & React.RefAttributes<HTMLSelectElement>>;
+export default SelectNative;

package/dist/Components/Select/SelectNative.js

@@ -0,0 +1,49 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const react_2 = require("@chakra-ui/react");
+const controlSizes_1 = require("../../Theme/tokens/primitives/controlSizes");
+const FormLabel_1 = require("../Common/FormLabel");
+const FieldMessage_1 = __importDefault(require("../Common/FieldMessage"));
+const useFieldIds_1 = require("../Common/useFieldIds");
+const optionGroups = (options) => {
+    const segments = [];
+    options.forEach((option) => {
+        const last = segments[segments.length - 1];
+        if (last && last.group === option.group) {
+            last.options.push(option);
+        }
+        else {
+            segments.push({ group: option.group, options: [option] });
+        }
+    });
+    return segments;
+};
+/** Native `<select>` renderer — today's `Select`, unchanged, plus optgroup/disabled from `option.group`/`isDisabled`. */
+const SelectNative = (0, react_1.forwardRef)(function SelectNative({ placeholder = "Select Option", size = controlSizes_1.DEFAULT_CONTROL_SIZE, variant = "outline", icon, onChange, onBlur, onFocus, errorBorderColor, isDisabled, isReadOnly, isRequired = false, value = "", colorScheme, label, id, name, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, error = false, errorMessage, helperText, options = [], width, height, formControlStyle, isInformation = false, informationMessage, selectStyle, noOptionsMessage, }, ref) {
+    const ids = (0, useFieldIds_1.useFieldIds)(id, { error, errorMessage, helperText });
+    const getOptionsList = (0, react_1.useCallback)(() => {
+        if (!options.length) {
+            return (0, jsx_runtime_1.jsx)("option", { value: "", children: String(noOptionsMessage !== null && noOptionsMessage !== void 0 ? noOptionsMessage : "No Options") });
+        }
+        return optionGroups(options).map((segment, index) => {
+            const rows = segment.options.map((option) => ((0, jsx_runtime_1.jsx)("option", { value: option.id, disabled: option.isDisabled, children: option.label }, option.id)));
+            if (!segment.group)
+                return rows;
+            return ((0, jsx_runtime_1.jsx)("optgroup", { label: segment.group, children: rows }, `${segment.group}-${index}`));
+        });
+    }, [options, noOptionsMessage]);
+    const handleOnChange = (event) => {
+        if (isReadOnly)
+            return;
+        const selectedOption = options.find((option) => option.id.toString() === event.target.value.toString());
+        if (selectedOption)
+            onChange(selectedOption);
+    };
+    return ((0, jsx_runtime_1.jsxs)(react_2.FormControl, { isInvalid: error, 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.jsx)(react_2.Select, { ref: ref, ...ids.controlProps, name: name, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, placeholder: placeholder, size: size, variant: variant, icon: icon, iconSize: `${controlSizes_1.CONTROL_SIZES[size].iconSize}px`, isInvalid: error, isRequired: isRequired, value: value, onChange: handleOnChange, onBlur: onBlur, onFocus: onFocus, isDisabled: isDisabled, isReadOnly: isReadOnly, colorScheme: colorScheme, errorBorderColor: errorBorderColor, style: selectStyle, ...(height != null && height !== "" ? { minH: height, h: height } : {}), children: getOptionsList() }), (0, jsx_runtime_1.jsx)(FieldMessage_1.default, { error: error, errorMessage: errorMessage, helperText: helperText, helperId: ids.helperId, errorId: ids.errorId })] }));
+});
+exports.default = SelectNative;

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

@@ -0,0 +1,5 @@
+import React from "react";
+import { SelectFieldProps } from "./SelectProps";
+/** The unified `Select`'s popup mode (`native={false}`) — absorbs SelectV2's behaviour, plus clear/create/groups/virtualization. */
+declare const SelectPopup: React.ForwardRefExoticComponent<SelectFieldProps & React.RefAttributes<HTMLDivElement>>;
+export default SelectPopup;

package/dist/Components/Select/SelectPopup.js

@@ -0,0 +1,485 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = __importStar(require("react"));
+const react_2 = require("@chakra-ui/react");
+const lucide_react_1 = require("lucide-react");
+const useCustomTheme_1 = require("../../Theme/useCustomTheme");
+const focusRing_styles_1 = require("../../Theme/chakra/focusRing.styles");
+const rowStates_1 = require("../../Theme/tokens/builders/rowStates");
+const optionRowInk_1 = require("./optionRowInk");
+const optionRowSizes_1 = require("../../Theme/tokens/primitives/optionRowSizes");
+const scrollbar_1 = require("../../Theme/tokens/builders/scrollbar");
+const controlSizes_1 = require("../../Theme/tokens/primitives/controlSizes");
+const motion_1 = require("../../Theme/tokens/primitives/motion");
+const motion_2 = require("../../Theme/chakra/motion");
+const chipTriggerSize_1 = require("../Common/chipTriggerSize");
+const fieldStyles_1 = require("../Common/fieldStyles");
+const useFieldIds_1 = require("../Common/useFieldIds");
+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 ROW_TRANSITION = (0, motion_1.transitionFor)(["background-color", "color"]);
+const CHEVRON_TRANSITION = (0, motion_1.transitionFor)(["transform"], "base");
+const PAGE_STEP = 8;
+const LOAD_MORE_THRESHOLD_PX = 8;
+const DEFAULT_MAX_VISIBLE_CHIPS = 6;
+const VIRTUAL_OVERSCAN = 4;
+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, "-")}`;
+const parseRemToPx = (value, fallbackPx) => {
+    const match = /^(\d*\.?\d+)rem$/.exec(value);
+    return match ? parseFloat(match[1]) * 16 : fallbackPx;
+};
+const OptionRow = react_1.default.memo(function OptionRow({ option, index, listboxId, isSelected, isActive, isMulti, theme, backgrounds, spec, renderOption, onSelect, onActivate, }) {
+    const isSingleSelected = isSelected && !isMulti;
+    const selectedBg = isActive ? backgrounds.selectedActive : backgrounds.selected;
+    const restBg = isActive ? backgrounds.active : "transparent";
+    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: isSingleSelected ? selectedBg : restBg, 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 })) : 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;
+    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;
+    const theme = (0, useCustomTheme_1.useCustomTheme)();
+    const { colors } = theme;
+    const { isOpen, onOpen, onClose } = (0, react_2.useDisclosure)({ defaultIsOpen: defaultOpen });
+    const requestExclusiveOpen = (0, useExclusiveOverlay_1.useExclusiveOverlay)(isOpen, onClose);
+    const [activeIndex, setActiveIndex] = (0, react_1.useState)(-1);
+    const triggerRef = (0, react_1.useRef)(null);
+    const mergedTriggerRef = (0, react_2.useMergeRefs)(triggerRef, ref);
+    const filterInputRef = (0, react_1.useRef)(null);
+    const listRef = (0, react_1.useRef)(null);
+    const lastActiveIndex = (0, react_1.useRef)(-1);
+    const wasVirtualized = (0, react_1.useRef)(false);
+    const [triggerWidth, setTriggerWidth] = (0, react_1.useState)(0);
+    const ids = (0, useFieldIds_1.useFieldIds)(id, { error, errorMessage, helperText });
+    const listboxId = `${ids.inputId}-listbox`;
+    const filterInputId = `${listboxId}-filter`;
+    const createRowId = `${listboxId}-create`;
+    const isInteractive = !isDisabled && !isReadOnly;
+    const isValueControlled = props.value !== undefined;
+    const [uncontrolledValue, setUncontrolledValue] = (0, react_1.useState)(props.defaultValue);
+    const currentValue = isValueControlled ? props.value : uncontrolledValue;
+    const isSearchControlled = searchValue !== undefined;
+    const [uncontrolledSearch, setUncontrolledSearch] = (0, react_1.useState)(defaultSearchValue !== null && defaultSearchValue !== void 0 ? defaultSearchValue : "");
+    const currentSearch = isSearchControlled ? searchValue : uncontrolledSearch;
+    const searchDebounceTimer = (0, react_1.useRef)();
+    (0, react_1.useEffect)(() => () => clearTimeout(searchDebounceTimer.current), []);
+    const selectedIds = (0, react_1.useMemo)(() => props.isMulti
+        ? asIdSet(currentValue)
+        : asIdSet(currentValue !== undefined ? [currentValue] : undefined), [props.isMulti, currentValue]);
+    const selectionCacheRef = (0, react_1.useRef)(new Map());
+    const selectedOptions = (0, react_1.useMemo)(() => {
+        const cache = selectionCacheRef.current;
+        options.forEach((option) => {
+            if (selectedIds.has(option.id.toString()))
+                cache.set(option.id.toString(), option);
+        });
+        Array.from(cache.keys()).forEach((cachedId) => {
+            if (!selectedIds.has(cachedId))
+                cache.delete(cachedId);
+        });
+        return Array.from(selectedIds)
+            .map((selectedId) => cache.get(selectedId))
+            .filter((option) => option !== undefined);
+    }, [options, selectedIds]);
+    const shouldFilterLocally = filterOptions !== null && filterOptions !== void 0 ? filterOptions : !onSearchChange;
+    const filteredOptions = (0, react_1.useMemo)(() => {
+        if (!isSearchable || !currentSearch.trim() || !shouldFilterLocally)
+            return options;
+        const needle = currentSearch.trim().toLowerCase();
+        return options.filter((option) => option.label.toString().toLowerCase().includes(needle));
+    }, [options, currentSearch, isSearchable, shouldFilterLocally]);
+    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))
+            return;
+        onClose();
+        if (!isSearchControlled)
+            setUncontrolledSearch("");
+        setActiveIndex(-1);
+        onBlur === null || onBlur === void 0 ? void 0 : onBlur();
+    }, [onClose, onBlur, props.isMulti, isSearchControlled]);
+    const handleOpen = () => {
+        if (!isInteractive)
+            return;
+        requestExclusiveOpen();
+        onFocus === null || onFocus === void 0 ? void 0 : onFocus();
+        onOpen();
+        const firstSelected = props.isMulti
+            ? currentValue === null || currentValue === void 0 ? void 0 : currentValue[0]
+            : currentValue;
+        setActiveIndex(filteredOptions.findIndex((option) => option.id.toString() === (firstSelected === null || firstSelected === void 0 ? void 0 : firstSelected.toString())));
+    };
+    const selectedIdsRef = (0, react_1.useRef)(selectedIds);
+    selectedIdsRef.current = selectedIds;
+    const selectedOptionsRef = (0, react_1.useRef)(selectedOptions);
+    selectedOptionsRef.current = selectedOptions;
+    const handleSelect = (0, react_1.useCallback)((option) => {
+        var _a, _b;
+        if (option.isDisabled)
+            return;
+        if (props.isMulti) {
+            const alreadySelected = selectedIdsRef.current.has(option.id.toString());
+            const next = alreadySelected
+                ? selectedOptionsRef.current.filter((selected) => selected.id.toString() !== option.id.toString())
+                : [...selectedOptionsRef.current, option];
+            if (!isValueControlled)
+                setUncontrolledValue(next.map((o) => o.id));
+            props.onChange(next);
+            resetAndClose({ keepOpenForMulti: true });
+            (_a = filterInputRef.current) === null || _a === void 0 ? void 0 : _a.focus();
+            return;
+        }
+        if (!isValueControlled)
+            setUncontrolledValue(option.id);
+        props.onChange(option);
+        resetAndClose();
+        (_b = triggerRef.current) === null || _b === void 0 ? void 0 : _b.focus();
+    }, 
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [props.isMulti, props.onChange, resetAndClose, isValueControlled]);
+    const handleCreate = (0, react_1.useCallback)(() => {
+        if (!onCreate)
+            return;
+        onCreate(currentSearch.trim());
+        resetAndClose();
+    }, [onCreate, currentSearch, resetAndClose]);
+    const handleClear = (0, react_1.useCallback)((event) => {
+        event.stopPropagation();
+        if (!isInteractive)
+            return;
+        if (props.isMulti) {
+            if (!isValueControlled)
+                setUncontrolledValue([]);
+            props.onChange([]);
+        }
+        else {
+            if (!isValueControlled)
+                setUncontrolledValue(undefined);
+            props.onChange(undefined);
+        }
+        onClear === null || onClear === void 0 ? void 0 : onClear();
+    }, 
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [isInteractive, props.isMulti, props.onChange, isValueControlled, onClear]);
+    // The panel grows past the trigger to fit long labels, so it cannot inherit the anchor width.
+    (0, react_1.useEffect)(() => {
+        const node = triggerRef.current;
+        if (!isOpen || !node)
+            return;
+        setTriggerWidth(node.getBoundingClientRect().width);
+    }, [isOpen]);
+    (0, react_1.useEffect)(() => {
+        if (!isOpen || !isSearchable)
+            return;
+        const frame = requestAnimationFrame(() => { var _a; return (_a = filterInputRef.current) === null || _a === void 0 ? void 0 : _a.focus(); });
+        return () => cancelAnimationFrame(frame);
+    }, [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 [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 visibleCount = Math.ceil(maxMenuHeightPx / rowHeightPx) + VIRTUAL_OVERSCAN * 2;
+    const startIndex = shouldVirtualize
+        ? Math.max(0, Math.floor(scrollTop / 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;
+    (0, react_1.useLayoutEffect)(() => {
+        var _a;
+        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]);
+    // Windowing starts mid-list, so the window must open where the user already is.
+    (0, react_1.useLayoutEffect)(() => {
+        var _a, _b;
+        if (shouldVirtualize && !wasVirtualized.current)
+            setScrollTop((_b = (_a = listRef.current) === null || _a === void 0 ? void 0 : _a.scrollTop) !== null && _b !== void 0 ? _b : 0);
+        wasVirtualized.current = shouldVirtualize;
+    }, [shouldVirtualize]);
+    (0, react_1.useEffect)(() => {
+        var _a, _b;
+        if (activeIndex < 0 || !listRef.current)
+            return;
+        if (lastActiveIndex.current === activeIndex)
+            return;
+        lastActiveIndex.current = activeIndex;
+        const el = listRef.current;
+        if (shouldVirtualize) {
+            const targetTop = activeIndex * rowHeightPx;
+            const targetBottom = targetTop + rowHeightPx;
+            if (targetTop < el.scrollTop) {
+                el.scrollTop = targetTop;
+                setScrollTop(targetTop);
+            }
+            else if (targetBottom > el.scrollTop + maxMenuHeightPx) {
+                const next = targetBottom - maxMenuHeightPx;
+                el.scrollTop = next;
+                setScrollTop(next);
+            }
+            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]);
+    const loadMoreInFlightRef = (0, react_1.useRef)(false);
+    const prevOptionsLengthRef = (0, react_1.useRef)(options.length);
+    const prevIsLoadingRef = (0, react_1.useRef)(isLoading);
+    (0, react_1.useEffect)(() => {
+        if (options.length !== prevOptionsLengthRef.current)
+            loadMoreInFlightRef.current = false;
+        prevOptionsLengthRef.current = options.length;
+    }, [options.length]);
+    (0, react_1.useEffect)(() => {
+        if (prevIsLoadingRef.current && !isLoading)
+            loadMoreInFlightRef.current = false;
+        prevIsLoadingRef.current = isLoading;
+    }, [isLoading]);
+    const canLoadMore = !!onLoadMore && hasMore !== false;
+    const triggerLoadMore = (0, react_1.useCallback)(() => {
+        if (!onLoadMore || hasMore === false || isLoading || loadMoreInFlightRef.current)
+            return;
+        loadMoreInFlightRef.current = true;
+        onLoadMore();
+    }, [onLoadMore, hasMore, isLoading]);
+    const moveActive = (delta) => {
+        if (!filteredOptions.length)
+            return;
+        const next = activeIndex + delta;
+        if (delta > 0 && next >= filteredOptions.length) {
+            if (canLoadMore) {
+                triggerLoadMore();
+                return;
+            }
+            setActiveIndex(0);
+            return;
+        }
+        if (next < 0) {
+            setActiveIndex(filteredOptions.length - 1);
+            return;
+        }
+        setActiveIndex(next);
+    };
+    const moveActiveBy = (delta) => {
+        if (!filteredOptions.length)
+            return;
+        setActiveIndex((current) => Math.min(Math.max(current + delta, 0), filteredOptions.length - 1));
+    };
+    const moveActiveToEdge = (edge) => {
+        if (!filteredOptions.length)
+            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";
+        switch (event.key) {
+            case "ArrowDown":
+                event.preventDefault();
+                moveActive(1);
+                break;
+            case "ArrowUp":
+                event.preventDefault();
+                moveActive(-1);
+                break;
+            case "Home":
+                if (isTextInput)
+                    break;
+                event.preventDefault();
+                moveActiveToEdge("start");
+                break;
+            case "End":
+                if (isTextInput)
+                    break;
+                event.preventDefault();
+                moveActiveToEdge("end");
+                break;
+            case "PageUp":
+                event.preventDefault();
+                moveActiveBy(-PAGE_STEP);
+                break;
+            case "PageDown":
+                event.preventDefault();
+                moveActiveBy(PAGE_STEP);
+                break;
+            case "Enter": {
+                event.preventDefault();
+                const activeOption = filteredOptions[activeIndex];
+                if (activeOption)
+                    handleSelect(activeOption);
+                else if (showCreateRow)
+                    handleCreate();
+                break;
+            }
+            case "Escape":
+                event.preventDefault();
+                resetAndClose();
+                (_b = triggerRef.current) === null || _b === void 0 ? void 0 : _b.focus();
+                break;
+            case "Tab":
+                resetAndClose();
+                break;
+            default:
+                break;
+        }
+    };
+    const handleTriggerKeyDown = (event) => {
+        if (!isInteractive)
+            return;
+        if (props.isMulti && !isOpen && event.key === "Backspace" && selectedOptions.length) {
+            event.preventDefault();
+            handleSelect(selectedOptions[selectedOptions.length - 1]);
+            return;
+        }
+        if (isOpen) {
+            handleListKeyDown(event);
+            return;
+        }
+        if (["ArrowDown", "ArrowUp", "Enter", " "].includes(event.key)) {
+            event.preventDefault();
+            handleOpen();
+        }
+    };
+    const handleListScroll = (event) => {
+        const { scrollTop: nextScrollTop, clientHeight, scrollHeight } = event.currentTarget;
+        if (shouldVirtualize)
+            setScrollTop(nextScrollTop);
+        if (nextScrollTop + clientHeight >= scrollHeight - LOAD_MORE_THRESHOLD_PX)
+            triggerLoadMore();
+    };
+    const handleFilterChange = (event) => {
+        const nextText = event.target.value;
+        if (!isSearchControlled)
+            setUncontrolledSearch(nextText);
+        setActiveIndex(0);
+        if (!onSearchChange)
+            return;
+        if (!searchDebounceMs) {
+            onSearchChange(nextText);
+            return;
+        }
+        clearTimeout(searchDebounceTimer.current);
+        searchDebounceTimer.current = setTimeout(() => onSearchChange(nextText), searchDebounceMs);
+    };
+    const activeOption = filteredOptions[activeIndex];
+    const activeDescendantId = activeOption
+        ? optionDomId(listboxId, activeOption.id)
+        : showCreateRow
+            ? 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 visibleChipOptions = showChips ? selectedOptions.slice(0, maxVisibleChips) : [];
+    const overflowChipCount = showChips ? selectedOptions.length - visibleChipOptions.length : 0;
+    const showClear = isClearable && isInteractive && selectedOptions.length > 0;
+    const triggerSx = (0, react_1.useMemo)(() => ({
+        ...(0, fieldStyles_1.fieldControlStyles)(colors),
+        ...(0, chipTriggerSize_1.chipTriggerSizeStyles)(size, showChips, chipSize),
+        ...(selectedOptions.length ? {} : { color: colors.textMuted }),
+        ...(isOpen
+            ? { borderColor: error ? colors.semanticText.error : colors.primary[500], boxShadow: (0, focusRing_styles_1.focusGlowShadow)(colors) }
+            : {}),
+        ...(0, motion_2.reducedMotionSx)(),
+    }), [colors, size, showChips, chipSize, selectedOptions.length, isOpen, error]);
+    const defaultTriggerContent = () => {
+        var _a;
+        if (props.isMulti) {
+            const max = (_a = props.maxLabelsBeforeSummary) !== null && _a !== void 0 ? _a : 2;
+            if (selectedOptions.length === 0)
+                return placeholder;
+            if (selectedOptions.length > max)
+                return `${selectedOptions.length} selected`;
+            return selectedOptions.map((o) => o.label).join(", ");
+        }
+        return selectedOptions[0] ? selectedOptions[0].label : placeholder;
+    };
+    const triggerAriaLabel = () => {
+        const base = ariaLabel !== null && ariaLabel !== void 0 ? ariaLabel : label;
+        if (!showChips)
+            return base;
+        const summary = defaultTriggerContent();
+        return base ? `${base}: ${summary}` : `${summary}`;
+    };
+    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, { 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: `0.063rem solid ${colors.boxborder[200]}`, 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": (_d = label !== null && label !== void 0 ? label : ariaLabel) !== null && _d !== void 0 ? _d : 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: "0.6875rem", 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));
+                                            })
+                                            : ((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 })] }));
+});
+exports.default = SelectPopup;