@funhub/platform 0.2.29 → 0.2.31

package/dist/hooks/use-follow.mjs

@@ -1,2 +1,70 @@
 
-"use client";import{followUser as e,getCurrentUserId as t,unfollowUser as n}from"../utils/follow-service.mjs";import{useCallback as r,useState as i}from"react";function a(a=!1,o){let[s,c]=i(a),[l,u]=i(!1);return{followed:s,loading:l,toggleFollow:r(async()=>{if(!o)return console.warn(`用户ID不能为空`),{success:!1,message:`用户ID不能为空`};if(l)return{success:!1,message:`操作进行中，请稍候`};u(!0);let r=!s;try{let i=t(),a;return a=r?await e({app_id:0,follower_id:i,followee_id:o}):await n({app_id:0,follower_id:i,followee_id:o}),a.success&&c(r),a}catch(e){return console.error(`关注操作异常:`,e),{success:!1,message:`操作失败，请稍后重试`}}finally{u(!1)}},[s,l,o]),setFollowedState:r(e=>{c(e)},[])}}export{a as useFollow};
+'use client';
+
+import { followUser, getCurrentUserId, unfollowUser } from "../utils/follow-service.mjs";
+import { useCallback, useState } from "react";
+
+//#region hooks/use-follow.ts
+/**
+* 关注状态管理Hook
+* @param initialFollowed 初始关注状态
+* @param userId 目标用户ID
+* @returns 关注状态和操作方法
+*/
+function useFollow(initialFollowed = false, userId) {
+	const [followed, setFollowed] = useState(initialFollowed);
+	const [loading, setLoading] = useState(false);
+	return {
+		followed,
+		loading,
+		toggleFollow: useCallback(async () => {
+			if (!userId) {
+				console.warn("用户ID不能为空");
+				return {
+					success: false,
+					message: "用户ID不能为空"
+				};
+			}
+			if (loading) return {
+				success: false,
+				message: "操作进行中，请稍候"
+			};
+			setLoading(true);
+			const nextFollowed = !followed;
+			try {
+				const currentUserId = getCurrentUserId();
+				let result;
+				if (nextFollowed) result = await followUser({
+					app_id: 0,
+					follower_id: currentUserId,
+					followee_id: userId
+				});
+				else result = await unfollowUser({
+					app_id: 0,
+					follower_id: currentUserId,
+					followee_id: userId
+				});
+				if (result.success) setFollowed(nextFollowed);
+				return result;
+			} catch (error) {
+				console.error("关注操作异常:", error);
+				return {
+					success: false,
+					message: "操作失败，请稍后重试"
+				};
+			} finally {
+				setLoading(false);
+			}
+		}, [
+			followed,
+			loading,
+			userId
+		]),
+		setFollowedState: useCallback((state) => {
+			setFollowed(state);
+		}, [])
+	};
+}
+
+//#endregion
+export { useFollow };

package/dist/hooks/use-fullscreen-gestures.mjs

@@ -1,2 +1,145 @@
 
