@funhub/platform 0.1.53 → 0.1.54

package/dist/components/biz/business/home-recommend/{variants/home-recommend-waterfall → home-recommend-waterfall}/material.d.mts

@@ -1,20 +1,21 @@
 
-import { SchemaHasDefaultValue } from "../../../../../../utils/schema/schema.mjs";
-import { DefineMaterialOption } from "../../../../../../utils/schema/material.mjs";
-import "../../../../../../utils/schema/index.mjs";
-import { HomeRecommendWaterfallPrefetchClient } from "./runtime/prefetch-client.mjs";
+import { SchemaHasDefaultValue } from "../../../../../utils/schema/schema.mjs";
+import { DefineMaterialOption } from "../../../../../utils/schema/material.mjs";
+import "../../../../../utils/schema/index.mjs";
+import { HomeRecommendWaterfallClient } from "./client.mjs";
 import { HomeRecommendWaterfall } from "./server.mjs";
 import * as zod from "zod";
 import * as zod_v4_core0 from "zod/v4/core";
 
-//#region components/biz/business/home-recommend/variants/home-recommend-waterfall/material.d.ts
-declare const homeRecommendWaterfallMaterial: DefineMaterialOption<typeof HomeRecommendWaterfall, typeof HomeRecommendWaterfallPrefetchClient, zod.ZodObject<{
+//#region components/biz/business/home-recommend/home-recommend-waterfall/material.d.ts
+declare const homeRecommendWaterfallMaterial: DefineMaterialOption<typeof HomeRecommendWaterfall, typeof HomeRecommendWaterfallClient, zod.ZodObject<{
   smartTagEnabled: zod.ZodBoolean & SchemaHasDefaultValue;
   title: zod.ZodString & SchemaHasDefaultValue;
   showPlayCount: zod.ZodBoolean & SchemaHasDefaultValue;
   playCountDelta: zod.ZodNumber & SchemaHasDefaultValue;
   showEpisode: zod.ZodBoolean & SchemaHasDefaultValue;
   enableInfinite: zod.ZodBoolean & SchemaHasDefaultValue;
+  moreLink: zod.ZodOptional<zod.ZodString> & SchemaHasDefaultValue;
   smartTagIds: zod.ZodOptional<zod.ZodArray<zod.ZodString>>;
   items: zod.ZodOptional<zod.ZodArray<zod.ZodObject<{
     contentId: zod.ZodString;
@@ -23,6 +24,7 @@ declare const homeRecommendWaterfallMaterial: DefineMaterialOption<typeof HomeRe
       upload: "upload";
     }>>;
     coverUrl: zod.ZodOptional<zod.ZodString>;
+    badge_url: zod.ZodOptional<zod.ZodString>;
     titleMode: zod.ZodOptional<zod.ZodEnum<{
       content: "content";
       custom: "custom";
@@ -36,6 +38,6 @@ declare const homeRecommendWaterfallMaterial: DefineMaterialOption<typeof HomeRe
     renderer: "renderer";
     editor: "editor";
   }>>;
-}, zod_v4_core0.$strip>, "home-recommend-waterfall">;
+}, zod_v4_core0.$strip>, "home-recommend-waterfall", "内容组件">;
 //#endregion
 export { homeRecommendWaterfallMaterial };

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

@@ -0,0 +1,19 @@
+
+import { defineMaterial } from "../../../../../utils/schema/material.mjs";
+import HomeRecommendWaterfallClient from "./client.mjs";
+import { homeRecommendWaterfallInspectorPropsSchema } from "./inspector-schema.mjs";
+import { HomeRecommendWaterfall } from "./server.mjs";
+
+//#region components/biz/business/home-recommend/home-recommend-waterfall/material.ts
+const homeRecommendWaterfallMaterial = defineMaterial({
+	type: "home-recommend-waterfall",
+	name: "瀑布流",
+	icon: "/static/components-thumb/grid_waterfall_two_column.png",
+	category: "内容组件",
+	serverComponent: HomeRecommendWaterfall,
+	clientComponent: HomeRecommendWaterfallClient,
+	propsSchema: homeRecommendWaterfallInspectorPropsSchema
+});
+
+//#endregion
+export { homeRecommendWaterfallMaterial };

