@cites/react-hooks 0.0.1

package/dist/core/useBoundingClientRect.d.ts

@@ -0,0 +1,12 @@
+export interface BoundingClientRectOptions {
+    measureOnce?: boolean;
+    trackElementResize?: boolean;
+    trackScroll?: boolean;
+    trackResize?: boolean;
+}
+export interface BoundingClientRectResults<T extends HTMLElement> {
+    rect: DOMRect | null;
+    ref: React.RefCallback<T>;
+}
+export declare function useBoundingClientRect<T extends HTMLElement>(options?: BoundingClientRectOptions): BoundingClientRectResults<T>;
+//# sourceMappingURL=useBoundingClientRect.d.ts.map

package/dist/core/useBoundingClientRect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBoundingClientRect.d.ts","sourceRoot":"","sources":["../../src/core/useBoundingClientRect.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,yBAAyB;IACtC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC,SAAS,WAAW;IAC5D,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IACrB,GAAG,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;CAC7B;AAED,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,WAAW,EACvD,OAAO,GAAE,yBAA8B,GACxC,yBAAyB,CAAC,CAAC,CAAC,CAmF9B"}

package/dist/core/useBoundingClientRect.js

@@ -0,0 +1,72 @@
+import { useState, useCallback, useRef } from "react";
+import { useIsomorphicLayoutEffect } from "./useIsomorphicLayoutEffect.js";
+import { useEventCallback } from "./useEventCallback.js";
+export function useBoundingClientRect(options = {}) {
+    const { measureOnce = false, trackElementResize = true, trackScroll = true, trackResize = true, } = options;
+    const [node, setNode] = useState();
+    const [rect, setRect] = useState(null);
+    const animationFrameId = useRef(null);
+    const ref = useCallback(nodeInstance => {
+        setNode(nodeInstance);
+        return () => {
+            setNode(undefined);
+        };
+    }, []);
+    const updateRect = useEventCallback(() => {
+        if (node) {
+            setRect(node.getBoundingClientRect());
+        }
+    });
+    useIsomorphicLayoutEffect(() => {
+        const element = node;
+        if (!element) {
+            setRect(null);
+            return;
+        }
+        updateRect();
+        if (measureOnce)
+            return;
+        const handleScrollAndResize = () => {
+            if (animationFrameId.current) {
+                cancelAnimationFrame(animationFrameId.current);
+            }
+            animationFrameId.current = requestAnimationFrame(updateRect);
+        };
+        if (trackScroll) {
+            window.addEventListener("scroll", handleScrollAndResize, {
+                capture: true,
+                passive: true,
+            });
+        }
+        if (trackResize) {
+            window.addEventListener("resize", handleScrollAndResize, {
+                passive: true,
+            });
+        }
+        let resizeObserver;
+        if (trackElementResize) {
+            resizeObserver = new ResizeObserver(handleScrollAndResize);
+            resizeObserver.observe(element);
+        }
+        return () => {
+            if (trackScroll) {
+                window.removeEventListener("scroll", handleScrollAndResize, true);
+            }
+            if (trackResize) {
+                window.removeEventListener("resize", handleScrollAndResize);
+            }
+            if (resizeObserver) {
+                resizeObserver.disconnect();
+            }
+            if (animationFrameId.current) {
+                cancelAnimationFrame(animationFrameId.current);
+                animationFrameId.current = null;
+            }
+        };
+    }, [node, measureOnce, trackElementResize, trackScroll, trackResize]);
+    return {
+        rect,
+        ref,
+    };
+}
+//# sourceMappingURL=useBoundingClientRect.js.map

package/dist/core/useBoundingClientRect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBoundingClientRect.js","sourceRoot":"","sources":["../../src/core/useBoundingClientRect.ts"],"names":[],"mappings":"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"}

package/dist/core/useComposedRefs.d.ts

@@ -0,0 +1,9 @@
+import React from "react";
+type PossibleRef<T> = React.Ref<T> | undefined;
+/**
+ * A custom hook that composes multiple refs
+ * Accepts callback refs and RefObject(s)
+ */
+export declare function useComposedRefs<T>(...refs: PossibleRef<T>[]): React.RefCallback<T>;
+export {};
+//# sourceMappingURL=useComposedRefs.d.ts.map

package/dist/core/useComposedRefs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useComposedRefs.d.ts","sourceRoot":"","sources":["../../src/core/useComposedRefs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAsB,MAAM,OAAO,CAAC;AAE3C,KAAK,WAAW,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;AAoD/C;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAGlF"}

package/dist/core/useComposedRefs.js

@@ -0,0 +1,58 @@
+import { useCallback } from "react";
+const isFunction = (value) => {
+    return typeof value === "function";
+};
+/**
+ * Set a given ref to a given value
+ * This utility takes care of different types of refs: callback refs and RefObject(s)
+ */
+function setRef(ref, value) {
+    if (isFunction(ref)) {
+        return ref(value);
+    }
+    else if (ref !== null && ref !== undefined) {
+        ref.current = value;
+    }
+}
+/**
+ * A utility to compose multiple refs together
+ * Accepts callback refs and RefObject(s)
+ */
+function composeRefs(...refs) {
+    return (node) => {
+        let hasCleanup = false;
+        const cleanups = refs.map((ref) => {
+            const cleanup = setRef(ref, node);
+            if (!hasCleanup && isFunction(cleanup)) {
+                hasCleanup = true;
+            }
+            return cleanup;
+        });
+        // React <19 will log an error to the console if a callback ref returns a
+        // value. We don"t use ref cleanups internally so this will only happen if a
+        // user"s ref callback returns a value, which we only expect if they are
+        // using the cleanup functionality added in React 19.
+        if (hasCleanup) {
+            return () => {
+                for (let i = 0; i < cleanups.length; i++) {
+                    const cleanup = cleanups[i];
+                    if (isFunction(cleanup)) {
+                        cleanup();
+                    }
+                    else {
+                        setRef(refs[i], null);
+                    }
+                }
+            };
+        }
+    };
+}
+/**
+ * A custom hook that composes multiple refs
+ * Accepts callback refs and RefObject(s)
+ */
+export function useComposedRefs(...refs) {
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    return useCallback(composeRefs(...refs), refs);
+}
+//# sourceMappingURL=useComposedRefs.js.map

