@develemit/web-hooks 0.0.0-stage → 0.2.0

package/dist/index.d.cts

@@ -0,0 +1,14 @@
+export { BACK_ZONE_PX, CLOSE_DISTANCE_PX, FORWARD_ZONE_PX, MAX_SWIPE_DURATION_MS, OPEN_DISTANCE_PX, SwipeIntent, SwipePoint, UseDrawerSwipeOptions, VERTICAL_CANCEL_PX, isInOpenZone, isInsideHorizontalScroller, resolveSwipeIntent, useDrawerSwipe } from './drawer-swipe.cjs';
+export { FOCUSABLE_SELECTOR, UseFocusTrapOptions, focusableWithin, nextFocusTarget, useFocusTrap } from './focus-trap.cjs';
+export { useEscape } from './escape.cjs';
+export { CopyResult, CopyStatus, copyText, useCopyFeedback } from './clipboard.cjs';
+export { lockScroll, unlockScroll, useScrollLock } from './scroll-lock.cjs';
+export { COARSE_POINTER_QUERY, REDUCED_MOTION_QUERY, UseMediaQueryOptions, useCoarsePointer, useMediaQuery, useReducedMotion } from './media-query.cjs';
+export { UseOutsidePressOptions, isOutside, isPrimaryPress, useOutsidePress } from './outside-press.cjs';
+export { UseVisibilityPollingOptions, nextDelay, useVisibilityPolling } from './visibility-polling.cjs';
+export { DebouncedCallback, Debouncer, createDebouncer, useDebouncedCallback, useDebouncedValue } from './debounce.cjs';
+export { StorageKind, StorageStateSetter, UseStorageStateOptions, useStorageState } from './storage-state.cjs';
+export { handleBeforeUnload, useUnsavedChangesGuard } from './unsaved-guard.cjs';
+export { ParsedHotkey, UseHotkeyOptions, detectApple, isEditableTarget, matchHotkey, parseHotkey, useHotkey } from './hotkey.cjs';
+export { NextHeight, UseAutoGrowTextareaOptions, nextHeight, useAutoGrowTextarea } from './auto-grow.cjs';
+import 'react';

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { BACK_ZONE_PX, CLOSE_DISTANCE_PX, FORWARD_ZONE_PX, MAX_SWIPE_DURATION_MS, OPEN_DISTANCE_PX, SwipeIntent, SwipePoint, UseDrawerSwipeOptions, VERTICAL_CANCEL_PX, isInOpenZone, isInsideHorizontalScroller, resolveSwipeIntent, useDrawerSwipe } from './drawer-swipe.js';
+export { FOCUSABLE_SELECTOR, UseFocusTrapOptions, focusableWithin, nextFocusTarget, useFocusTrap } from './focus-trap.js';
+export { useEscape } from './escape.js';
+export { CopyResult, CopyStatus, copyText, useCopyFeedback } from './clipboard.js';
+export { lockScroll, unlockScroll, useScrollLock } from './scroll-lock.js';
+export { COARSE_POINTER_QUERY, REDUCED_MOTION_QUERY, UseMediaQueryOptions, useCoarsePointer, useMediaQuery, useReducedMotion } from './media-query.js';
+export { UseOutsidePressOptions, isOutside, isPrimaryPress, useOutsidePress } from './outside-press.js';
+export { UseVisibilityPollingOptions, nextDelay, useVisibilityPolling } from './visibility-polling.js';
+export { DebouncedCallback, Debouncer, createDebouncer, useDebouncedCallback, useDebouncedValue } from './debounce.js';
+export { StorageKind, StorageStateSetter, UseStorageStateOptions, useStorageState } from './storage-state.js';
+export { handleBeforeUnload, useUnsavedChangesGuard } from './unsaved-guard.js';
+export { ParsedHotkey, UseHotkeyOptions, detectApple, isEditableTarget, matchHotkey, parseHotkey, useHotkey } from './hotkey.js';
+export { NextHeight, UseAutoGrowTextareaOptions, nextHeight, useAutoGrowTextarea } from './auto-grow.js';
+import 'react';

