pixelize-design-library 2.4.2-beta.43 → 2.4.2-beta.44

package/dist/Components/SelectSearch/SelectSearch.js

@@ -7,13 +7,19 @@ exports.default = SelectSearch;
 const jsx_runtime_1 = require("react/jsx-runtime");
 const react_1 = require("react");
 const react_2 = require("@chakra-ui/react");
+const Avatar_1 = __importDefault(require("../Avatar/Avatar"));
 const FormLabel_1 = require("../Common/FormLabel");
 const fieldStyles_1 = require("../Common/fieldStyles");
+const useFieldIds_1 = require("../Common/useFieldIds");
+const FieldMessage_1 = __importDefault(require("../Common/FieldMessage"));
+const motion_1 = require("../../Theme/tokens/primitives/motion");
+const controlSizes_1 = require("../../Theme/tokens/primitives/controlSizes");
+const motion_2 = require("../../Theme/chakra/motion");
 const useCustomTheme_1 = require("../../Theme/useCustomTheme");
 const rowStates_1 = require("../../Theme/tokens/builders/rowStates");
 const useExclusiveOverlay_1 = require("../../Hooks/useExclusiveOverlay");
 const lucide_react_1 = require("lucide-react");
-const ErrorMessage_1 = __importDefault(require("../Common/ErrorMessage"));
+const ROW_TRANSITION = (0, motion_1.transitionFor)(["background-color"]);
 const RenderOptions = ({ isOptionLoading, filteredOptions, loadingText, handleOptionClick, isProfile, isColorOptions, isOptionSelected, activeIndex, optionRefs, }) => {
     const theme = (0, useCustomTheme_1.useCustomTheme)();
     const rowBackgrounds = (0, react_1.useMemo)(() => (0, rowStates_1.listRowBackgrounds)(theme.colors), [theme.colors]);
@@ -33,27 +39,22 @@ const RenderOptions = ({ isOptionLoading, filteredOptions, loadingText, handleOp
                         : "transparent";
                 return ((0, jsx_runtime_1.jsxs)(react_2.Box, { as: "button", type: "button", ref: (el) => {
                         optionRefs.current[index] = el;
-                    }, role: "option", "aria-selected": selected, tabIndex: isActive ? 0 : -1, w: "100%", textAlign: "left", border: "none", fontFamily: "inherit", bg: rowBg, px: 4, py: 2, cursor: "pointer", color: theme.colors.text[700], fontWeight: selected ? 600 : 500, transition: "background 0.12s ease", _hover: {
+                    }, role: "option", "aria-selected": selected, tabIndex: isActive ? 0 : -1, w: "100%", textAlign: "left", border: "none", fontFamily: "inherit", bg: rowBg, px: 4, py: 1.5, fontSize: "0.8125rem", cursor: "pointer", color: theme.colors.text[700], fontWeight: selected ? 600 : 400, transition: ROW_TRANSITION, sx: (0, motion_2.reducedMotionSx)(), _hover: {
                         bg: selected ? rowBackgrounds.selectedActive : rowBackgrounds.active,
                     }, onClick: () => handleOptionClick(option), onKeyDown: (e) => {
                         if (e.key === "Enter" || e.key === " ") {
                             e.preventDefault();
                             handleOptionClick(option);
                         }
-                    }, display: "flex", alignItems: "center", gap: "0.5rem", children: [isProfile && ((0, jsx_runtime_1.jsx)(react_2.Box, { children: (0, jsx_runtime_1.jsx)(react_2.Avatar, { size: "sm", name: option.label.toLocaleUpperCase(), src: option.profileUrl ? option.profileUrl : undefined }) })), isColorOptions && ((0, jsx_runtime_1.jsx)(react_2.Box, { width: "0.8rem", height: "0.8rem", content: "", backgroundColor: option === null || option === void 0 ? void 0 : option.color, borderRadius: "50%" })), (0, jsx_runtime_1.jsxs)(react_2.Box, { children: [(0, jsx_runtime_1.jsx)(react_2.Box, { children: option.label }), option.email && ((0, jsx_runtime_1.jsx)(react_2.Box, { fontSize: 12, color: theme.colors.textMuted, children: option.email }))] })] }, option.id));
+                    }, display: "flex", alignItems: "center", gap: "0.5rem", children: [isProfile && ((0, jsx_runtime_1.jsx)(react_2.Box, { children: (0, jsx_runtime_1.jsx)(Avatar_1.default, { size: "sm", name: option.label.toLocaleUpperCase(), src: option.profileUrl ? option.profileUrl : undefined }) })), isColorOptions && ((0, jsx_runtime_1.jsx)(react_2.Box, { width: "0.8rem", height: "0.8rem", content: "", backgroundColor: option === null || option === void 0 ? void 0 : option.color, borderRadius: "50%" })), (0, jsx_runtime_1.jsxs)(react_2.Box, { children: [(0, jsx_runtime_1.jsx)(react_2.Box, { children: option.label }), option.email && ((0, jsx_runtime_1.jsx)(react_2.Box, { fontSize: "0.75rem", color: theme.colors.textMuted, children: option.email }))] })] }, option.id));
             }) }));
     }
     return ((0, jsx_runtime_1.jsx)(react_2.Text, { px: 4, py: 2, color: theme.colors.textMuted, children: "No options found" }));
 };
