sass-template-common 0.11.0 → 0.11.1

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,31 @@ 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;
+};
+
+/**
+ * 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 +3018,8 @@ 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;
 };
 
 declare type Props_3 = {
@@ -3971,6 +4022,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;