@studiolxd/brand 41.0.0 → 42.0.0

package/CHANGELOG.md

@@ -7,6 +7,125 @@ 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
+> lado, el pie de una tarjeta cumple la norma de las acciones por sí solo, y `block` queda
+> escrito como lo que es: la excepción.
+
+### `FilterBar`: un control sin rótulo, a la altura del que sí lo lleva
+
+Un interruptor no lleva rótulo encima y un campo sí, así que en la rejilla el interruptor
+se pegaba arriba, a la altura de los **rótulos** en vez de a la de los **campos**. Ahora la
+barra le reserva a esa celda el renglón del rótulo —medido por token, no a ojo— y, en el
+espacio que queda, abre una caja de **la altura de un campo** y centra el control dentro.
+
+Medido en Chromium: los centros de la caja del campo, del interruptor y del botón de las
+acciones caen en el mismo píxel. La referencia es la **talla estándar del campo**, no el
+alto real del renglón, y eso es lo que permite tener las dos cosas a la vez: un control que
+crece hacia abajo —un selector múltiple con fichas— sigue creciendo sin mover a nadie, y
+los rótulos siguen todos en su línea. Donde ningún filtro lleva rótulo no se reserva nada,
+y apilado, por debajo del punto de ruptura, tampoco.
+
+### `CardFooter` cumple la norma solo
+
+Era la única ranura de acciones del sistema que no lo hacía: siempre una fila, con la
+columna a pedir a mano — la prop de escape que la norma vino a quitar, mudada del botón al
+contenedor. Ahora, por debajo de `md`, sus acciones ocupan la línea como en las otras once
+ranuras.
+
+`direction="column"` **se queda**, y con un significado más limpio: ya no es «acuérdate de
+apilar en móvil», sino «apila **siempre**, también donde hay sitio» — el pie con una línea
+de texto sobre el botón, o la tarjeta que se sabe estrecha en escritorio.
+
+**Por qué por ventana y no por contenedor**, que es el hallazgo que merece quedar escrito:
+se intentó como el pie de un diálogo y se midió antes de darlo por bueno. Declarar la
+tarjeta como contenedor (`container-type: inline-size`) le quita el ancho que saca de su
+contenido: dos tarjetas dentro de un `Inline` pasan de medir lo que mide su texto a 34px,
+solo su propio aire. **Una tarjeta no puede ser contenedor** porque se usa de las dos
+maneras —unas veces la estira su hueco, otras la mide su contenido—; un diálogo sí, porque
+su ancho siempre viene de fuera. Queda en `Foundations › Puntos de ruptura` como el primer
+límite documentado de la técnica.
+
+### `Button.block`, escrito al derecho
+
+Su documentación decía que era «lo que quiere un botón suelto dentro de una página», que es
+justo la invitación a usarlo en vez de buscar la ranura. Ahora dice lo contrario, y la
+norma tiene su mitad negativa escrita:
+
+> Todo botón vive en una ranura de acciones. Si no hay ranura que le encaje, eso es un
+> hueco del sistema que se reporta — no un `block` que se añade.
+
+Con la lista de las ranuras que dan la línea entera y de las que no la dan a propósito
+—las que viven dentro de una fila, donde estirar rompería la fila que les da sentido—.
+`AnnotationThread` sale de la lista de dudosos: vive en un panel estrecho también en
+escritorio, así que sus acciones ocupan la línea **siempre**, sin punto de ruptura.
+
 ## [41.0.0] — 2026-09-15
 
 > **Major.** Segunda familia al proveedor de textos: `Table` y `DataTable` pierden sus

package/dist/_shared/tokens.js

