sass-template-common 0.10.18 → 0.10.20

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

@@ -155,6 +155,22 @@ export declare type BannerScope = {
     value: number;
 };
 
+/**
+ * ¿La ruta actual debe emitir banners para este request? Fuente ÚNICA de la
+ * política "banners condicionados a query". Para las rutas listadas en
+ * `CONFIG_bannersRequireQuery` (default `['buscar']`) devuelve `true` solo si hay
+ * query no vacío; para el resto de rutas devuelve siempre `true`.
+ *
+ * Consumida por `GenerateHead` (gatea `<BannersPreconnect>` + `headscripts`) y
+ * por el `LayoutCore` de cada sitio (para saltar el self-fetch de `getBanners`
+ * cuando no corresponde). Al vivir acá, agregar/quitar rutas gateadas o el
+ * default es un cambio de un solo lugar que se propaga a todos los repos.
+ *
+ * `cfg` default = `getConfig()` (singleton de `initLibrary`, ya poblado cuando
+ * corre el render de Head/LayoutCore). Se puede pasar explícito para tests.
+ */
+export declare function bannersEnabledForRequest(route: string, query: string | undefined, cfg?: Pick<LibraryConfig, 'CONFIG_bannersRequireQuery'>): boolean;
+
 export declare const BannersPreconnect: ({ gpt, googleAds, syndication, adsense, }: BannersPreconnectProps) => JSX.Element;
 
 /**
@@ -1905,6 +1921,22 @@ export declare type LibraryConfig = {
         middle?: boolean;
         innote?: boolean;
     };
+    /**
+     * [banners] Rutas cuyo contenido de banners depende de que exista un query
+     * string (ej. `'buscar'`: sin query no hay resultados → no hay banners). Para
+     * esas rutas, cuando el query está vacío: `GenerateHead` NO emite los
+     * preconnects de banners (`<BannersPreconnect>`) ni los `headscripts`, y cada
+     * sitio debería saltarse el fetch de banners en su `LayoutCore` usando
+     * `bannersEnabledForRequest(route, query)`. El resto de rutas nunca se gatea.
+     *
+     * Default (si no se define): `['buscar']`. Para desactivar el gate por
+     * completo: `[]`. Aditivo/retro-compatible: solo afecta buscar-sin-query, que
+     * en esta familia de templates nunca renderiza banners (el render del
+     * `LandingTemplate` ya está gateado por `amount > 0`). Se tipa como `string[]`
+     * (no `MetadataDefaultsKeys[]`) para evitar el import circular config ↔
+     * metadata_defaults; las claves válidas son las de `MetadataDefaultsKeys`.
+     */
+    CONFIG_bannersRequireQuery?: string[];
     /**
      * TTL (ms) del cache in-memory SSR para `getMainMenu` / `getBanners` vía API CMS.
      * Default 45000. `0` desactiva el cache. También configurable en