@sproutsocial/seeds-react-menu 1.13.0 → 1.16.0

package/dist/esm/v3/index.js

@@ -134,20 +134,50 @@ function groupItems(data, groupBy) {
 
 // src/v3/Common/SelectStyles.tsx
 import { Select as Select2 } from "@base-ui/react/select";
-import styled2 from "styled-components";
+import styled3, { css } from "styled-components";
 import { focusRing } from "@sproutsocial/seeds-react-mixins";
-var Field = styled2.div`
+
+// src/v3/Common/SelectIcons.tsx
+import "react";
+import styled2 from "styled-components";
+import { Icon as Icon2 } from "@sproutsocial/seeds-react-icon";
+import { jsx as jsx2 } from "react/jsx-runtime";
+var StyledChevron = styled2.div`
+  display: flex;
+  align-items: center;
+  transition: transform 0.15s;
+  ${({ $isOpen }) => $isOpen && "transform: rotate(-180deg);"}
+`;
+function ChevronIcon() {
+  return /* @__PURE__ */ jsx2(Icon2, { name: "chevron-down-outline", fixedWidth: true, "aria-hidden": true });
+}
+function ClearIcon() {
+  return /* @__PURE__ */ jsx2(Icon2, { name: "circle-x-outline", fixedWidth: true, "aria-hidden": true, size: "mini" });
+}
+function CheckIcon2() {
+  return /* @__PURE__ */ jsx2(Icon2, { name: "check-outline", fixedWidth: true, "aria-hidden": true });
+}
+
+// src/v3/Common/SelectStyles.tsx
+var invalidStyles = css`
+  border-color: ${({ theme }) => theme.colors.form.border.error};
+
+  ${StyledChevron} {
+    color: ${({ theme }) => theme.colors.icon.error};
+  }
+`;
+var Field = styled3.div`
   display: ${({ $fullWidth }) => $fullWidth === false ? "inline-flex" : "flex"};
   flex-direction: column;
   gap: ${({ theme }) => theme.space[200]};
   ${({ $fullWidth }) => $fullWidth !== false && "width: 100%;"}
 `;
-var SelectLabel = styled2(Select2.Label)`
+var SelectLabel = styled3(Select2.Label)`
   font-size: ${({ theme }) => theme.typography[200].fontSize};
   font-weight: ${({ theme }) => theme.fontWeights.semibold};
   color: ${({ theme }) => theme.colors.text.body};
 `;
-var SelectTrigger = styled2(Select2.Trigger)`
+var SelectTrigger = styled3(Select2.Trigger)`
   display: flex;
   align-items: center;
   justify-content: space-between;
@@ -182,21 +212,23 @@ var SelectTrigger = styled2(Select2.Trigger)`
     opacity: 0.4;
     cursor: not-allowed;
   }
+
+  ${({ $isInvalid }) => $isInvalid && invalidStyles}
 `;
-var SelectValue = styled2(Select2.Value)`
+var SelectValue = styled3(Select2.Value)`
   min-width: 0;
   overflow: hidden;
 `;
-var SelectIcon = styled2(Select2.Icon)`
+var SelectIcon = styled3(Select2.Icon)`
   display: flex;
   align-items: center;
   color: ${({ theme }) => theme.colors.icon.base};
   flex-shrink: 0;
 `;
-var SelectGroup = styled2(Select2.Group)`
+var SelectGroup = styled3(Select2.Group)`
   display: block;
 `;
-var SelectGroupLabel = styled2(Select2.GroupLabel)`
+var SelectGroupLabel = styled3(Select2.GroupLabel)`
   padding: ${({ theme }) => `${theme.space[300]} ${theme.space[300]} ${theme.space[200]}`};
   font-size: ${({ theme }) => theme.typography[100].fontSize};
   font-weight: ${({ theme }) => theme.fontWeights.semibold};
@@ -204,23 +236,23 @@ var SelectGroupLabel = styled2(Select2.GroupLabel)`
   letter-spacing: 0.05em;
   color: ${({ theme }) => theme.colors.text.subtext};
 `;
-var SelectSeparator = styled2(Select2.Separator)`
+var SelectSeparator = styled3(Select2.Separator)`
   height: 1px;
   margin: ${({ theme }) => `${theme.space[200]} ${theme.space[300]}`};
   background: ${({ theme }) => theme.colors.container.border.base};
 `;
-var SelectPositioner = styled2(Select2.Positioner)`
+var SelectPositioner = styled3(Select2.Positioner)`
   width: var(--anchor-width);
   z-index: 7;
 `;
-var SelectPopup = styled2(Select2.Popup)`
+var SelectPopup = styled3(Select2.Popup)`
   font-family: ${({ theme }) => theme.fontFamily};
   background: ${({ theme }) => theme.colors.container.background.base};
   border: 1px solid ${({ theme }) => theme.colors.container.border.base};
   border-radius: ${({ theme }) => theme.radii[500]};
   box-shadow: ${({ theme }) => theme.shadows.low};
   outline: none;
-  max-height: min(var(--base-ui-available-height, 400px), 400px);
+  max-height: min(var(--available-height, 400px), 400px);
   overflow-y: auto;
   padding: ${({ theme }) => theme.space[200]};
 
@@ -255,27 +287,6 @@ var SelectPopup = styled2(Select2.Popup)`
   }
 `;
 
-// src/v3/Common/SelectIcons.tsx
-import "react";
-import styled3 from "styled-components";
-import { Icon as Icon2 } from "@sproutsocial/seeds-react-icon";
-import { jsx as jsx2 } from "react/jsx-runtime";
-var StyledChevron = styled3.div`
-  display: flex;
-  align-items: center;
-  transition: transform 0.15s;
-  ${({ $isOpen }) => $isOpen && "transform: rotate(-180deg);"}
-`;
-function ChevronIcon() {
-  return /* @__PURE__ */ jsx2(Icon2, { name: "chevron-down-outline", fixedWidth: true, "aria-hidden": true });
-}
-function ClearIcon() {
-  return /* @__PURE__ */ jsx2(Icon2, { name: "circle-x-outline", fixedWidth: true, "aria-hidden": true, size: "mini" });
-}
-function CheckIcon2() {
-  return /* @__PURE__ */ jsx2(Icon2, { name: "check-outline", fixedWidth: true, "aria-hidden": true });
-}
-
 // src/v3/SingleSelect.tsx
 import { Fragment as Fragment2, jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
 var StyledValue = styled4(Select3.Value)`
