@codeleap/web 7.0.0 → 7.0.1

package/dist/lib/hooks/useClickOutside.js

@@ -0,0 +1,31 @@
+import { useEffect, useRef } from 'react';
+const DEFAULT_EVENTS = ['mousedown', 'touchstart'];
+/**
+ * Calls `handler` when a pointer event fires outside the returned ref's element.
+ *
+ * Listens for `mousedown` and `touchstart` by default; pass `events` to
+ * override. Supply `nodes` to bypass the ref entirely and check a fixed set of
+ * elements instead — useful when the trigger lives outside the component tree.
+ * Elements with `data-ignore-outside-clicks` are always ignored.
+ */
+export function useClickOutside(handler, events, nodes) {
+    const ref = useRef(null);
+    useEffect(() => {
+        const listener = (event) => {
+            if (Array.isArray(nodes)) {
+                const shouldIgnore = event?.target?.hasAttribute('data-ignore-outside-clicks');
+                const shouldTrigger = nodes.every((node) => !!node && !node.contains(event.target));
+                shouldTrigger && !shouldIgnore && handler();
+            }
+            else if (ref.current && !ref.current.contains(event.target)) {
+                handler();
+            }
+        };
+        (events || DEFAULT_EVENTS).forEach((fn) => document.addEventListener(fn, listener));
+        return () => {
+            (events || DEFAULT_EVENTS).forEach((fn) => document.removeEventListener(fn, listener));
+        };
+    }, [ref, handler, nodes]);
+    return ref;
+}
+//# sourceMappingURL=useClickOutside.js.map

package/dist/lib/hooks/useClickOutside.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClickOutside.js","sourceRoot":"","sources":["../../../src/lib/hooks/useClickOutside.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAEzC,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,YAAY,CAAC,CAAA;AAElD;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAmB,EACnB,MAAwB,EACxB,KAAqB;IAErB,MAAM,GAAG,GAAG,MAAM,CAAI,IAAI,CAAC,CAAA;IAE3B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,QAAQ,GAAG,CAAC,KAAU,EAAE,EAAE;YAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,MAAM,YAAY,GAAG,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,4BAA4B,CAAC,CAAA;gBAC9E,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;gBACnF,aAAa,IAAI,CAAC,YAAY,IAAI,OAAO,EAAE,CAAA;YAC7C,CAAC;iBAAM,IAAI,GAAG,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC9D,OAAO,EAAE,CAAA;YACX,CAAC;QACH,CAAC,CAAC;QAEF,CAAC,MAAM,IAAI,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAA;QAEnF,OAAO,GAAG,EAAE;YACV,CAAC,MAAM,IAAI,cAAc,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAA;QACxF,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;IAEzB,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/lib/hooks/useFileInput.js

@@ -0,0 +1,17 @@
+import { useRef } from 'react';
+/**
+ * Provides an imperative ref and `openFilePicker` helper for a `FileInput`
+ * component. Attach the returned `ref` to `<FileInput ref={ref} />` and call
+ * `openFilePicker()` from a button or any other trigger.
+ */
+export const useFileInput = () => {
+    const inputRef = useRef(null);
+    const openFilePicker = () => {
+        return inputRef.current?.openFilePicker();
+    };
+    return {
+        openFilePicker,
+        ref: inputRef,
+    };
+};
+//# sourceMappingURL=useFileInput.js.map

package/dist/lib/hooks/useFileInput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFileInput.js","sourceRoot":"","sources":["../../../src/lib/hooks/useFileInput.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAG9B;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,EAAE;IAC/B,MAAM,QAAQ,GAAG,MAAM,CAAsB,IAAI,CAAC,CAAA;IAElD,MAAM,cAAc,GAAG,GAAG,EAAE;QAC1B,OAAO,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,CAAA;IAC3C,CAAC,CAAA;IAED,OAAO;QACL,cAAc;QACd,GAAG,EAAE,QAAQ;KACd,CAAA;AACH,CAAC,CAAA"}

package/dist/lib/hooks/useIsomorphicEffect.js

@@ -0,0 +1,7 @@
+import { useEffect, useLayoutEffect } from 'react';
+/**
+ * `useLayoutEffect` in the browser; `useEffect` on the server.
+ * Avoids the React SSR warning about `useLayoutEffect` in non-browser environments.
+ */
+export const useIsomorphicEffect = typeof document !== 'undefined' ? useLayoutEffect : useEffect;
+//# sourceMappingURL=useIsomorphicEffect.js.map

package/dist/lib/hooks/useIsomorphicEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useIsomorphicEffect.js","sourceRoot":"","sources":["../../../src/lib/hooks/useIsomorphicEffect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,OAAO,CAAA;AAElD;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,SAAS,CAAA"}