-"use client";import{useCallback as e,useRef as t}from"react";function n({getPageHeight:n,isAnimating:r,applyTransform:i,onSwipeNext:a,onSwipePrev:o,onGestureStart:s,onGestureEnd:c,onSwipeCancel:l}){let u=t(null),d=e(e=>{r()||e.isPrimary&&(e.pointerType===`mouse`&&e.button!==0||(i({dy:0,withTransition:!1}),u.current={pointerId:e.pointerId,startX:e.clientX,startY:e.clientY,lastX:e.clientX,lastY:e.clientY,minDy:0,maxDy:0,lockAxis:null,active:!0},s?.({pointerType:e.pointerType})))},[i,r,s]),f=e(e=>{let t=u.current;if(!t?.active||r()||!e.isPrimary||e.pointerId!==t.pointerId)return;t.lastX=e.clientX,t.lastY=e.clientY;let n=t.lastX-t.startX,a=t.lastY-t.startY;if(!t.lockAxis){if(Math.abs(n)<10&&Math.abs(a)<10)return;if(t.lockAxis=Math.abs(a)>=Math.abs(n)?`y`:`x`,t.lockAxis===`y`)try{e.currentTarget.setPointerCapture(e.pointerId)}catch{}}t.lockAxis===`y`&&(t.minDy=Math.min(t.minDy,a),t.maxDy=Math.max(t.maxDy,a),e.preventDefault(),i({dy:a,withTransition:!1}))},[i,r]),p=e(async({minDy:e,maxDy:t})=>{let r=n()/20;if(r<=0){i({dy:0,withTransition:!0}),l?.({reason:`invalid-height`});return}let s=e<=-r,c=t>=r;s&&c?Math.abs(e)>=Math.abs(t)?await a():await o():s?await a():c?await o():(i({dy:0,withTransition:!0}),l?.({reason:`threshold`}))},[n,a,o,i,l]);return{handlePointerDown:d,handlePointerMove:f,handlePointerUpOrCancel:e(e=>{let t=u.current;if(t?.active&&!r()&&!(e&&e.pointerId!==t.pointerId)){if(!t.lockAxis){u.current=null,c?.({lockAxis:null,minDy:t.minDy,maxDy:t.maxDy});return}if(e)try{e.currentTarget.releasePointerCapture(e.pointerId)}catch{}if(u.current=null,t.lockAxis===`y`){c?.({lockAxis:t.lockAxis,minDy:t.minDy,maxDy:t.maxDy}),p({minDy:t.minDy,maxDy:t.maxDy});return}c?.({lockAxis:t.lockAxis,minDy:t.minDy,maxDy:t.maxDy}),t.lockAxis===`x`&&l?.({reason:`x-axis`}),i({dy:0,withTransition:!0})}},[i,p,r,c,l])}}export{n as useFullscreenGestures};
+'use client';
+
+import { useCallback, useRef } from "react";
+
+//#region hooks/use-fullscreen-gestures.ts
+function useFullscreenGestures({ getPageHeight, isAnimating, applyTransform, onSwipeNext, onSwipePrev, onGestureStart, onGestureEnd, onSwipeCancel }) {
+	const gestureRef = useRef(null);
+	const handlePointerDown = useCallback((e) => {
+		if (isAnimating()) return;
+		if (!e.isPrimary) return;
+		if (e.pointerType === "mouse" && e.button !== 0) return;
+		applyTransform({
+			dy: 0,
+			withTransition: false
+		});
+		gestureRef.current = {
+			pointerId: e.pointerId,
+			startX: e.clientX,
+			startY: e.clientY,
+			lastX: e.clientX,
+			lastY: e.clientY,
+			minDy: 0,
+			maxDy: 0,
+			lockAxis: null,
+			active: true
+		};
+		onGestureStart?.({ pointerType: e.pointerType });
+	}, [
+		applyTransform,
+		isAnimating,
+		onGestureStart
+	]);
+	const handlePointerMove = useCallback((e) => {
+		const g = gestureRef.current;
+		if (!g?.active) return;
+		if (isAnimating()) return;
+		if (!e.isPrimary) return;
+		if (e.pointerId !== g.pointerId) return;
+		g.lastX = e.clientX;
+		g.lastY = e.clientY;
+		const dx = g.lastX - g.startX;
+		const dy = g.lastY - g.startY;
+		if (!g.lockAxis) {
+			if (Math.abs(dx) < 10 && Math.abs(dy) < 10) return;
+			g.lockAxis = Math.abs(dy) >= Math.abs(dx) ? "y" : "x";
+			if (g.lockAxis === "y") try {
+				e.currentTarget.setPointerCapture(e.pointerId);
+			} catch {}
+		}
+		if (g.lockAxis === "y") {
+			g.minDy = Math.min(g.minDy, dy);
+			g.maxDy = Math.max(g.maxDy, dy);
+			e.preventDefault();
+			applyTransform({
+				dy,
+				withTransition: false
+			});
+		}
+	}, [applyTransform, isAnimating]);
+	const endSwipe = useCallback(async ({ minDy, maxDy }) => {
+		const threshold = getPageHeight() / 20;
+		if (threshold <= 0) {
+			applyTransform({
+				dy: 0,
+				withTransition: true
+			});
+			onSwipeCancel?.({ reason: "invalid-height" });
+			return;
+		}
+		const shouldNext = minDy <= -threshold;
+		const shouldPrev = maxDy >= threshold;
+		if (shouldNext && shouldPrev) if (Math.abs(minDy) >= Math.abs(maxDy)) await onSwipeNext();
+		else await onSwipePrev();
+		else if (shouldNext) await onSwipeNext();
+		else if (shouldPrev) await onSwipePrev();
+		else {
+			applyTransform({
+				dy: 0,
+				withTransition: true
+			});
+			onSwipeCancel?.({ reason: "threshold" });
+		}
+	}, [
+		getPageHeight,
+		onSwipeNext,
+		onSwipePrev,
+		applyTransform,
+		onSwipeCancel
+	]);
+	return {
+		handlePointerDown,
+		handlePointerMove,
+		handlePointerUpOrCancel: useCallback((e) => {
+			const g = gestureRef.current;
+			if (!g?.active) return;
+			if (isAnimating()) return;
+			if (e && e.pointerId !== g.pointerId) return;
+			if (!g.lockAxis) {
+				gestureRef.current = null;
+				onGestureEnd?.({
+					lockAxis: null,
+					minDy: g.minDy,
+					maxDy: g.maxDy
+				});
+				return;
+			}
+			if (e) try {
+				e.currentTarget.releasePointerCapture(e.pointerId);
+			} catch {}
+			gestureRef.current = null;
+			if (g.lockAxis === "y") {
+				onGestureEnd?.({
+					lockAxis: g.lockAxis,
+					minDy: g.minDy,
+					maxDy: g.maxDy
+				});
+				endSwipe({
+					minDy: g.minDy,
+					maxDy: g.maxDy
+				});
+				return;
+			}
+			onGestureEnd?.({
+				lockAxis: g.lockAxis,
+				minDy: g.minDy,
+				maxDy: g.maxDy
+			});
+			if (g.lockAxis === "x") onSwipeCancel?.({ reason: "x-axis" });
+			applyTransform({
+				dy: 0,
+				withTransition: true
+			});
+		}, [
+			applyTransform,
+			endSwipe,
+			isAnimating,
+			onGestureEnd,
+			onSwipeCancel
+		])
+	};
+}
+
+//#endregion
+export { useFullscreenGestures };

