@studiolxd/brand 45.1.0 → 47.0.0

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

@@ -29,6 +29,13 @@ export interface MenuProps {
     maxWidth?: string;
     /** Talla de los ítems, la del disparador (32/40/48): el panel desplegado casa con el control plegado, como en el Select. */
     size?: 'sm' | 'md' | 'lg';
+    /**
+     * Nodo DOM donde montar el portal. Por defecto, el nodo de la superficie que
+     * llegue por contexto —`SiteShell` publica el suyo, para que la capa herede
+     * la talla de la superficie pública— y, si no hay ninguna, `document.body`.
+     * Pásalo solo para llevar la capa a otro sitio: gana siempre.
+     */
+    container?: HTMLElement | null;
     className?: string;
 }
 /**
@@ -36,4 +43,4 @@ export interface MenuProps {
  * (tokens `menu.*`) de todos los menús; `ContextMenu`, `UserMenu`,
  * `OrgSwitcher` o `DropdownField` son este menú con un disparador concreto.
  */
-export declare function Menu({ trigger, items, value, onValueChange, renderLink, open, defaultOpen, onOpenChange, openOnHover, hoverDelay, side, align, sideOffset, minWidth, maxWidth, size, className, }: MenuProps): import("react/jsx-runtime").JSX.Element;
+export declare function Menu({ trigger, items, value, onValueChange, renderLink, open, defaultOpen, onOpenChange, openOnHover, hoverDelay, side, align, sideOffset, minWidth, maxWidth, size, container, className, }: MenuProps): import("react/jsx-runtime").JSX.Element;

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