package/dist/index.js

@@ -0,0 +1,115 @@
+"use client";
+import {
+  nextDelay,
+  useVisibilityPolling
+} from "./chunk-UPVNSGIK.js";
+import {
+  createDebouncer,
+  useDebouncedCallback,
+  useDebouncedValue
+} from "./chunk-IWQDAJEP.js";
+import {
+  useStorageState
+} from "./chunk-5KIH2XLV.js";
+import {
+  handleBeforeUnload,
+  useUnsavedChangesGuard
+} from "./chunk-LZKAGDER.js";
+import {
+  detectApple,
+  isEditableTarget,
+  matchHotkey,
+  parseHotkey,
+  useHotkey
+} from "./chunk-NKLEB5TR.js";
+import {
+  nextHeight,
+  useAutoGrowTextarea
+} from "./chunk-5CA5RIMH.js";
+import {
+  BACK_ZONE_PX,
+  CLOSE_DISTANCE_PX,
+  FORWARD_ZONE_PX,
+  MAX_SWIPE_DURATION_MS,
+  OPEN_DISTANCE_PX,
+  VERTICAL_CANCEL_PX,
+  isInOpenZone,
+  isInsideHorizontalScroller,
+  resolveSwipeIntent,
+  useDrawerSwipe
+} from "./chunk-OZ4PU4E3.js";
+import {
+  FOCUSABLE_SELECTOR,
+  focusableWithin,
+  nextFocusTarget,
+  useFocusTrap
+} from "./chunk-DNU57XEJ.js";
+import {
+  useEscape
+} from "./chunk-S4YKMGQE.js";
+import {
+  copyText,
+  useCopyFeedback
+} from "./chunk-3CACI4OQ.js";
+import {
+  lockScroll,
+  unlockScroll,
+  useScrollLock
+} from "./chunk-6KCRVSLS.js";
+import {
+  COARSE_POINTER_QUERY,
+  REDUCED_MOTION_QUERY,
+  useCoarsePointer,
+  useMediaQuery,
+  useReducedMotion
+} from "./chunk-UZADAINO.js";
+import {
+  isOutside,
+  isPrimaryPress,
+  useOutsidePress
+} from "./chunk-3UGRXQIA.js";
+export {
+  BACK_ZONE_PX,
+  CLOSE_DISTANCE_PX,
+  COARSE_POINTER_QUERY,
+  FOCUSABLE_SELECTOR,
+  FORWARD_ZONE_PX,
+  MAX_SWIPE_DURATION_MS,
+  OPEN_DISTANCE_PX,
+  REDUCED_MOTION_QUERY,
+  VERTICAL_CANCEL_PX,
+  copyText,
+  createDebouncer,
+  detectApple,
+  focusableWithin,
+  handleBeforeUnload,
+  isEditableTarget,
+  isInOpenZone,
+  isInsideHorizontalScroller,
+  isOutside,
+  isPrimaryPress,
+  lockScroll,
+  matchHotkey,
+  nextDelay,
+  nextFocusTarget,
+  nextHeight,
+  parseHotkey,
+  resolveSwipeIntent,
+  unlockScroll,
+  useAutoGrowTextarea,
+  useCoarsePointer,
+  useCopyFeedback,
+  useDebouncedCallback,
+  useDebouncedValue,
+  useDrawerSwipe,
+  useEscape,
+  useFocusTrap,
+  useHotkey,
+  useMediaQuery,
+  useOutsidePress,
+  useReducedMotion,
+  useScrollLock,
+  useStorageState,
+  useUnsavedChangesGuard,
+  useVisibilityPolling
+};

package/dist/media-query.cjs

