sass-template-common 0.11.30 → 0.11.31

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

@@ -986,6 +986,17 @@ export declare const DEFAULT_HEAD_CONFIG: headConfig;
  */
 export declare const DEFAULT_RELATIVE_MAX_AGE_HOURS = 48;
 
+/**
+ * Separador por defecto entre el absoluto y el relativo cuando el absoluto se
+ * preserva (`keepAbsolute`): `' · '`, U+00B7 con espacios a los lados.
+ *
+ * No es `'•'` a propósito: el absoluto del encabezado de la nota ya usa ese
+ * glifo entre fecha y hora (`13 de agosto 2026 • 01:18 hs`), y repetirlo haría
+ * ilegible cuál de los dos separa qué. Se sobreescribe con
+ * `CONFIG_relativeTime.separator`.
+ */
+export declare const DEFAULT_RELATIVE_SEPARATOR = " \u00B7 ";
+
 export declare const DEFAULT_S3_REFERER = "https://goamg.amplifyapp.com/vndomv";
 
 declare type DestacadoDiario = {
@@ -1956,11 +1967,20 @@ export declare type LibraryConfig = {
      * - `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).
+     * - `keepAbsolute` — dónde el relativo se AGREGA al absoluto en vez de
+     *                    reemplazarlo. Default `'notes'`.
+     *                    Ver {@link RelativeTimeKeepAbsolute}.
+     * - `separator`   — qué va entre el absoluto y el relativo cuando se
+     *                   preserva el absoluto. Default `' · '` (U+00B7). El
+     *                   absoluto de la nota ya usa `'•'` entre fecha y hora, así
+     *                   que conviene no repetir ese glifo.
      */
     CONFIG_relativeTime?: {
         enabled: boolean;
         maxAgeHours?: number;
         scope?: RelativeTimeScope;
+        keepAbsolute?: RelativeTimeKeepAbsolute;
+        separator?: string;
     };
     CONFIG_deferBanners?: {
         common?: boolean;
@@ -3514,6 +3534,24 @@ export declare const relativeTimeAttrs: (ts: number | undefined, prefix?: string
  */
 export declare const relativeTimeAttrsHTML: (ts: number | undefined, prefix?: string, surface?: RelativeTimeSurface) => string;
 
+/**
+ * Dónde el relativo se AGREGA al absoluto en lugar de reemplazarlo
+ * (`CONFIG_relativeTime.keepAbsolute`). Mismas familias que
+ * {@link RelativeTimeScope}, más `'none'`.
+ *
+ * - `'notes'`     — el encabezado de la nota y los comentarios quedan
+ *                   `"13 de agosto 2026 • 01:18 hs · hace 3 horas"`; las
+ *                   tarjetas y listados siguen reemplazando. **Es el default.**
+ * - `'all'`       — se preserva el absoluto en todas las superficies.
+ * - `'summaries'` — se preserva solo en tarjetas y listados.
+ * - `'none'`      — el relativo reemplaza el texto en todas partes
+ *                   (comportamiento previo a esta opción).
+ *
+ * Preservar el absoluto no agrega nodos al DOM: el hidratador reescribe el
+ * mismo nodo de texto con `absoluto + separator + relativo`.
+ */
+export declare type RelativeTimeKeepAbsolute = RelativeTimeScope | 'none';
+
 declare type RelativeTimeOptions = {
     /**
      * Gana sobre `CONFIG_relativeTime.enabled`. Sin ninguno de los dos en `true`
@@ -3527,6 +3565,16 @@ declare type RelativeTimeOptions = {
      * o `'all'` — que es exactamente el comportamiento previo al toggle.
      */
     scope?: RelativeTimeScope;
+    /**
+     * Dónde el relativo se AGREGA al absoluto en lugar de reemplazarlo. Default
+     * `CONFIG_relativeTime.keepAbsolute`, o `'notes'`.
+     */
+    keepAbsolute?: RelativeTimeKeepAbsolute;
+    /**
+     * Separador entre el absoluto y el relativo. Default
+     * `CONFIG_relativeTime.separator`, o {@link DEFAULT_RELATIVE_SEPARATOR}.
+     */
+    separator?: string;
     /** Cada cuánto refresca el texto. Default 60_000. `0` desactiva el refresco. */
     refreshMs?: number;
     /** Raíz del query. Default `document`. */