@refraktor/utils 0.0.1

package/.turbo/turbo-build.log

@@ -0,0 +1 @@
+$ tsc

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ChillWoW
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,21 @@
+# @refraktor/utils
+
+Utility and hooks library for Refraktor.
+
+## Installation
+
+```bash
+# NPM
+npm install @refraktor/utils
+
+# Bun
+bun add @refraktor/utils
+```
+
+## Documentation
+
+Coming Soon...
+
+## License
+
+[MIT](LICENSE)

package/build/hooks/index.d.ts

@@ -0,0 +1,9 @@
+export { useId } from "./use-id";
+export { useDisclosure } from "./use-disclosure";
+export { useClickOutside } from "./use-click-outside";
+export { useResizeObserver } from "./use-resize-observer";
+export { useMergedRefs } from "./use-merged-refs";
+export { useUncontrolled } from "./use-uncontrolled";
+export { useDebouncedCallback } from "./use-debounced-callback";
+export { useIsomorphicLayoutEffect } from "./use-isomorphic-layout-effect";
+//# sourceMappingURL=index.d.ts.map

package/build/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC"}

package/build/hooks/index.js

@@ -0,0 +1,8 @@
+export { useId } from "./use-id";
+export { useDisclosure } from "./use-disclosure";
+export { useClickOutside } from "./use-click-outside";
+export { useResizeObserver } from "./use-resize-observer";
+export { useMergedRefs } from "./use-merged-refs";
+export { useUncontrolled } from "./use-uncontrolled";
+export { useDebouncedCallback } from "./use-debounced-callback";
+export { useIsomorphicLayoutEffect } from "./use-isomorphic-layout-effect";

package/build/hooks/use-click-outside/index.d.ts

@@ -0,0 +1,5 @@
+export type UseClickOutsideEvent = keyof DocumentEventMap;
+type UseClickOutsideNode = HTMLElement | null;
+export declare function useClickOutside<T extends HTMLElement = HTMLElement>(handler: (event: Event) => void, events?: UseClickOutsideEvent[], nodes?: UseClickOutsideNode[]): import("react").RefObject<T | null>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/hooks/use-click-outside/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-click-outside/index.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,GAAG,MAAM,gBAAgB,CAAC;AAE1D,KAAK,mBAAmB,GAAG,WAAW,GAAG,IAAI,CAAC;AAK9C,wBAAgB,eAAe,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAC/D,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,EAC/B,MAAM,GAAE,oBAAoB,EAAmB,EAC/C,KAAK,GAAE,mBAAmB,EAAkB,uCA+D/C"}

package/build/hooks/use-click-outside/index.js

@@ -0,0 +1,50 @@
+import { useEffect, useRef } from "react";
+const DEFAULT_EVENTS = ["mousedown", "touchstart"];
+const DEFAULT_NODES = [];
+export function useClickOutside(handler, events = DEFAULT_EVENTS, nodes = DEFAULT_NODES) {
+    const ref = useRef(null);
+    const handlerRef = useRef(handler);
+    useEffect(() => {
+        handlerRef.current = handler;
+    }, [handler]);
+    useEffect(() => {
+        const listener = (event) => {
+            const target = event.target;
+            if (!(target instanceof Node)) {
+                return;
+            }
+            const element = ref.current;
+            if (!element) {
+                return;
+            }
+            const path = typeof event.composedPath === "function"
+                ? event.composedPath()
+                : undefined;
+            const isInsideElement = path
+                ? path.includes(element)
+                : element.contains(target);
+            if (isInsideElement) {
+                return;
+            }
+            const isInsideAdditionalNode = nodes.some((node) => {
+                if (!node) {
+                    return false;
+                }
+                return path ? path.includes(node) : node.contains(target);
+            });
+            if (isInsideAdditionalNode) {
+                return;
+            }
+            handlerRef.current(event);
+        };
+        for (const eventName of events) {
+            document.addEventListener(eventName, listener);
+        }
+        return () => {
+            for (const eventName of events) {
+                document.removeEventListener(eventName, listener);
+            }
+        };
+    }, [events, nodes]);
+    return ref;
+}

package/build/hooks/use-debounced-callback/index.d.ts