package/dist/lib/hooks/useKeydown.js

@@ -0,0 +1,39 @@
+import { TypeGuards } from '@codeleap/types';
+import { useEffect } from 'react';
+/** Convenience key descriptors available as `useKeydown.keys`. */
+export const keydownDefaultKeyOptions = {
+    ArrowLeft: 'ArrowLeft',
+    ArrowRight: 'ArrowRight',
+    ArrowUp: 'ArrowUp',
+    ArrowDown: 'ArrowDown',
+    Enter: 'Enter',
+    Space: {
+        key: ' ',
+        code: 'Space',
+    },
+};
+/**
+ * Adds a `keydown` listener on `document` for a single key.
+ *
+ * `expectedKey` can be a shorthand from `useKeydown.keys` (e.g. `'Enter'`) or
+ * an explicit `{ key, code }` object. The listener is re-registered whenever
+ * `deps` change.
+ */
+export function useKeydown(expectedKey, handler, deps = [], options) {
+    const eventKey = TypeGuards.isString(expectedKey) ? (useKeydown?.keys?.[expectedKey] ?? expectedKey) : expectedKey;
+    const handleKeyPress = (event) => {
+        const { key, code } = TypeGuards.isString(eventKey) ? { key: eventKey, code: eventKey } : eventKey;
+        if (event?.key === key || event?.code === code) {
+            handler?.(event);
+        }
+    };
+    useEffect(() => {
+        document.addEventListener('keydown', handleKeyPress, options);
+        return () => {
+            document.removeEventListener('keydown', handleKeyPress);
+        };
+    }, deps);
+}
+useKeydown.keys = keydownDefaultKeyOptions;
+useKeydown.defaultKeyOptions = keydownDefaultKeyOptions;
+//# sourceMappingURL=useKeydown.js.map

package/dist/lib/hooks/useKeydown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useKeydown.js","sourceRoot":"","sources":["../../../src/lib/hooks/useKeydown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEjC,kEAAkE;AAClE,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,SAAS,EAAE,WAAW;IACtB,UAAU,EAAE,YAAY;IACxB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE;QACL,GAAG,EAAE,GAAG;QACR,IAAI,EAAE,OAAO;KACd;CACF,CAAA;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CACxB,WAAyE,EACzE,OAAuC,EACvC,OAAmB,EAAE,EACrB,OAA2C;IAE3C,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAA;IAElH,MAAM,cAAc,GAAG,CAAC,KAAoB,EAAE,EAAE;QAC9C,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAA;QAElG,IAAI,KAAK,EAAE,GAAG,KAAK,GAAG,IAAI,KAAK,EAAE,IAAI,KAAK,IAAI,EAAE,CAAC;YAC/C,OAAO,EAAE,CAAC,KAAK,CAAC,CAAA;QAClB,CAAC;IACH,CAAC,CAAA;IAED,SAAS,CAAC,GAAG,EAAE;QACb,QAAQ,CAAC,gBAAgB,CAAC,SAAS,EAAE,cAAc,EAAE,OAAO,CAAC,CAAA;QAE7D,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,mBAAmB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAA;QACzD,CAAC,CAAA;IACH,CAAC,EAAE,IAAI,CAAC,CAAA;AACV,CAAC;AAED,UAAU,CAAC,IAAI,GAAG,wBAAwB,CAAA;AAC1C,UAAU,CAAC,iBAAiB,GAAG,wBAAwB,CAAA"}

package/dist/lib/hooks/useListFocus.js

@@ -0,0 +1,46 @@
+import { useEffect, useMemo } from 'react';
+/**
+ * Creates a stable imperative focus handle for a ListBox DOM ref and returns it.
+ *
+ * The handle queries [role="option"] elements directly. When the chosen item
+ * receives DOM focus, react-aria's own useSelectableItem onFocus handler calls
+ * manager.setFocusedKey(key), so internal keyboard-navigation state stays in
+ * sync without needing access to ListStateContext.
+ *
+ * Pass the same listBoxRef to <ListBox ref={...}>.
+ * Pass externalRef to also expose the handle to a consumer-provided ref.
+ */
+export function useListFocus(listBoxRef, externalRef) {
+    const handle = useMemo(() => ({
+        focus(strategy = 'selected') {
+            const list = listBoxRef.current;
+            if (!list)
+                return;
+            const options = Array.from(list.querySelectorAll('[role="option"]:not([data-disabled])'));
+            if (!options.length)
+                return;
+            let target = null;
+            if (strategy === 'last') {
+                target = options.at(-1) ?? null;
+            }
+            else if (strategy === 'selected') {
+                target =
+                    list.querySelector('[role="option"][aria-selected="true"]') ??
+                        options[0] ??
+                        null;
+            }
+            else {
+                target = options[0] ?? null;
+            }
+            target?.focus();
+        },
+    }), [listBoxRef]);
+    useEffect(() => {
+        if (!externalRef)
+            return;
+        externalRef.current = handle;
+        return () => { externalRef.current = null; };
+    }, [handle, externalRef]);
+    return handle;
+}
+//# sourceMappingURL=useListFocus.js.map

