@funhub/platform 0.2.29 → 0.2.31

package/dist/components/ui/wheel-picker.mjs

@@ -1,2 +1,29 @@
 
-"use client";import{cn as e}from"../../utils/cn.mjs";import{jsx as t}from"react/jsx-runtime";import*as n from"@ncdai/react-wheel-picker";function r({className:r,...i}){return t(n.WheelPickerWrapper,{className:e(`w-56 rounded-lg border border-text1/10 bg-bg1 px-1 shadow-sm`,`[&>[data-rwp]:first-child [data-rwp-highlight-wrapper]]:rounded-s-md`,`[&>[data-rwp]:last-child [data-rwp-highlight-wrapper]]:rounded-e-md`,r),...i})}function i({classNames:r,...i}){return t(n.WheelPicker,{classNames:{optionItem:`text-text1`,highlightWrapper:e(`bg-text1/20 text-transparent `,`data-[rwp-focused]:ring-2 data-[rwp-focused]:ring-zinc-300 data-[rwp-focused]:ring-inset dark:data-[rwp-focused]:ring-zinc-600`),...r},...i})}export{i as WheelPicker,r as WheelPickerWrapper};
+'use client';
+
+import { cn } from "../../utils/cn.mjs";
+import { jsx } from "react/jsx-runtime";
+import * as WheelPickerPrimitive from "@ncdai/react-wheel-picker";
+
+//#region components/ui/wheel-picker.tsx
+/** UI 组件模块。 */
+/** WheelPickerWrapper 组件。 */
+function WheelPickerWrapper({ className, ...props }) {
+	return /* @__PURE__ */ jsx(WheelPickerPrimitive.WheelPickerWrapper, {
+		className: cn("w-56 rounded-lg border border-text1/10 bg-bg1 px-1 shadow-sm", "[&>[data-rwp]:first-child [data-rwp-highlight-wrapper]]:rounded-s-md", "[&>[data-rwp]:last-child [data-rwp-highlight-wrapper]]:rounded-e-md", className),
+		...props
+	});
+}
+function WheelPicker({ classNames, ...props }) {
+	return /* @__PURE__ */ jsx(WheelPickerPrimitive.WheelPicker, {
+		classNames: {
+			optionItem: "text-text1",
+			highlightWrapper: cn("bg-text1/20 text-transparent ", "data-[rwp-focused]:ring-2 data-[rwp-focused]:ring-zinc-300 data-[rwp-focused]:ring-inset dark:data-[rwp-focused]:ring-zinc-600"),
+			...classNames
+		},
+		...props
+	});
+}
+
+//#endregion
+export { WheelPicker, WheelPickerWrapper };

package/dist/constants/event-key.mjs

@@ -1,2 +1,19 @@
 
-const e={ITEM_INFO_CHANGE:`ITEM_INFO_CHANGE`,DOCUMENT_CLICK:`DOCUMENT_CLICK`,DOCUMENT_TOUCH:`DOCUMENT_TOUCH`,DOCUMENT_SCROLL:`DOCUMENT_SCROLL`,SHOW_LOGIN_POPUP:`SHOW_LOGIN_POPUP`,WAIT_LOADING_SHOW:`WAIT_LOADING_SHOW`,SHOW_POPUP_VIDEO:`SHOW_POPUP_VIDEO`,EXCHANGE_SEARCH_TYPE:`EXCHANGE_SEARCH_TYPE`,EXCHANGE_SEARCH_SORT:`EXCHANGE_SEARCH_SORT`,CHANNEL_LIST_CHANGE:`CHANNEL_LIST_CHANGE`,USER_INFO_LOAD_COMPLETE:`USER_INFO_LOAD_COMPLETE`,SEARCH_HISTORY_UPDATE:`SEARCH_HISTORY_UPDATE`};export{e as eventKey};
+//#region constants/event-key.ts
+const eventKey = {
+	ITEM_INFO_CHANGE: "ITEM_INFO_CHANGE",
+	DOCUMENT_CLICK: "DOCUMENT_CLICK",
+	DOCUMENT_TOUCH: "DOCUMENT_TOUCH",
+	DOCUMENT_SCROLL: "DOCUMENT_SCROLL",
+	SHOW_LOGIN_POPUP: "SHOW_LOGIN_POPUP",
+	WAIT_LOADING_SHOW: "WAIT_LOADING_SHOW",
+	SHOW_POPUP_VIDEO: "SHOW_POPUP_VIDEO",
+	EXCHANGE_SEARCH_TYPE: "EXCHANGE_SEARCH_TYPE",
+	EXCHANGE_SEARCH_SORT: "EXCHANGE_SEARCH_SORT",
+	CHANNEL_LIST_CHANGE: "CHANNEL_LIST_CHANGE",
+	USER_INFO_LOAD_COMPLETE: "USER_INFO_LOAD_COMPLETE",
+	SEARCH_HISTORY_UPDATE: "SEARCH_HISTORY_UPDATE"
+};
+
+//#endregion
+export { eventKey };

