@studiolxd/brand 50.0.0 → 51.0.0

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/constants/default-render-link.d.ts

@@ -1,4 +1,4 @@
-import type { AnchorHTMLAttributes } from 'react';
+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
@@ -11,3 +11,10 @@ import type { AnchorHTMLAttributes } from 'react';
  * 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/messages/BrandMessages.d.ts

@@ -63,6 +63,7 @@ import type { HeatmapMessages } from '../molecules/Heatmap/Heatmap';
 import type { OrgChartMessages } from '../organisms/OrgChart/OrgChart';
 import type { PlanningGridMessages } from '../organisms/PlanningGrid/PlanningGrid';
 import type { RecurrenceFieldMessages } from '../molecules/RecurrenceField/RecurrenceField';
+import type { FieldMessages } from '../molecules/_shared/FieldShell';
 import type { TimelineMessages } from '../molecules/Timeline/Timeline';
 import type { UptimeBarsMessages } from '../molecules/UptimeBars/UptimeBars';
 import type { ChartMessages } from '../organisms/Chart/Chart';
@@ -87,8 +88,7 @@ import type { ConnectorSignInMessages } from '../templates/ConnectorAuth/Connect
 import type { ConnectorExternalSignInMessages } from '../templates/ConnectorAuth/ConnectorExternalSignInPage';
 import type { ConnectorRejectionMessages } from '../templates/ConnectorAuth/ConnectorRejectionPage';
 /**
- * El contrato de textos de la librería: un espacio por componente, y dentro
- * de cada espacio **todas las claves obligatorias**.
+ * La forma de los textos de la librería: un espacio por componente.
  *
  * El tipo nace aquí, en el DS, y es el catálogo de la aplicación el que lo
  * satisface — nunca al revés. Si el tipo se generase desde el JSON de una
@@ -103,11 +103,17 @@ import type { ConnectorRejectionMessages } from '../templates/ConnectorAuth/Conn
  *
  * Cada interfaz de espacio vive **junto a su componente** (como
  * `RecoveryCodesLabels`), no aquí: aquí solo se ensamblan. Un componente que
- * gana textos declara su interfaz al lado de sus props y añade una línea a
- * este tipo; a partir de ese momento, una aplicación que no la rellene no
- * compila.
+ * gana textos declara su interfaz al lado de sus props, añade una línea a
+ * esta forma y su castellano en `es/<espacio>.ts`.
+ *
+ * De esta forma salen los dos tipos que se publican (D5):
+ * - `BrandMessages`, **todo opcional** (espacios y claves): lo que acepta el
+ *   proveedor. Lo que falte sale en castellano, con un aviso en desarrollo.
+ * - `CompleteBrandMessages`, **todo obligatorio**: el modo estricto, para la
+ *   app que quiere que olvidar un texto sea un error de compilación
+ *   (`satisfies CompleteBrandMessages`).
  */
