@servicetitan/anvil2 3.0.4 → 3.0.6

package/dist/index.js

@@ -1,73 +1,73 @@
 export { DndSort, DndSortCard, DndSortZone } from './DndSort.js';
-export { A as Alert } from './Alert-BTesdKK7.js';
-export { A as AiMark } from './AiMark-DjOf60tj.js';
+export { A as Alert } from './Alert-BNH0UD2s.js';
+export { A as AiMark } from './AiMark-BXL0sWIV.js';
 export { A as Announcement } from './Announcement-CgTqDU8A.js';
 export { A as Avatar } from './Avatar-B_cRQqKR.js';
 export { A as AvatarGroup } from './Avatar-FDHyqiCy.js';
 export { B as Badge } from './Badge-DtUI2AEk.js';
-export { B as Breadcrumbs } from './Breadcrumbs-DTi5RqT-.js';
+export { B as Breadcrumbs } from './Breadcrumbs-Bzxbdu-S.js';
 export { B as Button } from './Button-C_V2xQAs.js';
 export { B as ButtonCompound } from './ButtonCompound-BQb2gfAl.js';
 export { B as ButtonLink } from './ButtonLink-UhLks0vM.js';
 export { B as ButtonToggle } from './ButtonToggle-jnDMPSyK.js';
-export { a as Calendar, g as CalendarMonth, f as CalendarMonthButton, e as CalendarNext, b as CalendarNow, d as CalendarPrev, c as CalendarYearButton } from './Calendar-ddGQKSGU.js';
+export { a as Calendar, g as CalendarMonth, f as CalendarMonthButton, e as CalendarNext, b as CalendarNow, d as CalendarPrev, c as CalendarYearButton } from './Calendar-BYNFAWpZ.js';
 export { C as Card } from './Card-fBqg853U.js';
-export { C as Checkbox } from './Checkbox-CVidv1sO.js';
-export { C as Chip } from './Chip-0-Yx9SGX.js';
-export { C as Combobox, a as ComboboxElement, c as ComboboxList, b as ComboboxSelect } from './Combobox-C9-3tlcP.js';
+export { C as Checkbox } from './Checkbox-BeIzx_ZX.js';
+export { C as Chip } from './Chip-D2k5X_wX.js';
+export { C as Combobox, a as ComboboxElement, c as ComboboxList, b as ComboboxSelect } from './Combobox-Cp7M4-4r.js';
 export { u as useInfiniteCombobox } from './useInfiniteCombobox-WcRgC9p6.js';
-export { D as DateFieldRange } from './DateFieldRange-CO2C776E.js';
-export { D as DateFieldSingle } from './DateFieldSingle-DjmHpn1y.js';
-export { D as DateFieldYearless } from './DateFieldYearless-CCJAopYd.js';
-export { D as DateFieldYearlessRange } from './DateFieldYearlessRange-BUv1mGJg.js';
-export { D as DaysOfTheWeek } from './DaysOfTheWeek-BihTU2No.js';
+export { D as DateFieldRange } from './DateFieldRange-Be_I9GTp.js';
+export { D as DateFieldSingle } from './DateFieldSingle-CsrsY9i8.js';
+export { D as DateFieldYearless } from './DateFieldYearless-m_Hl2gMY.js';
+export { D as DateFieldYearlessRange } from './DateFieldYearlessRange-DNqSTBDr.js';
+export { D as DaysOfTheWeek } from './DaysOfTheWeek-D58z_eF3.js';
 export { D as Details } from './Details-s2pVu-YL.js';
-export { D as Dialog } from './Dialog-BZTo4hbX.js';
+export { D as Dialog } from './Dialog-CD-SDfPT.js';
 export { D as Divider } from './Divider-CxtTyw8_.js';
 export { D as Dnd } from './index-CukEaIHB.js';
-export { D as Drawer } from './Drawer-Dg35inxH.js';
-export { D as DrillDown, b as DrillDownContent, c as DrillDownFooter, a as DrillDownHeader, d as DrillDownNextButton, e as DrillDownPrevButton, u as useDrillDown } from './useDrilldown-bIRsbg1m.js';
-export { E as EditCard } from './EditCard-BfNq-T8n.js';
-export { F as FieldLabel } from './FieldLabel-xV6EdVwo.js';
+export { D as Drawer } from './Drawer-s2y0xcgV.js';
+export { D as DrillDown, b as DrillDownContent, c as DrillDownFooter, a as DrillDownHeader, d as DrillDownNextButton, e as DrillDownPrevButton, u as useDrillDown } from './useDrilldown-KZ9rRsXQ.js';
+export { E as EditCard } from './EditCard-B25pj0Jx.js';
+export { F as FieldLabel } from './FieldLabel-D1qPAGtB.js';
 export { w as warnDeprecatedErrorUsage } from './utils-CM48ODEJ.js';
 export { F as FieldMessage } from './FieldMessage-mTGdycSA.js';
 export { F as Flex } from './Flex-_orhvoxS.js';
 export { G as Grid } from './Grid-BAN8WD_V.js';
 export { I as Icon } from './Icon-feeG7gXA.js';
-export { I as InputMask } from './InputMask-8rI6UIb8.js';
+export { I as InputMask } from './InputMask-BDl09V4u.js';
 export { L as Layout, b as LayoutElement, a as LayoutItem } from './Layout-C2Q2hyLG.js';
 export { L as Link, u as useLinkStyles } from './Link-D8A_WT94.js';
 export { L as LinkButton } from './LinkButton-DxYsWiXB.js';
 export { L as List } from './List-GPS-GqH7.js';
-export { L as Listbox } from './Listbox-DRznPBCr.js';
-export { L as ListView, a as ListViewOption, b as ListViewOptionCell } from './ListView-CIa981KJ.js';
+export { L as Listbox } from './Listbox-CvQHBFWb.js';
+export { L as ListView, a as ListViewOption, b as ListViewOptionCell } from './ListView-CcRRh1ap.js';
 export { M as Menu } from './Menu-W0c-xKdX.js';
-export { N as NumberField } from './NumberField-D7YYo4Rl.js';
+export { N as NumberField } from './NumberField-BymFZhIJ.js';
 export { Overflow, OverflowText } from './Overflow.js';