package/dist/constants/query-key.mjs

@@ -1,2 +1,33 @@
 
-const e=`channel_content_list_query_key`,t={CHANNEL:`channel_query_key`,CHANNEL_CONTENT_LIST:e,GUESS_YOU_LIKE_USER_DATA:`guess_you_like_user_data_query_key`,FLOATING_BALL:`floating_ball_query_key`,GET_CONTENT_LIST(t){return[e,t||`all`]}};export{t as queryKey};
+//#region constants/query-key.ts
+/**
+* 频道
+*/
+const CHANNEL_QUERY_KEY = "channel_query_key";
+/**
+* 内容列表
+*/
+const CHANNEL_CONTENT_LIST_QUERY_KEY = "channel_content_list_query_key";
+/**
+* 猜你喜欢用户数据
+*/
+const GUESS_YOU_LIKE_USER_DATA_QUERY_KEY = "guess_you_like_user_data_query_key";
+/**
+* 悬浮球
+*/
+const FLOATING_BALL_QUERY_KEY = "floating_ball_query_key";
+/**
+* 查询 key 常量
+*/
+const queryKey = {
+	CHANNEL: CHANNEL_QUERY_KEY,
+	CHANNEL_CONTENT_LIST: CHANNEL_CONTENT_LIST_QUERY_KEY,
+	GUESS_YOU_LIKE_USER_DATA: GUESS_YOU_LIKE_USER_DATA_QUERY_KEY,
+	FLOATING_BALL: FLOATING_BALL_QUERY_KEY,
+	GET_CONTENT_LIST(channelId) {
+		return [CHANNEL_CONTENT_LIST_QUERY_KEY, channelId || "all"];
+	}
+};
+
+//#endregion
+export { queryKey };

package/dist/constants/revalidate.mjs

@@ -1,2 +1,10 @@
 
-const e={TIME:3600};export{e as revalidate};
+//#region constants/revalidate.ts
+/**
+* 数据重新验证时间配置（秒）
+* 用于 Next.js 页面和 API 请求的缓存重新验证时间
+*/
+const revalidate = { TIME: 3600 };
+
+//#endregion
+export { revalidate };

package/dist/constants/site.mjs

@@ -1,2 +1,12 @@
 
-const e={APP_NAME:`次元坞`,URL:process.env.NEXT_PUBLIC_SITE_URL||process.env.SITE_URL||`https://www.guadd.fun`,TITLE:process.env.NEXT_PUBLIC_SITE_TITLE||`精彩视频图片大全_高清影视资源在线观看_内容更新推荐`,DESCRIPTION:process.env.NEXT_PUBLIC_SITE_DESCRIPTION||`为您提供高清影视剧、原创短视频及精美图集资源。本页面汇集全网优质视听内容，支持多种设备流畅播放与预览，精彩看点实时更新，打造极致的视觉发现体验。`,KEYWORDS:process.env.NEXT_PUBLIC_SITE_KEYWORDS||`视频在线观看,高清图片,影视大全,短视频,热门资源,高清素材`};export{e as site};
+//#region constants/site.ts
+const site = {
+	APP_NAME: "次元坞",
+	URL: process.env.NEXT_PUBLIC_SITE_URL || process.env.SITE_URL || "https://www.guadd.fun",
+	TITLE: process.env.NEXT_PUBLIC_SITE_TITLE || "精彩视频图片大全_高清影视资源在线观看_内容更新推荐",
+	DESCRIPTION: process.env.NEXT_PUBLIC_SITE_DESCRIPTION || "为您提供高清影视剧、原创短视频及精美图集资源。本页面汇集全网优质视听内容，支持多种设备流畅播放与预览，精彩看点实时更新，打造极致的视觉发现体验。",
+	KEYWORDS: process.env.NEXT_PUBLIC_SITE_KEYWORDS || "视频在线观看,高清图片,影视大全,短视频,热门资源,高清素材"
+};
+
+//#endregion
+export { site };

