@astryxdesign/core 0.3.0 → 0.4.0-canary.058f476

package/dist/MultiSelector/MultiSelector.js

@@ -20,20 +20,22 @@ import * as stylex from '@stylexjs/stylex';
 import { usePopover } from "../Popover/usePopover.js";
 import { useTooltip } from "../Tooltip/index.js";
 import { Icon, renderIconSlot } from "../Icon/index.js";
-import { Field, inputStatusBorderStyles, inputStatusHoverShadowStyles, inputWrapperStyles } from "../Field/index.js";
+import { Field, InputClearButton, inputStatusBorderStyles, inputStatusHoverShadowStyles, inputWrapperStyles } from "../Field/index.js";
 import { Divider } from "../Divider/index.js";
 import { Spinner } from "../Spinner/index.js";
-import { TextInput } from "../TextInput/index.js";
+import { PanelSearchInput } from "../Field/PanelSearchInput.js";
 import { CheckboxInput } from "../CheckboxInput/index.js";
 import { Badge } from "../Badge/index.js";
 import "../theme/tokens.stylex.js";
-import { colorVars, sizeVars, spacingVars, radiusVars, durationVars, easeVars, typographyVars, fontWeightVars, typeScaleVars, borderVars } from "../theme/tokens.stylex.js";
+import { colorVars, sizeVars, spacingVars, radiusVars, durationVars, easeVars, typographyVars, fontWeightVars, typeScaleVars } from "../theme/tokens.stylex.js";
 import { isOptionData, isDivider, isSection, normalizeOption, getSelectableOptions } from "../Selector/utils.js";
 import { useMultiCombobox } from "./hooks.js";
 import { getInputARIA, mergeProps } from "../utils/index.js";
 import { useAnnounce } from "../hooks/useAnnounce.js";
 import { useSize } from "../SizeContext/SizeContext.js";
 import { themeProps } from "../utils/themeProps.js";
+import { focusOutlineStyles } from "../utils/focusOutline.stylex.js";
+import { stableClassName } from "../naming.js";
 import { groupStyles } from "../InputGroup/groupStyles.js";
 import { useInputGroup } from "../InputGroup/InputGroupContext.js";
 import { VisuallyHidden } from "../VisuallyHidden/index.js";
@@ -63,6 +65,21 @@ const styles = {
     kMwMTN: "xv1l7n4",
     $$css: true
   },