@@ -0,0 +1,11 @@
+export interface UseDebouncedCallbackOptions {
+    leading?: boolean;
+    trailing?: boolean;
+}
+export type UseDebouncedCallbackReturn<TArgs extends unknown[], TResult> = ((...args: TArgs) => void) & {
+    cancel: () => void;
+    flush: () => TResult | undefined;
+    isPending: () => boolean;
+};
+export declare function useDebouncedCallback<TArgs extends unknown[], TResult>(callback: (...args: TArgs) => TResult, delay: number, options?: UseDebouncedCallbackOptions): UseDebouncedCallbackReturn<TArgs, TResult>;
+//# sourceMappingURL=index.d.ts.map

package/build/hooks/use-debounced-callback/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-debounced-callback/index.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,2BAA2B;IACxC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,MAAM,0BAA0B,CAClC,KAAK,SAAS,OAAO,EAAE,EACvB,OAAO,IACP,CAAC,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG;IAC7B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,KAAK,EAAE,MAAM,OAAO,GAAG,SAAS,CAAC;IACjC,SAAS,EAAE,MAAM,OAAO,CAAC;CAC5B,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,KAAK,SAAS,OAAO,EAAE,EAAE,OAAO,EACjE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,EACrC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,2BAAgC,GAC1C,0BAA0B,CAAC,KAAK,EAAE,OAAO,CAAC,CA2G5C"}

package/build/hooks/use-debounced-callback/index.js

@@ -0,0 +1,88 @@
+import { useCallback, useEffect, useMemo, useRef } from "react";
+export function useDebouncedCallback(callback, delay, options = {}) {
+    const { leading = false, trailing = true } = options;
+    const wait = Math.max(0, delay);
+    const callbackRef = useRef(callback);
+    const timeoutRef = useRef(null);
+    const lastArgsRef = useRef(null);
+    const shouldCallTrailingRef = useRef(false);
+    const resultRef = useRef(undefined);
+    useEffect(() => {
+        callbackRef.current = callback;
+    }, [callback]);
+    const invoke = useCallback((args) => {
+        const result = callbackRef.current(...args);
+        resultRef.current = result;
+        return result;
+    }, []);
+    const clearTimer = useCallback(() => {
+        if (timeoutRef.current !== null) {
+            clearTimeout(timeoutRef.current);
+            timeoutRef.current = null;
+        }
+    }, []);
+    const cancel = useCallback(() => {
+        clearTimer();
+        shouldCallTrailingRef.current = false;
+        lastArgsRef.current = null;
+    }, [clearTimer]);
+    const flush = useCallback(() => {
+        if (timeoutRef.current === null) {
+            return resultRef.current;
+        }
+        clearTimer();
+        if (trailing &&
+            shouldCallTrailingRef.current &&
+            lastArgsRef.current !== null) {
+            const next = invoke(lastArgsRef.current);
+            shouldCallTrailingRef.current = false;
+            lastArgsRef.current = null;
+            return next;
+        }
+        shouldCallTrailingRef.current = false;
+        lastArgsRef.current = null;
+        return resultRef.current;
+    }, [clearTimer, invoke, trailing]);
+    const isPending = useCallback(() => timeoutRef.current !== null, []);
+    const debounced = useMemo(() => {
+        const fn = (...args) => {
+            if (!leading && !trailing) {
+                return;
+            }
+            const hasTimer = timeoutRef.current !== null;
+            if (!hasTimer) {
+                if (leading) {
+                    invoke(args);
+                    shouldCallTrailingRef.current = false;
+                    lastArgsRef.current = null;
+                }
+                else {
+                    shouldCallTrailingRef.current = true;
+                    lastArgsRef.current = args;
+                }
+            }
+            else if (trailing) {
+                shouldCallTrailingRef.current = true;
+                lastArgsRef.current = args;
+            }
+            clearTimer();
+            timeoutRef.current = setTimeout(() => {
+                timeoutRef.current = null;
+                if (trailing &&
+                    shouldCallTrailingRef.current &&
+                    lastArgsRef.current !== null) {
+                    invoke(lastArgsRef.current);
+                }
+                shouldCallTrailingRef.current = false;
+                lastArgsRef.current = null;
+            }, wait);
+        };
+        return Object.assign(fn, {
+            cancel,
+            flush,
+            isPending
+        });
+    }, [cancel, clearTimer, flush, invoke, isPending, leading, trailing, wait]);
+    useEffect(() => cancel, [cancel]);
+    return debounced;
+}

