@funhub/platform 0.2.29 → 0.2.31

package/dist/utils/share-manager.mjs

@@ -1,2 +1,184 @@
 
-import{Dialog as e,DialogContent as t}from"../components/ui/dialog.mjs";import n from"../components/common/share-popup/share-content.mjs";import{defaultLocale as r,getMessages as i,isValidLocale as a}from"../i18n.mjs";import{IntlProvider as o}from"../components/common/intl-provider/intl-provider.mjs";import{SharePlatformEnum as s}from"../types/share.mjs";import{jsx as c}from"react/jsx-runtime";import{createRoot as l}from"react-dom/client";const u=`session_share_config`;function d(){return{domain:``,[s.QQ]:!0,[s.SAVE]:!0,[s.SHARE_LINK]:!0,[s.WECHAT]:!0,[s.WECHAT_MOMENTS]:!0}}function f(r){let{visible:i,onClose:a,type:o,data:s,copyUrl:l}=r;function u(e){e||a()}return c(e,{open:i,onOpenChange:u,children:c(t,{showCloseButton:!1,className:`z-[2000] w-[calc(100%-48px)] max-w-[360px] overflow-hidden rounded-[16px] bg-bg1 p-0 text-text1`,children:c(n,{type:o,data:s,copyUrl:l,visible:i,onClose:a})})})}function p(){if(typeof document>`u`)return r;let e=document.documentElement?.lang||``;return a(e)?e:r}function m(e){let t=p();return c(o,{locale:t,messages:i(t),children:c(f,{...e})})}let h=null,g=null,_=null,v=``;function y(){typeof window>`u`||(_!==null&&(window.clearInterval(_),_=null),v=``)}function b(e){typeof window>`u`||(y(),v=window.location.href,_=window.setInterval(()=>{if(!g||!h){y();return}window.location.href!==v&&e()},120))}var x=class e{static async initShareConfig(){let e=d();try{let t=sessionStorage.getItem(u);t?e=JSON.parse(t):sessionStorage.setItem(u,JSON.stringify(e))}catch(e){console.error(`获取分享配置失败:`,e)}return e}static showSharePopup({type:t,data:n,copyUrl:r}){h||(h=document.createElement(`div`),h.style.zIndex=`2001`,document.body.appendChild(h),g=l(h)),g?.render(c(m,{visible:!1,type:t,data:n,copyUrl:r,onClose:()=>{e.clear()}})),requestAnimationFrame(()=>{g?.render(c(m,{visible:!0,type:t,data:n,copyUrl:r,onClose:()=>{e.clear()}}))}),b(()=>{e.clear()})}static clear(){y(),g&&h&&(g.render(c(m,{visible:!1,type:s.SHARE_LINK,data:{id:``},copyUrl:``,onClose:()=>{e.clear()}})),setTimeout(()=>{g?.unmount(),g=null,h?.parentNode&&h.parentNode.removeChild(h),h=null},300))}};export{x as default};
+import { Dialog, DialogContent } from "../components/ui/dialog.mjs";
+import ShareContent from "../components/common/share-popup/share-content.mjs";
+import { defaultLocale, getMessages, isValidLocale } from "../i18n.mjs";
+import { IntlProvider } from "../components/common/intl-provider/intl-provider.mjs";
+import { SharePlatformEnum } from "../types/share.mjs";
+import { jsx } from "react/jsx-runtime";
+import { createRoot } from "react-dom/client";
+
+//#region utils/share-manager.tsx
+/**
+* 分享配置缓存键。
+*/
+const SESSION_STORAGE_KEY = "session_share_config";
+/**
+* 构建默认分享配置。
+* @returns 默认分享配置
+*/
+function buildDefaultShareConfig() {
+	return {
+		domain: "",
+		[SharePlatformEnum.QQ]: true,
+		[SharePlatformEnum.SAVE]: true,
+		[SharePlatformEnum.SHARE_LINK]: true,
+		[SharePlatformEnum.WECHAT]: true,
+		[SharePlatformEnum.WECHAT_MOMENTS]: true
+	};
+}
+/**
+* 分享内容弹窗组件。
+* @param props 组件参数
+*/
+function ShareContentPopup(props) {
+	const { visible, onClose, type, data, copyUrl } = props;
+	/**
+	* 弹窗开关回调。
+	* @param nextOpen 是否打开
+	*/
+	function handleOpenChange(nextOpen) {
+		if (!nextOpen) onClose();
+	}
+	return /* @__PURE__ */ jsx(Dialog, {
+		open: visible,
+		onOpenChange: handleOpenChange,
+		children: /* @__PURE__ */ jsx(DialogContent, {
+			showCloseButton: false,
+			className: "z-[2000] w-[calc(100%-48px)] max-w-[360px] overflow-hidden rounded-[16px] bg-bg1 p-0 text-text1",
+			children: /* @__PURE__ */ jsx(ShareContent, {
+				type,
+				data,
+				copyUrl,
+				visible,
+				onClose
+			})
+		})
+	});
+}
+/**
+* 获取分享弹窗使用的语言。
+*/
+function resolveShareLocale() {
+	if (typeof document === "undefined") return defaultLocale;
+	const lang = document.documentElement?.lang || "";
+	return isValidLocale(lang) ? lang : defaultLocale;
+}
+/**
+* 带国际化上下文的分享弹窗。
+*/
+function ShareContentPopupWithIntl(props) {
+	const locale = resolveShareLocale();
+	return /* @__PURE__ */ jsx(IntlProvider, {
+		locale,
+		messages: getMessages(locale),
+		children: /* @__PURE__ */ jsx(ShareContentPopup, { ...props })
+	});
+}
+let sharePopupContainer = null;
+let sharePopupRoot = null;
+let sharePopupRouteWatchTimer = null;
+let sharePopupOpenedHref = "";
+function stopSharePopupNavigationWatch() {
+	if (typeof window === "undefined") return;
+	if (sharePopupRouteWatchTimer !== null) {
+		window.clearInterval(sharePopupRouteWatchTimer);
+		sharePopupRouteWatchTimer = null;
+	}
+	sharePopupOpenedHref = "";
+}
+function startSharePopupNavigationWatch(onLocationChanged) {
+	if (typeof window === "undefined") return;
+	stopSharePopupNavigationWatch();
+	sharePopupOpenedHref = window.location.href;
+	sharePopupRouteWatchTimer = window.setInterval(() => {
+		if (!sharePopupRoot || !sharePopupContainer) {
+			stopSharePopupNavigationWatch();
+			return;
+		}
+		if (window.location.href !== sharePopupOpenedHref) onLocationChanged();
+	}, 120);
+}
+/**
+* 分享弹窗管理器。
+*/
+var ShareManager = class ShareManager {
+	/**
+	* 初始化分享配置。
+	* @returns 分享配置
+	*/
+	static async initShareConfig() {
+		let shareConfig = buildDefaultShareConfig();
+		try {
+			const cache = sessionStorage.getItem(SESSION_STORAGE_KEY);
+			if (cache) shareConfig = JSON.parse(cache);
+			else sessionStorage.setItem(SESSION_STORAGE_KEY, JSON.stringify(shareConfig));
+		} catch (error) {
+			console.error("获取分享配置失败:", error);
+		}
+		return shareConfig;
+	}
+	/**
+	* 显示分享链接弹窗。
+	* @param options 弹窗配置
+	* @param options.type 分享类型
+	* @param options.data 分享数据
+	* @param options.copyUrl 复制链接
+	*/
+	static showSharePopup({ type, data, copyUrl }) {
+		if (!sharePopupContainer) {
+			sharePopupContainer = document.createElement("div");
+			sharePopupContainer.style.zIndex = "2001";
+			document.body.appendChild(sharePopupContainer);
+			sharePopupRoot = createRoot(sharePopupContainer);
+		}
+		sharePopupRoot?.render(/* @__PURE__ */ jsx(ShareContentPopupWithIntl, {
+			visible: false,
+			type,
+			data,
+			copyUrl,
+			onClose: () => {
+				ShareManager.clear();
+			}
+		}));
+		requestAnimationFrame(() => {
+			sharePopupRoot?.render(/* @__PURE__ */ jsx(ShareContentPopupWithIntl, {
+				visible: true,
+				type,
+				data,
+				copyUrl,
+				onClose: () => {
+					ShareManager.clear();
+				}
+			}));
+		});
+		startSharePopupNavigationWatch(() => {
+			ShareManager.clear();
+		});
+	}
+	/**
+	* 清除分享链接弹窗。
+	*/
+	static clear() {
+		stopSharePopupNavigationWatch();
+		if (sharePopupRoot && sharePopupContainer) {
+			sharePopupRoot.render(/* @__PURE__ */ jsx(ShareContentPopupWithIntl, {
+				visible: false,
+				type: SharePlatformEnum.SHARE_LINK,
+				data: { id: "" },
+				copyUrl: "",
+				onClose: () => {
+					ShareManager.clear();
+				}
+			}));
+			setTimeout(() => {
+				sharePopupRoot?.unmount();
+				sharePopupRoot = null;
+				if (sharePopupContainer?.parentNode) sharePopupContainer.parentNode.removeChild(sharePopupContainer);
+				sharePopupContainer = null;
+			}, 300);
+		}
+	}
+};
+
+//#endregion
+export { ShareManager as default };

