gantri-components 2.252.2 → 2.253.1

package/dist/components/aspect-ratio/aspect-ratio.types.d.ts

@@ -7,5 +7,13 @@ export interface AspectRatioProps extends BaseProps {
     backgroundColor?: ResolutionAwareProp<Color>;
     height?: ResolutionAwareProp<Property.Height>;
     hidden?: ResolutionAwareProp<boolean>;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     width?: ResolutionAwareProp<Property.Width>;
 }

package/dist/components/badge/badge.types.d.ts

@@ -16,6 +16,15 @@ export interface BadgeProps {
     semanticColor?: BadgeSemanticColor;
     size?: BadgeSize;
     style?: CSSProperties;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-name`, `data-tx`, `data-label`, etc.)
+     * are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     text?: string;
     textColor?: PaletteColor;
     tx?: string;

package/dist/components/banner/banner.types.d.ts

@@ -22,6 +22,15 @@ export interface BannerProps {
     closeable?: boolean;
     /** Callback when the close button is clicked. */
     onClose?: () => void;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-name`, `data-tx`, `data-label`, etc.)
+     * are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
 }
 export interface StyledBannerProps {
     $variant: BannerVariant;

package/dist/components/box/box.types.d.ts

@@ -51,6 +51,14 @@ export interface BoxProps extends BaseProps, ElementSpacingProps {
     minHeight?: ResolutionAwareProp<Property.MinHeight>;
     minWidth?: ResolutionAwareProp<string>;
     overflow?: Property.Overflow;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     textAlign?: ResolutionAwareProp<string>;
     width?: ResolutionAwareProp<string>;
 }

package/dist/components/breadcrumbs/breadcrumbs.types.d.ts

@@ -3,4 +3,13 @@ export interface BreadcrumbsProps {
     'aria-label'?: string;
     gap?: Property.Gap;
     separator?: string;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-name`, `data-tx`, `data-label`, etc.)
+     * are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
 }

package/dist/components/button/button.types.d.ts

@@ -32,6 +32,23 @@ export interface ButtonProps extends Pick<BaseProps, Exclude<keyof BaseProps, 'c
      */
     rounded?: boolean;
     size?: ResolutionAwareProp<ButtonSize>;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-name`, `data-tx`, `data-label`, etc.)
+     * are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
+    /**
+     * @internal Library use only. Lets a parent gantri-components component
+     * override the auto-emitted `data-component="button"` with a more
+     * specific name (e.g., `confirmation-modal-confirm`, `button-menu-trigger`,
+     * `carousel-arrow-prev`). Not a public API — consumers should not pass
+     * this directly.
+     */
+    _dataComponentName?: string;
     text?: string;
     textLineHeight?: Property.LineHeight;
     textVariant?: TextVariant;

package/dist/components/button-menu/button-menu.types.d.ts

@@ -22,5 +22,14 @@ export interface ButtonMenuProps<T extends Record<string, unknown>> extends Drop
     onClose?: () => void;
     onOpen?: () => void;
     position?: OverlayPosition;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-name`, `data-tx`, `data-label`, etc.)
+     * are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     triggerEvent?: 'click' | 'hover' | 'manual';
 }

package/dist/components/carousel/carousel.types.d.ts

@@ -20,6 +20,15 @@ export interface CarouselProps {
     style?: CSSProperties;
     swipeThreshold?: number;
     swipeable?: boolean;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-items-per-page`, etc.) are usually
+     * sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     transitionDuration?: number;
     transitionEasing?: string;
 }

package/dist/components/cell/cell.types.d.ts

