sass-template-common 0.15.12 → 0.16.2

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

@@ -353,8 +353,32 @@ export declare type BucketOriginConfig = {
     cacheTtlMs?: number;
 };
 
+declare type BuildArgs = {
+    route: string;
+    slug: string;
+    page: number;
+    /** Tamano del lote. Es el `NEWS_PER_SECTION` con el que se pinto la pagina 1. */
+    size: number;
+    cfg?: LibraryConfig;
+};
+
 export declare function buildConfigMenuApiPath(servicePrefix: string, configVersion: string, fileName: string): string;
 
+/**
+ * Arma `{ path, params }` para la pagina `page` de `route`.
+ *
+ * `publication` es OBLIGATORIO: sin el, el CMS responde 500 (verificado contra
+ * `news-list-section`). En el resto de la app viaja gratis porque `createAxiosApi`
+ * lo pone como param por default del instance; aca el request se arma a mano.
+ *
+ * Los listados transversales (tema / autor / ultimas-noticias) lo pisan con la
+ * lista de ids de multipublicacion; `seccion` NO, porque sus slugs son propios
+ * de cada publicacion.
+ *
+ * Devuelve `null` si la ruta no es una ruta de listado conocida.
+ */
+export declare function buildLoadMoreRequest({ route, slug, page, size, cfg, }: BuildArgs): LoadMoreCmsRequest | null;
+
 export declare const buildTagUrl: (tag: Tag, paths: RoutePathConfig) => string;
 
 /**
@@ -1266,11 +1290,29 @@ export declare const extractRealtedNews: typeof extractRelatedNews;
  */
 export declare function extractRelatedNews(article: NewListResponseData): Array<Array<string>>;
 
+/** ID de tag en slugs como `lionel-messi-t640863` o `t640863`. */
+export declare const extractTagIdFromSlug: (slug: string) => string;
+
 export declare type FetchConfig = {
     imgSizes: string;
     newsType: string;
 };
 
+declare type FetchMoreArgs = {
+    endpoint: string;
+    route: string;
+    slug: string;
+    page: number;
+    size: number;
+    /** Rama CDN: URL ya armada (con params) + headers. Ausente = endpoint propio. */
+    direct?: {
+        url: string;
+        headers: Record<string, string>;
+    };
+};
+
+export declare function fetchMoreNews({ endpoint, route, slug, page, size, direct, }: FetchMoreArgs): Promise<MoreNewsPage>;
+
 /**
  * Cache in-memory + deduplicación de requests en vuelo (misma clave → misma promesa).
  * TTL corto pensado para SSR: evita 4–5 GETs repetidos de menú/banners por instancia.
@@ -1599,6 +1641,8 @@ export declare const GTM: () => "" | JSX.Element | undefined;
 
 export declare function handleGetComments({ publication, path, size, sizereply, id, lastid, state, apiToken, API_ENV, }: GetCommentsParams): Promise<any>;
 
+export declare function handleListLoadMoreRequest(url: URL, { size, cfg, timeoutMs }: ListLoadMoreHandlerOptions): Promise<Response>;
+
 export declare interface Hascontent {
     hasgalleryvideosflash: boolean;
     hasgalleryvideosyoutube: boolean;
@@ -1914,6 +1958,9 @@ export declare interface Info {
 
 export declare function initLibrary(userConfig?: LibraryConfig): void;
 
+/** Engancha todos los botones "Ver mas" presentes en `scope` (default: el documento). */
+export declare function initListLoadMore(scope?: ParentNode | null): void;
+
 /**
  * Reescribe a "hace 3 horas" el texto de todo `[data-rel-ts]` cuya fecha caiga
  * dentro de `maxAgeHours`, y lo refresca mientras la pestaña esté visible.
@@ -1955,6 +2002,9 @@ export declare interface ISection {
  */
 export declare const isHomePath: (pathname?: string) => boolean;
 
+/** `true` si esta ruta muestra el boton "Ver mas" en lugar del paginador. */
+export declare function isLoadMoreRoute(route: string, cfg?: Pick<LibraryConfig, 'CONFIG_listLoadMore'>): boolean;
+
 export declare const isPhotoGallery: (news: NewListResponseData) => boolean | undefined;
 
 /**
@@ -1972,6 +2022,15 @@ export declare const isPhotoGallery: (news: NewListResponseData) => boolean | un
  */
 export declare function isRecaptchaBlocked(cfg?: Pick<LibraryConfig, 'CONFIG_blockRecaptcha'>): boolean;
 