package/dist/utils/tools.mjs

@@ -1,2 +1,93 @@
 
-function e(e){if(typeof e!=`number`||Number.isNaN(e))return`00:00`;e<0&&(e=0);let t=e,n=Math.floor(t/3600),r=Math.floor(t%3600/60),i=t%60,a=e=>e.toString().padStart(2,`0`);return n>0?`${a(n)}:${a(r)}:${a(i)}`:`${a(r)}:${a(i)}`}function t(){return/iPhone|iPad|iPod/i.test(navigator.userAgent)}function n({id:e,contentType:t}){return t===0?`/video/${e}`:`/post/${e}`}function r(e){let{text:t=``,atUsers:n=[]}=e;return t.replace(/<@_user>(\w+)<\/@_user>/g,(e,t)=>`<span class="mention" data-id="${t}">@${n.find(e=>e.userId===t||e.user_id===t)?.name||``}</span>`)}function i(e,t){return t?.includes(`download`)||!e?!1:![`Mobile`,`Android`,`iPhone`,`iPad`,`iPod`,`BlackBerry`,`Windows Phone`,`Opera Mini`,`IEMobile`,`Mobile Safari`,`webOS`,`Kindle`,`Silk`,`Fennec`,`Maemo`,`Tablet`,`HarmonyOS`,`OpenHarmony`].some(t=>e.includes(t))}function a(){return i(navigator?.userAgent)}export{e as formatVideoDuration,n as getPostDetailPagePath,t as isMobileIOS,a as isPCEnv,r as replaceAtUserElementHtmlStr};
+//#region utils/tools.ts
+/**
+* 毫秒转化为视频播放时长
+* @param milliseconds 视频时长数值（按当前实现以秒处理）。
+* @returns `mm:ss` 或 `hh:mm:ss` 格式的时长字符串。
+*/
+function formatVideoDuration(milliseconds) {
+	if (typeof milliseconds !== "number" || Number.isNaN(milliseconds)) return "00:00";
+	if (milliseconds < 0) milliseconds = 0;
+	const totalSeconds = milliseconds;
+	const hours = Math.floor(totalSeconds / 3600);
+	const minutes = Math.floor(totalSeconds % 3600 / 60);
+	const seconds = totalSeconds % 60;
+	const formatPart = (part) => part.toString().padStart(2, "0");
+	if (hours > 0) return `${formatPart(hours)}:${formatPart(minutes)}:${formatPart(seconds)}`;
+	return `${formatPart(minutes)}:${formatPart(seconds)}`;
+}
+/**
+* 判断是否是移动端IOS
+* @returns 是否为 iOS 设备。
+*/
+function isMobileIOS() {
+	return /iPhone|iPad|iPod/i.test(navigator.userAgent);
+}
+/**
+* 获取详情页路由。
+*
+* 该项目的详情页路由为：
+* - 视频：`/video/:id`
+* - 帖子：`/post/:id`
+*
+* @param params - 参数
+* @param params.id - 内容 ID
+* @param params.contentType - 内容类型（SafeInformationType.content_type），用于区分视频/帖子
+* @returns 详情页路由地址。
+*/
+function getPostDetailPagePath({ id, contentType }) {
+	return contentType === 0 ? `/video/${id}` : `/post/${id}`;
+}
+/**
+* 将<@_user>data-id</@_user>替换为span元素
+* @param options 参数对象。
+* @param options.text 含占位符的文本。
+* @param options.atUsers 用户信息列表。
+* @returns 替换后的 HTML 字符串。
+*/
+function replaceAtUserElementHtmlStr(options) {
+	const { text = "", atUsers = [] } = options;
+	return text.replace(/<@_user>(\w+)<\/@_user>/g, (_match, p1) => {
+		return `<span class="mention" data-id="${p1}">@${atUsers.find((item) => item.userId === p1 || item.user_id === p1)?.name || ""}</span>`;
+	});
+}
+/**
+* 根据userAgent判断是否是PC端
+* @param userAgent 用户代理字符串
+* @param pathname 当前页面路径，用于排除下载页。
+* @returns 是否是PC端
+*/
+function isPCByUserAgent(userAgent, pathname) {
+	if (pathname?.includes("download")) return false;
+	if (!userAgent) return false;
+	return ![
+		"Mobile",
+		"Android",
+		"iPhone",
+		"iPad",
+		"iPod",
+		"BlackBerry",
+		"Windows Phone",
+		"Opera Mini",
+		"IEMobile",
+		"Mobile Safari",
+		"webOS",
+		"Kindle",
+		"Silk",
+		"Fennec",
+		"Maemo",
+		"Tablet",
+		"HarmonyOS",
+		"OpenHarmony"
+	].some((keyword) => userAgent.includes(keyword));
+}
+/**
+* 是否是pc环境
+* @returns 当前环境是否判定为 PC。
+*/
+function isPCEnv() {
+	return isPCByUserAgent(navigator?.userAgent);
+}
+
+//#endregion
+export { formatVideoDuration, getPostDetailPagePath, isMobileIOS, isPCEnv, replaceAtUserElementHtmlStr };