package/dist/hooks/use-interaction-animation.mjs

@@ -1,2 +1,27 @@
 
-import{useCallback as e,useState as t}from"react";function n(n={}){let{duration:r=600}=n,[i,a]=t(!1),[o,s]=t(``);return{isAnimating:i,animationClass:o,trigger:e((e,t)=>{if(i)return;a(!0),s(e);let n=setTimeout(()=>{a(!1),s(``),t?.()},r);return()=>clearTimeout(n)},[i,r])}}export{n as useInteractionAnimation};
+import { useCallback, useState } from "react";
+
+//#region hooks/use-interaction-animation.ts
+function useInteractionAnimation(options = {}) {
+	const { duration = 600 } = options;
+	const [isAnimating, setIsAnimating] = useState(false);
+	const [animationClass, setAnimationClass] = useState("");
+	return {
+		isAnimating,
+		animationClass,
+		trigger: useCallback((targetAnimationClass, callback) => {
+			if (isAnimating) return;
+			setIsAnimating(true);
+			setAnimationClass(targetAnimationClass);
+			const timer = setTimeout(() => {
+				setIsAnimating(false);
+				setAnimationClass("");
+				callback?.();
+			}, duration);
+			return () => clearTimeout(timer);
+		}, [isAnimating, duration])
+	};
+}
+
+//#endregion
+export { useInteractionAnimation };

package/dist/hooks/use-is-client.mjs

@@ -1,2 +1,21 @@
 
-"use client";import{useEffect as e,useState as t}from"react";function n(){let[n,r]=t(!1);return e(()=>{r(!0)},[]),n}export{n as useIsClient};
+'use client';
+
+import { useEffect, useState } from "react";
+
+//#region hooks/use-is-client.ts
+/**
+* 判断当前是否在客户端环境
+*
+* 用于处理 SSR/CSR 兼容性问题
+*/
+function useIsClient() {
+	const [isClient, setIsClient] = useState(false);
+	useEffect(() => {
+		setIsClient(true);
+	}, []);
+	return isClient;
+}
+
+//#endregion
+export { useIsClient };

package/dist/hooks/use-keyboard-open.mjs

@@ -1,2 +1,57 @@
 