package/build/hooks/use-disclosure/index.d.ts

@@ -0,0 +1,12 @@
+export interface UseDisclosureCallbacks {
+    onOpen?: () => void;
+    onClose?: () => void;
+}
+export interface UseDisclosureHandlers {
+    open: () => void;
+    close: () => void;
+    toggle: () => void;
+}
+export type UseDisclosureReturn = [boolean, UseDisclosureHandlers];
+export declare function useDisclosure(initialState?: boolean, callbacks?: UseDisclosureCallbacks): UseDisclosureReturn;
+//# sourceMappingURL=index.d.ts.map

package/build/hooks/use-disclosure/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-disclosure/index.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,sBAAsB;IACnC,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,qBAAqB;IAClC,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,MAAM,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;AAEnE,wBAAgB,aAAa,CACzB,YAAY,UAAQ,EACpB,SAAS,CAAC,EAAE,sBAAsB,GACnC,mBAAmB,CAgDrB"}

package/build/hooks/use-disclosure/index.js

@@ -0,0 +1,39 @@
+import { useCallback, useMemo, useState } from "react";
+export function useDisclosure(initialState = false, callbacks) {
+    const [opened, setOpened] = useState(initialState);
+    const { onOpen, onClose } = callbacks ?? {};
+    const open = useCallback(() => {
+        setOpened((isOpened) => {
+            if (!isOpened) {
+                onOpen?.();
+            }
+            return true;
+        });
+    }, [onOpen]);
+    const close = useCallback(() => {
+        setOpened((isOpened) => {
+            if (isOpened) {
+                onClose?.();
+            }
+            return false;
+        });
+    }, [onClose]);
+    const toggle = useCallback(() => {
+        setOpened((isOpened) => {
+            const next = !isOpened;
+            if (next) {
+                onOpen?.();
+            }
+            else {
+                onClose?.();
+            }
+            return next;
+        });
+    }, [onOpen, onClose]);
+    const handlers = useMemo(() => ({
+        open,
+        close,
+        toggle
+    }), [open, close, toggle]);
+    return [opened, handlers];
+}

package/build/hooks/use-id/index.d.ts

@@ -0,0 +1,2 @@
+export declare function useId(propId?: any): string;
+//# sourceMappingURL=index.d.ts.map

package/build/hooks/use-id/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-id/index.ts"],"names":[],"mappings":"AAEA,wBAAgB,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,GAAG,MAAM,CAG1C"}

package/build/hooks/use-id/index.js

@@ -0,0 +1,5 @@
+import { useId as useReactId } from "react";
+export function useId(propId) {
+    const id = useReactId();
+    return propId ?? id;
+}

package/build/hooks/use-isomorphic-layout-effect/index.d.ts

@@ -0,0 +1,3 @@
+import { useLayoutEffect } from "react";
+export declare const useIsomorphicLayoutEffect: typeof useLayoutEffect;
+//# sourceMappingURL=index.d.ts.map

package/build/hooks/use-isomorphic-layout-effect/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-isomorphic-layout-effect/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,eAAe,EAAE,MAAM,OAAO,CAAC;AAEnD,eAAO,MAAM,yBAAyB,EAAE,OAAO,eACgB,CAAC"}

package/build/hooks/use-isomorphic-layout-effect/index.js

@@ -0,0 +1,2 @@
+import { useEffect, useLayoutEffect } from "react";
+export const useIsomorphicLayoutEffect = typeof window !== "undefined" ? useLayoutEffect : useEffect;

package/build/hooks/use-merged-refs/index.d.ts

@@ -0,0 +1,6 @@
+import { Ref, RefCallback } from "react";
+type AnyRef<T> = Ref<T> | undefined;
+export declare function mergeRefs<T>(...refs: AnyRef<T>[]): RefCallback<T>;
+export declare function useMergedRefs<T>(...refs: AnyRef<T>[]): RefCallback<T>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/hooks/use-merged-refs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-merged-refs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAe,WAAW,EAAE,MAAM,OAAO,CAAC;AAEtD,KAAK,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;AAepC,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAuBjE;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,kBAEpD"}