-export { P as Page } from './Page-cELP59Hm.js';
-export { P as Pagination } from './Pagination-DTN4FovY.js';
-export { P as Popover } from './Popover-B3Vw4lDW.js';
-export { P as ProgressBar } from './ProgressBar-kzCNhaCO.js';
-export { R as Radio } from './Radio-CSBetBV6.js';
-export { S as SearchField } from './SearchField-Dl7sh_M4.js';
+export { P as Page } from './Page-SBy27-Wv.js';
+export { P as Pagination } from './Pagination-Cm8-K6VH.js';
+export { P as Popover } from './Popover-8mTJoMy7.js';
+export { P as ProgressBar } from './ProgressBar-C1CkQHV5.js';
+export { R as Radio } from './Radio-BcHMk8dD.js';
+export { S as SearchField } from './SearchField-3tUPU8hH.js';
 export { S as SegmentedControl, a as SegmentedControlSegment } from './SegmentedControl-PwLdTdrd.js';
-export { S as SelectCard } from './SelectCard-CLCLIBoq.js';
-export { S as SelectTrigger } from './SelectTrigger-RiRjgwXd.js';
+export { S as SelectCard } from './SelectCard-BN-LI14f.js';
+export { S as SelectTrigger } from './SelectTrigger-DTz7V-Xx.js';
 export { S as SideNav } from './SideNav-JzIIZSK_.js';
 export { Skeleton, SkeletonCircle, SkeletonPill, SkeletonRectangle, SkeletonText } from './Skeleton.js';
 export { S as Spinner } from './Spinner-B7tTWcP6.js';
 export { S as SrOnly } from './SrOnly-pnf8ajnh.js';
 export { S as Stepper } from './Stepper-lYywxPU5.js';
-export { S as Switch } from './Switch-p4yVJTNy.js';
+export { S as Switch } from './Switch-onmiKoRd.js';
 export { T as Tab } from './Tab-CIY6BO2e.js';
-export { T as Text } from './Text-BgPuOXJM.js';
-export { T as Textarea } from './Textarea-Dks15Zt3.js';
-export { T as TextField } from './TextField-DzuM8vvd.js';
-export { T as TimeField } from './TimeField-lN_5V6-X.js';
-export { T as Toaster } from './Toaster-2pAMQXRk.js';
-export { t as toast } from './Toaster-3GI_qJxj.js';
-export { T as Toolbar } from './Toolbar-BRQpvj9U.js';
-export { T as Tooltip } from './Tooltip-DGo3OWqL.js';
+export { T as Text } from './Text-BTzgTpqu.js';
+export { T as Textarea } from './Textarea-PXjppEQ6.js';
+export { T as TextField } from './TextField-WTYZJlX3.js';
+export { T as TimeField } from './TimeField-BJPXIv6W.js';
+export { T as Toaster } from './Toaster-DXLc86VD.js';
+export { t as toast } from './Toaster-CoChsMD0.js';
+export { T as Toolbar } from './Toolbar-Bt3kShho.js';
+export { T as Tooltip } from './Tooltip-yr1D06BE.js';
 export { u as useAccessibleColor } from './useAccessibleColor-BYKjkGRg.js';
 export { u as useBreakpoint } from './useBreakpoint-CeaUyHxh.js';
 export { u as useMergeRefs } from './useMergeRefs-Dfmtq9cI.js';
@@ -75,7 +75,7 @@ export { u as usePrefersColorScheme } from './usePrefersColorScheme-_hT7dK7_.js'
 export { u as usePrefersReducedMotion } from './usePrefersReducedMotion-DR9B_D6w.js';
 export { u as useSwipe } from './useSwipe-Cp-CJxLU.js';
 export { useTrackingId } from './useTrackingId.js';
-export { A as AnvilProvider, a as AnvilProviderContext } from './AnvilProvider-JXEbeQjR.js';
+export { A as AnvilProvider, a as AnvilProviderContext } from './AnvilProvider-J9DjoJiB.js';
 export { L as LocalizationProvider } from './LocalizationProvider-CO8fQGqs.js';
 export { L as LocalizationContext, u as useLocalizationContext } from './LocalizationContext-UsmB5mnR.js';
 export { P as PortalProvider, a as PortalProviderContext } from './PortalProvider-Cj_y3gbC.js';

package/dist/src/beta/components/FilterBar/FilterButton.d.ts

