@studiolxd/brand 45.0.0 → 46.0.0

package/CHANGELOG.md

@@ -7,6 +7,76 @@ 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.
 
+## [46.0.0] — 2026-09-15
+
+> **Major.** Séptima familia al proveedor de textos: los envoltorios de diálogo. `Consent`,
+> `CommandPalette`, `AppLauncher`, `FloatingDock`, `NotificationButton` y
+> `NotificationPanel` dejan de traer castellano puesto.
+
+### Los envoltorios leen del proveedor
+
+Seis espacios nuevos en `BrandMessages`: `consent`, `commandPalette`, `appLauncher`,
+`floatingDock`, `notificationButton` y `notificationPanel`. Mismo orden —**prop →
+proveedor → error**—. `CommandPalette` y `AppLauncher` relajan su API de paso: los textos
+que antes eran props obligatorias en cada uso ahora son opcionales, porque los pone el
+catálogo.
+
+### Lo que se queda como prop, por valor y no por nombre
+
+`ConsentBanner.description` y `policyLabel` son **obligatorias y sin default**, como el
+`confirmLabel` de un diálogo: el texto legal depende de la jurisdicción y de lo que cada
+producto guarde. El tipo exige `policyLabel` en cuanto hay `policyHref` —o el enlace no
+está, o está entero—, así que una política sin nombre no compila.
+
+`AppLauncherLabels.trigger` no va al catálogo por una razón distinta: su **presencia**
+decide la cara del disparador (solo icono, o icono con rótulo), y un texto de catálogo está
+siempre presente. Meterlo ahí obligaría a todos los lanzadores de la suite a llevar rótulo.
+
+### `FloatingDock` tiene su propio aspa, y por qué no pasa por `Modal`
+
+Se miró antes de decidirlo, y la razón es real: es un diálogo **no modal** —sin velo, con
+la página viva detrás—, no atrapa el foco, su portal monta dentro del propio ancla para
+heredar la superficie por cascada, y va anclado a una esquina con el aspa fuera de la
+cabecera. El `Modal` del sistema es lo contrario en las cuatro cosas. Hacerlo pasar por él
+no era quitar una clave: era cambiar el componente. Queda escrito en el componente y en su
+documentación para que no se vuelva a abrir.
+
+## [45.1.0] — 2026-09-15
+
+> **Minor.** La superficie pública pone los controles en talla lg, igual que hace con el
+> texto.
+
+### `.site-shell` parte de lg también en los controles
+
+El bloque subía el cuerpo a 20px y dejaba los campos en la talla de aplicación: en una
+página pública el texto era grande y los buscadores, filtros y botones de al lado no. Misma
+omisión que tenía el término de la ficha hasta la v39.0.0, y misma respuesta: en el bloque,
+no en cada app.
+
+No se enumeran controles a mano. Cada control ya declara su talla lg en tokens hermanos
+(`input.lg-height` junto a `input.height`), de donde bebe su modificador `--lg`; ahora
+`.site-shell` apunta cada token de partida a su hermano `lg-*`, y lo que hereda de un
+control sube con él. Un control nuevo entra solo por tener sus tokens `lg-*`. La familia
+base (`control.*`) estrena su par lg, y el motor de tokens arrastra ahora una referencia
+metida dentro de una fórmula —sin eso el renglón reservado para el rótulo de la barra de
+filtros se quedaba corto y descolocaba el interruptor—.
+
+**El botón entra**: 40→48px y 16→20px, porque un botón md junto a un campo de 48 se lee
+como un control de otra talla justo donde más se juntan. **El chevron del `Select`** era lo
+único de la caja que no subía —su tamaño salía de una prop de React y no de un token— y
+ahora es token (16→24px).
+
+Medido en Chromium: dentro del shell, campo, selector, selector múltiple, campo de fecha y
+botón a 48px/20px, exactamente lg; fuera, 40px/16px. El interruptor, su campo y el botón de
+acciones de la barra siguen con el centro en el mismo píxel.
+
+**Dos matices, documentados.** `size="sm"` sigue mandando dentro del shell; lo que ya no
+se distingue de lg es un `size="md"` escrito a mano. Y **lo que sale por un portal** —la
+lista de un `Select`, el calendario de un `DatePicker`— monta en `document.body` y no
+hereda la superficie: el disparador va a 48/20 y su lista se queda en la talla de
+aplicación. Es el mismo caso que `Modal` y `Sheet` documentan, y la misma respuesta
+(`container`), pero los campos `*Field` no lo exponen todavía.
+
 ## [45.0.0] — 2026-09-15
 
 > **Major.** Sexta familia al proveedor de textos: diálogos y superficies. `Modal`, `Sheet`,

