@octavius2929-personal/design-system 1.4.1 → 1.5.0

package/dist/index.d.cts

@@ -1702,9 +1702,40 @@ interface DividerProps extends Omit<HTMLAttributes<HTMLDivElement>, "className">
 declare const Divider: react.ForwardRefExoticComponent<DividerProps & react.RefAttributes<HTMLDivElement>>;
 
 type AvatarSize = "sm" | "md" | "lg";
+type AvatarStatus = "online" | "away" | "busy" | "offline";
 interface AvatarProps extends HTMLAttributes<HTMLSpanElement> {
     size?: AvatarSize;
     filled?: boolean;
+    /** URL de la imagen de perfil. Si falla al cargar (`onError`), cae a las iniciales. */
+    src?: string;
+    /**
+     * Texto alternativo de la imagen. Cuando el avatar es informativo, es el nombre
+     * accesible preferido (por encima de `name`).
+     */
+    alt?: string;
+    /**
+     * Nombre completo de la persona. Alimenta las iniciales de fallback (cuando no hay
+     * `children` explícito) y, si no hay `alt`, el nombre accesible.
+     */
+    name?: string;
+    /**
+     * Contenido de fallback explícito (p.ej. iniciales manuales o un ícono). Tiene
+     * prioridad sobre las iniciales derivadas de `name`.
+     */
+    children?: ReactNode;
+    /** Indicador de presencia. Sin `status`, no se renderiza ningún indicador. */
+    status?: AvatarStatus;
+    /**
+     * Marcá el avatar como puramente decorativo cuando el nombre de la persona ya está
+     * visible como texto al lado (fila de tabla, item de lista, header con título): oculta
+     * la imagen/iniciales del árbol accesible (`aria-hidden`) para no duplicar el anuncio.
+     * Por defecto `false` (informativo: `role="img"` + nombre accesible) — el modo seguro
+     * cuando el avatar puede aparecer solo (trigger de menú, header de perfil).
+     *
+     * El indicador de `status`, si existe, siempre es accesible sin importar este flag: es
+     * información propia (presencia), no redundante con el nombre visible.
+     */
+    decorative?: boolean;
     /** Segmento de contexto para el data-testid. */
     testId?: string;
 }
@@ -2352,4 +2383,4 @@ interface TestIdHandle {
 }
 declare function useTestId(type: string, ownTestId?: string): TestIdHandle;
 