package/dist/core/useComposedRefs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useComposedRefs.js","sourceRoot":"","sources":["../../src/core/useComposedRefs.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAI3C,MAAM,UAAU,GAAG,CAAC,KAAc,EAAqB,EAAE;IACrD,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC;AACvC,CAAC,CAAA;AAED;;;GAGG;AACH,SAAS,MAAM,CAAI,GAAmB,EAAE,KAAQ;IAC5C,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAClB,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;SAAM,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QAC3C,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC;IACxB,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAI,GAAG,IAAsB;IAC7C,OAAO,CAAC,IAAI,EAAE,EAAE;QACZ,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YAC9B,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAClC,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBACrC,UAAU,GAAG,IAAI,CAAC;YACtB,CAAC;YACD,OAAO,OAAO,CAAC;QACnB,CAAC,CAAC,CAAC;QAEH,yEAAyE;QACzE,4EAA4E;QAC5E,wEAAwE;QACxE,qDAAqD;QACrD,IAAI,UAAU,EAAE,CAAC;YACb,OAAO,GAAG,EAAE;gBACR,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACvC,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;oBAC5B,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;wBACtB,OAAO,EAAE,CAAC;oBACd,CAAC;yBAAM,CAAC;wBACJ,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;oBAC1B,CAAC;gBACL,CAAC;YACL,CAAC,CAAC;QACN,CAAC;IACL,CAAC,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAI,GAAG,IAAsB;IACxD,uDAAuD;IACvD,OAAO,WAAW,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;AACnD,CAAC"}

package/dist/core/useCustomScroller.d.ts

@@ -0,0 +1,6 @@
+import { AnimatedScrollOptions } from "../utils/scroll-helper.js";
+export declare function useCustomScroller<T extends HTMLElement>(): {
+    containerRef: import("react").RefObject<T | null>;
+    scrollTo: (target: HTMLElement, options?: AnimatedScrollOptions) => void;
+};
+//# sourceMappingURL=useCustomScroller.d.ts.map

package/dist/core/useCustomScroller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCustomScroller.d.ts","sourceRoot":"","sources":["../../src/core/useCustomScroller.ts"],"names":[],"mappings":"AAGA,OAAO,EAEH,qBAAqB,EAGxB,MAAM,2BAA2B,CAAC;AAEnC,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,WAAW;;uBAKvC,WAAW,YACV,qBAAqB;EAoBrC"}

package/dist/core/useCustomScroller.js

@@ -0,0 +1,21 @@
+import { useRef, useCallback, } from "react";
+import { ScrollDirections, animatedScrollTo, calculateScrollOffset, } from "../utils/scroll-helper.js";
+export function useCustomScroller() {
+    const containerRef = useRef(null);
+    const runningAnimation = useRef(null);
+    const scrollTo = useCallback((target, options = {}) => {
+        if (!containerRef.current) {
+            console.warn("滚动容器的 ref 尚未附加到元素上。");
+            return;
+        }
+        if (runningAnimation.current) {
+            runningAnimation.current();
+        }
+        const { direction = ScrollDirections.vertical, ...restOptions } = options;
+        const container = containerRef.current;
+        const targetOffset = calculateScrollOffset(container, target, direction, options);
+        runningAnimation.current = animatedScrollTo(container, targetOffset, direction, restOptions);
+    }, []);
+    return { containerRef, scrollTo };
+}
+//# sourceMappingURL=useCustomScroller.js.map

package/dist/core/useCustomScroller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCustomScroller.js","sourceRoot":"","sources":["../../src/core/useCustomScroller.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,MAAM,EAAE,WAAW,GACtB,MAAM,OAAO,CAAC;AACf,OAAO,EACH,gBAAgB,EAEhB,gBAAgB,EAChB,qBAAqB,GACxB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,UAAU,iBAAiB;IAC7B,MAAM,YAAY,GAAG,MAAM,CAAI,IAAI,CAAC,CAAC;IACrC,MAAM,gBAAgB,GAAG,MAAM,CAAsB,IAAI,CAAC,CAAC;IAE3D,MAAM,QAAQ,GAAG,WAAW,CAAC,CACzB,MAAmB,EACnB,UAAiC,EAAE,EACrC,EAAE;QACA,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;YACpC,OAAO;QACX,CAAC;QAED,IAAI,gBAAgB,CAAC,OAAO,EAAE,CAAC;YAC3B,gBAAgB,CAAC,OAAO,EAAE,CAAC;QAC/B,CAAC;QAED,MAAM,EAAE,SAAS,GAAG,gBAAgB,CAAC,QAAQ,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC;QAC1E,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC;QAEvC,MAAM,YAAY,GAAG,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAElF,gBAAgB,CAAC,OAAO,GAAG,gBAAgB,CAAC,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IACjG,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC;AACtC,CAAC"}

package/dist/core/useDraggable.d.ts

@@ -0,0 +1,22 @@
+import React from "react";
+export interface Point {
+    x: number;
+    y: number;
+}
+export interface Bounds {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+}
+export interface DragInfo<T extends HTMLElement> extends Point {
+    ref: React.Ref<T>;
+    isDragging: boolean;
+}
+export interface DraggableOptions {
+    mode?: "object" | "slider";
+    initialPosition?: Point;
+    bounds?: Bounds;
+}
+export declare const useDraggable: <T extends HTMLElement>(options?: DraggableOptions) => DragInfo<T>;
+//# sourceMappingURL=useDraggable.d.ts.map