-"use client";import{useCallback as e,useEffect as t,useRef as n,useState as r}from"react";function i(){let[i,a]=r(!1),[o,s]=r(0),c=n(0),l=e(()=>{if(typeof window>`u`)return;let e=window.innerHeight,t=Math.max(0,c.current-e);s(t),a(t>100)},[]),u=e(()=>{l()},[l]),d=e(()=>{a(!0),l()},[l]),f=e(()=>{l()},[l]);return t(()=>{if(typeof window>`u`)return;c.current=window.innerHeight,window.addEventListener(`resize`,u);let e=e=>{e.target?.matches?.(`input, textarea, [contenteditable]`)&&d()},t=e=>{e.target?.matches?.(`input, textarea, [contenteditable]`)&&f()};return document.addEventListener(`focusin`,e),document.addEventListener(`focusout`,t),()=>{window.removeEventListener(`resize`,u),document.removeEventListener(`focusin`,e),document.removeEventListener(`focusout`,t)}},[u,f,d]),{isOpen:i,height:o}}export{i as useKeyboardOpen};
+'use client';
+
+import { useCallback, useEffect, useRef, useState } from "react";
+
+//#region hooks/use-keyboard-open.ts
+function useKeyboardOpen() {
+	const [isOpen, setIsOpen] = useState(false);
+	const [height, setHeight] = useState(0);
+	const initialHeight = useRef(0);
+	const calculateHeight = useCallback(() => {
+		if (typeof window === "undefined") return;
+		const currentHeight = window.innerHeight;
+		const keyboardHeight = Math.max(0, initialHeight.current - currentHeight);
+		setHeight(keyboardHeight);
+		setIsOpen(keyboardHeight > 100);
+	}, []);
+	const handleResize = useCallback(() => {
+		calculateHeight();
+	}, [calculateHeight]);
+	const onFocus = useCallback(() => {
+		setIsOpen(true);
+		calculateHeight();
+	}, [calculateHeight]);
+	const onBlur = useCallback(() => {
+		calculateHeight();
+	}, [calculateHeight]);
+	useEffect(() => {
+		if (typeof window === "undefined") return;
+		initialHeight.current = window.innerHeight;
+		window.addEventListener("resize", handleResize);
+		const handleFocusIn = (event) => {
+			if (event.target?.matches?.("input, textarea, [contenteditable]")) onFocus();
+		};
+		const handleFocusOut = (event) => {
+			if (event.target?.matches?.("input, textarea, [contenteditable]")) onBlur();
+		};
+		document.addEventListener("focusin", handleFocusIn);
+		document.addEventListener("focusout", handleFocusOut);
+		return () => {
+			window.removeEventListener("resize", handleResize);
+			document.removeEventListener("focusin", handleFocusIn);
+			document.removeEventListener("focusout", handleFocusOut);
+		};
+	}, [
+		handleResize,
+		onBlur,
+		onFocus
+	]);
+	return {
+		isOpen,
+		height
+	};
+}
+
+//#endregion
+export { useKeyboardOpen };

package/dist/hooks/use-like-dislike.mjs

@@ -1,2 +1,41 @@
 
