@usels/core 0.0.1

package/dist/sensors/useScroll/index.mjs

@@ -0,0 +1,125 @@
+"use client";
+import { useMount, useObservable } from "@legendapp/state/react";
+import { useMemo, useRef } from "react";
+import { throttle } from "es-toolkit";
+import { peekElement } from "../../elements/useRef$";
+import { isWindow } from "../../shared";
+import { useEventListener } from "../../browser/useEventListener";
+function getScrollValues(el) {
+  if (!el) return { x: 0, y: 0 };
+  if (isWindow(el)) return { x: el.scrollX, y: el.scrollY };
+  if (el instanceof Document)
+    return {
+      x: el.documentElement.scrollLeft,
+      y: el.documentElement.scrollTop
+    };
+  return { x: el.scrollLeft, y: el.scrollTop };
+}
+function getScrollDimensions(el) {
+  if (!el || isWindow(el)) {
+    return {
+      scrollW: document.documentElement.scrollWidth,
+      scrollH: document.documentElement.scrollHeight,
+      clientW: window.innerWidth,
+      clientH: window.innerHeight
+    };
+  }
+  if (el instanceof Document) {
+    const root = el.documentElement;
+    return {
+      scrollW: root.scrollWidth,
+      scrollH: root.scrollHeight,
+      clientW: root.clientWidth,
+      clientH: root.clientHeight
+    };
+  }
+  return {
+    scrollW: el.scrollWidth,
+    scrollH: el.scrollHeight,
+    clientW: el.clientWidth,
+    clientH: el.clientHeight
+  };
+}
+function useScroll(element, options) {
+  const initial = getScrollValues(peekElement(element));
+  const x$ = useObservable(initial.x);
+  const y$ = useObservable(initial.y);
+  const isScrolling$ = useObservable(false);
+  const arrivedState$ = useObservable({
+    left: true,
+    right: false,
+    top: true,
+    bottom: false
+  });
+  const directions$ = useObservable({
+    left: false,
+    right: false,
+    top: false,
+    bottom: false
+  });
+  const idleTimer = useRef(null);
+  const resetIdle = () => {
+    if (idleTimer.current) clearTimeout(idleTimer.current);
+    isScrolling$.set(true);
+    idleTimer.current = setTimeout(() => {
+      isScrolling$.set(false);
+      options?.onStop?.();
+    }, options?.idle ?? 200);
+  };
+  const measure = () => {
+    const el = peekElement(element);
+    if (!el) return;
+    const prevX = x$.peek();
+    const prevY = y$.peek();
+    const { x: newX, y: newY } = getScrollValues(el);
+    directions$.assign({
+      left: newX < prevX,
+      right: newX > prevX,
+      top: newY < prevY,
+      bottom: newY > prevY
+    });
+    x$.set(newX);
+    y$.set(newY);
+    const { scrollW, scrollH, clientW, clientH } = getScrollDimensions(el);
+    const maxX = scrollW - clientW;
+    const maxY = scrollH - clientH;
+    const offset = options?.offset ?? {};
+    arrivedState$.assign({
+      left: newX <= (offset.left ?? 0),
+      right: newX >= maxX - (offset.right ?? 0),
+      top: newY <= (offset.top ?? 0),
+      bottom: newY >= maxY - (offset.bottom ?? 0)
+    });
+    resetIdle();
+  };
+  const measureRef = useRef(measure);
+  measureRef.current = measure;
+  const handler = useMemo(() => {
+    const ms = options?.throttle ?? 0;
+    return ms > 0 ? throttle(() => measureRef.current(), ms) : () => measureRef.current();
+  }, []);
+  useEventListener(
+    element,
+    "scroll",
+    handler,
+    options?.eventListenerOptions ?? { capture: false, passive: true }
+  );
+  useMount(() => {
+    measure();
+    return () => {
+      if (idleTimer.current) clearTimeout(idleTimer.current);
+    };
+  });
+  return {
+    x: x$,
+    y: y$,
+    isScrolling: isScrolling$,
+    arrivedState: arrivedState$,
+    directions: directions$,
+    measure
+  };
+}
+export {
+  useScroll
+};
+//# sourceMappingURL=index.mjs.map

