@funhub/platform 0.2.30 → 0.2.31

package/dist/utils/get-res-url.mjs

@@ -1,2 +1,95 @@
 
-let e,t,n=!1;function r(){return typeof window<`u`}function i(e,t=2e3){return new Promise((n,r)=>{let i=new XMLHttpRequest,a=performance.now(),o=!1,s=window.setTimeout(()=>{o||(o=!0,i.abort(),r(Error(`timeout`)))},t);i.onreadystatechange=()=>{if(!o&&i.readyState===2){o=!0,clearTimeout(s);let e=performance.now()-a;i.abort(),n(e)}},i.onerror=()=>{o||(o=!0,clearTimeout(s),r(Error(`network error`)))},i.open(`GET`,e,!0),i.send()})}async function a(e,t){if(!t||t.length===0)return``;let n=t.map(t=>{let n=new URL(t+e);return n.searchParams.set(`_t`,String(Date.now())),n.toString()}),r=(await Promise.allSettled(n.map(e=>i(e)))).map((e,t)=>({r:e,i:t})).filter(e=>e.r.status===`fulfilled`).map(e=>({url:n[e.i],ms:e.r.value})).sort((e,t)=>e.ms-t.ms);if(!r.length)return``;try{return new URL(r[0].url).origin}catch(e){return console.warn(`Failed to parse fastest host URL:`,e),``}}function o(){if(!t&&(t=process.env.NEXT_PUBLIC_DEFAULT_CDN||``,!t))return console.warn(`NEXT_PUBLIC_DEFAULT_CDN is not configured`),``;if(!r())return t;let i=process.env.NEXT_PUBLIC_CDN_LIST;if(!i)return t;let o=i.split(`,`).filter(Boolean);return o.length===0?t:(!n&&o.length>0&&(n=!0,a(`/md-204/dcc-file/bd/bdacfcd4c9ff70353971a79dd9e8cb8c-small.bnc`,o).then(t=>{e=t}).catch(()=>{e=t})),e||t||``)}export{o as default};
+//#region utils/get-res-url.ts
+let api_url;
+let default_cdn;
+let flag = false;
+/**
+* 检查是否在客户端环境
+*/
+function isClient() {
+	return typeof window !== "undefined";
+}
+function measureTtfbByXHR(url, timeoutMs = 2e3) {
+	return new Promise((resolve, reject) => {
+		const xhr = new XMLHttpRequest();
+		const t0 = performance.now();
+		let done = false;
+		const timeout = window.setTimeout(() => {
+			if (done) return;
+			done = true;
+			xhr.abort();
+			reject(/* @__PURE__ */ new Error("timeout"));
+		}, timeoutMs);
+		xhr.onreadystatechange = () => {
+			if (!done && xhr.readyState === 2) {
+				done = true;
+				clearTimeout(timeout);
+				const t = performance.now() - t0;
+				xhr.abort();
+				resolve(t);
+			}
+		};
+		xhr.onerror = () => {
+			if (done) return;
+			done = true;
+			clearTimeout(timeout);
+			reject(/* @__PURE__ */ new Error("network error"));
+		};
+		xhr.open("GET", url, true);
+		xhr.send();
+	});
+}
+async function pickFasterHostByTTFB(path, hosts) {
+	if (!hosts || hosts.length === 0) return "";
+	const urls = hosts.map((h) => {
+		const u = new URL(h + path);
+		u.searchParams.set("_t", String(Date.now()));
+		return u.toString();
+	});
+	const ok = (await Promise.allSettled(urls.map((u) => measureTtfbByXHR(u)))).map((r, i) => ({
+		r,
+		i
+	})).filter((x) => x.r.status === "fulfilled").map((x) => ({
+		url: urls[x.i],
+		ms: x.r.value
+	})).sort((a, b) => a.ms - b.ms);
+	if (!ok.length) return "";
+	try {
+		return new URL(ok[0].url).origin;
+	} catch (error) {
+		console.warn("Failed to parse fastest host URL:", error);
+		return "";
+	}
+}
+/**
+* 获取资源URL
+* - 服务端（SSG/SSR）：直接返回默认CDN
+* - 客户端：初始时返回默认CDN，测速完成后自动切换到最快的CDN
+* @returns CDN URL
+*/
+function getResUrl() {
+	if (!default_cdn) {
+		default_cdn = process.env.NEXT_PUBLIC_DEFAULT_CDN || "";
+		if (!default_cdn) {
+			console.warn("NEXT_PUBLIC_DEFAULT_CDN is not configured");
+			return "";
+		}
+	}
+	if (!isClient()) return default_cdn;
+	const cdnListEnv = process.env.NEXT_PUBLIC_CDN_LIST;
+	if (!cdnListEnv) return default_cdn;
+	const cdnList = cdnListEnv.split(",").filter(Boolean);
+	if (cdnList.length === 0) return default_cdn;
+	if (!flag && cdnList.length > 0) {
+		flag = true;
+		pickFasterHostByTTFB("/md-204/dcc-file/bd/bdacfcd4c9ff70353971a79dd9e8cb8c-small.bnc", cdnList).then((url) => {
+			api_url = url;
+		}).catch(() => {
+			api_url = default_cdn;
+		});
+	}
+	return api_url || default_cdn || "";
+}
+
+//#endregion
+export { getResUrl as default };