package/dist/core/useDraggable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDraggable.d.ts","sourceRoot":"","sources":["../../src/core/useDraggable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAGxE,MAAM,WAAW,KAAK;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,MAAM;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,WAAW,CAAE,SAAQ,KAAK;IAC1D,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC7B,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC3B,eAAe,CAAC,EAAE,KAAK,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,WAAW,EAAE,UAAS,gBAAqB,KAAG,QAAQ,CAAC,CAAC,CAmG9F,CAAC"}

package/dist/core/useDraggable.js

@@ -0,0 +1,82 @@
+import { useState, useEffect, useRef, useCallback } from "react";
+import { useEventCallback } from "./useEventCallback.js";
+export const useDraggable = (options = {}) => {
+    const { initialPosition, bounds, mode = "object" } = options;
+    const [position, setPosition] = useState(null);
+    const [isDragging, setIsDragging] = useState(false);
+    const animationFrameId = useRef(null);
+    const currentPosition = position ?? initialPosition ?? { x: 0, y: 0 };
+    const [handleNode, setHandleNode] = useState(null);
+    const handleRefCallback = useCallback((node) => {
+        setHandleNode(node);
+        return () => {
+            setHandleNode(null);
+        };
+    }, []);
+    const dragInfo = useRef(null);
+    const animate = useEventCallback(() => {
+        if (!dragInfo.current)
+            return;
+        const newPosition = {
+            x: dragInfo.current.initialPosition.x + (dragInfo.current.lastPoint.x - dragInfo.current.startPoint.x),
+            y: dragInfo.current.initialPosition.y + (dragInfo.current.lastPoint.y - dragInfo.current.startPoint.y),
+        };
+        if (bounds) {
+            newPosition.x = Math.max(bounds.left, Math.min(newPosition.x, bounds.right));
+            newPosition.y = Math.max(bounds.top, Math.min(newPosition.y, bounds.bottom));
+        }
+        setPosition(newPosition);
+        animationFrameId.current = requestAnimationFrame(animate);
+    });
+    const handlePointerMove = useEventCallback((event) => {
+        if (dragInfo.current) {
+            dragInfo.current.lastPoint = { x: event.clientX, y: event.clientY };
+        }
+    });
+    const handlePointerUp = useEventCallback(() => {
+        window.removeEventListener("pointermove", handlePointerMove);
+        window.removeEventListener("pointerup", handlePointerUp);
+        if (animationFrameId.current) {
+            cancelAnimationFrame(animationFrameId.current);
+        }
+        dragInfo.current = null;
+        setIsDragging(false);
+    });
+    const handlePointerDown = useEventCallback((event) => {
+        if (event.button !== 0)
+            return;
+        event.preventDefault();
+        const isSliderMode = mode === "slider";
+        const startPosition = isSliderMode
+            ? { x: event.clientX, y: event.clientY }
+            : { ...currentPosition };
+        dragInfo.current = {
+            initialPosition: startPosition,
+            startPoint: { x: event.clientX, y: event.clientY },
+            lastPoint: { x: event.clientX, y: event.clientY },
+        };
+        window.addEventListener("pointermove", handlePointerMove);
+        window.addEventListener("pointerup", handlePointerUp);
+        animationFrameId.current = requestAnimationFrame(animate);
+        setIsDragging(true);
+    });
+    useEffect(() => {
+        if (!handleNode)
+            return;
+        handleNode.addEventListener("pointerdown", handlePointerDown);
+        return () => {
+            handleNode.removeEventListener("pointerdown", handlePointerDown);
+            window.removeEventListener("pointermove", handlePointerMove);
+            window.removeEventListener("pointerup", handlePointerUp);
+            if (animationFrameId.current) {
+                cancelAnimationFrame(animationFrameId.current);
+                if (animationFrameId) {
+                    animationFrameId.current = null;
+                }
+            }
+            dragInfo.current = null;
+        };
+    }, [handleNode]);
+    return { ...currentPosition, isDragging, ref: handleRefCallback };
+};
+//# sourceMappingURL=useDraggable.js.map

package/dist/core/useDraggable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDraggable.js","sourceRoot":"","sources":["../../src/core/useDraggable.ts"],"names":[],"mappings":"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"}

package/dist/core/useEventCallback.d.ts

@@ -0,0 +1,14 @@
+/**
+ * A custom React hook that creates a stable function reference (a "callback event")
+ * that will always call the latest version of the function passed to it.
+ * This is a TypeScript implementation of the pattern used to polyfill the
+ * upcoming official `useEffectEvent` hook.
+ *
+ * @template T - The type of the callback function.
+ * @param {T} callback - The function to be made stable. This function can use
+ * the latest props and state, and it will be updated on every render.
+ * @returns {T} A memoized function that has a stable identity across re-renders
+ * but executes the most recent version of the `callback`.
+ */
+export declare function useEventCallback<T extends (...args: any[]) => any>(callback: T): T;
+//# sourceMappingURL=useEventCallback.d.ts.map

package/dist/core/useEventCallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEventCallback.d.ts","sourceRoot":"","sources":["../../src/core/useEventCallback.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAkBlF"}

package/dist/core/useEventCallback.js

