@studiolxd/brand 49.28.0 → 51.0.0

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

@@ -57,14 +57,37 @@ export interface RecurrenceFieldProps {
      * texto del catálogo, pásale `recurrenceField.legend`.
      */
     legend?: ReactNode;
+    /**
+     * Oculta la leyenda a la vista (sigue nombrando el grupo para el lector de
+     * pantalla): la `legendHidden` del `Fieldset`. Por defecto `false`. Sin
+     * valor, lo decide quien lo envuelva: dentro de un `FieldRow` que no es la
+     * primera de la lista, se oculta sola, como la etiqueta de los demás campos.
+     * Sin `legend` no hace nada.
+     */
+    labelHidden?: boolean;
     /** Deshabilita el editor entero. */
     disabled?: boolean;
+    /**
+     * Texto de ayuda del editor entero, bajo los campos. Describe el grupo
+     * (`aria-describedby` en el `fieldset`, o en el `role="group"` sin `legend`).
+     */
+    helperText?: string;
+    /**
+     * Mensaje de error del editor entero (una regla que no cuadra con el
+     * evento). Se anuncia (`role="alert"`) y describe el grupo, como la ayuda.
+     */
+    errorMessage?: string;
     /** Talla de los campos. Sin ella, la del contexto de formulario. */
     size?: 'sm' | 'md' | 'lg';
     /** Locale de los nombres de los días y del campo de fecha. Default `'es-ES'`. */
     locale?: string;
     /** Por dónde empieza la semana en los días. Default `'monday'`. */
     weekStartsOn?: 'monday' | 'sunday';
+    /**
+     * El «hoy» del calendario de la fecha de final. Default: la fecha actual.
+     * En SSR conviene pasarla (ver `Calendar`).
+     */
+    today?: Date;
     /** Tope inferior de la fecha de final. */
     minDate?: Date;
     /** Tope superior de la fecha de final. */
@@ -90,4 +113,4 @@ export interface RecurrenceFieldProps {
  * Es **controlado**, como el resto de campos del sistema: recibe `value` y
  * llama a `onValueChange` con el valor entero. `null` es «no se repite».
  */
-export declare function RecurrenceField({ value, onValueChange, id: idProp, legend, disabled, size, locale, weekStartsOn, minDate, maxDate, className, frequencyLabel, weekdaysLabel, endLabel, }: RecurrenceFieldProps): import("react/jsx-runtime").JSX.Element;
+export declare function RecurrenceField({ value, onValueChange, id: idProp, legend, labelHidden: labelHiddenProp, disabled, helperText, errorMessage, size, locale, weekStartsOn, minDate, maxDate, today, className, frequencyLabel, weekdaysLabel, endLabel, }: RecurrenceFieldProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,6 +1,7 @@
 import './SelectField.css';
+import { type FieldOptionalProps } from '../_shared/FieldShell';
 import type { SelectOptionOrGroup } from '../../atoms/Select/Select';
-export interface SelectFieldProps {
+export interface SelectFieldProps extends FieldOptionalProps {
     /** `id` del control. Si no se pasa, se genera con `useId`. */
     id?: string;
     label: string;

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

@@ -54,6 +54,11 @@ export interface SheetProps extends Omit<React.ComponentPropsWithoutRef<'div'>,
      * Sirve para desmontar el panel solo después de que haya salido de pantalla.
      */
     onAnimationEndCapture?: (event: React.AnimationEvent) => void;
+    /**
+     * Se añade DESPUÉS de las clases propias (el consumidor añade, no sustituye).
+     * **Va al panel; el disparador, si lo hay, es tuyo y ya lleva tus clases**
+     * (regla de `className` en componentes con portal, CLAUDE.md § Base UI).
+     */
     className?: string;
 }
 /**

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

@@ -1,4 +1,4 @@
-import type { ReactNode } from 'react';
+import { type ReactNode } from 'react';
 import './SidebarNav.css';
 export interface SidebarNavItem {
     id: string;
@@ -51,6 +51,14 @@ export interface SidebarNavProps {
      * `sidebarNav.empty`. Solo se lee cuando hay alguna entrada vacía.
      */
     emptyLabel?: string;
+    /**
+     * Nombre de una entrada vacía donde no cabe la marca aparte —el tooltip y
+     * el nombre accesible del modo rail, el rótulo del menú de un grupo—.
+     * Recibe el rótulo de la entrada y la marca de vacío ya resuelta. **Sin
+     * default**: sale de `sidebarNav.emptyEntry`. Solo se lee cuando hay alguna
+     * entrada vacía en esas formas.
+     */
+    emptyEntryLabel?: (label: string, empty: string) => string;
     /** Solo iconos: los enlaces con tooltip, los grupos como menú. Sin él, lo decide la `Sidebar` (rail). */
     rail?: boolean;
     entries: SidebarNavEntry[];
@@ -58,6 +66,8 @@ export interface SidebarNavProps {
     value?: string[];
     onValueChange?: (value: string[]) => void;
     renderLink?: (props: SidebarNavRenderLinkProps) => ReactNode;
+    /** Se añade DESPUÉS de las clases propias (el consumidor añade, no sustituye). */
+    className?: string;
 }
 /**
  * Los dos textos de la navegación, los dos **cromo**: el nombre de la región
@@ -70,5 +80,11 @@ export interface SidebarNavMessages {
     label: string;
     /** Marca de las entradas sin contenido. */
     empty: string;
+    /**
+     * Una entrada vacía nombrada en una sola cadena: «Guías — sin docs». Recibe
+     * el rótulo de la entrada y la marca de vacío; es función porque el orden y
+     * el separador son de cada idioma.
+     */
+    emptyEntry: (label: string, empty: string) => string;
 }
-export declare function SidebarNav({ label, emptyLabel, rail, entries, defaultValue, value, onValueChange, renderLink, }: SidebarNavProps): import("react/jsx-runtime").JSX.Element;
+export declare function SidebarNav({ label, emptyLabel, emptyEntryLabel, rail, entries, defaultValue, value, onValueChange, renderLink, className, }: SidebarNavProps): import("react/jsx-runtime").JSX.Element;

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

@@ -55,7 +55,10 @@ export interface SiteNavProps {
     groups: SiteNavGroup[];
     /** Nombre accesible del `nav`. */
     label?: string;
-    /** Enlace del router del producto; por defecto, un `<a>`. */
+    /**
+     * Enlace del router del producto; por defecto, un `<a>`. Recibe solo
+     * atributos de `<a>` y tiene que reenviarlos **todos** (`<Link {...props} />`).
+     */
     renderLink?: (props: SiteNavRenderLinkProps) => ReactNode;
     className?: string;
 }

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

@@ -2,6 +2,19 @@ import { type ComponentPropsWithoutRef, type ReactNode } from 'react';
 import './StatTile.css';
 export type StatTileDirection = 'up' | 'down' | 'flat';
 export type StatTileTone = 'positive' | 'negative' | 'neutral';
+/**
+ * Las tres direcciones del delta, que solo oye un lector de pantalla (la
+ * flecha es decorativa). Dicen hacia dónde se movió la cifra, no qué cifra
+ * es: valen igual en cualquier panel.
+ */
+export interface StatTileMessages {
+    /** La cifra ha subido. */
+    up: string;
+    /** La cifra ha bajado. */
+    down: string;
+    /** La cifra no se ha movido. */
+    flat: string;
+}
 export interface StatTileDelta {
     /** La variación, ya formateada: «+12 %», «−3», «igual». */
     value: ReactNode;
@@ -14,7 +27,8 @@ export interface StatTileDelta {
     tone?: StatTileTone;
     /**
      * Cómo se lee la dirección para un lector de pantalla, que no ve la flecha.
-     * Default castellano según `direction`.
+     * **Sin default**: sin él, sale de `statTile.up`, `statTile.down` o
+     * `statTile.flat` del `BrandMessagesProvider`, según `direction`.
      */
     label?: string;
 }

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

@@ -1,4 +1,4 @@
-import type { ReactNode } from 'react';
+import { type ReactNode } from 'react';
 import './Table.css';
 /**
  * Los textos que la tabla emite por su cuenta: el cromo de la cabecera —el
@@ -73,7 +73,12 @@ export interface TableRowProps extends Omit<React.HTMLAttributes<HTMLTableRowEle
     onClick?: () => void;
     /** Alternativa explícita a onClick para control manual */
     interactive?: boolean;
-    /** Marca la fila como seleccionada: se dice con tinta y peso, sin fondo. */
+    /**
+     * Marca la fila como seleccionada: **solo visual** (`table__row--selected`,
+     * tinta y peso, sin fondo). No emite `aria-selected`, que fuera de un
+     * `role="grid"` no es válido en una fila: el estado lo anuncia el control
+     * de la fila —normalmente una casilla, como en `DataTable`—.
+     */
     selected?: boolean;
     /**
      * Nombre accesible de la fila. Por defecto el rol `row` toma su nombre del

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

@@ -20,6 +20,8 @@ export interface TableOfContentsProps extends Omit<React.ComponentPropsWithoutRe
      * Nombre accesible del `nav`. **Sin default**: sin él, sale de
      * `tableOfContents.label` del `BrandMessagesProvider`.
      */
+    'aria-label'?: string;
+    /** @deprecated Usa `aria-label`. Sigue funcionando y avisa en desarrollo; se retira en la v52. */
     ariaLabel?: string;
     /** Rótulo visible sobre la lista. Sin él, no se pinta ninguno. */
     title?: string;
@@ -44,7 +46,7 @@ export interface TableOfContentsProps extends Omit<React.ComponentPropsWithoutRe
  * sigue al hash y para uno estático.
  *
  * `{...rest}` (`id`, `data-*`, `role`…) se reenvía al `<nav>`. El nombre
- * accesible sigue siendo `ariaLabel`.
+ * accesible es `aria-label`.
  */
 /**
  * El único texto que el índice dice por su cuenta, y es **cromo**: «En esta

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

@@ -1,6 +1,7 @@
 import { type ComponentPropsWithoutRef } from 'react';
 import './TextareaField.css';
-export interface TextareaFieldProps extends Omit<ComponentPropsWithoutRef<'textarea'>, 'value' | 'defaultValue' | 'rows'> {
+import { type FieldOptionalProps } from '../_shared/FieldShell';
+export interface TextareaFieldProps extends Omit<ComponentPropsWithoutRef<'textarea'>, 'value' | 'defaultValue' | 'rows'>, FieldOptionalProps {
     id: string;
     label: string;
     /**

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

@@ -1,19 +1,54 @@
 import './ThemeSwitcher.css';
 export type Theme = 'light' | 'dark' | 'system';
+/**
+ * El cromo del selector de tema: el nombre del control, los tres temas y la
+ * frase que nombra el botón de icono con el tema vigente. Todo es igual en
+ * cualquier pantalla de la suite, así que va al catálogo una sola vez.
+ */
+export interface ThemeSwitcherMessages {
+    /** Nombre del control: la etiqueta del compacto y el nombre del grupo en lista. */
+    group: string;
+    /** El tema claro. */
+    light: string;
+    /** El tema oscuro. */
+    dark: string;
+    /** El tema que sigue al sistema operativo. */
+    system: string;
+    /**
+     * Nombre accesible del botón de la variante `icon`, que solo enseña el
+     * icono del tema vigente: «Tema: Claro». Recibe el nombre del control y el
+     * del tema vigente, ya resueltos, y es función porque el orden y la
+     * puntuación de la frase son de cada idioma.
+     */
+    trigger: (group: string, theme: string) => string;
+}
+/**
+ * Anulaciones puntuales del catálogo, clave a clave. Las que no se pasen
+ * salen de `themeSwitcher.*` del `BrandMessagesProvider`.
+ */
 export interface ThemeSwitcherLabels {
-    /** Nombre accesible del control. */
+    /** Anulación puntual de `themeSwitcher.group`. */
     group?: string;
+    /** Anulación puntual de `themeSwitcher.light`. */
     light?: string;
+    /** Anulación puntual de `themeSwitcher.dark`. */
     dark?: string;
+    /** Anulación puntual de `themeSwitcher.system`. */
     system?: string;
+    /** Anulación puntual de `themeSwitcher.trigger`. */
+    trigger?: (group: string, theme: string) => string;
 }
 export interface ThemeSwitcherProps {
     /** Tema elegido. `system` sigue la preferencia del sistema operativo. */
     value: Theme;
     /** Cambio de tema. Aplicarlo (clase en `html`) y persistirlo es del producto. */
     onChange?: (theme: Theme) => void;
+    /**
+     * Textos del control, clave a clave. **Sin defaults**: los que no se pasen
+     * salen de `themeSwitcher.*` del `BrandMessagesProvider`.
+     */
     labels?: ThemeSwitcherLabels;
-    /** `id` del control en compacto (enlaza la etiqueta). */
+    /** `id` del control en compacto (enlaza la etiqueta). Por defecto, uno único por instancia (`useId`). */
     id?: string;
     /**
      * `compact`: un `DropdownField` (etiqueta + control rectangular) con el icono y el nombre del tema actual — el del panel.
@@ -39,4 +74,4 @@ export interface ThemeSwitcherProps {
  * opciones exclusivas; en lista, las opciones desplegadas para el pie. Aplicar el tema y
  * recordarlo es del producto; el componente solo muestra y elige.
  */
-export declare function ThemeSwitcher({ value, onChange, labels, id, variant, layout, size, className }: ThemeSwitcherProps): import("react/jsx-runtime").JSX.Element;
+export declare function ThemeSwitcher({ value, onChange, labels, id: idProp, variant, layout, size, className }: ThemeSwitcherProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,6 +1,7 @@
+import { type FieldOptionalProps } from '../_shared/FieldShell';
 import type { TimeValue } from '../../atoms/TimeSelect/TimeSelect';
 import './TimeField.css';
-export interface TimeFieldProps {
+export interface TimeFieldProps extends FieldOptionalProps {
     /** `id` del control. Si no se pasa, se genera con `useId`. */
     id?: string;
     label: string;

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

@@ -1,5 +1,5 @@
 import { type ComponentPropsWithoutRef, type ReactNode } from 'react';
-import { type StepMarkerTone } from '../../atoms/StepMarker/StepMarker';
+import { type StepMarkerTone, type StepMarkerToneDeprecated } from '../../atoms/StepMarker/StepMarker';
 import type { IconName } from '../../atoms/Icon/Icon';
 import './Timeline.css';
 /**
@@ -14,8 +14,11 @@ export interface TimelineMessages {
     /** Lo que se lee tras el título del hito vigente: «estado actual». */
     current: string;
 }
-/** El tono de la marca: los mismos ocho que `StepMarker`, sin traducción. */
-export type TimelineTone = StepMarkerTone;
+/**
+ * El tono de la marca: los mismos ocho que `StepMarker`, sin traducción. Admite
+ * todavía el obsoleto `danger` (hoy `error`), que la marca traduce y avisa.
+ */
+export type TimelineTone = StepMarkerTone | StepMarkerToneDeprecated;
 /** Un hito del historial: un cambio de estado, con su fecha y quien lo firmó. */
 export interface TimelineItem {
     id: string;

package/dist/_types/molecules/Toast/Toaster.d.ts

@@ -47,6 +47,14 @@ export interface ToasterProps {
  * Punto de montaje de los avisos efímeros. Se monta **una vez** en la raíz de la
  * aplicación; los avisos se lanzan desde cualquier sitio con `toast(...)`.
  *
+ * **Solo puede haber un `Toaster` montado a la vez.** La cola (`toastManager`)
+ * es un único objeto de módulo y el `Toaster` no la aísla: dos montados pintan
+ * cada aviso dos veces, el último que monta impone su `duration` a todos
+ * (`setToastDefaultDuration` escribe una variable global, la que usa un aviso
+ * actualizado por `id`) y los dos sincronizan la misma lista de avisos vivos de
+ * `toast.dismiss()`. Para otra posición u otra duración se cambian las props de
+ * ese único `Toaster` o se pasa `duration` al aviso.
+ *
  * La cara del aviso es la del `Alert` —mismo relleno, mismo borde, misma
  * tipografía y las mismas cuatro intenciones, sobre el juego de tokens
  * `alert.*`—; lo propio del toast es la capa, la posición, el apilado y el

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

@@ -30,5 +30,12 @@ export interface UserMenuProps {
     renderLink?: (props: MenuRenderLinkProps) => ReactNode;
     onOpenChange?: (open: boolean) => void;
     defaultOpen?: boolean;
+    /**
+     * Se añade DESPUÉS de las clases propias (el consumidor añade, no sustituye).
+     * **Va al disparador, que pinta el componente**: el panel sale por un
+     * portal y se personaliza con tokens (regla de `className` en componentes
+     * con portal, CLAUDE.md § Base UI).
+     */
+    className?: string;
 }
-export declare function UserMenu({ name, email, avatarUrl, notificationCount, items, label, compact, renderLink, onOpenChange, defaultOpen, }: UserMenuProps): import("react/jsx-runtime").JSX.Element;
+export declare function UserMenu({ name, email, avatarUrl, notificationCount, items, label, compact, renderLink, onOpenChange, defaultOpen, className, }: UserMenuProps): import("react/jsx-runtime").JSX.Element;

package/dist/_types/molecules/_shared/FieldShell.d.ts

@@ -0,0 +1,130 @@
+import { type HTMLAttributes, type ReactNode } from 'react';
+import type { FormSize } from '../../constants/form-size';
+/**
+ * El espacio `field` del catálogo: los textos que pinta el armazón común de
+ * los campos. Como todo el catálogo, opcional en `BrandMessages`: sin él
+ * la marca cae al castellano «(opcional)».
+ */
+export interface FieldMessages {
+    /** La marca tras la etiqueta de un campo `optional`. Castellano: «(opcional)». */
+    optional: string;
+    /**
+     * La descripción oculta que anuncia un campo obligatorio cuyo disparador es
+     * un botón, que no admite `aria-required` (D73): `ColorPickerField` y
+     * `DropdownField`. Castellano: «obligatorio».
+     */
+    required: string;
+}
+/**
+ * La marca de campo opcional (D70), común a todos los `*Field`. Se marca lo
+ * **opcional**, no lo obligatorio: en un formulario donde casi todo es
+ * obligatorio, lo que hay que señalar es la excepción. Es explícita —un campo
+ * sin `required` no la lleva sola—, porque un campo suelto (un buscador, un
+ * filtro) no es «opcional» de ningún formulario.
+ */
+export interface FieldOptionalProps {
+    /**
+     * Pinta « (opcional)» tras la etiqueta, en la tinta apagada de la etiqueta.
+     * Va dentro del `<label>`, así que el lector de pantalla la lee como parte
+     * del nombre del campo. No se combina con `required`. Sin valor, lo decide
+     * el `Form` que lo envuelva: con `markOptional`, todo campo sin `required`
+     * la lleva (D74); `optional={false}` la apaga en un campo concreto. Sin
+     * `Form markOptional`, por defecto `false`.
+     */
+    optional?: boolean;
+    /**
+     * Texto de la marca de opcional. **Sin default en la prop**: sin ella, sale
+     * de `field.optional` del `BrandMessagesProvider` y, si el catálogo no la
+     * trae, del castellano «(opcional)».
+     */
+    optionalLabel?: string;
+}
+/**
+ * Lo obligatorio de un campo cuyo disparador es un botón (D73). ARIA 1.2 no
+ * admite `aria-required` ni en `role="button"` ni en `role="group"`, así que
+ * lo obligatorio va en la **descripción** del disparador: un texto oculto
+ * («obligatorio») enlazado por su `aria-describedby`, detrás de la ayuda y el
+ * error. El `<form>` lo sigue validando el campo oculto con `required`.
+ */
+export interface FieldRequiredProps {
+    /**
+     * Texto que anuncia lo obligatorio. **Sin default en la prop**: sin ella,
+     * sale de `field.required` del `BrandMessagesProvider` y, si el catálogo no
+     * la trae, del castellano «obligatorio». Solo se lee con `required`.
+     */
+    requiredLabel?: string;
+}
+/** El `id` del texto oculto de obligatorio de un control. */
+export declare function requiredTextId(controlId: string): string;
+/**
+ * El texto oculto «obligatorio» al que apunta el `aria-describedby` del
+ * disparador (ver `FieldRequiredProps`). Se pinta solo con `required`.
+ */
+export declare function FieldRequiredText({ id, label }: {
+    id: string;
+    label?: string;
+}): import("react/jsx-runtime").JSX.Element;
+/** Une ids para un `aria-*` de referencias; sin ninguno, `undefined` (no un atributo vacío). */
+export declare function joinIds(...ids: Array<string | false | null | undefined>): string | undefined;
+export interface FieldShellOptions {
+    /** `id` del control. Sin él, uno de `useId`. */
+    id?: string;
+    /** Error sin mensaje. Un `errorMessage` ya lo implica. */
+    error?: boolean;
+    errorMessage?: string;
+    helperText?: string;
+    /** `aria-describedby` que trae el consumidor: se suma detrás de los propios. */
+    describedBy?: string;
+}
+export interface FieldShellState {
+    /** `id` del control (el del consumidor o uno generado). */
+    id: string;
+    /** `id` de la etiqueta, para los controles que se nombran por `aria-labelledby`. */
+    labelId: string;
+    errorId?: string;
+    helperId?: string;
+    /** Lo que va en el `aria-describedby` del control. */
+    describedBy?: string;
+    /** Error con o sin mensaje: lo que pone el control en error. */
+    hasError: boolean;
+    errorMessage?: string;
+    helperText?: string;
+}
+export declare function useFieldShell({ id: idProp, error, errorMessage, helperText, describedBy }: FieldShellOptions): FieldShellState;
+export interface FieldShellProps {
+    /** El estado de `useFieldShell`. */
+    field: FieldShellState;
+    /** Bloque BEM del campo (`input-field`): clase raíz y prefijo de `__helper`/`__label`/`__control`. */
+    block: string;
+    /** Clases de modificador ya formadas (`checkbox-field--sm`); los falsos se descartan. */
+    modifiers?: Array<string | false | null | undefined>;
+    /** Se añade DESPUÉS de las clases propias. */
+    className?: string;
+    /** Talla de la etiqueta (`stack`). */
+    size?: FormSize;
+    /** Texto de la etiqueta. Sin él no se pinta etiqueta (el control se nombra por otra vía). */
+    label?: ReactNode;
+    /** Marca de campo opcional tras la etiqueta (ver `FieldOptionalProps`). */
+    optional?: boolean;
+    /** Texto de la marca; sin él, `field.optional` del catálogo o «(opcional)». */
+    optionalLabel?: string;
+    /** Etiqueta oculta a la vista, presente para el lector de pantalla. */
+    labelHidden?: boolean;
+    /**
+     * - `stack` (por defecto): `Label` encima del control.
+     * - `inline`: un `<label>` (`__control`) envuelve el control y, a su derecha,
+     *   el texto (`__label`): casilla, radio, interruptor.
+     */
+    layout?: 'stack' | 'inline';
+    /** A qué apunta el `htmlFor` de la etiqueta. Default: `field.id`. */
+    labelFor?: string;
+    /** La etiqueta lleva `id` (`field.labelId`) para que la apunte un `aria-labelledby`. */
+    labelIdentified?: boolean;
+    /** Atributos del contenedor (el `role="group"` de un editor compuesto). */
+    rootProps?: HTMLAttributes<HTMLDivElement>;
+    /** El control (y lo que vaya pegado a él). */
+    children: ReactNode;
+    /** Lo que va tras la ayuda: la acción de `PasswordField`. */
+    footer?: ReactNode;
+}
+export declare function FieldShell({ field, block, modifiers, className, size, label, optional, optionalLabel, labelHidden, layout, labelFor, labelIdentified, rootProps, children, footer, }: FieldShellProps): import("react/jsx-runtime").JSX.Element;

package/dist/_types/molecules/_shared/calendarGrid.d.ts

@@ -93,6 +93,15 @@ export interface CalendarMonthNavOptions {
  * sin mover el foco.
  */
 export declare function renderCalendarMonthNav({ block, title, titleId, navigable, previousLabel, nextLabel, prevDisabled, nextDisabled, onPrev, onNext, chevronSize, onTitleClick, titleExpanded, titleRef, children, }: CalendarMonthNavOptions): import("react/jsx-runtime").JSX.Element;
+/**
+ * El «hoy» de un calendario: el que pasa el consumidor o, sin él, la fecha
+ * actual **calculada una vez por montaje** —no en cada render—. En SSR el
+ * servidor y el navegador calculan cada uno el suyo, y alrededor de la
+ * medianoche (o con husos distintos) no coinciden: React avisa de un
+ * desajuste de hidratación. Para evitarlo, la app pasa `today` desde el
+ * servidor a los dos lados.
+ */
+export declare function useToday(today?: Date): Date;
 export interface UseCalendarGridNavigationOptions {
     /** Mes visible */
     month: Date;
@@ -100,6 +109,8 @@ export interface UseCalendarGridNavigationOptions {
     onMonthChange: (month: Date) => void;
     /** Fecha seleccionada, si la hay: es la primera candidata a llevar el tabindex */
     selected?: Date | null;
+    /** El «hoy» del calendario (`useToday`): segundo candidato al tabindex. */
+    today: Date;
     /**
      * Activación de la celda enfocada con Enter/Espacio. Solo para rejillas cuya
      * celda no es un `<button>` (que ya lo resuelve el navegador).
@@ -126,12 +137,14 @@ export interface CalendarGridNavigation {
  * moverse de día, Inicio/Fin dentro de la semana, RePág/AvPág de mes y con
  * Mayús de año.
  */
-export declare function useCalendarGridNavigation({ month, onMonthChange, selected, onActivate, minDate, maxDate, }: UseCalendarGridNavigationOptions): CalendarGridNavigation;
+export declare function useCalendarGridNavigation({ month, onMonthChange, selected, today, onActivate, minDate, maxDate, }: UseCalendarGridNavigationOptions): CalendarGridNavigation;
 export interface UseCalendarWeekNavigationOptions {
     /** Lunes de la semana visible */
     weekStart: Date;
     /** Se llama cuando el teclado saca el foco fuera de la semana visible */
     onWeekChange: (weekStart: Date) => void;
+    /** El «hoy» del calendario (`useToday`): candidato al tabindex de la semana. */
+    today: Date;
     /** Activación de la columna enfocada con Enter/Espacio */
     onActivate?: (date: Date) => void;
     minDate?: Date;
@@ -147,4 +160,4 @@ export interface UseCalendarWeekNavigationOptions {
  * fila de celdas, así que arriba y abajo no llevan a ninguna otra parte y se
  * quedan recorriendo los días, como ↑/↓ en una lista.
  */
-export declare function useCalendarWeekNavigation({ weekStart, onWeekChange, onActivate, minDate, maxDate, }: UseCalendarWeekNavigationOptions): CalendarGridNavigation;
+export declare function useCalendarWeekNavigation({ weekStart, onWeekChange, today, onActivate, minDate, maxDate, }: UseCalendarWeekNavigationOptions): CalendarGridNavigation;

package/dist/_types/molecules/_shared/dialogSurface.d.ts

@@ -19,7 +19,12 @@ export interface DialogHeaderProps {
     className: string;
     children: ReactNode;
 }
-/** Cabecera del diálogo, en una de sus dos colocaciones. */
+/**
+ * Cabecera del diálogo, en una de sus dos colocaciones. Es un `<div>`, no un
+ * `<header>`: el diálogo sale por un portal al `<body>`, fuera de cualquier
+ * `<main>`/`<section>`, y ahí un `<header>` es un `banner` — el segundo de la
+ * página, junto al de la aplicación. El diálogo ya se nombra por su título.
+ */
 export declare function DialogHeader({ layout, noTitle, className, children }: DialogHeaderProps): import("react/jsx-runtime").JSX.Element;
 /**
  * Pie de acciones. Fila a la derecha; por debajo del punto de ruptura, botones

package/dist/_types/molecules/_shared/dropdownItems.d.ts

@@ -68,8 +68,6 @@ export type MenuRenderLinkProps = React.AnchorHTMLAttributes<HTMLAnchorElement>
     children: ReactNode;
     className: string;
 };
-/** Reenvía TODO lo que inyecta Base UI: un renderLink que solo copie href/className rompe el menú. */
-export declare function defaultRenderLink({ children, ...props }: MenuRenderLinkProps): import("react/jsx-runtime").JSX.Element;
 interface RenderDropdownItemsOptions {
     items: MenuItem[];
     itemClass: (destructive?: boolean) => string;

package/dist/_types/molecules/_shared/requiredInput.d.ts

@@ -0,0 +1,8 @@
+export interface RequiredInputProps {
+    name?: string;
+    value: string;
+    required?: boolean;
+    /** El control al que se devuelve el foco cuando el navegador lo pide para avisar. */
+    focusTarget?: () => HTMLElement | null | undefined;
+}
+export declare function RequiredInput({ name, value, required, focusTarget }: RequiredInputProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -68,8 +68,9 @@ export interface AnnotationThreadProps extends React.ComponentPropsWithoutRef<'a
     replies?: AnnotationEntry[];
     /**
      * Estado del hilo, en orden de flujo. `open` pide atención; `acknowledged`
-     * es el hilo que alguien ya ha mirado y da un paso atrás sin cerrarse;
-     * `resolved` se retira visualmente sin desaparecer.
+     * es el hilo que alguien ya ha mirado, sin cerrarse; `resolved` está
+     * cerrado. Lo dice la etiqueta de estado que abre el hilo: el hilo se lee
+     * a contraste pleno en los tres.
      */
     status?: AnnotationThreadStatus;
     /**

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

@@ -55,7 +55,7 @@ export interface DataTableServerPagination {
 /** Etiquetas accesibles que la tabla reenvía a sus cabeceras ordenables. */
 export type DataTableHeaderLabels = Pick<TableHeaderProps, 'actionsLabel' | 'sortedAscLabel' | 'sortedDescLabel' | 'sortableLabel'>;
 /** Etiquetas accesibles que la tabla reenvía a su paginación. */
-export type DataTablePaginationLabels = Pick<PaginationProps, 'ariaLabel' | 'pageLabel' | 'previousLabel' | 'nextLabel' | 'pagesGroupLabel' | 'pageSizeLabel' | 'totalLabel' | 'pageSizeOptions'>;
+export type DataTablePaginationLabels = Pick<PaginationProps, 'aria-label' | 'ariaLabel' | 'pageLabel' | 'previousLabel' | 'nextLabel' | 'pagesGroupLabel' | 'pageSizeLabel' | 'totalLabel' | 'pageSizeOptions'>;
 export interface DataTableProps<TData, TValue> {
     columns: ColumnDef<TData, TValue>[];
     data: TData[];

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

@@ -21,6 +21,11 @@ export interface PlanningGridMessages {
     remaining: string;
     /** Lo que se lee tras un resto negativo: hay más horas asignadas que disponibles. */
     over: string;
+    /**
+     * Lo que anuncia la marca de guardado de un cruce en vuelo («Guardando…»).
+     * **Opcional**: un catálogo sin ella compila, y la rejilla cae al castellano.
+     */
+    saving?: string;
 }
 /** Una fila: un proyecto, una persona. Lo que se planifica. */
 export interface PlanningGridRow {
@@ -56,7 +61,7 @@ export interface PlanningGridCell {
     value: number | null;
     /** Este cruce en concreto no se edita. */
     readOnly?: boolean;
-    /** El cambio está en vuelo: la celda se atenúa. */
+    /** El cambio está en vuelo: la cifra sigue a contraste pleno y la celda lleva una marca de guardado (un `Spinner` pequeño). */
     pending?: boolean;
     /** Lo que falló al guardar este cruce. Pone el campo en error y se anuncia. */
     error?: string;
@@ -103,6 +108,12 @@ export interface PlanningGridProps extends Omit<ComponentPropsWithoutRef<'div'>,
     label?: string;
     /** Nombre accesible del campo de un cruce. Sin él, sale de `planningGrid.cellLabel`. */
     cellLabel?: (row: string, column: string) => string;
+    /**
+     * Lo que anuncia la marca de guardado de un cruce en vuelo. Sin ella, sale
+     * de `planningGrid.saving` del catálogo y, si el catálogo no la trae, del
+     * default castellano «Guardando…». Solo se lee cuando hay un cruce en vuelo.
+     */
+    savingLabel?: string;
 }
 /**
  * La rejilla editable de horas: fila × columna —persona por semana, proyecto

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

@@ -1,7 +1,7 @@
 import { type ReactNode } from 'react';
 import { type HeadingLevel, type HeadingSize } from '../../atoms/Heading/Heading';
 import { type IconName } from '../../atoms/Icon/Icon';
-import { type StepMarkerTone } from '../../atoms/StepMarker/StepMarker';
+import { type StepMarkerTone, type StepMarkerToneDeprecated } from '../../atoms/StepMarker/StepMarker';
 import './Steps.css';
 export interface StepItem {
     /** Clave de React. Sin ella se usa la posición. */
@@ -23,9 +23,9 @@ export interface StepsProps {
     /** Uno debajo de otro (por defecto) o en fila. */
     orientation?: 'vertical' | 'horizontal';
     /** Color de la marca. Por defecto `primary`. */
-    tone?: StepMarkerTone;
+    tone?: StepMarkerTone | StepMarkerToneDeprecated;
     /** @deprecated Usar `tone`. Se mantiene como alias por compatibilidad. */
-    badgeVariant?: StepMarkerTone;
+    badgeVariant?: StepMarkerTone | StepMarkerToneDeprecated;
     /** Nivel semántico del título de cada paso. Por defecto `3`. */
     titleLevel?: HeadingLevel;
     /** Talla del título de cada paso. Por defecto `1` (14px, la de la etiqueta de `Stepper`). */

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

@@ -57,6 +57,8 @@ export interface AppHeaderProps {
     menuCloseLabel?: string;
     /** id de la sidebar que gobierna el botón (`aria-controls`). */
     sidebarId?: string;
+    /** Se añade DESPUÉS de las clases propias (el consumidor añade, no sustituye). */
+    className?: string;
 }
 /**
  * La barra superior de la aplicación, en todos los anchos. A la izquierda el
@@ -64,4 +66,4 @@ export interface AppHeaderProps {
  * escritorio; a la derecha, notificaciones y cuenta. Entre medias, lo que la
  * página necesite. Con `logo`, la marca del producto va justo tras el botón.
  */
-export declare function AppHeader({ logo, logoHref, logoLabel, renderLogoLink, start, notifications, end, menuLabel, menuCloseLabel, sidebarId, }: AppHeaderProps): import("react/jsx-runtime").JSX.Element;
+export declare function AppHeader({ logo, logoHref, logoLabel, renderLogoLink, start, notifications, end, menuLabel, menuCloseLabel, sidebarId, className, }: AppHeaderProps): import("react/jsx-runtime").JSX.Element;