@ajuarezso/sui-design-system 0.24.1 → 0.25.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ajuarezso/sui-design-system",
-  "version": "0.24.1",
+  "version": "0.25.0",
   "description": "SUI Design System — librería de componentes Angular (SUI 2.0).",
   "license": "UNLICENSED",
   "publishConfig": {

package/types/ajuarezso-sui-design-system.d.ts

@@ -1048,7 +1048,7 @@ declare class SuiAlert {
      * `small` (12/16) en los compactos (small/xsmall). Mapea el tipo del action al
      * tamaño del alert.
      */
-    readonly actionLinkSize: _angular_core.Signal<"small" | "medium">;
+    readonly actionLinkSize: _angular_core.Signal<"medium" | "small">;
     /**
      * Tamaño del `sui-compact-button` del cierre, mapeado del size del alert para
      * conservar el footprint del icono: xsmall (icon 16) → compact `medium`;
@@ -1603,7 +1603,7 @@ declare class SuiButtonGroupItem {
     /** aria-label para icon-only buttons */
     readonly ariaLabel: _angular_core.InputSignal<string>;
     /** Estado del data-attribute para CSS scoping */
-    readonly state: _angular_core.Signal<"default" | "active" | "disabled">;
+    readonly state: _angular_core.Signal<"disabled" | "default" | "active">;
     /** True cuando solo tiene icon (left o right) sin label */
     readonly onlyIcon: _angular_core.Signal<boolean>;
     /**
@@ -1931,7 +1931,7 @@ declare class SuiChartLegendDot {
     /** Color canon de la serie. Default `gray` (variant default del set Figma). */
     readonly color: _angular_core.InputSignal<SuiChartLegendColor>;
     /** Size del container: `medium` 20×20 / `small` 16×16. El dot es 12×12 en ambos. */
-    readonly size: _angular_core.InputSignal<"small" | "medium">;
+    readonly size: _angular_core.InputSignal<"medium" | "small">;
     /**
      * CSS color custom (override del preset) para series fuera de la paleta
      * canon — ej. colores de una paleta echarts propia. Si presente, ignora
@@ -2666,7 +2666,7 @@ declare class SuiColorDot {
      *   - `selected` → dot 12×12 + ring 2px.
      *   - `disabled` → dot gris pálido, sin pointer events.
      */
-    readonly state: _angular_core.InputSignal<"default" | "disabled" | "hover" | "selected">;
+    readonly state: _angular_core.InputSignal<"disabled" | "default" | "hover" | "selected">;
     /**
      * Tamaño. `medium` (default, Figma 24): dot 16 / hover 14 / selected 12 + anillo 18.
      * `large` (32, extensión SUI para mobile): dot 22 / hover 18 / selected 16 + anillo 24.
@@ -2766,7 +2766,7 @@ declare class SuiColorPicker {
      * Default `null` = sin valor seleccionado.
      */
     readonly value: _angular_core.ModelSignal<string | null>;
-    /** Label visible cuando no hay color seleccionado. */
+    /** Label visible cuando no hay color seleccionado. Imperativo con tuteo (dueño, 05-10-2026, P4 a). */
     readonly placeholder: _angular_core.InputSignal<string>;
     /** Etiqueta de la sección Recommended Colors dentro del panel. */
     readonly recommendedLabel: _angular_core.InputSignal<string>;
@@ -3072,7 +3072,7 @@ declare class SuiCommandMenuItem {
     /** Tamaño del avatar/icon container según el size del item. */
     readonly leadingSize: _angular_core.Signal<20 | 40>;
     /** Para sui-avatar, traduce a SuiAvatarSize. */
-    readonly avatarSize: _angular_core.Signal<"xs" | "lg">;
+    readonly avatarSize: _angular_core.Signal<"lg" | "xs">;
     onClick(event: MouseEvent): void;
     onButtonClick(event: MouseEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SuiCommandMenuItem, never>;
@@ -3369,7 +3369,7 @@ declare class SuiCompactSelectForInput<T = string> implements ControlValueAccess
     readonly arrowIcon: _angular_core.Signal<"arrow-up-s-line" | "arrow-down-s-line">;
     readonly displayValue: _angular_core.Signal<string>;
     readonly displayFlag: _angular_core.Signal<"abkhazia" | "afghanistan" | "aland-islands" | "albania" | "algeria" | "american-samoa" | "andorra" | "angola" | "anguilla" | "antigua-and-barbuda" | "argentina" | "armenia" | "aruba" | "australia" | "austria" | "azerbaijan" | "azores-islands" | "bahamas" | "bahrain" | "balearic-islands" | "bangladesh" | "barbados" | "basque-country" | "belarus" | "belgium" | "belize" | "benin" | "bermuda" | "bhutan" | "bolivia" | "bonaire" | "bosnia-and-herzegovina" | "botswana" | "brazil" | "british-columbia" | "british-indian-ocean-territory" | "british-virgin-islands" | "brunei" | "bulgaria" | "burkina-faso" | "burundi" | "cambodia" | "cameroon" | "canada" | "canary-islands" | "cape-verde" | "cayman-islands" | "central-african-republic" | "ceuta" | "chad" | "chile" | "china" | "christmas-island" | "cocos-island" | "colombia" | "comoros" | "cook-islands" | "corsica" | "costa-rica" | "croatia" | "cuba" | "curacao" | "cyprus" | "czech-republic" | "democratic-republic-of-congo" | "denmark" | "djibouti" | "dominica" | "dominican-republic" | "east-timor" | "ecuador" | "egypt" | "el-salvador" | "england" | "equatorial-guinea" | "eritrea" | "estonia" | "ethiopia" | "european-union" | "falkland-islands" | "faroe-islands" | "fiji" | "finland" | "france" | "french-polynesia" | "gabon" | "galapagos-islands" | "gambia" | "georgia" | "germany" | "ghana" | "gibraltar" | "greece" | "greenland" | "grenada" | "guam" | "guatemala" | "guernsey" | "guinea-bissau" | "guinea" | "guyana" | "haiti" | "hawaii" | "honduras" | "hong-kong" | "hungary" | "iceland" | "india" | "indonesia" | "iran" | "iraq" | "ireland" | "isle-of-man" | "israel" | "italy" | "ivory-coast" | "jamaica" | "japan" | "jersey" | "jordan" | "kazakhstan" | "kenya" | "kiribati" | "kosovo" | "kuwait" | "kyrgyzstan" | "laos" | "latvia" | "lebanon" | "lesotho" | "liberia" | "libya" | "liechtenstein" | "lithuania" | "luxembourg" | "macao" | "madagascar" | "madeira" | "malawi" | "malaysia" | "maldives" | "mali" | "malta" | "marshall-island" | "martinique" | "mauritania" | "mauritus" | "melilla" | "mexico" | "micronesia" | "moldova" | "monaco" | "mongolia" | "montenegro" | "montserrat" | "morocco" | "mozambique" | "myanmar" | "namibia" | "nato" | "nauru" | "nepal" | "netherlands" | "new-zealand" | "nicaragua" | "niger" | "nigeria" | "niue" | "norfolk-island" | "north-korea" | "northern-cyprus" | "northern-marianas-islands" | "norway" | "oman" | "orkney-islands" | "ossetia" | "pakistan" | "palau" | "palestine" | "panama" | "papua-new-guinea" | "paraguay" | "peru" | "philippines" | "pitcairn-islands" | "poland" | "portugal" | "puerto-rico" | "qatar" | "rapa-nui" | "republic-of-macedonia" | "republic-of-the-congo" | "romania" | "russia" | "rwanda" | "saba-island" | "sahrawi-arab-democratic-republic" | "saint-kitts-and-nevis" | "samoa" | "san-marino" | "sao-tome-and-prince" | "sardinia" | "saudi-arabia" | "scotland" | "senegal" | "serbia" | "seychelles" | "sierra-leone" | "singapore" | "sint-eustatius" | "sint-maarten" | "slovakia" | "slovania" | "solomon-islands" | "somalia" | "somaliland" | "south-africa" | "south-korea" | "south-sudan" | "spain" | "sri-lanka" | "st-barts" | "st-lucia" | "st-vincent-and-the-grenadines" | "sudan" | "suriname" | "swaziland" | "sweden" | "switzerland" | "syria" | "taijikistan" | "taiwan" | "tanzania" | "thailand" | "tibet" | "togo" | "tokelau" | "tonga" | "transnistria" | "trinidad-and-tobago" | "tunisia" | "turkey" | "turkmenistan" | "turks-and-caicos" | "tuvalu" | "uganda" | "ukraine" | "united-arab-emirates" | "united-kingdom" | "united-nations" | "united-states" | "uruguay" | "uzbekistan" | "vanuatu" | "vatican-city" | "venezuela" | "vietnam" | "virgin-islands" | "wales" | "yemen" | "zambia" | "zimbabwe" | null>;
-    readonly flagSizePx: _angular_core.Signal<20 | 16>;
+    readonly flagSizePx: _angular_core.Signal<16 | 20>;
     onHostClick(event: Event): void;
     protected onMenuOpenedChange(open: boolean): void;
     protected selectItem(item: SuiCompactSelectForInputItem<T>): void;
@@ -3486,7 +3486,7 @@ declare class SuiCompactSelect<T = string> implements ControlValueAccessor {
      *   medium/small → sm (20px), xsmall → xs (16px).
      * Mismo patrón que flagSizePx de sui-compact-select-for-input.
      */
-    readonly flagSize: _angular_core.Signal<"xs" | "sm">;
+    readonly flagSize: _angular_core.Signal<"sm" | "xs">;
     readonly displayValue: _angular_core.Signal<string>;
     readonly displayIcon: _angular_core.Signal<string | null>;
     readonly displayFlag: _angular_core.Signal<"abkhazia" | "afghanistan" | "aland-islands" | "albania" | "algeria" | "american-samoa" | "andorra" | "angola" | "anguilla" | "antigua-and-barbuda" | "argentina" | "armenia" | "aruba" | "australia" | "austria" | "azerbaijan" | "azores-islands" | "bahamas" | "bahrain" | "balearic-islands" | "bangladesh" | "barbados" | "basque-country" | "belarus" | "belgium" | "belize" | "benin" | "bermuda" | "bhutan" | "bolivia" | "bonaire" | "bosnia-and-herzegovina" | "botswana" | "brazil" | "british-columbia" | "british-indian-ocean-territory" | "british-virgin-islands" | "brunei" | "bulgaria" | "burkina-faso" | "burundi" | "cambodia" | "cameroon" | "canada" | "canary-islands" | "cape-verde" | "cayman-islands" | "central-african-republic" | "ceuta" | "chad" | "chile" | "china" | "christmas-island" | "cocos-island" | "colombia" | "comoros" | "cook-islands" | "corsica" | "costa-rica" | "croatia" | "cuba" | "curacao" | "cyprus" | "czech-republic" | "democratic-republic-of-congo" | "denmark" | "djibouti" | "dominica" | "dominican-republic" | "east-timor" | "ecuador" | "egypt" | "el-salvador" | "england" | "equatorial-guinea" | "eritrea" | "estonia" | "ethiopia" | "european-union" | "falkland-islands" | "faroe-islands" | "fiji" | "finland" | "france" | "french-polynesia" | "gabon" | "galapagos-islands" | "gambia" | "georgia" | "germany" | "ghana" | "gibraltar" | "greece" | "greenland" | "grenada" | "guam" | "guatemala" | "guernsey" | "guinea-bissau" | "guinea" | "guyana" | "haiti" | "hawaii" | "honduras" | "hong-kong" | "hungary" | "iceland" | "india" | "indonesia" | "iran" | "iraq" | "ireland" | "isle-of-man" | "israel" | "italy" | "ivory-coast" | "jamaica" | "japan" | "jersey" | "jordan" | "kazakhstan" | "kenya" | "kiribati" | "kosovo" | "kuwait" | "kyrgyzstan" | "laos" | "latvia" | "lebanon" | "lesotho" | "liberia" | "libya" | "liechtenstein" | "lithuania" | "luxembourg" | "macao" | "madagascar" | "madeira" | "malawi" | "malaysia" | "maldives" | "mali" | "malta" | "marshall-island" | "martinique" | "mauritania" | "mauritus" | "melilla" | "mexico" | "micronesia" | "moldova" | "monaco" | "mongolia" | "montenegro" | "montserrat" | "morocco" | "mozambique" | "myanmar" | "namibia" | "nato" | "nauru" | "nepal" | "netherlands" | "new-zealand" | "nicaragua" | "niger" | "nigeria" | "niue" | "norfolk-island" | "north-korea" | "northern-cyprus" | "northern-marianas-islands" | "norway" | "oman" | "orkney-islands" | "ossetia" | "pakistan" | "palau" | "palestine" | "panama" | "papua-new-guinea" | "paraguay" | "peru" | "philippines" | "pitcairn-islands" | "poland" | "portugal" | "puerto-rico" | "qatar" | "rapa-nui" | "republic-of-macedonia" | "republic-of-the-congo" | "romania" | "russia" | "rwanda" | "saba-island" | "sahrawi-arab-democratic-republic" | "saint-kitts-and-nevis" | "samoa" | "san-marino" | "sao-tome-and-prince" | "sardinia" | "saudi-arabia" | "scotland" | "senegal" | "serbia" | "seychelles" | "sierra-leone" | "singapore" | "sint-eustatius" | "sint-maarten" | "slovakia" | "slovania" | "solomon-islands" | "somalia" | "somaliland" | "south-africa" | "south-korea" | "south-sudan" | "spain" | "sri-lanka" | "st-barts" | "st-lucia" | "st-vincent-and-the-grenadines" | "sudan" | "suriname" | "swaziland" | "sweden" | "switzerland" | "syria" | "taijikistan" | "taiwan" | "tanzania" | "thailand" | "tibet" | "togo" | "tokelau" | "tonga" | "transnistria" | "trinidad-and-tobago" | "tunisia" | "turkey" | "turkmenistan" | "turks-and-caicos" | "tuvalu" | "uganda" | "ukraine" | "united-arab-emirates" | "united-kingdom" | "united-nations" | "united-states" | "uruguay" | "uzbekistan" | "vanuatu" | "vatican-city" | "venezuela" | "vietnam" | "virgin-islands" | "wales" | "yemen" | "zambia" | "zimbabwe" | null>;
@@ -4326,8 +4326,9 @@ declare class SuiDatepicker implements ControlValueAccessor {
     readonly inline: _angular_core.InputSignal<boolean>;
     /** Alto del campo: small 36 · medium 40 (default) · large 48 · xlarge 52 con días de 44 (ver SuiDatepickerSize). */
     readonly size: _angular_core.InputSignal<SuiDatepickerSize>;
-    /** Placeholder del input cuando no hay valor seleccionado. */
-    readonly placeholder: _angular_core.InputSignal<string>;
+    /** Placeholder del campo cuando no hay valor. Sin pasarlo: «Elige una fecha» (`date`) o
+     *  «Elige el período» (`range`), en imperativo con tuteo (dueño, 05-10-2026, P4 a). */
+    readonly placeholder: _angular_core.InputSignal<string | null>;
     /** Si true, muestra Cancel/Apply en el footer. Range siempre lo muestra. */
     readonly showFooter: _angular_core.InputSignal<boolean>;
     readonly disabled: _angular_core.InputSignal<boolean>;
@@ -4372,7 +4373,7 @@ declare class SuiDatepicker implements ControlValueAccessor {
      * Cancelar / Aplicar: large (48) con el campo large y siempre en mobile, para
      * tocarlos con el dedo (extensión SUI, 03-10-2026); small (36, Figma) si no.
      */
-    readonly footerButtonSize: _angular_core.Signal<"small" | "large">;
+    readonly footerButtonSize: _angular_core.Signal<"large" | "small">;
     /**
      * Tamaño de las piezas del panel (días, flechas de mes, rangos predefinidos):
      * `large` (44) solo con el campo xlarge — canon del dueño 04-10-2026, piso
@@ -4403,6 +4404,8 @@ declare class SuiDatepicker implements ControlValueAccessor {
     /** Preset «Todo el tiempo» aplicado: su valor es `{ start: null, end: null }`,
      *  igual que «nada elegido», así que se recuerda aparte para el trigger. */
     private readonly _todoElTiempoAplicado;
+    /** El placeholder que se ve: el que se pasó o, si no, el de fábrica según `mode`. */
+    readonly resolvedPlaceholder: _angular_core.Signal<string>;
     /** Texto del trigger input. */
     readonly triggerText: _angular_core.Signal<string>;
     /** ¿El trigger muestra un valor (no el placeholder)? Pinta el texto oscuro. */
@@ -5806,7 +5809,7 @@ declare class SuiFileUpload {
     protected readonly inputRef: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
     protected readonly dragging: _angular_core.WritableSignal<boolean>;
     protected readonly internalError: _angular_core.WritableSignal<string | null>;
-    protected readonly state: _angular_core.Signal<"default" | "error" | "disabled" | "dragover">;
+    protected readonly state: _angular_core.Signal<"dragover" | "disabled" | "error" | "default">;
     protected readonly resolvedTitle: _angular_core.Signal<string>;
     protected readonly resolvedSubtitle: _angular_core.Signal<string>;
     protected readonly resolvedErrorMessage: _angular_core.Signal<string | null>;
@@ -6042,7 +6045,7 @@ declare class SuiFilterPanelFooter {
     /** Botón "Apply" (filled primary) — string shorthand o SuiFooterButtonConfig. */
     readonly applyButton: _angular_core.InputSignal<string | SuiFooterButtonConfig>;
     /** Tamaño de los botones. Default 'small' (Figma: p-8px/radius-8 = size small). */
-    readonly size: _angular_core.InputSignal<"small" | "medium">;
+    readonly size: _angular_core.InputSignal<"medium" | "small">;
     /** Config resuelta del botón Clear (string → { label }). */
     protected readonly clearCfg: _angular_core.Signal<SuiFooterButtonConfig>;
     /** Config resuelta del botón Apply (string → { label }). */
@@ -6458,15 +6461,15 @@ declare class SuiImageUpload {
     protected readonly sizePx: _angular_core.Signal<number>;
     /** Camera icon px en el empty state. xl escala a 20, resto 16
      *  (matchea el escalado del contenedor 32→40 en SCSS). */
-    protected readonly iconSize: _angular_core.Signal<20 | 16>;
+    protected readonly iconSize: _angular_core.Signal<16 | 20>;
     /** Ícono del lápiz y el tacho (editable): 20 en botones de 40, 16 en sm (32). */
-    protected readonly ctrlIconSize: _angular_core.Signal<20 | 16>;
+    protected readonly ctrlIconSize: _angular_core.Signal<16 | 20>;
     protected readonly hasSrc: _angular_core.Signal<boolean>;
     /** Hay imagen y se muestra el botón «Quitar» debajo (sin `editable`). */
     protected readonly conQuitar: _angular_core.Signal<boolean>;
     /** Valor del `accept` del input file (incluye HEIC/HEIF). */
     protected readonly accept: string;
-    protected readonly state: _angular_core.Signal<"filled" | "disabled" | "dragover" | "empty">;
+    protected readonly state: _angular_core.Signal<"empty" | "filled" | "dragover" | "disabled">;
     protected readonly resolvedTitle: _angular_core.Signal<string>;
     protected readonly resolvedSubtitle: _angular_core.Signal<string>;
     onHostClick(): void;
@@ -7919,7 +7922,7 @@ declare class SuiModalHeader {
     /** Descripción bajo el título (Paragraph/X-Small). */
     readonly description: _angular_core.InputSignal<string | null>;
     /** medium (80): título + descripción · small (56): título; icono flat 24. */
-    readonly size: _angular_core.InputSignal<"small" | "medium">;
+    readonly size: _angular_core.InputSignal<"medium" | "small">;
     /** Icono semántico de status (círculo state lighter/base en medium). */
     readonly iconVariant: _angular_core.InputSignal<SuiModalHeaderVariant | null>;
     /** Icono custom (type "Left Icon" de Figma). Prioridad sobre iconVariant. */
@@ -8261,7 +8264,7 @@ declare class SuiNotification {
     readonly dismissible: _angular_core.InputSignal<boolean>;
     readonly unread: _angular_core.InputSignal<boolean>;
     /** Item body type. 'basic' keeps the legacy/alert layout (no body slot). */
-    readonly type: _angular_core.InputSignal<"basic" | "file" | "button" | "message">;
+    readonly type: _angular_core.InputSignal<"button" | "basic" | "file" | "message">;
     /** When true, item paints the Figma hover bg + reveals the more-2-line button. */
     readonly showMore: _angular_core.InputSignal<boolean>;
     /** Forces the hover affordance visible (e.g. keyboard-focused row). */
@@ -9535,7 +9538,7 @@ declare class SuiRating implements ControlValueAccessor {
      *  bar/bar-area usan 20px hardcoded en el template (no pasan por aquí). */
     readonly iconPx: _angular_core.Signal<number>;
     /** Rol del host: `img` para la nota de solo lectura (o `group` si trae link), `radiogroup` para pedirla. */
-    protected readonly hostRole: _angular_core.Signal<"group" | "img" | "radiogroup">;
+    protected readonly hostRole: _angular_core.Signal<"img" | "group" | "radiogroup">;
     /** Nombre accesible: interactivo = `ariaLabel`; readonly = «Calificación: 4,5 de 5, 120 calificaciones». */
     protected readonly hostAriaLabel: _angular_core.Signal<string>;
     /** Índice (1..max) de la celda con tabindex 0: la elegida, o la primera. */
@@ -10888,7 +10891,7 @@ declare class SuiProductCard {
     /** Glyph del «+» / lápiz: 18 en small, 20 en medium y large. */
     readonly iconSize: _angular_core.Signal<20 | 18>;
     /** Glyph del stepper: 16 en small, 20 en medium y large. */
-    readonly stepIconSize: _angular_core.Signal<20 | 16>;
+    readonly stepIconSize: _angular_core.Signal<16 | 20>;
     readonly showStepper: _angular_core.Signal<boolean>;
     /** Config resuelta de la imagen (string → { url }; `position` default 50).
      *  null = sin imagen → fallback. */
@@ -12575,6 +12578,7 @@ declare class SuiTimePicker implements ControlValueAccessor {
     readonly hint: _angular_core.InputSignal<string | null>;
     readonly errorMessage: _angular_core.InputSignal<string | null>;
     readonly error: _angular_core.InputSignal<boolean>;
+    /** Texto del campo sin hora. Imperativo con tuteo (dueño, 05-10-2026, P4 a). */
     readonly placeholder: _angular_core.InputSignal<string>;
     readonly disabled: _angular_core.InputSignal<boolean>;
     /**
@@ -12586,7 +12590,7 @@ declare class SuiTimePicker implements ControlValueAccessor {
      */
     readonly size: _angular_core.InputSignal<SuiTimePickerSize>;
     /** sui-form-label no tiene large: el label queda en medium. */
-    protected readonly labelSize: _angular_core.Signal<"small" | "medium">;
+    protected readonly labelSize: _angular_core.Signal<"medium" | "small">;
     /** Panel grande (filas de 44 con texto 16) con el campo large o xlarge. */
     protected readonly panelLarge: _angular_core.Signal<boolean>;
     /**
@@ -12594,7 +12598,7 @@ declare class SuiTimePicker implements ControlValueAccessor {
      * mobile (fix 04-10-2026, como el sui-datepicker: Cancelar/Aplicar se tocan
      * con el dedo aunque el campo vaya en medium); small (36, Figma) si no.
      */
-    protected readonly footerButtonSize: _angular_core.Signal<"small" | "large">;
+    protected readonly footerButtonSize: _angular_core.Signal<"large" | "small">;
     /** Formato de display: '12h' (AM/PM) o '24h'. */
     readonly format: _angular_core.InputSignal<SuiTimeFormat>;
     /** Incremento de minutos de la lista (1, 5, 15, ...). Default 5. */