@servicetitan/anvil2 1.37.2 → 1.38.0

package/dist/{Combobox-Dde7-7tv.js → Combobox-7ADxZKDE.js}

@@ -3,23 +3,24 @@ import { useTrackingId } from './useTrackingId.js';
 import React__default, { useRef, useEffect, useMemo, useCallback, useLayoutEffect, useReducer, cloneElement, Component, useState, createContext, useId, useContext, useDeferredValue } from 'react';
 import { g as getDefaultExportFromCjs, c as cx } from './index-tZvMCc77.js';
 import { a as _extends, _ as _objectWithoutPropertiesLoose } from './extends-Bg2s_OKl.js';
-import { e as PopoverLegacy, d as Popover, u as usePopoverLegacyContext, f as usePopoverContext } from './Popover-CpyYXmal-I-E-B4u8.js';
+import { e as PopoverLegacy, d as Popover, u as usePopoverLegacyContext, f as usePopoverContext } from './Popover-VztF0YHt-ci3tYiye.js';
 import { s as styles$3 } from './Listbox.module-DcBE8Zmo-DcBE8Zmo.js';
-import { L as Label, H as Helper, s as supportsPopover } from './ProgressBar-CeClhdcf-Dcft7ZjO.js';
-import { F as Flex } from './Flex-EX9xObMl-BPBQ7nb5.js';
-import { B as Button } from './Button-C-QpfgfF-CRBE7KiD.js';
-import { C as Chip } from './Chip-DwiMFYBm-CIDM1d8e.js';
+import { L as Label, s as supportsPopover } from './ProgressBar-Cfi5zZRy-BpESsdh_.js';
+import { F as Flex } from './Flex-CiK7uNUu-BfxHG4L0.js';
+import { B as Button } from './Button-BaHFf1AT-BQy-PFB5.js';
+import { C as Chip } from './Chip-_daV8CmM-CTke7zH4.js';
 import { S as SvgClose } from './close-DZj38AEh.js';
 import { S as SvgChevronRight } from './chevron_right-BdpsxX7x.js';
-import { T as Text } from './Text-CN_-FF7J-Dzoy8A70.js';
+import { H as Helper } from './Helper-C9sHaTrI-C5fAsK6i.js';
+import { T as Text } from './Text-DCvcLCvf-DlmnnjTR.js';
 import { S as Spinner } from './Spinner-DliJVzdW-BQlZEj4V.js';
 import { s as styles$2 } from './ListView.module-MVsNF0X0-MVsNF0X0.js';
-import { I as Icon$2 } from './Icon-BrdmZw1i-CG-LzgEz.js';
+import { I as Icon$2 } from './Icon-B6HmlQiR-BxQkO3X5.js';
 import { c as checkboxStyles, S as SvgIndeterminateCheckBox, a as SvgCheckBox, b as SvgCheckBoxOutlineBlank } from './Checkbox.module-DZ58p15b-BUsQC1lW.js';
 import { S as SvgCheck } from './check-Cf67OWrZ.js';
-import { u as useLayoutPropsUtil } from './useLayoutPropsUtil-GT5myWCm-Clw_nEze.js';
+import { u as useLayoutPropsUtil } from './useLayoutPropsUtil-DWACCL8v-CZNrcQT-.js';
 import { c as childrenToString } from './childrenToString-Bz9MqbHb-Bz9MqbHb.js';
