@publikit/hooks 0.1.1 → 1.0.0

package/dist/use-infinite-scroll.d.ts

@@ -0,0 +1,28 @@
+import { RefCallback } from 'react';
+
+interface UseIntersectionLoadMoreOptions {
+    /** 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;
+}
+interface UseIntersectionLoadMoreReturn {
+    /** Callback ref for the sentinel element. */
+    sentinelRef: RefCallback<HTMLElement | null>;
+}
+/**
+ * Headless infinite-load behaviour using IntersectionObserver.
+ */
+declare function useIntersectionLoadMore({ onLoadMore, hasNextPage, isFetchingNextPage, rootMargin, threshold, enabled, root, }: UseIntersectionLoadMoreOptions): UseIntersectionLoadMoreReturn;
+
+export { type UseIntersectionLoadMoreOptions, type UseIntersectionLoadMoreReturn, useIntersectionLoadMore };

package/dist/use-infinite-scroll.js

@@ -0,0 +1,51 @@
+import { useRef, useState, useCallback, useEffect } from 'react';
+
+// use-infinite-scroll.tsx
+function useIntersectionLoadMore({
+  onLoadMore,
+  hasNextPage,
+  isFetchingNextPage,
+  rootMargin = "200px",
+  threshold = 0,
+  enabled = true,
+  root
+}) {
+  const observerRef = useRef(null);
+  const [sentinelElement, setSentinelElement] = 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 (sentinelElement) {
+      observerRef.current.observe(sentinelElement);
+    }
+    return () => {
+      if (observerRef.current) {
+        observerRef.current.disconnect();
+      }
+    };
+  }, [sentinelElement, handleIntersection, rootMargin, threshold, enabled, root]);
+  return {
+    sentinelRef: setSentinelElement
+  };
+}
+
+export { useIntersectionLoadMore };
+//# sourceMappingURL=use-infinite-scroll.js.map
+//# sourceMappingURL=use-infinite-scroll.js.map

package/dist/use-infinite-scroll.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../use-infinite-scroll.tsx"],"names":[],"mappings":";;;AA2BO,SAAS,uBAAA,CAAwB;AAAA,EACtC,UAAA;AAAA,EACA,WAAA;AAAA,EACA,kBAAA;AAAA,EACA,UAAA,GAAa,OAAA;AAAA,EACb,SAAA,GAAY,CAAA;AAAA,EACZ,OAAA,GAAU,IAAA;AAAA,EACV;AACF,CAAA,EAAkE;AAChE,EAAA,MAAM,WAAA,GAAc,OAAoC,IAAI,CAAA;AAC5D,EAAA,MAAM,CAAC,eAAA,EAAiB,kBAAkB,CAAA,GAAI,SAA6B,IAAI,CAAA;AAE/E,EAAA,MAAM,kBAAA,GAAqB,WAAA;AAAA,IACzB,CAAC,OAAA,KAAyC;AACxC,MAAA,MAAM,KAAA,GAAQ,QAAQ,CAAC,CAAA;AACvB,MAAA,IAAI,CAAC,OAAO,cAAA,EAAgB;AAC5B,MAAA,IAAI,WAAA,IAAe,CAAC,kBAAA,IAAsB,OAAA,EAAS;AACjD,QAAA,UAAA,EAAW;AAAA,MACb;AAAA,IACF,CAAA;AAAA,IACA,CAAC,UAAA,EAAY,WAAA,EAAa,kBAAA,EAAoB,OAAO;AAAA,GACvD;AAEA,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,CAAC,OAAA,EAAS;AAEd,IAAA,IAAI,YAAY,OAAA,EAAS;AACvB,MAAA,WAAA,CAAY,QAAQ,UAAA,EAAW;AAAA,IACjC;AAEA,IAAA,WAAA,CAAY,OAAA,GAAU,IAAI,oBAAA,CAAqB,kBAAA,EAAoB;AAAA,MACjE,MAAM,IAAA,IAAQ,IAAA;AAAA,MACd,UAAA;AAAA,MACA;AAAA,KACD,CAAA;AAED,IAAA,IAAI,eAAA,EAAiB;AACnB,MAAA,WAAA,CAAY,OAAA,CAAQ,QAAQ,eAAe,CAAA;AAAA,IAC7C;AAEA,IAAA,OAAO,MAAM;AACX,MAAA,IAAI,YAAY,OAAA,EAAS;AACvB,QAAA,WAAA,CAAY,QAAQ,UAAA,EAAW;AAAA,MACjC;AAAA,IACF,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,eAAA,EAAiB,kBAAA,EAAoB,YAAY,SAAA,EAAW,OAAA,EAAS,IAAI,CAAC,CAAA;AAE9E,EAAA,OAAO;AAAA,IACL,WAAA,EAAa;AAAA,GACf;AACF","file":"use-infinite-scroll.js","sourcesContent":["import { useEffect, useRef, useCallback, useState, type RefCallback } from 'react';\r\n\r\nexport interface UseIntersectionLoadMoreOptions {\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\nexport interface UseIntersectionLoadMoreReturn {\r\n  /** Callback ref for the sentinel element. */\r\n  sentinelRef: RefCallback<HTMLElement | null>;\r\n}\r\n\r\n/**\r\n * Headless infinite-load behaviour using IntersectionObserver.\r\n */\r\nexport function useIntersectionLoadMore({\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}: UseIntersectionLoadMoreOptions): UseIntersectionLoadMoreReturn {\r\n  const observerRef = useRef<IntersectionObserver | null>(null);\r\n  const [sentinelElement, setSentinelElement] = useState<HTMLElement | 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 (sentinelElement) {\r\n      observerRef.current.observe(sentinelElement);\r\n    }\r\n\r\n    return () => {\r\n      if (observerRef.current) {\r\n        observerRef.current.disconnect();\r\n      }\r\n    };\r\n  }, [sentinelElement, handleIntersection, rootMargin, threshold, enabled, root]);\r\n\r\n  return {\r\n    sentinelRef: setSentinelElement,\r\n  };\r\n}\r\n"]}