package/dist/utils/helper.mjs

@@ -1,2 +1,34 @@
 
-function e(e){return`${(e/390*100).toFixed(3)}vw`}function t(e){if(e)return e.trim()||void 0}function n(){typeof document<`u`&&(document.body.style.overflow=`hidden`)}function r(){typeof document<`u`&&(document.body.style.overflow=``)}export{n as disablePageScroll,r as enablePageScroll,t as normalizeClassName,e as pxToVw};
+//#region utils/helper.ts
+/**
+* 将像素值转换为 vw（基于 390 宽设计稿）。
+* @param px 像素值。
+* @returns 转换后的 vw 字符串。
+*/
+function pxToVw(px) {
+	return `${(px / 390 * 100).toFixed(3)}vw`;
+}
+/**
+* 规范化 className，去除首尾空格
+* @param className - 类名字符串
+* @returns 规范化后的类名，如果为空则返回 undefined
+*/
+function normalizeClassName(className) {
+	if (!className) return void 0;
+	return className.trim() || void 0;
+}
+/**
+* 禁用页面滚动
+*/
+function disablePageScroll() {
+	if (typeof document !== "undefined") document.body.style.overflow = "hidden";
+}
+/**
+* 启用页面滚动
+*/
+function enablePageScroll() {
+	if (typeof document !== "undefined") document.body.style.overflow = "";
+}
+
+//#endregion
+export { disablePageScroll, enablePageScroll, normalizeClassName, pxToVw };

package/dist/utils/http.mjs

@@ -1,2 +1,203 @@
 
