@funhub/platform 0.1.126 → 0.1.130

package/dist/components/biz/business/home-recommend/home-recommend-waterfall/server.mjs

@@ -1,2 +1,45 @@
 
-import e from"./client.mjs";import{normalizeHomeRecommendRuntimeProps as t}from"../shared/home-recommend-runtime-props.mjs";import{resolveHomeRecommendServerData as n}from"../shared/home-recommend-server-data.mjs";import{jsx as r}from"react/jsx-runtime";function i(e,t){if(e===!0)return 16;let n=Array.isArray(t)?t.length:0;return n<=0?16:n}async function a(a){let{mode:o=`renderer`,...s}=a,c=t(s);if(o!==`renderer`)return r(e,{...c,mode:o});let l=await n({smartTagEnabled:c.smartTagEnabled,smartTagIds:c.smartTagIds,catId:c.catId,enableInfinite:c.enableInfinite,pageSize:i(c.enableInfinite,c.items),items:c.items});return r(e,{...c,prefetchData:l.data,mode:o})}export{a as HomeRecommendWaterfall};
+import HomeRecommendWaterfallClient from "./client.mjs";
+import { normalizeHomeRecommendRuntimeProps } from "../shared/home-recommend-runtime-props.mjs";
+import { resolveHomeRecommendServerData } from "../shared/home-recommend-server-data.mjs";
+import { jsx } from "react/jsx-runtime";
+
+//#region components/biz/business/home-recommend/home-recommend-waterfall/server.tsx
+const DEFAULT_PAGE_SIZE = 16;
+/**
+* 解析瀑布流推荐位服务端分页数量。
+*/
+function resolveWaterfallPageSize(enableInfinite, items) {
+	if (enableInfinite === true) return DEFAULT_PAGE_SIZE;
+	const count = Array.isArray(items) ? items.length : 0;
+	if (count <= 0) return DEFAULT_PAGE_SIZE;
+	return count;
+}
+/**
+* HomeRecommendWaterfall 物料组件
+* 接收 inspector 可编辑的 props，转换为 BaseComponentProps 传给 runtime client
+*/
+async function HomeRecommendWaterfall(props) {
+	const { mode = "renderer", ...rawRuntimeProps } = props;
+	const runtimeProps = normalizeHomeRecommendRuntimeProps(rawRuntimeProps);
+	if (mode !== "renderer") return /* @__PURE__ */ jsx(HomeRecommendWaterfallClient, {
+		...runtimeProps,
+		mode
+	});
+	const resolved = await resolveHomeRecommendServerData({
+		smartTagEnabled: runtimeProps.smartTagEnabled,
+		smartTagIds: runtimeProps.smartTagIds,
+		catId: runtimeProps.catId,
+		enableInfinite: runtimeProps.enableInfinite,
+		pageSize: resolveWaterfallPageSize(runtimeProps.enableInfinite, runtimeProps.items),
+		items: runtimeProps.items
+	});
+	return /* @__PURE__ */ jsx(HomeRecommendWaterfallClient, {
+		...runtimeProps,
+		prefetchData: resolved.data,
+		mode
+	});
+}
+
+//#endregion
+export { HomeRecommendWaterfall };

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

@@ -1,2 +1,499 @@
 