+/**
+ * ¿El molde es una tarjeta que este renderer sabe completar? Cubre
+ * `section-card-1` y `SectionCard6`, que son las dos que emiten el bloque de
+ * `NewsDescription` (`.sass-com-nd-*`). Una `OpinionCard2` (`.sass-com-oc2-*`)
+ * NO lo emite: ahi el clon saldria con los datos de la primera nota repetidos,
+ * asi que el runtime corta antes de pintar nada.
+ */
+export declare const isSupportedCardTemplate: (template: Element) => boolean;
+
 export declare class IssuuServices {
     private issuuApi;
     private api;
@@ -2113,6 +2172,28 @@ export declare type LibraryConfig = {
      * hidratador de imágenes offline). Default `false` → usa `<HomeCard>` React.
      */
     CONFIG_landingFastRender?: boolean;
+    /**
+     * [listados] Boton "Ver mas" en lugar de ANTERIOR/SIGUIENTE.
+     *
+     * `true` lo prende en todas las rutas de {@link LISTING_ROUTES} con los
+     * defaults; la forma larga ({@link ListLoadMoreConfig}) permite elegir rutas,
+     * tope de paginas y los params del pedido al CMS.
+     *
+     * Prenderlo arrastra, sin tocar codigo de la ruta:
+     *  - `SectionServerComponent` pinta `<ListLoadMore>` en el lugar exacto donde
+     *    pintaba `<NextPrev>`, o sea que hereda su caja y su CSS.
+     *  - `shouldDisablePagination(route)` pasa a `true`, para que el sitio recorte
+     *    la metadata de paginado (`rel=prev` / `rel=next`).
+     *
+     * Lo unico que cada repo monta a mano es el runtime de cliente
+     * (`initListLoadMore()`, un `<script>` en el layout) y el endpoint
+     * (`handleListLoadMoreRequest`, un archivo de ~6 lineas en `src/pages/api/`),
+     * porque ni los `<script>` ni las rutas de Astro se pueden declarar desde un
+     * paquete.
+     *
+     * Default `undefined` -> paginacion clasica, comportamiento actual.
+     */
+    CONFIG_listLoadMore?: boolean | ListLoadMoreConfig;
     /**
      * [render] Fecha relativa ("hace 3 horas") en las superficies que emiten
      * `data-rel-ts`. Solo lo lee el hidratador `initRelativeTime` en el cliente:
@@ -2317,8 +2398,137 @@ export declare interface Link {
 
 export declare function LinkComponent(props: any): JSX.Element;
 
+/** Se emite cuando el boton agrego tarjetas: lo escucha `initRelativeTime`. */
+export declare const LIST_APPENDED_EVENT = "list:appended";
+
+/**
+ * Rutas de listado que el boton "Ver mas" sabe recorrer. Es la key con la que
+ * viaja el `route` desde el boton hasta `buildLoadMoreRequest` y hasta el
+ * endpoint propio del sitio; cada una resuelve a un endpoint distinto del CMS.
+ *
+ * `cartonista` NO es una `MetadataDefaultsKeys` (esa ruta se cuelga de la key
+ * 'autor' para menu / banners / schemas), pero SI es una ruta de listado a
+ * estos efectos.
+ */
+export declare const LISTING_ROUTES: readonly ["seccion", "tema", "ultimas-noticias", "autor", "cartonista"];
+
+export declare type ListingRoute = (typeof LISTING_ROUTES)[number];
+
+/**
+ * Boton "Ver mas": reemplaza a ANTERIOR/SIGUIENTE en las rutas que el sitio
+ * marca en `CONFIG_listLoadMore`.
+ *
+ * Se renderiza en el SERVIDOR (sin `client:`): el boton esta en el HTML desde el
+ * primer byte, no hay salto de layout ni espera de hidratacion. Lo unico que
+ * corre en el cliente es `initListLoadMore`, que lee todo de estos `data-*`.
+ *
+ * Va con las clases del paginador (`sass-com-np-content` + `sass-com-np-linkStyled`)
+ * y en el mismo lugar del arbol a proposito: mismo alto, mismo radio, mismo
+ * color y mismo hover que los links que reemplaza, sin CSS nuevo salvo el reset
+ * del <button>.
+ */
+declare const ListLoadMore: FC<ListLoadMoreProps>;
+export { ListLoadMore }
+export { ListLoadMore as ListLoadMoreComponent }
+
+/**
+ * Forma larga del toggle {@link LibraryConfig.CONFIG_listLoadMore}.
+ */
+export declare type ListLoadMoreConfig = {
+    /** Kill switch. `false` apaga la feature aunque el objeto este presente. */
+    enabled?: boolean;
+    /** Que rutas llevan boton. Default: todas las de {@link LISTING_ROUTES}. */
+    routes?: ListingRoute[];
+    /**
+     * Tope de paginas que el boton deja alcanzar, contando la pagina 1 que ya
+     * pinto el SSR: 5 => 4 clicks (paginas 2, 3, 4 y 5) y despues el boton se
+     * saca del DOM. Default 5.
+     */
+    maxPages?: number;
+    /** Endpoint propio del sitio. Default `/api/get-more-list`. */
+    endpoint?: string;
+    /**
+     * `newstype` del pedido. Tiene que ser el MISMO que usa el router del sitio
+     * para la pagina 1 (`config.newsType`), o la tarjeta 46 no sale del mismo
+     * universo que la 45. Sin valor, el param no se manda y el CMS aplica su
+     * default.
+     */
+    newsType?: string;
+    /**
+     * `imagesizes` del pedido. Mismo criterio: el corte con el que el router
+     * pidio la pagina 1 (tipicamente `imageSizes.note.listStandard`). Sin valor,
+     * el param no se manda y el CMS devuelve sus cortes por default — o sea,
+     * imagenes con otra medida que las del SSR.
+     */
+    imageSizes?: string;
+    /** `exclude` del pedido. Default: el mismo de los routers de listado. */
+    exclude?: string;
+    /**
+     * Opt-in: el browser le pide las notas al CMS por `/hit/*` en vez de al
+     * endpoint propio. Ahorra el paso por el SSR, pero obliga a publicar los dos
+     * tokens (`PUBLIC_X_SECURITY_TOKEN` y `PUBLIC_X_SECURITY_WAF_TOKEN`) en el
+     * HTML de la pagina. Default `false`.
+     */
+    cdnDirect?: boolean;
+    /** Overrides por ruta de `newsType` / `imageSizes`. */
+    routeOverrides?: Partial<Record<ListingRoute, ListLoadMoreRouteOverride>>;
+};
+
+export declare type ListLoadMoreHandlerOptions = {
+    /** Tamano del lote. Es el `config.newsListLimit` del sitio. */
+    size: number;
+    cfg?: LibraryConfig;
+    /**
+     * Techo del pedido al CMS. Sin esto, un lote alto que tarda mas de lo normal
+     * se corta solo del lado de Node y el boton queda sin salida. Default 20 s
+     * (medido: hay lotes que tardan ~9 s, y el resto de la app no pone timeout).
+     */
+    timeoutMs?: number;
+};
+
+export declare type ListLoadMoreProps = {
+    /** Ruta de listado. Es la key con la que viaja hasta el endpoint. */
+    route: string;
+    /** Slug del listado: seccion, tag (`...-t1234`) o usuario del autor. */
+    slug: string;
+    /** Cuantas notas ya pinto el SSR. Lote incompleto = no hay pagina siguiente. */
+    renderedCount: number;
+    /** Tamano del lote (`NEWS_PER_SECTION`). */
+    batchSize: number;
+    /** Pagina que ya esta en pantalla. El boton arranca en `currentPage + 1`. */
+    currentPage?: number;
+    texts?: {
+        [key: string]: string | undefined;
+    };
+    paths: RoutePathConfig;
+    /** Clase de speculation rules, para sacarla de los clones. */
+    prerenderClass?: string;
+    /**
+     * Variante de tarjeta con la que se pinto el listado (el `option` de
+     * `SectionCardServerComponent`). Las variantes de opinion montan
+     * `OpinionCard2`, que el renderer no sabe completar.
+     */
+    cardOption?: string;
+    /** Override del contenedor al que se le hace `appendChild`. */
+    targetSelector?: string;
+    /** Override del selector de la tarjeta molde dentro de ese contenedor. */
+    itemSelector?: string;
+};
+
+/** Overrides de los params del CMS para una ruta puntual. */
+export declare type ListLoadMoreRouteOverride = {
+    newsType?: string;
+    imageSizes?: string;
+};
+
 export declare const LiveBlogHeader: FC<Props_43>;
 
+export declare type LoadMoreCmsRequest = {
+    /** Nombre del endpoint del CMS, sin host ni version de path. */
+    path: string;
+    params: Record<string, string>;
+};
+
 declare const Location_2: FC<Props_23>;
 export { Location_2 as Location }
 
@@ -2545,6 +2755,12 @@ declare interface ModuloNewsletterProps {
 
 export declare const ModuloOpinion: FC<OptionCardBlockProps>;
 
+export declare type MoreNewsPage = {
+    items: NewListResponseData[];
+    /** Mismo criterio que el `showNext` del paginador: lote incompleto = no hay mas. */
+    hasMore: boolean;
+};
+
 declare type Network = {
     title: string;
     slug: string;
@@ -2973,6 +3189,15 @@ export declare type NoteShare = {
 
 export declare type NoteShareOption = 'X' | 'Email' | 'LinkedIn' | 'Whatsapp' | 'FaceBook';
 
+export declare const OpinionCard2: FC<OpinionCardProps>;
+
+declare interface OpinionCardProps {
+    data: NewListResponseData;
+    autorIcon: any;
+    paths: RoutePathConfig;
+    speculationPrerenderClass?: string;
+}
+
 declare interface OptionCardBlockProps {
     title: ReactNode;
     banner?: ReactNode;
@@ -3747,6 +3972,20 @@ declare type Props_8 = {
     custom_bannerPosition?: {
         [key: number]: number;
     };
+    /**
+     * [listados] Identidad del listado para el boton "Ver mas". Es lo UNICO que
+     * cada ruta agrega para sumarse a la feature; el on/off vive en
+     * `CONFIG_listLoadMore` (initLibrary), asi que con el toggle apagado este prop
+     * no hace nada.
+     *
+     * `slug` va aparte del prop `slug` del componente a proposito: ese prop es la
+     * VARIANTE de tarjeta (`option` de `SectionCardServerComponent`), y en varios
+     * repos no coincide con el slug real del listado.
+     */
+    loadMore?: {
+        route: string;
+        slug: string;
+    };
 };
 
 declare type Props_9 = {
@@ -3916,6 +4155,21 @@ export declare type RelativeTimeSurface = 'note' | 'summary';
 
 export declare const removePages: (pathname: string) => string;
 
+export declare type RenderCardContext = {
+    /** Base de las imagenes relativas (`getEnvironmentUrl()` resuelto en el SSR). */
+    imageBase: string;
+    paths: RoutePathConfig;
+    /** `SHOW_TAG_BY_SECTION`: la volanta muestra el primer tag y no la seccion. */
+    showTagBySection: boolean;
+    /** `PUBLIC_LNG` (el mismo valor que lee `formatDate` del singleton en el SSR). */
+    lng: string;
+    timeZone: string;
+    /** Clase de speculation rules a sacar del clon. */
+    prerenderClass?: string;
+};
+
+export declare function renderCardFast(template: Element, item: NewListResponseData, ctx: RenderCardContext): Element;
+
 declare type ReplaceProps = {
     '[author_replace]': string;
     '[section_replace]': string;
@@ -4051,6 +4305,18 @@ export declare function resolveBucketMenuSubtype(path?: string): string;
  */
 export declare function resolveBucketOriginUrl(bucket: BucketOriginConfig, servicePrefix: string | undefined, type: 'menu' | 'banners' | 'bloques', subtype: string, offline?: boolean): string;
 
+/** {@link ListLoadMoreConfig} con todos los defaults ya aplicados. */
+export declare type ResolvedListLoadMore = {
+    routes: readonly ListingRoute[];
+    maxPages: number;
+    endpoint: string;
+    newsType: string;
+    imageSizes: string;
+    exclude: string;
+    cdnDirect: boolean;
+    routeOverrides?: Partial<Record<ListingRoute, ListLoadMoreRouteOverride>>;
+};
+
 /**
  * Recibe lo que el app mande hoy (contrato completo, parcial, o nada) y
  * devuelve SIEMPRE un contrato completo. Los constructores públicos del
@@ -4063,6 +4329,13 @@ export declare function resolveBucketOriginUrl(bucket: BucketOriginConfig, servi
  */
 export declare function resolveImageSizes(input: ImageSizesContractInput | undefined): ImageSizesResolution;
 
+/**
+ * El toggle del boton "Ver mas" con los defaults aplicados, o `null` si el
+ * sitio no lo prendio. Fuente UNICA de la resolucion: la consumen el componente,
+ * el armador de params y el endpoint.
+ */
+export declare function resolveListLoadMore(cfg?: Pick<LibraryConfig, 'CONFIG_listLoadMore'>): ResolvedListLoadMore | null;
+
 /** Clase de prerender para una nota por índice (primer slot: todas las notas). */
 export declare function resolveSpeculationPrerenderClass(index: number, speculationPrerenderClass?: string, speculationPrerender?: SpeculationPrerenderConfig): string | undefined;
 
@@ -4247,6 +4520,14 @@ declare type SelectItem = {
 
 export declare function shareButtons({ noteShare }: Props_34): JSX.Element | null;
 
+/**
+ * `true` si la ruta dejo de paginar de verdad, o sea si el sitio tiene que
+ * recortar la metadata de paginado: sin `rel=prev` / `rel=next` y con el
+ * canonical sin `/page/N`. Hoy es exactamente "esta ruta usa el boton", y existe
+ * aparte para que los consumidores expresen la intencion y no la condicion.
+ */
+export declare function shouldDisablePagination(route: string, cfg?: Pick<LibraryConfig, 'CONFIG_listLoadMore'>): boolean;
+
 export declare const ShowSection: FC<Props_25>;
 
 declare interface Size {