-import { a as Avatar } from './Avatar-C2IfIAxL-BUio7c00.js';
+import { a as Avatar } from './Avatar-B20IdOEO-Di14brYV.js';
 
 import './Combobox.css';function _setPrototypeOf(t, e) {
   return _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function (t, e) {
@@ -7363,7 +7364,7 @@ const SelectLegacyMultiple = function(props) {
 };
 
 const ComboboxLegacyTrigger = ({
-  variant: variantProp = "combobox",
+  // variant: variantProp = "combobox",
   className,
   label,
   size,
@@ -7592,7 +7593,7 @@ const ComboboxLegacyTrigger = ({
                         {
                           ...selectedItemProps,
                           label: itemToString(item),
-                          onClose: isDisabled || isReadOnly ? void 0 : (e) => {
+                          onClose: isDisabled || isReadOnly ? void 0 : (_e) => {
                             removeSelectedItem(item);
                           },
                           className: styles$1["chip"],
@@ -8119,7 +8120,7 @@ const styles = {
 };
 
 const ComboboxTrigger = function({
-  variant: variantProp = "combobox",
+  // variant: variantProp = "combobox",
   className,
   label,
   size,
@@ -8347,7 +8348,7 @@ const ComboboxTrigger = function({
                         {
                           ...selectedItemProps,
                           label: itemToString(item),
-                          onClose: isDisabled || isReadOnly ? void 0 : (e) => {
+                          onClose: isDisabled || isReadOnly ? void 0 : (_e) => {
                             removeSelectedItem(item);
                           },
                           className: styles["chip"],
@@ -8488,7 +8489,7 @@ const ComboboxContentElement = function({
     };
   }, [disablePopover, setHasDisabledPopover]);
   const context = usePopoverContext();
-  const handleBlur = (e) => {
+  const handleBlur = (_e) => {
     if (context?.controlled) return;
     context?.popover.close?.(closeMenu);
   };
@@ -8604,8 +8605,8 @@ const ComboboxContent$1 = function({
   return /* @__PURE__ */ jsx(
     ComboboxContentElement,
     {
-      disablePopover,
       className,
+      disablePopover,
       ...rest,
       children
     }
@@ -9013,7 +9014,7 @@ const ComboboxSingle = function(props) {
   const [isDisabled, setIsDisabled] = useState(disabled);
   const referenceRef = useRef(null);
   const contentRef = useRef(null);
-  const handleOutsidePress = (e) => {
+  const handleOutsidePress = (_e) => {
     if (disableCloseOnClickOutside) return;
     closeMenu();
   };
@@ -9303,7 +9304,7 @@ const ComboboxMultiple = function(props) {
   let storedSetInputValue = void 0;
   const referenceRef = useRef(null);
   const contentRef = useRef(null);
-  const handleOutsidePress = (e) => {
+  const handleOutsidePress = (_e) => {
     if (disableCloseOnClickOutside) return;
     closeMenu();
   };
@@ -9642,7 +9643,7 @@ const SelectSingle = function(props) {
   const [isDisabled, setIsDisabled] = useState(disabled);
   const referenceRef = useRef(null);
   const contentRef = useRef(null);
-  const handleOutsidePress = (e) => {
+  const handleOutsidePress = (_e) => {
     if (disableCloseOnClickOutside) return;
     closeMenu();
   };
@@ -9821,7 +9822,7 @@ const SelectMultiple = function(props) {
   const [isDisabled, setIsDisabled] = useState(disabled);
   const referenceRef = useRef(null);
   const contentRef = useRef(null);
-  const handleOutsidePress = (e) => {
+  const handleOutsidePress = (_e) => {
     if (disableCloseOnClickOutside) return;
     closeMenu();
   };
@@ -10235,6 +10236,9 @@ const ComboboxElement = function(props) {
 const ComboboxSelect = function(props) {
   return /* @__PURE__ */ jsx(ComboboxSelect$1, { ...props });
 };
+const ComboboxContent = function(props) {
+  return /* @__PURE__ */ jsx(Combobox$1.Content, { ...props });
+};
 const ComboboxSearchField = function({
   prefix: prefixProp,
   ...props
@@ -10305,9 +10309,6 @@ const ComboboxSelectTrigger = function({
     }
   );
 };
-const ComboboxContent = function(props) {
-  return /* @__PURE__ */ jsx(Combobox$1.Content, { ...props });
-};
 const ComboboxList = function(props) {
   return /* @__PURE__ */ jsx(Combobox$1.List, { ...props });
 };
@@ -10337,15 +10338,177 @@ const ComboboxEmpty = function(props) {
   return /* @__PURE__ */ jsx(Combobox$1.Empty, { ...props });
 };
 const Combobox = Object.assign(ComboboxElement, {
+  /**
+   * ComboboxSelect component for selecting items from a predefined list.
+   *
+   * Features:
+   * - Single and multiple item selection from predefined options
+   * - Dropdown-style selection interface
+   * - Grouping support with custom group labels and sorting
+   * - Loading states with spinner indicators
+   * - Disabled and read-only states
+   * - Customizable popover behavior and positioning
+   * - Full accessibility support with ARIA attributes
+   * - Keyboard navigation support
+   * - Layout utility props for positioning and spacing
+   * - Automatic tracking ID generation for analytics
+   *
+   * @example
+   * <Combobox.Select
+   *   items={items}
+   *   itemToString={(item) => item.name}
+   *   onChange={setSelectedItem}
+   * >
+   *   <Combobox.SelectTrigger label="Select an item" />
+   *   <Combobox.Content>
+   *     {({ items }) => (
+   *       <Combobox.List>
+   *         {items.map((item, i) => (
+   *           <Combobox.Item key={item.id} item={item} index={i}>
+   *             {item.name}
+   *           </Combobox.Item>
+   *         ))}
+   *       </Combobox.List>
+   *     )}
+   *   </Combobox.Content>
+   * </Combobox.Select>
+   */
   Select: ComboboxSelect,
+  /**
+   * ComboboxSearchField component for the search input field.
+   *
+   * Features:
+   * - Search input with clear button functionality
+   * - Supports multiple selection with chip display
+   * - Handles keyboard navigation and accessibility
+   * - Integrates with combobox state management
+   * - Supports custom styling and layout
+   * - Manages focus and blur events
+   * - Enhanced prefix support for icons and avatars
+   * - Automatic tracking ID generation for analytics
+   *
+   * @example
+   * <Combobox.SearchField
+   *   label="Search users"
+   *   placeholder="Type to search..."
+   *   prefix={{ icon: { svg: SearchIcon } }}
+   * />
+   */
   SearchField: ComboboxSearchField,
+  /**
+   * ComboboxSelectTrigger component for the select trigger field.
+   *
+   * Features:
+   * - Select input with dropdown trigger
+   * - Supports single selection display
+   * - Handles keyboard navigation and accessibility
+   * - Integrates with combobox state management
+   * - Supports custom styling and layout
+   * - Manages focus and blur events
+   * - Enhanced prefix support for icons and avatars
+   * - Automatic tracking ID generation for analytics
+   *
+   * @example
+   * <Combobox.SelectTrigger
+   *   label="Select user"
+   *   placeholder="Choose a user..."
+   *   prefix={{ avatar: { name: "User" } }}
+   * />
+   */
   SelectTrigger: ComboboxSelectTrigger,
+  /**
+   * ComboboxContent component for rendering the content area of a combobox.
+   *
+   * Features:
+   * - Supports both popover and inline rendering modes
+   * - Provides render props pattern for flexible content rendering
+   * - Handles grouped items with proper ARIA labels
+   * - Integrates with combobox state management
+   * - Supports custom styling and layout
+   * - Manages focus and blur events for popover behavior
+   *
+   * @example
+   * <Combobox.Content>
+   *   {({ items }) => (
+   *     <Combobox.List>
+   *       {items.map((item, index) => (
+   *         <Combobox.Item key={item.id} item={item} index={index}>
+   *           {item.name}
+   *         </Combobox.Item>
+   *       ))}
+   *     </Combobox.List>
+   *   )}
+   * </Combobox.Content>
+   */
   Content: ComboboxContent,
+  /**
+   * ComboboxList component for rendering the list of items.
+   *
+   * Features:
+   * - Renders list of items with proper accessibility
+   * - Supports both single and multiple selection modes
+   * - Loading state with spinner
+   * - Empty state handling
+   * - Automatic tracking ID generation for analytics
+   *
+   * @example
+   * <Combobox.List>
+   *   {items.map((item, i) => (
+   *     <Combobox.Item key={item.id} item={item} index={i}>
+   *       {item.name}
+   *     </Combobox.Item>
+   *   ))}
+   * </Combobox.List>
+   */
   List: ComboboxList,
+  /**
+   * ComboboxItem component for rendering individual items in the list.
+   *
+   * Features:
+   * - Individual item rendering with proper accessibility
+   * - Support for disabled state
+   * - Custom content rendering
+   * - Automatic tracking ID generation for analytics
+   *
+   * @example
+   * <Combobox.Item item={item} index={index}>
+   *   <Flex direction="column">
+   *     <Text>{item.name}</Text>
+   *     <Text size="small" subdued>{item.description}</Text>
+   *   </Flex>
+   * </Combobox.Item>
+   */
   Item: ComboboxItem,
+  /**
+   * ComboboxItemAddNew component for rendering an "Add New" option.
+   *
+   * Features:
+   * - "Add New" option that appears when no exact match is found
+   * - Customizable content rendering
+   * - Callback when selected
+   * - Automatic tracking ID generation for analytics
+   *
+   * @example
+   * <Combobox.ItemAddNew onSelection={(inputValue) => addNewItem(inputValue)}>
+   *   Add "{inputValue}" as new item
+   * </Combobox.ItemAddNew>
+   */
   ItemAddNew: ComboboxItemAddNew,
+  /**
+   * ComboboxEmpty component for rendering content when no items are available.
+   *
+   * Features:
+   * - Renders content when list is empty
+   * - Customizable empty state message
+   * - Automatic tracking ID generation for analytics
+   *
+   * @example
+   * <Combobox.Empty>
+   *   <Text>No items found. Try adjusting your search.</Text>
+   * </Combobox.Empty>
+   */
   Empty: ComboboxEmpty
 });
 
-export { Combobox as C, ComboboxElement as a, ComboboxSelect as b, ComboboxSearchField as c, ComboboxSelectTrigger as d, ComboboxContent as e, ComboboxList as f, ComboboxItem as g, ComboboxItemAddNew as h, ComboboxEmpty as i, useInfiniteCombobox as u };
-//# sourceMappingURL=Combobox-Dde7-7tv.js.map
+export { Combobox as C, ComboboxElement as a, ComboboxSelect as b, ComboboxContent as c, ComboboxSearchField as d, ComboboxSelectTrigger as e, ComboboxList as f, ComboboxItem as g, ComboboxItemAddNew as h, ComboboxEmpty as i, useInfiniteCombobox as u };
+//# sourceMappingURL=Combobox-7ADxZKDE.js.map