-function e(){let e=e=>{let t=e.like_flag===`1`,n=e.like_flag===`2`,r={...e,like_flag:t?`0`:`1`,like_cnt:t?Math.max(0,Number(e.like_cnt)-1).toString():(Number(e.like_cnt)+1).toString()};return!t&&n&&(r.dislike_cnt=Math.max(0,Number(e.dislike_cnt)-1).toString()),r},t=e=>{let t=e.like_flag===`1`,n=e.like_flag===`2`,r={...e,like_flag:n?`0`:`2`,dislike_cnt:n?Math.max(0,Number(e.dislike_cnt)-1).toString():(Number(e.dislike_cnt)+1).toString()};return!n&&t&&(r.like_cnt=Math.max(0,Number(e.like_cnt)-1).toString()),r};return{getLikedData:e,getDislikedData:t,getLikedListData:(t,n)=>t.map(t=>t.id===n?e(t):t),getDislikedListData:(e,n)=>e.map(e=>e.id===n?t(e):e)}}export{e as useLikeDislike};
+//#region hooks/use-like-dislike.ts
+/**
+* 历史遗留问题，这里不必须使用use
+* @returns
+*/
+function useLikeDislike() {
+	const getLikedData = (item) => {
+		const isLiked = item.like_flag === "1";
+		const isDisliked = item.like_flag === "2";
+		const next = {
+			...item,
+			like_flag: isLiked ? "0" : "1",
+			like_cnt: isLiked ? Math.max(0, Number(item.like_cnt) - 1).toString() : (Number(item.like_cnt) + 1).toString()
+		};
+		if (!isLiked && isDisliked) next.dislike_cnt = Math.max(0, Number(item.dislike_cnt) - 1).toString();
+		return next;
+	};
+	const getDislikedData = (item) => {
+		const isLiked = item.like_flag === "1";
+		const isDisliked = item.like_flag === "2";
+		const next = {
+			...item,
+			like_flag: isDisliked ? "0" : "2",
+			dislike_cnt: isDisliked ? Math.max(0, Number(item.dislike_cnt) - 1).toString() : (Number(item.dislike_cnt) + 1).toString()
+		};
+		if (!isDisliked && isLiked) next.like_cnt = Math.max(0, Number(item.like_cnt) - 1).toString();
+		return next;
+	};
+	const getLikedListData = (list, targetId) => list.map((item) => item.id === targetId ? getLikedData(item) : item);
+	const getDislikedListData = (list, targetId) => list.map((item) => item.id === targetId ? getDislikedData(item) : item);
+	return {
+		getLikedData,
+		getDislikedData,
+		getLikedListData,
+		getDislikedListData
+	};
+}
+
+//#endregion
+export { useLikeDislike };

package/dist/hooks/use-min-duration-loading.mjs

@@ -1,2 +1,64 @@
 
-import{useCallback as e,useEffect as t,useRef as n,useState as r}from"react";function i(i=500){let[a,o]=r(!1),s=n(!1),c=n(0),l=n(null),u=e(()=>{l.current&&=(clearTimeout(l.current),null),s.current=!1,o(!1)},[]),d=e(()=>{l.current&&=(clearTimeout(l.current),null),c.current=Date.now(),s.current=!0,o(!0)},[]),f=e(()=>{if(!s.current)return;let e=i-(Date.now()-(c.current||Date.now()));if(e<=0){s.current=!1,o(!1);return}l.current&&clearTimeout(l.current),l.current=setTimeout(()=>{l.current=null,s.current=!1,o(!1)},e)},[i]);return t(()=>()=>{u()},[u]),{isLoading:a,show:d,hide:f,cancel:u}}export{i as useMinDurationLoading};
+import { useCallback, useEffect, useRef, useState } from "react";
+
+//#region hooks/use-min-duration-loading.ts
+/**
+* useMinDurationLoading
+*
+* 用于控制 loading 的展示时长：当请求很快完成时，保证 loading 至少展示 `minDuration` 毫秒，
+* 避免 UI 闪烁。
+*
+* @param minDuration - 最小展示时长（ms），默认 500
+*/
+function useMinDurationLoading(minDuration = 500) {
+	const [isLoading, setIsLoading] = useState(false);
+	const visibleRef = useRef(false);
+	const startedAtRef = useRef(0);
+	const timerRef = useRef(null);
+	const cancel = useCallback(() => {
+		if (timerRef.current) {
+			clearTimeout(timerRef.current);
+			timerRef.current = null;
+		}
+		visibleRef.current = false;
+		setIsLoading(false);
+	}, []);
+	const show = useCallback(() => {
+		if (timerRef.current) {
+			clearTimeout(timerRef.current);
+			timerRef.current = null;
+		}
+		startedAtRef.current = Date.now();
+		visibleRef.current = true;
+		setIsLoading(true);
+	}, []);
+	const hide = useCallback(() => {
+		if (!visibleRef.current) return;
+		const remaining = minDuration - (Date.now() - (startedAtRef.current || Date.now()));
+		if (remaining <= 0) {
+			visibleRef.current = false;
+			setIsLoading(false);
+			return;
+		}
+		if (timerRef.current) clearTimeout(timerRef.current);
+		timerRef.current = setTimeout(() => {
+			timerRef.current = null;
+			visibleRef.current = false;
+			setIsLoading(false);
+		}, remaining);
+	}, [minDuration]);
+	useEffect(() => {
+		return () => {
+			cancel();
+		};
+	}, [cancel]);
+	return {
+		isLoading,
+		show,
+		hide,
+		cancel
+	};
+}
+
+//#endregion
+export { useMinDurationLoading };