-import{getCookie as e,isClient as t}from"./common.mjs";import{getOrCreateDeviceId as n}from"./device-id.mjs";import{useBlockedModalStore as r}from"../store/modules/blocked-modal-store.mjs";import{useUserStore as i}from"../store/modules/user-store.mjs";import{resolveRequestUserId as a}from"./request-user-id.mjs";import{toast as o}from"sonner";const s=process.env.NEXT_PUBLIC_API_BASE||``;let c=!1,l=!1,u=null;var d=class extends Error{constructor(e,t,n){super(t),this.status=e,this.response=n}};function f(e){if(!e)return``;let t=new URLSearchParams;Object.entries(e).forEach(([e,n])=>{n!=null&&t.append(e,String(n))});let n=t.toString();return n?`?${n}`:``}function p(e=1e4,t){let n=new AbortController,r=setTimeout(()=>n.abort(),e);return t&&t.addEventListener(`abort`,()=>n.abort()),{signal:n.signal,clear:()=>clearTimeout(r)}}function m(){t()&&(l||(l=!0,i.getState().logout(),setTimeout(()=>{l=!1},1e3)))}var h=class{constructor(){this.baseURL=s,this.defaultConfig={method:`GET`,timeout:1e4,cache:`default`}}async buildHeaders(e){return{"Content-Type":`application/json`,...e}}buildURL(e,t){return`${e.startsWith(`http`)?e:`${this.baseURL}${e.startsWith(`/`)?``:`/`}${e}`}${f(t)}`}async executeOnce(s){let{url:l,method:f=`GET`,data:h,params:g,timeout:_,cache:v,revalidate:y,tags:b,signal:x}=s,S=await this.buildHeaders(s.headers),C=``,w=f===`GET`||f===`HEAD`;if(t()&&!S[`x-device-id`]){let e=await n();e&&(S[`x-device-id`]=e)}C=await e(`token`);let T=await e(`userId`),E=await e(`guestUserId`);C&&(S.Authorization=`Bearer ${C}`);let D=a(T,E);if(D&&(S[`x-user-id`]=D),t()&&(u?.token&&u.token!==C&&(u=null),C&&u?.token===C))throw m(),new d(403,`账号已被封禁`,{code:403,message:`账号已被封禁`,data:{blocked_remark:u.blockedRemark,blocked_end_time:u.blockedEndTime}});let O;!w&&h!==void 0&&(h instanceof FormData?(delete S[`Content-Type`],O=h):O=JSON.stringify(h));let{signal:k,clear:A}=p(_,x),j=this.buildURL(l,g);try{let e=await fetch(j,{method:f,headers:S,body:O,cache:v,signal:k,next:{revalidate:y??0,tags:b}}),n=e.status===401||e.status===403;if(!e.ok&&!n)throw new d(e.status,e.statusText,await e.text());let a=await e.json(),s=n&&e.status===401||a?.code===401,l=n&&e.status===403||a?.code===403;if(s)if(t())c||(c=!0,o.error(`登录已过期，请重新登录`),i.getState().logout(),setTimeout(()=>{c=!1},3e3));else throw new d(a.code,a.message,a);if(l){let e=typeof a?.data?.blocked_remark==`string`?a.data.blocked_remark:``,n=Number(a?.data?.blocked_end_time),i={blockedRemark:e,blockedEndTime:Number.isFinite(n)&&n>0?Math.floor(n):0};if(t()){let e=C,t=u?.token===e;e&&(u={token:e,...i}),t||r.getState().open(i),m()}throw new d(a.code,a.message,a)}if(a.code!==0)throw new d(a.code,a.message,a);return a}finally{A()}}async request(e){let t={...this.defaultConfig,...e};return await this.executeOnce(t)}get(e,t){return this.request({...t,method:`GET`,url:e})}post(e,t){return this.request({...t,method:`POST`,url:e})}put(e,t){return this.request({...t,method:`PUT`,url:e})}delete(e,t){return this.request({...t,method:`DELETE`,url:e})}patch(e,t){return this.request({...t,method:`PATCH`,url:e})}};const g=new h;export{h as HttpClient,d as HttpError,g as default};
+import { getCookie, isClient } from "./common.mjs";
+import { getOrCreateDeviceId } from "./device-id.mjs";
+import { useBlockedModalStore } from "../store/modules/blocked-modal-store.mjs";
+import { useUserStore } from "../store/modules/user-store.mjs";
+import { resolveRequestUserId } from "./request-user-id.mjs";
+import { toast } from "sonner";
+
+//#region utils/http.ts
+const apiBase = process.env.NEXT_PUBLIC_API_BASE || "";
+let hasHandledAuthExpired = false;
+let hasHandledBlockedAutoLogout = false;
+let blockedSession = null;
+var HttpError = class extends Error {
+	constructor(status, message, response) {
+		super(message);
+		this.status = status;
+		this.response = response;
+	}
+};
+function buildQuery(params) {
+	if (!params) return "";
+	const qs = new URLSearchParams();
+	Object.entries(params).forEach(([k, v]) => {
+		if (v !== void 0 && v !== null) qs.append(k, String(v));
+	});
+	const str = qs.toString();
+	return str ? `?${str}` : "";
+}
+function withTimeout(timeout = 1e4, signal) {
+	const controller = new AbortController();
+	const id = setTimeout(() => controller.abort(), timeout);
+	if (signal) signal.addEventListener("abort", () => controller.abort());
+	return {
+		signal: controller.signal,
+		clear: () => clearTimeout(id)
+	};
+}
+/**
+* 避免并发 403 导致重复执行登出与刷新。
+*/
+function triggerBlockedAutoLogout() {
+	if (!isClient()) return;
+	if (hasHandledBlockedAutoLogout) return;
+	hasHandledBlockedAutoLogout = true;
+	useUserStore.getState().logout();
+	setTimeout(() => {
+		hasHandledBlockedAutoLogout = false;
+	}, 1e3);
+}
+var HttpClient = class {
+	constructor() {
+		this.baseURL = apiBase;
+		this.defaultConfig = {
+			method: "GET",
+			timeout: 1e4,
+			cache: "default"
+		};
+	}
+	async buildHeaders(custom) {
+		return {
+			"Content-Type": "application/json",
+			...custom
+		};
+	}
+	buildURL(url, params) {
+		return `${url.startsWith("http") ? url : `${this.baseURL}${url.startsWith("/") ? "" : "/"}${url}`}${buildQuery(params)}`;
+	}
+	async executeOnce(config) {
+		const { url, method = "GET", data, params, timeout, cache, revalidate, tags, signal } = config;
+		const headers = await this.buildHeaders(config.headers);
+		let token = "";
+		const isGetLike = method === "GET" || method === "HEAD";
+		if (isClient()) {
+			if (!headers["x-device-id"]) {
+				const deviceId = await getOrCreateDeviceId();
+				if (deviceId) headers["x-device-id"] = deviceId;
+			}
+			token = await getCookie("token");
+			const userId = await getCookie("userId");
+			const guestUserId = await getCookie("guestUserId");
+			if (token) headers.Authorization = `Bearer ${token}`;
+			const requestUserId = resolveRequestUserId(userId, guestUserId);
+			if (requestUserId) headers["x-user-id"] = requestUserId;
+			if (blockedSession?.token && blockedSession.token !== token) blockedSession = null;
+			if (token && blockedSession?.token === token) {
+				triggerBlockedAutoLogout();
+				throw new HttpError(403, "账号已被封禁", {
+					code: 403,
+					message: "账号已被封禁",
+					data: {
+						blocked_remark: blockedSession.blockedRemark,
+						blocked_end_time: blockedSession.blockedEndTime
+					}
+				});
+			}
+		}
+		let body;
+		if (!isGetLike && data !== void 0) if (data instanceof FormData) {
+			delete headers["Content-Type"];
+			body = data;
+		} else body = JSON.stringify(data);
+		const { signal: timeoutSignal, clear } = withTimeout(timeout, signal);
+		const requestURL = this.buildURL(url, params);
+		try {
+			const res = await fetch(requestURL, {
+				method,
+				headers,
+				body,
+				cache,
+				signal: timeoutSignal,
+				next: {
+					revalidate: revalidate ?? 0,
+					tags
+				}
+			});
+			const isAuthStatus = res.status === 401 || res.status === 403;
+			if (!res.ok && !isAuthStatus) throw new HttpError(res.status, res.statusText, await res.text());
+			const data = await res.json();
+			const isAuthExpired = isAuthStatus ? res.status === 401 || data?.code === 401 : data?.code === 401;
+			const isBlockedStatus = isAuthStatus ? res.status === 403 || data?.code === 403 : data?.code === 403;
+			if (isAuthExpired) if (isClient()) {
+				if (!hasHandledAuthExpired) {
+					hasHandledAuthExpired = true;
+					toast.error("登录已过期，请重新登录");
+					useUserStore.getState().logout();
+					setTimeout(() => {
+						hasHandledAuthExpired = false;
+					}, 3e3);
+				}
+			} else throw new HttpError(data.code, data.message, data);
+			if (isBlockedStatus) {
+				const blockedRemark = typeof data?.data?.blocked_remark === "string" ? data.data.blocked_remark : "";
+				const rawBlockedEndTime = Number(data?.data?.blocked_end_time);
+				const payload = {
+					blockedRemark,
+					blockedEndTime: Number.isFinite(rawBlockedEndTime) && rawBlockedEndTime > 0 ? Math.floor(rawBlockedEndTime) : 0
+				};
+				if (isClient()) {
+					const blockedToken = token;
+					const isSameBlockedSession = blockedSession?.token === blockedToken;
+					if (blockedToken) blockedSession = {
+						token: blockedToken,
+						...payload
+					};
+					if (!isSameBlockedSession) useBlockedModalStore.getState().open(payload);
+					triggerBlockedAutoLogout();
+				}
+				throw new HttpError(data.code, data.message, data);
+			}
+			if (data.code !== 0) throw new HttpError(data.code, data.message, data);
+			return data;
+		} finally {
+			clear();
+		}
+	}
+	async request(input) {
+		const config = {
+			...this.defaultConfig,
+			...input
+		};
+		return await this.executeOnce(config);
+	}
+	get(url, config) {
+		return this.request({
+			...config,
+			method: "GET",
+			url
+		});
+	}
+	post(url, config) {
+		return this.request({
+			...config,
+			method: "POST",
+			url
+		});
+	}
+	put(url, config) {
+		return this.request({
+			...config,
+			method: "PUT",
+			url
+		});
+	}
+	delete(url, config) {
+		return this.request({
+			...config,
+			method: "DELETE",
+			url
+		});
+	}
+	patch(url, config) {
+		return this.request({
+			...config,
+			method: "PATCH",
+			url
+		});
+	}
+};
+const httpClient = new HttpClient();
+
+//#endregion
+export { HttpClient, HttpError, httpClient as default };

