@studiolxd/brand 47.1.0 → 48.0.0

package/CHANGELOG.md

@@ -7,6 +7,134 @@ 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.
 
+## [48.0.0] — 2026-09-16
+
+> **Major.** Novena familia al proveedor de textos: copiar, datos y estado. Diecisiete
+> espacios nuevos, y con ellos el primero que **no es de un componente sino de una
+> conducta**: `copy`, las tres palabras que dicen por igual el botón suelto, el valor en
+> línea y el bloque de código. Además, la banda de preferencias de `PublicPageShell` se
+> puede pedir a otra medida, y `Foundations/Redacción` fija por escrito que los estados de
+> carga conservan sus puntos suspensivos.
+
+### Copiar, datos y estado leen del proveedor
+
+Diecisiete espacios nuevos en `BrandMessages`: `copy`, `codeBlock`, `dotsButton`,
+`progressBar`, `spinner`, `slider`, `treeView`, `uptimeBars`, `chart`, `stepper`,
+`carousel`, `languageSwitcher`, `projectCard`, `legalFooter`, `calendarRoster`,
+`calendarPlanner` y `notificationList`. Mismo orden —**prop → proveedor → error**— y cada
+texto se lee **donde se pinta**: un botón que nunca falla no exige el aviso de
+portapapeles roto, un spinner decorativo no exige su texto, un progreso que empieza en el
+primer paso no exige la marca de «completado», un deslizador de un pulgar no exige los dos
+nombres del rango y un cuadrante sin leyenda no exige ninguno de sus seis tipos.
+
+### `copy` es un espacio de conducta, y es la primera excepción a «un espacio por componente»
+
+`CopyButton`, `CopyableValue`, `DescriptionDetails copyable` y el acuse de `CodeBlock`
+dicen **las mismas tres palabras**: «Copiar», «Copiado», «No se pudo copiar». Un espacio
+por componente habría obligado a la aplicación a escribirlas tres veces, con el riesgo de
+que un día dijeran cosas distintas; el catálogo de la suite ya las tiene una sola vez
+(`common.copy`, `common.copied`). Así que la interfaz `CopyMessages` vive donde ya vivía
+la conducta compartida —`src/stories/constants/copy-to-clipboard.ts`— y no junto a un
+componente: lo que comparten es el comportamiento, y el texto va con él.
+
+`CodeBlock` es el caso que lo enseña: lee de **dos** espacios, porque su rótulo dice
+«Copiar código» (suyo, `codeBlock.copy`) y su acuse dice «Copiado» (de todos,
+`copy.copied`). Y `codeBlock.region` —el nombre del área desplazable— interpola el
+lenguaje, así que es función.
+
+### Un nombre genérico es cromo; el de ESTA pantalla sigue siendo prop
+
+`ProgressBar` y `TreeView` son la pareja que mejor lo enseña. El catálogo pone «Progreso»
+y «Árbol», que valen en cualquier pantalla; lo que avanza de verdad —«Subiendo el
+vídeo»— y de qué árbol se trata —«Matriz de contenidos»— lo sabe solo la pantalla, y para
+eso siguen estando las props, que ganan. Lo mismo en `Chart`: el cromo de la tabla
+equivalente es catálogo, pero **`ariaLabel` sigue obligatorio y fuera** —un texto común lo
+dejaría diciendo «Gráfico» en todas partes sin que nada fallara—.
+
+### Cuatro piezas entran al alcance por arrastre
+
+`Spinner` no estaba en la lista y entra: es el estado por excelencia, y su «Cargando…» es
+exactamente el texto que la norma de redacción de esta misma release declara excepción.
+`Slider` tenía tres palabras cableadas dentro del default de `thumbLabel` («Valor»,
+«Mínimo», «Máximo») que ninguna prop de texto dejaba ver. `CalendarPlanner` comparte
+familia con `CalendarRoster` y se habría quedado con su «+N más» en castellano.
+`DescriptionDetails` y `ContextMenu` pasan a ser **reenvíos puros**: sus props siguen
+existiendo como anulación puntual, pero ya no hacen falta para traducir.
+
+`MessageComposer`, `ConversationList`, `ConversationThread`, `AssistantMessage`,
+`AnnotationThread`, `ChatShell`, `TypingIndicator` y las pantallas de `ConnectorAuth`
+**no entran**: son texto de producto y legal, y tienen ola propia.
+
+### La leyenda del cuadrante va clave a clave, contra la regla general
+
+La norma del sistema es que una **lista** se traduce pasándola entera, no con una prop de
+texto por elemento. Los seis tipos de la leyenda de `CalendarRoster` son la excepción: es
+un vocabulario **cerrado** del componente —festivo, vacaciones, ausencia, recuperación,
+cumpleaños, no laborable—, y obligar a la aplicación a montar el array con sus `type`
+correctos solo para traducir seis palabras era peor que darles seis claves.
+`legendItems` sigue existiendo para sustituir la leyenda **entera** —otro orden, otros
+tipos— y gana. `birthdayPrefix` se queda fuera: es un emoji, y un emoji no se traduce.
+
+### Redacción: los estados de carga conservan los puntos suspensivos
+
+Sección propia en `Foundations/Redacción`, con sus ejemplos ✓/✗. «Buscando…»,
+«Cargando…», «Guardando…» no son una frase que se corta: son **progreso**, y los tres
+puntos dicen que algo está pasando ahora mismo y que va a terminar. Quitárselos convierte
+el estado en un rótulo. Vale igual para el texto visible y para el que solo oye un lector
+de pantalla. Lo que **no** es un estado en curso sigue sin llevarlos, aunque hable de algo
+que tarda.
+
+### La banda de preferencias de `PublicPageShell` se puede pedir a otra medida
+
+Prop nueva, `preferencesWidth?: ContainerWidth`, con el prefijo de la ranura —como
+`mainWidth`— porque el marco tiene cuatro y un `width` pelado no diría cuál gobierna. El
+default es `'xl'`, lo de hoy, **así que esta parte no es breaking**. Una página que lee a
+`lg` pide `preferencesWidth="lg"` y la banda estrecha con ella.
+
+Lo que resolvía el hueco hasta hoy —anidar un `Container width="lg"` dentro de
+`preferences`— metía un `container__inner` dentro de otro: el relleno lateral se contaba
+dos veces y la banda dejaba de alinear con el `main`. Sin CSS nuevo.
+
+### Para quien actualice
+
+El catálogo del `BrandMessagesProvider` tiene que crecer con los diecisiete espacios, o la
+primera pantalla con un `CopyButton`, un `Spinner` o una `ProgressBar` **lanza en render**.
+Estas son las claves que hay que aportar:
+
+| Espacio | Claves | Qué es |
+| --- | --- | --- |
+| `copy` | `label`, `copied`, `error` | copiar al portapapeles, para toda la familia |
+| `codeBlock` | `copy`, `region(language?)` | el rótulo propio del bloque y el nombre de su área |
+| `dotsButton` | `label` | el botón de tres puntos — lo reenvía `ContextMenu` |
+| `progressBar` | `label` | el nombre genérico de lo que avanza |
+| `spinner` | `label` | la espera, con sus puntos suspensivos |
+| `slider` | `value`, `min`, `max`, `valueAt(index)` | los nombres de los pulgares |
+| `treeView` | `label` | el nombre genérico del árbol |
+| `uptimeBars` | `label`, `noData` | la tira y cómo se dice que un punto no tiene dato |
+| `chart` | `tableCaption`, `tableHint`, `category`, `value`, `share`, `empty` | el cromo de la tabla equivalente |
+| `stepper` | `label`, `compact(current, total)`, `completed`, `current`, `pending` | el progreso y sus tres marcas de estado |
+| `carousel` | `label`, `roleDescription`, `track`, `previous`, `next`, `indicator(index)`, `pause`, `play`, `slideStatus(index, total)`, `slideRoleDescription` | todo el cromo del carrusel |
+| `languageSwitcher` | `label` | la etiqueta del selector — **no** los idiomas |
+| `projectCard` | `tags` | la lista de etiquetas de categoría |
+| `legalFooter` | `label` | la navegación del pie legal |
+| `calendarRoster` | `name`, `legend`, `holiday`, `vacation`, `absence`, `recovery`, `birthday`, `nonWorking` | la columna de nombres y los seis tipos de la leyenda |
+| `calendarPlanner` | `more(count)` | el botón de desbordamiento de una celda |
+| `notificationList` | `label`, `unread`, `markRead` | la bandeja — **no** el panel de la cabecera |
+
+Seis de ellas interpolan un dato (`codeBlock.region`, `slider.valueAt`, `stepper.compact`,
+`carousel.indicator`, `carousel.slideStatus`, `calendarPlanner.more`), así que son
+funciones.
+
+A cambio, dejan de hacer falta para traducir `DescriptionDetails.copyLabel` y
+`copiedLabel`, y `ContextMenu.label`: son reenvíos puros y siguen existiendo solo como
+anulación puntual. `RecoveryCodes` mantiene sus tres `labels` obligatorias —«Copiar todos»
+no es «Copiar»—, pero su botón lee `copy.error` si el portapapeles falla.
+
+**Ojo con dos valores.** `spinner.label` lleva **puntos suspensivos** dentro («Cargando…»):
+son parte del texto, no adorno. Y `notificationList.*` no es `notificationPanel.*`: en el
+catálogo de la suite son `notifications.inbox.*` y `notifications.panel.*`, y mezclarlos
+deja la bandeja diciendo lo del flotante.
+
 ## [47.1.0] — 2026-09-15
 
 > **Minor.** La norma de puntuación de subtítulos y estados vacíos, fijada por escrito en