@@ -0,0 +1,90 @@
+"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/media-query/index.ts
+var media_query_exports = {};
+__export(media_query_exports, {
+  COARSE_POINTER_QUERY: () => COARSE_POINTER_QUERY,
+  REDUCED_MOTION_QUERY: () => REDUCED_MOTION_QUERY,
+  useCoarsePointer: () => useCoarsePointer,
+  useMediaQuery: () => useMediaQuery,
+  useReducedMotion: () => useReducedMotion
+});
+module.exports = __toCommonJS(media_query_exports);
+
+// src/media-query/use-media-query.ts
+var import_react = require("react");
+
+// src/media-query/media-query.ts
+var REDUCED_MOTION_QUERY = "(prefers-reduced-motion: reduce)";
+var COARSE_POINTER_QUERY = "(pointer: coarse)";
+var lists = /* @__PURE__ */ new WeakMap();
+function getList(query) {
+  if (typeof window === "undefined" || typeof window.matchMedia !== "function") return null;
+  const owner = window.matchMedia;
+  let byQuery = lists.get(owner);
+  if (!byQuery) {
+    byQuery = /* @__PURE__ */ new Map();
+    lists.set(owner, byQuery);
+  }
+  let list = byQuery.get(query);
+  if (!list) {
+    list = owner.call(window, query);
+    byQuery.set(query, list);
+  }
+  return list;
+}
+function getMatches(query) {
+  return getList(query)?.matches ?? null;
+}
+function subscribe(query, onChange) {
+  const list = getList(query);
+  if (!list) return () => {
+  };
+  if (typeof list.addEventListener === "function") {
+    list.addEventListener("change", onChange);
+    return () => list.removeEventListener("change", onChange);
+  }
+  list.addListener(onChange);
+  return () => list.removeListener(onChange);
+}
+
+// src/media-query/use-media-query.ts
+function useMediaQuery(query, options = {}) {
+  const serverDefault = options.serverDefault ?? false;
+  const subscribeToQuery = (0, import_react.useCallback)((onChange) => subscribe(query, onChange), [query]);
+  const getSnapshot = (0, import_react.useCallback)(() => getMatches(query) ?? serverDefault, [query, serverDefault]);
+  const getServerSnapshot = (0, import_react.useCallback)(() => serverDefault, [serverDefault]);
+  return (0, import_react.useSyncExternalStore)(subscribeToQuery, getSnapshot, getServerSnapshot);
+}
+function useReducedMotion(options) {
+  return useMediaQuery(REDUCED_MOTION_QUERY, options);
+}
+function useCoarsePointer(options) {
+  return useMediaQuery(COARSE_POINTER_QUERY, options);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  COARSE_POINTER_QUERY,
+  REDUCED_MOTION_QUERY,
+  useCoarsePointer,
+  useMediaQuery,
+  useReducedMotion
+});

package/dist/media-query.d.cts

@@ -0,0 +1,12 @@
+interface UseMediaQueryOptions {
+    /** Value on the server, during hydration, and where `matchMedia` is missing. Default `false`. */
+    serverDefault?: boolean;
+}
+declare function useMediaQuery(query: string, options?: UseMediaQueryOptions): boolean;
+declare function useReducedMotion(options?: UseMediaQueryOptions): boolean;
+declare function useCoarsePointer(options?: UseMediaQueryOptions): boolean;
+
+declare const REDUCED_MOTION_QUERY = "(prefers-reduced-motion: reduce)";
+declare const COARSE_POINTER_QUERY = "(pointer: coarse)";
+
+export { COARSE_POINTER_QUERY, REDUCED_MOTION_QUERY, type UseMediaQueryOptions, useCoarsePointer, useMediaQuery, useReducedMotion };

package/dist/media-query.d.ts

@@ -0,0 +1,12 @@
+interface UseMediaQueryOptions {
+    /** Value on the server, during hydration, and where `matchMedia` is missing. Default `false`. */
+    serverDefault?: boolean;
+}
+declare function useMediaQuery(query: string, options?: UseMediaQueryOptions): boolean;
+declare function useReducedMotion(options?: UseMediaQueryOptions): boolean;
+declare function useCoarsePointer(options?: UseMediaQueryOptions): boolean;
+
+declare const REDUCED_MOTION_QUERY = "(prefers-reduced-motion: reduce)";
+declare const COARSE_POINTER_QUERY = "(pointer: coarse)";
+
+export { COARSE_POINTER_QUERY, REDUCED_MOTION_QUERY, type UseMediaQueryOptions, useCoarsePointer, useMediaQuery, useReducedMotion };

