@octavius2929-personal/design-system 0.12.0 → 0.14.0

package/dist/index.d.cts

@@ -814,10 +814,12 @@ type Sprinkles = Parameters<typeof sprinkles>[0];
 
 type ContainerOwnProps<E extends ElementType> = Sprinkles & {
     as?: E;
+    /** Segmento de contexto para el data-testid. */
+    testId?: string;
 };
 type ContainerProps<E extends ElementType = "div"> = ContainerOwnProps<E> & Omit<ComponentPropsWithoutRef<E>, "className" | "style" | "color" | keyof ContainerOwnProps<E>>;
 
-declare function ContainerImpl<E extends ElementType = "div">({ as, ...props }: ContainerProps<E>, ref: Ref<Element>): react.JSX.Element;
+declare function ContainerImpl<E extends ElementType = "div">({ as, testId, ...props }: ContainerProps<E>, ref: Ref<Element>): react.JSX.Element;
 declare const Container: <E extends ElementType = "div">(props: ContainerProps<E> & {
     ref?: Ref<Element>;
 }) => ReturnType<typeof ContainerImpl>;
@@ -830,10 +832,12 @@ type TypographyOwnProps<E extends ElementType> = {
     as?: E;
     color?: TypographyColor;
     align?: TypographyAlign;
+    /** Segmento de contexto para el data-testid. */
+    testId?: string;
 };
 type TypographyProps<E extends ElementType = "span"> = TypographyOwnProps<E> & Omit<ComponentPropsWithoutRef<E>, "className" | "style" | "color" | keyof TypographyOwnProps<E>>;
 
-declare function TypographyInner<E extends ElementType = "span">({ variant, as, color, align, ...rest }: TypographyProps<E>, ref: Ref<HTMLElement>): react.JSX.Element;
+declare function TypographyInner<E extends ElementType = "span">({ variant, as, color, align, testId, ...rest }: TypographyProps<E>, ref: Ref<HTMLElement>): react.JSX.Element;
 declare const Typography: <E extends ElementType = "span">(props: TypographyProps<E> & {
     ref?: Ref<HTMLElement>;
 }) => ReturnType<typeof TypographyInner>;
@@ -856,6 +860,8 @@ interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
     startIcon?: Icon;
     endIcon?: Icon;
     full?: boolean;
+    /** Segmento de contexto para el data-testid (no es un override del id completo). */
+    testId?: string;
 }
 
 declare const Button: react.ForwardRefExoticComponent<ButtonProps & react.RefAttributes<HTMLButtonElement>>;
@@ -863,6 +869,8 @@ declare const Button: react.ForwardRefExoticComponent<ButtonProps & react.RefAtt
 interface DividerProps extends Omit<HTMLAttributes<HTMLDivElement>, "className"> {
     vertical?: boolean;
     label?: ReactNode;
+    /** Segmento de contexto para el data-testid. */
+    testId?: string;
 }
 
 declare const Divider: react.ForwardRefExoticComponent<DividerProps & react.RefAttributes<HTMLDivElement>>;
@@ -871,6 +879,8 @@ type AvatarSize = "sm" | "md" | "lg";
 interface AvatarProps extends HTMLAttributes<HTMLSpanElement> {
     size?: AvatarSize;
     filled?: boolean;
+    /** Segmento de contexto para el data-testid. */
+    testId?: string;
 }
 
 declare const Avatar: react.ForwardRefExoticComponent<AvatarProps & react.RefAttributes<HTMLSpanElement>>;
@@ -879,6 +889,8 @@ type BadgeTone = "ink" | "accent";
 interface BadgeProps extends HTMLAttributes<HTMLSpanElement> {
     count?: number;
     tone?: BadgeTone;
+    /** Segmento de contexto para el data-testid. */
+    testId?: string;
 }
 
 declare const Badge: react.ForwardRefExoticComponent<BadgeProps & react.RefAttributes<HTMLSpanElement>>;
@@ -888,6 +900,8 @@ interface ProgressProps extends HTMLAttributes<HTMLDivElement> {
     variant?: ProgressVariant;
     value?: number;
     size?: number;
+    /** Segmento de contexto para el data-testid. */
+    testId?: string;
 }
 
 declare const Progress: react.ForwardRefExoticComponent<ProgressProps & react.RefAttributes<HTMLElement>>;
