sass-template-common 0.10.12 → 0.10.14

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

@@ -248,6 +248,27 @@ export declare type BucketOriginConfig = {
     menu?: boolean;
     /** Sirve los banners (home/seccion/nota) desde el bucket. */
     banners?: boolean;
+    /**
+     * [transicional] Sirve la config de los slots dinámicos de home
+     * (`bloques/modulos-dinamicos/modulos-dinamicos.json`) desde el bucket en
+     * lugar del fan-out N contra `/config/blocks-saas`. Toggle de migración: al
+     * pasar todos los sitios a `true`, la rama legacy CMS se elimina y el toggle
+     * queda no-op (luego se remueve). ⚠ Requiere el adapter
+     * `mapBucketModulesToSlots`, aún sin implementar por depender del shape real
+     * del JSON — ver `PLAN_DYNAMIC_SLOTS_BUCKET_ORIGIN.md` §2. NO prender hasta
+     * que el adapter exista (hoy lanza si se activa).
+     */
+    slots?: boolean;
+    /**
+     * [transicional] Sirve la config del destacado dinámico
+     * (`bloques/destacado/destacado.json`) desde el bucket en lugar de
+     * `/config/blocks`. Drop-in 1→1: asume el mismo envelope `{ data: [...] }`
+     * que el endpoint CMS (verificar contra el archivo real antes de prender —
+     * `PLAN_DYNAMIC_SLOTS_BUCKET_ORIGIN.md` §2 Q4). Cae al CMS legacy si el
+     * bucket agota reintentos, igual que `menu`/`banners`. Al migrar todos los
+     * sitios la rama legacy se elimina y el toggle queda no-op.
+     */
+    destacado?: boolean;
     /**
      * Referer exigido por la bucket policy (`aws:Referer`). Sin este header el
      * bucket devuelve 403 aunque la ruta/archivo exista. Default: el mismo
@@ -1008,6 +1029,25 @@ export declare class DynamicBlockServices extends CommonServices {
     } | {
         blockSass: BlockSaasResponse[] | undefined;
     }>;
+    /**
+     * Dada la config de UN slot (`BlockSaasResponse[]`, se usa `[0]`), dispara el
+     * content-fetch que corresponda (`videos`/`tag`/`seccion`) y devuelve
+     * `{ blockSass, content? }`. Extraído de `getBlockSass` para reusarse tanto
+     * desde la rama legacy (CMS `/config/blocks-saas`) como desde la rama de
+     * bucket (`modulos-dinamicos.json`, ver `getDynamicSlotsFromBucket`): el
+     * origen del array cambia, el resto de la resolución de contenido no.
+     */
+    resolveSlotContent: (blockSassData: Array<BlockSaasResponse> | undefined) => Promise<{
+        blockSass: BlockSaasResponse[];
+        content: {
+            data: Array<VideoResponseData>;
+        } | undefined;
+    } | {
+        blockSass: BlockSaasResponse[];
+        content: NewListResponse | undefined;
+    } | {
+        blockSass: BlockSaasResponse[] | undefined;
+    }>;
 }
 
 export declare const DynamicComponents: ({ slots, DYNAMIC_SLOT_SUBINDEXES, stylesConfig, AutorIcon, config, banners, showTagBySection, pathname, }: Props_21) => JSX.Element[];
