sass-template-common 0.11.0 → 0.11.11

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

@@ -316,6 +316,15 @@ export declare function buildConfigMenuApiPath(servicePrefix: string, configVers
 
 export declare const buildTagUrl: (tag: Tag, paths: RoutePathConfig) => string;
 
+/**
+ * Reconstruye la URL pública desde `info.link.internal`. Es el inverso exacto
+ * de `getVideoRealPath`, que es quien la vuelve a resolver en `/video/[…slug]`.
+ */
+export declare const buildVideoUrlFromInternal: (internal: string, options?: {
+    videoPath?: string;
+    title?: string;
+}) => string;
+
 declare interface ButtonCSS {
     '--button-background-color'?: string;
     '--button-color'?: string;
@@ -1406,8 +1415,18 @@ export declare const getSlugs: {
 /** String (o undefined) para una clave dinámica; nunca devuelve el objeto `comentarios`. */
 export declare function getTextsStringValue(texts: textsType, key: string): string | undefined;
 
+export declare function getTitleString(title: string | {
+    article?: string;
+    home?: string;
+    section?: string;
+    seo?: string;
+} | undefined): string;
+
 export declare const getTypeOfNews: (props: Props) => string;
 
+/** `vf` | `vy` | `ve` si la entrada es un video; `undefined` si es nota. */
+export declare const getVideoOp: (item: any) => VideoOp | undefined;
+
 export declare function getVideoRealPath(pathname: string): {
     path: string;
     op: string;
@@ -1688,6 +1707,8 @@ export declare interface ImageSizesResolution {
 
 export declare interface Info {
     type?: string;
+    /** Tipo de video cuando `type === 'video'`: flash, youtube o embedded. */
+    videoOp?: 'vf' | 'vy' | 've';
     section?: {
         name: string;
         slug: string;
@@ -1752,6 +1773,9 @@ export declare class IssuuServices {
     getListIssuuPublicationBySlug(slug: string): Promise<AxiosResponse<any, any, {}> | undefined>;
 }
 
+/** True para videos (flash, youtube y embedded) en cualquiera de sus formas. */
+export declare const isVideoContentItem: (item: any) => boolean;
+
 export declare interface ItemFormatedType extends NewListResponseData {
     gallery?: Array<Preview>;
     videos?: Array<VideoItem>;
@@ -2577,6 +2601,42 @@ export declare interface NewsResponse {
 
 export declare const NextPrev: FC<Props_36>;
 
+/**
+ * Deja la entrada del ranking lista para `Readest`/`NewDescriptionBlock`.
+ * Idempotente: una entrada ya normalizada (o una nota completa) se devuelve
+ * tal cual, sin copia.
+ */
+export declare const normalizeRankingItem: (item: any, options?: NormalizeRankingOptions) => NewListResponseData | null;
+
+/**
+ * Normaliza la lista completa del ranking. Descarta las entradas sin título:
+ * son las que hoy se cuelan como slot numerado en blanco.
+ */
+export declare const normalizeRankingList: (list: unknown, options?: NormalizeRankingOptions) => Array<NewListResponseData>;
+
+export declare type NormalizeRankingOptions = {
+    /** Prefijo de la ruta de ficha de video. Default: `video`. */
+    videoPath?: string;
+    /**
+     * Sección sintética para las entradas de video, que no tienen una propia (el
+     * bucket las manda como `section: { name: null }`). `name` sale de los textos
+     * del sitio y `url` de `paths.videos`; si falta cualquiera de los dos el video
+     * queda sin chip en vez de enlazar a una ruta inventada.
+     */
+    videoSection?: {
+        name?: string;
+        url?: string;
+        slug?: string;
+    };
+};
+
+/**
+ * Normaliza el payload del bucket sin tocar su envoltorio, sea la respuesta de
+ * axios (`{ data: { data: [...] } }`) o el fallback de `resilientFetch`
+ * (`{ data: [...] }`).
+ */
+export declare const normalizeRankingResponse: <T>(response: T, options?: NormalizeRankingOptions) => T;
+
 export declare const NOTA_PRERENDER_CLASS = "nota-prerender";
 
 export declare type NoteShare = {
@@ -2969,6 +3029,13 @@ declare type Props_29 = {
     isHome?: boolean;
     paths: RoutePathConfig;
     speculationPrerenderClass?: string;
+    /** Prefijo de la ficha de video para las entradas de video del ranking. */
+    videoPath?: string;
+    /**
+     * Label del chip de video. Default: `videosSectionTitle` de los textos del
+     * idioma activo. Los sitios lo pasan desde su propio `getTexts()`.
+     */
+    videosSectionLabel?: string;
 };
 
 declare type Props_3 = {
@@ -3160,6 +3227,8 @@ declare type Props_47 = {
     ranking: Array<NewListResponseData>;
     paths: RoutePathConfig;
     readestCustomStyles?: CSSProperties;
+    /** Label del chip de sección de los videos del ranking (textos del sitio). */
+    videosSectionLabel?: string;
 };
 
 declare type Props_48 = {
@@ -3464,6 +3533,12 @@ export declare interface RoutePathConfig {
     contacto?: string | 'contacto';
     anuncia?: string | 'anuncia';
     'ultimas-noticias': string | 'ultimas-noticias';
+    /**
+     * Segmento del listado de videos. Opcional a propósito: es lo que habilita el
+     * chip de sección en las entradas de video del ranking, y no todos los sitios
+     * tienen la ruta. Sin él no se inventa un `/videos` que daría 404.
+     */
+    videos?: string | 'videos';
 }
 
 export declare function runConfigOriginComparison(params: {
@@ -3793,6 +3868,12 @@ export declare type TextsListsAndSearch = {
     relatedNewsTitle: string;
     moreNewsTitle: string;
     searchKeyWord: string;
+    /**
+     * Label del chip de sección de las entradas de video del ranking (las notas
+     * traen la sección del CMS; los videos no tienen una). Opcional: sin valor el
+     * video queda sin chip en vez de mostrar un texto inventado.
+     */
+    videosSectionTitle?: string;
 };
 
 /** Etiquetas de segmentos de URL (paths) */
@@ -3802,6 +3883,8 @@ export declare type TextsPathLabels = {
     buscar: string;
     seccion: string;
     'ultimas-noticias': string;
+    /** Listado de videos. Opcional: no todos los sitios tienen la ruta. */
+    videos?: string;
 };
 
 /** Cinta de ediciones y copyright */
@@ -3971,6 +4054,21 @@ export declare interface VideoItem {
     clip: string;
 }
 
+/**
+ * El ranking (bucket GA4) mezcla notas y videos, pero NO los emite con la misma
+ * forma: la nota llega completa (`info.link.url`, `main.title.home/section`,
+ * `config`, `authors`…) y el video llega degradado —solo `info.link.internal` +
+ * `info.link.canonical`, `main.title.article` y `preview`—.
+ *
+ * Sin normalizar, un video ocupa un slot en blanco: `NewDescriptionBlock` no
+ * pinta la imagen (condiciona a `main.title.home`), `NewsDescription` no pinta
+ * el título (lee `main.title.section`) ni lo enlaza (lee `info.link.url`).
+ *
+ * Este helper lleva cualquier entrada del ranking a `NewListResponseData`
+ * completo, resolviendo la URL pública del video (flash, youtube y embedded).
+ */
+export declare type VideoOp = 'vf' | 'vy' | 've';
+
 export declare interface VideoResponseData {
     config: {
         autoplay: boolean;