@servicetitan/anvil2 3.0.5 → 3.0.7

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

@@ -0,0 +1,147 @@
+import { ReactNode } from 'react';
+import { Filter } from '../FilterBar/internal/types';
+/**
+ * A consumer-owned preset of filter values. The component never mutates these
+ * — it only emits callbacks describing the user's intent (apply, save, update,
+ * delete). The consumer holds the source-of-truth list and re-renders
+ * `SavedFiltersButton` with the updated array.
+ *
+ * `filters` is a snapshot of the bar's full filter schema with the preset's
+ * values baked in, in the same shape as `FilterBar`'s `filters` prop. That
+ * uniformity lets the edit drilldown reuse the FilterBar adapter
+ * `renderDrawer` machinery without bespoke per-filter-type rendering.
+ */
+export type SavedFilter = {
+    id: string;
+    name: string;
+    filters: Filter[];
+    /**
+     * When true, this preset cannot be edited from the Edit drawer — its row
+     * renders without an Edit affordance and the drilldown is unreachable.
+     * Useful for marking system / seeded presets as immutable while still
+     * letting users edit their own.
+     */
+    disableEdit?: boolean;
+    /**
+     * When true, the "Delete Filter" button is omitted from the drilldown
+     * footer for this preset. Independent of `disableEdit` — a preset can be
+     * editable but not deletable, or vice versa.
+     */
+    disableDelete?: boolean;
+};
+/**
+ * Text overrides for the auto-managed success / error Alerts that appear on
+ * the "Edit Saved Filters" drawer after a save, update, delete, or reorder
+ * settles.
+ *
+ * All entries are optional; unset values fall back to generic defaults.
+ */
+export type SavedFiltersAlertText = {
+    saveSuccess?: string;
+    saveError?: string;
+    updateSuccess?: string;
+    updateError?: string;
+    deleteSuccess?: string;
+    deleteError?: string;
+    /**
+     * Surfaced on the list view when `onReorderSavedFilters` rejects. No
+     * matching `reorderSuccess` — successful reorders don't show an alert,
+     * because the new order is its own visible confirmation.
+     */
+    reorderError?: string;
+};
+export type SavedFiltersButtonProps = {
+    /** The presets to list. Consumer owns the storage. */
+    savedFilters: SavedFilter[];
+    /**
+     * The filters currently committed in the FilterBar (or any analogous
+     * filter source). Used as the snapshot payload when the user clicks
+     * "Save Current Filter."
+     */
+    currentFilters: Filter[];
+    /**
+     * Called when the user picks a preset from the list. The consumer is
+     * responsible for pushing `saved.filters` into their FilterBar (or
+     * equivalent) state. The popover closes immediately after click.
+     */
+    onApplySavedFilter: (saved: SavedFilter) => void;
+    /**
+     * Called when the user submits the "Save Current Filter" drawer. The
+     * payload `filters` is the snapshot of `currentFilters` at the moment the
+     * drawer opened. May return a promise; while pending, the Add button
+     * shows a loading state. Rejecting surfaces an error alert; resolving
+     * surfaces a success alert and closes the drawer.
+     */
+    onSaveCurrentFilter: (payload: {
+        name: string;
+        filters: Filter[];
+    }) => void | Promise<void>;
+    /**
+     * Called when the user submits the drilldown's "Update Filter" action.
+     * Same async / alert semantics as `onSaveCurrentFilter`.
+     */
+    onUpdateSavedFilter: (id: string, update: {
+        name: string;
+        filters: Filter[];
+    }) => void | Promise<void>;
+    /**
+     * Called when the user clicks "Delete Filter" in the drilldown. Same
+     * async / alert semantics as `onSaveCurrentFilter`.
+     */
+    onDeleteSavedFilter: (id: string) => void | Promise<void>;
+    /**
+     * Optional validation for the name field in the save / edit flows. Return
+     * an error string to block submit (Add / Update is disabled); return
+     * `undefined` when valid. The optional `currentId` is set during an edit
+     * flow 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;
+    /**
+     * Optional id of the preset that is currently applied. When set, the
+     * matching row in the popover renders with a check affordance. The
+     * component does no comparison itself — the consumer is responsible for
+     * tracking which preset (if any) reflects the current filter state, and
+     * for clearing the id when the filters drift (e.g. the user edited a
+     * filter directly).
+     *
+     * Defaults to `undefined`, in which case no row is marked active.
+     */
+    activeSavedFilterId?: string;
+    /**
+     * Optional trigger label override.
+     * @default "Saved Filters"
+     */
+    label?: string;
+    /**
+     * Optional override for the popover's empty-state content, shown when
+     * `savedFilters` is empty. Defaults to "No saved filters yet."
+     *
+     * - Pass a `string` to keep the default subdued/small `Text` styling — only
+     *   the wording changes.
+     * - Pass any other `ReactNode` (a CTA, an illustration, a styled block) to
+     *   take full control of the empty-state content.
+     *
+     * Separately, when `savedFilters` is empty the "Edit Saved Filters" footer
+     * button is disabled, so this empty-state is the only thing the user sees
+     * in the popover.
+     */
+    emptyState?: ReactNode;
+    /**
+     * Called when the user drags a preset to a new position in the "Edit Saved
+     * Filters" drawer. The payload is the full list of preset ids in their new
+     * order; the consumer is responsible for re-sorting their `savedFilters`
+     * array to match.
+     *
+     * Providing this callback opts the Edit drawer into drag-to-reorder UI —
+     * each row picks up a drag handle and keyboard-accessible drop affordance.
+     * Omitting it renders the list as a static stack with no handles.
+     *
+     * May return a promise. A rejection surfaces as a danger alert on the
+     * list view using `alertText.reorderError` (or the thrown Error's message
+     * when present).
+     */
+    onReorderSavedFilters?: (orderedIds: string[]) => void | Promise<void>;
+};

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