@@ -897,6 +911,8 @@ interface ChipProps extends Omit<HTMLAttributes<HTMLSpanElement>, "className"> {
     selected?: boolean;
     tone?: ChipTone;
     onDelete?: () => void;
+    /** Segmento de contexto para el data-testid. */
+    testId?: string;
 }
 
 declare const Chip: react.ForwardRefExoticComponent<ChipProps & react.RefAttributes<HTMLSpanElement>>;
@@ -907,6 +923,8 @@ interface CheckboxProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "onC
     label?: ReactNode;
     disabled?: boolean;
     id?: string;
+    /** Segmento de contexto para el data-testid. */
+    testId?: string;
 }
 
 declare const Checkbox: react.ForwardRefExoticComponent<CheckboxProps & react.RefAttributes<HTMLInputElement>>;
@@ -918,6 +936,8 @@ interface RadioProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "onChan
     name?: string;
     value?: string;
     disabled?: boolean;
+    /** Segmento de contexto para el data-testid. */
+    testId?: string;
 }
 
 declare const Radio: react.ForwardRefExoticComponent<RadioProps & react.RefAttributes<HTMLInputElement>>;
@@ -927,6 +947,8 @@ interface SwitchProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "onCha
     onChange?: (checked: boolean) => void;
     label?: ReactNode;
     disabled?: boolean;
+    /** Segmento de contexto para el data-testid. */
+    testId?: string;
 }
 
 declare const Switch: react.ForwardRefExoticComponent<SwitchProps & react.RefAttributes<HTMLInputElement>>;
@@ -940,6 +962,8 @@ interface TextFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "on
     multiline?: boolean;
     rows?: number;
     onChange?: (value: string) => void;
+    /** Segmento de contexto para el data-testid. */
+    testId?: string;
 }
 
 declare const TextField: react.ForwardRefExoticComponent<TextFieldProps & react.RefAttributes<HTMLInputElement>>;
@@ -979,12 +1003,17 @@ interface IconButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>,
     active?: boolean;
     tone?: IconButtonTone;
     title: string;
+    /** Segmento de contexto para el data-testid. */
+    testId?: string;
 }
 
 declare const IconButton: react.ForwardRefExoticComponent<IconButtonProps & react.RefAttributes<HTMLButtonElement>>;
 
 type DivProps = Omit<HTMLAttributes<HTMLDivElement>, "className">;
-type CardProps = DivProps;
+interface CardProps extends DivProps {
+    /** testId de la instancia (segmento hoja); compone con el contexto de TestIdProvider. */
+    testId?: string;
+}
 type CardSectionProps = DivProps;
 
 declare function CardHeader({ children, ...rest }: CardSectionProps): react.JSX.Element;
@@ -999,273 +1028,7 @@ declare function CardFooter({ children, ...rest }: CardSectionProps): react.JSX.
 declare namespace CardFooter {
     var displayName: string;
 }