@@ -38,6 +38,14 @@ export interface CellProps extends BaseProps {
     row?: ResolutionAwareProp<any>;
     rowGap?: ResolutionAwareProp<string>;
     style?: CSSProperties;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     textAlign?: ResolutionAwareProp<Property.TextAlign>;
     verticalMargin?: ResolutionAwareProp<BoxDimension>;
     verticalPadding?: ResolutionAwareProp<BoxDimension>;

package/dist/components/checkbox/checkbox.types.d.ts

@@ -35,6 +35,15 @@ export interface CheckboxProps<T = boolean> {
     onClick?: MouseEventHandler<HTMLDivElement>;
     onFocus?: (event: FocusEvent<HTMLInputElement | HTMLTextAreaElement>) => void;
     onSelected?: (value: T) => void;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-name`, `data-tx`, `data-label`, etc.)
+     * are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     variant?: CheckboxVariant;
 }
 export interface LabelContentProps extends Pick<CheckboxProps, 'labelText' | 'labelTx' | 'labelTxComponents' | 'labelVariant' | 'labelColor' | 'Component' | 'labelHtmlText'> {

package/dist/components/checkbox-list/checkbox-list.types.d.ts

@@ -14,6 +14,15 @@ export interface CheckboxListProps<Value extends string | Record<any, any>> exte
     };
     items: (Value extends string ? Value : CheckboxItem<Value>)[];
     onValueChange: OnCheckboxListValueChange<Value>;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-name`, `data-tx`, `data-label`, etc.)
+     * are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     values: string[];
 }
 export interface CheckboxListDefaultProps<Value extends string | Record<any, any>> {

package/dist/components/circular-progress/circular-progress.types.d.ts

@@ -2,4 +2,13 @@ import { Property } from 'csstype';
 export type CircularProgressBaseSize = 'small' | 'medium' | 'large';
 export interface CircularProgressProps {
     size?: CircularProgressBaseSize | Property.Height;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-name`, `data-tx`, `data-label`, etc.)
+     * are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
 }

package/dist/components/color-picker/color-picker.types.d.ts

@@ -11,6 +11,15 @@ export interface ColorPickerProps extends Partial<ColorPickerDefaultProps> {
     onChange?: (event: ColorPickerChangeEvent) => void;
     onValueChange?: (selected: ColorDetails | ColorDetails[] | null) => void;
     readOnly?: boolean;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-name`, `data-tx`, `data-label`, etc.)
+     * are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     value?: string | string[];
 }
 export interface ColorPickerDefaultProps {

package/dist/components/confirmation-modal/confirmation-modal.types.d.ts

@@ -13,4 +13,12 @@ export interface ConfirmationModalProps extends Partial<ModalProps> {
     headerTx?: string;
     onCancel?: () => void;
     onConfirm: () => void;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
 }

package/dist/components/dropdown/dropdown.types.d.ts

@@ -43,6 +43,15 @@ export interface DropdownProps<T extends Record<any, any>> extends Omit<Dropdown
     resetSelectionOnDisabled?: boolean;
     size?: ResolutionAwareProp<TextFieldSize>;
     style?: CSSProperties;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-name`, `data-tx`, `data-label`, etc.)
+     * are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     variant?: TextFieldVariant;
     zIndex?: number;
 }

package/dist/components/dropdown-menu/dropdown-menu.types.d.ts

@@ -32,6 +32,15 @@ export interface DropdownMenuProps<T extends DynamicListItem<Record<any, any>>>
     searchable?: boolean;
     /** Optionally provide to highlight multiple items as selected. */
     selectedItems?: DynamicListItem<T>[];
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-id`, `data-label`, etc.) are usually
+     * sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     value?: string | number;
     width?: Property.Width<string | number>;
 }

package/dist/components/file-uploader/file-uploader.types.d.ts

@@ -37,6 +37,15 @@ export type FileUploaderProps = {
     /** Used to show loading indicator for `'thumbnail'` variant. For the `'button'` variant, it can be passed here or as part of `buttonProps`. */
     processing: boolean;
     purifyFileName?: boolean;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-name`, `data-tx`, `data-label`, etc.)
+     * are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     transformThumbnailSrc?: TransformThumbnailSrc;
     /** If invalid, return the error message to display. */
     validateFile?: ValidateFile;

package/dist/components/filter-button/filter-button.types.d.ts

@@ -23,5 +23,14 @@ export interface FilterButtonProps {
     resetButtonText?: string;
     resetButtonTx?: string;
     size?: ResolutionAwareProp<ButtonSize>;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-name`, `data-tx`, `data-label`, etc.)
+     * are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     variant?: 'primary' | 'secondary';
 }

package/dist/components/icon/icon.types.d.ts