@@ -0,0 +1,32 @@
+import { useRef, useCallback } from "react";
+import { useIsomorphicLayoutEffect } from "./useIsomorphicLayoutEffect.js";
+/**
+ * A custom React hook that creates a stable function reference (a "callback event")
+ * that will always call the latest version of the function passed to it.
+ * This is a TypeScript implementation of the pattern used to polyfill the
+ * upcoming official `useEffectEvent` hook.
+ *
+ * @template T - The type of the callback function.
+ * @param {T} callback - The function to be made stable. This function can use
+ * the latest props and state, and it will be updated on every render.
+ * @returns {T} A memoized function that has a stable identity across re-renders
+ * but executes the most recent version of the `callback`.
+ */
+export function useEventCallback(callback) {
+    // 1. Store the latest callback in a ref. The ref's type is the function signature.
+    const callbackRef = useRef(callback);
+    // 2. Use useLayoutEffect to update the ref synchronously after every render.
+    // This ensures the ref always holds the latest version of the callback
+    // before any other effects run.
+    useIsomorphicLayoutEffect(() => {
+        callbackRef.current = callback;
+    }); // No dependency array means this effect runs on every render.
+    // 3. Return a stable, memoized function.
+    // This function's identity will never change because of the empty dependency array.
+    // We cast the returned function to type T to match the input function signature.
+    return useCallback((...args) => {
+        // When called, it executes the *current* function stored in the ref.
+        return callbackRef.current(...args);
+    }, []);
+}
+//# sourceMappingURL=useEventCallback.js.map

package/dist/core/useEventCallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEventCallback.js","sourceRoot":"","sources":["../../src/core/useEventCallback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAoC,QAAW;IAC3E,mFAAmF;IACnF,MAAM,WAAW,GAAG,MAAM,CAAI,QAAQ,CAAC,CAAC;IAExC,6EAA6E;IAC7E,uEAAuE;IACvE,gCAAgC;IAChC,yBAAyB,CAAC,GAAG,EAAE;QAC3B,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;IACnC,CAAC,CAAC,CAAC,CAAC,8DAA8D;IAElE,yCAAyC;IACzC,oFAAoF;IACpF,iFAAiF;IACjF,OAAO,WAAW,CAAC,CAAC,GAAG,IAAmB,EAAiB,EAAE;QACzD,qEAAqE;QACrE,OAAO,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACxC,CAAC,EAAE,EAAE,CAAM,CAAC;AAChB,CAAC"}

package/dist/core/useIsomorphicLayoutEffect.d.ts

@@ -0,0 +1,3 @@
+import { useLayoutEffect } from "react";
+export declare const useIsomorphicLayoutEffect: typeof useLayoutEffect;
+//# sourceMappingURL=useIsomorphicLayoutEffect.d.ts.map

package/dist/core/useIsomorphicLayoutEffect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIsomorphicLayoutEffect.d.ts","sourceRoot":"","sources":["../../src/core/useIsomorphicLayoutEffect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAa,MAAM,OAAO,CAAC;AAEnD,eAAO,MAAM,yBAAyB,wBAA8D,CAAC"}

package/dist/core/useIsomorphicLayoutEffect.js

@@ -0,0 +1,3 @@
+import { useLayoutEffect, useEffect } from "react";
+export const useIsomorphicLayoutEffect = typeof window !== "undefined" ? useLayoutEffect : useEffect;
+//# sourceMappingURL=useIsomorphicLayoutEffect.js.map

package/dist/core/useIsomorphicLayoutEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIsomorphicLayoutEffect.js","sourceRoot":"","sources":["../../src/core/useIsomorphicLayoutEffect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEnD,MAAM,CAAC,MAAM,yBAAyB,GAAG,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAC"}

package/dist/core/useKeepActiveItemIntoView.d.ts

@@ -0,0 +1,20 @@
+import { type AnimatedScrollOptions } from "./useScrollIntoViewHelper.js";
+interface UseKeepActiveItemIntoViewOptions<T, K = T> extends AnimatedScrollOptions {
+    activeItem?: T | null;
+    getKey?: (item: T) => K;
+}
+type SetContainerRef = (element: HTMLElement | null) => void;
+type SetItemRef<K> = (key: K, element: HTMLElement | null) => void;
+type ManualScrollToItem<T> = (item: T, overrideOptions?: AnimatedScrollOptions) => void;
+/**
+ * 维持列表中的活动项始终在视图内的 Hook.
+ * @param options 配置项，包括活动项、key 生成函数和滚动选项
+ * @returns 返回一个元组：[设置容器的 ref 回调, 设置列表项的 ref 回调, 手动滚动函数]
+ */
+export declare function useKeepActiveItemIntoView<T, K = T>(options?: UseKeepActiveItemIntoViewOptions<T, K>): {
+    setContainerRef: SetContainerRef;
+    setItemRef: SetItemRef<K>;
+    scrollToItem: ManualScrollToItem<T>;
+};
+export {};
+//# sourceMappingURL=useKeepActiveItemIntoView.d.ts.map

package/dist/core/useKeepActiveItemIntoView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeepActiveItemIntoView.d.ts","sourceRoot":"","sources":["../../src/core/useKeepActiveItemIntoView.ts"],"names":[],"mappings":"AAIA,OAAO,EACH,KAAK,qBAAqB,EAE7B,MAAM,8BAA8B,CAAC;AAEtC,UAAU,gCAAgC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAE,SAAQ,qBAAqB;IAC9E,UAAU,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IACtB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;CAC3B;AAED,KAAK,eAAe,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;AAC7D,KAAK,UAAU,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAC;AACnE,KAAK,kBAAkB,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,eAAe,CAAC,EAAE,qBAAqB,KAAK,IAAI,CAAC;AAExF;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAC9C,OAAO,GAAE,gCAAgC,CAAC,CAAC,EAAE,CAAC,CAAM;;;;EA2CvD"}

package/dist/core/useKeepActiveItemIntoView.js