-declare const Card: react.ForwardRefExoticComponent<{
-    color?: string | undefined | undefined;
-    content?: string | undefined | undefined;
-    translate?: "yes" | "no" | undefined | undefined;
-    hidden?: boolean | undefined | undefined;
-    style?: react.CSSProperties | undefined;
-    slot?: string | undefined | undefined;
-    title?: string | undefined | undefined;
-    defaultChecked?: boolean | undefined | undefined;
-    defaultValue?: string | number | readonly string[] | undefined;
-    suppressContentEditableWarning?: boolean | undefined | undefined;
-    suppressHydrationWarning?: boolean | undefined | undefined;
-    accessKey?: string | undefined | undefined;
-    autoCapitalize?: "off" | "none" | "on" | "sentences" | "words" | "characters" | undefined | (string & {}) | undefined;
-    autoFocus?: boolean | undefined | undefined;
-    contentEditable?: "inherit" | (boolean | "false" | "true") | "plaintext-only" | undefined;
-    contextMenu?: string | undefined | undefined;
-    dir?: string | undefined | undefined;
-    draggable?: (boolean | "false" | "true") | undefined;
-    enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined | undefined;
-    id?: string | undefined | undefined;
-    lang?: string | undefined | undefined;
-    nonce?: string | undefined | undefined;
-    spellCheck?: (boolean | "false" | "true") | undefined;
-    tabIndex?: number | undefined | undefined;
-    radioGroup?: string | undefined | undefined;
-    role?: react.AriaRole | undefined;
-    about?: string | undefined | undefined;
-    datatype?: string | undefined | undefined;
-    inlist?: any;
-    prefix?: string | undefined | undefined;
-    property?: string | undefined | undefined;
-    rel?: string | undefined | undefined;
-    resource?: string | undefined | undefined;
-    rev?: string | undefined | undefined;
-    typeof?: string | undefined | undefined;
-    vocab?: string | undefined | undefined;
-    autoCorrect?: string | undefined | undefined;
-    autoSave?: string | undefined | undefined;
-    itemProp?: string | undefined | undefined;
-    itemScope?: boolean | undefined | undefined;
-    itemType?: string | undefined | undefined;
-    itemID?: string | undefined | undefined;
-    itemRef?: string | undefined | undefined;
-    results?: number | undefined | undefined;
-    security?: string | undefined | undefined;
-    unselectable?: "on" | "off" | undefined | undefined;
-    inputMode?: "none" | "text" | "tel" | "url" | "email" | "numeric" | "decimal" | "search" | undefined | undefined;
-    is?: string | undefined | undefined;
-    exportparts?: string | undefined | undefined;
-    part?: string | undefined | undefined;
-    "aria-activedescendant"?: string | undefined | undefined;
-    "aria-atomic"?: (boolean | "false" | "true") | undefined;
-    "aria-autocomplete"?: "none" | "inline" | "list" | "both" | undefined | undefined;
-    "aria-braillelabel"?: string | undefined | undefined;
-    "aria-brailleroledescription"?: string | undefined | undefined;
-    "aria-busy"?: (boolean | "false" | "true") | undefined;
-    "aria-checked"?: boolean | "false" | "mixed" | "true" | undefined | undefined;
-    "aria-colcount"?: number | undefined | undefined;
-    "aria-colindex"?: number | undefined | undefined;
-    "aria-colindextext"?: string | undefined | undefined;
-    "aria-colspan"?: number | undefined | undefined;
-    "aria-controls"?: string | undefined | undefined;
-    "aria-current"?: boolean | "false" | "true" | "page" | "step" | "location" | "date" | "time" | undefined | undefined;
-    "aria-describedby"?: string | undefined | undefined;
-    "aria-description"?: string | undefined | undefined;
-    "aria-details"?: string | undefined | undefined;
-    "aria-disabled"?: (boolean | "false" | "true") | undefined;
-    "aria-dropeffect"?: "none" | "copy" | "execute" | "link" | "move" | "popup" | undefined | undefined;
-    "aria-errormessage"?: string | undefined | undefined;
-    "aria-expanded"?: (boolean | "false" | "true") | undefined;
-    "aria-flowto"?: string | undefined | undefined;
-    "aria-grabbed"?: (boolean | "false" | "true") | undefined;
-    "aria-haspopup"?: boolean | "false" | "true" | "menu" | "listbox" | "tree" | "grid" | "dialog" | undefined | undefined;
-    "aria-hidden"?: (boolean | "false" | "true") | undefined;
-    "aria-invalid"?: boolean | "false" | "true" | "grammar" | "spelling" | undefined | undefined;
-    "aria-keyshortcuts"?: string | undefined | undefined;
-    "aria-label"?: string | undefined | undefined;
-    "aria-labelledby"?: string | undefined | undefined;
-    "aria-level"?: number | undefined | undefined;
-    "aria-live"?: "off" | "assertive" | "polite" | undefined | undefined;
-    "aria-modal"?: (boolean | "false" | "true") | undefined;
-    "aria-multiline"?: (boolean | "false" | "true") | undefined;
-    "aria-multiselectable"?: (boolean | "false" | "true") | undefined;
-    "aria-orientation"?: "horizontal" | "vertical" | undefined | undefined;
-    "aria-owns"?: string | undefined | undefined;
-    "aria-placeholder"?: string | undefined | undefined;
-    "aria-posinset"?: number | undefined | undefined;
-    "aria-pressed"?: boolean | "false" | "mixed" | "true" | undefined | undefined;
-    "aria-readonly"?: (boolean | "false" | "true") | undefined;
-    "aria-relevant"?: "additions" | "additions removals" | "additions text" | "all" | "removals" | "removals additions" | "removals text" | "text" | "text additions" | "text removals" | undefined | undefined;
-    "aria-required"?: (boolean | "false" | "true") | undefined;
-    "aria-roledescription"?: string | undefined | undefined;
-    "aria-rowcount"?: number | undefined | undefined;
-    "aria-rowindex"?: number | undefined | undefined;
-    "aria-rowindextext"?: string | undefined | undefined;
-    "aria-rowspan"?: number | undefined | undefined;
-    "aria-selected"?: (boolean | "false" | "true") | undefined;
-    "aria-setsize"?: number | undefined | undefined;
-    "aria-sort"?: "none" | "ascending" | "descending" | "other" | undefined | undefined;
-    "aria-valuemax"?: number | undefined | undefined;
-    "aria-valuemin"?: number | undefined | undefined;
-    "aria-valuenow"?: number | undefined | undefined;
-    "aria-valuetext"?: string | undefined | undefined;
-    children?: react.ReactNode;
-    dangerouslySetInnerHTML?: {
-        __html: string | TrustedHTML;
-    } | undefined | undefined;
-    onCopy?: react.ClipboardEventHandler<HTMLDivElement> | undefined;
-    onCopyCapture?: react.ClipboardEventHandler<HTMLDivElement> | undefined;
-    onCut?: react.ClipboardEventHandler<HTMLDivElement> | undefined;
-    onCutCapture?: react.ClipboardEventHandler<HTMLDivElement> | undefined;
-    onPaste?: react.ClipboardEventHandler<HTMLDivElement> | undefined;
-    onPasteCapture?: react.ClipboardEventHandler<HTMLDivElement> | undefined;
-    onCompositionEnd?: react.CompositionEventHandler<HTMLDivElement> | undefined;
-    onCompositionEndCapture?: react.CompositionEventHandler<HTMLDivElement> | undefined;
-    onCompositionStart?: react.CompositionEventHandler<HTMLDivElement> | undefined;
-    onCompositionStartCapture?: react.CompositionEventHandler<HTMLDivElement> | undefined;
-    onCompositionUpdate?: react.CompositionEventHandler<HTMLDivElement> | undefined;
-    onCompositionUpdateCapture?: react.CompositionEventHandler<HTMLDivElement> | undefined;
-    onFocus?: react.FocusEventHandler<HTMLDivElement> | undefined;
-    onFocusCapture?: react.FocusEventHandler<HTMLDivElement> | undefined;
-    onBlur?: react.FocusEventHandler<HTMLDivElement> | undefined;
-    onBlurCapture?: react.FocusEventHandler<HTMLDivElement> | undefined;
-    onChange?: react.FormEventHandler<HTMLDivElement> | undefined;
-    onChangeCapture?: react.FormEventHandler<HTMLDivElement> | undefined;
-    onBeforeInput?: react.InputEventHandler<HTMLDivElement> | undefined;
-    onBeforeInputCapture?: react.FormEventHandler<HTMLDivElement> | undefined;
-    onInput?: react.FormEventHandler<HTMLDivElement> | undefined;
-    onInputCapture?: react.FormEventHandler<HTMLDivElement> | undefined;
-    onReset?: react.FormEventHandler<HTMLDivElement> | undefined;
-    onResetCapture?: react.FormEventHandler<HTMLDivElement> | undefined;
-    onSubmit?: react.FormEventHandler<HTMLDivElement> | undefined;
-    onSubmitCapture?: react.FormEventHandler<HTMLDivElement> | undefined;
-    onInvalid?: react.FormEventHandler<HTMLDivElement> | undefined;
-    onInvalidCapture?: react.FormEventHandler<HTMLDivElement> | undefined;
-    onLoad?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onLoadCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onError?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onErrorCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onKeyDown?: react.KeyboardEventHandler<HTMLDivElement> | undefined;
-    onKeyDownCapture?: react.KeyboardEventHandler<HTMLDivElement> | undefined;
-    onKeyPress?: react.KeyboardEventHandler<HTMLDivElement> | undefined;
-    onKeyPressCapture?: react.KeyboardEventHandler<HTMLDivElement> | undefined;
-    onKeyUp?: react.KeyboardEventHandler<HTMLDivElement> | undefined;
-    onKeyUpCapture?: react.KeyboardEventHandler<HTMLDivElement> | undefined;
-    onAbort?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onAbortCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onCanPlay?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onCanPlayCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onCanPlayThrough?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onCanPlayThroughCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onDurationChange?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onDurationChangeCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onEmptied?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onEmptiedCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onEncrypted?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onEncryptedCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onEnded?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onEndedCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onLoadedData?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onLoadedDataCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onLoadedMetadata?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onLoadedMetadataCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onLoadStart?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onLoadStartCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onPause?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onPauseCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onPlay?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onPlayCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onPlaying?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onPlayingCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onProgress?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onProgressCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onRateChange?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onRateChangeCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onSeeked?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onSeekedCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onSeeking?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onSeekingCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onStalled?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onStalledCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onSuspend?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onSuspendCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onTimeUpdate?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onTimeUpdateCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onVolumeChange?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onVolumeChangeCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onWaiting?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onWaitingCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onAuxClick?: react.MouseEventHandler<HTMLDivElement> | undefined;
-    onAuxClickCapture?: react.MouseEventHandler<HTMLDivElement> | undefined;
-    onClick?: react.MouseEventHandler<HTMLDivElement> | undefined;
-    onClickCapture?: react.MouseEventHandler<HTMLDivElement> | undefined;
-    onContextMenu?: react.MouseEventHandler<HTMLDivElement> | undefined;
-    onContextMenuCapture?: react.MouseEventHandler<HTMLDivElement> | undefined;
-    onDoubleClick?: react.MouseEventHandler<HTMLDivElement> | undefined;
-    onDoubleClickCapture?: react.MouseEventHandler<HTMLDivElement> | undefined;
-    onDrag?: react.DragEventHandler<HTMLDivElement> | undefined;
-    onDragCapture?: react.DragEventHandler<HTMLDivElement> | undefined;
-    onDragEnd?: react.DragEventHandler<HTMLDivElement> | undefined;
-    onDragEndCapture?: react.DragEventHandler<HTMLDivElement> | undefined;
-    onDragEnter?: react.DragEventHandler<HTMLDivElement> | undefined;
-    onDragEnterCapture?: react.DragEventHandler<HTMLDivElement> | undefined;
-    onDragExit?: react.DragEventHandler<HTMLDivElement> | undefined;
-    onDragExitCapture?: react.DragEventHandler<HTMLDivElement> | undefined;
-    onDragLeave?: react.DragEventHandler<HTMLDivElement> | undefined;
-    onDragLeaveCapture?: react.DragEventHandler<HTMLDivElement> | undefined;
-    onDragOver?: react.DragEventHandler<HTMLDivElement> | undefined;
-    onDragOverCapture?: react.DragEventHandler<HTMLDivElement> | undefined;
-    onDragStart?: react.DragEventHandler<HTMLDivElement> | undefined;
-    onDragStartCapture?: react.DragEventHandler<HTMLDivElement> | undefined;
-    onDrop?: react.DragEventHandler<HTMLDivElement> | undefined;
-    onDropCapture?: react.DragEventHandler<HTMLDivElement> | undefined;
-    onMouseDown?: react.MouseEventHandler<HTMLDivElement> | undefined;
-    onMouseDownCapture?: react.MouseEventHandler<HTMLDivElement> | undefined;
-    onMouseEnter?: react.MouseEventHandler<HTMLDivElement> | undefined;
-    onMouseLeave?: react.MouseEventHandler<HTMLDivElement> | undefined;
-    onMouseMove?: react.MouseEventHandler<HTMLDivElement> | undefined;
-    onMouseMoveCapture?: react.MouseEventHandler<HTMLDivElement> | undefined;
-    onMouseOut?: react.MouseEventHandler<HTMLDivElement> | undefined;
-    onMouseOutCapture?: react.MouseEventHandler<HTMLDivElement> | undefined;
-    onMouseOver?: react.MouseEventHandler<HTMLDivElement> | undefined;
-    onMouseOverCapture?: react.MouseEventHandler<HTMLDivElement> | undefined;
-    onMouseUp?: react.MouseEventHandler<HTMLDivElement> | undefined;
-    onMouseUpCapture?: react.MouseEventHandler<HTMLDivElement> | undefined;
-    onSelect?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onSelectCapture?: react.ReactEventHandler<HTMLDivElement> | undefined;
-    onTouchCancel?: react.TouchEventHandler<HTMLDivElement> | undefined;
-    onTouchCancelCapture?: react.TouchEventHandler<HTMLDivElement> | undefined;
-    onTouchEnd?: react.TouchEventHandler<HTMLDivElement> | undefined;
-    onTouchEndCapture?: react.TouchEventHandler<HTMLDivElement> | undefined;
-    onTouchMove?: react.TouchEventHandler<HTMLDivElement> | undefined;
-    onTouchMoveCapture?: react.TouchEventHandler<HTMLDivElement> | undefined;
-    onTouchStart?: react.TouchEventHandler<HTMLDivElement> | undefined;
-    onTouchStartCapture?: react.TouchEventHandler<HTMLDivElement> | undefined;
-    onPointerDown?: react.PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerDownCapture?: react.PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerMove?: react.PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerMoveCapture?: react.PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerUp?: react.PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerUpCapture?: react.PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerCancel?: react.PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerCancelCapture?: react.PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerEnter?: react.PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerLeave?: react.PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerOver?: react.PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerOverCapture?: react.PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerOut?: react.PointerEventHandler<HTMLDivElement> | undefined;
-    onPointerOutCapture?: react.PointerEventHandler<HTMLDivElement> | undefined;
-    onGotPointerCapture?: react.PointerEventHandler<HTMLDivElement> | undefined;
-    onGotPointerCaptureCapture?: react.PointerEventHandler<HTMLDivElement> | undefined;
-    onLostPointerCapture?: react.PointerEventHandler<HTMLDivElement> | undefined;
-    onLostPointerCaptureCapture?: react.PointerEventHandler<HTMLDivElement> | undefined;
-    onScroll?: react.UIEventHandler<HTMLDivElement> | undefined;
-    onScrollCapture?: react.UIEventHandler<HTMLDivElement> | undefined;
-    onWheel?: react.WheelEventHandler<HTMLDivElement> | undefined;
-    onWheelCapture?: react.WheelEventHandler<HTMLDivElement> | undefined;
-    onAnimationStart?: react.AnimationEventHandler<HTMLDivElement> | undefined;
-    onAnimationStartCapture?: react.AnimationEventHandler<HTMLDivElement> | undefined;
-    onAnimationEnd?: react.AnimationEventHandler<HTMLDivElement> | undefined;
-    onAnimationEndCapture?: react.AnimationEventHandler<HTMLDivElement> | undefined;
-    onAnimationIteration?: react.AnimationEventHandler<HTMLDivElement> | undefined;
-    onAnimationIterationCapture?: react.AnimationEventHandler<HTMLDivElement> | undefined;
-    onTransitionEnd?: react.TransitionEventHandler<HTMLDivElement> | undefined;
-    onTransitionEndCapture?: react.TransitionEventHandler<HTMLDivElement> | undefined;
-} & react.RefAttributes<HTMLDivElement>> & {
+declare const Card: react.ForwardRefExoticComponent<CardProps & react.RefAttributes<HTMLDivElement>> & {
     Header: typeof CardHeader;
     Body: typeof CardBody;
     Footer: typeof CardFooter;
@@ -1276,6 +1039,8 @@ interface AlertProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
     severity?: AlertSeverity;
     title?: ReactNode;
     icon?: Icon;
+    /** testId de la instancia: compone `feedback__<contexto>__<testId>`. */
+    testId?: string;
 }
 
 declare const Alert: react.ForwardRefExoticComponent<AlertProps & react.RefAttributes<HTMLDivElement>>;
@@ -1285,6 +1050,8 @@ interface TooltipProps {
     label: ReactNode;
     children: ReactElement;
     placement?: TooltipPlacement;
+    /** testId de la instancia: compone `feedback__<contexto>__<testId>`. */
+    testId?: string;
 }
 
 declare const Tooltip: react.ForwardRefExoticComponent<TooltipProps & react.RefAttributes<HTMLSpanElement>>;
@@ -1326,6 +1093,8 @@ interface AccordionProps {
     multiple?: boolean;
     defaultOpen?: string[];
     className?: string;
+    /** testId de la instancia (segmento hoja); compone con el contexto de TestIdProvider. */
+    testId?: string;
 }
 
 declare const Accordion: react.ForwardRefExoticComponent<AccordionProps & react.RefAttributes<HTMLDivElement>>;
@@ -1336,6 +1105,8 @@ interface Crumb {
 }
 interface BreadcrumbsProps extends HTMLAttributes<HTMLElement> {
     items: Crumb[];
+    /** testId de la instancia (segmento hoja); compone con el contexto de TestIdProvider. */
+    testId?: string;
 }
 
 declare const Breadcrumbs: react.ForwardRefExoticComponent<BreadcrumbsProps & react.RefAttributes<HTMLElement>>;
@@ -1345,6 +1116,8 @@ interface PaginationProps extends Omit<HTMLAttributes<HTMLElement>, "className"
     page?: number;
     onChange?: (page: number) => void;
     siblingCount?: number;
+    /** testId de la instancia (segmento hoja); compone con el contexto de TestIdProvider. */
+    testId?: string;
 }
 
 declare const Pagination: react.ForwardRefExoticComponent<PaginationProps & react.RefAttributes<HTMLElement>>;