package/dist/lib/hooks/useListFocus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useListFocus.js","sourceRoot":"","sources":["../../../src/lib/hooks/useListFocus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAkB,MAAM,OAAO,CAAA;AAS1D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAC1B,UAAyC,EACzC,WAA+C;IAE/C,MAAM,MAAM,GAAG,OAAO,CAAkB,GAAG,EAAE,CAAC,CAAC;QAC7C,KAAK,CAAC,WAA8B,UAAU;YAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAA;YAC/B,IAAI,CAAC,IAAI;gBAAE,OAAM;YAEjB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CACxB,IAAI,CAAC,gBAAgB,CAAc,sCAAsC,CAAC,CAC3E,CAAA;YACD,IAAI,CAAC,OAAO,CAAC,MAAM;gBAAE,OAAM;YAE3B,IAAI,MAAM,GAAuB,IAAI,CAAA;YAErC,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACxB,MAAM,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;YACjC,CAAC;iBAAM,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;gBACnC,MAAM;oBACJ,IAAI,CAAC,aAAa,CAAc,uCAAuC,CAAC;wBACxE,OAAO,CAAC,CAAC,CAAC;wBACV,IAAI,CAAA;YACR,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;YAC7B,CAAC;YAED,MAAM,EAAE,KAAK,EAAE,CAAA;QACjB,CAAC;KACF,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAA;IAEjB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,WAAW;YAAE,OAAM;QACxB,WAAW,CAAC,OAAO,GAAG,MAAM,CAAA;QAC5B,OAAO,GAAG,EAAE,GAAG,WAAW,CAAC,OAAO,GAAG,IAAI,CAAA,CAAC,CAAC,CAAA;IAC7C,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAA;IAEzB,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/lib/hooks/useMediaQuery.js

@@ -0,0 +1,25 @@
+import { useEffect, useRef, useState } from 'react';
+import { attachMediaListener, getMediaQuery, isMediaQuery } from '../tools';
+/**
+ * Subscribes to a CSS media query string and returns whether it currently matches.
+ *
+ * Falls back to a static check via `isMediaQuery` on SSR or when `matchMedia` is
+ * unavailable. The query string may include the `@media screen and ` prefix —
+ * it is stripped internally before passing to `window.matchMedia`.
+ */
+export function useMediaQuery(query) {
+    const [matches, setMatches] = useState(isMediaQuery(query));
+    const queryRef = useRef(undefined);
+    useEffect(() => {
+        if (query?.trim() === '' || !query)
+            return;
+        if ('matchMedia' in window) {
+            queryRef.current = window.matchMedia(getMediaQuery(query));
+            setMatches(queryRef.current.matches);
+            return attachMediaListener(queryRef.current, (event) => setMatches(event.matches));
+        }
+        return undefined;
+    }, []);
+    return matches;
+}
+//# sourceMappingURL=useMediaQuery.js.map

package/dist/lib/hooks/useMediaQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMediaQuery.js","sourceRoot":"","sources":["../../../src/lib/hooks/useMediaQuery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AACnD,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAE3E;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAA;IAE3D,MAAM,QAAQ,GAAG,MAAM,CAAiB,SAAS,CAAC,CAAA;IAElD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK;YAAE,OAAM;QAE1C,IAAI,YAAY,IAAI,MAAM,EAAE,CAAC;YAC3B,QAAQ,CAAC,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAA;YAC1D,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;YACpC,OAAO,mBAAmB,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAA;QACpF,CAAC;QAED,OAAO,SAAS,CAAA;IAClB,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/lib/hooks/usePageExitBlocker.js

