@octavius2929-personal/design-system 0.12.0 → 0.13.0

package/dist/index.d.cts

@@ -856,6 +856,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>>;
@@ -940,6 +942,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,6 +983,8 @@ 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>>;
@@ -1381,6 +1387,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 +1399,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>>;
@@ -1499,4 +1509,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 };

package/dist/index.d.ts

@@ -856,6 +856,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>>;
@@ -940,6 +942,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,6 +983,8 @@ 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>>;
@@ -1381,6 +1387,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 +1399,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>>;
@@ -1499,4 +1509,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 };