sass-template-common 0.11.32 → 0.11.33

package/README.md

@@ -1,36 +1,36 @@
-# sass-template-common
-
-Librería web, maqueta de configuración y componentes para proyectos sass.
-
-## Publicar nueva versión
-
-Para que los cambios se reflejen al publicar:
-
-1. **Subir versión** (obligatorio; si no, npm rechaza o se usa la misma versión):
-   ```bash
-   pnpm version:patch   # 0.3.21 → 0.3.22
-   # o
-   pnpm version:minor   # 0.3.21 → 0.4.0
-   pnpm version:major   # 0.3.21 → 1.0.0
-   ```
-
-2. **Build limpio + publicar**:
-   ```bash
-   pnpm run clean && pnpm run build && pnpm publish
-   ```
-   O en un solo paso (patch):
-   ```bash
-   pnpm release:patch
-   ```
-
-3. **`prepublishOnly`**: Antes de cada `pnpm publish` se ejecuta `clean` + `build`, así siempre se publica un build nuevo.
-
-4. **En proyectos que consumen la lib**: Actualizar la dependencia y reinstalar:
-   ```bash
-   pnpm update sass-template-common
-   # o cambiar la versión en package.json y luego
-   pnpm install
-   ```
-   Si usan versión fija (`"0.3.21"`), hay que actualizarla a la nueva (p. ej. `"0.3.22"`).
-
-**Si no ves los cambios:** comprueba que subiste la versión (`version:patch` o similar), que hiciste `clean` + `build` antes de publicar, y que el proyecto consumidor tiene actualizada la dependencia (o `^0.3.21` y ha ejecutado `pnpm update`).
+# sass-template-common
+
+Librería web, maqueta de configuración y componentes para proyectos sass.
+
+## Publicar nueva versión
+
+Para que los cambios se reflejen al publicar:
+
+1. **Subir versión** (obligatorio; si no, npm rechaza o se usa la misma versión):
+   ```bash
+   pnpm version:patch   # 0.3.21 → 0.3.22
+   # o
+   pnpm version:minor   # 0.3.21 → 0.4.0
+   pnpm version:major   # 0.3.21 → 1.0.0
+   ```
+
+2. **Build limpio + publicar**:
+   ```bash
+   pnpm run clean && pnpm run build && pnpm publish
+   ```
+   O en un solo paso (patch):
+   ```bash
+   pnpm release:patch
+   ```
+
+3. **`prepublishOnly`**: Antes de cada `pnpm publish` se ejecuta `clean` + `build`, así siempre se publica un build nuevo.
+
+4. **En proyectos que consumen la lib**: Actualizar la dependencia y reinstalar:
+   ```bash
+   pnpm update sass-template-common
+   # o cambiar la versión en package.json y luego
+   pnpm install
+   ```
+   Si usan versión fija (`"0.3.21"`), hay que actualizarla a la nueva (p. ej. `"0.3.22"`).
+
+**Si no ves los cambios:** comprueba que subiste la versión (`version:patch` o similar), que hiciste `clean` + `build` antes de publicar, y que el proyecto consumidor tiene actualizada la dependencia (o `^0.3.21` y ha ejecutado `pnpm update`).

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`. */