package/dist/sensors/useScroll/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/sensors/useScroll/index.ts"],"sourcesContent":["\"use client\";\nimport type { Observable } from \"@legendapp/state\";\nimport { useMount, useObservable } from \"@legendapp/state/react\";\nimport { useMemo, useRef } from \"react\";\nimport { throttle } from \"es-toolkit\";\nimport { type MaybeElement, peekElement } from \"../../elements/useRef$\";\nimport { isWindow } from \"../../shared\";\nimport type { MaybeObservable } from \"../../types\";\nimport { useEventListener } from \"../../browser/useEventListener\";\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface UseScrollOptions {\n  throttle?: number;\n  idle?: number;\n  onStop?: () => void;\n  onError?: (error: unknown) => void;\n  offset?: {\n    left?: number;\n    right?: number;\n    top?: number;\n    bottom?: number;\n  };\n  behavior?: ScrollBehavior;\n  eventListenerOptions?: MaybeObservable<AddEventListenerOptions>;\n}\n\nexport interface ArrivedState {\n  left: boolean;\n  right: boolean;\n  top: boolean;\n  bottom: boolean;\n}\n\nexport interface ScrollDirections {\n  left: boolean;\n  right: boolean;\n  top: boolean;\n  bottom: boolean;\n}\n\nexport interface UseScrollReturn {\n  x: Observable<number>;\n  y: Observable<number>;\n  isScrolling: Observable<boolean>;\n  arrivedState: Observable<ArrivedState>;\n  directions: Observable<ScrollDirections>;\n  measure: () => void;\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction getScrollValues(el: HTMLElement | Document | Window | null): {\n  x: number;\n  y: number;\n} {\n  if (!el) return { x: 0, y: 0 };\n  if (isWindow(el)) return { x: el.scrollX, y: el.scrollY };\n  if (el instanceof Document)\n    return {\n      x: el.documentElement.scrollLeft,\n      y: el.documentElement.scrollTop,\n    };\n  return { x: el.scrollLeft, y: el.scrollTop };\n}\n\nfunction getScrollDimensions(el: HTMLElement | Document | Window | null): {\n  scrollW: number;\n  scrollH: number;\n  clientW: number;\n  clientH: number;\n} {\n  if (!el || isWindow(el)) {\n    return {\n      scrollW: document.documentElement.scrollWidth,\n      scrollH: document.documentElement.scrollHeight,\n      clientW: window.innerWidth,\n      clientH: window.innerHeight,\n    };\n  }\n  if (el instanceof Document) {\n    const root = el.documentElement;\n    return {\n      scrollW: root.scrollWidth,\n      scrollH: root.scrollHeight,\n      clientW: root.clientWidth,\n      clientH: root.clientHeight,\n    };\n  }\n  return {\n    scrollW: el.scrollWidth,\n    scrollH: el.scrollHeight,\n    clientW: el.clientWidth,\n    clientH: el.clientHeight,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Hook\n// ---------------------------------------------------------------------------\n\nexport function useScroll(\n  element: MaybeElement,\n  options?: UseScrollOptions,\n): UseScrollReturn {\n  const initial = getScrollValues(peekElement(element));\n\n  const x$ = useObservable<number>(initial.x);\n  const y$ = useObservable<number>(initial.y);\n  const isScrolling$ = useObservable<boolean>(false);\n  const arrivedState$ = useObservable<ArrivedState>({\n    left: true,\n    right: false,\n    top: true,\n    bottom: false,\n  });\n  const directions$ = useObservable<ScrollDirections>({\n    left: false,\n    right: false,\n    top: false,\n    bottom: false,\n  });\n\n  const idleTimer = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  const resetIdle = () => {\n    if (idleTimer.current) clearTimeout(idleTimer.current);\n    isScrolling$.set(true);\n    idleTimer.current = setTimeout(() => {\n      isScrolling$.set(false);\n      options?.onStop?.();\n    }, options?.idle ?? 200);\n  };\n\n  const measure = () => {\n    const el = peekElement(element);\n    if (!el) return;\n\n    const prevX = x$.peek();\n    const prevY = y$.peek();\n    const { x: newX, y: newY } = getScrollValues(el);\n\n    directions$.assign({\n      left: newX < prevX,\n      right: newX > prevX,\n      top: newY < prevY,\n      bottom: newY > prevY,\n    });\n\n    x$.set(newX);\n    y$.set(newY);\n\n    const { scrollW, scrollH, clientW, clientH } = getScrollDimensions(el);\n    const maxX = scrollW - clientW;\n    const maxY = scrollH - clientH;\n    const offset = options?.offset ?? {};\n\n    arrivedState$.assign({\n      left: newX <= (offset.left ?? 0),\n      right: newX >= maxX - (offset.right ?? 0),\n      top: newY <= (offset.top ?? 0),\n      bottom: newY >= maxY - (offset.bottom ?? 0),\n    });\n\n    resetIdle();\n  };\n\n  const measureRef = useRef(measure);\n  measureRef.current = measure;\n\n  const handler = useMemo(() => {\n    const ms = options?.throttle ?? 0;\n    return ms > 0\n      ? throttle(() => measureRef.current(), ms)\n      : () => measureRef.current();\n  }, []); // eslint-disable-line react-hooks/exhaustive-deps\n\n  useEventListener(element as any, \"scroll\", handler,\n    options?.eventListenerOptions ?? { capture: false, passive: true },\n  );\n\n  useMount(() => {\n    measure();\n    return () => {\n      if (idleTimer.current) clearTimeout(idleTimer.current);\n    };\n  });\n\n  return {\n    x: x$,\n    y: y$,\n    isScrolling: isScrolling$,\n    arrivedState: arrivedState$,\n    directions: directions$,\n    measure,\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/sensors/useWindowScroll/demo.d.mts

@@ -0,0 +1,5 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+declare function UseWindowScrollDemo(): react_jsx_runtime.JSX.Element;
+
+export { UseWindowScrollDemo as default };

package/dist/sensors/useWindowScroll/demo.d.ts

@@ -0,0 +1,5 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+declare function UseWindowScrollDemo(): react_jsx_runtime.JSX.Element;
+
+export { UseWindowScrollDemo as default };

package/dist/sensors/useWindowScroll/demo.js

