@publikit/hooks 0.1.1 → 1.0.0

package/dist/use-scrollable-container.js

@@ -0,0 +1,144 @@
+import { useRef, useState, useMemo, useCallback, useLayoutEffect, useEffect } from 'react';
+import { debounce } from '@publikit/utils';
+
+// use-scrollable-container.ts
+var SCROLL_AMOUNT = 80;
+var SCROLL_CHECK_DELAY = 100;
+var DEFAULT_SCROLL_POSITION_KEY = "scrollable-container-position";
+var STORAGE_DEBOUNCE_MS = 150;
+function resolveStorage(storage) {
+  if (storage === false) return null;
+  if (storage) return storage;
+  if (typeof sessionStorage === "undefined") return null;
+  return sessionStorage;
+}
+function getScrollPosition(element, axis) {
+  return axis === "x" ? element.scrollLeft : element.scrollTop;
+}
+function setScrollPosition(element, axis, position) {
+  if (axis === "x") {
+    element.scrollLeft = position;
+  } else {
+    element.scrollTop = position;
+  }
+}
+function getScrollSize(element, axis) {
+  return axis === "x" ? element.scrollWidth : element.scrollHeight;
+}
+function getClientSize(element, axis) {
+  return axis === "x" ? element.clientWidth : element.clientHeight;
+}
+function useScrollableContainer({
+  scrollPositionKey,
+  axis = "y",
+  scrollAmount = SCROLL_AMOUNT,
+  checkDelay = SCROLL_CHECK_DELAY,
+  storage
+}) {
+  const containerRef = useRef(null);
+  const [containerElement, setContainerElement] = useState(null);
+  const isRestoringRef = useRef(false);
+  const [canScrollBackward, setCanScrollBackward] = useState(false);
+  const [canScrollForward, setCanScrollForward] = useState(false);
+  const storageAdapter = useMemo(() => resolveStorage(storage), [storage]);
+  const assignContainerRef = useCallback((node) => {
+    containerRef.current = node;
+    setContainerElement(node);
+  }, []);
+  const saveToStorage = useMemo(
+    () => debounce((position) => {
+      if (!storageAdapter) return;
+      try {
+        storageAdapter.setItem(scrollPositionKey, String(position));
+      } catch {
+      }
+    }, STORAGE_DEBOUNCE_MS),
+    [scrollPositionKey, storageAdapter]
+  );
+  const checkScrollability = useCallback(() => {
+    if (!containerRef.current || isRestoringRef.current) return;
+    const scrollPosition = getScrollPosition(containerRef.current, axis);
+    const scrollSize = getScrollSize(containerRef.current, axis);
+    const clientSize = getClientSize(containerRef.current, axis);
+    saveToStorage(scrollPosition);
+    setCanScrollBackward(scrollPosition > 0);
+    setCanScrollForward(scrollPosition < scrollSize - clientSize - 1);
+  }, [axis, saveToStorage]);
+  useLayoutEffect(() => {
+    if (!containerElement || isRestoringRef.current) return;
+    if (!storageAdapter) return;
+    try {
+      const savedPosition = storageAdapter.getItem(scrollPositionKey);
+      if (savedPosition !== null) {
+        const position = parseInt(savedPosition, 10);
+        const currentPosition = getScrollPosition(containerElement, axis);
+        if (position > 0 && !isNaN(position) && Math.abs(currentPosition - position) > 1) {
+          isRestoringRef.current = true;
+          setScrollPosition(containerElement, axis, position);
+          requestAnimationFrame(() => {
+            isRestoringRef.current = false;
+            checkScrollability();
+          });
+        }
+      }
+    } catch {
+    }
+  }, [axis, containerElement, scrollPositionKey, checkScrollability, storageAdapter]);
+  const preserveScrollPosition = useCallback(() => {
+    if (containerRef.current && storageAdapter) {
+      try {
+        storageAdapter.setItem(
+          scrollPositionKey,
+          String(getScrollPosition(containerRef.current, axis))
+        );
+      } catch {
+      }
+    }
+  }, [axis, scrollPositionKey, storageAdapter]);
+  useEffect(() => {
+    return () => {
+      saveToStorage.cancel();
+    };
+  }, [saveToStorage]);
+  useEffect(() => {
+    if (!containerElement) return;
+    const timeoutId = setTimeout(checkScrollability, checkDelay);
+    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();
+    };
+  }, [checkDelay, containerElement, checkScrollability]);
+  const scrollBackward = useCallback(() => {
+    const delta = -scrollAmount;
+    containerRef.current?.scrollBy(
+      axis === "x" ? { left: delta, behavior: "smooth" } : { top: delta, behavior: "smooth" }
+    );
+  }, [axis, scrollAmount]);
+  const scrollForward = useCallback(() => {
+    containerRef.current?.scrollBy(
+      axis === "x" ? { left: scrollAmount, behavior: "smooth" } : { top: scrollAmount, behavior: "smooth" }
+    );
+  }, [axis, scrollAmount]);
+  return {
+    containerRef: assignContainerRef,
+    canScrollBackward,
+    canScrollForward,
+    scrollBackward,
+    scrollForward,
+    checkScrollability,
+    preserveScrollPosition
+  };
+}
+
+export { DEFAULT_SCROLL_POSITION_KEY, SCROLL_AMOUNT, SCROLL_CHECK_DELAY, useScrollableContainer };
+//# sourceMappingURL=use-scrollable-container.js.map
+//# sourceMappingURL=use-scrollable-container.js.map