-export { Accordion, type AccordionItem, type AccordionProps, Alert, AlertCircleIcon, type AlertProps, type AlertSeverity, AppBar, type AppBarProps, ArchiveIcon, ArrowDownIcon, ArrowLeftIcon, ArrowRightIcon, ArrowUpIcon, AtSignIcon, Avatar, type AvatarProps, type AvatarSize, Badge, type BadgeProps, type BadgeTone, BellIcon, BellOffIcon, BookmarkIcon, Breadcrumbs, type BreadcrumbsProps, Button, type ButtonProps, type ButtonSize, type ButtonTone, type ButtonVariant, CalendarIcon, CameraIcon, Card, type CardProps, type CardSectionProps, CheckIcon, Checkbox, type CheckboxProps, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, ChevronUpIcon, ChevronsLeftIcon, ChevronsRightIcon, Chip, type ChipProps, type ChipTone, CircleCheckIcon, CircleXIcon, ClipboardIcon, ClockIcon, CloudIcon, type ColorTokens, Container, type ContainerProps, CopyIcon, CornerDownRightIcon, CreditCardIcon, type Crumb, Dialog, type DialogProps, Divider, type DividerProps, DollarSignIcon, DownloadIcon, ExternalLinkIcon, EyeIcon, EyeOffIcon, FileIcon, FileTextIcon, FilterIcon, FingerprintIcon, FolderIcon, FolderOpenIcon, GiftIcon, GitHubIcon, GlobeIcon, GridIcon, HeartIcon, HelpCircleIcon, HomeIcon, type Icon, IconButton, type IconButtonProps, type IconButtonTone, type IconProps, ImageIcon, InboxIcon, InfoIcon, KeyIcon, LayoutIcon, LinkIcon, ListIcon, ListItem, type ListItemProps, LoaderIcon, LockIcon, LogInIcon, LogOutIcon, MailIcon, MapPinIcon, MaximizeIcon, Menu, MenuIcon, type MenuItemDef, type MenuProps, MessageCircleIcon, MessageSquareIcon, MicIcon, MinimizeIcon, MinusIcon, type Mode, type ModePreference, MoneyField, type MoneyFieldProps, MoonIcon, MoreHorizontalIcon, MoreVerticalIcon, PackageIcon, Pagination, type PaginationProps, PaperclipIcon, PasswordField, type PasswordFieldProps, PauseIcon, PencilIcon, PhoneIcon, PlayIcon, PlusIcon, PrinterIcon, Progress, type ProgressProps, type ProgressVariant, Radio, RadioGroup, type RadioGroupOption, type RadioGroupOrientation, type RadioGroupProps, type RadioProps, RedoIcon, RefreshCwIcon, SaveIcon, type SchemaName, SearchIcon, Select, type SelectOption, type SelectProps, SendIcon, SettingsIcon, ShareIcon, ShieldCheckIcon, ShieldIcon, ShoppingBagIcon, ShoppingCartIcon, SidebarIcon, SkipBackIcon, SkipForwardIcon, Slider, type SliderProps, SlidersIcon, SmileIcon, Snackbar, type SnackbarProps, StarIcon, type Step, Stepper, type StepperProps, SunIcon, Surface, type SurfaceProps, Switch, type SwitchProps, type TabItem, Table, type TableColumn, type TableProps, Tabs, type TabsProps, TagIcon, type TestIdHandle, TestIdProvider, type TestIdProviderProps, TextField, type TextFieldProps, ThemeProvider, type ThemeProviderProps, ThumbsDownIcon, ThumbsUpIcon, Tooltip, type TooltipPlacement, type TooltipProps, TrashIcon, TriangleAlertIcon, Typography, type TypographyAlign, type TypographyColor, type TypographyProps, type TypographyVariant, UndoIcon, UnlockIcon, UploadIcon, UserCheckIcon, UserIcon, UserPlusIcon, UsersIcon, Volume2Icon, VolumeXIcon, WifiIcon, XIcon, ZapIcon, colorVars, iconCatalog, modeNames, schemaNames, vars as theme, themes, usePrevious, useTestId, useTheme, useToggle };
+export { Accordion, type AccordionItem, type AccordionProps, Alert, AlertCircleIcon, type AlertProps, type AlertSeverity, AppBar, type AppBarProps, ArchiveIcon, ArrowDownIcon, ArrowLeftIcon, ArrowRightIcon, ArrowUpIcon, AtSignIcon, Avatar, type AvatarProps, type AvatarSize, type AvatarStatus, Badge, type BadgeProps, type BadgeTone, BellIcon, BellOffIcon, BookmarkIcon, Breadcrumbs, type BreadcrumbsProps, Button, type ButtonProps, type ButtonSize, type ButtonTone, type ButtonVariant, CalendarIcon, CameraIcon, Card, type CardProps, type CardSectionProps, CheckIcon, Checkbox, type CheckboxProps, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, ChevronUpIcon, ChevronsLeftIcon, ChevronsRightIcon, Chip, type ChipProps, type ChipTone, CircleCheckIcon, CircleXIcon, ClipboardIcon, ClockIcon, CloudIcon, type ColorTokens, Container, type ContainerProps, CopyIcon, CornerDownRightIcon, CreditCardIcon, type Crumb, Dialog, type DialogProps, Divider, type DividerProps, DollarSignIcon, DownloadIcon, ExternalLinkIcon, EyeIcon, EyeOffIcon, FileIcon, FileTextIcon, FilterIcon, FingerprintIcon, FolderIcon, FolderOpenIcon, GiftIcon, GitHubIcon, GlobeIcon, GridIcon, HeartIcon, HelpCircleIcon, HomeIcon, type Icon, IconButton, type IconButtonProps, type IconButtonTone, type IconProps, ImageIcon, InboxIcon, InfoIcon, KeyIcon, LayoutIcon, LinkIcon, ListIcon, ListItem, type ListItemProps, LoaderIcon, LockIcon, LogInIcon, LogOutIcon, MailIcon, MapPinIcon, MaximizeIcon, Menu, MenuIcon, type MenuItemDef, type MenuProps, MessageCircleIcon, MessageSquareIcon, MicIcon, MinimizeIcon, MinusIcon, type Mode, type ModePreference, MoneyField, type MoneyFieldProps, MoonIcon, MoreHorizontalIcon, MoreVerticalIcon, PackageIcon, Pagination, type PaginationProps, PaperclipIcon, PasswordField, type PasswordFieldProps, PauseIcon, PencilIcon, PhoneIcon, PlayIcon, PlusIcon, PrinterIcon, Progress, type ProgressProps, type ProgressVariant, Radio, RadioGroup, type RadioGroupOption, type RadioGroupOrientation, type RadioGroupProps, type RadioProps, RedoIcon, RefreshCwIcon, SaveIcon, type SchemaName, SearchIcon, Select, type SelectOption, type SelectProps, SendIcon, SettingsIcon, ShareIcon, ShieldCheckIcon, ShieldIcon, ShoppingBagIcon, ShoppingCartIcon, SidebarIcon, SkipBackIcon, SkipForwardIcon, Slider, type SliderProps, SlidersIcon, SmileIcon, Snackbar, type SnackbarProps, StarIcon, type Step, Stepper, type StepperProps, SunIcon, Surface, type SurfaceProps, Switch, type SwitchProps, type TabItem, Table, type TableColumn, type TableProps, Tabs, type TabsProps, TagIcon, type TestIdHandle, TestIdProvider, type TestIdProviderProps, TextField, type TextFieldProps, ThemeProvider, type ThemeProviderProps, ThumbsDownIcon, ThumbsUpIcon, Tooltip, type TooltipPlacement, type TooltipProps, TrashIcon, TriangleAlertIcon, Typography, type TypographyAlign, type TypographyColor, type TypographyProps, type TypographyVariant, UndoIcon, UnlockIcon, UploadIcon, UserCheckIcon, UserIcon, UserPlusIcon, UsersIcon, Volume2Icon, VolumeXIcon, WifiIcon, XIcon, ZapIcon, colorVars, iconCatalog, modeNames, schemaNames, vars as theme, themes, usePrevious, useTestId, useTheme, useToggle };