package/dist/utils/image-compression.mjs

@@ -1,2 +1,60 @@
 
-"use client";import e from"browser-image-compression";const t=.92,n=.6,r=[{maxSize:1024*1024,quality:.9},{maxSize:5*1024*1024,quality:.8},{maxSize:10*1024*1024,quality:.7},{maxSize:1/0,quality:.6}];function i(e){return r.find(t=>e<t.maxSize)?.quality??t}async function a(t,r){return e(t,{...r,useWebWorker:r?.useWebWorker??!0,initialQuality:r?.initialQuality??i(t.size),maxSizeMB:r?.maxSizeMB??n})}export{a as compressImage,n as defaultImageCompressionMaxSizeMB,t as defaultImageCompressionQuality,i as getImageCompressionQuality,r as imageCompressionQualityRules};
+'use client';
+
+import imageCompression from "browser-image-compression";
+
+//#region utils/image-compression.ts
+/**
+* 默认图片压缩质量。
+*/
+const defaultImageCompressionQuality = .92;
+/**
+* 默认压缩后最大体积（MB）。
+*/
+const defaultImageCompressionMaxSizeMB = .6;
+/**
+* 图片压缩质量规则配置。
+*/
+const imageCompressionQualityRules = [
+	{
+		maxSize: 1024 * 1024,
+		quality: .9
+	},
+	{
+		maxSize: 5 * 1024 * 1024,
+		quality: .8
+	},
+	{
+		maxSize: 10 * 1024 * 1024,
+		quality: .7
+	},
+	{
+		maxSize: Number.POSITIVE_INFINITY,
+		quality: .6
+	}
+];
+/**
+* 根据文件大小获取推荐压缩质量。
+* @param fileSize 文件大小（字节）。
+* @returns 推荐的压缩质量（0-1）。
+*/
+function getImageCompressionQuality(fileSize) {
+	return imageCompressionQualityRules.find((item) => fileSize < item.maxSize)?.quality ?? defaultImageCompressionQuality;
+}
+/**
+* 压缩图片文件。
+* @param file 原始图片文件。
+* @param options 可选压缩配置，会与默认策略合并。
+* @returns 压缩后的文件对象。
+*/
+async function compressImage(file, options) {
+	return imageCompression(file, {
+		...options,
+		useWebWorker: options?.useWebWorker ?? true,
+		initialQuality: options?.initialQuality ?? getImageCompressionQuality(file.size),
+		maxSizeMB: options?.maxSizeMB ?? defaultImageCompressionMaxSizeMB
+	});
+}
+
+//#endregion
+export { compressImage, defaultImageCompressionMaxSizeMB, defaultImageCompressionQuality, getImageCompressionQuality, imageCompressionQualityRules };