@@ -0,0 +1,46 @@
+import { useRef, useCallback, useEffect, } from "react";
+import { useScrollIntoViewHelper, } from "./useScrollIntoViewHelper.js";
+/**
+ * 维持列表中的活动项始终在视图内的 Hook.
+ * @param options 配置项，包括活动项、key 生成函数和滚动选项
+ * @returns 返回一个元组：[设置容器的 ref 回调, 设置列表项的 ref 回调, 手动滚动函数]
+ */
+export function useKeepActiveItemIntoView(options = {}) {
+    const { activeItem, getKey, ...scrollOptions } = options;
+    const containerRef = useRef(null);
+    const itemsRef = useRef(new Map());
+    const scrollHelper = useScrollIntoViewHelper(containerRef.current);
+    // 检查并更新滚动助手的容器
+    const setContainerRef = useCallback((element) => {
+        containerRef.current = element;
+        scrollHelper.current?.setContainer(element);
+    }, [scrollHelper]);
+    // 注册或注销列表项及其对应的 DOM 元素
+    const setItemRef = useCallback((key, element) => {
+        if (element) {
+            itemsRef.current.set(key, element);
+        }
+        else {
+            itemsRef.current.delete(key);
+        }
+    }, []);
+    // 手动滚动函数
+    const scrollToItem = useCallback((item, overrideOptions) => {
+        const key = getKey ? getKey(item) : item;
+        const element = itemsRef.current.get(key);
+        if (element) {
+            // 合并默认选项和手动覆盖选项
+            const finalOptions = { ...scrollOptions, ...overrideOptions };
+            scrollHelper.current?.scrollTo(element, finalOptions);
+        }
+    }, [getKey, scrollHelper, scrollOptions]);
+    // 自动滚动逻辑
+    useEffect(() => {
+        if (activeItem) {
+            // 使用 setTimeout 确保 DOM 元素已经渲染并注册
+            setTimeout(() => scrollToItem(activeItem), 0);
+        }
+    }, [activeItem, scrollToItem]);
+    return { setContainerRef, setItemRef, scrollToItem };
+}
+//# sourceMappingURL=useKeepActiveItemIntoView.js.map

package/dist/core/useKeepActiveItemIntoView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeepActiveItemIntoView.js","sourceRoot":"","sources":["../../src/core/useKeepActiveItemIntoView.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,MAAM,EAAE,WAAW,EAAE,SAAS,GACjC,MAAM,OAAO,CAAC;AAEf,OAAO,EAEH,uBAAuB,GAC1B,MAAM,8BAA8B,CAAC;AAWtC;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CACrC,UAAkD,EAAE;IAEpD,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,CAAC;IAEzD,MAAM,YAAY,GAAG,MAAM,CAAqB,IAAI,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,MAAM,CAAsB,IAAI,GAAG,EAAE,CAAC,CAAC;IACxD,MAAM,YAAY,GAAG,uBAAuB,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAEnE,eAAe;IACf,MAAM,eAAe,GAAoB,WAAW,CAAC,CAAC,OAA2B,EAAE,EAAE;QACjF,YAAY,CAAC,OAAO,GAAG,OAAO,CAAC;QAC/B,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAEnB,uBAAuB;IACvB,MAAM,UAAU,GAAkB,WAAW,CAAC,CAAC,GAAM,EAAE,OAA2B,EAAE,EAAE;QAClF,IAAI,OAAO,EAAE,CAAC;YACV,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACJ,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,SAAS;IACT,MAAM,YAAY,GAA0B,WAAW,CAAC,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE;QAC9E,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAqB,CAAC;QAC3D,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACV,gBAAgB;YAChB,MAAM,YAAY,GAAG,EAAE,GAAG,aAAa,EAAE,GAAG,eAAe,EAAE,CAAC;YAC9D,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;QAC1D,CAAC;IACL,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC,CAAC;IAE1C,SAAS;IACT,SAAS,CAAC,GAAG,EAAE;QACX,IAAI,UAAU,EAAE,CAAC;YACb,iCAAiC;YACjC,UAAU,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;QAClD,CAAC;IACL,CAAC,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;IAE/B,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;AACzD,CAAC"}

package/dist/core/useScrollIntoViewHelper.d.ts

@@ -0,0 +1,24 @@
+import { type RefObject } from "react";
+import { type AnimatedScrollOptions } from "../utils/scroll-helper.js";
+export type { AnimatedScrollOptions };
+/**
+ * A helper class that encapsulates scrolling logic.
+ * This is managed by the useScrollIntoViewHelper hook.
+ */
+declare class ScrollIntoViewHelper {
+    private _container;
+    private _runningAnimation;
+    constructor(container: HTMLElement | null);
+    scrollTo(element: HTMLElement, options?: AnimatedScrollOptions): void;
+    stopScroll(): void;
+    getContainer(): HTMLElement | null;
+    setContainer(container: HTMLElement | null): void;
+    destroy(): void;
+}
+/**
+ * 创建并管理一个 ScrollIntoViewHelper 实例的 Hook.
+ * @param container 初始的滚动容器元素
+ * @returns 返回一个包含 ScrollIntoViewHelper 实例的 RefObject
+ */
+export declare function useScrollIntoViewHelper(container: HTMLElement | null): RefObject<ScrollIntoViewHelper | null>;
+//# sourceMappingURL=useScrollIntoViewHelper.d.ts.map

package/dist/core/useScrollIntoViewHelper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollIntoViewHelper.d.ts","sourceRoot":"","sources":["../../src/core/useScrollIntoViewHelper.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,SAAS,EAEjB,MAAM,OAAO,CAAC;AAEf,OAAO,EACH,KAAK,qBAAqB,EAI7B,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EAAE,qBAAqB,EAAE,CAAC;AAEtC;;;GAGG;AACH,cAAM,oBAAoB;IACtB,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,iBAAiB,CAA6B;gBAE1C,SAAS,EAAE,WAAW,GAAG,IAAI;IAIlC,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,GAAE,qBAA0B,GAAG,IAAI;IAuBzE,UAAU,IAAI,IAAI;IAQlB,YAAY,IAAI,WAAW,GAAG,IAAI;IAGlC,YAAY,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI;IAIjD,OAAO,IAAI,IAAI;CAIzB;AAGD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACnC,SAAS,EAAE,WAAW,GAAG,IAAI,GAC9B,SAAS,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAaxC"}

