sass-template-common 0.12.0 → 0.12.1

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

@@ -1003,12 +1003,15 @@ 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.
+ * Separador entre el absoluto y el relativo para los absolutos que NO traen
+ * hora: `' · '`, U+00B7 con espacios a los lados. Es el caso de las tarjetas y
+ * de los comentarios, que emiten solo fecha (`formatDate`) — el resultado es
+ * `26 agosto 2026 · hace 2 horas`.
  *
- * 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
+ * Cuando el absoluto SÍ trae hora (el encabezado de la nota:
+ * `26 de agosto 2026 • 09:23 hs`) este separador no se usa: el relativo ocupa
+ * el lugar de la hora y se conserva el `'•'` que ya emitió el SSR. Ver
+ * {@link absolutePrefixWithoutTime}. Se sobreescribe con
  * `CONFIG_relativeTime.separator`.
  */
 export declare const DEFAULT_RELATIVE_SEPARATOR = " \u00B7 ";
@@ -1910,6 +1913,23 @@ export declare const JournalistArticule2: FC<Props_49>;
 
 export declare const JournalistGroup: FC<Props_50>;
 
+/**
+ * Techo de la ventana para las familias que PRESERVAN el absoluto
+ * (`keepAbsolute`): **24 h**. Con la fecha absoluta a la vista, un relativo en
+ * días no agrega información — `26 de agosto 2026 • hace 3 días` es la misma
+ * fecha dicha dos veces, y peor: la segunda, aproximada.
+ *
+ * Es un TECHO, no un default: se aplica como `min(maxAgeHours, 24)`, así un
+ * sitio que configure una ventana más corta la conserva. Las familias que
+ * REEMPLAZAN el absoluto no lo usan: ahí el relativo es el único dato que hay y
+ * `maxAgeHours` manda entero.
+ *
+ * El borde es EXCLUSIVO (`< 24 h`), a diferencia de `isWithinRelativeWindow`,
+ * que es inclusiva: a las 24 h exactas la escala ya dice "hace 1 día", que es
+ * justo lo que este techo existe para evitar.
+ */
+export declare const KEEP_ABSOLUTE_MAX_AGE_HOURS = 24;
+
 export declare const LayoutNewsComponent: FC<Props_47>;
 
 export declare type LibraryConfig = {
@@ -1983,13 +2003,21 @@ 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'`.
+     *                   En las familias de `keepAbsolute` la ventana se topea en
+     *                   **24 h** (`min(maxAgeHours, 24)`): con la fecha a la
+     *                   vista, un relativo en días es la misma fecha repetida.
+     * - `keepAbsolute` — dónde el relativo convive con el absoluto en vez de
+     *                    reemplazarlo. Default `'notes'`. En esas familias la
+     *                    ventana se topea en 24 h y el relativo ocupa el lugar de
+     *                    la hora (`26 de agosto 2026 • hace 2 horas`).
      *                    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.
+     * - `separator`   — qué va entre el absoluto y el relativo cuando el
+     *                   absoluto NO trae hora (tarjetas, comentarios). Default
+     *                   `' · '` (U+00B7). En el encabezado de la nota, que sí
+     *                   trae hora (`26 de agosto 2026 • 09:23 hs`), el relativo
+     *                   OCUPA el lugar de la hora conservando el `'•'` del SSR
+     *                   (`26 de agosto 2026 • hace 2 horas`) y este separador no
+     *                   se usa; la hora vuelve entera al salir de la ventana.
      */
     CONFIG_relativeTime?: {
         enabled: boolean;
@@ -3581,7 +3609,11 @@ 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. */
+    /**
+     * Ventana del relativo. Default `CONFIG_relativeTime.maxAgeHours`, o 48.
+     * Las familias de `keepAbsolute` la topean en
+     * {@link KEEP_ABSOLUTE_MAX_AGE_HOURS}.
+     */
     maxAgeHours?: number;
     /**
      * Qué familias de superficie hidratar. Default `CONFIG_relativeTime.scope`,