@servicetitan/anvil2 3.0.5 → 3.0.7

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

@@ -1,69 +1,33 @@
 import { Filter, FilterValue } from '../types';
+export { hasChangedFilter } from './value-compare';
 /**
  * Returns an array of filters that are currently active (i.e., have a value set).
- *
- * @param {Filter[]} filters - Array of filter objects to check
- * @returns {Filter[]} Array of active filters
  */
 export declare const getActiveFilters: (filters: Filter[]) => Filter[];
 /**
  * Checks if any filters in the array have active values
- *
- * @param {Filter[]} filters - Array of filter objects to check
- * @returns {boolean} True if any filter has an active value
  */
 export declare const checkActiveFilters: (filters: Filter[]) => boolean;
 /**
  * Resets all filters to their default state
- *
- * @param {Filter[]} filters - Array of filter objects to reset
- * @returns {Filter[]} New array with reset filters
  */
 export declare const resetFilters: (filters: Filter[]) => Filter[];
 /**
  * Updates a single filter in an array of filters
- *
- * @param {Filter[]} filters - Array of filter objects
- * @param {string} filterId - ID of the filter to update
- * @param {FilterValue} value - New value for the filter
- * @returns {Filter[]} New array with updated filter
  */
 export declare const updateSingleFilter: (filters: Filter[], filterId: string, value: FilterValue) => Filter[];
