@servicetitan/anvil2 3.9.0 → 3.10.1

package/dist/src/components/DrillDown/DrillDown.d.ts

@@ -10,6 +10,17 @@ import { PassThroughPropsWithRef } from '../../types';
 export type DrillDownProps = PassThroughPropsWithRef<"div"> & {
     index: number;
     onClose?: () => void;
+    /**
+     * Suspends this screen's focus trap while `false`, even though the screen
+     * stays mounted and visible. Use when a consumer opens an independent
+     * Dialog/Drawer of their own (not a nested `DrillDown` index — e.g. a
+     * `DateListDialog` triggered from a form field in this screen) that stacks
+     * on top: that overlay isn't a descendant of this screen's trap boundary,
+     * so without this escape hatch the trap treats every click inside it as
+     * "outside" and blocks it.
+     * @default true
+     */
+    interactive?: boolean;
 };
 /**
  * Multi-step, hierarchical drill-down navigation component for Dialog, Drawer, and Page.Panel — lets users drill down by selecting a category to go deeper into nested subcategories or screens, and navigate back up.

package/dist/src/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, isHighlighted, 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;
+export declare const MultiSelectFieldComboboxMode: ({ labelAiMark, id, helperUid, selectedOptions, onSelectedOptionsChange, displayAs, isDisabledOrReadOnly, disabled, readOnly, isHighlighted, 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, dataAttributes, }: MultiSelectFieldComboboxInternalProps) => import("react/jsx-runtime").JSX.Element;

package/dist/src/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, isHighlighted, 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;
+export declare const MultiSelectFieldSelectMode: ({ labelAiMark, id, helperUid, selectedOptions, onSelectedOptionsChange, displayAs, isDisabledOrReadOnly, disabled, readOnly, isHighlighted, 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, dataAttributes, }: MultiSelectFieldBaseInternalProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -1,5 +1,5 @@
 import { ReactElement, ReactNode, RefObject } from 'react';
-import { AiMarkWithTooltipOrPopoverProps, CheckState } from '../../../types';
+import { AiMarkWithTooltipOrPopoverProps, CheckState, DataAttributes } from '../../../types';
 import { AddNewItemProps } from '../../../internal/types/addNewItemTypes';
 import { MultiSelectFieldChipProps, MultiSelectFieldOption, MultiSelectFieldProps } from '../types';
 export type MultiSelectFieldBaseInternalProps = {
@@ -63,6 +63,8 @@ export type MultiSelectFieldBaseInternalProps = {
         id: string | number;
     }) => void;
     handleClear: () => void;
+    /** Consumer-supplied `data-*` attributes forwarded to the field wrapper. */
+    dataAttributes?: DataAttributes;
 } & AddNewItemProps;
 export type MultiSelectFieldComboboxInternalProps = MultiSelectFieldBaseInternalProps & {
     debounceMs: number;

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

@@ -0,0 +1,20 @@
+/**
+ * `data-anv-part` names for MultiSelectField's interactive sub-elements.
+ *
+ * Scope a query by the consumer's `data-cy` on the field root
+ * (`[data-cy="x"] [data-anv-part="input"]`). Portaled parts (`menu`, `option`,
+ * `dialog`, `popover`) come from the shared option internals and render in the
+ * top layer — target them by part attribute or the field's `#{id}-popover` /
+ * `#{id}-dialog`.
+ *
+ * Every role MultiSelectField needs is a shared one, so all values come from
+ * `COMMON_PART`.
+ */
+export declare const PARTS: {
+    readonly trigger: "trigger";
+    readonly input: "input";
+    readonly chip: "chip";
+    readonly overflowChip: "overflow-chip";
+    readonly clearButton: "clear-button";
+    readonly toggleButton: "toggle-button";
+};

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

@@ -1,5 +1,5 @@
 import { AriaAttributes, CSSProperties, ReactElement, ReactNode } from 'react';
-import { AiMarkWithTooltipOrPopoverProps, LayoutUtilProps, Size } from '../../types';
+import { AiMarkWithTooltipOrPopoverProps, DataAttributes, LayoutUtilProps, Size } from '../../types';
 import { SelectFieldGroupByValue, SelectFieldOption, SelectFieldOptionContent } from '../SelectField/types';
 import { ChipProps } from '../../components/Chip';
 import { AddNewItemProps } from '../../internal/types/addNewItemTypes';
@@ -294,7 +294,7 @@ type MultiSelectFieldCommonProps = {
      * @returns Partial chip props to merge onto the chip
      */
     getChipProps?: (option: MultiSelectFieldOption) => MultiSelectFieldChipProps;
-} & MultiSelectFieldSearchProps & LayoutUtilProps & AddNewItemProps;
+} & MultiSelectFieldSearchProps & LayoutUtilProps & AddNewItemProps & DataAttributes;
 type MultiSelectFieldGroupingProps = {
     /**
      * Function to convert a group value to a display label.

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

@@ -0,0 +1,12 @@
+/**
+ * `data-anv-part` names for MultiSelectMenu interactive sub-elements.
+ *
+ * There is no wrapper root — attach consumer `data-*` (e.g. `data-cy`) via
+ * props; they are merged into the trigger render-prop bag. Portaled
+ * `menu` / `option` / `popover` / `dialog` / footer buttons come from shared
+ * internals (not redeclared here).
+ */
+export declare const PARTS: {
+    readonly trigger: "trigger";
+    readonly input: "input";
+};

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

@@ -1,4 +1,5 @@
 import { KeyboardEvent, ReactElement, RefObject } from 'react';
+import { DataAttributes } from '../../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';
@@ -54,7 +55,7 @@ export type MultiSelectMenuTriggerProps = {
     "aria-controls": string;
     "aria-expanded": boolean;
     "data-state": "open" | "close";
-};
+} & DataAttributes;
 type MultiSelectMenuCommonProps = {
     /**
      * The id of the multi-select menu.
@@ -188,7 +189,7 @@ type MultiSelectMenuCommonProps = {
         label?: string;
         disabled?: boolean;
     };
-} & MultiSelectMenuSearchProps & AddNewItemProps;
+} & MultiSelectMenuSearchProps & AddNewItemProps & DataAttributes;
 type MultiSelectMenuGroupingProps = {
     /**
      * Function to convert a group value to a display label.

package/dist/src/components/Pagination/Pagination.d.ts

@@ -1,4 +1,4 @@
-import { DataTrackingId } from '../../types';
+import { DataAttributes, DataTrackingId } from '../../types';
 import { PaginationProps as BasePaginationProps } from './internal/Pagination';
 /**
  * Props for the Pagination component
@@ -12,8 +12,9 @@ import { PaginationProps as BasePaginationProps } from './internal/Pagination';
  * @property {string} [itemsPerPageLabel] - Custom label displayed before the items-per-page selector. Defaults to "Rows per page"
  * @extends Omit<BasePaginationProps, "children">
  * @extends DataTrackingId
+ * @extends DataAttributes
  */
-export type PaginationProps = Omit<BasePaginationProps, "children"> & DataTrackingId & {
+export type PaginationProps = Omit<BasePaginationProps, "children"> & DataTrackingId & DataAttributes & {
     page: number;
     itemsPerPage: number;
     itemsPerPageOptions?: number[];
@@ -47,7 +48,7 @@ export type PaginationProps = Omit<BasePaginationProps, "children"> & DataTracki
  *   onItemsPerPageChange={(itemsPerPage) => console.log('Items per page:', itemsPerPage)}
  * />
  */
-export declare const Pagination: import('react').ForwardRefExoticComponent<Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLElement>, HTMLElement>, "ref">, "children"> & DataTrackingId & {
+export declare const Pagination: import('react').ForwardRefExoticComponent<Omit<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLElement>, HTMLElement>, "ref">, "children"> & DataTrackingId & DataAttributes & {
     page: number;
     itemsPerPage: number;
     itemsPerPageOptions?: number[];

package/dist/src/components/Pagination/parts.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `data-anv-part` names for Pagination's interactive sub-elements.
+ *
+ * Scope a query by the consumer's `data-cy` on the Pagination root
+ * (`[data-cy="x"] [data-anv-part="next-page-button"]`).
+ *
+ * Repeated parts use secondary discriminators:
+ * - page buttons / overflow options: `data-page`
+ * - items-per-page options: `data-items-per-page`
+ *
+ * Overflow and items-per-page menus render in the browser top layer — target
+ * `option` parts by attribute (or after opening the matching trigger), not as
+ * descendants of the Pagination root.
+ */
+export declare const PARTS: {
+    /** Shared role for menu options (overflow pages + items-per-page). */
+    readonly option: "option";
+    /** Previous-page control. */
+    readonly prevPageButton: "prev-page-button";
+    /** Next-page control. */
+    readonly nextPageButton: "next-page-button";
+    /** Numbered page control. Narrow with `data-page`. */
+    readonly pageButton: "page-button";
+    /** Ellipsis control that opens the overflow page menu. */
+    readonly overflowTrigger: "overflow-trigger";
+    /** Control that opens the items-per-page menu. */
+    readonly itemsPerPageTrigger: "items-per-page-trigger";
+};

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

@@ -3,4 +3,4 @@ import { SelectFieldComboboxInternalProps } from '../../../internal/types/select
  * 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, isHighlighted, 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;
+export declare const SelectFieldComboboxMode: ({ id, helperUid, selectedOption, onSelectedOptionChange, displayAs, isDisabledOrReadOnly, disabled, labelAiMark, readOnly, isHighlighted, 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, dataAttributes, }: SelectFieldComboboxInternalProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -3,4 +3,4 @@ import { SelectFieldBaseInternalProps } from '../../../internal/types/selectFiel
  * 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, isHighlighted, 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;
+export declare const SelectFieldSelectMode: ({ labelAiMark, id, helperUid, selectedOption, onSelectedOptionChange, displayAs, isDisabledOrReadOnly, disabled, readOnly, isHighlighted, 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, dataAttributes, }: SelectFieldBaseInternalProps) => import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,18 @@
+/**
+ * `data-anv-part` names for SelectField's interactive sub-elements.
+ *
+ * Scope a query by the consumer's `data-cy` on the field root
+ * (`[data-cy="x"] [data-anv-part="input"]`). Portaled parts (`menu`, `option`,
+ * `dialog`, `popover`) come from the shared option internals and render in the
+ * top layer — target them by part attribute or the field's `#{id}-popover` /
+ * `#{id}-dialog`.
+ *
+ * Every role SelectField needs is a shared one, so all values come from
+ * `COMMON_PART`.
+ */
+export declare const PARTS: {
+    readonly trigger: "trigger";
+    readonly input: "input";
+    readonly clearButton: "clear-button";
+    readonly toggleButton: "toggle-button";
+};

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

@@ -1,5 +1,5 @@
 import { AriaAttributes, CSSProperties, ReactElement, ReactNode } from 'react';
-import { AiMarkWithTooltipOrPopoverProps, LayoutUtilProps, Size } from '../../types';
+import { AiMarkWithTooltipOrPopoverProps, DataAttributes, LayoutUtilProps, Size } from '../../types';
 import { OptionContent } from '../../internal/types/optionContent';
 import { AddNewItemProps } from '../../internal/types/addNewItemTypes';
 /**
@@ -31,6 +31,11 @@ export type SelectFieldOption = {
     label: string;
     searchText?: string;
     group?: SelectFieldGroupByValue;
+    /**
+     * When true, the option cannot be selected from the menu. If the option is
+     * already in the field `value`, MultiSelectField also treats it as locked:
+     * the chip has no close control, and clear / backspace skip it.
+     */
     disabled?: boolean;
     extra?: Record<string, unknown>;
     content?: SelectFieldOptionContent;
@@ -252,7 +257,7 @@ type SelectFieldCommonSelectFieldProps = {
      * @default false
      */
     disableSearch?: boolean;
-} & SelectFieldSearchProps & SelectFieldAddNewOptionProps & LayoutUtilProps & AddNewItemProps;
+} & SelectFieldSearchProps & SelectFieldAddNewOptionProps & LayoutUtilProps & AddNewItemProps & DataAttributes;
 type SelectFieldGroupingProps = {
     /**
      * Function to convert a group value to a display label.

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

@@ -36,12 +36,12 @@ export type MenuTriggerProps = {
     "aria-controls": string;
     "aria-expanded": boolean;
     "data-state": "open" | "close";
-};
+} & Record<`data-${string}`, string>;
 type MenuPropsArg = {
     className?: string;
     style?: CSSProperties;
-};
-type MenuReturnProps = MenuPropsArg & {
+} & Record<string, unknown>;
+type MenuReturnProps = {
     role: "listbox";
     id: string;
     "aria-label": string;
@@ -50,13 +50,15 @@ type MenuReturnProps = MenuPropsArg & {
     "aria-activedescendant"?: string;
     ref: RefObject<HTMLDivElement>;
     onKeyDown: (e: KeyboardEvent) => void;
-};
+    className?: string;
+    style?: CSSProperties;
+} & Record<string, unknown>;
 type ItemPropsArg = {
     item: SelectItem;
     index: number;
     className?: string;
     "data-type"?: string;
-};
+} & Record<string, unknown>;
 type ItemReturnProps = {
     role: "option";
     id: string;
@@ -66,7 +68,7 @@ type ItemReturnProps = {
     onMouseMove: () => void;
     className?: string;
     "data-type"?: string;
-};
+} & Record<string, unknown>;
 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, closeOnDisabled, id, triggerRef, label, isOpen, setIsOpen, onImplicitClose, onExplicitClose, }: UseMenuInteractionConfig) => {

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

@@ -0,0 +1,12 @@
+/**
+ * `data-anv-part` names for SelectMenu interactive sub-elements.
+ *
+ * There is no wrapper root — attach consumer `data-*` (e.g. `data-cy`) via
+ * props; they are merged into the trigger render-prop bag. Portaled
+ * `menu` / `option` / `popover` / `dialog` / footer buttons come from shared
+ * internals (not redeclared here).
+ */
+export declare const PARTS: {
+    readonly trigger: "trigger";
+    readonly input: "input";
+};

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

@@ -1,4 +1,5 @@
 import { KeyboardEvent, ReactElement, RefObject } from 'react';
+import { DataAttributes } from '../../types';
 import { SelectFieldCacheOptions, SelectFieldEagerLoader, SelectFieldGroupByValue, SelectFieldGroupLazyLoader, SelectFieldGroupedOption, SelectFieldOffsetLazyLoader, SelectFieldOption, SelectFieldOptionContent, SelectFieldPageLazyLoader, SelectFieldPinnedOptions, SelectFieldSearchProps } from '../SelectField/types';
 import { AddNewItemProps } from '../../internal/types/addNewItemTypes';
 /**
@@ -48,7 +49,7 @@ export type SelectMenuTriggerProps = {
     "aria-controls": string;
     "aria-expanded": boolean;
     "data-state": "open" | "close";
-};
+} & DataAttributes;
 type SelectMenuCommonProps = {
     /**
      * The id of the select menu.
@@ -145,7 +146,7 @@ type SelectMenuCommonProps = {
         label?: string;
         disabled?: boolean;
     };
-} & SelectMenuSearchProps & AddNewItemProps;
+} & SelectMenuSearchProps & AddNewItemProps & DataAttributes;
 type SelectMenuGroupingProps = {
     /**
      * Function to convert a group value to a display label.

package/dist/src/components/SelectTrigger/internal/SelectTriggerBase.d.ts

@@ -2,8 +2,8 @@ import { ComponentPropsWithoutRef, MutableRefObject, MouseEventHandler, ReactNod
 import { ChipProps } from '../../Chip';
 import { FieldLabelProps } from '../../FieldLabel';
 import { TextFieldProps } from '../../TextField';
-import { DistributiveOmit } from '../../../types';
-type PartialChipProps = Partial<Omit<ChipProps, "icon" | "avatar">> & ({
+import { DataAttributes, DistributiveOmit } from '../../../types';
+type PartialChipProps = Partial<Omit<ChipProps, "icon" | "avatar">> & DataAttributes & ({
     icon?: ChipProps["icon"];
     avatar?: never;
 } | {
@@ -30,12 +30,13 @@ export type SelectTriggerBaseProps<Item = unknown> = DistributiveOmit<TextFieldP
     onClearButtonClick?: MouseEventHandler<HTMLButtonElement>;
     labelProps?: Partial<FieldLabelProps>;
     inputWrapperProps?: ComponentPropsWithoutRef<"div">;
-    toggleButtonProps?: ComponentPropsWithoutRef<"button">;
+    toggleButtonProps?: ComponentPropsWithoutRef<"button"> & DataAttributes;
+    clearButtonProps?: ComponentPropsWithoutRef<"button"> & DataAttributes;
     chipProps?: (item: Item, index: number) => PartialChipProps;
-    inputProps?: ComponentPropsWithoutRef<"input" | "div">;
+    inputProps?: ComponentPropsWithoutRef<"input" | "div"> & DataAttributes;
     disableToggleButton?: boolean;
 } & {
     prefix?: string | ReactNode;
 };
-export declare const SelectTriggerBase: <Item>({ className, label, size, error, hint, description, prefix, suffix, maxRows, selectedItemProps, disabled, readOnly, disableClearSelection, itemToString: itemToStringProp, selectedItem, selectedItems, removeSelectedItem, inputValue, referenceRef, variant, onClearButtonClick, labelProps, inputWrapperProps, toggleButtonProps, inputProps, chipProps, disableToggleButton, warning, placeholder, ...rest }: SelectTriggerBaseProps<Item>) => import("react/jsx-runtime").JSX.Element;
+export declare const SelectTriggerBase: <Item>({ className, label, size, error, hint, description, prefix, suffix, maxRows, selectedItemProps, disabled, readOnly, disableClearSelection, itemToString: itemToStringProp, selectedItem, selectedItems, removeSelectedItem, inputValue, referenceRef, variant, onClearButtonClick, labelProps, inputWrapperProps, toggleButtonProps, clearButtonProps, inputProps, chipProps, disableToggleButton, warning, placeholder, ...rest }: SelectTriggerBaseProps<Item>) => import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/src/components/Toolbar/Toolbar.d.ts

@@ -1,12 +1,12 @@
 import { ToolbarOverflowTypes, ToolbarSize } from './types';
 import { ComponentPropsWithoutRef, ReactElement } from 'react';
-import { LayoutUtilProps } from '../../types';
+import { DataAttributes, LayoutUtilProps } from '../../types';
 /**
  * Props for the Toolbar component
  * @extends ComponentPropsWithoutRef<"div">
  * @extends LayoutUtilProps
  */
-export type ToolbarProps = ComponentPropsWithoutRef<"div"> & LayoutUtilProps & {
+export type ToolbarProps = ComponentPropsWithoutRef<"div"> & LayoutUtilProps & DataAttributes & {
     /**
      * Description of the content this toolbar is associated with, used for accessibility
      */
@@ -57,7 +57,7 @@ export type ToolbarProps = ComponentPropsWithoutRef<"div"> & LayoutUtilProps & {
  *   />
  * </Toolbar>
  */
-export declare const Toolbar: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & LayoutUtilProps & {
+export declare const Toolbar: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & LayoutUtilProps & DataAttributes & {
     /**
      * Description of the content this toolbar is associated with, used for accessibility
      */

package/dist/src/components/Toolbar/parts.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `data-anv-part` names for Toolbar's interactive sub-elements.
+ *
+ * Scope in-wrapper parts by the consumer's `data-cy` on the Toolbar root.
+ * Overflow menu/items render in the popover top layer — target them by part
+ * attribute directly.
+ */
+export declare const PARTS: {
+    readonly trigger: "trigger";
+    readonly menu: "menu";
+    readonly overflowItem: "overflow-item";
+    /**
+     * A leaf toolbar control (`Toolbar.Button` / `Toolbar.ButtonToggle`).
+     * Discriminate with `aria-label`, `id`, or a consumer `data-*`. Callers may
+     * override this (e.g. FilterBar stamps `trigger` on boolean toggles).
+     */
+    readonly item: "item";
+};

package/dist/src/internal/constants/anvParts.d.ts

@@ -0,0 +1,81 @@
+/**
+ * `data-anv-part` — the internally-managed test attribute for targeting the
+ * interactive sub-elements of complex Anvil2 components in end-to-end tests.
+ *
+ * Scoping model (two independent axes — use either or both):
+ * - **Component type**: the component's existing `data-anv` root value
+ *   (e.g. `data-anv="data-table-base"`). Stable, already present on most roots.
+ * - **Instance**: a consumer-supplied `data-*` (e.g. `data-cy`) forwarded to the
+ *   root. The consumer owns this.
+ *
+ * A test then queries `[data-anv="<component>"] [data-anv-part="row"]` or
+ * `[data-cy="x"] [data-anv-part="row"]`. Because the part is always read in the
+ * context of a component, **part names only need to be unique within a single
+ * component** — `header`, `row`, and `item` may repeat across components.
+ *
+ * Kept separate from `data-anv` (which holds structural/decorative values like
+ * "popover-content" or "button"); the two attributes coexist on an element.
+ *
+ * ## Where part names live
+ *
+ * Each component owns its part names in a co-located `parts.ts` next to its
+ * source (e.g. `beta/components/Table/parts.ts`):
+ *
+ *     import { ANV_PART_ATTR } from "../../../internal/constants/anvParts";
+ *     export const PARTS = {
+ *       row: "row",
+ *       cell: "cell",
+ *       sortToggle: "sort-toggle",
+ *     } as const;
+ *
+ * This file centralizes only (1) the attribute name and (2) the small set of
+ * roles that recur across many components, so their *string values* stay
+ * identical everywhere. Prefer a `COMMON_PART` value when one fits; otherwise
+ * define a component-specific name in that component's `parts.ts`.
+ */
+export declare const ANV_PART_ATTR: "data-anv-part";
+/**
+ * Cross-cutting part roles whose string values must match across components so
+ * consumers can rely on them. Spread or reference these from a component's
+ * co-located `parts.ts` rather than re-typing the literals.
+ */
+export declare const COMMON_PART: {
+    /** Element that opens a menu/popover/dialog/drawer. */
+    readonly trigger: "trigger";
+    /** Free-text entry. */
+    readonly input: "input";
+    /** Button that clears the current value/selection. */
+    readonly clearButton: "clear-button";
+    /** Button that opens/closes an adjacent surface. */
+    readonly toggleButton: "toggle-button";
+    /** Button that commits a pending selection. */
+    readonly applyButton: "apply-button";
+    /** Button that dismisses a surface without committing. */
+    readonly cancelButton: "cancel-button";
+    /** Listbox/menu container. */
+    readonly menu: "menu";
+    /** A single option/row within a menu. */
+    readonly option: "option";
+    /** A selected-value chip. */
+    readonly chip: "chip";
+    /** Dialog container (top layer). */
+    readonly dialog: "dialog";
+    /** Popover container (top layer). */
+    readonly popover: "popover";
+    /** Drawer container (top layer). */
+    readonly drawer: "drawer";
+    /** Masked text input of a date / date-range field. */
+    readonly dateInput: "date-input";
+    /** Calendar surface of a date / date-range field. */
+    readonly dateCalendar: "date-calendar";
+    /** Affordance that adds a new item from a select/combobox menu. */
+    readonly addNewItemButton: "add-new-item-button";
+    /** Lazy-load control inside a virtualized/paged options list. */
+    readonly loadMoreButton: "load-more-button";
+    /**
+     * "+N" overflow indicator when selected-value chips exceed the visible
+     * budget. Distinct from `chip` (real selected values).
+     */
+    readonly overflowChip: "overflow-chip";
+};
+export type CommonPart = (typeof COMMON_PART)[keyof typeof COMMON_PART];

package/dist/src/internal/testing/anvPartsContract.d.ts

@@ -0,0 +1,24 @@
+type PartsRecord = Record<string, string>;
+type PartKey<T extends PartsRecord> = Extract<keyof T, string>;
+export type ExpectAnvPartsOptions<T extends PartsRecord> = {
+    /** Part keys that must be present in `scope` (default: at least one match). */
+    present?: PartKey<T>[];
+    /** Part keys that must not appear in `scope`. */
+    absent?: PartKey<T>[];
+    /**
+     * Node to query within. Defaults to `document.body` so portaled parts
+     * (menu / popover / dialog / drawer) are found without a wrapper.
+     */
+    scope?: ParentNode;
+    /** Exact match count for a present key. */
+    count?: Partial<Record<PartKey<T>, number>>;
+    /** Minimum match count for a present key (ignored when `count` is set). */
+    minCount?: Partial<Record<PartKey<T>, number>>;
+};
+/**
+ * Assert that `data-anv-part` values from a PARTS / COMMON_PART map are present
+ * or absent in the DOM. Prefer this over hard-coded attribute strings so
+ * renames in `parts.ts` fail the contract instead of silently drifting.
+ */
+export declare function expectAnvParts<T extends PartsRecord>(parts: T, options?: ExpectAnvPartsOptions<T>): void;
+export {};

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

@@ -1,5 +1,5 @@
 import { ReactElement, ReactNode, RefObject } from 'react';
-import { AiMarkWithTooltipOrPopoverProps, CheckState } from '../../types';
+import { AiMarkWithTooltipOrPopoverProps, CheckState, DataAttributes } from '../../types';
 import { SelectFieldOption, SelectFieldProps } from '../../components/SelectField/types';
 import { AddNewItemProps } from './addNewItemTypes';
 import { ResolvedConfirmation } from './confirmationTypes';
@@ -66,6 +66,8 @@ export type SelectFieldBaseInternalProps = {
     setInitialLoadPerformed: (val: boolean) => void;
     inputWrapperRef: RefObject<HTMLDivElement>;
     confirmation?: ResolvedConfirmation;
+    /** Consumer-supplied `data-*` attributes forwarded to the field wrapper. */
+    dataAttributes?: DataAttributes;
 } & AddNewItemProps;
 export type SelectFieldComboboxInternalProps = SelectFieldBaseInternalProps & {
     debounceMs: number;

package/dist/{syncFilterUtils-UVNoFsDr.js → syncFilterUtils-YB6gRuuR.js}

@@ -3,6 +3,7 @@ import { S as Spinner } from './Spinner-B7tTWcP6.js';
 import { B as Button } from './Button-Dwh_Nd4l.js';
 import { c as cx } from './index-De1g9FRV.js';
 import { useState, useRef, useCallback, useEffect, useMemo, forwardRef, useId, useImperativeHandle } from 'react';
+import { C as COMMON_PART, A as ANV_PART_ATTR } from './anvParts-BGg5dgfl.js';
 import { u as useIntersectionObserver } from './useIntersectionObserver-BEmMDO3P.js';
 import { T as Text } from './Text-CIoD_RK4.js';
 import { D as Divider } from './Divider-C7fp5Xb6.js';
@@ -10,7 +11,7 @@ import { u as useMergeRefs } from './useMergeRefs-Dfmtq9cI.js';
 import { S as SrOnly } from './SrOnly-pnf8ajnh.js';
 import { I as Icon } from './Icon-B5zwN7GD.js';
 import { S as SvgCheck } from './check-Cf67OWrZ.js';
-import { b as OptionRow, c as OptionRowSideContent, d as OptionCheckbox, e as OptionContentArea, u as useAdaptiveView } from './useAdaptiveView-C_WvM4-P.js';
+import { b as OptionRow, c as OptionRowSideContent, d as OptionCheckbox, e as OptionContentArea, u as useAdaptiveView } from './useAdaptiveView-DmhhcX-B.js';
 import { d as defaultRangeExtractor, u as useVirtualizer } from './index-DXeGMe23.js';
 import { S as SvgAdd } from './add-BcQkAUip.js';
 import { m as matchSorter } from './match-sorter.esm-CGAauEiU.js';
@@ -214,6 +215,7 @@ const SelectOption = ({
         item,
         index,
         "data-type": item.type,
+        [ANV_PART_ATTR]: COMMON_PART.option,
         className: cx(styles["select-option"], {
           [styles.highlighted]: highlighted && !isSingleSelected,
           [styles["single-selected"]]: isSingleSelected && !highlighted,
@@ -489,7 +491,8 @@ const OptionsPanel = forwardRef(
     };
     const menuProps = getMenuProps({
       className: cx(styles$1["scroller"], className),
-      style
+      style,
+      [ANV_PART_ATTR]: COMMON_PART.menu
     });
     const menuRef = useMergeRefs([menuProps.ref, scrollerRef]);
     return /* @__PURE__ */ jsx("div", { ...menuProps, ref: menuRef, children: /* @__PURE__ */ jsxs("div", { className: styles$1["select-field-list"], children: [
@@ -517,6 +520,7 @@ const OptionsPanel = forwardRef(
               appearance: "secondary",
               size: "small",
               onClick: onLoadMore,
+              ...{ [ANV_PART_ATTR]: COMMON_PART.loadMoreButton },
               children: "Load more"
             }
           ) })
@@ -734,6 +738,7 @@ const VirtualizedOptionsPanel = forwardRef(
             appearance: "secondary",
             size: "small",
             onClick: () => onLoadMoreRef.current(),
+            ...{ [ANV_PART_ATTR]: COMMON_PART.loadMoreButton },
             children: "Load more"
           }
         ) }) });
@@ -742,7 +747,8 @@ const VirtualizedOptionsPanel = forwardRef(
     };
     const menuProps = getMenuProps({
       className: cx(styles$1["scroller"], className),
-      style
+      style,
+      [ANV_PART_ATTR]: COMMON_PART.menu
     });
     const menuRef = useMergeRefs([menuProps.ref, scrollerRef]);
     return /* @__PURE__ */ jsx("div", { ...menuProps, ref: menuRef, children: /* @__PURE__ */ jsxs("div", { className: styles$1["select-field-list"], children: [
@@ -1099,6 +1105,7 @@ const AddNewItemButton = ({
         onAddNewItem(searchText);
       },
       style: { width: "100%" },
+      ...{ [ANV_PART_ATTR]: COMMON_PART.addNewItemButton },
       children: resolvedLabel
     }
   );
@@ -1220,4 +1227,4 @@ const sortByGroup = (options, groupSorter) => {
 };
 
 export { AddNewItemButton as A, OptionsPanel as O, VirtualizedOptionsPanel as V, useProcessedOptions as a, buildSelectItems as b, sortByGroup as c, defaultSyncFilter as d, toSelectItem as e, shouldShowAddNewItem as s, toSyncFilterFn as t, useSelectOrchestration as u };
-//# sourceMappingURL=syncFilterUtils-UVNoFsDr.js.map
+//# sourceMappingURL=syncFilterUtils-YB6gRuuR.js.map