@studiolxd/brand 49.28.0 → 51.0.0

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

@@ -21,6 +21,8 @@ export interface OtpInputProps {
     onComplete?: (value: string) => void;
     disabled?: boolean;
     readOnly?: boolean;
+    /** Obligatorio: `required` nativo en cada celda — un código a medias no vale. */
+    required?: boolean;
     error?: boolean;
     size?: 'sm' | 'md' | 'lg';
     /** @deprecated Usa el atributo nativo `aria-describedby`. */

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

@@ -1,7 +1,19 @@
 import './Paragraph.css';
+/** Talla del párrafo: un peldaño por debajo del cuerpo (`sm`), el cuerpo (`md`) y uno por encima (`lg`). */
+export type ParagraphSize = 'sm' | 'md' | 'lg';
+/**
+ * @deprecated Usa `ParagraphSize`: `small` es `sm`, `default` es `md` y
+ * `large` es `lg` desde la v51 (las tallas del sistema se escriben `xs`…`4xl`,
+ * nunca con palabras). Se retira en la v52.
+ */
+export type ParagraphSizeDeprecated = 'small' | 'default' | 'large';
 export interface ParagraphProps extends Omit<React.ComponentPropsWithoutRef<'p'>, 'children'> {
-    /** Tamaño: `small` para notas y metadatos, `large` para entradillas. */
-    size?: 'small' | 'default' | 'large';
+    /**
+     * Talla: `sm` para notas y metadatos, `lg` para entradillas. Default `md`
+     * (el cuerpo). `small`, `default` y `large` son alias obsoletos que siguen
+     * funcionando, con un aviso en desarrollo, hasta la v52.
+     */
+    size?: ParagraphSize | ParagraphSizeDeprecated;
     children: React.ReactNode;
 }
 export declare const Paragraph: import("react").ForwardRefExoticComponent<ParagraphProps & import("react").RefAttributes<HTMLParagraphElement>>;

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

@@ -77,7 +77,11 @@ export interface PopoverProps {
      * Pásalo solo para llevar la capa a otro sitio: gana siempre.
      */
     container?: HTMLElement | null;
-    /** Clase adicional para el panel. */
+    /**
+     * 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/atoms/ProgressBar/ProgressBar.d.ts

@@ -8,13 +8,21 @@ export interface ProgressBarMessages {
     /** Nombre accesible de la barra cuando la pantalla no dice qué avanza. */
     label: string;
 }
-export type ProgressBarVariant = 'primary' | 'accent-1' | 'accent-2' | 'support-1' | 'support-2';
+/** Color del relleno. */
+export type ProgressBarTone = 'primary' | 'accent-1' | 'accent-2' | 'support-1' | 'support-2';
+/** @deprecated Usa `ProgressBarTone`: la prop de color se llama `tone` desde la v51. Se retira en la v52. */
+export type ProgressBarVariant = ProgressBarTone;
 export type ProgressBarSize = 'sm' | 'md' | 'lg';
 export interface ProgressBarProps {
     /** Porcentaje completado (0–100). Se acota al rango y se redondea al entero más cercano. */
     value: number;
-    /** Variante de color del relleno. */
-    variant?: ProgressBarVariant;
+    /** Color del relleno. Default `'primary'`. */
+    tone?: ProgressBarTone;
+    /**
+     * @deprecated Usa `tone`. Sigue funcionando, con un aviso en desarrollo,
+     * hasta la v52.
+     */
+    variant?: ProgressBarTone;
     /** Talla de la barra. En `sm` no se muestra la cifra. */
     size?: ProgressBarSize;
     /**
@@ -26,4 +34,4 @@ export interface ProgressBarProps {
     /** Clases adicionales para el contenedor. */
     className?: string;
 }
-export declare function ProgressBar({ value, variant, size, label, className, }: ProgressBarProps): import("react/jsx-runtime").JSX.Element;
+export declare function ProgressBar({ value, tone: toneProp, variant, size, label, className, }: ProgressBarProps): import("react/jsx-runtime").JSX.Element;

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/Sparkline/Sparkline.d.ts

@@ -25,6 +25,8 @@ export interface SparklineProps extends Omit<React.ComponentPropsWithoutRef<'svg
      * decorativa —lo correcto dentro de un `StatTile`, donde la cifra y su
      * variación ya dicen lo que la chispa enseña—.
      */
+    'aria-label'?: string;
+    /** @deprecated Usa `aria-label`. Sigue funcionando y avisa en desarrollo; se retira en la v52. */
     ariaLabel?: string;
     /** Se añade DESPUÉS de las clases propias. */
     className?: string;

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/StepMarker/StepMarker.d.ts

@@ -2,8 +2,13 @@ import { type IconName } from '../Icon/Icon';
 import './StepMarker.css';
 /** Estado del paso: decide si la marca va rellena o hueca y qué contenido lleva por defecto. */
 export type StepMarkerState = 'done' | 'current' | 'pending' | 'neutral';
-/** Color del relleno. Las mismas variantes que `NumberBadgeVariant`, mapeadas 1:1. */
-export type StepMarkerTone = 'primary' | 'accent-1' | 'accent-2' | 'support-1' | 'support-2' | 'danger' | 'success' | 'neutral';
+/** Color del relleno. Los mismos tonos que `NumberBadgeTone`, mapeados 1:1. */
+export type StepMarkerTone = 'primary' | 'accent-1' | 'accent-2' | 'support-1' | 'support-2' | 'error' | 'success' | 'neutral';
+/**
+ * @deprecated `danger` es `error` desde la v51 (el vocabulario de estado del
+ * sistema). Sigue funcionando, con un aviso en desarrollo, hasta la v52.
+ */
+export type StepMarkerToneDeprecated = 'danger';
 export type StepMarkerSize = 'sm' | 'md';
 export interface StepMarkerProps {
     /**
@@ -14,7 +19,7 @@ export interface StepMarkerProps {
      */
     state?: StepMarkerState;
     /** Color del relleno en los estados rellenos (`done`, `current`, `neutral`). Sin efecto en `pending`. Default `primary`. */
-    tone?: StepMarkerTone;
+    tone?: StepMarkerTone | StepMarkerToneDeprecated;
     /** Talla de la marca. Default `md` (32px, la de `Stepper`). */
     size?: StepMarkerSize;
     /** La cifra del paso. Se ignora si hay `icon` o si `state` es `done`. */
@@ -32,4 +37,4 @@ export interface StepMarkerProps {
  * Es puramente decorativa: `aria-hidden` siempre, porque la numeración
  * semántica la da el `<ol>` que la contiene, no la cifra pintada dentro.
  */
-export declare function StepMarker({ state, tone, size, count, icon, className }: StepMarkerProps): import("react/jsx-runtime").JSX.Element;
+export declare function StepMarker({ state, tone: toneProp, size, count, icon, className }: StepMarkerProps): import("react/jsx-runtime").JSX.Element;

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

@@ -1,7 +1,18 @@
 import './Tag.css';
-export type TagVariant = 'primary' | 'accent-1' | 'accent-2' | 'support-1' | 'support-2' | 'neutral' | 'info' | 'warning' | 'success' | 'danger';
+/** Color del tag: los de marca, `neutral` y los de feedback. */
+export type TagTone = 'primary' | 'accent-1' | 'accent-2' | 'support-1' | 'support-2' | 'neutral' | 'info' | 'warning' | 'success' | 'error';
+/**
+ * @deprecated Usa `TagTone`. La prop de color se llama `tone` desde la v51 y
+ * `danger` es `error` (el vocabulario de estado del sistema). Se retira en la v52.
+ */
+export type TagVariant = TagTone | 'danger';
 export interface TagProps extends React.ComponentPropsWithoutRef<'span'> {
-    /** Variante de color del tag. */
+    /** Color del 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;
 }
 /**

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

@@ -1,4 +1,6 @@
 import './Text.css';
+/** Intención de un fragmento de texto en línea. */
+export type TextTone = 'default' | 'muted' | 'error' | 'destructive' | 'success';
 export interface TextProps extends React.ComponentPropsWithoutRef<'span'> {
     /**
      * Qué elemento se pinta, que es lo mismo que decir **qué significa**:
@@ -7,11 +9,15 @@ export interface TextProps extends React.ComponentPropsWithoutRef<'span'> {
      */
     as?: 'span' | 'em' | 'strong' | 'del' | 's';
     /**
-     * Intención del fragmento. `destructive` es la palabra que dice que algo se
-     * pierde («esta acción **borra** el curso»); `success`, la que dice que salió
-     * bien; `muted`, una aclaración secundaria.
+     * Intención del fragmento. Mismo vocabulario que el resto del sistema:
+     * `error` para un **estado** que ha fallado («el cupón no es válido»),
+     * `destructive` para el aviso de una **acción** que hace perder algo («esta
+     * acción **borra** el curso», en la descripción de un `ConfirmDialog`
+     * destructivo); `success`, la que dice que salió bien; `muted`, una
+     * aclaración secundaria. `error` y `destructive` se pintan con la misma
+     * tinta: lo que cambia es lo que dicen.
      */
-    tone?: 'default' | 'muted' | 'destructive' | 'success';
+    tone?: TextTone;
     /**
      * Tacha el fragmento con una línea y lo atenúa (tinta secundaria): lo que ya
      * está hecho, como un producto que ya está en el carrito. Es **solo
@@ -40,7 +46,7 @@ export interface TextProps extends React.ComponentPropsWithoutRef<'span'> {
  *   producto.
  * - **Tachado** (`strikethrough`, o `as="del"`/`as="s"`): lo hecho o lo que ya
  *   no vale, en tinta atenuada.
- * - **Intención** (`tone`): énfasis con carga —destructiva o de logro— en tinta
+ * - **Intención** (`tone`): énfasis con carga —de error, destructiva o de logro— en tinta
  *   de feedback. Es color de texto sobre la superficie, **nunca un relleno**:
  *   una palabra resaltada dentro de un párrafo no lleva fondo.
  *

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

@@ -38,7 +38,12 @@ export interface TimeSelectProps {
     id?: string;
     /** Nombre del campo en el formulario: se monta un input oculto con `HH:MM`. */
     name?: string;
-    /** Campo obligatorio: se marca el grupo y los dos desplegables. */
+    /**
+     * Campo obligatorio: `required` en los dos desplegables, que es lo que
+     * valida el `<form>` y lo que les pone `aria-required` (un `combobox` sí lo
+     * admite). El grupo no lo lleva: ARIA 1.2 no admite `aria-required` en
+     * `role="group"` (D73).
+     */
     required?: boolean;
     /** Id de la etiqueta que nombra el grupo (lo pone el campo). */
     'aria-labelledby'?: string;

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

@@ -22,6 +22,15 @@ export interface ToggleBaseProps extends Omit<BaseToggleProps, 'onPressedChange'
      * `aria-label` o `aria-labelledby`: no hay texto que nombre el control.
      */
     iconOnly?: boolean;
+    /**
+     * Con `disabled`, el botón sigue en el orden de tabulación: deja el
+     * `disabled` nativo, se anuncia con `aria-disabled="true"`, conserva la cara
+     * de apagado (`data-disabled`) y no conmuta. Mismo contrato que en `Button`;
+     * `Tooltip` lo activa solo en su disparador deshabilitado.
+     *
+     * @default false
+     */
+    focusableWhenDisabled?: boolean;
     /** Se añade DESPUÉS de las clases propias. */
     className?: string;
 }

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

@@ -42,18 +42,12 @@ export interface TooltipProps extends Omit<React.HTMLAttributes<HTMLElement>, 'c
      */
     describe?: boolean;
     /**
-     * El disparador está **deshabilitado** y el bocadillo es justo lo que
-     * explica por qué. Un `button[disabled]` no sirve de disparador: el
-     * navegador no le manda eventos de puntero ni lo deja recibir foco, así que
-     * el bocadillo no se abre ni con el ratón ni con el teclado — y quien no
-     * puede pulsar es precisamente quien necesita leer el motivo.
-     *
-     * Con `disabledTrigger` el bocadillo se dispara desde un envoltorio
-     * focusable (`span.tooltip__trigger`, `tabIndex={0}`) que pone el propio
-     * componente: es él quien recibe hover, foco y el `aria-describedby`,
-     * mientras el control de dentro sigue deshabilitado de verdad. El CSS
-     * apaga los eventos de puntero del hijo deshabilitado para que el hover
-     * sobre el botón llegue al envoltorio en vez de perderse.
+     * @deprecated Ya no hace falta: con un disparador deshabilitado (`Button`,
+     * `CloseButton`, `DotsButton`, `CopyButton`, `Toggle` o un `<button>`
+     * nativo con `disabled`) el `Tooltip` le pide `focusableWhenDisabled` y el
+     * control, sin `disabled` nativo, recibe foco y puntero y se anuncia con
+     * `aria-disabled`. Sigue funcionando (para cualquier otro disparador cae en
+     * el envoltorio de siempre), avisa en desarrollo y se retira en la v52.
      *
      * @default false
      */
@@ -65,7 +59,11 @@ export interface TooltipProps extends Omit<React.HTMLAttributes<HTMLElement>, 'c
      * Pásalo solo para llevar la capa a otro sitio: gana siempre.
      */
     container?: HTMLElement | null;
-    /** Clase adicional para el **bocadillo** (no para el disparador). */
+    /**
+     * Se añade DESPUÉS de las clases propias (el consumidor añade, no sustituye).
+     * **Va al panel (el bocadillo); 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/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,20 @@
+import type { AnchorHTMLAttributes, ComponentType, ReactNode } 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;
+/**
+ * Puente del alias obsoleto `linkComponent` (v51, se retira en la v52) a
+ * `renderLink`: el componente `Link` del router recibe, tal cual, las props
+ * que recibiría el `renderLink`. Lo usan `Pagination`, `PrevNextNav` y
+ * `CalendarRoster` mientras conviven las dos formas.
+ */
+export declare function renderLinkFromComponent<P extends AnchorHTMLAttributes<HTMLAnchorElement>>(LinkComponent: ComponentType<P>): (props: P) => ReactNode;

package/dist/_types/constants/env.d.ts

@@ -1,7 +1,11 @@
+export declare function isDevelopment(): boolean;
+/** `console.warn` una sola vez por `key`, y solo en desarrollo. */
+export declare function warnOnce(key: string, message: string): void;
 /**
- * `process.env.NODE_ENV` sin depender de los tipos de `@types/node`: la
- * librería se distribuye para consumidores que no siempre los tienen en su
- * propio `tsconfig`, así que se lee a través de `globalThis` en vez de
- * asumir el global ambiental `process`.
+ * Aviso de API obsoleta (alias que se retira en el major siguiente), una vez
+ * por componente y prop: «`<Tag variant>` está obsoleta; usa `tone`. Se
+ * retira en la v52.»
  */
-export declare function isDevelopment(): boolean;
+export declare function warnDeprecated(component: string, old: string, replacement: string): void;
+/** Solo para tests: vacía el registro de avisos ya emitidos. */
+export declare function resetWarnings(): void;

package/dist/_types/constants/field-optional.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Si los campos de este formulario marcan solos lo opcional (D74). Lo reparte
+ * `Form markOptional`: todo `*Field` sin `required` pinta « (opcional)» tras
+ * la etiqueta, sin poner `optional` campo a campo. Mismo patrón que
+ * `FormSizeContext`: sin `Form` (o sin `markOptional`), `false`.
+ */
+export declare const FormMarkOptionalContext: import("react").Context<boolean>;
+/**
+ * Si un campo lleva la marca de opcional: lo que pide el consumidor por
+ * `optional` gana siempre —también `optional={false}`, que la apaga en un
+ * campo concreto—; si no dice nada, la lleva cuando el formulario la reparte
+ * y el campo no es `required`.
+ */
+export declare function useFieldOptional(optional: boolean | undefined, required: boolean | undefined): boolean;

package/dist/_types/constants/focusable-when-disabled.d.ts

@@ -0,0 +1,2 @@
+export declare function markFocusableWhenDisabled<T extends object>(component: T): T;
+export declare function supportsFocusableWhenDisabled(type: unknown): boolean;

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.