@develemit/web-hooks 0.1.0 → 0.3.0

package/dist/unsaved-guard.d.ts

@@ -0,0 +1,5 @@
+declare function handleBeforeUnload(event: BeforeUnloadEvent): void;
+
+declare function useUnsavedChangesGuard(dirty: boolean): void;
+
+export { handleBeforeUnload, useUnsavedChangesGuard };

package/dist/unsaved-guard.js

@@ -0,0 +1,9 @@
+"use client";
+import {
+  handleBeforeUnload,
+  useUnsavedChangesGuard
+} from "./chunk-LZKAGDER.js";
+export {
+  handleBeforeUnload,
+  useUnsavedChangesGuard
+};

package/dist/visibility-polling.cjs

@@ -0,0 +1,98 @@
+"use client";
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/visibility-polling/index.ts
+var visibility_polling_exports = {};
+__export(visibility_polling_exports, {
+  nextDelay: () => nextDelay,
+  useVisibilityPolling: () => useVisibilityPolling
+});
+module.exports = __toCommonJS(visibility_polling_exports);
+
+// src/visibility-polling/schedule.ts
+function nextDelay(intervalMs, jitter, random) {
+  const fraction = Math.min(1, Math.max(0, jitter));
+  return intervalMs + random() * fraction * intervalMs;
+}
+
+// src/visibility-polling/use-visibility-polling.ts
+var import_react = require("react");
+var isHidden = () => document.visibilityState === "hidden";
+function useVisibilityPolling(fn, intervalMs, { enabled = true, immediate = true, jitter = 0, runOnVisible = true } = {}) {
+  const fnRef = (0, import_react.useRef)(fn);
+  const optionsRef = (0, import_react.useRef)({ immediate, jitter, runOnVisible });
+  (0, import_react.useEffect)(() => {
+    fnRef.current = fn;
+    optionsRef.current = { immediate, jitter, runOnVisible };
+  });
+  const runningRef = (0, import_react.useRef)(false);
+  const scheduleRef = (0, import_react.useRef)(null);
+  (0, import_react.useEffect)(() => {
+    if (!enabled) return;
+    let active = true;
+    let timer = null;
+    function clearTimer() {
+      if (timer !== null) clearTimeout(timer);
+      timer = null;
+    }
+    function schedule() {
+      clearTimer();
+      if (!active || isHidden()) return;
+      timer = setTimeout(run, nextDelay(intervalMs, optionsRef.current.jitter, Math.random));
+    }
+    async function run() {
+      timer = null;
+      if (!active || runningRef.current || isHidden()) return;
+      runningRef.current = true;
+      try {
+        await fnRef.current();
+      } catch {
+      } finally {
+        runningRef.current = false;
+      }
+      scheduleRef.current?.();
+    }
+    function onVisibilityChange() {
+      if (isHidden()) {
+        clearTimer();
+      } else if (optionsRef.current.runOnVisible) {
+        clearTimer();
+        void run();
+      } else if (!runningRef.current) {
+        schedule();
+      }
+    }
+    scheduleRef.current = schedule;
+    if (optionsRef.current.immediate && !isHidden()) void run();
+    else schedule();
+    document.addEventListener("visibilitychange", onVisibilityChange);
+    return () => {
+      active = false;
+      scheduleRef.current = null;
+      clearTimer();
+      document.removeEventListener("visibilitychange", onVisibilityChange);
+    };
+  }, [enabled, intervalMs]);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  nextDelay,
+  useVisibilityPolling
+});

package/dist/visibility-polling.d.cts

@@ -0,0 +1,14 @@
+declare function nextDelay(intervalMs: number, jitter: number, random: () => number): number;
+
+interface UseVisibilityPollingOptions {
+    enabled?: boolean;
+    /** Run once on mount (when visible) before the first interval. */
+    immediate?: boolean;
+    /** 0–1 fraction of the interval added at random to each delay. */
+    jitter?: number;
+    /** Run once as soon as the page becomes visible again. */
+    runOnVisible?: boolean;
+}
+declare function useVisibilityPolling(fn: () => unknown, intervalMs: number, { enabled, immediate, jitter, runOnVisible }?: UseVisibilityPollingOptions): void;
+
+export { type UseVisibilityPollingOptions, nextDelay, useVisibilityPolling };

package/dist/visibility-polling.d.ts

@@ -0,0 +1,14 @@
+declare function nextDelay(intervalMs: number, jitter: number, random: () => number): number;
+
+interface UseVisibilityPollingOptions {
+    enabled?: boolean;
+    /** Run once on mount (when visible) before the first interval. */
+    immediate?: boolean;
+    /** 0–1 fraction of the interval added at random to each delay. */
+    jitter?: number;
+    /** Run once as soon as the page becomes visible again. */
+    runOnVisible?: boolean;
+}
+declare function useVisibilityPolling(fn: () => unknown, intervalMs: number, { enabled, immediate, jitter, runOnVisible }?: UseVisibilityPollingOptions): void;
+
+export { type UseVisibilityPollingOptions, nextDelay, useVisibilityPolling };