package/dist/core/useScrollIntoViewHelper.js

@@ -0,0 +1,65 @@
+import { useRef, useEffect, } from "react";
+import { ensureNotNull } from "../utils/index.js";
+import { ScrollDirections, animatedScrollTo, calculateScrollOffset, } from "../utils/scroll-helper.js";
+/**
+ * A helper class that encapsulates scrolling logic.
+ * This is managed by the useScrollIntoViewHelper hook.
+ */
+class ScrollIntoViewHelper {
+    _container;
+    _runningAnimation = null; // 用于停止动画
+    constructor(container) {
+        this._container = container;
+    }
+    scrollTo(element, options = {}) {
+        if (!this._container || !element) {
+            return;
+        }
+        // [新引擎] 功能强大
+        // 1. 如果有正在进行的动画，先停止它
+        if (this._runningAnimation) {
+            this._runningAnimation();
+        }
+        // 2. 解构出 direction，因为它决定了计算方式
+        const { direction = ScrollDirections.vertical, ...restOptions } = options;
+        // 3. 调用我们的核心计算函数
+        const targetOffset = calculateScrollOffset(this._container, element, direction, options);
+        // 4. 调用我们的核心动画函数，并保存停止句柄
+        this._runningAnimation = animatedScrollTo(this._container, targetOffset, direction, restOptions);
+    }
+    // 别忘了在 stopScroll 和 destroy 方法里也调用它
+    stopScroll() {
+        if (this._runningAnimation) {
+            this._runningAnimation();
+            this._runningAnimation = null;
+        }
+    }
+    // These two methods are what useKeepActiveItemIntoView needs.
+    getContainer() {
+        return this._container;
+    }
+    setContainer(container) {
+        this._container = container;
+    }
+    destroy() {
+        this.stopScroll();
+        this._container = null;
+    }
+}
+/**
+ * 创建并管理一个 ScrollIntoViewHelper 实例的 Hook.
+ * @param container 初始的滚动容器元素
+ * @returns 返回一个包含 ScrollIntoViewHelper 实例的 RefObject
+ */
+export function useScrollIntoViewHelper(container) {
+    const helperRef = useRef(null);
+    useEffect(() => {
+        helperRef.current = new ScrollIntoViewHelper(container);
+        return () => {
+            // 在组件卸载时销毁实例，防止内存泄漏
+            ensureNotNull(helperRef.current).destroy();
+        };
+    }, [container]); // 当容器变化时重新创建实例
+    return helperRef;
+}
+//# sourceMappingURL=useScrollIntoViewHelper.js.map

package/dist/core/useScrollIntoViewHelper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollIntoViewHelper.js","sourceRoot":"","sources":["../../src/core/useScrollIntoViewHelper.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,MAAM,EAAE,SAAS,GACpB,MAAM,OAAO,CAAC;AACf,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAEH,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,GACxB,MAAM,2BAA2B,CAAC;AAInC;;;GAGG;AACH,MAAM,oBAAoB;IACd,UAAU,CAAqB;IAC/B,iBAAiB,GAAwB,IAAI,CAAC,CAAC,SAAS;IAEhE,YAAY,SAA6B;QACrC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAChC,CAAC;IAEM,QAAQ,CAAC,OAAoB,EAAE,UAAiC,EAAE;QACrE,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,OAAO,EAAE,CAAC;YAC/B,OAAO;QACX,CAAC;QAED,aAAa;QAEb,qBAAqB;QACrB,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACzB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC7B,CAAC;QAED,8BAA8B;QAC9B,MAAM,EAAE,SAAS,GAAG,gBAAgB,CAAC,QAAQ,EAAE,GAAG,WAAW,EAAE,GAAG,OAAO,CAAC;QAE1E,iBAAiB;QACjB,MAAM,YAAY,GAAG,qBAAqB,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAEzF,yBAAyB;QACzB,IAAI,CAAC,iBAAiB,GAAG,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IACrG,CAAC;IAED,oCAAoC;IAC7B,UAAU;QACb,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACzB,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACzB,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAClC,CAAC;IACL,CAAC;IAED,8DAA8D;IACvD,YAAY;QACf,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IACM,YAAY,CAAC,SAA6B;QAC7C,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAChC,CAAC;IAEM,OAAO;QACV,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IAC3B,CAAC;CACJ;AAGD;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACnC,SAA6B;IAE7B,MAAM,SAAS,GAAG,MAAM,CAA8B,IAAI,CAAC,CAAC;IAE5D,SAAS,CAAC,GAAG,EAAE;QACX,SAAS,CAAC,OAAO,GAAG,IAAI,oBAAoB,CAAC,SAAS,CAAC,CAAC;QAExD,OAAO,GAAG,EAAE;YACR,oBAAoB;YACpB,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;QAC/C,CAAC,CAAC;IACN,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,eAAe;IAEhC,OAAO,SAAS,CAAC;AACrB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./core/useBoundingClientRect.js";
+export * from "./core/useComposedRefs.js";
+export * from "./core/useDraggable.js";
+export * from "./core/useEventCallback.js";
+export * from "./core/useIsomorphicLayoutEffect.js";
+export * from "./core/useCustomScroller.js";
+export * from "./core/useKeepActiveItemIntoView.js";
+export * from "./core/useScrollIntoViewHelper.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qCAAqC,CAAC;AAEpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from "./core/useBoundingClientRect.js";
+export * from "./core/useComposedRefs.js";
+export * from "./core/useDraggable.js";
+export * from "./core/useEventCallback.js";
+export * from "./core/useIsomorphicLayoutEffect.js";
+export * from "./core/useCustomScroller.js";
+export * from "./core/useKeepActiveItemIntoView.js";
+export * from "./core/useScrollIntoViewHelper.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,2BAA2B,CAAC;AAC1C,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,qCAAqC,CAAC;AAEpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,2 @@
+export declare function ensureNotNull<T>(value: T | null | undefined): T;
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,CAAC,CAK/D"}