package/dist/constants/url-prefix.mjs

@@ -1,2 +1,12 @@
 
-const e={CHANNEL:`/category`,DOMAIN:`/domain`};export{e as urlPrefix};
+//#region constants/url-prefix.ts
+/**
+* 频道链接前缀
+*/
+const urlPrefix = {
+	CHANNEL: "/category",
+	DOMAIN: "/domain"
+};
+
+//#endregion
+export { urlPrefix };

package/dist/hooks/image-text-recommend.mjs

@@ -1,2 +1,72 @@
 
-const e=8;function t(e){if(e==null)return``;let t=e;return t.id||t.content_id||t.video_id||t.mid||``}function n(e){return!e||!Array.isArray(e.tags)?[]:e.tags.map(e=>String(e).trim()).filter(Boolean)}function r(e){for(let t=e.length-1;t>0;t--){let n=Math.floor(Math.random()*(t+1));[e[t],e[n]]=[e[n],e[t]]}return e}function i(e,t){let n=[...e];return r(n),n.slice(0,Math.max(0,t))}function a(e,t){if(t<=0||!e.length)return[];if(e.length>=t)return i(e,t);let n=[];for(let t of e)n.push(t);for(;n.length<t;){let t=e[Math.floor(Math.random()*e.length)];n.push(t)}return r(n),n}function o(e,t){return(e.tags??[]).some(e=>(e.name??``).trim()===t)}function s(e,n,r){let i=new Set,a=[];for(let s=0;s<r;s++){let r=n[s]??``,c=r?e.filter(e=>!i.has(t(e))&&o(e,r)):[],l=c.length?c:e.filter(e=>!i.has(t(e))),u=l.length?l[Math.floor(Math.random()*l.length)]:void 0;u&&(i.add(t(u)),a.push(u))}return a}function c(e,t){return t||!e?.length?[]:e.map(e=>String(e?.contentId??``).trim()).filter(Boolean)}function l(e){let n={};for(let r of e){let e=r,i=t(e);i&&(n[i]=e),e.content_id&&e.content_id!==i&&(n[e.content_id]=e)}return n}export{e as IMAGE_TEXT_RECOMMEND_FIXED_BATCH_SIZE,a as buildImageTextRecommendChosenTags,l as buildImageTextRecommendRemoteMap,s as buildImageTextRecommendSmartPicked,c as getImageTextRecommendFixedIds,n as getImageTextRecommendLayoutTags,t as resolveImageTextRecommendVideoId};
+//#region hooks/image-text-recommend.ts
+/** 关闭智能铺设时，按 id 批量拉取的每批数量 */
+const IMAGE_TEXT_RECOMMEND_FIXED_BATCH_SIZE = 8;
+function resolveImageTextRecommendVideoId(item) {
+	if (item == null) return "";
+	const maybe = item;
+	return maybe.id || maybe.content_id || maybe.video_id || maybe.mid || "";
+}
+function getImageTextRecommendLayoutTags(layout) {
+	if (!layout || !Array.isArray(layout.tags)) return [];
+	return layout.tags.map((s) => String(s).trim()).filter(Boolean);
+}
+function shuffleInPlace(arr) {
+	for (let i = arr.length - 1; i > 0; i--) {
+		const j = Math.floor(Math.random() * (i + 1));
+		[arr[i], arr[j]] = [arr[j], arr[i]];
+	}
+	return arr;
+}
+function pickRandomUnique(arr, count) {
+	const copy = [...arr];
+	shuffleInPlace(copy);
+	return copy.slice(0, Math.max(0, count));
+}
+function buildImageTextRecommendChosenTags(tags, count) {
+	if (count <= 0 || !tags.length) return [];
+	if (tags.length >= count) return pickRandomUnique(tags, count);
+	const result = [];
+	for (const t of tags) result.push(t);
+	while (result.length < count) {
+		const t = tags[Math.floor(Math.random() * tags.length)];
+		result.push(t);
+	}
+	shuffleInPlace(result);
+	return result;
+}
+function imageTextRecommendHasTag(video, tag) {
+	return (video.tags ?? []).some((t) => (t.name ?? "").trim() === tag);
+}
+function buildImageTextRecommendSmartPicked(list, chosenTags, targetCount) {
+	const used = /* @__PURE__ */ new Set();
+	const picked = [];
+	for (let i = 0; i < targetCount; i++) {
+		const tag = chosenTags[i] ?? "";
+		const byTag = tag ? list.filter((v) => !used.has(resolveImageTextRecommendVideoId(v)) && imageTextRecommendHasTag(v, tag)) : [];
+		const pool = byTag.length ? byTag : list.filter((v) => !used.has(resolveImageTextRecommendVideoId(v)));
+		const chosen = pool.length ? pool[Math.floor(Math.random() * pool.length)] : void 0;
+		if (chosen) {
+			used.add(resolveImageTextRecommendVideoId(chosen));
+			picked.push(chosen);
+		}
+	}
+	return picked;
+}
+function getImageTextRecommendFixedIds(items, isSmartEnabled) {
+	if (isSmartEnabled || !items?.length) return [];
+	return items.map((it) => String(it?.contentId ?? "").trim()).filter(Boolean);
+}
+function buildImageTextRecommendRemoteMap(rawVideos) {
+	const map = {};
+	for (const v of rawVideos) {
+		const vid = v;
+		const id = resolveImageTextRecommendVideoId(vid);
+		if (id) map[id] = vid;
+		if (vid.content_id && vid.content_id !== id) map[vid.content_id] = vid;
+	}
+	return map;
+}
+
+//#endregion
+export { IMAGE_TEXT_RECOMMEND_FIXED_BATCH_SIZE, buildImageTextRecommendChosenTags, buildImageTextRecommendRemoteMap, buildImageTextRecommendSmartPicked, getImageTextRecommendFixedIds, getImageTextRecommendLayoutTags, resolveImageTextRecommendVideoId };