@@ -13,6 +13,15 @@ export interface IconProps extends SVGProps<any> {
     opacity?: number;
     right?: Property.Right;
     size?: ResolutionAwareProp<Property.Height<string>>;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-name`, `data-tx`, `data-label`, etc.)
+     * are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     top?: Property.Top;
     width?: ResolutionAwareProp<Property.Width<string | any>>;
 }

package/dist/components/image/image.types.d.ts

@@ -42,6 +42,14 @@ export interface ImageProps {
     source?: Optional<ImageSource>;
     src: ResolutionAwareProp<string>;
     style?: CSSProperties;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     transformations?: Optional<ResolutionAwareProp<Transformations>>;
     transformationsVariant?: Optional<ImageTransformationsVariant>;
     /**

package/dist/components/label/label.types.d.ts

@@ -18,4 +18,15 @@ export interface LabelProps {
     required?: boolean;
     /** Whether to show the "(Optional)" suffix. Defaults to false. */
     showOptional?: boolean;
+    /** The `for` attribute target (HTML `for`). */
+    htmlFor?: string;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-name`, `data-tx`, `data-label`, etc.)
+     * are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
 }

package/dist/components/line/line.types.d.ts

@@ -4,4 +4,13 @@ import { MarginProps } from '../box/box.types';
 export interface LineProps extends MarginProps {
     color?: keyof DefaultTheme['colors']['dividers'];
     height?: Property.Height;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-name`, `data-tx`, `data-label`, etc.)
+     * are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
 }

package/dist/components/linear-progress/linear-progress.types.d.ts

@@ -10,6 +10,15 @@ export interface LinearProgressProps {
     progressStrokeColor?: Property.BackgroundColor;
     progressStrokeSize?: Property.Width;
     showText?: boolean;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-name`, `data-tx`, `data-label`, etc.)
+     * are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     textColor?: TypographyProps['color'];
     total: number;
     transition?: Property.Transition;

package/dist/components/max-width/max-width.types.d.ts

@@ -8,4 +8,12 @@ export interface MaxWidthProps {
     backgroundColor?: ResolutionAwareProp<Color>;
     borderBottom?: Divider;
     borderTop?: Divider;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
 }

package/dist/components/modal/modal.types.d.ts