package/dist/utils/index.js

@@ -0,0 +1,7 @@
+export function ensureNotNull(value) {
+    if (value === null || value === undefined) {
+        throw new Error('Value is null or undefined');
+    }
+    return value;
+}
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAI,KAA2B;IACxD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/utils/scroll-helper.d.ts

@@ -0,0 +1,37 @@
+type ValueOf<T> = T[keyof T];
+export declare const ScrollDirections: {
+    readonly vertical: "vertical";
+    readonly horizontal: "horizontal";
+};
+export type ScrollDirections = ValueOf<typeof ScrollDirections>;
+export declare const Anchors: {
+    readonly start: "start";
+    readonly middle: "middle";
+    readonly end: "end";
+};
+export type Anchors = ValueOf<typeof Anchors>;
+export declare const BuiltinEasingFunctions: {
+    readonly linear: "linear";
+    readonly easeInOutCubic: "easeInOutCubic";
+};
+export type BuiltinEasingFunctions = ValueOf<typeof BuiltinEasingFunctions>;
+export interface AnimatedScrollOptions {
+    /** 动画的最大时长 (毫秒)，实际时长会自适应调整 */
+    duration?: number;
+    /** 缓动函数 */
+    easing?: BuiltinEasingFunctions | ((t: number) => number);
+    /** 要对齐的目标元素的锚点，默认为 'start' (顶部/左侧) */
+    targetAnchor?: Anchors;
+    /** 要对齐到的容器的锚点，可以是固定位置或百分比 (0-100)，默认为 'start' */
+    containerAnchor?: Anchors | number;
+    /** 在对齐后应用的额外偏移量，支持 'px' 和 '%' (相对于目标元素尺寸) */
+    offset?: number | string;
+    /** 滚动方向，默认为 'vertical' */
+    direction?: ScrollDirections;
+    /** 滚动动画结束后的回调 */
+    onScrollEnd?: () => void;
+}
+export declare function animatedScrollTo(container: HTMLElement, targetOffset: number, direction: NonNullable<AnimatedScrollOptions["direction"]>, options?: Pick<AnimatedScrollOptions, "duration" | "easing" | "onScrollEnd">): () => void;
+export declare function calculateScrollOffset(container: HTMLElement, target: HTMLElement, direction: NonNullable<AnimatedScrollOptions["direction"]>, options?: AnimatedScrollOptions): number;
+export {};
+//# sourceMappingURL=scroll-helper.d.ts.map

package/dist/utils/scroll-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-helper.d.ts","sourceRoot":"","sources":["../../src/utils/scroll-helper.ts"],"names":[],"mappings":"AAAA,KAAK,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AAE7B,eAAO,MAAM,gBAAgB;;;CAGnB,CAAC;AACX,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,eAAO,MAAM,OAAO;;;;CAIV,CAAC;AACX,MAAM,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,OAAO,CAAC,CAAC;AAE9C,eAAO,MAAM,sBAAsB;;;CAGzB,CAAC;AACX,MAAM,MAAM,sBAAsB,GAAG,OAAO,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E,MAAM,WAAW,qBAAqB;IAClC,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW;IACX,MAAM,CAAC,EAAE,sBAAsB,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IAC1D,sCAAsC;IACtC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iDAAiD;IACjD,eAAe,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACnC,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,0BAA0B;IAC1B,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,iBAAiB;IACjB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC5B;AAuBD,wBAAgB,gBAAgB,CAC5B,SAAS,EAAE,WAAW,EACtB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,WAAW,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC,EAC1D,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,EAAE,UAAU,GAAG,QAAQ,GAAG,aAAa,CAAC,GAC7E,MAAM,IAAI,CAmDZ;AAKD,wBAAgB,qBAAqB,CACjC,SAAS,EAAE,WAAW,EACtB,MAAM,EAAE,WAAW,EACnB,SAAS,EAAE,WAAW,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC,EAC1D,OAAO,CAAC,EAAE,qBAAqB,GAChC,MAAM,CA+CR"}

package/dist/utils/scroll-helper.js