package/dist/utils/image-crop.mjs

@@ -1,2 +1,64 @@
 
-import{defaultImageCompressionQuality as e}from"./image-compression.mjs";async function t(t,r,i={}){let{fileType:a=`image/jpeg`,quality:o=e,maxWidth:s,maxHeight:c,circular:l=!1}=i,u=await n(t),d=document.createElement(`canvas`),f=d.getContext(`2d`);if(!f)throw Error(`无法获取 canvas 上下文`);let p=r.width,m=r.height;if(s||c){let e=s?p/s:1,t=c?m/c:1,n=Math.max(e,t);n>1&&(p/=n,m/=n)}return d.width=p,d.height=m,l&&(f.beginPath(),f.arc(p/2,m/2,p/2,0,2*Math.PI),f.closePath(),f.clip()),f.drawImage(u,r.x,r.y,r.width,r.height,0,0,p,m),new Promise((e,t)=>{d.toBlob(n=>{n?e(n):t(Error(`无法生成图片 Blob`))},a,o)})}function n(e){return new Promise((t,n)=>{let r=new Image;r.addEventListener(`load`,()=>t(r)),r.addEventListener(`error`,e=>n(e)),r.src=e})}export{t as getCroppedImg};
+import { defaultImageCompressionQuality } from "./image-compression.mjs";
+
+//#region utils/image-crop.ts
+/**
+* 图片裁剪工具函数
+* 用于将 react-easy-crop 的裁剪结果转换为 Blob 或 File
+*/
+/**
+* 将裁剪后的图片转换为 Blob
+* @param imageSrc - 图片 URL（base64 或 blob URL）
+* @param pixelCrop - 裁剪区域的像素坐标
+* @param options - 裁剪选项
+* @returns 裁剪后的图片 Blob
+*/
+async function getCroppedImg(imageSrc, pixelCrop, options = {}) {
+	const { fileType = "image/jpeg", quality = defaultImageCompressionQuality, maxWidth, maxHeight, circular = false } = options;
+	const image = await createImage(imageSrc);
+	const canvas = document.createElement("canvas");
+	const ctx = canvas.getContext("2d");
+	if (!ctx) throw new Error("无法获取 canvas 上下文");
+	let outputWidth = pixelCrop.width;
+	let outputHeight = pixelCrop.height;
+	if (maxWidth || maxHeight) {
+		const widthRatio = maxWidth ? outputWidth / maxWidth : 1;
+		const heightRatio = maxHeight ? outputHeight / maxHeight : 1;
+		const ratio = Math.max(widthRatio, heightRatio);
+		if (ratio > 1) {
+			outputWidth = outputWidth / ratio;
+			outputHeight = outputHeight / ratio;
+		}
+	}
+	canvas.width = outputWidth;
+	canvas.height = outputHeight;
+	if (circular) {
+		ctx.beginPath();
+		ctx.arc(outputWidth / 2, outputHeight / 2, outputWidth / 2, 0, 2 * Math.PI);
+		ctx.closePath();
+		ctx.clip();
+	}
+	ctx.drawImage(image, pixelCrop.x, pixelCrop.y, pixelCrop.width, pixelCrop.height, 0, 0, outputWidth, outputHeight);
+	return new Promise((resolve, reject) => {
+		canvas.toBlob((blob) => {
+			if (blob) resolve(blob);
+			else reject(/* @__PURE__ */ new Error("无法生成图片 Blob"));
+		}, fileType, quality);
+	});
+}
+/**
+* 创建图片对象
+* @param url - 图片 URL
+* @returns HTMLImageElement
+*/
+function createImage(url) {
+	return new Promise((resolve, reject) => {
+		const image = new Image();
+		image.addEventListener("load", () => resolve(image));
+		image.addEventListener("error", (error) => reject(error));
+		image.src = url;
+	});
+}
+
+//#endregion
+export { getCroppedImg };