@@ -0,0 +1,85 @@
+"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);
+var demo_exports = {};
+__export(demo_exports, {
+  default: () => UseWindowScrollDemo
+});
+module.exports = __toCommonJS(demo_exports);
+var import_jsx_runtime = require("react/jsx-runtime");
+var import_react = require("@legendapp/state/react");
+var import__ = require(".");
+const card = {
+  display: "flex",
+  flexWrap: "wrap",
+  gap: "16px",
+  padding: "10px 14px",
+  borderRadius: "6px",
+  border: "1px solid var(--sl-color-gray-5, #e2e8f0)",
+  background: "var(--sl-color-gray-6, #f8fafc)",
+  fontFamily: "monospace",
+  fontSize: "13px"
+};
+const chip = (active) => ({
+  padding: "2px 8px",
+  borderRadius: "4px",
+  background: active ? "var(--sl-color-green-low, #f0fdf4)" : "var(--sl-color-gray-5, #f1f5f9)",
+  color: active ? "var(--sl-color-green, #16a34a)" : "var(--sl-color-gray-3, #64748b)",
+  border: `1px solid ${active ? "var(--sl-color-green, #22c55e)" : "var(--sl-color-gray-5, #e2e8f0)"}`,
+  transition: "all 0.15s"
+});
+function UseWindowScrollDemo() {
+  const { x, y, isScrolling, arrivedState, directions } = (0, import__.useWindowScroll)();
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: { display: "flex", flexDirection: "column", gap: "8px" }, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react.Computed, { children: () => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: card, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", { children: [
+        "x: ",
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("strong", { children: x.get() })
+      ] }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", { children: [
+        "y: ",
+        /* @__PURE__ */ (0, import_jsx_runtime.jsx)("strong", { children: y.get() })
+      ] }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: chip(isScrolling.get()), children: isScrolling.get() ? "scrolling" : "idle" })
+    ] }) }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react.Computed, { children: () => /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { style: card, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: chip(arrivedState.top.get()), children: "top" }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: chip(arrivedState.bottom.get()), children: "bottom" }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: chip(arrivedState.left.get()), children: "left" }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsx)("span", { style: chip(arrivedState.right.get()), children: "right" }),
+      /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("span", { style: { color: "var(--sl-color-gray-3, #94a3b8)" }, children: [
+        directions.top.get() && "\u2191 ",
+        directions.bottom.get() && "\u2193 ",
+        directions.left.get() && "\u2190 ",
+        directions.right.get() && "\u2192 "
+      ] })
+    ] }) }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+      "p",
+      {
+        style: {
+          margin: 0,
+          fontSize: "11px",
+          color: "var(--sl-color-gray-3, #94a3b8)"
+        },
+        children: "Scroll the page to see the values update in real time."
+      }
+    )
+  ] });
+}
+//# sourceMappingURL=demo.js.map