-"use client";import{pContentGetPopularVideoList 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 i from"../../../../../assets/icons/detail/video_flag.mjs";import{MiniThreeCard as a}from"../../../../common/cards/mini-three-card.mjs";import{HOME_RECOMMEND_DEFAULT_GRID_COLUMNS as o,HOME_RECOMMEND_DEFAULT_GRID_ROWS as s,HOME_RECOMMEND_DEFAULT_PLAY_COUNT_DELTA as c,HOME_RECOMMEND_DEFAULT_SHOW_EPISODE as l,HOME_RECOMMEND_DEFAULT_SHOW_PLAY_COUNT as u,HOME_RECOMMEND_MAX_GRID_COLUMNS as ee,HOME_RECOMMEND_MAX_GRID_ROWS as te}from"./home-recommend-default-config.mjs";import{HOME_RECOMMEND_CARD_CONFIG_FIELD as d}from"./home-recommend-preview.mjs";import{useCallback as f,useEffect as p,useLayoutEffect as m,useMemo as h,useRef as g,useState as _}from"react";import{jsx as v,jsxs as y}from"react/jsx-runtime";import{useRouter as ne}from"next/navigation";const re={},ie={list:[]};function b({variant:t,props:i=re,data:a=ie,mode:d=`renderer`}){let b=d===`editor`,S=ne(),{list:C,title:se,cursor:T}=a,E=h(()=>Array.isArray(C)?C:[],[C]),D=h(()=>Array.isArray(a.icons)?a.icons:[],[a.icons]),{rows:O,columns:ce,moreLink:k,title:A,smartTagEnabled:j,smartTagIds:M,catId:ue,showPlayCount:de,playCountDelta:fe,showEpisode:pe,enableInfinite:me}=i,F=me===!0&&j===!0,I=!b&&F&&E.length>=16,L=h(()=>Array.isArray(M)?M.map(e=>String(e||``).trim()).filter(Boolean):[],[M]),R=typeof ue==`string`?ue.trim():``,[z,he]=_(0),[ge,_e]=_(E),[ve,ye]=_(D),[B,V]=_(()=>N(T)),[be,xe]=_(!1),Se=g(null),H=g(null),U=g(!1);p(()=>{_e(E),ye(D),V(N(T))},[T,D,E]);let Ce=oe(O,s,te),W=oe(ce,o,ee),G=F?16:t===`grid`?Ce*W:16,we=Ce*W,Te=b&&t===`grid`,K=Te?ge.slice(0,we):ge,q=Te?ve.slice(0,we):ve,Ee=t===`waterfall`?6:4,J=K.length>0?Math.max(0,K.length-Ee):-1,De=!!B,Oe=A&&A.trim()||se||``,Y=de??u,X=Number(fe??c),Z=pe??l,ke=!F,Q=ke?ae(k):``,Ae=ke&&!!Q,je=f(async()=>{let t=B;if(!(!I||!t||U.current)){U.current=!0,xe(!0);try{let n=await e({cursor:t,page_size:G,tags:L.length>0?L:void 0,cat_id:R||void 0}),r=Array.isArray(n.data?.videos)?n.data.videos:[],i=N(n.data?.cursor);r.length>0&&_e(e=>e.concat(r)),V(e=>{if(!(!r.length||!i))return i===e?void 0:i})}catch(e){console.error(`推荐位加载下一页失败（client）`,e),V(void 0)}finally{U.current=!1,xe(!1)}}},[B,R,G,L,I]),Me=f(()=>{Q&&(Q.startsWith(`http`)?window.location.href=Q:S.push(Q))},[Q,S]);p(()=>{let e=H.current;if(!e||!I||!De)return;let t=new IntersectionObserver(e=>{!e[0]?.isIntersecting||be||je()},{root:null,threshold:0});return t.observe(e),()=>{t.disconnect()}},[je,De,be,K.length,G,I,J]),m(()=>{let e=Se.current;if(!e||t!==`waterfall`)return;let n=()=>{let t=e.clientWidth||0;he(t>0?(t-12)/2:0)};n();let r=new ResizeObserver(n);return r.observe(e),()=>{r.disconnect()}},[t]);let $=h(()=>t===`waterfall`?le(K,q,z):{left:[],right:[]},[z,q,K,t]);return K.length?y(n,{className:`w-full mt-[16px]`,children:[y(n,{className:`flex items-center justify-between px-[12px] mb-[8px]`,children:[v(r,{className:`flex-1 min-w-0 text-text1 text-[18px] leading-[26px] font-bold line-clamp-1`,children:Oe}),Ae&&v(r,{className:`text-text3 text-[12px] leading-[18px] cursor-pointer`,onClick:Me,children:`更多`})]}),t===`grid`&&v(n,{className:`w-full flex flex-wrap px-[12px]`,children:K.map((e,n)=>{let r=q[n],i=w(e),a=Y&&(i?.showPlayCount??!0),o=i?.playCountDelta??X,s=i?.showEpisode??Z,c=n%W,l=W>1?{paddingLeft:12*c/W,paddingRight:12*(W-c-1)/W}:void 0;return v(`div`,{ref:n===J?H:void 0,className:`min-w-0`,style:{width:`${100/W}%`,...l||{}},children:v(x,{variant:t,item:e,icon:r,index:n,showPlayCount:a,playCountDelta:o,showEpisode:s,widthStyle:{width:`100%`}})},P(e,n))})}),t===`waterfall`&&y(n,{ref:Se,className:`w-full px-[12px] flex gap-[12px]`,children:[v(n,{className:`flex-1 min-w-0 flex flex-col`,children:$.left.map(e=>{let n=w(e.item),r=Y&&(n?.showPlayCount??!0),i=n?.playCountDelta??X,a=n?.showEpisode??Z;return v(`div`,{ref:e.index===J?H:void 0,children:v(x,{variant:t,item:e.item,icon:e.icon,index:e.index,showPlayCount:r,playCountDelta:i,showEpisode:a,widthStyle:{width:`100%`}})},P(e.item,e.index))})}),v(n,{className:`flex-1 min-w-0 flex flex-col`,children:$.right.map(e=>{let n=w(e.item),r=Y&&(n?.showPlayCount??!0),i=n?.playCountDelta??X,a=n?.showEpisode??Z;return v(`div`,{ref:e.index===J?H:void 0,children:v(x,{variant:t,item:e.item,icon:e.icon,index:e.index,showPlayCount:r,playCountDelta:i,showEpisode:a,widthStyle:{width:`100%`}})},P(e.item,e.index))})})]})]}):null}function x({variant:e,item:t,icon:o,index:s,showPlayCount:c,playCountDelta:l,showEpisode:u,widthStyle:ee}){let te=se(t),d=t.name||t?.title||``,f=O(ce(t.static?.browse_cnt??0,l)),p=E(t,u),m=j(t,o,s);return v(a,{url:te,text:d,className:`w-full`,style:ee,topRightChild:m?v(S,{url:m}):void 0,bottomLeftChild:c?y(n,{className:`h-[20px] leading-[20px] text-[#fff] text-[12px] px-[4px] rounded-[4px] bg-[#333] ml-[4px] flex items-center`,children:[v(i,{className:`w-[16px] h-[auto] text-[#fff] mr-[4px]`}),f]}):null,bottomRightChild:u?p&&v(r,{className:`text-[#fff] text-[12px] leading-[18px] pr-2`,children:p}):null,textChild:v(n,{className:`py-[4px]`,children:v(r,{as:`h3`,className:`text-text1 text-[16px] leading-[24px] ${e===`waterfall`?`break-words line-clamp-3`:`line-clamp-1`}`,children:d})}),linkPath:C(t)})}function S({url:e}){return v(n,{className:`relative w-[40px] h-[20px]`,children:v(t,{src:e,alt:`corner`,width:40,height:20,className:`w-full h-auto`})})}function C(e){let t=encodeURIComponent(e.name||``);return`/video/${e.id||``}/${t}/episode/1`}function ae(e){return e?e.trim():``}function oe(e,t,n){let r=Number(e);return!Number.isFinite(r)||r<=0?t:Math.min(n,Math.floor(r))}function w(e){return e[d]}function se(e){return e.img_y||e.img_x||e?.coverUrl}function T(e){return typeof e==`string`?e:``}function E(e,t){if(!t)return``;if(D(e)){let t=Number(e.episode_cnt||e.links?.length||0);return t>0?`全${t}集`:``}return A(Number(e.duration||0))}function D(e){if(Number(e.type??0)===2)return!0;let t=Number(e.episode_cnt||e.links?.length||0);return Number.isFinite(t)&&t>1}function O(e){return!Number.isFinite(e)||e<=0?`0`:e>=1e6?`${k(e/1e6)}M`:e>=1e3?`${k(e/1e3)}k`:Math.floor(e).toString()}function ce(e,t){let n=Number(e||0),r=Number(t||0);return!Number.isFinite(n)||!Number.isFinite(r)?0:Math.max(0,n+r)}function k(e){let t=e.toFixed(1);return t.endsWith(`.0`)?t.slice(0,-2):t}function A(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 j(e,t,n){return T(e.badge_url)||T(t?.material_url)||``}function le(e,t,n){let r=[],i=[],a=n<=0,o=0,s=0;return e.forEach((e,c)=>{let l=t[c];if(a){c%2==0?r.push({item:e,icon:l,index:c}):i.push({item:e,icon:l,index:c});return}let u=M(n,e);o<=s?(r.push({item:e,icon:l,index:c}),o+=u):(i.push({item:e,icon:l,index:c}),s+=u)}),{left:r,right:i}}function M(e,t){if(!e)return 0;let n=e*1.3461538461538463,r=E(t,!0)?18:0;return n+20+r+6+16}function N(e){if(typeof e==`string`)return e.trim()||void 0}function P(e,t){return e.id?`home-recommend-${e.id}`:`home-recommend-${t}`}export{b 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 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, smartTagIds, catId, showPlayCount, playCountDelta, showEpisode, enableInfinite } = propsConfig;
+	const shouldEnableInfinite = enableInfinite === true && smartTagEnabled === true;
+	const shouldRequestNextPage = !isEditor && shouldEnableInfinite && initialItems.length >= DEFAULT_PAGE_SIZE;
+	const resolvedSmartTagIds = useMemo(() => {
+		if (!Array.isArray(smartTagIds)) return [];
+		return smartTagIds.map((item) => String(item || "").trim()).filter(Boolean);
+	}, [smartTagIds]);
+	const resolvedCatId = typeof catId === "string" ? catId.trim() : "";
+	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 = shouldEnableInfinite ? DEFAULT_PAGE_SIZE : variant === "grid" ? resolvedGridRows * resolvedGridColumns : DEFAULT_PAGE_SIZE;
+	const editorGridLimitCount = resolvedGridRows * resolvedGridColumns;
+	const shouldLimitEditorGrid = isEditor && variant === "grid";
+	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,
+				tags: resolvedSmartTagIds.length > 0 ? resolvedSmartTagIds : void 0,
+				cat_id: resolvedCatId || void 0
+			});
+			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,
+		resolvedCatId,
+		resolvedPageSize,
+		resolvedSmartTagIds,
+		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 observer = new IntersectionObserver((entries) => {
+			if (!entries[0]?.isIntersecting || isFetchingNextPage) return;
+			fetchNextPage();
+		}, {
+			root: null,
+			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, showEpisode, widthStyle }) {
+	const coverUrl = resolveCoverUrl(item);
+	const titleText = item.name || item?.title || "";
+	const playCount = formatPlayCount(applyPlayCountDelta(item.static?.browse_cnt ?? 0, playCountDelta));
+	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: "py-[4px]",
+			children: /* @__PURE__ */ jsx(Text, {
+				as: "h3",
+				className: `text-text1 text-[16px] leading-[24px] ${variant === "waterfall" ? "break-words line-clamp-3" : "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",
+			width: 40,
+			height: 20,
+			className: "w-full h-auto"
+		})
+	});
+}
+/**
+* 根据内容数据生成详情页链接。
+*/
+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 || item?.coverUrl;
+}
+/**
+* 将不同结构的角标字段解析成图片 URL。
+*/
+function resolveIconUrl(source) {
+	return typeof source === "string" ? source : "";
+}
+/**
+* 根据内容类型生成视频信息文案。
+*/
+function buildVideoInfoText(item, showEpisode) {
+	if (!showEpisode) return "";
+	if (isSeriesContent(item)) {
+		const totalEpisodes = Number(item.episode_cnt || item.links?.length || 0);
+		return totalEpisodes > 0 ? `全${totalEpisodes}集` : "";
+	}
+	return formatDuration(Number(item.duration || 0));
+}
+/**
+* 根据多字段兜底判断当前内容是否为剧集。
+*/
+function isSeriesContent(item) {
+	if (Number(item.type ?? 0) === 2) return true;
+	const totalEpisodes = Number(item.episode_cnt || item.links?.length || 0);
+	return Number.isFinite(totalEpisodes) && totalEpisodes > 1;
+}
+/**
+* 格式化播放量。
+*/
+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();
+}
+/**
+* 播放量浮动。
+*/
+function applyPlayCountDelta(base, delta) {
+	const resolvedBase = Number(base || 0);
+	const resolvedDelta = Number(delta || 0);
+	if (!Number.isFinite(resolvedBase) || !Number.isFinite(resolvedDelta)) return 0;
+	return Math.max(0, resolvedBase + resolvedDelta);
+}
+/**
+* 保留一位小数并去掉尾随 .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 = [];
+	const shouldUseEvenSplit = columnWidth <= 0;
+	let leftHeight = 0;
+	let rightHeight = 0;
+	items.forEach((item, index) => {
+		const icon = icons[index];
+		if (shouldUseEvenSplit) {
+			if (index % 2 === 0) left.push({
+				item,
+				icon,
+				index
+			});
+			else right.push({
+				item,
+				icon,
+				index
+			});
+			return;
+		}
+		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

@@ -1,2 +1,26 @@
 
-const e=`推荐`,t=1,n=2,r=10,i=6,a=!1,o=!0,s=0,c=!0,l=!1;function u(e){return e===!0?`manual-with-video-detail`:`popular`}export{l as HOME_RECOMMEND_DEFAULT_ENABLE_INFINITE,n as HOME_RECOMMEND_DEFAULT_GRID_COLUMNS,t as HOME_RECOMMEND_DEFAULT_GRID_ROWS,s as HOME_RECOMMEND_DEFAULT_PLAY_COUNT_DELTA,c as HOME_RECOMMEND_DEFAULT_SHOW_EPISODE,o as HOME_RECOMMEND_DEFAULT_SHOW_PLAY_COUNT,a as HOME_RECOMMEND_DEFAULT_SMART_TAG_ENABLED,e as HOME_RECOMMEND_DEFAULT_TITLE,i as HOME_RECOMMEND_MAX_GRID_COLUMNS,r as HOME_RECOMMEND_MAX_GRID_ROWS,u as resolveHomeRecommendFeedMode};
+//#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;
+/**
+* 首页推荐数据源模式由智能铺设开关唯一决定。
+* 说明：`manual-with-video-detail` 是历史枚举值，当前语义用于“智能铺设开启”。
+*/
+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 };