-export interface BrandMessages {
+interface BrandMessagesShape {
     pagination: PaginationMessages;
     table: TableMessages;
     dataTable: DataTableMessages;
@@ -146,13 +152,7 @@ export interface BrandMessages {
     menuButton: MenuButtonMessages;
     appRoot: AppRootMessages;
     appShell: AppShellMessages;
-    /**
-     * **Opcional** (desde v49.23.1): solo lo lee el `AppHeader` cuando lleva
-     * `logo` y no recibe `logoLabel`. En v49.23.0 entró obligatorio y rompía la
-     * compilación de catálogos que no usan el logo. Si un `AppHeader` lo
-     * necesita y falta, lanza como cualquier otra clave ausente.
-     */
-    appHeader?: AppHeaderMessages;
+    appHeader: AppHeaderMessages;
     sidebar: SidebarMessages;
     sidebarNav: SidebarNavMessages;
     siteNav: SiteNavMessages;
@@ -179,6 +179,8 @@ export interface BrandMessages {
     orgChart: OrgChartMessages;
     planningGrid: PlanningGridMessages;
     recurrenceField: RecurrenceFieldMessages;
+    /** La marca de los campos `optional` (el armazón común de los `*Field`). */
+    field: FieldMessages;
     timeline: TimelineMessages;
     uptimeBars: UptimeBarsMessages;
     chart: ChartMessages;
@@ -203,4 +205,41 @@ export interface BrandMessages {
     connectorExternalSignIn: ConnectorExternalSignInMessages;
     connectorRejection: ConnectorRejectionMessages;
 }
-export type { PaginationMessages, TableMessages, DataTableMessages, InputFieldMessages, PasswordFieldMessages, SelectMessages, MultiSelectMessages, NumberInputMessages, OtpInputMessages, InputPhoneMessages, AsyncSelectMessages, AsyncMultiSelectMessages, DocsSearchMessages, SearchFormMessages, SiteSearchMessages, FilterBarMessages, CalendarMessages, DatePickerMessages, ColorPickerMessages, TimeSelectMessages, FileUploadMessages, ImageCropDialogMessages, AvatarUploadMessages, ModalMessages, SheetMessages, ConfirmDialogMessages, AlertMessages, BannerMessages, ToasterMessages, ConsentMessages, CommandPaletteMessages, AppLauncherMessages, FloatingDockMessages, NotificationButtonMessages, NotificationPanelMessages, MenuButtonMessages, AppRootMessages, AppShellMessages, AppHeaderMessages, SidebarMessages, SidebarNavMessages, SiteNavMessages, SiteHeaderMessages, UserMenuMessages, OrgSwitcherMessages, BreadcrumbMessages, TableOfContentsMessages, PrevNextNavMessages, PublicPageShellMessages, OnboardingShellMessages, CopyMessages, CodeBlockMessages, DotsButtonMessages, CloseButtonMessages, ThemeSwitcherMessages, StatTileMessages, ProgressBarMessages, SpinnerMessages, SliderMessages, TreeViewMessages, ClockWidgetMessages, HeatmapMessages, OrgChartMessages, PlanningGridMessages, RecurrenceFieldMessages, TimelineMessages, UptimeBarsMessages, ChartMessages, StepperMessages, CarouselMessages, LanguageSwitcherMessages, ProjectCardMessages, LegalFooterMessages, CalendarRosterMessages, CalendarPlannerMessages, NotificationListMessages, MessageComposerMessages, ConversationListMessages, ConversationThreadMessages, TypingIndicatorMessages, AnnotationThreadMessages, ChatShellMessages, UntrustedTextMessages, ConnectorRequestSummaryMessages, ConnectorConsentMessages, ConnectorSignInMessages, ConnectorExternalSignInMessages, ConnectorRejectionMessages, };
+/**
+ * Lo que no se abre al volver opcional o obligatorio un texto: una plantilla
+ * (función) y una tupla (`untrustedText.quotes`) son un valor entero.
+ */
+type MessageLeaf = ((...args: never[]) => unknown) | readonly unknown[];
+/** Todas las claves opcionales, a cualquier profundidad. */
+export type DeepPartialMessages<T> = T extends MessageLeaf ? T : T extends object ? {
+    [K in keyof T]?: DeepPartialMessages<T[K]>;
+} : T;
+/** Todas las claves obligatorias, a cualquier profundidad. */
+export type DeepRequiredMessages<T> = T extends MessageLeaf ? T : T extends object ? {
+    [K in keyof T]-?: DeepRequiredMessages<NonNullable<T[K]>>;
+} : T;
+/**
+ * El catálogo que acepta `BrandMessagesProvider`: **todo opcional**, espacios
+ * y claves (D5). Un catálogo a medias es válido; cada texto que no traiga sale
+ * en el castellano que lleva el paquete, y en desarrollo avisa una vez por
+ * clave en la consola.
+ *
+ * Una clave nueva entra siempre así, opcional: añadir un texto a la librería
+ * no rompe la compilación de ninguna app.
+ */
+export type BrandMessages = DeepPartialMessages<BrandMessagesShape>;
+/**
+ * El catálogo **entero**: todos los espacios y todas las claves obligatorias.
+ * Es el modo estricto, para la app que quiere enterarse al compilar —y no en
+ * la consola— de que le falta un texto:
+ *
+ * ```ts
+ * export const messages = { pagination: { … }, … } satisfies CompleteBrandMessages;
+ * ```
+ *
+ * Al subir de versión, una clave nueva del DS hace fallar ese `satisfies`
+ * hasta que el catálogo la traduce. Es también el tipo del castellano de
+ * respaldo que lleva el paquete.
+ */
+export type CompleteBrandMessages = DeepRequiredMessages<BrandMessagesShape>;
+export type { PaginationMessages, TableMessages, DataTableMessages, InputFieldMessages, PasswordFieldMessages, SelectMessages, MultiSelectMessages, NumberInputMessages, OtpInputMessages, InputPhoneMessages, AsyncSelectMessages, AsyncMultiSelectMessages, DocsSearchMessages, SearchFormMessages, SiteSearchMessages, FilterBarMessages, CalendarMessages, DatePickerMessages, ColorPickerMessages, TimeSelectMessages, FileUploadMessages, ImageCropDialogMessages, AvatarUploadMessages, ModalMessages, SheetMessages, ConfirmDialogMessages, AlertMessages, BannerMessages, ToasterMessages, ConsentMessages, CommandPaletteMessages, AppLauncherMessages, FloatingDockMessages, NotificationButtonMessages, NotificationPanelMessages, MenuButtonMessages, AppRootMessages, AppShellMessages, AppHeaderMessages, SidebarMessages, SidebarNavMessages, SiteNavMessages, SiteHeaderMessages, UserMenuMessages, OrgSwitcherMessages, BreadcrumbMessages, TableOfContentsMessages, PrevNextNavMessages, PublicPageShellMessages, OnboardingShellMessages, CopyMessages, CodeBlockMessages, DotsButtonMessages, CloseButtonMessages, ThemeSwitcherMessages, StatTileMessages, ProgressBarMessages, SpinnerMessages, SliderMessages, TreeViewMessages, ClockWidgetMessages, HeatmapMessages, OrgChartMessages, PlanningGridMessages, RecurrenceFieldMessages, FieldMessages, TimelineMessages, UptimeBarsMessages, ChartMessages, StepperMessages, CarouselMessages, LanguageSwitcherMessages, ProjectCardMessages, LegalFooterMessages, CalendarRosterMessages, CalendarPlannerMessages, NotificationListMessages, MessageComposerMessages, ConversationListMessages, ConversationThreadMessages, TypingIndicatorMessages, AnnotationThreadMessages, ChatShellMessages, UntrustedTextMessages, ConnectorRequestSummaryMessages, ConnectorConsentMessages, ConnectorSignInMessages, ConnectorExternalSignInMessages, ConnectorRejectionMessages, };