sass-cms-template-common 0.0.18 → 0.0.20

package/dist/index.d.ts

@@ -1991,6 +1991,33 @@ export declare class CmsRecipesServices {
     schedulePublish: (paths: string[]) => Promise<CmsResponse>;
 }
 
+/**
+ * Muestra un instante como tiempo transcurrido ("hace 3 días") que se recalcula
+ * solo cada minuto. El cálculo relativo corre únicamente en el cliente (usa
+ * `Date.now()`): en SSR y en el primer render muestra `title` (la fecha absoluta),
+ * evitando el desajuste de hidratación de Next.
+ */
+export declare function CmsRelativeTime({ epochMs, localeTag, style, title, testId, className, }: CmsRelativeTimeProps): JSX.Element;
+
+export declare type CmsRelativeTimeProps = {
+    /** Instante a mostrar, en milisegundos (epoch UTC). */
+    epochMs: number;
+    /** Tag BCP 47 (p. ej. `"es-AR"`); usar `getIntlLocaleTag(locale)`. */
+    localeTag: string;
+    /** Estilo del texto: `"long"` (por defecto) → "hace 18 minutos". */
+    style?: RelativeTimeStyle;
+    /**
+     * Texto para el `title` (tooltip nativo) y para el primer render/SSR: conviene
+     * pasar la fecha absoluta ya formateada (p. ej. `formatSiteDateTime(...)`), así
+     * el usuario ve el instante exacto al pasar el mouse y no hay salto vacío.
+     */
+    title?: string;
+    /** Base para el `data-testid` (p. ej. `row-<id>-time`). */
+    testId?: string;
+    /** Clase opcional para estilar el `<span>` desde el gestor. */
+    className?: string;
+};
+
 /** Envelope común de respuesta de los webservices de OpenCms. */
 export declare interface CmsResponse {
     status: 'ok' | 'fail' | 'error';
@@ -2080,10 +2107,10 @@ export declare type CmsSearchFieldProps = {
     /** Espacio mínimo a la derecha cuando `grow` está activo. Por defecto `40`. */
     endGap?: number;
     /**
-     * Separación fija a la izquierda (px) cuando `grow` está activo. Si se pasa, el
-     * buscador **llena** el espacio restante dejando este hueco respecto del control
-     * previo (p. ej. un filtro), en reposo y expandido. Si se omite, en reposo se
-     * alinea a la derecha con ancho `width` y crece al enfocar.
+     * Separación mínima a la izquierda (px) que el buscador deja respecto del
+     * control previo (p. ej. un filtro) **al crecer** en modo `grow`. En reposo
+     * mantiene el ancho `width` alineado a la derecha; al enfocar crece hasta el
+     * espacio disponible dejando este hueco a la izquierda. Por defecto sin hueco.
      */
     startGap?: number;
     /** `aria-label` del botón de avanzadas. */
@@ -3285,6 +3312,7 @@ export declare const enMessages: {
         readonly SECTIONS: "Sections";
         readonly TWITTERS: "Twitter Feeds";
         readonly USERS: "Users";
+        readonly COPILOT: "CoPilot";
         readonly ZONES: "Zones";
         readonly IA: "IA";
     };
@@ -3511,6 +3539,7 @@ export declare const esMessages: {
         SECTIONS: string;
         TWITTERS: string;
         USERS: string;
+        COPILOT: string;
         ZONES: string;
         IA: string;
     };
@@ -4002,6 +4031,25 @@ export declare const fontFamilies: {
     readonly mono: "ui-monospace, SFMono-Regular, Menlo, Consolas, monospace";
 };
 
+/**
+ * Formatea un instante como tiempo transcurrido hasta "ahora": "hace 18 minutos",
+ * "hace 3 días", "hace 3 meses". Elige sola la unidad más significativa y se
+ * traduce al idioma del `localeTag` vía `Intl.RelativeTimeFormat` (no requiere
+ * claves i18n propias).
+ *
+ * La cuenta es una resta de instantes UTC, así que NO depende del GMT del sitio
+ * ni de la zona del navegador (a diferencia de `formatSiteDateTime`).
+ *
+ * @param epochMs Instante en milisegundos (UTC).
+ * @param localeTag Tag BCP 47 (p. ej. `"es-AR"`); usar `getIntlLocaleTag(locale)`.
+ * @param options `nowMs` (referencia de "ahora", por defecto `Date.now()`) y
+ *   `style` (por defecto `"long"`).
+ */
+export declare function formatRelativeTime(epochMs: number, localeTag: string, options?: {
+    nowMs?: number;
+    style?: RelativeTimeStyle;
+}): string;
+
 /**
  * Formatea un instante (epoch ms) en la zona horaria del sitio, de forma
  * estable entre navegadores.
@@ -6228,6 +6276,7 @@ export declare const ptMessages: {
         SECTIONS: string;
         TWITTERS: string;
         USERS: string;
+        COPILOT: string;
         ZONES: string;
         IA: string;
     };
@@ -6694,6 +6743,9 @@ export declare interface RecipesPublishCheckResponse extends CmsResponse {
     [key: string]: unknown;
 }
 
+/** Estilo del texto relativo (`Intl.RelativeTimeFormat`). */
+export declare type RelativeTimeStyle = 'long' | 'short' | 'narrow';
+
 export declare type ResilientRunner = <T>(fn: () => Promise<T>, options?: ResilientRunOptions) => Promise<T>;
 
 export declare interface ResilientRunOptions {
@@ -7105,6 +7157,22 @@ export declare interface SubscriptionsGetResponse extends CmsResponse {
 
 export declare const SUPPORTED_LOCALES: readonly ["es", "en", "pt"];
 
+/**
+ * Superficie estándar de los menús desplegables (dropdowns, flyouts del menú
+ * lateral, kebab de acciones de fila, "Mi Perfil", etc.). Unifica **borde +
+ * radio + sombra** para que todos mantengan la misma estética (NAA-4799: algunos
+ * papers tenían solo sombra, sin el borde definido, y se perdían contra el
+ * fondo, que comparte el mismo gris).
+ *
+ * - Borde `divider` (= `outlineVariant`, #C4C6CF en claro / #3A3E46 en oscuro):
+ *   el mismo que ya usaba el flyout del menú lateral.
+ * - Radio `radii.flyout` (12px) y sombra `shadows.flyout` (dos capas suaves).
+ *
+ * Cada paper agrega aparte lo suyo (ancho mínimo, padding, `overflow`, margen de
+ * separación con el disparador). Se aplica con `...(sxMenuSurface as object)`.
+ */
+export declare const sxMenuSurface: SxProps<Theme>;
+
 /** Botón pill completo y autónomo. Reutilizable en cualquier CTA de la lib. */
 export declare function sxPillButton(variant?: CmsButtonVariant): SxProps<Theme>;