@studiolxd/brand 47.0.0 → 48.0.0

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

@@ -1,15 +1,52 @@
 import './Carousel.css';
+/**
+ * El cromo del carrusel: cómo se llaman la región y la pista, qué hacen sus
+ * mandos y qué se anuncia al cambiar de diapositiva. Todo cromo — dicen qué es
+ * y qué hace el carrusel, nunca qué hay dentro: el contenido de cada
+ * diapositiva lo pone quien la monta.
+ *
+ * Las dos `roleDescription` también van aquí: las lee el lector de pantalla en
+ * voz alta, así que son texto y no una palabra clave del motor.
+ */
+export interface CarouselMessages {
+    /** Nombre accesible de la región cuando la pantalla no le da uno propio. */
+    label: string;
+    /** `aria-roledescription` de la región: qué es esto. */
+    roleDescription: string;
+    /** Nombre accesible de la pista, la que recibe el foco para desplazarse. */
+    track: string;
+    /** Nombre accesible del botón de retroceso. */
+    previous: string;
+    /** Nombre accesible del botón de avance. */
+    next: string;
+    /** Nombre accesible del indicador n (base 0). Interpola, así que es función. */
+    indicator: (index: number) => string;
+    /** Nombre accesible del botón que detiene el avance automático. */
+    pause: string;
+    /** Nombre accesible del botón que lo reanuda. */
+    play: string;
+    /** Lo que se anuncia al cambiar de diapositiva. Interpola, así que es función. */
+    slideStatus: (index: number, total: number) => string;
+    /** `aria-roledescription` de cada diapositiva. */
+    slideRoleDescription: string;
+}
 export interface CarouselProps {
     /** Las diapositivas: uno o varios `CarouselSlide`. */
     children: React.ReactNode;
-    /** Nombre accesible de la región. Default: «Carrusel» (castellano). Una app multiidioma debe pasarlo traducido. */
+    /**
+     * Nombre accesible de la región. **Sin default**: sin él, sale de
+     * `carousel.label` del `BrandMessagesProvider`.
+     */
     label?: string;
     /**
-     * Texto de `aria-roledescription` de la región. Por defecto «carrusel», en
-     * castellano: es el lector de pantalla quien lo lee, así que se traduce.
+     * Texto de `aria-roledescription` de la región. **Sin default**: sin él,
+     * sale de `carousel.roleDescription`.
      */
     roleDescription?: string;
-    /** Nombre accesible de la pista, la que recibe el foco para desplazarse con el teclado. Default: «Diapositivas» (castellano). Una app multiidioma debe pasarlo traducido. */
+    /**
+     * Nombre accesible de la pista, la que recibe el foco para desplazarse con
+     * el teclado. **Sin default**: sin él, sale de `carousel.track`.
+     */
     trackLabel?: string;
     /**
      * Ancho de cada diapositiva — cualquier medida CSS (`'50%'`, `'18rem'`,
@@ -29,19 +66,34 @@ export interface CarouselProps {
      * movimiento automático: pararlo así es definitivo, no se reanuda solo.
      */
     autoplay?: number;
-    /** Texto accesible del botón «anterior». Default: «Anterior» (castellano). Una app multiidioma debe pasarlo traducido. */
+    /**
+     * Texto accesible del botón «anterior». **Sin default**: sin él, sale de
+     * `carousel.previous`. Solo se lee con `controls`.
+     */
     prevLabel?: string;
-    /** Texto accesible del botón «siguiente». Default: «Siguiente» (castellano). Una app multiidioma debe pasarlo traducido. */
+    /**
+     * Texto accesible del botón «siguiente». **Sin default**: sin él, sale de
+     * `carousel.next`. Solo se lee con `controls`.
+     */
     nextLabel?: string;
-    /** Texto accesible del indicador n. Default: «Ir a la diapositiva N» (castellano). Una app multiidioma debe pasarlo traducido. */
+    /**
+     * Texto accesible del indicador n. **Sin default**: sin él, sale de
+     * `carousel.indicator`. Solo se lee con `indicators`.
+     */
     indicatorLabel?: (index: number) => string;
-    /** Texto accesible del botón que detiene el avance automático. Por defecto «Pausar». */
+    /**
+     * Texto accesible del botón que detiene el avance automático. **Sin
+     * default**: sin él, sale de `carousel.pause`. Solo se lee con `autoplay`.
+     */
     pauseLabel?: string;
-    /** Texto accesible del botón que reanuda el avance automático. Por defecto «Reproducir». */
+    /**
+     * Texto accesible del botón que reanuda el avance automático. **Sin
+     * default**: sin él, sale de `carousel.play`. Solo se lee con `autoplay`.
+     */
     playLabel?: string;
     /**
-     * Texto que se anuncia al cambiar de diapositiva. Por defecto «Diapositiva N
-     * de M». Lo lee el lector de pantalla: se traduce.
+     * Texto que se anuncia al cambiar de diapositiva. **Sin default**: sin él,
+     * sale de `carousel.slideStatus`.
      */
     slideStatusLabel?: (index: number, count: number) => string;
     className?: string;
@@ -61,8 +113,8 @@ export interface CarouselProps {
 export declare function Carousel({ children, label, roleDescription, trackLabel, slideSize, controls, indicators, autoplay, prevLabel, nextLabel, indicatorLabel, pauseLabel, playLabel, slideStatusLabel, className, id, }: CarouselProps): import("react/jsx-runtime").JSX.Element;
 export interface CarouselSlideProps extends React.ComponentPropsWithoutRef<'div'> {
     /**
-     * Texto de `aria-roledescription` de la diapositiva. Por defecto
-     * «diapositiva», en castellano.
+     * Texto de `aria-roledescription` de la diapositiva. **Sin default**: sin
+     * él, sale de `carousel.slideRoleDescription` del `BrandMessagesProvider`.
      */
     roleDescription?: string;
     children: React.ReactNode;

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

@@ -1,4 +1,17 @@
 import './CodeBlock.css';
+/**
+ * Los dos textos propios del bloque de código. El acuse de copiar **no está
+ * aquí**: es el de toda la familia y sale de `copy.copied`.
+ */
+export interface CodeBlockMessages {
+    /** Nombre accesible del botón de copiar. Dice qué se copia: código. */
+    copy: string;
+    /**
+     * Nombre accesible del área de código, que es focalizable por tener scroll
+     * horizontal propio. Recibe el lenguaje cuando lo hay.
+     */
+    region: (language?: string) => string;
+}
 export interface CodeBlockProps extends React.ComponentPropsWithoutRef<'div'> {
     /** Código a mostrar. Texto plano o nodos ya resaltados por un highlighter externo. */
     children: React.ReactNode;
@@ -17,18 +30,19 @@ export interface CodeBlockProps extends React.ComponentPropsWithoutRef<'div'> {
      */
     singleLine?: boolean;
     /**
-     * aria-label del botón de copiar. Default: "Copiar código" (castellano).
-     * Una app multiidioma debe pasarla traducida.
+     * aria-label del botón de copiar. **Sin default**: sin él, sale de
+     * `codeBlock.copy` del `BrandMessagesProvider`. Solo se lee con `copyable`.
      */
     copyLabel?: string;
     /**
-     * Texto que se anuncia al lector de pantalla tras copiar. Default: "Copiado"
-     * (castellano).
+     * Texto que se anuncia al lector de pantalla tras copiar. **Sin default**:
+     * sin él, sale de `copy.copied` —el acuse de toda la familia de copiar, no
+     * uno propio del bloque.
      */
     copiedLabel?: string;
     /**
-     * Nombre accesible del área de código, que es focalizable por tener scroll
-     * horizontal propio. Recibe el `language` cuando lo hay. Default en castellano.
+     * Nombre accesible del área de código. Recibe el `language` cuando lo hay.
+     * **Sin default**: sin él, sale de `codeBlock.region`.
      */
     codeLabel?: (language?: string) => string;
     /** Se añade DESPUÉS de las clases propias del componente. */

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

@@ -14,7 +14,11 @@ export interface ContextMenuProps {
     /** Talla del botón de tres puntos (talla del sistema). */
     triggerSize?: 'sm' | 'md' | 'lg';
     triggerOrientation?: 'horizontal' | 'vertical';
-    /** Nombre accesible del botón. */
+    /**
+     * Nombre accesible del botón. **Reenvío puro** al `DotsButton`, que lee
+     * `dotsButton.label` del `BrandMessagesProvider`: no hace falta pasarlo para
+     * traducir.
+     */
     label?: string;
 }
 /**

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

@@ -13,20 +13,19 @@ export interface CopyButtonProps extends Omit<ComponentPropsWithoutRef<'button'>
      */
     children?: ReactNode;
     /**
-     * Nombre accesible del botón. Default castellano.
-     * @default 'Copiar'
+     * Nombre accesible del botón. **Sin default**: sin él, sale de `copy.label`
+     * del `BrandMessagesProvider`. Solo se lee cuando el botón es de solo icono
+     * —con rótulo visible, lo nombra el rótulo.
      */
     label?: string;
     /**
      * Acuse tras copiar: se anuncia en una región viva y, si hay rótulo visible,
-     * lo sustituye mientras dura. Default castellano.
-     * @default 'Copiado'
+     * lo sustituye mientras dura. **Sin default**: sin él, sale de `copy.copied`.
      */
     copiedLabel?: string;
     /**
      * Aviso cuando el portapapeles no está disponible (contexto no seguro,
-     * permiso denegado). Default castellano.
-     * @default 'No se pudo copiar'
+     * permiso denegado). **Sin default**: sin él, sale de `copy.error`.
      */
     errorLabel?: string;
     /** Variante del botón. */

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

@@ -5,7 +5,9 @@ export interface EmptyStateAction {
     href?: string;
 }
 export interface EmptyStateProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** El rótulo del estado: sin punto (ver Foundations → Redacción). */
     title: string;
+    /** La frase que lo explica, opcional: termina en punto (ver Foundations → Redacción). */
     description?: string;
     icon?: React.ReactNode;
     action?: EmptyStateAction;

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

@@ -1,5 +1,14 @@
 import type { ReactNode } from 'react';
 import './LanguageSwitcher.css';
+/**
+ * El único texto del selector, y es **cromo**: cómo se llama el control. Los
+ * nombres de los idiomas **no** están aquí y no es olvido: van cada uno en su
+ * propio idioma («Español», «English») y viajan en `languages`, que son datos.
+ */
+export interface LanguageSwitcherMessages {
+    /** Etiqueta del control (visible en `compact`, nombre del `nav` en `list`). */
+    label: string;
+}
 export interface Language {
     /** Código BCP 47 (`es`, `en`, `pt-BR`). Es el valor; en el control se muestra el nombre. */
     code: string;
@@ -19,7 +28,10 @@ export interface LanguageSwitcherProps {
     value: string;
     /** Cambio de idioma. Qué hacer con él (enrutar, persistir) es del producto. */
     onChange?: (code: string) => void;
-    /** Nombre accesible del control (la etiqueta del campo). */
+    /**
+     * Nombre accesible del control (la etiqueta del campo). **Sin default**: sin
+     * él, sale de `languageSwitcher.label` del `BrandMessagesProvider`.
+     */
     label?: string;
     /** `id` del control en compacto (enlaza la etiqueta). */
     id?: string;

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

@@ -1,5 +1,23 @@
 import type { ReactNode } from 'react';
 import './NotificationList.css';
+/**
+ * El cromo de la bandeja: cómo se llama la lista, cómo se marca una fila sin
+ * leer y qué dice el botón de marcarla. **Espacio propio y no el del
+ * `NotificationPanel`**: son dos piezas distintas —la bandeja a página
+ * completa y el flotante de la cabecera— y el catálogo de la suite también las
+ * tiene aparte (`notifications.inbox.*` frente a `notifications.panel.*`).
+ *
+ * Lo que cuenta cada notificación —título, cuerpo, hora ya formateada— es
+ * contenido y viaja en `items`.
+ */
+export interface NotificationListMessages {
+    /** Nombre accesible de la lista. No se pinta: el título lo pone la página. */
+    label: string;
+    /** Texto, solo para lectores de pantalla, que marca una fila sin leer. */
+    unread: string;
+    /** Rótulo del botón de marcar una fila como leída. */
+    markRead: string;
+}
 /** Una notificación tal y como la enseña la lista: ya resuelta, sin datos crudos. */
 export interface NotificationListItem {
     id: string;
@@ -59,11 +77,23 @@ export interface NotificationListProps {
      * acciones del producto; sin ella no se pinta.
      */
     onMarkRead?: (id: string) => void;
-    /** Nombre accesible de la lista. **No se pinta**: el título lo pone la página. Default «Notificaciones». */
+    /**
+     * Nombre accesible de la lista. **No se pinta**: el título lo pone la
+     * página. **Sin default**: sin él, sale de `notificationList.label` del
+     * `BrandMessagesProvider`.
+     */
     label?: 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 `notificationList.unread`. Solo se lee cuando
+     * hay alguna fila sin leer y esa fila no trae el suyo.
+     */
     unreadLabel?: string;
-    /** Rótulo del botón de marcar una fila. Default «Marcar como leída». */
+    /**
+     * Rótulo del botón de marcar una fila. **Sin default**: sin él, sale de
+     * `notificationList.markRead`. Solo se lee cuando hay `onMarkRead` y alguna
+     * fila sin leer.
+     */
     markReadLabel?: string;
     /** Se añade DESPUÉS de las clases propias de la lista (el consumidor añade, no sustituye). */
     className?: string;

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

@@ -2,16 +2,21 @@ import type { ReactNode } from 'react';
 import { type HeadingProps } from '../../atoms/Heading/Heading';
 import './PageIntro.css';
 export interface PageIntroProps {
+    /**
+     * Encima del título: una `Tag` de estado, una categoría, un `Breadcrumb`
+     * corto. No es un subtítulo ni acepta una frase larga —para eso está
+     * `description`—, es una pieza pequeña que sitúa la página antes de
+     * nombrarla. Con `actions`, queda en la columna del título, nunca en la
+     * de las acciones.
+     */
+    eyebrow?: ReactNode;
     /** El título de la página: un `Heading` de nivel 1 (o el que diga `level`). */
     title: ReactNode;
     /**
      * La frase bajo el título, opcional: va como entradilla (`Paragraph
-     * size="large"`, un peldaño por encima del cuerpo).
-     *
-     * **Es una frase y termina con puntuación final** —un punto, o el signo que
-     * le toque—: no es un rótulo ni un subtítulo. Sin el punto, el párrafo se
-     * lee como un `Heading` menor y la jerarquía de la cabecera se deshace. Lo
-     * que no llegue a frase o cabe en el título, o va en `children`.
+     * size="large"`, un peldaño por encima del cuerpo). Termina en punto (ver
+     * Foundations → Redacción). Lo que no llegue a frase, o cabe en el título,
+     * o va en `children`.
      */
     description?: ReactNode;
     /** Más texto bajo la frase (otro `Paragraph`, una lista…): mismo aire. */
@@ -45,4 +50,4 @@ export interface PageIntroProps {
  * Con `actions` sirve además de cabecera de una sección dentro de la página
  * (`level={2}`): el título a la izquierda y la acción principal a la derecha.
  */
-export declare function PageIntro({ title, description, actions, level, size, as: Tag, className, children, }: PageIntroProps): import("react/jsx-runtime").JSX.Element;
+export declare function PageIntro({ eyebrow, title, description, actions, level, size, as: Tag, className, children, }: PageIntroProps): import("react/jsx-runtime").JSX.Element;

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

@@ -3,6 +3,15 @@ import { type HeadingLevel, type HeadingSize } from '../../atoms/Heading/Heading
 import { type TagVariant } from '../../atoms/Tag/Tag';
 import type { CardMedia } from '../Card/Card';
 import './ProjectCard.css';
+/**
+ * El único texto de la tarjeta, y es **cromo**: cómo se llama la lista de
+ * etiquetas. Las etiquetas en sí son datos y viajan en `tags`; el título y la
+ * descripción son contenido.
+ */
+export interface ProjectCardMessages {
+    /** Nombre accesible de la lista de etiquetas de categoría. */
+    tags: string;
+}
 export type { TagVariant };
 export interface ProjectCardTag {
     /** Clave de React. Sin ella se usa la etiqueta. */
@@ -30,7 +39,11 @@ export interface ProjectCardProps {
     headingLevel?: HeadingLevel;
     /** Talla del título. Por defecto `5` (24px). */
     headingSize?: HeadingSize;
-    /** Nombre accesible de la lista de etiquetas. Por defecto «Categorías». */
+    /**
+     * Nombre accesible de la lista de etiquetas. **Sin default**: sin él, sale
+     * de `projectCard.tags` del `BrandMessagesProvider`. Solo se lee cuando hay
+     * etiquetas.
+     */
     tagsLabel?: string;
     className?: string;
     id?: string;

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

@@ -28,12 +28,30 @@ export interface StepperStep {
 }
 /** Estado de un paso dentro del flujo. Lo deduce el componente de `current`. */
 export type StepperStatus = 'completed' | 'current' | 'pending';
+/**
+ * El cromo del progreso: el nombre de la lista, la cuenta de la forma
+ * compacta y las tres marcas de estado que solo oye un lector de pantalla.
+ * Dicen en qué punto del flujo se está, no de qué flujo se trata: las
+ * etiquetas de cada paso son contenido y viajan en `steps`.
+ */
+export interface StepperMessages {
+    /** Nombre accesible de la lista de pasos. */
+    label: string;
+    /** La cuenta de la forma compacta: «Paso 2 de 4». Interpola, así que es función. */
+    compact: (current: number, total: number) => string;
+    /** Se antepone, solo para lectores de pantalla, a la etiqueta de un paso ya hecho. */
+    completed: string;
+    /** Ídem para el paso actual. */
+    current: string;
+    /** Ídem para un paso que aún no toca. */
+    pending: string;
+}
 export interface StepperLabels {
-    /** Se antepone, solo para lectores de pantalla, a la etiqueta de un paso ya hecho. Default: «Completado». */
+    /** Anulación puntual de `stepper.completed`. */
     completed?: string;
-    /** Ídem para el paso actual. Default: «Paso actual». */
+    /** Anulación puntual de `stepper.current`. */
     current?: string;
-    /** Ídem para un paso que aún no toca. Default: «Pendiente». */
+    /** Anulación puntual de `stepper.pending`. */
     pending?: string;
 }
 export interface StepperProps {
@@ -47,15 +65,22 @@ export interface StepperProps {
      * `reachable`; por defecto, los completados.
      */
     onStepSelect?: (index: number, step: StepperStep) => void;
-    /** Nombre accesible de la lista. Default: «Progreso» (castellano). */
+    /**
+     * Nombre accesible de la lista. **Sin default**: sin él, sale de
+     * `stepper.label` del `BrandMessagesProvider`.
+     */
     label?: string;
     /**
      * El texto de la forma compacta (por debajo de `md`), donde no caben las
-     * etiquetas. Recibe el número de paso (base 1) y el total.
-     * Default: «Paso 2 de 4» (castellano).
+     * etiquetas. Recibe el número de paso (base 1) y el total. **Sin default**:
+     * sin él, sale de `stepper.compact`.
      */
     compactLabel?: (current: number, total: number) => string;
-    /** Textos de estado para lectores de pantalla. Todos con default castellano. */
+    /**
+     * Textos de estado para lectores de pantalla, clave a clave. **Sin
+     * defaults**: los que no se pasen salen de `stepper.completed`,
+     * `stepper.current` y `stepper.pending`.
+     */
     labels?: StepperLabels;
     className?: string;
     id?: string;

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

@@ -1,5 +1,13 @@
 import { type ReactNode } from 'react';
 import './TreeView.css';
+/**
+ * El único texto del árbol, y es **cromo**: el nombre genérico de la región.
+ * Qué árbol es —«Contenidos del curso»— lo dice la prop `label`, que gana.
+ */
+export interface TreeViewMessages {
+    /** Nombre accesible del árbol cuando la pantalla no le da uno propio. */
+    label: string;
+}
 export interface TreeViewNode {
     /** Identificador único en todo el árbol. */
     id: string;
@@ -55,8 +63,9 @@ export interface TreeViewProps extends Omit<React.ComponentPropsWithoutRef<'ul'>
     /** Se llama con el id del nodo elegido. */
     onSelectedChange?: (id: string) => void;
     /**
-     * Nombre accesible del árbol. Default: «Árbol» (castellano). Una app
-     * multiidioma debe pasarlo traducido.
+     * Nombre accesible del árbol. **Sin default**: sin él, sale de
+     * `treeView.label` del `BrandMessagesProvider`, que es el nombre genérico;
+     * esta prop es la que dice de qué árbol se trata.
      */
     label?: string;
     /**

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

@@ -1,6 +1,17 @@
 import { type ComponentPropsWithoutRef, type ReactNode } from 'react';
 import { type UptimeBarsThresholds } from './uptimeStatus';
 import './UptimeBars.css';
+/**
+ * Los dos textos de la tira, y los dos son **cromo**: cómo se llama la región
+ * y cómo se dice que un punto no tiene dato. Ni las fechas ni los porcentajes
+ * pasan por aquí — son formato (`locale`) y los escribe quien pasa los puntos.
+ */
+export interface UptimeBarsMessages {
+    /** Nombre accesible de la tira cuando la pantalla no le da uno propio. */
+    label: string;
+    /** Cómo se dice que un punto no tiene dato (el monitor todavía no existía). */
+    noData: string;
+}
 export type { UptimeBarsThresholds, UptimeBarsStatus } from './uptimeStatus';
 /** Un punto de la serie: un día, una hora, un despliegue. La tira no lo sabe. */
 export interface UptimeBarsPoint {
@@ -23,7 +34,10 @@ export interface UptimeBarsProps extends Omit<ComponentPropsWithoutRef<'div'>, '
      * tira: el dato que se lee sin mirar treinta rectángulos ni abrir un bocadillo.
      */
     summary: ReactNode;
-    /** Nombre accesible de la tira. Default castellano: «Disponibilidad». */
+    /**
+     * Nombre accesible de la tira. **Sin default**: sin él, sale de
+     * `uptimeBars.label` del `BrandMessagesProvider`.
+     */
     label?: string;
     /** Rótulo del extremo antiguo, bajo la primera barrita: «Hace 30 días». */
     startLabel?: ReactNode;
@@ -41,7 +55,11 @@ export interface UptimeBarsProps extends Omit<ComponentPropsWithoutRef<'div'>, '
      * «5 de septiembre: 100 %. Sin incidencias».
      */
     pointLabel?: (point: UptimeBarsPoint, formattedValue: string | null) => string;
-    /** Cómo se dice que un punto no tiene dato. Default castellano: «sin datos». */
+    /**
+     * Cómo se dice que un punto no tiene dato. **Sin default**: sin él, sale de
+     * `uptimeBars.noData`. Solo se lee cuando hay un punto sin dato y no hay
+     * `pointLabel` propio.
+     */
     noDataLabel?: string;
     /**
      * Bocadillo por barrita, con ratón y con teclado. Default `true`. Sin él las

package/dist/_types/organisms/Chart/Chart.d.ts

@@ -1,5 +1,29 @@
 import { type ReactNode } from 'react';
 import './Chart.css';
+/**
+ * El cromo del gráfico: el nombre de la tabla equivalente, sus encabezados, la
+ * pista que se lee al enfocar el lienzo y el aviso de serie vacía. Dicen lo
+ * mismo en cualquier gráfico de la suite.
+ *
+ * **Lo que NO está aquí, y no es olvido:** `ariaLabel` —qué cuenta ESTE
+ * gráfico— sigue siendo obligatorio y sin default; el `title`, el `caption` y
+ * los nombres de las series son contenido; y las cifras son formato, que sale
+ * de `locale` con `Intl`.
+ */
+export interface ChartMessages {
+    /** Título de la tabla equivalente oculta. */
+    tableCaption: string;
+    /** Frase que describe el gráfico para quien lo enfoca. */
+    tableHint: string;
+    /** Encabezado de la primera columna de la tabla. */
+    category: string;
+    /** Encabezado de la columna de valores en `pie`/`donut`. */
+    value: string;
+    /** Encabezado de la columna de porcentaje en `pie`/`donut`. */
+    share: string;
+    /** Texto cuando no hay datos que mostrar. */
+    empty: string;
+}
 export type ChartType = 'line' | 'area' | 'bar' | 'scatter' | 'pie' | 'donut' | 'funnel' | 'treemap' | 'radial-bar' | 'radar';
 export interface ChartSeries {
     /** Clave del valor dentro de cada fila de `data`. */
@@ -83,21 +107,35 @@ export interface ChartProps extends Omit<React.ComponentPropsWithoutRef<'figure'
     valueLabels?: ChartValueLabels;
     /** Locale con el que se formatean los números. Default `'es-ES'`. */
     locale?: string;
-    /** Título de la tabla equivalente oculta. Default: «Datos del gráfico» (castellano). */
+    /**
+     * Título de la tabla equivalente oculta. **Sin default**: sin él, sale de
+     * `chart.tableCaption` del `BrandMessagesProvider`.
+     */
     tableCaption?: string;
     /**
-     * Frase que describe el gráfico para quien lo enfoca. Default: «Los datos
-     * completos están en la tabla que sigue; flechas para recorrer el gráfico.»
-     * (castellano).
+     * Frase que describe el gráfico para quien lo enfoca. **Sin default**: sin
+     * él, sale de `chart.tableHint`.
      */
     tableHint?: string;
-    /** Encabezado de la primera columna de la tabla. Default: «Categoría» (castellano). */
+    /**
+     * Encabezado de la primera columna de la tabla. **Sin default**: sin él,
+     * sale de `chart.category`.
+     */
     categoryLabel?: string;
-    /** Encabezado de la columna de valores en `pie`/`donut`. Default: «Valor» (castellano). */
+    /**
+     * Encabezado de la columna de valores en `pie`/`donut`. **Sin default**: sin
+     * él, sale de `chart.value`. Solo se lee en esos dos tipos.
+     */
     valueLabel?: string;
-    /** Encabezado de la columna de porcentaje en `pie`/`donut`. Default: «Porcentaje» (castellano). */
+    /**
+     * Encabezado de la columna de porcentaje en `pie`/`donut`. **Sin default**:
+     * sin él, sale de `chart.share`. Solo se lee en esos dos tipos.
+     */
     shareLabel?: string;
-    /** Texto cuando no hay datos. Default: «Sin datos que mostrar» (castellano). */
+    /**
+     * Texto cuando no hay datos. **Sin default**: sin él, sale de `chart.empty`.
+     * Solo se lee cuando no hay nada que pintar.
+     */
     emptyMessage?: string;
     /** Se añade DESPUÉS de las clases propias del componente. */
     className?: string;

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

@@ -4,7 +4,10 @@ import './Hero.css';
 export interface HeroProps {
     /** El título de la portada: un `Heading` de nivel 1 a talla 10 (display). */
     title: ReactNode;
-    /** La frase bajo el título, opcional: `Paragraph size="large"`. */
+    /**
+     * La frase bajo el título, opcional: `Paragraph size="large"`. Termina en
+     * punto (ver Foundations → Redacción).
+     */
     description?: ReactNode;
     /** Uno o varios botones (`Button`), en fila con envoltura (`Inline`), bajo el texto. Van a talla `lg`: la escala del Hero lo pide, y el consumidor no tiene que acordarse de pasarla. */
     actions?: ReactNode;

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

@@ -1,6 +1,15 @@
 import type { ReactNode } from 'react';
 import { type ContainerWidth } from '../../atoms/Container/Container';
 import './LegalFooter.css';
+/**
+ * El único texto del pie, y es **cromo**: cómo se llama esa navegación. Los
+ * rótulos de los enlaces —aviso legal, privacidad, cookies— son datos y viajan
+ * en `links`; el `title` es el contenido de ESE pie.
+ */
+export interface LegalFooterMessages {
+    /** Nombre accesible del `nav` de enlaces legales. */
+    label: string;
+}
 export interface LegalFooterLink {
     id: string;
     label: string;
@@ -12,7 +21,10 @@ export type LegalFooterRenderLinkProps = {
     children: ReactNode;
 };
 export interface LegalFooterProps {
-    /** Nombre accesible del `nav`. */
+    /**
+     * Nombre accesible del `nav`. **Sin default**: sin él, sale de
+     * `legalFooter.label` del `BrandMessagesProvider`.
+     */
     label?: string;
     /** Título opcional sobre los enlaces. */
     title?: string;

package/dist/_types/templates/PublicPageShell/PublicPageShell.d.ts

@@ -26,6 +26,18 @@ export interface PublicPageShellProps {
      * lee cuando hay banda.
      */
     preferencesLabel?: string;
+    /**
+     * Medida del contenido de la banda de preferencias, tal cual la de
+     * `Container`. Por defecto `'xl'`, la misma que el `main` de una página
+     * pública corriente. Se baja a `'lg'` cuando la página entera lee a esa
+     * medida: la banda tiene que alinear con el contenido, no al revés. Lleva el
+     * prefijo de la ranura —como `mainWidth`— porque el marco tiene cuatro y un
+     * `width` pelado no diría cuál gobierna.
+     *
+     * No se resuelve anidando un `Container` dentro de `preferences`: eso dobla
+     * el relleno lateral y desalinea la banda con el `main`.
+     */
+    preferencesWidth?: ContainerWidth;
     /**
      * Medida del contenido del `main`, tal cual la de `Container`. Por defecto
      * `'xl'` (1280px), el ancho de las páginas públicas; `'full'` para que el
@@ -82,7 +94,9 @@ export interface PublicPageShellProps {
  *
  * **El `main` lleva los mismos mandos que un `Container`** (`mainWidth`,
  * `mainSpace`, `mainFlush`), con los defaults de siempre. Es lo que permite que
- * una portada abra con un `Hero` de lado a lado sin salirse del marco.
+ * una portada abra con un `Hero` de lado a lado sin salirse del marco. La
+ * banda de preferencias tiene el suyo, `preferencesWidth`, para que pueda
+ * alinear con un contenido más estrecho sin anidar otro `Container` dentro.
  */
 /**
  * El único texto del marco, y es **cromo**: el nombre de la banda donde viven