@servicetitan/anvil2 3.8.0 → 3.10.0

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

@@ -1,6 +1,6 @@
 export * from './Popover';
-export { type PopoverButtonProps } from './PopoverButton';
-export { type PopoverCloseProps } from './PopoverClose';
-export { type PopoverContentProps } from './PopoverContent';
-export { type PopoverTriggerProps } from './PopoverTrigger';
+export type { PopoverButtonProps } from './PopoverButton';
+export type { PopoverCloseProps } from './PopoverClose';
+export type { PopoverContentProps } from './PopoverContent';
+export type { PopoverTriggerProps } from './PopoverTrigger';
 export { Popover as default } from './Popover';

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

@@ -1,4 +1,4 @@
 export * from './Radio';
-export { type RadioGroupProps } from './RadioGroup';
+export type { RadioGroupProps } from './RadioGroup';
 export { Radio as default } from './Radio';
-export { type RadioState } from './types';
+export type { RadioState } from './types';

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

@@ -1,3 +1,3 @@
 export * from './SelectCard';
-export { type SelectCardGroupProps } from './SelectCardGroup';
+export type { SelectCardGroupProps } from './SelectCardGroup';
 export { SelectCard as default } from './SelectCard';

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

@@ -9,6 +9,12 @@ export type UseMenuInteractionConfig = {
     displayAs: "popover" | "dialog";
     closeOnActivate: boolean;
     disabled?: boolean;
+    /**
+     * When true (default), the menu closes if `disabled` becomes true.
+     * Set false when `disabled` only freezes row interaction (e.g. bulk pending)
+     * and the menu should remain open.
+     */
+    closeOnDisabled?: boolean;
     id: string;
     triggerRef: RefObject<HTMLButtonElement>;
     label: string;
@@ -30,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;
@@ -44,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;
@@ -60,10 +68,10 @@ 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, id, triggerRef, label, isOpen, setIsOpen, onImplicitClose, onExplicitClose, }: UseMenuInteractionConfig) => {
+export declare const useMenuInteraction: ({ items, sectionsMeta: _sectionsMeta, onItemActivate, selectedItemIds, displayAs: _displayAs, closeOnActivate, disabled, closeOnDisabled, id, triggerRef, label, isOpen, setIsOpen, onImplicitClose, onExplicitClose, }: UseMenuInteractionConfig) => {
     isOpen: boolean;
     openMenu: () => void;
     closeMenu: (options?: {

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/SideNav/index.d.ts

@@ -1,5 +1,5 @@
 export { SideNav, type SideNavProps } from './SideNav';
-export { type SideNavLinkProps } from './SideNavLink';
-export { type SideNavCollapsibleProps } from './SideNavCollapsible';
-export { type SideNavGroupProps } from './SideNavGroup';
+export type { SideNavLinkProps } from './SideNavLink';
+export type { SideNavCollapsibleProps } from './SideNavCollapsible';
+export type { SideNavGroupProps } from './SideNavGroup';
 export { SideNav as default } from './SideNav';

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

@@ -1,8 +1,8 @@
 export * from './Stepper';
-export { type StepperFinalPanelProps } from './StepperFinalPanel';
-export { type StepperListProps } from './StepperList';
-export { type StepperNextButtonProps } from './StepperNextButton';
-export { type StepperPanelProps } from './StepperPanel';
-export { type StepperPrevButtonProps } from './StepperPrevButton';
-export { type StepperStepProps } from './StepperStep';
+export type { StepperFinalPanelProps } from './StepperFinalPanel';
+export type { StepperListProps } from './StepperList';
+export type { StepperNextButtonProps } from './StepperNextButton';
+export type { StepperPanelProps } from './StepperPanel';
+export type { StepperPrevButtonProps } from './StepperPrevButton';
+export type { StepperStepProps } from './StepperStep';
 export { Stepper as default } from './Stepper';

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

@@ -1,5 +1,5 @@
 export * from './Tab';
 export { Tab as default } from './Tab';
-export { type TabButtonProps } from './TabButton';
-export { type TabListProps } from './TabList';
-export { type TabPanelProps } from './TabPanel';
+export type { TabButtonProps } from './TabButton';
+export type { TabListProps } from './TabList';
+export type { TabPanelProps } from './TabPanel';

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

@@ -1,3 +1,3 @@
 export * from './TimeField';
 export { TimeField as default, type TimeFieldProps } from './TimeField';
-export { type TimeFieldChange } from './internal/types';
+export type { TimeFieldChange } from './internal/types';

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/index.d.ts

@@ -1,7 +1,7 @@
 export * from './Toolbar';
 export { Toolbar as default, type ToolbarProps } from './Toolbar';
-export { type ToolbarButtonProps } from './ToolbarButton';
-export { type ToolbarButtonToggleProps } from './ToolbarButtonToggle';
-export { type ToolbarButtonLinkProps } from './ToolbarButtonLink';
-export { type ToolbarSelectProps } from './ToolbarSelect';
-export { type ToolbarItemAppearance, type ToolbarOverflowTypes } from './types';
+export type { ToolbarButtonProps } from './ToolbarButton';
+export type { ToolbarButtonToggleProps } from './ToolbarButtonToggle';
+export type { ToolbarButtonLinkProps } from './ToolbarButtonLink';
+export type { ToolbarSelectProps } from './ToolbarSelect';
+export type { ToolbarItemAppearance, ToolbarOverflowTypes } from './types';

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/components/Tooltip/index.d.ts

@@ -1,4 +1,4 @@
 export * from './Tooltip';
-export { type TooltipContentProps } from './TooltipContent';
-export { type TooltipTriggerProps } from './TooltipTrigger';
+export type { TooltipContentProps } from './TooltipContent';
+export type { TooltipTriggerProps } from './TooltipTrigger';
 export { Tooltip as default } from './Tooltip';

package/dist/src/internal/components/Popover/index.d.ts

@@ -1,6 +1,6 @@
 export * from './Popover';
-export { type PopoverButtonProps } from './PopoverButton';
-export { type PopoverCloseProps } from './PopoverClose';
-export { type PopoverContentProps } from './PopoverContent';
-export { type PopoverTriggerProps } from './PopoverTrigger';
+export type { PopoverButtonProps } from './PopoverButton';
+export type { PopoverCloseProps } from './PopoverClose';
+export type { PopoverContentProps } from './PopoverContent';
+export type { PopoverTriggerProps } from './PopoverTrigger';
 export { Popover as default } from './Popover';

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/src/providers/ThemeProvider/index.d.ts

@@ -1,7 +1,7 @@
 export { ThemeProvider, type ThemeProviderProps, type CustomThemeType, } from './ThemeProvider';
-export { 
+export type { 
 /**
  * @deprecated internal context type
  */
-type ThemeProviderContextProps, } from './internal/ThemeProviderContext';
+ThemeProviderContextProps, } from './internal/ThemeProviderContext';
 export { useTheme } from './useTheme';

package/dist/src/providers/TrackingProvider/index.d.ts

@@ -1,3 +1,3 @@
 export { TrackingProvider, TrackingProvider as default, } from './TrackingProvider';
-export { type TrackingProviderProps, type TrackingProviderContextProps, } from './TrackingProviderContext';
+export type { TrackingProviderProps, TrackingProviderContextProps, } from './TrackingProviderContext';
 export { useTrackingContext } from './useTrackingContext';

package/dist/src/types/index.d.ts

@@ -1,6 +1,6 @@
-export { type DataTrackingId } from './DataTrackingId';
-export { type DistributiveOmit } from './DistributiveOmit';
-export { type MaxLengthCounterProps } from './MaxLengthCounterProps';
+export type { DataTrackingId } from './DataTrackingId';
+export type { DistributiveOmit } from './DistributiveOmit';
+export type { MaxLengthCounterProps } from './MaxLengthCounterProps';
 export * from './ai-marks';
 export * from './ianaZones';
 export * from './locales';

package/dist/{stripInlineMarkdown-BZzgG-Zm.js → stripInlineMarkdown-BfNNOWPk.js}

@@ -1,4 +1,4 @@
-import { I as INLINE_MARKDOWN_REGEX } from './FieldLabel-Cm5A1Jcx.js';
+import { I as INLINE_MARKDOWN_REGEX } from './FieldLabel-SzH61hCb.js';
 
 const stripInlineMarkdown = (str) => {
   const parts = [];
@@ -22,4 +22,4 @@ const stripInlineMarkdown = (str) => {
 };
 
 export { stripInlineMarkdown as s };
-//# sourceMappingURL=stripInlineMarkdown-BZzgG-Zm.js.map
+//# sourceMappingURL=stripInlineMarkdown-BfNNOWPk.js.map

package/dist/{stripInlineMarkdown-BZzgG-Zm.js.map → stripInlineMarkdown-BfNNOWPk.js.map}

@@ -1 +1 @@
-{"version":3,"file":"stripInlineMarkdown-BZzgG-Zm.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-BfNNOWPk.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;;;;"}

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

@@ -1,16 +1,17 @@
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 import { S as Spinner } from './Spinner-B7tTWcP6.js';
-import { B as Button } from './Button-BNzCI47m.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-mDcQHC2U.js';
+import { T as Text } from './Text-CIoD_RK4.js';
 import { D as Divider } from './Divider-C7fp5Xb6.js';
 import { u as useMergeRefs } from './useMergeRefs-Dfmtq9cI.js';
 import { S as SrOnly } from './SrOnly-pnf8ajnh.js';
-import { I as Icon } from './Icon-B4uCvMU9.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-AvsDkChF.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-BVclVovw.js.map
+//# sourceMappingURL=syncFilterUtils-YB6gRuuR.js.map