package/dist/utils/loaders.mjs

@@ -1,2 +1,52 @@
 
-const e=new Map,t={HomeExamplePage:async()=>(await import(`../components/pages/home/index.mjs`)).HomePage,PublishPage:async()=>(await import(`../components/pages/publish/page.mjs`)).default};async function n(e,n){t[e]=n}async function r(n){let r=e.get(n);if(r)return r;let i=await t[n]();return e.set(n,i),i}export{t as components,r as loadComponent,n as rewriteComponent};
+//#region utils/loaders.ts
+const compCache = /* @__PURE__ */ new Map();
+/**
+* 可动态加载的组件加载器集合。
+*
+* - key：组件名（用于 `loadComponent(name)` / `rewriteComponent(name, loader)`）
+* - value：返回 React 组件的异步加载函数（通常是 `import()` 的 default export）
+*
+* 注意：该对象会被 `rewriteComponent` 动态改写。
+*/
+const components = {
+	HomeExamplePage: async () => {
+		return (await import("../components/pages/home/index.mjs")).HomePage;
+	},
+	PublishPage: async () => {
+		return (await import("../components/pages/publish/page.mjs")).default;
+	}
+};
+/**
+* 运行时重写（替换/注入）某个组件的加载器。
+*
+* 典型用途：
+* - 业务侧按需覆盖平台内置组件
+* - A/B 或白标场景下动态替换实现
+*
+* @param name - 组件名（与 `components` 的 key 一致）
+* @param component - 异步加载函数，resolve 为 React 组件
+* @returns 重写完成后 resolve。
+*/
+async function rewriteComponent(name, component) {
+	components[name] = component;
+}
+/**
+* 按名称加载组件，并做内存缓存。
+*
+* - 命中缓存：直接返回缓存的组件
+* - 未命中缓存：调用 `components[name]()` 动态加载并写入缓存
+*
+* @param name - 组件名（需在 `components` 中存在或已通过 `rewriteComponent` 注入）
+* @returns Promise of `React.ComponentType<any>` - 组件本身（不是 ReactElement）
+*/
+async function loadComponent(name) {
+	const cached = compCache.get(name);
+	if (cached) return cached;
+	const Component = await components[name]();
+	compCache.set(name, Component);
+	return Component;
+}
+
+//#endregion
+export { components, loadComponent, rewriteComponent };