package/dist/sensors/useWindowScroll/demo.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/sensors/useWindowScroll/demo.tsx"],"sourcesContent":["import { Computed } from \"@legendapp/state/react\";\nimport { useWindowScroll } from \".\";\n\nconst card: React.CSSProperties = {\n  display: \"flex\",\n  flexWrap: \"wrap\",\n  gap: \"16px\",\n  padding: \"10px 14px\",\n  borderRadius: \"6px\",\n  border: \"1px solid var(--sl-color-gray-5, #e2e8f0)\",\n  background: \"var(--sl-color-gray-6, #f8fafc)\",\n  fontFamily: \"monospace\",\n  fontSize: \"13px\",\n};\n\nconst chip = (active: boolean): React.CSSProperties => ({\n  padding: \"2px 8px\",\n  borderRadius: \"4px\",\n  background: active\n    ? \"var(--sl-color-green-low, #f0fdf4)\"\n    : \"var(--sl-color-gray-5, #f1f5f9)\",\n  color: active\n    ? \"var(--sl-color-green, #16a34a)\"\n    : \"var(--sl-color-gray-3, #64748b)\",\n  border: `1px solid ${active ? \"var(--sl-color-green, #22c55e)\" : \"var(--sl-color-gray-5, #e2e8f0)\"}`,\n  transition: \"all 0.15s\",\n});\n\nexport default function UseWindowScrollDemo() {\n  const { x, y, isScrolling, arrivedState, directions } = useWindowScroll();\n\n  return (\n    <div style={{ display: \"flex\", flexDirection: \"column\", gap: \"8px\" }}>\n      <Computed>\n        {() => (\n          <div style={card}>\n            <span>\n              x: <strong>{x.get()}</strong>\n            </span>\n            <span>\n              y: <strong>{y.get()}</strong>\n            </span>\n            <span style={chip(isScrolling.get())}>\n              {isScrolling.get() ? \"scrolling\" : \"idle\"}\n            </span>\n          </div>\n        )}\n      </Computed>\n\n      <Computed>\n        {() => (\n          <div style={card}>\n            <span style={chip(arrivedState.top.get())}>top</span>\n            <span style={chip(arrivedState.bottom.get())}>bottom</span>\n            <span style={chip(arrivedState.left.get())}>left</span>\n            <span style={chip(arrivedState.right.get())}>right</span>\n            <span style={{ color: \"var(--sl-color-gray-3, #94a3b8)\" }}>\n              {directions.top.get() && \"↑ \"}\n              {directions.bottom.get() && \"↓ \"}\n              {directions.left.get() && \"← \"}\n              {directions.right.get() && \"→ \"}\n            </span>\n          </div>\n        )}\n      </Computed>\n\n      <p\n        style={{\n          margin: 0,\n          fontSize: \"11px\",\n          color: \"var(--sl-color-gray-3, #94a3b8)\",\n        }}\n      >\n        Scroll the page to see the values update in real time.\n      </p>\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAoCY;AApCZ,mBAAyB;AACzB,eAAgC;AAEhC,MAAM,OAA4B;AAAA,EAChC,SAAS;AAAA,EACT,UAAU;AAAA,EACV,KAAK;AAAA,EACL,SAAS;AAAA,EACT,cAAc;AAAA,EACd,QAAQ;AAAA,EACR,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,UAAU;AACZ;AAEA,MAAM,OAAO,CAAC,YAA0C;AAAA,EACtD,SAAS;AAAA,EACT,cAAc;AAAA,EACd,YAAY,SACR,uCACA;AAAA,EACJ,OAAO,SACH,mCACA;AAAA,EACJ,QAAQ,aAAa,SAAS,mCAAmC,iCAAiC;AAAA,EAClG,YAAY;AACd;AAEe,SAAR,sBAAuC;AAC5C,QAAM,EAAE,GAAG,GAAG,aAAa,cAAc,WAAW,QAAI,0BAAgB;AAExE,SACE,6CAAC,SAAI,OAAO,EAAE,SAAS,QAAQ,eAAe,UAAU,KAAK,MAAM,GACjE;AAAA,gDAAC,yBACE,gBACC,6CAAC,SAAI,OAAO,MACV;AAAA,mDAAC,UAAK;AAAA;AAAA,QACD,4CAAC,YAAQ,YAAE,IAAI,GAAE;AAAA,SACtB;AAAA,MACA,6CAAC,UAAK;AAAA;AAAA,QACD,4CAAC,YAAQ,YAAE,IAAI,GAAE;AAAA,SACtB;AAAA,MACA,4CAAC,UAAK,OAAO,KAAK,YAAY,IAAI,CAAC,GAChC,sBAAY,IAAI,IAAI,cAAc,QACrC;AAAA,OACF,GAEJ;AAAA,IAEA,4CAAC,yBACE,gBACC,6CAAC,SAAI,OAAO,MACV;AAAA,kDAAC,UAAK,OAAO,KAAK,aAAa,IAAI,IAAI,CAAC,GAAG,iBAAG;AAAA,MAC9C,4CAAC,UAAK,OAAO,KAAK,aAAa,OAAO,IAAI,CAAC,GAAG,oBAAM;AAAA,MACpD,4CAAC,UAAK,OAAO,KAAK,aAAa,KAAK,IAAI,CAAC,GAAG,kBAAI;AAAA,MAChD,4CAAC,UAAK,OAAO,KAAK,aAAa,MAAM,IAAI,CAAC,GAAG,mBAAK;AAAA,MAClD,6CAAC,UAAK,OAAO,EAAE,OAAO,kCAAkC,GACrD;AAAA,mBAAW,IAAI,IAAI,KAAK;AAAA,QACxB,WAAW,OAAO,IAAI,KAAK;AAAA,QAC3B,WAAW,KAAK,IAAI,KAAK;AAAA,QACzB,WAAW,MAAM,IAAI,KAAK;AAAA,SAC7B;AAAA,OACF,GAEJ;AAAA,IAEA;AAAA,MAAC;AAAA;AAAA,QACC,OAAO;AAAA,UACL,QAAQ;AAAA,UACR,UAAU;AAAA,UACV,OAAO;AAAA,QACT;AAAA,QACD;AAAA;AAAA,IAED;AAAA,KACF;AAEJ;","names":[]}

package/dist/sensors/useWindowScroll/demo.mjs

@@ -0,0 +1,65 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Computed } from "@legendapp/state/react";
+import { useWindowScroll } from ".";
+const card = {
+  display: "flex",
+  flexWrap: "wrap",
+  gap: "16px",
+  padding: "10px 14px",
+  borderRadius: "6px",
+  border: "1px solid var(--sl-color-gray-5, #e2e8f0)",
+  background: "var(--sl-color-gray-6, #f8fafc)",
+  fontFamily: "monospace",
+  fontSize: "13px"
+};
+const chip = (active) => ({
+  padding: "2px 8px",
+  borderRadius: "4px",
+  background: active ? "var(--sl-color-green-low, #f0fdf4)" : "var(--sl-color-gray-5, #f1f5f9)",
+  color: active ? "var(--sl-color-green, #16a34a)" : "var(--sl-color-gray-3, #64748b)",
+  border: `1px solid ${active ? "var(--sl-color-green, #22c55e)" : "var(--sl-color-gray-5, #e2e8f0)"}`,
+  transition: "all 0.15s"
+});
+function UseWindowScrollDemo() {
+  const { x, y, isScrolling, arrivedState, directions } = useWindowScroll();
+  return /* @__PURE__ */ jsxs("div", { style: { display: "flex", flexDirection: "column", gap: "8px" }, children: [
+    /* @__PURE__ */ jsx(Computed, { children: () => /* @__PURE__ */ jsxs("div", { style: card, children: [
+      /* @__PURE__ */ jsxs("span", { children: [
+        "x: ",
+        /* @__PURE__ */ jsx("strong", { children: x.get() })
+      ] }),
+      /* @__PURE__ */ jsxs("span", { children: [
+        "y: ",
+        /* @__PURE__ */ jsx("strong", { children: y.get() })
+      ] }),
+      /* @__PURE__ */ jsx("span", { style: chip(isScrolling.get()), children: isScrolling.get() ? "scrolling" : "idle" })
+    ] }) }),
+    /* @__PURE__ */ jsx(Computed, { children: () => /* @__PURE__ */ jsxs("div", { style: card, children: [
+      /* @__PURE__ */ jsx("span", { style: chip(arrivedState.top.get()), children: "top" }),
+      /* @__PURE__ */ jsx("span", { style: chip(arrivedState.bottom.get()), children: "bottom" }),
+      /* @__PURE__ */ jsx("span", { style: chip(arrivedState.left.get()), children: "left" }),
+      /* @__PURE__ */ jsx("span", { style: chip(arrivedState.right.get()), children: "right" }),
+      /* @__PURE__ */ jsxs("span", { style: { color: "var(--sl-color-gray-3, #94a3b8)" }, children: [
+        directions.top.get() && "\u2191 ",
+        directions.bottom.get() && "\u2193 ",
+        directions.left.get() && "\u2190 ",
+        directions.right.get() && "\u2192 "
+      ] })
+    ] }) }),
+    /* @__PURE__ */ jsx(
+      "p",
+      {
+        style: {
+          margin: 0,
+          fontSize: "11px",
+          color: "var(--sl-color-gray-3, #94a3b8)"
+        },
+        children: "Scroll the page to see the values update in real time."
+      }
+    )
+  ] });
+}
+export {
+  UseWindowScrollDemo as default
+};
+//# sourceMappingURL=demo.mjs.map