-/**
- * 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.
- *
- * @param {T} a - First value to compare
- * @param {T} b - Second value to compare
- * @returns {boolean} True if the values are different
- */
-export declare const hasChangedFilter: <T>(a: T, b: T) => boolean;
 /**
  * Checks if the selection value of a filter has changed by comparing references.
  * Uses reference equality (===) to detect if the parent has provided a new value.
- *
- * @param {Filter} existingFilter - The current filter state
- * @param {Filter} newFilter - The incoming filter from props
- * @returns {boolean} True if the selection value reference has changed
  */
 export declare const hasFilterSelectionChanged: (existingFilter: Filter, newFilter: Filter) => boolean;
 /**
  * Preserves the selection state from an existing filter into a new filter.
- * Used when filter configuration updates but the selection value reference hasn't changed,
- * allowing us to maintain user selections through configuration updates.
- *
- * @param {Filter} newFilter - The new filter configuration from props
- * @param {Filter} existingFilter - The existing filter with user's selections
- * @returns {Filter} New filter with configuration from newFilter and selection from existingFilter
+ * Used when filter configuration updates but the selection value reference hasn't changed.
  */
 export declare const preserveFilterState: (newFilter: Filter, existingFilter: Filter) => Filter;
 /**
  * Creates a deep clone of filters with updated item references.
  * Ensures that selected items reference the current items array for proper equality checks.
- * Used when initializing draft state to ensure selections use current item references.
- *
- * @param {Filter[]} filters - Array of filter objects to clone
- * @returns {Filter[]} New array with cloned filters and updated item references
  */
 export declare const cloneFiltersWithItemRefs: (filters: Filter[]) => Filter[];

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 { AsyncMultiSelectFilter, AsyncSelectFilter, Filter, BooleanFilter, CustomFilter, SingleSelectFilter, MultiSelectFilter, DateFilter, DateListFilter, DateRangeFilter, NumericRangeFilter } from '../types';
 export type TestValue = {
     id: number;
     label: string;
@@ -11,24 +11,12 @@ export declare const mockFilterOptions: {
 }[];
 export declare const defaultMockBooleanFilter: BooleanFilter;
 export declare const defaultMockCustomFilter: CustomFilter<TestValue>;
-export declare const defaultMockSingleSelectFilter: SingleSelectFilter<{
-    id: string;
-    label: string;
-}>;
-export declare const defaultMockMultiSelectFilter: MultiSelectFilter<{
-    id: string;
-    label: string;
-}>;
+export declare const defaultMockSingleSelectFilter: SingleSelectFilter;
+export declare const defaultMockMultiSelectFilter: MultiSelectFilter;
 export declare const defaultMockDateFilter: DateFilter;
 export declare const defaultMockDateRangeFilter: DateRangeFilter;
-export declare const defaultMockFilters: (BooleanFilter | DateFilter | DateRangeFilter | CustomFilter<TestValue> | SingleSelectFilter<{
-    id: string;
-    label: string;
-}> | MultiSelectFilter<{
-    id: string;
-    label: string;
-}>)[];
-export declare function createMockFilter<T = unknown>(overrides?: Partial<Filter | CustomFilter<T> | SingleSelectFilter<T>>): Filter | CustomFilter<T> | SingleSelectFilter<T>;
+export declare const defaultMockFilters: (BooleanFilter | SingleSelectFilter | MultiSelectFilter | DateFilter | DateRangeFilter | CustomFilter<TestValue>)[];
+export declare function createMockFilter<T = unknown>(overrides?: Partial<Filter | CustomFilter<T> | SingleSelectFilter>): Filter | CustomFilter<T> | SingleSelectFilter;
 export declare function createMockFilterContext(filters?: Filter[], contextOverrides?: {}): {
     filterGroupRef: {
         current: HTMLDivElement;
@@ -36,23 +24,21 @@ export declare function createMockFilterContext(filters?: Filter[], contextOverr
     filters: Filter[];
     updateFilter: import('vitest').Mock<(...args: any[]) => any>;
     onFilterChange: import('vitest').Mock<(...args: any[]) => any>;
-    hiddenFilters: never[];
-    addHiddenFilter: import('vitest').Mock<(...args: any[]) => any>;
-    removeHiddenFilter: import('vitest').Mock<(...args: any[]) => any>;
+    drawerOnlyFilters: never[];
     controlledFiltering: boolean;
     associatedContent: string;
+    showInlineFilters: boolean;
 };
 export declare function createMockBooleanFilter(overrides?: Partial<BooleanFilter>): BooleanFilter;
 export declare function createMockCustomFilter<T = unknown>(overrides?: Partial<CustomFilter<T>>): CustomFilter<T>;
-export declare function createMockSingleSelectFilter<T = {
-    id: string;
-    label: string;
-}>(overrides?: Partial<SingleSelectFilter<T>>): SingleSelectFilter<T>;
-export declare function createMockMultiSelectFilter<T = {
-    id: string;
-    label: string;
-}>(overrides?: Partial<MultiSelectFilter<T>>): MultiSelectFilter<T>;
+export declare function createMockSingleSelectFilter(overrides?: Partial<SingleSelectFilter>): SingleSelectFilter;
+export declare function createMockMultiSelectFilter(overrides?: Partial<MultiSelectFilter>): MultiSelectFilter;
 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 function createMockAsyncSelectFilter(overrides?: Partial<AsyncSelectFilter>): AsyncSelectFilter;
+export declare function createMockAsyncMultiSelectFilter(overrides?: Partial<AsyncMultiSelectFilter>): AsyncMultiSelectFilter;
+export declare function createMockNumericRangeFilter(overrides?: Partial<NumericRangeFilter>): NumericRangeFilter;
 export declare const setupDesktopContainer: () => void;
 export declare const setupMobileContainer: () => void;
+export declare const setupSmContainer: () => void;

package/dist/src/beta/components/FilterBar/internal/utils/value-compare.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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.
+ *
+ * Intentionally adapter-free — kept here (rather than in filter-state.ts) so that
+ * FilterPopoverButton can import it without pulling the adapter registry into
+ * the import graph. filter-state.ts depends on the adapter registry; the registry
+ * depends on FilterPopoverButton; FilterPopoverButton would otherwise depend on
+ * filter-state — closing a runtime-evaluated cycle.
+ */
+export declare const hasChangedFilter: <T>(a: T, b: T) => boolean;

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, addItemLabel, onAddNewItem, 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, bulkPending, onBulkActivate, 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, addItemLabel, onAddNewItem, 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, bulkPending, onBulkActivate, singleRow, maxChips, getChipProps, addItemLabel, onAddNewItem, handleRemoveOption, handleClear, }: MultiSelectFieldBaseInternalProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -49,9 +49,12 @@ export type MultiSelectFieldBaseInternalProps = {
     inputWrapperRef: RefObject<HTMLDivElement>;
     selectAll?: {
         label: string;
-        onClick: () => void;
         checkState: CheckState;
     };
+    /** True while a `compute`-driven bulk action's promise is in flight. */
+    bulkPending: boolean;
+    /** Called when the user activates the select-all or select-filtered row. */
+    onBulkActivate: (kind: "selectAll" | "selectFiltered", searchValue: string) => void;
     singleRow?: boolean;
     maxChips?: number;
     getChipProps?: (option: MultiSelectFieldOption) => MultiSelectFieldChipProps;
@@ -64,7 +67,6 @@ export type MultiSelectFieldComboboxInternalProps = MultiSelectFieldBaseInternal
     debounceMs: number;
     selectFiltered?: (searchValue: string) => {
         label?: string;
-        onClick: () => void;
         checkState: CheckState;
     };
     onSearchChange?: (searchValue: string) => void;

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

@@ -11,18 +11,20 @@ export type UseComboMultipleOptions = {
     groupToString?: (groupValue: MultiSelectFieldGroupByValue) => string;
     /** Function to sort group sections */
     groupSorter?: (a: MultiSelectFieldGroupByValue, b: MultiSelectFieldGroupByValue) => number;
-    /** Configuration for the "Select All" option (shown when search is empty) */
+    /** Configuration for the "Select All" option (shown when search is empty). */
     selectAll?: {
         label: string;
-        onClick: () => void;
         checkState: CheckState;
     };
-    /** Function that receives the search value and returns config for "Select Filtered" */
+    /** Function that receives the search value and returns config for "Select Filtered". */
     selectFiltered?: (searchValue: string) => {
         label?: string;
-        onClick: () => void;
         checkState: CheckState;
     };
+    /** True while a `compute`-driven bulk action is in flight. Disables option rows. */
+    bulkPending: boolean;
+    /** Called when the user activates the select-all or select-filtered row. */
+    onBulkActivate: (kind: "selectAll" | "selectFiltered", searchValue: string) => void;
     /** The currently selected options (controlled from outside) */
     selectedOptions: MultiSelectFieldOption[];
     onSelectedOptionsChange: (options: MultiSelectFieldOption[]) => void;
@@ -43,7 +45,7 @@ export type UseComboMultipleOptions = {
  * @param options - Configuration options for the hook
  * @returns Downshift combobox props and state
  */
-export declare const useComboMultiple: ({ options, pinned, groupToString, groupSorter, selectAll, selectFiltered, selectedOptions, onSelectedOptionsChange, onInputValueChange, onIsOpenChange, displayAs, disabled, loading, virtualize, onScrollToHighlight, }: UseComboMultipleOptions) => {
+export declare const useComboMultiple: ({ options, pinned, groupToString, groupSorter, selectAll, selectFiltered, bulkPending, onBulkActivate, selectedOptions, onSelectedOptionsChange, onInputValueChange, onIsOpenChange, displayAs, disabled, loading, virtualize, onScrollToHighlight, }: UseComboMultipleOptions) => {
     inputValue: string;
     wrapperDivRef: import('react').RefObject<HTMLDivElement>;
     getToggleButtonProps: <Options>(options?: import('downshift').UseComboboxGetToggleButtonPropsOptions & Options) => import('downshift').Overwrite<import('downshift').UseComboboxGetToggleButtonPropsReturnValue, Options>;

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

@@ -8,9 +8,12 @@ export type UseSelectModeMultipleOptions = {
     groupSorter?: (a: MultiSelectFieldGroupByValue, b: MultiSelectFieldGroupByValue) => number;
     selectAll?: {
         label: string;
-        onClick: () => void;
         checkState: CheckState;
     };
+    /** True while a `compute`-driven bulk action is in flight. Disables option rows. */
+    bulkPending: boolean;
+    /** Called when the user activates the select-all row. */
+    onBulkActivate: (kind: "selectAll" | "selectFiltered", searchValue: string) => void;
     selectedOptions: MultiSelectFieldOption[];
     onSelectedOptionsChange: (options: MultiSelectFieldOption[]) => void;
     onIsOpenChange?: (changes: {
@@ -25,7 +28,7 @@ export type UseSelectModeMultipleOptions = {
  * Wraps downshift's useSelect for non-searchable multi-select fields.
  * Keeps menu open after selection and handles bulk actions.
  */
-export declare const useSelectModeMultiple: ({ options, pinned, groupToString, groupSorter, selectAll, selectedOptions, onSelectedOptionsChange, onIsOpenChange, displayAs, disabled, virtualize, onScrollToHighlight, }: UseSelectModeMultipleOptions) => {
+export declare const useSelectModeMultiple: ({ options, pinned, groupToString, groupSorter, selectAll, bulkPending, onBulkActivate, selectedOptions, onSelectedOptionsChange, onIsOpenChange, displayAs, disabled, virtualize, onScrollToHighlight, }: UseSelectModeMultipleOptions) => {
     wrapperDivRef: import('react').RefObject<HTMLDivElement>;
     getToggleButtonProps: <Options>(options?: import('downshift').UseSelectGetToggleButtonPropsOptions & Options, otherOptions?: import('downshift').GetPropsCommonOptions) => import('downshift').Overwrite<import('downshift').UseSelectGetToggleButtonReturnValue, Options>;
     getLabelProps: <Options>(options?: import('downshift').UseSelectGetLabelPropsOptions & Options) => import('downshift').Overwrite<import('downshift').UseSelectGetLabelPropsReturnValue, Options>;

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

@@ -1,8 +1,9 @@
 import { AriaAttributes, CSSProperties, ReactElement, ReactNode } from 'react';
-import { AiMarkWithTooltipOrPopoverProps, CheckState, LayoutUtilProps, Size } from '../../../types';
-import { SelectFieldGroupByValue, SelectFieldOption } from '../SelectField/types';
+import { AiMarkWithTooltipOrPopoverProps, LayoutUtilProps, Size } from '../../../types';
+import { SelectFieldGroupByValue, SelectFieldOption, SelectFieldOptionContent } from '../SelectField/types';
 import { ChipProps } from '../../../components/Chip';
 import { AddNewItemProps } from '../../../internal/types/addNewItemTypes';
+import { BulkActionConfig } from '../../../internal/types/bulkActionTypes';
 /**
  * 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.
@@ -34,6 +35,11 @@ export type MultiSelectFieldHandle = {
     invalidate: () => void;
 };
 export type MultiSelectFieldGroupByValue = SelectFieldGroupByValue;
+/**
+ * Rich content configuration for a MultiSelectField option row.
+ * Controls the avatar, icon, description, and chip display within an option.
+ */
+export type MultiSelectFieldOptionContent = SelectFieldOptionContent;
 export type MultiSelectFieldOption = SelectFieldOption;
 export type MultiSelectFieldGroupedOption = MultiSelectFieldOption & {
     group: MultiSelectFieldGroupByValue;
@@ -210,27 +216,18 @@ type MultiSelectFieldCommonProps = {
      * Configuration for the "Select All" option at the top of the list.
      * When provided, a "Select All" option will be shown while the search input is empty.
      *
+     * Pass exactly one of `onClick` (fire-and-forget; the consumer commits via
+     * `onSelectedOptionsChange`) or `compute` (returns the next selection; the
+     * field commits the result for you, with sync or async support).
+     *
+     * While a `compute` promise is pending, the bulk row shows a loading state,
+     * all option rows are disabled, and stale resolutions are silently discarded.
+     *
      * Select All and Select Filtered are mutually exclusive:
      * - Select All is shown when the search input is empty.
      * - Select Filtered (if provided) is shown when a search term is active.
      */
-    selectAll?: {
-        /**
-         * The label to display for the "Select All" option.
-         * @default "Select All"
-         */
-        label?: string;
-        /**
-         * Callback when the "Select All" option is clicked.
-         * The parent component is responsible for handling the select/deselect all logic.
-         */
-        onClick: () => void;
-        /**
-         * Check state for the "Select All" option.
-         * @default false
-         */
-        checkState: boolean | CheckState;
-    };
+    selectAll?: BulkActionConfig;
     /**
      * Function that receives the current search value and returns configuration for
      * the "Select Filtered" option at the top of the list.
@@ -238,28 +235,16 @@ type MultiSelectFieldCommonProps = {
      * When provided and a search term is active, a "Select Filtered" option will be shown
      * instead of "Select All". This allows selecting all options matching the current filter.
      *
+     * See `selectAll` for the `onClick` / `compute` choice.
+     *
      * Select All and Select Filtered are mutually exclusive:
      * - Select All (if provided) is shown when the search input is empty.
      * - Select Filtered is shown when a search term is active.
      *
      * @param searchValue - The current search input value
-     * @returns Configuration object with label, onClick, and checkState
-     *
-     * @example
-     * selectFiltered={(searchValue) => ({
-     *   label: `Select items matching "${searchValue}"`,
-     *   onClick: () => handleSelectFiltered(searchValue),
-     *   checkState: allFilteredSelected ? "checked" : "unchecked",
-     * })}
-     */
-    selectFiltered?: (searchValue: string) => {
-        /** The label to display. @default `Select items matching "${searchValue}"` */
-        label?: string;
-        /** Callback when clicked. */
-        onClick: () => void;
-        /** Check state for the option. */
-        checkState: boolean | CheckState;
-    };
+     * @returns BulkActionConfig describing the row
+     */
+    selectFiltered?: (searchValue: string) => BulkActionConfig;
     /**
      * When true, restricts the field to a single row height.
      * Overflow chips will be collapsed into a "+N" indicator.

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

@@ -18,6 +18,7 @@ import { MultiSelectMenuHandle, MultiSelectMenuProps } from './types';
  * - Controlled selection state
  * - Configurable popover width
  * - Optional "Add new item" affordance below the option list with consumer-owned dialog
+ * - Optional confirmation mode that buffers selection until Apply is clicked
  *
  * @example
  * <MultiSelectMenu

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

@@ -1,8 +1,18 @@
 import { KeyboardEvent, ReactElement, RefObject } from 'react';
-import { CheckState } from '../../../types';
-import { SelectFieldGroupByValue, SelectFieldOption } from '../SelectField/types';
+import { SelectFieldGroupByValue, SelectFieldOption, SelectFieldOptionContent } from '../SelectField/types';
 import { MultiSelectFieldCacheOptions, MultiSelectFieldEagerLoader, MultiSelectFieldGroupLazyLoader, MultiSelectFieldOffsetLazyLoader, MultiSelectFieldPageLazyLoader, MultiSelectFieldPinnedOptions, MultiSelectFieldSearchProps } from '../MultiSelectField/types';
 import { AddNewItemProps } from '../../../internal/types/addNewItemTypes';
+import { ConfirmationProp } from '../../../internal/types/confirmationTypes';
+import { BulkActionConfig } from '../../../internal/types/bulkActionTypes';
+/**
+ * Configuration for the "Select All" / "Select Filtered" rows.
+ */
+export type MultiSelectMenuBulkActionConfig = BulkActionConfig;
+/**
+ * Rich content configuration for a MultiSelectMenu option row.
+ * Controls the avatar, icon, description, and chip display within an option.
+ */
+export type MultiSelectMenuOptionContent = SelectFieldOptionContent;
 export type MultiSelectMenuOption = SelectFieldOption;
 export type MultiSelectMenuGroupByValue = SelectFieldGroupByValue;
 /**
@@ -121,28 +131,58 @@ type MultiSelectMenuCommonProps = {
     /**
      * Configuration for the "Select All" option at the top of the list.
      * Shown when the search input is empty.
+     *
+     * Pass exactly one of `onClick` (fire-and-forget; the consumer commits via
+     * `onSelectedOptionsChange`) or `compute` (returns the next selection;
+     * integrates with confirmation drafts and supports async resolution).
+     *
+     * `compute` is required when you want the action to participate in the
+     * confirmation draft. While a `compute` promise is pending, the menu shows
+     * a loading state, disables all options, and disables Apply.
      */
-    selectAll?: {
-        label?: string;
-        onClick: () => void;
-        checkState: boolean | CheckState;
-    };
+    selectAll?: MultiSelectMenuBulkActionConfig;
     /**
      * Function that receives the current search value and returns configuration for
      * the "Select Filtered" option at the top of the list.
      * Shown when a search term is active (instead of Select All).
+     *
+     * See `selectAll` for the `onClick` / `compute` choice.
      */
-    selectFiltered?: (searchValue: string) => {
-        label?: string;
-        onClick: () => void;
-        checkState: boolean | CheckState;
-    };
+    selectFiltered?: (searchValue: string) => MultiSelectMenuBulkActionConfig;
     /**
      * Width of the popover. Only applies when `displayMenuAs="popover"` (or when the adaptive mode resolves to popover). Has no effect in dialog mode.
      * Accepts a CSS width value or "reference" to match the trigger element's width.
      * @default 320
      */
     popoverWidth?: "reference" | number | string;
+    /**
+     * When set, the menu becomes a buffered selection: clicks update a draft
+     * value inside the open menu, and `onSelectedOptionsChange` only fires when
+     * the user clicks Apply. Dismissing the menu (Escape, click outside,
+     * toggling the trigger) discards the draft. Pass `true` for the default
+     * "Apply" / "Cancel" labels, or an object to customize.
+     *
+     * Note: a `selectAll` / `selectFiltered` row configured with `onClick`
+     * bypasses the draft and applies immediately. Use the `compute` variant
+     * to integrate the bulk action with the draft.
+     * @default undefined (off — selections apply immediately)
+     */
+    confirmation?: ConfirmationProp;
+    /**
+     * Configures a "Clear" button in the menu footer. Presence of this prop
+     * enables the button; omit to suppress.
+     *
+     * - `onClick` — called when the user clicks Clear.
+     * - `label` — button label (default "Clear").
+     * - `disabled` — whether the button is inert. Filter adapters typically
+     *   tie this to `!isActive(filter)` so the button is dim when nothing is
+     *   selected.
+     */
+    clear?: {
+        onClick: () => void;
+        label?: string;
+        disabled?: boolean;
+    };
 } & MultiSelectMenuSearchProps & AddNewItemProps;
 type MultiSelectMenuGroupingProps = {
     /**

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

@@ -0,0 +1,40 @@
+import { SavedFiltersButtonProps } from './types';
+/**
+ * `SavedFiltersButton` is an opt-in companion to FilterBar that lets users
+ * apply, save, edit, and delete preset filter selections. It is fully
+ * stateless: the consumer owns the `savedFilters` array and writes its own
+ * persistence (server, localStorage, etc.) by reacting to the callbacks the
+ * component fires.
+ *
+ * Visually it's a single Button trigger that opens a popover listing the
+ * presets, with two footer actions:
+ *
+ * - **Save Current Filter** opens a drawer that snapshots `currentFilters`
+ *   into a new preset.
+ * - **Edit Saved Filters** opens a drawer listing every preset with edit
+ *   affordances; clicking edit on a row drills into a per-preset form
+ *   reusing the FilterBar adapter `renderDrawer` machinery.
+ *
+ * Apply, save, update, and delete are all delivered as consumer callbacks
+ * (`onApplySavedFilter`, `onSaveCurrentFilter`, `onUpdateSavedFilter`,
+ * `onDeleteSavedFilter`). Promise-returning callbacks are supported with
+ * loading state on the relevant submit button and success/error alerts on
+ * the parent drawer.
+ *
+ * @example
+ * <SavedFiltersButton
+ *   savedFilters={presets}
+ *   currentFilters={filters}
+ *   onApplySavedFilter={(preset) => setFilters(preset.filters)}
+ *   onSaveCurrentFilter={async ({ name, filters }) => {
+ *     await api.savePreset({ name, filters });
+ *     refetchPresets();
+ *   }}
+ *   onUpdateSavedFilter={async (id, update) => api.updatePreset(id, update)}
+ *   onDeleteSavedFilter={async (id) => api.deletePreset(id)}
+ * />
+ */
+export declare const SavedFiltersButton: {
+    (props: SavedFiltersButtonProps): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

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

@@ -0,0 +1,2 @@
+export { SavedFiltersButton } from './SavedFiltersButton';
+export type { SavedFilter, SavedFiltersAlertText, SavedFiltersButtonProps, } from './types';

package/dist/src/beta/components/SavedFiltersButton/internal/AddSavedFilterDrawer.d.ts

@@ -0,0 +1,27 @@
+import { Filter } from '../../FilterBar/internal/types';
+type AddSavedFilterDrawerProps = {
+    open: boolean;
+    onClose: () => void;
+    /** Snapshot of filters captured when the drawer opened. */
+    filtersSnapshot: Filter[];
+    onSave: (payload: {
+        name: string;
+        filters: Filter[];
+    }) => void | Promise<void>;
+    /**
+     * Consumer-supplied name validator. Returning a string blocks Add and is
+     * surfaced as the field's error message; `undefined` allows submit.
+     */
+    validateName?: (name: string) => string | undefined;
+};
+/**
+ * Drawer rendered when the user clicks "Save Current Filter" in the
+ * SavedFiltersButton popover. Captures a name and emits `onSave` with the
+ * filters snapshot. Supports async `onSave`; while pending the Add button
+ * shows a loading spinner and the form is disabled.
+ *
+ * If `onSave` rejects, the drawer stays open with the current input so the
+ * user can retry or cancel. On success the drawer closes.
+ */
+export declare const AddSavedFilterDrawer: ({ open, onClose, filtersSnapshot, onSave, validateName, }: AddSavedFilterDrawerProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/beta/components/SavedFiltersButton/internal/EditSavedFiltersDrawer.d.ts

@@ -0,0 +1,38 @@
+import { SavedFilter, SavedFiltersAlertText } from '../types';
+type EditSavedFiltersDrawerProps = {
+    open: boolean;
+    onClose: () => void;
+    savedFilters: SavedFilter[];
+    /** Drilldown's "Update Filter" action. May return a promise. */
+    onUpdate?: (id: string, update: {
+        name: string;
+        filters: SavedFilter["filters"];
+    }) => void | Promise<void>;
+    /** Drilldown's "Delete Filter" action. May return a promise. */
+    onDelete?: (id: string) => void | Promise<void>;
+    /**
+     * Optional drag-to-reorder callback. When provided, the list view renders
+     * each row as a `DndSort.Card` with a drag handle and emits the new
+     * `orderedIds` after a drop. When omitted, the list renders as a static
+     * stack with no handles.
+     */
+    onReorder?: (orderedIds: string[]) => void | Promise<void>;
+    /**
+     * Optional validator for the name field in the drilldown. The `currentId`
+     * is set to the preset being edited so the consumer can permit the row's
+     * own name in uniqueness checks.
+     */
+    validateName?: (name: string, currentId?: string) => string | undefined;
+    /** Optional override for the auto-managed alert text. */
+    alertText?: SavedFiltersAlertText;
+};
+/**
+ * Drawer that lets the user manage existing saved filters. Composed of two
+ * views — a list of presets (the Drawer host) and a per-preset edit screen
+ * (a `DrillDown` child) that reuses the FilterBar adapter `renderDrawer`
+ * machinery to render edit fields. Navigation between the two is driven by
+ * `useDrillDown`, which also wires the back-button affordance built into
+ * `DrillDown.Header`.
+ */
+export declare const EditSavedFiltersDrawer: ({ open, onClose, savedFilters, onUpdate, onDelete, onReorder, validateName, alertText, }: EditSavedFiltersDrawerProps) => import("react/jsx-runtime").JSX.Element;
+export {};