sass-cms-template-common 0.0.18 → 0.0.19

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. */
@@ -4002,6 +4029,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.
@@ -6694,6 +6740,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 {