+  triggerIcon: {
+    kmuXW: "x2lah0s",
+    $$css: true
+  },
+  triggerIconRotation: {
+    k1ekBW: "x11xpdln",
+    kIyJzY: "xuedmi6",
+    kAMwcw: "xlr8y92",
+    k3nNDw: "x1g0ag68",
+    $$css: true
+  },
+  triggerIconOpen: {
+    k3aq6I: "x19jd1h0",
+    $$css: true
+  },
   triggerGhost: {
     kzqmXN: "x14atkfc",
     kMzoRj: "xc342km",
@@ -70,8 +87,6 @@ const styles = {
     kKwaWg: "x1ilzqfv xq8i9tn",
     kGVxlE: "x1gnnqk1 x1irk71m x15ysqaf",
     k63SB2: "x1e4wzip",
-    kI3sdo: "x1a2a7pz x1irc7jg",
-    kInvED: "x1wfwxd8 xscfbxq",
     k1ekBW: "xrafxwg",
     k3aq6I: "x3oybdh xk4oym4",
     $$css: true
@@ -81,9 +96,22 @@ const styles = {
     k3aq6I: "x1c071of x1pdlv7q",
     $$css: true
   },
+  statusButton: {
+    k1xSpc: "x78zum5",
+    kGNEyG: "x6s0dn4",
+    kjj79g: "xl56j7k",
+    kmVPX3: "x1717udv",
+    kogj98: "x1ghz6dp",
+    kMzoRj: "xc342km",
+    ksu8eU: "xng3xce",
+    kWkggS: "xjbqb8w",
+    kMwMTN: "x1heor9g",
+    kkrTdU: "x1ypdohk",
+    kaIpWk: "xh6dtrn",
+    $$css: true
+  },
   popover: {
     k7Eaqz: "xrzjruh",
-    keoZOQ: "xcsaf9d",
     $$css: true
   },
   selectAllWrapper: {
@@ -93,10 +121,6 @@ const styles = {
     kkrTdU: "x1ypdohk",
     $$css: true
   },
-  sectionDivider: {
-    kqGvvJ: "xsq74q5",
-    $$css: true
-  },
   divider: {
     kqGvvJ: "xsq74q5",
     $$css: true
@@ -109,6 +133,10 @@ const styles = {
     kzqmXN: "xh8yej3",
     kaIpWk: "xh6dtrn",
     kkrTdU: "x1ypdohk",
+    kMv6JI: "x9ynric",
+    kGuDYH: "xcr08ib",
+    k63SB2: "x1e4wzip",
+    kMwMTN: "x1tgivj0",
     kWkggS: "xjbqb8w",
     kI3sdo: "x1a2a7pz",
     $$css: true
@@ -119,6 +147,7 @@ const styles = {
   },
   itemDisabled: {
     kSiTet: "xbyyjgo",
+    kMwMTN: "xnbbluu",
     kkrTdU: "x1h6gzvc",
     $$css: true
   }
@@ -248,6 +277,7 @@ export function MultiSelector({
   triggerDisplay = 'count',
   maxBadges = 3,
   renderOption,
+  indicatorPosition = 'start',
   isDefaultOpen = false,
   'data-testid': testId,
   htmlName,
@@ -272,7 +302,7 @@ export function MultiSelector({
   const searchRef = useRef(null);
   const inputGroup = useInputGroup();
   const [searchQuery, setSearchQuery] = useState('');
-  // A typed query shows TextInput's built-in clear (✕) button, which becomes
+  // A typed query shows the search row's clear (✕) button, which becomes
   // the next tab stop after the search input.
   const hasQuery = searchQuery.length > 0;
 
@@ -389,7 +419,10 @@ export function MultiSelector({
     hasAutoFocus: false,
     // The popup's own role="listbox" is the exposed semantics; the trigger
     // keeps DOM focus, so wrapping it in a modal dialog would misrepresent it.
-    role: 'none'
+    role: 'none',
+    // The theme target belongs on the SURFACE that paints the popup, which
+    // `usePopover` owns — not on the scrolling list inside it.
+    surfaceTarget: 'multi-selector-popup'
   });
 
   // Open dropdown on mount when isDefaultOpen is true
@@ -595,13 +628,36 @@ export function MultiSelector({
     if (!hasSearch) {
       return null;
     }
-    return /*#__PURE__*/_jsx("div", {
-      ...{
-        className: "x78zum5 x6s0dn4 xf314gf xu0wf1k"
-      },
-      onKeyDown: e => {
-        // The clear (✕) button lives inside the TextInput, after the input in
-        // DOM order. When it is focused and the user tabs forward there is
+    return /*#__PURE__*/_jsx(PanelSearchInput, {
+      ref: searchRef,
+      id: searchId
+      // The search row is the panel's header: a magnifier, a borderless
+      // input, and the shared clear (✕) button. It deliberately does NOT
+      // render a bordered TextInput — the popup is already a bordered
+      // surface, and a field inside it drew a second box within that box.
+      ,
+      label: t('@astryx.multiSelector.searchOptions')
+      // Same accessible name the TextInput's built-in clear produced
+      // ("Clear Search options"), so the affordance keeps its name while its
+      // chrome changes.
+      ,
+      clearLabel: t('@astryx.textInput.clearLabel', {
+        label: t('@astryx.multiSelector.searchOptions')
+      }),
+      ...themeProps('multi-selector-search'),
+      // When hasSearch is set, focus moves into this input on open, so it —
+      // not the trigger — must be the combobox reporting the highlighted
+      // option via aria-activedescendant (comboboxes-4).
+      role: "combobox",
+      "aria-expanded": popover.isOpen,
+      "aria-controls": listboxId,
+      "aria-autocomplete": "list",
+      "aria-activedescendant": popover.isOpen && highlightedIndex >= 0 ? getItemId(highlightedIndex) : undefined,
+      value: searchQuery,
+      onValueChange: handleSearchChange,
+      onContainerKeyDown: e => {
+        // The clear (✕) button lives inside the row, after the input in DOM
+        // order. When it is focused and the user tabs forward there is
         // nothing else in the popup, so dismiss it (Shift+Tab returns to the
         // input natively). Key events originating on the input are handled on
         // the input below; ignore them here so we don't double-dismiss.
@@ -612,54 +668,23 @@ export function MultiSelector({
           onKeyDown(e);
         }
       },
-      children: /*#__PURE__*/_jsx(TextInput, {
-        ref: searchRef,
-        id: searchId
-        // The search field IS a TextInput: the leading magnifier is its
-        // `startIcon` and the trailing clear (✕) is its built-in `hasClear`
-        // (which resets the value and refocuses the input). We add no bespoke
-        // affordance chrome — the field just looks and behaves like every
-        // other Astryx input.
-        ,
-        label: t('@astryx.multiSelector.searchOptions'),
-        isLabelHidden: true,
-        startIcon: "search",
-        hasClear: true,
-        size: "sm"
-        // Fill the dropdown's width (minus the wrapper's inline padding) so
-        // the field is flush end-to-end rather than sized to its content.
-        ,
-        width: "100%"
-        // When hasSearch is set, focus moves into this input on open, so it —
-        // not the trigger — must be the combobox reporting the highlighted
-        // option via aria-activedescendant (comboboxes-4). role + aria-* pass
-        // through to the underlying <input> via BaseProps.
-        ,
-        role: "combobox",
-        "aria-expanded": popover.isOpen,
-        "aria-controls": listboxId,
-        "aria-autocomplete": "list",
-        "aria-activedescendant": popover.isOpen && highlightedIndex >= 0 ? getItemId(highlightedIndex) : undefined,
-        value: searchQuery,
-        onChange: handleSearchChange,
-        onKeyDown: e => {
-          // Arrow keys navigate options; Enter toggles; Escape closes.
-          // Space and Home/End are left to the input (type a space / move
-          // the caret) per the APG editable combobox; PageUp/PageDown are
-          // the sanctioned substitute for jumping to the first/last option.
-          if (e.key === 'ArrowDown' || e.key === 'ArrowUp' || e.key === 'PageUp' || e.key === 'PageDown' || e.key === 'Enter' || e.key === 'Escape') {
-            onKeyDown(e);
-            return;
-          }
-          // Tab: when a query is showing the clear (✕) button, forward-tab
-          // moves focus to it (keeping the popup open) so the affordance is
-          // keyboard-reachable. Every other Tab dismisses the popup as usual.
-          if (e.key === 'Tab' && (e.shiftKey || !hasQuery)) {
-            onKeyDown(e);
-          }
-        },
-        placeholder: searchPlaceholder
-      })
+      onKeyDown: e => {
+        // Arrow keys navigate options; Enter toggles; Escape closes.
+        // Space and Home/End are left to the input (type a space / move
+        // the caret) per the APG editable combobox; PageUp/PageDown are
+        // the sanctioned substitute for jumping to the first/last option.
+        if (e.key === 'ArrowDown' || e.key === 'ArrowUp' || e.key === 'PageUp' || e.key === 'PageDown' || e.key === 'Enter' || e.key === 'Escape') {
+          onKeyDown(e);
+          return;
+        }
+        // Tab: when a query is showing the clear (✕) button, forward-tab
+        // moves focus to it (keeping the popup open) so the affordance is
+        // keyboard-reachable. Every other Tab dismisses the popup as usual.
+        if (e.key === 'Tab' && (e.shiftKey || !hasQuery)) {
+          onKeyDown(e);
+        }
+      },
+      placeholder: searchPlaceholder
     });
   }, [hasSearch, searchId, listboxId, searchQuery, hasQuery, searchPlaceholder, handleSearchChange, onKeyDown, popover.isOpen, highlightedIndex, getItemId, t]);
 
@@ -673,6 +698,25 @@ export function MultiSelector({
     // checkbox is inert/decorative, so the indeterminate state must be
     // conveyed through the option's accessible name (WCAG 4.1.2).
     const isPartiallySelected = isSelectAll && selectAllState === 'indeterminate';
+    const checkbox = /*#__PURE__*/_jsx("div", {
+      inert: true,
+      ...{
+        0: {
+          className: "x47corl x78zum5 x2lah0s"
+        },
+        1: {
+          className: "x47corl x78zum5 x2lah0s xvc5jky"
+        }
+      }[!!(indicatorPosition === 'end') << 0],
+      children: /*#__PURE__*/_jsx(CheckboxInput, {
+        label: "",
+        isLabelHidden: true,
+        value: checkboxValue,
+        onChange: () => {},
+        isDisabled: item.disabled,
+        size: size === 'lg' ? 'md' : size
+      })
+    });
     return /*#__PURE__*/_jsxs("div", {
       id: getItemId(flatIndex),
       role: "option",
@@ -687,33 +731,25 @@ export function MultiSelector({
         }
       },
       onMouseEnter: () => onItemMouseEnter(item, flatIndex),
-      ...stylex.props(styles.item, isSelectAll ? selectAllSizeStyles[size] : itemSizeStyles[size], isSelectAll && styles.selectAllWrapper, isHighlighted && styles.itemHighlighted, item.disabled && styles.itemDisabled),
-      children: [/*#__PURE__*/_jsx("div", {
-        inert: true,
+      ...mergeProps(
+      // One target for every dropdown row, carrying the row's size and
+      // runtime state so a theme can express "selected option at large"
+      // or restyle just the Select All row (`.select-all`) without
+      // reaching for structural selectors.
+      themeProps('multi-selector-option', {
+        size,
+        'select-all': isSelectAll ? 'select-all' : null,
+        selected: isSelected ? 'selected' : null,
+        disabled: item.disabled ? 'disabled' : null
+      }), stylex.props(styles.item, isSelectAll ? selectAllSizeStyles[size] : itemSizeStyles[size], isSelectAll && styles.selectAllWrapper, isHighlighted && styles.itemHighlighted, item.disabled && styles.itemDisabled)),
+      children: [indicatorPosition === 'start' && checkbox, renderOption && !isSelectAll ? renderOption(item) : /*#__PURE__*/_jsx("span", {
         ...{
-          className: "x47corl x78zum5 x2lah0s"
+          className: "xeuugli xb3r6kr xlyipyv xuxw1ft"
         },
-        children: /*#__PURE__*/_jsx(CheckboxInput, {
-          label: "",
-          isLabelHidden: true,
-          value: checkboxValue,
-          onChange: () => {},
-          isDisabled: item.disabled,
-          size: size === 'lg' ? 'md' : size
-        })
-      }), renderOption && !isSelectAll ? renderOption(item) : /*#__PURE__*/_jsx("span", {
-        ...{
-          0: {
-            className: "x9ynric xcr08ib x1e4wzip x1tgivj0 xeuugli xb3r6kr xlyipyv xuxw1ft"
-          },
-          1: {
-            className: "x9ynric xcr08ib x1e4wzip xeuugli xb3r6kr xlyipyv xuxw1ft xnbbluu"
-          }
-        }[!!item.disabled << 0],
         children: item.label ?? item.value
-      })]
+      }), indicatorPosition === 'end' && checkbox]
     }, item.value);
-  }, [renderOption, highlightedIndex, optimisticValue, allEnabledSelected, selectAllState, selectAllLabel, getItemId, handleNavigableToggle, onItemMouseEnter, size, t]);
+  }, [renderOption, indicatorPosition, highlightedIndex, optimisticValue, allEnabledSelected, selectAllState, selectAllLabel, getItemId, handleNavigableToggle, onItemMouseEnter, size, t]);
 
   // Render all options. Uses sortedItems as the single source of truth for
   // item order — no independent sorting here. Structural elements (dividers,
@@ -725,12 +761,11 @@ export function MultiSelector({
     // Number of real items (excluding the select-all sentinel)
     const realItemCount = hasSelectAll ? sortedItems.length - 1 : sortedItems.length;
 
-    // Show select-all only when there are real items to select
+    // Show select-all only when there are real items to select. It reads as
+    // the first row of the list, not a section of its own — no divider under
+    // it (the checkbox column already lines it up with the options below).
     if (hasSelectAll && realItemCount > 0) {
       elements.push(renderItem(sortedItems[0], 0));
-      elements.push(/*#__PURE__*/_jsx(Divider, {
-        xstyle: styles.divider
-      }, "select-all-divider"));
       cursor = 1;
     } else if (hasSelectAll) {
       // Skip the select-all sentinel when there are no real items
@@ -744,9 +779,9 @@ export function MultiSelector({
     if (realItemCount === 0) {
       elements.push(/*#__PURE__*/_jsx("div", {
         role: "presentation",
-        ...{
+        ...mergeProps(themeProps('multi-selector-empty-state'), {
           className: "x1b2ylru x2b8uid xv1l7n4 x9ynric xcr08ib"
-        },
+        }),
         children: "No results found"
       }, "empty"));
       return elements;
@@ -788,16 +823,21 @@ export function MultiSelector({
           sectionItems.push(renderItem(sortedItems[cursor], cursor));
           cursor++;
         }
-        if (option.title) {
-          elements.push(/*#__PURE__*/_jsx(Divider, {
-            label: option.title,
-            xstyle: styles.sectionDivider
-          }, `section-divider-${i}`));
-        }
-        elements.push(/*#__PURE__*/_jsx("div", {
+        // The heading lives INSIDE the group and is aria-hidden: the group
+        // already carries the title as its accessible name, so exposing the
+        // text again would announce it twice. This also keeps role="listbox"'s
+        // children to option/group only — the old labeled Divider sat in the
+        // listbox as a stray role="separator".
+        elements.push(/*#__PURE__*/_jsxs("div", {
           role: "group",
           "aria-label": option.title,
-          children: sectionItems
+          children: [option.title && /*#__PURE__*/_jsx("div", {
+            "aria-hidden": "true",
+            ...mergeProps(themeProps('multi-selector-section-heading'), {
+              className: "xu0wf1k xf314gf x9ynric x141an7d x1ltkj2j xv1l7n4 x87ps6o"
+            }),
+            children: option.title
+          }), sectionItems]
         }, `section-${i}`));
       } else if (isOptionData(option)) {
         if (!isSearching || optionMatchesQuery(normalizeOption(option), searchQuery)) {
@@ -827,8 +867,9 @@ export function MultiSelector({
       ...mergeProps(themeProps('multi-selector', {
         variant,
         size,
-        status: status?.type ?? null
-      }), stylex.props(inputWrapperStyles.base, styles.triggerContainer, sizeStyles[size], variant === 'ghost' && styles.triggerGhost, isDisabled && inputWrapperStyles.disabled, variant === 'ghost' && isDisabled && styles.triggerGhostDisabled, optimisticValue.length === 0 && styles.triggerPlaceholder, variant !== 'ghost' && status && inputStatusBorderStyles[status.type], variant !== 'ghost' && status && !isDisabled && inputStatusHoverShadowStyles[status.type], variant !== 'ghost' && inputGroup && groupStyles.inGroup, xstyle), className, style),
+        status: status?.type ?? null,
+        disabled: isDisabled ? 'disabled' : null
+      }), stylex.props(inputWrapperStyles.base, styles.triggerContainer, sizeStyles[size], variant === 'ghost' && styles.triggerGhost, variant === 'ghost' && focusOutlineStyles.focusWithin, isDisabled && inputWrapperStyles.disabled, variant === 'ghost' && isDisabled && styles.triggerGhostDisabled, optimisticValue.length === 0 && styles.triggerPlaceholder, variant !== 'ghost' && status && inputStatusBorderStyles[status.type], variant !== 'ghost' && status && !isDisabled && inputStatusHoverShadowStyles[status.type], variant !== 'ghost' && inputGroup && groupStyles.inGroup, xstyle), className, style),
       children: [startIcon && renderIconSlot(startIcon, {
         size: 'sm',
         color: 'secondary'
@@ -880,89 +921,83 @@ export function MultiSelector({
         disabled: isDisabled
       }, v)), isBusy && /*#__PURE__*/_jsx(Spinner, {
         size: "sm"
-      }), hasClear && value.length > 0 && !isDisabled && /*#__PURE__*/_jsx("button", {
-        type: "button",
-        onClick: handleClear,
-        "aria-label": t('@astryx.multiSelector.clearAll', {
+      }), hasClear && value.length > 0 && !isDisabled && /*#__PURE__*/_jsx(InputClearButton, {
+        label: t('@astryx.multiSelector.clearAll', {
           label
         }),
-        ...{
-          className: "x78zum5 x6s0dn4 xl56j7k x1717udv x1ghz6dp xc342km xng3xce xjbqb8w x1ypdohk xh6dtrn x1a2a7pz x1p25gnr x1y3gkto"
-        },
+        onClick: handleClear,
+        iconClassName: stableClassName('multi-selector-clear-icon')
+      }), showStatusIcon ? showStatusTooltip ? /*#__PURE__*/_jsx("button", {
+        ref: statusTooltip.ref,
+        type: "button",
+        "aria-label": t(STATUS_BUTTON_LABEL_KEY[status.type]),
+        "aria-describedby": statusTooltip.describedBy,
+        onClick: e => e.stopPropagation(),
+        ...stylex.props(focusOutlineStyles.focusVisible, styles.statusButton),
         children: /*#__PURE__*/_jsx(Icon, {
-          icon: "close",
+          icon: STATUS_ICON_MAP[status.type],
           size: "sm",
-          color: "secondary"
-          // Stable theme target on the clear glyph itself, so a theme can
-          // restyle just this icon (color, size, hover) via `defineTheme`.
-          // Same-element rules in @layer astryx-theme win over the icon's
-          // own base color/size, which a button-level target could not
-          // reach.
-          ,
-          ...themeProps('multi-selector-clear-icon')
+          color: STATUS_ICON_COLOR_MAP[status.type],
+          xstyle: styles.triggerIcon
         })
-      }), /*#__PURE__*/_jsx("span", {
+      }) : /*#__PURE__*/_jsx(Icon, {
+        icon: STATUS_ICON_MAP[status.type],
+        size: "sm",
+        color: STATUS_ICON_COLOR_MAP[status.type],
+        xstyle: styles.triggerIcon
+      }) : /*#__PURE__*/_jsx(Icon, {
+        icon: "chevronDown",
+        size: "sm",
+        color: "secondary"
+        // The rotation rides on the glyph, alongside the box and color
+        // the wrapper used to provide, so one element carries the mark,
+        // its open/closed transform, and the theme target.
+        ,
+        xstyle: [styles.triggerIcon, styles.triggerIconRotation, popover.isOpen && styles.triggerIconOpen]
+        // Stable theme target on the chevron glyph itself, so a theme can
+        // restyle just this icon (color, size, hover) — and its
+        // open/closed state — via `defineTheme`. Same-element rules in
+        // @layer astryx-theme win over the icon's own base color/size,
+        // which a button-level target could not reach.
+        ,
+        ...themeProps('multi-selector-indicator-icon', {
+          state: popover.isOpen ? 'expanded' : 'collapsed'
+        })
+      })]
+    }), popover.render(hasSearch ?
+    /*#__PURE__*/
+    // With a search row the panel splits: the header stays put while the
+    // options scroll under it, so the field does not slide out of reach
+    // in a long list. Without one the panel is a single scroll container,
+    // exactly as before.
+    _jsxs("div", {
+      children: [renderSearch(), /*#__PURE__*/_jsx(Divider, {}), /*#__PURE__*/_jsx("div", {
         ...{
-          0: {
-            className: "x2lah0s x78zum5 x6s0dn4 xl56j7k x1kky2od xlup9mm x11xpdln xuedmi6 xlr8y92 x1g0ag68 xv9yike"
-          },
-          2: {
-            className: "x2lah0s x78zum5 x6s0dn4 xl56j7k x1kky2od xlup9mm x11xpdln xuedmi6 xlr8y92 x1g0ag68 xv9yike x19jd1h0"
-          },
-          1: {
-            className: "x2lah0s x78zum5 x6s0dn4 xl56j7k x1kky2od xlup9mm x11xpdln xuedmi6 xlr8y92 x1g0ag68 xv9yike xq2gx43"
-          },
-          3: {
-            className: "x2lah0s x78zum5 x6s0dn4 xl56j7k x1kky2od xlup9mm x11xpdln xuedmi6 xlr8y92 x1g0ag68 xv9yike x19jd1h0 xq2gx43"
-          }
-        }[!!(!showStatusIcon && popover.isOpen) << 1 | !!showStatusIcon << 0],
-        children: showStatusIcon ? showStatusTooltip ? /*#__PURE__*/_jsx("button", {
-          ref: statusTooltip.ref,
-          type: "button",
-          "aria-label": t(STATUS_BUTTON_LABEL_KEY[status.type]),
-          "aria-describedby": statusTooltip.describedBy,
-          onClick: e => e.stopPropagation(),
-          ...{
-            className: "x78zum5 x6s0dn4 xl56j7k x1717udv x1ghz6dp xc342km xng3xce xjbqb8w x1heor9g x1ypdohk xh6dtrn x1a2a7pz x1p25gnr x1y3gkto"
-          },
-          children: /*#__PURE__*/_jsx(Icon, {
-            icon: STATUS_ICON_MAP[status.type],
-            size: "sm",
-            color: STATUS_ICON_COLOR_MAP[status.type]
-          })
-        }) : /*#__PURE__*/_jsx(Icon, {
-          icon: STATUS_ICON_MAP[status.type],
-          size: "sm",
-          color: STATUS_ICON_COLOR_MAP[status.type]
-        }) : /*#__PURE__*/_jsx(Icon, {
-          icon: "chevronDown",
-          size: "sm",
-          color: "inherit"
-          // Stable theme target on the chevron glyph itself, so a theme can
-          // restyle just this icon (color, size, hover) — and its
-          // open/closed state — via `defineTheme`. Same-element rules in
-          // @layer astryx-theme win over the icon's own base color/size,
-          // which a button-level target could not reach.
-          ,
-          ...themeProps('multi-selector-indicator-icon', {
-            state: popover.isOpen ? 'expanded' : 'collapsed'
-          })
+          className: "x9f619 xuyqlj2 x1odjw0f x9epnlk"
+        },
+        children: /*#__PURE__*/_jsx("div", {
+          id: listboxId,
+          role: "listbox",
+          "aria-multiselectable": "true",
+          "aria-labelledby": triggerId,
+          children: renderOptions()
         })
       })]
-    }), popover.render(/*#__PURE__*/_jsxs("div", {
+    }) : /*#__PURE__*/_jsx("div", {
       ...{
         className: "x9f619 xuyqlj2 x1odjw0f x9epnlk"
       },
-      children: [renderSearch(), /*#__PURE__*/_jsx("div", {
+      children: /*#__PURE__*/_jsx("div", {
         id: listboxId,
         role: "listbox",
         "aria-multiselectable": "true",
         "aria-labelledby": triggerId,
         children: renderOptions()
-      })]
+      })
     }), {
       placement: 'below',
       alignment: 'start',
+      offset: spacingVars['--spacing-1'],
       xstyle: styles.popover
     }), showStatusTooltip && statusTooltip.renderTooltip(status?.message ?? ''), showsDisabledMessage && disabledMessageTooltip.renderTooltip(disabledMessage)]
   });

package/dist/NumberInput/NumberInput.d.ts

@@ -61,6 +61,17 @@ interface NumberInputPropsBase extends Omit<BaseProps, 'onChange' | 'defaultValu
      * @default false
      */
     isDisabled?: boolean;
+    /**
+     * Whether the input is read-only.
+     * The value is shown at full opacity and still submits with the form, but
+     * cannot be edited. Unlike `isDisabled`, a read-only input is not dimmed and
+     * stays in the tab order — use it for a value the user should see and send
+     * but not change. Stepping is off in every form while read-only: arrow keys,
+     * the wheel, and the number steppers. `isDisabled` takes precedence when both
+     * are set.
+     * @default false
+     */
+    isReadOnly?: boolean;
     /**
      * Explains why the input is disabled. When set together with `isDisabled`,
      * the input shows a tooltip with this text on hover and keyboard focus, and
@@ -159,6 +170,21 @@ interface NumberInputPropsBase extends Omit<BaseProps, 'onChange' | 'defaultValu
      * @default 1
      */
     step?: number | null;
+    /**
+     * Formats the committed value while the input is not being edited.
+     * The raw numeric value is shown on focus so it remains editable.
+     */
+    formatValue?: (value: number) => string;
+    /**
+     * Whether scrolling the wheel over a focused input steps the value.
+     * @default true
+     */
+    isWheelEnabled?: boolean;
+    /**
+     * Whether to show increment and decrement buttons at the end of the input.
+     * @default false
+     */
+    hasNumberSteppers?: boolean;
     /**
      * Units text to display at the end of the input (e.g., "%" or "GB").
      */
@@ -215,7 +241,7 @@ export type NumberInputProps = NumberInputPropsNonClearable | NumberInputPropsCl
  * <NumberInput label="Price" value={price} onChange={setPrice} min={0} step={0.01} />
  * ```
  */
-export declare function NumberInput({ label, isLabelHidden, description, isOptional, isRequired, isDisabled, disabledMessage, startIcon, labelIcon, status, statusVariant, size: sizeProp, onChange, value, placeholder, labelTooltip, hasAutoFocus, htmlName, autoComplete, min, max, step, units, isIntegerOnly, onFocus, onBlur, hasClear, onEnter, onKeyDown, width, xstyle, className, style, ref, ...rest }: NumberInputProps): import("react").JSX.Element;
+export declare function NumberInput({ label, isLabelHidden, description, isOptional, isRequired, isDisabled, isReadOnly, disabledMessage, startIcon, labelIcon, status, statusVariant, size: sizeProp, onChange, value, placeholder, labelTooltip, hasAutoFocus, htmlName, autoComplete, min, max, step, formatValue, isWheelEnabled, hasNumberSteppers, units, isIntegerOnly, onFocus, onBlur, hasClear, onEnter, onKeyDown, width, xstyle, className, style, ref, ...rest }: NumberInputProps): import("react").JSX.Element;
 export declare namespace NumberInput {
     var displayName: string;
 }

package/dist/NumberInput/NumberInput.d.ts.map

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