package/dist/sensors/useWindowScroll/demo.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/sensors/useWindowScroll/demo.tsx"],"sourcesContent":["import { Computed } from \"@legendapp/state/react\";\nimport { useWindowScroll } from \".\";\n\nconst card: React.CSSProperties = {\n  display: \"flex\",\n  flexWrap: \"wrap\",\n  gap: \"16px\",\n  padding: \"10px 14px\",\n  borderRadius: \"6px\",\n  border: \"1px solid var(--sl-color-gray-5, #e2e8f0)\",\n  background: \"var(--sl-color-gray-6, #f8fafc)\",\n  fontFamily: \"monospace\",\n  fontSize: \"13px\",\n};\n\nconst chip = (active: boolean): React.CSSProperties => ({\n  padding: \"2px 8px\",\n  borderRadius: \"4px\",\n  background: active\n    ? \"var(--sl-color-green-low, #f0fdf4)\"\n    : \"var(--sl-color-gray-5, #f1f5f9)\",\n  color: active\n    ? \"var(--sl-color-green, #16a34a)\"\n    : \"var(--sl-color-gray-3, #64748b)\",\n  border: `1px solid ${active ? \"var(--sl-color-green, #22c55e)\" : \"var(--sl-color-gray-5, #e2e8f0)\"}`,\n  transition: \"all 0.15s\",\n});\n\nexport default function UseWindowScrollDemo() {\n  const { x, y, isScrolling, arrivedState, directions } = useWindowScroll();\n\n  return (\n    <div style={{ display: \"flex\", flexDirection: \"column\", gap: \"8px\" }}>\n      <Computed>\n        {() => (\n          <div style={card}>\n            <span>\n              x: <strong>{x.get()}</strong>\n            </span>\n            <span>\n              y: <strong>{y.get()}</strong>\n            </span>\n            <span style={chip(isScrolling.get())}>\n              {isScrolling.get() ? \"scrolling\" : \"idle\"}\n            </span>\n          </div>\n        )}\n      </Computed>\n\n      <Computed>\n        {() => (\n          <div style={card}>\n            <span style={chip(arrivedState.top.get())}>top</span>\n            <span style={chip(arrivedState.bottom.get())}>bottom</span>\n            <span style={chip(arrivedState.left.get())}>left</span>\n            <span style={chip(arrivedState.right.get())}>right</span>\n            <span style={{ color: \"var(--sl-color-gray-3, #94a3b8)\" }}>\n              {directions.top.get() && \"↑ \"}\n              {directions.bottom.get() && \"↓ \"}\n              {directions.left.get() && \"← \"}\n              {directions.right.get() && \"→ \"}\n            </span>\n          </div>\n        )}\n      </Computed>\n\n      <p\n        style={{\n          margin: 0,\n          fontSize: \"11px\",\n          color: \"var(--sl-color-gray-3, #94a3b8)\",\n        }}\n      >\n        Scroll the page to see the values update in real time.\n      </p>\n    </div>\n  );\n}\n"],"mappings":"AAoCY,SACK,KADL;AApCZ,SAAS,gBAAgB;AACzB,SAAS,uBAAuB;AAEhC,MAAM,OAA4B;AAAA,EAChC,SAAS;AAAA,EACT,UAAU;AAAA,EACV,KAAK;AAAA,EACL,SAAS;AAAA,EACT,cAAc;AAAA,EACd,QAAQ;AAAA,EACR,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,UAAU;AACZ;AAEA,MAAM,OAAO,CAAC,YAA0C;AAAA,EACtD,SAAS;AAAA,EACT,cAAc;AAAA,EACd,YAAY,SACR,uCACA;AAAA,EACJ,OAAO,SACH,mCACA;AAAA,EACJ,QAAQ,aAAa,SAAS,mCAAmC,iCAAiC;AAAA,EAClG,YAAY;AACd;AAEe,SAAR,sBAAuC;AAC5C,QAAM,EAAE,GAAG,GAAG,aAAa,cAAc,WAAW,IAAI,gBAAgB;AAExE,SACE,qBAAC,SAAI,OAAO,EAAE,SAAS,QAAQ,eAAe,UAAU,KAAK,MAAM,GACjE;AAAA,wBAAC,YACE,gBACC,qBAAC,SAAI,OAAO,MACV;AAAA,2BAAC,UAAK;AAAA;AAAA,QACD,oBAAC,YAAQ,YAAE,IAAI,GAAE;AAAA,SACtB;AAAA,MACA,qBAAC,UAAK;AAAA;AAAA,QACD,oBAAC,YAAQ,YAAE,IAAI,GAAE;AAAA,SACtB;AAAA,MACA,oBAAC,UAAK,OAAO,KAAK,YAAY,IAAI,CAAC,GAChC,sBAAY,IAAI,IAAI,cAAc,QACrC;AAAA,OACF,GAEJ;AAAA,IAEA,oBAAC,YACE,gBACC,qBAAC,SAAI,OAAO,MACV;AAAA,0BAAC,UAAK,OAAO,KAAK,aAAa,IAAI,IAAI,CAAC,GAAG,iBAAG;AAAA,MAC9C,oBAAC,UAAK,OAAO,KAAK,aAAa,OAAO,IAAI,CAAC,GAAG,oBAAM;AAAA,MACpD,oBAAC,UAAK,OAAO,KAAK,aAAa,KAAK,IAAI,CAAC,GAAG,kBAAI;AAAA,MAChD,oBAAC,UAAK,OAAO,KAAK,aAAa,MAAM,IAAI,CAAC,GAAG,mBAAK;AAAA,MAClD,qBAAC,UAAK,OAAO,EAAE,OAAO,kCAAkC,GACrD;AAAA,mBAAW,IAAI,IAAI,KAAK;AAAA,QACxB,WAAW,OAAO,IAAI,KAAK;AAAA,QAC3B,WAAW,KAAK,IAAI,KAAK;AAAA,QACzB,WAAW,MAAM,IAAI,KAAK;AAAA,SAC7B;AAAA,OACF,GAEJ;AAAA,IAEA;AAAA,MAAC;AAAA;AAAA,QACC,OAAO;AAAA,UACL,QAAQ;AAAA,UACR,UAAU;AAAA,UACV,OAAO;AAAA,QACT;AAAA,QACD;AAAA;AAAA,IAED;AAAA,KACF;AAEJ;","names":[]}

