@publikit/hooks 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Pirimera
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,64 @@
+# @publikit/hooks
+
+Generic, reusable React hooks with no UI component dependencies.
+
+- **Peer dep**: React 18/19 only — no `react-dom`, Radix, Tailwind, or shadcn
+- **Tree-shakeable** — `sideEffects: false`
+
+## Installation
+
+```bash
+npm install @publikit/hooks
+```
+
+### Peer dependency
+
+```bash
+npm install react
+```
+
+## Hooks
+
+| Hook | Description |
+|------|-------------|
+| `useIsMobile` | Responsive breakpoint detection (768px) |
+| `useInfiniteScroll` | IntersectionObserver-based infinite scroll |
+| `usePullToRefresh` | Touch pull-to-refresh gesture |
+| `useLiveTimestamp` | Adaptive live relative timestamps |
+| `useScrollableContainer` | Scroll position persistence + scroll buttons |
+
+## Usage
+
+```tsx
+import {
+  useIsMobile,
+  useInfiniteScroll,
+  usePullToRefresh,
+  useLiveTimestamp,
+} from '@publikit/hooks';
+
+function FeedList({ loadMore, hasMore, isLoading }) {
+  const isMobile = useIsMobile();
+  const { Sentinel } = useInfiniteScroll({
+    onLoadMore: loadMore,
+    hasNextPage: hasMore,
+    isFetchingNextPage: isLoading,
+  });
+
+  return (
+    <div>
+      {items.map(renderItem)}
+      <Sentinel />
+    </div>
+  );
+}
+```
+
+## Related packages
+
+- [`@publikit/utils`](../utils) — framework-agnostic utilities
+- [`@publikit/base`](../base) — UI components (re-exports `useIsMobile`)
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,421 @@
+'use strict';
+
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+var utils = require('@publikit/utils');
+
+// use-mobile.tsx
+var MOBILE_BREAKPOINT = 768;
+var MOBILE_MEDIA_QUERY = `(max-width: ${MOBILE_BREAKPOINT - 1}px)`;
+function getIsMobile() {
+  if (typeof window === "undefined") return false;
+  return window.matchMedia(MOBILE_MEDIA_QUERY).matches;
+}
+function useIsMobile() {
+  const [isMobile, setIsMobile] = react.useState(getIsMobile);
+  react.useEffect(() => {
+    const mql = window.matchMedia(MOBILE_MEDIA_QUERY);
+    const onChange = () => setIsMobile(mql.matches);
+    mql.addEventListener("change", onChange);
+    return () => mql.removeEventListener("change", onChange);
+  }, []);
+  return isMobile;
+}
+function useInfiniteScroll({
+  onLoadMore,
+  hasNextPage,
+  isFetchingNextPage,
+  rootMargin = "200px",
+  threshold = 0,
+  enabled = true,
+  root
+}) {
+  const observerRef = react.useRef(null);
+  const [sentinelRef, setSentinelRef] = react.useState(null);
+  const handleIntersection = react.useCallback(
+    (entries) => {
+      const entry = entries[0];
+      if (!entry?.isIntersecting) return;
+      if (hasNextPage && !isFetchingNextPage && enabled) {
+        onLoadMore();
+      }
+    },
+    [onLoadMore, hasNextPage, isFetchingNextPage, enabled]
+  );
+  react.useEffect(() => {
+    if (!enabled) return;
+    if (observerRef.current) {
+      observerRef.current.disconnect();
+    }
+    observerRef.current = new IntersectionObserver(handleIntersection, {
+      root: root || null,
+      rootMargin,
+      threshold
+    });
+    if (sentinelRef) {
+      observerRef.current.observe(sentinelRef);
+    }
+    return () => {
+      if (observerRef.current) {
+        observerRef.current.disconnect();
+      }
+    };
+  }, [sentinelRef, handleIntersection, rootMargin, threshold, enabled, root]);
+  const Sentinel = react.useCallback(
+    ({ className }) => /* @__PURE__ */ jsxRuntime.jsx(
+      "div",
+      {
+        ref: setSentinelRef,
+        className,
+        "aria-hidden": "true",
+        style: { height: "1px" }
+      }
+    ),
+    []
+  );
+  return {
+    Sentinel,
+    sentinelRef: setSentinelRef
+  };
+}
+function usePullToRefresh({
+  onRefresh,
+  threshold = 80,
+  resistance = 2.5,
+  disabled = false
+}) {
+  const [pullDistance, setPullDistance] = react.useState(0);
+  const [isRefreshing, setIsRefreshing] = react.useState(false);
+  const [isPulling, setIsPulling] = react.useState(false);
+  const [containerElement, setContainerElement] = react.useState(null);
+  const containerRef = react.useRef(null);
+  const startYRef = react.useRef(null);
+  const currentYRef = react.useRef(null);
+  const pullDistanceRef = react.useRef(0);
+  pullDistanceRef.current = pullDistance;
+  const assignContainerRef = react.useCallback((node) => {
+    containerRef.current = node;
+    setContainerElement(node);
+  }, []);
+  const handleTouchStart = react.useCallback(
+    (e) => {
+      if (disabled || isRefreshing) return;
+      const container = containerRef.current;
+      if (!container) return;
+      if (container.scrollTop <= 0) {
+        startYRef.current = e.touches[0].clientY;
+        setIsPulling(true);
+      }
+    },
+    [disabled, isRefreshing]
+  );
+  const handleTouchMove = react.useCallback(
+    (e) => {
+      if (disabled || isRefreshing || startYRef.current === null) return;
+      const container = containerRef.current;
+      if (!container) return;
+      if (container.scrollTop > 0) {
+        startYRef.current = null;
+        setPullDistance(0);
+        setIsPulling(false);
+        return;
+      }
+      currentYRef.current = e.touches[0].clientY;
+      const diff = currentYRef.current - startYRef.current;
+      if (diff > 0) {
+        const distance = Math.min(diff / resistance, threshold * 1.5);
+        setPullDistance(distance);
+        if (distance > 5) {
+          e.preventDefault();
+        }
+      }
+    },
+    [disabled, isRefreshing, resistance, threshold]
+  );
+  const handleTouchEnd = react.useCallback(async () => {
+    if (disabled || isRefreshing) return;
+    startYRef.current = null;
+    currentYRef.current = null;
+    setIsPulling(false);
+    const distance = pullDistanceRef.current;
+    if (distance >= threshold) {
+      setIsRefreshing(true);
+      setPullDistance(threshold * 0.5);
+      try {
+        await onRefresh();
+      } finally {
+        setIsRefreshing(false);
+        setPullDistance(0);
+      }
+    } else {
+      setPullDistance(0);
+    }
+  }, [disabled, isRefreshing, threshold, onRefresh]);
+  react.useEffect(() => {
+    const container = containerElement;
+    if (!container) return;
+    container.addEventListener("touchstart", handleTouchStart, { passive: true });
+    container.addEventListener("touchmove", handleTouchMove, { passive: false });
+    container.addEventListener("touchend", handleTouchEnd, { passive: true });
+    return () => {
+      container.removeEventListener("touchstart", handleTouchStart);
+      container.removeEventListener("touchmove", handleTouchMove);
+      container.removeEventListener("touchend", handleTouchEnd);
+    };
+  }, [containerElement, handleTouchStart, handleTouchMove, handleTouchEnd]);
+  const pullProgress = Math.min(pullDistance / threshold, 1);
+  return {
+    pullDistance,
+    isRefreshing,
+    isPulling,
+    containerRef: assignContainerRef,
+    pullProgress
+  };
+}
+var globalNow = /* @__PURE__ */ new Date();
+var subscribers = /* @__PURE__ */ new Map();
+var visibilityMap = /* @__PURE__ */ new Map();
+var rafId = null;
+var intervalId = null;
+var isTabVisible = true;
+var pendingUpdate = false;
+function getUpdateInterval(date) {
+  const ageMs = Date.now() - date.getTime();
+  const ageMinutes = ageMs / 6e4;
+  if (ageMinutes < 1) return 1e4;
+  if (ageMinutes < 60) return 3e4;
+  if (ageMinutes < 1440) return 3e5;
+  return 36e5;
+}
+function getMinInterval() {
+  if (subscribers.size === 0) return 3e4;
+  const intervals = Array.from(subscribers.values()).map((sub) => getUpdateInterval(sub.date));
+  return Math.max(Math.min(...intervals), 1e4);
+}
+var createObserver = (subscriberId, callback) => {
+  return new IntersectionObserver(
+    (entries) => {
+      entries.forEach((entry) => {
+        visibilityMap.set(subscriberId, entry.isIntersecting);
+        if (entry.isIntersecting) {
+          callback();
+        }
+      });
+    },
+    {
+      root: null,
+      rootMargin: "50px",
+      threshold: 0.01
+    }
+  );
+};
+function updateVisibleSubscribers() {
+  if (!isTabVisible || subscribers.size === 0) {
+    pendingUpdate = false;
+    return;
+  }
+  globalNow = /* @__PURE__ */ new Date();
+  if (!pendingUpdate) {
+    pendingUpdate = true;
+    rafId = requestAnimationFrame(() => {
+      subscribers.forEach((subscriber, subscriberId) => {
+        const isVisible = visibilityMap.get(subscriberId) ?? true;
+        if (isVisible) {
+          subscriber.callback();
+        }
+      });
+      pendingUpdate = false;
+    });
+  }
+}
+function stopTimer() {
+  if (intervalId) {
+    clearTimeout(intervalId);
+    intervalId = null;
+  }
+  if (rafId) {
+    cancelAnimationFrame(rafId);
+    rafId = null;
+  }
+  pendingUpdate = false;
+}
+function scheduleNextTick() {
+  if (intervalId) {
+    clearTimeout(intervalId);
+    intervalId = null;
+  }
+  if (subscribers.size === 0 || !isTabVisible) {
+    return;
+  }
+  intervalId = setTimeout(() => {
+    updateVisibleSubscribers();
+    scheduleNextTick();
+  }, getMinInterval());
+}
+function ensureTimerRunning() {
+  if (!intervalId && subscribers.size > 0 && isTabVisible) {
+    scheduleNextTick();
+  }
+}
+function restartTimer() {
+  stopTimer();
+  ensureTimerRunning();
+}
+if (typeof window !== "undefined") {
+  document.addEventListener("visibilitychange", () => {
+    isTabVisible = !document.hidden;
+    if (isTabVisible && subscribers.size > 0) {
+      updateVisibleSubscribers();
+      ensureTimerRunning();
+    } else if (!isTabVisible) {
+      stopTimer();
+    }
+  });
+}
+function useLiveTimestamp(date, elementRef) {
+  const [, setTick] = react.useState(0);
+  const subscriberIdRef = react.useRef(/* @__PURE__ */ Symbol("live-timestamp-subscriber"));
+  react.useEffect(() => {
+    const subscriberId = subscriberIdRef.current;
+    const callback = () => {
+      const isVisible = visibilityMap.get(subscriberId) ?? true;
+      if (isVisible) {
+        setTick((t) => t + 1);
+      }
+    };
+    let observer = null;
+    if (elementRef?.current) {
+      observer = createObserver(subscriberId, callback);
+      observer.observe(elementRef.current);
+      visibilityMap.set(subscriberId, false);
+    } else {
+      visibilityMap.set(subscriberId, true);
+    }
+    subscribers.set(subscriberId, {
+      callback,
+      date,
+      observer
+    });
+    ensureTimerRunning();
+    return () => {
+      const subscriber = subscribers.get(subscriberId);
+      if (subscriber?.observer) {
+        subscriber.observer.disconnect();
+      }
+      subscribers.delete(subscriberId);
+      visibilityMap.delete(subscriberId);
+      if (subscribers.size === 0) {
+        stopTimer();
+      } else {
+        restartTimer();
+      }
+    };
+  }, [date.getTime(), elementRef]);
+  return globalNow;
+}
+var SCROLL_AMOUNT = 80;
+var SCROLL_CHECK_DELAY = 100;
+var DEFAULT_SCROLL_POSITION_KEY = "scrollable-container-position";
+var STORAGE_DEBOUNCE_MS = 150;
+function useScrollableContainer(scrollPositionKey = DEFAULT_SCROLL_POSITION_KEY) {
+  const containerRef = react.useRef(null);
+  const [containerElement, setContainerElement] = react.useState(null);
+  const isRestoringRef = react.useRef(false);
+  const [canScrollUp, setCanScrollUp] = react.useState(false);
+  const [canScrollDown, setCanScrollDown] = react.useState(false);
+  const assignContainerRef = react.useCallback((node) => {
+    containerRef.current = node;
+    setContainerElement(node);
+  }, []);
+  const saveToStorage = react.useMemo(
+    () => utils.debounce((position) => {
+      try {
+        sessionStorage.setItem(scrollPositionKey, String(position));
+      } catch {
+      }
+    }, STORAGE_DEBOUNCE_MS),
+    [scrollPositionKey]
+  );
+  const checkScrollability = react.useCallback(() => {
+    if (!containerRef.current || isRestoringRef.current) return;
+    const { scrollTop, scrollHeight, clientHeight } = containerRef.current;
+    saveToStorage(scrollTop);
+    setCanScrollUp(scrollTop > 0);
+    setCanScrollDown(scrollTop < scrollHeight - clientHeight - 1);
+  }, [saveToStorage]);
+  react.useLayoutEffect(() => {
+    if (!containerElement || isRestoringRef.current) return;
+    try {
+      const savedPosition = sessionStorage.getItem(scrollPositionKey);
+      if (savedPosition !== null) {
+        const position = parseInt(savedPosition, 10);
+        const currentPosition = containerElement.scrollTop;
+        if (position > 0 && !isNaN(position) && Math.abs(currentPosition - position) > 1) {
+          isRestoringRef.current = true;
+          containerElement.scrollTop = position;
+          requestAnimationFrame(() => {
+            isRestoringRef.current = false;
+            checkScrollability();
+          });
+        }
+      }
+    } catch {
+    }
+  }, [containerElement, scrollPositionKey, checkScrollability]);
+  const preserveScrollPosition = react.useCallback(() => {
+    if (containerRef.current) {
+      try {
+        sessionStorage.setItem(scrollPositionKey, String(containerRef.current.scrollTop));
+      } catch {
+      }
+    }
+  }, [scrollPositionKey]);
+  react.useEffect(() => {
+    return () => {
+      saveToStorage.cancel();
+    };
+  }, [saveToStorage]);
+  react.useEffect(() => {
+    if (!containerElement) return;
+    const timeoutId = setTimeout(checkScrollability, SCROLL_CHECK_DELAY);
+    const handleScroll = () => {
+      checkScrollability();
+    };
+    containerElement.addEventListener("scroll", handleScroll, { passive: true });
+    window.addEventListener("resize", checkScrollability);
+    const resizeObserver = new ResizeObserver(checkScrollability);
+    resizeObserver.observe(containerElement);
+    return () => {
+      clearTimeout(timeoutId);
+      containerElement.removeEventListener("scroll", handleScroll);
+      window.removeEventListener("resize", checkScrollability);
+      resizeObserver.disconnect();
+    };
+  }, [containerElement, checkScrollability]);
+  const scrollUp = react.useCallback(() => {
+    containerRef.current?.scrollBy({ top: -SCROLL_AMOUNT, behavior: "smooth" });
+  }, []);
+  const scrollDown = react.useCallback(() => {
+    containerRef.current?.scrollBy({ top: SCROLL_AMOUNT, behavior: "smooth" });
+  }, []);
+  return {
+    containerRef: assignContainerRef,
+    canScrollUp,
+    canScrollDown,
+    scrollUp,
+    scrollDown,
+    checkScrollability,
+    preserveScrollPosition
+  };
+}
+
+exports.DEFAULT_SCROLL_POSITION_KEY = DEFAULT_SCROLL_POSITION_KEY;
+exports.SCROLL_AMOUNT = SCROLL_AMOUNT;
+exports.SCROLL_CHECK_DELAY = SCROLL_CHECK_DELAY;
+exports.useInfiniteScroll = useInfiniteScroll;
+exports.useIsMobile = useIsMobile;
+exports.useLiveTimestamp = useLiveTimestamp;
+exports.usePullToRefresh = usePullToRefresh;
+exports.useScrollableContainer = useScrollableContainer;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../use-mobile.tsx","../use-infinite-scroll.tsx","../use-pull-to-refresh.ts","../use-live-timestamp.ts","../use-scrollable-container.ts"],"names":["useState","useEffect","useRef","useCallback","jsx","useMemo","debounce","useLayoutEffect"],"mappings":"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","file":"index.cjs","sourcesContent":["import { useEffect, useState } from 'react';\r\n\r\nconst MOBILE_BREAKPOINT = 768;\r\nconst MOBILE_MEDIA_QUERY = `(max-width: ${MOBILE_BREAKPOINT - 1}px)` as const;\r\n\r\nfunction getIsMobile(): boolean {\r\n  if (typeof window === 'undefined') return false;\r\n  return window.matchMedia(MOBILE_MEDIA_QUERY).matches;\r\n}\r\n\r\nexport function useIsMobile(): boolean {\r\n  const [isMobile, setIsMobile] = useState<boolean>(getIsMobile);\r\n\r\n  useEffect(() => {\r\n    const mql = window.matchMedia(MOBILE_MEDIA_QUERY);\r\n    const onChange = () => setIsMobile(mql.matches);\r\n    mql.addEventListener('change', onChange);\r\n    return () => mql.removeEventListener('change', onChange);\r\n  }, []);\r\n\r\n  return isMobile;\r\n}\r\n","import { useEffect, useRef, useCallback, useState } from 'react';\r\n\r\nexport interface UseInfiniteScrollOptions {\r\n  /** Callback when intersection occurs */\r\n  onLoadMore: () => void;\r\n  /** Whether more data can be loaded */\r\n  hasNextPage: boolean;\r\n  /** Whether currently fetching */\r\n  isFetchingNextPage: boolean;\r\n  /** Root margin for intersection observer */\r\n  rootMargin?: string;\r\n  /** Threshold for intersection */\r\n  threshold?: number;\r\n  /** Enable/disable the hook */\r\n  enabled?: boolean;\r\n  /** Custom root element for IntersectionObserver (e.g., ScrollArea viewport) */\r\n  root?: HTMLElement | null;\r\n}\r\n\r\n/**\r\n * Hook for implementing infinite scroll using IntersectionObserver.\r\n */\r\nexport function useInfiniteScroll({\r\n  onLoadMore,\r\n  hasNextPage,\r\n  isFetchingNextPage,\r\n  rootMargin = '200px',\r\n  threshold = 0,\r\n  enabled = true,\r\n  root,\r\n}: UseInfiniteScrollOptions) {\r\n  const observerRef = useRef<IntersectionObserver | null>(null);\r\n  const [sentinelRef, setSentinelRef] = useState<HTMLDivElement | null>(null);\r\n\r\n  const handleIntersection = useCallback(\r\n    (entries: IntersectionObserverEntry[]) => {\r\n      const entry = entries[0];\r\n      if (!entry?.isIntersecting) return;\r\n      if (hasNextPage && !isFetchingNextPage && enabled) {\r\n        onLoadMore();\r\n      }\r\n    },\r\n    [onLoadMore, hasNextPage, isFetchingNextPage, enabled]\r\n  );\r\n\r\n  useEffect(() => {\r\n    if (!enabled) return;\r\n\r\n    if (observerRef.current) {\r\n      observerRef.current.disconnect();\r\n    }\r\n\r\n    observerRef.current = new IntersectionObserver(handleIntersection, {\r\n      root: root || null,\r\n      rootMargin,\r\n      threshold,\r\n    });\r\n\r\n    if (sentinelRef) {\r\n      observerRef.current.observe(sentinelRef);\r\n    }\r\n\r\n    return () => {\r\n      if (observerRef.current) {\r\n        observerRef.current.disconnect();\r\n      }\r\n    };\r\n  }, [sentinelRef, handleIntersection, rootMargin, threshold, enabled, root]);\r\n\r\n  const Sentinel = useCallback(\r\n    ({ className }: { className?: string }) => (\r\n      <div\r\n        ref={setSentinelRef}\r\n        className={className}\r\n        aria-hidden=\"true\"\r\n        style={{ height: '1px' }}\r\n      />\r\n    ),\r\n    []\r\n  );\r\n\r\n  return {\r\n    Sentinel,\r\n    sentinelRef: setSentinelRef,\r\n  };\r\n}\r\n","import { useState, useEffect, useRef, useCallback, type Ref } from 'react';\r\n\r\nexport interface UsePullToRefreshOptions {\r\n  onRefresh: () => Promise<void>;\r\n  threshold?: number;\r\n  resistance?: number;\r\n  disabled?: boolean;\r\n}\r\n\r\nexport interface UsePullToRefreshReturn {\r\n  pullDistance: number;\r\n  isRefreshing: boolean;\r\n  isPulling: boolean;\r\n  /** Callback ref — attach to the scrollable container element */\r\n  containerRef: Ref<HTMLDivElement | null>;\r\n  pullProgress: number;\r\n}\r\n\r\n/**\r\n * Hook to add pull-to-refresh gesture for mobile devices.\r\n */\r\nexport function usePullToRefresh({\r\n  onRefresh,\r\n  threshold = 80,\r\n  resistance = 2.5,\r\n  disabled = false,\r\n}: UsePullToRefreshOptions): UsePullToRefreshReturn {\r\n  const [pullDistance, setPullDistance] = useState(0);\r\n  const [isRefreshing, setIsRefreshing] = useState(false);\r\n  const [isPulling, setIsPulling] = useState(false);\r\n  const [containerElement, setContainerElement] = useState<HTMLDivElement | null>(null);\r\n\r\n  const containerRef = useRef<HTMLDivElement | null>(null);\r\n  const startYRef = useRef<number | null>(null);\r\n  const currentYRef = useRef<number | null>(null);\r\n  const pullDistanceRef = useRef(0);\r\n\r\n  pullDistanceRef.current = pullDistance;\r\n\r\n  const assignContainerRef = useCallback((node: HTMLDivElement | null) => {\r\n    containerRef.current = node;\r\n    setContainerElement(node);\r\n  }, []);\r\n\r\n  const handleTouchStart = useCallback(\r\n    (e: TouchEvent) => {\r\n      if (disabled || isRefreshing) return;\r\n\r\n      const container = containerRef.current;\r\n      if (!container) return;\r\n\r\n      if (container.scrollTop <= 0) {\r\n        startYRef.current = e.touches[0].clientY;\r\n        setIsPulling(true);\r\n      }\r\n    },\r\n    [disabled, isRefreshing]\r\n  );\r\n\r\n  const handleTouchMove = useCallback(\r\n    (e: TouchEvent) => {\r\n      if (disabled || isRefreshing || startYRef.current === null) return;\r\n\r\n      const container = containerRef.current;\r\n      if (!container) return;\r\n\r\n      if (container.scrollTop > 0) {\r\n        startYRef.current = null;\r\n        setPullDistance(0);\r\n        setIsPulling(false);\r\n        return;\r\n      }\r\n\r\n      currentYRef.current = e.touches[0].clientY;\r\n      const diff = currentYRef.current - startYRef.current;\r\n\r\n      if (diff > 0) {\r\n        const distance = Math.min(diff / resistance, threshold * 1.5);\r\n        setPullDistance(distance);\r\n\r\n        if (distance > 5) {\r\n          e.preventDefault();\r\n        }\r\n      }\r\n    },\r\n    [disabled, isRefreshing, resistance, threshold]\r\n  );\r\n\r\n  const handleTouchEnd = useCallback(async () => {\r\n    if (disabled || isRefreshing) return;\r\n\r\n    startYRef.current = null;\r\n    currentYRef.current = null;\r\n    setIsPulling(false);\r\n\r\n    const distance = pullDistanceRef.current;\r\n\r\n    if (distance >= threshold) {\r\n      setIsRefreshing(true);\r\n      setPullDistance(threshold * 0.5);\r\n\r\n      try {\r\n        await onRefresh();\r\n      } finally {\r\n        setIsRefreshing(false);\r\n        setPullDistance(0);\r\n      }\r\n    } else {\r\n      setPullDistance(0);\r\n    }\r\n  }, [disabled, isRefreshing, threshold, onRefresh]);\r\n\r\n  useEffect(() => {\r\n    const container = containerElement;\r\n    if (!container) return;\r\n\r\n    container.addEventListener('touchstart', handleTouchStart, { passive: true });\r\n    container.addEventListener('touchmove', handleTouchMove, { passive: false });\r\n    container.addEventListener('touchend', handleTouchEnd, { passive: true });\r\n\r\n    return () => {\r\n      container.removeEventListener('touchstart', handleTouchStart);\r\n      container.removeEventListener('touchmove', handleTouchMove);\r\n      container.removeEventListener('touchend', handleTouchEnd);\r\n    };\r\n  }, [containerElement, handleTouchStart, handleTouchMove, handleTouchEnd]);\r\n\r\n  const pullProgress = Math.min(pullDistance / threshold, 1);\r\n\r\n  return {\r\n    pullDistance,\r\n    isRefreshing,\r\n    isPulling,\r\n    containerRef: assignContainerRef,\r\n    pullProgress,\r\n  };\r\n}\r\n","import { useState, useEffect, useRef, type RefObject } from 'react';\r\n\r\nlet globalNow = new Date();\r\n\r\ntype SubscriberId = symbol;\r\n\r\ntype Subscriber = {\r\n  callback: () => void;\r\n  date: Date;\r\n  observer: IntersectionObserver | null;\r\n};\r\n\r\nconst subscribers = new Map<SubscriberId, Subscriber>();\r\nconst visibilityMap = new Map<SubscriberId, boolean>();\r\n\r\nlet rafId: number | null = null;\r\nlet intervalId: ReturnType<typeof setTimeout> | null = null;\r\nlet isTabVisible = true;\r\nlet pendingUpdate = false;\r\n\r\nfunction getUpdateInterval(date: Date): number {\r\n  const ageMs = Date.now() - date.getTime();\r\n  const ageMinutes = ageMs / 60000;\r\n\r\n  if (ageMinutes < 1) return 10000;\r\n  if (ageMinutes < 60) return 30000;\r\n  if (ageMinutes < 1440) return 300000;\r\n  return 3600000;\r\n}\r\n\r\nfunction getMinInterval(): number {\r\n  if (subscribers.size === 0) return 30000;\r\n  const intervals = Array.from(subscribers.values()).map((sub) => getUpdateInterval(sub.date));\r\n  return Math.max(Math.min(...intervals), 10000);\r\n}\r\n\r\nconst createObserver = (\r\n  subscriberId: SubscriberId,\r\n  callback: () => void\r\n): IntersectionObserver => {\r\n  return new IntersectionObserver(\r\n    (entries) => {\r\n      entries.forEach((entry) => {\r\n        visibilityMap.set(subscriberId, entry.isIntersecting);\r\n        if (entry.isIntersecting) {\r\n          callback();\r\n        }\r\n      });\r\n    },\r\n    {\r\n      root: null,\r\n      rootMargin: '50px',\r\n      threshold: 0.01,\r\n    }\r\n  );\r\n};\r\n\r\nfunction updateVisibleSubscribers() {\r\n  if (!isTabVisible || subscribers.size === 0) {\r\n    pendingUpdate = false;\r\n    return;\r\n  }\r\n\r\n  globalNow = new Date();\r\n\r\n  if (!pendingUpdate) {\r\n    pendingUpdate = true;\r\n    rafId = requestAnimationFrame(() => {\r\n      subscribers.forEach((subscriber, subscriberId) => {\r\n        const isVisible = visibilityMap.get(subscriberId) ?? true;\r\n        if (isVisible) {\r\n          subscriber.callback();\r\n        }\r\n      });\r\n      pendingUpdate = false;\r\n    });\r\n  }\r\n}\r\n\r\nfunction stopTimer() {\r\n  if (intervalId) {\r\n    clearTimeout(intervalId);\r\n    intervalId = null;\r\n  }\r\n  if (rafId) {\r\n    cancelAnimationFrame(rafId);\r\n    rafId = null;\r\n  }\r\n  pendingUpdate = false;\r\n}\r\n\r\nfunction scheduleNextTick() {\r\n  if (intervalId) {\r\n    clearTimeout(intervalId);\r\n    intervalId = null;\r\n  }\r\n\r\n  if (subscribers.size === 0 || !isTabVisible) {\r\n    return;\r\n  }\r\n\r\n  intervalId = setTimeout(() => {\r\n    updateVisibleSubscribers();\r\n    scheduleNextTick();\r\n  }, getMinInterval());\r\n}\r\n\r\nfunction ensureTimerRunning() {\r\n  if (!intervalId && subscribers.size > 0 && isTabVisible) {\r\n    scheduleNextTick();\r\n  }\r\n}\r\n\r\nfunction restartTimer() {\r\n  stopTimer();\r\n  ensureTimerRunning();\r\n}\r\n\r\nif (typeof window !== 'undefined') {\r\n  document.addEventListener('visibilitychange', () => {\r\n    isTabVisible = !document.hidden;\r\n    if (isTabVisible && subscribers.size > 0) {\r\n      updateVisibleSubscribers();\r\n      ensureTimerRunning();\r\n    } else if (!isTabVisible) {\r\n      stopTimer();\r\n    }\r\n  });\r\n}\r\n\r\n/**\r\n * Live-updating timestamp hook with visibility-aware adaptive intervals.\r\n */\r\nexport function useLiveTimestamp(date: Date, elementRef?: RefObject<Element>): Date {\r\n  const [, setTick] = useState(0);\r\n  const subscriberIdRef = useRef<SubscriberId>(Symbol('live-timestamp-subscriber'));\r\n\r\n  useEffect(() => {\r\n    const subscriberId = subscriberIdRef.current;\r\n\r\n    const callback = () => {\r\n      const isVisible = visibilityMap.get(subscriberId) ?? true;\r\n      if (isVisible) {\r\n        setTick((t) => t + 1);\r\n      }\r\n    };\r\n\r\n    let observer: IntersectionObserver | null = null;\r\n    if (elementRef?.current) {\r\n      observer = createObserver(subscriberId, callback);\r\n      observer.observe(elementRef.current);\r\n      visibilityMap.set(subscriberId, false);\r\n    } else {\r\n      visibilityMap.set(subscriberId, true);\r\n    }\r\n\r\n    subscribers.set(subscriberId, {\r\n      callback,\r\n      date,\r\n      observer,\r\n    });\r\n\r\n    ensureTimerRunning();\r\n\r\n    return () => {\r\n      const subscriber = subscribers.get(subscriberId);\r\n      if (subscriber?.observer) {\r\n        subscriber.observer.disconnect();\r\n      }\r\n      subscribers.delete(subscriberId);\r\n      visibilityMap.delete(subscriberId);\r\n\r\n      if (subscribers.size === 0) {\r\n        stopTimer();\r\n      } else {\r\n        restartTimer();\r\n      }\r\n    };\r\n    // Key on the timestamp value, not the Date identity, so callers passing a\r\n    // freshly constructed Date each render don't trigger a re-subscribe.\r\n  }, [date.getTime(), elementRef]);\r\n\r\n  return globalNow;\r\n}\r\n","import { useRef, useEffect, useLayoutEffect, useState, useCallback, useMemo, type Ref } from 'react';\r\nimport { debounce } from '@publikit/utils';\r\n\r\nexport const SCROLL_AMOUNT = 80;\r\nexport const SCROLL_CHECK_DELAY = 100;\r\nexport const DEFAULT_SCROLL_POSITION_KEY = 'scrollable-container-position';\r\nconst STORAGE_DEBOUNCE_MS = 150;\r\n\r\n/**\r\n * Scrollable container with position persistence and scroll button state.\r\n *\r\n * @param scrollPositionKey - sessionStorage key for scroll position\r\n */\r\nexport function useScrollableContainer(\r\n  scrollPositionKey: string = DEFAULT_SCROLL_POSITION_KEY\r\n) {\r\n  const containerRef = useRef<HTMLElement | null>(null);\r\n  const [containerElement, setContainerElement] = useState<HTMLElement | null>(null);\r\n  const isRestoringRef = useRef<boolean>(false);\r\n  const [canScrollUp, setCanScrollUp] = useState(false);\r\n  const [canScrollDown, setCanScrollDown] = useState(false);\r\n\r\n  const assignContainerRef = useCallback((node: HTMLElement | null) => {\r\n    containerRef.current = node;\r\n    setContainerElement(node);\r\n  }, []);\r\n\r\n  const saveToStorage = useMemo(\r\n    () =>\r\n      debounce((position: number) => {\r\n        try {\r\n          sessionStorage.setItem(scrollPositionKey, String(position));\r\n        } catch {\r\n          // Ignore storage errors\r\n        }\r\n      }, STORAGE_DEBOUNCE_MS),\r\n    [scrollPositionKey]\r\n  );\r\n\r\n  const checkScrollability = useCallback(() => {\r\n    if (!containerRef.current || isRestoringRef.current) return;\r\n    const { scrollTop, scrollHeight, clientHeight } = containerRef.current;\r\n\r\n    saveToStorage(scrollTop);\r\n\r\n    setCanScrollUp(scrollTop > 0);\r\n    setCanScrollDown(scrollTop < scrollHeight - clientHeight - 1);\r\n  }, [saveToStorage]);\r\n\r\n  useLayoutEffect(() => {\r\n    if (!containerElement || isRestoringRef.current) return;\r\n\r\n    try {\r\n      const savedPosition = sessionStorage.getItem(scrollPositionKey);\r\n      if (savedPosition !== null) {\r\n        const position = parseInt(savedPosition, 10);\r\n        const currentPosition = containerElement.scrollTop;\r\n\r\n        if (position > 0 && !isNaN(position) && Math.abs(currentPosition - position) > 1) {\r\n          isRestoringRef.current = true;\r\n          containerElement.scrollTop = position;\r\n          requestAnimationFrame(() => {\r\n            isRestoringRef.current = false;\r\n            checkScrollability();\r\n          });\r\n        }\r\n      }\r\n    } catch {\r\n      // Ignore storage errors\r\n    }\r\n  }, [containerElement, scrollPositionKey, checkScrollability]);\r\n\r\n  const preserveScrollPosition = useCallback(() => {\r\n    if (containerRef.current) {\r\n      try {\r\n        sessionStorage.setItem(scrollPositionKey, String(containerRef.current.scrollTop));\r\n      } catch {\r\n        // Ignore storage errors\r\n      }\r\n    }\r\n  }, [scrollPositionKey]);\r\n\r\n  useEffect(() => {\r\n    return () => {\r\n      saveToStorage.cancel();\r\n    };\r\n  }, [saveToStorage]);\r\n\r\n  useEffect(() => {\r\n    if (!containerElement) return;\r\n\r\n    const timeoutId = setTimeout(checkScrollability, SCROLL_CHECK_DELAY);\r\n\r\n    const handleScroll = () => {\r\n      checkScrollability();\r\n    };\r\n\r\n    containerElement.addEventListener('scroll', handleScroll, { passive: true });\r\n    window.addEventListener('resize', checkScrollability);\r\n\r\n    const resizeObserver = new ResizeObserver(checkScrollability);\r\n    resizeObserver.observe(containerElement);\r\n\r\n    return () => {\r\n      clearTimeout(timeoutId);\r\n      containerElement.removeEventListener('scroll', handleScroll);\r\n      window.removeEventListener('resize', checkScrollability);\r\n      resizeObserver.disconnect();\r\n    };\r\n  }, [containerElement, checkScrollability]);\r\n\r\n  const scrollUp = useCallback(() => {\r\n    containerRef.current?.scrollBy({ top: -SCROLL_AMOUNT, behavior: 'smooth' });\r\n  }, []);\r\n\r\n  const scrollDown = useCallback(() => {\r\n    containerRef.current?.scrollBy({ top: SCROLL_AMOUNT, behavior: 'smooth' });\r\n  }, []);\r\n\r\n  return {\r\n    containerRef: assignContainerRef as Ref<HTMLElement | null>,\r\n    canScrollUp,\r\n    canScrollDown,\r\n    scrollUp,\r\n    scrollDown,\r\n    checkScrollability,\r\n    preserveScrollPosition,\r\n  };\r\n}\r\n"]}

package/dist/index.d.cts

@@ -0,0 +1,74 @@
+import * as react from 'react';
+import { Ref, RefObject } from 'react';
+
+declare function useIsMobile(): boolean;
+
+interface UseInfiniteScrollOptions {
+    /** Callback when intersection occurs */
+    onLoadMore: () => void;
+    /** Whether more data can be loaded */
+    hasNextPage: boolean;
+    /** Whether currently fetching */
+    isFetchingNextPage: boolean;
+    /** Root margin for intersection observer */
+    rootMargin?: string;
+    /** Threshold for intersection */
+    threshold?: number;
+    /** Enable/disable the hook */
+    enabled?: boolean;
+    /** Custom root element for IntersectionObserver (e.g., ScrollArea viewport) */
+    root?: HTMLElement | null;
+}
+/**
+ * Hook for implementing infinite scroll using IntersectionObserver.
+ */
+declare function useInfiniteScroll({ onLoadMore, hasNextPage, isFetchingNextPage, rootMargin, threshold, enabled, root, }: UseInfiniteScrollOptions): {
+    Sentinel: ({ className }: {
+        className?: string;
+    }) => react.JSX.Element;
+    sentinelRef: react.Dispatch<react.SetStateAction<HTMLDivElement | null>>;
+};
+
+interface UsePullToRefreshOptions {
+    onRefresh: () => Promise<void>;
+    threshold?: number;
+    resistance?: number;
+    disabled?: boolean;
+}
+interface UsePullToRefreshReturn {
+    pullDistance: number;
+    isRefreshing: boolean;
+    isPulling: boolean;
+    /** Callback ref — attach to the scrollable container element */
+    containerRef: Ref<HTMLDivElement | null>;
+    pullProgress: number;
+}
+/**
+ * Hook to add pull-to-refresh gesture for mobile devices.
+ */
+declare function usePullToRefresh({ onRefresh, threshold, resistance, disabled, }: UsePullToRefreshOptions): UsePullToRefreshReturn;
+
+/**
+ * Live-updating timestamp hook with visibility-aware adaptive intervals.
+ */
+declare function useLiveTimestamp(date: Date, elementRef?: RefObject<Element>): Date;
+
+declare const SCROLL_AMOUNT = 80;
+declare const SCROLL_CHECK_DELAY = 100;
+declare const DEFAULT_SCROLL_POSITION_KEY = "scrollable-container-position";
+/**
+ * Scrollable container with position persistence and scroll button state.
+ *
+ * @param scrollPositionKey - sessionStorage key for scroll position
+ */
+declare function useScrollableContainer(scrollPositionKey?: string): {
+    containerRef: Ref<HTMLElement | null>;
+    canScrollUp: boolean;
+    canScrollDown: boolean;
+    scrollUp: () => void;
+    scrollDown: () => void;
+    checkScrollability: () => void;
+    preserveScrollPosition: () => void;
+};
+
+export { DEFAULT_SCROLL_POSITION_KEY, SCROLL_AMOUNT, SCROLL_CHECK_DELAY, type UseInfiniteScrollOptions, type UsePullToRefreshOptions, type UsePullToRefreshReturn, useInfiniteScroll, useIsMobile, useLiveTimestamp, usePullToRefresh, useScrollableContainer };

package/dist/index.d.ts

@@ -0,0 +1,74 @@
+import * as react from 'react';
+import { Ref, RefObject } from 'react';
+
+declare function useIsMobile(): boolean;
+
+interface UseInfiniteScrollOptions {
+    /** Callback when intersection occurs */
+    onLoadMore: () => void;
+    /** Whether more data can be loaded */
+    hasNextPage: boolean;
+    /** Whether currently fetching */
+    isFetchingNextPage: boolean;
+    /** Root margin for intersection observer */
+    rootMargin?: string;
+    /** Threshold for intersection */
+    threshold?: number;
+    /** Enable/disable the hook */
+    enabled?: boolean;
+    /** Custom root element for IntersectionObserver (e.g., ScrollArea viewport) */
+    root?: HTMLElement | null;
+}
+/**
+ * Hook for implementing infinite scroll using IntersectionObserver.
+ */
+declare function useInfiniteScroll({ onLoadMore, hasNextPage, isFetchingNextPage, rootMargin, threshold, enabled, root, }: UseInfiniteScrollOptions): {
+    Sentinel: ({ className }: {
+        className?: string;
+    }) => react.JSX.Element;
+    sentinelRef: react.Dispatch<react.SetStateAction<HTMLDivElement | null>>;
+};
+
+interface UsePullToRefreshOptions {
+    onRefresh: () => Promise<void>;
+    threshold?: number;
+    resistance?: number;
+    disabled?: boolean;
+}
+interface UsePullToRefreshReturn {
+    pullDistance: number;
+    isRefreshing: boolean;
+    isPulling: boolean;
+    /** Callback ref — attach to the scrollable container element */
+    containerRef: Ref<HTMLDivElement | null>;
+    pullProgress: number;
+}
+/**
+ * Hook to add pull-to-refresh gesture for mobile devices.
+ */
+declare function usePullToRefresh({ onRefresh, threshold, resistance, disabled, }: UsePullToRefreshOptions): UsePullToRefreshReturn;
+
+/**
+ * Live-updating timestamp hook with visibility-aware adaptive intervals.
+ */
+declare function useLiveTimestamp(date: Date, elementRef?: RefObject<Element>): Date;
+
+declare const SCROLL_AMOUNT = 80;
+declare const SCROLL_CHECK_DELAY = 100;
+declare const DEFAULT_SCROLL_POSITION_KEY = "scrollable-container-position";
+/**
+ * Scrollable container with position persistence and scroll button state.
+ *
+ * @param scrollPositionKey - sessionStorage key for scroll position
+ */
+declare function useScrollableContainer(scrollPositionKey?: string): {
+    containerRef: Ref<HTMLElement | null>;
+    canScrollUp: boolean;
+    canScrollDown: boolean;
+    scrollUp: () => void;
+    scrollDown: () => void;
+    checkScrollability: () => void;
+    preserveScrollPosition: () => void;
+};
+
+export { DEFAULT_SCROLL_POSITION_KEY, SCROLL_AMOUNT, SCROLL_CHECK_DELAY, type UseInfiniteScrollOptions, type UsePullToRefreshOptions, type UsePullToRefreshReturn, useInfiniteScroll, useIsMobile, useLiveTimestamp, usePullToRefresh, useScrollableContainer };

package/dist/index.js

@@ -0,0 +1,412 @@
+import { useState, useEffect, useRef, useCallback, useMemo, useLayoutEffect } from 'react';
+import { jsx } from 'react/jsx-runtime';
+import { debounce } from '@publikit/utils';
+
+// use-mobile.tsx
+var MOBILE_BREAKPOINT = 768;
+var MOBILE_MEDIA_QUERY = `(max-width: ${MOBILE_BREAKPOINT - 1}px)`;
+function getIsMobile() {
+  if (typeof window === "undefined") return false;
+  return window.matchMedia(MOBILE_MEDIA_QUERY).matches;
+}
+function useIsMobile() {
+  const [isMobile, setIsMobile] = useState(getIsMobile);
+  useEffect(() => {
+    const mql = window.matchMedia(MOBILE_MEDIA_QUERY);
+    const onChange = () => setIsMobile(mql.matches);
+    mql.addEventListener("change", onChange);
+    return () => mql.removeEventListener("change", onChange);
+  }, []);
+  return isMobile;
+}
+function useInfiniteScroll({
+  onLoadMore,
+  hasNextPage,
+  isFetchingNextPage,
+  rootMargin = "200px",
+  threshold = 0,
+  enabled = true,
+  root
+}) {
+  const observerRef = useRef(null);
+  const [sentinelRef, setSentinelRef] = useState(null);
+  const handleIntersection = useCallback(
+    (entries) => {
+      const entry = entries[0];
+      if (!entry?.isIntersecting) return;
+      if (hasNextPage && !isFetchingNextPage && enabled) {
+        onLoadMore();
+      }
+    },
+    [onLoadMore, hasNextPage, isFetchingNextPage, enabled]
+  );
+  useEffect(() => {
+    if (!enabled) return;
+    if (observerRef.current) {
+      observerRef.current.disconnect();
+    }
+    observerRef.current = new IntersectionObserver(handleIntersection, {
+      root: root || null,
+      rootMargin,
+      threshold
+    });
+    if (sentinelRef) {
+      observerRef.current.observe(sentinelRef);
+    }
+    return () => {
+      if (observerRef.current) {
+        observerRef.current.disconnect();
+      }
+    };
+  }, [sentinelRef, handleIntersection, rootMargin, threshold, enabled, root]);
+  const Sentinel = useCallback(
+    ({ className }) => /* @__PURE__ */ jsx(
+      "div",
+      {
+        ref: setSentinelRef,
+        className,
+        "aria-hidden": "true",
+        style: { height: "1px" }
+      }
+    ),
+    []
+  );
+  return {
+    Sentinel,
+    sentinelRef: setSentinelRef
+  };
+}
+function usePullToRefresh({
+  onRefresh,
+  threshold = 80,
+  resistance = 2.5,
+  disabled = false
+}) {
+  const [pullDistance, setPullDistance] = useState(0);
+  const [isRefreshing, setIsRefreshing] = useState(false);
+  const [isPulling, setIsPulling] = useState(false);
+  const [containerElement, setContainerElement] = useState(null);
+  const containerRef = useRef(null);
+  const startYRef = useRef(null);
+  const currentYRef = useRef(null);
+  const pullDistanceRef = useRef(0);
+  pullDistanceRef.current = pullDistance;
+  const assignContainerRef = useCallback((node) => {
+    containerRef.current = node;
+    setContainerElement(node);
+  }, []);
+  const handleTouchStart = useCallback(
+    (e) => {
+      if (disabled || isRefreshing) return;
+      const container = containerRef.current;
+      if (!container) return;
+      if (container.scrollTop <= 0) {
+        startYRef.current = e.touches[0].clientY;
+        setIsPulling(true);
+      }
+    },
+    [disabled, isRefreshing]
+  );
+  const handleTouchMove = useCallback(
+    (e) => {
+      if (disabled || isRefreshing || startYRef.current === null) return;
+      const container = containerRef.current;
+      if (!container) return;
+      if (container.scrollTop > 0) {
+        startYRef.current = null;
+        setPullDistance(0);
+        setIsPulling(false);
+        return;
+      }
+      currentYRef.current = e.touches[0].clientY;
+      const diff = currentYRef.current - startYRef.current;
+      if (diff > 0) {
+        const distance = Math.min(diff / resistance, threshold * 1.5);
+        setPullDistance(distance);
+        if (distance > 5) {
+          e.preventDefault();
+        }
+      }
+    },
+    [disabled, isRefreshing, resistance, threshold]
+  );
+  const handleTouchEnd = useCallback(async () => {
+    if (disabled || isRefreshing) return;
+    startYRef.current = null;
+    currentYRef.current = null;
+    setIsPulling(false);
+    const distance = pullDistanceRef.current;
+    if (distance >= threshold) {
+      setIsRefreshing(true);
+      setPullDistance(threshold * 0.5);
+      try {
+        await onRefresh();
+      } finally {
+        setIsRefreshing(false);
+        setPullDistance(0);
+      }
+    } else {
+      setPullDistance(0);
+    }
+  }, [disabled, isRefreshing, threshold, onRefresh]);
+  useEffect(() => {
+    const container = containerElement;
+    if (!container) return;
+    container.addEventListener("touchstart", handleTouchStart, { passive: true });
+    container.addEventListener("touchmove", handleTouchMove, { passive: false });
+    container.addEventListener("touchend", handleTouchEnd, { passive: true });
+    return () => {
+      container.removeEventListener("touchstart", handleTouchStart);
+      container.removeEventListener("touchmove", handleTouchMove);
+      container.removeEventListener("touchend", handleTouchEnd);
+    };
+  }, [containerElement, handleTouchStart, handleTouchMove, handleTouchEnd]);
+  const pullProgress = Math.min(pullDistance / threshold, 1);
+  return {
+    pullDistance,
+    isRefreshing,
+    isPulling,
+    containerRef: assignContainerRef,
+    pullProgress
+  };
+}
+var globalNow = /* @__PURE__ */ new Date();
+var subscribers = /* @__PURE__ */ new Map();
+var visibilityMap = /* @__PURE__ */ new Map();
+var rafId = null;
+var intervalId = null;
+var isTabVisible = true;
+var pendingUpdate = false;
+function getUpdateInterval(date) {
+  const ageMs = Date.now() - date.getTime();
+  const ageMinutes = ageMs / 6e4;
+  if (ageMinutes < 1) return 1e4;
+  if (ageMinutes < 60) return 3e4;
+  if (ageMinutes < 1440) return 3e5;
+  return 36e5;
+}
+function getMinInterval() {
+  if (subscribers.size === 0) return 3e4;
+  const intervals = Array.from(subscribers.values()).map((sub) => getUpdateInterval(sub.date));
+  return Math.max(Math.min(...intervals), 1e4);
+}
+var createObserver = (subscriberId, callback) => {
+  return new IntersectionObserver(
+    (entries) => {
+      entries.forEach((entry) => {
+        visibilityMap.set(subscriberId, entry.isIntersecting);
+        if (entry.isIntersecting) {
+          callback();
+        }
+      });
+    },
+    {
+      root: null,
+      rootMargin: "50px",
+      threshold: 0.01
+    }
+  );
+};
+function updateVisibleSubscribers() {
+  if (!isTabVisible || subscribers.size === 0) {
+    pendingUpdate = false;
+    return;
+  }
+  globalNow = /* @__PURE__ */ new Date();
+  if (!pendingUpdate) {
+    pendingUpdate = true;
+    rafId = requestAnimationFrame(() => {
+      subscribers.forEach((subscriber, subscriberId) => {
+        const isVisible = visibilityMap.get(subscriberId) ?? true;
+        if (isVisible) {
+          subscriber.callback();
+        }
+      });
+      pendingUpdate = false;
+    });
+  }
+}
+function stopTimer() {
+  if (intervalId) {
+    clearTimeout(intervalId);
+    intervalId = null;
+  }
+  if (rafId) {
+    cancelAnimationFrame(rafId);
+    rafId = null;
+  }
+  pendingUpdate = false;
+}
+function scheduleNextTick() {
+  if (intervalId) {
+    clearTimeout(intervalId);
+    intervalId = null;
+  }
+  if (subscribers.size === 0 || !isTabVisible) {
+    return;
+  }
+  intervalId = setTimeout(() => {
+    updateVisibleSubscribers();
+    scheduleNextTick();
+  }, getMinInterval());
+}
+function ensureTimerRunning() {
+  if (!intervalId && subscribers.size > 0 && isTabVisible) {
+    scheduleNextTick();
+  }
+}
+function restartTimer() {
+  stopTimer();
+  ensureTimerRunning();
+}
+if (typeof window !== "undefined") {
+  document.addEventListener("visibilitychange", () => {
+    isTabVisible = !document.hidden;
+    if (isTabVisible && subscribers.size > 0) {
+      updateVisibleSubscribers();
+      ensureTimerRunning();
+    } else if (!isTabVisible) {
+      stopTimer();
+    }
+  });
+}
+function useLiveTimestamp(date, elementRef) {
+  const [, setTick] = useState(0);
+  const subscriberIdRef = useRef(/* @__PURE__ */ Symbol("live-timestamp-subscriber"));
+  useEffect(() => {
+    const subscriberId = subscriberIdRef.current;
+    const callback = () => {
+      const isVisible = visibilityMap.get(subscriberId) ?? true;
+      if (isVisible) {
+        setTick((t) => t + 1);
+      }
+    };
+    let observer = null;
+    if (elementRef?.current) {
+      observer = createObserver(subscriberId, callback);
+      observer.observe(elementRef.current);
+      visibilityMap.set(subscriberId, false);
+    } else {
+      visibilityMap.set(subscriberId, true);
+    }
+    subscribers.set(subscriberId, {
+      callback,
+      date,
+      observer
+    });
+    ensureTimerRunning();
+    return () => {
+      const subscriber = subscribers.get(subscriberId);
+      if (subscriber?.observer) {
+        subscriber.observer.disconnect();
+      }
+      subscribers.delete(subscriberId);
+      visibilityMap.delete(subscriberId);
+      if (subscribers.size === 0) {
+        stopTimer();
+      } else {
+        restartTimer();
+      }
+    };
+  }, [date.getTime(), elementRef]);
+  return globalNow;
+}
+var SCROLL_AMOUNT = 80;
+var SCROLL_CHECK_DELAY = 100;
+var DEFAULT_SCROLL_POSITION_KEY = "scrollable-container-position";
+var STORAGE_DEBOUNCE_MS = 150;
+function useScrollableContainer(scrollPositionKey = DEFAULT_SCROLL_POSITION_KEY) {
+  const containerRef = useRef(null);
+  const [containerElement, setContainerElement] = useState(null);
+  const isRestoringRef = useRef(false);
+  const [canScrollUp, setCanScrollUp] = useState(false);
+  const [canScrollDown, setCanScrollDown] = useState(false);
+  const assignContainerRef = useCallback((node) => {
+    containerRef.current = node;
+    setContainerElement(node);
+  }, []);
+  const saveToStorage = useMemo(
+    () => debounce((position) => {
+      try {
+        sessionStorage.setItem(scrollPositionKey, String(position));
+      } catch {
+      }
+    }, STORAGE_DEBOUNCE_MS),
+    [scrollPositionKey]
+  );
+  const checkScrollability = useCallback(() => {
+    if (!containerRef.current || isRestoringRef.current) return;
+    const { scrollTop, scrollHeight, clientHeight } = containerRef.current;
+    saveToStorage(scrollTop);
+    setCanScrollUp(scrollTop > 0);
+    setCanScrollDown(scrollTop < scrollHeight - clientHeight - 1);
+  }, [saveToStorage]);
+  useLayoutEffect(() => {
+    if (!containerElement || isRestoringRef.current) return;
+    try {
+      const savedPosition = sessionStorage.getItem(scrollPositionKey);
+      if (savedPosition !== null) {
+        const position = parseInt(savedPosition, 10);
+        const currentPosition = containerElement.scrollTop;
+        if (position > 0 && !isNaN(position) && Math.abs(currentPosition - position) > 1) {
+          isRestoringRef.current = true;
+          containerElement.scrollTop = position;
+          requestAnimationFrame(() => {
+            isRestoringRef.current = false;
+            checkScrollability();
+          });
+        }
+      }
+    } catch {
+    }
+  }, [containerElement, scrollPositionKey, checkScrollability]);
+  const preserveScrollPosition = useCallback(() => {
+    if (containerRef.current) {
+      try {
+        sessionStorage.setItem(scrollPositionKey, String(containerRef.current.scrollTop));
+      } catch {
+      }
+    }
+  }, [scrollPositionKey]);
+  useEffect(() => {
+    return () => {
+      saveToStorage.cancel();
+    };
+  }, [saveToStorage]);
+  useEffect(() => {
+    if (!containerElement) return;
+    const timeoutId = setTimeout(checkScrollability, SCROLL_CHECK_DELAY);
+    const handleScroll = () => {
+      checkScrollability();
+    };
+    containerElement.addEventListener("scroll", handleScroll, { passive: true });
+    window.addEventListener("resize", checkScrollability);
+    const resizeObserver = new ResizeObserver(checkScrollability);
+    resizeObserver.observe(containerElement);
+    return () => {
+      clearTimeout(timeoutId);
+      containerElement.removeEventListener("scroll", handleScroll);
+      window.removeEventListener("resize", checkScrollability);
+      resizeObserver.disconnect();
+    };
+  }, [containerElement, checkScrollability]);
+  const scrollUp = useCallback(() => {
+    containerRef.current?.scrollBy({ top: -SCROLL_AMOUNT, behavior: "smooth" });
+  }, []);
+  const scrollDown = useCallback(() => {
+    containerRef.current?.scrollBy({ top: SCROLL_AMOUNT, behavior: "smooth" });
+  }, []);
+  return {
+    containerRef: assignContainerRef,
+    canScrollUp,
+    canScrollDown,
+    scrollUp,
+    scrollDown,
+    checkScrollability,
+    preserveScrollPosition
+  };
+}
+
+export { DEFAULT_SCROLL_POSITION_KEY, SCROLL_AMOUNT, SCROLL_CHECK_DELAY, useInfiniteScroll, useIsMobile, useLiveTimestamp, usePullToRefresh, useScrollableContainer };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../use-mobile.tsx","../use-infinite-scroll.tsx","../use-pull-to-refresh.ts","../use-live-timestamp.ts","../use-scrollable-container.ts"],"names":["useState","useEffect","useRef","useCallback"],"mappings":"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","file":"index.js","sourcesContent":["import { useEffect, useState } from 'react';\r\n\r\nconst MOBILE_BREAKPOINT = 768;\r\nconst MOBILE_MEDIA_QUERY = `(max-width: ${MOBILE_BREAKPOINT - 1}px)` as const;\r\n\r\nfunction getIsMobile(): boolean {\r\n  if (typeof window === 'undefined') return false;\r\n  return window.matchMedia(MOBILE_MEDIA_QUERY).matches;\r\n}\r\n\r\nexport function useIsMobile(): boolean {\r\n  const [isMobile, setIsMobile] = useState<boolean>(getIsMobile);\r\n\r\n  useEffect(() => {\r\n    const mql = window.matchMedia(MOBILE_MEDIA_QUERY);\r\n    const onChange = () => setIsMobile(mql.matches);\r\n    mql.addEventListener('change', onChange);\r\n    return () => mql.removeEventListener('change', onChange);\r\n  }, []);\r\n\r\n  return isMobile;\r\n}\r\n","import { useEffect, useRef, useCallback, useState } from 'react';\r\n\r\nexport interface UseInfiniteScrollOptions {\r\n  /** Callback when intersection occurs */\r\n  onLoadMore: () => void;\r\n  /** Whether more data can be loaded */\r\n  hasNextPage: boolean;\r\n  /** Whether currently fetching */\r\n  isFetchingNextPage: boolean;\r\n  /** Root margin for intersection observer */\r\n  rootMargin?: string;\r\n  /** Threshold for intersection */\r\n  threshold?: number;\r\n  /** Enable/disable the hook */\r\n  enabled?: boolean;\r\n  /** Custom root element for IntersectionObserver (e.g., ScrollArea viewport) */\r\n  root?: HTMLElement | null;\r\n}\r\n\r\n/**\r\n * Hook for implementing infinite scroll using IntersectionObserver.\r\n */\r\nexport function useInfiniteScroll({\r\n  onLoadMore,\r\n  hasNextPage,\r\n  isFetchingNextPage,\r\n  rootMargin = '200px',\r\n  threshold = 0,\r\n  enabled = true,\r\n  root,\r\n}: UseInfiniteScrollOptions) {\r\n  const observerRef = useRef<IntersectionObserver | null>(null);\r\n  const [sentinelRef, setSentinelRef] = useState<HTMLDivElement | null>(null);\r\n\r\n  const handleIntersection = useCallback(\r\n    (entries: IntersectionObserverEntry[]) => {\r\n      const entry = entries[0];\r\n      if (!entry?.isIntersecting) return;\r\n      if (hasNextPage && !isFetchingNextPage && enabled) {\r\n        onLoadMore();\r\n      }\r\n    },\r\n    [onLoadMore, hasNextPage, isFetchingNextPage, enabled]\r\n  );\r\n\r\n  useEffect(() => {\r\n    if (!enabled) return;\r\n\r\n    if (observerRef.current) {\r\n      observerRef.current.disconnect();\r\n    }\r\n\r\n    observerRef.current = new IntersectionObserver(handleIntersection, {\r\n      root: root || null,\r\n      rootMargin,\r\n      threshold,\r\n    });\r\n\r\n    if (sentinelRef) {\r\n      observerRef.current.observe(sentinelRef);\r\n    }\r\n\r\n    return () => {\r\n      if (observerRef.current) {\r\n        observerRef.current.disconnect();\r\n      }\r\n    };\r\n  }, [sentinelRef, handleIntersection, rootMargin, threshold, enabled, root]);\r\n\r\n  const Sentinel = useCallback(\r\n    ({ className }: { className?: string }) => (\r\n      <div\r\n        ref={setSentinelRef}\r\n        className={className}\r\n        aria-hidden=\"true\"\r\n        style={{ height: '1px' }}\r\n      />\r\n    ),\r\n    []\r\n  );\r\n\r\n  return {\r\n    Sentinel,\r\n    sentinelRef: setSentinelRef,\r\n  };\r\n}\r\n","import { useState, useEffect, useRef, useCallback, type Ref } from 'react';\r\n\r\nexport interface UsePullToRefreshOptions {\r\n  onRefresh: () => Promise<void>;\r\n  threshold?: number;\r\n  resistance?: number;\r\n  disabled?: boolean;\r\n}\r\n\r\nexport interface UsePullToRefreshReturn {\r\n  pullDistance: number;\r\n  isRefreshing: boolean;\r\n  isPulling: boolean;\r\n  /** Callback ref — attach to the scrollable container element */\r\n  containerRef: Ref<HTMLDivElement | null>;\r\n  pullProgress: number;\r\n}\r\n\r\n/**\r\n * Hook to add pull-to-refresh gesture for mobile devices.\r\n */\r\nexport function usePullToRefresh({\r\n  onRefresh,\r\n  threshold = 80,\r\n  resistance = 2.5,\r\n  disabled = false,\r\n}: UsePullToRefreshOptions): UsePullToRefreshReturn {\r\n  const [pullDistance, setPullDistance] = useState(0);\r\n  const [isRefreshing, setIsRefreshing] = useState(false);\r\n  const [isPulling, setIsPulling] = useState(false);\r\n  const [containerElement, setContainerElement] = useState<HTMLDivElement | null>(null);\r\n\r\n  const containerRef = useRef<HTMLDivElement | null>(null);\r\n  const startYRef = useRef<number | null>(null);\r\n  const currentYRef = useRef<number | null>(null);\r\n  const pullDistanceRef = useRef(0);\r\n\r\n  pullDistanceRef.current = pullDistance;\r\n\r\n  const assignContainerRef = useCallback((node: HTMLDivElement | null) => {\r\n    containerRef.current = node;\r\n    setContainerElement(node);\r\n  }, []);\r\n\r\n  const handleTouchStart = useCallback(\r\n    (e: TouchEvent) => {\r\n      if (disabled || isRefreshing) return;\r\n\r\n      const container = containerRef.current;\r\n      if (!container) return;\r\n\r\n      if (container.scrollTop <= 0) {\r\n        startYRef.current = e.touches[0].clientY;\r\n        setIsPulling(true);\r\n      }\r\n    },\r\n    [disabled, isRefreshing]\r\n  );\r\n\r\n  const handleTouchMove = useCallback(\r\n    (e: TouchEvent) => {\r\n      if (disabled || isRefreshing || startYRef.current === null) return;\r\n\r\n      const container = containerRef.current;\r\n      if (!container) return;\r\n\r\n      if (container.scrollTop > 0) {\r\n        startYRef.current = null;\r\n        setPullDistance(0);\r\n        setIsPulling(false);\r\n        return;\r\n      }\r\n\r\n      currentYRef.current = e.touches[0].clientY;\r\n      const diff = currentYRef.current - startYRef.current;\r\n\r\n      if (diff > 0) {\r\n        const distance = Math.min(diff / resistance, threshold * 1.5);\r\n        setPullDistance(distance);\r\n\r\n        if (distance > 5) {\r\n          e.preventDefault();\r\n        }\r\n      }\r\n    },\r\n    [disabled, isRefreshing, resistance, threshold]\r\n  );\r\n\r\n  const handleTouchEnd = useCallback(async () => {\r\n    if (disabled || isRefreshing) return;\r\n\r\n    startYRef.current = null;\r\n    currentYRef.current = null;\r\n    setIsPulling(false);\r\n\r\n    const distance = pullDistanceRef.current;\r\n\r\n    if (distance >= threshold) {\r\n      setIsRefreshing(true);\r\n      setPullDistance(threshold * 0.5);\r\n\r\n      try {\r\n        await onRefresh();\r\n      } finally {\r\n        setIsRefreshing(false);\r\n        setPullDistance(0);\r\n      }\r\n    } else {\r\n      setPullDistance(0);\r\n    }\r\n  }, [disabled, isRefreshing, threshold, onRefresh]);\r\n\r\n  useEffect(() => {\r\n    const container = containerElement;\r\n    if (!container) return;\r\n\r\n    container.addEventListener('touchstart', handleTouchStart, { passive: true });\r\n    container.addEventListener('touchmove', handleTouchMove, { passive: false });\r\n    container.addEventListener('touchend', handleTouchEnd, { passive: true });\r\n\r\n    return () => {\r\n      container.removeEventListener('touchstart', handleTouchStart);\r\n      container.removeEventListener('touchmove', handleTouchMove);\r\n      container.removeEventListener('touchend', handleTouchEnd);\r\n    };\r\n  }, [containerElement, handleTouchStart, handleTouchMove, handleTouchEnd]);\r\n\r\n  const pullProgress = Math.min(pullDistance / threshold, 1);\r\n\r\n  return {\r\n    pullDistance,\r\n    isRefreshing,\r\n    isPulling,\r\n    containerRef: assignContainerRef,\r\n    pullProgress,\r\n  };\r\n}\r\n","import { useState, useEffect, useRef, type RefObject } from 'react';\r\n\r\nlet globalNow = new Date();\r\n\r\ntype SubscriberId = symbol;\r\n\r\ntype Subscriber = {\r\n  callback: () => void;\r\n  date: Date;\r\n  observer: IntersectionObserver | null;\r\n};\r\n\r\nconst subscribers = new Map<SubscriberId, Subscriber>();\r\nconst visibilityMap = new Map<SubscriberId, boolean>();\r\n\r\nlet rafId: number | null = null;\r\nlet intervalId: ReturnType<typeof setTimeout> | null = null;\r\nlet isTabVisible = true;\r\nlet pendingUpdate = false;\r\n\r\nfunction getUpdateInterval(date: Date): number {\r\n  const ageMs = Date.now() - date.getTime();\r\n  const ageMinutes = ageMs / 60000;\r\n\r\n  if (ageMinutes < 1) return 10000;\r\n  if (ageMinutes < 60) return 30000;\r\n  if (ageMinutes < 1440) return 300000;\r\n  return 3600000;\r\n}\r\n\r\nfunction getMinInterval(): number {\r\n  if (subscribers.size === 0) return 30000;\r\n  const intervals = Array.from(subscribers.values()).map((sub) => getUpdateInterval(sub.date));\r\n  return Math.max(Math.min(...intervals), 10000);\r\n}\r\n\r\nconst createObserver = (\r\n  subscriberId: SubscriberId,\r\n  callback: () => void\r\n): IntersectionObserver => {\r\n  return new IntersectionObserver(\r\n    (entries) => {\r\n      entries.forEach((entry) => {\r\n        visibilityMap.set(subscriberId, entry.isIntersecting);\r\n        if (entry.isIntersecting) {\r\n          callback();\r\n        }\r\n      });\r\n    },\r\n    {\r\n      root: null,\r\n      rootMargin: '50px',\r\n      threshold: 0.01,\r\n    }\r\n  );\r\n};\r\n\r\nfunction updateVisibleSubscribers() {\r\n  if (!isTabVisible || subscribers.size === 0) {\r\n    pendingUpdate = false;\r\n    return;\r\n  }\r\n\r\n  globalNow = new Date();\r\n\r\n  if (!pendingUpdate) {\r\n    pendingUpdate = true;\r\n    rafId = requestAnimationFrame(() => {\r\n      subscribers.forEach((subscriber, subscriberId) => {\r\n        const isVisible = visibilityMap.get(subscriberId) ?? true;\r\n        if (isVisible) {\r\n          subscriber.callback();\r\n        }\r\n      });\r\n      pendingUpdate = false;\r\n    });\r\n  }\r\n}\r\n\r\nfunction stopTimer() {\r\n  if (intervalId) {\r\n    clearTimeout(intervalId);\r\n    intervalId = null;\r\n  }\r\n  if (rafId) {\r\n    cancelAnimationFrame(rafId);\r\n    rafId = null;\r\n  }\r\n  pendingUpdate = false;\r\n}\r\n\r\nfunction scheduleNextTick() {\r\n  if (intervalId) {\r\n    clearTimeout(intervalId);\r\n    intervalId = null;\r\n  }\r\n\r\n  if (subscribers.size === 0 || !isTabVisible) {\r\n    return;\r\n  }\r\n\r\n  intervalId = setTimeout(() => {\r\n    updateVisibleSubscribers();\r\n    scheduleNextTick();\r\n  }, getMinInterval());\r\n}\r\n\r\nfunction ensureTimerRunning() {\r\n  if (!intervalId && subscribers.size > 0 && isTabVisible) {\r\n    scheduleNextTick();\r\n  }\r\n}\r\n\r\nfunction restartTimer() {\r\n  stopTimer();\r\n  ensureTimerRunning();\r\n}\r\n\r\nif (typeof window !== 'undefined') {\r\n  document.addEventListener('visibilitychange', () => {\r\n    isTabVisible = !document.hidden;\r\n    if (isTabVisible && subscribers.size > 0) {\r\n      updateVisibleSubscribers();\r\n      ensureTimerRunning();\r\n    } else if (!isTabVisible) {\r\n      stopTimer();\r\n    }\r\n  });\r\n}\r\n\r\n/**\r\n * Live-updating timestamp hook with visibility-aware adaptive intervals.\r\n */\r\nexport function useLiveTimestamp(date: Date, elementRef?: RefObject<Element>): Date {\r\n  const [, setTick] = useState(0);\r\n  const subscriberIdRef = useRef<SubscriberId>(Symbol('live-timestamp-subscriber'));\r\n\r\n  useEffect(() => {\r\n    const subscriberId = subscriberIdRef.current;\r\n\r\n    const callback = () => {\r\n      const isVisible = visibilityMap.get(subscriberId) ?? true;\r\n      if (isVisible) {\r\n        setTick((t) => t + 1);\r\n      }\r\n    };\r\n\r\n    let observer: IntersectionObserver | null = null;\r\n    if (elementRef?.current) {\r\n      observer = createObserver(subscriberId, callback);\r\n      observer.observe(elementRef.current);\r\n      visibilityMap.set(subscriberId, false);\r\n    } else {\r\n      visibilityMap.set(subscriberId, true);\r\n    }\r\n\r\n    subscribers.set(subscriberId, {\r\n      callback,\r\n      date,\r\n      observer,\r\n    });\r\n\r\n    ensureTimerRunning();\r\n\r\n    return () => {\r\n      const subscriber = subscribers.get(subscriberId);\r\n      if (subscriber?.observer) {\r\n        subscriber.observer.disconnect();\r\n      }\r\n      subscribers.delete(subscriberId);\r\n      visibilityMap.delete(subscriberId);\r\n\r\n      if (subscribers.size === 0) {\r\n        stopTimer();\r\n      } else {\r\n        restartTimer();\r\n      }\r\n    };\r\n    // Key on the timestamp value, not the Date identity, so callers passing a\r\n    // freshly constructed Date each render don't trigger a re-subscribe.\r\n  }, [date.getTime(), elementRef]);\r\n\r\n  return globalNow;\r\n}\r\n","import { useRef, useEffect, useLayoutEffect, useState, useCallback, useMemo, type Ref } from 'react';\r\nimport { debounce } from '@publikit/utils';\r\n\r\nexport const SCROLL_AMOUNT = 80;\r\nexport const SCROLL_CHECK_DELAY = 100;\r\nexport const DEFAULT_SCROLL_POSITION_KEY = 'scrollable-container-position';\r\nconst STORAGE_DEBOUNCE_MS = 150;\r\n\r\n/**\r\n * Scrollable container with position persistence and scroll button state.\r\n *\r\n * @param scrollPositionKey - sessionStorage key for scroll position\r\n */\r\nexport function useScrollableContainer(\r\n  scrollPositionKey: string = DEFAULT_SCROLL_POSITION_KEY\r\n) {\r\n  const containerRef = useRef<HTMLElement | null>(null);\r\n  const [containerElement, setContainerElement] = useState<HTMLElement | null>(null);\r\n  const isRestoringRef = useRef<boolean>(false);\r\n  const [canScrollUp, setCanScrollUp] = useState(false);\r\n  const [canScrollDown, setCanScrollDown] = useState(false);\r\n\r\n  const assignContainerRef = useCallback((node: HTMLElement | null) => {\r\n    containerRef.current = node;\r\n    setContainerElement(node);\r\n  }, []);\r\n\r\n  const saveToStorage = useMemo(\r\n    () =>\r\n      debounce((position: number) => {\r\n        try {\r\n          sessionStorage.setItem(scrollPositionKey, String(position));\r\n        } catch {\r\n          // Ignore storage errors\r\n        }\r\n      }, STORAGE_DEBOUNCE_MS),\r\n    [scrollPositionKey]\r\n  );\r\n\r\n  const checkScrollability = useCallback(() => {\r\n    if (!containerRef.current || isRestoringRef.current) return;\r\n    const { scrollTop, scrollHeight, clientHeight } = containerRef.current;\r\n\r\n    saveToStorage(scrollTop);\r\n\r\n    setCanScrollUp(scrollTop > 0);\r\n    setCanScrollDown(scrollTop < scrollHeight - clientHeight - 1);\r\n  }, [saveToStorage]);\r\n\r\n  useLayoutEffect(() => {\r\n    if (!containerElement || isRestoringRef.current) return;\r\n\r\n    try {\r\n      const savedPosition = sessionStorage.getItem(scrollPositionKey);\r\n      if (savedPosition !== null) {\r\n        const position = parseInt(savedPosition, 10);\r\n        const currentPosition = containerElement.scrollTop;\r\n\r\n        if (position > 0 && !isNaN(position) && Math.abs(currentPosition - position) > 1) {\r\n          isRestoringRef.current = true;\r\n          containerElement.scrollTop = position;\r\n          requestAnimationFrame(() => {\r\n            isRestoringRef.current = false;\r\n            checkScrollability();\r\n          });\r\n        }\r\n      }\r\n    } catch {\r\n      // Ignore storage errors\r\n    }\r\n  }, [containerElement, scrollPositionKey, checkScrollability]);\r\n\r\n  const preserveScrollPosition = useCallback(() => {\r\n    if (containerRef.current) {\r\n      try {\r\n        sessionStorage.setItem(scrollPositionKey, String(containerRef.current.scrollTop));\r\n      } catch {\r\n        // Ignore storage errors\r\n      }\r\n    }\r\n  }, [scrollPositionKey]);\r\n\r\n  useEffect(() => {\r\n    return () => {\r\n      saveToStorage.cancel();\r\n    };\r\n  }, [saveToStorage]);\r\n\r\n  useEffect(() => {\r\n    if (!containerElement) return;\r\n\r\n    const timeoutId = setTimeout(checkScrollability, SCROLL_CHECK_DELAY);\r\n\r\n    const handleScroll = () => {\r\n      checkScrollability();\r\n    };\r\n\r\n    containerElement.addEventListener('scroll', handleScroll, { passive: true });\r\n    window.addEventListener('resize', checkScrollability);\r\n\r\n    const resizeObserver = new ResizeObserver(checkScrollability);\r\n    resizeObserver.observe(containerElement);\r\n\r\n    return () => {\r\n      clearTimeout(timeoutId);\r\n      containerElement.removeEventListener('scroll', handleScroll);\r\n      window.removeEventListener('resize', checkScrollability);\r\n      resizeObserver.disconnect();\r\n    };\r\n  }, [containerElement, checkScrollability]);\r\n\r\n  const scrollUp = useCallback(() => {\r\n    containerRef.current?.scrollBy({ top: -SCROLL_AMOUNT, behavior: 'smooth' });\r\n  }, []);\r\n\r\n  const scrollDown = useCallback(() => {\r\n    containerRef.current?.scrollBy({ top: SCROLL_AMOUNT, behavior: 'smooth' });\r\n  }, []);\r\n\r\n  return {\r\n    containerRef: assignContainerRef as Ref<HTMLElement | null>,\r\n    canScrollUp,\r\n    canScrollDown,\r\n    scrollUp,\r\n    scrollDown,\r\n    checkScrollability,\r\n    preserveScrollPosition,\r\n  };\r\n}\r\n"]}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@publikit/hooks",
+  "version": "0.1.1",
+  "description": "Generic, reusable React hooks for Publikit packages and applications",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rimraf dist",
+    "prepublishOnly": "npm run clean && npm run build",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "keywords": [
+    "react",
+    "hooks",
+    "infinite-scroll",
+    "pull-to-refresh",
+    "publikit"
+  ],
+  "author": "Pirimera",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pirimera/publikit.git",
+    "directory": "hooks"
+  },
+  "homepage": "https://github.com/pirimera/publikit/tree/main/hooks#readme",
+  "bugs": {
+    "url": "https://github.com/pirimera/publikit/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "@publikit/utils": "^0.1.1"
+  },
+  "devDependencies": {
+    "@publikit/utils": "file:../utils",
+    "@testing-library/react": "^16.3.0",
+    "@types/react": "^18.3.23 || ^19.0.0",
+    "@types/react-dom": "^18.3.7 || ^19.0.0",
+    "jsdom": "^26.1.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "rimraf": "^5.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.8.3",
+    "vitest": "^4.0.18"
+  }
+}