@@ -14,14 +14,17 @@ interface FilterButtonProps {
 /**
  * FilterButton component provides a popover interface for filter selection.
  * Handles both controlled and uncontrolled filter updates.
- * Built into FilterGroup for single-select, multi-select, date, and date range filter rendering.
+ * Built into FilterGroup for single-select, multi-select, date, date range,
+ * and date list filter rendering.
  *
  * Features:
  * - Maintains draft state for controlled filters
  * - Updates immediately for uncontrolled filters
- * - Provides Apply and Cancel actions in controlled mode
+ * - Provides Apply and Cancel actions in controlled mode (except dateList,
+ *   which always commits and closes on selection)
  * - Supports keyboard navigation and accessibility
- * - Renders custom, single-select, multi-select, date, and date range filter types
+ * - Renders custom, single-select, multi-select, date, date range, and date
+ *   list filter types
  * - Integrates with FilterGroup context for state management
  * - Displays appropriate icons for date-based filters
  * - Shows formatted date values in button labels

package/dist/src/beta/components/FilterBar/FilterDateList.d.ts

@@ -0,0 +1,37 @@
+import { DateFieldSingleProps } from '../../../components/DateFieldSingle';
+import { DateListFilter, DateListLibraryOptionId, DateListOption } from './internal/types';
+interface DateListDialogProps {
+    /** Library option whose dialog is open; null when closed. */
+    libraryId: DateListLibraryOptionId | null;
+    /** Parent filter id; used to derive unique DOM ids for the synthetic date pickers inside the dialog. */
+    parentFilterId: string;
+    /** Pre-seed value when re-opening an already-selected library option. */
+    initialValue?: string | {
+        startDate: string;
+        endDate: string;
+    };
+    mode?: DateFieldSingleProps["mode"];
+    /** Primary CTA label. "Apply" in popover, "Save" in drawer. */
+    dialogCtaLabel: "Apply" | "Save";
+    onCommit: (option: DateListOption) => void;
+    onCancel: () => void;
+}
+/**
+ * Dialog shared by FilterDateList (popover) and FilterDrawer's dateList case.
+ * Renders a date or range picker for the chosen library option and commits
+ * up on Apply/Save.
+ */
+export declare const DateListDialog: ({ libraryId, parentFilterId, initialValue, mode, dialogCtaLabel, onCommit, onCancel, }: DateListDialogProps) => import("react/jsx-runtime").JSX.Element;
+interface FilterDateListProps {
+    filter: DateListFilter;
+    draftValue: DateListOption | undefined;
+    onDraftChange: (value: DateListOption | undefined) => void;
+    /** Primary CTA label for the library-option dialog. */
+    dialogCtaLabel: "Apply" | "Save";
+}
+/**
+ * FilterDateList renders the dateList filter's option list inside a popover.
+ * Consumer options commit immediately; library options open a Dialog.
+ */
+export declare const FilterDateList: ({ filter, draftValue, onDraftChange, dialogCtaLabel, }: FilterDateListProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/beta/components/FilterBar/index.d.ts

@@ -1,3 +1,3 @@
 export * from './FilterBar';
 export { FilterBar as default, type FilterBarProps } from './FilterBar';
-export { type Filter, type BooleanFilter, type CustomFilter, type SingleSelectFilter, type MultiSelectFilter, type DateFilter, type DateRangeFilter, type FilterValue, type FilterRenderProps, type BaseFilter, } from './internal/types';
+export { type Filter, type BooleanFilter, type CustomFilter, type SingleSelectFilter, type MultiSelectFilter, type DateFilter, type DateRangeFilter, type DateListFilter, type DateListOption, type DateListLibraryOptionId, type FilterValue, type FilterRenderProps, type BaseFilter, } from './internal/types';

package/dist/src/beta/components/FilterBar/internal/types.d.ts

@@ -121,10 +121,48 @@ export type DateFilter = BaseFilter & Pick<DateFieldSingleProps, "value" | "mode
 export type DateRangeFilter = BaseFilter & Pick<DateFieldRangeProps, "value" | "mode"> & {
     type: "dateRange";
 };
+/**
+ * Pre-defined library options the dateList filter always renders below the
+ * consumer's options. Each opens a Dialog with a date picker. Callers must
+ * not use these ids in their own `options`.
+ */
+export type DateListLibraryOptionId = "on" | "before" | "after" | "customRange";
+/**
+ * An option in a dateList filter. Consumer-supplied options commit their
+ * `value` immediately on click. Library options share this shape with one
+ * of the reserved `DateListLibraryOptionId` ids.
+ */
+export type DateListOption = {
+    /** Unique identifier for the option */
+    id: string;
+    /** Display label for the option */
+    label: string;
+    /**
+     * Concrete value the option resolves to: an ISO date string, a date range,
+     * or `null` to represent "no filter applied" (treated as inactive).
+     */
+    value: string | {
+        startDate: string;
+        endDate: string;
+    } | null;
+};
+/**
+ * Date list filter type. Renders the consumer's options followed by four
+ * library options (On…, Before…, After…, Custom Range…) that open a Dialog
+ * with the appropriate date picker.
+ */
+export type DateListFilter = BaseFilter & Pick<DateFieldSingleProps, "mode"> & {
+    /** Identifies this as a date list filter */
+    type: "dateList";
+    /** Consumer-supplied options. Library options are auto-rendered below. */
+    options: DateListOption[];
+    /** The currently selected option (consumer or library) */
+    selectedOption?: DateListOption;
+};
 /**
  * Union type of all available filter types
  * Uses unknown instead of any for better type safety
  */
-export type Filter = BooleanFilter | CustomFilter<any> | SingleSelectFilter<any> | MultiSelectFilter<any> | DateFilter | DateRangeFilter;
+export type Filter = BooleanFilter | CustomFilter<any> | SingleSelectFilter<any> | MultiSelectFilter<any> | DateFilter | DateRangeFilter | DateListFilter;
 /** Type representing all possible filter values */
-export type FilterValue = boolean | CustomFilter["value"] | SingleSelectFilter["selectedItem"] | MultiSelectFilter["selectedItems"] | DateFilter["value"] | DateRangeFilter["value"];
+export type FilterValue = boolean | CustomFilter["value"] | SingleSelectFilter["selectedItem"] | MultiSelectFilter["selectedItems"] | DateFilter["value"] | DateRangeFilter["value"] | DateListFilter["selectedOption"];

package/dist/src/beta/components/FilterBar/internal/utils/dateListLibraryOptions.d.ts

@@ -0,0 +1,29 @@
+import { DateListLibraryOptionId, DateListOption } from '../types';
+/** Type guard for the four reserved library option ids. */
+export declare const isDateListLibraryOptionId: (id: string) => id is DateListLibraryOptionId;
+/** Label for a given library option id. */
+export declare const getDateListLibraryOptionLabel: (id: DateListLibraryOptionId) => string;
+/**
+ * Library options the dateList filter always renders below the consumer's
+ * options. Used by FilterDateList (popover) and FilterDrawer (drawer). The
+ * "…" suffix signals that picking the option opens a dialog; once a date is
+ * committed, the bare label (without "…") is what gets stored and shown in
+ * the filter trigger.
+ */
+export declare const dateListLibraryOptions: ReadonlyArray<{
+    id: DateListLibraryOptionId;
+    label: string;
+}>;
+/** True when the library option opens a date-range dialog. */
+export declare const isDateListRangeLibraryId: (id: DateListLibraryOptionId) => boolean;
+/**
+ * Build the display label for a committed dateList selection. Used by both
+ * the FilterButton trigger and the FilterDrawer SelectField so the two
+ * surfaces stay in sync.
+ *
+ * - Selection with `value: null` (e.g. "Any day") → option label only.
+ * - Custom Range library option → just the formatted range (label omitted
+ *   since the range is self-explanatory).
+ * - Other library or consumer options → `"<label>: <formatted>"`.
+ */
+export declare const formatDateListSelectionLabel: (selection: DateListOption) => string;

package/dist/src/beta/components/FilterBar/internal/utils/filter-state.d.ts

@@ -33,6 +33,8 @@ export declare const updateSingleFilter: (filters: Filter[], filterId: string, v
  * Determines if two filter values are different.
  * For arrays (multiSelect), compares by id set (order-insensitive, avoids JSON serialization).
  * For singleSelect, compares by id if both are objects with id.
+ * For dateList selections (objects with both id and value), compares id AND value
+ * so re-picking the same library option with a different date still counts as a change.
  *
  * @param {T} a - First value to compare
  * @param {T} b - Second value to compare

package/dist/src/beta/components/FilterBar/internal/utils/test.d.ts

@@ -1,4 +1,4 @@
-import { Filter, BooleanFilter, CustomFilter, SingleSelectFilter, MultiSelectFilter, DateFilter, DateRangeFilter } from '../types';
+import { Filter, BooleanFilter, CustomFilter, SingleSelectFilter, MultiSelectFilter, DateFilter, DateListFilter, DateRangeFilter } from '../types';
 export type TestValue = {
     id: number;
     label: string;
@@ -54,5 +54,6 @@ export declare function createMockMultiSelectFilter<T = {
 }>(overrides?: Partial<MultiSelectFilter<T>>): MultiSelectFilter<T>;
 export declare function createMockDateFilter(overrides?: Partial<DateFilter>): DateFilter;
 export declare function createMockDateRangeFilter(overrides?: Partial<DateRangeFilter>): DateRangeFilter;
+export declare function createMockDateListFilter(overrides?: Partial<DateListFilter>): DateListFilter;
 export declare const setupDesktopContainer: () => void;
 export declare const setupMobileContainer: () => void;

package/dist/src/beta/components/MultiSelectField/MultiSelectField.d.ts

@@ -16,5 +16,6 @@ import { MultiSelectFieldHandle, MultiSelectFieldProps } from './types';
  * - Chip count limiting (maxChips prop)
  * - Full accessibility support with ARIA attributes
  * - Controlled selection state
+ * - Optional "Add new item" affordance below the option list with consumer-owned dialog
  */
 export declare const MultiSelectField: import('react').ForwardRefExoticComponent<MultiSelectFieldProps & import('react').RefAttributes<MultiSelectFieldHandle>>;

package/dist/src/beta/components/MultiSelectField/internal/MultiSelectFieldComboboxMode.d.ts

@@ -2,4 +2,4 @@ import { MultiSelectFieldComboboxInternalProps } from './types';
 /**
  * Combobox mode: searchable multi-select using useCombobox.
  */
-export declare const MultiSelectFieldComboboxMode: ({ labelAiMark, id, helperUid, selectedOptions, onSelectedOptionsChange, displayAs, isDisabledOrReadOnly, disabled, readOnly, required, placeholder, size, error, hasHelperText, disableClearButton, prefix, suffix, label, hideLabel, hint, moreInfo, moreInfoId, errorMessages, warning, description, className, style, layoutStyles, pinned, groupToString, groupSorter, virtualize, options, loading, loadingMore, hasMore, loadOptions, loadMore, initialLoad, initialLoadPerformed, setInitialLoadPerformed, inputWrapperRef, debounceMs, selectAll, selectFiltered, singleRow, maxChips, getChipProps, onSearchChange, handleRemoveOption, handleClear, }: MultiSelectFieldComboboxInternalProps) => import("react/jsx-runtime").JSX.Element;
+export declare const MultiSelectFieldComboboxMode: ({ labelAiMark, id, helperUid, selectedOptions, onSelectedOptionsChange, displayAs, isDisabledOrReadOnly, disabled, readOnly, required, placeholder, size, error, hasHelperText, disableClearButton, prefix, suffix, label, hideLabel, hint, moreInfo, moreInfoId, errorMessages, warning, description, className, style, layoutStyles, pinned, groupToString, groupSorter, virtualize, options, loading, loadingMore, hasMore, loadOptions, loadMore, initialLoad, initialLoadPerformed, setInitialLoadPerformed, inputWrapperRef, debounceMs, selectAll, selectFiltered, singleRow, maxChips, getChipProps, onSearchChange, addItemLabel, onAddNewItem, handleRemoveOption, handleClear, }: MultiSelectFieldComboboxInternalProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/beta/components/MultiSelectField/internal/MultiSelectFieldSelectMode.d.ts

@@ -3,4 +3,4 @@ import { MultiSelectFieldBaseInternalProps } from './types';
  * Select mode: non-searchable multi-select using useSelect.
  * Active when disableSearch is true.
  */
-export declare const MultiSelectFieldSelectMode: ({ labelAiMark, id, helperUid, selectedOptions, onSelectedOptionsChange, displayAs, isDisabledOrReadOnly, disabled, readOnly, required, placeholder, size, error, hasHelperText, disableClearButton, prefix, suffix, label, hideLabel, hint, moreInfo, moreInfoId, errorMessages, warning, description, className, style, layoutStyles, pinned, groupToString, groupSorter, virtualize, options, loading, loadingMore, hasMore, loadOptions, loadMore, initialLoad, initialLoadPerformed, setInitialLoadPerformed, inputWrapperRef, selectAll, singleRow, maxChips, getChipProps, handleRemoveOption, handleClear, }: MultiSelectFieldBaseInternalProps) => import("react/jsx-runtime").JSX.Element;
+export declare const MultiSelectFieldSelectMode: ({ labelAiMark, id, helperUid, selectedOptions, onSelectedOptionsChange, displayAs, isDisabledOrReadOnly, disabled, readOnly, required, placeholder, size, error, hasHelperText, disableClearButton, prefix, suffix, label, hideLabel, hint, moreInfo, moreInfoId, errorMessages, warning, description, className, style, layoutStyles, pinned, groupToString, groupSorter, virtualize, options, loading, loadingMore, hasMore, loadOptions, loadMore, initialLoad, initialLoadPerformed, setInitialLoadPerformed, inputWrapperRef, selectAll, singleRow, maxChips, getChipProps, addItemLabel, onAddNewItem, handleRemoveOption, handleClear, }: MultiSelectFieldBaseInternalProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/beta/components/MultiSelectField/internal/types.d.ts

@@ -1,5 +1,6 @@
 import { ReactElement, ReactNode, RefObject } from 'react';
 import { AiMarkWithTooltipOrPopoverProps, CheckState } from '../../../../types';
+import { AddNewItemProps } from '../../../../internal/types/addNewItemTypes';
 import { MultiSelectFieldChipProps, MultiSelectFieldOption, MultiSelectFieldProps } from '../types';
 export type MultiSelectFieldBaseInternalProps = {
     id: string;
@@ -58,7 +59,7 @@ export type MultiSelectFieldBaseInternalProps = {
         id: string | number;
     }) => void;
     handleClear: () => void;
-};
+} & AddNewItemProps;
 export type MultiSelectFieldComboboxInternalProps = MultiSelectFieldBaseInternalProps & {
     debounceMs: number;
     selectFiltered?: (searchValue: string) => {

package/dist/src/beta/components/MultiSelectField/types.d.ts

@@ -2,6 +2,7 @@ import { AriaAttributes, CSSProperties, ReactElement, ReactNode } from 'react';
 import { AiMarkWithTooltipOrPopoverProps, CheckState, LayoutUtilProps, Size } from '../../../types';
 import { SelectFieldGroupByValue, SelectFieldOption } from '../SelectField/types';
 import { ChipProps } from '../../../components/Chip';
+import { AddNewItemProps } from '../../../internal/types/addNewItemTypes';
 /**
  * Partial chip props that can be returned from the `getChipProps` callback.
  * Supports `icon` or `avatar` (mutually exclusive) and all other chip props as optional overrides.
@@ -300,7 +301,7 @@ type MultiSelectFieldCommonProps = {
      * @returns Partial chip props to merge onto the chip
      */
     getChipProps?: (option: MultiSelectFieldOption) => MultiSelectFieldChipProps;
-} & MultiSelectFieldSearchProps & LayoutUtilProps;
+} & MultiSelectFieldSearchProps & LayoutUtilProps & AddNewItemProps;
 type MultiSelectFieldGroupingProps = {
     /**
      * Function to convert a group value to a display label.

package/dist/src/beta/components/MultiSelectMenu/MultiSelectMenu.d.ts

@@ -17,6 +17,7 @@ import { MultiSelectMenuHandle, MultiSelectMenuProps } from './types';
  * - Full accessibility support with ARIA attributes
  * - Controlled selection state
  * - Configurable popover width
+ * - Optional "Add new item" affordance below the option list with consumer-owned dialog
  *
  * @example
  * <MultiSelectMenu

package/dist/src/beta/components/MultiSelectMenu/types.d.ts

@@ -2,6 +2,7 @@ import { KeyboardEvent, ReactElement, RefObject } from 'react';
 import { CheckState } from '../../../types';
 import { SelectFieldGroupByValue, SelectFieldOption } from '../SelectField/types';
 import { MultiSelectFieldCacheOptions, MultiSelectFieldEagerLoader, MultiSelectFieldGroupLazyLoader, MultiSelectFieldOffsetLazyLoader, MultiSelectFieldPageLazyLoader, MultiSelectFieldPinnedOptions, MultiSelectFieldSearchProps } from '../MultiSelectField/types';
+import { AddNewItemProps } from '../../../internal/types/addNewItemTypes';
 export type MultiSelectMenuOption = SelectFieldOption;
 export type MultiSelectMenuGroupByValue = SelectFieldGroupByValue;
 /**
@@ -142,7 +143,7 @@ type MultiSelectMenuCommonProps = {
      * @default 320
      */
     popoverWidth?: "reference" | number | string;
-} & MultiSelectMenuSearchProps;
+} & MultiSelectMenuSearchProps & AddNewItemProps;
 type MultiSelectMenuGroupingProps = {
     /**
      * Function to convert a group value to a display label.

package/dist/src/beta/components/SelectField/SelectField.d.ts

@@ -1,2 +1,23 @@
 import { SelectFieldHandle, SelectFieldProps } from './types';
+/**
+ * SelectField component for selecting a single option from a searchable dropdown.
+ *
+ * Features:
+ * - Async option loading with caching, lazy pagination (page, offset, group), and debounced search
+ * - Supports pinned option sections (static or dynamically loaded)
+ * - Grouped options with custom sort and label functions
+ * - Combobox mode (searchable) and select mode (non-searchable) via disableSearch
+ * - Dialog and popover display modes with auto-detection based on viewport
+ * - Imperative handle for cache management (clearCache, invalidate)
+ * - Optional "Add new item" affordance below the option list with consumer-owned dialog
+ * - Supports layout utilities for positioning and spacing
+ *
+ * @example
+ * <SelectField
+ *   label="Technician"
+ *   value={selected}
+ *   onSelectedOptionChange={setSelected}
+ *   loadOptions={async (search) => fetchTechnicians(search)}
+ * />
+ */
 export declare const SelectField: import('react').ForwardRefExoticComponent<SelectFieldProps & import('react').RefAttributes<SelectFieldHandle>>;

package/dist/src/beta/components/SelectField/internal/SelectFieldComboboxMode.d.ts

@@ -3,4 +3,4 @@ import { SelectFieldComboboxInternalProps } from '../../../../internal/types/sel
  * Combobox mode: searchable select using useCombobox.
  * This is the default behavior when disableSearch is false.
  */
-export declare const SelectFieldComboboxMode: ({ id, helperUid, selectedOption, onSelectedOptionChange, displayAs, isDisabledOrReadOnly, disabled, labelAiMark, readOnly, required, placeholder, size, error, hasHelperText, disableClearButton, prefix, suffix, label, hideLabel, hint, moreInfo, moreInfoId, errorMessages, warning, description, className, style, layoutStyles, pinned, groupToString, groupSorter, virtualize, options, loading, loadingMore, hasMore, loadOptions, loadMore, initialLoad, initialLoadPerformed, setInitialLoadPerformed, inputWrapperRef, debounceMs, }: SelectFieldComboboxInternalProps) => import("react/jsx-runtime").JSX.Element;
+export declare const SelectFieldComboboxMode: ({ id, helperUid, selectedOption, onSelectedOptionChange, displayAs, isDisabledOrReadOnly, disabled, labelAiMark, readOnly, required, placeholder, size, error, hasHelperText, disableClearButton, prefix, suffix, label, hideLabel, hint, moreInfo, moreInfoId, errorMessages, warning, description, className, style, layoutStyles, pinned, groupToString, groupSorter, virtualize, options, loading, loadingMore, hasMore, loadOptions, loadMore, initialLoad, initialLoadPerformed, setInitialLoadPerformed, inputWrapperRef, debounceMs, addItemLabel, onAddNewItem, }: SelectFieldComboboxInternalProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/beta/components/SelectField/internal/SelectFieldSelectMode.d.ts

@@ -3,4 +3,4 @@ import { SelectFieldBaseInternalProps } from '../../../../internal/types/selectF
  * Select mode: non-searchable select using useSelect.
  * Active when disableSearch is true.
  */
-export declare const SelectFieldSelectMode: ({ labelAiMark, id, helperUid, selectedOption, onSelectedOptionChange, displayAs, isDisabledOrReadOnly, disabled, readOnly, placeholder, size, error, hasHelperText, disableClearButton, prefix, suffix, label, hideLabel, hint, moreInfo, moreInfoId, errorMessages, warning, description, className, style, layoutStyles, pinned, groupToString, groupSorter, virtualize, options, loading, loadingMore, hasMore, loadOptions, loadMore, initialLoad, initialLoadPerformed, setInitialLoadPerformed, inputWrapperRef, required, }: SelectFieldBaseInternalProps) => import("react/jsx-runtime").JSX.Element;
+export declare const SelectFieldSelectMode: ({ labelAiMark, id, helperUid, selectedOption, onSelectedOptionChange, displayAs, isDisabledOrReadOnly, disabled, readOnly, placeholder, size, error, hasHelperText, disableClearButton, prefix, suffix, label, hideLabel, hint, moreInfo, moreInfoId, errorMessages, warning, description, className, style, layoutStyles, pinned, groupToString, groupSorter, virtualize, options, loading, loadingMore, hasMore, loadOptions, loadMore, initialLoad, initialLoadPerformed, setInitialLoadPerformed, inputWrapperRef, required, addItemLabel, onAddNewItem, }: SelectFieldBaseInternalProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/beta/components/SelectField/types.d.ts

@@ -1,6 +1,7 @@
 import { AriaAttributes, CSSProperties, ReactElement, ReactNode } from 'react';
 import { AiMarkWithTooltipOrPopoverProps, LayoutUtilProps, Size } from '../../../types';
 import { AvatarProps, ChipProps, IconProps } from '../../..';
+import { AddNewItemProps } from '../../../internal/types/addNewItemTypes';
 /**
  * Configuration options for the SelectField cache.
  * @property enabled - Whether caching is enabled. Defaults to true.
@@ -250,7 +251,7 @@ type SelectFieldCommonSelectFieldProps = {
      * @default false
      */
     disableSearch?: boolean;
-} & SelectFieldSearchProps & SelectFieldAddNewOptionProps & LayoutUtilProps;
+} & SelectFieldSearchProps & SelectFieldAddNewOptionProps & LayoutUtilProps & AddNewItemProps;
 type SelectFieldGroupingProps = {
     /**
      * Function to convert a group value to a display label.

package/dist/src/beta/components/SelectMenu/SelectMenu.d.ts

@@ -14,6 +14,7 @@ import { SelectMenuHandle, SelectMenuProps } from './types';
  * - Full accessibility support with ARIA attributes
  * - Controlled selection state
  * - Configurable popover width
+ * - Optional "Add new item" affordance below the option list with consumer-owned dialog
  *
  * @example
  * <SelectMenu

package/dist/src/beta/components/SelectMenu/types.d.ts

@@ -1,5 +1,6 @@
 import { KeyboardEvent, ReactElement, RefObject } from 'react';
 import { SelectFieldCacheOptions, SelectFieldEagerLoader, SelectFieldGroupByValue, SelectFieldGroupLazyLoader, SelectFieldGroupedOption, SelectFieldOffsetLazyLoader, SelectFieldOption, SelectFieldPageLazyLoader, SelectFieldPinnedOptions, SelectFieldSearchProps } from '../SelectField/types';
+import { AddNewItemProps } from '../../../internal/types/addNewItemTypes';
 export type SelectMenuOption = SelectFieldOption;
 export type SelectMenuGroupByValue = SelectFieldGroupByValue;
 export type SelectMenuGroupedOption = SelectFieldGroupedOption;
@@ -124,7 +125,7 @@ type SelectMenuCommonProps = {
      * @default 320
      */
     popoverWidth?: "reference" | number | string;
-} & SelectMenuSearchProps;
+} & SelectMenuSearchProps & AddNewItemProps;
 type SelectMenuGroupingProps = {
     /**
      * Function to convert a group value to a display label.

package/dist/src/internal/components/AddNewItemButton.d.ts

@@ -0,0 +1,40 @@
+import { AddNewItemProps } from '../types/addNewItemTypes';
+/**
+ * Props for the AddNewItemButton component.
+ *
+ * @property {string} searchText - The current search text, forwarded to the consumer's handler and label callback.
+ * @property {() => void} [onCloseMenu] - Internal hook for the host menu to close itself when the button is clicked. Fires before the consumer's handler.
+ * @extends AddNewItemProps
+ */
+export type AddNewItemButtonProps = AddNewItemProps & {
+    /** The current search text, forwarded to the consumer's handler and label callback. */
+    searchText: string;
+    /** Internal hook for the host menu to close itself when the button is clicked. */
+    onCloseMenu?: () => void;
+};
+/**
+ * AddNewItemButton renders the consumer's "Add new item" affordance for the
+ * Select* / MultiSelect* components. Positioning, padding, background tint,
+ * and the visual separator from the option list are owned by the surrounding
+ * popover/dialog footer slot — this component is only responsible for the
+ * button itself.
+ *
+ * Features:
+ * - Renders nothing when no `onAddNewItem` handler is provided
+ * - Static or dynamic label resolved against the current search text
+ * - Closes the host menu via `onCloseMenu` when clicked, before invoking the consumer's handler
+ *
+ * @example
+ * <AddNewItemButton
+ *   searchText={searchText}
+ *   addItemLabel={(s) => `Add "${s}"`}
+ *   onAddNewItem={(text) => openAddDialog(text)}
+ *   onCloseMenu={closeMenu}
+ * />
+ *
+ * @returns The button, or null when the feature is not enabled.
+ */
+export declare const AddNewItemButton: {
+    ({ searchText, addItemLabel, onAddNewItem, onCloseMenu, }: AddNewItemButtonProps): import("react/jsx-runtime").JSX.Element | null;
+    displayName: string;
+};

package/dist/src/internal/components/OptionsDialog/OptionsDialog.d.ts

@@ -1,5 +1,5 @@
 import { FocusableElement } from '../../..';
-export declare const OptionsDialog: ({ id, isOpen, onClose, field, children, title, initialFocusResolver, }: {
+export declare const OptionsDialog: ({ id, isOpen, onClose, field, children, title, initialFocusResolver, footer, }: {
     id: string;
     isOpen: boolean;
     onClose: () => void;
@@ -7,4 +7,6 @@ export declare const OptionsDialog: ({ id, isOpen, onClose, field, children, tit
     field?: React.ReactNode;
     children: React.ReactNode;
     initialFocusResolver?: (focusables: FocusableElement[]) => FocusableElement;
+    /** Optional content rendered below the dialog body. */
+    footer?: React.ReactNode;
 }) => import("react/jsx-runtime").JSX.Element;

package/dist/src/internal/components/OptionsPopover/OptionsPopover.d.ts

@@ -4,7 +4,13 @@ export type OptionsPopoverProps = {
     children: ReactNode;
     referenceElement: RefObject<HTMLElement>;
     open: boolean;
-    onClickOutside: () => void;
+    /**
+     * Fired when the popover should close — either because the user clicked
+     * outside it, focus moved to an element outside the popover or its
+     * reference (trigger) element, or the user pressed Escape inside the
+     * popover.
+     */
+    onClose: () => void;
     /** Controls the popover width strategy.
      * - `"reference"` — match the reference element's width
      * - `number` — fixed width in px
@@ -12,5 +18,11 @@ export type OptionsPopoverProps = {
      * - `undefined` (default) — intrinsic sizing (`max-content`)
      */
     width?: "reference" | number | string;
+    /**
+     * Optional content rendered as a full-bleed footer region inside the popover
+     * shell, separated from the body by a top border. The popover suppresses its
+     * own bottom padding so the footer can hug the popover's lower edge.
+     */
+    footer?: ReactNode;
 };
 export declare const OptionsPopover: (props: OptionsPopoverProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/internal/types/addNewItemTypes.d.ts

@@ -0,0 +1,12 @@
+import { ReactNode } from 'react';
+/**
+ * Shared prop set for the "Add new item" affordance available on
+ * SelectField, SelectMenu, MultiSelectField, and MultiSelectMenu.
+ *
+ * @property addItemLabel - Label rendered inside the "Add new item" button. May be a static node or a callback that receives the current search text and returns a dynamic label (e.g. `Add "${searchText}"`). When omitted but `onAddNewItem` is provided, falls back to `"Add new item"`.
+ * @property onAddNewItem - Click handler for the "Add new item" button. Presence of this prop is what gates rendering the button. Receives the current search text. The menu auto-closes synchronously on click; the handler runs immediately after — typically opening a Dialog or Drawer to collect the new item's details. Consumers manage their own overlay presentation, focus return, option list updates, and selection state.
+ */
+export type AddNewItemProps = {
+    addItemLabel?: ReactNode | ((searchText: string) => ReactNode);
+    onAddNewItem?: (searchText: string) => void;
+};

package/dist/src/internal/types/selectFieldInternalTypes.d.ts

@@ -1,6 +1,7 @@
 import { ReactElement, ReactNode, RefObject } from 'react';
 import { AiMarkWithTooltipOrPopoverProps, CheckState } from '../../types';
 import { SelectFieldOption, SelectFieldProps } from '../../beta/components/SelectField/types';
+import { AddNewItemProps } from './addNewItemTypes';
 /**
  * Metadata about list sections for rendering purposes.
  * Used by SelectOptions, MultiSelectOptions, and their Menu counterparts to render section headers and dividers.
@@ -62,7 +63,7 @@ export type SelectFieldBaseInternalProps = {
     initialLoadPerformed: boolean;
     setInitialLoadPerformed: (val: boolean) => void;
     inputWrapperRef: RefObject<HTMLDivElement>;
-};
+} & AddNewItemProps;
 export type SelectFieldComboboxInternalProps = SelectFieldBaseInternalProps & {
     debounceMs: number;
 };

package/dist/{stripInlineMarkdown-D_eHogvh.js → stripInlineMarkdown-C5DNxxwf.js}

@@ -1,4 +1,4 @@
-import { I as INLINE_MARKDOWN_REGEX } from './FieldLabel-xV6EdVwo.js';
+import { I as INLINE_MARKDOWN_REGEX } from './FieldLabel-D1qPAGtB.js';
 
 const stripInlineMarkdown = (str) => {
   const parts = [];
@@ -22,4 +22,4 @@ const stripInlineMarkdown = (str) => {
 };
 
 export { stripInlineMarkdown as s };
-//# sourceMappingURL=stripInlineMarkdown-D_eHogvh.js.map
+//# sourceMappingURL=stripInlineMarkdown-C5DNxxwf.js.map

package/dist/{stripInlineMarkdown-D_eHogvh.js.map → stripInlineMarkdown-C5DNxxwf.js.map}

@@ -1 +1 @@
-{"version":3,"file":"stripInlineMarkdown-D_eHogvh.js","sources":["../src/internal/functions/stripInlineMarkdown.ts"],"sourcesContent":["import { INLINE_MARKDOWN_REGEX } from \"../utils/inlineMarkdownRegex\";\n\n/**\n * Strips inline markdown syntax from a string, returning plain text.\n * Intended for accessibility contexts (e.g. `aria-label`) where only plain text is appropriate.\n *\n * @param str - The string to strip\n * @returns The string with all inline markdown syntax removed\n */\nexport const stripInlineMarkdown = (str: string): string => {\n  const parts: string[] = [];\n  let lastIndex = 0;\n\n  INLINE_MARKDOWN_REGEX.lastIndex = 0;\n  let match: RegExpExecArray | null;\n\n  while ((match = INLINE_MARKDOWN_REGEX.exec(str)) !== null) {\n    if (match.index > lastIndex) {\n      parts.push(str.substring(lastIndex, match.index));\n    }\n\n    const savedIndex = INLINE_MARKDOWN_REGEX.lastIndex;\n    const inner =\n      match[1] ?? match[2] ?? match[3] ?? match[4] ?? match[5] ?? \"\";\n\n    // code spans don't support nested markdown, matching parseInlineMarkdown behavior\n    parts.push(match[5] ? inner : stripInlineMarkdown(inner));\n\n    INLINE_MARKDOWN_REGEX.lastIndex = savedIndex;\n    lastIndex = savedIndex;\n  }\n\n  if (lastIndex < str.length) {\n    parts.push(str.substring(lastIndex));\n  }\n\n  return parts.join(\"\");\n};\n"],"names":[],"mappings":";;AASO,MAAM,mBAAA,GAAsB,CAAC,GAAA,KAAwB;AAC1D,EAAA,MAAM,QAAkB,EAAC;AACzB,EAAA,IAAI,SAAA,GAAY,CAAA;AAEhB,EAAA,qBAAA,CAAsB,SAAA,GAAY,CAAA;AAClC,EAAA,IAAI,KAAA;AAEJ,EAAA,OAAA,CAAQ,KAAA,GAAQ,qBAAA,CAAsB,IAAA,CAAK,GAAG,OAAO,IAAA,EAAM;AACzD,IAAA,IAAI,KAAA,CAAM,QAAQ,SAAA,EAAW;AAC3B,MAAA,KAAA,CAAM,KAAK,GAAA,CAAI,SAAA,CAAU,SAAA,EAAW,KAAA,CAAM,KAAK,CAAC,CAAA;AAAA,IAClD;AAEA,IAAA,MAAM,aAAa,qBAAA,CAAsB,SAAA;AACzC,IAAA,MAAM,KAAA,GACJ,KAAA,CAAM,CAAC,CAAA,IAAK,MAAM,CAAC,CAAA,IAAK,KAAA,CAAM,CAAC,KAAK,KAAA,CAAM,CAAC,CAAA,IAAK,KAAA,CAAM,CAAC,CAAA,IAAK,EAAA;AAG9D,IAAA,KAAA,CAAM,KAAK,KAAA,CAAM,CAAC,IAAI,KAAA,GAAQ,mBAAA,CAAoB,KAAK,CAAC,CAAA;AAExD,IAAA,qBAAA,CAAsB,SAAA,GAAY,UAAA;AAClC,IAAA,SAAA,GAAY,UAAA;AAAA,EACd;AAEA,EAAA,IAAI,SAAA,GAAY,IAAI,MAAA,EAAQ;AAC1B,IAAA,KAAA,CAAM,IAAA,CAAK,GAAA,CAAI,SAAA,CAAU,SAAS,CAAC,CAAA;AAAA,EACrC;AAEA,EAAA,OAAO,KAAA,CAAM,KAAK,EAAE,CAAA;AACtB;;;;"}
+{"version":3,"file":"stripInlineMarkdown-C5DNxxwf.js","sources":["../src/internal/functions/stripInlineMarkdown.ts"],"sourcesContent":["import { INLINE_MARKDOWN_REGEX } from \"../utils/inlineMarkdownRegex\";\n\n/**\n * Strips inline markdown syntax from a string, returning plain text.\n * Intended for accessibility contexts (e.g. `aria-label`) where only plain text is appropriate.\n *\n * @param str - The string to strip\n * @returns The string with all inline markdown syntax removed\n */\nexport const stripInlineMarkdown = (str: string): string => {\n  const parts: string[] = [];\n  let lastIndex = 0;\n\n  INLINE_MARKDOWN_REGEX.lastIndex = 0;\n  let match: RegExpExecArray | null;\n\n  while ((match = INLINE_MARKDOWN_REGEX.exec(str)) !== null) {\n    if (match.index > lastIndex) {\n      parts.push(str.substring(lastIndex, match.index));\n    }\n\n    const savedIndex = INLINE_MARKDOWN_REGEX.lastIndex;\n    const inner =\n      match[1] ?? match[2] ?? match[3] ?? match[4] ?? match[5] ?? \"\";\n\n    // code spans don't support nested markdown, matching parseInlineMarkdown behavior\n    parts.push(match[5] ? inner : stripInlineMarkdown(inner));\n\n    INLINE_MARKDOWN_REGEX.lastIndex = savedIndex;\n    lastIndex = savedIndex;\n  }\n\n  if (lastIndex < str.length) {\n    parts.push(str.substring(lastIndex));\n  }\n\n  return parts.join(\"\");\n};\n"],"names":[],"mappings":";;AASO,MAAM,mBAAA,GAAsB,CAAC,GAAA,KAAwB;AAC1D,EAAA,MAAM,QAAkB,EAAC;AACzB,EAAA,IAAI,SAAA,GAAY,CAAA;AAEhB,EAAA,qBAAA,CAAsB,SAAA,GAAY,CAAA;AAClC,EAAA,IAAI,KAAA;AAEJ,EAAA,OAAA,CAAQ,KAAA,GAAQ,qBAAA,CAAsB,IAAA,CAAK,GAAG,OAAO,IAAA,EAAM;AACzD,IAAA,IAAI,KAAA,CAAM,QAAQ,SAAA,EAAW;AAC3B,MAAA,KAAA,CAAM,KAAK,GAAA,CAAI,SAAA,CAAU,SAAA,EAAW,KAAA,CAAM,KAAK,CAAC,CAAA;AAAA,IAClD;AAEA,IAAA,MAAM,aAAa,qBAAA,CAAsB,SAAA;AACzC,IAAA,MAAM,KAAA,GACJ,KAAA,CAAM,CAAC,CAAA,IAAK,MAAM,CAAC,CAAA,IAAK,KAAA,CAAM,CAAC,KAAK,KAAA,CAAM,CAAC,CAAA,IAAK,KAAA,CAAM,CAAC,CAAA,IAAK,EAAA;AAG9D,IAAA,KAAA,CAAM,KAAK,KAAA,CAAM,CAAC,IAAI,KAAA,GAAQ,mBAAA,CAAoB,KAAK,CAAC,CAAA;AAExD,IAAA,qBAAA,CAAsB,SAAA,GAAY,UAAA;AAClC,IAAA,SAAA,GAAY,UAAA;AAAA,EACd;AAEA,EAAA,IAAI,SAAA,GAAY,IAAI,MAAA,EAAQ;AAC1B,IAAA,KAAA,CAAM,IAAA,CAAK,GAAA,CAAI,SAAA,CAAU,SAAS,CAAC,CAAA;AAAA,EACrC;AAEA,EAAA,OAAO,KAAA,CAAM,KAAK,EAAE,CAAA;AACtB;;;;"}