package/dist/sensors/useWindowScroll/index.d.mts

@@ -0,0 +1,9 @@
+import { UseScrollOptions, UseScrollReturn } from '../useScroll/index.mjs';
+import '@legendapp/state';
+import '../../elements/useRef_/index.mjs';
+import 'react';
+import '../../types.mjs';
+
+declare function useWindowScroll(options?: UseScrollOptions): UseScrollReturn;
+
+export { UseScrollOptions, UseScrollReturn, useWindowScroll };

package/dist/sensors/useWindowScroll/index.d.ts

@@ -0,0 +1,9 @@
+import { UseScrollOptions, UseScrollReturn } from '../useScroll/index.js';
+import '@legendapp/state';
+import '../../elements/useRef_/index.js';
+import 'react';
+import '../../types.js';
+
+declare function useWindowScroll(options?: UseScrollOptions): UseScrollReturn;
+
+export { UseScrollOptions, UseScrollReturn, useWindowScroll };

package/dist/sensors/useWindowScroll/index.js

@@ -0,0 +1,36 @@
+"use strict";
+"use client";
+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);
+var useWindowScroll_exports = {};
+__export(useWindowScroll_exports, {
+  useWindowScroll: () => useWindowScroll
+});
+module.exports = __toCommonJS(useWindowScroll_exports);
+var import_useScroll = require("../useScroll");
+function useWindowScroll(options) {
+  return (0, import_useScroll.useScroll)(
+    typeof window !== "undefined" ? window : null,
+    options
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useWindowScroll
+});
+//# sourceMappingURL=index.js.map

package/dist/sensors/useWindowScroll/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/sensors/useWindowScroll/index.ts"],"sourcesContent":["\"use client\";\nimport { type UseScrollOptions, type UseScrollReturn, useScroll } from \"../useScroll\";\n\nexport type { UseScrollOptions, UseScrollReturn };\n\nexport function useWindowScroll(options?: UseScrollOptions): UseScrollReturn {\n  return useScroll(\n    typeof window !== \"undefined\" ? window : null,\n    options,\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,uBAAuE;AAIhE,SAAS,gBAAgB,SAA6C;AAC3E,aAAO;AAAA,IACL,OAAO,WAAW,cAAc,SAAS;AAAA,IACzC;AAAA,EACF;AACF;","names":[]}

package/dist/sensors/useWindowScroll/index.mjs

@@ -0,0 +1,12 @@
+"use client";
+import { useScroll } from "../useScroll";
+function useWindowScroll(options) {
+  return useScroll(
+    typeof window !== "undefined" ? window : null,
+    options
+  );
+}
+export {
+  useWindowScroll
+};
+//# sourceMappingURL=index.mjs.map