@@ -292,6 +303,7 @@ var StyledValue = styled4(Select3.Value)`
 function SingleSelect(props) {
   const { id, placeholder, includePlaceholderItem, fullWidth = true } = props;
   const ariaDescribedBy = props["aria-describedby"];
+  const isInvalid = props.isInvalid;
   const isChildrenMode = "children" in props && props.children != null;
   const selectedItemId = props.selectedItemId;
   const defaultSelectedItemId = props.defaultSelectedItemId;
@@ -349,10 +361,19 @@ function SingleSelect(props) {
         onValueChange: handleValueChange,
         id,
         children: [
-          /* @__PURE__ */ jsxs2(SelectTrigger, { "aria-describedby": ariaDescribedBy, children: [
-            /* @__PURE__ */ jsx3(StyledValue, { placeholder, children: renderSelection && selectedItem ? renderSelection(selectedItem) : void 0 }),
-            /* @__PURE__ */ jsx3(SelectIcon, { children: /* @__PURE__ */ jsx3(StyledChevron, { "data-chevron": true, children: /* @__PURE__ */ jsx3(ChevronIcon, {}) }) })
-          ] }),
+          /* @__PURE__ */ jsxs2(
+            SelectTrigger,
+            {
+              "aria-describedby": ariaDescribedBy,
+              "aria-invalid": isInvalid || void 0,
+              "aria-required": props.required || void 0,
+              $isInvalid: isInvalid,
+              children: [
+                /* @__PURE__ */ jsx3(StyledValue, { placeholder, children: renderSelection && selectedItem ? renderSelection(selectedItem) : void 0 }),
+                /* @__PURE__ */ jsx3(SelectIcon, { children: /* @__PURE__ */ jsx3(StyledChevron, { "data-chevron": true, children: /* @__PURE__ */ jsx3(ChevronIcon, {}) }) })
+              ]
+            }
+          ),
           /* @__PURE__ */ jsx3(Select3.Portal, { container: portalContainer, children: /* @__PURE__ */ jsx3(SelectPositioner, { sideOffset: 8, alignItemWithTrigger: false, children: /* @__PURE__ */ jsxs2(SelectPopup, { children: [
             /* @__PURE__ */ jsx3(Select3.ScrollUpArrow, {}),
             /* @__PURE__ */ jsx3(Select3.List, { children: children ? children : groupBy ? groupItems(data, groupBy).map((group, index, arr) => /* @__PURE__ */ jsxs2(React4.Fragment, { children: [
@@ -422,6 +443,7 @@ var Placeholder = styled5.div`
 function MultiSelect(props) {
   const { id, placeholder = "Select...", fullWidth = true } = props;
   const ariaDescribedBy = props["aria-describedby"];
+  const isInvalid = props.isInvalid;
   const isChildrenMode = "children" in props && props.children != null;
   const data = isChildrenMode ? [] : props.data;
   const itemToString = isChildrenMode ? () => "" : props.itemToString;
@@ -478,23 +500,32 @@ function MultiSelect(props) {
         disabled: props.disabled,
         id,
         children: [
-          /* @__PURE__ */ jsxs3(SelectTrigger, { "aria-describedby": ariaDescribedBy, children: [
-            /* @__PURE__ */ jsx4(SelectValue, { children: () => {
-              if (renderSelection) return renderSelection(selectedItems);
-              if (selectedItems.length === 0)
-                return /* @__PURE__ */ jsx4(Placeholder, { children: placeholder });
-              const visibleItems = maxSelections != null ? selectedItems.slice(0, maxSelections) : selectedItems;
-              const overflowCount = maxSelections != null && selectedItems.length > maxSelections ? selectedItems.length - maxSelections : 0;
-              const text = visibleItems.map(
-                (item) => customRenderSelections ? customRenderSelections(item) : itemToString(item)
-              ).join(", ");
-              return /* @__PURE__ */ jsxs3(SelectionText, { children: [
-                text,
-                overflowCount > 0 ? `, +${overflowCount}` : ""
-              ] });
-            } }),
-            /* @__PURE__ */ jsx4(SelectIcon, { children: /* @__PURE__ */ jsx4(StyledChevron, { "data-chevron": true, children: /* @__PURE__ */ jsx4(ChevronIcon, {}) }) })
-          ] }),
+          /* @__PURE__ */ jsxs3(
+            SelectTrigger,
+            {
+              "aria-describedby": ariaDescribedBy,
+              "aria-invalid": isInvalid || void 0,
+              "aria-required": props.required || void 0,
+              $isInvalid: isInvalid,
+              children: [
+                /* @__PURE__ */ jsx4(SelectValue, { children: () => {
+                  if (renderSelection) return renderSelection(selectedItems);
+                  if (selectedItems.length === 0)
+                    return /* @__PURE__ */ jsx4(Placeholder, { children: placeholder });
+                  const visibleItems = maxSelections != null ? selectedItems.slice(0, maxSelections) : selectedItems;
+                  const overflowCount = maxSelections != null && selectedItems.length > maxSelections ? selectedItems.length - maxSelections : 0;
+                  const text = visibleItems.map(
+                    (item) => customRenderSelections ? customRenderSelections(item) : itemToString(item)
+                  ).join(", ");
+                  return /* @__PURE__ */ jsxs3(SelectionText, { children: [
+                    text,
+                    overflowCount > 0 ? `, +${overflowCount}` : ""
+                  ] });
+                } }),
+                /* @__PURE__ */ jsx4(SelectIcon, { children: /* @__PURE__ */ jsx4(StyledChevron, { "data-chevron": true, children: /* @__PURE__ */ jsx4(ChevronIcon, {}) }) })
+              ]
+            }
+          ),
           /* @__PURE__ */ jsx4(Select4.Portal, { container: portalContainer, children: /* @__PURE__ */ jsx4(SelectPositioner, { sideOffset: 8, alignItemWithTrigger: false, children: /* @__PURE__ */ jsxs3(SelectPopup, { children: [
             /* @__PURE__ */ jsx4(Select4.ScrollUpArrow, {}),
             /* @__PURE__ */ jsx4(Select4.List, { children: children ? children : groupBy ? groupItems(data, groupBy).map((group, index, arr) => /* @__PURE__ */ jsxs3(React5.Fragment, { children: [
@@ -535,21 +566,41 @@ function MultiSelect(props) {
 }
 
 // src/v3/SingleCombobox.tsx
-import * as React8 from "react";
+import * as React9 from "react";
 import { Combobox as Combobox3 } from "@base-ui/react/combobox";
 import "@tanstack/react-virtual";
 
-// src/v3/Common/ComboboxItem.tsx
+// src/v3/Common/useSuppressEscapeClear.ts
 import * as React6 from "react";
+function useSuppressEscapeClear(open) {
+  return React6.useCallback(
+    (event) => {
+      if (event.key === "Escape" && !open) {
+        event.stopPropagation();
+      }
+    },
+    [open]
+  );
+}
+
+// src/v3/Common/ComboboxItem.tsx
+import * as React7 from "react";
 import Radio2 from "@sproutsocial/seeds-react-radio";
 import Checkbox3 from "@sproutsocial/seeds-react-checkbox";
 
 // src/v3/Common/ComboboxStyles.tsx
 import { Combobox } from "@base-ui/react/combobox";
-import styled6 from "styled-components";
+import styled6, { css as css2 } from "styled-components";
 import { focusRing as focusRing2 } from "@sproutsocial/seeds-react-mixins";
 import Checkbox2 from "@sproutsocial/seeds-react-checkbox";
 import { jsx as jsx5 } from "react/jsx-runtime";
+var invalidStyles2 = css2`
+  border-color: ${({ theme }) => theme.colors.form.border.error};
+
+  ${StyledChevron} {
+    color: ${({ theme }) => theme.colors.icon.error};
+  }
+`;
 var ComboboxLabel = styled6.label`
   font-size: ${({ theme }) => theme.typography[200].fontSize};
   font-weight: ${({ theme }) => theme.fontWeights.semibold};
@@ -576,6 +627,8 @@ var ComboboxInputGroup = styled6(Combobox.InputGroup)`
     opacity: 0.4;
     cursor: not-allowed;
   }
+
+  ${({ $isInvalid }) => $isInvalid && invalidStyles2}
 `;
 var ComboboxInput = styled6(Combobox.Input)`
   flex: 1;
@@ -623,7 +676,7 @@ var ComboboxActionButtons = styled6.div`
   margin-left: auto;
   gap: ${({ theme }) => theme.space[100]};
 `;
-var ComboboxClear = styled6(Combobox.Clear)`
+var ComboboxClear = styled6(Combobox.Clear).attrs({ tabIndex: 0 })`
   display: flex;
   align-items: center;
   justify-content: center;
@@ -640,6 +693,10 @@ var ComboboxClear = styled6(Combobox.Clear)`
     color: ${({ theme }) => theme.colors.text.body};
   }
 
+  &:focus-visible {
+    ${focusRing2}
+  }
+
   &[data-empty] {
     display: none;
   }
@@ -672,7 +729,7 @@ var ComboboxPopup = styled6(Combobox.Popup)`
   box-shadow: ${({ theme }) => theme.shadows.medium};
   outline: none;
   width: 100%;
-  max-height: min(var(--base-ui-available-height, 400px), 400px);
+  max-height: min(var(--available-height, 400px), 400px);
   overflow-y: auto;
   padding: 0;
 
@@ -800,6 +857,12 @@ var ComboboxGroupHeaderItem = styled6(Combobox.Item)`
     background: ${({ theme }) => theme.colors.listItem.background.hover};
     color: ${({ theme }) => theme.colors.text.body};
   }
+
+  &[data-disabled] {
+    opacity: 0.4;
+    cursor: not-allowed;
+    pointer-events: none;
+  }
 `;
 var ComboboxSelectAllItem = styled6(Combobox.Item)`
   display: flex;
@@ -839,6 +902,7 @@ var ComboboxToken = styled6(Combobox.Chips)`
   display: flex;
   width: 100%;
   flex-wrap: wrap;
+  gap: ${({ theme }) => theme.space[200]};
 `;
 var ComboboxTokenInputGroup = styled6(Combobox.InputGroup)`
   display: flex;
@@ -863,6 +927,8 @@ var ComboboxTokenInputGroup = styled6(Combobox.InputGroup)`
     opacity: 0.4;
     cursor: not-allowed;
   }
+
+  ${({ $isInvalid }) => $isInvalid && invalidStyles2}
 `;
 var Token = styled6.span`
   display: inline-flex;
@@ -895,6 +961,10 @@ var TokenRemove = styled6.button`
   cursor: pointer;
   padding: 0;
   line-height: 1;
+
+  &:focus-visible {
+    ${focusRing2}
+  }
 `;
 var SearchableSelectTrigger = styled6(Combobox.Trigger)`
   display: flex;
@@ -928,6 +998,8 @@ var SearchableSelectTrigger = styled6(Combobox.Trigger)`
     opacity: 0.4;
     cursor: not-allowed;
   }
+
+  ${({ $isInvalid }) => $isInvalid && invalidStyles2}
 `;
 var SearchableSelectTriggerIcon = styled6(Combobox.Icon)`
   display: flex;
@@ -1010,6 +1082,8 @@ var SearchableSelectTokenTrigger = styled6(Combobox.Trigger)`
     opacity: 0.4;
     cursor: not-allowed;
   }
+
+  ${({ $isInvalid }) => $isInvalid && invalidStyles2}
 `;
 
 // src/v3/Common/ComboboxItem.tsx
@@ -1074,11 +1148,11 @@ function ComboboxItemInner({
     }
   );
 }
-var ComboboxItem2 = React6.forwardRef(ComboboxItemInner);
+var ComboboxItem2 = React7.forwardRef(ComboboxItemInner);
 var ComboboxItem_default = ComboboxItem2;
 
 // src/v3/Common/VirtualizedComboboxList.tsx
-import * as React7 from "react";
+import * as React8 from "react";
 import { Combobox as Combobox2 } from "@base-ui/react/combobox";
 import { useVirtualizer } from "@tanstack/react-virtual";
 
@@ -1115,10 +1189,11 @@ function VirtualizedComboboxList({
   inputType,
   renderItem,
   renderGroupHeading,
+  isGroupHeaderDisabled,
   renderCreatableItem
 }) {
   const filteredItems = Combobox2.useFilteredItems();
-  const scrollElementRef = React7.useRef(null);
+  const scrollElementRef = React8.useRef(null);
   const virtualizer = useVirtualizer({
     enabled: open,
     count: filteredItems.length,
@@ -1130,8 +1205,8 @@ function VirtualizedComboboxList({
     scrollPaddingStart: 4,
     scrollPaddingEnd: 4
   });
-  React7.useImperativeHandle(virtualizerRef, () => virtualizer);
-  const handleScrollRef = React7.useCallback(
+  React8.useImperativeHandle(virtualizerRef, () => virtualizer);
+  const handleScrollRef = React8.useCallback(
     (el) => {
       scrollElementRef.current = el;
       if (el) requestAnimationFrame(() => virtualizer.measure());
@@ -1217,6 +1292,7 @@ function VirtualizedComboboxList({
                   index: virtualItem.index,
                   "data-index": virtualItem.index,
                   value: row,
+                  disabled: isGroupHeaderDisabled?.(row.groupName),
                   style: baseStyle,
                   ref: virtualizer.measureElement,
                   children: [
@@ -1279,6 +1355,7 @@ function SingleCombobox(props) {
     fullWidth = true
   } = props;
   const ariaDescribedBy = props["aria-describedby"];
+  const isInvalid = props.isInvalid;
   const isChildrenMode = "children" in props && props.children != null;
   const data = isChildrenMode ? [] : props.data;
   const itemToString = isChildrenMode ? (_item) => "" : props.itemToString;
@@ -1292,17 +1369,18 @@ function SingleCombobox(props) {
   const defaultSelectedItemId = props.defaultSelectedItemId;
   const onSelectedItemIdChange = props.onSelectedItemIdChange;
   const { containerRef, portalContainer } = useSeedsPortalContainer();
-  const [open, setOpen] = React8.useState(false);
-  const virtualizerRef = React8.useRef(null);
+  const [open, setOpen] = React9.useState(false);
+  const virtualizerRef = React9.useRef(null);
+  const onInputKeyDownCapture = useSuppressEscapeClear(open);
   const isControlled = selectedItemId !== void 0;
-  const idToItem = React8.useCallback(
+  const idToItem = React9.useCallback(
     (id2) => {
       if (id2 == null) return null;
       return data.find((d) => String(d.id) === String(id2)) ?? null;
     },
     [data]
   );
-  const [internalValue, setInternalValue] = React8.useState(
+  const [internalValue, setInternalValue] = React9.useState(
     () => idToItem(defaultSelectedItemId)
   );
   const value = isControlled ? idToItem(selectedItemId) : internalValue;
@@ -1314,7 +1392,7 @@ function SingleCombobox(props) {
       onSelectedItemIdChange(newItem ? newItem.id : null);
     }
   }
-  const groups = React8.useMemo(
+  const groups = React9.useMemo(
     () => groupBy ? groupItems(data, groupBy) : null,
     [data, groupBy]
   );
@@ -1339,29 +1417,38 @@ function SingleCombobox(props) {
           if (!item || !virt) return;
           const isStart = index === 0;
           const isEnd = index === virt.options.count - 1;
-          if (reason === "none" || reason === "keyboard" && (isStart || isEnd)) {
+          if (reason === "keyboard" && (isStart || isEnd)) {
             queueMicrotask(() => {
               virt.scrollToIndex(index, {
-                align: isEnd ? "start" : "end"
+                align: isStart ? "start" : "end"
               });
             });
           }
         } : void 0,
         children: [
-          /* @__PURE__ */ jsxs6(ComboboxInputGroup, { children: [
-            /* @__PURE__ */ jsx8(
-              ComboboxInput,
-              {
-                placeholder,
-                id,
-                "aria-describedby": ariaDescribedBy
-              }
-            ),
-            /* @__PURE__ */ jsxs6(ComboboxActionButtons, { children: [
-              /* @__PURE__ */ jsx8(ComboboxClear, { "aria-label": "Clear selection", children: /* @__PURE__ */ jsx8(ClearIcon, {}) }),
-              /* @__PURE__ */ jsx8(ComboboxTrigger, { "aria-label": "Open popup", children: /* @__PURE__ */ jsx8(StyledChevron, { $isOpen: open, children: /* @__PURE__ */ jsx8(ChevronIcon, {}) }) })
-            ] })
-          ] }),
+          /* @__PURE__ */ jsxs6(
+            ComboboxInputGroup,
+            {
+              $isInvalid: isInvalid,
+              onKeyDownCapture: onInputKeyDownCapture,
+              children: [
+                /* @__PURE__ */ jsx8(
+                  ComboboxInput,
+                  {
+                    placeholder,
+                    id,
+                    "aria-describedby": ariaDescribedBy,
+                    "aria-invalid": isInvalid || void 0,
+                    "aria-required": props.required || void 0
+                  }
+                ),
+                /* @__PURE__ */ jsxs6(ComboboxActionButtons, { children: [
+                  /* @__PURE__ */ jsx8(ComboboxClear, { "aria-label": "Clear selection", children: /* @__PURE__ */ jsx8(ClearIcon, {}) }),
+                  /* @__PURE__ */ jsx8(ComboboxTrigger, { "aria-label": "Open popup", children: /* @__PURE__ */ jsx8(StyledChevron, { $isOpen: open, children: /* @__PURE__ */ jsx8(ChevronIcon, {}) }) })
+                ] })
+              ]
+            }
+          ),
           /* @__PURE__ */ jsx8(Combobox3.Portal, { container: portalContainer, children: /* @__PURE__ */ jsx8(ComboboxPositioner, { sideOffset: 4, children: /* @__PURE__ */ jsxs6(
             ComboboxPopup,
             {
@@ -1391,7 +1478,7 @@ function SingleCombobox(props) {
                         renderItem,
                         renderGroupHeading
                       }
-                    ) : children ? children : groups ? (group, index) => /* @__PURE__ */ jsxs6(React8.Fragment, { children: [
+                    ) : children ? children : groups ? ((group, index) => /* @__PURE__ */ jsxs6(React9.Fragment, { children: [
                       /* @__PURE__ */ jsxs6(ComboboxGroup, { items: group.items, children: [
                         /* @__PURE__ */ jsx8(ComboboxGroupLabel, { children: renderGroupHeading ? renderGroupHeading(group.value) : group.value }),
                         /* @__PURE__ */ jsx8(Combobox3.Collection, { children: (item) => /* @__PURE__ */ jsx8(
@@ -1408,7 +1495,7 @@ function SingleCombobox(props) {
                         ) })
                       ] }),
                       index < groups.length - 1 && /* @__PURE__ */ jsx8(ComboboxSeparator, {})
-                    ] }, group.value) : (item) => /* @__PURE__ */ jsx8(
+                    ] }, group.value)) : ((item) => /* @__PURE__ */ jsx8(
                       ComboboxItem_default,
                       {
                         value: item,
@@ -1419,7 +1506,7 @@ function SingleCombobox(props) {
                         renderItem: renderItem ? () => renderItem(item) : () => itemToString(item)
                       },
                       item.id
-                    )
+                    ))
                   }
                 )
               ]
@@ -1432,7 +1519,7 @@ function SingleCombobox(props) {
 }
 
 // src/v3/MultiCombobox.tsx
-import * as React9 from "react";
+import * as React10 from "react";
 import { Combobox as Combobox4 } from "@base-ui/react/combobox";
 import "@tanstack/react-virtual";
 import Icon3 from "@sproutsocial/seeds-react-icon";
@@ -1460,6 +1547,7 @@ function MultiCombobox(props) {
     fullWidth = true
   } = props;
   const ariaDescribedBy = props["aria-describedby"];
+  const isInvalid = props.isInvalid;
   const isChildrenMode = "children" in props && props.children != null;
   const data = isChildrenMode ? [] : props.data;
   const itemToString = isChildrenMode ? (_item) => "" : props.itemToString;
@@ -1471,6 +1559,7 @@ function MultiCombobox(props) {
   const inputType = isChildrenMode ? "checkbox" : removeSelectedItems ? "none" : props.inputType ?? "checkbox";
   const groupBy = isChildrenMode ? void 0 : props.groupBy;
   const renderGroupHeading = isChildrenMode ? void 0 : props.renderGroupHeading;
+  const isGroupHeaderDisabled = isChildrenMode ? void 0 : props.isGroupHeaderDisabled;
   const selectHeadings = isChildrenMode ? false : props.selectHeadings ?? false;
   const selectAllProp = isChildrenMode ? false : props.selectAll ?? false;
   const selectAll = Boolean(selectAllProp);
@@ -1483,29 +1572,31 @@ function MultiCombobox(props) {
   const defaultSelectedItemIds = props.defaultSelectedItemIds;
   const onSelectedItemIdsChange = props.onSelectedItemIdsChange;
   const { containerRef, portalContainer } = useSeedsPortalContainer();
-  const [open, setOpen] = React9.useState(false);
-  const [internalInputValue, setInternalInputValue] = React9.useState("");
-  const skipNextInputChangeRef = React9.useRef(false);
-  const virtualizerRef = React9.useRef(null);
+  const [open, setOpen] = React10.useState(false);
+  const [internalInputValue, setInternalInputValue] = React10.useState("");
+  const skipNextInputChangeRef = React10.useRef(false);
+  const virtualizerRef = React10.useRef(null);
+  const inputRef = React10.useRef(null);
+  const onInputKeyDownCapture = useSuppressEscapeClear(open);
   const isControlled = selectedItemIds !== void 0;
-  const idsToItems = React9.useCallback(
+  const idsToItems = React10.useCallback(
     (ids) => ids.map((id2) => data.find((d) => d.id === id2)).filter((d) => d != null),
     [data]
   );
-  const [internalValue, setInternalValue] = React9.useState(
+  const [internalValue, setInternalValue] = React10.useState(
     () => defaultSelectedItemIds ? idsToItems(defaultSelectedItemIds) : []
   );
   const value = isControlled ? idsToItems(selectedItemIds) : internalValue;
-  const visibleData = React9.useMemo(
+  const visibleData = React10.useMemo(
     () => removeSelectedItems ? data.filter((item) => !value.some((v) => v.id === item.id)) : data,
     [data, value, removeSelectedItems]
   );
-  const groups = React9.useMemo(
+  const groups = React10.useMemo(
     () => groupBy ? groupItems(visibleData, groupBy) : null,
     [visibleData, groupBy]
   );
   const currentInputValue = inputValue ?? internalInputValue;
-  const creatableSentinel = React9.useMemo(() => {
+  const creatableSentinel = React10.useMemo(() => {
     if (!creatableProp) return null;
     const trimmed = currentInputValue.trim();
     if (!trimmed) return null;
@@ -1516,7 +1607,7 @@ function MultiCombobox(props) {
     if (exactExists) return null;
     return makeCreatableSentinel(trimmed);
   }, [creatableProp, currentInputValue, data, itemToString]);
-  const flatItems = React9.useMemo(() => {
+  const flatItems = React10.useMemo(() => {
     if (!selectHeadings && !selectAll) return null;
     if (!groups && !selectAll) return null;
     const rows = [];
@@ -1567,6 +1658,7 @@ function MultiCombobox(props) {
     }
     let updated = [...realItems];
     for (const sentinel of groupSentinels) {
+      if (isGroupHeaderDisabled?.(sentinel.groupName)) continue;
       const group = groups?.find((g) => g.value === sentinel.groupName);
       if (!group) continue;
       const allSelected = group.items.every(
@@ -1602,6 +1694,7 @@ function MultiCombobox(props) {
     e.preventDefault();
     e.stopPropagation();
     setSelectedItems(value.filter((v) => v.id !== item.id));
+    inputRef.current?.focus();
   }
   function renderSentinelRow(row) {
     if (isSelectAllSentinel2(row)) {
@@ -1620,16 +1713,24 @@ function MultiCombobox(props) {
         (item2) => value.some((s) => s.id === item2.id)
       ).length;
       const state = selectedCount === 0 ? "none" : selectedCount === groupItemsList.length ? "all" : "partial";
-      return /* @__PURE__ */ jsxs7(ComboboxGroupHeaderItem, { value: row, children: [
-        /* @__PURE__ */ jsx9(
-          ComboboxGroupHeaderCheckbox,
-          {
-            $state: state,
-            id: `__header-${row.groupName}`
-          }
-        ),
-        renderGroupHeading ? renderGroupHeading(row.groupName) : row.groupName
-      ] }, `__header-${row.groupName}`);
+      return /* @__PURE__ */ jsxs7(
+        ComboboxGroupHeaderItem,
+        {
+          value: row,
+          disabled: isGroupHeaderDisabled?.(row.groupName),
+          children: [
+            /* @__PURE__ */ jsx9(
+              ComboboxGroupHeaderCheckbox,
+              {
+                $state: state,
+                id: `__header-${row.groupName}`
+              }
+            ),
+            renderGroupHeading ? renderGroupHeading(row.groupName) : row.groupName
+          ]
+        },
+        `__header-${row.groupName}`
+      );
     }
     if (isCreatableSentinel(row)) {
       return renderCreatableItem(row);
@@ -1683,7 +1784,10 @@ function MultiCombobox(props) {
         open,
         disabled: props.disabled,
         onOpenChange: (nextOpen, eventDetails) => {
-          if (!nextOpen && eventDetails.reason === "item-press") return;
+          if (!nextOpen && eventDetails.reason === "item-press") {
+            eventDetails.cancel();
+            return;
+          }
           setOpen(nextOpen);
         },
         filter: creatableProp ? (item, query) => {
@@ -1716,10 +1820,10 @@ function MultiCombobox(props) {
           if (!item || !virt) return;
           const isStart = index === 0;
           const isEnd = index === virt.options.count - 1;
-          if (reason === "none" || reason === "keyboard" && (isStart || isEnd)) {
+          if (reason === "keyboard" && (isStart || isEnd)) {
             queueMicrotask(() => {
               virt.scrollToIndex(index, {
-                align: isEnd ? "start" : "end"
+                align: isStart ? "start" : "end"
               });
             });
           }
@@ -1746,42 +1850,52 @@ function MultiCombobox(props) {
         },
         items: rootItems,
         children: [
-          /* @__PURE__ */ jsx9(ComboboxTokenInputGroup, { children: /* @__PURE__ */ jsxs7(ComboboxToken, { children: [
-            renderSelection ? renderSelection(value) : (() => {
-              const visibleTokens = maxTokens != null ? value.slice(0, maxTokens) : value;
-              const overflow = maxTokens != null ? value.length - maxTokens : 0;
-              return /* @__PURE__ */ jsxs7(Fragment6, { children: [
-                visibleTokens.map((item) => /* @__PURE__ */ jsxs7(Token, { children: [
-                  renderToken ? renderToken(item) : itemToString(item),
-                  /* @__PURE__ */ jsx9(
-                    TokenRemove,
-                    {
-                      "aria-label": `Remove ${itemToString(item)}`,
-                      onPointerDown: (e) => e.preventDefault(),
-                      onClick: (e) => removeItem(item, e),
-                      children: /* @__PURE__ */ jsx9(Icon3, { name: "x-outline", size: "mini" })
-                    }
-                  )
-                ] }, item.id)),
-                overflow > 0 && /* @__PURE__ */ jsxs7(Token, { children: [
-                  "+",
-                  overflow
-                ] }, "__overflow")
-              ] });
-            })(),
-            /* @__PURE__ */ jsx9(
-              ComboboxTokenInput,
-              {
-                id,
-                placeholder: value.length > 0 ? "" : placeholder,
-                "aria-describedby": ariaDescribedBy
-              }
-            ),
-            /* @__PURE__ */ jsxs7(ComboboxActionButtons, { children: [
-              /* @__PURE__ */ jsx9(ComboboxClear, { "aria-label": "Clear all", children: /* @__PURE__ */ jsx9(ClearIcon, {}) }),
-              /* @__PURE__ */ jsx9(ComboboxTrigger, { "aria-label": "Open popup", children: /* @__PURE__ */ jsx9(StyledChevron, { $isOpen: open, children: /* @__PURE__ */ jsx9(ChevronIcon, {}) }) })
-            ] })
-          ] }) }),
+          /* @__PURE__ */ jsx9(
+            ComboboxTokenInputGroup,
+            {
+              $isInvalid: isInvalid,
+              onKeyDownCapture: onInputKeyDownCapture,
+              children: /* @__PURE__ */ jsxs7(ComboboxToken, { children: [
+                renderSelection ? renderSelection(value) : (() => {
+                  const visibleTokens = maxTokens != null ? value.slice(0, maxTokens) : value;
+                  const overflow = maxTokens != null ? value.length - maxTokens : 0;
+                  return /* @__PURE__ */ jsxs7(Fragment6, { children: [
+                    visibleTokens.map((item) => /* @__PURE__ */ jsxs7(Token, { children: [
+                      renderToken ? renderToken(item) : itemToString(item),
+                      /* @__PURE__ */ jsx9(
+                        TokenRemove,
+                        {
+                          "aria-label": `Remove ${itemToString(item)}`,
+                          onPointerDown: (e) => e.preventDefault(),
+                          onClick: (e) => removeItem(item, e),
+                          children: /* @__PURE__ */ jsx9(Icon3, { name: "x-outline", size: "mini" })
+                        }
+                      )
+                    ] }, item.id)),
+                    overflow > 0 && /* @__PURE__ */ jsxs7(Token, { children: [
+                      "+",
+                      overflow
+                    ] }, "__overflow")
+                  ] });
+                })(),
+                /* @__PURE__ */ jsx9(
+                  ComboboxTokenInput,
+                  {
+                    ref: inputRef,
+                    id,
+                    placeholder: value.length > 0 ? "" : placeholder,
+                    "aria-describedby": ariaDescribedBy,
+                    "aria-invalid": isInvalid || void 0,
+                    "aria-required": props.required || void 0
+                  }
+                ),
+                /* @__PURE__ */ jsxs7(ComboboxActionButtons, { children: [
+                  /* @__PURE__ */ jsx9(ComboboxClear, { "aria-label": "Clear all", children: /* @__PURE__ */ jsx9(ClearIcon, {}) }),
+                  /* @__PURE__ */ jsx9(ComboboxTrigger, { "aria-label": "Open popup", children: /* @__PURE__ */ jsx9(StyledChevron, { $isOpen: open, children: /* @__PURE__ */ jsx9(ChevronIcon, {}) }) })
+                ] })
+              ] })
+            }
+          ),
           /* @__PURE__ */ jsx9(Combobox4.Portal, { container: portalContainer, children: /* @__PURE__ */ jsx9(ComboboxPositioner, { sideOffset: 4, children: /* @__PURE__ */ jsxs7(
             ComboboxPopup,
             {
@@ -1812,6 +1926,7 @@ function MultiCombobox(props) {
                         inputType,
                         renderItem,
                         renderGroupHeading,
+                        isGroupHeaderDisabled,
                         renderCreatableItem: creatableProp ? (sentinel, style, index, measureRef) => renderCreatableItem(
                           sentinel,
                           style,
@@ -1819,12 +1934,12 @@ function MultiCombobox(props) {
                           measureRef
                         ) : void 0
                       }
-                    ) : children ? children : flatItems ? (row) => renderSentinelRow(row) : groups ? (group, index) => {
+                    ) : children ? children : flatItems ? ((row) => renderSentinelRow(row)) : groups ? ((group, index) => {
                       if (isCreatableSentinel(group)) {
                         return renderCreatableItem(group);
                       }
                       const g = group;
-                      return /* @__PURE__ */ jsxs7(React9.Fragment, { children: [
+                      return /* @__PURE__ */ jsxs7(React10.Fragment, { children: [
                         /* @__PURE__ */ jsxs7(ComboboxGroup, { items: g.items, children: [
                           /* @__PURE__ */ jsx9(ComboboxGroupLabel, { children: renderGroupHeading ? renderGroupHeading(g.value) : g.value }),
                           /* @__PURE__ */ jsx9(Combobox4.Collection, { children: (item) => /* @__PURE__ */ jsx9(
@@ -1842,7 +1957,7 @@ function MultiCombobox(props) {
                         ] }),
                         index < groups.length - 1 && /* @__PURE__ */ jsx9(ComboboxSeparator, {})
                       ] }, g.value);
-                    } : (item) => {
+                    }) : ((item) => {
                       if (isCreatableSentinel(item)) {
                         return renderCreatableItem(item);
                       }
@@ -1859,7 +1974,7 @@ function MultiCombobox(props) {
                         },
                         dataItem.id
                       );
-                    }
+                    })
                   }
                 )
               ]
@@ -1872,7 +1987,7 @@ function MultiCombobox(props) {
 }
 
 // src/v3/SingleSearchableSelect.tsx
-import * as React10 from "react";
+import * as React11 from "react";
 import { Combobox as Combobox5 } from "@base-ui/react/combobox";
 import "@tanstack/react-virtual";
 import { Fragment as Fragment8, jsx as jsx10, jsxs as jsxs8 } from "react/jsx-runtime";
@@ -1889,6 +2004,7 @@ function SingleSearchableSelect(props) {
     fullWidth = true
   } = props;
   const ariaDescribedBy = props["aria-describedby"];
+  const isInvalid = props.isInvalid;
   const isChildrenMode = "children" in props && props.children != null;
   const data = isChildrenMode ? [] : props.data;
   const itemToString = isChildrenMode ? (_item) => "" : props.itemToString;
@@ -1903,17 +2019,17 @@ function SingleSearchableSelect(props) {
   const defaultSelectedItemId = props.defaultSelectedItemId;
   const onSelectedItemIdChange = props.onSelectedItemIdChange;
   const { containerRef, portalContainer } = useSeedsPortalContainer();
-  const [open, setOpen] = React10.useState(false);
-  const virtualizerRef = React10.useRef(null);
+  const [open, setOpen] = React11.useState(false);
+  const virtualizerRef = React11.useRef(null);
   const isControlled = selectedItemId !== void 0;
-  const idToItem = React10.useCallback(
+  const idToItem = React11.useCallback(
     (id2) => {
       if (id2 == null) return null;
       return data.find((d) => String(d.id) === String(id2)) ?? null;
     },
     [data]
   );
-  const [internalValue, setInternalValue] = React10.useState(
+  const [internalValue, setInternalValue] = React11.useState(
     () => idToItem(defaultSelectedItemId)
   );
   const value = isControlled ? idToItem(selectedItemId) : internalValue;
@@ -1924,7 +2040,7 @@ function SingleSearchableSelect(props) {
       onSelectedItemIdChange(realItem ? realItem.id : null);
     }
   }
-  const groups = React10.useMemo(
+  const groups = React11.useMemo(
     () => groupBy ? groupItems(data, groupBy) : null,
     [data, groupBy]
   );
@@ -1954,19 +2070,29 @@ function SingleSearchableSelect(props) {
           if (!item || !virt) return;
           const isStart = index === 0;
           const isEnd = index === virt.options.count - 1;
-          if (reason === "none" || reason === "keyboard" && (isStart || isEnd)) {
+          if (reason === "keyboard" && (isStart || isEnd)) {
             queueMicrotask(() => {
               virt.scrollToIndex(index, {
-                align: isEnd ? "start" : "end"
+                align: isStart ? "start" : "end"
               });
             });
           }
         } : void 0,
         children: [
-          /* @__PURE__ */ jsxs8(SearchableSelectTrigger, { id, "aria-describedby": ariaDescribedBy, children: [
-            /* @__PURE__ */ jsx10(SearchableSelectPlaceholder, { children: /* @__PURE__ */ jsx10(Combobox5.Value, { placeholder, children: value ? renderSelection ? renderSelection(value) : itemToString(value) : placeholder }) }),
-            /* @__PURE__ */ jsx10(SearchableSelectTriggerIcon, { children: /* @__PURE__ */ jsx10(StyledChevron, { "data-chevron": true, children: /* @__PURE__ */ jsx10(ChevronIcon, {}) }) })
-          ] }),
+          /* @__PURE__ */ jsxs8(
+            SearchableSelectTrigger,
+            {
+              id,
+              "aria-describedby": ariaDescribedBy,
+              "aria-invalid": isInvalid || void 0,
+              "aria-required": props.required || void 0,
+              $isInvalid: isInvalid,
+              children: [
+                /* @__PURE__ */ jsx10(SearchableSelectPlaceholder, { children: /* @__PURE__ */ jsx10(Combobox5.Value, { placeholder, children: value ? renderSelection ? renderSelection(value) : itemToString(value) : placeholder }) }),
+                /* @__PURE__ */ jsx10(SearchableSelectTriggerIcon, { children: /* @__PURE__ */ jsx10(StyledChevron, { "data-chevron": true, children: /* @__PURE__ */ jsx10(ChevronIcon, {}) }) })
+              ]
+            }
+          ),
           /* @__PURE__ */ jsx10(Combobox5.Portal, { container: portalContainer, children: /* @__PURE__ */ jsx10(ComboboxPositioner, { sideOffset: 4, children: /* @__PURE__ */ jsxs8(
             SearchableSelectPopup,
             {
@@ -2004,7 +2130,7 @@ function SingleSearchableSelect(props) {
                         inputType,
                         renderItem
                       }
-                    ) : children ? children : groups ? (group, index) => /* @__PURE__ */ jsxs8(React10.Fragment, { children: [
+                    ) : children ? children : groups ? ((group, index) => /* @__PURE__ */ jsxs8(React11.Fragment, { children: [
                       /* @__PURE__ */ jsxs8(ComboboxGroup, { items: group.items, children: [
                         /* @__PURE__ */ jsx10(ComboboxGroupLabel, { children: renderGroupHeading ? renderGroupHeading(group.value) : group.value }),
                         /* @__PURE__ */ jsx10(Combobox5.Collection, { children: (item) => /* @__PURE__ */ jsx10(
@@ -2021,7 +2147,7 @@ function SingleSearchableSelect(props) {
                         ) })
                       ] }),
                       index < groups.length - 1 && /* @__PURE__ */ jsx10(ComboboxSeparator, {})
-                    ] }, group.value) : /* @__PURE__ */ jsxs8(Fragment8, { children: [
+                    ] }, group.value)) : /* @__PURE__ */ jsxs8(Fragment8, { children: [
                       includePlaceholderItem && /* @__PURE__ */ jsx10(
                         ComboboxItem_default,
                         {
@@ -2057,7 +2183,7 @@ function SingleSearchableSelect(props) {
 }
 
 // src/v3/MultiSearchableSelect.tsx
-import * as React11 from "react";
+import * as React12 from "react";
 import { Combobox as Combobox6 } from "@base-ui/react/combobox";
 import "@tanstack/react-virtual";
 import Icon4 from "@sproutsocial/seeds-react-icon";
@@ -2091,6 +2217,7 @@ function MultiSearchableSelect(props) {
     fullWidth = true
   } = props;
   const ariaDescribedBy = props["aria-describedby"];
+  const isInvalid = props.isInvalid;
   const isChildrenMode = "children" in props && props.children != null;
   const data = isChildrenMode ? [] : props.data;
   const itemToString = isChildrenMode ? (_item) => "" : props.itemToString;
@@ -2112,29 +2239,29 @@ function MultiSearchableSelect(props) {
   const defaultSelectedItemIds = props.defaultSelectedItemIds;
   const onSelectedItemIdsChange = props.onSelectedItemIdsChange;
   const { containerRef, portalContainer } = useSeedsPortalContainer();
-  const [open, setOpen] = React11.useState(false);
-  const [internalInputValue, setInternalInputValue] = React11.useState("");
-  const skipNextInputChangeRef = React11.useRef(false);
-  const virtualizerRef = React11.useRef(null);
+  const [open, setOpen] = React12.useState(false);
+  const [internalInputValue, setInternalInputValue] = React12.useState("");
+  const skipNextInputChangeRef = React12.useRef(false);
+  const virtualizerRef = React12.useRef(null);
   const isControlled = selectedItemIds !== void 0;
-  const idsToItems = React11.useCallback(
+  const idsToItems = React12.useCallback(
     (ids) => ids.map((id2) => data.find((d) => d.id === id2)).filter((d) => d != null),
     [data]
   );
-  const [internalValue, setInternalValue] = React11.useState(
+  const [internalValue, setInternalValue] = React12.useState(
     () => defaultSelectedItemIds ? idsToItems(defaultSelectedItemIds) : []
   );
   const value = isControlled ? idsToItems(selectedItemIds) : internalValue;
-  const visibleData = React11.useMemo(
+  const visibleData = React12.useMemo(
     () => removeSelectedItems ? data.filter((item) => !value.some((v) => v.id === item.id)) : data,
     [data, value, removeSelectedItems]
   );
-  const groups = React11.useMemo(
+  const groups = React12.useMemo(
     () => groupBy ? groupItems(visibleData, groupBy) : null,
     [visibleData, groupBy]
   );
   const currentInputValue = internalInputValue;
-  const creatableSentinel = React11.useMemo(() => {
+  const creatableSentinel = React12.useMemo(() => {
     if (!creatableProp) return null;
     const trimmed = currentInputValue.trim();
     if (!trimmed) return null;
@@ -2145,7 +2272,7 @@ function MultiSearchableSelect(props) {
     if (exactExists) return null;
     return makeCreatableSentinel(trimmed);
   }, [creatableProp, currentInputValue, data, itemToString]);
-  const flatItems = React11.useMemo(() => {
+  const flatItems = React12.useMemo(() => {
     if (!groups || !selectHeadings && !selectAll) return null;
     const rows = [];
     if (selectAll) rows.push(SELECT_ALL_SENTINEL2);
@@ -2322,10 +2449,10 @@ function MultiSearchableSelect(props) {
           if (!item || !virt) return;
           const isStart = index === 0;
           const isEnd = index === virt.options.count - 1;
-          if (reason === "none" || reason === "keyboard" && (isStart || isEnd)) {
+          if (reason === "keyboard" && (isStart || isEnd)) {
             queueMicrotask(() => {
               virt.scrollToIndex(index, {
-                align: isEnd ? "start" : "end"
+                align: isStart ? "start" : "end"
               });
             });
           }
@@ -2357,6 +2484,9 @@ function MultiSearchableSelect(props) {
             {
               id,
               "aria-describedby": ariaDescribedBy,
+              "aria-invalid": isInvalid || void 0,
+              "aria-required": props.required || void 0,
+              $isInvalid: isInvalid,
               children: [
                 renderSelection ? renderSelection(value) : value.length > 0 ? (() => {
                   const visibleItems = maxSelections != null ? value.slice(0, maxSelections) : value;
@@ -2417,12 +2547,12 @@ function MultiSearchableSelect(props) {
                           measureRef
                         ) : void 0
                       }
-                    ) : children ? children : flatItems ? (row) => renderSentinelRow(row) : groups ? (group, index) => {
+                    ) : children ? children : flatItems ? ((row) => renderSentinelRow(row)) : groups ? ((group, index) => {
                       if (isCreatableSentinel(group)) {
                         return renderCreatableItem(group);
                       }
                       const g = group;
-                      return /* @__PURE__ */ jsxs9(React11.Fragment, { children: [
+                      return /* @__PURE__ */ jsxs9(React12.Fragment, { children: [
                         /* @__PURE__ */ jsxs9(ComboboxGroup, { items: g.items, children: [
                           /* @__PURE__ */ jsx11(ComboboxGroupLabel, { children: renderGroupHeading ? renderGroupHeading(g.value) : g.value }),
                           /* @__PURE__ */ jsx11(Combobox6.Collection, { children: (item) => /* @__PURE__ */ jsx11(
@@ -2440,7 +2570,7 @@ function MultiSearchableSelect(props) {
                         ] }),
                         index < groups.length - 1 && /* @__PURE__ */ jsx11(ComboboxSeparator, {})
                       ] }, g.value);
-                    } : (item) => {
+                    }) : ((item) => {
                       if (isCreatableSentinel(item)) {
                         return renderCreatableItem(item);
                       }
@@ -2457,7 +2587,7 @@ function MultiSearchableSelect(props) {
                         },
                         dataItem.id
                       );
-                    }
+                    })
                   }
                 )
               ]
@@ -2470,7 +2600,7 @@ function MultiSearchableSelect(props) {
 }
 
 // src/v3/ActionMenu.tsx
-import * as React12 from "react";
+import * as React13 from "react";
 import { Menu as Menu2 } from "@base-ui/react/menu";
 import Radio3 from "@sproutsocial/seeds-react-radio";
 import Checkbox4 from "@sproutsocial/seeds-react-checkbox";
@@ -2478,23 +2608,25 @@ import { Icon as Icon5 } from "@sproutsocial/seeds-react-icon";
 
 // src/v3/ActionMenuStyles.tsx
 import { Menu } from "@base-ui/react/menu";
-import styled8, { css } from "styled-components";
+import styled8, { css as css3 } from "styled-components";
 import "@sproutsocial/seeds-react-mixins";
 var ActionMenuTrigger = styled8(Menu.Trigger)``;
 var ActionMenuPositioner = styled8(Menu.Positioner)`
   min-width: var(--anchor-width);
   z-index: 7;
 `;
-var ActionMenuPopup = styled8(Menu.Popup)`
+var ActionMenuPopup = styled8(Menu.Popup).attrs({
+  "data-base-ui-swipe-ignore": ""
+})`
   font-family: ${({ theme }) => theme.fontFamily};
   background: ${({ theme }) => theme.colors.container.background.base};
   border: 1px solid ${({ theme }) => theme.colors.container.border.base};
   border-radius: ${({ theme }) => theme.radii[500]};
   box-shadow: ${({ theme }) => theme.shadows.low};
   outline: none;
-  max-height: min(var(--base-ui-available-height, 400px), 400px);
+  max-height: min(var(--available-height, 400px), 400px);
   overflow-y: auto;
-  padding: ${({ theme }) => theme.space[200]};
+  padding: ${({ theme }) => theme.space[300]};
 
   &[data-open] {
     animation: action-menu-popup-in 120ms ease-out;
@@ -2530,19 +2662,16 @@ var ActionMenuGroup = styled8(Menu.Group)`
   display: block;
 `;
 var ActionMenuGroupLabel = styled8(Menu.GroupLabel)`
-  padding: ${({ theme }) => `${theme.space[300]} ${theme.space[300]} ${theme.space[200]}`};
+  padding: ${({ theme }) => `${theme.space[300]}`};
   font-size: ${({ theme }) => theme.typography[100].fontSize};
-  font-weight: ${({ theme }) => theme.fontWeights.semibold};
-  text-transform: uppercase;
-  letter-spacing: 0.05em;
-  color: ${({ theme }) => theme.colors.text.subtext};
+  color: ${({ theme }) => theme.colors.text.body};
 `;
 var ActionMenuSeparator = styled8(Menu.Separator)`
   height: 1px;
-  margin: ${({ theme }) => `${theme.space[200]} ${theme.space[300]}`};
+  margin: ${({ theme }) => `${theme.space[300]} -${theme.space[300]}`};
   background: ${({ theme }) => theme.colors.container.border.base};
 `;
-var menuItemStyles = css`
+var menuItemStyles = css3`
   box-sizing: border-box;
   display: block;
   width: 100%;
@@ -2671,7 +2800,7 @@ function MenuRadioGroup({
   );
 }
 function MenuItem(props) {
-  const generatedId = React12.useId();
+  const generatedId = React13.useId();
   if (props.type === "checkbox") {
     const {
       children: children2,
@@ -2812,6 +2941,81 @@ function MenuSubTrigger({
     }
   );
 }
+
+// src/v3/MenuButton.tsx
+import "react";
+import "@sproutsocial/seeds-react-button";
+import { Icon as Icon6 } from "@sproutsocial/seeds-react-icon";
+
+// src/v3/MenuButtonStyles.tsx
+import styled9 from "styled-components";
+import { Button } from "@sproutsocial/seeds-react-button";
+var MenuButtonContainer = styled9.div`
+  display: inline-flex;
+  gap: 1px;
+`;
+var MainButton = styled9(Button)`
+  && {
+    border-top-right-radius: 0;
+    border-bottom-right-radius: 0;
+  }
+`;
+var TriggerButton = styled9(Button)`
+  && {
+    border-top-left-radius: 0;
+    border-bottom-left-radius: 0;
+  }
+
+  .Icon-svg {
+    transition: transform ${({ theme }) => theme.duration.fast} ease;
+  }
+
+  &[data-popup-open] .Icon-svg {
+    transform: rotate(180deg);
+  }
+`;
+
+// src/v3/MenuButton.tsx
+import { jsx as jsx13, jsxs as jsxs11 } from "react/jsx-runtime";
+function MenuButton({
+  actionMenu,
+  appearance = "primary",
+  size,
+  disabled,
+  menuButtonAriaLabel,
+  children,
+  ...rest
+}) {
+  return /* @__PURE__ */ jsxs11(MenuButtonContainer, { children: [
+    /* @__PURE__ */ jsx13(
+      MainButton,
+      {
+        appearance,
+        size,
+        disabled,
+        ...rest,
+        children
+      }
+    ),
+    /* @__PURE__ */ jsx13(
+      ActionMenu,
+      {
+        disabled,
+        trigger: /* @__PURE__ */ jsx13(
+          TriggerButton,
+          {
+            appearance,
+            size,
+            disabled,
+            ariaLabel: menuButtonAriaLabel,
+            children: /* @__PURE__ */ jsx13(Icon6, { name: "chevron-down-outline", fixedWidth: true, "aria-hidden": true })
+          }
+        ),
+        children: actionMenu
+      }
+    )
+  ] });
+}
 export {
   ActionMenu,
   ComboboxActionButtons,
@@ -2836,6 +3040,7 @@ export {
   ComboboxTokenInput,
   ComboboxTokenInputGroup,
   ComboboxTrigger,
+  MenuButton,
   MenuGroup,
   MenuItem,
   MenuRadioGroup,