@@ -0,0 +1,115 @@
+export const ScrollDirections = {
+    vertical: "vertical",
+    horizontal: "horizontal",
+};
+export const Anchors = {
+    start: "start",
+    middle: "middle",
+    end: "end",
+};
+export const BuiltinEasingFunctions = {
+    linear: "linear",
+    easeInOutCubic: "easeInOutCubic",
+};
+const EASING_FUNCTIONS = {
+    linear: (t) => t,
+    easeInOutCubic: (t) => t < 0.5 ? 4 * t * t * t : 1 - Math.pow(-2 * t + 2, 3) / 2,
+};
+function parseOffset(offset, referenceSize) {
+    if (typeof offset === "number") {
+        return offset;
+    }
+    if (typeof offset === "string") {
+        if (offset.endsWith("%")) {
+            const percent = parseFloat(offset.slice(0, -1));
+            return (percent / 100) * referenceSize;
+        }
+        return parseFloat(offset);
+    }
+    return 0;
+}
+// 2. 核心动画函数 (V5.4 更新：基于速度的自适应时长)
+// ==========================================================
+export function animatedScrollTo(container, targetOffset, direction, options) {
+    const { duration: userMaxDuration = 800, easing = BuiltinEasingFunctions.linear, onScrollEnd, } = options ?? {};
+    let animationFrameId;
+    const scrollProperty = direction === ScrollDirections.vertical ? "scrollTop" : "scrollLeft";
+    const startPosition = container[scrollProperty];
+    const distance = targetOffset - startPosition;
+    // --- 基于速度的自适应时长逻辑 ---
+    const PIXELS_PER_MS = 1.5; // 定义一个理想滚动速度 (1500px/s)
+    const MIN_DURATION = 200; // 保证动画可被感知的最小时长
+    // 根据速度计算理想时长
+    const idealDuration = Math.abs(distance) / PIXELS_PER_MS;
+    // 最终时长 = 在[最小时长, 用户设定的最大时长]区间内，取理想时长
+    const finalDuration = Math.max(MIN_DURATION, Math.min(idealDuration, userMaxDuration));
+    // --- 逻辑结束 ---
+    if (Math.abs(distance) < 1) {
+        onScrollEnd?.();
+        return () => { };
+    }
+    const startTime = performance.now();
+    const easingFunction = typeof easing === "string" ? EASING_FUNCTIONS[easing] : easing;
+    const animationLoop = (currentTime) => {
+        const elapsedTime = currentTime - startTime;
+        const progress = Math.min(elapsedTime / finalDuration, 1);
+        const easedProgress = easingFunction(progress);
+        container[scrollProperty] = startPosition + distance * easedProgress;
+        if (progress < 1) {
+            animationFrameId = requestAnimationFrame(animationLoop);
+        }
+        else {
+            container[scrollProperty] = targetOffset;
+            onScrollEnd?.();
+        }
+    };
+    animationFrameId = requestAnimationFrame(animationLoop);
+    return () => {
+        cancelAnimationFrame(animationFrameId);
+    };
+}
+// 3. 核心计算函数
+// ==========================================================
+export function calculateScrollOffset(container, target, direction, options) {
+    const { targetAnchor = Anchors.start, containerAnchor = Anchors.start, offset = 0, } = options ?? {};
+    const DIMS = {
+        vertical: {
+            clientSize: "clientHeight",
+            offsetPos: "offsetTop",
+            offsetSize: "offsetHeight",
+            scrollSize: "scrollHeight"
+        },
+        horizontal: {
+            clientSize: "clientWidth",
+            offsetPos: "offsetLeft",
+            offsetSize: "offsetWidth",
+            scrollSize: "scrollWidth",
+        },
+    }[direction];
+    const containerSize = container[DIMS.clientSize];
+    const targetPos = target[DIMS.offsetPos];
+    const targetSize = target[DIMS.offsetSize];
+    const maxScrollPos = container[DIMS.scrollSize] - containerSize;
+    if (maxScrollPos <= 0)
+        return 0;
+    let targetAnchorPos = targetPos;
+    if (targetAnchor === Anchors.middle)
+        targetAnchorPos += targetSize / 2;
+    if (targetAnchor === Anchors.end)
+        targetAnchorPos += targetSize;
+    let containerAnchorPos = 0;
+    if (typeof containerAnchor === "number") {
+        containerAnchorPos = containerSize * (containerAnchor / 100);
+    }
+    else {
+        if (containerAnchor === Anchors.middle)
+            containerAnchorPos = containerSize / 2;
+        if (containerAnchor === Anchors.end)
+            containerAnchorPos = containerSize;
+    }
+    let targetOffset = targetAnchorPos - containerAnchorPos;
+    const finalPixelOffset = parseOffset(offset, targetSize);
+    targetOffset += finalPixelOffset;
+    return Math.max(0, Math.min(targetOffset, maxScrollPos));
+}
+//# sourceMappingURL=scroll-helper.js.map

package/dist/utils/scroll-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scroll-helper.js","sourceRoot":"","sources":["../../src/utils/scroll-helper.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@cites/react-hooks",
+  "description": "React hooks",
+  "version": "0.0.1",
+  "type": "module",
+  "scripts": {
+    "clean": "rm -rf dist && rm -rf .cache",
+    "build": "tsc --build",
+    "prepublishOnly": "npm run clean && npm run build",
+    "pretest": "npm run build",
+    "test": "node --test './dist/**/*.test.js'"
+  },
+  "exports": {
+    ".": {
+      "default": "./dist/core/index.js",
+      "types": "./dist/core/index.d.ts"
+    },
+    "./useBoundingClientRect": {
+      "default": "./dist/core/useBoundingClientRect.js",
+      "types": "./dist/core/useBoundingClientRect.d.ts"
+    },
+    "./useComposedRefs": {
+      "default": "./dist/core/useComposedRefs.js",
+      "types": "./dist/core/useComposedRefs.d.ts"
+    },
+    "./useDraggable": {
+      "default": "./dist/core/useDraggable.js",
+      "types": "./dist/core/useDraggable.d.ts"
+    },
+    "./useEventCallback": {
+      "default": "./dist/core/useEventCallback.js",
+      "types": "./dist/core/useEventCallback.d.ts"
+    },
+    "./useIsomorphicLayoutEffect": {
+      "default": "./dist/core/useIsomorphicLayoutEffect.js",
+      "types": "./dist/core/useIsomorphicLayoutEffect.d.ts"
+    },
+    "./useCustomScroller": {
+      "default": "./dist/core/useCustomScroller.js",
+      "types": "./dist/core/useCustomScroller.d.ts"
+    },
+    "./useKeepActiveItemIntoView": {
+      "default": "./dist/core/useKeepActiveItemIntoView.js",
+      "types": "./dist/core/useKeepActiveItemIntoView.d.ts"
+    },
+    "./useScrollIntoViewHelper": {
+      "default": "./dist/core/useScrollIntoViewHelper.js",
+      "types": "./dist/core/useScrollIntoViewHelper.d.ts"
+    }
+  },
+  "keywords": [
+    "react",
+    "hooks"
+  ],
+  "author": "Colin Cheng <zbinlin@outlook.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zbinlin/react-hooks.git"
+  },
+  "files": [
+    "./dist/",
+    "README.md"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@types/jsdom": "^21.1.7",
+    "@types/node": "^22.15.19",
+    "@types/react": "^19.1.6",
+    "@types/react-dom": "^19.1.6",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "typescript": "^5.8.3"
+  }
+}