sass-template-common 0.9.226 → 0.9.227

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

@@ -1447,6 +1447,14 @@ export declare type LibraryConfig = {
     VARIANT_tag?: 'op1' | 'op2';
     S3_ID_DIR?: string;
     CONFIG_commentsV2?: boolean;
+    /**
+     * [EXPERIMENTAL] Lista de `internalPath` donde forzar `commentsV2` en el
+     * render SSR aunque el flag global `CONFIG_commentsV2` esté en `false`.
+     * Scaffold de testing per-nota (el flag global se lee de un singleton y no
+     * puede variar por nota). Aditivo: sin la lista el comportamiento no cambia.
+     * Remover al promover v2 a global.
+     */
+    EXPERIMENTAL_commentsV2Paths?: string[];
     CONFIG_comments?: boolean;
     CONFIG_blockDefaultTwitterHydrator?: boolean;
     CONFIG_hasSlugRoute?: boolean;
@@ -3223,21 +3231,25 @@ export declare const toISOWithTimeZone: (value: number | string, timeZone: strin
 
 /**
  * Devuelve la URL pública de la edición CONFIANDO en la URL que entrega el CMS
- * (`info.link.canonical`), que es correcta en la enorme mayoría de los casos.
- * Solo la reescribe cuando detecta el síntoma concreto de que el CMS filtró el
- * PATH INTERNO de la publicación principal: la URL viene con un **origin ajeno**
- * al público Y su path arranca con el **service prefix** de la API
- * (ej. `https://www.debate.com.mx/soyfutbolen/news/x.html` cuando la edición se
- * sirve en `https://www.soyfutbol.com/en` — `soyfutbolen` es subpublicación de
- * debate.com.mx). En ese caso arma la URL pública: origin público + front prefix
- * + path sin el service prefix.
+ * (`info.link.canonical`, items de breadcrumb, etc.), que es correcta en la
+ * enorme mayoría de los casos. Solo la reescribe cuando detecta el síntoma
+ * concreto de que el CMS filtró el PATH INTERNO de la publicación principal:
+ * el `pathname` arranca con el **service prefix** de la API (`/soyfutbolen`).
+ *
+ * Esa señal aparece tanto con origin ajeno (canonical:
+ * `https://www.debate.com.mx/soyfutbolen/news/x.html`) como con el origin
+ * público correcto (breadcrumb: `https://www.soyfutbol.com/soyfutbolen/...`);
+ * en ambos casos `soyfutbolen` es el prefijo interno y hay que mapearlo al
+ * front prefix público. Se arma: origin público + front prefix + path sin el
+ * service prefix. El origin ajeno queda normalizado como efecto.
  *
  * Todo lo demás se devuelve sin tocar → retrocompatible:
- *   - canónica ya correcta (mismo origin),
- *   - canónica cross-domain intencional de contenido sindicado (origin ajeno
- *     pero el path NO está bajo el service prefix),
- *   - publicación principal (sin service prefix),
- *   - subpublicación directa (se sirve desde su propio origin → mismo origin).
+ *   - URL ya correcta (path bajo `/en`, no bajo `/soyfutbolen`),
+ *   - canónica cross-domain intencional de contenido sindicado (path NO bajo
+ *     el service prefix),
+ *   - publicación principal (sin service prefix → return temprano),
+ *   - subpublicación directa (`frontPrefix === servicePrefix`: el swap deja el
+ *     path igual y el origin ya es el propio → no-op).
  *
  * @param cmsUrl       URL absoluta tal como la entrega el CMS.
  * @param publicOrigin Origin público de la edición (sin path), ej.
@@ -3245,6 +3257,33 @@ export declare const toISOWithTimeZone: (value: number | string, timeZone: strin
  */
 export declare function toPublicEditionUrl(cmsUrl: string | undefined, publicOrigin: string, cfg?: PrefixConfig): string | undefined;
 
+/**
+ * Convierte un path o URL del CMS en la URL pública de COMPARTIR de la edición,
+ * GARANTIZANDO el front prefix (`/en`). A diferencia de `toPublicEditionUrl`
+ * —que confía en el CMS y solo reescribe el síntoma de path interno filtrado—,
+ * este helper SIEMPRE deja la forma canónica pública, porque las URLs de
+ * compartir apuntan siempre a la misma edición y deben ser la forma navegable
+ * (`/en/news/...`), nunca el namespace interno (`/soyfutbolen/...`) ni la forma
+ * sin prefijo (`/news/...`). Pensado para los call-sites que arman la URL por
+ * concatenación (share de WhatsApp / comentarios / clipboard), que se saltean
+ * el prefijado que sí aplica `<Link>`/`getFrontPrefix`.
+ *
+ * Reglas:
+ *   1. Sin front prefix (publicación principal) → no-op (retrocompat).
+ *   2. Si el path arranca con el service prefix interno (`/soyfutbolen`) → se
+ *      quita.
+ *   3. Se antepone el front prefix (`/en`) de forma idempotente (no duplica si
+ *      el path ya lo tiene).
+ *
+ * Acepta URL absoluta (`https://host/soyfutbolen/x`) o path relativo
+ * (`/soyfutbolen/x`), preservando query y hash.
+ *
+ * @param cmsUrl URL absoluta o path relativo tal como se arma en el call-site.
+ * @param cfg    Config de prefijos. En cliente (donde `getConfig()` puede no
+ *               estar inicializado) se DEBE pasar explícito.
+ */
+export declare function toPublicShareUrl(cmsUrl: string | undefined, cfg?: PrefixConfig): string | undefined;
+
 export declare function TrimPathname(url: string): string;
 
 export declare const TwitterHydration: ({ currentNew }: {