@codeleap/web 7.0.0 → 7.0.2

package/dist/lib/WebStyleRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebStyleRegistry.js","sourceRoot":"","sources":["../../src/lib/WebStyleRegistry.ts"],"names":[],"mappings":";;;AAAA,6CAAkG;AAElG,MAAM,SAAS,GAAG,IAAI,uBAAc,CAAC;IACnC,GAAG,CAAC,GAAG,EAAE,KAAK;QACZ,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO,IAAI,CAAA;QAC9C,OAAO,YAAY,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;IAC1C,CAAC;IACD,GAAG,CAAC,GAAG;QACL,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO,IAAI,CAAA;QAC9C,OAAO,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;IACnC,CAAC;IACD,GAAG,CAAC,GAAG;QACL,IAAI,OAAO,MAAM,KAAK,WAAW;YAAE,OAAO,IAAI,CAAA;QAC9C,OAAO,YAAY,EAAE,UAAU,CAAC,GAAG,CAAC,CAAA;IACtC,CAAC;CACF,CAAC,CAAA;AAEF,IAAI,QAA0B,CAAA;AAE9B,MAAM,UAAU,GAAkD,EAAE,CAAA;AAEpE;;;;;;;;;;;;;;GAcG;AACH,MAAa,gBAAiB,SAAQ,8BAAqB;IACzD,eAAe,GAA2C,EAAE,CAAA;IAE5D;QACE,KAAK,CAAC,SAAS,CAAC,CAAA;QAEhB,UAAU,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE;YAC/B,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAA;QACnC,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,GAAG,IAAI,CAAA;QACjB,CAAC;QAED,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,8GAA8G;IAC9G,uBAAuB,CAAC,aAAqB,EAAE,QAAgC;QAC7E,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,GAAG,QAAQ,CAAA;IAChD,CAAC;IAED,iHAAiH;IACjH,iBAAiB,CAAC,aAAqB,EAAE,WAAmB;QAC1D,OAAO,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,EAAE,CAAC,WAAW,CAAC,CAAA;IAC3D,CAAC;IAED,WAAW,CAAC,GAAS;QACnB,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,MAAM,KAAK,OAAO;QAChB,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,MAAM,CAAC,iBAAiB,CAAC,SAA6B;QACpD,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAC1B,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAA;QACvC,CAAC;IACH,CAAC;CACF;AAzCD,4CAyCC"}

package/dist/lib/hooks/index.js

