@studiolxd/brand 41.1.0 → 42.0.0

package/CHANGELOG.md

@@ -7,6 +7,71 @@ El paquete sigue [semver](https://semver.org/lang/es/): **patch** para bug fixes
 regeneración de `dist`, **minor** para componentes/props/variantes/tokens nuevos, **major**
 para breaking changes.
 
+## [42.0.0] — 2026-09-15
+
+> **Major.** Tercera familia al proveedor de textos: los átomos y moléculas de formulario
+> dejan de traer castellano puesto. Y la barra de filtros apila de verdad por debajo del
+> punto de ruptura, no solo cuando la aritmética de la rejilla lo permitía.
+
+### Los formularios leen del proveedor
+
+Doce componentes, doce espacios nuevos en `BrandMessages`: `inputField`, `passwordField`,
+`select`, `multiSelect`, `numberInput`, `otpInput`, `inputPhone`, `asyncSelect`,
+`asyncMultiSelect`, `searchForm`, `docsSearch` y `filterBar`. Los `*Field` que los envuelven
+son reenvío puro y no tienen espacio propio: pasan la prop al átomo, y el átomo lee del
+catálogo. Mismo orden que en las dos olas anteriores —**prop → proveedor → error**— y
+mismo carácter: incompatible **en tiempo de compilación**, que es lo que se busca.
+
+Esta familia iba ahora, y no más tarde, por un reenvío: `DataTable` pasaba
+`searchClearLabel` a un `InputField` que seguía con su «Borrar» cableado, así que las
+tablas no quedaban limpias del todo en una aplicación francesa hasta que cayera el átomo.
+Ese reenvío está cerrado. Y de paso se ha visto lo que tapaba: `removeLabel`,
+`decrementLabel`, `incrementLabel`, `digitLabel`, `countryLabel` y `loadingLabel` **no se
+pasaban en ningún sitio de la suite** — esos controles salían en castellano dentro de las
+aplicaciones en francés, alemán, neerlandés y portugués, y nadie lo había parcheado porque
+nadie lo veía. Con el proveedor se corrigen sin tocar un solo punto de uso.
+
+### Lo que se queda como prop, y las dudosas
+
+`label`, `helperText`, `errorMessage` y el `placeholder` que dice algo del campo son
+**contenido de ese campo** y siguen siendo props; ninguno traía castellano que retirar. Las
+que hubo que decidir mirando **el valor y no el nombre**: `Select.placeholder`
+(«Seleccionar…») es cromo, y la prop gana cuando el marcador dice algo del campo;
+`SearchForm.label` («Buscar») es cromo, porque el buscador de sitio se llama igual en toda
+la suite; `AsyncSelect.emptyMessage` («Sin resultados») es cromo, con la prop intacta para
+un vacío propio. `DocsSearch.clearLabel` no tiene clave: el aspa es la del `InputField` de
+debajo, y darle clave obligaría a traducir «Borrar» dos veces y a que coincidieran.
+`InputPhone.internationalLabel` conserva su «🌐»: un glifo no se traduce.
+
+El sistema **no tiene marca de obligatorio ni de «opcional»** — ni `Label` ni ningún
+`*Field` la emiten. No había nada que migrar ahí; si algún día se quiere, es una pieza
+nueva.
+
+### `FilterBar`: una columna por debajo de `md`, de verdad
+
+Su documentación prometía una columna por debajo del punto de ruptura y sus acciones sí
+conmutaban ahí, pero los filtros se dejaban a la aritmética de la rejilla
+(`minmax(min(192px, 100%), 1fr)`), que solo apila por fuerza por debajo de unos 400px.
+Medido en Chromium: a 320 y 390px, una columna; **a 430, 600, 700 y 760px, dos o tres
+columnas y un selector a media línea**. Es justo lo que se veía en un teléfono apaisado.
+Ahora la base es `1fr` y la rejilla `auto-fill` vive dentro del `@media (min-width: 768px)`
+que ya existía.
+
+El test que debía haberlo cogido medía la caja equivocada: comprobaba que la **celda**
+llenaba la línea —y lo hacía siempre—, no el **control** de dentro, que era lo que se
+quedaba corto, y solo en una franja que ningún preset de ventana de Storybook toca. El test
+nuevo mide el control y mide a 600px.
+
+`FilterBar` pasa a ser componente cliente: leer del contexto lo exige.
+
+### Un solo fixture inglés para las historias
+
+Las historias «Textos desde el proveedor (otro idioma)» de esta ola y de las dos anteriores
+importan un único `.storybook/brandMessagesFixtureEn.ts`, hermano del castellano, en vez de
+repetir el literal en cada una. El test que vigila que ningún fixture se publica ahora
+enumera lo que hay en `.storybook/`, así que el de la próxima ola queda cubierto por
+existir.
+
 ## [41.1.0] — 2026-09-15
 
 > **Minor.** El interruptor de la barra de filtros se centra con el campo que tiene al

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

@@ -4,6 +4,21 @@ export interface AsyncMultiSelectOption {
     value: string;
     label: string;
 }
+/**
+ * Los textos que el control emite por su cuenta. Todos son cromo: dicen lo
+ * mismo en toda la suite y no hablan de lo que se busca. Lo que sí es de esta
+ * pantalla —las opciones que devuelve `onSearch`— no pasa por aquí.
+ */
+export interface AsyncMultiSelectMessages {
+    /** Pista dentro del campo de búsqueda. */
+    placeholder: string;
+    /** Aviso cuando la búsqueda no devuelve opciones. */
+    empty: string;
+    /** Nombre accesible del spinner mientras se busca. */
+    loading: string;
+    /** Nombre accesible del aspa de cada ficha, con la etiqueta de su opción. */
+    remove: (label: string) => string;
+}
 export interface AsyncMultiSelectProps {
     onSearch: (query: string) => Promise<AsyncMultiSelectOption[]>;
     value?: string[];
@@ -21,6 +36,10 @@ export interface AsyncMultiSelectProps {
      * componente las recuerda—, solo para los valores de `defaultValue`.
      */
     selectedOptions?: AsyncMultiSelectOption[];
+    /**
+     * Pista dentro del campo de búsqueda. **Sin default**: sale de la clave
+     * `placeholder` del espacio de este control.
+     */
     placeholder?: string;
     disabled?: boolean;
     readOnly?: boolean;
@@ -53,16 +72,20 @@ export interface AsyncMultiSelectProps {
      */
     'aria-label'?: string;
     'aria-describedby'?: string;
-    /** aria-label del botón que quita un valor. Default: `Quitar ${etiqueta}` (castellano). */
+    /**
+     * aria-label del botón que quita un valor. **Sin default**: sale de
+     * `asyncMultiSelect.remove`.
+     */
     removeLabel?: (label: string) => string;
     /**
-     * Texto mostrado cuando la búsqueda no devuelve opciones. Default: "Sin resultados"
-     * (castellano). Es texto **visible**: una app multiidioma debe pasarlo traducido.
+     * Texto mostrado cuando la búsqueda no devuelve opciones. **Sin default**:
+     * sale de la clave `empty` del espacio de este control en el
+     * `BrandMessagesProvider`.
      */
     emptyMessage?: string;
     /**
-     * Etiqueta accesible del spinner mientras se busca. Default: "Buscando…" (castellano).
-     * Una app multiidioma debe pasarla traducida.
+     * Etiqueta accesible del spinner mientras se busca. **Sin default**: sale de
+     * la clave `loading` del espacio de este control.
      */
     loadingLabel?: string;
     /**

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

@@ -4,12 +4,31 @@ export interface AsyncSelectOption {
     value: string;
     label: string;
 }
+/**
+ * Los textos que el control emite por su cuenta. Todos son cromo: dicen lo
+ * mismo en toda la suite y no hablan de lo que se busca. Lo que sí es de esta
+ * pantalla —las opciones que devuelve `onSearch`— no pasa por aquí.
+ */
+export interface AsyncSelectMessages {
+    /** Pista dentro del campo de búsqueda. */
+    placeholder: string;
+    /** Aviso cuando la búsqueda no devuelve opciones. */
+    empty: string;
+    /** Nombre accesible del spinner mientras se busca. */
+    loading: string;
+    /** Nombre accesible del botón que vacía la selección. */
+    clear: string;
+}
 export interface AsyncSelectProps {
     onSearch: (query: string) => Promise<AsyncSelectOption[]>;
     value?: string | null;
     onValueChange?: (value: string | null, option: AsyncSelectOption | null) => void;
     /** Label of the currently selected option — required when `value` is set so the component can display it */
     selectedOption?: AsyncSelectOption | null;
+    /**
+     * Pista dentro del campo de búsqueda. **Sin default**: sale de la clave
+     * `placeholder` del espacio de este control.
+     */
     placeholder?: string;
     disabled?: boolean;
     readOnly?: boolean;
@@ -43,18 +62,19 @@ export interface AsyncSelectProps {
     'aria-label'?: string;
     'aria-describedby'?: string;
     /**
-     * Texto mostrado cuando la búsqueda no devuelve opciones. Default: "Sin resultados"
-     * (castellano). Es texto **visible**: una app multiidioma debe pasarlo traducido.
+     * Texto mostrado cuando la búsqueda no devuelve opciones. **Sin default**:
+     * sale de la clave `empty` del espacio de este control en el
+     * `BrandMessagesProvider`.
      */
     emptyMessage?: string;
     /**
-     * Etiqueta accesible del spinner mientras se busca. Default: "Buscando…" (castellano).
-     * Una app multiidioma debe pasarla traducida.
+     * Etiqueta accesible del spinner mientras se busca. **Sin default**: sale de
+     * la clave `loading` del espacio de este control.
      */
     loadingLabel?: string;
     /**
-     * aria-label del botón de limpiar selección. Default: "Limpiar selección" (castellano).
-     * Una app multiidioma debe pasarla traducida.
+     * aria-label del botón de limpiar selección. **Sin default**: sale de
+     * `asyncSelect.clear`.
      */
     clearLabel?: string;
     /**

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

@@ -1,6 +1,15 @@
 import { Select as BaseSelect } from '@base-ui/react/select';
 import type { Country } from 'react-phone-number-input';
 import './InputPhone.css';
+/**
+ * El único texto que el campo emite por su cuenta: el nombre accesible del
+ * selector de país. Los **nombres de los países** no están aquí: los resuelve
+ * `Intl` desde el `locale`, como los meses y las fechas.
+ */
+export interface InputPhoneMessages {
+    /** Nombre accesible del selector de prefijo/país. */
+    country: string;
+}
 export interface InputPhoneProps {
     value?: string;
     defaultCountry?: Country;
@@ -24,14 +33,16 @@ export interface InputPhoneProps {
     onBlur?: React.FocusEventHandler<HTMLInputElement>;
     onFocus?: React.FocusEventHandler<HTMLInputElement>;
     /**
-     * aria-label del selector de país. Default: "País" (castellano).
-     * Una app multiidioma debe pasarla traducida.
+     * aria-label del selector de país. **Sin default**: sale de
+     * `inputPhone.country` del `BrandMessagesProvider`.
      */
     countryLabel?: string;
     /**
      * Lo que enseña el selector cuando no hay país elegido (número en formato
-     * internacional). Default: "🌐". Es contenido visible: una app que no quiera
-     * el emoji pasa aquí su propio texto o glifo.
+     * internacional). Default: "🌐". **No pasa por el catálogo de textos a
+     * propósito**: un glifo no se traduce, dice lo mismo en los seis idiomas y
+     * meterlo en el catálogo obligaría a repetirlo seis veces. Una app que no
+     * quiera el emoji pasa aquí su propio texto o glifo.
      */
     internationalLabel?: string;
     /**

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

@@ -1,5 +1,17 @@
 import { Popover as BasePopover } from '@base-ui/react/popover';
 import './MultiSelect.css';
+/**
+ * Los dos textos que el control emite por su cuenta: el marcador de sitio sin
+ * nada elegido y el nombre del aspa de cada ficha. Los dos son cromo — dicen
+ * lo mismo en toda la suite, y el segundo solo interpola la etiqueta de la
+ * opción, que es un dato.
+ */
+export interface MultiSelectMessages {
+    /** Marcador de sitio de la caja sin valores elegidos. */
+    placeholder: string;
+    /** Nombre accesible del aspa de una ficha, con la etiqueta de su opción. */
+    remove: (label: string) => string;
+}
 export interface MultiSelectOption {
     value: string;
     label: string;
@@ -9,6 +21,10 @@ export interface MultiSelectProps {
     options: MultiSelectOption[];
     value?: string[];
     defaultValue?: string[];
+    /**
+     * Marcador de sitio sin valores elegidos. **Sin default**: sale de
+     * `multiSelect.placeholder` del `BrandMessagesProvider`.
+     */
     placeholder?: string;
     disabled?: boolean;
     readOnly?: boolean;
@@ -32,7 +48,10 @@ export interface MultiSelectProps {
     'aria-labelledby'?: string;
     /** Ids de ayuda/error que describen el control (lo pone el campo). */
     'aria-describedby'?: string;
-    /** aria-label del botón que quita un valor. Default: `Quitar ${etiqueta}` (castellano). */
+    /**
+     * aria-label del botón que quita un valor. **Sin default**: sale de
+     * `multiSelect.remove` del `BrandMessagesProvider`.
+     */
     removeLabel?: (label: string) => string;
     /**
      * Nodo DOM donde montar el portal del dropdown (reenviado a Base UI

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

@@ -1,5 +1,15 @@
 import { type ComponentPropsWithoutRef } from 'react';
 import './NumberInput.css';
+/**
+ * Los dos textos que el control emite por su cuenta: los nombres accesibles de
+ * sus dos botones. Cromo puro — no dicen nada de qué se cuenta.
+ */
+export interface NumberInputMessages {
+    /** Nombre accesible del botón que resta un paso. */
+    decrement: string;
+    /** Nombre accesible del botón que suma un paso. */
+    increment: string;
+}
 export interface NumberInputProps extends Omit<ComponentPropsWithoutRef<'input'>, 'size' | 'type' | 'value' | 'defaultValue' | 'onChange'> {
     value?: number;
     defaultValue?: number;
@@ -20,13 +30,13 @@ export interface NumberInputProps extends Omit<ComponentPropsWithoutRef<'input'>
     /** Se añade DESPUÉS de las clases propias del componente (el consumidor añade, no sustituye). */
     className?: string;
     /**
-     * aria-label del botón de decremento. Default: "Decrementar" (castellano).
-     * Una app multiidioma debe pasarla traducida.
+     * aria-label del botón de decremento. **Sin default**: sale de
+     * `numberInput.decrement` del `BrandMessagesProvider`.
      */
     decrementLabel?: string;
     /**
-     * aria-label del botón de incremento. Default: "Incrementar" (castellano).
-     * Una app multiidioma debe pasarla traducida.
+     * aria-label del botón de incremento. **Sin default**: sale de
+     * `numberInput.increment` del `BrandMessagesProvider`.
      */
     incrementLabel?: string;
     onChange?: (value: number) => void;

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

@@ -1,4 +1,15 @@
 import './OtpInput.css';
+/**
+ * Los textos que el control emite por su cuenta: el nombre del grupo cuando va
+ * suelto y el de cada celda. Cromo — el segundo solo interpola la posición de
+ * la celda, que es una cifra.
+ */
+export interface OtpInputMessages {
+    /** Nombre accesible del grupo de celdas cuando el control va suelto. */
+    group: string;
+    /** Nombre accesible de una celda, con su posición y el total. */
+    digit: (index: number, length: number) => string;
+}
 export interface OtpInputProps {
     /** Número de celdas a renderizar. Requerido. */
     length: number;
@@ -22,8 +33,8 @@ export interface OtpInputProps {
     'aria-labelledby'?: string;
     /**
      * Nombre accesible del grupo cuando no se pasa `aria-label` ni
-     * `aria-labelledby` — el caso del control suelto. Default: "Código de
-     * verificación" (castellano). Una app multiidioma debe pasarla traducida.
+     * `aria-labelledby` — el caso del control suelto. **Sin default**: sale de
+     * `otpInput.group` del `BrandMessagesProvider`.
      */
     groupLabel?: string;
     id?: string;
@@ -39,8 +50,8 @@ export interface OtpInputProps {
     /** Se añade DESPUÉS de las clases propias del componente. */
     className?: string;
     /**
-     * Etiqueta accesible de cada celda. Default: `Dígito N de M` (castellano).
-     * Una app multiidioma debe pasarla traducida.
+     * Etiqueta accesible de cada celda. **Sin default**: sale de
+     * `otpInput.digit` del `BrandMessagesProvider`.
      */
     digitLabel?: (index: number, length: number) => string;
 }

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

@@ -2,6 +2,18 @@ import type { ReactNode } from 'react';
 import { Select as BaseSelect } from '@base-ui/react/select';
 import type { SeparatorProps as BaseSeparatorProps } from '@base-ui/react/separator';
 import './Select.css';
+/**
+ * El único texto que el desplegable emite por su cuenta: el marcador de sitio
+ * genérico del disparador, el que dice «aquí no has elegido nada todavía».
+ *
+ * Es cromo, no contenido: cuando el marcador dice algo de ESTE campo («Elige
+ * un país») lo escribe quien monta el campo y viaja por la prop `placeholder`,
+ * que sigue ganando. Las **opciones** tampoco están aquí: son datos.
+ */
+export interface SelectMessages {
+    /** Marcador de sitio del disparador sin valor elegido. */
+    placeholder: string;
+}
 export interface SelectOption {
     value: string;
     label: string;
@@ -34,7 +46,12 @@ export interface SelectProps {
     options: SelectOptionOrGroup[];
     value?: string;
     defaultValue?: string;
-    /** Placeholder del trigger. Default: "Seleccionar…" (en la API compuesta lo pone cada consumidor vía `Select.Value`). */
+    /**
+     * Placeholder del trigger. **Sin default**: sale de `select.placeholder` del
+     * `BrandMessagesProvider`, y esta prop es la anulación puntual cuando el
+     * marcador dice algo de este campo concreto. En la API compuesta lo pone cada
+     * consumidor vía `Select.Value`.
+     */
     placeholder?: string;
     disabled?: boolean;
     readOnly?: boolean;

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

@@ -1,6 +1,18 @@
 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';
 /**
  * El contrato de textos de la librería: un espacio por componente, y dentro
  * de cada espacio **todas las claves obligatorias**.
@@ -26,5 +38,17 @@ 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;
 }
-export type { PaginationMessages, TableMessages, DataTableMessages };
+export type { PaginationMessages, TableMessages, DataTableMessages, InputFieldMessages, PasswordFieldMessages, SelectMessages, MultiSelectMessages, NumberInputMessages, OtpInputMessages, InputPhoneMessages, AsyncSelectMessages, AsyncMultiSelectMessages, DocsSearchMessages, SearchFormMessages, FilterBarMessages, };

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, } from './BrandMessages';

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`.