package/dist/hooks/use-search-history.mjs

@@ -1,2 +1,54 @@
 
-import e from"../utils/event-bus.mjs";import{eventKey as t}from"../constants/event-key.mjs";import{useEffect as n,useState as r}from"react";function i({storageKey:i,maxCount:a=20}){let[o,s]=r([]),c=`search_history_${i}`;return n(()=>{let e=localStorage.getItem(c);if(e)try{s(JSON.parse(e))}catch(e){console.error(`Failed to parse search history`,e)}},[c]),{history:o,addHistory:n=>{if(!n.trim())return;let r=n.trim();try{let e=localStorage.getItem(c),t=[];if(e)try{let n=JSON.parse(e);t=Array.isArray(n)?n.map(e=>String(e).trim()).filter(Boolean):[]}catch{t=[]}let n=[r,...t.filter(e=>e!==r)].slice(0,a);s(n),localStorage.setItem(c,JSON.stringify(n))}catch(e){console.error(`Failed to save search history`,e)}e.emit(t.SEARCH_HISTORY_UPDATE)},clearHistory:()=>{s([]),localStorage.removeItem(c),e.emit(t.SEARCH_HISTORY_UPDATE)}}}export{i as useSearchHistory};
+import eventBus from "../utils/event-bus.mjs";
+import { eventKey } from "../constants/event-key.mjs";
+import { useEffect, useState } from "react";
+
+//#region hooks/use-search-history.ts
+/**
+* 搜索历史管理 Hook
+*/
+function useSearchHistory({ storageKey, maxCount = 20 }) {
+	const [history, setHistory] = useState([]);
+	const fullKey = `search_history_${storageKey}`;
+	useEffect(() => {
+		const data = localStorage.getItem(fullKey);
+		if (data) try {
+			setHistory(JSON.parse(data));
+		} catch (e) {
+			console.error("Failed to parse search history", e);
+		}
+	}, [fullKey]);
+	const addHistory = (keyword) => {
+		if (!keyword.trim()) return;
+		const trimmed = keyword.trim();
+		try {
+			const raw = localStorage.getItem(fullKey);
+			let existing = [];
+			if (raw) try {
+				const p = JSON.parse(raw);
+				existing = Array.isArray(p) ? p.map((item) => String(item).trim()).filter(Boolean) : [];
+			} catch {
+				existing = [];
+			}
+			const newHistory = [trimmed, ...existing.filter((item) => item !== trimmed)].slice(0, maxCount);
+			setHistory(newHistory);
+			localStorage.setItem(fullKey, JSON.stringify(newHistory));
+		} catch (e) {
+			console.error("Failed to save search history", e);
+		}
+		eventBus.emit(eventKey.SEARCH_HISTORY_UPDATE);
+	};
+	const clearHistory = () => {
+		setHistory([]);
+		localStorage.removeItem(fullKey);
+		eventBus.emit(eventKey.SEARCH_HISTORY_UPDATE);
+	};
+	return {
+		history,
+		addHistory,
+		clearHistory
+	};
+}
+
+//#endregion
+export { useSearchHistory };

package/dist/hooks/use-sticky.mjs

@@ -1,2 +1,51 @@
 