@@ -0,0 +1,44 @@
+import { globalHistory } from '@reach/router';
+import { useEffect } from 'react';
+/**
+ * Blocks the user from leaving the current page without confirmation.
+ *
+ * Intercepts both browser tab-close / reload (`beforeunload`) and in-app
+ * navigation via `@reach/router`'s `globalHistory`. When a PUSH or POP
+ * navigation is detected, a `window.confirm` dialog is shown; `handler` is
+ * called with `true` if the user confirmed, `false` if they cancelled.
+ *
+ * Requires `@reach/router` to be present in the application.
+ */
+export const usePageExitBlocker = (handler, deps = [], message = 'Are you sure you want to leave?') => {
+    const handleBeforeUnload = (event) => {
+        if (!event)
+            return null;
+        event?.preventDefault();
+        event.returnValue = '';
+        return;
+    };
+    useEffect(() => {
+        if (!window)
+            return null;
+        window.addEventListener('beforeunload', handleBeforeUnload);
+        return () => {
+            window.removeEventListener('beforeunload', handleBeforeUnload);
+        };
+    }, deps);
+    useEffect(() => {
+        return globalHistory.listen((args) => {
+            if (!window)
+                return null;
+            const historyPathname = args?.location?.pathname;
+            const windowPathname = window?.location?.pathname;
+            const isPopAction = args?.action === 'POP';
+            const isLeaveAction = args?.action === 'PUSH' && !historyPathname?.includes(windowPathname);
+            if (isLeaveAction || isPopAction) {
+                const willLeavePage = window.confirm(message);
+                handler?.(willLeavePage);
+            }
+        });
+    }, deps);
+};
+//# sourceMappingURL=usePageExitBlocker.js.map

package/dist/lib/hooks/usePageExitBlocker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePageExitBlocker.js","sourceRoot":"","sources":["../../../src/lib/hooks/usePageExitBlocker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEjC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,OAAyC,EACzC,OAAmB,EAAE,EACrB,OAAO,GAAG,iCAAiC,EAC3C,EAAE;IACF,MAAM,kBAAkB,GAAG,CAAC,KAAwB,EAAE,EAAE;QACtD,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAA;QAEvB,KAAK,EAAE,cAAc,EAAE,CAAA;QACvB,KAAK,CAAC,WAAW,GAAG,EAAE,CAAA;QACtB,OAAM;IACR,CAAC,CAAA;IAED,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAA;QAExB,MAAM,CAAC,gBAAgB,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAA;QAE3D,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,mBAAmB,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAA;QAChE,CAAC,CAAA;IACH,CAAC,EAAE,IAAI,CAAC,CAAA;IAER,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;YACnC,IAAI,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAA;YAExB,MAAM,eAAe,GAAG,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAA;YAChD,MAAM,cAAc,GAAG,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAA;YAEjD,MAAM,WAAW,GAAG,IAAI,EAAE,MAAM,KAAK,KAAK,CAAA;YAC1C,MAAM,aAAa,GAAG,IAAI,EAAE,MAAM,KAAK,MAAM,IAAI,CAAC,eAAe,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAA;YAE3F,IAAI,aAAa,IAAI,WAAW,EAAE,CAAC;gBACjC,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;gBAE7C,OAAO,EAAE,CAAC,aAAa,CAAC,CAAA;YAC1B,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC,EAAE,IAAI,CAAC,CAAA;AACV,CAAC,CAAA"}

package/dist/lib/hooks/usePagination.js

@@ -0,0 +1,90 @@
+import { useMemo, useUncontrolled } from '@codeleap/hooks';
+import { range } from '@codeleap/utils';
+/**
+ * Manages pagination state and computes the visible page range for a
+ * `PaginationButtons` component.
+ *
+ * Supports controlled (`page` + `onChangePage`) and uncontrolled modes. When
+ * `shouldAbbreviate` is true (default) and `total` exceeds
+ * `abbreviationMinimumAmount`, the range collapses middle pages into
+ * `abbreviationSymbol` entries. Mobile mode reduces the boundary count and
+ * forces abbreviation.
+ *
+ * Arrow buttons at positions `0` and `total + 1` are reserved for the
+ * previous/next controls and are not selectable as page numbers.
+ */
+export function usePagination(props) {
+    const { isMobile } = props;
+    const { total, boundaries = 2, initialPage = 1, page, onChangePage, shouldAbbreviate = true, abbreviationMinimumAmount = isMobile ? 5 : 10, displayLeftArrow = true, displayRightArrow = true, abbreviationSymbol, } = props;
+    const [activePage, setActivePage] = useUncontrolled({
+        value: page,
+        onChange: onChangePage,
+        defaultValue: initialPage,
+        finalValue: initialPage,
+        rule: (_page) => typeof _page === 'number' && _page <= total,
+    });
+    const _boundaries = isMobile ? 2 : boundaries;
+    const canAbreviateItems = (shouldAbbreviate || isMobile) && total > abbreviationMinimumAmount;
+    const displayLastNumbers = activePage + _boundaries + (isMobile ? 0 : 2) >= total;
+    const isCenterSelected = canAbreviateItems && activePage > _boundaries && !displayLastNumbers;
+    const dotsDisplay = isCenterSelected ? abbreviationSymbol : null;
+    const setPage = (pageNumber) => {
+        const isPreviousArrow = pageNumber === 0;
+        const isNextArrow = pageNumber === total + 1;
+        const nonSelectableItems = [
+            displayLeftArrow && isPreviousArrow,
+            displayRightArrow && isNextArrow,
+        ].some(x => x);
+        if (nonSelectableItems)
+            return activePage;
+        setActivePage(pageNumber);
+    };
+    const next = () => setPage(activePage + 1);
+    const previous = () => setPage(activePage - 1);
+    const first = () => setPage(1);
+    const last = () => setPage(total);
+    const status = useMemo(() => {
+        if (isCenterSelected) {
+            return 'abreviated';
+        }
+        if (displayLastNumbers) {
+            return 'end';
+        }
+        return 'initial';
+    }, [isCenterSelected, displayLastNumbers]);
+    const paginationRange = useMemo(() => {
+        if (!canAbreviateItems) {
+            return [
+                ...range(1, total),
+            ].filter(Boolean);
+        }
+        if (displayLastNumbers) {
+            const extraItems = [
+                1,
+                abbreviationSymbol,
+            ];
+            return [
+                ...extraItems,
+                ...range(total - (_boundaries + extraItems?.length - (isMobile ? 2 : 0)), total),
+            ].filter(Boolean);
+        }
+        return [
+            ...range(1, isCenterSelected ? _boundaries - 1 : _boundaries),
+            dotsDisplay,
+            isCenterSelected ? activePage : abbreviationSymbol,
+            dotsDisplay,
+            ...range(total - _boundaries + (isCenterSelected ? 2 : 1), total),
+        ].filter(Boolean);
+    }, [total, activePage, displayLastNumbers, isCenterSelected, canAbreviateItems]);
+    return {
+        range: paginationRange,
+        page: Number(activePage),
+        setPage,
+        status,
+        next,
+        previous,
+        first,
+        last,
+    };
+}
+//# sourceMappingURL=usePagination.js.map

