@funhub/platform 0.1.52 → 0.1.54

package/dist/components/biz/business/home-recommend/shared/home-recommend-base.mjs

@@ -1,2 +1,460 @@
 
-"use client";import{gContentGetAppChannelBlockData as e}from"../../../../../service/generated/client.mjs";import{Image as t}from"../../../../ui/image.mjs";import{Box as n}from"../../../../ui/box.mjs";import{Text as r}from"../../../../ui/text.mjs";import{usePaginated as i}from"../../../../../hooks/query/use-query.mjs";import a from"../../../../../assets/icons/detail/video_flag.mjs";import{MiniThreeCard as o}from"../../../../common/cards/mini-three-card.mjs";import{useCallback as s,useEffect as c,useLayoutEffect as l,useMemo as u,useRef as d,useState as f}from"react";import{jsx as p,jsxs as m}from"react/jsx-runtime";import{useRouter as h}from"next/navigation";const g={},_={list:[]};function v({variant:e,props:t=g,data:i=_,mode:a=`renderer`}){let o=h(),{list:v,title:b,cursor:x,block_id:C,channel_id:w}=i,T=Array.isArray(i.icons)?i.icons:[],{moreLink:E,title:D,enableInfinite:O}=t,[A,N]=f(0),P=d(null),F=O===!0,{items:I,icons:L,hasNextPage:R,isFetchingNextPage:z,fetchNextPage:B}=M({blockId:C||``,initialCursor:x||``,initialIcons:T,initialList:v,pageSize:16,enabled:a===`renderer`&&F}),V=e===`waterfall`?6:4,H=I.length>=V?I.length-V:-1,U=d(null),W=d(!1),G=D&&D.trim()||b||``,K=e!==`waterfall`&&!F,q=K?S(E,C||``,w||``):``,J=!!(x&&x.trim()),Y=a===`renderer`&&F&&(J||R===!0),X=s(()=>{q&&(q.startsWith(`http`)?window.location.href=q:o.push(q))},[q,o]);l(()=>{let t=P.current;if(!t||e!==`waterfall`)return;let n=()=>{let e=t.clientWidth||0;N(e>0?(e-12)/2:0)};n();let r=new ResizeObserver(n);return r.observe(t),()=>{r.disconnect()}},[e]),c(()=>{let e=U.current;if(!e||!Y||I.length<16)return;let t=document.getElementById(`app-scroll-container`)||null,n=new IntersectionObserver(e=>{e[0]?.isIntersecting&&(z||W.current||(W.current=!0,B().finally(()=>{W.current=!1})))},{root:t,threshold:0});return n.observe(e),()=>{n.disconnect()}},[Y,B,z,I.length,H]);let Z=u(()=>e===`waterfall`?k(I,L,A):{left:[],right:[]},[A,I,L,e]);return I.length?m(n,{className:`w-full mt-[16px]`,children:[m(n,{className:`flex items-center justify-between px-[12px] mb-[8px]`,children:[p(r,{className:`text-text1 text-[18px] leading-[26px] font-bold line-clamp-1`,children:G}),K&&p(r,{className:`text-text3 text-[12px] leading-[18px] ${q?`cursor-pointer`:``}`,onClick:X,children:`更多`})]}),e===`grid`&&p(n,{className:`w-full flex flex-wrap px-[12px]`,children:I.map((e,t)=>{let n=L[t];return p(`div`,{ref:t===H?U:void 0,className:`w-1/2 px-[6px]`,children:p(y,{item:e,icon:n,index:t,widthStyle:{width:`100%`}})},j(e,t))})}),e===`waterfall`&&m(n,{ref:P,className:`w-full px-[12px] flex gap-[12px]`,children:[p(n,{className:`flex-1 min-w-0 flex flex-col`,children:Z.left.map(e=>p(`div`,{ref:e.index===H?U:void 0,children:p(y,{item:e.item,icon:e.icon,index:e.index,widthStyle:{width:`100%`}})},j(e.item,e.index)))}),p(n,{className:`flex-1 min-w-0 flex flex-col`,children:Z.right.map(e=>p(`div`,{ref:e.index===H?U:void 0,children:p(y,{item:e.item,icon:e.icon,index:e.index,widthStyle:{width:`100%`}})},j(e.item,e.index)))})]})]}):null}function y({item:e,icon:t,index:i,widthStyle:s}){let c=C(e),l=e.name||``,u=T(e.static?.browse_cnt??0),d=w(e),f=O(e,t,i);return p(o,{url:c,text:l,className:`w-full`,style:s,topRightChild:f?p(b,{url:f}):void 0,bottomLeftChild:m(n,{className:`h-[20px] leading-[20px] text-[#fff] text-[12px] px-[4px] rounded-[4px] bg-[#333] ml-[4px] flex items-center`,children:[p(a,{className:`w-[16px] h-[auto] text-[#fff] mr-[4px]`}),u]}),textChild:m(n,{className:`mt-[4px]`,children:[p(r,{as:`h3`,className:`text-text1 text-[14px] leading-[20px] line-clamp-1`,children:l}),d&&p(r,{className:`text-text3 text-[12px] leading-[18px]`,children:d})]}),linkPath:x(e)})}function b({url:e}){return p(n,{className:`relative w-[40px] h-[20px] mr-[6px] mt-[6px]`,children:p(t,{src:e,alt:`corner`,fill:!0,objectFit:`contain`})})}function x(e){let t=encodeURIComponent(e.name||``);return`/video/${e.id||``}/${t}/episode/1`}function S(e,t,n){if(e)return e;if(!t)return``;let r=new URLSearchParams({blockId:t});return n&&r.set(`channelId`,n),`/featured?${r.toString()}`}function C(e){return e.img_y||e.img_x||``}function w(e){if((e.type??0)===2){let t=Number(e.episode_cnt||e.links?.length||0);return t>0?`全${t}集`:``}return D(Number(e.duration||0))}function T(e){return!Number.isFinite(e)||e<=0?`0`:e>=1e6?`${E(e/1e6)}M`:e>=1e3?`${E(e/1e3)}k`:Math.floor(e).toString()}function E(e){let t=e.toFixed(1);return t.endsWith(`.0`)?t.slice(0,-2):t}function D(e){if(!Number.isFinite(e)||e<=0)return``;let t=Math.floor(e),n=Math.floor(t/3600),r=Math.floor(t%3600/60),i=t%60,a=e=>String(e).padStart(2,`0`);return n>0?`${a(n)}:${a(r)}:${a(i)}`:`${a(r)}:${a(i)}`}function O(e,t,n){let r=e;return r.corner_icon_url||r.corner_icon||r.icon_url||t?.material_url||``}function k(e,t,n){let r=[],i=[],a=0,o=0;return e.forEach((e,s)=>{let c=t[s],l=A(n,e);a<=o?(r.push({item:e,icon:c,index:s}),a+=l):(i.push({item:e,icon:c,index:s}),o+=l)}),{left:r,right:i}}function A(e,t){if(!e)return 0;let n=e*1.3461538461538463,r=w(t)?18:0;return n+20+r+6+16}function j(e,t){return e.id?`home-recommend-${e.id}`:`home-recommend-${t}`}function M({blockId:t,initialList:n,initialCursor:r,initialIcons:a,pageSize:o,enabled:p}){let m=n.length>0,h=d(n),g=d(a),[_,v]=f(!1);c(()=>{h.current=n,g.current=a},[a,n]);let y=u(()=>{if(!m)return;let e=r&&r.trim()?r:void 0;return{pages:[{data:{block:{data:{videos:n,icons:a,cursor:r||``}}}}],pageParams:[e]}},[m,r,a,n]),{data:b,fetchNextPage:x,hasNextPage:S,isFetchingNextPage:C}=i({key:[`home-recommend`,t],queryFn:n=>e({block_id:t,cursor:n||void 0,page_size:o}),getNextPageParam:e=>{let t=e.data?.block?.data?.cursor;return t&&t.trim()?t:void 0},options:{enabled:p&&!!t,initialData:y,refetchOnMount:!1,refetchOnWindowFocus:!1,refetchOnReconnect:!1},initialPageParam:m&&r&&r.trim()?r:void 0});l(()=>{v(!0)},[]);let w=u(()=>{if(!_)return{items:m?[...h.current]:[],icons:m?[...g.current]:[]};let e=b?.pages||[],t=[],n=[],r=m?1:0;m&&(t.push(...h.current),n.push(...g.current));for(let i=r;i<e.length;i++){let r=e[i].data?.block?.data,a=r?.videos||[],o=r?.icons||[];t.push(...a),n.push(...o)}return{items:t,icons:n}},[m,_,b?.pages]),T=s(async()=>{await x()},[x]);return{items:w.items,icons:w.icons,hasNextPage:S,isFetchingNextPage:C,fetchNextPage:T}}export{v as default};
+'use client';
+
+import { pContentGetPopularVideoList } from "../../../../../service/generated/client.mjs";
+import { Image } from "../../../../ui/image.mjs";
+import { Box } from "../../../../ui/box.mjs";
+import { Text } from "../../../../ui/text.mjs";
+import SvgVideoFlag from "../../../../../assets/icons/detail/video_flag.mjs";
+import { MiniThreeCard } from "../../../../common/cards/mini-three-card.mjs";
+import { HOME_RECOMMEND_DEFAULT_GRID_COLUMNS, HOME_RECOMMEND_DEFAULT_GRID_ROWS, HOME_RECOMMEND_DEFAULT_PLAY_COUNT_DELTA, HOME_RECOMMEND_DEFAULT_SHOW_EPISODE, HOME_RECOMMEND_DEFAULT_SHOW_PLAY_COUNT, HOME_RECOMMEND_MAX_GRID_COLUMNS, HOME_RECOMMEND_MAX_GRID_ROWS } from "./home-recommend-default-config.mjs";
+import { HOME_RECOMMEND_CARD_CONFIG_FIELD } from "./home-recommend-preview.mjs";
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useRouter } from "next/navigation";
+
+//#region components/biz/business/home-recommend/shared/home-recommend-base.tsx
+/**
+* 首页推荐组件公共渲染逻辑。
+*/
+const SCROLL_ROOT_ID = "app-scroll-container";
+const DEFAULT_PAGE_SIZE = 16;
+const GRID_PREFETCH_OFFSET = 4;
+const WATERFALL_PREFETCH_OFFSET = 6;
+const GRID_COLUMN_GAP = 12;
+const WATERFALL_COLUMN_GAP = 12;
+const COVER_RATIO = 175 / 130;
+const TITLE_LINE_HEIGHT = 20;
+const INFO_LINE_HEIGHT = 18;
+const TEXT_VERTICAL_GAP = 6;
+const CARD_BOTTOM_GAP = 16;
+const emptyPropsConfig = {};
+const emptyData = { list: [] };
+/**
+* 首页推荐组件基础实现。
+*/
+function HomeRecommendBase({ variant, props: propsConfig = emptyPropsConfig, data = emptyData, mode = "renderer" }) {
+	const isEditor = mode === "editor";
+	const router = useRouter();
+	const { list, title, cursor } = data;
+	const initialItems = useMemo(() => Array.isArray(list) ? list : [], [list]);
+	const initialIcons = useMemo(() => Array.isArray(data.icons) ? data.icons : [], [data.icons]);
+	const { rows, columns, moreLink, title: overrideTitle, smartTagEnabled, showPlayCount, playCountDelta, showEpisode, enableInfinite } = propsConfig;
+	const shouldEnableInfinite = enableInfinite === true;
+	const shouldRequestNextPage = !isEditor && shouldEnableInfinite && smartTagEnabled !== true;
+	const [columnWidth, setColumnWidth] = useState(0);
+	const [runtimeItems, setRuntimeItems] = useState(initialItems);
+	const [runtimeIcons, setRuntimeIcons] = useState(initialIcons);
+	const [nextCursor, setNextCursor] = useState(() => normalizeCursor(cursor));
+	const [isFetchingNextPage, setIsFetchingNextPage] = useState(false);
+	const containerRef = useRef(null);
+	const triggerRef = useRef(null);
+	const inFlightRef = useRef(false);
+	useEffect(() => {
+		setRuntimeItems(initialItems);
+		setRuntimeIcons(initialIcons);
+		setNextCursor(normalizeCursor(cursor));
+	}, [
+		cursor,
+		initialIcons,
+		initialItems
+	]);
+	const resolvedGridRows = clampPositiveInt(rows, HOME_RECOMMEND_DEFAULT_GRID_ROWS, HOME_RECOMMEND_MAX_GRID_ROWS);
+	const resolvedGridColumns = clampPositiveInt(columns, HOME_RECOMMEND_DEFAULT_GRID_COLUMNS, HOME_RECOMMEND_MAX_GRID_COLUMNS);
+	const resolvedPageSize = variant === "grid" ? resolvedGridRows * resolvedGridColumns : DEFAULT_PAGE_SIZE;
+	const editorGridLimitCount = resolvedGridRows * resolvedGridColumns;
+	const shouldLimitEditorGrid = isEditor && variant === "grid" && !shouldEnableInfinite;
+	const resolvedItems = shouldLimitEditorGrid ? runtimeItems.slice(0, editorGridLimitCount) : runtimeItems;
+	const resolvedIcons = shouldLimitEditorGrid ? runtimeIcons.slice(0, editorGridLimitCount) : runtimeIcons;
+	const prefetchOffset = variant === "waterfall" ? WATERFALL_PREFETCH_OFFSET : GRID_PREFETCH_OFFSET;
+	const triggerIndex = resolvedItems.length > 0 ? Math.max(0, resolvedItems.length - prefetchOffset) : -1;
+	const hasNextPage = Boolean(nextCursor);
+	const resolvedTitle = overrideTitle && overrideTitle.trim() || title || "";
+	const resolvedShowPlayCount = showPlayCount ?? HOME_RECOMMEND_DEFAULT_SHOW_PLAY_COUNT;
+	const resolvedPlayCountDelta = Number(playCountDelta ?? HOME_RECOMMEND_DEFAULT_PLAY_COUNT_DELTA);
+	const resolvedShowEpisode = showEpisode ?? HOME_RECOMMEND_DEFAULT_SHOW_EPISODE;
+	const shouldShowMore = !shouldEnableInfinite;
+	const resolvedMoreLink = shouldShowMore ? resolveMoreLink(moreLink) : "";
+	const shouldRenderMore = shouldShowMore && Boolean(resolvedMoreLink);
+	/**
+	* 拉取下一页推荐数据（仅客户端无限下拉）。
+	*/
+	const fetchNextPage = useCallback(async () => {
+		const requestCursor = nextCursor;
+		if (!shouldRequestNextPage || !requestCursor || inFlightRef.current) return;
+		inFlightRef.current = true;
+		setIsFetchingNextPage(true);
+		try {
+			const response = await pContentGetPopularVideoList({
+				cursor: requestCursor,
+				page_size: resolvedPageSize
+			});
+			const nextVideos = Array.isArray(response.data?.videos) ? response.data.videos : [];
+			const followingCursor = normalizeCursor(response.data?.cursor);
+			if (nextVideos.length > 0) setRuntimeItems((prev) => prev.concat(nextVideos));
+			setNextCursor((prev) => {
+				if (!nextVideos.length || !followingCursor) return;
+				return followingCursor === prev ? void 0 : followingCursor;
+			});
+		} catch (error) {
+			console.error("推荐位加载下一页失败（client）", error);
+			setNextCursor(void 0);
+		} finally {
+			inFlightRef.current = false;
+			setIsFetchingNextPage(false);
+		}
+	}, [
+		nextCursor,
+		resolvedPageSize,
+		shouldRequestNextPage
+	]);
+	/**
+	* 处理更多按钮点击。
+	*/
+	const handleMoreClick = useCallback(() => {
+		if (!resolvedMoreLink) return;
+		if (resolvedMoreLink.startsWith("http")) window.location.href = resolvedMoreLink;
+		else router.push(resolvedMoreLink);
+	}, [resolvedMoreLink, router]);
+	useEffect(() => {
+		const target = triggerRef.current;
+		if (!target || !shouldRequestNextPage || !hasNextPage) return;
+		const observerRoot = document.getElementById(SCROLL_ROOT_ID) || null;
+		const observer = new IntersectionObserver((entries) => {
+			if (!entries[0]?.isIntersecting || isFetchingNextPage) return;
+			fetchNextPage();
+		}, {
+			root: observerRoot,
+			threshold: 0
+		});
+		observer.observe(target);
+		return () => {
+			observer.disconnect();
+		};
+	}, [
+		fetchNextPage,
+		hasNextPage,
+		isFetchingNextPage,
+		resolvedItems.length,
+		resolvedPageSize,
+		shouldRequestNextPage,
+		triggerIndex
+	]);
+	useLayoutEffect(() => {
+		const container = containerRef.current;
+		if (!container || variant !== "waterfall") return;
+		/**
+		* 更新瀑布流列宽。
+		*/
+		const updateWidth = () => {
+			const width = container.clientWidth || 0;
+			setColumnWidth(width > 0 ? (width - WATERFALL_COLUMN_GAP) / 2 : 0);
+		};
+		updateWidth();
+		const observer = new ResizeObserver(updateWidth);
+		observer.observe(container);
+		return () => {
+			observer.disconnect();
+		};
+	}, [variant]);
+	const waterfallColumns = useMemo(() => {
+		if (variant !== "waterfall") return {
+			left: [],
+			right: []
+		};
+		return buildWaterfallColumns(resolvedItems, resolvedIcons, columnWidth);
+	}, [
+		columnWidth,
+		resolvedIcons,
+		resolvedItems,
+		variant
+	]);
+	if (!resolvedItems.length) return null;
+	return /* @__PURE__ */ jsxs(Box, {
+		className: "w-full mt-[16px]",
+		children: [
+			/* @__PURE__ */ jsxs(Box, {
+				className: "flex items-center justify-between px-[12px] mb-[8px]",
+				children: [/* @__PURE__ */ jsx(Text, {
+					className: "flex-1 min-w-0 text-text1 text-[18px] leading-[26px] font-bold line-clamp-1",
+					children: resolvedTitle
+				}), shouldRenderMore && /* @__PURE__ */ jsx(Text, {
+					className: "text-text3 text-[12px] leading-[18px] cursor-pointer",
+					onClick: handleMoreClick,
+					children: "更多"
+				})]
+			}),
+			variant === "grid" && /* @__PURE__ */ jsx(Box, {
+				className: "w-full flex flex-wrap px-[12px]",
+				children: resolvedItems.map((item, index) => {
+					const icon = resolvedIcons[index];
+					const itemCardConfig = resolveCardDisplayConfig(item);
+					const itemShowPlayCount = resolvedShowPlayCount && (itemCardConfig?.showPlayCount ?? true);
+					const itemPlayCountDelta = itemCardConfig?.playCountDelta ?? resolvedPlayCountDelta;
+					const itemShowEpisode = itemCardConfig?.showEpisode ?? resolvedShowEpisode;
+					const columnIndex = index % resolvedGridColumns;
+					const cardHorizontalStyle = resolvedGridColumns > 1 ? {
+						paddingLeft: GRID_COLUMN_GAP * columnIndex / resolvedGridColumns,
+						paddingRight: GRID_COLUMN_GAP * (resolvedGridColumns - columnIndex - 1) / resolvedGridColumns
+					} : void 0;
+					return /* @__PURE__ */ jsx("div", {
+						ref: index === triggerIndex ? triggerRef : void 0,
+						className: "min-w-0",
+						style: {
+							width: `${100 / resolvedGridColumns}%`,
+							...cardHorizontalStyle || {}
+						},
+						children: /* @__PURE__ */ jsx(HomeRecommendCard, {
+							variant,
+							item,
+							icon,
+							index,
+							showPlayCount: itemShowPlayCount,
+							playCountDelta: itemPlayCountDelta,
+							showEpisode: itemShowEpisode,
+							widthStyle: { width: "100%" }
+						})
+					}, buildItemKey(item, index));
+				})
+			}),
+			variant === "waterfall" && /* @__PURE__ */ jsxs(Box, {
+				ref: containerRef,
+				className: "w-full px-[12px] flex gap-[12px]",
+				children: [/* @__PURE__ */ jsx(Box, {
+					className: "flex-1 min-w-0 flex flex-col",
+					children: waterfallColumns.left.map((entry) => {
+						const itemCardConfig = resolveCardDisplayConfig(entry.item);
+						const itemShowPlayCount = resolvedShowPlayCount && (itemCardConfig?.showPlayCount ?? true);
+						const itemPlayCountDelta = itemCardConfig?.playCountDelta ?? resolvedPlayCountDelta;
+						const itemShowEpisode = itemCardConfig?.showEpisode ?? resolvedShowEpisode;
+						return /* @__PURE__ */ jsx("div", {
+							ref: entry.index === triggerIndex ? triggerRef : void 0,
+							children: /* @__PURE__ */ jsx(HomeRecommendCard, {
+								variant,
+								item: entry.item,
+								icon: entry.icon,
+								index: entry.index,
+								showPlayCount: itemShowPlayCount,
+								playCountDelta: itemPlayCountDelta,
+								showEpisode: itemShowEpisode,
+								widthStyle: { width: "100%" }
+							})
+						}, buildItemKey(entry.item, entry.index));
+					})
+				}), /* @__PURE__ */ jsx(Box, {
+					className: "flex-1 min-w-0 flex flex-col",
+					children: waterfallColumns.right.map((entry) => {
+						const itemCardConfig = resolveCardDisplayConfig(entry.item);
+						const itemShowPlayCount = resolvedShowPlayCount && (itemCardConfig?.showPlayCount ?? true);
+						const itemPlayCountDelta = itemCardConfig?.playCountDelta ?? resolvedPlayCountDelta;
+						const itemShowEpisode = itemCardConfig?.showEpisode ?? resolvedShowEpisode;
+						return /* @__PURE__ */ jsx("div", {
+							ref: entry.index === triggerIndex ? triggerRef : void 0,
+							children: /* @__PURE__ */ jsx(HomeRecommendCard, {
+								variant,
+								item: entry.item,
+								icon: entry.icon,
+								index: entry.index,
+								showPlayCount: itemShowPlayCount,
+								playCountDelta: itemPlayCountDelta,
+								showEpisode: itemShowEpisode,
+								widthStyle: { width: "100%" }
+							})
+						}, buildItemKey(entry.item, entry.index));
+					})
+				})]
+			})
+		]
+	});
+}
+/**
+* 首页推荐卡片渲染组件。
+*/
+function HomeRecommendCard({ variant, item, icon, index, showPlayCount, playCountDelta: _playCountDelta, showEpisode, widthStyle }) {
+	const coverUrl = resolveCoverUrl(item);
+	const titleText = item.name || "";
+	const playCount = formatPlayCount(item.static?.browse_cnt ?? 0);
+	const videoInfo = buildVideoInfoText(item, showEpisode);
+	const cornerIconUrl = resolveCornerIconUrl(item, icon, index);
+	return /* @__PURE__ */ jsx(MiniThreeCard, {
+		url: coverUrl,
+		text: titleText,
+		className: "w-full",
+		style: widthStyle,
+		topRightChild: cornerIconUrl ? /* @__PURE__ */ jsx(CornerIcon, { url: cornerIconUrl }) : void 0,
+		bottomLeftChild: showPlayCount ? /* @__PURE__ */ jsxs(Box, {
+			className: "h-[20px] leading-[20px] text-[#fff] text-[12px] px-[4px] rounded-[4px] bg-[#333] ml-[4px] flex items-center",
+			children: [/* @__PURE__ */ jsx(SvgVideoFlag, { className: "w-[16px] h-[auto] text-[#fff] mr-[4px]" }), playCount]
+		}) : null,
+		bottomRightChild: showEpisode ? videoInfo && /* @__PURE__ */ jsx(Text, {
+			className: "text-[#fff] text-[12px] leading-[18px] pr-2",
+			children: videoInfo
+		}) : null,
+		textChild: /* @__PURE__ */ jsx(Box, {
+			className: "mt-[4px]",
+			children: /* @__PURE__ */ jsx(Text, {
+				as: "h3",
+				className: variant === "waterfall" ? "text-text1 text-[14px] leading-[20px] break-words" : "text-text1 text-[14px] leading-[20px] line-clamp-1",
+				children: titleText
+			})
+		}),
+		linkPath: buildDetailPath(item)
+	});
+}
+/**
+* 角标图片渲染组件。
+*/
+function CornerIcon({ url }) {
+	return /* @__PURE__ */ jsx(Box, {
+		className: "relative w-[40px] h-[20px]",
+		children: /* @__PURE__ */ jsx(Image, {
+			src: url,
+			alt: "corner",
+			fill: true,
+			objectFit: "cover"
+		})
+	});
+}
+/**
+* 根据内容数据生成详情页链接。
+*/
+function buildDetailPath(info) {
+	const encodedName = encodeURIComponent(info.name || "");
+	return `/video/${info.id || ""}/${encodedName}/episode/1`;
+}
+/**
+* 解析推荐位“更多”跳转链接。
+*/
+function resolveMoreLink(moreLink) {
+	if (!moreLink) return "";
+	return moreLink.trim();
+}
+/**
+* 将配置值归一化为正整数并限制上限。
+*/
+function clampPositiveInt(value, fallback, max) {
+	const normalized = Number(value);
+	if (!Number.isFinite(normalized) || normalized <= 0) return fallback;
+	return Math.min(max, Math.floor(normalized));
+}
+/**
+* 解析单卡显示配置。
+*/
+function resolveCardDisplayConfig(item) {
+	return item[HOME_RECOMMEND_CARD_CONFIG_FIELD];
+}
+/**
+* 解析封面图 URL。
+*/
+function resolveCoverUrl(item) {
+	return item.img_y || item.img_x || "";
+}
+/**
+* 将不同结构的角标字段解析成图片 URL。
+*/
+function resolveIconUrl(source) {
+	return typeof source === "string" ? source : "";
+}
+/**
+* 根据内容类型生成视频信息文案。
+*/
+function buildVideoInfoText(item, showEpisode) {
+	if ((item.type ?? 0) === 2) {
+		if (!showEpisode) return "";
+		const totalEpisodes = Number(item.episode_cnt || item.links?.length || 0);
+		return totalEpisodes > 0 ? `全${totalEpisodes}集` : "";
+	}
+	return formatDuration(Number(item.duration || 0));
+}
+/**
+* 格式化播放量。
+*/
+function formatPlayCount(value) {
+	if (!Number.isFinite(value) || value <= 0) return "0";
+	if (value >= 1e6) return `${trimDecimal(value / 1e6)}M`;
+	if (value >= 1e3) return `${trimDecimal(value / 1e3)}k`;
+	return Math.floor(value).toString();
+}
+/**
+* 保留一位小数并去掉尾随 .0。
+*/
+function trimDecimal(value) {
+	const fixed = value.toFixed(1);
+	return fixed.endsWith(".0") ? fixed.slice(0, -2) : fixed;
+}
+/**
+* 格式化视频时长为 HH:mm:ss 或 mm:ss。
+*/
+function formatDuration(duration) {
+	if (!Number.isFinite(duration) || duration <= 0) return "";
+	const totalSeconds = Math.floor(duration);
+	const hours = Math.floor(totalSeconds / 3600);
+	const minutes = Math.floor(totalSeconds % 3600 / 60);
+	const seconds = totalSeconds % 60;
+	const formatNumber = (value) => String(value).padStart(2, "0");
+	if (hours > 0) return `${formatNumber(hours)}:${formatNumber(minutes)}:${formatNumber(seconds)}`;
+	return `${formatNumber(minutes)}:${formatNumber(seconds)}`;
+}
+/**
+* 解析角标图片 URL。
+*/
+function resolveCornerIconUrl(item, icon, _index) {
+	return resolveIconUrl(item.badge_url) || resolveIconUrl(icon?.material_url) || "";
+}
+/**
+* 生成瀑布流布局列数据。
+*/
+function buildWaterfallColumns(items, icons, columnWidth) {
+	const left = [];
+	const right = [];
+	let leftHeight = 0;
+	let rightHeight = 0;
+	items.forEach((item, index) => {
+		const icon = icons[index];
+		const estimatedHeight = estimateCardHeight(columnWidth, item);
+		if (leftHeight <= rightHeight) {
+			left.push({
+				item,
+				icon,
+				index
+			});
+			leftHeight += estimatedHeight;
+		} else {
+			right.push({
+				item,
+				icon,
+				index
+			});
+			rightHeight += estimatedHeight;
+		}
+	});
+	return {
+		left,
+		right
+	};
+}
+/**
+* 预估瀑布流卡片高度，用于分配列。
+*/
+function estimateCardHeight(columnWidth, item) {
+	if (!columnWidth) return 0;
+	const coverHeight = columnWidth * COVER_RATIO;
+	const infoHeight = buildVideoInfoText(item, true) ? INFO_LINE_HEIGHT : 0;
+	return coverHeight + TITLE_LINE_HEIGHT + infoHeight + TEXT_VERTICAL_GAP + CARD_BOTTOM_GAP;
+}
+/**
+* 归一化分页游标。
+*/
+function normalizeCursor(cursor) {
+	if (typeof cursor !== "string") return;
+	return cursor.trim() || void 0;
+}
+/**
+* 生成列表项唯一 key。
+*/
+function buildItemKey(item, index) {
+	return item.id ? `home-recommend-${item.id}` : `home-recommend-${index}`;
+}
+
+//#endregion
+export { HomeRecommendBase as default };