package/build/hooks/use-merged-refs/index.js

@@ -0,0 +1,38 @@
+import { useCallback } from "react";
+function applyRef(ref, value) {
+    if (!ref)
+        return;
+    if (typeof ref === "function") {
+        return ref(value);
+    }
+    if (typeof ref === "object" && "current" in ref) {
+        ref.current = value;
+    }
+}
+export function mergeRefs(...refs) {
+    const cleanups = new Map();
+    return (node) => {
+        for (const ref of refs) {
+            const cleanup = applyRef(ref, node);
+            if (cleanup)
+                cleanups.set(ref, cleanup);
+        }
+        if (cleanups.size > 0) {
+            return () => {
+                for (const ref of refs) {
+                    const fn = cleanups.get(ref);
+                    if (typeof fn === "function") {
+                        fn();
+                    }
+                    else {
+                        applyRef(ref, null);
+                    }
+                }
+                cleanups.clear();
+            };
+        }
+    };
+}
+export function useMergedRefs(...refs) {
+    return useCallback(mergeRefs(...refs), refs);
+}

package/build/hooks/use-resize-observer/index.d.ts

@@ -0,0 +1,15 @@
+export interface UseResizeObserverSize {
+    width: number;
+    height: number;
+}
+export interface UseResizeObserverOptions {
+    initialSize?: UseResizeObserverSize;
+    box?: ResizeObserverBoxOptions;
+    onResize?: (entry: ResizeObserverEntry) => void;
+}
+export interface UseResizeObserverReturn<T extends HTMLElement = HTMLElement> extends UseResizeObserverSize {
+    ref: (node: T | null) => void;
+    entry: ResizeObserverEntry | null;
+}
+export declare function useResizeObserver<T extends HTMLElement = HTMLElement>(options?: UseResizeObserverOptions): UseResizeObserverReturn<T>;
+//# sourceMappingURL=index.d.ts.map

package/build/hooks/use-resize-observer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-resize-observer/index.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,qBAAqB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,wBAAwB;IACrC,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,GAAG,CAAC,EAAE,wBAAwB,CAAC;IAC/B,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,CACxE,SAAQ,qBAAqB;IAC7B,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,KAAK,IAAI,CAAC;IAC9B,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACrC;AAWD,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EACjE,OAAO,GAAE,wBAA6B,GACvC,uBAAuB,CAAC,CAAC,CAAC,CA0E5B"}

package/build/hooks/use-resize-observer/index.js

@@ -0,0 +1,65 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+const DEFAULT_SIZE = {
+    width: 0,
+    height: 0
+};
+export function useResizeObserver(options = {}) {
+    const { initialSize = DEFAULT_SIZE, box, onResize } = options;
+    const [node, setNode] = useState(null);
+    const [state, setState] = useState(() => ({
+        width: initialSize.width,
+        height: initialSize.height,
+        entry: null
+    }));
+    const onResizeRef = useRef(onResize);
+    useEffect(() => {
+        onResizeRef.current = onResize;
+    }, [onResize]);
+    const ref = useCallback((nextNode) => {
+        setNode(nextNode);
+    }, []);
+    useEffect(() => {
+        if (!node) {
+            return;
+        }
+        if (typeof window === "undefined" ||
+            typeof ResizeObserver === "undefined") {
+            return;
+        }
+        const observer = new ResizeObserver(([entry]) => {
+            if (!entry) {
+                return;
+            }
+            const nextWidth = entry.contentRect.width;
+            const nextHeight = entry.contentRect.height;
+            setState((current) => {
+                if (current.width === nextWidth &&
+                    current.height === nextHeight &&
+                    current.entry !== null) {
+                    return current;
+                }
+                return {
+                    width: nextWidth,
+                    height: nextHeight,
+                    entry
+                };
+            });
+            onResizeRef.current?.(entry);
+        });
+        try {
+            observer.observe(node, box ? { box } : undefined);
+        }
+        catch {
+            observer.observe(node);
+        }
+        return () => {
+            observer.disconnect();
+        };
+    }, [box, node]);
+    return {
+        ref,
+        width: state.width,
+        height: state.height,
+        entry: state.entry
+    };
+}