package/dist/sensors/useWindowScroll/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/sensors/useWindowScroll/index.ts"],"sourcesContent":["\"use client\";\nimport { type UseScrollOptions, type UseScrollReturn, useScroll } from \"../useScroll\";\n\nexport type { UseScrollOptions, UseScrollReturn };\n\nexport function useWindowScroll(options?: UseScrollOptions): UseScrollReturn {\n  return useScroll(\n    typeof window !== \"undefined\" ? window : null,\n    options,\n  );\n}\n"],"mappings":";AACA,SAAsD,iBAAiB;AAIhE,SAAS,gBAAgB,SAA6C;AAC3E,SAAO;AAAA,IACL,OAAO,WAAW,cAAc,SAAS;AAAA,IACzC;AAAA,EACF;AACF;","names":[]}

package/dist/shared/configurable.d.mts

@@ -0,0 +1,21 @@
+interface ConfigurableWindow {
+    window?: Window;
+}
+interface ConfigurableDocument {
+    document?: Document;
+}
+interface ConfigurableDocumentOrShadowRoot {
+    document?: DocumentOrShadowRoot;
+}
+interface ConfigurableNavigator {
+    navigator?: Navigator;
+}
+interface ConfigurableLocation {
+    location?: Location;
+}
+declare const defaultWindow: (Window & typeof globalThis) | undefined;
+declare const defaultDocument: Document | undefined;
+declare const defaultNavigator: Navigator | undefined;
+declare const defaultLocation: Location | undefined;
+
+export { type ConfigurableDocument, type ConfigurableDocumentOrShadowRoot, type ConfigurableLocation, type ConfigurableNavigator, type ConfigurableWindow, defaultDocument, defaultLocation, defaultNavigator, defaultWindow };

package/dist/shared/configurable.d.ts

@@ -0,0 +1,21 @@
+interface ConfigurableWindow {
+    window?: Window;
+}
+interface ConfigurableDocument {
+    document?: Document;
+}
+interface ConfigurableDocumentOrShadowRoot {
+    document?: DocumentOrShadowRoot;
+}
+interface ConfigurableNavigator {
+    navigator?: Navigator;
+}
+interface ConfigurableLocation {
+    location?: Location;
+}
+declare const defaultWindow: (Window & typeof globalThis) | undefined;
+declare const defaultDocument: Document | undefined;
+declare const defaultNavigator: Navigator | undefined;
+declare const defaultLocation: Location | undefined;
+
+export { type ConfigurableDocument, type ConfigurableDocumentOrShadowRoot, type ConfigurableLocation, type ConfigurableNavigator, type ConfigurableWindow, defaultDocument, defaultLocation, defaultNavigator, defaultWindow };

package/dist/shared/configurable.js

@@ -0,0 +1,39 @@
+"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);
+var configurable_exports = {};
+__export(configurable_exports, {
+  defaultDocument: () => defaultDocument,
+  defaultLocation: () => defaultLocation,
+  defaultNavigator: () => defaultNavigator,
+  defaultWindow: () => defaultWindow
+});
+module.exports = __toCommonJS(configurable_exports);
+var import_utils = require("./utils");
+const defaultWindow = import_utils.isClient ? window : void 0;
+const defaultDocument = import_utils.isClient ? window.document : void 0;
+const defaultNavigator = import_utils.isClient ? window.navigator : void 0;
+const defaultLocation = import_utils.isClient ? window.location : void 0;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defaultDocument,
+  defaultLocation,
+  defaultNavigator,
+  defaultWindow
+});
+//# sourceMappingURL=configurable.js.map

package/dist/shared/configurable.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shared/configurable.ts"],"sourcesContent":["import { isClient } from \"./utils\";\n\nexport interface ConfigurableWindow {\n  window?: Window;\n}\n\nexport interface ConfigurableDocument {\n  document?: Document;\n}\n\nexport interface ConfigurableDocumentOrShadowRoot {\n  document?: DocumentOrShadowRoot;\n}\n\nexport interface ConfigurableNavigator {\n  navigator?: Navigator;\n}\n\nexport interface ConfigurableLocation {\n  location?: Location;\n}\n\nexport const defaultWindow = /* #__PURE__ */ isClient ? window : undefined;\n\nexport const defaultDocument = /* #__PURE__ */ isClient\n  ? window.document\n  : undefined;\n\nexport const defaultNavigator = /* #__PURE__ */ isClient\n  ? window.navigator\n  : undefined;\n\nexport const defaultLocation = /* #__PURE__ */ isClient\n  ? window.location\n  : undefined;\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAyB;AAsBlB,MAAM,gBAAgC,wBAAW,SAAS;AAE1D,MAAM,kBAAkC,wBAC3C,OAAO,WACP;AAEG,MAAM,mBAAmC,wBAC5C,OAAO,YACP;AAEG,MAAM,kBAAkC,wBAC3C,OAAO,WACP;","names":[]}

package/dist/shared/configurable.mjs

@@ -0,0 +1,12 @@
+import { isClient } from "./utils";
+const defaultWindow = isClient ? window : void 0;
+const defaultDocument = isClient ? window.document : void 0;
+const defaultNavigator = isClient ? window.navigator : void 0;
+const defaultLocation = isClient ? window.location : void 0;
+export {
+  defaultDocument,
+  defaultLocation,
+  defaultNavigator,
+  defaultWindow
+};
+//# sourceMappingURL=configurable.mjs.map