package/dist/index.d.ts

@@ -1702,9 +1702,40 @@ interface DividerProps extends Omit<HTMLAttributes<HTMLDivElement>, "className">
 declare const Divider: react.ForwardRefExoticComponent<DividerProps & react.RefAttributes<HTMLDivElement>>;
 
 type AvatarSize = "sm" | "md" | "lg";
+type AvatarStatus = "online" | "away" | "busy" | "offline";
 interface AvatarProps extends HTMLAttributes<HTMLSpanElement> {
     size?: AvatarSize;
     filled?: boolean;
+    /** URL de la imagen de perfil. Si falla al cargar (`onError`), cae a las iniciales. */
+    src?: string;
+    /**
+     * Texto alternativo de la imagen. Cuando el avatar es informativo, es el nombre
+     * accesible preferido (por encima de `name`).
+     */
+    alt?: string;
+    /**
+     * Nombre completo de la persona. Alimenta las iniciales de fallback (cuando no hay
+     * `children` explícito) y, si no hay `alt`, el nombre accesible.
+     */
+    name?: string;
+    /**
+     * Contenido de fallback explícito (p.ej. iniciales manuales o un ícono). Tiene
+     * prioridad sobre las iniciales derivadas de `name`.
+     */
+    children?: ReactNode;
+    /** Indicador de presencia. Sin `status`, no se renderiza ningún indicador. */
+    status?: AvatarStatus;
+    /**
+     * Marcá el avatar como puramente decorativo cuando el nombre de la persona ya está
+     * visible como texto al lado (fila de tabla, item de lista, header con título): oculta
+     * la imagen/iniciales del árbol accesible (`aria-hidden`) para no duplicar el anuncio.
+     * Por defecto `false` (informativo: `role="img"` + nombre accesible) — el modo seguro
+     * cuando el avatar puede aparecer solo (trigger de menú, header de perfil).
+     *
+     * El indicador de `status`, si existe, siempre es accesible sin importar este flag: es
+     * información propia (presencia), no redundante con el nombre visible.
+     */
+    decorative?: boolean;
     /** Segmento de contexto para el data-testid. */
     testId?: string;
 }
