@studiolxd/brand 45.1.0 → 47.0.0

package/CHANGELOG.md

@@ -7,6 +7,174 @@ 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.
 
+## [47.0.0] — 2026-09-15
+
+> **Major.** Octava familia al proveedor de textos: el cromo de aplicación y la navegación.
+> Catorce espacios nuevos, y con ellos la familia donde más claves ya existían en el
+> catálogo de la suite. Además, los portales dejan de abrirse en la talla equivocada dentro
+> de una página pública, y el `main` de `PublicPageShell` se puede pedir a sangre.
+
+### La navegación lee del proveedor
+
+Catorce espacios nuevos en `BrandMessages`: `menuButton`, `appRoot`, `appShell`, `sidebar`,
+`sidebarNav`, `siteNav`, `siteHeader`, `userMenu`, `orgSwitcher`, `breadcrumb`,
+`tableOfContents`, `prevNextNav`, `publicPageShell` y `onboardingShell`. Mismo orden —**prop
+→ proveedor → error**— y cada texto se lee **donde se pinta**: una barra fuera de un
+`AppShell` no tiene asa y no exige sus dos textos, una navegación sin entradas vacías no
+exige su marca, un menú de cuenta sin contador no exige el plural, un paso sin acciones no
+exige el nombre de su pie.
+
+La frontera se decide por el valor. **Cromo**: el nombre de una región de navegación
+(«Principal», «En esta página», «Migas de pan»), el salto al contenido, qué hace el
+logotipo, la dirección de un par anterior/siguiente. **Contenido**: los ítems de un menú,
+los nombres de las organizaciones, el nombre de la persona, los títulos de destino del
+`PrevNextNav`, el rótulo visible de un índice. `PrevNextNav` es el caso que mejor lo
+enseña: «Anterior» y «Siguiente» son catálogo, pero un par que navega semanas quiere decir
+«Semana anterior» y para eso siguen estando las props, que ganan.
+
+### Tres piezas entran al alcance por arrastre
+
+`MenuButton` es donde vivía el castellano que reenviaban las dos cabeceras: migrarlo deja
+`AppHeader.menuLabel` y `SiteHeader.menuLabel` como **reenvíos puros**, una sola clave en
+vez de tres. `AppRoot` tiene la misma frase de salto que `AppShell` y se habría quedado
+cableada. Y `PublicPageShell` tenía que migrar para que `OnboardingShell.preferencesLabel`
+pudiera ser reenvío puro: es la misma banda y la misma clave.
+
+`Switcher` estaba en la lista y **no entra**: no emite ningún texto propio. Lo nombra la
+etiqueta de su campo.
+
+### Breaking — `MenuButton` abierto dice «cerrar»
+
+El nombre accesible pasa a seguir al estado: cerrado lee `menuButton.open`, abierto lee
+`menuButton.close`. Antes, con el menú abierto el botón seguía llamándose igual salvo que
+el consumidor pasara `closeLabel` a mano, así que la cara de cerrar casi nunca se pintaba.
+Ahora que el catálogo trae las dos, el nombre ya no se queda a medias. **Un test que
+consulte el botón por su nombre con la barra abierta deja de encontrarlo**: es el punto
+donde esto rompe en silencio.
+
+`UserMenu` tenía un texto que ni siquiera era prop —el contador de notificaciones llevaba
+`${count} notificaciones sin leer` escrito en el JSX—. Ahora es `userMenu.unread`, una
+función, y `notifications.unreadCount` de la suite ya la satisface con su plural.
+
+### Los portales heredan la superficie
+
+La v45.1.0 puso los controles en talla `lg` dentro de `.site-shell` por herencia CSS, y
+dejó apuntado lo que no cubría: la lista de un `Select` y el calendario de un `DatePicker`
+los monta un portal en `document.body`, que no es descendiente del bloque. El campo se
+pintaba a 48px/20 y su lista se abría a 40px/16. El tema oscuro no tenía este problema
+porque se activa en `<html>` y cascadea a todo el documento; la superficie de lectura se
+activa a media altura del árbol.
+
+`SiteShell` publica ahora su nodo raíz por `PortalContainerContext`, y todo componente con
+portal lo toma como destino cuando no recibe `container`. La resolución es **prop →
+contexto → `document.body`**, y la prop gana siempre. No hay nada que pasar en cada uso: el
+árbol de React sabe dónde está el shell aunque el árbol del DOM no lo sepa. El nodo viaja
+en **estado y no en una ref**, porque el destino tiene que existir en el render en el que
+el portal se monta — el mismo patrón que `ChatShell` ya usaba para el `container` de su
+cajón. `SiteShell` pasa a ser componente cliente.
+
+Lo consumen por defecto `Select`, `MultiSelect`, `AsyncSelect`, `AsyncMultiSelect`,
+`InputPhone`, `Modal`, `Sheet`, `AppLauncher`, `OrgSwitcher`, `UserMenu` y `Toaster`.
+`Popover`, `Tooltip` y `Menu` **estrenan prop `container`** —son los primitivos
+componibles, y sin ella no había escotilla—, y con ellos heredan sin tocar nada
+`DatePicker`, `DateTimeField`, `TimeSelect`, `TimeField`, `ContextMenu`, `DropdownField`,
+`NotificationButton`, `ConfirmDialog`, `ImageCropDialog`, `AvatarUpload`, `CommandPalette`
+y `Consent`. `FloatingDock` queda intacto: monta su panel dentro de su propia ancla a
+propósito y no pasa por el contexto.
+
+**`AppShell` no provee el contexto, y es deliberado.** La superficie de aplicación es la
+del `:root`, así que `document.body` ya resuelve los mismos valores; meter los portales
+dentro de `.app-shell` —que es `overflow: clip` y de altura fija— solo añadiría riesgo de
+recorte sin arreglar nada. El día que la superficie de aplicación cambie de talla, el
+arreglo es montar ahí el mismo proveedor: una línea.
+
+Los campos `*Field` siguen **sin** reenviar `container`, y también a propósito: obligar a
+cada app a pasar un nodo en cada uso era el problema, no la solución. La escotilla vive en
+el primitivo.
+
+### El `main` de `PublicPageShell` se puede pedir a sangre
+
+`PublicPageShell` montaba su `main` como `Container as="main" space="xl"` fijo. Es lo que
+quiere una página corriente, pero no una **portada**: la que abre con un `Hero` de lado a
+lado no cabía en el molde y tenía que montarse a mano con `SiteShell` + `Container`, que es
+justo lo que el molde único existe para evitar.
+
+El `main` lleva ahora los mismos tres mandos que un `Container` —`mainWidth`, `mainSpace` y
+`mainFlush`—, con el prefijo de la ranura porque el marco tiene cuatro y un `width` pelado
+no diría cuál gobierna. **Los defaults son los de hoy** (`'xl'`, `'xl'`, `false`): quien no
+los toque se pinta exactamente igual, así que esta parte no es breaking. Una portada pide
+`mainWidth="full" mainSpace="none" mainFlush` y apila secciones, poniendo su propio
+`Container` a lo que quiera columna.
+
+El `main` sigue siendo el `main`, con su `id` y su `tabIndex`, así que el enlace de salto al
+contenido llega igual a una portada abierta a sangre.
+
+### Para quien actualice
+
+El catálogo del `BrandMessagesProvider` tiene que crecer con los catorce espacios, o la
+primera pantalla con un `Breadcrumb`, un `AppRoot` o un `MenuButton` **lanza en render**.
+Estas son las claves que hay que aportar:
+
+| Espacio | Claves | Qué es |
+| --- | --- | --- |
+| `menuButton` | `open`, `close` | qué hace el botón de menú, en sus dos caras |
+| `appRoot` | `skipToContent` | el salto al contenido del documento |
+| `appShell` | `skipToContent` | el salto al contenido de la aplicación |
+| `sidebar` | `label`, `resizer`, `resizerValue(width)` | la región, el asa y su ancho hablado |
+| `sidebarNav` | `label`, `empty` | la región y la marca de una entrada sin contenido |
+| `siteNav` | `label` | la región del índice del sitio |
+| `siteHeader` | `logo` | qué hace el logotipo — **lleva la marca dentro** |
+| `userMenu` | `trigger(name)`, `unread(count)` | el botón de cuenta y su contador |
+| `orgSwitcher` | `trigger(name)` | el botón del conmutador de organización |
+| `breadcrumb` | `label` | la región del rastro |
+| `tableOfContents` | `label` | la región del índice de la página |
+| `prevNextNav` | `previous`, `next` | la dirección, no el destino |
+| `publicPageShell` | `preferences` | la banda de idioma y tema |
+| `onboardingShell` | `actions` | el grupo de acciones del pie del alta |
+
+Cuatro de ellas interpolan un dato (`sidebar.resizerValue`, `userMenu.trigger`,
+`userMenu.unread`, `orgSwitcher.trigger`), así que son funciones. `siteHeader.logo` la
+escribe cada producto con su propia marca: el default retirado decía «Studio LXD — ir al
+inicio».
+
+A cambio, dejan de hacer falta para traducir `AppHeader.menuLabel` y `menuCloseLabel`,
+`SiteHeader.menuLabel` y `menuCloseLabel`, y `OnboardingShell.preferencesLabel`: son
+reenvíos puros y siguen existiendo solo como anulación puntual.
+
+## [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