@@ -1,6 +1,6 @@
 import { AriaAttributes, CSSProperties, ReactElement, ReactNode } from 'react';
 import { AiMarkWithTooltipOrPopoverProps, LayoutUtilProps, Size } from '../../../types';
-import { AvatarProps, ChipProps, IconProps } from '../../..';
+import { OptionContent } from '../../../internal/types/optionContent';
 import { AddNewItemProps } from '../../../internal/types/addNewItemTypes';
 /**
  * Configuration options for the SelectField cache.
@@ -21,6 +21,11 @@ export type SelectFieldHandle = {
     invalidate: () => void;
 };
 export type SelectFieldGroupByValue = string | number;
+/**
+ * Rich content configuration for a SelectField option row.
+ * Controls the avatar, icon, description, and chip display within an option.
+ */
+export type SelectFieldOptionContent = OptionContent;
 export type SelectFieldOption = {
     id: string | number;
     label: string;
@@ -28,16 +33,7 @@ export type SelectFieldOption = {
     group?: SelectFieldGroupByValue;
     disabled?: boolean;
     extra?: Record<string, unknown>;
-    content?: {
-        title?: string;
-        description?: string;
-        chips?: Pick<ChipProps, "label" | "color" | "textWrap">[];
-        avatar?: Pick<AvatarProps, "name" | "status" | "color" | "image">;
-        icon?: Pick<IconProps, "svg" | "color"> & {
-            /** Accessible label for the icon. When omitted, the icon is treated as decorative. */
-            label?: string;
-        };
-    };
+    content?: SelectFieldOptionContent;
 };
 export type SelectFieldGroupedOption = SelectFieldOption & {
     group: SelectFieldGroupByValue;

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

@@ -12,6 +12,13 @@ export type UseMenuInteractionConfig = {
     id: string;
     triggerRef: RefObject<HTMLButtonElement>;
     label: string;
+    /**
+     * Controlled open state. The consumer owns `[isOpen, setIsOpen]` so other
+     * hooks in the same render (e.g. `useConfirmationDraft`) can read the same
+     * value without a one-render lag.
+     */
+    isOpen: boolean;
+    setIsOpen: (open: boolean) => void;
     onImplicitClose?: () => void;
     onExplicitClose?: () => void;
 };
@@ -56,7 +63,7 @@ type ItemReturnProps = {
 };
 export type GetMenuPropsFn = (opts?: MenuPropsArg) => MenuReturnProps;
 export type GetItemPropsFn = (opts: ItemPropsArg) => ItemReturnProps;
-export declare const useMenuInteraction: ({ items, sectionsMeta: _sectionsMeta, onItemActivate, selectedItemIds, displayAs: _displayAs, closeOnActivate, disabled, id, triggerRef, label, onImplicitClose, onExplicitClose, }: UseMenuInteractionConfig) => {
+export declare const useMenuInteraction: ({ items, sectionsMeta: _sectionsMeta, onItemActivate, selectedItemIds, displayAs: _displayAs, closeOnActivate, disabled, id, triggerRef, label, isOpen, setIsOpen, onImplicitClose, onExplicitClose, }: UseMenuInteractionConfig) => {
     isOpen: boolean;
     openMenu: () => void;
     closeMenu: (options?: {

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

@@ -1,6 +1,11 @@
 import { KeyboardEvent, ReactElement, RefObject } from 'react';
-import { SelectFieldCacheOptions, SelectFieldEagerLoader, SelectFieldGroupByValue, SelectFieldGroupLazyLoader, SelectFieldGroupedOption, SelectFieldOffsetLazyLoader, SelectFieldOption, SelectFieldPageLazyLoader, SelectFieldPinnedOptions, SelectFieldSearchProps } from '../SelectField/types';
+import { SelectFieldCacheOptions, SelectFieldEagerLoader, SelectFieldGroupByValue, SelectFieldGroupLazyLoader, SelectFieldGroupedOption, SelectFieldOffsetLazyLoader, SelectFieldOption, SelectFieldOptionContent, SelectFieldPageLazyLoader, SelectFieldPinnedOptions, SelectFieldSearchProps } from '../SelectField/types';
 import { AddNewItemProps } from '../../../internal/types/addNewItemTypes';
+/**
+ * Rich content configuration for a SelectMenu option row.
+ * Controls the avatar, icon, description, and chip display within an option.
+ */
+export type SelectMenuOptionContent = SelectFieldOptionContent;
 export type SelectMenuOption = SelectFieldOption;
 export type SelectMenuGroupByValue = SelectFieldGroupByValue;
 export type SelectMenuGroupedOption = SelectFieldGroupedOption;
@@ -125,6 +130,21 @@ type SelectMenuCommonProps = {
      * @default 320
      */
     popoverWidth?: "reference" | number | string;
+    /**
+     * 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;
+    };
 } & SelectMenuSearchProps & AddNewItemProps;
 type SelectMenuGroupingProps = {
     /**

package/dist/src/beta/components/Table/DataTable/internal/DataTablePagination.d.ts

@@ -1,3 +1,9 @@
 import { PaginationProps } from '../../../../..';
+type DataTableCursorPaginationProps = Pick<PaginationProps, "page" | "itemsPerPage" | "onPageChange" | "onItemsPerPageChange" | "itemsPerPageOptions"> & {
+    hasNextPage?: boolean;
+    hasPrevPage?: boolean;
+};
 export type DataTablePaginationProps = Pick<PaginationProps, "page" | "itemsPerPage" | "totalItemCount" | "showCount" | "onPageChange" | "onItemsPerPageChange" | "itemsPerPageOptions">;
 export declare const DataTablePagination: ({ showCount, ...props }: DataTablePaginationProps) => import("react/jsx-runtime").JSX.Element;
+export declare const DataTableCursorPagination: ({ page, itemsPerPage, itemsPerPageOptions, hasNextPage, hasPrevPage, onPageChange, onItemsPerPageChange, }: DataTableCursorPaginationProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/beta/components/Table/DataTable/types.d.ts

@@ -53,9 +53,12 @@ export type DataTableCacheOptions = {
     maxSize?: number;
 };
 /**
- * Configuration for pagination in DataTable
+ * Pagination behavior for DataTable.
+ * "offset" uses numbered pages with a known total row count.
+ * "cursor" uses previous/next availability for unknown-total pagination.
  */
-export type DataTablePaginationConfig<T> = {
+export type DataTablePaginationMode = "offset" | "cursor";
+type DataTablePaginationBaseConfig<T> = {
     /**
      * Number of rows displayed per page
      * @default 25
@@ -96,28 +99,57 @@ export type DataTablePaginationConfig<T> = {
      * Callback when page changes. Receives the new page index (0-based)
      */
     onPageChange?: (pageIndex: number) => void;
+    /**
+     * Key that triggers data refetch when changed.
+     * Useful for forcing refetch when external filters change.
+     * When changed, the page index automatically resets to 0.
+     */
+    refreshKey?: string | number;
+    /**
+     * Configuration for caching loadPageData results.
+     * Caching is enabled by default. Set `{ enabled: false }` to disable.
+     */
+    cache?: DataTableCacheOptions;
+};
+export type DataTableOffsetPaginationConfig<T> = DataTablePaginationBaseConfig<T> & {
+    /**
+     * Offset pagination mode.
+     * @default "offset"
+     */
+    mode?: "offset";
     /**
      * Whether to display the item count information in pagination
      * @default true
      */
     showCount?: boolean;
     /**
-     * Total number of rows across all pages. Falls back to data.length if not provided.
+     * Total number of rows across all pages in offset mode. Falls back to data.length if not provided.
      * Useful for server-side pagination scenarios where totalRowCount may differ from data array length.
      */
     totalRowCount?: number;
+    hasNextPage?: never;
+    hasPrevPage?: never;
+};
+export type DataTableCursorPaginationConfig<T> = DataTablePaginationBaseConfig<T> & {
     /**
-     * Key that triggers data refetch when changed.
-     * Useful for forcing refetch when external filters change.
-     * When changed, the page index automatically resets to 0.
+     * Cursor pagination mode for datasets where the total row count is unknown.
      */
-    refreshKey?: string | number;
+    mode: "cursor";
     /**
-     * Configuration for caching loadPageData results.
-     * Caching is enabled by default. Set `{ enabled: false }` to disable.
+     * Whether another page is available.
      */
-    cache?: DataTableCacheOptions;
+    hasNextPage: boolean;
+    /**
+     * Whether a previous page is available.
+     */
+    hasPrevPage: boolean;
+    showCount?: never;
+    totalRowCount?: never;
 };
+/**
+ * Configuration for pagination in DataTable
+ */
+export type DataTablePaginationConfig<T> = DataTableOffsetPaginationConfig<T> | DataTableCursorPaginationConfig<T>;
 /**
  * Ref handle for DataTable component
  * @property {function} refresh - Triggers a data refetch and resets the page index to 0. Useful for manually refreshing data after external changes (e.g., after a mutation).
@@ -135,3 +167,4 @@ export type DataTableRef = {
      */
     clearCache: () => void;
 };
+export {};

package/dist/src/beta/components/Toolbar/internal/ToolbarContext.d.ts

@@ -25,9 +25,10 @@ export type ToolbarContextProps = {
      */
     orderedIds?: string[];
     /**
-     * Overflow behavior type (wrap or collapse)
+     * Overflow behavior type. Defaults to wrap behavior when omitted.
+     * @default "wrap"
      */
-    overflow: ToolbarOverflowTypes;
+    overflow?: ToolbarOverflowTypes;
     /**
      * Size of toolbar child components
      */

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

@@ -8,3 +8,4 @@ export * from './SelectMenu';
 export * from './MultiSelectMenu';
 export * from './InteractiveCard';
 export * from './RichTextEditor';
+export * from './SavedFiltersButton';

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

@@ -0,0 +1,43 @@
+import { ReactNode } from 'react';
+export type MenuFooterClearConfig = {
+    onClick: () => void;
+    label?: string;
+    disabled?: boolean;
+};
+export type MenuFooterConfirmationConfig = {
+    onApply: () => void;
+    onCancel: () => void;
+    applyLabel?: string;
+    cancelLabel?: string;
+    applyDisabled?: boolean;
+};
+export type MenuFooterProps = {
+    /** Clear-selection button config. Omit to suppress. */
+    clear?: MenuFooterClearConfig;
+    /** Apply/Cancel pair config. Omit when not in confirmation mode. */
+    confirmation?: MenuFooterConfirmationConfig;
+    /**
+     * Pre-rendered add-new affordance (AddNewItemButton or similar). Layout owns
+     * its row vs. inline placement; the caller just provides the node.
+     */
+    addNew?: ReactNode;
+};
+/**
+ * MenuFooter composes the footer of a menu popover/dialog from up to three
+ * optional pieces: a clear-selection button, an Apply/Cancel pair, and an
+ * add-new affordance.
+ *
+ * Layout rules:
+ * - clear + confirmation + addNew → [addNew full-width row] / [clear | apply cancel]
+ * - clear + confirmation         → [clear | apply cancel]
+ * - clear + addNew               → [addNew] / [clear]   (stacked, both full-width)
+ * - clear                        → [clear]               (full-width)
+ * - confirmation + addNew        → [addNew | apply cancel]   (addNew on the leading side)
+ * - confirmation                 → [apply | cancel]
+ * - addNew                       → [addNew]
+ * - (none)                       → null
+ */
+export declare const MenuFooter: {
+    ({ clear, confirmation, addNew, }: MenuFooterProps): import("react/jsx-runtime").JSX.Element | null;
+    displayName: string;
+};

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

@@ -0,0 +1,6 @@
+import { CheckState } from '../../types';
+export type OptionCheckboxProps = {
+    checkState: CheckState;
+    className?: string;
+};
+export declare function OptionCheckbox({ checkState, className }: OptionCheckboxProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,8 @@
+import { ReactNode } from 'react';
+import { OptionContent } from '../types/optionContent';
+export type OptionContentAreaProps = {
+    label: string;
+    content?: OptionContent;
+    children?: ReactNode;
+};
+export declare function OptionContentArea({ label, content, children, }: OptionContentAreaProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,10 @@
+import { ComponentPropsWithoutRef, ReactNode } from 'react';
+export type OptionRowProps = ComponentPropsWithoutRef<"div"> & {
+    disabled?: boolean;
+};
+export declare const OptionRow: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    disabled?: boolean;
+} & import('react').RefAttributes<HTMLDivElement>>;
+export declare const OptionRowSideContent: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & {
+    children: ReactNode;
+} & import('react').RefAttributes<HTMLDivElement>>;

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

@@ -5,10 +5,10 @@ export type OptionsPopoverProps = {
     referenceElement: RefObject<HTMLElement>;
     open: boolean;
     /**
-     * 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.
+     * Fired when the popover should close (click-outside, focus-out, or
+     * Escape). On Escape, the popover restores focus to `referenceElement`
+     * before invoking this callback; for other paths focus has already moved
+     * elsewhere intentionally.
      */
     onClose: () => void;
     /** Controls the popover width strategy.

package/dist/src/internal/hooks/index.d.ts

@@ -17,3 +17,5 @@ export * from './useContainerQuery';
 export * from './useTypeAhead';
 export * from './useSelectFieldLoading';
 export * from './useDownshiftEnvironment';
+export * from './useConfirmationDraft';
+export * from './useBulkActionRunner';

package/dist/src/internal/hooks/useBulkActionRunner.d.ts

@@ -0,0 +1,41 @@
+type BulkComputeResult<T> = T[] | Promise<T[]>;
+export type UseBulkActionRunnerOptions<T> = {
+    /** Sets the draft (or commits when confirmation is off). */
+    setDraft: (next: T[]) => void;
+};
+export type UseBulkActionRunnerResult<T> = {
+    /**
+     * True while a bulk-action promise is in flight. While true, callers should
+     * disable option rows, override the bulk row's checkState to "loading", and
+     * disable Apply.
+     */
+    pending: boolean;
+    /**
+     * Run a bulk action. If `compute` returns an array synchronously, the draft
+     * is updated immediately. If it returns a promise, the runner enters the
+     * pending state until resolve/reject. Stale resolutions (those that finish
+     * after another draft mutation or another bulk run, or after `reset()`) are
+     * silently discarded.
+     */
+    runBulk: (compute: (current: T[]) => BulkComputeResult<T>, current: T[]) => void;
+    /**
+     * Wrap an external draft mutation so that any in-flight bulk promise's
+     * eventual resolution is discarded. Use this in place of the raw setDraft
+     * whenever the user mutates the draft outside of a bulk action (option
+     * click, etc.) so that a slow Select-All-fetching promise can't clobber a
+     * subsequent click.
+     */
+    setDraftAndBump: (next: T[]) => void;
+    /**
+     * Discard any in-flight bulk resolution. Call when the menu closes so that
+     * a promise resolving after close can't apply to the next menu instance.
+     */
+    reset: () => void;
+};
+/**
+ * Runs Select-All / Select-Filtered-style "bulk action" computations against
+ * the controlled or draft selection, with support for both synchronous and
+ * asynchronous results, and stale-result discard via a monotonic generation.
+ */
+export declare function useBulkActionRunner<T>({ setDraft, }: UseBulkActionRunnerOptions<T>): UseBulkActionRunnerResult<T>;
+export {};

package/dist/src/internal/hooks/useConfirmationDraft.d.ts

@@ -0,0 +1,21 @@
+export type UseConfirmationDraftOptions<T> = {
+    value: T;
+    onCommit: (value: T) => void;
+    isOpen: boolean;
+    enabled: boolean;
+    isEqual?: (a: T, b: T) => boolean;
+};
+export type UseConfirmationDraftResult<T> = {
+    displayValue: T;
+    setDraft: (next: T) => void;
+    apply: () => void;
+    cancel: () => void;
+    isDirty: boolean;
+};
+/**
+ * Holds a draft copy of a controlled value while a menu is open, so that
+ * selections can be confirmed (`apply`) or discarded (`cancel`). When
+ * `enabled` is false, `setDraft` passes through directly to `onCommit` and
+ * `displayValue` always reflects the controlled `value`.
+ */
+export declare function useConfirmationDraft<T>({ value, onCommit, isOpen, enabled, isEqual, }: UseConfirmationDraftOptions<T>): UseConfirmationDraftResult<T>;

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

@@ -0,0 +1,39 @@
+import { CheckState } from '../../types';
+import { SelectFieldOption } from '../../beta/components/SelectField/types';
+/**
+ * Configuration for the "Select All" / "Select Filtered" rows in a
+ * MultiSelectMenu or MultiSelectField.
+ *
+ * Choose exactly one of `onClick` or `compute`:
+ *
+ * - **`onClick`** — the row fires the callback; the consumer commits the next
+ *   selection themselves via `onSelectedOptionsChange`. Simple and familiar.
+ *   When `confirmation` is enabled, `onClick` bypasses the menu's draft layer
+ *   (the menu warns once in development).
+ * - **`compute`** — the menu invokes `compute(currentDraft)` and writes the
+ *   result into the draft (or commits it, when confirmation is off). `compute`
+ *   may return a `Promise<SelectFieldOption[]>`; while the promise is pending
+ *   the menu shows a loading state, disables all option rows, and disables
+ *   Apply.
+ */
+export type BulkActionConfig = {
+    label?: string;
+    checkState: boolean | CheckState;
+    onClick: () => void;
+    compute?: never;
+} | {
+    label?: string;
+    checkState: boolean | CheckState;
+    compute: (current: SelectFieldOption[]) => SelectFieldOption[] | Promise<SelectFieldOption[]>;
+    onClick?: never;
+};
+/**
+ * Normalized form used internally after `checkState`'s `boolean` shorthand has
+ * been resolved to a `CheckState`.
+ */
+export type ResolvedBulkAction = {
+    label?: string;
+    checkState: CheckState;
+    onClick?: () => void;
+    compute?: (current: SelectFieldOption[]) => SelectFieldOption[] | Promise<SelectFieldOption[]>;
+};

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

@@ -0,0 +1,19 @@
+/**
+ * Opt-in confirmation mode for Select* and MultiSelect* components.
+ *
+ * When set, selection changes are held as a draft inside the open menu and
+ * only commit to the controlled `value` when the user clicks Apply. Dismissing
+ * the menu (Escape, click outside, toggling the trigger) discards the draft.
+ *
+ * `true` enables the default Apply/Cancel labels. Pass an object to customize.
+ */
+export type ConfirmationProp = boolean | {
+    applyLabel?: string;
+    cancelLabel?: string;
+};
+export type ResolvedConfirmation = {
+    enabled: boolean;
+    applyLabel: string;
+    cancelLabel: string;
+};
+export declare const resolveConfirmation: (prop: ConfirmationProp | undefined) => ResolvedConfirmation;

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

@@ -0,0 +1,19 @@
+import { AvatarProps, ChipProps, IconProps } from '../../components';
+/**
+ * Shared content shape for option rows in SelectField, MultiSelectField, and TreeSelectField.
+ * @property title - Overrides the option label text when provided.
+ * @property description - Secondary text displayed below the title in a subdued color.
+ * @property chips - Tags displayed below the description.
+ * @property avatar - Avatar displayed to the left of the text content.
+ * @property icon - Icon displayed to the right of the text content.
+ */
+export type OptionContent = {
+    title?: string;
+    description?: string;
+    chips?: Pick<ChipProps, "label" | "color" | "textWrap">[];
+    avatar?: Pick<AvatarProps, "name" | "status" | "color" | "image">;
+    icon?: Pick<IconProps, "svg" | "color"> & {
+        /** Accessible label for the icon. When omitted, the icon is treated as decorative. */
+        label?: string;
+    };
+};

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

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