package/dist/visibility-polling.js

@@ -0,0 +1,9 @@
+"use client";
+import {
+  nextDelay,
+  useVisibilityPolling
+} from "./chunk-UPVNSGIK.js";
+export {
+  nextDelay,
+  useVisibilityPolling
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@develemit/web-hooks",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Shared React behavior hooks for develemit web apps: drawer swipe, focus trap, escape key and clipboard.",
   "license": "MIT",
   "author": "Emit Dutcher",
@@ -34,6 +34,81 @@
       "types": "./dist/clipboard.d.ts",
       "import": "./dist/clipboard.js",
       "require": "./dist/clipboard.cjs"
+    },
+    "./scroll-lock": {
+      "types": "./dist/scroll-lock.d.ts",
+      "import": "./dist/scroll-lock.js",
+      "require": "./dist/scroll-lock.cjs"
+    },
+    "./media-query": {
+      "types": "./dist/media-query.d.ts",
+      "import": "./dist/media-query.js",
+      "require": "./dist/media-query.cjs"
+    },
+    "./outside-press": {
+      "types": "./dist/outside-press.d.ts",
+      "import": "./dist/outside-press.js",
+      "require": "./dist/outside-press.cjs"
+    },
+    "./visibility-polling": {
+      "types": "./dist/visibility-polling.d.ts",
+      "import": "./dist/visibility-polling.js",
+      "require": "./dist/visibility-polling.cjs"
+    },
+    "./debounce": {
+      "types": "./dist/debounce.d.ts",
+      "import": "./dist/debounce.js",
+      "require": "./dist/debounce.cjs"
+    },
+    "./storage-state": {
+      "types": "./dist/storage-state.d.ts",
+      "import": "./dist/storage-state.js",
+      "require": "./dist/storage-state.cjs"
+    },
+    "./unsaved-guard": {
+      "types": "./dist/unsaved-guard.d.ts",
+      "import": "./dist/unsaved-guard.js",
+      "require": "./dist/unsaved-guard.cjs"
+    },
+    "./hotkey": {
+      "types": "./dist/hotkey.d.ts",
+      "import": "./dist/hotkey.js",
+      "require": "./dist/hotkey.cjs"
+    },
+    "./auto-grow": {
+      "types": "./dist/auto-grow.d.ts",
+      "import": "./dist/auto-grow.js",
+      "require": "./dist/auto-grow.cjs"
+    },
+    "./pwa": {
+      "types": "./dist/pwa.d.ts",
+      "import": "./dist/pwa.js",
+      "require": "./dist/pwa.cjs"
+    },
+    "./online-status": {
+      "types": "./dist/online-status.d.ts",
+      "import": "./dist/online-status.js",
+      "require": "./dist/online-status.cjs"
+    },
+    "./service-worker": {
+      "types": "./dist/service-worker.d.ts",
+      "import": "./dist/service-worker.js",
+      "require": "./dist/service-worker.cjs"
+    },
+    "./share": {
+      "types": "./dist/share.d.ts",
+      "import": "./dist/share.js",
+      "require": "./dist/share.cjs"
+    },
+    "./keyboard-inset": {
+      "types": "./dist/keyboard-inset.d.ts",
+      "import": "./dist/keyboard-inset.js",
+      "require": "./dist/keyboard-inset.cjs"
+    },
+    "./push": {
+      "types": "./dist/push.d.ts",
+      "import": "./dist/push.js",
+      "require": "./dist/push.cjs"
     }
   },
   "main": "./dist/index.cjs",
@@ -54,11 +129,17 @@
     "@eslint/js": "^9.0.0",
     "@testing-library/react": "^16.0.0",
     "@types/react": "^19.0.0",
+    "@types/react-18": "npm:@types/react@^18.3.31",
     "@types/react-dom": "^19.0.0",
+    "@vitest/browser": "3.2.7",
     "eslint": "^9.0.0",
     "jsdom": "^26.0.0",
+    "playwright": "1.64.0",
     "react": "^19.0.0",
+    "react-18": "npm:react@^18.3.1",
     "react-dom": "^19.0.0",
+    "react-dom-18": "npm:react-dom@^18.3.1",
+    "testing-library-react-18": "npm:@testing-library/react@16.2.0",
     "tsup": "^8.5.1",
     "typescript": "^5.9.0",
     "typescript-eslint": "^8.0.0",
@@ -71,6 +152,8 @@
     "build": "rm -rf dist && tsup",
     "check": "pnpm typecheck && pnpm lint && pnpm test && pnpm build",
     "release": "pnpm check && pnpm publish --access public",
-    "release:dry": "pnpm publish --access public --dry-run"
+    "release:dry": "pnpm publish --access public --dry-run",
+    "test:unit": "vitest run --project jsdom-react19 --project jsdom-react18",
+    "test:browser": "vitest run --project browser-webkit"
   }
 }