package/dist/utils/tracking.mjs

@@ -1,2 +1,184 @@
 
-"use client";function e(e,t,n,r,i){if(typeof window>`u`)return;let a=n?.pageX??0,o=n?.pageY??0,s=window.innerWidth||1,c=window.innerHeight||1,l={page_key:e,page_name:t,element_name:r,click_page_x:Math.round(a),click_page_y:Math.round(o),click_x_percent:Math.round(a/s*100),click_y_percent:Math.round(o/c*100),screen_width:window.screen.width,screen_height:window.screen.height,recommend_trace_id:``,...i};window.WebSDK?.track?.({event:`page_click`,payload:l}),window.sensors?.track?.(`page_click`,l)}function t(e){if(typeof window>`u`)return;let t={recommend_trace_id:``,recommend_id:``,recommend_trace_info:``,...e};window.WebSDK?.track?.({event:`recommend_list_click`,payload:t}),window.sensors?.track?.(`recommend_list_click`,t)}const n=new Set;function r(e){if(typeof window>`u`)return;let t=e.ad_id.split(`,`).map(e=>e.trim()).filter(Boolean),r=(e.creative_id??``).split(`,`).map(e=>e.trim()),i=t.reduce((t,r,i)=>(n.has(`${e.ad_slot_key}::${r}`)||t.push(i),t),[]);if(i.length===0)return;for(let r of i)n.add(`${e.ad_slot_key}::${t[r]}`);let a={...e,ad_id:i.map(e=>t[e]).join(`,`),creative_id:i.map(e=>r[e]??``).join(`,`)};window.WebSDK?.track?.({event:`ad_impression`,payload:a}),window.sensors?.track?.(`ad_impression`,a)}function i(e){typeof window>`u`||(window.WebSDK?.track?.({event:`advertising`,payload:e}),window.sensors?.track?.(`advertising`,e))}function a(e){typeof window>`u`||(window.WebSDK?.track?.({event:`navigation`,payload:e}),window.sensors?.track?.(`navigation`,e))}function o(e){typeof window>`u`||(window.WebSDK?.track?.({event:`video_event`,payload:e}),window.sensors?.track?.(`video_event`,e))}function s(e){typeof window>`u`||(window.WebSDK?.track?.({event:`keyword_click`,payload:e}),window.sensors?.track?.(`keyword_click`,e))}function c(e){if(typeof window>`u`)return;let t={creative_id:``,...e};window.WebSDK?.track?.({event:`ad_click`,payload:t}),window.sensors?.track?.(`ad_click`,t)}function l(e){if(typeof window>`u`)return;let t={user_type:`normal`,referrer_page_key:``,referrer_page_name:``,page_load_time:0,recommend_trace_id:``,...e};window.WebSDK?.track?.({event:`app_page_view`,payload:t}),window.sensors?.track?.(`app_page_view`,t)}function u(e){typeof window>`u`||(window.WebSDK?.track?.({event:`page_lifecycle`,payload:e}),window.sensors?.track?.(`page_lifecycle`,e))}export{c as trackAdClick,r as trackAdImpression,i as trackAdvertising,l as trackAppPageView,s as trackKeywordClick,a as trackNavigation,e as trackPageClick,u as trackPageLifecycle,t as trackRecommendListClick,o as trackVideoEvent};
+'use client';
+
+//#region utils/tracking.ts
+/**
+* 通用 page_click 上报。
+* @param pageKey      页面标识（如 'page_user'、'login'）。
+* @param pageName     页面名称（如 '我的'、'登录注册'）。
+* @param pos          鼠标事件对象，用于提取点击坐标；无法获取时传 null。
+* @param elementName  被点击元素标识。
+* @param extraPayload 额外 payload 字段。
+*/
+function trackPageClick(pageKey, pageName, pos, elementName, extraPayload) {
+	if (typeof window === "undefined") return;
+	const x = pos?.pageX ?? 0;
+	const y = pos?.pageY ?? 0;
+	const w = window.innerWidth || 1;
+	const h = window.innerHeight || 1;
+	const pageClickPayload = {
+		page_key: pageKey,
+		page_name: pageName,
+		element_name: elementName,
+		click_page_x: Math.round(x),
+		click_page_y: Math.round(y),
+		click_x_percent: Math.round(x / w * 100),
+		click_y_percent: Math.round(y / h * 100),
+		screen_width: window.screen.width,
+		screen_height: window.screen.height,
+		recommend_trace_id: "",
+		...extraPayload
+	};
+	window.WebSDK?.track?.({
+		event: "page_click",
+		payload: pageClickPayload
+	});
+	window.sensors?.track?.("page_click", pageClickPayload);
+}
+/**
+* 通用 recommend_list_click 上报。
+* @param payload  推荐列表点击 payload。
+*/
+function trackRecommendListClick(payload) {
+	if (typeof window === "undefined") return;
+	const recommendClickPayload = {
+		recommend_trace_id: "",
+		recommend_id: "",
+		recommend_trace_info: "",
+		...payload
+	};
+	window.WebSDK?.track?.({
+		event: "recommend_list_click",
+		payload: recommendClickPayload
+	});
+	window.sensors?.track?.("recommend_list_click", recommendClickPayload);
+}
+/** 模块级 Set，记录已上报过曝光的广告，键格式为 `${ad_slot_key}::${ad_id}`。 */
+const reportedAdImpressionKeys = /* @__PURE__ */ new Set();
+/**
+* 广告展示上报（ad_impression）。
+*
+* 去重规则：同一 ad_slot_key + ad_id 组合在页面生命周期内只上报一次。
+* 支持批量：ad_id 传逗号分隔的多个 ID，函数会自动过滤已上报的部分，
+* 仅将首次出现的 ID 上报，与之位置对应的 creative_id 同步过滤。
+*
+* @param payload  广告展示 payload。
+*/
+function trackAdImpression(payload) {
+	if (typeof window === "undefined") return;
+	const adIds = payload.ad_id.split(",").map((s) => s.trim()).filter(Boolean);
+	const creativeIds = (payload.creative_id ?? "").split(",").map((s) => s.trim());
+	const newIndices = adIds.reduce((acc, adId, i) => {
+		if (!reportedAdImpressionKeys.has(`${payload.ad_slot_key}::${adId}`)) acc.push(i);
+		return acc;
+	}, []);
+	if (newIndices.length === 0) return;
+	for (const i of newIndices) reportedAdImpressionKeys.add(`${payload.ad_slot_key}::${adIds[i]}`);
+	const adImpressionPayload = {
+		...payload,
+		ad_id: newIndices.map((i) => adIds[i]).join(","),
+		creative_id: newIndices.map((i) => creativeIds[i] ?? "").join(",")
+	};
+	window.WebSDK?.track?.({
+		event: "ad_impression",
+		payload: adImpressionPayload
+	});
+	window.sensors?.track?.("ad_impression", adImpressionPayload);
+}
+/**
+* 广告页面事件上报（advertising）。
+* 用于 APP 内部自定义的活动弹窗等场景。
+* @param payload  广告页面事件 payload。
+*/
+function trackAdvertising(payload) {
+	if (typeof window === "undefined") return;
+	window.WebSDK?.track?.({
+		event: "advertising",
+		payload
+	});
+	window.sensors?.track?.("advertising", payload);
+}
+/**
+* 导航模块点击上报（navigation）。
+* @param payload  导航点击 payload。
+*/
+function trackNavigation(payload) {
+	if (typeof window === "undefined") return;
+	window.WebSDK?.track?.({
+		event: "navigation",
+		payload
+	});
+	window.sensors?.track?.("navigation", payload);
+}
+/**
+* 视频行为上报（video_event）。
+* @param payload  视频事件 payload。
+*/
+function trackVideoEvent(payload) {
+	if (typeof window === "undefined") return;
+	window.WebSDK?.track?.({
+		event: "video_event",
+		payload
+	});
+	window.sensors?.track?.("video_event", payload);
+}
+/**
+* 关键词搜索结果点击上报（keyword_click）。
+* @param payload  关键词点击 payload。
+*/
+function trackKeywordClick(payload) {
+	if (typeof window === "undefined") return;
+	window.WebSDK?.track?.({
+		event: "keyword_click",
+		payload
+	});
+	window.sensors?.track?.("keyword_click", payload);
+}
+/**
+* 广告点击上报（ad_click）。
+* P0 等级，从广告中心拉取的广告点击时上报。
+* @param payload  广告点击 payload。
+*/
+function trackAdClick(payload) {
+	if (typeof window === "undefined") return;
+	const adClickPayload = {
+		creative_id: "",
+		...payload
+	};
+	window.WebSDK?.track?.({
+		event: "ad_click",
+		payload: adClickPayload
+	});
+	window.sensors?.track?.("ad_click", adClickPayload);
+}
+function trackAppPageView(payload) {
+	if (typeof window === "undefined") return;
+	const pageViewPayload = {
+		user_type: "normal",
+		referrer_page_key: "",
+		referrer_page_name: "",
+		page_load_time: 0,
+		recommend_trace_id: "",
+		...payload
+	};
+	window.WebSDK?.track?.({
+		event: "app_page_view",
+		payload: pageViewPayload
+	});
+	window.sensors?.track?.("app_page_view", pageViewPayload);
+}
+/**
+* 页面生命周期上报（page_lifecycle）。
+* @param payload  页面生命周期 payload。
+*/
+function trackPageLifecycle(payload) {
+	if (typeof window === "undefined") return;
+	window.WebSDK?.track?.({
+		event: "page_lifecycle",
+		payload
+	});
+	window.sensors?.track?.("page_lifecycle", payload);
+}
+
+//#endregion
+export { trackAdClick, trackAdImpression, trackAdvertising, trackAppPageView, trackKeywordClick, trackNavigation, trackPageClick, trackPageLifecycle, trackRecommendListClick, trackVideoEvent };