@@ -33,12 +33,14 @@ export interface ModalProps extends Omit<React.ComponentPropsWithoutRef<'div'>,
      */
     fallbackTitle?: string;
     /**
-     * Nodo DOM donde montar el portal del modal (reenviado a Base UI
-     * `Portal.container`). Por defecto se monta en `document.body`, que
-     * hereda el tema activado a nivel raíz (`html.dark`/`[data-theme="dark"]`)
-     * sin configuración adicional. Solo hace falta pasarlo cuando el Modal
-     * vive dentro de un `.surface-dark` **anidado** (no en la raíz), ya que
-     * ese contexto no llega a `document.body` por la cascada.
+     * Nodo DOM donde montar el portal del modal (reenviado a Base UI `Portal.container`).
+     * Por defecto, el nodo de la superficie que llegue por contexto:
+     * `SiteShell` publica el suyo, de modo que la capa hereda la talla de la
+     * superficie pública en vez de abrirse a la de aplicación. Si no hay
+     * superficie, `document.body` — que ya hereda el tema activado en la raíz
+     * (`html.dark`/`[data-theme="dark"]`) sin configuración adicional. Pásalo
+     * solo para llevar la capa a otro sitio: un `.surface-dark` **anidado**, el
+     * cajón de un shell propio. Gana siempre.
      */
     container?: React.ComponentPropsWithoutRef<typeof Dialog.Portal>['container'];
     /**

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

@@ -6,8 +6,22 @@ export interface OrgOption {
     name: string;
     logoUrl?: string;
 }
+/**
+ * El único texto que el conmutador dice por su cuenta, y es **cromo**: cómo se
+ * nombra su botón. Interpola la organización activa, así que es una función.
+ * Los nombres de las organizaciones son **contenido** y vienen en
+ * `organizations`.
+ */
+export interface OrgSwitcherMessages {
+    /** Nombre accesible del botón, a partir del nombre de la organización. */
+    trigger: (name: string) => string;
+}
 export interface OrgSwitcherProps {
-    /** Nombre accesible del botón. Por defecto, «Organización: ‹nombre›». */
+    /**
+     * Nombre accesible del botón. **Sin default**: sin él, sale de
+     * `orgSwitcher.trigger` del `BrandMessagesProvider`, que recibe el nombre de
+     * la organización activa.
+     */
     label?: string;
     /** Ocupa todo el ancho disponible (en la Sidebar). Por defecto mide lo que su contenido. */
     block?: boolean;

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

@@ -16,10 +16,14 @@ export interface PrevNextNavProps {
     /**
      * Rótulo del control anterior. Sin `prevTitle` es el `aria-label` del
      * chevron; con `prevTitle` es el rótulo **visible** que lo encabeza.
-     * Default: "Anterior"
+     * **Sin default**: sin él, sale de `prevNextNav.previous` del
+     * `BrandMessagesProvider`.
      */
     prevLabel?: string;
-    /** Rótulo del control siguiente. Mismo contrato que `prevLabel`. Default: "Siguiente" */
+    /**
+     * Rótulo del control siguiente. Mismo contrato que `prevLabel`. **Sin
+     * default**: sale de `prevNextNav.next`.
+     */
     nextLabel?: string;
     /**
      * Título visible del destino anterior (el de la página, el capítulo…). Con
@@ -47,4 +51,15 @@ export interface PrevNextNavProps {
     /** Variante de densidad. Default: "md" */
     size?: 'sm' | 'md';
 }
+/**
+ * Los dos textos del par, y los dos son **cromo**: «anterior» y «siguiente»
+ * dicen la dirección, no el destino. El destino —`prevTitle`, `nextTitle`, el
+ * rótulo del medio— es **contenido** y lo escribe la página.
+ */
+export interface PrevNextNavMessages {
+    /** Rótulo del control anterior. */
+    previous: string;
+    /** Rótulo del control siguiente. */
+    next: string;
+}
 export declare function PrevNextNav({ prevHref, nextHref, prevOnClick, nextOnClick, prevLabel, nextLabel, prevTitle, nextTitle, label, labelId, linkComponent, size, }: PrevNextNavProps): import("react/jsx-runtime").JSX.Element;

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

@@ -39,13 +39,14 @@ export interface SheetProps extends Omit<React.ComponentPropsWithoutRef<'div'>,
     /** Elemento que abre el panel. Sin él, la apertura la controla el consumidor. */
     trigger?: ReactNode;
     /**
-     * Nodo DOM donde montar el portal del panel (reenviado a Base UI
-     * `Portal.container`). Por defecto se monta en `document.body`, que
-     * hereda el tema activado a nivel raíz (`html.dark`/`[data-theme="dark"]`)
-     * sin configuración adicional. Solo hace falta pasarlo cuando el Sheet
-     * vive dentro de una superficie **anidada** (un `.surface-dark` que no está
-     * en la raíz, o dentro de `SiteShell`/`.site-shell`), ya que ese contexto
-     * no llega a `document.body` por la cascada.
+     * Nodo DOM donde montar el portal del panel (reenviado a Base UI `Portal.container`).
+     * Por defecto, el nodo de la superficie que llegue por contexto:
+     * `SiteShell` publica el suyo, de modo que la capa hereda la talla de la
+     * superficie pública en vez de abrirse a la de aplicación. Si no hay
+     * superficie, `document.body` — que ya hereda el tema activado en la raíz
+     * (`html.dark`/`[data-theme="dark"]`) sin configuración adicional. Pásalo
+     * solo para llevar la capa a otro sitio: un `.surface-dark` **anidado**, el
+     * cajón de un shell propio. Gana siempre.
      */
     container?: React.ComponentPropsWithoutRef<typeof Dialog.Portal>['container'];
     /**

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

@@ -41,11 +41,14 @@ export type SidebarNavRenderLinkProps = React.AnchorHTMLAttributes<HTMLAnchorEle
     'aria-current'?: 'page';
 };
 export interface SidebarNavProps {
-    /** Nombre accesible del `nav`. */
+    /**
+     * Nombre accesible del `nav`. **Sin default**: sin él, sale de
+     * `sidebarNav.label` del `BrandMessagesProvider`.
+     */
     label?: string;
     /**
-     * Marca de las entradas vacías (`empty`). Por defecto, en castellano:
-     * «sin docs».
+     * Marca de las entradas vacías (`empty`). **Sin default**: sale de
+     * `sidebarNav.empty`. Solo se lee cuando hay alguna entrada vacía.
      */
     emptyLabel?: string;
     /** Solo iconos: los enlaces con tooltip, los grupos como menú. Sin él, lo decide la `Sidebar` (rail). */
@@ -56,4 +59,16 @@ export interface SidebarNavProps {
     onValueChange?: (value: string[]) => void;
     renderLink?: (props: SidebarNavRenderLinkProps) => ReactNode;
 }
+/**
+ * Los dos textos de la navegación, los dos **cromo**: el nombre de la región
+ * («Principal», el mismo en toda la suite) y la marca que se pone a una entrada
+ * sin contenido. Los rótulos de las entradas son **contenido** y siguen
+ * viniendo en `entries`.
+ */
+export interface SidebarNavMessages {
+    /** Nombre accesible del `nav`. */
+    label: string;
+    /** Marca de las entradas sin contenido. */
+    empty: string;
+}
 export declare function SidebarNav({ label, emptyLabel, rail, entries, defaultValue, value, onValueChange, renderLink, }: SidebarNavProps): import("react/jsx-runtime").JSX.Element;

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

@@ -49,4 +49,13 @@ export interface SiteNavProps {
  * `style-src 'self'` descarta el atributo sin avisar y el grupo de más caía
  * a la segunda fila.
  */
+/**
+ * El único texto que el índice dice por su cuenta, y es **cromo**: el nombre de
+ * la región de navegación. Los grupos y sus enlaces son **contenido** y vienen
+ * en `groups`.
+ */
+export interface SiteNavMessages {
+    /** Nombre accesible del `nav`. */
+    label: string;
+}
 export declare function SiteNav({ groups, label, renderLink, className, }: SiteNavProps): import("react/jsx-runtime").JSX.Element;

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

@@ -17,8 +17,8 @@ export interface TableOfContentsProps extends Omit<React.ComponentPropsWithoutRe
      */
     activeId?: string;
     /**
-     * Nombre accesible del `nav`. Por defecto, en castellano.
-     * @default 'En esta página'
+     * Nombre accesible del `nav`. **Sin default**: sin él, sale de
+     * `tableOfContents.label` del `BrandMessagesProvider`.
      */
     ariaLabel?: string;
     /** Rótulo visible sobre la lista. Sin él, no se pinta ninguno. */
@@ -46,4 +46,13 @@ export interface TableOfContentsProps extends Omit<React.ComponentPropsWithoutRe
  * `{...rest}` (`id`, `data-*`, `role`…) se reenvía al `<nav>`. El nombre
  * accesible sigue siendo `ariaLabel`.
  */
+/**
+ * El único texto que el índice dice por su cuenta, y es **cromo**: «En esta
+ * página» nombra la región, no la página. El rótulo visible (`title`) y los
+ * encabezados (`items`) son **contenido**.
+ */
+export interface TableOfContentsMessages {
+    /** Nombre accesible del `nav`. */
+    label: string;
+}
 export declare const TableOfContents: import("react").ForwardRefExoticComponent<TableOfContentsProps & import("react").RefAttributes<HTMLElement>>;

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

@@ -1,11 +1,26 @@
 import type { ReactNode } from 'react';
 import type { MenuItem, MenuRenderLinkProps } from '../Menu/Menu';
 import './UserMenu.css';
+/**
+ * Lo que el menú de cuenta dice por su cuenta, y es **cromo**: cómo se nombra
+ * su botón y cómo se cuentan las notificaciones sin leer. Los dos interpolan un
+ * dato —el nombre, el número—, así que son funciones. El nombre, el correo y
+ * los ítems son **contenido** y siguen viniendo por props.
+ */
+export interface UserMenuMessages {
+    /** Nombre accesible del botón, a partir del nombre del usuario. */
+    trigger: (name: string) => string;
+    /** Nombre accesible del contador de notificaciones sin leer. */
+    unread: (count: number) => string;
+}
 export interface UserMenuProps {
     name: string;
     email: string;
     avatarUrl?: string;
-    /** Nombre accesible del botón. Por defecto, «Cuenta de ‹nombre›». */
+    /**
+     * Nombre accesible del botón. **Sin default**: sin él, sale de
+     * `userMenu.trigger` del `BrandMessagesProvider`, que recibe el nombre.
+     */
     label?: string;
     /** Sin nombre — avatar, badge y chevron: para la barra del AppHeader. El nombre sigue en el panel y en el nombre accesible. */
     compact?: boolean;

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

@@ -7,9 +7,15 @@ export interface AppHeaderProps {
     notifications?: ReactNode;
     /** Al final, siempre: el `UserMenu` (compacto). */
     end?: ReactNode;
-    /** Texto accesible del botón de menú. */
+    /**
+     * Texto accesible del botón de menú. **Reenvío puro** al `MenuButton`: sin
+     * él, el botón lee `menuButton.open` del `BrandMessagesProvider`.
+     */
     menuLabel?: string;
-    /** Texto accesible del botón cuando la sidebar está abierta («Cerrar menú»). */
+    /**
+     * Texto accesible del botón con la sidebar abierta. **Reenvío puro** al
+     * `MenuButton`: sin él, lee `menuButton.close`.
+     */
     menuCloseLabel?: string;
     /** id de la sidebar que gobierna el botón (`aria-controls`). */
     sidebarId?: string;

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

@@ -1,6 +1,17 @@
 import type { ReactNode } from 'react';
-export interface AppRootProps {
+/**
+ * El único texto de la raíz, y es **cromo**: el enlace de salto al contenido
+ * dice lo mismo en todo el documento y en todos los productos.
+ */
+export interface AppRootMessages {
     /** Texto del enlace de salto al contenido. */
+    skipToContent: string;
+}
+export interface AppRootProps {
+    /**
+     * Texto del enlace de salto al contenido. **Sin default**: sin él, sale de
+     * `appRoot.skipToContent` del `BrandMessagesProvider`.
+     */
     skipLabel?: string;
     /** Destino del salto: el `id` del contenido principal de la página. */
     skipHref?: string;

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

@@ -17,9 +17,22 @@ export interface AppShellProps {
     /** Ancho inicial de la sidebar desplegada (px). Sin él, el token `sidebar.width`. */
     defaultSidebarWidth?: number;
     onSidebarWidthChange?: (width: number) => void;
-    /** Texto del enlace de salto al contenido (`SkipLink`). Default: castellano. */
+    /**
+     * Texto del enlace de salto al contenido (`SkipLink`). **Sin default**: sin
+     * él, sale de `appShell.skipToContent` del `BrandMessagesProvider`.
+     */
     skipLabel?: string;
 }
+/**
+ * El único texto que el armazón dice por su cuenta, y es **cromo**: el enlace
+ * de salto al contenido dice lo mismo en todas las pantallas de todas las
+ * aplicaciones. Lo que hay dentro del armazón —la barra, la navegación, la
+ * página— lo escribe el producto.
+ */
+export interface AppShellMessages {
+    /** Texto del enlace de salto al contenido. */
+    skipToContent: string;
+}
 /**
  * El armazón de una aplicación: barra superior, barra lateral y contenido.
  * Lleva el estado de la sidebar (abierta, rail o cerrada; su ancho) y lo