package/dist/lib/hooks/usePagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePagination.js","sourceRoot":"","sources":["../../../src/lib/hooks/usePagination.ts"],"names":[],"mappings":"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"}

package/dist/lib/hooks/usePopState.js

@@ -0,0 +1,31 @@
+import { useUnmount } from '@codeleap/hooks';
+import { useIsomorphicEffect } from './useIsomorphicEffect';
+/**
+ * Conditionally attaches a `popstate` listener while `dependence` is `true`.
+ *
+ * When `dependence` becomes `true`, pushes the current URL onto the history
+ * stack so the browser back button triggers `popstate` rather than navigating
+ * away. When `dependence` becomes `false` (or the component unmounts), the
+ * listener is removed.
+ *
+ * Useful for keeping overlays (modals, drawers) dismissable via the browser
+ * back button.
+ */
+export const usePopState = (dependence, handler) => {
+    useIsomorphicEffect(() => {
+        if (dependence) {
+            const pathname = location.pathname;
+            const searchParams = location.search;
+            const newUrl = pathname + searchParams;
+            window.history.pushState(null, null, newUrl);
+            window.addEventListener('popstate', handler);
+        }
+        else {
+            window.removeEventListener('popstate', handler);
+        }
+    }, [dependence]);
+    useUnmount(() => {
+        window.removeEventListener('popstate', handler);
+    });
+};
+//# sourceMappingURL=usePopState.js.map

package/dist/lib/hooks/usePopState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePopState.js","sourceRoot":"","sources":["../../../src/lib/hooks/usePopState.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAE3D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,UAAmB,EAAE,OAAoB,EAAE,EAAE;IACvE,mBAAmB,CAAC,GAAG,EAAE;QACvB,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAA;YAClC,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAA;YACpC,MAAM,MAAM,GAAG,QAAQ,GAAG,YAAY,CAAA;YAEtC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;YAC5C,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;QAC9C,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;QACjD,CAAC;IACH,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAA;IAEhB,UAAU,CAAC,GAAG,EAAE;QACd,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;IACjD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/dist/lib/hooks/usePopoverDismiss.js