-"use client";import{useEffect as e,useRef as t,useState as n}from"react";function r(r){let[i,a]=n(!1),o=t(null),s=t(null);return e(()=>{let e=o.current;if(!e)return;let t=r?document.getElementById(r):null,n=!t,i=()=>t?t.scrollTop:window.scrollY??document.documentElement.scrollTop??0;if(s.current===null){let n=e.getBoundingClientRect();if(t){let e=t.getBoundingClientRect();s.current=n.top-e.top+t.scrollTop}else s.current=n.top+i()}let c=()=>{let e=i()>=s.current;a(t=>t===e?t:e)};return n?window.addEventListener(`scroll`,c,{passive:!0}):t.addEventListener(`scroll`,c,{passive:!0}),c(),()=>{n?window.removeEventListener(`scroll`,c):t.removeEventListener(`scroll`,c)}},[r]),{isSticky:i,ref:o}}export{r as useSticky};
+'use client';
+
+import { useEffect, useRef, useState } from "react";
+
+//#region hooks/use-sticky.ts
+/**
+* 监听元素滚动，当元素接近顶部时返回固定状态
+* @param scrollContainerId 滚动容器的 ID，不传时监听 window
+* @returns { isSticky, ref } - isSticky: 是否应该固定，ref: 需要绑定到元素的 ref
+*/
+function useSticky(scrollContainerId) {
+	const [isSticky, setIsSticky] = useState(false);
+	const elementRef = useRef(null);
+	const originalOffsetTopRef = useRef(null);
+	useEffect(() => {
+		const element = elementRef.current;
+		if (!element) return;
+		const scrollContainer = scrollContainerId ? document.getElementById(scrollContainerId) : null;
+		const useWindowScroll = !scrollContainer;
+		const getScrollTop = () => {
+			if (scrollContainer) return scrollContainer.scrollTop;
+			return window.scrollY ?? document.documentElement.scrollTop ?? 0;
+		};
+		if (originalOffsetTopRef.current === null) {
+			const elementRect = element.getBoundingClientRect();
+			if (scrollContainer) {
+				const containerRect = scrollContainer.getBoundingClientRect();
+				originalOffsetTopRef.current = elementRect.top - containerRect.top + scrollContainer.scrollTop;
+			} else originalOffsetTopRef.current = elementRect.top + getScrollTop();
+		}
+		const handleScroll = () => {
+			const shouldBeSticky = getScrollTop() >= originalOffsetTopRef.current;
+			setIsSticky((prev) => prev !== shouldBeSticky ? shouldBeSticky : prev);
+		};
+		if (useWindowScroll) window.addEventListener("scroll", handleScroll, { passive: true });
+		else scrollContainer.addEventListener("scroll", handleScroll, { passive: true });
+		handleScroll();
+		return () => {
+			if (useWindowScroll) window.removeEventListener("scroll", handleScroll);
+			else scrollContainer.removeEventListener("scroll", handleScroll);
+		};
+	}, [scrollContainerId]);
+	return {
+		isSticky,
+		ref: elementRef
+	};
+}
+
+//#endregion
+export { useSticky };

package/dist/hooks.mjs

@@ -1,2 +1,18 @@
 
