@studiolxd/brand 42.0.0 → 44.0.0

package/dist/_types/atoms/FileUpload/FileUpload.d.ts

@@ -1,5 +1,40 @@
 import { type FormSize } from '../../constants/form-size';
 import './FileUpload.css';
+/**
+ * El cromo de la zona de subida: lo que dice la zona, lo que dice de los
+ * límites y lo que dice cuando un archivo no vale.
+ *
+ * Las dos pistas de límite son **plantillas y no frases hechas**, y ahí está
+ * la parte interesante. «Máximo 2,5 MB» tiene dos mitades que se deciden en
+ * sitios distintos, igual que `dd/mm/aaaa`: la frase es idioma y sale de aquí;
+ * la cifra —la coma o el punto decimal, el espacio antes de `MB`— es formato y
+ * la escribe `Intl.NumberFormat` con el `locale` del componente. Por eso el
+ * catálogo recibe el peso **ya formateado** y solo lo envuelve: una traducción
+ * que escribiera «max. 2.5 MB» a mano metería el punto inglés en una interfaz
+ * española.
+ */
+export interface FileUploadMessages {
+    /** Texto visible de la zona de arrastre en reposo. */
+    dropzone: string;
+    /** Texto visible mientras se arrastra un archivo por encima. */
+    dropzoneActive: string;
+    /** Texto visible secundario: que además se puede hacer clic. */
+    dropzoneHint: string;
+    /** Pista de peso máximo. Recibe el peso **ya escrito en el locale** («2,5 MB»). */
+    maxSize: (maxSize: string) => string;
+    /** Pista de número máximo de archivos. */
+    maxFiles: (maxFiles: number) => string;
+    /** aria-label de la lista de archivos elegidos. */
+    files: string;
+    /** aria-label de la barra de progreso. */
+    progress: string;
+    /** aria-label del botón de quitar un archivo de la lista. */
+    removeFile: (fileName: string) => string;
+    /** Error de archivo demasiado pesado. Recibe el peso ya escrito en el locale. */
+    tooLarge: (maxSize: string) => string;
+    /** Error de tipo de archivo no admitido. */
+    invalidType: string;
+}
 export interface FileUploadProps {
     multiple?: boolean;
     accept?: string;
@@ -35,27 +70,60 @@ export interface FileUploadProps {
     /** Se añade DESPUÉS de las clases propias del componente. */
     className?: string;
     /**
-     * Texto visible de la zona de arrastre. Default: "Arrastra archivos aquí" (castellano).
-     * Una app multiidioma debe pasarlo traducido — igual que el resto de props de texto.
+     * Locale con el que se escriben **los pesos** («2,5 MB» / «2.5 MB»). No
+     * decide el idioma de los textos —eso es el catálogo— sino el formato de la
+     * cifra. Default `'es-ES'`.
+     */
+    locale?: string;
+    /**
+     * Texto visible de la zona de arrastre. **Sin default**: sin él, sale de
+     * `fileUpload.dropzone` del `BrandMessagesProvider`.
      */
     dropzoneLabel?: string;
-    /** Texto visible mientras se arrastra encima. Default: "Suelta los archivos aquí" */
+    /**
+     * Texto visible mientras se arrastra encima. **Sin default**: sin él, sale
+     * de `fileUpload.dropzoneActive`.
+     */
     dropzoneActiveLabel?: string;
-    /** Texto visible secundario de la zona. Default: "o haz clic para seleccionar" */
+    /**
+     * Texto visible secundario de la zona. **Sin default**: sin él, sale de
+     * `fileUpload.dropzoneHint`.
+     */
     dropzoneHintLabel?: string;
-    /** Pista de tamaño máximo. Default: `máx. ${size}` (el tamaño ya viene formateado) */
+    /**
+     * Pista de peso máximo. Recibe el peso **ya escrito en el locale**.
+     * **Sin default**: sin ella, sale de `fileUpload.maxSize`.
+     */
     maxSizeHint?: (maxSize: string) => string;
-    /** Pista de número máximo de archivos. Default: `hasta ${n} archivos` */
+    /**
+     * Pista de número máximo de archivos. **Sin default**: sin ella, sale de
+     * `fileUpload.maxFiles`.
+     */
     maxFilesHint?: (maxFiles: number) => string;
-    /** aria-label de la lista de archivos. Default: "Archivos seleccionados" */
+    /**
+     * aria-label de la lista de archivos. **Sin default**: sin él, sale de
+     * `fileUpload.files`.
+     */
     filesLabel?: string;
-    /** aria-label de la barra de progreso. Default: "Progreso de subida" */
+    /**
+     * aria-label de la barra de progreso. **Sin default**: sin él, sale de
+     * `fileUpload.progress`.
+     */
     progressLabel?: string;
-    /** aria-label del botón de eliminar archivo. Default: `Eliminar ${nombre}` */
+    /**
+     * aria-label del botón de quitar un archivo. **Sin default**: sin él, sale
+     * de `fileUpload.removeFile`.
+     */
     removeFileLabel?: (fileName: string) => string;
-    /** Error de archivo demasiado grande. Default: `Archivo demasiado grande (máx. ${size})` */
+    /**
+     * Error de archivo demasiado pesado. **Sin default**: sin él, sale de
+     * `fileUpload.tooLarge`.
+     */
     tooLargeError?: (maxSize: string) => string;
-    /** Error de tipo no admitido. Default: "Tipo de archivo no permitido" */
+    /**
+     * Error de tipo no admitido. **Sin default**: sin él, sale de
+     * `fileUpload.invalidType`.
+     */
     invalidTypeError?: string;
 }
 /**

package/dist/_types/atoms/FileUpload/validate.d.ts

@@ -4,11 +4,44 @@
  * otra cosa (la diana es el avatar, no una zona de arrastre), pero acepta y
  * rechaza exactamente por la misma regla, y una segunda copia de esta función
  * sería una segunda definición de qué archivo vale.
+ *
+ * Aquí vive además la mitad **de formato** de esta familia: el peso escrito y
+ * la lista de formatos. La regla de la campaña del proveedor es la misma que
+ * en la máscara de fecha: *si cambia al cambiar de idioma es cromo y va al
+ * catálogo; si cambia al cambiar de país es formato y sale del `locale`*.
  */
-/** El peso de un archivo, en la unidad que toque. */
-export declare function formatBytes(bytes: number): string;
+/** El locale que se usa cuando el componente no recibe ninguno. */
+export declare const DEFAULT_LOCALE = "es-ES";
+/**
+ * El peso de un archivo, escrito **en el locale**: `2,5 MB` en `es-ES` y
+ * `2.5 MB` en `en-US`.
+ *
+ * «2,5 MB» tiene dos mitades, igual que `dd/mm/aaaa`:
+ *
+ * - **El símbolo no se traduce.** `MB` es `MB` en las seis lenguas de la
+ *   suite; no es una palabra, es una unidad del SI.
+ * - **El separador decimal y la colocación del sufijo son formato.** La coma
+ *   o el punto, el espacio antes de la unidad y hasta si va delante o detrás
+ *   los decide el `locale`, no el idioma de la interfaz.
+ *
+ * Por eso esto no es una plantilla del catálogo sino `Intl.NumberFormat` con
+ * `style: 'unit'`: la cifra la escribe el navegador. Al catálogo va solo la
+ * frase que la envuelve («Máximo {size}»), que sí es cromo.
+ */
+export declare function formatFileSize(bytes: number, locale?: string): string;
+/**
+ * Una lista de cosas escrita con la conjunción del idioma: `JPEG, PNG o WEBP`
+ * en castellano, `JPEG, PNG, or WEBP` en inglés, `JPEG, PNG oder WEBP` en
+ * alemán.
+ *
+ * Es `Intl.ListFormat` y no un `join(', ')` con una «o» pegada: la conjunción,
+ * la coma de Oxford y el espaciado cambian de una lengua a otra, y pegarlos a
+ * mano deja el texto en castellano dentro de una frase traducida. `disjunction`
+ * porque se acepta **uno** de los formatos, no todos.
+ */
+export declare function formatList(items: string[], locale?: string): string;
 /**
  * `null` si el archivo pasa; si no, el mensaje que lo explica. Los mensajes
  * los pone quien llama: son texto de producto, no de esta función.
  */
-export declare function validateFile(file: File, accept: string | undefined, maxSize: number | undefined, tooLargeError: (maxSize: string) => string, invalidTypeError: string): string | null;
+export declare function validateFile(file: File, accept: string | undefined, maxSize: number | undefined, tooLargeError: (maxSize: string) => string, invalidTypeError: string, locale?: string): string | null;

package/dist/_types/atoms/TimeSelect/TimeSelect.d.ts

@@ -1,4 +1,26 @@
 import './TimeSelect.css';
+/**
+ * El cromo de la hora: cómo se llaman los dos desplegables y qué pone dentro
+ * mientras no hay hora elegida.
+ *
+ * **Las dos máscaras también son idioma, no formato.** `HH` y `MM` parecen
+ * notación técnica, pero son la inicial de una palabra —hora y minuto— y
+ * cambian con ella: en alemán se escriben `SS`/`MM` (*Stunde*, *Minute*). Lo
+ * que NO se traduce es el dibujo: dos cifras, la hora antes que el minuto y
+ * los dos puntos en medio; eso no lo decide ni la prop ni el catálogo.
+ *
+ * Las **cifras de las opciones** (`00`…`23`) tampoco están aquí: son datos.
+ */
+export interface TimeSelectMessages {
+    /** Nombre accesible del desplegable de horas. */
+    hours: string;
+    /** Nombre accesible del desplegable de minutos. */
+    minutes: string;
+    /** Máscara del desplegable de horas sin valor: `HH`. */
+    maskHours: string;
+    /** Máscara del desplegable de minutos sin valor: `MM`. */
+    maskMinutes: string;
+}
 export interface TimeValue {
     h: number;
     m: number;
@@ -27,18 +49,24 @@ export interface TimeSelectProps {
     /** Se añade DESPUÉS de las clases propias del componente. */
     className?: string;
     /**
-     * aria-label del selector de horas. Default: "Horas" (castellano).
-     * Una app multiidioma debe pasarla traducida.
+     * aria-label del selector de horas. **Sin default**: sin él, el texto sale
+     * de `timeSelect.hours` del `BrandMessagesProvider`.
      */
     hoursLabel?: string;
     /**
-     * aria-label del selector de minutos. Default: "Minutos" (castellano).
-     * Una app multiidioma debe pasarla traducida.
+     * aria-label del selector de minutos. **Sin default**: sin él, sale de
+     * `timeSelect.minutes` del `BrandMessagesProvider`.
      */
     minutesLabel?: string;
-    /** Placeholder del selector de horas. Default: "HH" */
+    /**
+     * Máscara del selector de horas. **Sin default**: sin ella, sale de
+     * `timeSelect.maskHours` del `BrandMessagesProvider`.
+     */
     hoursPlaceholder?: string;
-    /** Placeholder del selector de minutos. Default: "MM" */
+    /**
+     * Máscara del selector de minutos. **Sin default**: sin ella, sale de
+     * `timeSelect.maskMinutes` del `BrandMessagesProvider`.
+     */
     minutesPlaceholder?: string;
 }
 /**

package/dist/_types/messages/BrandMessages.d.ts

@@ -13,6 +13,12 @@ import type { AsyncMultiSelectMessages } from '../atoms/AsyncMultiSelect/AsyncMu
 import type { DocsSearchMessages } from '../molecules/DocsSearch/DocsSearch';
 import type { SearchFormMessages } from '../molecules/SearchForm/SearchForm';
 import type { FilterBarMessages } from '../molecules/FilterBar/FilterBar';
+import type { CalendarMessages } from '../molecules/Calendar/Calendar';
+import type { DatePickerMessages } from '../molecules/DatePicker/DatePicker';
+import type { TimeSelectMessages } from '../atoms/TimeSelect/TimeSelect';
+import type { FileUploadMessages } from '../atoms/FileUpload/FileUpload';
+import type { ImageCropDialogMessages } from '../molecules/ImageCropDialog/ImageCropDialog';
+import type { AvatarUploadMessages } from '../molecules/AvatarUpload/AvatarUpload';
 /**
  * El contrato de textos de la librería: un espacio por componente, y dentro
  * de cada espacio **todas las claves obligatorias**.
@@ -50,5 +56,11 @@ export interface BrandMessages {
     docsSearch: DocsSearchMessages;
     searchForm: SearchFormMessages;
     filterBar: FilterBarMessages;
+    calendar: CalendarMessages;
+    datePicker: DatePickerMessages;
+    timeSelect: TimeSelectMessages;
+    fileUpload: FileUploadMessages;
+    imageCropDialog: ImageCropDialogMessages;
+    avatarUpload: AvatarUploadMessages;
 }
-export type { PaginationMessages, TableMessages, DataTableMessages, InputFieldMessages, PasswordFieldMessages, SelectMessages, MultiSelectMessages, NumberInputMessages, OtpInputMessages, InputPhoneMessages, AsyncSelectMessages, AsyncMultiSelectMessages, DocsSearchMessages, SearchFormMessages, FilterBarMessages, };
+export type { PaginationMessages, TableMessages, DataTableMessages, InputFieldMessages, PasswordFieldMessages, SelectMessages, MultiSelectMessages, NumberInputMessages, OtpInputMessages, InputPhoneMessages, AsyncSelectMessages, AsyncMultiSelectMessages, DocsSearchMessages, SearchFormMessages, FilterBarMessages, CalendarMessages, DatePickerMessages, TimeSelectMessages, FileUploadMessages, ImageCropDialogMessages, AvatarUploadMessages, };

package/dist/_types/messages/index.d.ts

@@ -2,4 +2,4 @@ export { BrandMessagesProvider } from './BrandMessagesProvider';
 export type { BrandMessagesProviderProps } from './BrandMessagesProvider';
 export { useBrandMessages } from './BrandMessagesContext';
 export type { BrandMessagesReader } from './BrandMessagesContext';
-export type { BrandMessages, PaginationMessages, TableMessages, DataTableMessages, InputFieldMessages, PasswordFieldMessages, SelectMessages, MultiSelectMessages, NumberInputMessages, OtpInputMessages, InputPhoneMessages, AsyncSelectMessages, AsyncMultiSelectMessages, DocsSearchMessages, SearchFormMessages, FilterBarMessages, } from './BrandMessages';
+export type { BrandMessages, PaginationMessages, TableMessages, DataTableMessages, InputFieldMessages, PasswordFieldMessages, SelectMessages, MultiSelectMessages, NumberInputMessages, OtpInputMessages, InputPhoneMessages, AsyncSelectMessages, AsyncMultiSelectMessages, DocsSearchMessages, SearchFormMessages, FilterBarMessages, CalendarMessages, DatePickerMessages, TimeSelectMessages, FileUploadMessages, ImageCropDialogMessages, AvatarUploadMessages, } from './BrandMessages';

package/dist/_types/molecules/AvatarUpload/AvatarUpload.d.ts

@@ -1,6 +1,53 @@
 import { type ReactNode } from 'react';
 import { type FormSize } from '../../constants/form-size';
 import './AvatarUpload.css';
+/**
+ * El cromo de la subida de avatar. Todo lo de aquí vale igual en la pantalla
+ * de la cuenta y en la de la organización; lo que cambia entre las dos —qué se
+ * sube— entra por `subject`, que es contenido y sigue siendo prop.
+ *
+ * **El par visible/accesible del botón está aquí entero, y a propósito.**
+ * WCAG 2.5.3 (Label in Name) exige que el nombre accesible **contenga** el
+ * texto visible: quien navega por voz dice lo que ve. Si el visible saliera
+ * del catálogo común («Subir») y el accesible de la pantalla («Subir logo»),
+ * los dos lados del contrato vivirían en ficheros distintos y una traducción
+ * podría romperlo sin que nada fallara — el botón quedaría inalcanzable por
+ * voz. Por eso el catálogo trae los dos: `button`, el verbo suelto, y
+ * `buttonFor`, la **plantilla** que lo envuelve con el sujeto.
+ *
+ * La plantilla, y no una concatenación en el componente, porque el orden es
+ * del idioma: «Subir el logo» y *«Upload the logo»* ponen el verbo delante,
+ * pero el alemán lo pone al final («das Logo hochladen»). Un `${verbo}
+ * ${sujeto}` cableado aquí sería castellano disfrazado.
+ *
+ * **La regla del catálogo, en una línea: `buttonFor(x)` tiene que contener
+ * `button`.** En desarrollo se avisa por consola si no lo cumple.
+ */
+export interface AvatarUploadMessages {
+    /** Texto **visible** del botón: el verbo suelto («Subir»). */
+    button: string;
+    /**
+     * Nombre **accesible** del botón, con el sujeto dentro («Subir el logo»).
+     * Tiene que contener `button`, o WCAG 2.5.3 se rompe.
+     */
+    buttonFor: (subject: string) => string;
+    /** Qué se sube cuando la pantalla no lo dice: el sujeto genérico («el avatar»). */
+    subject: string;
+    /** Pista **visible** de que además se puede arrastrar. */
+    dropHint: (subject: string) => string;
+    /** Lo que se anuncia cuando empieza un arrastre sobre la ventana. */
+    dropActive: (subject: string) => string;
+    /** Pista de peso máximo. Recibe el peso **ya escrito en el locale** («2,5 MB»). */
+    maxSize: (maxSize: string) => string;
+    /** Error de formato. Recibe los formatos **ya unidos con la conjunción del idioma**. */
+    invalidType: (formats: string) => string;
+    /** Error de peso. Recibe el peso ya escrito en el locale. */
+    tooLarge: (maxSize: string) => string;
+    /** Texto del botón que descarta el recorte. */
+    cropCancel: string;
+    /** Texto del botón que confirma el recorte. */
+    cropConfirm: string;
+}
 export interface AvatarUploadProps {
     /** URL de la imagen actual. Sin ella, el avatar enseña las iniciales de `name`. */
     src?: string | null;
@@ -36,16 +83,31 @@ export interface AvatarUploadProps {
     /** Un archivo rechazado por la validación de cliente, con el mensaje que se enseña. */
     onError?: (message: string) => void;
     /**
-     * Texto **visible** del botón. Default: "Subir" (castellano).
-     * Corto a propósito: el nombre completo va en `buttonAccessibleLabel`.
+     * **Qué** se sube, como sintagma con artículo: `"el logo"`, `"la foto de
+     * perfil"`. Es lo único de esta pieza que cambia de una pantalla a otra, así
+     * que es contenido y entra por aquí, del catálogo de la aplicación.
+     *
+     * Con él se arman el nombre accesible del botón, la pista de arrastre y el
+     * aviso de soltar, cada uno con su plantilla del catálogo. Sin él, el sujeto
+     * genérico de `avatarUpload.subject` («el avatar»).
+     */
+    subject?: string;
+    /**
+     * Texto **visible** del botón. **Sin default**: sin él, sale de
+     * `avatarUpload.button` del `BrandMessagesProvider`.
+     *
+     * Corto a propósito: el sujeto va en el nombre accesible, que se arma con
+     * `subject`.
      */
     buttonLabel?: string;
     /**
-     * Nombre **accesible** del botón, para decir de qué es la subida ("Subir
-     * logo", "Subir avatar"). Por defecto, `buttonLabel`.
+     * Nombre **accesible** del botón, entero. Es la salida de emergencia: lo
+     * normal es pasar `subject` y dejar que el catálogo lo arme, porque así el
+     * verbo visible y el accesible salen del mismo sitio y no se pueden
+     * desparejar al traducir.
      *
      * WCAG 2.5.3 (Label in Name) exige que **contenga** el texto visible: quien
-     * navega por voz dice lo que ve. "Subir" dentro de "Subir logo" cumple;
+     * navega por voz dice lo que ve. "Subir" dentro de "Subir el logo" cumple;
      * "Cargar imagen de la organización" no, y deja el control inalcanzable.
      * En desarrollo se avisa por consola si no lo contiene.
      */
@@ -58,51 +120,87 @@ export interface AvatarUploadProps {
     hintLabel?: string;
     /**
      * Los formatos, escritos para leer. Default: los subtipos de `accept` en
-     * mayúsculas. Con comodines (`image/*`) pásalo escrito.
+     * mayúsculas, unidos con la conjunción del `locale` (`JPEG, PNG o WEBP`).
+     * Con comodines (`image/*`) pásalo escrito.
      */
     formatsLabel?: string;
-    /** Pista de peso máximo. Default: `máx. ${size}` (el peso ya viene formateado). */
+    /**
+     * Locale con el que se escriben **el peso** («2,5 MB» / «2.5 MB») y **la
+     * conjunción de la lista de formatos** («o» / «or» / «oder»). No decide el
+     * idioma de los textos —eso es el catálogo— sino el formato. Default
+     * `'es-ES'`.
+     */
+    locale?: string;
+    /**
+     * Pista de peso máximo. Recibe el peso **ya escrito en el locale**.
+     * **Sin default**: sin ella, sale de `avatarUpload.maxSize`.
+     */
     maxSizeHint?: (maxSize: string) => string;
     /**
-     * Error de formato. Default: `Formato no admitido. Se aceptan ${formatos}.`
-     * Dice lo que SÍ se acepta: por el botón el error es imposible (lo filtra el
-     * diálogo del sistema), pero soltando un archivo no hay filtro que valga.
+     * Error de formato. **Sin default**: sin él, sale de
+     * `avatarUpload.invalidType`. Dice lo que SÍ se acepta: por el botón el
+     * error es imposible (lo filtra el diálogo del sistema), pero soltando un
+     * archivo no hay filtro que valga.
      */
     invalidTypeError?: (formats: string) => string;
-    /** Error de peso. Default: `El archivo pesa demasiado. El máximo es ${max}.` */
+    /**
+     * Error de peso. **Sin default**: sin él, sale de `avatarUpload.tooLarge`.
+     */
     tooLargeError?: (maxSize: string) => string;
     /**
-     * Lo que se anuncia cuando empieza un arrastre sobre la ventana.
-     * Default: "Suelta la imagen sobre el avatar para subirla".
+     * Lo que se anuncia cuando empieza un arrastre sobre la ventana. **Sin
+     * default**: sin él, `avatarUpload.dropActive` con el `subject`.
      */
     dropActiveMessage?: string;
     /**
      * Pista **visible** bajo el botón: dice que además se puede arrastrar, que
-     * es lo único de esta pieza que no se adivina mirándola. Default castellano:
-     * "…o arrastra la imagen hasta el avatar". Con cadena vacía no se pinta.
+     * es lo único de esta pieza que no se adivina mirándola. **Sin default**:
+     * sin ella, `avatarUpload.dropHint` con el `subject`. Con cadena vacía no se
+     * pinta.
      */
     dropHintLabel?: string;
     /**
-     * Título del diálogo de recorte. Default: "Recortar imagen" (castellano).
-     * Es una acción, no una invitación: nombra lo que va a pasar, sin segunda
-     * persona, como el resto de títulos de diálogo del sistema.
+     * Título del diálogo de recorte. **Obligatorio y sin default**, como el
+     * `title` del propio `ImageCropDialog`: el diálogo no sabe qué se recorta
+     * («Recorta tu foto», «Recorta tu logo») y eso es contenido de la pantalla.
      */
-    cropTitle?: string;
+    cropTitle: string;
     /**
      * Descripción del diálogo de recorte. **Sin default**: el diálogo enseña la
      * imagen y su marco de selección, que se explican solos. Pásala solo si en
      * tu caso hay algo que decir que no esté ya a la vista.
      */
     cropDescription?: ReactNode;
-    /** Default: "Cancelar". */
+    /**
+     * Texto del botón que descarta el recorte. **Sin default**: sin él, sale de
+     * `avatarUpload.cropCancel`.
+     *
+     * Aquí sí sale del catálogo, al revés que en `ImageCropDialog`: el diálogo
+     * genérico no sabe qué confirma («Aplicar», «Usar esta imagen») y por eso lo
+     * exige; esta subida sí lo sabe —se descarta o se guarda un recorte— y el
+     * par vale igual en todas las pantallas.
+     */
     cropCancelLabel?: ReactNode;
-    /** Default: "Guardar". */
+    /**
+     * Texto del botón que confirma el recorte. **Sin default**: sin él, sale de
+     * `avatarUpload.cropConfirm`.
+     */
     cropConfirmLabel?: ReactNode;
-    /** Etiqueta del aspa de cerrar. Default: "Cerrar". */
+    /**
+     * Etiqueta del aspa de cerrar. Se reenvía **tal cual** al `ImageCropDialog`
+     * y de ahí al `Modal`, que todavía no lee del proveedor: mientras no se
+     * migre, sin esta prop el aspa dice lo que diga `Modal`.
+     */
     cropCloseLabel?: string;
-    /** Lo que se dice mientras la imagen se carga en el diálogo. Default: "Cargando imagen…". */
+    /**
+     * Lo que se dice mientras la imagen se carga en el diálogo. Reenvío puro:
+     * sin él, el `ImageCropDialog` lo lee de `imageCropDialog.loading`.
+     */
     cropLoadingLabel?: string;
-    /** Lo que se dice cuando la imagen no se puede cargar. Default: "No hemos podido cargar la imagen. Prueba con otro archivo.". */
+    /**
+     * Lo que se dice cuando la imagen no se puede cargar. Reenvío puro: sin él,
+     * el `ImageCropDialog` lo lee de `imageCropDialog.error`.
+     */
     cropErrorMessage?: string;
     /** Se añade DESPUÉS de las clases propias del componente. */
     className?: string;
@@ -122,4 +220,4 @@ export interface AvatarUploadProps {
  * arrastrar no existe para el teclado, así que es la vía principal, no un
  * respaldo.
  */
-export declare function AvatarUpload({ src, name, alt, shape, size: sizeProp, accept, maxSize, outputMimeType, outputSize, disabled, busy, errorMessage, onChange, onSelect, onError, buttonLabel, buttonAccessibleLabel, hintLabel, formatsLabel, maxSizeHint, invalidTypeError, tooLargeError, dropActiveMessage, dropHintLabel, cropTitle, cropDescription, cropCancelLabel, cropConfirmLabel, cropCloseLabel, cropLoadingLabel, cropErrorMessage, className, }: AvatarUploadProps): import("react/jsx-runtime").JSX.Element;
+export declare function AvatarUpload({ src, name, alt, shape, size: sizeProp, accept, maxSize, outputMimeType, outputSize, disabled, busy, errorMessage, onChange, onSelect, onError, subject: subjectProp, buttonLabel, buttonAccessibleLabel, hintLabel, formatsLabel, locale, maxSizeHint, invalidTypeError, tooLargeError, dropActiveMessage, dropHintLabel, cropTitle, cropDescription, cropCancelLabel, cropConfirmLabel, cropCloseLabel, cropLoadingLabel, cropErrorMessage, className, }: AvatarUploadProps): import("react/jsx-runtime").JSX.Element;

package/dist/_types/molecules/Calendar/Calendar.d.ts

@@ -1,4 +1,32 @@
 import './Calendar.css';
+/**
+ * El cromo del calendario: las dos flechas —que cambian de nombre según la
+ * vista— y el rótulo de la rejilla de años. Dicen lo mismo en toda la suite,
+ * así que salen del catálogo y no de una prop por uso.
+ *
+ * **Lo que NO está aquí, y no es olvido:** los nombres de los meses, los de
+ * los días de la semana, las cifras del año y el nombre accesible de cada
+ * celda («lunes, 15 de enero de 2025»). Eso no es texto de interfaz sino
+ * **formato de fecha**: sale de `locale` con `Intl`, que además es quien sabe
+ * en qué día empieza la semana y con qué cifras se escribe el año. Traducirlo
+ * por catálogo sería reescribir a mano lo que el navegador ya trae bien.
+ *
+ * Tampoco está `gridLabel`: nombra a ESTE calendario («Fecha de alta»), que
+ * es contenido de la pantalla. Sin él la rejilla toma como nombre el título
+ * del mes visible, que ya viene del locale.
+ */
+export interface CalendarMessages {
+    /** Nombre accesible de la flecha de retroceso sobre la rejilla de días. */
+    previousMonth: string;
+    /** Nombre accesible de la flecha de avance sobre la rejilla de días. */
+    nextMonth: string;
+    /** Nombre accesible de la flecha de retroceso sobre la rejilla de años. */
+    previousYears: string;
+    /** Nombre accesible de la flecha de avance sobre la rejilla de años. */
+    nextYears: string;
+    /** Nombre accesible de la rejilla de años. */
+    yearGrid: string;
+}
 export interface CalendarProps {
     /** Fecha seleccionada (modo controlado) */
     value?: Date | null;
@@ -21,34 +49,37 @@ export interface CalendarProps {
     /** Locale para nombres de mes y día. Default: 'es-ES' */
     locale?: string;
     /**
-     * aria-label del botón de mes anterior. Default: "Mes anterior" (castellano).
-     * Una app multiidioma debe pasarla traducida.
+     * aria-label del botón de mes anterior. **Sin default**: sin él, el texto
+     * sale de `calendar.previousMonth` del `BrandMessagesProvider`.
      */
     previousMonthLabel?: string;
     /**
-     * aria-label del botón de mes siguiente. Default: "Mes siguiente" (castellano).
-     * Una app multiidioma debe pasarla traducida.
+     * aria-label del botón de mes siguiente. **Sin default**: sin él, el texto
+     * sale de `calendar.nextMonth` del `BrandMessagesProvider`.
      */
     nextMonthLabel?: string;
     /**
-     * aria-label del botón de retroceso **en la vista de años**. Default: "Años
-     * anteriores" (castellano). Una app multiidioma debe pasarla traducida.
+     * aria-label del botón de retroceso **en la vista de años**. **Sin
+     * default**: sin él, sale de `calendar.previousYears` del
+     * `BrandMessagesProvider`.
      */
     previousYearsLabel?: string;
     /**
-     * aria-label del botón de avance en la vista de años. Default: "Años
-     * siguientes" (castellano).
+     * aria-label del botón de avance en la vista de años. **Sin default**: sin
+     * él, sale de `calendar.nextYears` del `BrandMessagesProvider`.
      */
     nextYearsLabel?: string;
     /**
-     * aria-label de la rejilla de años. Default: "Elegir año" (castellano).
+     * aria-label de la rejilla de años. **Sin default**: sin él, sale de
+     * `calendar.yearGrid` del `BrandMessagesProvider`.
      */
     yearGridLabel?: string;
     /**
-     * aria-label de la rejilla de días. Sin ella, la rejilla toma como nombre el
-     * título del mes visible. Cuando el calendario vive dentro de un panel con
-     * nombre propio (el `Popover` de `DatePicker`), conviene pasarlo aquí.
-     * Es texto visible para lectores: una app multiidioma debe pasarlo traducido.
+     * aria-label de la rejilla de días. **No sale del catálogo**: nombra a ESTE
+     * calendario («Fecha de alta»), que es contenido de la pantalla. Sin ella,
+     * la rejilla toma como nombre el título del mes visible. Cuando el
+     * calendario vive dentro de un panel con nombre propio (el `Popover` de
+     * `DatePicker`), conviene pasarlo aquí.
      */
     gridLabel?: string;
     /** Tamaño del componente. Default: 'md' */

package/dist/_types/molecules/CalendarPlanner/CalendarPlanner.d.ts

@@ -43,13 +43,14 @@ export interface CalendarPlannerProps {
     /** Locale para nombres de mes y día. Default: 'es-ES' */
     locale?: string;
     /**
-     * aria-label del botón de mes anterior. Default: "Mes anterior" (castellano).
-     * Una app multiidioma debe pasarla traducida.
+     * aria-label del botón de mes anterior. **Sin default**: sin él, sale de
+     * `calendar.previousMonth` del `BrandMessagesProvider` — es el mismo texto
+     * que el del `Calendar`, así que es el mismo espacio.
      */
     previousMonthLabel?: string;
     /**
-     * aria-label del botón de mes siguiente. Default: "Mes siguiente" (castellano).
-     * Una app multiidioma debe pasarla traducida.
+     * aria-label del botón de mes siguiente. **Sin default**: sin él, sale de
+     * `calendar.nextMonth` del `BrandMessagesProvider`.
      */
     nextMonthLabel?: string;
     /**

package/dist/_types/molecules/CalendarRoster/CalendarRoster.d.ts

@@ -62,13 +62,14 @@ export interface CalendarRosterProps {
      */
     legendLabel?: string;
     /**
-     * aria-label del botón de mes anterior. Default: "Mes anterior" (castellano).
-     * Una app multiidioma debe pasarla traducida.
+     * aria-label del botón de mes anterior. **Sin default**: sin él, sale de
+     * `calendar.previousMonth` del `BrandMessagesProvider` — es el mismo texto
+     * que el del `Calendar`, así que es el mismo espacio.
      */
     previousMonthLabel?: string;
     /**
-     * aria-label del botón de mes siguiente. Default: "Mes siguiente" (castellano).
-     * Una app multiidioma debe pasarla traducida.
+     * aria-label del botón de mes siguiente. **Sin default**: sin él, sale de
+     * `calendar.nextMonth` del `BrandMessagesProvider`.
      */
     nextMonthLabel?: string;
     /** Locale para nombres de mes y día. Default: 'es-ES' */