package/dist/media-query.js

@@ -0,0 +1,15 @@
+"use client";
+import {
+  COARSE_POINTER_QUERY,
+  REDUCED_MOTION_QUERY,
+  useCoarsePointer,
+  useMediaQuery,
+  useReducedMotion
+} from "./chunk-UZADAINO.js";
+export {
+  COARSE_POINTER_QUERY,
+  REDUCED_MOTION_QUERY,
+  useCoarsePointer,
+  useMediaQuery,
+  useReducedMotion
+};

package/dist/outside-press.cjs

@@ -0,0 +1,66 @@
+"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/outside-press/index.ts
+var outside_press_exports = {};
+__export(outside_press_exports, {
+  isOutside: () => isOutside,
+  isPrimaryPress: () => isPrimaryPress,
+  useOutsidePress: () => useOutsidePress
+});
+module.exports = __toCommonJS(outside_press_exports);
+
+// src/outside-press/outside-press.ts
+function isOutside(target, elements) {
+  if (!target) return false;
+  if (!target.isConnected) return false;
+  return !elements.some((el) => el?.contains(target));
+}
+function isPrimaryPress(event) {
+  return !(event.pointerType === "mouse" && event.button !== 0);
+}
+
+// src/outside-press/use-outside-press.ts
+var import_react = require("react");
+function useOutsidePress(refs, onOutsidePress, { enabled = true } = {}) {
+  const refsRef = (0, import_react.useRef)(refs);
+  const handlerRef = (0, import_react.useRef)(onOutsidePress);
+  (0, import_react.useEffect)(() => {
+    refsRef.current = refs;
+    handlerRef.current = onOutsidePress;
+  });
+  (0, import_react.useEffect)(() => {
+    if (!enabled) return;
+    function onPointerDown(event) {
+      if (!isPrimaryPress(event)) return;
+      const list = Array.isArray(refsRef.current) ? refsRef.current : [refsRef.current];
+      const elements = list.map((ref) => ref.current);
+      if (isOutside(event.target, elements)) handlerRef.current(event);
+    }
+    document.addEventListener("pointerdown", onPointerDown, true);
+    return () => document.removeEventListener("pointerdown", onPointerDown, true);
+  }, [enabled]);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isOutside,
+  isPrimaryPress,
+  useOutsidePress
+});

package/dist/outside-press.d.cts

@@ -0,0 +1,15 @@
+import { RefObject } from 'react';
+
+declare function isOutside(target: Node | null, elements: (Element | null)[]): boolean;
+declare function isPrimaryPress(event: {
+    button?: number;
+    pointerType?: string;
+}): boolean;
+
+type ElementRef = RefObject<Element | null>;
+interface UseOutsidePressOptions {
+    enabled?: boolean;
+}
+declare function useOutsidePress(refs: ElementRef | ElementRef[], onOutsidePress: (event: PointerEvent) => void, { enabled }?: UseOutsidePressOptions): void;
+
+export { type UseOutsidePressOptions, isOutside, isPrimaryPress, useOutsidePress };

package/dist/outside-press.d.ts

@@ -0,0 +1,15 @@
+import { RefObject } from 'react';
+
+declare function isOutside(target: Node | null, elements: (Element | null)[]): boolean;
+declare function isPrimaryPress(event: {
+    button?: number;
+    pointerType?: string;
+}): boolean;
+
+type ElementRef = RefObject<Element | null>;
+interface UseOutsidePressOptions {
+    enabled?: boolean;
+}
+declare function useOutsidePress(refs: ElementRef | ElementRef[], onOutsidePress: (event: PointerEvent) => void, { enabled }?: UseOutsidePressOptions): void;
+
+export { type UseOutsidePressOptions, isOutside, isPrimaryPress, useOutsidePress };

package/dist/outside-press.js