package/dist/components/biz/business/home-recommend/home-recommend-waterfall/schema.d.mts

@@ -0,0 +1,11 @@
+
+import { ComponentSchema } from "../../../utils/schema/component.mjs";
+import "../../../utils/index.mjs";
+
+//#region components/biz/business/home-recommend/home-recommend-waterfall/schema.d.ts
+/**
+ * HomeRecommendWaterfall 组件 Schema 定义。
+ */
+declare const schema: ComponentSchema;
+//#endregion
+export { schema };

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

@@ -0,0 +1,25 @@
+
+import { commonStyleSchema } from "../../../utils/styles/schema.mjs";
+import { homeRecommendWaterfallPropsSchema } from "./inspector-schema.mjs";
+
+//#region components/biz/business/home-recommend/home-recommend-waterfall/schema.ts
+/**
+* HomeRecommendWaterfall 组件 Schema 定义。
+*/
+const schema = {
+	componentName: "HomeRecommendWaterfall",
+	displayName: "瀑布流",
+	category: "HomeRecommend",
+	categoryName: "内容组件",
+	enabled: true,
+	propsSchema: homeRecommendWaterfallPropsSchema,
+	dataSchema: { dataBinding: {
+		field: "videos",
+		sourceType: "dynamic"
+	} },
+	styleSchema: { ...commonStyleSchema },
+	eventSchema: {}
+};
+
+//#endregion
+export { schema };

package/dist/components/biz/business/home-recommend/{variants/home-recommend-waterfall → home-recommend-waterfall}/server.d.mts

@@ -2,7 +2,7 @@
 import { HomeRecommendWaterfallInspectorProps } from "./inspector-schema.mjs";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
 
-//#region components/biz/business/home-recommend/variants/home-recommend-waterfall/server.d.ts
+//#region components/biz/business/home-recommend/home-recommend-waterfall/server.d.ts
 /** HomeRecommendWaterfall 物料组件 props。 */
 type HomeRecommendWaterfallProps = HomeRecommendWaterfallInspectorProps;
 /**
@@ -11,4 +11,4 @@ type HomeRecommendWaterfallProps = HomeRecommendWaterfallInspectorProps;
  */
 declare function HomeRecommendWaterfall(props: HomeRecommendWaterfallProps): Promise<react_jsx_runtime0.JSX.Element>;
 //#endregion
-export { HomeRecommendWaterfall };
+export { HomeRecommendWaterfall, HomeRecommendWaterfallProps };

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

@@ -0,0 +1,38 @@
+
+import HomeRecommendWaterfallClient from "./client.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(items) {
+	const count = Array.isArray(items) ? items.length : 0;
+	return count > 0 ? count : DEFAULT_PAGE_SIZE;
+}
+/**
+* HomeRecommendWaterfall 物料组件
+* 接收 inspector 可编辑的 props，转换为 BaseComponentProps 传给 runtime client
+*/
+async function HomeRecommendWaterfall(props) {
+	const { mode = "renderer", ...runtimeProps } = props;
+	if (mode !== "renderer") return /* @__PURE__ */ jsx(HomeRecommendWaterfallClient, {
+		...runtimeProps,
+		mode
+	});
+	const resolved = await resolveHomeRecommendServerData({
+		smartTagEnabled: runtimeProps.smartTagEnabled,
+		pageSize: resolveWaterfallPageSize(runtimeProps.items),
+		items: runtimeProps.items
+	});
+	return /* @__PURE__ */ jsx(HomeRecommendWaterfallClient, {
+		...runtimeProps,
+		prefetchData: resolved.data,
+		mode
+	});
+}
+
+//#endregion
+export { HomeRecommendWaterfall };

package/dist/components/biz/business/home-recommend/index.d.mts

@@ -1,13 +1,13 @@
 