package/dist/hooks/query/hydration-boundary.mjs

@@ -1,2 +1,35 @@
 
-import{jsx as e}from"react/jsx-runtime";import{HydrationBoundary as t,QueryClient as n,dehydrate as r}from"@tanstack/react-query";async function i(i){let{children:a,prefetch:o}=i,s=new n;return await Promise.all(o?.map(e=>e.type===`infinite`?s.prefetchInfiniteQuery({queryKey:e.queryKey,queryFn:({pageParam:t})=>e.queryFn(t),initialPageParam:e.initialPageParam??1,getNextPageParam:e.getNextPageParam??(()=>void 0)}):s.prefetchQuery({queryKey:e.queryKey,queryFn:e.queryFn}))||[]),e(t,{state:r(s),children:a})}export{i as HydrationBoundary};
+import { jsx } from "react/jsx-runtime";
+import { HydrationBoundary, QueryClient, dehydrate } from "@tanstack/react-query";
+
+//#region hooks/query/hydration-boundary.tsx
+/**
+* HydrationBoundary 组件
+* @param props - 组件属性
+* @param props.children - 子组件
+* @param props.prefetch - 预取数据
+* @returns
+*/
+async function HydrationBoundary$1(props) {
+	const { children, prefetch } = props;
+	const queryClient = new QueryClient();
+	await Promise.all(prefetch?.map((item) => {
+		if (item.type === "infinite") return queryClient.prefetchInfiniteQuery({
+			queryKey: item.queryKey,
+			queryFn: ({ pageParam }) => item.queryFn(pageParam),
+			initialPageParam: item.initialPageParam ?? 1,
+			getNextPageParam: item.getNextPageParam ?? (() => void 0)
+		});
+		return queryClient.prefetchQuery({
+			queryKey: item.queryKey,
+			queryFn: item.queryFn
+		});
+	}) || []);
+	return /* @__PURE__ */ jsx(HydrationBoundary, {
+		state: dehydrate(queryClient),
+		children
+	});
+}
+
+//#endregion
+export { HydrationBoundary$1 as HydrationBoundary };

package/dist/hooks/query/use-query.mjs

@@ -1,2 +1,115 @@
 