package/dist/shared/configurable.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shared/configurable.ts"],"sourcesContent":["import { isClient } from \"./utils\";\n\nexport interface ConfigurableWindow {\n  window?: Window;\n}\n\nexport interface ConfigurableDocument {\n  document?: Document;\n}\n\nexport interface ConfigurableDocumentOrShadowRoot {\n  document?: DocumentOrShadowRoot;\n}\n\nexport interface ConfigurableNavigator {\n  navigator?: Navigator;\n}\n\nexport interface ConfigurableLocation {\n  location?: Location;\n}\n\nexport const defaultWindow = /* #__PURE__ */ isClient ? window : undefined;\n\nexport const defaultDocument = /* #__PURE__ */ isClient\n  ? window.document\n  : undefined;\n\nexport const defaultNavigator = /* #__PURE__ */ isClient\n  ? window.navigator\n  : undefined;\n\nexport const defaultLocation = /* #__PURE__ */ isClient\n  ? window.location\n  : undefined;\n"],"mappings":"AAAA,SAAS,gBAAgB;AAsBlB,MAAM,gBAAgC,WAAW,SAAS;AAE1D,MAAM,kBAAkC,WAC3C,OAAO,WACP;AAEG,MAAM,mBAAmC,WAC5C,OAAO,YACP;AAEG,MAAM,kBAAkC,WAC3C,OAAO,WACP;","names":[]}

package/dist/shared/index.d.mts

@@ -0,0 +1,4 @@
+/** typeof window 우선 검사 — instanceof Window는 jsdom 환경에서 실패할 수 있음 */
+declare function isWindow(el: unknown): el is Window;
+
+export { isWindow };

package/dist/shared/index.d.ts

@@ -0,0 +1,4 @@
+/** typeof window 우선 검사 — instanceof Window는 jsdom 환경에서 실패할 수 있음 */
+declare function isWindow(el: unknown): el is Window;
+
+export { isWindow };

package/dist/shared/index.js

@@ -0,0 +1,31 @@
+"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);
+var shared_exports = {};
+__export(shared_exports, {
+  isWindow: () => isWindow
+});
+module.exports = __toCommonJS(shared_exports);
+function isWindow(el) {
+  return typeof window !== "undefined" && el === window;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isWindow
+});
+//# sourceMappingURL=index.js.map

package/dist/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shared/index.ts"],"sourcesContent":["/** typeof window 우선 검사 — instanceof Window는 jsdom 환경에서 실패할 수 있음 */\nexport function isWindow(el: unknown): el is Window {\n  return typeof window !== \"undefined\" && el === window;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACO,SAAS,SAAS,IAA2B;AAClD,SAAO,OAAO,WAAW,eAAe,OAAO;AACjD;","names":[]}

package/dist/shared/index.mjs

@@ -0,0 +1,7 @@
+function isWindow(el) {
+  return typeof window !== "undefined" && el === window;
+}
+export {
+  isWindow
+};
+//# sourceMappingURL=index.mjs.map

package/dist/shared/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shared/index.ts"],"sourcesContent":["/** typeof window 우선 검사 — instanceof Window는 jsdom 환경에서 실패할 수 있음 */\nexport function isWindow(el: unknown): el is Window {\n  return typeof window !== \"undefined\" && el === window;\n}\n"],"mappings":"AACO,SAAS,SAAS,IAA2B;AAClD,SAAO,OAAO,WAAW,eAAe,OAAO;AACjD;","names":[]}

package/dist/shared/normalizeTargets/index.d.mts

@@ -0,0 +1,21 @@
+import { MaybeElement } from '../../elements/useRef_/index.mjs';
+import '@legendapp/state';
+import 'react';
+
+/**
+ * Normalizes one or more observable-element targets into a plain Element[].
+ *
+ * - `Ref$<T>` — calls `.get()` and unwraps the OpaqueObject via `.valueOf()`
+ * - `Observable<OpaqueObject<Element> | null>` — calls `.get()` and unwraps via `.valueOf()`
+ * - `Document` / `Window` — filtered out (not an Element, handled by callers)
+ * - `null` — filtered out
+ *
+ * When called inside `useObserve`, reading `.get()` registers observable
+ * dependencies so the observer re-fires when a tracked target changes.
+ *
+ * Currently shared by useResizeObserver.
+ * useIntersectionObserver, useMutationObserver will use this once implemented.
+ */
+declare function normalizeTargets(target?: MaybeElement | MaybeElement[]): Element[];
+
+export { normalizeTargets };

package/dist/shared/normalizeTargets/index.d.ts

@@ -0,0 +1,21 @@
+import { MaybeElement } from '../../elements/useRef_/index.js';
+import '@legendapp/state';
+import 'react';
+
+/**
+ * Normalizes one or more observable-element targets into a plain Element[].
+ *
+ * - `Ref$<T>` — calls `.get()` and unwraps the OpaqueObject via `.valueOf()`
+ * - `Observable<OpaqueObject<Element> | null>` — calls `.get()` and unwraps via `.valueOf()`
+ * - `Document` / `Window` — filtered out (not an Element, handled by callers)
+ * - `null` — filtered out
+ *
+ * When called inside `useObserve`, reading `.get()` registers observable
+ * dependencies so the observer re-fires when a tracked target changes.
+ *
+ * Currently shared by useResizeObserver.
+ * useIntersectionObserver, useMutationObserver will use this once implemented.
+ */
+declare function normalizeTargets(target?: MaybeElement | MaybeElement[]): Element[];
+
+export { normalizeTargets };