-/** Search-as-you-type combobox with avatar/color/email rows — Enter only picks on an exact label match, not the highlighted option. */
-function SelectSearch({ options, initialSelectedOption, onOptionSelect, inputOnchange, id, name, label, inputStyle, isOptionLoading, loadingText = "loading", boxStyle, placeholder = "Select Option", searchQuery = null, isInformation = false, informationMessage, rightIcon, rightElementStyle, isMultipleSelect = false, isRequired = false, onOptionMultiSelect, error = false, isProfile = false, isBottomIcon = false, errorMessage, 
-// BottomIconStyle,
-BottomIcon = false, BottomText, handleBottomClick, BottomTextColor, isColorOptions, }) {
+/** Prefer `Select` with `native={false}` for new work — not yet a drop-in; see select-absorption-spec.md. */
+function SelectSearch({ options, initialSelectedOption, onOptionSelect, inputOnchange, id, name, label, inputStyle, isOptionLoading, loadingText = "loading", boxStyle, placeholder = "Select Option", searchQuery = null, isInformation = false, informationMessage, rightIcon, rightElementStyle, isMultipleSelect = false, isRequired = false, onOptionMultiSelect, error = false, isProfile = false, isBottomIcon = false, errorMessage, helperText, size = controlSizes_1.DEFAULT_CONTROL_SIZE, BottomIcon = false, BottomText, handleBottomClick, BottomTextColor, isColorOptions, }) {
     const theme = (0, useCustomTheme_1.useCustomTheme)();
-    const errorBorder = `2px solid ${theme.colors.semanticText.error}`;
-    // [800], not [500]: WCAG 1.4.11 needs >=3.0 for a control boundary against any named surface
-    // up to `muted` (lightest); [500] fails there, [800] clears all with margin.
-    const defaultBorderThin = `1px solid ${theme.colors.boxborder[500]}`;
+    const ids = (0, useFieldIds_1.useFieldIds)(id, { error, errorMessage, helperText });
     const [selectedOptions, setSelectedOptions] = (0, react_1.useState)(initialSelectedOption ? [initialSelectedOption] : []);
     const [inputValue, setInputValue] = (0, react_1.useState)(searchQuery);
     const [isOpen, setIsOpen] = (0, react_1.useState)(false);
@@ -66,14 +67,10 @@ BottomIcon = false, BottomText, handleBottomClick, BottomTextColor, isColorOptio
     const inputRef = (0, react_1.useRef)(null);
     const dropdownRef = (0, react_1.useRef)(null);
     const listboxId = (0, react_1.useId)();
-    // Roving-tabindex keyboard nav for the options list (same shape as
-    // Table/filters/CompactSelect's listbox pattern): real DOM focus moves
-    // through the options, so no aria-activedescendant is needed.
+    // NOTE: roving-tabindex nav (same shape as Table/filters/CompactSelect) — real DOM focus, no aria-activedescendant needed.
     const optionRefs = (0, react_1.useRef)([]);
     const [activeIndex, setActiveIndex] = (0, react_1.useState)(0);
     const pendingFocusFirstOption = (0, react_1.useRef)(false);
-    // Programmatically focusing the input (Escape returning focus there) would
-    // otherwise re-trigger its own onFocus and immediately reopen the list.
     const skipNextInputFocusOpen = (0, react_1.useRef)(false);
     const closeAndFocusInput = () => {
         var _a;
@@ -86,58 +83,17 @@ BottomIcon = false, BottomText, handleBottomClick, BottomTextColor, isColorOptio
         setActiveIndex(next);
         (_a = optionRefs.current[next]) === null || _a === void 0 ? void 0 : _a.focus();
     }, []);
-    // const filteredOptions = useMemo(() => {
-    //   return options.filter((option) => {
-    //     const optionLabel = option.label || '';
-    //     const searchValue = inputValue || '';
-    //     return optionLabel.toLowerCase().includes(searchValue.toLowerCase());
-    //   });
-    // }, [options, inputValue]);
     const filteredOptions = (0, react_1.useMemo)(() => {
         return options.filter((option) => {
-            // First filter out already selected options
-            // const isNotSelected = !selectedOptions.some(
-            //   (selected) => selected.id === option.id
-            // );
             const isNotSelected = isMultipleSelect
                 ? !selectedOptions.some((selected) => selected.id === option.id)
                 : true;
-            // Then apply the search filter
             const optionLabel = option.label || "";
             const searchValue = inputValue || "";
             return (isNotSelected &&
                 optionLabel.toLowerCase().includes(searchValue.toLowerCase()));
         });
     }, [options, inputValue, isMultipleSelect, selectedOptions]);
-    // const filteredOptions = useMemo(() => {
-    //   return options.filter((option) =>
-    //     option.label?.toLowerCase().includes((inputValue ?? "")?.toLowerCase())
-    //   );
-    // }, [options, inputValue]);
-    //   const handleOptionClick = useCallback(
-    //     (option: selectOptions) => {
-    //       if (isMultipleSelect) {
-    //         setSelectedOptions((prev) => {
-    //           const isSelected = prev.some((selected) => selected.id === option.id);
-    //           const newSelected = isSelected
-    //             ? prev.filter((selected) => selected.id !== option.id)
-    //             : [...prev, option];
-    //           setInputValue("");
-    //           if (onOptionMultiSelect) {
-    //             onOptionMultiSelect(newSelected);
-    //           }
-    //           return newSelected;
-    //         });
-    //       } else {
-    //         setInputValue(option.label);
-    //         setIsOpen(false);
-    //         if (onOptionSelect) {
-    //           onOptionSelect(option);
-    //         }
-    //       }
-    //     },
-    //     [isMultipleSelect, onOptionSelect, onOptionMultiSelect]
-    //   );
     const handleOptionClick = (0, react_1.useCallback)((option) => {
         if (isMultipleSelect) {
             setSelectedOptions((prev) => {
@@ -268,31 +224,13 @@ BottomIcon = false, BottomText, handleBottomClick, BottomTextColor, isColorOptio
             document.removeEventListener("mousedown", handleClickOutside);
         };
     }, [isOpen]);
-    return ((0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: (0, jsx_runtime_1.jsx)(react_2.FormControl, { isInvalid: error, children: (0, jsx_runtime_1.jsxs)(react_2.Box, { display: "flex", flexDirection: "column", position: "relative", sx: boxStyle, children: [label && ((0, jsx_runtime_1.jsx)(FormLabel_1.TextLabel, { label: label, id: id, isRequired: isRequired, isInformation: isInformation, informationMessage: informationMessage })), isMultipleSelect && selectedOptions.length > 0 && ((0, jsx_runtime_1.jsx)(react_2.HStack, { spacing: 2, mb: 2, children: selectedOptions.map((option) => ((0, jsx_runtime_1.jsxs)(react_2.Tag, { size: "md", borderRadius: "full", variant: "solid", colorScheme: "primary", children: [(0, jsx_runtime_1.jsx)(react_2.TagLabel, { width: "50px", children: option.label }), (0, jsx_runtime_1.jsx)(react_2.TagCloseButton, { onClick: () => handleRemoveOption(option) })] }, option.id))) })), (0, jsx_runtime_1.jsxs)(react_2.InputGroup, { children: [(0, jsx_runtime_1.jsx)(react_2.Input, { ref: inputRef, variant: "outline", borderRadius: fieldStyles_1.FIELD_RADIUS, value: inputValue ? inputValue : "", onClick: openDropdown, onFocus: () => {
+    return ((0, jsx_runtime_1.jsx)(jsx_runtime_1.Fragment, { children: (0, jsx_runtime_1.jsx)(react_2.FormControl, { isInvalid: error, children: (0, jsx_runtime_1.jsxs)(react_2.Box, { display: "flex", flexDirection: "column", position: "relative", sx: boxStyle, children: [label && ((0, jsx_runtime_1.jsx)(FormLabel_1.TextLabel, { label: label, id: ids.inputId, isRequired: isRequired, isInformation: isInformation, informationMessage: informationMessage })), isMultipleSelect && selectedOptions.length > 0 && ((0, jsx_runtime_1.jsx)(react_2.HStack, { spacing: 2, mb: 2, children: selectedOptions.map((option) => ((0, jsx_runtime_1.jsxs)(react_2.Tag, { size: "md", borderRadius: "full", variant: "solid", colorScheme: "primary", children: [(0, jsx_runtime_1.jsx)(react_2.TagLabel, { width: "3.125rem", children: option.label }), (0, jsx_runtime_1.jsx)(react_2.TagCloseButton, { onClick: () => handleRemoveOption(option) })] }, option.id))) })), (0, jsx_runtime_1.jsxs)(react_2.InputGroup, { children: [(0, jsx_runtime_1.jsx)(react_2.Input, { ref: inputRef, ...ids.controlProps, variant: "outline", value: inputValue ? inputValue : "", onClick: openDropdown, onFocus: () => {
                                     if (skipNextInputFocusOpen.current) {
                                         skipNextInputFocusOpen.current = false;
                                         return;
                                     }
                                     openDropdown();
-                                }, onChange: (e) => handleInputChange(e.target.value), placeholder: placeholder, onKeyDown: handleKeyDown, id: id, name: name, role: "combobox", "aria-autocomplete": "list", "aria-haspopup": "listbox", "aria-expanded": isOpen, "aria-controls": listboxId, cursor: "pointer", borderColor: theme.colors.boxborder[500], transition: "border-color 0.2s, box-shadow 0.2s", _hover: {
-                                    borderColor: error
-                                        ? theme.colors.semanticText.error
-                                        : theme.colors.primary[500],
-                                }, _focus: {
-                                    borderColor: error
-                                        ? theme.colors.semanticText.error
-                                        : theme.colors.primary[500],
-                                    boxShadow: (0, fieldStyles_1.fieldFocusRing)(theme, !!error),
-                                }, style: {
-                                    ...inputStyle,
-                                    backgroundColor: theme.colors.background[50],
-                                    fontWeight: 600,
-                                    color: theme.colors.text[700],
-                                    padding: "0 0.75rem",
-                                    fontSize: 15,
-                                    letterSpacing: 0.7,
-                                    border: error ? errorBorder : defaultBorderThin,
-                                } }), rightIcon && ((0, jsx_runtime_1.jsx)(react_2.InputRightElement, { pointerEvents: "none", children: rightIcon, style: { ...rightElementStyle } }))] }), isOpen && ((0, jsx_runtime_1.jsxs)(react_2.Box, { ref: dropdownRef, marginTop: "5px", position: "absolute", top: position === "below" ? "100%" : "auto", bottom: position === "above" ? "100%" : "auto", left: 0, right: 0, border: "1px solid", borderColor: theme.colors.boxborder[200], borderRadius: "md", bg: theme.colors.background[50], maxHeight: "150px", overflowY: "auto", zIndex: 10, children: [(0, jsx_runtime_1.jsx)(react_2.Box, { id: listboxId, role: "listbox", "aria-label": label !== null && label !== void 0 ? label : placeholder, onKeyDown: handleListKeyDown, children: (0, jsx_runtime_1.jsx)(RenderOptions, { isOptionLoading: isOptionLoading, filteredOptions: filteredOptions, loadingText: loadingText, handleOptionClick: handleOptionClick, isProfile: isProfile, isColorOptions: isColorOptions, isOptionSelected: isOptionSelected, activeIndex: activeIndex, optionRefs: optionRefs }) }), (0, jsx_runtime_1.jsx)("hr", {}), isBottomIcon && ((0, jsx_runtime_1.jsxs)(react_2.Box, { position: "sticky", bottom: 0, background: theme.colors.background[50], display: "flex", alignItems: "center", pl: "1rem", cursor: "pointer", onClick: handleBottomClick, borderColor: theme.colors.boxborder[200], zIndex: 1, borderTop: `1px solid ${theme.colors.boxborder[200]}`, children: [(0, jsx_runtime_1.jsx)(react_2.Box, { children: BottomIcon ? BottomIcon : (0, jsx_runtime_1.jsx)(lucide_react_1.PlusIcon, { size: "1rem" }) }), (0, jsx_runtime_1.jsx)(react_2.Box, { fontSize: "0.875rem", color: BottomTextColor
+                                }, onChange: (e) => handleInputChange(e.target.value), placeholder: placeholder, onKeyDown: handleKeyDown, name: name, role: "combobox", "aria-autocomplete": "list", "aria-haspopup": "listbox", "aria-expanded": isOpen, "aria-controls": listboxId, "aria-required": isRequired || undefined, cursor: "pointer", sx: { ...(0, fieldStyles_1.fieldControlStyles)(theme.colors), ...(0, fieldStyles_1.controlSizeStyles)(size), ...(0, motion_2.reducedMotionSx)() }, style: inputStyle }), rightIcon && ((0, jsx_runtime_1.jsx)(react_2.InputRightElement, { pointerEvents: "none", children: rightIcon, style: { ...rightElementStyle } }))] }), isOpen && ((0, jsx_runtime_1.jsxs)(react_2.Box, { ref: dropdownRef, marginTop: "0.313rem", position: "absolute", top: position === "below" ? "100%" : "auto", bottom: position === "above" ? "100%" : "auto", left: 0, right: 0, border: "0.063rem solid", borderColor: theme.colors.boxborder[200], borderRadius: "xl", boxShadow: theme.shadows.lg, bg: theme.colors.surfaceRaised, maxHeight: "9.375rem", overflowY: "auto", zIndex: 10, children: [(0, jsx_runtime_1.jsx)(react_2.Box, { id: listboxId, role: "listbox", "aria-label": label !== null && label !== void 0 ? label : placeholder, onKeyDown: handleListKeyDown, children: (0, jsx_runtime_1.jsx)(RenderOptions, { isOptionLoading: isOptionLoading, filteredOptions: filteredOptions, loadingText: loadingText, handleOptionClick: handleOptionClick, isProfile: isProfile, isColorOptions: isColorOptions, isOptionSelected: isOptionSelected, activeIndex: activeIndex, optionRefs: optionRefs }) }), (0, jsx_runtime_1.jsx)("hr", {}), isBottomIcon && ((0, jsx_runtime_1.jsxs)(react_2.Box, { position: "sticky", bottom: 0, background: theme.colors.surfaceRaised, display: "flex", alignItems: "center", pl: "1rem", cursor: "pointer", onClick: handleBottomClick, borderColor: theme.colors.boxborder[200], zIndex: 1, borderTop: `1px solid ${theme.colors.boxborder[200]}`, children: [(0, jsx_runtime_1.jsx)(react_2.Box, { children: BottomIcon ? BottomIcon : (0, jsx_runtime_1.jsx)(lucide_react_1.PlusIcon, { size: "1rem" }) }), (0, jsx_runtime_1.jsx)(react_2.Box, { fontSize: "0.875rem", color: BottomTextColor
                                             ? BottomTextColor
-                                            : theme.colors.accentText, padding: "8px 8px", children: BottomText || "Add New" })] }))] })), error && (0, jsx_runtime_1.jsx)(ErrorMessage_1.default, { errorMessage: errorMessage })] }) }) }));
+                                            : theme.colors.accentText, padding: "8px 8px", children: BottomText || "Add New" })] }))] })), (0, jsx_runtime_1.jsx)(FieldMessage_1.default, { error: error, errorMessage: errorMessage, helperText: helperText, helperId: ids.helperId, errorId: ids.errorId })] }) }) }));
 }

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

@@ -1,38 +1,67 @@
-/** Props for the searchable combobox `SelectSearch`; supports multi-select chips and profile/color option rows. */
+import type { ControlSize } from "../../Theme/tokens/primitives/controlSizes";
+/** Prefer `Select` with `native={false}` for new work — not a drop-in: its combobox is the text input itself. See select-absorption-spec.md. */
 export type SelectSearchProps = {
     options: selectOptions[];
-    /** Not implemented — never read by the component; the search input always renders regardless of this value. */
+    /** @deprecated Never read — the search input always renders. */
     isSearchEnabled?: boolean;
     /** Seeds state once on mount (useState initializer) — changing it later does not update the selection; no sync effect. */
     initialSelectedOption?: selectOptions | null;
+    /** Single mode only; fires on pick and writes the option label into the input. */
     onOptionSelect?: (option: selectOptions) => void;
+    /** Multi mode only; receives the full selection after each toggle or chip removal. */
     onOptionMultiSelect?: (option: selectOptions[]) => void;
+    /** Fires on every keystroke, undebounced; local label filtering runs regardless. */
     inputOnchange: (value: string | number) => void;
     id?: string;
     name?: string;
     label?: string;
+    /** Inline style on the text input. */
     inputStyle?: React.CSSProperties;
+    /** `sx` on the wrapper around label, chips, input and popup. */
     boxStyle?: React.CSSProperties;
+    /** Replaces the whole option list with a spinner and `loadingText`. */
     isOptionLoading?: boolean;
+    /** Defaults to "loading" (lowercase). */
     loadingText?: string;
+    /** Defaults to "Select Option"; also the listbox's accessible name when `label` is absent. */
     placeholder?: string;
+    /** Seeds the input text once on mount; later changes are ignored. */
     searchQuery: string | null;
+    /** Info icon beside the label; needs `label` and `informationMessage` too. */
     isInformation?: boolean;
+    /** Tooltip text for the info icon; ignored unless `isInformation` is true. */
     informationMessage?: string;
+    /** Decorative only — rendered with `pointerEvents: none`, so it can't be clicked. */
     rightIcon?: React.ReactNode;
+    /** Inline style on the right-icon slot; ignored without `rightIcon`. */
     rightElementStyle?: object;
+    /** Multi mode: chips above the input, selected options hidden from the list. */
     isMultipleSelect?: boolean;
+    /** Label asterisk + `aria-required` only; never blocks submission. */
     isRequired?: boolean | undefined;
+    /** Marks the field invalid and swaps `helperText` for `errorMessage`. */
     error?: boolean | undefined;
+    /** Prefixes each row with an avatar built from `profileUrl` (falls back to label initials). */
     isProfile?: boolean | undefined;
+    /** Prefixes each row with a dot filled with the option's `color`. */
     isColorOptions?: boolean | undefined;
+    /** Rendered only while `error` is true. */
     errorMessage?: string | undefined;
+    /** Hint under the field; replaced by `errorMessage` while `error` is true. */
+    helperText?: string;
+    /** Height on the shared control scale (xs 24 · sm 32 · md 40 · lg 48px). Defaults to `sm`. */
+    size?: ControlSize;
+    /** Shows a sticky "Add New"-style footer row in the popup; required for all Bottom* props. */
     isBottomIcon?: boolean | undefined;
+    /** Footer icon element; omit for a plus icon — `true` renders no icon at all. */
     BottomIcon?: boolean | undefined | JSX.Element;
+    /** @deprecated Never read by the component. */
     BottomIconStyle?: React.CSSProperties;
+    /** Footer text. Defaults to "Add New". */
     BottomText?: string | number;
     /** Despite the CSSProperties type, pass a plain color string (e.g. "red") — used directly as one, not spread as styles. */
     BottomTextColor?: React.CSSProperties;
+    /** Fires on footer row click; the popup stays open. */
     handleBottomClick?: () => void;
 };
 /** Option shape for SelectSearch; `email`/`profileUrl` back `isProfile` rows, `color` backs `isColorOptions` rows. */

package/dist/Components/SelectV2/SelectV2.d.ts

@@ -1,3 +1,15 @@
-import { SelectV2Props } from "./SelectV2Props";
-/** Themed custom-popup select (fully React-rendered popup); not virtualized — for very large option lists, prefer SearchSelect. */
-export default function SelectV2(props: SelectV2Props): import("react/jsx-runtime").JSX.Element;
+import React from "react";
+import { type ControlSize } from "../../Theme/tokens/primitives/controlSizes";
+import type { SelectV2Props } from "./SelectV2Props";
+type ChipSize = "xs" | "sm";
+export declare const chipTriggerSizeStyles: (size: ControlSize, hasChips: boolean, chipSize?: ChipSize) => {
+    minH: string;
+    fontSize: string;
+    px: string;
+    h?: string;
+    py?: string;
+};
+/** @deprecated Use `Select` with `native={false}`. See MERGE-NOTES-select-deprecation.md. */
+declare const SelectV2: React.ForwardRefExoticComponent<SelectV2Props & React.RefAttributes<HTMLDivElement>>;
+/** @deprecated Use `Select` with `native={false}`. */
+export default SelectV2;

package/dist/Components/SelectV2/SelectV2.js

@@ -1,272 +1,25 @@
 "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 });
-exports.default = SelectV2;
+exports.chipTriggerSizeStyles = void 0;
 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 placeholderInk_1 = require("../../Theme/tokens/builders/placeholderInk");
-const rowStates_1 = require("../../Theme/tokens/builders/rowStates");
-const scrollbar_1 = require("../../Theme/tokens/builders/scrollbar");
-const fieldStyles_1 = require("../Common/fieldStyles");
-const useExclusiveOverlay_1 = require("../../Hooks/useExclusiveOverlay");
-const FormLabel_1 = require("../Common/FormLabel");
-const ErrorMessage_1 = __importDefault(require("../Common/ErrorMessage"));
-const HelperText_1 = __importDefault(require("../Common/HelperText"));
-// Mirrors Select.styles.ts sizing so a call site swapping Select -> SelectV2 keeps its layout.
-const SIZE_MAP = {
-    sm: { h: "2.125rem", fontSize: "0.8125rem", px: "0.5rem" },
-    md: { h: "2.375rem", fontSize: "0.875rem", px: "0.75rem" },
-    lg: { h: "2.75rem", fontSize: "0.9375rem", px: "1rem" },
+const react_1 = require("react");
+const Select_1 = __importDefault(require("../Select/Select"));
+const controlSizes_1 = require("../../Theme/tokens/primitives/controlSizes");
+const CHIP_TAG_HEIGHT_PX = { xs: 20, sm: 24 };
+const controlHeightPx = (size) => parseFloat(controlSizes_1.CONTROL_SIZES[size].height) * 16;
+const chipRowPaddingY = (size, chipSize) => `${(controlHeightPx(size) - CHIP_TAG_HEIGHT_PX[chipSize]) / 2 / 16}rem`;
+const chipTriggerSizeStyles = (size, hasChips, chipSize = "sm") => {
+    const spec = controlSizes_1.CONTROL_SIZES[size];
+    const base = { minH: spec.height, fontSize: spec.fontSize, px: spec.paddingX };
+    return hasChips ? { ...base, py: chipRowPaddingY(size, chipSize) } : { ...base, h: spec.height };
 };
-const asIdSet = (values) => new Set((values !== null && values !== void 0 ? values : []).map((v) => v.toString()));
-// Derived from the option's own id (not its index) so it stays stable across filtering/reordering.
-const optionDomId = (listboxId, id) => `${listboxId}-option-${id.toString().replace(/[^a-zA-Z0-9_-]/g, "-")}`;
-const OptionRow = react_1.default.memo(function OptionRow({ option, index, listboxId, isSelected, isActive, isMulti, theme, backgrounds, renderOption, onSelect, onActivate, }) {
-    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: 1.5, px: 2.5, py: 1.5, borderRadius: "md", cursor: option.isDisabled ? "not-allowed" : "pointer", opacity: option.isDisabled ? 0.4 : 1, display: "flex", alignItems: "center", gap: 2, fontSize: "0.8125rem", fontWeight: isSelected && !isMulti ? 600 : 500, color: isSelected && !isMulti
-            ? theme.colors.accentText
-            : theme.colors.text[700], bg: isSelected && !isMulti
-            ? isActive
-                ? backgrounds.selectedActive
-                : backgrounds.selected
-            : isActive
-                ? backgrounds.active
-                : "transparent", transition: "background 0.12s ease, color 0.12s ease", children: [isMulti ? ((0, jsx_runtime_1.jsx)(react_2.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: "0.75rem", fontWeight: 400, color: theme.colors.textMuted, isTruncated: true, children: option.description })) : null] })] }))] }));
+exports.chipTriggerSizeStyles = chipTriggerSizeStyles;
+/** @deprecated Use `Select` with `native={false}`. See MERGE-NOTES-select-deprecation.md. */
+const SelectV2 = (0, react_1.forwardRef)(function SelectV2(props, ref) {
+    return (0, jsx_runtime_1.jsx)(Select_1.default, { ...props, native: false, ref: ref });
 });
