@studiolxd/brand 49.28.0 → 50.0.0

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

@@ -1,4 +1,4 @@
-import { Popover as BasePopover } from '@base-ui/react/popover';
+import { Select as BaseSelect } from '@base-ui/react/select';
 import './MultiSelect.css';
 /**
  * Los dos textos que el control emite por su cuenta: el marcador de sitio sin
@@ -63,16 +63,17 @@ export interface MultiSelectProps {
      * 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'];
+    container?: React.ComponentPropsWithoutRef<typeof BaseSelect.Portal>['container'];
 }
 /**
- * Selección múltiple. El `ref` va al elemento con `role="combobox"`, que es lo
- * enfocable, para que react-hook-form pueda enfocarlo al fallar la validación.
- *
- * Teclado del patrón combobox (el mismo que `AsyncSelect`): flechas abren y
- * recorren, Inicio/Fin saltan a los extremos, Intro/Espacio marcan y desmarcan,
- * Escape cierra y escribir una letra salta a la opción que empieza por ella. El
- * foco del DOM no se mueve nunca de la caja: la opción activa se señala con
- * `aria-activedescendant`.
+ * Selección múltiple sin campo de texto, sobre el `Select` múltiple de Base UI
+ * (no sobre su `Combobox`: sin `<input>`, la guía de Base UI manda al
+ * `Select`). El teclado es suyo: flechas, Intro y Espacio abren; dentro de la
+ * lista las flechas y Inicio/Fin recorren, Intro y Espacio marcan y desmarcan,
+ * escribir salta a la opción que empieza por lo tecleado y Escape cierra y
+ * devuelve el foco a la caja. La lista **sí recibe el foco** (es una lista de
+ * Base UI, no un foco virtual). El `ref` va al elemento con `role="combobox"`,
+ * que es lo enfocable, para que react-hook-form pueda enfocarlo al fallar la
+ * validación.
  */
 export declare const MultiSelect: import("react").ForwardRefExoticComponent<MultiSelectProps & import("react").RefAttributes<HTMLDivElement>>;

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

