sass-template-common 0.11.24 → 0.11.25

package/dist/sass-template-common.d.ts

@@ -976,6 +976,16 @@ export declare function decodeApiEnv<T = any>(encoded: Record<string, any>): T;
  */
 export declare const DEFAULT_HEAD_CONFIG: headConfig;
 
+/**
+ * Ventana por defecto del relativo, en horas. **48 h**: hasta ahí el texto es
+ * "hace N horas"; pasada la ventana, fecha absoluta.
+ *
+ * Es el default de `isWithinRelativeWindow`, de `formatRelativeDate` y del
+ * hidratador, para que los tres no puedan discrepar. Se sobreescribe por sitio
+ * con `CONFIG_relativeTime.maxAgeHours`.
+ */
+export declare const DEFAULT_RELATIVE_MAX_AGE_HOURS = 48;
+
 export declare const DEFAULT_S3_REFERER = "https://goamg.amplifyapp.com/vndomv";
 
 declare type DestacadoDiario = {
@@ -1262,6 +1272,11 @@ export declare const formatNewsMeta: (meta: any, news: NewListResponseData | und
  * Relativo ("hace 3 horas") si la nota es más nueva que `maxAgeHours`;
  * si no, cae a `formatDate` (absoluto).
  *
+ * Escala: `hace instantes` (< 1 min) · `hace N minutos` · `hace N horas` ·
+ * `hace N días`. Pasada la ventana (`maxAgeHours`, default 48) vuelve al
+ * absoluto — el hidratador restaura el texto que emitió el SSR, que puede no
+ * ser el de `formatDate` (la nota usa `formatDateJournalistArticule`).
+ *
  * `now` entra POR PARÁMETRO, no se lee adentro: así la función es determinista
  * dado `(date, now)` y el SSR nunca la llama con `Date.now()` por accidente
  * (un relativo renderizado en servidor queda congelado en el cache del CDN y
@@ -1934,11 +1949,18 @@ export declare type LibraryConfig = {
      * un relativo renderizado en servidor queda congelado en el CDN.
      *
      * Default `undefined` -> comportamiento actual (absoluto, sin hidratador).
-     * `maxAgeHours` default 24: pasada esa antiguedad se muestra el absoluto.
+     *
+     * - `enabled`     — kill switch. Sin `true` el hidratador no toca el DOM.
+     * - `scope`       — qué familias de superficie hidrata. Default `'all'`.
+     *                   Ver {@link RelativeTimeScope}.
+     * - `maxAgeHours` — cuánto tiempo se mantiene el relativo. Default **48**;
+     *                   pasada esa antigüedad se muestra el absoluto que emitió
+     *                   el SSR (cada superficie conserva su propio formato).
      */
     CONFIG_relativeTime?: {
         enabled: boolean;
         maxAgeHours?: number;
+        scope?: RelativeTimeScope;
     };
     CONFIG_deferBanners?: {
         common?: boolean;
@@ -3462,18 +3484,35 @@ export declare const RELATIVE_TIME_ATTR = "data-rel-ts";
  */
 export declare const RELATIVE_TIME_PREFIX_ATTR = "data-rel-prefix";
 
+/**
+ * Superficie a la que pertenece el elemento, para que `CONFIG_relativeTime.scope`
+ * pueda prender/apagar por familia sin que el hidratador tenga que adivinar la
+ * ruta ni conocer selectores de componentes.
+ *
+ * - `'note'`   → la fecha del ENCABEZADO de la nota (`JournalistArticule3/4/5`)
+ *                y la de los comentarios: solo existen dentro de una nota.
+ * - `'summary'`→ tarjetas y listados (home, sección, tag, autor, búsqueda,
+ *                "más noticias", videos, opinión). Es el DEFAULT.
+ *
+ * `'summary'` no se emite: la ausencia del atributo YA significa summary. Así
+ * el HTML de las 8 superficies que ya existían no cambia ni un byte, y el HTML
+ * emitido por versiones anteriores (sin el atributo) se sigue clasificando
+ * bien.
+ */
+export declare const RELATIVE_TIME_SCOPE_ATTR = "data-rel-scope";
+
 /**
  * Props JSX del contrato. Devuelve `{}` (spread vacío, cero atributos en el
  * HTML) si el timestamp no sirve: la superficie queda exactamente como hoy.
  */
-export declare const relativeTimeAttrs: (ts: number | undefined, prefix?: string) => Record<string, string | number>;
+export declare const relativeTimeAttrs: (ts: number | undefined, prefix?: string, surface?: RelativeTimeSurface) => Record<string, string | number>;
 
 /**
  * La misma info que `relativeTimeAttrs`, para los emisores de HTML-string
  * (`homeCardFastRender`). Devuelve `''` o un fragmento que ARRANCA con espacio,
  * listo para concatenar dentro del tag.
  */
-export declare const relativeTimeAttrsHTML: (ts: number | undefined, prefix?: string) => string;
+export declare const relativeTimeAttrsHTML: (ts: number | undefined, prefix?: string, surface?: RelativeTimeSurface) => string;
 
 declare type RelativeTimeOptions = {
     /**
@@ -3481,13 +3520,39 @@ declare type RelativeTimeOptions = {
      * el hidratador es un no-op: no observa, no agenda y no toca el DOM.
      */
     enabled?: boolean;
+    /** Ventana del relativo. Default `CONFIG_relativeTime.maxAgeHours`, o 48. */
     maxAgeHours?: number;
+    /**
+     * Qué familias de superficie hidratar. Default `CONFIG_relativeTime.scope`,
+     * o `'all'` — que es exactamente el comportamiento previo al toggle.
+     */
+    scope?: RelativeTimeScope;
     /** Cada cuánto refresca el texto. Default 60_000. `0` desactiva el refresco. */
     refreshMs?: number;
     /** Raíz del query. Default `document`. */
     root?: ParentNode;
 };
 
+/**
+ * Alcance de la fecha relativa (`CONFIG_relativeTime.scope`).
+ *
+ * - `'all'`       — todo el sitio, **incluida la fecha del encabezado de la
+ *                   nota** (`JournalistArticule3/4/5`) y la de los comentarios.
+ *                   Es el default y el comportamiento previo al toggle.
+ * - `'summaries'` — solo tarjetas y listados: home, sección, tag, autor,
+ *                   búsqueda, "más noticias", videos, opinión. El encabezado de
+ *                   la nota y los comentarios quedan en absoluto.
+ * - `'notes'`     — solo lo que vive dentro de la nota: encabezado y
+ *                   comentarios. Los listados quedan en absoluto.
+ *
+ * La clasificación viaja en el HTML como `data-rel-scope="note"` (la ausencia
+ * del atributo significa `summary`), así que no depende de detectar la ruta.
+ */
+export declare type RelativeTimeScope = 'all' | 'summaries' | 'notes';
+
+/** Familia de superficie. Ver `RELATIVE_TIME_SCOPE_ATTR`. */
+export declare type RelativeTimeSurface = 'note' | 'summary';
+
 export declare const removePages: (pathname: string) => string;
 
 declare type ReplaceProps = {