package/dist/use-scrollable-container.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../use-scrollable-container.ts"],"names":[],"mappings":"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","file":"use-scrollable-container.js","sourcesContent":["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\nexport type ScrollAxis = 'x' | 'y';\r\n\r\nexport interface ScrollStorageAdapter {\r\n  getItem(key: string): string | null;\r\n  setItem(key: string, value: string): void;\r\n}\r\n\r\nexport interface UseScrollableContainerOptions {\r\n  /** Session/storage key used to persist scroll position. */\r\n  scrollPositionKey: string;\r\n  /** Axis to measure and scroll. */\r\n  axis?: ScrollAxis;\r\n  /** Distance used by scroll helpers. */\r\n  scrollAmount?: number;\r\n  /** Delay before initial scrollability check. */\r\n  checkDelay?: number;\r\n  /** Optional storage adapter. Pass `false` to disable persistence. */\r\n  storage?: ScrollStorageAdapter | false;\r\n}\r\n\r\nexport interface UseScrollableContainerReturn {\r\n  /** Callback ref — attach to the scrollable element. */\r\n  containerRef: Ref<HTMLElement | null>;\r\n  canScrollBackward: boolean;\r\n  canScrollForward: boolean;\r\n  scrollBackward: () => void;\r\n  scrollForward: () => void;\r\n  checkScrollability: () => void;\r\n  preserveScrollPosition: () => void;\r\n}\r\n\r\nfunction resolveStorage(\r\n  storage: ScrollStorageAdapter | false | undefined,\r\n): ScrollStorageAdapter | null {\r\n  if (storage === false) return null;\r\n  if (storage) return storage;\r\n  if (typeof sessionStorage === 'undefined') return null;\r\n  return sessionStorage;\r\n}\r\n\r\nfunction getScrollPosition(element: HTMLElement, axis: ScrollAxis): number {\r\n  return axis === 'x' ? element.scrollLeft : element.scrollTop;\r\n}\r\n\r\nfunction setScrollPosition(element: HTMLElement, axis: ScrollAxis, position: number): void {\r\n  if (axis === 'x') {\r\n    element.scrollLeft = position;\r\n  } else {\r\n    element.scrollTop = position;\r\n  }\r\n}\r\n\r\nfunction getScrollSize(element: HTMLElement, axis: ScrollAxis): number {\r\n  return axis === 'x' ? element.scrollWidth : element.scrollHeight;\r\n}\r\n\r\nfunction getClientSize(element: HTMLElement, axis: ScrollAxis): number {\r\n  return axis === 'x' ? element.clientWidth : element.clientHeight;\r\n}\r\n\r\n/**\r\n * Scrollable container with position persistence and scroll button state.\r\n */\r\nexport function useScrollableContainer(\r\n  {\r\n    scrollPositionKey,\r\n    axis = 'y',\r\n    scrollAmount = SCROLL_AMOUNT,\r\n    checkDelay = SCROLL_CHECK_DELAY,\r\n    storage,\r\n  }: UseScrollableContainerOptions,\r\n): UseScrollableContainerReturn {\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 [canScrollBackward, setCanScrollBackward] = useState(false);\r\n  const [canScrollForward, setCanScrollForward] = useState(false);\r\n  const storageAdapter = useMemo(() => resolveStorage(storage), [storage]);\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        if (!storageAdapter) return;\r\n        try {\r\n          storageAdapter.setItem(scrollPositionKey, String(position));\r\n        } catch {\r\n          // Ignore storage errors\r\n        }\r\n      }, STORAGE_DEBOUNCE_MS),\r\n    [scrollPositionKey, storageAdapter]\r\n  );\r\n\r\n  const checkScrollability = useCallback(() => {\r\n    if (!containerRef.current || isRestoringRef.current) return;\r\n    const scrollPosition = getScrollPosition(containerRef.current, axis);\r\n    const scrollSize = getScrollSize(containerRef.current, axis);\r\n    const clientSize = getClientSize(containerRef.current, axis);\r\n\r\n    saveToStorage(scrollPosition);\r\n\r\n    setCanScrollBackward(scrollPosition > 0);\r\n    setCanScrollForward(scrollPosition < scrollSize - clientSize - 1);\r\n  }, [axis, saveToStorage]);\r\n\r\n  useLayoutEffect(() => {\r\n    if (!containerElement || isRestoringRef.current) return;\r\n    if (!storageAdapter) return;\r\n\r\n    try {\r\n      const savedPosition = storageAdapter.getItem(scrollPositionKey);\r\n      if (savedPosition !== null) {\r\n        const position = parseInt(savedPosition, 10);\r\n        const currentPosition = getScrollPosition(containerElement, axis);\r\n\r\n        if (position > 0 && !isNaN(position) && Math.abs(currentPosition - position) > 1) {\r\n          isRestoringRef.current = true;\r\n          setScrollPosition(containerElement, axis, 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  }, [axis, containerElement, scrollPositionKey, checkScrollability, storageAdapter]);\r\n\r\n  const preserveScrollPosition = useCallback(() => {\r\n    if (containerRef.current && storageAdapter) {\r\n      try {\r\n        storageAdapter.setItem(\r\n          scrollPositionKey,\r\n          String(getScrollPosition(containerRef.current, axis)),\r\n        );\r\n      } catch {\r\n        // Ignore storage errors\r\n      }\r\n    }\r\n  }, [axis, scrollPositionKey, storageAdapter]);\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, checkDelay);\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  }, [checkDelay, containerElement, checkScrollability]);\r\n\r\n  const scrollBackward = useCallback(() => {\r\n    const delta = -scrollAmount;\r\n    containerRef.current?.scrollBy(\r\n      axis === 'x' ? { left: delta, behavior: 'smooth' } : { top: delta, behavior: 'smooth' },\r\n    );\r\n  }, [axis, scrollAmount]);\r\n\r\n  const scrollForward = useCallback(() => {\r\n    containerRef.current?.scrollBy(\r\n      axis === 'x'\r\n        ? { left: scrollAmount, behavior: 'smooth' }\r\n        : { top: scrollAmount, behavior: 'smooth' },\r\n    );\r\n  }, [axis, scrollAmount]);\r\n\r\n  return {\r\n    containerRef: assignContainerRef as Ref<HTMLElement | null>,\r\n    canScrollBackward,\r\n    canScrollForward,\r\n    scrollBackward,\r\n    scrollForward,\r\n    checkScrollability,\r\n    preserveScrollPosition,\r\n  };\r\n}\r\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@publikit/hooks",
-  "version": "0.1.1",
+  "version": "1.0.0",
   "description": "Generic, reusable React hooks for Publikit packages and applications",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -11,11 +11,42 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./use-media-query": {
+      "types": "./dist/use-media-query.d.ts",
+      "import": "./dist/use-media-query.js",
+      "require": "./dist/use-media-query.cjs"
+    },
+    "./use-mobile": {
+      "types": "./dist/use-mobile.d.ts",
+      "import": "./dist/use-mobile.js",
+      "require": "./dist/use-mobile.cjs"
+    },
+    "./use-infinite-scroll": {
+      "types": "./dist/use-infinite-scroll.d.ts",
+      "import": "./dist/use-infinite-scroll.js",
+      "require": "./dist/use-infinite-scroll.cjs"
+    },
+    "./use-pull-to-refresh": {
+      "types": "./dist/use-pull-to-refresh.d.ts",
+      "import": "./dist/use-pull-to-refresh.js",
+      "require": "./dist/use-pull-to-refresh.cjs"
+    },
+    "./use-live-timestamp": {
+      "types": "./dist/use-live-timestamp.d.ts",
+      "import": "./dist/use-live-timestamp.js",
+      "require": "./dist/use-live-timestamp.cjs"
+    },
+    "./use-scrollable-container": {
+      "types": "./dist/use-scrollable-container.d.ts",
+      "import": "./dist/use-scrollable-container.js",
+      "require": "./dist/use-scrollable-container.cjs"
     }
   },
   "files": [
     "dist",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "sideEffects": false,
@@ -25,7 +56,8 @@
     "clean": "rimraf dist",
     "prepublishOnly": "npm run clean && npm run build",
     "typecheck": "tsc --noEmit",
-    "test": "vitest run"
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage"
   },
   "keywords": [
     "react",
@@ -39,9 +71,9 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/pirimera/publikit.git",
-    "directory": "hooks"
+    "directory": "packages/hooks"
   },
-  "homepage": "https://github.com/pirimera/publikit/tree/main/hooks#readme",
+  "homepage": "https://github.com/pirimera/publikit/tree/main/packages/hooks#readme",
   "bugs": {
     "url": "https://github.com/pirimera/publikit/issues"
   },
@@ -55,7 +87,7 @@
     "react": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
-    "@publikit/utils": "^0.1.1"
+    "@publikit/utils": "^1.0.0"
   },
   "devDependencies": {
     "@publikit/utils": "file:../utils",
@@ -68,6 +100,7 @@
     "rimraf": "^5.0.0",
     "tsup": "^8.0.0",
     "typescript": "^5.8.3",
+    "@vitest/coverage-v8": "^4.0.18",
     "vitest": "^4.0.18"
   }
 }