-import{useInfiniteQuery as e,useMutation as t,useQuery as n,useQueryClient as r}from"@tanstack/react-query";function i(e,t,r){return n({queryKey:e,queryFn:t,staleTime:1/0,...r})}function a(e,n){return t({mutationFn:e,...n})}function o(t){let{key:n,queryFn:r,getNextPageParam:i,options:a,initialPageParam:o}=t;return e({queryKey:n,queryFn:({pageParam:e})=>r(e),initialPageParam:o??1,getNextPageParam:i,staleTime:1/0,...a})}function s(){let e=r();return(t,n,r)=>{e.setQueryData(t,n,r)}}function c(){let e=r();return t=>{e.invalidateQueries({queryKey:t})}}function l(){let e=r();return t=>{e.refetchQueries({queryKey:t})}}function u(){let e=r();return async(t,n)=>{await e.prefetchQuery({queryKey:t,queryFn:n})}}export{c as useDeleteRequest,a as useMutation,o as usePaginated,u as usePrefetchQuery,l as useRefetchQuery,i as useRequest,s as useUpdateRequest};
+import { useInfiniteQuery, useMutation, useQuery, useQueryClient } from "@tanstack/react-query";
+
+//#region hooks/query/use-query.ts
+/**
+* 基于 `@tanstack/react-query` 的 `useQuery` 简易封装。
+*
+* - 默认 `staleTime: Infinity`：数据将被视为永不过期（除非手动失效/更新）。
+*
+* @typeParam T - 请求返回的数据类型
+* @param key - Query Key（建议稳定且可序列化）
+* @param queryFn - 异步请求函数
+* @param options - `useQuery` 额外配置（会覆盖默认配置）
+*/
+function useRequest(key, queryFn, options) {
+	return useQuery({
+		queryKey: key,
+		queryFn,
+		staleTime: Infinity,
+		...options
+	});
+}
+/**
+* 基于 `useMutation` 的数据写入封装。
+*
+* @typeParam TData - 返回数据类型
+* @typeParam TVariables - 变量类型
+* @typeParam TContext - 上下文类型
+* @param mutationFn - 写入请求函数
+* @param options - `useMutation` 额外配置
+*/
+function useMutation$1(mutationFn, options) {
+	return useMutation({
+		mutationFn,
+		...options
+	});
+}
+/**
+* 基于 `useInfiniteQuery` 的分页（无限滚动）封装。
+*
+* - 默认 `initialPageParam: 1`
+* - 默认 `staleTime: Infinity`：数据将被视为永不过期（除非手动失效/更新）
+*
+* @typeParam T - 单页返回的数据类型
+* @param params - 参数对象
+* @param params.key - Query Key（建议包含分页相关筛选条件）
+* @param params.queryFn - 根据 `pageParam` 拉取一页数据的函数
+* @param params.getNextPageParam - 根据最后一页和所有页计算下一页 `pageParam`
+* @param params.options - `useInfiniteQuery` 额外配置（不包含 queryKey/queryFn/initialPageParam/getNextPageParam）
+* @param params.initialPageParam - 初始 `pageParam`（默认 1）
+*/
+function usePaginated(params) {
+	const { key, queryFn, getNextPageParam, options, initialPageParam } = params;
+	return useInfiniteQuery({
+		queryKey: key,
+		queryFn: ({ pageParam }) => queryFn(pageParam),
+		initialPageParam: initialPageParam ?? 1,
+		getNextPageParam,
+		staleTime: Infinity,
+		...options
+	});
+}
+/**
+* 获取一个用于更新（写入）指定 queryKey 缓存数据的函数。
+*
+* @typeParam T - 缓存数据类型
+* @returns 写入函数：`(key, data, options) => void`
+*/
+function useUpdateRequest() {
+	const queryClient = useQueryClient();
+	return (key, data, options) => {
+		queryClient.setQueryData(key, data, options);
+	};
+}
+/**
+* 获取一个用于使指定 queryKey 失效（触发重新获取）的函数。
+*
+* @returns 失效函数：`(key) => void`
+*/
+function useDeleteRequest() {
+	const queryClient = useQueryClient();
+	return (key) => {
+		queryClient.invalidateQueries({ queryKey: key });
+	};
+}
+/**
+* 获取一个用于主动重新请求指定 queryKey 的函数（不等待失效策略）。
+*
+* @returns 重新获取函数：`(key) => void`
+*/
+function useRefetchQuery() {
+	const queryClient = useQueryClient();
+	return (key) => {
+		queryClient.refetchQueries({ queryKey: key });
+	};
+}
+/**
+* 获取一个用于预获取（prefetch）指定 queryKey 的函数。
+*
+* 适用于：进入页面前预热数据、hover/曝光时提前拉取等。
+*
+* @returns 预获取函数：`(key, queryFn) => Promise<void>`
+*/
+function usePrefetchQuery() {
+	const queryClient = useQueryClient();
+	return async (key, queryFn) => {
+		await queryClient.prefetchQuery({
+			queryKey: key,
+			queryFn
+		});
+	};
+}
+
+//#endregion
+export { useDeleteRequest, useMutation$1 as useMutation, usePaginated, usePrefetchQuery, useRefetchQuery, useRequest, useUpdateRequest };