package/build/hooks/use-uncontrolled/index.d.ts

@@ -0,0 +1,13 @@
+export type UseUncontrolledProps<T> = {
+    value?: T;
+    defaultValue?: T;
+    finalValue?: T;
+    onChange?: (value: T, ...payload: any[]) => void;
+};
+export type UseUncontrolledReturn<T> = [
+    T,
+    (value: T, ...payload: any[]) => void,
+    boolean
+];
+export declare function useUncontrolled<T>({ value, defaultValue, finalValue, onChange }: UseUncontrolledProps<T>): UseUncontrolledReturn<T>;
+//# sourceMappingURL=index.d.ts.map

package/build/hooks/use-uncontrolled/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/use-uncontrolled/index.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI;IAClC,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,YAAY,CAAC,EAAE,CAAC,CAAC;IACjB,UAAU,CAAC,EAAE,CAAC,CAAC;IACf,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI;IACnC,CAAC;IACD,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,KAAK,IAAI;IACrC,OAAO;CACV,CAAC;AAEF,wBAAgB,eAAe,CAAC,CAAC,EAAE,EAC/B,KAAK,EACL,YAAY,EACZ,UAAU,EACV,QAAmB,EACtB,EAAE,oBAAoB,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAepD"}

package/build/hooks/use-uncontrolled/index.js

@@ -0,0 +1,12 @@
+import { useState } from "react";
+export function useUncontrolled({ value, defaultValue, finalValue, onChange = () => { } }) {
+    const [state, setState] = useState(defaultValue !== undefined ? defaultValue : finalValue);
+    const handleChange = (val, ...payload) => {
+        setState(val);
+        onChange?.(val, ...payload);
+    };
+    if (value !== undefined) {
+        return [value, onChange, true];
+    }
+    return [state, handleChange, false];
+}

package/build/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./hooks";
+export * from "./utils";
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/build/index.js

@@ -0,0 +1,2 @@
+export * from "./hooks";
+export * from "./utils";

package/build/utils/auto-contrast/index.d.ts

@@ -0,0 +1,2 @@
+export declare function getAutoContrastTextColor(background: string, darkText: string, lightText: string, fallbackColor: string): string;
+//# sourceMappingURL=index.d.ts.map

package/build/utils/auto-contrast/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/auto-contrast/index.ts"],"names":[],"mappings":"AAsDA,wBAAgB,wBAAwB,CACpC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACtB,MAAM,CAaR"}

package/build/utils/auto-contrast/index.js