@@ -1595,12 +1635,12 @@ export declare interface ImageSizesContract {
         cardTall: SizeString;
         square: SizeString;
         gallery: SizeString;
-        featuredSuperSecondary: SizeString;
-        featuredVerticalPrimary: SizeString;
-        featuredVerticalSecondary: SizeString;
-        featuredHorizontalPrimary: SizeString;
-        featuredHorizontalSecondary: SizeString;
-        featuredDiarioImageThumb: SizeString;
+        featuredSuperSecondary?: SizeString;
+        featuredVerticalPrimary?: SizeString;
+        featuredVerticalSecondary?: SizeString;
+        featuredHorizontalPrimary?: SizeString;
+        featuredHorizontalSecondary?: SizeString;
+        featuredDiarioImageThumb?: SizeString;
     };
     author: {
         avatar: SizeString;
@@ -1614,15 +1654,28 @@ export declare interface ImageSizesContract {
     og: {
         social: SizeString;
     };
+    /**
+     * Corte opcional propio de un repo (NO resuelto por `resolveImageSizes`, sin
+     * default congelado). El repo que lo usa lo declara; si un consumidor lo usa
+     * sin declararlo es `undefined` → falla (obliga a configurar, decisión del
+     * owner). Hoy: preview cuadrado-grande de video/clip (`squareLg`) en
+     * radioformula/template/crack-family. Repos que no lo usan lo omiten.
+     */
+    squareLg?: SizeString;
 }
 
 /**
  * Partial real (por slot, no solo por grupo): `Partial<ImageSizesContract>` es
  * shallow y obligaría a mandar cada grupo completo o nada. Un app puede mandar
  * solo algunos slots de `note` y dejar el resto en manos del default congelado.
+ *
+ * `squareLg` (opcional, sin default) va aparte del mapeo de grupos: es un
+ * escalar, no un grupo — pasa tal cual si se provee, se omite si no.
  */
 export declare type ImageSizesContractInput = {
-    [G in keyof ImageSizesContract]?: Partial<ImageSizesContract[G]>;
+    [G in RequiredGroup]?: Partial<ImageSizesContract[G]>;
+} & {
+    squareLg?: SizeString;
 };
 
 export declare interface ImageSizesResolution {
@@ -1972,8 +2025,8 @@ export declare class MainComponentServices {
     readonly contract: ImageSizesContract;
     constructor(config: Config, imgSizes: any, axiosApi: AxiosInstance, exclude?: string, customMainImagesSizes?: string, imageSizes?: ImageSizesContractInput);
     getNewsListZone(params: Params): Promise<AxiosResponse<NewListResponse, any, {}> | undefined>;
-    getOutstandingBlock(params: Params): Promise<AxiosResponse<    {
-    data: Array<Outstanding>;
+    getOutstandingBlock(params: Params): Promise<AxiosResponse<{
+        data: Array<Outstanding>;
     }, any, {}> | undefined>;
     getNewsListZoneWrapper(section: string, size: number, imagesizes?: string): Promise<AxiosResponse<NewListResponse, any, {}> | undefined>;
     getNewsDestacadoDiario(section: string): Promise<never[] | AxiosResponse<NewListResponse, any, {}>>;
@@ -3259,6 +3312,15 @@ export declare interface ReportCommentParams {
 
 export declare type ReportReasonKey = keyof typeof REPORT_REASONS;
 
+/**
+ * Grupos requeridos del contrato: los que `resolveImageSizes` completa con el
+ * default congelado y el assert exige enteros. Los slots OPCIONALES sin default
+ * obligatorio (`squareLg` a nivel raíz, `featured*` dentro de `note`) se manejan
+ * aparte — no participan del assert obligatorio. Derivado (no hardcode) para que
+ * un grupo requerido nuevo entre solo y siga cubierto por el guard de completitud.
+ */
+export declare type RequiredGroup = Exclude<keyof ImageSizesContract, 'squareLg'>;
+
 /**
  * Reintenta `fn` con backoff exponencial, acotando cada intento con `timeoutMs`
  * (un fetch a un bucket S3 colgado no debe bloquear el request indefinidamente).
@@ -3287,7 +3349,7 @@ export declare function resolveBatchCount(): number;
 
 export declare function resolveBucketMenuSubtype(path?: string): string;
 
-export declare function resolveBucketOriginUrl(bucket: BucketOriginConfig, servicePrefix: string | undefined, type: 'menu' | 'banners', subtype: string): string;
+export declare function resolveBucketOriginUrl(bucket: BucketOriginConfig, servicePrefix: string | undefined, type: 'menu' | 'banners' | 'bloques', subtype: string): string;
 
 /**
  * Recibe lo que el app mande hoy (contrato completo, parcial, o nada) y