-/** Themed custom-popup select (fully React-rendered popup); not virtualized — for very large option lists, prefer SearchSelect. */
-function SelectV2(props) {
-    var _a, _b;
-    const { options = [], placeholder = "Select Option", label, error = false, errorMessage, helperText, isDisabled = false, isRequired = false, size = "md", isSearchable = true, width, formControlStyle, onBlur, onFocus, renderOption, renderValue, maxMenuHeight = "16rem", defaultOpen = false, "data-testid": dataTestId, "aria-label": ariaLabel, } = props;
-    const theme = (0, useCustomTheme_1.useCustomTheme)();
-    const { isOpen, onOpen, onClose } = (0, react_2.useDisclosure)({ defaultIsOpen: defaultOpen });
-    const requestExclusiveOpen = (0, useExclusiveOverlay_1.useExclusiveOverlay)(isOpen, onClose);
-    const [filterText, setFilterText] = (0, react_1.useState)("");
-    const [activeIndex, setActiveIndex] = (0, react_1.useState)(-1);
-    const triggerRef = (0, react_1.useRef)(null);
-    const filterInputRef = (0, react_1.useRef)(null);
-    const listRef = (0, react_1.useRef)(null);
-    const s = (_a = SIZE_MAP[size]) !== null && _a !== void 0 ? _a : SIZE_MAP.md;
-    const fieldStyles = (0, react_1.useMemo)(() => (0, fieldStyles_1.getFieldStateStyles)(theme, { error, focused: isOpen }), [theme, error, isOpen]);
-    const selectedIds = (0, react_1.useMemo)(() => props.isMulti
-        ? asIdSet(props.value)
-        : asIdSet(props.value !== undefined ? [props.value] : undefined), 
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-    [props.isMulti, props.isMulti ? props.value : props.value]);
-    const selectedOptions = (0, react_1.useMemo)(() => options.filter((option) => selectedIds.has(option.id.toString())), [options, selectedIds]);
-    const filteredOptions = (0, react_1.useMemo)(() => {
-        if (!isSearchable || !filterText.trim())
-            return options;
-        const needle = filterText.trim().toLowerCase();
-        return options.filter((option) => option.label.toString().toLowerCase().includes(needle));
-    }, [options, filterText, isSearchable]);
-    const resetAndClose = (0, react_1.useCallback)((opts) => {
-        if (props.isMulti && (opts === null || opts === void 0 ? void 0 : opts.keepOpenForMulti))
-            return;
-        onClose();
-        setFilterText("");
-        setActiveIndex(-1);
-        onBlur === null || onBlur === void 0 ? void 0 : onBlur();
-    }, [onClose, onBlur, props.isMulti]);
-    const handleOpen = () => {
-        var _a;
-        if (isDisabled)
-            return;
-        requestExclusiveOpen();
-        onFocus === null || onFocus === void 0 ? void 0 : onFocus();
-        onOpen();
-        const firstSelected = props.isMulti ? (_a = props.value) === null || _a === void 0 ? void 0 : _a[0] : props.value;
-        const selectedFilteredIndex = filteredOptions.findIndex((option) => option.id.toString() === (firstSelected === null || firstSelected === void 0 ? void 0 : firstSelected.toString()));
-        setActiveIndex(selectedFilteredIndex);
-    };
-    const handleSelect = (0, react_1.useCallback)((option) => {
-        var _a, _b;
-        if (option.isDisabled)
-            return;
-        if (props.isMulti) {
-            const alreadySelected = selectedIds.has(option.id.toString());
-            const next = alreadySelected
-                ? selectedOptions.filter((selected) => selected.id.toString() !== option.id.toString())
-                : [...selectedOptions, option];
-            props.onChange(next);
-            resetAndClose({ keepOpenForMulti: true });
-            (_a = filterInputRef.current) === null || _a === void 0 ? void 0 : _a.focus();
-            return;
-        }
-        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, selectedIds, selectedOptions, resetAndClose]);
-    (0, react_1.useEffect)(() => {
-        if (isOpen && isSearchable) {
-            // Popover content mounts after open; defer focus so it lands on the rendered input.
-            const id = requestAnimationFrame(() => { var _a; return (_a = filterInputRef.current) === null || _a === void 0 ? void 0 : _a.focus(); });
-            return () => cancelAnimationFrame(id);
-        }
-    }, [isOpen, isSearchable]);
-    (0, react_1.useEffect)(() => {
-        var _a;
-        if (activeIndex < 0 || !listRef.current)
-            return;
-        const activeEl = listRef.current.querySelector(`[data-index="${activeIndex}"]`);
-        (_a = activeEl === null || activeEl === void 0 ? void 0 : activeEl.scrollIntoView) === null || _a === void 0 ? void 0 : _a.call(activeEl, { block: "nearest" });
-    }, [activeIndex]);
-    const moveActive = (delta) => {
-        if (!filteredOptions.length)
-            return;
-        setActiveIndex((current) => {
-            const next = current + delta;
-            if (next < 0)
-                return filteredOptions.length - 1;
-            if (next >= filteredOptions.length)
-                return 0;
-            return next;
-        });
-    };
-    // Page keys jump-and-clamp rather than wrap, matching the APG listbox pattern.
-    const PAGE_STEP = 8;
-    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 handleTriggerKeyDown = (event) => {
-        if (isDisabled)
-            return;
-        if (!isOpen) {
-            if (event.key === "ArrowDown" || event.key === "ArrowUp" || event.key === "Enter" || event.key === " ") {
-                event.preventDefault();
-                handleOpen();
-            }
-            return;
-        }
-        // Popup already open with focus still on the trigger (isSearchable=false has no
-        // filter input to move focus into) — drive the same listbox navigation from here.
-        handleListKeyDown(event);
-    };
-    const handleListKeyDown = (event) => {
-        var _a, _b;
-        // Home/End on the type-ahead filter input must move the text cursor, not the active option.
-        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);
-                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 instanceId = (0, react_1.useId)();
-    const listboxId = `selectv2-listbox-${instanceId}`;
-    const triggerId = `selectv2-trigger-${instanceId}`;
-    const activeOption = filteredOptions[activeIndex];
-    const activeDescendantId = activeOption ? optionDomId(listboxId, activeOption.id) : undefined;
-    const listScrollStyles = (0, react_1.useMemo)(() => (0, scrollbar_1.scrollbarStyles)(theme.colors, "overlay"), [theme]);
-    // primary[500] is the filled-button rung, so resolveHoverTint short-circuited and every hovered
-    // row became a solid brand fill under unresolved ink.
-    const rowBackgrounds = (0, react_1.useMemo)(() => (0, rowStates_1.listRowBackgrounds)(theme.colors), [theme]);
-    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 triggerIcon = !props.isMulti && ((_b = selectedOptions[0]) === null || _b === void 0 ? void 0 : _b.icon) ? selectedOptions[0].icon : null;
-    return ((0, jsx_runtime_1.jsxs)(react_2.FormControl, { isInvalid: error, isDisabled: isDisabled, style: formControlStyle, width: width, children: [label && ((0, jsx_runtime_1.jsx)(FormLabel_1.TextLabel, { label: label, id: triggerId, isRequired: isRequired })), (0, jsx_runtime_1.jsxs)(react_2.Popover, { isOpen: isOpen, onClose: () => resetAndClose(), placement: "bottom-start", matchWidth: true, 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: "button", type: "button", id: triggerId, ref: triggerRef, role: "combobox", "aria-haspopup": "listbox", "aria-expanded": isOpen, "aria-controls": listboxId, "aria-activedescendant": activeDescendantId, "aria-disabled": isDisabled, "aria-label": ariaLabel, disabled: isDisabled, onClick: handleOpen, onKeyDown: handleTriggerKeyDown, display: "flex", alignItems: "center", justifyContent: "space-between", width: "100%", h: s.h, px: s.px, fontSize: s.fontSize, fontWeight: 500, textAlign: "left", cursor: isDisabled ? "not-allowed" : "pointer", opacity: isDisabled ? 0.4 : 1, color: selectedOptions.length ? theme.colors.text[900] : (0, placeholderInk_1.placeholderInk)(theme.colors), "data-testid": dataTestId, ...fieldStyles, children: [(0, jsx_runtime_1.jsxs)(react_2.Box, { as: "span", display: "inline-flex", alignItems: "center", gap: 1.5, minW: 0, isTruncated: true, 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() })] }), (0, jsx_runtime_1.jsx)(react_2.Box, { as: "span", display: "inline-flex", flexShrink: 0, ml: 2, transition: "transform 0.2s ease", transform: isOpen ? "rotate(180deg)" : "rotate(0deg)", color: theme.colors.textMuted, children: (0, jsx_runtime_1.jsx)(lucide_react_1.ChevronDown, { size: 16 }) })] }) }), (0, jsx_runtime_1.jsx)(react_2.Portal, { children: (0, jsx_runtime_1.jsxs)(react_2.PopoverContent, { width: "100%", borderRadius: "xl", boxShadow: theme.shadows.lg, overflow: "hidden", onKeyDown: handleListKeyDown, children: [isSearchable && ((0, jsx_runtime_1.jsx)(react_2.Box, { p: 2, borderBottom: `0.063rem solid ${theme.colors.boxborder[200]}`, children: (0, jsx_runtime_1.jsx)(react_2.Input, { ref: filterInputRef, size: "sm", placeholder: "Type to filter...", value: filterText, onChange: (event) => {
-                                            setFilterText(event.target.value);
-                                            setActiveIndex(0);
-                                        }, "aria-activedescendant": activeDescendantId, "aria-label": "Filter options" }) })), (0, jsx_runtime_1.jsxs)(react_2.Box, { id: listboxId, ref: listRef, role: "listbox", "aria-multiselectable": props.isMulti || undefined, maxH: maxMenuHeight, overflowY: "auto", py: 1, sx: listScrollStyles, children: [filteredOptions.length === 0 && ((0, jsx_runtime_1.jsx)(react_2.Box, { px: 3, py: 2, fontSize: "0.8125rem", color: theme.colors.textMuted, children: "No Options" })), filteredOptions.map((option, index) => {
-                                            var _a;
-                                            return ((0, jsx_runtime_1.jsx)(OptionRow, { option: option, index: index, listboxId: listboxId, isSelected: selectedIds.has(option.id.toString()), isActive: index === activeIndex, isMulti: (_a = props.isMulti) !== null && _a !== void 0 ? _a : false, theme: theme, backgrounds: rowBackgrounds, renderOption: renderOption, onSelect: handleSelect, onActivate: setActiveIndex }, option.id));
-                                        })] })] }) })] }), error && (0, jsx_runtime_1.jsx)(ErrorMessage_1.default, { errorMessage: errorMessage }), helperText && !error && (0, jsx_runtime_1.jsx)(HelperText_1.default, { helperText: helperText })] }));
-}
+/** @deprecated Use `Select` with `native={false}`. */
+exports.default = SelectV2;