@@ -0,0 +1,32 @@
+import { useEffect, useRef } from 'react';
+/**
+ * Restores outside-click dismissal for a Popover rendered with isNonModal=true.
+ *
+ * react-aria's usePopover sets isDismissable=!isNonModal, which disables its own
+ * useInteractOutside listener. This hook adds an equivalent pointerdown capture
+ * listener directly on the document.
+ *
+ * The trigger element is excluded so its own press handler can handle the toggle.
+ * The blur-based close (shouldCloseOnBlur=true in useOverlay) still handles the
+ * case where focus is inside the popover and moves elsewhere, so this hook only
+ * needs to cover the unfocused-popover scenario.
+ */
+export function usePopoverDismiss({ popoverRef, triggerRef, isOpen, onClose, }) {
+    const onCloseRef = useRef(onClose);
+    useEffect(() => { onCloseRef.current = onClose; });
+    useEffect(() => {
+        if (!isOpen)
+            return;
+        const handle = (e) => {
+            const target = e.target;
+            if (popoverRef.current?.contains(target))
+                return;
+            if (triggerRef.current?.contains(target))
+                return;
+            onCloseRef.current();
+        };
+        document.addEventListener('pointerdown', handle, { capture: true });
+        return () => document.removeEventListener('pointerdown', handle, { capture: true });
+    }, [isOpen, popoverRef, triggerRef]);
+}
+//# sourceMappingURL=usePopoverDismiss.js.map

package/dist/lib/hooks/usePopoverDismiss.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePopoverDismiss.js","sourceRoot":"","sources":["../../../src/lib/hooks/usePopoverDismiss.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAkB,MAAM,OAAO,CAAA;AAEzD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAChC,UAAU,EACV,UAAU,EACV,MAAM,EACN,OAAO,GAMR;IACC,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;IAClC,SAAS,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,OAAO,GAAG,OAAO,CAAA,CAAC,CAAC,CAAC,CAAA;IAEjD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM;YAAE,OAAM;QAEnB,MAAM,MAAM,GAAG,CAAC,CAAe,EAAE,EAAE;YACjC,MAAM,MAAM,GAAG,CAAC,CAAC,MAAc,CAAA;YAC/B,IAAI,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC;gBAAE,OAAM;YAChD,IAAI,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC;gBAAE,OAAM;YAChD,UAAU,CAAC,OAAO,EAAE,CAAA;QACtB,CAAC,CAAA;QAED,QAAQ,CAAC,gBAAgB,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;QACnE,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;IACrF,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAA;AACtC,CAAC"}

package/dist/lib/hooks/useRefresh.js

@@ -0,0 +1,67 @@
+import React from 'react';
+import { useEffect } from '@codeleap/hooks';
+const scrollDebounce = (func, delay) => {
+    const timerRef = React.useRef(null);
+    const scrollDebounce = (...args) => {
+        clearTimeout(timerRef.current);
+        timerRef.current = setTimeout(() => {
+            func(...args);
+        }, delay);
+    };
+    return scrollDebounce;
+};
+/**
+ * Implements a pull-to-refresh pattern for web scroll containers.
+ *
+ * Monitors the window `scroll` event and fires `onRefresh` when the container
+ * has been scrolled above `threshold` (percentage) twice in quick succession.
+ * After `onRefresh` resolves, the refresh state is reset after 2.5 s. Set
+ * `enabled: false` to disable the listener entirely (e.g. while a request is
+ * already in flight). Attach `scrollableRef` to the scrollable container element.
+ */
+export const useRefresh = (onRefresh = () => null, options) => {
+    const { threshold, debounce, enabled, } = options;
+    const [refresh, setRefresh] = React.useState(false);
+    const pushToTopRef = React.useRef(0);
+    const refresher = React.useCallback(async (_onRefresh) => {
+        setRefresh(true);
+        await _onRefresh?.();
+        setTimeout(() => {
+            setRefresh(false);
+            pushToTopRef.current = 0;
+        }, 2500);
+    }, []);
+    const containerRef = React.useRef(null);
+    const onScroll = scrollDebounce(() => {
+        if (containerRef.current) {
+            const rect = containerRef.current?.getBoundingClientRect();
+            const scrollTop = window?.pageYOffset || document?.documentElement?.scrollTop;
+            const containerTop = rect.top + scrollTop;
+            const containerHeight = rect.height;
+            const distanceFromTop = Math.max(0, scrollTop - containerTop);
+            const distanceFromBottom = Math.max(0, containerTop + containerHeight - scrollTop);
+            const totalDistance = containerHeight + distanceFromTop + distanceFromBottom;
+            const percentage = (distanceFromTop / totalDistance) * 100;
+            if (percentage < threshold) {
+                if (pushToTopRef.current === 2) {
+                    refresher(onRefresh);
+                }
+                pushToTopRef.current = pushToTopRef.current + 1;
+            }
+        }
+    }, debounce);
+    useEffect(() => {
+        if (enabled) {
+            window.addEventListener('scroll', onScroll);
+            return () => {
+                window.removeEventListener('scroll', onScroll);
+            };
+        }
+    }, [enabled]);
+    return {
+        refresh,
+        scrollableRef: containerRef,
+        refresher,
+    };
+};
+//# sourceMappingURL=useRefresh.js.map

package/dist/lib/hooks/useRefresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useRefresh.js","sourceRoot":"","sources":["../../../src/lib/hooks/useRefresh.ts"],"names":[],"mappings":"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"}