-import{IMAGE_TEXT_RECOMMEND_FIXED_BATCH_SIZE as e,buildImageTextRecommendChosenTags as t,buildImageTextRecommendRemoteMap as n,buildImageTextRecommendSmartPicked as r,getImageTextRecommendFixedIds as i,getImageTextRecommendLayoutTags as a,resolveImageTextRecommendVideoId as o}from"./hooks/image-text-recommend.mjs";import{HydrationBoundary as s}from"./hooks/query/hydration-boundary.mjs";import{useDeleteRequest as c,useMutation as l,usePaginated as u,usePrefetchQuery as d,useRefetchQuery as f,useRequest as p,useUpdateRequest as m}from"./hooks/query/use-query.mjs";import{useAuth as h,useCloseLogin as g,useExpireTime as _,useIsLoggedIn as v,useLoginModalOpen as y,useLogout as b,useOpenLogin as x,useOpenLoginAsync as S,useOpenResetPassword as C,useRequireLogin as w,useSetAuthFields as T,useToken as E,useUserId as D,useUserInfo as O}from"./hooks/use-auth.mjs";import{useBrowseReport as k}from"./hooks/use-browse-report.mjs";import{useGridFirstRowHeight as A,useSingleFirstRowHeight as j,useWaterfallFirstRowHeight as M}from"./hooks/use-first-row-height.mjs";import{useFollow as N}from"./hooks/use-follow.mjs";import{useFullscreenGestures as P}from"./hooks/use-fullscreen-gestures.mjs";import{useIsClient as F}from"./hooks/use-is-client.mjs";import{useKeyboardOpen as I}from"./hooks/use-keyboard-open.mjs";import{useLikeDislike as L}from"./hooks/use-like-dislike.mjs";import{useMinDurationLoading as R}from"./hooks/use-min-duration-loading.mjs";import{useSearchHistory as z}from"./hooks/use-search-history.mjs";import{useSticky as B}from"./hooks/use-sticky.mjs";import{useKeepAliveEffect as V,useKeepAliveState as H}from"./components/common/keep-scroll-position/index.mjs";export{s as HydrationBoundary,e as IMAGE_TEXT_RECOMMEND_FIXED_BATCH_SIZE,t as buildImageTextRecommendChosenTags,n as buildImageTextRecommendRemoteMap,r as buildImageTextRecommendSmartPicked,i as getImageTextRecommendFixedIds,a as getImageTextRecommendLayoutTags,o as resolveImageTextRecommendVideoId,h as useAuth,k as useBrowseReport,g as useCloseLogin,c as useDeleteRequest,_ as useExpireTime,N as useFollow,P as useFullscreenGestures,A as useGridFirstRowHeight,F as useIsClient,v as useIsLoggedIn,V as useKeepAliveEffect,H as useKeepAliveState,I as useKeyboardOpen,L as useLikeDislike,y as useLoginModalOpen,b as useLogout,R as useMinDurationLoading,l as useMutation,x as useOpenLogin,S as useOpenLoginAsync,C as useOpenResetPassword,u as usePaginated,d as usePrefetchQuery,f as useRefetchQuery,p as useRequest,w as useRequireLogin,z as useSearchHistory,T as useSetAuthFields,j as useSingleFirstRowHeight,B as useSticky,E as useToken,m as useUpdateRequest,D as useUserId,O as useUserInfo,M as useWaterfallFirstRowHeight};
+import { IMAGE_TEXT_RECOMMEND_FIXED_BATCH_SIZE, buildImageTextRecommendChosenTags, buildImageTextRecommendRemoteMap, buildImageTextRecommendSmartPicked, getImageTextRecommendFixedIds, getImageTextRecommendLayoutTags, resolveImageTextRecommendVideoId } from "./hooks/image-text-recommend.mjs";
+import { HydrationBoundary } from "./hooks/query/hydration-boundary.mjs";
+import { useDeleteRequest, useMutation, usePaginated, usePrefetchQuery, useRefetchQuery, useRequest, useUpdateRequest } from "./hooks/query/use-query.mjs";
+import { useAuth, useCloseLogin, useExpireTime, useIsLoggedIn, useLoginModalOpen, useLogout, useOpenLogin, useOpenLoginAsync, useOpenResetPassword, useRequireLogin, useSetAuthFields, useToken, useUserId, useUserInfo } from "./hooks/use-auth.mjs";
+import { useBrowseReport } from "./hooks/use-browse-report.mjs";
+import { useGridFirstRowHeight, useSingleFirstRowHeight, useWaterfallFirstRowHeight } from "./hooks/use-first-row-height.mjs";
+import { useFollow } from "./hooks/use-follow.mjs";
+import { useFullscreenGestures } from "./hooks/use-fullscreen-gestures.mjs";
+import { useIsClient } from "./hooks/use-is-client.mjs";
+import { useKeyboardOpen } from "./hooks/use-keyboard-open.mjs";
+import { useLikeDislike } from "./hooks/use-like-dislike.mjs";
+import { useMinDurationLoading } from "./hooks/use-min-duration-loading.mjs";
+import { useSearchHistory } from "./hooks/use-search-history.mjs";
+import { useSticky } from "./hooks/use-sticky.mjs";
+import { useKeepAliveEffect, useKeepAliveState } from "./components/common/keep-scroll-position/index.mjs";
+
+export { HydrationBoundary, IMAGE_TEXT_RECOMMEND_FIXED_BATCH_SIZE, buildImageTextRecommendChosenTags, buildImageTextRecommendRemoteMap, buildImageTextRecommendSmartPicked, getImageTextRecommendFixedIds, getImageTextRecommendLayoutTags, resolveImageTextRecommendVideoId, useAuth, useBrowseReport, useCloseLogin, useDeleteRequest, useExpireTime, useFollow, useFullscreenGestures, useGridFirstRowHeight, useIsClient, useIsLoggedIn, useKeepAliveEffect, useKeepAliveState, useKeyboardOpen, useLikeDislike, useLoginModalOpen, useLogout, useMinDurationLoading, useMutation, useOpenLogin, useOpenLoginAsync, useOpenResetPassword, usePaginated, usePrefetchQuery, useRefetchQuery, useRequest, useRequireLogin, useSearchHistory, useSetAuthFields, useSingleFirstRowHeight, useSticky, useToken, useUpdateRequest, useUserId, useUserInfo, useWaterfallFirstRowHeight };