@@ -80,6 +80,12 @@ export interface SelectProps {
      * cajón de un shell propio. Gana siempre.
      */
     container?: SelectPortalContainer;
+    /**
+     * Se añade DESPUÉS de las clases propias (el consumidor añade, no sustituye).
+     * Va al disparador: es el único nodo que la forma cerrada pinta en su sitio
+     * (la lista sale por un portal).
+     */
+    className?: string;
 }
 type BaseSelectRootProps = React.ComponentProps<typeof BaseSelect.Root<string>>;
 export interface SelectRootProps extends Omit<BaseSelectRootProps, 'onValueChange' | 'multiple'> {

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

@@ -19,4 +19,4 @@ export interface SkeletonProps extends Omit<React.SVGProps<SVGSVGElement>, 'widt
  * saldría a ancho completo y una línea de alto. No hay prop `style` por lo
  * mismo: el atributo no llegaría a pintarse.
  */
-export declare function Skeleton({ width, height, circle, className, ...rest }: SkeletonProps): import("react/jsx-runtime").JSX.Element;
+export declare const Skeleton: import("react").ForwardRefExoticComponent<Omit<SkeletonProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;

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

@@ -20,5 +20,7 @@ export interface SpinnerProps {
     label?: string;
     /** Cuando true, el spinner es puramente decorativo (sin rol ni anuncio). */
     'aria-hidden'?: boolean;
+    /** Se añade DESPUÉS de las clases propias (el consumidor añade, no sustituye). */
+    className?: string;
 }
-export declare function Spinner({ size, label, 'aria-hidden': ariaHidden }: SpinnerProps): import("react/jsx-runtime").JSX.Element;
+export declare function Spinner({ size, label, 'aria-hidden': ariaHidden, className }: SpinnerProps): import("react/jsx-runtime").JSX.Element;

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

@@ -29,6 +29,8 @@ export interface TypingIndicatorProps {
      * `BrandMessagesProvider`.
      */
     label?: string;
+    /** Se añade DESPUÉS de las clases propias (el consumidor añade, no sustituye). */
+    className?: string;
 }
 /** Tres puntos cuadrados que laten en secuencia: «alguien está escribiendo». */
-export declare function TypingIndicator({ name, label }: TypingIndicatorProps): import("react/jsx-runtime").JSX.Element;
+export declare function TypingIndicator({ name, label, className }: TypingIndicatorProps): import("react/jsx-runtime").JSX.Element;

package/dist/_types/atoms/_shared/useAsyncOptions.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Lo que recibe un control de búsqueda para pedir opciones: lo escrito, y
+ * devuelve la lista, en el acto o en una promesa.
+ */
+export type SearchOptions<T> = (query: string) => T[] | Promise<T[]>;
+export interface AsyncOptions<T> {
+    /** Las opciones de la última búsqueda que terminó (y no se descartó). */
+    results: T[];
+    /** Hay una búsqueda en vuelo. */
+    loading: boolean;
+    /**
+     * Ha terminado al menos una búsqueda desde la última limpieza: distingue
+     * «aún no se ha buscado» de «se buscó y no hay nada» (el aviso de vacío).
+     */
+    hasSearched: boolean;
+    /** Busca ya, sin rebote. */
+    search: (query: string) => void;
+    /** Busca tras el rebote (`debounceMs`); a 0, en el acto. */
+    schedule: (query: string) => void;
+    /** Cancela el rebote pendiente y descarta la búsqueda en vuelo. */
+    cancel: () => void;
+    /** Vacía los resultados y vuelve al estado de «aún no se ha buscado». */
+    clear: () => void;
+}
+/**
+ * La carga asíncrona que comparten `AsyncSelect`, `AsyncMultiSelect` y
+ * `Autocomplete`: rebote entre teclas, un contador de petición para que solo
+ * mande la última —dos búsquedas seguidas pueden resolverse fuera de orden y
+ * pintar los resultados viejos— y limpieza al desmontar, para que una
+ * respuesta tardía no intente pintar nada. Si `onSearch` lanza o rechaza, no
+ * hay opciones: el control no tiene un estado de error propio.
+ *
+ * La conducta del combobox (teclado, foco, anuncios) es de Base UI; esto solo
+ * decide qué opciones hay en cada momento.
+ */
+export declare function useAsyncOptions<T>(onSearch: SearchOptions<T>, debounceMs: number): AsyncOptions<T>;

package/dist/_types/constants/assign-ref.d.ts

@@ -0,0 +1,12 @@
+import type { Ref } from 'react';
+/**
+ * Asigna un nodo a una `ref` de React, sea función u objeto. Es la pieza con
+ * la que un componente que necesita su propio nodo (para enfocar, medir o
+ * escribir por el CSSOM) lo comparte con la `ref` que le pasa el consumidor:
+ * se llama desde una ref de callback que hace las dos cosas.
+ *
+ * Sin `ref` del consumidor no hace nada. El valor que devuelva una ref de
+ * función (la limpieza de React 19) se descarta, igual que hacían las copias
+ * en línea a las que sustituye.
+ */
+export declare function assignRef<T>(target: Ref<T> | undefined, node: T | null): void;

package/dist/_types/constants/default-render-link.d.ts

@@ -0,0 +1,13 @@
+import type { AnchorHTMLAttributes } from 'react';
+/**
+ * El enlace por defecto de los componentes con `renderLink`: un `<a>` que
+ * recibe **todas** las props que le llegan. Reenviarlas todas no es un
+ * detalle: en un menú, el motor de conducta inyecta rol, `tabIndex` y
+ * manejadores de teclado en el enlace, y un `renderLink` que solo copie
+ * `href`/`className` lo rompe. El enlace del router del producto tiene que
+ * hacer lo mismo (`<Link {...props} />`).
+ *
+ * Quien lo use pasa al `renderLink` **solo atributos de `<a>`**: una prop
+ * interna se quita antes de llamarlo, no se filtra aquí dentro.
+ */
+export declare function defaultRenderLink(props: AnchorHTMLAttributes<HTMLAnchorElement>): import("react/jsx-runtime").JSX.Element;

package/dist/_types/constants/overflow-focusable.d.ts

@@ -0,0 +1,15 @@
+import { type RefObject } from 'react';
+/**
+ * ¿Desborda el contenedor? Un contenedor con scroll tiene que poder recibir el
+ * foco para que el teclado lo desplace (WCAG 2.1.1; regla de axe
+ * `scrollable-region-focusable`): sin un descendiente enfocable, quien no usa
+ * ratón no llega a lo que queda fuera. Pero una parada de tabulador de más en
+ * cada tabla que cabe entera estorba, así que esto devuelve `true` solo
+ * mientras el contenido desborda — y el componente pone entonces
+ * `tabIndex={0}`.
+ *
+ * Mide en cliente (`ResizeObserver` sobre el contenedor y su primer hijo, que
+ * crece con las filas): el primer render del servidor sale sin parada, que es
+ * lo correcto mientras no se sepa si desborda.
+ */
+export declare function useOverflowFocusable(ref: RefObject<HTMLElement | null>): boolean;

package/dist/_types/constants/side-offset.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Convierte una longitud CSS (`4px`, `0.25rem`, `0.5em`) a píxeles. `rem` se
+ * mide contra `<html>` y `em` contra `el` (por defecto, también `<html>`). Con
+ * cualquier otra unidad (o ninguna) devuelve el número tal cual, y sin número,
+ * 0: el token viaja siempre con el CSS del componente.
+ */
+export declare function cssLengthToPx(raw: string, el?: Element): number;
+/**
+ * `sideOffset` por defecto de un flotante a partir de su token. El Positioner
+ * de Base UI necesita un número (su función de offset solo recibe medidas, no
+ * el elemento), así que la función que devuelve lee la custom property sobre
+ * `<html>` **en cada cálculo de posición**: un consumidor lo cambia
+ * sobrescribiendo el token en la raíz, sin tocar el componente.
+ *
+ * Se crea a nivel de módulo (`const tokenSideOffset = sideOffsetFromToken('--tooltip-offset')`):
+ * no toca el DOM hasta que Base UI la llama, ya en cliente.
+ */
+export declare function sideOffsetFromToken(property: `--${string}`): () => number;

package/dist/_types/email/EmailLayout.d.ts

@@ -2,34 +2,51 @@ import type { ReactNode } from 'react';
 interface EmailOptOutBase {
     /** Baja directa, de un clic, de la categoría de aviso de este correo. */
     unsubscribeUrl: string;
-    /** Texto del enlace de baja. */
-    unsubscribeLabel?: string;
 }
-/**
- * El pie de quien **tiene cuenta** en la suite: puede darse de baja y, si el
- * producto tiene la pantalla, elegir categoría a categoría.
- */
-export interface EmailOptOutAccount extends EmailOptOutBase {
+interface EmailOptOutAccountLabels {
+    /**
+     * Texto del enlace de baja. Sin preferencias es la continuación de
+     * `manageLabel` («Para dejar de recibir estos avisos, **date de baja**»);
+     * con preferencias, el arranque de la frase («**Darse de baja** o …»).
+     */
+    unsubscribeLabel: string;
+    /** Frase que precede al enlace en el pie de un solo enlace. */
+    manageLabel: string;
+    /** Texto entre los dos enlaces del pie completo (« o »). */
+    manageBeforeLabel: string;
+    /** Texto del enlace a preferencias. */
+    managePreferencesLabel: string;
+    /** Texto tras el enlace a preferencias (el punto final, en castellano). */
+    manageAfterLabel: string;
+    reasonLabel?: never;
+}
+/** Sin pantalla de preferencias: el pie de un solo enlace. */
+interface EmailOptOutAccountSingle extends EmailOptOutBase, Pick<EmailOptOutAccountLabels, 'unsubscribeLabel' | 'manageLabel' | 'reasonLabel'>, Partial<Pick<EmailOptOutAccountLabels, 'manageBeforeLabel' | 'managePreferencesLabel' | 'manageAfterLabel'>> {
+    preferencesUrl?: undefined;
+}
+/** Con pantalla de preferencias: el pie completo, de dos enlaces. */
+interface EmailOptOutAccountFull extends EmailOptOutBase, Omit<EmailOptOutAccountLabels, 'manageLabel'>, Partial<Pick<EmailOptOutAccountLabels, 'manageLabel'>> {
     /**
      * Pantalla donde elegir categoría a categoría, para quien quiera conservar
      * algunas.
-     *
-     * Opcional a propósito: las apps que mandaban correo antes de que existiera
-     * el paquete solo construyen un enlace de baja, sin pantalla de preferencias
-     * detrás. Omitirlo deja el pie de un solo enlace en vez de obligar a cada
-     * llamada a inventarse una URL que no tiene.
      */
+    preferencesUrl: string;
+}
+/** Con una `preferencesUrl` que puede o no llegar: los cinco textos. */
+interface EmailOptOutAccountEither extends EmailOptOutBase, EmailOptOutAccountLabels {
     preferencesUrl?: string;
-    /** Frase que precede al enlace en el pie de un solo enlace. Por defecto, en castellano. */
-    manageLabel?: string;
-    /** Texto entre los dos enlaces del pie completo. Por defecto, en castellano. */
-    manageBeforeLabel?: string;
-    /** Texto del enlace a preferencias. Por defecto, en castellano. */
-    managePreferencesLabel?: string;
-    /** Texto tras el enlace a preferencias. Por defecto, en castellano. */
-    manageAfterLabel?: string;
-    reasonLabel?: never;
 }
+/**
+ * El pie de quien **tiene cuenta** en la suite: puede darse de baja y, si el
+ * producto tiene la pantalla, elegir categoría a categoría. Sus textos son
+ * obligatorios (ver arriba): los que pida la forma del pie.
+ *
+ * `preferencesUrl` es opcional a propósito: las apps que mandaban correo antes
+ * de que existiera el paquete solo construyen un enlace de baja, sin pantalla
+ * de preferencias detrás. Omitirla deja el pie de un solo enlace en vez de
+ * obligar a cada llamada a inventarse una URL que no tiene.
+ */
+export type EmailOptOutAccount = EmailOptOutAccountSingle | EmailOptOutAccountFull | EmailOptOutAccountEither;
 /**
  * El pie de quien **no tiene cuenta**: el invitado a una revisión, el que
  * recibe el correo por una dirección suelta. Solo la baja.

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

@@ -51,6 +51,9 @@ import type { OnboardingShellMessages } from '../templates/OnboardingShell/Onboa
 import type { CopyMessages } from '../constants/copy-to-clipboard';
 import type { CodeBlockMessages } from '../molecules/CodeBlock/CodeBlock';
 import type { DotsButtonMessages } from '../atoms/DotsButton/DotsButton';
+import type { CloseButtonMessages } from '../atoms/CloseButton/CloseButton';
+import type { ThemeSwitcherMessages } from '../molecules/ThemeSwitcher/ThemeSwitcher';
+import type { StatTileMessages } from '../molecules/StatTile/StatTile';
 import type { ProgressBarMessages } from '../atoms/ProgressBar/ProgressBar';
 import type { SpinnerMessages } from '../atoms/Spinner/Spinner';
 import type { SliderMessages } from '../atoms/Slider/Slider';
@@ -92,7 +95,7 @@ import type { ConnectorRejectionMessages } from '../templates/ConnectorAuth/Conn
  * suite concreta, el DS pasaría a depender de un paquete de producto para
  * declarar su propio contrato y dejaría de sostenerse solo.
  *
- * Anidado por componente, no plano: son 310 textos en 111 componentes, y una
+ * Anidado por componente, no plano: son unos 310 textos en 88 espacios, y una
  * lista plana de claves sueltas (`paginationPrevious`, `modalClose`…) no se
  * puede escribir ni revisar. Los espacios calcan además los que el catálogo
  * de la suite ya tiene (`pagination`, `table`, `common`…), así que montar el
@@ -164,6 +167,9 @@ export interface BrandMessages {
     copy: CopyMessages;
     codeBlock: CodeBlockMessages;
     dotsButton: DotsButtonMessages;
+    closeButton: CloseButtonMessages;
+    themeSwitcher: ThemeSwitcherMessages;
+    statTile: StatTileMessages;
     progressBar: ProgressBarMessages;
     spinner: SpinnerMessages;
     slider: SliderMessages;
@@ -197,4 +203,4 @@ export interface BrandMessages {
     connectorExternalSignIn: ConnectorExternalSignInMessages;
     connectorRejection: ConnectorRejectionMessages;
 }
-export type { PaginationMessages, TableMessages, DataTableMessages, InputFieldMessages, PasswordFieldMessages, SelectMessages, MultiSelectMessages, NumberInputMessages, OtpInputMessages, InputPhoneMessages, AsyncSelectMessages, AsyncMultiSelectMessages, DocsSearchMessages, SearchFormMessages, SiteSearchMessages, FilterBarMessages, CalendarMessages, DatePickerMessages, ColorPickerMessages, TimeSelectMessages, FileUploadMessages, ImageCropDialogMessages, AvatarUploadMessages, ModalMessages, SheetMessages, ConfirmDialogMessages, AlertMessages, BannerMessages, ToasterMessages, ConsentMessages, CommandPaletteMessages, AppLauncherMessages, FloatingDockMessages, NotificationButtonMessages, NotificationPanelMessages, MenuButtonMessages, AppRootMessages, AppShellMessages, AppHeaderMessages, SidebarMessages, SidebarNavMessages, SiteNavMessages, SiteHeaderMessages, UserMenuMessages, OrgSwitcherMessages, BreadcrumbMessages, TableOfContentsMessages, PrevNextNavMessages, PublicPageShellMessages, OnboardingShellMessages, CopyMessages, CodeBlockMessages, DotsButtonMessages, ProgressBarMessages, SpinnerMessages, SliderMessages, TreeViewMessages, ClockWidgetMessages, HeatmapMessages, OrgChartMessages, PlanningGridMessages, RecurrenceFieldMessages, TimelineMessages, UptimeBarsMessages, ChartMessages, StepperMessages, CarouselMessages, LanguageSwitcherMessages, ProjectCardMessages, LegalFooterMessages, CalendarRosterMessages, CalendarPlannerMessages, NotificationListMessages, MessageComposerMessages, ConversationListMessages, ConversationThreadMessages, TypingIndicatorMessages, AnnotationThreadMessages, ChatShellMessages, UntrustedTextMessages, ConnectorRequestSummaryMessages, ConnectorConsentMessages, ConnectorSignInMessages, ConnectorExternalSignInMessages, ConnectorRejectionMessages, };
+export type { PaginationMessages, TableMessages, DataTableMessages, InputFieldMessages, PasswordFieldMessages, SelectMessages, MultiSelectMessages, NumberInputMessages, OtpInputMessages, InputPhoneMessages, AsyncSelectMessages, AsyncMultiSelectMessages, DocsSearchMessages, SearchFormMessages, SiteSearchMessages, FilterBarMessages, CalendarMessages, DatePickerMessages, ColorPickerMessages, TimeSelectMessages, FileUploadMessages, ImageCropDialogMessages, AvatarUploadMessages, ModalMessages, SheetMessages, ConfirmDialogMessages, AlertMessages, BannerMessages, ToasterMessages, ConsentMessages, CommandPaletteMessages, AppLauncherMessages, FloatingDockMessages, NotificationButtonMessages, NotificationPanelMessages, MenuButtonMessages, AppRootMessages, AppShellMessages, AppHeaderMessages, SidebarMessages, SidebarNavMessages, SiteNavMessages, SiteHeaderMessages, UserMenuMessages, OrgSwitcherMessages, BreadcrumbMessages, TableOfContentsMessages, PrevNextNavMessages, PublicPageShellMessages, OnboardingShellMessages, CopyMessages, CodeBlockMessages, DotsButtonMessages, CloseButtonMessages, ThemeSwitcherMessages, StatTileMessages, ProgressBarMessages, SpinnerMessages, SliderMessages, TreeViewMessages, ClockWidgetMessages, HeatmapMessages, OrgChartMessages, PlanningGridMessages, RecurrenceFieldMessages, TimelineMessages, UptimeBarsMessages, ChartMessages, StepperMessages, CarouselMessages, LanguageSwitcherMessages, ProjectCardMessages, LegalFooterMessages, CalendarRosterMessages, CalendarPlannerMessages, NotificationListMessages, MessageComposerMessages, ConversationListMessages, ConversationThreadMessages, TypingIndicatorMessages, AnnotationThreadMessages, ChatShellMessages, UntrustedTextMessages, ConnectorRequestSummaryMessages, ConnectorConsentMessages, ConnectorSignInMessages, ConnectorExternalSignInMessages, ConnectorRejectionMessages, };

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, BrandMessagesNamespace } from './BrandMessagesContext';
-export type { BrandMessages, PaginationMessages, TableMessages, DataTableMessages, InputFieldMessages, PasswordFieldMessages, SelectMessages, MultiSelectMessages, NumberInputMessages, OtpInputMessages, InputPhoneMessages, AsyncSelectMessages, AsyncMultiSelectMessages, DocsSearchMessages, SearchFormMessages, SiteSearchMessages, FilterBarMessages, CalendarMessages, DatePickerMessages, ColorPickerMessages, TimeSelectMessages, FileUploadMessages, ImageCropDialogMessages, AvatarUploadMessages, ModalMessages, SheetMessages, ConfirmDialogMessages, AlertMessages, BannerMessages, ToasterMessages, ConsentMessages, CommandPaletteMessages, AppLauncherMessages, FloatingDockMessages, NotificationButtonMessages, NotificationPanelMessages, MenuButtonMessages, AppRootMessages, AppShellMessages, AppHeaderMessages, SidebarMessages, SidebarNavMessages, SiteNavMessages, SiteHeaderMessages, UserMenuMessages, OrgSwitcherMessages, BreadcrumbMessages, TableOfContentsMessages, PrevNextNavMessages, PublicPageShellMessages, OnboardingShellMessages, CopyMessages, CodeBlockMessages, DotsButtonMessages, ProgressBarMessages, SpinnerMessages, SliderMessages, TreeViewMessages, ClockWidgetMessages, HeatmapMessages, OrgChartMessages, PlanningGridMessages, RecurrenceFieldMessages, TimelineMessages, UptimeBarsMessages, ChartMessages, StepperMessages, CarouselMessages, LanguageSwitcherMessages, ProjectCardMessages, LegalFooterMessages, CalendarRosterMessages, CalendarPlannerMessages, NotificationListMessages, MessageComposerMessages, ConversationListMessages, ConversationThreadMessages, TypingIndicatorMessages, AnnotationThreadMessages, ChatShellMessages, UntrustedTextMessages, ConnectorRequestSummaryMessages, ConnectorConsentMessages, ConnectorSignInMessages, ConnectorExternalSignInMessages, ConnectorRejectionMessages, } from './BrandMessages';
+export type { BrandMessages, PaginationMessages, TableMessages, DataTableMessages, InputFieldMessages, PasswordFieldMessages, SelectMessages, MultiSelectMessages, NumberInputMessages, OtpInputMessages, InputPhoneMessages, AsyncSelectMessages, AsyncMultiSelectMessages, DocsSearchMessages, SearchFormMessages, SiteSearchMessages, FilterBarMessages, CalendarMessages, DatePickerMessages, ColorPickerMessages, TimeSelectMessages, FileUploadMessages, ImageCropDialogMessages, AvatarUploadMessages, ModalMessages, SheetMessages, ConfirmDialogMessages, AlertMessages, BannerMessages, ToasterMessages, ConsentMessages, CommandPaletteMessages, AppLauncherMessages, FloatingDockMessages, NotificationButtonMessages, NotificationPanelMessages, MenuButtonMessages, AppRootMessages, AppShellMessages, AppHeaderMessages, SidebarMessages, SidebarNavMessages, SiteNavMessages, SiteHeaderMessages, UserMenuMessages, OrgSwitcherMessages, BreadcrumbMessages, TableOfContentsMessages, PrevNextNavMessages, PublicPageShellMessages, OnboardingShellMessages, CopyMessages, CodeBlockMessages, DotsButtonMessages, CloseButtonMessages, ThemeSwitcherMessages, StatTileMessages, ProgressBarMessages, SpinnerMessages, SliderMessages, TreeViewMessages, ClockWidgetMessages, HeatmapMessages, OrgChartMessages, PlanningGridMessages, RecurrenceFieldMessages, TimelineMessages, UptimeBarsMessages, ChartMessages, StepperMessages, CarouselMessages, LanguageSwitcherMessages, ProjectCardMessages, LegalFooterMessages, CalendarRosterMessages, CalendarPlannerMessages, NotificationListMessages, MessageComposerMessages, ConversationListMessages, ConversationThreadMessages, TypingIndicatorMessages, AnnotationThreadMessages, ChatShellMessages, UntrustedTextMessages, ConnectorRequestSummaryMessages, ConnectorConsentMessages, ConnectorSignInMessages, ConnectorExternalSignInMessages, ConnectorRejectionMessages, } from './BrandMessages';

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

@@ -16,7 +16,7 @@ export interface AppLauncherMessages {
     open: string;
     /** Texto del distintivo de app nueva. */
     new: string;
-    /** Título del diálogo con `presentation="modal"`. */
+    /** Título del diálogo con `presentation="modal"`; con `"popover"`, nombre accesible del popup. */
     title: string;
 }
 export interface LauncherApp {
@@ -65,8 +65,8 @@ export interface AppLauncherLabels {
     trigger?: string;
     /**
      * 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.
+     * sale de `appLauncher.title` del proveedor. En `presentation="popover"`,
+     * que no pinta título, es el nombre accesible (`aria-label`) del popup.
      */
     title?: string;
 }
@@ -92,5 +92,11 @@ export interface AppLauncherProps {
      * quien lo prefiera lo pide explícitamente.
      */
     presentation?: 'modal' | 'popover';
+    /**
+     * Se añade DESPUÉS de las clases propias (el consumidor añade, no sustituye).
+     * Va al disparador: es el único nodo que el componente pinta en su sitio (el
+     * panel sale por un portal, sea diálogo o popover).
+     */
+    className?: string;
 }
 export declare function AppLauncher({ presentation, labels, ...rest }: AppLauncherProps): import("react/jsx-runtime").JSX.Element;

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

@@ -82,8 +82,17 @@ export interface CalendarProps {
      * `DatePicker`), conviene pasarlo aquí.
      */
     gridLabel?: string;
+    /**
+     * El día que el calendario marca como «hoy» (y desde el que arranca el mes
+     * visible y el foco cuando no hay otra fecha). Default: la fecha actual,
+     * calculada una vez al montar. **En SSR conviene pasarla**: servidor y
+     * navegador calculan cada uno su «ahora», y cerca de la medianoche —o con
+     * husos distintos— no coinciden y la hidratación se desajusta. Basta con
+     * calcularla en el servidor y mandar la misma fecha a los dos lados.
+     */
+    today?: Date;
     /** Tamaño del componente. Default: 'md' */
     size?: 'sm' | 'md' | 'lg';
     className?: string;
 }
-export declare function Calendar({ value, onChange, defaultMonth, month: monthProp, onMonthChange, navigable, disabledDates, minDate, maxDate, locale, previousMonthLabel, nextMonthLabel, previousYearsLabel, nextYearsLabel, yearGridLabel, gridLabel, size, className, }: CalendarProps): import("react/jsx-runtime").JSX.Element;
+export declare function Calendar({ value, onChange, defaultMonth, month: monthProp, onMonthChange, navigable, disabledDates, minDate, maxDate, locale, previousMonthLabel, nextMonthLabel, previousYearsLabel, nextYearsLabel, yearGridLabel, gridLabel, today: todayProp, size, className, }: CalendarProps): import("react/jsx-runtime").JSX.Element;

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

@@ -2,14 +2,25 @@ 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
+ * Los textos propios del planificador: el botón que abre los eventos que no
+ * caben en una celda, las flechas de la vista de semana y el conmutador de
+ * vista. 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;
+    /** Nombre accesible de la flecha de retroceso en la vista de semana. */
+    previousWeek: string;
+    /** Nombre accesible de la flecha de avance en la vista de semana. */
+    nextWeek: string;
+    /** Rótulo del botón de vista de mes del conmutador. */
+    monthView: string;
+    /** Rótulo del botón de vista de semana del conmutador. */
+    weekView: string;
+    /** Nombre accesible del conmutador de vista. */
+    viewSwitcher: string;
 }
 export interface PlannerEvent {
     id: string;
@@ -113,23 +124,42 @@ export interface CalendarPlannerProps {
     /** Callback al cambiar de semana. Recibe el **lunes** de la nueva. */
     onWeekChange?: (weekStart: Date) => void;
     /**
-     * aria-label del botón de semana anterior. Default: `'Semana anterior'`
-     * (castellano). No sale del catálogo como las flechas de mes: añadirle una
-     * clave obligatoria a `CalendarPlannerMessages` rompería a todas las
-     * aplicaciones que ya lo tienen montado, así que estos cuatro textos entran
-     * como props y pasarán al catálogo en el próximo major.
+     * aria-label del botón de semana anterior. **Sin default**: sin él, sale de
+     * `calendarPlanner.previousWeek` del `BrandMessagesProvider`. Solo se lee
+     * en la vista de semana con `navigable`.
      */
     previousWeekLabel?: string;
-    /** aria-label del botón de semana siguiente. Default: `'Semana siguiente'`. */
+    /**
+     * aria-label del botón de semana siguiente. **Sin default**: sale de
+     * `calendarPlanner.nextWeek`.
+     */
     nextWeekLabel?: string;
-    /** Rótulo del botón de vista de mes del conmutador. Default: `'Mes'`. */
+    /**
+     * Rótulo del botón de vista de mes del conmutador. **Sin default**: sale de
+     * `calendarPlanner.monthView`. Solo se lee con `viewSwitcher`.
+     */
     monthViewLabel?: string;
-    /** Rótulo del botón de vista de semana del conmutador. Default: `'Semana'`. */
+    /**
+     * Rótulo del botón de vista de semana del conmutador. **Sin default**: sale
+     * de `calendarPlanner.weekView`. Solo se lee con `viewSwitcher`.
+     */
     weekViewLabel?: string;
-    /** Nombre accesible del conmutador de vista. Default: `'Vista del calendario'`. */
+    /**
+     * Nombre accesible del conmutador de vista. **Sin default**: sale de
+     * `calendarPlanner.viewSwitcher`. Solo se lee con `viewSwitcher`.
+     */
     viewSwitcherLabel?: string;
+    /**
+     * El día que el planificador marca como «hoy» (y desde el que arranca el
+     * mes o la semana visible cuando no se pasa otra fecha). Default: la fecha
+     * actual, calculada una vez al montar. **En SSR conviene pasarla**: servidor
+     * y navegador calculan cada uno su «ahora», y cerca de la medianoche —o con
+     * husos distintos— no coinciden y la hidratación se desajusta. Basta con
+     * calcularla en el servidor y mandar la misma fecha a los dos lados.
+     */
+    today?: Date;
     /** Tamaño del componente. Default: 'md' */
     size?: 'sm' | 'md' | 'lg';
     className?: string;
 }
-export declare function CalendarPlanner({ events, renderDay, maxItemsPerDay, onMoreClick, showMoreDialog, onDayClick, month: monthProp, defaultMonth, onMonthChange, view: viewProp, defaultView, onViewChange, viewSwitcher, week: weekProp, defaultWeek, onWeekChange, navigable, locale, previousMonthLabel, nextMonthLabel, previousWeekLabel, nextWeekLabel, monthViewLabel, weekViewLabel, viewSwitcherLabel, gridLabel, moreLabel, size, className, }: CalendarPlannerProps): import("react/jsx-runtime").JSX.Element;
+export declare function CalendarPlanner({ events, renderDay, maxItemsPerDay, onMoreClick, showMoreDialog, onDayClick, month: monthProp, defaultMonth, onMonthChange, view: viewProp, defaultView, onViewChange, viewSwitcher, week: weekProp, defaultWeek, onWeekChange, navigable, locale, previousMonthLabel, nextMonthLabel, previousWeekLabel, nextWeekLabel, monthViewLabel, weekViewLabel, viewSwitcherLabel, gridLabel, moreLabel, today: todayProp, size, className, }: CalendarPlannerProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,4 +1,4 @@
-import type { ComponentType, ReactNode } from 'react';
+import { type ComponentType, type ReactNode } from 'react';
 import './CalendarRoster.css';
 /**
  * El cromo del cuadrante: el encabezado de la columna de nombres y la leyenda
@@ -107,6 +107,14 @@ export interface CalendarRosterProps {
     nextMonthLabel?: string;
     /** Locale para nombres de mes y día. Default: 'es-ES' */
     locale?: string;
+    /**
+     * El día que el cuadrante marca como «hoy». Default: la fecha actual,
+     * calculada una vez al montar. **En SSR conviene pasarla**: servidor y
+     * navegador calculan cada uno su «ahora», y cerca de la medianoche —o con
+     * husos distintos— no coinciden y la hidratación se desajusta. Basta con
+     * calcularla en el servidor y mandar la misma fecha a los dos lados.
+     */
+    today?: Date;
     className?: string;
 }
-export declare function CalendarRoster({ rows, month, onMonthChange, hrefBuilder, linkComponent, renderCell, nameLabel, birthdayPrefix, showLegend, locale, legendItems, legendLabel, previousMonthLabel, nextMonthLabel, className, }: CalendarRosterProps): import("react/jsx-runtime").JSX.Element;
+export declare function CalendarRoster({ rows, month, onMonthChange, hrefBuilder, linkComponent, renderCell, nameLabel, birthdayPrefix, showLegend, locale, legendItems, legendLabel, previousMonthLabel, nextMonthLabel, today: todayProp, className, }: CalendarRosterProps): import("react/jsx-runtime").JSX.Element;

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

@@ -20,10 +20,17 @@ export interface ContextMenuProps {
      * traducir.
      */
     label?: string;
+    /**
+     * Se añade DESPUÉS de las clases propias (el consumidor añade, no sustituye).
+     * Va al botón de tres puntos —el único nodo que el componente pinta en su
+     * sitio—, no al panel, que sale por un portal: a diferencia de `Menu`, aquí
+     * el disparador es del componente y no del consumidor.
+     */
+    className?: string;
 }
 /**
  * El menú de acciones de una fila, una tarjeta, un elemento: un `Menu` cuyo
  * disparador es el botón de tres puntos (`DotsButton`). Todo lo demás —ítems,
  * enlaces del router, colocación, cara— es del `Menu`.
  */
-export declare function ContextMenu({ items, renderLink, onOpenChange, side, align, minWidth, maxWidth, triggerSize, triggerOrientation, label, }: ContextMenuProps): import("react/jsx-runtime").JSX.Element;
+export declare function ContextMenu({ items, renderLink, onOpenChange, side, align, minWidth, maxWidth, triggerSize, triggerOrientation, label, className, }: ContextMenuProps): import("react/jsx-runtime").JSX.Element;

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

@@ -102,6 +102,12 @@ export interface DatePickerProps {
      * nombra el panel entero.
      */
     gridLabel?: CalendarProps['gridLabel'];
+    /**
+     * El «hoy» que marca el calendario del panel. Default: la fecha actual,
+     * calculada una vez al montar el calendario. **En SSR conviene pasarla**
+     * (ver `Calendar`): evita el desajuste de hidratación cerca de la medianoche.
+     */
+    today?: CalendarProps['today'];
     /** Nombre del campo en el formulario: se monta un input oculto con la fecha en ISO. */
     name?: string;
     /** Se llama al salir del campo (react-hook-form lo usa para validar). */

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

@@ -53,6 +53,8 @@ export interface DateTimeFieldProps {
     yearGridLabel?: DatePickerProps['yearGridLabel'];
     /** aria-label de la rejilla de días. Sin él, el nombre del panel. */
     gridLabel?: DatePickerProps['gridLabel'];
+    /** El «hoy» del calendario. Default: la fecha actual. En SSR conviene pasarla (ver `Calendar`). */
+    today?: DatePickerProps['today'];
     /** aria-label del desplegable de horas. Sin él, `timeSelect.hours`. */
     hoursLabel?: string;
     /** aria-label del desplegable de minutos. Sin él, `timeSelect.minutes`. */

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

@@ -39,7 +39,7 @@ export interface DocsSearchMessages {
     loading: string;
 }
 export interface DocsSearchProps {
-    /** `id` del campo. Ata la etiqueta con el campo y el campo con la lista. */
+    /** `id` del campo. Ata la etiqueta con el campo y el campo con la lista. Por defecto, uno único por instancia (`useId`). */
     id?: string;
     /** Texto escrito. El componente es controlado: no guarda estado propio. */
     query: string;
@@ -111,4 +111,4 @@ export interface DocsSearchProps {
  * (`filter={null}`) y la lista en línea, sin popup: los resultados de una
  * búsqueda de documentación no son un menú flotante, son la página.
  */
-export declare function DocsSearch({ id, query, onQueryChange, results, loading, label, labelHidden, placeholder, clearable, clearLabel, resultsLabel, emptyLabel, loadingLabel, size, renderLink, onSelect, className, }: DocsSearchProps): import("react/jsx-runtime").JSX.Element;
+export declare function DocsSearch({ id: idProp, query, onQueryChange, results, loading, label, labelHidden, placeholder, clearable, clearLabel, resultsLabel, emptyLabel, loadingLabel, size, renderLink, onSelect, className, }: DocsSearchProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,83 @@
+import { type ReactNode } from 'react';
+import './FloatingToolbar.css';
+export interface FloatingToolbarProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'className' | 'children'> {
+    /**
+     * Las acciones del **principio**: a la izquierda del elemento en
+     * `sides`, al principio de la fila en `top`. Van como
+     * `FloatingToolbarButton`.
+     */
+    start?: ReactNode;
+    /**
+     * Las acciones del **final**: a la derecha del elemento en `sides`, al
+     * final de la fila en `top`.
+     */
+    end?: ReactNode;
+    /**
+     * Dónde se pinta la barra.
+     *
+     * - `auto` (por defecto): encima del elemento por debajo de `breakpoint.lg`
+     *   y en dos raíles a sus lados desde `lg`. Las acciones se declaran **una
+     *   vez**: es el CSS quien las coloca, no hay una barra por anchura.
+     * - `top`: siempre encima.
+     * - `sides`: siempre a los lados.
+     *
+     * @default 'auto'
+     */
+    layout?: 'auto' | 'top' | 'sides';
+    /**
+     * La barra se ve siempre, no solo al pasar el puntero o al tener el foco
+     * dentro. Para el elemento **seleccionado** —el que se está editando—,
+     * sobre todo en pantallas táctiles, donde no hay puntero que pase.
+     *
+     * @default false
+     */
+    alwaysVisible?: boolean;
+    /**
+     * Nombre accesible de la barra (`aria-label` del `role="toolbar"`).
+     * **Obligatorio y sin default**: tiene que decir **de qué** son las
+     * acciones —«Acciones del bloque 3: Texto»—, porque en una lista hay una
+     * barra por elemento y un nombre fijo las haría indistinguibles. Es un
+     * dato del producto, no un texto del sistema: por eso no está en el
+     * proveedor de textos.
+     */
+    label: string;
+    /** El elemento al que se ancla la barra. */
+    children: ReactNode;
+    /** Se añade DESPUÉS de las clases propias. */
+    className?: string;
+}
+/**
+ * Barra de botones de icono **anclada a un elemento**: aparece al pasar el
+ * puntero por él o al entrar el foco, y se pinta encima (pantallas estrechas)
+ * o en dos raíles a sus lados (escritorio). Es la barra de acciones de un
+ * bloque en un editor —mover, duplicar, borrar, convertir—.
+ *
+ * Es un `role="toolbar"` (Base UI Toolbar): **una sola parada de
+ * tabulación**, y dentro se recorre con las flechas (`roving tabindex`). Sigue
+ * en el orden de tabulación aunque no se vea, así que con teclado siempre se
+ * alcanza; al recibir el foco aparece.
+ *
+ * Reenvía `ref` y `{...rest}` al elemento ancla (el contenedor), no a la barra.
+ */
+export declare const FloatingToolbar: import("react").ForwardRefExoticComponent<FloatingToolbarProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface FloatingToolbarButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'className' | 'children' | 'aria-label'> {
+    /**
+     * Nombre de la acción. Es a la vez el `aria-label` del botón y el texto del
+     * bocadillo: un botón de solo icono no tiene otro nombre.
+     */
+    label: string;
+    /** El glifo (`<Icon … />`). Decorativo: el nombre lo da `label`. */
+    icon: ReactNode;
+    /** Pinta la acción en rojo (borrar). */
+    destructive?: boolean;
+    /** Se añade DESPUÉS de las clases propias del `Button`. */
+    className?: string;
+}
+/**
+ * Un botón de `FloatingToolbar`: `Button` `ghost` `sm` de solo icono, con su
+ * `Tooltip` y dentro del recorrido con flechas de la barra.
+ *
+ * Reenvía `ref` y `{...rest}` al `<button>`, así que sirve de `trigger` de un
+ * `Popover` o un `Menu` y de asa de arrastre (el `handleRef` de dnd-kit).
+ */
+export declare const FloatingToolbarButton: import("react").ForwardRefExoticComponent<FloatingToolbarButtonProps & import("react").RefAttributes<HTMLButtonElement>>;