@studiolxd/brand 43.0.0 → 44.1.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/messages/BrandMessages.d.ts

@@ -16,6 +16,9 @@ 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**.
@@ -56,5 +59,8 @@ export interface BrandMessages {
     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, CalendarMessages, DatePickerMessages, TimeSelectMessages, };
+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, CalendarMessages, DatePickerMessages, TimeSelectMessages, } 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/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' */

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

@@ -1,6 +1,25 @@
 import { type ReactNode } from 'react';
 import 'react-image-crop/dist/ReactCrop.css';
 import './ImageCropDialog.css';
+/**
+ * El cromo del recortador, y **solo el cromo**: lo que el diálogo dice por su
+ * cuenta mientras la imagen va y viene.
+ *
+ * Aquí se ve la distinción que gobierna la campaña entera. El título, el
+ * «Cancelar» y el «Guardar» **no** están en este espacio y siguen siendo props
+ * obligatorias sin valor por defecto: el diálogo no sabe qué se está
+ * recortando —una foto de perfil, un logo, la portada de un curso— ni qué pasa
+ * al confirmar, y eso es contenido de la pantalla que lo abre, no un rótulo
+ * del sistema. Lo que sí sabe es que la imagen puede tardar y puede fallar: el
+ * aviso de carga y el de error son suyos, valen igual en todas las pantallas y
+ * por eso salen del catálogo.
+ */
+export interface ImageCropDialogMessages {
+    /** Lo que se dice mientras la imagen se descarga y descodifica. Se anuncia y se ve. */
+    loading: string;
+    /** Lo que se dice cuando la imagen no se puede cargar. */
+    error: string;
+}
 export interface ImageCropDialogProps {
     /** Object URL del fichero elegido; el diálogo está abierto mientras no sea null. */
     sourceUrl: string | null;
@@ -16,16 +35,21 @@ export interface ImageCropDialogProps {
     busy?: boolean;
     cancelLabel: ReactNode;
     confirmLabel: ReactNode;
-    /** Etiqueta del botón de cierre del diálogo. */
+    /**
+     * Etiqueta del botón de cierre del diálogo. Se reenvía **tal cual** al
+     * `Modal`, que todavía no lee del proveedor: mientras no se migre, sin esta
+     * prop el aspa sigue diciendo lo que diga `Modal`.
+     */
     closeLabel?: string;
     /**
      * Lo que se dice mientras la imagen se descarga y descodifica. Se anuncia y
-     * se ve. Default castellano: «Cargando imagen…».
+     * se ve. **Sin default**: sin él, sale de `imageCropDialog.loading` del
+     * `BrandMessagesProvider`.
      */
     loadingLabel?: string;
     /**
-     * Lo que se dice cuando la imagen no se puede cargar. Default castellano:
-     * «No hemos podido cargar la imagen. Prueba con otro archivo.».
+     * Lo que se dice cuando la imagen no se puede cargar. **Sin default**: sin
+     * él, sale de `imageCropDialog.error` del `BrandMessagesProvider`.
      */
     errorMessage?: string;
     onConfirm: (blob: Blob) => void | Promise<void>;