@@ -20,6 +20,13 @@ export type ModalSurface = 'solid' | 'dynamic';
  */
 export type ModalFooterLayout = 'auto' | 'fullWidth';
 export interface ModalProps {
+    /**
+     * Internal: lets compound components (e.g. `ConfirmationModal`) override
+     * the `data-component` value emitted on the modal root so end-to-end
+     * tests can target them by their wrapper name. Defaults to `'modal'`.
+     * Not part of the public API.
+     */
+    _dataComponentName?: string;
     bodyStyle?: CSSProperties;
     closeable?: boolean;
     /** Allows passing/overriding props on the inner-most content wrapper. */
@@ -59,6 +66,14 @@ export interface ModalProps {
      *   On classic themes this falls back to the solid look.
      */
     surface?: ModalSurface;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     /** Ignored if `isFullScreen` is `true`. */
     top?: ResolutionAwareProp<Property.Top>;
     width?: ResolutionAwareProp<Property.Width>;

package/dist/components/multi-select-list/multi-select-list.types.d.ts

@@ -5,6 +5,15 @@ export interface MultiSelectListProps<Item extends Record<any, any>> extends Par
     /** Overrides the default item removal behavior. */
     onRemove?: (itemToRemove: Item) => void;
     setItems: (newItems: Item[]) => void;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-name`, `data-tx`, `data-label`, etc.)
+     * are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
 }
 export interface MultiSelectListDefaultProps<Item extends Record<any, any>> {
     clearButtonText?: string;

package/dist/components/option-selector/option-selector.types.d.ts

@@ -69,6 +69,15 @@ interface OptionSelectorBaseProps {
      * always on and this prop is ignored. Defaults to true.
      */
     allowDeselect?: boolean;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-name`, `data-tx`, `data-label`, etc.)
+     * are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
 }
 interface OptionSelectorSingleProps extends OptionSelectorBaseProps {
     /** Single-selection mode (default). */

package/dist/components/overlay/overlay.types.d.ts

@@ -30,6 +30,14 @@ export interface OverlayProps {
     prerenderContent?: boolean;
     renderInPortal?: boolean;
     showBackdropOnManualMode?: boolean;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     triggerEvent?: OverlayTriggerEvent;
     /** Overrides the default automatically calculated z-index. */
     zIndex?: number;

package/dist/components/picture/picture.types.d.ts

@@ -95,6 +95,14 @@ export interface PictureProps extends PicturePassThroughProps {
     onClick?: () => void;
     onLoad?: ReactEventHandler<HTMLImageElement>;
     onError?: ReactEventHandler<HTMLImageElement>;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
 }
 export interface StyledPictureContainerProps {
     $aspectRatio?: PictureProps['aspectRatio'];

package/dist/components/pills/components/pill/pill.types.d.ts

@@ -5,6 +5,15 @@ export interface PillProps<Value extends string | number> {
     icon?: JSX.Element;
     onSelected?: (value: Value) => void;
     selected?: boolean;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-tx`, `data-text`, etc.) are usually
+     * sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     text?: string;
     tx?: string;
     txValues?: Record<string, unknown>;

package/dist/components/pills/pills.types.d.ts

@@ -10,6 +10,15 @@ export interface PillsProps<Value extends string | number> extends Partial<Omit<
     onChange?: (event: PillsChangeEvent) => void;
     onFocus?: (event: FocusChangeEvent) => void;
     onSelect?: (value: Value) => void;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-name`, `data-tx`, `data-label`, etc.)
+     * are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     value?: Value;
 }
 export interface PillsChangeEvent<T = string | number> extends Pick<ChangeEvent<HTMLInputElement>, Exclude<keyof ChangeEvent<HTMLInputElement>, 'target'>> {

package/dist/components/quantity/quantity.types.d.ts

@@ -13,5 +13,14 @@ export interface QuantityProps {
     onDecrement?: (value: number) => void;
     onIncrement?: (value: number) => void;
     onValueChange?: (value: number) => void;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-name`, `data-tx`, `data-label`, etc.)
+     * are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     value: number;
 }

package/dist/components/radio/radio.types.d.ts

@@ -17,6 +17,15 @@ export interface RadioProps {
     onChange?: (event: any) => void;
     onSelected?: (value: any) => void;
     showAsTile?: boolean;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-name`, `data-tx`, `data-label`, etc.)
+     * are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     value?: any;
     variant?: RadioVariant;
 }

package/dist/components/radio-list/radio-list.types.d.ts

@@ -15,6 +15,15 @@ export interface RadioListProps<Value extends string> extends Partial<RadioListD
     items: (Value | RadioItem)[];
     onSelected: (value: Value) => void | Promise<void>;
     showAsTiles?: boolean;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-name`, `data-tx`, `data-label`, etc.)
+     * are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     value: Value;
 }
 export interface RadioListDefaultProps<Value extends string | Record<any, any>> {

package/dist/components/slider/slider.types.d.ts

@@ -10,6 +10,15 @@ export interface SliderProps {
     onValueChange?: (value: number) => void;
     step?: number;
     stepsVisible?: boolean;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-name`, `data-tx`, `data-label`, etc.)
+     * are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     value?: number;
     width?: Property.Width<string | number>;
 }

package/dist/components/table/table.types.d.ts

@@ -70,6 +70,14 @@ export interface TableProps<TData extends RowData> extends Partial<TableDefaultP
     search?: Omit<SearchProps, 'columns'>;
     sorting?: SortProps;
     syncState?: SyncState;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
 }
 export interface TableDefaultProps {
     stickyFirstColumn: boolean;

package/dist/components/tabs/tabs.types.d.ts

@@ -1,3 +1,12 @@
 export interface TabsProps {
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-value`, etc.) are usually sufficient.
+     * See `helpers/data-component`.
+     */
+    testId?: string;
     value: string | number;
 }

package/dist/components/text-field/text-field.types.d.ts

@@ -91,6 +91,15 @@ export interface TextFieldProps {
      * back to theme-based behavior.
      */
     surface?: TextFieldSurface;
+    /**
+     * Escape hatch for end-to-end tests when no other prop distinguishes two
+     * sibling instances. When provided, the root receives
+     * `data-testid={testId}` in addition to the auto-emitted `data-component`
+     * and projected `data-*` attributes. Rarely needed — the auto-emitted
+     * attributes (`data-component`, `data-name`, `data-tx`, `data-label`, etc.)
+     * are usually sufficient. See `helpers/data-component`.
+     */
+    testId?: string;
     throttle?: number;
     type?: HTMLInputTypeAttribute | undefined;
     value?: string;