package/dist/use-live-timestamp.cjs

@@ -0,0 +1,156 @@
+'use strict';
+
+var react = require('react');
+
+// use-live-timestamp.ts
+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;
+var visibilityListenerAttached = 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();
+}
+function ensureVisibilityListener() {
+  if (visibilityListenerAttached) return;
+  if (typeof document === "undefined") return;
+  document.addEventListener("visibilitychange", () => {
+    isTabVisible = !document.hidden;
+    if (isTabVisible && subscribers.size > 0) {
+      updateVisibleSubscribers();
+      ensureTimerRunning();
+    } else if (!isTabVisible) {
+      stopTimer();
+    }
+  });
+  visibilityListenerAttached = true;
+}
+function useLiveTimestamp(date, element) {
+  const [, setTick] = react.useState(0);
+  const subscriberIdRef = react.useRef(/* @__PURE__ */ Symbol("live-timestamp-subscriber"));
+  react.useEffect(() => {
+    ensureVisibilityListener();
+    const subscriberId = subscriberIdRef.current;
+    const observedElement = element ?? null;
+    const callback = () => {
+      const isVisible = visibilityMap.get(subscriberId) ?? true;
+      if (isVisible) {
+        setTick((t) => t + 1);
+      }
+    };
+    let observer = null;
+    if (observedElement) {
+      observer = createObserver(subscriberId, callback);
+      observer.observe(observedElement);
+      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(), element]);
+  return globalNow;
+}
+
+exports.useLiveTimestamp = useLiveTimestamp;
+//# sourceMappingURL=use-live-timestamp.cjs.map
+//# sourceMappingURL=use-live-timestamp.cjs.map

package/dist/use-live-timestamp.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../use-live-timestamp.ts"],"names":["useState","useRef","useEffect"],"mappings":"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","file":"use-live-timestamp.cjs","sourcesContent":["import { useState, useEffect, useRef } 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\nlet visibilityListenerAttached = 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\nfunction ensureVisibilityListener(): void {\r\n  if (visibilityListenerAttached) return;\r\n  if (typeof document === 'undefined') return;\r\n\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  visibilityListenerAttached = true;\r\n}\r\n\r\n/**\r\n * Live-updating timestamp hook with visibility-aware adaptive intervals.\r\n */\r\nexport function useLiveTimestamp(\r\n  date: Date,\r\n  element?: Element | null,\r\n): Date {\r\n  const [, setTick] = useState(0);\r\n  const subscriberIdRef = useRef<SubscriberId>(Symbol('live-timestamp-subscriber'));\r\n\r\n  useEffect(() => {\r\n    ensureVisibilityListener();\r\n    const subscriberId = subscriberIdRef.current;\r\n    const observedElement = element ?? null;\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 (observedElement) {\r\n      observer = createObserver(subscriberId, callback);\r\n      observer.observe(observedElement);\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(), element]);\r\n\r\n  return globalNow;\r\n}\r\n"]}

package/dist/use-live-timestamp.d.cts

@@ -0,0 +1,6 @@
+/**
+ * Live-updating timestamp hook with visibility-aware adaptive intervals.
+ */
+declare function useLiveTimestamp(date: Date, element?: Element | null): Date;
+
+export { useLiveTimestamp };

package/dist/use-live-timestamp.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Live-updating timestamp hook with visibility-aware adaptive intervals.
+ */
+declare function useLiveTimestamp(date: Date, element?: Element | null): Date;
+
+export { useLiveTimestamp };

package/dist/use-live-timestamp.js

@@ -0,0 +1,154 @@
+import { useState, useRef, useEffect } from 'react';
+
+// use-live-timestamp.ts
+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;
+var visibilityListenerAttached = 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();
+}
+function ensureVisibilityListener() {
+  if (visibilityListenerAttached) return;
+  if (typeof document === "undefined") return;
+  document.addEventListener("visibilitychange", () => {
+    isTabVisible = !document.hidden;
+    if (isTabVisible && subscribers.size > 0) {
+      updateVisibleSubscribers();
+      ensureTimerRunning();
+    } else if (!isTabVisible) {
+      stopTimer();
+    }
+  });
+  visibilityListenerAttached = true;
+}
+function useLiveTimestamp(date, element) {
+  const [, setTick] = useState(0);
+  const subscriberIdRef = useRef(/* @__PURE__ */ Symbol("live-timestamp-subscriber"));
+  useEffect(() => {
+    ensureVisibilityListener();
+    const subscriberId = subscriberIdRef.current;
+    const observedElement = element ?? null;
+    const callback = () => {
+      const isVisible = visibilityMap.get(subscriberId) ?? true;
+      if (isVisible) {
+        setTick((t) => t + 1);
+      }
+    };
+    let observer = null;
+    if (observedElement) {
+      observer = createObserver(subscriberId, callback);
+      observer.observe(observedElement);
+      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(), element]);
+  return globalNow;
+}
+
+export { useLiveTimestamp };
+//# sourceMappingURL=use-live-timestamp.js.map
+//# sourceMappingURL=use-live-timestamp.js.map

package/dist/use-live-timestamp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../use-live-timestamp.ts"],"names":[],"mappings":"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","file":"use-live-timestamp.js","sourcesContent":["import { useState, useEffect, useRef } 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\nlet visibilityListenerAttached = 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\nfunction ensureVisibilityListener(): void {\r\n  if (visibilityListenerAttached) return;\r\n  if (typeof document === 'undefined') return;\r\n\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  visibilityListenerAttached = true;\r\n}\r\n\r\n/**\r\n * Live-updating timestamp hook with visibility-aware adaptive intervals.\r\n */\r\nexport function useLiveTimestamp(\r\n  date: Date,\r\n  element?: Element | null,\r\n): Date {\r\n  const [, setTick] = useState(0);\r\n  const subscriberIdRef = useRef<SubscriberId>(Symbol('live-timestamp-subscriber'));\r\n\r\n  useEffect(() => {\r\n    ensureVisibilityListener();\r\n    const subscriberId = subscriberIdRef.current;\r\n    const observedElement = element ?? null;\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 (observedElement) {\r\n      observer = createObserver(subscriberId, callback);\r\n      observer.observe(observedElement);\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(), element]);\r\n\r\n  return globalNow;\r\n}\r\n"]}

package/dist/use-media-query.cjs

@@ -0,0 +1,24 @@
+'use strict';
+
+var react = require('react');
+
+// use-media-query.ts
+function getMatches(query, defaultValue) {
+  if (typeof window === "undefined") return defaultValue;
+  return window.matchMedia(query).matches;
+}
+function useMediaQuery(query, { defaultValue = false } = {}) {
+  const [matches, setMatches] = react.useState(() => getMatches(query, defaultValue));
+  react.useEffect(() => {
+    const mql = window.matchMedia(query);
+    const onChange = () => setMatches(mql.matches);
+    setMatches(mql.matches);
+    mql.addEventListener("change", onChange);
+    return () => mql.removeEventListener("change", onChange);
+  }, [query]);
+  return matches;
+}
+
+exports.useMediaQuery = useMediaQuery;
+//# sourceMappingURL=use-media-query.cjs.map
+//# sourceMappingURL=use-media-query.cjs.map

package/dist/use-media-query.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../use-media-query.ts"],"names":["useState","useEffect"],"mappings":";;;;;AAOA,SAAS,UAAA,CAAW,OAAe,YAAA,EAAgC;AACjE,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,EAAa,OAAO,YAAA;AAC1C,EAAA,OAAO,MAAA,CAAO,UAAA,CAAW,KAAK,CAAA,CAAE,OAAA;AAClC;AAKO,SAAS,cACd,KAAA,EACA,EAAE,eAAe,KAAA,EAAM,GAA0B,EAAC,EACzC;AACT,EAAA,MAAM,CAAC,SAAS,UAAU,CAAA,GAAIA,eAAkB,MAAM,UAAA,CAAW,KAAA,EAAO,YAAY,CAAC,CAAA;AAErF,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,MAAM,GAAA,GAAM,MAAA,CAAO,UAAA,CAAW,KAAK,CAAA;AACnC,IAAA,MAAM,QAAA,GAAW,MAAM,UAAA,CAAW,GAAA,CAAI,OAAO,CAAA;AAE7C,IAAA,UAAA,CAAW,IAAI,OAAO,CAAA;AACtB,IAAA,GAAA,CAAI,gBAAA,CAAiB,UAAU,QAAQ,CAAA;AACvC,IAAA,OAAO,MAAM,GAAA,CAAI,mBAAA,CAAoB,QAAA,EAAU,QAAQ,CAAA;AAAA,EACzD,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAEV,EAAA,OAAO,OAAA;AACT","file":"use-media-query.cjs","sourcesContent":["import { useEffect, useState } from 'react';\r\n\r\nexport interface UseMediaQueryOptions {\r\n  /** Value returned during SSR and before the first browser measurement. */\r\n  defaultValue?: boolean;\r\n}\r\n\r\nfunction getMatches(query: string, defaultValue: boolean): boolean {\r\n  if (typeof window === 'undefined') return defaultValue;\r\n  return window.matchMedia(query).matches;\r\n}\r\n\r\n/**\r\n * Subscribe to a CSS media query.\r\n */\r\nexport function useMediaQuery(\r\n  query: string,\r\n  { defaultValue = false }: UseMediaQueryOptions = {},\r\n): boolean {\r\n  const [matches, setMatches] = useState<boolean>(() => getMatches(query, defaultValue));\r\n\r\n  useEffect(() => {\r\n    const mql = window.matchMedia(query);\r\n    const onChange = () => setMatches(mql.matches);\r\n\r\n    setMatches(mql.matches);\r\n    mql.addEventListener('change', onChange);\r\n    return () => mql.removeEventListener('change', onChange);\r\n  }, [query]);\r\n\r\n  return matches;\r\n}\r\n"]}

package/dist/use-media-query.d.cts

@@ -0,0 +1,10 @@
+interface UseMediaQueryOptions {
+    /** Value returned during SSR and before the first browser measurement. */
+    defaultValue?: boolean;
+}
+/**
+ * Subscribe to a CSS media query.
+ */
+declare function useMediaQuery(query: string, { defaultValue }?: UseMediaQueryOptions): boolean;
+
+export { type UseMediaQueryOptions, useMediaQuery };

package/dist/use-media-query.d.ts

@@ -0,0 +1,10 @@
+interface UseMediaQueryOptions {
+    /** Value returned during SSR and before the first browser measurement. */
+    defaultValue?: boolean;
+}
+/**
+ * Subscribe to a CSS media query.
+ */
+declare function useMediaQuery(query: string, { defaultValue }?: UseMediaQueryOptions): boolean;
+
+export { type UseMediaQueryOptions, useMediaQuery };

package/dist/use-media-query.js

@@ -0,0 +1,22 @@
+import { useState, useEffect } from 'react';
+
+// use-media-query.ts
+function getMatches(query, defaultValue) {
+  if (typeof window === "undefined") return defaultValue;
+  return window.matchMedia(query).matches;
+}
+function useMediaQuery(query, { defaultValue = false } = {}) {
+  const [matches, setMatches] = useState(() => getMatches(query, defaultValue));
+  useEffect(() => {
+    const mql = window.matchMedia(query);
+    const onChange = () => setMatches(mql.matches);
+    setMatches(mql.matches);
+    mql.addEventListener("change", onChange);
+    return () => mql.removeEventListener("change", onChange);
+  }, [query]);
+  return matches;
+}
+
+export { useMediaQuery };
+//# sourceMappingURL=use-media-query.js.map
+//# sourceMappingURL=use-media-query.js.map

package/dist/use-media-query.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../use-media-query.ts"],"names":[],"mappings":";;;AAOA,SAAS,UAAA,CAAW,OAAe,YAAA,EAAgC;AACjE,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,EAAa,OAAO,YAAA;AAC1C,EAAA,OAAO,MAAA,CAAO,UAAA,CAAW,KAAK,CAAA,CAAE,OAAA;AAClC;AAKO,SAAS,cACd,KAAA,EACA,EAAE,eAAe,KAAA,EAAM,GAA0B,EAAC,EACzC;AACT,EAAA,MAAM,CAAC,SAAS,UAAU,CAAA,GAAI,SAAkB,MAAM,UAAA,CAAW,KAAA,EAAO,YAAY,CAAC,CAAA;AAErF,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,MAAM,GAAA,GAAM,MAAA,CAAO,UAAA,CAAW,KAAK,CAAA;AACnC,IAAA,MAAM,QAAA,GAAW,MAAM,UAAA,CAAW,GAAA,CAAI,OAAO,CAAA;AAE7C,IAAA,UAAA,CAAW,IAAI,OAAO,CAAA;AACtB,IAAA,GAAA,CAAI,gBAAA,CAAiB,UAAU,QAAQ,CAAA;AACvC,IAAA,OAAO,MAAM,GAAA,CAAI,mBAAA,CAAoB,QAAA,EAAU,QAAQ,CAAA;AAAA,EACzD,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAEV,EAAA,OAAO,OAAA;AACT","file":"use-media-query.js","sourcesContent":["import { useEffect, useState } from 'react';\r\n\r\nexport interface UseMediaQueryOptions {\r\n  /** Value returned during SSR and before the first browser measurement. */\r\n  defaultValue?: boolean;\r\n}\r\n\r\nfunction getMatches(query: string, defaultValue: boolean): boolean {\r\n  if (typeof window === 'undefined') return defaultValue;\r\n  return window.matchMedia(query).matches;\r\n}\r\n\r\n/**\r\n * Subscribe to a CSS media query.\r\n */\r\nexport function useMediaQuery(\r\n  query: string,\r\n  { defaultValue = false }: UseMediaQueryOptions = {},\r\n): boolean {\r\n  const [matches, setMatches] = useState<boolean>(() => getMatches(query, defaultValue));\r\n\r\n  useEffect(() => {\r\n    const mql = window.matchMedia(query);\r\n    const onChange = () => setMatches(mql.matches);\r\n\r\n    setMatches(mql.matches);\r\n    mql.addEventListener('change', onChange);\r\n    return () => mql.removeEventListener('change', onChange);\r\n  }, [query]);\r\n\r\n  return matches;\r\n}\r\n"]}

package/dist/use-mobile.cjs

@@ -0,0 +1,37 @@
+'use strict';
+
+var react = require('react');
+
+// use-media-query.ts
+function getMatches(query, defaultValue) {
+  if (typeof window === "undefined") return defaultValue;
+  return window.matchMedia(query).matches;
+}
+function useMediaQuery(query, { defaultValue = false } = {}) {
+  const [matches, setMatches] = react.useState(() => getMatches(query, defaultValue));
+  react.useEffect(() => {
+    const mql = window.matchMedia(query);
+    const onChange = () => setMatches(mql.matches);
+    setMatches(mql.matches);
+    mql.addEventListener("change", onChange);
+    return () => mql.removeEventListener("change", onChange);
+  }, [query]);
+  return matches;
+}
+
+// use-mobile.ts
+var MOBILE_BREAKPOINT = 768;
+function getMobileMediaQuery(breakpoint) {
+  return `(max-width: ${breakpoint - 1}px)`;
+}
+function useIsMobile({
+  breakpoint = MOBILE_BREAKPOINT,
+  defaultValue = false
+} = {}) {
+  return useMediaQuery(getMobileMediaQuery(breakpoint), { defaultValue });
+}
+
+exports.MOBILE_BREAKPOINT = MOBILE_BREAKPOINT;
+exports.useIsMobile = useIsMobile;
+//# sourceMappingURL=use-mobile.cjs.map
+//# sourceMappingURL=use-mobile.cjs.map

package/dist/use-mobile.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../use-media-query.ts","../use-mobile.ts"],"names":["useState","useEffect"],"mappings":";;;;;AAOA,SAAS,UAAA,CAAW,OAAe,YAAA,EAAgC;AACjE,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,EAAa,OAAO,YAAA;AAC1C,EAAA,OAAO,MAAA,CAAO,UAAA,CAAW,KAAK,CAAA,CAAE,OAAA;AAClC;AAKO,SAAS,cACd,KAAA,EACA,EAAE,eAAe,KAAA,EAAM,GAA0B,EAAC,EACzC;AACT,EAAA,MAAM,CAAC,SAAS,UAAU,CAAA,GAAIA,eAAkB,MAAM,UAAA,CAAW,KAAA,EAAO,YAAY,CAAC,CAAA;AAErF,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,MAAM,GAAA,GAAM,MAAA,CAAO,UAAA,CAAW,KAAK,CAAA;AACnC,IAAA,MAAM,QAAA,GAAW,MAAM,UAAA,CAAW,GAAA,CAAI,OAAO,CAAA;AAE7C,IAAA,UAAA,CAAW,IAAI,OAAO,CAAA;AACtB,IAAA,GAAA,CAAI,gBAAA,CAAiB,UAAU,QAAQ,CAAA;AACvC,IAAA,OAAO,MAAM,GAAA,CAAI,mBAAA,CAAoB,QAAA,EAAU,QAAQ,CAAA;AAAA,EACzD,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAEV,EAAA,OAAO,OAAA;AACT;;;AC7BO,IAAM,iBAAA,GAAoB;AASjC,SAAS,oBAAoB,UAAA,EAA4B;AACvD,EAAA,OAAO,CAAA,YAAA,EAAe,aAAa,CAAC,CAAA,GAAA,CAAA;AACtC;AAEO,SAAS,WAAA,CAAY;AAAA,EAC1B,UAAA,GAAa,iBAAA;AAAA,EACb,YAAA,GAAe;AACjB,CAAA,GAAwB,EAAC,EAAY;AACnC,EAAA,OAAO,cAAc,mBAAA,CAAoB,UAAU,CAAA,EAAG,EAAE,cAAc,CAAA;AACxE","file":"use-mobile.cjs","sourcesContent":["import { useEffect, useState } from 'react';\r\n\r\nexport interface UseMediaQueryOptions {\r\n  /** Value returned during SSR and before the first browser measurement. */\r\n  defaultValue?: boolean;\r\n}\r\n\r\nfunction getMatches(query: string, defaultValue: boolean): boolean {\r\n  if (typeof window === 'undefined') return defaultValue;\r\n  return window.matchMedia(query).matches;\r\n}\r\n\r\n/**\r\n * Subscribe to a CSS media query.\r\n */\r\nexport function useMediaQuery(\r\n  query: string,\r\n  { defaultValue = false }: UseMediaQueryOptions = {},\r\n): boolean {\r\n  const [matches, setMatches] = useState<boolean>(() => getMatches(query, defaultValue));\r\n\r\n  useEffect(() => {\r\n    const mql = window.matchMedia(query);\r\n    const onChange = () => setMatches(mql.matches);\r\n\r\n    setMatches(mql.matches);\r\n    mql.addEventListener('change', onChange);\r\n    return () => mql.removeEventListener('change', onChange);\r\n  }, [query]);\r\n\r\n  return matches;\r\n}\r\n","import { useMediaQuery } from './use-media-query';\r\n\r\nexport const MOBILE_BREAKPOINT = 768;\r\n\r\nexport interface UseIsMobileOptions {\r\n  /** Pixel breakpoint below which the viewport is considered mobile. */\r\n  breakpoint?: number;\r\n  /** Value returned during SSR and before the first browser measurement. */\r\n  defaultValue?: boolean;\r\n}\r\n\r\nfunction getMobileMediaQuery(breakpoint: number): string {\r\n  return `(max-width: ${breakpoint - 1}px)`;\r\n}\r\n\r\nexport function useIsMobile({\r\n  breakpoint = MOBILE_BREAKPOINT,\r\n  defaultValue = false,\r\n}: UseIsMobileOptions = {}): boolean {\r\n  return useMediaQuery(getMobileMediaQuery(breakpoint), { defaultValue });\r\n}\r\n"]}

package/dist/use-mobile.d.cts

@@ -0,0 +1,10 @@
+declare const MOBILE_BREAKPOINT = 768;
+interface UseIsMobileOptions {
+    /** Pixel breakpoint below which the viewport is considered mobile. */
+    breakpoint?: number;
+    /** Value returned during SSR and before the first browser measurement. */
+    defaultValue?: boolean;
+}
+declare function useIsMobile({ breakpoint, defaultValue, }?: UseIsMobileOptions): boolean;
+
+export { MOBILE_BREAKPOINT, type UseIsMobileOptions, useIsMobile };

package/dist/use-mobile.d.ts

@@ -0,0 +1,10 @@
+declare const MOBILE_BREAKPOINT = 768;
+interface UseIsMobileOptions {
+    /** Pixel breakpoint below which the viewport is considered mobile. */
+    breakpoint?: number;
+    /** Value returned during SSR and before the first browser measurement. */
+    defaultValue?: boolean;
+}
+declare function useIsMobile({ breakpoint, defaultValue, }?: UseIsMobileOptions): boolean;
+
+export { MOBILE_BREAKPOINT, type UseIsMobileOptions, useIsMobile };

package/dist/use-mobile.js

@@ -0,0 +1,34 @@
+import { useState, useEffect } from 'react';
+
+// use-media-query.ts
+function getMatches(query, defaultValue) {
+  if (typeof window === "undefined") return defaultValue;
+  return window.matchMedia(query).matches;
+}
+function useMediaQuery(query, { defaultValue = false } = {}) {
+  const [matches, setMatches] = useState(() => getMatches(query, defaultValue));
+  useEffect(() => {
+    const mql = window.matchMedia(query);
+    const onChange = () => setMatches(mql.matches);
+    setMatches(mql.matches);
+    mql.addEventListener("change", onChange);
+    return () => mql.removeEventListener("change", onChange);
+  }, [query]);
+  return matches;
+}
+
+// use-mobile.ts
+var MOBILE_BREAKPOINT = 768;
+function getMobileMediaQuery(breakpoint) {
+  return `(max-width: ${breakpoint - 1}px)`;
+}
+function useIsMobile({
+  breakpoint = MOBILE_BREAKPOINT,
+  defaultValue = false
+} = {}) {
+  return useMediaQuery(getMobileMediaQuery(breakpoint), { defaultValue });
+}
+
+export { MOBILE_BREAKPOINT, useIsMobile };
+//# sourceMappingURL=use-mobile.js.map
+//# sourceMappingURL=use-mobile.js.map

package/dist/use-mobile.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../use-media-query.ts","../use-mobile.ts"],"names":[],"mappings":";;;AAOA,SAAS,UAAA,CAAW,OAAe,YAAA,EAAgC;AACjE,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,EAAa,OAAO,YAAA;AAC1C,EAAA,OAAO,MAAA,CAAO,UAAA,CAAW,KAAK,CAAA,CAAE,OAAA;AAClC;AAKO,SAAS,cACd,KAAA,EACA,EAAE,eAAe,KAAA,EAAM,GAA0B,EAAC,EACzC;AACT,EAAA,MAAM,CAAC,SAAS,UAAU,CAAA,GAAI,SAAkB,MAAM,UAAA,CAAW,KAAA,EAAO,YAAY,CAAC,CAAA;AAErF,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,MAAM,GAAA,GAAM,MAAA,CAAO,UAAA,CAAW,KAAK,CAAA;AACnC,IAAA,MAAM,QAAA,GAAW,MAAM,UAAA,CAAW,GAAA,CAAI,OAAO,CAAA;AAE7C,IAAA,UAAA,CAAW,IAAI,OAAO,CAAA;AACtB,IAAA,GAAA,CAAI,gBAAA,CAAiB,UAAU,QAAQ,CAAA;AACvC,IAAA,OAAO,MAAM,GAAA,CAAI,mBAAA,CAAoB,QAAA,EAAU,QAAQ,CAAA;AAAA,EACzD,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAEV,EAAA,OAAO,OAAA;AACT;;;AC7BO,IAAM,iBAAA,GAAoB;AASjC,SAAS,oBAAoB,UAAA,EAA4B;AACvD,EAAA,OAAO,CAAA,YAAA,EAAe,aAAa,CAAC,CAAA,GAAA,CAAA;AACtC;AAEO,SAAS,WAAA,CAAY;AAAA,EAC1B,UAAA,GAAa,iBAAA;AAAA,EACb,YAAA,GAAe;AACjB,CAAA,GAAwB,EAAC,EAAY;AACnC,EAAA,OAAO,cAAc,mBAAA,CAAoB,UAAU,CAAA,EAAG,EAAE,cAAc,CAAA;AACxE","file":"use-mobile.js","sourcesContent":["import { useEffect, useState } from 'react';\r\n\r\nexport interface UseMediaQueryOptions {\r\n  /** Value returned during SSR and before the first browser measurement. */\r\n  defaultValue?: boolean;\r\n}\r\n\r\nfunction getMatches(query: string, defaultValue: boolean): boolean {\r\n  if (typeof window === 'undefined') return defaultValue;\r\n  return window.matchMedia(query).matches;\r\n}\r\n\r\n/**\r\n * Subscribe to a CSS media query.\r\n */\r\nexport function useMediaQuery(\r\n  query: string,\r\n  { defaultValue = false }: UseMediaQueryOptions = {},\r\n): boolean {\r\n  const [matches, setMatches] = useState<boolean>(() => getMatches(query, defaultValue));\r\n\r\n  useEffect(() => {\r\n    const mql = window.matchMedia(query);\r\n    const onChange = () => setMatches(mql.matches);\r\n\r\n    setMatches(mql.matches);\r\n    mql.addEventListener('change', onChange);\r\n    return () => mql.removeEventListener('change', onChange);\r\n  }, [query]);\r\n\r\n  return matches;\r\n}\r\n","import { useMediaQuery } from './use-media-query';\r\n\r\nexport const MOBILE_BREAKPOINT = 768;\r\n\r\nexport interface UseIsMobileOptions {\r\n  /** Pixel breakpoint below which the viewport is considered mobile. */\r\n  breakpoint?: number;\r\n  /** Value returned during SSR and before the first browser measurement. */\r\n  defaultValue?: boolean;\r\n}\r\n\r\nfunction getMobileMediaQuery(breakpoint: number): string {\r\n  return `(max-width: ${breakpoint - 1}px)`;\r\n}\r\n\r\nexport function useIsMobile({\r\n  breakpoint = MOBILE_BREAKPOINT,\r\n  defaultValue = false,\r\n}: UseIsMobileOptions = {}): boolean {\r\n  return useMediaQuery(getMobileMediaQuery(breakpoint), { defaultValue });\r\n}\r\n"]}