@@ -0,0 +1,11 @@
+"use client";
+import {
+  isOutside,
+  isPrimaryPress,
+  useOutsidePress
+} from "./chunk-3UGRXQIA.js";
+export {
+  isOutside,
+  isPrimaryPress,
+  useOutsidePress
+};

package/dist/scroll-lock.cjs

@@ -0,0 +1,107 @@
+"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/scroll-lock/index.ts
+var scroll_lock_exports = {};
+__export(scroll_lock_exports, {
+  lockScroll: () => lockScroll,
+  unlockScroll: () => unlockScroll,
+  useScrollLock: () => useScrollLock
+});
+module.exports = __toCommonJS(scroll_lock_exports);
+
+// src/scroll-lock/use-scroll-lock.ts
+var import_react = require("react");
+
+// src/scroll-lock/lock-styles.ts
+var LOCKED_PROPERTIES = [
+  "position",
+  "top",
+  "left",
+  "right",
+  "width",
+  "overflow",
+  "paddingRight"
+];
+function computeLockStyles({ scrollY, scrollbarWidth, existingPaddingRight }) {
+  const styles = {
+    position: "fixed",
+    top: `-${scrollY}px`,
+    left: "0",
+    right: "0",
+    width: "100%",
+    overflow: "hidden"
+  };
+  if (scrollbarWidth > 0) styles.paddingRight = `${existingPaddingRight + scrollbarWidth}px`;
+  return styles;
+}
+
+// src/scroll-lock/scroll-lock.ts
+var count = 0;
+var saved = null;
+function applyFirstLock() {
+  const { body, documentElement } = document;
+  const inline = {};
+  for (const property of LOCKED_PROPERTIES) inline[property] = body.style[property];
+  saved = { scrollY: window.scrollY, inline };
+  const styles = computeLockStyles({
+    scrollY: saved.scrollY,
+    scrollbarWidth: Math.max(0, window.innerWidth - documentElement.clientWidth),
+    existingPaddingRight: parseFloat(getComputedStyle(body).paddingRight) || 0
+  });
+  Object.assign(body.style, styles);
+}
+function restoreLastLock() {
+  if (!saved) return;
+  const { scrollY, inline } = saved;
+  saved = null;
+  Object.assign(document.body.style, inline);
+  window.scrollTo(0, scrollY);
+}
+function lockScroll() {
+  if (count === 0) applyFirstLock();
+  count += 1;
+  let released = false;
+  return () => {
+    if (released) return;
+    released = true;
+    count -= 1;
+    if (count === 0) restoreLastLock();
+  };
+}
+function unlockScroll() {
+  if (count === 0) return;
+  count -= 1;
+  if (count === 0) restoreLastLock();
+}
+
+// src/scroll-lock/use-scroll-lock.ts
+function useScrollLock(active = true) {
+  (0, import_react.useEffect)(() => {
+    if (!active) return;
+    return lockScroll();
+  }, [active]);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  lockScroll,
+  unlockScroll,
+  useScrollLock
+});

package/dist/scroll-lock.d.cts

@@ -0,0 +1,8 @@
+declare function useScrollLock(active?: boolean): void;
+
+/** Locks page scroll. Locks are counted; the returned release is safe to call twice. */
+declare function lockScroll(): () => void;
+/** Releases one lock taken with `lockScroll()` that was not released through its own function. */
+declare function unlockScroll(): void;
+
+export { lockScroll, unlockScroll, useScrollLock };

package/dist/scroll-lock.d.ts

@@ -0,0 +1,8 @@
+declare function useScrollLock(active?: boolean): void;
+
+/** Locks page scroll. Locks are counted; the returned release is safe to call twice. */
+declare function lockScroll(): () => void;
+/** Releases one lock taken with `lockScroll()` that was not released through its own function. */
+declare function unlockScroll(): void;
+
+export { lockScroll, unlockScroll, useScrollLock };

package/dist/scroll-lock.js

@@ -0,0 +1,11 @@
+"use client";
+import {
+  lockScroll,
+  unlockScroll,
+  useScrollLock
+} from "./chunk-6KCRVSLS.js";
+export {
+  lockScroll,
+  unlockScroll,
+  useScrollLock
+};