@@ -2539,6 +2539,8 @@ var e = {
 	"--filter-bar-row-gap": "0.75rem",
 	"--filter-bar-column-min-inline-size": "12rem",
 	"--filter-bar-actions-gap": "0.75rem",
+	"--filter-bar-label-offset": "calc(0.875rem * 1.5 + 0.5rem)",
+	"--filter-bar-control-block-size": "2.5rem",
 	"--form-field-gap": "0.25rem",
 	"--image-crop-dialog-gap": "1rem",
 	"--image-crop-dialog-area-max-height": "60vh",
@@ -3093,6 +3095,7 @@ var e = {
 	"--annotation-thread-item-gap": "0.5rem",
 	"--annotation-thread-items-gap": "1rem",
 	"--annotation-thread-header-gap": "0.5rem",
+	"--annotation-thread-actions-gap": "0.75rem",
 	"--annotation-thread-author-font-family": "\"Google Sans Flex\", system-ui, sans-serif",
 	"--annotation-thread-author-font-size": "0.875rem",
 	"--annotation-thread-author-font-weight": "500",

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

@@ -28,10 +28,23 @@ export interface ButtonBaseProps extends Omit<React.ComponentPropsWithoutRef<'bu
     /** Size of the button */
     size?: 'sm' | 'md' | 'lg';
     /**
-     * Estira el botón hasta el ancho de su contenedor. `'mobile'` lo hace solo
-     * por debajo de `md`: es lo que quiere un botón suelto dentro de una página
-     * —una acción que en escritorio se lee bien con su ancho natural y en una
-     * pantalla estrecha queda mejor ocupando la línea entera.
+     * Estira el botón hasta el ancho de su contenedor (`'mobile'`, solo por
+     * debajo de `md`). **Es la excepción marcada, no el camino normal.**
+     *
+     * Todo botón vive en una **ranura de acciones**: el pie de un `Form` o de un
+     * diálogo, las `actions` de un `Alert`, de una `FilterBar`, de un `Hero`, de
+     * un `PageIntro`… Y el ancho lo decide la ranura, no el botón: la norma del
+     * sistema (Fundamentos › **Puntos de ruptura**) hace que en móvil las
+     * acciones tomen la línea entera desde el CSS del contenedor, sin prop que
+     * acordarse de pasar. Dentro de una ranura del sistema `block` no hace falta,
+     * y pasarlo es pelearse con ella.
+     *
+     * **Si no hay ranura que le encaje, eso es un hueco del sistema y se
+     * reporta** — no un `block` que se añade.
+     *
+     * Queda, entonces, para el botón que de verdad NO está en una ranura de
+     * acciones: la llamada a la acción dentro de un texto, o la fila que un
+     * producto monta a mano mientras el sistema no tiene su ranura.
      */
     block?: boolean | 'mobile';
     /**

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

@@ -142,11 +142,20 @@ export declare const CardAction: import("react").ForwardRefExoticComponent<Omit<
 export declare const CardContent: import("react").ForwardRefExoticComponent<Omit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
 export interface CardFooterProps extends CardPartProps {
     /**
-     * `row` (por defecto): las acciones en fila. `column`: apiladas y a todo
-     * el ancho — para un pie con una línea de texto sobre el botón (una nota
-     * de prueba, una condición) que debe quedar pegada a él.
+     * `row` (por defecto): las acciones en fila **en escritorio**; por debajo de
+     * `md` apilan y ocupan la línea entera solas, que es la norma del sistema
+     * (Fundamentos › Puntos de ruptura) — no hay que pedirlo.
+     *
+     * `column`: apiladas y a todo el ancho **siempre, también donde hay sitio**.
+     * Es la excepción declarada, para un pie con una línea de texto sobre el
+     * botón (una nota de prueba, una condición) que debe quedar pegada a él, y
+     * para una tarjeta que se sabe estrecha en escritorio —una rejilla de tres
+     * columnas—, porque el pie mide su hueco y no la ventana.
      */
     direction?: 'row' | 'column';
 }
-/** Pie de la tarjeta: sus acciones, en fila o apiladas. */
+/**
+ * Pie de la tarjeta: sus acciones. En móvil apila y da la línea entera a cada
+ * una; en escritorio, fila —salvo `direction="column"`—.
+ */
 export declare const CardFooter: import("react").ForwardRefExoticComponent<CardFooterProps & import("react").RefAttributes<HTMLDivElement>>;

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. */