package/dist/utils/uint8.mjs

@@ -1,2 +1,47 @@
 
-function e(e){return Array.from(e)}function t(e){let t=32768,n=[];for(let r=0;r<e.length;r+=t){let i=e.subarray(r,r+t);n.push(String.fromCharCode(...i))}return btoa(n.join(``))}function n(e){let t=atob(e),n=new Uint8Array(t.length);for(let e=0;e<t.length;e+=1)n[e]=t.charCodeAt(e);return n}export{n as base64ToUint8Array,t as uint8ArrayToBase64,e as uint8ArrayToNumberArray};
+//#region utils/uint8.ts
+/**
+* Uint8Array/ArrayBuffer 相关工具。
+*
+* 说明：
+* - JS 没有 Dart 的 `Uint8List` 类型；在 Web/TS 里通常使用 `Uint8Array` 等价表示。
+* - 若需要跨 WebView 透出给原生（JSON 传输），可以用 `number[]` 或 base64。
+*/
+/**
+* 将 Uint8Array 转为可 JSON 序列化的 number[]（适用于 Dart: Uint8List.fromList(list)）。
+* @param bytes 输入字节数组。
+* @returns 可 JSON 序列化的数字数组。
+*/
+function uint8ArrayToNumberArray(bytes) {
+	return Array.from(bytes);
+}
+/**
+* 将 Uint8Array 转为 base64 字符串（不包含 data: 前缀）。
+*
+* 注意：图片较大时要分片，否则 `String.fromCharCode(...bytes)` 可能触发调用栈/参数长度限制。
+* @param bytes 输入字节数组。
+* @returns base64 编码字符串。
+*/
+function uint8ArrayToBase64(bytes) {
+	const chunkSize = 32768;
+	const parts = [];
+	for (let i = 0; i < bytes.length; i += chunkSize) {
+		const chunk = bytes.subarray(i, i + chunkSize);
+		parts.push(String.fromCharCode(...chunk));
+	}
+	return btoa(parts.join(""));
+}
+/**
+* 将 base64 字符串（不包含 data: 前缀）转为 Uint8Array。
+* @param base64 base64 编码字符串。
+* @returns 解码后的字节数组。
+*/
+function base64ToUint8Array(base64) {
+	const bin = atob(base64);
+	const out = new Uint8Array(bin.length);
+	for (let i = 0; i < bin.length; i += 1) out[i] = bin.charCodeAt(i);
+	return out;
+}
+
+//#endregion
+export { base64ToUint8Array, uint8ArrayToBase64, uint8ArrayToNumberArray };