@studiolxd/brand 49.28.0 → 51.0.0

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

@@ -1,8 +1,11 @@
 import { type ComponentPropsWithoutRef, type ReactNode } from 'react';
+import { type HeatmapDivergingDirection } from './heatmapScale';
 import './Heatmap.css';
-export type { HeatmapScale } from './heatmapScale';
+export type { HeatmapScale, HeatmapDivergingDirection, HeatmapDivergingStep, } from './heatmapScale';
+/** La rampa de la matriz: una magnitud (`sequential`) o una distancia a un centro (`diverging`). */
+export type HeatmapScaleKind = 'sequential' | 'diverging';
 /**
- * Los tres textos de la matriz, y los tres son **cromo**: cómo se llama la
+ * Los textos de la matriz, y todos son **cromo**: cómo se llama la
  * tabla, cómo se dice que una casilla no tiene dato y cómo se llama la
  * leyenda. Los nombres de filas y columnas son contenido, y los escribe quien
  * pasa los datos.
@@ -14,6 +17,14 @@ export interface HeatmapMessages {
     empty: string;
     /** Nombre accesible de la leyenda de la rampa. */
     scale: string;
+    /**
+     * Rótulo del centro en la leyenda de la escala divergente, con el valor ya
+     * formateado («Centro: 0»). **Opcional** en el tipo para que un catálogo
+     * anterior siga compilando; solo se lee con `scale="diverging"` y leyenda,
+     * y sin él ni `midpointLabel` sale el respaldo castellano, como cualquier
+     * clave ausente.
+     */
+    midpoint?: (value: string) => string;
 }
 /** Una fila: una persona, un puesto. */
 export interface HeatmapRow {
@@ -45,16 +56,36 @@ export interface HeatmapProps extends Omit<ComponentPropsWithoutRef<'div'>, 'chi
     columns: HeatmapColumn[];
     /** Las casillas con dato. Las que falten se pintan sin dato. */
     cells: HeatmapCell[];
-    /** Extremo bajo del dominio. Default 0. */
+    /**
+     * La rampa. `'sequential'` (default) pinta una magnitud, de menos a más;
+     * `'diverging'` pinta la distancia a `midpoint`, con un brazo cálido y uno
+     * frío de tres intensidades y el neutro en el centro.
+     */
+    scale?: HeatmapScaleKind;
+    /**
+     * Extremo bajo del dominio. En la secuencial, default 0. En la divergente
+     * no tiene default: si se pasa (él o `max`), el radio de los brazos es la
+     * mayor distancia de los extremos pasados al centro.
+     */
     min?: number;
     /**
      * Extremo alto del dominio. **Sin él sale del mayor valor de `cells`**, que
      * sirve para explorar pero hace que dos matrices del mismo panel no se
-     * puedan comparar: en cuanto haya dos, se pasa.
+     * puedan comparar: en cuanto haya dos, se pasa. En la divergente, sin `min`
+     * ni `max` el radio sale de la mayor |valor − centro| de las casillas.
      */
     max?: number;
-    /** Pasos de la rampa, de 2 a 6. Default 5. */
+    /** Pasos de la rampa secuencial, de 2 a 6. Default 5. La divergente siempre tiene siete. */
     steps?: number;
+    /** El centro de la escala divergente: el valor que se lee como «nada». Default 0. */
+    midpoint?: number;
+    /**
+     * Qué brazo pinta lo que queda por debajo del centro. Default
+     * `'warm-below'`: lo que se queda corto es cálido y lo que sobra, frío.
+     * `'warm-above'` lo invierte, para magnitudes en las que pasarse es lo que
+     * alarma.
+     */
+    divergingDirection?: HeatmapDivergingDirection;
     /** Encabezado de la columna de filas («Persona», «Puesto»). */
     rowHeader?: ReactNode;
     /** Pinta la cifra dentro de la celda. Default `true`. Con `false` sigue leyéndose. */
@@ -69,6 +100,12 @@ export interface HeatmapProps extends Omit<ComponentPropsWithoutRef<'div'>, 'chi
     minLabel?: ReactNode;
     /** Rótulo del extremo alto de la leyenda. Default: el máximo formateado. */
     maxLabel?: ReactNode;
+    /**
+     * Rótulo del centro en la leyenda divergente. **Sin él**, sale de
+     * `heatmap.midpoint` del catálogo con el centro formateado. Solo se lee con
+     * `scale="diverging"` y leyenda.
+     */
+    midpointLabel?: ReactNode;
     /**
      * Nombre accesible de la matriz. **Sin él**, sale de `heatmap.label` del
      * `BrandMessagesProvider`.

package/dist/_types/molecules/Heatmap/heatmapScale.d.ts

@@ -37,3 +37,53 @@ export declare function heatmapStep(value: number | null | undefined, scale: Hea
  * para que dos matrices con distinto número de pasos se lean igual de lejos.
  */
 export declare function heatmapRampIndex(step: number, steps: number): number;
+/**
+ * Los peldaños de la rampa divergente: tres por brazo y el neutro en medio.
+ * El nombre es el del token (`heatmap.diverging-<peldaño>-bg`).
+ */
+export type HeatmapDivergingStep = 'warm-3' | 'warm-2' | 'warm-1' | 'neutral' | 'cool-1' | 'cool-2' | 'cool-3';
+/** Intensidades por brazo de la rampa divergente. */
+export declare const HEATMAP_DIVERGING_ARM_STEPS = 3;
+/**
+ * Qué brazo pinta lo que queda **por debajo** del centro. Por defecto,
+ * `'warm-below'`: lo que se queda corto es cálido (cayena) y lo que sobra es
+ * frío (prusia). `'warm-above'` lo da la vuelta, para magnitudes en las que
+ * pasarse es lo que alarma (un retraso, un sobrecoste).
+ */
+export type HeatmapDivergingDirection = 'warm-below' | 'warm-above';
+/** El dominio de la escala divergente: el centro y cuánto se aleja de él. */
+export interface HeatmapDivergingScale {
+    /** El valor que se lee como «nada»: la meta, el cero de una diferencia. */
+    midpoint: number;
+    /**
+     * La distancia al centro que pinta el extremo de cada brazo. Los dos brazos
+     * comparten radio, así que la misma distancia pinta la misma intensidad a
+     * los dos lados.
+     */
+    radius: number;
+    direction?: HeatmapDivergingDirection;
+}
+/**
+ * El peldaño divergente que le toca a un valor. `null` es **sin dato**.
+ *
+ * El intervalo `[centro − radio, centro + radio]` se parte en **siete bandas
+ * iguales**, una por peldaño, como la secuencial parte el suyo en tantas
+ * bandas como pasos: la banda central —a menos de medio séptimo de diámetro
+ * del centro— es el neutro, y cada brazo tiene tres bandas más. Lo que se sale
+ * del radio se recorta contra el extremo. Con niveles enteros y un radio de 3
+ * (una brecha de −3 a +3), cada nivel cae en su peldaño: 0 es el neutro, ±1
+ * el primero de cada brazo y ±3 el extremo.
+ */
+export declare function heatmapDivergingStep(value: number | null | undefined, scale: HeatmapDivergingScale): HeatmapDivergingStep | null;
+/**
+ * Los siete peldaños en el orden en que se leen de izquierda a derecha, del
+ * valor más bajo al más alto: el orden de la leyenda.
+ */
+export declare function heatmapDivergingLegend(direction?: HeatmapDivergingDirection): HeatmapDivergingStep[];
+/**
+ * El radio de la escala divergente. Los extremos que se pasen (`min`, `max`)
+ * mandan: el radio es la mayor distancia de cualquiera de ellos al centro, y
+ * así dos matrices del mismo panel se comparan. **Sin ninguno, sale de los
+ * datos**: la mayor |valor − centro| de las casillas.
+ */
+export declare function heatmapDivergingRadius(midpoint: number, values: readonly (number | null)[], min?: number, max?: number): number;

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

@@ -53,7 +53,23 @@ export interface ImageCropDialogProps {
      */
     errorMessage?: string;
     onConfirm: (blob: Blob) => void | Promise<void>;
-    onClose: () => void;
+    /**
+     * Se llama cuando el diálogo pide cerrarse —`Cancelar`, el aspa, `Escape`,
+     * el velo, o tras confirmar— con `false`, como `onOpenChange` del resto de
+     * superposiciones del DS. El diálogo está abierto mientras `sourceUrl` no
+     * sea `null`: cerrarlo es devolverlo a `null`.
+     */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * @deprecated Usa `onOpenChange`. Sigue funcionando y avisa en desarrollo;
+     * se retira en la v52.
+     */
+    onClose?: () => void;
+    /**
+     * Se añade DESPUÉS de las clases propias (el consumidor añade, no sustituye).
+     * **Va al panel (su contenido, dentro del diálogo); 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;
 }
 /**
@@ -63,4 +79,4 @@ export interface ImageCropDialogProps {
  * `react-image-crop` aporta el gesto de selección; el DS pone el diálogo, las
  * acciones y el volcado a lienzo (`cropImageToBlob`).
  */
-export declare function ImageCropDialog({ sourceUrl, title, description, circularCrop, aspect, outputSize, outputMimeType, busy, cancelLabel, confirmLabel, closeLabel, loadingLabel, errorMessage, onConfirm, onClose, className, }: ImageCropDialogProps): import("react/jsx-runtime").JSX.Element;
+export declare function ImageCropDialog({ sourceUrl, title, description, circularCrop, aspect, outputSize, outputMimeType, busy, cancelLabel, confirmLabel, closeLabel, loadingLabel, errorMessage, onConfirm, onOpenChange, onClose, className, }: ImageCropDialogProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,5 +1,6 @@
 import { type ComponentPropsWithoutRef } from 'react';
 import './InputField.css';
+import { type FieldOptionalProps } from '../_shared/FieldShell';
 /**
  * El único texto que el campo emite por su cuenta: el nombre accesible del
  * aspa de borrado. Es cromo —dice la misma cosa en toda la suite—, así que
@@ -13,7 +14,7 @@ export interface InputFieldMessages {
     /** Nombre accesible del botón que vacía un campo de búsqueda. */
     clear: string;
 }
-export interface InputFieldProps extends Omit<ComponentPropsWithoutRef<'input'>, 'size' | 'type' | 'value' | 'defaultValue'> {
+export interface InputFieldProps extends Omit<ComponentPropsWithoutRef<'input'>, 'size' | 'type' | 'value' | 'defaultValue'>, FieldOptionalProps {
     id: string;
     label: string;
     /**

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

@@ -1,6 +1,7 @@
+import { type FieldOptionalProps } from '../_shared/FieldShell';
 import type { Country } from 'react-phone-number-input';
 import './InputPhoneField.css';
-export interface InputPhoneFieldProps {
+export interface InputPhoneFieldProps extends FieldOptionalProps {
     /** `id` del control. Si no se pasa, se genera con `useId`. */
     id?: string;
     label: string;

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

@@ -1,4 +1,4 @@
-import type { ReactNode } from 'react';
+import { type ReactNode } from 'react';
 import './LanguageSwitcher.css';
 /**
  * El único texto del selector, y es **cromo**: cómo se llama el control. Los
@@ -33,7 +33,7 @@ export interface LanguageSwitcherProps {
      * él, sale de `languageSwitcher.label` del `BrandMessagesProvider`.
      */
     label?: string;
-    /** `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;
     /** Oculta la etiqueta (visible por defecto: en el panel va con su nombre, como el de tema). */
     labelHidden?: boolean;
@@ -47,6 +47,10 @@ export interface LanguageSwitcherProps {
      * Sin él, la lista es de botones y usa `onChange`.
      */
     hrefFor?: (code: string) => string;
+    /**
+     * Enlace del router del producto; por defecto, un `<a>`. Recibe solo
+     * atributos de `<a>` y tiene que reenviarlos **todos** (`<Link {...props} />`).
+     */
     renderLink?: (props: LanguageSwitcherRenderLinkProps) => ReactNode;
     /**
      * Disposición de la etiqueta. `inline` (por defecto) la pone delante del
@@ -67,4 +71,4 @@ export interface LanguageSwitcherProps {
  * componente del sistema porque aparece en el menú y en el pie de todos los
  * sitios; el enrutado y la persistencia se quedan en el producto.
  */
-export declare function LanguageSwitcher({ languages, value, onChange, label, id, labelHidden, variant, layout, size, hrefFor, renderLink, className, }: LanguageSwitcherProps): import("react/jsx-runtime").JSX.Element;
+export declare function LanguageSwitcher({ languages, value, onChange, label, id: idProp, labelHidden, variant, layout, size, hrefFor, renderLink, className, }: LanguageSwitcherProps): import("react/jsx-runtime").JSX.Element;

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

@@ -25,29 +25,37 @@ export declare function LoadingRegion({ label, announce, children, className, ..
 export interface SkeletonTextProps {
     /** Líneas del párrafo; la última sale más corta. */
     lines?: number;
+    /** Se añade DESPUÉS de las clases propias (el consumidor añade, no sustituye). */
+    className?: string;
 }
 /** Un bloque de texto —un párrafo, una lista de definiciones— que aún no llegó. Decorativo. */
-export declare function SkeletonText({ lines }: SkeletonTextProps): import("react/jsx-runtime").JSX.Element;
+export declare function SkeletonText({ lines, className }: SkeletonTextProps): import("react/jsx-runtime").JSX.Element;
 export interface SkeletonListProps {
     /** Filas de la lista. */
     rows?: number;
+    /** Se añade DESPUÉS de las clases propias (el consumidor añade, no sustituye). */
+    className?: string;
 }
 /** Una lista que aún no llegó: una barra por fila, del alto de un control. Decorativo. */
-export declare function SkeletonList({ rows }: SkeletonListProps): import("react/jsx-runtime").JSX.Element;
+export declare function SkeletonList({ rows, className }: SkeletonListProps): import("react/jsx-runtime").JSX.Element;
 export interface SkeletonTableProps {
     /** Filas de cuerpo, sin contar la cabecera. */
     rows?: number;
+    /** Se añade DESPUÉS de las clases propias (el consumidor añade, no sustituye). */
+    className?: string;
 }
 /**
  * Una tabla que aún no llegó: la cabecera y sus filas. No calca el diseño —no
  * hace falta—, solo ocupa un sitio parecido. Decorativo.
  */
-export declare function SkeletonTable({ rows }: SkeletonTableProps): import("react/jsx-runtime").JSX.Element;
+export declare function SkeletonTable({ rows, className }: SkeletonTableProps): import("react/jsx-runtime").JSX.Element;
 export interface SkeletonGridProps {
     /** Columnas de la rejilla. */
     columns?: 2 | 3 | 4;
     /** Filas de la rejilla: se pintan `columns × rows` celdas. */
     rows?: number;
+    /** Se añade DESPUÉS de las clases propias (el consumidor añade, no sustituye). */
+    className?: string;
 }
 /** Una rejilla de tarjetas o miniaturas que aún no llegó. Decorativo. */
-export declare function SkeletonGrid({ columns, rows }: SkeletonGridProps): import("react/jsx-runtime").JSX.Element;
+export declare function SkeletonGrid({ columns, rows, className }: SkeletonGridProps): import("react/jsx-runtime").JSX.Element;

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

@@ -36,6 +36,11 @@ export interface MenuProps {
      * Pásalo solo para llevar la capa a otro sitio: gana siempre.
      */
     container?: HTMLElement | null;
+    /**
+     * Se añade DESPUÉS de las clases propias (el consumidor añade, no sustituye).
+     * **Va al panel; el disparador es tuyo y ya lleva tus clases**
+     * (regla de `className` en componentes con portal, CLAUDE.md § Base UI).
+     */
     className?: string;
 }
 /**

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

@@ -16,9 +16,21 @@ export interface ModalMessages {
     /** Nombre accesible del diálogo cuando no hay `title`. */
     fallbackTitle: string;
 }
-export interface ModalProps extends Omit<React.ComponentPropsWithoutRef<'div'>, 'title' | 'className'> {
+export interface ModalProps extends Omit<React.ComponentPropsWithoutRef<'div'>, 'title'> {
     open: boolean;
-    onClose: () => void;
+    /**
+     * Se llama cuando el diálogo pide abrirse o cerrarse (aspa, `Escape`, clic en
+     * el velo), con el estado al que quiere pasar — la misma firma que `Sheet`,
+     * `Popover` y el resto de superposiciones del DS. Un `Modal` controlado solo
+     * pide cerrarse, así que en la práctica llega siempre `false`.
+     */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * @deprecated Usa `onOpenChange` (`onOpenChange={(open) => { if (!open) cerrar(); }}`,
+     * o directamente `onOpenChange={setOpen}`). Sigue funcionando y avisa en
+     * desarrollo; se retira en la v52.
+     */
+    onClose?: () => void;
     title?: string;
     children: React.ReactNode;
     /**
@@ -73,6 +85,12 @@ export interface ModalProps extends Omit<React.ComponentPropsWithoutRef<'div'>,
     footer?: React.ReactNode;
     /** Se añade DESPUÉS de las clases propias del pie. */
     footerClassName?: string;
+    /**
+     * Se añade DESPUÉS de las clases propias del panel (`modal__content`), igual
+     * que en `Sheet`. Es un enganche para el producto (una prueba, una medida
+     * propia), no la vía de personalizar la cara del diálogo: eso va por tokens.
+     */
+    className?: string;
 }
 /**
  * Diálogo centrado sobre un velo. El motor (portal, velo, trampa de foco,
@@ -84,7 +102,7 @@ export interface ModalProps extends Omit<React.ComponentPropsWithoutRef<'div'>,
  * `onClick`/`onPointerDown` con `stopPropagation` en el propio popup— sin
  * envolverlo en `div`s de producto.
  *
- * `className` **no** se reenvía a propósito: la cara del diálogo la pone el
- * sistema, y se personaliza por tokens.
+ * `className` se concatena tras las clases propias del popup, como en `Sheet`.
+ * La cara del diálogo sigue personalizándose por tokens.
  */
-export declare function Modal({ open, onClose, title, children, closeLabel, fallbackTitle, container, description, 'aria-describedby': ariaDescribedBy, initialFocus, footer, footerClassName, ...rest }: ModalProps): import("react/jsx-runtime").JSX.Element;
+export declare function Modal({ open, onOpenChange, onClose, title, children, closeLabel, fallbackTitle, container, description, 'aria-describedby': ariaDescribedBy, initialFocus, footer, footerClassName, className, ...rest }: ModalProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,7 +1,8 @@
 import './MultiSelectField.css';
+import { type FieldOptionalProps } from '../_shared/FieldShell';
 import type { MultiSelectOption } from '../../atoms/MultiSelect/MultiSelect';
 export type { MultiSelectOption };
-export interface MultiSelectFieldProps {
+export interface MultiSelectFieldProps extends FieldOptionalProps {
     /** `id` del control. Si no se pasa, se genera con `useId`. */
     id?: string;
     label: string;
@@ -25,6 +26,8 @@ export interface MultiSelectFieldProps {
     name?: string;
     disabled?: boolean;
     readOnly?: boolean;
+    /** Obligatorio: `aria-required` en el `combobox` y `required` en el input oculto (ver `MultiSelect`). */
+    required?: boolean;
     /** Marca el control en error sin mensaje. Un `errorMessage` ya lo implica. */
     error?: boolean;
     /** Mensaje de error: se anuncia (`role="alert"`) y pone el control en error. */

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

@@ -124,7 +124,12 @@ export interface NotificationPanelProps {
     open?: boolean;
     defaultOpen?: boolean;
     onOpenChange?: (open: boolean, details: PopoverChangeDetails) => void;
-    /** Se añade DESPUÉS de las clases propias del panel (el consumidor añade, no sustituye). */
+    /**
+     * Va al **disparador** —la campana, el `NotificationButton` que pinta el
+     * propio componente y que se queda en su sitio—, no al panel (D65). Se añade
+     * DESPUÉS de las clases propias (el consumidor añade, no sustituye). El
+     * panel se personaliza con tokens.
+     */
     className?: string;
 }
 /**

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

@@ -1,7 +1,8 @@
 import { type ComponentPropsWithoutRef } from 'react';
 import './NumberInputField.css';
+import { type FieldOptionalProps } from '../_shared/FieldShell';
 import { type NumberInputCommitMode } from '../../atoms/NumberInput/NumberInput';
-export interface NumberInputFieldProps extends Omit<ComponentPropsWithoutRef<'input'>, 'size' | 'type' | 'value' | 'defaultValue' | 'onChange'> {
+export interface NumberInputFieldProps extends Omit<ComponentPropsWithoutRef<'input'>, 'size' | 'type' | 'value' | 'defaultValue' | 'onChange'>, FieldOptionalProps {
     /** `id` del control. Si no se pasa, se genera con `useId`. */
     id?: string;
     label: string;

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

@@ -33,5 +33,12 @@ export interface OrgSwitcherProps {
     defaultOpen?: boolean;
     items?: MenuItem[];
     renderLink?: (props: MenuRenderLinkProps) => ReactNode;
+    /**
+     * 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 OrgSwitcher({ label, block, compact, current, organizations, onOrgChange, defaultOpen, items, renderLink }: OrgSwitcherProps): import("react/jsx-runtime").JSX.Element;
+export declare function OrgSwitcher({ label, block, compact, current, organizations, onOrgChange, defaultOpen, items, renderLink, className }: OrgSwitcherProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,5 +1,6 @@
 import './OtpField.css';
-export interface OtpFieldProps {
+import { type FieldOptionalProps } from '../_shared/FieldShell';
+export interface OtpFieldProps extends FieldOptionalProps {
     /** `id` del control. Si no se pasa, se genera con `useId`. */
     id?: string;
     label: string;
@@ -17,6 +18,8 @@ export interface OtpFieldProps {
     name?: string;
     disabled?: boolean;
     readOnly?: boolean;
+    /** Obligatorio: `required` nativo en cada celda (ver `OtpInput`). */
+    required?: boolean;
     /** Marca el control en error sin mensaje. Un `errorMessage` ya lo implica. */
     error?: boolean;
     /** Mensaje de error: se anuncia (`role="alert"`) y pone el control en error. */

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

@@ -14,7 +14,7 @@ export interface PageIntroProps {
     title: ReactNode;
     /**
      * La frase bajo el título, opcional: va como entradilla (`Paragraph
-     * size="large"`, un peldaño por encima del cuerpo). Termina en punto (ver
+     * size="lg"`, un peldaño por encima del cuerpo). Termina en punto (ver
      * Foundations → Redacción). Lo que no llegue a frase, o cabe en el título,
      * o va en `children`.
      */

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

@@ -1,6 +1,15 @@
-import type { ComponentType, ReactNode } from 'react';
+import { type AnchorHTMLAttributes, type ComponentType, type ReactNode } from 'react';
 import type { SelectOption } from '../../atoms/Select/Select';
 import './Pagination.css';
+/**
+ * Lo que recibe `renderLink`: los atributos del `<a>` que pintaría el
+ * paginador. Hay que reenviarlos **todos** al enlace del router.
+ */
+export type PaginationRenderLinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {
+    href: string;
+    className: string;
+    children: ReactNode;
+};
 /**
  * Los textos que el paginador emite por su cuenta. Los nombres calcan el
  * espacio `pagination` del catálogo de la suite, así que montarlo es mapear
@@ -91,9 +100,19 @@ export interface PaginationProps {
     /** Mostrar "X resultados" antes de los controles. Default: false */
     showTotal?: boolean;
     /**
-     * Componente Link del router. Default: "a" (recarga completa).
-     * Acepta next/link, react-router Link, etc. — cualquier componente
-     * que acepte las props estándar de <a> (href, className, …).
+     * Pinta cada enlace del paginador con el `Link` del router:
+     * `renderLink={(props) => <Link {...props} />}`. Recibe todos los atributos
+     * del `<a>` (`href`, `className`, `aria-label`, `onClick`, `children`) y
+     * tiene que reenviarlos todos. Sin él, un `<a>` (recarga completa).
+     *
+     * Es una función: desde un Server Component no cruza al cliente. Ahí, o se
+     * monta el paginador en un fichero de cliente propio, o se navega con
+     * `<a>` (sin `renderLink`).
+     */
+    renderLink?: (props: PaginationRenderLinkProps) => ReactNode;
+    /**
+     * @deprecated Usa `renderLink` (`renderLink={(props) => <Link {...props} />}`).
+     * Sigue funcionando y avisa en desarrollo; se retira en la v52.
      */
     linkComponent?: ComponentType<any>;
     /** Tamaño del componente. Default: "md" */
@@ -102,6 +121,8 @@ export interface PaginationProps {
      * `aria-label` del `<nav>`. Sin default: cuando no se pasa, sale de
      * `pagination.label` del `BrandMessagesProvider`.
      */
+    'aria-label'?: string;
+    /** @deprecated Usa `aria-label`. Sigue funcionando y avisa en desarrollo; se retira en la v52. */
     ariaLabel?: string;
     /** `aria-label` de cada botón/enlace de página. Sin default: `pagination.goToPage`. */
     pageLabel?: (page: number) => string;
@@ -120,4 +141,4 @@ export interface PaginationProps {
     totalLabel?: (total: number) => string;
     className?: string;
 }
-export declare function Pagination({ mode, total, pageCount, page, pageSize, hrefs, previousHref, nextHref, onPrevious, onNext, onPageChange, hrefBuilder: hrefBuilderProp, linkComponent, onPageSizeChange, pageSizeOptions, afterPageSize, showTotal, size, ariaLabel, pageLabel, previousLabel, nextLabel, pagesGroupLabel, pageSizeLabel, totalLabel, className, }: PaginationProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function Pagination({ mode, total, pageCount, page, pageSize, hrefs, previousHref, nextHref, onPrevious, onNext, onPageChange, hrefBuilder: hrefBuilderProp, renderLink: renderLinkProp, linkComponent, onPageSizeChange, pageSizeOptions, afterPageSize, showTotal, size, 'aria-label': ariaLabelProp, ariaLabel: ariaLabelDeprecated, pageLabel, previousLabel, nextLabel, pagesGroupLabel, pageSizeLabel, totalLabel, className, }: PaginationProps): import("react/jsx-runtime").JSX.Element | null;

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

@@ -1,4 +1,5 @@
 import './PasswordField.css';
+import { type FieldOptionalProps } from '../_shared/FieldShell';
 /**
  * Los dos textos que el campo emite por su cuenta: las dos caras del
  * interruptor de mostrar/ocultar. Son cromo —dicen lo mismo en toda la
@@ -13,18 +14,25 @@ export interface PasswordFieldMessages {
     /** Nombre accesible del interruptor con la contraseña a la vista. */
     hide: string;
 }
-export interface PasswordFieldProps extends Omit<React.ComponentPropsWithoutRef<'input'>, 'size' | 'type'> {
+export interface PasswordFieldProps extends Omit<React.ComponentPropsWithoutRef<'input'>, 'size' | 'type'>, FieldOptionalProps {
     /**
      * Etiqueta del campo. **Opcional**: si se omite, el componente renderiza solo
-     * el campo + toggle (sin `<label>`, sin error ni ayuda), para componerlo
-     * dentro de una capa de formulario propia.
+     * el campo + toggle, sin `<label>`, para componerlo dentro de una capa de
+     * formulario propia (el error y la ayuda se pintan igual si se pasan).
      */
     label?: string;
-    /** Oculta visualmente el label (solo aplica cuando hay `label`). Default: true. */
+    /**
+     * Oculta la etiqueta a la vista (sigue leyéndola el lector de pantalla).
+     * Solo aplica cuando hay `label`. Por defecto `false`: la etiqueta se ve,
+     * como en `InputField`. Con la etiqueta oculta y sin `placeholder`, el
+     * control usa el texto de la etiqueta como placeholder para no quedarse sin
+     * pista visible. Sin valor, lo decide quien lo envuelva: dentro de un
+     * `FieldRow` que no es la primera de la lista, la etiqueta se oculta sola.
+     */
     labelHidden?: boolean;
     /** Marca el estado de error (borde) y `aria-invalid` en el input. */
     error?: boolean;
-    /** Mensaje de error propio del componente (solo se renderiza si hay `label`-mode completo). */
+    /** Mensaje de error propio del componente. Se pinta bajo el campo y se enlaza con `aria-describedby`, haya o no `label`. */
     errorMessage?: string;
     /** Texto de ayuda propio del componente. */
     helperText?: string;

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

@@ -1,5 +1,14 @@
-import type { ComponentType, MouseEvent, ReactNode } from 'react';
+import type { AnchorHTMLAttributes, ComponentType, MouseEvent, ReactNode } from 'react';
 import './PrevNextNav.css';
+/**
+ * Lo que recibe `renderLink`: los atributos del `<a>` que pintaría el
+ * control. Hay que reenviarlos **todos** al enlace del router.
+ */
+export type PrevNextNavRenderLinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {
+    href: string;
+    className: string;
+    children: ReactNode;
+};
 export interface PrevNextNavProps {
     /** href del enlace anterior. Mutuamente exclusivo con prevOnClick */
     prevHref?: string;
@@ -44,12 +53,21 @@ export interface PrevNextNavProps {
      */
     labelId?: string;
     /**
-     * Componente `Link` del router para los controles con `href`. Default: `"a"`.
-     * Recibe `href` y el resto de props tal cual.
+     * Pinta los controles con `href` con el `Link` del router:
+     * `renderLink={(props) => <Link {...props} />}`. Recibe todos los atributos
+     * del `<a>` (`href`, `className`, `aria-label`, `onClick`, `children`) y
+     * tiene que reenviarlos todos. Sin él, un `<a>`.
+     */
+    renderLink?: (props: PrevNextNavRenderLinkProps) => ReactNode;
+    /**
+     * @deprecated Usa `renderLink` (`renderLink={(props) => <Link {...props} />}`).
+     * Sigue funcionando y avisa en desarrollo; se retira en la v52.
      */
     linkComponent?: ComponentType<any>;
     /** Variante de densidad. Default: "md" */
     size?: 'sm' | 'md';
+    /** Se añade DESPUÉS de las clases propias (el consumidor añade, no sustituye). */
+    className?: string;
 }
 /**
  * Los dos textos del par, y los dos son **cromo**: «anterior» y «siguiente»
@@ -62,4 +80,4 @@ export interface PrevNextNavMessages {
     /** Rótulo del control siguiente. */
     next: string;
 }
-export declare function PrevNextNav({ prevHref, nextHref, prevOnClick, nextOnClick, prevLabel, nextLabel, prevTitle, nextTitle, label, labelId, linkComponent, size, }: PrevNextNavProps): import("react/jsx-runtime").JSX.Element;
+export declare function PrevNextNav({ prevHref, nextHref, prevOnClick, nextOnClick, prevLabel, nextLabel, prevTitle, nextTitle, label, labelId, renderLink: renderLinkProp, linkComponent, size, className, }: PrevNextNavProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,6 +1,6 @@
 import type { ReactNode } from 'react';
 import { type HeadingLevel, type HeadingSize } from '../../atoms/Heading/Heading';
-import { type TagVariant } from '../../atoms/Tag/Tag';
+import { type TagTone, type TagVariant } from '../../atoms/Tag/Tag';
 import type { CardMedia } from '../Card/Card';
 import './ProjectCard.css';
 /**
@@ -12,11 +12,17 @@ export interface ProjectCardMessages {
     /** Nombre accesible de la lista de etiquetas de categoría. */
     tags: string;
 }
-export type { TagVariant };
+export type { TagTone, TagVariant };
 export interface ProjectCardTag {
     /** Clave de React. Sin ella se usa la etiqueta. */
     id?: string;
     label: string;
+    /** Color de la etiqueta (el `tone` de `Tag`). Default `'neutral'`. */
+    tone?: TagTone;
+    /**
+     * @deprecated Usa `tone`. `variant: 'danger'` es `tone: 'error'`. Sigue
+     * funcionando, con un aviso en desarrollo, hasta la v52.
+     */
     variant?: TagVariant;
 }
 export interface ProjectCardProps {

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

@@ -3,6 +3,14 @@ import './RadioField.css';
 export interface RadioFieldProps extends Omit<ComponentPropsWithoutRef<'input'>, 'size' | 'type' | 'id'> {
     /** Texto de la opción, a la derecha de la marca. Acepta JSX (un enlace, por ejemplo). */
     label: ReactNode;
+    /**
+     * Oculta el texto de la opción **visualmente**, sin quitarlo del árbol de
+     * accesibilidad: el radio conserva su nombre. Misma prop que en
+     * `CheckboxField` y `SwitcherField`. Default: `false`.
+     * Sin valor, lo decide quien lo envuelva: dentro de un `FieldRow` que no
+     * es la primera de la lista, la etiqueta se oculta sola.
+     */
+    labelHidden?: boolean;
     /** `id` del control. Si no se pasa, se genera con `useId`. */
     id?: string;
     /** Talla del sistema. Sin ella, la del `Form` que lo envuelva; sin `Form`, `md`. */

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

@@ -10,7 +10,7 @@ export interface RecoveryCodesLabels {
     /**
      * Aviso del botón de copiar si el portapapeles falla (contexto no seguro,
      * permiso denegado). Opcional: sin él sale de `copy.error` del
-     * `BrandMessagesProvider`, y sin ninguno de los dos el componente lanza.
+     * `BrandMessagesProvider`, y sin ninguno de los dos, del castellano de respaldo.
      */
     error?: string;
 }