@@ -1355,6 +1128,8 @@ interface Step {
 interface StepperProps extends HTMLAttributes<HTMLDivElement> {
     steps: Step[];
     active?: number;
+    /** testId de la instancia (segmento hoja); compone con el contexto de TestIdProvider. */
+    testId?: string;
 }
 
 declare const Stepper: react.ForwardRefExoticComponent<StepperProps & react.RefAttributes<HTMLDivElement>>;
@@ -1369,6 +1144,8 @@ interface TabsProps extends Omit<HTMLAttributes<HTMLDivElement>, "className" | "
     items: TabItem[];
     value?: string;
     onChange?: (value: string) => void;
+    /** testId de la instancia (segmento hoja); compone con el contexto de TestIdProvider. */
+    testId?: string;
 }
 
 declare const Tabs: react.ForwardRefExoticComponent<TabsProps & react.RefAttributes<HTMLDivElement>>;
@@ -1381,6 +1158,8 @@ interface MenuItemDef {
 interface MenuProps {
     trigger: ReactElement;
     items: MenuItemDef[];
+    /** Segmento de contexto para el data-testid. */
+    testId?: string;
 }
 
 declare const Menu: react.ForwardRefExoticComponent<MenuProps & react.RefAttributes<HTMLDivElement>>;
@@ -1391,6 +1170,8 @@ interface DialogProps {
     title?: ReactNode;
     actions?: ReactNode;
     children?: ReactNode;
+    /** Segmento de contexto para el data-testid. */
+    testId?: string;
 }
 
 declare const Dialog: react.ForwardRefExoticComponent<DialogProps & react.RefAttributes<HTMLDivElement>>;
@@ -1400,6 +1181,8 @@ interface SnackbarProps {
     message: ReactNode;
     action?: ReactNode;
     onClose?: () => void;
+    /** testId de la instancia: compone `feedback__<contexto>__<testId>`. */
+    testId?: string;
 }
 
 declare const Snackbar: react.ForwardRefExoticComponent<SnackbarProps & react.RefAttributes<HTMLDivElement>>;
@@ -1416,9 +1199,11 @@ interface TableProps<Row extends Record<string, unknown>> extends TableHTMLAttri
     getRowKey?: (row: Row, index: number) => string | number;
     /** Título accesible de la tabla (`<caption>`). Recomendado para lectores de pantalla. */
     caption?: ReactNode;
+    /** testId de la instancia: compone `list__<contexto>__<testId>`. */
+    testId?: string;
 }
 
