@studiolxd/brand 41.1.0 → 43.0.0

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

@@ -1,6 +1,21 @@
 import type { PaginationMessages } from '../molecules/Pagination/Pagination';
 import type { TableMessages } from '../molecules/Table/Table';
 import type { DataTableMessages } from '../organisms/DataTable/DataTable';
+import type { InputFieldMessages } from '../molecules/InputField/InputField';
+import type { PasswordFieldMessages } from '../molecules/PasswordField/PasswordField';
+import type { SelectMessages } from '../atoms/Select/Select';
+import type { MultiSelectMessages } from '../atoms/MultiSelect/MultiSelect';
+import type { NumberInputMessages } from '../atoms/NumberInput/NumberInput';
+import type { OtpInputMessages } from '../atoms/OtpInput/OtpInput';
+import type { InputPhoneMessages } from '../atoms/InputPhone/InputPhone';
+import type { AsyncSelectMessages } from '../atoms/AsyncSelect/AsyncSelect';
+import type { AsyncMultiSelectMessages } from '../atoms/AsyncMultiSelect/AsyncMultiSelect';
+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';
 /**
  * El contrato de textos de la librería: un espacio por componente, y dentro
  * de cada espacio **todas las claves obligatorias**.
@@ -26,5 +41,20 @@ export interface BrandMessages {
     pagination: PaginationMessages;
     table: TableMessages;
     dataTable: DataTableMessages;
+    inputField: InputFieldMessages;
+    passwordField: PasswordFieldMessages;
+    select: SelectMessages;
+    multiSelect: MultiSelectMessages;
+    numberInput: NumberInputMessages;
+    otpInput: OtpInputMessages;
+    inputPhone: InputPhoneMessages;
+    asyncSelect: AsyncSelectMessages;
+    asyncMultiSelect: AsyncMultiSelectMessages;
+    docsSearch: DocsSearchMessages;
+    searchForm: SearchFormMessages;
+    filterBar: FilterBarMessages;
+    calendar: CalendarMessages;
+    datePicker: DatePickerMessages;
+    timeSelect: TimeSelectMessages;
 }
-export type { PaginationMessages, TableMessages, DataTableMessages };
+export type { PaginationMessages, TableMessages, DataTableMessages, InputFieldMessages, PasswordFieldMessages, SelectMessages, MultiSelectMessages, NumberInputMessages, OtpInputMessages, InputPhoneMessages, AsyncSelectMessages, AsyncMultiSelectMessages, DocsSearchMessages, SearchFormMessages, FilterBarMessages, CalendarMessages, DatePickerMessages, TimeSelectMessages, };

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, } from './BrandMessages';
+export type { BrandMessages, PaginationMessages, TableMessages, DataTableMessages, InputFieldMessages, PasswordFieldMessages, SelectMessages, MultiSelectMessages, NumberInputMessages, OtpInputMessages, InputPhoneMessages, AsyncSelectMessages, AsyncMultiSelectMessages, DocsSearchMessages, SearchFormMessages, FilterBarMessages, CalendarMessages, DatePickerMessages, TimeSelectMessages, } from './BrandMessages';

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/DatePicker/DatePicker.d.ts

@@ -1,6 +1,38 @@
 import type { CalendarProps } from '../Calendar/Calendar';
 import { type DateMaskLetters } from './dateMask';
 import './DatePicker.css';
+/**
+ * El cromo del selector de fecha: el botón que abre el calendario, el aviso de
+ * fecha incompleta, el nombre del panel y **las letras de la máscara**.
+ *
+ * Las letras están aquí a propósito, y son el caso interesante de esta
+ * familia. `dd/mm/aaaa` tiene dos mitades que no se deciden igual:
+ *
+ * - **El orden y el separador son formato**: que `es` escriba 25/09/2026,
+ *   `en-US` 09/25/2026 y `de` 25.09.2026 sale del `locale` con `Intl`
+ *   (`dateMask.ts`), no de una prop ni del catálogo. Una app en inglés
+ *   mostrando fechas españolas las quiere en orden español.
+ * - **Las letras son idioma**: `aaaa` es «año», `yyyy` es *year* y `jjjj` es
+ *   *Jahr*. Son la abreviatura de una palabra, así que se traducen — y por eso
+ *   son cromo y salen del catálogo, como cualquier otro rótulo.
+ *
+ * Por eso el catálogo trae solo las tres letras y no la máscara montada: la
+ * máscara la arma el componente poniendo las letras en el orden del locale.
+ */
+export interface DatePickerMessages {
+    /** Nombre accesible del botón que abre el calendario. */
+    openCalendar: string;
+    /** Aviso de fecha incompleta o inexistente, anunciado con `role="alert"`. */
+    invalid: string;
+    /** Nombre accesible del panel del calendario (`role="dialog"`). */
+    calendar: string;
+    /**
+     * Las letras de la máscara, una por parte: `{ day: 'dd', month: 'mm',
+     * year: 'aaaa' }`. El orden y el separador NO están aquí: salen del
+     * `locale`.
+     */
+    maskLetters: DateMaskLetters;
+}
 export interface DatePickerProps {
     value?: Date | null;
     /**
@@ -9,23 +41,28 @@ export interface DatePickerProps {
      */
     onChange?: (date: Date | null) => void;
     /**
-     * Pista dentro del campo. Por defecto, la máscara del locale con las letras
-     * castellanas (`dd/mm/aaaa`, `mm/dd/aaaa` en `en-US`). Una app multiidioma
-     * pasa `maskLetters` para traducir las letras sin tocar el orden.
+     * Pista dentro del campo. Sin ella, la máscara del locale con las letras
+     * del catálogo (`dd/mm/aaaa`, `mm/dd/aaaa` en `en-US`). Es la anulación
+     * puntual: un campo que quiere decir otra cosa («Desde») la pasa.
      */
     placeholder?: string;
     /**
-     * Letras de la máscara del marcador de posición. Default castellano
-     * (`{ day: 'dd', month: 'mm', year: 'aaaa' }`). El orden y el separador no
-     * son props: salen del `locale` con `Intl`.
+     * Letras de la máscara del marcador de posición. **Sin default**: sin
+     * ellas, salen de `datePicker.maskLetters` del `BrandMessagesProvider`. El
+     * orden y el separador no son props ni catálogo: salen del `locale` con
+     * `Intl`.
      */
     maskLetters?: DateMaskLetters;
     /**
-     * Mensaje cuando lo escrito no es una fecha completa y válida. Default
-     * castellano; se anuncia con `role="alert"`.
+     * Mensaje cuando lo escrito no es una fecha completa y válida. **Sin
+     * default**: sin él, sale de `datePicker.invalid` del
+     * `BrandMessagesProvider`; se anuncia con `role="alert"`.
      */
     invalidMessage?: string;
-    /** Nombre accesible del botón que abre el calendario. Default castellano. */
+    /**
+     * Nombre accesible del botón que abre el calendario. **Sin default**: sin
+     * él, sale de `datePicker.openCalendar` del `BrandMessagesProvider`.
+     */
     openCalendarLabel?: string;
     minDate?: CalendarProps['minDate'];
     maxDate?: CalendarProps['maxDate'];
@@ -43,29 +80,22 @@ export interface DatePickerProps {
     'aria-describedby'?: string;
     /** Nombre accesible cuando el control va suelto. En un campo lo nombra la etiqueta. */
     'aria-label'?: string;
-    /** Nombre accesible del panel del calendario (`role="dialog"`). */
-    calendarLabel?: string;
     /**
-     * aria-label del botón de mes anterior del calendario. Default: «Mes
-     * anterior» (castellano). Una app multiidioma debe pasarla traducida.
+     * Nombre accesible del panel del calendario (`role="dialog"`). **Sin
+     * default**: sin él, sale de `datePicker.calendar` del
+     * `BrandMessagesProvider`. En un campo lo pone la etiqueta del campo, que es
+     * contenido de la pantalla y gana como cualquier prop.
      */
+    calendarLabel?: string;
+    /** aria-label del botón de mes anterior. Sin él, `calendar.previousMonth`. */
     previousMonthLabel?: CalendarProps['previousMonthLabel'];
-    /**
-     * aria-label del botón de mes siguiente. Default: «Mes siguiente»
-     * (castellano).
-     */
+    /** aria-label del botón de mes siguiente. Sin él, `calendar.nextMonth`. */
     nextMonthLabel?: CalendarProps['nextMonthLabel'];
-    /**
-     * aria-label del botón de retroceso **en la vista de años**. Default: «Años
-     * anteriores» (castellano).
-     */
+    /** aria-label del retroceso en la vista de años. Sin él, `calendar.previousYears`. */
     previousYearsLabel?: CalendarProps['previousYearsLabel'];
-    /**
-     * aria-label del botón de avance en la vista de años. Default: «Años
-     * siguientes» (castellano).
-     */
+    /** aria-label del avance en la vista de años. Sin él, `calendar.nextYears`. */
     nextYearsLabel?: CalendarProps['nextYearsLabel'];
-    /** aria-label de la rejilla de años. Default: «Elegir año» (castellano). */
+    /** aria-label de la rejilla de años. Sin él, `calendar.yearGrid`. */
     yearGridLabel?: CalendarProps['yearGridLabel'];
     /**
      * aria-label de la rejilla de días. Por defecto toma `calendarLabel`, que ya

package/dist/_types/molecules/DatePicker/dateMask.d.ts

@@ -1,11 +1,18 @@
 export type DatePartName = 'day' | 'month' | 'year';
-/** Letras de la máscara del marcador de posición: `dd/mm/aaaa` en castellano. */
+/**
+ * Letras de la máscara del marcador de posición, una por parte.
+ *
+ * **No hay juego por defecto, y es deliberado**: las letras se traducen
+ * (`aaaa` es «año», `yyyy` es *year*, `jjjj` es *Jahr*), así que salen del
+ * catálogo de la aplicación —`datePicker.maskLetters`— igual que cualquier
+ * otro rótulo. Lo que este módulo decide es el **orden** y el **separador**,
+ * que son formato y salen del `locale`.
+ */
 export interface DateMaskLetters {
     day: string;
     month: string;
     year: string;
 }
-export declare const SPANISH_MASK_LETTERS: DateMaskLetters;
 export interface DateMask {
     /** Orden de las partes en ese locale, p. ej. `['day', 'month', 'year']`. */
     order: DatePartName[];

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

@@ -33,29 +33,29 @@ export interface DateTimeFieldProps {
     locale?: string;
     /** Se añade DESPUÉS de las clases propias (el consumidor añade, no sustituye). */
     className?: string;
-    /** Nombre accesible del panel del calendario. Default: la etiqueta del campo. */
+    /** Nombre accesible del panel del calendario. Sin él, la etiqueta del campo. */
     calendarLabel?: DatePickerProps['calendarLabel'];
-    /** Nombre accesible del botón que abre el calendario. Default castellano. */
+    /** Nombre accesible del botón que abre el calendario. Sin él, `datePicker.openCalendar`. */
     openCalendarLabel?: DatePickerProps['openCalendarLabel'];
-    /** Mensaje de fecha incompleta del campo de texto. Default castellano. */
+    /** Mensaje de fecha incompleta del campo de texto. Sin él, `datePicker.invalid`. */
     invalidMessage?: DatePickerProps['invalidMessage'];
-    /** Letras de la máscara del marcador de posición. Default castellano. */
+    /** Letras de la máscara del marcador de posición. Sin ellas, `datePicker.maskLetters`. */
     maskLetters?: DatePickerProps['maskLetters'];
-    /** aria-label del botón de mes anterior del calendario. Default castellano. */
+    /** aria-label del botón de mes anterior. Sin él, `calendar.previousMonth`. */
     previousMonthLabel?: DatePickerProps['previousMonthLabel'];
-    /** aria-label del botón de mes siguiente. Default castellano. */
+    /** aria-label del botón de mes siguiente. Sin él, `calendar.nextMonth`. */
     nextMonthLabel?: DatePickerProps['nextMonthLabel'];
-    /** aria-label del botón de retroceso en la vista de años. Default castellano. */
+    /** aria-label del retroceso en la vista de años. Sin él, `calendar.previousYears`. */
     previousYearsLabel?: DatePickerProps['previousYearsLabel'];
-    /** aria-label del botón de avance en la vista de años. Default castellano. */
+    /** aria-label del avance en la vista de años. Sin él, `calendar.nextYears`. */
     nextYearsLabel?: DatePickerProps['nextYearsLabel'];
-    /** aria-label de la rejilla de años. Default castellano. */
+    /** aria-label de la rejilla de años. Sin él, `calendar.yearGrid`. */
     yearGridLabel?: DatePickerProps['yearGridLabel'];
-    /** aria-label de la rejilla de días. Default: `calendarLabel`. */
+    /** aria-label de la rejilla de días. Sin él, el nombre del panel. */
     gridLabel?: DatePickerProps['gridLabel'];
-    /** aria-label del desplegable de horas. Default: "Horas" (castellano). */
+    /** aria-label del desplegable de horas. Sin él, `timeSelect.hours`. */
     hoursLabel?: string;
-    /** aria-label del desplegable de minutos. Default: "Minutos" (castellano). */
+    /** aria-label del desplegable de minutos. Sin él, `timeSelect.minutes`. */
     minutesLabel?: string;
     onChange?: (date: Date | null) => void;
     /** Se llama al salir de cualquiera de los dos controles: el campo de fecha (un `<input>`) o los desplegables de hora (dos `<button>`). */

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

@@ -17,6 +17,27 @@ export type DocsSearchRenderLinkProps = React.AnchorHTMLAttributes<HTMLAnchorEle
     href: string;
     className: string;
 };
+/**
+ * Los textos que el buscador emite por su cuenta. Los seis son cromo: en toda
+ * la suite el buscador de la documentación se llama igual y avisa igual. Los
+ * **resultados** no están aquí — son datos que llegan por `results`.
+ *
+ * El nombre del aspa tampoco: el aspa es la del `InputField` que hay debajo y
+ * sale de `inputField.clear`. Es la misma palabra y el mismo botón; darle una
+ * clave propia solo obligaría a traducir «Borrar» dos veces.
+ */
+export interface DocsSearchMessages {
+    /** Etiqueta del campo, que nombra también el punto de referencia. */
+    label: string;
+    /** Pista dentro del campo. */
+    placeholder: string;
+    /** Nombre accesible de la lista de resultados. */
+    results: string;
+    /** Aviso cuando la búsqueda no encuentra nada. */
+    empty: string;
+    /** Aviso mientras se busca. */
+    loading: string;
+}
 export interface DocsSearchProps {
     /** `id` del campo. Ata la etiqueta con el campo y el campo con la lista. */
     id?: string;
@@ -29,15 +50,14 @@ export interface DocsSearchProps {
     /** Hay una búsqueda en curso: el aviso de estado lo dice. */
     loading?: boolean;
     /**
-     * Etiqueta del campo. Default castellano.
-     * @default 'Buscar en la documentación'
+     * Etiqueta del campo. **Sin default**: sale de `docsSearch.label` del
+     * `BrandMessagesProvider`.
      */
     label?: string;
     /** Oculta la etiqueta a la vista; el lector de pantalla la sigue leyendo. */
     labelHidden?: boolean;
     /**
-     * Pista dentro del campo. Default castellano.
-     * @default 'Buscar…'
+     * Pista dentro del campo. **Sin default**: sale de `docsSearch.placeholder`.
      */
     placeholder?: string;
     /**
@@ -47,23 +67,22 @@ export interface DocsSearchProps {
      */
     clearable?: boolean;
     /**
-     * Nombre accesible del botón de borrado. Default castellano.
-     * @default 'Borrar'
+     * Nombre accesible del botón de borrado. Reenvío puro al `InputField`: sin
+     * él, el texto sale de `inputField.clear` del `BrandMessagesProvider`.
      */
     clearLabel?: string;
     /**
-     * Nombre accesible de la lista de resultados. Default castellano.
-     * @default 'Resultados'
+     * Nombre accesible de la lista de resultados. **Sin default**: sale de
+     * `docsSearch.results`.
      */
     resultsLabel?: string;
     /**
-     * Aviso cuando la búsqueda no encuentra nada. Default castellano.
-     * @default 'Sin resultados.'
+     * Aviso cuando la búsqueda no encuentra nada. **Sin default**: sale de
+     * `docsSearch.empty`.
      */
     emptyLabel?: string;
     /**
-     * Aviso mientras se busca. Default castellano.
-     * @default 'Buscando…'
+     * Aviso mientras se busca. **Sin default**: sale de `docsSearch.loading`.
      */
     loadingLabel?: string;
     /** Talla del campo. */

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

@@ -1,5 +1,14 @@
 import { type ComponentPropsWithoutRef, type ReactNode } from 'react';
 import './FilterBar.css';
+/**
+ * El único texto que la barra emite por su cuenta: su nombre accesible como
+ * punto de referencia de búsqueda. Los rótulos de los filtros no están aquí —
+ * los escribe cada campo, y dicen qué filtran.
+ */
+export interface FilterBarMessages {
+    /** Nombre accesible del punto de referencia `search` que es la barra. */
+    label: string;
+}
 export interface FilterBarProps extends Omit<ComponentPropsWithoutRef<'div'>, 'children'> {
     /**
      * El buscador: el campo de búsqueda del sistema —un `InputField kind="search"`,
@@ -22,7 +31,7 @@ export interface FilterBarProps extends Omit<ComponentPropsWithoutRef<'div'>, 'c
     actions?: ReactNode;
     /**
      * Nombre accesible del punto de referencia `search` que es la barra.
-     * Default: «Filtros» (castellano). Una app multiidioma debe pasarlo traducido.
+     * **Sin default**: sale de `filterBar.label` del `BrandMessagesProvider`.
      */
     ariaLabel?: string;
     /** Se añade DESPUÉS de las clases propias. */

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

@@ -1,5 +1,18 @@
 import { type ComponentPropsWithoutRef } from 'react';
 import './InputField.css';
+/**
+ * El único texto que el campo emite por su cuenta: el nombre accesible del
+ * aspa de borrado. Es cromo —dice la misma cosa en toda la suite—, así que
+ * sale del catálogo común y no de quien monta el campo.
+ *
+ * El `label`, el `placeholder`, el `helperText` y el `errorMessage` NO están
+ * aquí: son el contenido de ESTE campo, y ningún catálogo común puede saber
+ * qué dicen.
+ */
+export interface InputFieldMessages {
+    /** Nombre accesible del botón que vacía un campo de búsqueda. */
+    clear: string;
+}
 export interface InputFieldProps extends Omit<ComponentPropsWithoutRef<'input'>, 'size' | 'type' | 'value' | 'defaultValue'> {
     id: string;
     label: string;
@@ -33,8 +46,9 @@ export interface InputFieldProps extends Omit<ComponentPropsWithoutRef<'input'>,
      */
     clearable?: boolean;
     /**
-     * Nombre accesible del botón de borrado. Default castellano.
-     * @default 'Borrar'
+     * Nombre accesible del botón de borrado. **Sin default**: sale de
+     * `inputField.clear` del `BrandMessagesProvider`, y esta prop es la
+     * anulación puntual de un uso concreto.
      */
     clearLabel?: string;
     /** Se llama tras vaciar el campo desde el aspa, ya con el foco devuelto. */

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

@@ -15,6 +15,11 @@ export interface MultiSelectFieldProps {
     options: MultiSelectOption[];
     value?: string[];
     defaultValue?: string[];
+    /**
+     * Marcador de sitio del control sin valor elegido. Reenvío puro al `MultiSelect`:
+     * sin él, el texto sale de `multiSelect.placeholder` del `BrandMessagesProvider`.
+     * Se pasa solo cuando el marcador dice algo de ESTE campo.
+     */
     placeholder?: string;
     /** Nombre del campo en el formulario: se monta un input oculto por valor elegido. */
     name?: string;
@@ -29,7 +34,10 @@ export interface MultiSelectFieldProps {
     size?: 'sm' | 'md' | 'lg';
     /** Se añade DESPUÉS de las clases propias (el consumidor añade, no sustituye). */
     className?: string;
-    /** aria-label del botón que quita un valor. Default: `Quitar ${etiqueta}` (castellano). */
+    /**
+     * aria-label del botón que quita un valor. Reenvío puro al `MultiSelect`:
+     * sin él, el texto sale de `multiSelect.remove` del `BrandMessagesProvider`.
+     */
     removeLabel?: (label: string) => string;
     onValueChange?: (value: string[]) => void;
     onBlur?: React.FocusEventHandler<HTMLDivElement>;

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

@@ -1,4 +1,18 @@
 import './PasswordField.css';
+/**
+ * Los dos textos que el campo emite por su cuenta: las dos caras del
+ * interruptor de mostrar/ocultar. Son cromo —dicen lo mismo en toda la
+ * suite—, y por eso salen del catálogo común.
+ *
+ * El `label`, el `placeholder`, el `helperText` y el `errorMessage` no están
+ * aquí: son el contenido de ESTE campo.
+ */
+export interface PasswordFieldMessages {
+    /** Nombre accesible del interruptor con la contraseña oculta. */
+    show: string;
+    /** Nombre accesible del interruptor con la contraseña a la vista. */
+    hide: string;
+}
 export interface PasswordFieldProps extends Omit<React.ComponentPropsWithoutRef<'input'>, 'size' | 'type'> {
     /**
      * Etiqueta del campo. **Opcional**: si se omite, el componente renderiza solo
@@ -18,9 +32,15 @@ export interface PasswordFieldProps extends Omit<React.ComponentPropsWithoutRef<
     action?: React.ReactNode;
     /** Tamaño del campo. */
     size?: 'sm' | 'md' | 'lg';
-    /** aria-label del toggle cuando la contraseña está oculta. Default: "Mostrar contraseña". */
+    /**
+     * aria-label del toggle cuando la contraseña está oculta. **Sin default**:
+     * sale de `passwordField.show` del `BrandMessagesProvider`.
+     */
     showPasswordLabel?: string;
-    /** aria-label del toggle cuando la contraseña es visible. Default: "Ocultar contraseña". */
+    /**
+     * aria-label del toggle cuando la contraseña es visible. **Sin default**:
+     * sale de `passwordField.hide` del `BrandMessagesProvider`.
+     */
     hidePasswordLabel?: string;
     /**
      * Se añade DESPUÉS de las clases propias, sobre el wrapper raíz `.password-field`.

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

@@ -1,4 +1,17 @@
 import './SearchForm.css';
+/**
+ * Los tres textos que el buscador emite por su cuenta. Son cromo: el buscador
+ * de sitio se llama igual en toda la suite, y ni el rótulo ni la pista dicen
+ * nada de lo que se busca en ESTA pantalla.
+ */
+export interface SearchFormMessages {
+    /** Etiqueta del campo; nombra también el punto de referencia `search`. */
+    label: string;
+    /** Pista dentro del campo. */
+    placeholder: string;
+    /** Nombre accesible del botón de envío. */
+    submit: string;
+}
 export interface SearchFormProps {
     /** `id` del campo. Si no se pasa, el componente genera uno estable. */
     id?: string;
@@ -28,8 +41,7 @@ export interface SearchFormProps {
     method?: 'get' | 'post';
     /**
      * Etiqueta del campo. Nombra también el punto de referencia `search`.
-     * Default castellano.
-     * @default 'Buscar'
+     * **Sin default**: sale de `searchForm.label` del `BrandMessagesProvider`.
      */
     label?: string;
     /**
@@ -38,13 +50,13 @@ export interface SearchFormProps {
      */
     labelHidden?: boolean;
     /**
-     * Pista dentro del campo. Default castellano.
-     * @default 'Buscar…'
+     * Pista dentro del campo. **Sin default**: sale de
+     * `searchForm.placeholder`.
      */
     placeholder?: string;
     /**
-     * Nombre accesible del botón de envío. Default castellano.
-     * @default 'Buscar'
+     * Nombre accesible del botón de envío. **Sin default**: sale de
+     * `searchForm.submit`.
      */
     submitLabel?: string;
     /**

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

@@ -19,6 +19,11 @@ export interface SelectFieldProps {
     options: SelectOptionOrGroup[];
     value?: string;
     defaultValue?: string;
+    /**
+     * Marcador de sitio del control sin valor elegido. Reenvío puro al `Select`:
+     * sin él, el texto sale de `select.placeholder` del `BrandMessagesProvider`.
+     * Se pasa solo cuando el marcador dice algo de ESTE campo.
+     */
     placeholder?: string;
     /** Nombre del campo en el formulario: Base UI monta un input oculto con el valor. */
     name?: string;