package/dist/components/biz/business/home-recommend/shared/home-recommend-default-config.mjs

@@ -0,0 +1,25 @@
+
+//#region components/biz/business/home-recommend/shared/home-recommend-default-config.ts
+/**
+* 首页推荐共享默认配置。
+* 统一维护，避免 base/preview/schema 多处重复定义后发生偏差。
+*/
+const HOME_RECOMMEND_DEFAULT_TITLE = "推荐";
+const HOME_RECOMMEND_DEFAULT_GRID_ROWS = 1;
+const HOME_RECOMMEND_DEFAULT_GRID_COLUMNS = 2;
+const HOME_RECOMMEND_MAX_GRID_ROWS = 10;
+const HOME_RECOMMEND_MAX_GRID_COLUMNS = 6;
+const HOME_RECOMMEND_DEFAULT_SMART_TAG_ENABLED = false;
+const HOME_RECOMMEND_DEFAULT_SHOW_PLAY_COUNT = true;
+const HOME_RECOMMEND_DEFAULT_PLAY_COUNT_DELTA = 0;
+const HOME_RECOMMEND_DEFAULT_SHOW_EPISODE = true;
+const HOME_RECOMMEND_DEFAULT_ENABLE_INFINITE = false;
+/**
+* 首页推荐数据源模式由智能铺设开关唯一决定。
+*/
+function resolveHomeRecommendFeedMode(smartTagEnabled) {
+	return smartTagEnabled === true ? "manual-with-video-detail" : "popular";
+}
+
+//#endregion
+export { HOME_RECOMMEND_DEFAULT_ENABLE_INFINITE, HOME_RECOMMEND_DEFAULT_GRID_COLUMNS, HOME_RECOMMEND_DEFAULT_GRID_ROWS, HOME_RECOMMEND_DEFAULT_PLAY_COUNT_DELTA, HOME_RECOMMEND_DEFAULT_SHOW_EPISODE, HOME_RECOMMEND_DEFAULT_SHOW_PLAY_COUNT, HOME_RECOMMEND_DEFAULT_SMART_TAG_ENABLED, HOME_RECOMMEND_DEFAULT_TITLE, HOME_RECOMMEND_MAX_GRID_COLUMNS, HOME_RECOMMEND_MAX_GRID_ROWS, resolveHomeRecommendFeedMode };

