sass-template-common 0.10.10 → 0.10.12

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

@@ -51,6 +51,13 @@ export declare type Analytics = {
     comscore: string | undefined;
 };
 
+/**
+ * Red de seguridad runtime para consumidores JS (sin type-check). El tipo
+ * marca la forma en build; esto valida presencia de cada slot y que matchee
+ * el formato exacto en runtime — enforcement doble, decisión del owner (§3).
+ */
+export declare function assertImageSizesContract(x: unknown): asserts x is ImageSizesContract;
+
 export declare const assetsImagesPrefixer: (imagePath: string, assetsClient?: string) => string;
 
 export declare const AssetsPreconnect: () => false | "" | JSX.Element | undefined;
@@ -309,6 +316,9 @@ declare interface CarruselCardProps extends Omit<CarrouselProps, 'slot_id'> {
 
 export declare const CarruselOpinion: FC<SectionCardCarouselProps>;
 
+/** Corre `resolveImageSizes` y reduce el resultado a pass/fail para CI. */
+export declare function checkImageSizes(input: ImageSizesContractInput | undefined): ImageSizesCheckReport;
+
 /**
  * Recorre recursivamente un schema (objeto o array) y elimina toda entry
  * que quede sin valor. Si una propiedad de un objeto queda sin valor, la
@@ -512,6 +522,11 @@ export declare class CommonServices {
     protected props?: ICommonServices | undefined;
     configVersion: string;
     exclude: string;
+    /**
+     * Contrato de tamaños resuelto UNA vez en el punto de entrada (§3). El resto
+     * de los métodos consume `this.contract.<slot>` — cero literales sueltos.
+     */
+    readonly contract: ImageSizesContract;
     constructor(props?: ICommonServices | undefined);
     generateTokenOffline: (browserId: string) => Promise<any>;
     getEntitySection: (params: Params) => Promise<AxiosResponse<{
@@ -1289,9 +1304,7 @@ export declare function getConfigOriginAuditReport(comparison?: ConfigOriginComp
 
 export declare const getDynamicSlots: (axiosApi: AxiosInstance, config: Config, imgSizes: {
     [key: string]: any;
-}, imgSizesVideo: {
-    [key: string]: any;
-}, DYNAMIC_SLOT_TOTAL: number, DYNAMIC_SLOT_SUBINDEXES: number, exclude?: string) => Promise<{
+}, imageSizes: ImageSizesContractInput | undefined, DYNAMIC_SLOT_TOTAL: number, DYNAMIC_SLOT_SUBINDEXES: number, exclude?: string) => Promise<{
     [key: string]: any;
 }>;
 
@@ -1327,7 +1340,7 @@ export declare const getPreloadImages: (list: NewListResponseData[], PRELOADED_I
 
 export declare const getPrevMeta: (config: Config, paths: Array<string>, page: number) => string;
 
-export declare const getRelatedNewsCarrousel: (currentNew: NewListResponseData, internalPath: string, commonServices: CommonServices, imgSizes: any) => Promise<NewListResponseData[] | undefined>;
+export declare const getRelatedNewsCarrousel: (currentNew: NewListResponseData, internalPath: string, commonServices: CommonServices) => Promise<NewListResponseData[] | undefined>;
 
 export declare function getReportReasonLabel(reasonKey: ReportReasonKey): string;
 
@@ -1475,8 +1488,12 @@ export declare function homeCardImagenToHTMLString(item: NewListResponseData, in
 
 declare interface ICommonServices {
     config?: Config;
+    /** @deprecated Ya no se lee acá; los tamaños salen de `contract` (§3). Se acepta por retrocompat hasta Fase 3. */
     imgSizes?: any;
+    /** @deprecated No se lee en CommonServices; se acepta por retrocompat hasta Fase 3. */
     imgSizesVideo?: any;
+    /** Nuevo contrato de tamaños (REFACTOR_IMGSIZES_PLAN.md §3). Ausente → `resolveImageSizes` cae a los defaults congelados (§4) → output idéntico. */
+    imageSizes?: ImageSizesContractInput;
     axiosApi: AxiosInstance;
     exclude?: string;
 }
@@ -1561,6 +1578,60 @@ declare interface ImageProps_4 {
     figCaption?: string;
 }
 
+export declare interface ImageSizesCheckReport {
+    /** `true` si el contrato no necesitó ningún default congelado. */
+    ok: boolean;
+    legacyFieldsUsed: string[];
+}
+
+export declare interface ImageSizesContract {
+    note: {
+        detailMain: SizeString;
+        detailSecondary: SizeString;
+        itemsListPrimary: SizeString;
+        relatedPrimary: SizeString;
+        relatedThumb: SizeString;
+        listStandard: SizeString;
+        cardTall: SizeString;
+        square: SizeString;
+        gallery: SizeString;
+        featuredSuperSecondary: SizeString;
+        featuredVerticalPrimary: SizeString;
+        featuredVerticalSecondary: SizeString;
+        featuredHorizontalPrimary: SizeString;
+        featuredHorizontalSecondary: SizeString;
+        featuredDiarioImageThumb: SizeString;
+    };
+    author: {
+        avatar: SizeString;
+        multiCrop: SizeString;
+    };
+    video: {
+        xl: SizeString;
+        lg: SizeString;
+        md: SizeString;
+    };
+    og: {
+        social: 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.
+ */
+export declare type ImageSizesContractInput = {
+    [G in keyof ImageSizesContract]?: Partial<ImageSizesContract[G]>;
+};
+
+export declare interface ImageSizesResolution {
+    /** Siempre completo — nunca undefined para el resto del paquete. */
+    contract: ImageSizesContract;
+    /** Slots resueltos por el default congelado, no provistos por el app. */
+    legacyFieldsUsed: string[];
+}
+
 export declare interface Info {
     type?: string;
     section?: {
@@ -1887,11 +1958,19 @@ export declare interface MainBlock1Props extends SectionCardProps, NewDescriptio
 export declare class MainComponentServices {
     exclude: string;
     config: any;
+    /**
+     * @deprecated Ya no se lee: los tamaños salen de `this.contract` (§3). Bigfish
+     * pasa `imgSizesVideo` acá (quirk documentado en el snapshot de Fase 0), por eso
+     * `this.imgSizes.lg` valía `video.lg`; ahora eso se expresa como `contract.video.lg`.
+     * Se mantiene el parámetro posicional por retrocompat hasta Fase 3.
+     */
     imgSizes: any;
     configVersion: string;
     axiosApi: AxiosInstance | undefined;
     customMainImagesSize: string | undefined;
-    constructor(config: Config, imgSizes: any, axiosApi: AxiosInstance, exclude?: string, customMainImagesSizes?: string);
+    /** Contrato de tamaños resuelto UNA vez (§3); el resto consume `this.contract.<slot>`. */
+    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>;
@@ -2575,7 +2654,10 @@ export declare interface Preview {
     photographer?: string | false;
 }
 
-export declare const processExtractedRelatedNews: (relatedNews: string[][], getNews: (params: any) => any) => Promise<any[]>;
+/** Única función que imprime: nada de `console.warn` en el runtime de la app (§3.1). */
+export declare function printImageSizesReport(report: ImageSizesCheckReport, label?: string): void;
+
+export declare const processExtractedRelatedNews: (relatedNews: string[][], getNews: (params: any) => any, imagesizes?: string) => Promise<any[]>;
 
 export declare type PromiseArray = {
     [key: string]: {
@@ -3207,6 +3289,18 @@ export declare function resolveBucketMenuSubtype(path?: string): string;
 
 export declare function resolveBucketOriginUrl(bucket: BucketOriginConfig, servicePrefix: string | undefined, type: 'menu' | 'banners', subtype: string): string;
 
+/**
+ * Recibe lo que el app mande hoy (contrato completo, parcial, o nada) y
+ * devuelve SIEMPRE un contrato completo. Los constructores públicos del
+ * paquete llaman esto una sola vez, en su punto de entrada, y de ahí en
+ * adelante consumen `contract.<slot>` sin condicionales ni valores propios.
+ *
+ * Puede tirar (vía `assertImageSizesContract`) si un slot provisto por el
+ * app no matchea el formato esperado — enforcement doble (§3): tipos en
+ * build, assert en runtime.
+ */
+export declare function resolveImageSizes(input: ImageSizesContractInput | undefined): ImageSizesResolution;
+
 export declare interface RoutePathConfig {
     autor: string | 'autor';
     tema: string | 'tema';
@@ -3386,6 +3480,9 @@ export declare interface SizeImage {
     scale?: string;
 }
 
+/** Formato: `"w:{n},h:{n},t:{n}[,c:{hex}];"` (uno o más, cada uno separado y terminado en `;`). */
+export declare type SizeString = string;
+
 declare interface Social {
     title: boolean;
     description: boolean;