package/dist/utils/login-modal-bridge.mjs

@@ -1,2 +1,66 @@
 
-function e(){return typeof window>`u`?!1:window.isWebView===!0}function t(t){if(!e())return;let n=window[t?`showBridgePlayer`:`hideBridgePlayer`];if(typeof n==`function`){Promise.resolve(n()).catch(e=>{console.warn(`调用 WebView 播放器显隐方法失败:`,e)});return}let r=window.flutter_inappwebview;typeof r?.callHandler==`function`&&Promise.resolve(r.callHandler(`setPlayerVisible`,t)).catch(e=>{console.warn(`调用 setPlayerVisible 失败:`,e)})}function n(t,...n){if(!e())return;let r=window[t];typeof r==`function`&&Promise.resolve(r(...n)).catch(e=>{console.warn(`调用 ${t} 失败:`,e)})}function r(){e()&&(t(!1),n(`notifyBridgeLoginModalOpened`))}function i(){t(!0)}function a(){n(`notifyBridgeLoginSuccessClosed`)}function o(e){n(`notifyBridgeEpisodeChanged`,e)}export{o as notifyBridgeEpisodeChanged,i as notifyBridgeLoginModalClosed,r as notifyBridgeLoginModalOpened,a as notifyBridgeLoginSuccessClosed};
+//#region utils/login-modal-bridge.ts
+/**
+* 判断是否在 WebView 环境。
+*/
+function isWebViewRuntime() {
+	if (typeof window === "undefined") return false;
+	return window.isWebView === true;
+}
+/**
+* WebView：控制播放器显隐（登录弹窗打开时隐藏，关闭时恢复）。
+*/
+function setWebViewPlayerVisible(visible) {
+	if (!isWebViewRuntime()) return;
+	const playerMethod = window[visible ? "showBridgePlayer" : "hideBridgePlayer"];
+	if (typeof playerMethod === "function") {
+		Promise.resolve(playerMethod()).catch((error) => {
+			console.warn("调用 WebView 播放器显隐方法失败:", error);
+		});
+		return;
+	}
+	const inAppWebView = window.flutter_inappwebview;
+	if (typeof inAppWebView?.callHandler === "function") Promise.resolve(inAppWebView.callHandler("setPlayerVisible", visible)).catch((error) => {
+		console.warn("调用 setPlayerVisible 失败:", error);
+	});
+}
+/**
+* 调用 WebView 全局桥接函数。
+*/
+function callWebViewBridgeMethod(methodName, ...args) {
+	if (!isWebViewRuntime()) return;
+	const webViewMethod = window[methodName];
+	if (typeof webViewMethod !== "function") return;
+	Promise.resolve(webViewMethod(...args)).catch((error) => {
+		console.warn(`调用 ${methodName} 失败:`, error);
+	});
+}
+/**
+* WebView：登录弹窗打开回调（Bridge）。
+*/
+function notifyBridgeLoginModalOpened() {
+	if (!isWebViewRuntime()) return;
+	setWebViewPlayerVisible(false);
+	callWebViewBridgeMethod("notifyBridgeLoginModalOpened");
+}
+/**
+* WebView：登录弹窗关闭回调，用于恢复播放器显示。
+*/
+function notifyBridgeLoginModalClosed() {
+	setWebViewPlayerVisible(true);
+}
+/**
+* WebView：登录成功并自动关闭弹窗回调（Bridge）。
+*/
+function notifyBridgeLoginSuccessClosed() {
+	callWebViewBridgeMethod("notifyBridgeLoginSuccessClosed");
+}
+/**
+* WebView：分集切换通知（占位，优先调用 webview.js 暴露方法）。
+*/
+function notifyBridgeEpisodeChanged(payload) {
+	callWebViewBridgeMethod("notifyBridgeEpisodeChanged", payload);
+}
+
+//#endregion
+export { notifyBridgeEpisodeChanged, notifyBridgeLoginModalClosed, notifyBridgeLoginModalOpened, notifyBridgeLoginSuccessClosed };