package/dist/lib/hooks/useScrollEffect.js

@@ -0,0 +1,19 @@
+import { useEffect } from 'react';
+/**
+ * Calls `effect` on every window scroll event, passing whether `window.scrollY`
+ * has passed `breakpoint` and the current scroll position. The listener is
+ * re-registered when `breakpoint` or any `extraDependencies` change.
+ */
+export function useScrollEffect(effect, breakpoint, extraDependencies = []) {
+    function handleScroll() {
+        const passed = window.scrollY > breakpoint;
+        effect(passed, window.scrollY);
+    }
+    useEffect(() => {
+        document.addEventListener('scroll', handleScroll);
+        return () => {
+            document.removeEventListener('scroll', handleScroll);
+        };
+    }, [breakpoint, ...extraDependencies]);
+}
+//# sourceMappingURL=useScrollEffect.js.map

package/dist/lib/hooks/useScrollEffect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useScrollEffect.js","sourceRoot":"","sources":["../../../src/lib/hooks/useScrollEffect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEjC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAiD,EACjD,UAAkB,EAClB,iBAAiB,GAAG,EAAE;IAEtB,SAAS,YAAY;QACnB,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,GAAG,UAAU,CAAA;QAC1C,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;IAChC,CAAC;IAED,SAAS,CAAC,GAAG,EAAE;QACb,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;QACjD,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,mBAAmB,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAA;QACtD,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,iBAAiB,CAAC,CAAC,CAAA;AACxC,CAAC"}

package/dist/lib/hooks/useSearchParams.js

@@ -0,0 +1,48 @@
+import { useEffect, useRef, useState } from 'react';
+import { usePrevious } from '@codeleap/hooks';
+/**
+ * Syncs a typed record of string params with the URL query string via
+ * `window.history.replaceState`. On mount, reads the current URL params and
+ * merges them with `initial` defaults (initial values are only applied when the
+ * URL param is absent or empty). Call `reset()` to restore `initial`.
+ *
+ * Not a router integration — changes do not trigger a navigation event, and the
+ * hook does not react to external URL changes after mount.
+ */
+export function useSearchParams(initial) {
+    const searchParams = useRef(new URLSearchParams(typeof window === 'undefined' ? '' : location.search));
+    const [params, setParams] = useState(() => {
+        const initialParams = Object.fromEntries(searchParams.current);
+        for (const key in initial) {
+            if (initialParams[key] === '' || typeof initialParams[key] === 'undefined') {
+                initialParams[key] = initial[key];
+            }
+        }
+        return initialParams;
+    });
+    const previousParams = usePrevious(params);
+    useEffect(() => {
+        if (window.history) {
+            Object.entries({ ...previousParams, ...params }).forEach(([k, v]) => {
+                if (!!previousParams?.[k] && !params?.[k]) {
+                    searchParams.current.delete(k);
+                }
+                else if (v) {
+                    searchParams.current.set(k, v);
+                }
+                else {
+                    searchParams.current.delete(k);
+                }
+            });
+            const url = window.location.origin +
+                window.location.pathname +
+                `?${searchParams.current?.toString()}`;
+            window.history.replaceState({ path: url }, '', url);
+        }
+    }, [params]);
+    function reset() {
+        setParams(initial);
+    }
+    return [params, setParams, reset, searchParams.current];
+}
+//# sourceMappingURL=useSearchParams.js.map

package/dist/lib/hooks/useSearchParams.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useSearchParams.js","sourceRoot":"","sources":["../../../src/lib/hooks/useSearchParams.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAa7C;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAE7B,OAAW;IACX,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,eAAe,CAAC,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA;IACtG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAI,GAAG,EAAE;QAE3C,MAAM,aAAa,GAAG,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,OAAc,CAAM,CAAA;QAE1E,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,OAAO,aAAa,CAAC,GAAG,CAAC,KAAK,WAAW,EAAE,CAAC;gBAC3E,aAAa,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;YACnC,CAAC;QACH,CAAC;QAED,OAAO,aAAa,CAAA;IACtB,CAAC,CAAC,CAAA;IACF,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;IAE1C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;gBAClE,IAAI,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC1C,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;gBAChC,CAAC;qBAAM,IAAI,CAAC,EAAE,CAAC;oBACb,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;gBAChC,CAAC;qBAAM,CAAC;oBACN,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;gBAChC,CAAC;YACH,CAAC,CAAC,CAAA;YAEF,MAAM,GAAG,GACP,MAAM,CAAC,QAAQ,CAAC,MAAM;gBACtB,MAAM,CAAC,QAAQ,CAAC,QAAQ;gBACxB,IAAI,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE,CAAA;YACxC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,CAAA;QACrD,CAAC;IACH,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAA;IAEZ,SAAS,KAAK;QACZ,SAAS,CAAC,OAAO,CAAC,CAAA;IACpB,CAAC;IAED,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,CAAA;AACzD,CAAC"}