package/dist/_shared/tokens.js

@@ -684,6 +684,9 @@ var e = {
 	"--control-focus-ring-inset-offset": "1px",
 	"--control-padding-inline": "1rem",
 	"--control-padding-block": "1rem",
+	"--control-lg-height": "3rem",
+	"--control-lg-font-size": "1.25rem",
+	"--control-lg-padding-inline": "1.5rem",
 	"--copyable-value-gap": "0.75rem",
 	"--description-list-border-width": "1px",
 	"--description-list-border-style": "solid",
@@ -1202,6 +1205,9 @@ var e = {
 	"--multi-select-item-selected-font-weight": "700",
 	"--multi-select-icon-transition-easing": "ease",
 	"--multi-select-selection-gap": "0.25rem",
+	"--multi-select-icon-size": "16px",
+	"--multi-select-sm-icon-size": "8px",
+	"--multi-select-lg-icon-size": "24px",
 	"--multi-select-sm-font-size": "0.875rem",
 	"--multi-select-sm-padding-inline": "0.5rem",
 	"--multi-select-sm-item-padding-block": "0.25rem",
@@ -1475,6 +1481,9 @@ var e = {
 	"--select-item-selected-font-weight": "500",
 	"--select-item-highlighted-bg": "#111e30",
 	"--select-item-highlighted-color": "#ffffff",
+	"--select-icon-size": "16px",
+	"--select-sm-icon-size": "8px",
+	"--select-lg-icon-size": "24px",
 	"--select-sm-font-size": "0.875rem",
 	"--select-sm-padding-inline": "0.5rem",
 	"--select-sm-item-padding-block": "0.25rem",

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

@@ -25,6 +25,12 @@ import type { ConfirmDialogMessages } from '../molecules/ConfirmDialog/ConfirmDi
 import type { AlertMessages } from '../molecules/Alert/Alert';
 import type { BannerMessages } from '../molecules/Banner/Banner';
 import type { ToasterMessages } from '../molecules/Toast/Toaster';
+import type { ConsentMessages } from '../molecules/Consent/Consent';
+import type { CommandPaletteMessages } from '../molecules/CommandPalette/CommandPalette';
+import type { AppLauncherMessages } from '../molecules/AppLauncher/AppLauncher';
+import type { FloatingDockMessages } from '../sections/FloatingDock/FloatingDock';
+import type { NotificationButtonMessages } from '../molecules/NotificationButton/NotificationButton';
+import type { NotificationPanelMessages } from '../molecules/NotificationPanel/NotificationPanel';
 /**
  * El contrato de textos de la librería: un espacio por componente, y dentro
  * de cada espacio **todas las claves obligatorias**.
@@ -74,5 +80,11 @@ export interface BrandMessages {
     alert: AlertMessages;
     banner: BannerMessages;
     toaster: ToasterMessages;
+    consent: ConsentMessages;
+    commandPalette: CommandPaletteMessages;
+    appLauncher: AppLauncherMessages;
+    floatingDock: FloatingDockMessages;
+    notificationButton: NotificationButtonMessages;
+    notificationPanel: NotificationPanelMessages;
 }
-export type { PaginationMessages, TableMessages, DataTableMessages, InputFieldMessages, PasswordFieldMessages, SelectMessages, MultiSelectMessages, NumberInputMessages, OtpInputMessages, InputPhoneMessages, AsyncSelectMessages, AsyncMultiSelectMessages, DocsSearchMessages, SearchFormMessages, FilterBarMessages, CalendarMessages, DatePickerMessages, TimeSelectMessages, FileUploadMessages, ImageCropDialogMessages, AvatarUploadMessages, ModalMessages, SheetMessages, ConfirmDialogMessages, AlertMessages, BannerMessages, ToasterMessages, };
+export type { PaginationMessages, TableMessages, DataTableMessages, InputFieldMessages, PasswordFieldMessages, SelectMessages, MultiSelectMessages, NumberInputMessages, OtpInputMessages, InputPhoneMessages, AsyncSelectMessages, AsyncMultiSelectMessages, DocsSearchMessages, SearchFormMessages, FilterBarMessages, CalendarMessages, DatePickerMessages, TimeSelectMessages, FileUploadMessages, ImageCropDialogMessages, AvatarUploadMessages, ModalMessages, SheetMessages, ConfirmDialogMessages, AlertMessages, BannerMessages, ToasterMessages, ConsentMessages, CommandPaletteMessages, AppLauncherMessages, FloatingDockMessages, NotificationButtonMessages, NotificationPanelMessages, };

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

@@ -2,4 +2,4 @@ export { BrandMessagesProvider } from './BrandMessagesProvider';
 export type { BrandMessagesProviderProps } from './BrandMessagesProvider';
 export { useBrandMessages } from './BrandMessagesContext';
 export type { BrandMessagesReader } from './BrandMessagesContext';
-export type { BrandMessages, PaginationMessages, TableMessages, DataTableMessages, InputFieldMessages, PasswordFieldMessages, SelectMessages, MultiSelectMessages, NumberInputMessages, OtpInputMessages, InputPhoneMessages, AsyncSelectMessages, AsyncMultiSelectMessages, DocsSearchMessages, SearchFormMessages, FilterBarMessages, CalendarMessages, DatePickerMessages, TimeSelectMessages, FileUploadMessages, ImageCropDialogMessages, AvatarUploadMessages, ModalMessages, SheetMessages, ConfirmDialogMessages, AlertMessages, BannerMessages, ToasterMessages, } from './BrandMessages';
+export type { BrandMessages, PaginationMessages, TableMessages, DataTableMessages, InputFieldMessages, PasswordFieldMessages, SelectMessages, MultiSelectMessages, NumberInputMessages, OtpInputMessages, InputPhoneMessages, AsyncSelectMessages, AsyncMultiSelectMessages, DocsSearchMessages, SearchFormMessages, FilterBarMessages, CalendarMessages, DatePickerMessages, TimeSelectMessages, FileUploadMessages, ImageCropDialogMessages, AvatarUploadMessages, ModalMessages, SheetMessages, ConfirmDialogMessages, AlertMessages, BannerMessages, ToasterMessages, ConsentMessages, CommandPaletteMessages, AppLauncherMessages, FloatingDockMessages, NotificationButtonMessages, NotificationPanelMessages, } from './BrandMessages';

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

@@ -1,4 +1,24 @@
 import './AppLauncher.css';
+/**
+ * El cromo del lanzador, y **solo el cromo**: el nombre accesible del
+ * disparador, el título del diálogo y la marca de app nueva. Las tres valen
+ * igual en todas las apps de la suite —el lanzador es el mismo mueble en
+ * todas— y ninguna nombra una aplicación concreta: eso viaja en `apps`.
+ *
+ * **`trigger` no está aquí** y sigue siendo prop. No es un texto de más: su
+ * presencia decide la cara del disparador —solo icono, o icono con rótulo—, y
+ * un texto de catálogo está siempre presente, así que ponerlo aquí obligaría a
+ * todos los lanzadores de la suite a llevar rótulo. Es una decisión de
+ * maqueta que se toma en el sitio donde se monta.
+ */
+export interface AppLauncherMessages {
+    /** Nombre accesible del disparador cuando es solo icono («Abrir launcher de apps»). */
+    open: string;
+    /** Texto del distintivo de app nueva. */
+    new: string;
+    /** Título del diálogo con `presentation="modal"`. */
+    title: string;
+}
 export interface LauncherApp {
     id: string;
     name: string;
@@ -6,10 +26,18 @@ export interface LauncherApp {
     isNew?: boolean;
 }
 export interface AppLauncherLabels {
-    /** Texto accesible del trigger («Abrir launcher de apps»). Solo se usa como `aria-label` cuando no hay `trigger`: con texto visible, el nombre accesible es ese texto. */
-    open: string;
-    /** Texto del badge de app nueva. */
-    new: string;
+    /**
+     * Texto accesible del trigger («Abrir launcher de apps»). Solo se usa como
+     * `aria-label` cuando no hay `trigger`: con texto visible, el nombre
+     * accesible es ese texto. **Sin default**: sin él, sale de
+     * `appLauncher.open` del `BrandMessagesProvider`.
+     */
+    open?: string;
+    /**
+     * Texto del badge de app nueva. **Sin default**: sin él, sale de
+     * `appLauncher.new` del proveedor.
+     */
+    new?: string;
     /**
      * Texto visible del disparador (p. ej. «Aplicaciones»), a la derecha del
      * icono de rejilla. Sin él, el disparador se queda como hoy: solo icono,
@@ -17,14 +45,21 @@ export interface AppLauncherLabels {
      */
     trigger?: string;
     /**
-     * Título del diálogo cuando `presentation="modal"`. Default: «Aplicaciones»
-     * (castellano). Sin uso en `presentation="popover"`, que no lleva título.
+     * Título del diálogo cuando `presentation="modal"`. **Sin default**: sin él,
+     * sale de `appLauncher.title` del proveedor. Sin uso en
+     * `presentation="popover"`, que no lleva título.
      */
     title?: string;
 }
 export interface AppLauncherProps {
     apps: LauncherApp[];
-    labels: AppLauncherLabels;
+    /**
+     * Anulaciones puntuales de los textos del lanzador. **Ya no es
+     * obligatoria**: sin ella, el cromo sale del espacio `appLauncher` del
+     * `BrandMessagesProvider`. Sigue haciendo falta para `trigger`, que no es
+     * catálogo.
+     */
+    labels?: AppLauncherLabels;
     /** Id de la app actual — se marca en la rejilla. */
     currentAppId?: string;
     open?: boolean;
@@ -39,4 +74,4 @@ export interface AppLauncherProps {
      */
     presentation?: 'modal' | 'popover';
 }
-export declare function AppLauncher({ presentation, ...rest }: AppLauncherProps): import("react/jsx-runtime").JSX.Element;
+export declare function AppLauncher({ presentation, labels, ...rest }: AppLauncherProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,5 +1,27 @@
 import { type ReactNode } from 'react';
 import './CommandPalette.css';
+/**
+ * El cromo de la paleta, y **solo el cromo**: las cuatro cosas que la paleta
+ * dice por su cuenta, sin que se las pase nadie.
+ *
+ * Ninguna nombra un comando: la paleta se llama igual en todas las pantallas
+ * («Buscar un comando»), el buscador pide lo mismo, el vacío dice que no hay
+ * nada y la lista solo necesita un nombre para el lector. Lo que sí cambia
+ * —los grupos y sus ítems— viaja en `groups` y lo escribe la aplicación.
+ *
+ * El aspa **no está aquí**: es un reenvío puro al `Modal`, y sin `closeLabel`
+ * lee `modal.close` como cualquier otro diálogo.
+ */
+export interface CommandPaletteMessages {
+    /** Título accesible y visible del diálogo. */
+    title: string;
+    /** Marcador del buscador. */
+    placeholder: string;
+    /** Texto del estado «sin resultados». */
+    empty: string;
+    /** Nombre accesible de la lista de resultados (`role="listbox"`). */
+    list: string;
+}
 export interface CommandPaletteItem {
     /** Clave estable del ítem. */
     id: string;
@@ -24,17 +46,30 @@ export interface CommandPaletteProps {
      * filtrar no se renderizan — el call-site no necesita condicionarlos.
      */
     groups: CommandPaletteGroup[];
-    /** Título accesible y visible del diálogo. */
-    title: string;
-    placeholder: string;
-    /** Texto del estado "sin resultados". */
-    emptyLabel: string;
     /**
-     * Etiqueta accesible de la lista de resultados (`role="listbox"`). Sin ella
-     * el listbox se queda sin nombre: pásala siempre en apps multiidioma.
+     * Título accesible y visible del diálogo. **Sin default**: sin él, sale de
+     * `commandPalette.title` del `BrandMessagesProvider`.
+     */
+    title?: string;
+    /**
+     * Marcador del buscador. **Sin default**: sin él, sale de
+     * `commandPalette.placeholder` del proveedor.
+     */
+    placeholder?: string;
+    /**
+     * Texto del estado «sin resultados». **Sin default**: sin él, sale de
+     * `commandPalette.empty` del proveedor.
+     */
+    emptyLabel?: string;
+    /**
+     * Nombre accesible de la lista de resultados (`role="listbox"`). **Sin
+     * default**: sin ella, sale de `commandPalette.list` del proveedor.
      */
     listLabel?: string;
-    /** Etiqueta del botón de cierre del diálogo. */
+    /**
+     * Nombre accesible del aspa del diálogo. **Reenvío puro** al `Modal`: sin
+     * él, el aspa lee `modal.close` del proveedor.
+     */
     closeLabel?: string;
     /**
      * Tecla del atajo global (con ⌘ o Ctrl) que abre y cierra la paleta.

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

@@ -1,6 +1,43 @@
 import { type ReactNode } from 'react';
 import './Consent.css';
 import { Modal } from '../Modal/Modal';
+/**
+ * El cromo del consentimiento, y **solo el cromo**: lo que la banda y el
+ * panel dicen por su cuenta y vale igual en cualquier sitio que los monte.
+ *
+ * La línea cae aquí en medio de una pieza legal, así que conviene decirla
+ * entera:
+ *
+ * - **Los botones son cromo.** «Aceptar todas», «Rechazar» y «Preferencias»
+ *   nombran las tres salidas que la ePrivacy pide, y son las mismas en todos
+ *   los sitios: no describen qué se guarda, describen qué hace el botón.
+ * - **El título y el nombre de la región son cromo.** «Cookies» nombra el
+ *   mecanismo, no la política de nadie.
+ * - **`description` y `policyLabel` NO están aquí y son obligatorias.** El
+ *   texto legal depende de la jurisdicción y de lo que cada producto guarde
+ *   de verdad: un default de catálogo lo haría decir lo mismo en todas partes
+ *   —que es exactamente lo que un texto legal no puede hacer— y, siendo
+ *   opcional, nadie llegaría a escribir el bueno. Como el `confirmLabel` del
+ *   `ConfirmDialog`.
+ * - **Las categorías tampoco.** Su nombre y su descripción son contenido: qué
+ *   guarda cada una lo sabe el producto.
+ */
+export interface ConsentMessages {
+    /** Título de la banda. */
+    title: string;
+    /** Nombre accesible de la región de la banda (`role="region"`). */
+    regionLabel: string;
+    /** Rótulo del botón que acepta todas las categorías. */
+    acceptAll: string;
+    /** Rótulo del botón que rechaza las opcionales. */
+    rejectAll: string;
+    /** Rótulo del botón que abre el panel de preferencias. */
+    preferences: string;
+    /** Título del panel de preferencias. */
+    preferencesTitle: string;
+    /** Marca, solo para lectores de pantalla, de una categoría necesaria. */
+    alwaysOn: string;
+}
 /** Una categoría de tecnologías sobre la que se pide (o no) consentimiento. */
 export interface ConsentCategory {
     /** Identificador de la categoría. Es la clave dentro de `value`. */
@@ -18,7 +55,25 @@ export interface ConsentCategory {
 }
 /** La decisión: qué categorías están aceptadas, por `id`. */
 export type ConsentValue = Record<string, boolean>;
-export interface ConsentBannerProps extends Omit<React.ComponentPropsWithoutRef<'aside'>, 'title' | 'children' | 'onChange'> {
+/**
+ * El enlace a la política: o no está, o está **entero**. El texto del enlace
+ * es contenido —lo escribe la app y depende de la jurisdicción—, así que no
+ * sale del catálogo, y una `policyHref` sin `policyLabel` dejaría un enlace
+ * sin nombre. El tipo lo impide en compilación.
+ */
+export type ConsentPolicyProps = {
+    policyHref?: undefined;
+    policyLabel?: undefined;
+    policyExternal?: undefined;
+} | {
+    /** URL de la política de cookies. */
+    policyHref: string;
+    /** Texto del enlace a la política. **Obligatorio con `policyHref`**: es contenido, no sale del catálogo. */
+    policyLabel: string;
+    /** Abre la política en otra pestaña (la política suele vivir en la web pública). */
+    policyExternal?: boolean;
+};
+export interface ConsentBannerBaseProps extends Omit<React.ComponentPropsWithoutRef<'aside'>, 'title' | 'children' | 'onChange'> {
     /**
      * Muestra la banda. Es la primera visita, o la decisión ha caducado: quién lo
      * sabe es el consumidor, que es también quien guarda la cookie. Default: `true`.
@@ -30,28 +85,41 @@ export interface ConsentBannerProps extends Omit<React.ComponentPropsWithoutRef<
     onRejectAll: () => void;
     /** Abre el panel de preferencias. Sin ella no se pinta el botón. */
     onOpenPreferences?: () => void;
-    /** Título de la banda. Default castellano: `'Cookies'`. */
+    /**
+     * Título de la banda. **Sin default**: sin él, sale de `consent.title` del
+     * `BrandMessagesProvider`.
+     */
     title?: ReactNode;
-    /** Texto de la banda. Default castellano. */
-    description?: ReactNode;
-    /** URL de la política de cookies. Sin ella no se pinta el enlace. */
-    policyHref?: string;
-    /** Texto del enlace a la política. Default castellano: `'Política de cookies'`. */
-    policyLabel?: string;
-    /** Abre la política en otra pestaña (la política suele vivir en la web pública). */
-    policyExternal?: boolean;
-    /** Etiqueta del botón de aceptar. Default castellano: `'Aceptar todas'`. */
+    /**
+     * Texto de la banda: qué se guarda y por qué. **Obligatorio y sin default**
+     * — es el texto legal, depende de la jurisdicción y de lo que el producto
+     * guarde de verdad, así que no sale del catálogo. Ver `ConsentMessages`.
+     */
+    description: ReactNode;
+    /**
+     * Etiqueta del botón de aceptar. **Sin default**: sin ella, sale de
+     * `consent.acceptAll` del proveedor.
+     */
     acceptAllLabel?: string;
-    /** Etiqueta del botón de rechazar. Default castellano: `'Rechazar'`. */
+    /**
+     * Etiqueta del botón de rechazar. **Sin default**: sin ella, sale de
+     * `consent.rejectAll` del proveedor.
+     */
     rejectAllLabel?: string;
-    /** Etiqueta del botón de preferencias. Default castellano: `'Preferencias'`. */
+    /**
+     * Etiqueta del botón de preferencias. **Sin default**: sin ella, sale de
+     * `consent.preferences` del proveedor. Solo se lee si hay
+     * `onOpenPreferences`: sin botón no se exige su texto.
+     */
     preferencesLabel?: string;
     /**
-     * Nombre accesible de la región. Default: el propio `title` cuando es texto;
-     * si el título lleva JSX, pásalo. Default castellano: `'Consentimiento de cookies'`.
+     * Nombre accesible de la región. **Sin default**: sin él, sale de
+     * `consent.regionLabel` del proveedor. Pásalo cuando el título lleve JSX y
+     * quieras que la región se nombre con otra cosa.
      */
     regionLabel?: string;
 }
+export type ConsentBannerProps = ConsentBannerBaseProps & ConsentPolicyProps;
 /**
  * La banda de consentimiento: qué se quiere guardar y tres salidas —aceptar,
  * rechazar, decidir por categorías—. **No es un diálogo**: no atrapa el foco, no
@@ -91,17 +159,22 @@ export interface ConsentPreferencesProps {
     surface?: 'sheet' | 'modal';
     /** Borde por el que entra el panel (solo con `surface="sheet"`, la alternativa lateral que el sistema conserva para otros usos). Default: `'right'`. */
     side?: 'top' | 'right' | 'bottom' | 'left';
-    /** Título del panel. Default castellano: `'Preferencias de cookies'`. */
+    /**
+     * Título del panel. **Sin default**: sin él, sale de
+     * `consent.preferencesTitle` del `BrandMessagesProvider`.
+     */
     title?: ReactNode;
     /**
      * Nombre accesible del botón de cerrar. **Reenvío puro** al `Modal` o al
      * `Sheet` sobre el que se abre el panel: sin él, el aspa lee `modal.close`
-     * o `sheet.close` del `BrandMessagesProvider`. El resto de los textos de
-     * `Consent` sigue con su default castellano — este componente todavía no
-     * está migrado al proveedor.
+     * o `sheet.close` del `BrandMessagesProvider`. El espacio `consent` no
+     * repite la clave.
      */
     closeLabel?: string;
-    /** Marca de una categoría necesaria. Default castellano: `'Siempre activa'`. */
+    /**
+     * Marca de una categoría necesaria, solo para lectores de pantalla. **Sin
+     * default**: sin ella, sale de `consent.alwaysOn` del proveedor.
+     */
     alwaysOnLabel?: string;
     /**
      * Nodo DOM donde montar el portal del panel, reenviado a `Modal`/`Sheet`.

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

@@ -1,19 +1,32 @@
 import { type ButtonBaseProps } from '../../atoms/Button/Button';
 import './NotificationButton.css';
+/**
+ * El cromo de la campana, y **solo el cromo**: cómo se llama el botón, con
+ * contador y sin él. La campana no dice nada más —el número lo pinta el
+ * `NumberBadge` y las notificaciones viven en otro sitio—, así que los dos
+ * textos son todo lo que emite por su cuenta, y ninguno cambia de pantalla a
+ * pantalla.
+ */
+export interface NotificationButtonMessages {
+    /** Nombre accesible cuando no hay contador. */
+    label: string;
+    /** Nombre accesible cuando hay contador. Recibe el número. */
+    countLabel: (count: number) => string;
+}
 export interface NotificationButtonProps extends Omit<ButtonBaseProps, 'variant' | 'iconOnly' | 'children' | 'href' | 'size'> {
     /** Notificaciones sin leer. Con 0 (o sin él) no hay contador. */
     count?: number;
     /** Tope del contador («99+»). */
     max?: number;
     /**
-     * Nombre accesible cuando no hay contador. Default: «Notificaciones»
-     * (castellano). Una app multiidioma debe pasarla traducida.
+     * Nombre accesible cuando no hay contador. **Sin default**: sin ella, sale
+     * de `notificationButton.label` del `BrandMessagesProvider`.
      */
     label?: string;
     /**
      * Nombre accesible cuando hay contador: recibe el número, para que la frase
-     * se pueda rehacer en cualquier idioma. Default: «Notificaciones: N sin
-     * leer» (castellano).
+     * se pueda rehacer en cualquier idioma. **Sin default**: sin ella, sale de
+     * `notificationButton.countLabel` del proveedor.
      */
     countLabel?: (count: number) => string;
 }

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

@@ -1,6 +1,30 @@
 import { type ReactNode } from 'react';
 import { type PopoverChangeDetails } from '../../atoms/Popover/Popover';
 import './NotificationPanel.css';
+/**
+ * El cromo del panel, y **solo el cromo**: cómo se llama el panel, la marca de
+ * una fila sin leer, el vacío, los dos destinos del pie y la acción sobre el
+ * conjunto. Ninguno nombra una notificación: eso viaja en `items` y lo escribe
+ * el producto —título, cuerpo y la hora, ya formateada por el consumidor—.
+ *
+ * Los textos de la campana **no están aquí**: `label` y `countLabel` son un
+ * reenvío puro al `NotificationButton`, que tiene su propio espacio. El panel
+ * no repite la clave.
+ */
+export interface NotificationPanelMessages {
+    /** Nombre del panel (`role="dialog"`) y de la lista. No se pinta. */
+    panel: string;
+    /** Texto, solo para lectores de pantalla, que marca una fila sin leer. */
+    unread: string;
+    /** Mensaje cuando no hay notificaciones. */
+    empty: string;
+    /** Rótulo del enlace a la bandeja. */
+    all: string;
+    /** Rótulo del enlace a las preferencias. */
+    preferences: string;
+    /** Rótulo del botón de marcar todas como leídas. */
+    markAllRead: string;
+}
 /** Una notificación tal y como la enseña el panel: ya resuelta, sin datos crudos. */
 export interface NotificationPanelItem {
     id: string;
@@ -56,24 +80,46 @@ export interface NotificationPanelProps {
      * `<a>` corriente.
      */
     renderLink?: RenderNotificationPanelLink;
-    /** Nombre accesible de la campana sin contador. Default castellano. */
+    /**
+     * Nombre accesible de la campana sin contador. **Reenvío puro** al
+     * `NotificationButton`: sin ella, sale de `notificationButton.label`.
+     */
     label?: string;
-    /** Nombre accesible de la campana con contador. Recibe el número. Default castellano. */
+    /**
+     * Nombre accesible de la campana con contador. **Reenvío puro** al
+     * `NotificationButton`: sin ella, sale de `notificationButton.countLabel`.
+     */
     countLabel?: (count: number) => string;
     /**
      * Nombre del panel (`role="dialog"`) y de la lista. **No se pinta**: el
-     * panel no lleva cabecera visible. Default «Notificaciones».
+     * panel no lleva cabecera visible. **Sin default**: sin él, sale de
+     * `notificationPanel.panel` del `BrandMessagesProvider`.
      */
     panelLabel?: string;
-    /** Texto solo para lectores de pantalla que marca una fila sin leer. Default «Sin leer». */
+    /**
+     * Texto solo para lectores de pantalla que marca una fila sin leer. **Sin
+     * default**: sin él, sale de `notificationPanel.unread`.
+     */
     unreadLabel?: string;
-    /** Mensaje cuando no hay notificaciones. Default «Estás al día». */
+    /**
+     * Mensaje cuando no hay notificaciones. **Sin default**: sin él, sale de
+     * `notificationPanel.empty`.
+     */
     emptyLabel?: string;
-    /** Rótulo del enlace a la bandeja. Default «Ver todas las notificaciones». */
+    /**
+     * Rótulo del enlace a la bandeja. **Sin default**: sin él, sale de
+     * `notificationPanel.all`.
+     */
     allLabel?: string;
-    /** Rótulo del enlace a las preferencias. Default «Preferencias de notificaciones». */
+    /**
+     * Rótulo del enlace a las preferencias. **Sin default**: sin él, sale de
+     * `notificationPanel.preferences`.
+     */
     preferencesLabel?: string;
-    /** Rótulo del botón de marcar todas. Default «Marcar todas como leídas». */
+    /**
+     * Rótulo del botón de marcar todas. **Sin default**: sin él, sale de
+     * `notificationPanel.markAllRead`. Solo se lee cuando el botón se pinta.
+     */
     markAllReadLabel?: string;
     open?: boolean;
     defaultOpen?: boolean;

package/dist/_types/sections/FloatingDock/FloatingDock.d.ts

@@ -1,5 +1,29 @@
 import { type ReactNode } from 'react';
 import './FloatingDock.css';
+/**
+ * El cromo del dock, y **solo el cromo**: el aspa y cómo se lee el contador.
+ *
+ * **Tiene espacio propio y no hereda `modal.close`, a propósito.** El panel del
+ * dock no es un `Modal` y no puede serlo: es un diálogo **no modal**
+ * (`modal={false}`) sin velo, que no atrapa el foco y deja la página viva
+ * detrás, montado por portal **dentro del propio ancla** para heredar por
+ * cascada la superficie donde el consumidor lo haya puesto, anclado a una
+ * esquina de la ventana y con el aspa fuera de la cabecera. El `Modal` del
+ * sistema es lo contrario en las cuatro cosas —velo, foco atrapado, portal en
+ * `document.body`, diálogo centrado—, así que hacerlo pasar por él no era
+ * quitar una clave: era cambiar el componente. La razón es real y de hoy, no
+ * histórica, y por eso el aspa se llama aquí.
+ *
+ * El `label` del lanzador **no está aquí**: nombra lo que abre el dock —«Abrir
+ * el asistente», «Abrir el chat de soporte»— y eso lo sabe el producto. Sigue
+ * siendo prop obligatoria.
+ */
+export interface FloatingDockMessages {
+    /** Nombre accesible del aspa que cierra el panel. */
+    close: string;
+    /** Cómo se lee el contador de novedades. Interpola el número. */
+    badge: (count: number) => string;
+}
 /** Esquina de la ventana a la que se ancla el dock. */
 export type FloatingDockPosition = 'bottom-end' | 'bottom-start' | 'top-end' | 'top-start';
 export interface FloatingDockProps extends Omit<React.ComponentPropsWithoutRef<'div'>, 'title' | 'children'> {
@@ -26,15 +50,21 @@ export interface FloatingDockProps extends Omit<React.ComponentPropsWithoutRef<'
     defaultOpen?: boolean;
     /** Se llama al abrirse y al cerrarse, en controlado y en no controlado. */
     onOpenChange?: (open: boolean) => void;
-    /** `aria-label` del aspa. Default: «Cerrar» (castellano). */
+    /**
+     * `aria-label` del aspa. **Sin default**: sin él, sale de
+     * `floatingDock.close` del `BrandMessagesProvider` — espacio propio, no
+     * `modal.close`: el panel del dock no es un `Modal` (ver
+     * `FloatingDockMessages`).
+     */
     closeLabel?: string;
     /** Novedades sin ver. Con 0 (o sin él) no hay contador. */
     badge?: number;
     /** Tope del contador («99+»). */
     badgeMax?: number;
     /**
-     * Cómo se lee el contador. Default: «N mensajes nuevos» (castellano).
-     * Interpola el número, así que es una función.
+     * Cómo se lee el contador. **Sin default**: sin ella, sale de
+     * `floatingDock.badge` del proveedor. Interpola el número, así que es una
+     * función. Solo se lee cuando hay contador y `badgeLive`.
      */
     badgeLabel?: (count: number) => string;
     /**