package/dist/_shared/portal-container.js

@@ -0,0 +1,9 @@
+import { createContext as e, useContext as t } from "react";
+//#region src/stories/constants/portal-container.ts
+var n = e(null);
+function r(e) {
+	let r = t(n);
+	return e === void 0 ? r ?? void 0 : e;
+}
+//#endregion
+export { r as n, n as t };

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

@@ -89,13 +89,14 @@ export interface AsyncMultiSelectProps {
      */
     loadingLabel?: string;
     /**
-     * Nodo DOM donde montar el portal del dropdown (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
-     * AsyncMultiSelect 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 dropdown (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 BasePopover.Portal>['container'];
 }

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

@@ -78,12 +78,14 @@ export interface AsyncSelectProps {
      */
     clearLabel?: string;
     /**
-     * Nodo DOM donde montar el portal del dropdown (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
-     * AsyncSelect 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 dropdown (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 BasePopover.Portal>['container'];
 }

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

@@ -47,11 +47,14 @@ export interface InputPhoneProps {
     internationalLabel?: string;
     /**
      * Nodo DOM donde montar el portal del dropdown de país (reenviado a
-     * `Select.Portal` de Base UI). 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
-     * InputPhone vive dentro de un `.surface-dark` **anidado** (no en la
-     * raíz), ya que ese contexto no llega a `document.body` por la cascada.
+     * `Select.Portal` de Base UI).
+     * 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 BaseSelect.Portal>['container'];
 }

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

@@ -1,11 +1,31 @@
 import { type ComponentPropsWithoutRef } from 'react';
 import './MenuButton.css';
+/**
+ * Los dos textos del botón de menú, y los dos son **cromo**: no dicen de qué
+ * menú son, dicen qué hace el botón. Son los mismos en la cabecera de la
+ * aplicación y en la del sitio, así que van al catálogo una sola vez y las dos
+ * cabeceras los reenvían sin repetir la clave.
+ */
+export interface MenuButtonMessages {
+    /** Nombre accesible del botón con el menú cerrado. */
+    open: string;
+    /** Nombre accesible del botón con el menú abierto. */
+    close: string;
+}
 export interface MenuButtonProps extends Omit<ComponentPropsWithoutRef<'button'>, 'children'> {
     /** Estado del menú que gobierna. Abierto, el glifo `menu` se convierte en `close`. */
     isOpen?: boolean;
-    /** Texto accesible. Dice qué abre, no qué forma tiene. */
+    /**
+     * Texto accesible con el menú cerrado. Dice qué abre, no qué forma tiene.
+     * **Sin default**: sin él, sale de `menuButton.open` del
+     * `BrandMessagesProvider`.
+     */
     label?: string;
-    /** Texto accesible cuando el menú está abierto («Cerrar menú»). Sin él, se usa `label` con `aria-expanded`. */
+    /**
+     * Texto accesible con el menú abierto. **Sin default**: sin él, sale de
+     * `menuButton.close` del `BrandMessagesProvider`. Solo se lee cuando el menú
+     * está abierto: un botón que nunca se abre no exige esa clave.
+     */
     closeLabel?: string;
     /** Talla del botón: un cuadrado de 32, 40 o 48px. En `lg` el glifo mide 48px. */
     size?: 'sm' | 'md' | 'lg';

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

@@ -54,12 +54,14 @@ export interface MultiSelectProps {
      */
     removeLabel?: (label: string) => string;
     /**
-     * Nodo DOM donde montar el portal del dropdown (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
-     * MultiSelect 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 dropdown (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 BasePopover.Portal>['container'];
 }

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

@@ -54,6 +54,13 @@ export interface PopoverProps {
      * un `ref`, o una función que lo devuelva. Es la prop de Base UI, tal cual.
      */
     initialFocus?: React.ComponentProps<typeof BasePopover.Popup>['initialFocus'];
+    /**
+     * 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;
     /** Clase adicional para el panel. */
     className?: string;
 }
@@ -67,4 +74,4 @@ export interface PopoverProps {
  * mantener el panel abierto cuando el clic cae en algo que el motor no
  * reconoce como suyo.
  */
-export declare function Popover({ trigger, children, label, open, defaultOpen, onOpenChange, onPointerDownOutside, onFocusOutside, onEscapeKeyDown, side, align, sideOffset, initialFocus, className, }: PopoverProps): import("react/jsx-runtime").JSX.Element;
+export declare function Popover({ trigger, children, label, open, defaultOpen, onOpenChange, onPointerDownOutside, onFocusOutside, onEscapeKeyDown, side, align, sideOffset, initialFocus, container, className, }: PopoverProps): import("react/jsx-runtime").JSX.Element;

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

@@ -70,13 +70,14 @@ export interface SelectProps {
     /** Estado de error accesible (lo pone el campo). */
     'aria-invalid'?: boolean;
     /**
-     * Nodo DOM donde montar el portal del dropdown (reenviado a `Select.Portal`
-     * de Base UI). Por defecto el portal 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 pasar `container` cuando el Select
-     * vive dentro de un `.surface-dark` **anidado** (no en la raíz): ese contexto
-     * no llega a `document.body` por la cascada, así que hay que montar el portal
-     * dentro del propio contenedor con la clase.
+     * Nodo DOM donde montar el portal del dropdown (reenviado a `Select.Portal` de Base UI).
+     * 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?: SelectPortalContainer;
 }

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

@@ -41,6 +41,13 @@ export interface TooltipProps extends Omit<React.HTMLAttributes<HTMLElement>, 'c
      * @default true
      */
     describe?: boolean;
+    /**
+     * 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;
     /** Clase adicional para el **bocadillo** (no para el disparador). */
     className?: string;
 }

package/dist/_types/constants/portal-container.d.ts

@@ -0,0 +1,42 @@
+/**
+ * El nodo donde montan su portal los componentes que abren una capa flotante
+ * —la lista de un `Select`, el calendario de un `DatePicker`, el panel de un
+ * `Popover`, el velo de un `Modal`— cuando no se les pasa `container`.
+ *
+ * **Por qué hace falta.** Un portal monta en `document.body`, que no es
+ * descendiente de `.site-shell`. El tema oscuro sobrevive a eso porque se
+ * activa en `<html>` y cascadea a todo el documento; la **superficie de
+ * lectura** no: `.site-shell` remapea los tokens de texto y pone los controles
+ * en talla `lg` (v45.1.0) desde una clase que está a media altura del árbol.
+ * Resultado antes de esto: el campo se pintaba a 48px/20 y su lista se abría a
+ * 40px/16, fuera del shell.
+ *
+ * **Cómo se arregla.** `SiteShell` publica su nodo raíz por este contexto y
+ * todo componente con portal lo toma como destino por defecto. No hay nada que
+ * pasar en cada uso: el árbol de React ya sabe dónde está el shell aunque el
+ * árbol del DOM no lo sepa. El valor se guarda en **estado**, no en una ref —
+ * el destino tiene que existir en el render en el que el portal se monta, y
+ * una ref no provoca repintado al rellenarse. Es el patrón que `ChatShell` ya
+ * usaba para el `container` de su cajón.
+ *
+ * La prop `container` sigue existiendo y **gana siempre**: es la salida para
+ * quien quiera otro destino (el ancla de `FloatingDock`, un `.surface-dark`
+ * anidado).
+ *
+ * `AppShell` **no** lo provee, y es deliberado: la superficie de aplicación es
+ * la del `:root`, así que `document.body` ya resuelve los mismos valores y
+ * meter los portales dentro de `.app-shell` —que es `overflow: clip` y de
+ * altura fija— solo añadiría riesgo de recorte sin arreglar nada. El día que
+ * la superficie de aplicación cambie de talla, el arreglo es una línea: montar
+ * este mismo proveedor en `AppShell`.
+ */
+export declare const PortalContainerContext: import("react").Context<HTMLElement | null>;
+/**
+ * Resuelve el destino del portal: la prop si el consumidor la pasa, y si no,
+ * el nodo de la superficie que venga por contexto.
+ *
+ * Se llama **siempre**, con o sin prop —es un hook—, y devuelve `undefined`
+ * cuando no hay ni una cosa ni la otra, que es lo que Base UI entiende por
+ * «monta en `document.body`».
+ */
+export declare function usePortalContainer<T>(container: T): T | HTMLElement | undefined;

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

@@ -25,6 +25,26 @@ 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';
+import type { MenuButtonMessages } from '../atoms/MenuButton/MenuButton';
+import type { AppRootMessages } from '../sections/AppRoot/AppRoot';
+import type { AppShellMessages } from '../sections/AppShell/AppShell';
+import type { SidebarMessages } from '../sections/Sidebar/Sidebar';
+import type { SidebarNavMessages } from '../molecules/SidebarNav/SidebarNav';
+import type { SiteNavMessages } from '../molecules/SiteNav/SiteNav';
+import type { SiteHeaderMessages } from '../sections/SiteHeader/SiteHeader';
+import type { UserMenuMessages } from '../molecules/UserMenu/UserMenu';
+import type { OrgSwitcherMessages } from '../molecules/OrgSwitcher/OrgSwitcher';
+import type { BreadcrumbMessages } from '../molecules/Breadcrumb/Breadcrumb';
+import type { TableOfContentsMessages } from '../molecules/TableOfContents/TableOfContents';
+import type { PrevNextNavMessages } from '../molecules/PrevNextNav/PrevNextNav';
+import type { PublicPageShellMessages } from '../templates/PublicPageShell/PublicPageShell';
+import type { OnboardingShellMessages } from '../templates/OnboardingShell/OnboardingShell';
 /**
  * El contrato de textos de la librería: un espacio por componente, y dentro
  * de cada espacio **todas las claves obligatorias**.
@@ -74,5 +94,25 @@ export interface BrandMessages {
     alert: AlertMessages;
     banner: BannerMessages;
     toaster: ToasterMessages;
+    consent: ConsentMessages;
+    commandPalette: CommandPaletteMessages;
+    appLauncher: AppLauncherMessages;
+    floatingDock: FloatingDockMessages;
+    notificationButton: NotificationButtonMessages;
+    notificationPanel: NotificationPanelMessages;
+    menuButton: MenuButtonMessages;
+    appRoot: AppRootMessages;
+    appShell: AppShellMessages;
+    sidebar: SidebarMessages;
+    sidebarNav: SidebarNavMessages;
+    siteNav: SiteNavMessages;
+    siteHeader: SiteHeaderMessages;
+    userMenu: UserMenuMessages;
+    orgSwitcher: OrgSwitcherMessages;
+    breadcrumb: BreadcrumbMessages;
+    tableOfContents: TableOfContentsMessages;
+    prevNextNav: PrevNextNavMessages;
+    publicPageShell: PublicPageShellMessages;
+    onboardingShell: 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, };
+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, };

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, MenuButtonMessages, AppRootMessages, AppShellMessages, SidebarMessages, SidebarNavMessages, SiteNavMessages, SiteHeaderMessages, UserMenuMessages, OrgSwitcherMessages, BreadcrumbMessages, TableOfContentsMessages, PrevNextNavMessages, PublicPageShellMessages, OnboardingShellMessages, } 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/Breadcrumb/Breadcrumb.d.ts

@@ -14,10 +14,18 @@ export interface BreadcrumbProps {
     renderLink?: (props: BreadcrumbRenderLinkProps) => ReactNode;
     separator?: ReactNode;
     /**
-     * `aria-label` del `<nav>`. Default: «Migas de pan» (castellano).
-     * Una app multiidioma debe pasarlo traducido.
+     * `aria-label` del `<nav>`. **Sin default**: sin él, sale de
+     * `breadcrumb.label` del `BrandMessagesProvider`.
      */
     ariaLabel?: string;
     className?: string;
 }
+/**
+ * El único texto que las migas dicen por su cuenta, y es **cromo**: el nombre de
+ * la región. Los rótulos del rastro son **contenido** y vienen en `items`.
+ */
+export interface BreadcrumbMessages {
+    /** Nombre accesible del `nav`. */
+    label: string;
+}
 export declare function Breadcrumb({ items, renderLink, separator, ariaLabel, className, }: BreadcrumbProps): import("react/jsx-runtime").JSX.Element;