@@ -0,0 +1,39 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./useAnimatedStyle"), exports);
+__exportStar(require("./useAnimatedVariantStyles"), exports);
+__exportStar(require("./useBreakpointMatch"), exports);
+__exportStar(require("./useClick"), exports);
+__exportStar(require("./useClickOutside"), exports);
+__exportStar(require("./useMediaQuery"), exports);
+__exportStar(require("./usePageExitBlocker"), exports);
+__exportStar(require("./usePagination"), exports);
+__exportStar(require("./usePopState"), exports);
+__exportStar(require("./useScrollEffect"), exports);
+__exportStar(require("./useIsomorphicEffect"), exports);
+__exportStar(require("./useSearchParams"), exports);
+__exportStar(require("./useStaticAnimationStyles"), exports);
+__exportStar(require("./useWindowFocus"), exports);
+__exportStar(require("./useWindowSize"), exports);
+__exportStar(require("./useKeydown"), exports);
+__exportStar(require("./useRefresh"), exports);
+__exportStar(require("./useFileInput"), exports);
+__exportStar(require("./useStylesFor"), exports);
+__exportStar(require("./useAsyncSelect"), exports);
+__exportStar(require("./useListFocus"), exports);
+__exportStar(require("./usePopoverDismiss"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/hooks/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAkC;AAClC,6DAA0C;AAC1C,uDAAoC;AACpC,6CAA0B;AAC1B,oDAAiC;AACjC,kDAA+B;AAC/B,uDAAoC;AACpC,kDAA+B;AAC/B,gDAA6B;AAC7B,oDAAiC;AACjC,wDAAqC;AACrC,oDAAiC;AACjC,6DAA0C;AAC1C,mDAAgC;AAChC,kDAA+B;AAC/B,+CAA4B;AAC5B,+CAA4B;AAC5B,iDAA8B;AAC9B,iDAA8B;AAC9B,mDAAgC;AAEhC,iDAA8B;AAC9B,sDAAmC"}

package/dist/lib/hooks/useAnimatedStyle.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useAnimatedStyle = void 0;
+const react_1 = require("react");
+/**
+ * Drives a Framer Motion `animate` prop from a reactive updater function.
+ *
+ * The transition from the initial call is captured once and held stable; only
+ * the animated target re-evaluates on dependency changes. Returns `initial: false`
+ * so Motion skips the mount animation and begins from the current state.
+ */
+const useAnimatedStyle = (updater, deps) => {
+    const initialStyle = updater();
+    const [animatedStyle, setAnimatedStyle] = (0, react_1.useState)(initialStyle);
+    const transition = (0, react_1.useRef)(initialStyle.transition);
+    (0, react_1.useEffect)(() => {
+        const animatedStyleUpdated = updater();
+        setAnimatedStyle(animatedStyleUpdated);
+    }, deps);
+    return {
+        animate: animatedStyle,
+        transition: transition.current,
+        initial: false,
+    };
+};
+exports.useAnimatedStyle = useAnimatedStyle;
+//# sourceMappingURL=useAnimatedStyle.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAnimatedStyle.js","sourceRoot":"","sources":["../../../src/lib/hooks/useAnimatedStyle.ts"],"names":[],"mappings":";;;AAAA,iCAAmD;AAanD;;;;;;GAMG;AACI,MAAM,gBAAgB,GAAG,CAAC,OAA4B,EAAE,IAAgB,EAA0B,EAAE;IACzG,MAAM,YAAY,GAAG,OAAO,EAAE,CAAA;IAE9B,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,IAAA,gBAAQ,EAAsB,YAAY,CAAC,CAAA;IACrF,MAAM,UAAU,GAAG,IAAA,cAAM,EAAyB,YAAY,CAAC,UAAU,CAAC,CAAA;IAE1E,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,MAAM,oBAAoB,GAAG,OAAO,EAAE,CAAA;QAEtC,gBAAgB,CAAC,oBAAoB,CAAC,CAAA;IACxC,CAAC,EAAE,IAAI,CAAC,CAAA;IAER,OAAO;QACL,OAAO,EAAE,aAAa;QACtB,UAAU,EAAE,UAAU,CAAC,OAAO;QAC9B,OAAO,EAAE,KAAK;KACf,CAAA;AACH,CAAC,CAAA;AAjBY,QAAA,gBAAgB,oBAiB5B"}

package/dist/lib/hooks/useAnimatedVariantStyles.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useAnimatedVariantStyles = useAnimatedVariantStyles;
+const useStaticAnimationStyles_1 = require("./useStaticAnimationStyles");
+const react_1 = require("react");
+/**
+ * Derives a Framer Motion animation target from a component's variant styles,
+ * animating only the properties listed in `animatedProperties` while keeping the
+ * rest static (via `useStaticAnimationStyles`). Re-evaluates the `updater` whenever
+ * `dependencies` change.
+ */
+function useAnimatedVariantStyles(config) {
+    const { animatedProperties, updater, variantStyles, dependencies = [] } = config;
+    const staticStyles = (0, useStaticAnimationStyles_1.useStaticAnimationStyles)(variantStyles, animatedProperties);
+    const initialState = updater(staticStyles);
+    const [animated, setAnimated] = (0, react_1.useState)(initialState);
+    (0, react_1.useEffect)(() => {
+        const nextState = updater(staticStyles);
+        setAnimated(nextState);
+    }, dependencies);
+    return animated;
+}
+//# sourceMappingURL=useAnimatedVariantStyles.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAnimatedVariantStyles.js","sourceRoot":"","sources":["../../../src/lib/hooks/useAnimatedVariantStyles.ts"],"names":[],"mappings":";;AAkBA,4DAgBC;AAhCD,yEAAqE;AACrE,iCAA2C;AAS3C;;;;;GAKG;AACH,SAAgB,wBAAwB,CAAqE,MAA4C;IACvJ,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,GAAG,EAAE,EAAE,GAAG,MAAM,CAAA;IAEhF,MAAM,YAAY,GAAG,IAAA,mDAAwB,EAAC,aAAa,EAAE,kBAAkB,CAAC,CAAA;IAEhF,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAE1C,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,IAAA,gBAAQ,EAAC,YAAY,CAAC,CAAA;IAEtD,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,MAAM,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;QAEvC,WAAW,CAAC,SAAS,CAAC,CAAA;IACxB,CAAC,EAAE,YAAY,CAAC,CAAA;IAEhB,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/lib/hooks/useAsyncSelect.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useAsyncSelect = useAsyncSelect;
+const react_1 = require("react");
+const react_query_1 = require("@tanstack/react-query");
+/**
+ * Wraps TanStack Query to power a search-driven async Select component.
+ *
+ * Returns a `[selectProps, state]` tuple. Spread the first element onto a
+ * `Select` component; use the second to drive the search query and inspect
+ * loading / error state.
+ *
+ * The query is gated by `isSearchValid` (defaults to non-empty/non-null).
+ * Pass `isSearchValid: () => true` to fetch on mount with an empty query.
+ * Requires a TanStack Query `QueryClientProvider` in the tree.
+ */
+function useAsyncSelect(opts) {
+    const { load, isSearchValid, renderError, renderNoResults, renderLoading, queryOptions, } = opts;
+    const hookId = (0, react_1.useId)();
+    const baseKey = opts.queryKey ?? [hookId];
+    const [searchQuery, setSearchQuery] = (0, react_1.useState)('');
+    const defaultIsValid = (q) => q != null && q !== '';
+    const enabled = isSearchValid ? isSearchValid(searchQuery) : defaultIsValid(searchQuery);
+    const queryResult = (0, react_query_1.useQuery)({
+        queryKey: ['asyncSelect', ...baseKey, searchQuery],
+        queryFn: () => load(searchQuery),
+        enabled,
+        placeholderData: (prev) => prev,
+        ...queryOptions,
+    });
+    const query = (0, react_1.useCallback)((q) => setSearchQuery(q), []);
+    const renderEmpty = (0, react_1.useCallback)(({ style }) => {
+        if (queryResult.isLoading || queryResult.isFetching) {
+            return renderLoading?.(style) ?? null;
+        }
+        if (queryResult.isError) {
+            return renderError?.(queryResult.error, style) ?? null;
+        }
+        return renderNoResults?.(searchQuery, style) ?? null;
+    }, [
+        queryResult.isLoading, queryResult.isFetching,
+        queryResult.isError, queryResult.error,
+        renderLoading, renderError, renderNoResults, searchQuery,
+    ]);
+    return [
+        {
+            options: (queryResult.data?.results ?? []),
+            renderEmpty,
+        },
+        {
+            query,
+            searchQuery,
+            data: queryResult.data?.data ?? null,
+            isLoading: queryResult.isLoading,
+            error: queryResult.error,
+            queryResult,
+        },
+    ];
+}
+//# sourceMappingURL=useAsyncSelect.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAsyncSelect.js","sourceRoot":"","sources":["../../../src/lib/hooks/useAsyncSelect.ts"],"names":[],"mappings":";;AAkEA,wCA2DC;AA7HD,iCAA2D;AAC3D,uDAA2F;AAsD3F;;;;;;;;;;GAUG;AACH,SAAgB,cAAc,CAI5B,IAA4C;IAE5C,MAAM,EACJ,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,GAC/E,GAAG,IAAI,CAAA;IAER,MAAM,MAAM,GAAG,IAAA,aAAK,GAAE,CAAA;IACtB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,CAAC,CAAA;IAEzC,MAAM,CAAC,WAAW,EAAE,cAAc,CAAC,GAAG,IAAA,gBAAQ,EAAS,EAAY,CAAC,CAAA;IAEpE,MAAM,cAAc,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,KAAM,EAAa,CAAA;IACvE,MAAM,OAAO,GAAG,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,CAAA;IAExF,MAAM,WAAW,GAAG,IAAA,sBAAQ,EAAC;QAC3B,QAAQ,EAAE,CAAC,aAAa,EAAE,GAAG,OAAO,EAAE,WAAW,CAAC;QAClD,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC;QAChC,OAAO;QACP,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI;QAC/B,GAAG,YAAY;KAChB,CAAC,CAAA;IAEF,MAAM,KAAK,GAAG,IAAA,mBAAW,EAAC,CAAC,CAAS,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAE/D,MAAM,WAAW,GAAG,IAAA,mBAAW,EAC7B,CAAC,EAAE,KAAK,EAAmB,EAAmB,EAAE;QAC9C,IAAI,WAAW,CAAC,SAAS,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;YACpD,OAAO,aAAa,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,CAAA;QACvC,CAAC;QACD,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;YACxB,OAAO,WAAW,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,IAAI,CAAA;QACxD,CAAC;QACD,OAAO,eAAe,EAAE,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,IAAI,CAAA;IACtD,CAAC,EACD;QACE,WAAW,CAAC,SAAS,EAAE,WAAW,CAAC,UAAU;QAC7C,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,KAAK;QACtC,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW;KACzD,CACF,CAAA;IAED,OAAO;QACL;YACE,OAAO,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,IAAI,EAAE,CAAc;YACvD,WAAW;SACZ;QACD;YACE,KAAK;YACL,WAAW;YACX,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,IAAI,IAAI,IAAI;YACpC,SAAS,EAAE,WAAW,CAAC,SAAS;YAChC,KAAK,EAAE,WAAW,CAAC,KAAK;YACxB,WAAW;SACZ;KACF,CAAA;AACH,CAAC"}

package/dist/lib/hooks/useBreakpointMatch.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useBreakpointMatch = useBreakpointMatch;
+const react_1 = require("react");
+const types_1 = require("@codeleap/types");
+const styles_1 = require("@codeleap/styles");
+const tools_1 = require("../tools");
+const getTheme = () => styles_1.themeStore.themeTyped;
+function validateBreakpoint(currentTheme, breakpoint) {
+    const matchesDown = (0, tools_1.isMediaQuery)(currentTheme.media.down(breakpoint));
+    const matchesUp = (0, tools_1.isMediaQuery)(currentTheme.media.up(breakpoint));
+    return !matchesUp && matchesDown;
+}
+function useBreakpointMatches() {
+    return (0, react_1.useState)(() => {
+        const currentTheme = getTheme();
+        const breakpointMatches = {};
+        for (const breakpoint in currentTheme.breakpoints) {
+            breakpointMatches[breakpoint] = validateBreakpoint(currentTheme, breakpoint);
+        }
+        return breakpointMatches;
+    });
+}
+function useBreakpointListeners() {
+    const [breakpointMatches, setBreakpointMatches] = useBreakpointMatches();
+    const loaded = (0, react_1.useRef)(false);
+    const mediaQueries = (0, react_1.useRef)({});
+    function callback(event, breakpoint) {
+        const currentTheme = getTheme();
+        setBreakpointMatches((prevState) => {
+            const updatedMatches = { ...prevState };
+            updatedMatches[breakpoint] = validateBreakpoint(currentTheme, breakpoint);
+            return updatedMatches;
+        });
+    }
+    (0, react_1.useEffect)(() => {
+        if (loaded.current)
+            return;
+        loaded.current = true;
+        const currentTheme = getTheme();
+        for (const breakpoint in currentTheme.breakpoints) {
+            const queryUp = (0, tools_1.getMediaQuery)(currentTheme.media.up(breakpoint));
+            const matchUp = window.matchMedia(queryUp);
+            mediaQueries.current[breakpoint] = matchUp;
+            try {
+                matchUp.addEventListener('change', (event) => callback(event, breakpoint));
+            }
+            catch {
+                matchUp.addListener((event) => callback(event, breakpoint));
+            }
+        }
+        return () => {
+            for (const breakpoint in mediaQueries.current) {
+                const matchUp = mediaQueries.current[breakpoint];
+                try {
+                    matchUp.removeEventListener('change', (event) => callback(event, breakpoint));
+                }
+                catch {
+                    matchUp.removeListener((event) => callback(event, breakpoint));
+                }
+            }
+            mediaQueries.current = {};
+        };
+    }, []);
+    return breakpointMatches;
+}
+/**
+ * Returns the value mapped to the currently active breakpoint.
+ *
+ * Reads breakpoint definitions from the active `themeStore` theme and attaches
+ * `matchMedia` listeners to track viewport changes reactively. The lookup walks
+ * up from the current breakpoint until it finds a key present in `values`, so
+ * you can omit smaller breakpoints and let them fall back to the next larger one.
+ *
+ * Must be rendered in a browser context; SSR always resolves to the fallback
+ * value (the largest defined key in `values`).
+ */
+function useBreakpointMatch(values) {
+    const breakpointMatches = useBreakpointListeners();
+    const breakpoints = (0, react_1.useMemo)(() => {
+        return Object.entries(getTheme().breakpoints)
+            .sort(([, a], [, b]) => a - b)
+            .reduce((acc, [key, value]) => {
+            acc[key] = value;
+            return acc;
+        }, {});
+    }, []);
+    const breakpointValues = (0, react_1.useMemo)(() => {
+        return Object.keys(breakpoints).sort((a, b) => breakpoints?.[a] - breakpoints?.[b]);
+    }, []);
+    const currentBreakpoint = (0, react_1.useMemo)(() => {
+        return Object.keys(breakpointMatches).find((key) => breakpointMatches[key]);
+    }, [breakpointMatches]);
+    const breakpoint = (0, react_1.useMemo)(() => {
+        const validBreakpointIndex = breakpointValues?.findIndex(key => key === currentBreakpoint);
+        const validBreakpoints = breakpointValues?.slice(validBreakpointIndex, 100);
+        let validBreakpoint = null;
+        validBreakpoint = validBreakpoints?.find((currentValue) => {
+            if (Object?.keys(values)?.includes(currentValue)) {
+                return currentValue;
+            }
+        });
+        if (types_1.TypeGuards.isNil(validBreakpoint)) {
+            validBreakpoint = breakpointValues?.reverse()?.find(key => !!values?.[key]);
+        }
+        return validBreakpoint;
+    }, [currentBreakpoint]);
+    const value = (0, react_1.useMemo)(() => values?.[breakpoint], [breakpoint]);
+    return value;
+}
+//# sourceMappingURL=useBreakpointMatch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useBreakpointMatch.js","sourceRoot":"","sources":["../../../src/lib/hooks/useBreakpointMatch.ts"],"names":[],"mappings":";;AA+FA,gDA2CC;AA1ID,iCAA4D;AAC5D,2CAA4C;AAC5C,6CAA0E;AAC1E,oCAAsD;AAEtD,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,mBAAU,CAAC,UAAU,CAAA;AAE5C,SAAS,kBAAkB,CAAC,YAA6B,EAAE,UAAkB;IAC3E,MAAM,WAAW,GAAG,IAAA,oBAAY,EAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,UAAmB,CAAC,CAAC,CAAA;IAC9E,MAAM,SAAS,GAAG,IAAA,oBAAY,EAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,UAAmB,CAAC,CAAC,CAAA;IAE1E,OAAO,CAAC,SAAS,IAAI,WAAW,CAAA;AAClC,CAAC;AAED,SAAS,oBAAoB;IAC3B,OAAO,IAAA,gBAAQ,EAA0B,GAAG,EAAE;QAC5C,MAAM,YAAY,GAAG,QAAQ,EAAE,CAAA;QAE/B,MAAM,iBAAiB,GAA4B,EAAE,CAAA;QAErD,KAAK,MAAM,UAAU,IAAI,YAAY,CAAC,WAAW,EAAE,CAAC;YAClD,iBAAiB,CAAC,UAAU,CAAC,GAAG,kBAAkB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAA;QAC9E,CAAC;QAED,OAAO,iBAAiB,CAAA;IAC1B,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,sBAAsB;IAC7B,MAAM,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,GAAG,oBAAoB,EAAE,CAAA;IACxE,MAAM,MAAM,GAAG,IAAA,cAAM,EAAC,KAAK,CAAC,CAAA;IAC5B,MAAM,YAAY,GAAG,IAAA,cAAM,EAAiC,EAAE,CAAC,CAAA;IAE/D,SAAS,QAAQ,CAAC,KAA0B,EAAE,UAAkB;QAC9D,MAAM,YAAY,GAAG,QAAQ,EAAE,CAAA;QAE/B,oBAAoB,CAAC,CAAC,SAAS,EAAE,EAAE;YACjC,MAAM,cAAc,GAAG,EAAE,GAAG,SAAS,EAAE,CAAA;YAEvC,cAAc,CAAC,UAAU,CAAC,GAAG,kBAAkB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAA;YAEzE,OAAO,cAAc,CAAA;QACvB,CAAC,CAAC,CAAA;IACJ,CAAC;IAED,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,IAAI,MAAM,CAAC,OAAO;YAAE,OAAM;QAE1B,MAAM,CAAC,OAAO,GAAG,IAAI,CAAA;QAErB,MAAM,YAAY,GAAG,QAAQ,EAAE,CAAA;QAE/B,KAAK,MAAM,UAAU,IAAI,YAAY,CAAC,WAAW,EAAE,CAAC;YAClD,MAAM,OAAO,GAAG,IAAA,qBAAa,EAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,UAAmB,CAAC,CAAC,CAAA;YAEzE,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;YAE1C,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,OAAO,CAAA;YAE1C,IAAI,CAAC;gBACH,OAAO,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAA;YAC5E,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,WAAW,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAA;YAC7D,CAAC;QACH,CAAC;QAED,OAAO,GAAG,EAAE;YACV,KAAK,MAAM,UAAU,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;gBAC9C,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;gBAEhD,IAAI,CAAC;oBACH,OAAO,CAAC,mBAAmB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAA;gBAC/E,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,CAAC,cAAc,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAA;gBAChE,CAAC;YACH,CAAC;YAED,YAAY,CAAC,OAAO,GAAG,EAAE,CAAA;QAC3B,CAAC,CAAA;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,OAAO,iBAAiB,CAAA;AAC1B,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,kBAAkB,CAAa,MAAsC;IACnF,MAAM,iBAAiB,GAAG,sBAAsB,EAAE,CAAA;IAElD,MAAM,WAAW,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE;QAC/B,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,WAAW,CAAC;aAC1C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;aAC7B,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YAC5B,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;YAChB,OAAO,GAAG,CAAA;QACZ,CAAC,EAAE,EAA4B,CAAC,CAAA;IACpC,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,gBAAgB,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE;QACpC,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IACrF,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,iBAAiB,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE;QACrC,OAAO,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAA;IAC7E,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAA;IAEvB,MAAM,UAAU,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE;QAC9B,MAAM,oBAAoB,GAAG,gBAAgB,EAAE,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,iBAAiB,CAAC,CAAA;QAE1F,MAAM,gBAAgB,GAAG,gBAAgB,EAAE,KAAK,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAA;QAE3E,IAAI,eAAe,GAAG,IAAI,CAAA;QAE1B,eAAe,GAAG,gBAAgB,EAAE,IAAI,CAAC,CAAC,YAAY,EAAE,EAAE;YACxD,IAAI,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;gBACjD,OAAO,YAAY,CAAA;YACrB,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,IAAI,kBAAU,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC;YACtC,eAAe,GAAG,gBAAgB,EAAE,OAAO,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;QAC7E,CAAC;QAED,OAAO,eAAe,CAAA;IACxB,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAA;IAEvB,MAAM,KAAK,GAAG,IAAA,eAAO,EAAC,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAA;IAE/D,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/lib/hooks/useClick.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useClickOutsideElement = useClickOutsideElement;
+const types_1 = require("@codeleap/types");
+const react_1 = require("react");
+/**
+ * Attaches a global `click` listener and calls `handler` with `true` when the
+ * user clicks outside the returned ref's element, or `false` when they click
+ * inside it. Pass additional `elements` refs to treat those nodes as "inside"
+ * as well — the handler fires `false` if any of them contains the click target.
+ */
+function useClickOutsideElement(handler, elements = null) {
+    const elementRef = (0, react_1.useRef)(null);
+    const handleClickOutside = (0, react_1.useCallback)((event) => {
+        if (!elementRef.current)
+            return;
+        const clickedOutsideElement = !elementRef.current.contains(event?.target);
+        const clickedOutsideElements = [true];
+        if (types_1.TypeGuards?.isArray(elements)) {
+            elements?.forEach(element => {
+                if (element.current) {
+                    clickedOutsideElements.push(!element.current.contains(event?.target));
+                }
+            });
+        }
+        if (clickedOutsideElement && clickedOutsideElements.every((clickedOutside) => !!clickedOutside)) {
+            handler(true);
+        }
+        else {
+            handler(false);
+        }
+    }, [handler]);
+    (0, react_1.useEffect)(() => {
+        document.addEventListener('click', handleClickOutside);
+        return () => {
+            document.removeEventListener('click', handleClickOutside);
+        };
+    }, [handleClickOutside]);
+    return elementRef;
+}
+//# sourceMappingURL=useClick.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useClick.js","sourceRoot":"","sources":["../../../src/lib/hooks/useClick.ts"],"names":[],"mappings":";;AAaA,wDAoCC;AAjDD,2CAA4C;AAC5C,iCAA6D;AAM7D;;;;;GAKG;AACH,SAAgB,sBAAsB,CACpC,OAA4B,EAC5B,WAA+C,IAAI;IAEnD,MAAM,UAAU,GAAG,IAAA,cAAM,EAAC,IAAI,CAAC,CAAA;IAE/B,MAAM,kBAAkB,GAAG,IAAA,mBAAW,EAAC,CAAC,KAAiB,EAAE,EAAE;QAC3D,IAAI,CAAC,UAAU,CAAC,OAAO;YAAE,OAAM;QAE/B,MAAM,qBAAqB,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;QACzE,MAAM,sBAAsB,GAAG,CAAC,IAAI,CAAC,CAAA;QAErC,IAAI,kBAAU,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE;gBAC1B,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;oBACpB,sBAAsB,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAA;gBACvE,CAAC;YACH,CAAC,CAAC,CAAA;QACJ,CAAC;QAED,IAAI,qBAAqB,IAAI,sBAAsB,CAAC,KAAK,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC;YAChG,OAAO,CAAC,IAAI,CAAC,CAAA;QACf,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,CAAA;QAChB,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAA;IAEb,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAA;QAEtD,OAAO,GAAG,EAAE;YACV,QAAQ,CAAC,mBAAmB,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAA;QAC3D,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAA;IAExB,OAAO,UAAU,CAAA;AACnB,CAAC"}

package/dist/lib/hooks/useClickOutside.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useClickOutside = useClickOutside;
+const react_1 = require("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.
+ */
+function useClickOutside(handler, events, nodes) {
+    const ref = (0, react_1.useRef)(null);
+    (0, react_1.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":";;AAYA,0CA0BC;AAtCD,iCAAyC;AAEzC,MAAM,cAAc,GAAG,CAAC,WAAW,EAAE,YAAY,CAAC,CAAA;AAElD;;;;;;;GAOG;AACH,SAAgB,eAAe,CAC7B,OAAmB,EACnB,MAAwB,EACxB,KAAqB;IAErB,MAAM,GAAG,GAAG,IAAA,cAAM,EAAI,IAAI,CAAC,CAAA;IAE3B,IAAA,iBAAS,EAAC,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,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useFileInput = void 0;
+const react_1 = require("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.
+ */
+const useFileInput = () => {
+    const inputRef = (0, react_1.useRef)(null);
+    const openFilePicker = () => {
+        return inputRef.current?.openFilePicker();
+    };
+    return {
+        openFilePicker,
+        ref: inputRef,
+    };
+};
+exports.useFileInput = useFileInput;
+//# 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,iCAA8B;AAG9B;;;;GAIG;AACI,MAAM,YAAY,GAAG,GAAG,EAAE;IAC/B,MAAM,QAAQ,GAAG,IAAA,cAAM,EAAsB,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;AAXY,QAAA,YAAY,gBAWxB"}

package/dist/lib/hooks/useIsomorphicEffect.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useIsomorphicEffect = void 0;
+const react_1 = require("react");
+/**
+ * `useLayoutEffect` in the browser; `useEffect` on the server.
+ * Avoids the React SSR warning about `useLayoutEffect` in non-browser environments.
+ */
+exports.useIsomorphicEffect = typeof document !== 'undefined' ? react_1.useLayoutEffect : react_1.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,iCAAkD;AAElD;;;GAGG;AACU,QAAA,mBAAmB,GAAG,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,uBAAe,CAAC,CAAC,CAAC,iBAAS,CAAA"}

package/dist/lib/hooks/useKeydown.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.keydownDefaultKeyOptions = void 0;
+exports.useKeydown = useKeydown;
+const types_1 = require("@codeleap/types");
+const react_1 = require("react");
+/** Convenience key descriptors available as `useKeydown.keys`. */
+exports.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.
+ */
+function useKeydown(expectedKey, handler, deps = [], options) {
+    const eventKey = types_1.TypeGuards.isString(expectedKey) ? (useKeydown?.keys?.[expectedKey] ?? expectedKey) : expectedKey;
+    const handleKeyPress = (event) => {
+        const { key, code } = types_1.TypeGuards.isString(eventKey) ? { key: eventKey, code: eventKey } : eventKey;
+        if (event?.key === key || event?.code === code) {
+            handler?.(event);
+        }
+    };
+    (0, react_1.useEffect)(() => {
+        document.addEventListener('keydown', handleKeyPress, options);
+        return () => {
+            document.removeEventListener('keydown', handleKeyPress);
+        };
+    }, deps);
+}
+useKeydown.keys = exports.keydownDefaultKeyOptions;
+useKeydown.defaultKeyOptions = exports.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":";;;AAuBA,gCAuBC;AA9CD,2CAA4C;AAC5C,iCAAiC;AAEjC,kEAAkE;AACrD,QAAA,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,SAAgB,UAAU,CACxB,WAAyE,EACzE,OAAuC,EACvC,OAAmB,EAAE,EACrB,OAA2C;IAE3C,MAAM,QAAQ,GAAG,kBAAU,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,kBAAU,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,IAAA,iBAAS,EAAC,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,gCAAwB,CAAA;AAC1C,UAAU,CAAC,iBAAiB,GAAG,gCAAwB,CAAA"}

package/dist/lib/hooks/useListFocus.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useListFocus = useListFocus;
+const react_1 = require("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.
+ */
+function useListFocus(listBoxRef, externalRef) {
+    const handle = (0, react_1.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]);
+    (0, react_1.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":";;AAoBA,oCAsCC;AA1DD,iCAA0D;AAS1D;;;;;;;;;;GAUG;AACH,SAAgB,YAAY,CAC1B,UAAyC,EACzC,WAA+C;IAE/C,MAAM,MAAM,GAAG,IAAA,eAAO,EAAkB,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,IAAA,iBAAS,EAAC,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,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useMediaQuery = useMediaQuery;
+const react_1 = require("react");
+const tools_1 = require("../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`.
+ */
+function useMediaQuery(query) {
+    const [matches, setMatches] = (0, react_1.useState)((0, tools_1.isMediaQuery)(query));
+    const queryRef = (0, react_1.useRef)(undefined);
+    (0, react_1.useEffect)(() => {
+        if (query?.trim() === '' || !query)
+            return;
+        if ('matchMedia' in window) {
+            queryRef.current = window.matchMedia((0, tools_1.getMediaQuery)(query));
+            setMatches(queryRef.current.matches);
+            return (0, tools_1.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":";;AAUA,sCAkBC;AA5BD,iCAAmD;AACnD,oCAA2E;AAE3E;;;;;;GAMG;AACH,SAAgB,aAAa,CAAC,KAAa;IACzC,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,IAAA,gBAAQ,EAAC,IAAA,oBAAY,EAAC,KAAK,CAAC,CAAC,CAAA;IAE3D,MAAM,QAAQ,GAAG,IAAA,cAAM,EAAiB,SAAS,CAAC,CAAA;IAElD,IAAA,iBAAS,EAAC,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,IAAA,qBAAa,EAAC,KAAK,CAAC,CAAC,CAAA;YAC1D,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;YACpC,OAAO,IAAA,2BAAmB,EAAC,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,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.usePageExitBlocker = void 0;
+const router_1 = require("@reach/router");
+const react_1 = require("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.
+ */
+const usePageExitBlocker = (handler, deps = [], message = 'Are you sure you want to leave?') => {
+    const handleBeforeUnload = (event) => {
+        if (!event)
+            return null;
+        event?.preventDefault();
+        event.returnValue = '';
+        return;
+    };
+    (0, react_1.useEffect)(() => {
+        if (!window)
+            return null;
+        window.addEventListener('beforeunload', handleBeforeUnload);
+        return () => {
+            window.removeEventListener('beforeunload', handleBeforeUnload);
+        };
+    }, deps);
+    (0, react_1.useEffect)(() => {
+        return router_1.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);
+};
+exports.usePageExitBlocker = usePageExitBlocker;
+//# 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,0CAA6C;AAC7C,iCAAiC;AAEjC;;;;;;;;;GASG;AACI,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,IAAA,iBAAS,EAAC,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,IAAA,iBAAS,EAAC,GAAG,EAAE;QACb,OAAO,sBAAa,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;AAxCY,QAAA,kBAAkB,sBAwC9B"}