@servicetitan/anvil2 3.9.0 → 3.10.0

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

@@ -1,4 +1,4 @@
-import { DataTrackingId, LayoutUtilProps, Size } from '../../types';
+import { DataAttributes, DataTrackingId, LayoutUtilProps, Size } from '../../types';
 import { YearlessDate, YearlessDateMode } from './types';
 import { ReactElement, ReactNode, ComponentPropsWithoutRef } from 'react';
 import { FieldLabelProps } from '../FieldLabel';
@@ -105,7 +105,7 @@ export type DateFieldYearlessProps = Omit<ComponentPropsWithoutRef<"input">, "on
      * Function to call when the field is blurred
      */
     onBlur?: (event: React.FocusEvent) => void;
-} & DataTrackingId;
+} & DataTrackingId & DataAttributes;
 /**
  * Represents a change event for the DateFieldYearless component
  */

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

@@ -0,0 +1,15 @@
+/**
+ * `data-anv-part` names for DateFieldYearless interactive sub-elements.
+ *
+ * Consumer `data-*` (e.g. `data-cy`) is forwarded to the masked text input —
+ * the one element present in every mode (including `disablePicker`). The
+ * picker popover and month/day lists render in the top layer, outside the
+ * input's subtree — target them by part attribute directly.
+ */
+export declare const PARTS: {
+    readonly input: "date-input";
+    readonly popover: "popover";
+    readonly monthList: "month-list";
+    readonly dayList: "day-list";
+    readonly option: "option";
+};

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

@@ -1,6 +1,6 @@
 import { ReactElement } from 'react';
 import { HelperProps } from '../../internal/components';
-import { LayoutUtilProps, Size } from '../../types';
+import { DataAttributes, LayoutUtilProps, Size } from '../../types';
 import { FieldLabelProps } from '../FieldLabel';
 import { YearlessDate, YearlessDateMode } from '../DateFieldYearless/types';
 export type DateFieldYearlessRangeValue = {
@@ -73,7 +73,7 @@ export type DateFieldYearlessRangeProps = {
     endLabel?: string;
     legendProps?: Omit<FieldLabelProps, "el">;
     moreInfo?: FieldLabelProps["moreInfo"];
-} & LayoutUtilProps;
+} & LayoutUtilProps & DataAttributes;
 /**
  * DateFieldYearlessRange component for entering a start and end month/day
  * pair — a date range with no year, e.g. recurring events or anniversaries.

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

@@ -0,0 +1,12 @@
+/**
+ * `data-anv-part` names for DateFieldYearlessRange interactive sub-elements.
+ *
+ * Consumer `data-*` is forwarded to the fieldset root. Scope start/end inputs
+ * under it (`[data-cy="x"] [data-anv-part="start-input"]`). Picker popover /
+ * month-list / day-list / option parts are stamped by the shared yearless
+ * picker internals — see DateFieldYearless `PARTS`.
+ */
+export declare const PARTS: {
+    readonly startInput: "start-input";
+    readonly endInput: "end-input";
+};

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;