package/dist/_shared/progressbar.js

@@ -1,8 +1,9 @@
 import '../progressbar.css';
-import { jsx as e, jsxs as t } from "react/jsx-runtime";
+import { n as e } from "./brandmessagescontext.js";
+import { jsx as t, jsxs as n } from "react/jsx-runtime";
 //#endregion
 //#region src/stories/atoms/ProgressBar/ProgressBar.tsx
-var n = Number({ "progress-bar": {
+var r = Number({ "progress-bar": {
 	"height-sm": {
 		$value: "{spacing.2}",
 		$type: "dimension",
@@ -179,38 +180,38 @@ var n = Number({ "progress-bar": {
 		$description: "Cifra sobre el relleno primary — surface-dark. El relleno se invierte a blanco, así que la cifra pasa a la tinta clara: si no, quedaría blanco sobre blanco"
 	}
 } }["progress-bar"]["inside-label-threshold"].$value);
-function r({ value: r, variant: i = "primary", size: a = "md", label: o = "Progreso", className: s }) {
-	let c = Math.min(100, Math.max(0, Math.round(r))), l = a !== "sm", u = l && c >= n, d = l && !u;
-	return /* @__PURE__ */ e("div", {
+function i({ value: i, variant: a = "primary", size: o = "md", label: s, className: c }) {
+	let l = e("progressBar"), u = Math.min(100, Math.max(0, Math.round(i))), d = o !== "sm", f = d && u >= r, p = d && !f;
+	return /* @__PURE__ */ t("div", {
 		className: [
 			"progress-bar",
-			`progress-bar--${i}`,
 			`progress-bar--${a}`,
-			s
+			`progress-bar--${o}`,
+			c
 		].filter(Boolean).join(" "),
-		children: /* @__PURE__ */ t("div", {
+		children: /* @__PURE__ */ n("div", {
 			className: "progress-bar__track",
 			role: "progressbar",
-			"aria-valuenow": c,
+			"aria-valuenow": u,
 			"aria-valuemin": 0,
 			"aria-valuemax": 100,
-			"aria-valuetext": `${c}%`,
-			"aria-label": o,
-			"data-value": c,
-			children: [/* @__PURE__ */ e("div", {
+			"aria-valuetext": `${u}%`,
+			"aria-label": l("label", s),
+			"data-value": u,
+			children: [/* @__PURE__ */ t("div", {
 				className: "progress-bar__fill",
-				children: u && /* @__PURE__ */ t("span", {
+				children: f && /* @__PURE__ */ n("span", {
 					className: "progress-bar__label progress-bar__label--inside",
 					"aria-hidden": "true",
-					children: [c, "%"]
+					children: [u, "%"]
 				})
-			}), d && /* @__PURE__ */ t("span", {
+			}), p && /* @__PURE__ */ n("span", {
 				className: "progress-bar__label progress-bar__label--outside",
 				"aria-hidden": "true",
-				children: [c, "%"]
+				children: [u, "%"]
 			})]
 		})
 	});
 }
 //#endregion
-export { r as t };
+export { i as t };

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

@@ -10,13 +10,13 @@ export interface CopyableValueProps {
      */
     copyText?: string;
     /**
-     * Nombre accesible del botón de copiar. Default castellano.
-     * @default 'Copiar'
+     * Nombre accesible del botón de copiar. **Sin default**: sin él, sale de
+     * `copy.label` del `BrandMessagesProvider`.
      */
     copyLabel?: string;
     /**
-     * Acuse tras copiar, anunciado en una región viva. Default castellano.
-     * @default 'Copiado'
+     * Acuse tras copiar, anunciado en una región viva. **Sin default**: sin él,
+     * sale de `copy.copied`. Solo se lee tras copiar.
      */
     copiedLabel?: string;
     /** Se añade DESPUÉS de las clases propias. */

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

@@ -31,13 +31,14 @@ export interface DescriptionDetailsProps extends React.ComponentPropsWithoutRef<
      */
     copyText?: string;
     /**
-     * Nombre accesible del botón de copiar. Default castellano.
-     * @default 'Copiar'
+     * Nombre accesible del botón de copiar. **Reenvío puro** al `CopyableValue`
+     * de dentro, que lee `copy.label` del `BrandMessagesProvider`: no hace falta
+     * pasarla para traducir.
      */
     copyLabel?: string;
     /**
-     * Acuse tras copiar, anunciado en una región viva. Default castellano.
-     * @default 'Copiado'
+     * Acuse tras copiar. **Reenvío puro** al `CopyableValue`, que lee
+     * `copy.copied`.
      */
     copiedLabel?: string;
 }

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

@@ -1,10 +1,25 @@
 import { type ButtonBaseProps } from '../Button/Button';
 import './DotsButton.css';
+/**
+ * El único texto del botón de tres puntos, y es **cromo**: dice que hay más
+ * acciones, no de qué son. Es el mismo en una fila de tabla, en una tarjeta y
+ * dentro de un `ContextMenu`, así que va al catálogo una sola vez y el
+ * `ContextMenu` lo reenvía sin repetir la clave.
+ */
+export interface DotsButtonMessages {
+    /** Nombre accesible del botón. */
+    label: string;
+}
 export interface DotsButtonProps extends Omit<ButtonBaseProps, 'variant' | 'iconOnly' | 'children' | 'href'> {
     /** Talla del sistema (32/40/48). */
     size?: 'sm' | 'md' | 'lg';
     /** Puntos en fila (por defecto) o en columna. */
     orientation?: 'horizontal' | 'vertical';
+    /**
+     * Nombre accesible del botón. **Sin default**: sin él, sale de
+     * `dotsButton.label` del `BrandMessagesProvider`.
+     */
+    'aria-label'?: string;
 }
 /**
  * El botón de «más opciones»: un `Button` ghost de solo icono con el icono

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

@@ -1,4 +1,13 @@
 import './ProgressBar.css';
+/**
+ * El único texto de la barra, y es **cromo**: el nombre genérico de lo que
+ * avanza. Lo que avanza **de verdad** en una pantalla concreta —«Subiendo el
+ * vídeo»— se dice con la prop `label`, que gana.
+ */
+export interface ProgressBarMessages {
+    /** Nombre accesible de la barra cuando la pantalla no dice qué avanza. */
+    label: string;
+}
 export type ProgressBarVariant = 'primary' | 'accent-1' | 'accent-2' | 'support-1' | 'support-2';
 export type ProgressBarSize = 'sm' | 'md' | 'lg';
 export interface ProgressBarProps {
@@ -9,8 +18,9 @@ export interface ProgressBarProps {
     /** Talla de la barra. En `sm` no se muestra la cifra. */
     size?: ProgressBarSize;
     /**
-     * Nombre accesible de la barra: qué está avanzando. Default: «Progreso»
-     * (castellano). Una app multiidioma debe pasarlo traducido.
+     * Nombre accesible de la barra: qué está avanzando. **Sin default**: sin él,
+     * sale de `progressBar.label` del `BrandMessagesProvider`, que es el nombre
+     * genérico; esta prop es la que dice qué avanza en ESTA pantalla.
      */
     label?: string;
     /** Clases adicionales para el contenedor. */

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

@@ -1,5 +1,20 @@
 import { Slider as BaseSlider } from '@base-ui/react/slider';
 import './Slider.css';
+/**
+ * Los nombres genéricos de los pulgares, y son **cromo**: dicen qué pulgar es,
+ * no qué mide el deslizador. Lo que mide se dice con `label`, que es de la
+ * pantalla, y la cifra es formato.
+ */
+export interface SliderMessages {
+    /** Nombre del pulgar único cuando el deslizador no trae `label`. */
+    value: string;
+    /** Nombre del primer pulgar de un rango de dos. */
+    min: string;
+    /** Nombre del segundo pulgar de un rango de dos. */
+    max: string;
+    /** Nombre del pulgar n (base 1) con tres o más. Interpola, así que es función. */
+    valueAt: (index: number) => string;
+}
 type BaseSliderRootProps = Omit<React.ComponentPropsWithoutRef<typeof BaseSlider.Root>, 'className' | 'value' | 'defaultValue' | 'onValueChange' | 'onValueCommitted'>;
 export interface SliderProps extends BaseSliderRootProps {
     /** Valor actual (controlado). Un número, o una lista para un rango. */
@@ -16,8 +31,10 @@ export interface SliderProps extends BaseSliderRootProps {
      */
     label?: string;
     /**
-     * Nombre accesible de cada pulgar. Por defecto, en castellano: con dos
-     * pulgares «Mínimo» y «Máximo»; con más, «Valor 1», «Valor 2»…
+     * Nombre accesible de cada pulgar. **Sin default**: sin él, con un pulgar es
+     * `label` —y en su defecto `slider.value`—, con dos son `slider.min` y
+     * `slider.max`, y con más, `slider.valueAt`. Cada clave se lee **donde se
+     * pinta**: un deslizador de un solo pulgar no exige las del rango.
      */
     thumbLabel?: (index: number, total: number) => string;
     /** Muestra el valor formateado junto a la banda. */

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

@@ -1,8 +1,22 @@
 import './Spinner.css';
+/**
+ * El único texto de la espera, y es **cromo**: lo que se dice mientras no se
+ * sabe cuánto falta. Conserva los puntos suspensivos —es progreso, no una
+ * frase: ver Foundations → Redacción § «Los estados de carga llevan puntos
+ * suspensivos».
+ */
+export interface SpinnerMessages {
+    /** Texto anunciado por lectores de pantalla mientras se espera. */
+    label: string;
+}
 export type SpinnerSize = 'sm' | 'md' | 'lg';
 export interface SpinnerProps {
     size?: SpinnerSize;
-    /** Texto anunciado por lectores de pantalla. Default castellano: «Cargando…». Ignorado cuando aria-hidden es true. */
+    /**
+     * Texto anunciado por lectores de pantalla. **Sin default**: sin él, sale de
+     * `spinner.label` del `BrandMessagesProvider`. **No se lee** cuando
+     * `aria-hidden` es `true`: un spinner decorativo no exige la clave.
+     */
     label?: string;
     /** Cuando true, el spinner es puramente decorativo (sin rol ni anuncio). */
     'aria-hidden'?: boolean;

package/dist/_types/constants/copy-to-clipboard.d.ts

@@ -32,3 +32,25 @@ export declare function useCopyToClipboard(feedbackDuration?: number): {
         error: unknown;
     }>;
 };
+/**
+ * Los tres textos de copiar al portapapeles, en **un solo espacio** para toda
+ * la familia: el botón suelto (`CopyButton`), el valor en línea
+ * (`CopyableValue`, y con él `DescriptionDetails copyable`) y el bloque de
+ * código (`CodeBlock`, que solo lee el acuse: su rótulo dice «Copiar código» y
+ * vive en `codeBlock.copy`).
+ *
+ * No es un espacio por componente como el resto, y es deliberado: son
+ * literalmente las mismas tres palabras en los tres sitios, el catálogo de la
+ * suite ya las tiene una sola vez (`common.copy`, `common.copied`) y repetir
+ * la clave por componente obligaría a la aplicación a escribir «Copiar» tres
+ * veces con el riesgo de que un día dijeran cosas distintas. Lo que comparten
+ * es la conducta —por eso este fichero existe—, y el texto va con ella.
+ */
+export interface CopyMessages {
+    /** Nombre accesible del botón de copiar. */
+    label: string;
+    /** Acuse tras copiar, anunciado en una región viva. */
+    copied: string;
+    /** Aviso cuando el portapapeles no está disponible (contexto no seguro, permiso denegado). */
+    error: string;
+}

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

@@ -45,6 +45,23 @@ import type { TableOfContentsMessages } from '../molecules/TableOfContents/Table
 import type { PrevNextNavMessages } from '../molecules/PrevNextNav/PrevNextNav';
 import type { PublicPageShellMessages } from '../templates/PublicPageShell/PublicPageShell';
 import type { OnboardingShellMessages } from '../templates/OnboardingShell/OnboardingShell';
+import type { CopyMessages } from '../constants/copy-to-clipboard';
+import type { CodeBlockMessages } from '../molecules/CodeBlock/CodeBlock';
+import type { DotsButtonMessages } from '../atoms/DotsButton/DotsButton';
+import type { ProgressBarMessages } from '../atoms/ProgressBar/ProgressBar';
+import type { SpinnerMessages } from '../atoms/Spinner/Spinner';
+import type { SliderMessages } from '../atoms/Slider/Slider';
+import type { TreeViewMessages } from '../molecules/TreeView/TreeView';
+import type { UptimeBarsMessages } from '../molecules/UptimeBars/UptimeBars';
+import type { ChartMessages } from '../organisms/Chart/Chart';
+import type { StepperMessages } from '../molecules/Stepper/Stepper';
+import type { CarouselMessages } from '../molecules/Carousel/Carousel';
+import type { LanguageSwitcherMessages } from '../molecules/LanguageSwitcher/LanguageSwitcher';
+import type { ProjectCardMessages } from '../molecules/ProjectCard/ProjectCard';
+import type { LegalFooterMessages } from '../sections/LegalFooter/LegalFooter';
+import type { CalendarRosterMessages } from '../molecules/CalendarRoster/CalendarRoster';
+import type { CalendarPlannerMessages } from '../molecules/CalendarPlanner/CalendarPlanner';
+import type { NotificationListMessages } from '../molecules/NotificationList/NotificationList';
 /**
  * El contrato de textos de la librería: un espacio por componente, y dentro
  * de cada espacio **todas las claves obligatorias**.
@@ -114,5 +131,22 @@ export interface BrandMessages {
     prevNextNav: PrevNextNavMessages;
     publicPageShell: PublicPageShellMessages;
     onboardingShell: OnboardingShellMessages;
+    copy: CopyMessages;
+    codeBlock: CodeBlockMessages;
+    dotsButton: DotsButtonMessages;
+    progressBar: ProgressBarMessages;
+    spinner: SpinnerMessages;
+    slider: SliderMessages;
+    treeView: TreeViewMessages;
+    uptimeBars: UptimeBarsMessages;
+    chart: ChartMessages;
+    stepper: StepperMessages;
+    carousel: CarouselMessages;
+    languageSwitcher: LanguageSwitcherMessages;
+    projectCard: ProjectCardMessages;
+    legalFooter: LegalFooterMessages;
+    calendarRoster: CalendarRosterMessages;
+    calendarPlanner: CalendarPlannerMessages;
+    notificationList: NotificationListMessages;
 }
-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, MenuButtonMessages, AppRootMessages, AppShellMessages, SidebarMessages, SidebarNavMessages, SiteNavMessages, SiteHeaderMessages, UserMenuMessages, OrgSwitcherMessages, BreadcrumbMessages, TableOfContentsMessages, PrevNextNavMessages, PublicPageShellMessages, OnboardingShellMessages, };
+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, MenuButtonMessages, AppRootMessages, AppShellMessages, SidebarMessages, SidebarNavMessages, SiteNavMessages, SiteHeaderMessages, UserMenuMessages, OrgSwitcherMessages, BreadcrumbMessages, TableOfContentsMessages, PrevNextNavMessages, PublicPageShellMessages, OnboardingShellMessages, CopyMessages, CodeBlockMessages, DotsButtonMessages, ProgressBarMessages, SpinnerMessages, SliderMessages, TreeViewMessages, UptimeBarsMessages, ChartMessages, StepperMessages, CarouselMessages, LanguageSwitcherMessages, ProjectCardMessages, LegalFooterMessages, CalendarRosterMessages, CalendarPlannerMessages, NotificationListMessages, };

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, ConsentMessages, CommandPaletteMessages, AppLauncherMessages, FloatingDockMessages, NotificationButtonMessages, NotificationPanelMessages, MenuButtonMessages, AppRootMessages, AppShellMessages, SidebarMessages, SidebarNavMessages, SiteNavMessages, SiteHeaderMessages, UserMenuMessages, OrgSwitcherMessages, BreadcrumbMessages, TableOfContentsMessages, PrevNextNavMessages, PublicPageShellMessages, OnboardingShellMessages, } 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, MenuButtonMessages, AppRootMessages, AppShellMessages, SidebarMessages, SidebarNavMessages, SiteNavMessages, SiteHeaderMessages, UserMenuMessages, OrgSwitcherMessages, BreadcrumbMessages, TableOfContentsMessages, PrevNextNavMessages, PublicPageShellMessages, OnboardingShellMessages, CopyMessages, CodeBlockMessages, DotsButtonMessages, ProgressBarMessages, SpinnerMessages, SliderMessages, TreeViewMessages, UptimeBarsMessages, ChartMessages, StepperMessages, CarouselMessages, LanguageSwitcherMessages, ProjectCardMessages, LegalFooterMessages, CalendarRosterMessages, CalendarPlannerMessages, NotificationListMessages, } from './BrandMessages';

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

@@ -1,6 +1,16 @@
 import { type ReactNode } from 'react';
 import type { TagVariant } from '../../atoms/Tag/Tag';
 import './CalendarPlanner.css';
+/**
+ * El único texto propio del planificador: el botón que abre los eventos que no
+ * caben en una celda. Las **flechas de mes no están aquí** —son el mismo texto
+ * que el del `Calendar` y salen de `calendar.previousMonth` / `.nextMonth`—, y
+ * `gridLabel` tampoco: nombra a ESE planificador.
+ */
+export interface CalendarPlannerMessages {
+    /** Rótulo del botón de desbordamiento: «+3 más». Interpola, así que es función. */
+    more: (count: number) => string;
+}
 export interface PlannerEvent {
     id: string;
     date: Date;
@@ -60,9 +70,9 @@ export interface CalendarPlannerProps {
      */
     gridLabel?: string;
     /**
-     * Rótulo visible del botón que abre los eventos ocultos de una celda.
-     * Default: `+N más` (castellano). Interpola el número, así que es una
-     * función: una app multiidioma debe pasarla traducida.
+     * Rótulo visible del botón que abre los eventos ocultos de una celda. **Sin
+     * default**: sin él, sale de `calendarPlanner.more` del
+     * `BrandMessagesProvider`. Solo se lee cuando alguna celda desborda.
      */
     moreLabel?: (count: number) => string;
     /** Tamaño del componente. Default: 'md' */

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

@@ -1,5 +1,33 @@
 import type { ComponentType, ReactNode } from 'react';
 import './CalendarRoster.css';
+/**
+ * El cromo del cuadrante: el encabezado de la columna de nombres y la leyenda
+ * con sus seis tipos. Las **flechas de mes no están aquí**: son el mismo texto
+ * que el del `Calendar` y salen de `calendar.previousMonth` / `.nextMonth`.
+ *
+ * Los seis tipos van clave a clave, no como lista: una lista en el catálogo
+ * obligaría a la aplicación a montar el array entero con sus `type` correctos
+ * solo para traducir seis palabras. `legendItems` sigue existiendo para
+ * sustituir la leyenda **entera** —otro orden, otros tipos—, y gana.
+ */
+export interface CalendarRosterMessages {
+    /** Encabezado de la columna de nombres (empleado, recurso, aula…). */
+    name: string;
+    /** Nombre accesible de la leyenda. */
+    legend: string;
+    /** Un día festivo. */
+    holiday: string;
+    /** Vacaciones. */
+    vacation: string;
+    /** Una ausencia. */
+    absence: string;
+    /** Una recuperación de horas. */
+    recovery: string;
+    /** Un cumpleaños. */
+    birthday: string;
+    /** Un día no laborable. */
+    nonWorking: string;
+}
 export type RosterCellType = 'schedule' | 'holiday' | 'vacation' | 'absence' | 'recovery' | 'birthday' | 'non-working';
 export interface RosterCell {
     type: RosterCellType;
@@ -41,7 +69,10 @@ export interface CalendarRosterProps {
      * Cuando se pasa, sustituye al renderizado por defecto de chips/schedule.
      */
     renderCell?: (day: number, date: Date, cell: RosterCell | null) => ReactNode;
-    /** Etiqueta de la columna de nombre. Default: 'Empleado' */
+    /**
+     * Etiqueta de la columna de nombre. **Sin default**: sin ella, sale de
+     * `calendarRoster.name` del `BrandMessagesProvider`.
+     */
     nameLabel?: string;
     /**
      * Lo que precede a la etiqueta de un cumpleaños. Default: `'🎂 '`
@@ -52,13 +83,15 @@ export interface CalendarRosterProps {
     /** Muestra la leyenda al final. Default: true */
     showLegend?: boolean;
     /**
-     * Entradas de la leyenda, en orden. Default: las seis del sistema con sus etiquetas
-     * en castellano. Es texto **visible**: una app multiidioma debe pasarlas traducidas.
+     * Entradas de la leyenda, en orden. **Sin default**: sin ella, la leyenda se
+     * arma con los seis tipos del sistema y sus textos de
+     * `calendarRoster.*`. Se pasa entera para cambiar el orden o quitar tipos,
+     * no para traducir.
      */
     legendItems?: LegendItem[];
     /**
-     * aria-label de la leyenda. Default: "Leyenda" (castellano).
-     * Una app multiidioma debe pasarla traducida.
+     * aria-label de la leyenda. **Sin default**: sin ella, sale de
+     * `calendarRoster.legend`. Solo se lee con `showLegend`.
      */
     legendLabel?: string;
     /**