-import { homeRecommendGridInspectorDefaultProps, homeRecommendGridInspectorPropsSchema } from "./variants/home-recommend-grid/inspector-schema.mjs";
-import { HomeRecommendGridPrefetchClient } from "./variants/home-recommend-grid/runtime/prefetch-client.mjs";
-import { schema } from "./variants/home-recommend-grid/schema/index.mjs";
-import { HomeRecommendGrid } from "./variants/home-recommend-grid/server.mjs";
-import { homeRecommendGridMaterial } from "./variants/home-recommend-grid/material.mjs";
-import "./variants/home-recommend-grid/index.mjs";
-import { homeRecommendWaterfallInspectorDefaultProps, homeRecommendWaterfallInspectorPropsSchema } from "./variants/home-recommend-waterfall/inspector-schema.mjs";
-import { HomeRecommendWaterfallPrefetchClient } from "./variants/home-recommend-waterfall/runtime/prefetch-client.mjs";
-import { schema as schema$1 } from "./variants/home-recommend-waterfall/schema/index.mjs";
-import { HomeRecommendWaterfall } from "./variants/home-recommend-waterfall/server.mjs";
-import { homeRecommendWaterfallMaterial } from "./variants/home-recommend-waterfall/material.mjs";
-import "./variants/home-recommend-waterfall/index.mjs";
+import { homeRecommendGridInspectorDefaultProps, homeRecommendGridInspectorPropsSchema } from "./home-recommend-grid/inspector-schema.mjs";
+import { HomeRecommendGridClient } from "./home-recommend-grid/client.mjs";
+import { schema } from "./home-recommend-grid/schema.mjs";
+import { HomeRecommendGrid } from "./home-recommend-grid/server.mjs";
+import { homeRecommendGridMaterial } from "./home-recommend-grid/material.mjs";
+import "./home-recommend-grid/index.mjs";
+import { homeRecommendWaterfallInspectorDefaultProps, homeRecommendWaterfallInspectorPropsSchema } from "./home-recommend-waterfall/inspector-schema.mjs";
+import { HomeRecommendWaterfallClient } from "./home-recommend-waterfall/client.mjs";
+import { schema as schema$1 } from "./home-recommend-waterfall/schema.mjs";
+import { HomeRecommendWaterfall } from "./home-recommend-waterfall/server.mjs";
+import { homeRecommendWaterfallMaterial } from "./home-recommend-waterfall/material.mjs";
+import "./home-recommend-waterfall/index.mjs";

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

@@ -1,2 +1,460 @@
 