-declare function TableInner<Row extends Record<string, unknown>>({ columns, rows, getRowKey, className, caption, ...rest }: TableProps<Row>, ref: Ref<HTMLTableElement>): react.JSX.Element;
+declare function TableInner<Row extends Record<string, unknown>>({ columns, rows, getRowKey, className, caption, testId, ...rest }: TableProps<Row>, ref: Ref<HTMLTableElement>): react.JSX.Element;
 declare const Table: <Row extends Record<string, unknown>>(props: TableProps<Row> & {
     ref?: Ref<HTMLTableElement>;
 }) => ReturnType<typeof TableInner>;
@@ -1426,6 +1211,8 @@ declare const Table: <Row extends Record<string, unknown>>(props: TableProps<Row
 interface AppBarProps extends HTMLAttributes<HTMLElement> {
     brand?: ReactNode;
     actions?: ReactNode;
+    /** testId de la instancia (segmento hoja); compone con el contexto de TestIdProvider. */
+    testId?: string;
 }
 
 declare const AppBar: react.ForwardRefExoticComponent<AppBarProps & react.RefAttributes<HTMLElement>>;
@@ -1434,6 +1221,8 @@ interface ListItemProps extends HTMLAttributes<HTMLDivElement> {
     leading?: ReactNode;
     trailing?: ReactNode;
     selected?: boolean;
+    /** testId de la instancia: compone `list__<contexto>__<testId>`. */
+    testId?: string;
 }
 
 declare const ListItem: react.ForwardRefExoticComponent<ListItemProps & react.RefAttributes<HTMLDivElement>>;
@@ -1499,4 +1288,19 @@ interface ThemeProviderProps {
 declare function ThemeProvider({ children, defaultSchema, defaultMode, storageKey, persist, }: ThemeProviderProps): react.JSX.Element;
 declare function useTheme(): ThemeContextValue;
 
-export { Accordion, type AccordionItem, type AccordionProps, Alert, type AlertProps, type AlertSeverity, AppBar, type AppBarProps, Avatar, type AvatarProps, type AvatarSize, Badge, type BadgeProps, type BadgeTone, Breadcrumbs, type BreadcrumbsProps, Button, type ButtonProps, type ButtonSize, type ButtonTone, type ButtonVariant, Card, type CardProps, type CardSectionProps, CheckIcon, Checkbox, type CheckboxProps, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, ChevronUpIcon, Chip, type ChipProps, type ChipTone, CircleCheckIcon, CircleXIcon, type ColorTokens, Container, type ContainerProps, type Crumb, Dialog, type DialogProps, Divider, type DividerProps, EyeIcon, EyeOffIcon, type Icon, IconButton, type IconButtonProps, type IconButtonTone, type IconProps, InfoIcon, ListItem, type ListItemProps, Menu, type MenuItemDef, type MenuProps, MinusIcon, type Mode, type ModePreference, MoneyField, type MoneyFieldProps, MoreHorizontalIcon, Pagination, type PaginationProps, PasswordField, type PasswordFieldProps, PlusIcon, Progress, type ProgressProps, type ProgressVariant, Radio, type RadioProps, type SchemaName, SearchIcon, Select, type SelectOption, type SelectProps, Slider, type SliderProps, Snackbar, type SnackbarProps, type Step, Stepper, type StepperProps, Switch, type SwitchProps, type TabItem, Table, type TableColumn, type TableProps, Tabs, type TabsProps, TextField, type TextFieldProps, ThemeProvider, type ThemeProviderProps, Tooltip, type TooltipPlacement, type TooltipProps, TriangleAlertIcon, Typography, type TypographyAlign, type TypographyColor, type TypographyProps, type TypographyVariant, XIcon, colorVars, modeNames, schemaNames, text, vars as theme, themes, usePrevious, useTheme, useToggle };
+interface TestIdProviderProps {
+    /** Segmento de contexto que este provider agrega a la cadena (ej. "checkout"). */
+    context: string;
+    children: ReactNode;
+}
+declare function TestIdProvider({ context, children }: TestIdProviderProps): react.JSX.Element;
+
+interface TestIdHandle {
+    /** data-testid del nodo root: `<tipo>__<...contexto>__<ownTestId>`. */
+    testId: string;
+    /** Deriva el id de un slot interno: `<testId>__<slot>`. */
+    slot: (name: string) => string;
+}
+declare function useTestId(type: string, ownTestId?: string): TestIdHandle;
+
+export { Accordion, type AccordionItem, type AccordionProps, Alert, type AlertProps, type AlertSeverity, AppBar, type AppBarProps, Avatar, type AvatarProps, type AvatarSize, Badge, type BadgeProps, type BadgeTone, Breadcrumbs, type BreadcrumbsProps, Button, type ButtonProps, type ButtonSize, type ButtonTone, type ButtonVariant, Card, type CardProps, type CardSectionProps, CheckIcon, Checkbox, type CheckboxProps, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, ChevronUpIcon, Chip, type ChipProps, type ChipTone, CircleCheckIcon, CircleXIcon, type ColorTokens, Container, type ContainerProps, type Crumb, Dialog, type DialogProps, Divider, type DividerProps, EyeIcon, EyeOffIcon, type Icon, IconButton, type IconButtonProps, type IconButtonTone, type IconProps, InfoIcon, ListItem, type ListItemProps, Menu, type MenuItemDef, type MenuProps, MinusIcon, type Mode, type ModePreference, MoneyField, type MoneyFieldProps, MoreHorizontalIcon, Pagination, type PaginationProps, PasswordField, type PasswordFieldProps, PlusIcon, Progress, type ProgressProps, type ProgressVariant, Radio, type RadioProps, type SchemaName, SearchIcon, Select, type SelectOption, type SelectProps, Slider, type SliderProps, Snackbar, type SnackbarProps, type Step, Stepper, type StepperProps, Switch, type SwitchProps, type TabItem, Table, type TableColumn, type TableProps, Tabs, type TabsProps, type TestIdHandle, TestIdProvider, type TestIdProviderProps, TextField, type TextFieldProps, ThemeProvider, type ThemeProviderProps, Tooltip, type TooltipPlacement, type TooltipProps, TriangleAlertIcon, Typography, type TypographyAlign, type TypographyColor, type TypographyProps, type TypographyVariant, XIcon, colorVars, modeNames, schemaNames, text, vars as theme, themes, usePrevious, useTestId, useTheme, useToggle };