@@ -2352,4 +2383,4 @@ interface TestIdHandle {
 }
 declare function useTestId(type: string, ownTestId?: string): TestIdHandle;
 
-export { Accordion, type AccordionItem, type AccordionProps, Alert, AlertCircleIcon, type AlertProps, type AlertSeverity, AppBar, type AppBarProps, ArchiveIcon, ArrowDownIcon, ArrowLeftIcon, ArrowRightIcon, ArrowUpIcon, AtSignIcon, Avatar, type AvatarProps, type AvatarSize, Badge, type BadgeProps, type BadgeTone, BellIcon, BellOffIcon, BookmarkIcon, Breadcrumbs, type BreadcrumbsProps, Button, type ButtonProps, type ButtonSize, type ButtonTone, type ButtonVariant, CalendarIcon, CameraIcon, Card, type CardProps, type CardSectionProps, CheckIcon, Checkbox, type CheckboxProps, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, ChevronUpIcon, ChevronsLeftIcon, ChevronsRightIcon, Chip, type ChipProps, type ChipTone, CircleCheckIcon, CircleXIcon, ClipboardIcon, ClockIcon, CloudIcon, type ColorTokens, Container, type ContainerProps, CopyIcon, CornerDownRightIcon, CreditCardIcon, type Crumb, Dialog, type DialogProps, Divider, type DividerProps, DollarSignIcon, DownloadIcon, ExternalLinkIcon, EyeIcon, EyeOffIcon, FileIcon, FileTextIcon, FilterIcon, FingerprintIcon, FolderIcon, FolderOpenIcon, GiftIcon, GitHubIcon, GlobeIcon, GridIcon, HeartIcon, HelpCircleIcon, HomeIcon, type Icon, IconButton, type IconButtonProps, type IconButtonTone, type IconProps, ImageIcon, InboxIcon, InfoIcon, KeyIcon, LayoutIcon, LinkIcon, ListIcon, ListItem, type ListItemProps, LoaderIcon, LockIcon, LogInIcon, LogOutIcon, MailIcon, MapPinIcon, MaximizeIcon, Menu, MenuIcon, type MenuItemDef, type MenuProps, MessageCircleIcon, MessageSquareIcon, MicIcon, MinimizeIcon, MinusIcon, type Mode, type ModePreference, MoneyField, type MoneyFieldProps, MoonIcon, MoreHorizontalIcon, MoreVerticalIcon, PackageIcon, Pagination, type PaginationProps, PaperclipIcon, PasswordField, type PasswordFieldProps, PauseIcon, PencilIcon, PhoneIcon, PlayIcon, PlusIcon, PrinterIcon, Progress, type ProgressProps, type ProgressVariant, Radio, RadioGroup, type RadioGroupOption, type RadioGroupOrientation, type RadioGroupProps, type RadioProps, RedoIcon, RefreshCwIcon, SaveIcon, type SchemaName, SearchIcon, Select, type SelectOption, type SelectProps, SendIcon, SettingsIcon, ShareIcon, ShieldCheckIcon, ShieldIcon, ShoppingBagIcon, ShoppingCartIcon, SidebarIcon, SkipBackIcon, SkipForwardIcon, Slider, type SliderProps, SlidersIcon, SmileIcon, Snackbar, type SnackbarProps, StarIcon, type Step, Stepper, type StepperProps, SunIcon, Surface, type SurfaceProps, Switch, type SwitchProps, type TabItem, Table, type TableColumn, type TableProps, Tabs, type TabsProps, TagIcon, type TestIdHandle, TestIdProvider, type TestIdProviderProps, TextField, type TextFieldProps, ThemeProvider, type ThemeProviderProps, ThumbsDownIcon, ThumbsUpIcon, Tooltip, type TooltipPlacement, type TooltipProps, TrashIcon, TriangleAlertIcon, Typography, type TypographyAlign, type TypographyColor, type TypographyProps, type TypographyVariant, UndoIcon, UnlockIcon, UploadIcon, UserCheckIcon, UserIcon, UserPlusIcon, UsersIcon, Volume2Icon, VolumeXIcon, WifiIcon, XIcon, ZapIcon, colorVars, iconCatalog, modeNames, schemaNames, vars as theme, themes, usePrevious, useTestId, useTheme, useToggle };
+export { Accordion, type AccordionItem, type AccordionProps, Alert, AlertCircleIcon, type AlertProps, type AlertSeverity, AppBar, type AppBarProps, ArchiveIcon, ArrowDownIcon, ArrowLeftIcon, ArrowRightIcon, ArrowUpIcon, AtSignIcon, Avatar, type AvatarProps, type AvatarSize, type AvatarStatus, Badge, type BadgeProps, type BadgeTone, BellIcon, BellOffIcon, BookmarkIcon, Breadcrumbs, type BreadcrumbsProps, Button, type ButtonProps, type ButtonSize, type ButtonTone, type ButtonVariant, CalendarIcon, CameraIcon, Card, type CardProps, type CardSectionProps, CheckIcon, Checkbox, type CheckboxProps, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, ChevronUpIcon, ChevronsLeftIcon, ChevronsRightIcon, Chip, type ChipProps, type ChipTone, CircleCheckIcon, CircleXIcon, ClipboardIcon, ClockIcon, CloudIcon, type ColorTokens, Container, type ContainerProps, CopyIcon, CornerDownRightIcon, CreditCardIcon, type Crumb, Dialog, type DialogProps, Divider, type DividerProps, DollarSignIcon, DownloadIcon, ExternalLinkIcon, EyeIcon, EyeOffIcon, FileIcon, FileTextIcon, FilterIcon, FingerprintIcon, FolderIcon, FolderOpenIcon, GiftIcon, GitHubIcon, GlobeIcon, GridIcon, HeartIcon, HelpCircleIcon, HomeIcon, type Icon, IconButton, type IconButtonProps, type IconButtonTone, type IconProps, ImageIcon, InboxIcon, InfoIcon, KeyIcon, LayoutIcon, LinkIcon, ListIcon, ListItem, type ListItemProps, LoaderIcon, LockIcon, LogInIcon, LogOutIcon, MailIcon, MapPinIcon, MaximizeIcon, Menu, MenuIcon, type MenuItemDef, type MenuProps, MessageCircleIcon, MessageSquareIcon, MicIcon, MinimizeIcon, MinusIcon, type Mode, type ModePreference, MoneyField, type MoneyFieldProps, MoonIcon, MoreHorizontalIcon, MoreVerticalIcon, PackageIcon, Pagination, type PaginationProps, PaperclipIcon, PasswordField, type PasswordFieldProps, PauseIcon, PencilIcon, PhoneIcon, PlayIcon, PlusIcon, PrinterIcon, Progress, type ProgressProps, type ProgressVariant, Radio, RadioGroup, type RadioGroupOption, type RadioGroupOrientation, type RadioGroupProps, type RadioProps, RedoIcon, RefreshCwIcon, SaveIcon, type SchemaName, SearchIcon, Select, type SelectOption, type SelectProps, SendIcon, SettingsIcon, ShareIcon, ShieldCheckIcon, ShieldIcon, ShoppingBagIcon, ShoppingCartIcon, SidebarIcon, SkipBackIcon, SkipForwardIcon, Slider, type SliderProps, SlidersIcon, SmileIcon, Snackbar, type SnackbarProps, StarIcon, type Step, Stepper, type StepperProps, SunIcon, Surface, type SurfaceProps, Switch, type SwitchProps, type TabItem, Table, type TableColumn, type TableProps, Tabs, type TabsProps, TagIcon, type TestIdHandle, TestIdProvider, type TestIdProviderProps, TextField, type TextFieldProps, ThemeProvider, type ThemeProviderProps, ThumbsDownIcon, ThumbsUpIcon, Tooltip, type TooltipPlacement, type TooltipProps, TrashIcon, TriangleAlertIcon, Typography, type TypographyAlign, type TypographyColor, type TypographyProps, type TypographyVariant, UndoIcon, UnlockIcon, UploadIcon, UserCheckIcon, UserIcon, UserPlusIcon, UsersIcon, Volume2Icon, VolumeXIcon, WifiIcon, XIcon, ZapIcon, colorVars, iconCatalog, modeNames, schemaNames, vars as theme, themes, usePrevious, useTestId, useTheme, useToggle };