-"use client";import{gContentGetPopularVideoList 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{HOME_RECOMMEND_DEFAULT_GRID_COLUMNS as s,HOME_RECOMMEND_DEFAULT_GRID_ROWS as c,HOME_RECOMMEND_DEFAULT_PLAY_COUNT_DELTA as l,HOME_RECOMMEND_DEFAULT_SHOW_EPISODE as u,HOME_RECOMMEND_DEFAULT_SHOW_PLAY_COUNT as d,HOME_RECOMMEND_MAX_GRID_COLUMNS as f,HOME_RECOMMEND_MAX_GRID_ROWS as p}from"./home-recommend-default-config.mjs";import{resolveHomeRecommendFeedMode as m}from"./home-recommend-feed-mode.mjs";import{HOME_RECOMMEND_CARD_CONFIG_FIELD as h}from"./home-recommend-preview.mjs";import{enrichHomeRecommendItemsWithVideoDetails as g}from"./home-recommend-video-detail.mjs";import{useCallback as _,useEffect as v,useLayoutEffect as ee,useMemo as y,useRef as b,useState as x}from"react";import{jsx as S,jsxs as C}from"react/jsx-runtime";import{useRouter as te}from"next/navigation";const ne={},re={list:[]};function ie({variant:e,props:t=ne,data:i=re,mode:a=`renderer`}){let o=a===`editor`,h=!o,g=te(),{list:ie,title:ae,cursor:T,block_id:O,channel_id:k}=i,A=Array.isArray(i.icons)?i.icons:[],{rows:se,columns:j,moreLink:M,title:N,showPlayCount:P,playCountDelta:I,showEpisode:ue,enableInfinite:de}=t,[fe,pe]=x(0),me=b(null),he=m(t.smartTagEnabled),L=de===!0,{items:R,icons:z,hasNextPage:ge,isFetchingNextPage:B,fetchNextPage:V}=le({feedMode:he,blockId:O||``,initialCursor:T||``,initialIcons:A,initialList:ie,pageSize:16,enabled:h,enableInfinite:L}),_e=E(se,c,p),H=E(j,s,f),U=_e*H,W=o&&e===`grid`&&!L,G=W?R.slice(0,U):R,ve=W?z.slice(0,U):z,K=e===`waterfall`?6:4,q=G.length>=K?G.length-K:-1,J=b(null),Y=b(!1),ye=N&&N.trim()||ae||``,X=P??d,Z=Number(I??l),Q=ue??u,be=e!==`waterfall`&&!L,$=be?oe(M,O||``,k||``):``,xe=!!(T&&T.trim()),Se=h&&L&&(xe||ge===!0),Ce=_(()=>{$&&($.startsWith(`http`)?window.location.href=$:g.push($))},[$,g]);ee(()=>{let t=me.current;if(!t||e!==`waterfall`)return;let n=()=>{let e=t.clientWidth||0;pe(e>0?(e-12)/2:0)};n();let r=new ResizeObserver(n);return r.observe(t),()=>{r.disconnect()}},[e]),v(()=>{let e=J.current;if(!e||!Se||G.length<16)return;let t=document.getElementById(`app-scroll-container`)||null,n=new IntersectionObserver(e=>{e[0]?.isIntersecting&&(B||Y.current||(Y.current=!0,V().finally(()=>{Y.current=!1})))},{root:t,threshold:0});return n.observe(e),()=>{n.disconnect()}},[Se,V,B,G.length,q]);let we=y(()=>e===`waterfall`?ce(R,z,fe):{left:[],right:[]},[fe,R,z,e]);return G.length?C(n,{className:`w-full mt-[16px]`,children:[C(n,{className:`flex items-center justify-between px-[12px] mb-[8px]`,children:[S(r,{className:`text-text1 text-[18px] leading-[26px] font-bold line-clamp-1`,children:ye}),be&&S(r,{className:`text-text3 text-[12px] leading-[18px] ${$?`cursor-pointer`:``}`,onClick:Ce,children:`更多`})]}),e===`grid`&&S(n,{className:`w-full flex flex-wrap px-[12px]`,children:G.map((t,n)=>{let r=ve[n],i=D(t),a=X&&(i?.showPlayCount??!0),o=i?.playCountDelta??Z,s=i?.showEpisode??Q,c=n%H,l=H>1?{paddingLeft:12*c/H,paddingRight:12*(H-c-1)/H}:void 0;return S(`div`,{ref:n===q?J:void 0,className:`min-w-0`,style:{width:`${100/H}%`,...l||{}},children:S(w,{variant:e,item:t,icon:r,index:n,showPlayCount:a,playCountDelta:o,showEpisode:s,widthStyle:{width:`100%`}})},F(t,n))})}),e===`waterfall`&&C(n,{ref:me,className:`w-full px-[12px] flex gap-[12px]`,children:[S(n,{className:`flex-1 min-w-0 flex flex-col`,children:we.left.map(t=>{let n=D(t.item),r=X&&(n?.showPlayCount??!0),i=n?.playCountDelta??Z,a=n?.showEpisode??Q;return S(`div`,{ref:t.index===q?J:void 0,children:S(w,{variant:e,item:t.item,icon:t.icon,index:t.index,showPlayCount:r,playCountDelta:i,showEpisode:a,widthStyle:{width:`100%`}})},F(t.item,t.index))})}),S(n,{className:`flex-1 min-w-0 flex flex-col`,children:we.right.map(t=>{let n=D(t.item),r=X&&(n?.showPlayCount??!0),i=n?.playCountDelta??Z,a=n?.showEpisode??Q;return S(`div`,{ref:t.index===q?J:void 0,children:S(w,{variant:e,item:t.item,icon:t.icon,index:t.index,showPlayCount:r,playCountDelta:i,showEpisode:a,widthStyle:{width:`100%`}})},F(t.item,t.index))})})]})]}):null}function w({variant:e,item:t,icon:i,index:s,showPlayCount:c,playCountDelta:l,showEpisode:u,widthStyle:d}){let f=O(t),p=t.name||``,m=se(t.static?.browse_cnt??0),h=A(t,u),g=N(t,i,s);return S(o,{url:f,text:p,className:`w-full`,style:d,topRightChild:g?S(ae,{url:g}):void 0,bottomLeftChild:c?C(n,{className:`h-[20px] leading-[20px] text-[#fff] text-[12px] px-[4px] rounded-[4px] bg-[#333] ml-[4px] flex items-center`,children:[S(a,{className:`w-[16px] h-[auto] text-[#fff] mr-[4px]`}),m]}):null,bottomRightChild:u?h&&S(r,{className:`text-[#fff] text-[12px] leading-[18px] pr-2`,children:h}):null,textChild:S(n,{className:`mt-[4px]`,children:S(r,{as:`h3`,className:e===`waterfall`?`text-text1 text-[14px] leading-[20px] line-clamp-5`:`text-text1 text-[14px] leading-[20px] line-clamp-1`,children:p})}),linkPath:T(t)})}function ae({url:e}){return S(n,{className:`relative w-[40px] h-[20px]`,children:S(t,{src:e,alt:`corner`,fill:!0,objectFit:`cover`})})}function T(e){let t=encodeURIComponent(e.name||``);return`/video/${e.id||``}/${t}/episode/1`}function oe(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 E(e,t,n){let r=Number(e);return!Number.isFinite(r)||r<=0?t:Math.min(n,Math.floor(r))}function D(e){return e[h]}function O(e){return e.img_y||e.img_x||``}function k(e){return typeof e==`string`?e:``}function A(e,t){if((e.type??0)===2){if(!t)return``;let n=Number(e.episode_cnt||e.links?.length||0);return n>0?`全${n}集`:``}return M(Number(e.duration||0))}function se(e){return!Number.isFinite(e)||e<=0?`0`:e>=1e6?`${j(e/1e6)}M`:e>=1e3?`${j(e/1e3)}k`:Math.floor(e).toString()}function j(e){let t=e.toFixed(1);return t.endsWith(`.0`)?t.slice(0,-2):t}function M(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 N(e,t,n){return k(e.badge_url)||k(t?.material_url)||``}function ce(e,t,n){let r=[],i=[],a=0,o=0;return e.forEach((e,s)=>{let c=t[s],l=P(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 P(e,t){if(!e)return 0;let n=e*1.3461538461538463,r=A(t,!0)?18:0;return n+20+r+6+16}function F(e,t){return e.id?`home-recommend-${e.id}`:`home-recommend-${t}`}function I(e){if(typeof e==`string`)return e.trim()||void 0}function le({feedMode:t,blockId:n,initialList:r,initialCursor:a,initialIcons:o,pageSize:s,enabled:c,enableInfinite:l}){let u=r.length>0,[d,f]=x(!1),p=y(()=>{if(!u)return;let e=I(a);return{pages:[{items:r,icons:o,nextCursor:e}],pageParams:[e]}},[u,a,o,r]),{data:m,fetchNextPage:h,hasNextPage:v,isFetchingNextPage:b}=i({key:[`home-recommend`,t,n||`popular`],queryFn:async n=>{let r=await e({cursor:I(n),page_size:s}),i=r.data?.videos||[],a=i;if(t===`popular-with-video-detail`)try{a=await g(i)}catch(e){console.error(`推荐位批量补齐视频详情失败（client）`,e)}return{items:a,icons:[],nextCursor:I(r.data?.cusor)}},getNextPageParam:e=>{if(l)return I(e.nextCursor)},options:{enabled:c,initialData:p,refetchOnMount:!1,refetchOnWindowFocus:!1,refetchOnReconnect:!1},initialPageParam:u?I(a):``});ee(()=>{f(!0)},[]);let S=y(()=>{if(!d)return{items:u?[...r]:[],icons:u?[...o]:[]};let e=m?.pages||[],t=[],n=[],i=u?1:0;u&&(t.push(...r),n.push(...o));for(let r=i;r<e.length;r++){let i=e[r];t.push(...i.items||[]),n.push(...i.icons||[])}return{items:t,icons:n}},[u,o,r,d,m?.pages]),C=_(async()=>{await h()},[h]);return{items:S.items,icons:S.icons,hasNextPage:l?v:!1,isFetchingNextPage:b,fetchNextPage:C}}export{ie 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 };