package/dist/lib/hooks/useStaticAnimationStyles.js

@@ -0,0 +1,16 @@
+import { useRef } from 'react';
+/**
+ * Captures a frozen snapshot of the selected `keys` from `obj` on the first
+ * render and never updates it. Used by `useAnimatedVariantStyles` to keep the
+ * non-animated style values stable across re-renders so Framer Motion does not
+ * re-create animation targets unnecessarily.
+ */
+export function useStaticAnimationStyles(obj, keys) {
+    const styles = useRef({});
+    if (Object.keys(styles.current).length === 0) {
+        const mappedStyles = keys.map((k) => [k, { ...obj[k] }]);
+        styles.current = Object.fromEntries(mappedStyles);
+    }
+    return styles.current;
+}
+//# sourceMappingURL=useStaticAnimationStyles.js.map

package/dist/lib/hooks/useStaticAnimationStyles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStaticAnimationStyles.js","sourceRoot":"","sources":["../../../src/lib/hooks/useStaticAnimationStyles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAG9B;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAqE,GAAM,EAAE,IAAS;IAC5H,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC,CAAA;IAEzB,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7C,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;QAExD,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,CAAA;IACnD,CAAC;IAED,OAAO,MAAM,CAAC,OAAiC,CAAA;AACjD,CAAC"}

package/dist/lib/hooks/useStylesFor.js

@@ -0,0 +1,36 @@
+import { useStyleObserver } from '@codeleap/styles';
+import { useMemo } from 'react';
+import { WebStyleRegistry } from '../WebStyleRegistry';
+import { useStableReference } from '@codeleap/hooks';
+/**
+ * Resolves a component's style parts from `WebStyleRegistry` and re-evaluates
+ * whenever the `style` prop or `context` changes.
+ *
+ * Must be called inside a component that has a `WebStyleRegistry` instance
+ * available (created once per app via `new WebStyleRegistry()`). Pass the
+ * component's registered name as `componentName` — it must match the name used
+ * in `WebStyleRegistry.registerComponent`.
+ */
+export const useStylesFor = (componentName, style, context) => {
+    const styleObserver = useStyleObserver(style);
+    // const isMounted = useIsMounted()
+    const stableContext = useStableReference(context ?? {});
+    const styles = useMemo(() => {
+        return WebStyleRegistry.current.styleFor(componentName, style, true, stableContext);
+    }, [styleObserver, stableContext]);
+    // const processedStyles = useMemo(() => {
+    //   // this is strange, but necessary to recalculate the pre-set styles from SSR
+    //   return Object.entries(styles).reduce((acc, [key, styleValue]) => {
+    //     const isServer = typeof window === 'undefined'
+    //     const inEnvTransition = isServer ? false : !isMounted
+    //     acc[key] = inEnvTransition ? {
+    //       // Despite what it may look like, this is not (just) a joke. The "orphans" property is almost completely useless,
+    //       // so we set it just to force the styles to recompute after hydration. Also picked for comedic impact.
+    //       orphans: 1,
+    //       ...styleValue } : styleValue
+    //     return acc
+    //   }, {} as Record<C, ICSS>)
+    // }, [styles, isMounted])
+    return styles;
+};
+//# sourceMappingURL=useStylesFor.js.map

package/dist/lib/hooks/useStylesFor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStylesFor.js","sourceRoot":"","sources":["../../../src/lib/hooks/useStylesFor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACtF,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,EAAgB,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAElE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAmB,aAAqB,EAAE,KAA2B,EAAE,OAA0B,EAAmB,EAAE;IAChJ,MAAM,aAAa,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAA;IAE7C,mCAAmC;IAEnC,MAAM,aAAa,GAAG,kBAAkB,CAAC,OAAO,IAAI,EAAE,CAAC,CAAA;IAEvD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE;QAC1B,OAAO,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,CAAC,CAAA;IACrF,CAAC,EAAE,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC,CAAA;IAElC,0CAA0C;IAC1C,iFAAiF;IACjF,uEAAuE;IACvE,qDAAqD;IACrD,4DAA4D;IAE5D,qCAAqC;IACrC,0HAA0H;IAC1H,+GAA+G;IAC/G,oBAAoB;IAEpB,qCAAqC;IAErC,iBAAiB;IACjB,8BAA8B;IAC9B,0BAA0B;IAE1B,OAAO,MAAyB,CAAA;AAElC,CAAC,CAAA"}