package/dist/hooks/use-auth.mjs

@@ -1,2 +1,199 @@
 
-import{useUserStore as e}from"../store/modules/user-store.mjs";import{useLoginModalStore as t}from"../store/modules/login-modal-store.mjs";import{useCallback as n}from"react";function r(){return e(e=>e.token)}function i(){return e(e=>e.expireTime)}function a(){return e(e=>e.userId)}function o(){let t=e(e=>e.setToken),r=e(e=>e.setExpireTime),i=e(e=>e.setIsLogin),a=e(e=>e.setUserId);return n(e=>{e.token!==void 0&&t(e.token),e.expireTime!==void 0&&r(e.expireTime),e.userId!==void 0&&a(e.userId),i(!!e.userId)},[t,r,i,a])}function s(){return e(e=>e.isLogin)}function c(){return e(e=>e.userInfo)}function l(){return t(e=>e.open)}function u(){return t(e=>e.openAsync)}function d(){let e=t(e=>e.openWithStep);return n(()=>{e(`reset-password`)},[e])}function f(){return t(e=>e.close)}function p(){return t(e=>e.isOpen)}function m(){return e(e=>e.logout)}function h(){let t=e(e=>e.isLogin),r=u(),i=f();return n(async e=>{t?e():await r()&&(i(),e())},[i,t,r])}function g(){let n=e(e=>e.isLogin),r=e(e=>e.userInfo),i=e(e=>e.logout),o=t(e=>e.open),s=t(e=>e.close),c=t(e=>e.isOpen);return{isLoggedIn:n,userInfo:r,userId:a(),openLogin:o,closeLogin:s,isLoginModalOpen:c,logout:i}}export{g as useAuth,f as useCloseLogin,i as useExpireTime,s as useIsLoggedIn,p as useLoginModalOpen,m as useLogout,l as useOpenLogin,u as useOpenLoginAsync,d as useOpenResetPassword,h as useRequireLogin,o as useSetAuthFields,r as useToken,a as useUserId,c as useUserInfo};
+import { useUserStore } from "../store/modules/user-store.mjs";
+import { useLoginModalStore } from "../store/modules/login-modal-store.mjs";
+import { useCallback } from "react";
+
+//#region hooks/use-auth.ts
+/**
+* 获取当前 token
+* @returns token 字符串，未登录时返回空字符串
+* @example
+* const token = useToken();
+*/
+function useToken() {
+	return useUserStore((state) => state.token);
+}
+/**
+* 获取 token 过期时间
+* @returns 过期时间戳，未设置时返回 0
+* @example
+* const expireTime = useExpireTime();
+*/
+function useExpireTime() {
+	return useUserStore((state) => state.expireTime);
+}
+/**
+* 获取当前登录用户ID
+* @returns 用户ID，未登录时返回空字符串
+* @example
+* const userId = useUserId();
+*/
+function useUserId() {
+	return useUserStore((state) => state.userId);
+}
+/**
+* 获取设置认证字段的方法，支持同时设置多个值或单个值
+* @returns setAuthFields 方法
+* @example
+* const setAuthFields = useSetAuthFields();
+*
+* // 设置单个值
+* setAuthFields({ token: 'new-token' });
+*
+* // 同时设置多个值
+* setAuthFields({
+*   token: 'new-token',
+*   expireTime: Date.now() + 3600000,
+*   userId: 'user-123'
+* });
+*/
+function useSetAuthFields() {
+	const setToken = useUserStore((state) => state.setToken);
+	const setExpireTime = useUserStore((state) => state.setExpireTime);
+	const setIsLogin = useUserStore((state) => state.setIsLogin);
+	const setUserId = useUserStore((state) => state.setUserId);
+	return useCallback((fields) => {
+		if (fields.token !== void 0) setToken(fields.token);
+		if (fields.expireTime !== void 0) setExpireTime(fields.expireTime);
+		if (fields.userId !== void 0) setUserId(fields.userId);
+		setIsLogin(!!fields.userId);
+	}, [
+		setToken,
+		setExpireTime,
+		setIsLogin,
+		setUserId
+	]);
+}
+/**
+* 检查用户是否已登录
+* @returns 用户是否已登录的布尔值
+* @example
+* const isLoggedIn = useIsLoggedIn();
+* if (!isLoggedIn) {
+*   // 用户未登录
+* }
+*/
+function useIsLoggedIn() {
+	return useUserStore((state) => state.isLogin);
+}
+/**
+* 获取当前用户信息
+* @returns 用户信息对象，未登录时返回默认值
+* @example
+* const userInfo = useUserInfo();
+* console.log(userInfo.name, userInfo.avatar);
+*/
+function useUserInfo() {
+	return useUserStore((state) => state.userInfo);
+}
+/**
+* 调起登录弹窗的 Hook
+* 返回打开登录弹窗的方法
+* @returns openLogin 方法
+* @example
+* const openLogin = useOpenLogin();
+* // 在需要登录时调用
+* openLogin();
+*/
+function useOpenLogin() {
+	return useLoginModalStore((state) => state.open);
+}
+/**
+* 调起登录弹窗并等待结果的 Hook
+* - resolve(true): 登录成功
+* - resolve(false): 用户关闭/取消
+*/
+function useOpenLoginAsync() {
+	return useLoginModalStore((state) => state.openAsync);
+}
+/**
+* 调起重置密码入口
+* @returns openResetPassword 方法
+*/
+function useOpenResetPassword() {
+	const openWithStep = useLoginModalStore((state) => state.openWithStep);
+	return useCallback(() => {
+		openWithStep("reset-password");
+	}, [openWithStep]);
+}
+/**
+* 关闭登录弹窗的 Hook
+* @returns closeLogin 方法
+*/
+function useCloseLogin() {
+	return useLoginModalStore((state) => state.close);
+}
+/**
+* 登录弹窗状态 Hook
+* @returns 登录弹窗是否打开
+*/
+function useLoginModalOpen() {
+	return useLoginModalStore((state) => state.isOpen);
+}
+/**
+* 退出登录的 Hook
+* @returns logout 方法
+* @example
+* const logout = useLogout();
+* logout();
+*/
+function useLogout() {
+	return useUserStore((state) => state.logout);
+}
+/**
+* 需要登录才能执行操作的 Hook
+* 如果用户未登录，则打开登录弹窗；如果已登录，则执行回调
+* 登录成功后会继续执行回调，取消/关闭则不执行
+* @returns requireLogin 方法（异步）
+* @example
+* const requireLogin = useRequireLogin();
+*
+* const handleLike = () => {
+*   requireLogin(() => {
+*     // 用户已登录，执行点赞操作
+*     doLike();
+*   });
+* };
+*/
+function useRequireLogin() {
+	const isLogin = useUserStore((state) => state.isLogin);
+	const openLoginAsync = useOpenLoginAsync();
+	const closeLogin = useCloseLogin();
+	return useCallback(async (callback) => {
+		if (isLogin) callback();
+		else if (await openLoginAsync()) {
+			closeLogin();
+			callback();
+		}
+	}, [
+		closeLogin,
+		isLogin,
+		openLoginAsync
+	]);
+}
+/**
+* 完整的认证状态 Hook
+* 返回用户登录状态、用户信息以及登录相关操作
+* @example
+* const { isLoggedIn, userInfo, openLogin, closeLogin, logout } = useAuth();
+*/
+function useAuth() {
+	const isLoggedIn = useUserStore((state) => state.isLogin);
+	const userInfo = useUserStore((state) => state.userInfo);
+	const logout = useUserStore((state) => state.logout);
+	const openLogin = useLoginModalStore((state) => state.open);
+	const closeLogin = useLoginModalStore((state) => state.close);
+	const isLoginModalOpen = useLoginModalStore((state) => state.isOpen);
+	return {
+		isLoggedIn,
+		userInfo,
+		userId: useUserId(),
+		openLogin,
+		closeLogin,
+		isLoginModalOpen,
+		logout
+	};
+}
+
+//#endregion
+export { useAuth, useCloseLogin, useExpireTime, useIsLoggedIn, useLoginModalOpen, useLogout, useOpenLogin, useOpenLoginAsync, useOpenResetPassword, useRequireLogin, useSetAuthFields, useToken, useUserId, useUserInfo };