package/dist/components/biz/business/home-recommend/shared/home-recommend-preview.mjs

@@ -1,2 +1,126 @@
 
-const e=`/static/components-thumb/video_player.png`,t=Array.from({length:12},(t,n)=>{let r=n%2==1,i={browse_cnt:12345+n*731};return{id:`preview-recommend-${n+1}`,name:`媒资标题 ${n+1}`,img_y:e,img_x:e,type:r?2:1,duration:r?0:60*(18+n),episode_cnt:r?12+n%3*6:0,static:i}});function n(e,t){return t?8:e===`waterfall`?4:2}function r(e){let n=Math.max(1,Math.floor(e));return Array.from({length:n},(e,n)=>({...t[n%t.length],id:`preview-recommend-${n+1}`,name:`媒资标题 ${n+1}`}))}function i({variant:e,schemaTitle:t,enableInfinite:i,data:a}){let o=Array.isArray(a?.list)?a.list.filter(Boolean):[],s=n(e,i);return{title:t&&t.trim()||a?.title||`推荐位名称`,list:o.length?o:r(s),icons:Array.isArray(a?.icons)?a.icons:[],cursor:a?.cursor||``,block_id:a?.block_id||``,channel_id:a?.channel_id||``,show_style:a?.show_style}}export{i as buildHomeRecommendEditorPreviewData};
+import { HOME_RECOMMEND_DEFAULT_GRID_COLUMNS, HOME_RECOMMEND_DEFAULT_GRID_ROWS, HOME_RECOMMEND_DEFAULT_TITLE, HOME_RECOMMEND_MAX_GRID_COLUMNS, HOME_RECOMMEND_MAX_GRID_ROWS } from "./home-recommend-default-config.mjs";
+
+//#region components/biz/business/home-recommend/shared/home-recommend-preview.ts
+const EDITOR_PREVIEW_COVER = "/static/components-thumb/video_player.png";
+const GRID_PREVIEW_FALLBACK_CARD_COUNT = 2;
+const WATERFALL_PREVIEW_CARD_COUNT = 4;
+const INFINITE_PREVIEW_CARD_COUNT = 8;
+const PREVIEW_POOL_SIZE = 60;
+const HOME_RECOMMEND_CARD_CONFIG_FIELD = "__homeRecommendCardConfig";
+const editorPreviewPool = Array.from({ length: PREVIEW_POOL_SIZE }, (_, index) => {
+	const isSeries = index % 2 === 1;
+	const previewStatic = { browse_cnt: 12345 + index * 731 };
+	return {
+		id: `preview-recommend-${index + 1}`,
+		name: `${"媒资标题".repeat((index + 1) * 2)}`,
+		img_y: EDITOR_PREVIEW_COVER,
+		img_x: EDITOR_PREVIEW_COVER,
+		type: isSeries ? 2 : 1,
+		duration: isSeries ? 0 : 60 * (18 + index),
+		episode_cnt: isSeries ? 12 + index % 3 * 6 : 0,
+		static: previewStatic
+	};
+});
+/**
+* 根据 schema 配置计算编辑器预览卡片数量。
+*/
+function resolveHomeRecommendEditorPreviewCount({ variant, enableInfinite, rows, columns, items }) {
+	const manualItemCount = Array.isArray(items) ? items.length : 0;
+	if (enableInfinite) return Math.max(INFINITE_PREVIEW_CARD_COUNT, manualItemCount);
+	if (variant === "waterfall") return Math.max(WATERFALL_PREVIEW_CARD_COUNT, manualItemCount);
+	return Math.max(resolveGridPreviewCount(rows, columns), GRID_PREVIEW_FALLBACK_CARD_COUNT, manualItemCount);
+}
+/**
+* 构建编辑器预览用列表（不足时循环补齐）。
+*/
+function buildEditorPreviewList(count) {
+	const safeCount = Math.max(1, Math.floor(count));
+	return Array.from({ length: safeCount }, (_, index) => {
+		const source = editorPreviewPool[index % editorPreviewPool.length];
+		return {
+			...source,
+			id: `preview-recommend-${index + 1}`,
+			name: source.name
+		};
+	});
+}
+/**
+* 将手动配置覆盖到预览列表上。
+*/
+function applyManualItemConfigs(sourceList, itemConfigs, sourceMapById) {
+	if (!itemConfigs.length) return sourceList;
+	return sourceList.map((sourceItem, index) => {
+		const config = itemConfigs[index];
+		if (!config) return sourceItem;
+		const resolvedSource = (config.contentId ? sourceMapById.get(config.contentId) : void 0) || sourceItem;
+		const resolvedTitle = config.titleMode === "custom" ? config.title?.trim() || resolvedSource.name || sourceItem.name || "" : resolvedSource.name || sourceItem.name || "";
+		const shouldUseUploadCover = config.coverMode === "upload" && Boolean(config.coverUrl);
+		const resolvedCoverY = shouldUseUploadCover ? config.coverUrl || "" : resolvedSource.img_y || resolvedSource.img_x || sourceItem.img_y || sourceItem.img_x || "";
+		const resolvedCoverX = shouldUseUploadCover ? config.coverUrl || "" : resolvedSource.img_x || resolvedSource.img_y || sourceItem.img_x || sourceItem.img_y || "";
+		const sourceBadge = resolvedSource.badge_url || sourceItem.badge_url || "";
+		const resolvedBadge = config.badge_url ?? sourceBadge;
+		const cardConfig = resolveCardDisplayConfig(config, resolvedSource);
+		return {
+			...sourceItem,
+			...resolvedSource,
+			id: resolvedSource.id || sourceItem.id || `preview-recommend-${index + 1}`,
+			name: resolvedTitle,
+			img_y: resolvedCoverY,
+			img_x: resolvedCoverX,
+			badge_url: resolvedBadge || void 0,
+			[HOME_RECOMMEND_CARD_CONFIG_FIELD]: cardConfig
+		};
+	});
+}
+/**
+* 合并单卡显示配置。
+*/
+function resolveCardDisplayConfig(config, sourceItem) {
+	const sourceConfig = sourceItem[HOME_RECOMMEND_CARD_CONFIG_FIELD];
+	const resolved = {
+		showPlayCount: config.showPlayCount ?? sourceConfig?.showPlayCount,
+		playCountDelta: config.playCountDelta ?? sourceConfig?.playCountDelta,
+		showEpisode: config.showEpisode ?? sourceConfig?.showEpisode
+	};
+	if (resolved.showPlayCount === void 0 && resolved.playCountDelta === void 0 && resolved.showEpisode === void 0) return;
+	return resolved;
+}
+/**
+* 计算宫格预览卡片数。
+*/
+function resolveGridPreviewCount(rows, columns) {
+	return clampInteger(rows, HOME_RECOMMEND_DEFAULT_GRID_ROWS, 1, HOME_RECOMMEND_MAX_GRID_ROWS) * clampInteger(columns, HOME_RECOMMEND_DEFAULT_GRID_COLUMNS, 1, HOME_RECOMMEND_MAX_GRID_COLUMNS);
+}
+/**
+* 将输入值归一化为整数并限制区间。
+*/
+function clampInteger(value, fallback, min, max) {
+	const normalized = Number(value);
+	if (!Number.isFinite(normalized)) return fallback;
+	return Math.min(max, Math.max(min, Math.floor(normalized)));
+}
+/**
+* 构建编辑器预览的推荐位数据（由 schema 驱动）。
+*/
+function buildHomeRecommendEditorPreviewData({ variant, schemaTitle, enableInfinite, smartTagEnabled, rows, columns, items }) {
+	const sourceMapById = /* @__PURE__ */ new Map();
+	const manualItems = smartTagEnabled ? [] : Array.isArray(items) ? items.filter(Boolean) : [];
+	const resolvedList = applyManualItemConfigs(buildEditorPreviewList(resolveHomeRecommendEditorPreviewCount({
+		variant,
+		enableInfinite,
+		rows,
+		columns,
+		items: manualItems
+	})), manualItems, sourceMapById);
+	return {
+		title: schemaTitle && schemaTitle.trim() || HOME_RECOMMEND_DEFAULT_TITLE,
+		list: resolvedList,
+		icons: [],
+		cursor: "",
+		show_style: void 0
+	};
+}
+
+//#endregion
+export { HOME_RECOMMEND_CARD_CONFIG_FIELD, buildHomeRecommendEditorPreviewData };