@@ -0,0 +1,50 @@
+function parseHexColor(color) {
+    const value = color.trim().replace(/^#/, "");
+    if (![3, 4, 6, 8].includes(value.length))
+        return null;
+    if (!/^[0-9a-fA-F]+$/.test(value))
+        return null;
+    const normalized = value.length === 3 || value.length === 4
+        ? value
+            .slice(0, 3)
+            .split("")
+            .map((char) => `${char}${char}`)
+            .join("")
+        : value.slice(0, 6);
+    return {
+        r: Number.parseInt(normalized.slice(0, 2), 16),
+        g: Number.parseInt(normalized.slice(2, 4), 16),
+        b: Number.parseInt(normalized.slice(4, 6), 16)
+    };
+}
+function toRelativeLuminance(channel) {
+    const sRGB = channel / 255;
+    if (sRGB <= 0.03928)
+        return sRGB / 12.92;
+    return ((sRGB + 0.055) / 1.055) ** 2.4;
+}
+function getLuminance(color) {
+    return (0.2126 * toRelativeLuminance(color.r) +
+        0.7152 * toRelativeLuminance(color.g) +
+        0.0722 * toRelativeLuminance(color.b));
+}
+function getContrastRatio(background, foreground) {
+    const backgroundLuminance = getLuminance(background);
+    const foregroundLuminance = getLuminance(foreground);
+    const lighter = Math.max(backgroundLuminance, foregroundLuminance);
+    const darker = Math.min(backgroundLuminance, foregroundLuminance);
+    return (lighter + 0.05) / (darker + 0.05);
+}
+export function getAutoContrastTextColor(background, darkText, lightText, fallbackColor) {
+    const backgroundRGB = parseHexColor(background);
+    if (!backgroundRGB)
+        return fallbackColor;
+    const darkTextRGB = parseHexColor(darkText);
+    const lightTextRGB = parseHexColor(lightText);
+    if (!darkTextRGB || !lightTextRGB)
+        return fallbackColor;
+    return getContrastRatio(backgroundRGB, darkTextRGB) >=
+        getContrastRatio(backgroundRGB, lightTextRGB)
+        ? darkText
+        : lightText;
+}

package/build/utils/clamp/index.d.ts

@@ -0,0 +1,2 @@
+export declare function clamp(value: number, min: number | undefined, max: number | undefined): number;
+//# sourceMappingURL=index.d.ts.map

package/build/utils/clamp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/clamp/index.ts"],"names":[],"mappings":"AAAA,wBAAgB,KAAK,CACjB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,GAAG,SAAS,EACvB,GAAG,EAAE,MAAM,GAAG,SAAS,GACxB,MAAM,CAQR"}

package/build/utils/clamp/index.js

@@ -0,0 +1,9 @@
+export function clamp(value, min, max) {
+    if (min === undefined && max === undefined)
+        return value;
+    if (min !== undefined && max === undefined)
+        return Math.max(min, value);
+    if (min === undefined && max !== undefined)
+        return Math.min(max, value);
+    return Math.min(Math.max(value, min), max);
+}

package/build/utils/context/index.d.ts

@@ -0,0 +1,3 @@
+export { createOptionalContext } from "./optional-context";
+export { createSafeContext } from "./safe-context";
+//# sourceMappingURL=index.d.ts.map

package/build/utils/context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/context/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/build/utils/context/index.js

@@ -0,0 +1,2 @@
+export { createOptionalContext } from "./optional-context";
+export { createSafeContext } from "./safe-context";

package/build/utils/context/optional-context.d.ts

@@ -0,0 +1,5 @@
+export declare function createOptionalContext<ContextValue>(initialValue?: ContextValue | null): readonly [({ value, children }: {
+    value: ContextValue;
+    children: React.ReactNode;
+}) => import("react/jsx-runtime").JSX.Element, () => ContextValue | null];
+//# sourceMappingURL=optional-context.d.ts.map

package/build/utils/context/optional-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optional-context.d.ts","sourceRoot":"","sources":["../../../src/utils/context/optional-context.tsx"],"names":[],"mappings":"AAEA,wBAAgB,qBAAqB,CAAC,YAAY,EAC9C,YAAY,GAAE,YAAY,GAAG,IAAW,mCASrC;IACC,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC7B,yEAKJ"}

package/build/utils/context/optional-context.js

@@ -0,0 +1,10 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from "react";
+export function createOptionalContext(initialValue = null) {
+    const Context = createContext(initialValue);
+    const useOptionalContext = () => useContext(Context);
+    const Provider = ({ value, children }) => {
+        return _jsx(Context.Provider, { value: value, children: children });
+    };
+    return [Provider, useOptionalContext];
+}

package/build/utils/context/safe-context.d.ts

@@ -0,0 +1,5 @@
+export declare function createSafeContext<ContextValue>(err: string): readonly [({ children, value }: {
+    children: React.ReactNode;
+    value: ContextValue;
+}) => import("react/jsx-runtime").JSX.Element, () => ContextValue & ({} | undefined)];
+//# sourceMappingURL=safe-context.d.ts.map

package/build/utils/context/safe-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-context.d.ts","sourceRoot":"","sources":["../../../src/utils/context/safe-context.tsx"],"names":[],"mappings":"AAEA,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,GAAG,EAAE,MAAM,mCAgBpD;IACC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,KAAK,EAAE,YAAY,CAAC;CACvB,qFAGJ"}

package/build/utils/context/safe-context.js

@@ -0,0 +1,14 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from "react";
+export function createSafeContext(err) {
+    const Context = createContext(null);
+    const useSafeContext = () => {
+        const context = useContext(Context);
+        if (context === null) {
+            throw new Error(err);
+        }
+        return context;
+    };
+    const Provider = ({ children, value }) => _jsx(Context.Provider, { value: value, children: children });
+    return [Provider, useSafeContext];
+}