@structyl/hooks 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 your-lib contributors
+
+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,135 @@
+# @structyl/hooks
+
+> A collection of SSR-safe, tree-shakeable React hooks for state, refs, the DOM, browser APIs, and performance.
+
+![npm](https://img.shields.io/npm/v/@structyl/hooks)
+![license](https://img.shields.io/npm/l/@structyl/hooks)
+
+`@structyl/hooks` is the shared hook layer of [structyl](https://structyl.dev), the React UI library with structure. It packages the small, single-responsibility hooks that the primitives and styled components rely on, such as `useControllableState` for controlled/uncontrolled state and `useComposedRefs` for merging refs. Every hook is SSR-safe (no unguarded `window`/`document` access) and tree-shakeable, so it is equally useful on its own in any React 18 or 19 application.
+
+## Installation
+
+```bash
+# pnpm
+pnpm add @structyl/hooks
+
+# npm
+npm install @structyl/hooks
+
+# yarn
+yarn add @structyl/hooks
+```
+
+React 18 or 19 (and `react-dom`) are peer dependencies.
+
+## Usage
+
+```tsx
+import {
+  useControllableState,
+  useDebounce,
+  useLocalStorage,
+} from '@structyl/hooks';
+
+function SearchField({ value, defaultValue = '', onChange }: {
+  value?: string;
+  defaultValue?: string;
+  onChange?: (next: string) => void;
+}) {
+  // Works in both controlled and uncontrolled modes.
+  const [query, setQuery] = useControllableState({
+    prop: value,
+    defaultProp: defaultValue,
+    onChange,
+  });
+
+  // Only react to the value after the user stops typing.
+  const debouncedQuery = useDebounce(query ?? '', 300);
+
+  // Persist the last search across reloads (SSR-safe).
+  const [recent, setRecent] = useLocalStorage<string[]>('recent-searches', []);
+
+  return (
+    <input
+      type="search"
+      value={query ?? ''}
+      onChange={(event) => setQuery(event.target.value)}
+      onBlur={() => debouncedQuery && setRecent([debouncedQuery, ...recent])}
+      placeholder="Search…"
+    />
+  );
+}
+```
+
+## Features
+
+- **Controllable state** — `useControllableState` is the cornerstone hook for building components that work in both controlled and uncontrolled modes.
+- **SSR-safe by default** — browser-bound hooks guard `window`/`document` access and degrade gracefully on the server.
+- **Tree-shakeable** — named exports and `sideEffects: false` mean you only ship the hooks you import.
+- **Ref composition** — `useComposedRefs` / `composeRefs` merge multiple refs onto a single node, the foundation of `asChild` patterns.
+- **TypeScript-first** — fully typed signatures with generics and tuple returns; no `any`.
+- **ESM + CJS** — ships both module formats plus type declarations.
+
+## API
+
+### State
+
+| Hook | Description |
+| --- | --- |
+| `useControllableState` | Manage state that may be controlled by a parent or held internally. |
+| `useToggle` | Boolean state with a toggle and explicit setter `[value, toggle, set]`. |
+| `useBoolean` | Boolean state with `{ value, on, off, toggle, set }` helpers. |
+| `useCounter` | Numeric state with `increment`, `decrement`, `reset`, and `set`. |
+| `usePrevious` | Returns the value from the previous render. |
+
+### Refs
+
+| Hook | Description |
+| --- | --- |
+| `useComposedRefs` / `composeRefs` | Merge multiple refs (callback or object) onto one node. |
+| `useCallbackRef` | Stabilize a callback as a ref to avoid re-renders. |
+| `useLatest` | Keep a ref pointing at the latest value without re-rendering. |
+
+### DOM
+
+| Hook | Description |
+| --- | --- |
+| `useClickOutside` | Run a handler when a click/touch lands outside a ref. |
+| `useEventListener` | Typed `addEventListener` for `window`, `document`, or an element. |
+| `useKeyPress` | Run a handler when a specific key is pressed. |
+
+### Browser
+
+| Hook | Description |
+| --- | --- |
+| `useMediaQuery` | Subscribe to a CSS media query, with an SSR default. |
+| `useLocalStorage` | JSON-backed `localStorage` state `[value, set, remove]`, synced across tabs. |
+| `useCopyToClipboard` | Copy text and track `copied` state via the Clipboard API. |
+| `useDarkMode` | Boolean for the `prefers-color-scheme: dark` query. |
+
+### Performance
+
+| Hook | Description |
+| --- | --- |
+| `useDebounce` | Debounce a value by a delay (default `300ms`). |
+| `useThrottle` | Throttle a value by a delay (default `300ms`). |
+
+### Utility
+
+| Hook | Description |
+| --- | --- |
+| `useId` | SSR-safe stable ID wrapping `React.useId` with an optional prefix. |
+| `useMount` | Run a callback once on mount. |
+| `useUnmount` | Run a callback on unmount. |
+| `useUpdateEffect` | Like `useEffect`, but skips the first run. |
+| `useIsomorphicLayoutEffect` | `useLayoutEffect` on the client, `useEffect` on the server. |
+| `useWindowSize` | Track `{ width, height }` of the window. |
+| `useHotkeys` | Bind keyboard shortcuts (e.g. `mod+k`) with modifier support. |
+
+## Part of structyl
+
+Part of [structyl](https://github.com/imirfanul/structyl) — see the full documentation at [structyl.dev](https://structyl.dev).
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,335 @@
+'use strict';
+
+var react = require('react');
+
+// src/use-controllable-state.ts
+var useIsomorphicLayoutEffect = typeof window !== "undefined" ? react.useLayoutEffect : react.useEffect;
+
+// src/use-callback-ref.ts
+function useCallbackRef(callback) {
+  const callbackRef = react.useRef(callback);
+  useIsomorphicLayoutEffect(() => {
+    callbackRef.current = callback;
+  });
+  return react.useMemo(
+    () => ((...args) => callbackRef.current?.(...args)),
+    []
+  );
+}
+
+// src/use-controllable-state.ts
+function useControllableState({
+  prop,
+  defaultProp,
+  onChange = () => {
+  }
+}) {
+  const [uncontrolledProp, setUncontrolledProp] = useUncontrolledState({
+    defaultProp,
+    onChange
+  });
+  const isControlled = prop !== void 0;
+  const value = isControlled ? prop : uncontrolledProp;
+  const handleChange = useCallbackRef(onChange);
+  const setValue = react.useCallback(
+    (nextValue) => {
+      if (isControlled) {
+        const setter = nextValue;
+        const resolved = typeof nextValue === "function" ? setter(prop) : nextValue;
+        if (resolved !== prop) handleChange(resolved);
+      } else {
+        setUncontrolledProp(nextValue);
+      }
+    },
+    [isControlled, prop, setUncontrolledProp, handleChange]
+  );
+  return [value, setValue];
+}
+function useUncontrolledState({
+  defaultProp,
+  onChange
+}) {
+  const uncontrolledState = react.useState(defaultProp);
+  const [value] = uncontrolledState;
+  const prevValueRef = react.useRef(value);
+  const handleChange = useCallbackRef(onChange);
+  react.useEffect(() => {
+    if (prevValueRef.current !== value) {
+      handleChange(value);
+      prevValueRef.current = value;
+    }
+  }, [value, prevValueRef, handleChange]);
+  return uncontrolledState;
+}
+function useToggle(initial = false) {
+  const [value, setValue] = react.useState(initial);
+  const toggle = react.useCallback(() => setValue((v) => !v), []);
+  return [value, toggle, setValue];
+}
+function useBoolean(initial = false) {
+  const [value, setValue] = react.useState(initial);
+  const on = react.useCallback(() => setValue(true), []);
+  const off = react.useCallback(() => setValue(false), []);
+  const toggle = react.useCallback(() => setValue((v) => !v), []);
+  return { value, on, off, toggle, set: setValue };
+}
+function useCounter(initial = 0) {
+  const [count, setCount] = react.useState(initial);
+  const increment = react.useCallback((by = 1) => setCount((c) => c + by), []);
+  const decrement = react.useCallback((by = 1) => setCount((c) => c - by), []);
+  const reset = react.useCallback(() => setCount(initial), [initial]);
+  return { count, increment, decrement, reset, set: setCount };
+}
+function usePrevious(value) {
+  const ref = react.useRef(void 0);
+  react.useEffect(() => {
+    ref.current = value;
+  }, [value]);
+  return ref.current;
+}
+function setRef(ref, value) {
+  if (typeof ref === "function") ref(value);
+  else if (ref != null && typeof ref === "object")
+    ref.current = value;
+}
+function composeRefs(...refs) {
+  return (node) => refs.forEach((ref) => setRef(ref, node));
+}
+function useComposedRefs(...refs) {
+  return react.useCallback(composeRefs(...refs), refs);
+}
+function useLatest(value) {
+  const ref = react.useRef(value);
+  useIsomorphicLayoutEffect(() => {
+    ref.current = value;
+  });
+  return ref;
+}
+function useClickOutside(ref, handler, enabled = true) {
+  react.useEffect(() => {
+    if (!enabled) return;
+    const listener = (event) => {
+      const el = ref.current;
+      if (!el || el.contains(event.target)) return;
+      handler(event);
+    };
+    document.addEventListener("mousedown", listener);
+    document.addEventListener("touchstart", listener);
+    return () => {
+      document.removeEventListener("mousedown", listener);
+      document.removeEventListener("touchstart", listener);
+    };
+  }, [ref, handler, enabled]);
+}
+function useEventListener(eventName, handler, element) {
+  const savedHandler = react.useRef(handler);
+  react.useEffect(() => {
+    savedHandler.current = handler;
+  }, [handler]);
+  react.useEffect(() => {
+    const target = element ?? (typeof window !== "undefined" ? window : null);
+    if (!target?.addEventListener) return;
+    const listener = (event) => savedHandler.current(event);
+    target.addEventListener(eventName, listener);
+    return () => target.removeEventListener(eventName, listener);
+  }, [eventName, element]);
+}
+
+// src/use-key-press.ts
+function useKeyPress(targetKey, handler) {
+  useEventListener("keydown", (event) => {
+    if (event.key === targetKey) handler(event);
+  });
+}
+function useMediaQuery(query, defaultValue = false) {
+  const [matches, setMatches] = react.useState(defaultValue);
+  react.useEffect(() => {
+    if (typeof window === "undefined") return;
+    const mediaQuery = window.matchMedia(query);
+    setMatches(mediaQuery.matches);
+    const listener = (e) => setMatches(e.matches);
+    mediaQuery.addEventListener("change", listener);
+    return () => mediaQuery.removeEventListener("change", listener);
+  }, [query]);
+  return matches;
+}
+function useLocalStorage(key, initialValue) {
+  const readValue = react.useCallback(() => {
+    if (typeof window === "undefined") return initialValue;
+    try {
+      const item = window.localStorage.getItem(key);
+      return item ? JSON.parse(item) : initialValue;
+    } catch {
+      return initialValue;
+    }
+  }, [key, initialValue]);
+  const [storedValue, setStoredValue] = react.useState(readValue);
+  const setValue = react.useCallback(
+    (value) => {
+      try {
+        const newValue = value instanceof Function ? value(storedValue) : value;
+        setStoredValue(newValue);
+        if (typeof window !== "undefined") {
+          window.localStorage.setItem(key, JSON.stringify(newValue));
+          window.dispatchEvent(new StorageEvent("storage", { key }));
+        }
+      } catch (error) {
+        console.warn(`Error setting localStorage key "${key}":`, error);
+      }
+    },
+    [key, storedValue]
+  );
+  const remove = react.useCallback(() => {
+    try {
+      setStoredValue(initialValue);
+      if (typeof window !== "undefined") {
+        window.localStorage.removeItem(key);
+        window.dispatchEvent(new StorageEvent("storage", { key }));
+      }
+    } catch (error) {
+      console.warn(`Error removing localStorage key "${key}":`, error);
+    }
+  }, [key, initialValue]);
+  react.useEffect(() => {
+    const onStorage = (e) => {
+      if (e.key === key) setStoredValue(readValue());
+    };
+    window.addEventListener("storage", onStorage);
+    return () => window.removeEventListener("storage", onStorage);
+  }, [key, readValue]);
+  return [storedValue, setValue, remove];
+}
+function useCopyToClipboard() {
+  const [copied, setCopied] = react.useState(false);
+  const copy = react.useCallback(async (text) => {
+    if (typeof navigator === "undefined" || !navigator.clipboard) return false;
+    try {
+      await navigator.clipboard.writeText(text);
+      setCopied(true);
+      setTimeout(() => setCopied(false), 2e3);
+      return true;
+    } catch {
+      return false;
+    }
+  }, []);
+  const reset = react.useCallback(() => setCopied(false), []);
+  return { copy, copied, reset };
+}
+
+// src/use-dark-mode.ts
+function useDarkMode() {
+  return useMediaQuery("(prefers-color-scheme: dark)");
+}
+function useDebounce(value, delay = 300) {
+  const [debounced, setDebounced] = react.useState(value);
+  react.useEffect(() => {
+    const id = setTimeout(() => setDebounced(value), delay);
+    return () => clearTimeout(id);
+  }, [value, delay]);
+  return debounced;
+}
+function useThrottle(value, delay = 300) {
+  const [throttled, setThrottled] = react.useState(value);
+  const lastRan = react.useRef(Date.now());
+  react.useEffect(() => {
+    const handler = setTimeout(
+      () => {
+        if (Date.now() - lastRan.current >= delay) {
+          setThrottled(value);
+          lastRan.current = Date.now();
+        }
+      },
+      delay - (Date.now() - lastRan.current)
+    );
+    return () => clearTimeout(handler);
+  }, [value, delay]);
+  return throttled;
+}
+function useId(prefix) {
+  const id = react.useId();
+  return prefix ? `${prefix}-${id}` : id;
+}
+function useMount(callback) {
+  react.useEffect(() => {
+    callback();
+  }, []);
+}
+function useUnmount(callback) {
+  const cbRef = useLatest(callback);
+  react.useEffect(() => () => cbRef.current?.(), [cbRef]);
+}
+function useUpdateEffect(effect, deps) {
+  const isMounted = react.useRef(false);
+  react.useEffect(() => {
+    if (isMounted.current) return effect();
+    isMounted.current = true;
+    return void 0;
+  }, deps);
+}
+function useWindowSize() {
+  const [size, setSize] = react.useState({
+    width: typeof window === "undefined" ? 0 : window.innerWidth,
+    height: typeof window === "undefined" ? 0 : window.innerHeight
+  });
+  react.useEffect(() => {
+    if (typeof window === "undefined") return;
+    const handler = () => setSize({ width: window.innerWidth, height: window.innerHeight });
+    window.addEventListener("resize", handler);
+    return () => window.removeEventListener("resize", handler);
+  }, []);
+  return size;
+}
+function useHotkeys(keys, handler, options = {}) {
+  react.useEffect(() => {
+    const { enableOnFormTags = false, preventDefault = true } = options;
+    const tokens = keys.toLowerCase().split("+").map((s) => s.trim());
+    const targetKey = tokens[tokens.length - 1];
+    const listener = (event) => {
+      const target = event.target;
+      if (!enableOnFormTags && target && ["INPUT", "TEXTAREA", "SELECT"].includes(target.tagName)) {
+        return;
+      }
+      const expectsCtrl = tokens.includes("ctrl");
+      const expectsMeta = tokens.includes("meta");
+      const expectsMod = tokens.includes("mod");
+      const expectsShift = tokens.includes("shift");
+      const expectsAlt = tokens.includes("alt");
+      const isMacLike = typeof navigator !== "undefined" && /Mac|iPod|iPhone|iPad/.test(navigator.platform);
+      const modOk = expectsMod ? isMacLike ? event.metaKey : event.ctrlKey : true;
+      if (event.key.toLowerCase() === targetKey && (expectsCtrl ? event.ctrlKey : !expectsMod || !event.ctrlKey || isMacLike) && (expectsMeta ? event.metaKey : !expectsMod || !event.metaKey || !isMacLike) && modOk && (expectsShift ? event.shiftKey : !event.shiftKey || expectsShift) && (expectsAlt ? event.altKey : !event.altKey || expectsAlt)) {
+        if (preventDefault) event.preventDefault();
+        handler(event);
+      }
+    };
+    document.addEventListener("keydown", listener);
+    return () => document.removeEventListener("keydown", listener);
+  }, [keys, handler, options]);
+}
+
+exports.composeRefs = composeRefs;
+exports.useBoolean = useBoolean;
+exports.useCallbackRef = useCallbackRef;
+exports.useClickOutside = useClickOutside;
+exports.useComposedRefs = useComposedRefs;
+exports.useControllableState = useControllableState;
+exports.useCopyToClipboard = useCopyToClipboard;
+exports.useCounter = useCounter;
+exports.useDarkMode = useDarkMode;
+exports.useDebounce = useDebounce;
+exports.useEventListener = useEventListener;
+exports.useHotkeys = useHotkeys;
+exports.useId = useId;
+exports.useIsomorphicLayoutEffect = useIsomorphicLayoutEffect;
+exports.useKeyPress = useKeyPress;
+exports.useLatest = useLatest;
+exports.useLocalStorage = useLocalStorage;
+exports.useMediaQuery = useMediaQuery;
+exports.useMount = useMount;
+exports.usePrevious = usePrevious;
+exports.useThrottle = useThrottle;
+exports.useToggle = useToggle;
+exports.useUnmount = useUnmount;
+exports.useUpdateEffect = useUpdateEffect;
+exports.useWindowSize = useWindowSize;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/use-isomorphic-layout-effect.ts","../src/use-callback-ref.ts","../src/use-controllable-state.ts","../src/use-toggle.ts","../src/use-boolean.ts","../src/use-counter.ts","../src/use-previous.ts","../src/use-composed-refs.ts","../src/use-latest.ts","../src/use-click-outside.ts","../src/use-event-listener.ts","../src/use-key-press.ts","../src/use-media-query.ts","../src/use-local-storage.ts","../src/use-copy-to-clipboard.ts","../src/use-dark-mode.ts","../src/use-debounce.ts","../src/use-throttle.ts","../src/use-id.ts","../src/use-mount.ts","../src/use-unmount.ts","../src/use-update-effect.ts","../src/use-window-size.ts","../src/use-hotkeys.ts"],"names":["useLayoutEffect","useEffect","useRef","useMemo","useCallback","useState","useReactId"],"mappings":"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","file":"index.cjs","sourcesContent":["import { useEffect, useLayoutEffect } from 'react';\n\n/** Uses useLayoutEffect on the client, useEffect on the server. */\nexport const useIsomorphicLayoutEffect =\n  typeof window !== 'undefined' ? useLayoutEffect : useEffect;\n","import { useMemo, useRef } from 'react';\nimport { useIsomorphicLayoutEffect } from './use-isomorphic-layout-effect';\n\n/**\n * A custom hook that converts a callback to a ref to avoid triggering re-renders\n * when passed as a prop or in dependency arrays.\n */\nexport function useCallbackRef<T extends (...args: never[]) => unknown>(\n  callback: T | undefined,\n): T {\n  const callbackRef = useRef(callback);\n\n  useIsomorphicLayoutEffect(() => {\n    callbackRef.current = callback;\n  });\n\n  return useMemo(\n    () => ((...args) => callbackRef.current?.(...args)) as T,\n    [],\n  );\n}\n","import { useCallback, useEffect, useRef, useState } from 'react';\nimport { useCallbackRef } from './use-callback-ref';\n\ntype UseControllableStateParams<T> = {\n  prop?: T | undefined;\n  defaultProp?: T | undefined;\n  onChange?: (state: T) => void;\n};\n\ntype SetStateFn<T> = (prevState?: T) => T;\n\n/**\n * Manages state that can be either controlled by parent or uncontrolled internally.\n * The cornerstone hook of accessible component design.\n */\nexport function useControllableState<T>({\n  prop,\n  defaultProp,\n  onChange = () => {},\n}: UseControllableStateParams<T>): [T | undefined, (next: T | SetStateFn<T>) => void] {\n  const [uncontrolledProp, setUncontrolledProp] = useUncontrolledState({\n    defaultProp,\n    onChange,\n  });\n  const isControlled = prop !== undefined;\n  const value = isControlled ? prop : uncontrolledProp;\n  const handleChange = useCallbackRef(onChange);\n\n  const setValue = useCallback<(next: T | SetStateFn<T>) => void>(\n    (nextValue) => {\n      if (isControlled) {\n        const setter = nextValue as SetStateFn<T>;\n        const resolved =\n          typeof nextValue === 'function' ? setter(prop) : (nextValue as T);\n        if (resolved !== prop) handleChange(resolved);\n      } else {\n        setUncontrolledProp(nextValue);\n      }\n    },\n    [isControlled, prop, setUncontrolledProp, handleChange],\n  );\n\n  return [value, setValue];\n}\n\nfunction useUncontrolledState<T>({\n  defaultProp,\n  onChange,\n}: Omit<UseControllableStateParams<T>, 'prop'>): [T | undefined, (next: T | SetStateFn<T>) => void] {\n  const uncontrolledState = useState<T | undefined>(defaultProp);\n  const [value] = uncontrolledState;\n  const prevValueRef = useRef(value);\n  const handleChange = useCallbackRef(onChange);\n\n  useEffect(() => {\n    if (prevValueRef.current !== value) {\n      handleChange(value as T);\n      prevValueRef.current = value;\n    }\n  }, [value, prevValueRef, handleChange]);\n\n  return uncontrolledState;\n}\n","import { useCallback, useState } from 'react';\n\nexport function useToggle(initial = false): [boolean, () => void, (value: boolean) => void] {\n  const [value, setValue] = useState(initial);\n  const toggle = useCallback(() => setValue((v) => !v), []);\n  return [value, toggle, setValue];\n}\n","import { useCallback, useState } from 'react';\n\nexport function useBoolean(initial = false) {\n  const [value, setValue] = useState(initial);\n  const on = useCallback(() => setValue(true), []);\n  const off = useCallback(() => setValue(false), []);\n  const toggle = useCallback(() => setValue((v) => !v), []);\n  return { value, on, off, toggle, set: setValue };\n}\n","import { useCallback, useState } from 'react';\n\nexport function useCounter(initial = 0) {\n  const [count, setCount] = useState(initial);\n  const increment = useCallback((by = 1) => setCount((c) => c + by), []);\n  const decrement = useCallback((by = 1) => setCount((c) => c - by), []);\n  const reset = useCallback(() => setCount(initial), [initial]);\n  return { count, increment, decrement, reset, set: setCount };\n}\n","import { useEffect, useRef } from 'react';\n\nexport function usePrevious<T>(value: T): T | undefined {\n  const ref = useRef<T | undefined>(undefined);\n  useEffect(() => {\n    ref.current = value;\n  }, [value]);\n  return ref.current;\n}\n","import { useCallback, type Ref } from 'react';\n\ntype PossibleRef<T> = Ref<T> | undefined | ((value: T | null) => void);\n\nfunction setRef<T>(ref: PossibleRef<T>, value: T | null) {\n  if (typeof ref === 'function') ref(value as T);\n  else if (ref != null && typeof ref === 'object')\n    (ref as { current: T | null }).current = value;\n}\n\nexport function composeRefs<T>(...refs: PossibleRef<T>[]): (node: T | null) => void {\n  return (node) => refs.forEach((ref) => setRef(ref, node));\n}\n\nexport function useComposedRefs<T>(...refs: PossibleRef<T>[]): (node: T | null) => void {\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  return useCallback(composeRefs(...refs), refs);\n}\n","import { useRef } from 'react';\nimport { useIsomorphicLayoutEffect } from './use-isomorphic-layout-effect';\n\nexport function useLatest<T>(value: T): { readonly current: T } {\n  const ref = useRef(value);\n  useIsomorphicLayoutEffect(() => {\n    ref.current = value;\n  });\n  return ref;\n}\n","import { useEffect, type RefObject } from 'react';\n\nexport function useClickOutside<T extends HTMLElement>(\n  ref: RefObject<T | null>,\n  handler: (event: MouseEvent | TouchEvent) => void,\n  enabled = true,\n): void {\n  useEffect(() => {\n    if (!enabled) return;\n    const listener = (event: MouseEvent | TouchEvent) => {\n      const el = ref.current;\n      if (!el || el.contains(event.target as Node)) return;\n      handler(event);\n    };\n    document.addEventListener('mousedown', listener);\n    document.addEventListener('touchstart', listener);\n    return () => {\n      document.removeEventListener('mousedown', listener);\n      document.removeEventListener('touchstart', listener);\n    };\n  }, [ref, handler, enabled]);\n}\n","import { useEffect, useRef } from 'react';\n\nexport function useEventListener<K extends keyof WindowEventMap>(\n  eventName: K,\n  handler: (event: WindowEventMap[K]) => void,\n  element?: Window,\n): void;\nexport function useEventListener<K extends keyof DocumentEventMap>(\n  eventName: K,\n  handler: (event: DocumentEventMap[K]) => void,\n  element: Document,\n): void;\nexport function useEventListener<K extends keyof HTMLElementEventMap>(\n  eventName: K,\n  handler: (event: HTMLElementEventMap[K]) => void,\n  element: HTMLElement | null,\n): void;\nexport function useEventListener(\n  eventName: string,\n  handler: (event: Event) => void,\n  element?: Window | Document | HTMLElement | null,\n): void {\n  const savedHandler = useRef(handler);\n\n  useEffect(() => {\n    savedHandler.current = handler;\n  }, [handler]);\n\n  useEffect(() => {\n    const target = element ?? (typeof window !== 'undefined' ? window : null);\n    if (!target?.addEventListener) return;\n\n    const listener: EventListener = (event) => savedHandler.current(event);\n    target.addEventListener(eventName, listener);\n    return () => target.removeEventListener(eventName, listener);\n  }, [eventName, element]);\n}\n","import { useEventListener } from './use-event-listener';\n\nexport function useKeyPress(targetKey: string, handler: (event: KeyboardEvent) => void): void {\n  useEventListener('keydown', (event) => {\n    if (event.key === targetKey) handler(event);\n  });\n}\n","import { useEffect, useState } from 'react';\n\nexport function useMediaQuery(query: string, defaultValue = false): boolean {\n  const [matches, setMatches] = useState(defaultValue);\n\n  useEffect(() => {\n    if (typeof window === 'undefined') return;\n    const mediaQuery = window.matchMedia(query);\n    setMatches(mediaQuery.matches);\n    const listener = (e: MediaQueryListEvent) => setMatches(e.matches);\n    mediaQuery.addEventListener('change', listener);\n    return () => mediaQuery.removeEventListener('change', listener);\n  }, [query]);\n\n  return matches;\n}\n","import { useCallback, useEffect, useState } from 'react';\n\nexport function useLocalStorage<T>(\n  key: string,\n  initialValue: T,\n): [T, (value: T | ((val: T) => T)) => void, () => void] {\n  const readValue = useCallback((): T => {\n    if (typeof window === 'undefined') return initialValue;\n    try {\n      const item = window.localStorage.getItem(key);\n      return item ? (JSON.parse(item) as T) : initialValue;\n    } catch {\n      return initialValue;\n    }\n  }, [key, initialValue]);\n\n  const [storedValue, setStoredValue] = useState<T>(readValue);\n\n  const setValue = useCallback(\n    (value: T | ((val: T) => T)) => {\n      try {\n        const newValue =\n          value instanceof Function ? (value as (val: T) => T)(storedValue) : value;\n        setStoredValue(newValue);\n        if (typeof window !== 'undefined') {\n          window.localStorage.setItem(key, JSON.stringify(newValue));\n          window.dispatchEvent(new StorageEvent('storage', { key }));\n        }\n      } catch (error) {\n        console.warn(`Error setting localStorage key \"${key}\":`, error);\n      }\n    },\n    [key, storedValue],\n  );\n\n  const remove = useCallback(() => {\n    try {\n      setStoredValue(initialValue);\n      if (typeof window !== 'undefined') {\n        window.localStorage.removeItem(key);\n        window.dispatchEvent(new StorageEvent('storage', { key }));\n      }\n    } catch (error) {\n      console.warn(`Error removing localStorage key \"${key}\":`, error);\n    }\n  }, [key, initialValue]);\n\n  useEffect(() => {\n    const onStorage = (e: StorageEvent) => {\n      if (e.key === key) setStoredValue(readValue());\n    };\n    window.addEventListener('storage', onStorage);\n    return () => window.removeEventListener('storage', onStorage);\n  }, [key, readValue]);\n\n  return [storedValue, setValue, remove];\n}\n","import { useCallback, useState } from 'react';\n\nexport function useCopyToClipboard(): {\n  copy: (text: string) => Promise<boolean>;\n  copied: boolean;\n  reset: () => void;\n} {\n  const [copied, setCopied] = useState(false);\n\n  const copy = useCallback(async (text: string): Promise<boolean> => {\n    if (typeof navigator === 'undefined' || !navigator.clipboard) return false;\n    try {\n      await navigator.clipboard.writeText(text);\n      setCopied(true);\n      setTimeout(() => setCopied(false), 2000);\n      return true;\n    } catch {\n      return false;\n    }\n  }, []);\n\n  const reset = useCallback(() => setCopied(false), []);\n\n  return { copy, copied, reset };\n}\n","import { useMediaQuery } from './use-media-query';\n\nexport function useDarkMode(): boolean {\n  return useMediaQuery('(prefers-color-scheme: dark)');\n}\n","import { useEffect, useState } from 'react';\n\nexport function useDebounce<T>(value: T, delay = 300): T {\n  const [debounced, setDebounced] = useState(value);\n  useEffect(() => {\n    const id = setTimeout(() => setDebounced(value), delay);\n    return () => clearTimeout(id);\n  }, [value, delay]);\n  return debounced;\n}\n","import { useEffect, useRef, useState } from 'react';\n\nexport function useThrottle<T>(value: T, delay = 300): T {\n  const [throttled, setThrottled] = useState(value);\n  const lastRan = useRef(Date.now());\n\n  useEffect(() => {\n    const handler = setTimeout(\n      () => {\n        if (Date.now() - lastRan.current >= delay) {\n          setThrottled(value);\n          lastRan.current = Date.now();\n        }\n      },\n      delay - (Date.now() - lastRan.current),\n    );\n    return () => clearTimeout(handler);\n  }, [value, delay]);\n\n  return throttled;\n}\n","import { useId as useReactId } from 'react';\n\n/** SSR-safe stable ID. Wraps React.useId with optional prefix. */\nexport function useId(prefix?: string): string {\n  const id = useReactId();\n  return prefix ? `${prefix}-${id}` : id;\n}\n","import { useEffect } from 'react';\n\nexport function useMount(callback: () => void): void {\n  useEffect(() => {\n    callback();\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n}\n","import { useEffect } from 'react';\nimport { useLatest } from './use-latest';\n\nexport function useUnmount(callback: () => void): void {\n  const cbRef = useLatest(callback);\n  useEffect(() => () => cbRef.current?.(), [cbRef]);\n}\n","import { useEffect, useRef, type DependencyList, type EffectCallback } from 'react';\n\n/** Like useEffect, but skips the first run (on mount). */\nexport function useUpdateEffect(effect: EffectCallback, deps?: DependencyList): void {\n  const isMounted = useRef(false);\n  useEffect(() => {\n    if (isMounted.current) return effect();\n    isMounted.current = true;\n    return undefined;\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, deps);\n}\n","import { useEffect, useState } from 'react';\n\nexport function useWindowSize(): { width: number; height: number } {\n  const [size, setSize] = useState({\n    width: typeof window === 'undefined' ? 0 : window.innerWidth,\n    height: typeof window === 'undefined' ? 0 : window.innerHeight,\n  });\n\n  useEffect(() => {\n    if (typeof window === 'undefined') return;\n    const handler = () => setSize({ width: window.innerWidth, height: window.innerHeight });\n    window.addEventListener('resize', handler);\n    return () => window.removeEventListener('resize', handler);\n  }, []);\n\n  return size;\n}\n","import { useEffect } from 'react';\n\ntype Modifier = 'ctrl' | 'meta' | 'shift' | 'alt' | 'mod';\n\nexport function useHotkeys(\n  keys: string,\n  handler: (event: KeyboardEvent) => void,\n  options: { enableOnFormTags?: boolean; preventDefault?: boolean } = {},\n): void {\n  useEffect(() => {\n    const { enableOnFormTags = false, preventDefault = true } = options;\n    const tokens = keys.toLowerCase().split('+').map((s) => s.trim()) as (Modifier | string)[];\n    const targetKey = tokens[tokens.length - 1];\n\n    const listener = (event: KeyboardEvent) => {\n      const target = event.target as HTMLElement | null;\n      if (\n        !enableOnFormTags &&\n        target &&\n        ['INPUT', 'TEXTAREA', 'SELECT'].includes(target.tagName)\n      ) {\n        return;\n      }\n\n      const expectsCtrl = tokens.includes('ctrl');\n      const expectsMeta = tokens.includes('meta');\n      const expectsMod = tokens.includes('mod');\n      const expectsShift = tokens.includes('shift');\n      const expectsAlt = tokens.includes('alt');\n\n      const isMacLike =\n        typeof navigator !== 'undefined' && /Mac|iPod|iPhone|iPad/.test(navigator.platform);\n      const modOk = expectsMod ? (isMacLike ? event.metaKey : event.ctrlKey) : true;\n\n      if (\n        event.key.toLowerCase() === targetKey &&\n        (expectsCtrl ? event.ctrlKey : !expectsMod || !event.ctrlKey || isMacLike) &&\n        (expectsMeta ? event.metaKey : !expectsMod || !event.metaKey || !isMacLike) &&\n        modOk &&\n        (expectsShift ? event.shiftKey : !event.shiftKey || expectsShift) &&\n        (expectsAlt ? event.altKey : !event.altKey || expectsAlt)\n      ) {\n        if (preventDefault) event.preventDefault();\n        handler(event);\n      }\n    };\n\n    document.addEventListener('keydown', listener);\n    return () => document.removeEventListener('keydown', listener);\n  }, [keys, handler, options]);\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,97 @@
+import * as react from 'react';
+import { Ref, RefObject, EffectCallback, DependencyList, useLayoutEffect } from 'react';
+
+type UseControllableStateParams<T> = {
+    prop?: T | undefined;
+    defaultProp?: T | undefined;
+    onChange?: (state: T) => void;
+};
+type SetStateFn<T> = (prevState?: T) => T;
+/**
+ * Manages state that can be either controlled by parent or uncontrolled internally.
+ * The cornerstone hook of accessible component design.
+ */
+declare function useControllableState<T>({ prop, defaultProp, onChange, }: UseControllableStateParams<T>): [T | undefined, (next: T | SetStateFn<T>) => void];
+
+declare function useToggle(initial?: boolean): [boolean, () => void, (value: boolean) => void];
+
+declare function useBoolean(initial?: boolean): {
+    value: boolean;
+    on: () => void;
+    off: () => void;
+    toggle: () => void;
+    set: react.Dispatch<react.SetStateAction<boolean>>;
+};
+
+declare function useCounter(initial?: number): {
+    count: number;
+    increment: (by?: number) => void;
+    decrement: (by?: number) => void;
+    reset: () => void;
+    set: react.Dispatch<react.SetStateAction<number>>;
+};
+
+declare function usePrevious<T>(value: T): T | undefined;
+
+type PossibleRef<T> = Ref<T> | undefined | ((value: T | null) => void);
+declare function composeRefs<T>(...refs: PossibleRef<T>[]): (node: T | null) => void;
+declare function useComposedRefs<T>(...refs: PossibleRef<T>[]): (node: T | null) => void;
+
+/**
+ * A custom hook that converts a callback to a ref to avoid triggering re-renders
+ * when passed as a prop or in dependency arrays.
+ */
+declare function useCallbackRef<T extends (...args: never[]) => unknown>(callback: T | undefined): T;
+
+declare function useLatest<T>(value: T): {
+    readonly current: T;
+};
+
+declare function useClickOutside<T extends HTMLElement>(ref: RefObject<T | null>, handler: (event: MouseEvent | TouchEvent) => void, enabled?: boolean): void;
+
+declare function useEventListener<K extends keyof WindowEventMap>(eventName: K, handler: (event: WindowEventMap[K]) => void, element?: Window): void;
+declare function useEventListener<K extends keyof DocumentEventMap>(eventName: K, handler: (event: DocumentEventMap[K]) => void, element: Document): void;
+declare function useEventListener<K extends keyof HTMLElementEventMap>(eventName: K, handler: (event: HTMLElementEventMap[K]) => void, element: HTMLElement | null): void;
+
+declare function useKeyPress(targetKey: string, handler: (event: KeyboardEvent) => void): void;
+
+declare function useMediaQuery(query: string, defaultValue?: boolean): boolean;
+
+declare function useLocalStorage<T>(key: string, initialValue: T): [T, (value: T | ((val: T) => T)) => void, () => void];
+
+declare function useCopyToClipboard(): {
+    copy: (text: string) => Promise<boolean>;
+    copied: boolean;
+    reset: () => void;
+};
+
+declare function useDarkMode(): boolean;
+
+declare function useDebounce<T>(value: T, delay?: number): T;
+
+declare function useThrottle<T>(value: T, delay?: number): T;
+
+/** SSR-safe stable ID. Wraps React.useId with optional prefix. */
+declare function useId(prefix?: string): string;
+
+declare function useMount(callback: () => void): void;
+
+declare function useUnmount(callback: () => void): void;
+
+/** Like useEffect, but skips the first run (on mount). */
+declare function useUpdateEffect(effect: EffectCallback, deps?: DependencyList): void;
+
+/** Uses useLayoutEffect on the client, useEffect on the server. */
+declare const useIsomorphicLayoutEffect: typeof useLayoutEffect;
+
+declare function useWindowSize(): {
+    width: number;
+    height: number;
+};
+
+declare function useHotkeys(keys: string, handler: (event: KeyboardEvent) => void, options?: {
+    enableOnFormTags?: boolean;
+    preventDefault?: boolean;
+}): void;
+
+export { composeRefs, useBoolean, useCallbackRef, useClickOutside, useComposedRefs, useControllableState, useCopyToClipboard, useCounter, useDarkMode, useDebounce, useEventListener, useHotkeys, useId, useIsomorphicLayoutEffect, useKeyPress, useLatest, useLocalStorage, useMediaQuery, useMount, usePrevious, useThrottle, useToggle, useUnmount, useUpdateEffect, useWindowSize };

package/dist/index.d.ts

@@ -0,0 +1,97 @@
+import * as react from 'react';
+import { Ref, RefObject, EffectCallback, DependencyList, useLayoutEffect } from 'react';
+
+type UseControllableStateParams<T> = {
+    prop?: T | undefined;
+    defaultProp?: T | undefined;
+    onChange?: (state: T) => void;
+};
+type SetStateFn<T> = (prevState?: T) => T;
+/**
+ * Manages state that can be either controlled by parent or uncontrolled internally.
+ * The cornerstone hook of accessible component design.
+ */
+declare function useControllableState<T>({ prop, defaultProp, onChange, }: UseControllableStateParams<T>): [T | undefined, (next: T | SetStateFn<T>) => void];
+
+declare function useToggle(initial?: boolean): [boolean, () => void, (value: boolean) => void];
+
+declare function useBoolean(initial?: boolean): {
+    value: boolean;
+    on: () => void;
+    off: () => void;
+    toggle: () => void;
+    set: react.Dispatch<react.SetStateAction<boolean>>;
+};
+
+declare function useCounter(initial?: number): {
+    count: number;
+    increment: (by?: number) => void;
+    decrement: (by?: number) => void;
+    reset: () => void;
+    set: react.Dispatch<react.SetStateAction<number>>;
+};
+
+declare function usePrevious<T>(value: T): T | undefined;
+
+type PossibleRef<T> = Ref<T> | undefined | ((value: T | null) => void);
+declare function composeRefs<T>(...refs: PossibleRef<T>[]): (node: T | null) => void;
+declare function useComposedRefs<T>(...refs: PossibleRef<T>[]): (node: T | null) => void;
+
+/**
+ * A custom hook that converts a callback to a ref to avoid triggering re-renders
+ * when passed as a prop or in dependency arrays.
+ */
+declare function useCallbackRef<T extends (...args: never[]) => unknown>(callback: T | undefined): T;
+
+declare function useLatest<T>(value: T): {
+    readonly current: T;
+};
+
+declare function useClickOutside<T extends HTMLElement>(ref: RefObject<T | null>, handler: (event: MouseEvent | TouchEvent) => void, enabled?: boolean): void;
+
+declare function useEventListener<K extends keyof WindowEventMap>(eventName: K, handler: (event: WindowEventMap[K]) => void, element?: Window): void;
+declare function useEventListener<K extends keyof DocumentEventMap>(eventName: K, handler: (event: DocumentEventMap[K]) => void, element: Document): void;
+declare function useEventListener<K extends keyof HTMLElementEventMap>(eventName: K, handler: (event: HTMLElementEventMap[K]) => void, element: HTMLElement | null): void;
+
+declare function useKeyPress(targetKey: string, handler: (event: KeyboardEvent) => void): void;
+
+declare function useMediaQuery(query: string, defaultValue?: boolean): boolean;
+
+declare function useLocalStorage<T>(key: string, initialValue: T): [T, (value: T | ((val: T) => T)) => void, () => void];
+
+declare function useCopyToClipboard(): {
+    copy: (text: string) => Promise<boolean>;
+    copied: boolean;
+    reset: () => void;
+};
+
+declare function useDarkMode(): boolean;
+
+declare function useDebounce<T>(value: T, delay?: number): T;
+
+declare function useThrottle<T>(value: T, delay?: number): T;
+
+/** SSR-safe stable ID. Wraps React.useId with optional prefix. */
+declare function useId(prefix?: string): string;
+
+declare function useMount(callback: () => void): void;
+
+declare function useUnmount(callback: () => void): void;
+
+/** Like useEffect, but skips the first run (on mount). */
+declare function useUpdateEffect(effect: EffectCallback, deps?: DependencyList): void;
+
+/** Uses useLayoutEffect on the client, useEffect on the server. */
+declare const useIsomorphicLayoutEffect: typeof useLayoutEffect;
+
+declare function useWindowSize(): {
+    width: number;
+    height: number;
+};
+
+declare function useHotkeys(keys: string, handler: (event: KeyboardEvent) => void, options?: {
+    enableOnFormTags?: boolean;
+    preventDefault?: boolean;
+}): void;
+
+export { composeRefs, useBoolean, useCallbackRef, useClickOutside, useComposedRefs, useControllableState, useCopyToClipboard, useCounter, useDarkMode, useDebounce, useEventListener, useHotkeys, useId, useIsomorphicLayoutEffect, useKeyPress, useLatest, useLocalStorage, useMediaQuery, useMount, usePrevious, useThrottle, useToggle, useUnmount, useUpdateEffect, useWindowSize };

package/dist/index.mjs

@@ -0,0 +1,309 @@
+import { useLayoutEffect, useEffect, useRef, useMemo, useCallback, useState, useId as useId$1 } from 'react';
+
+// src/use-controllable-state.ts
+var useIsomorphicLayoutEffect = typeof window !== "undefined" ? useLayoutEffect : useEffect;
+
+// src/use-callback-ref.ts
+function useCallbackRef(callback) {
+  const callbackRef = useRef(callback);
+  useIsomorphicLayoutEffect(() => {
+    callbackRef.current = callback;
+  });
+  return useMemo(
+    () => ((...args) => callbackRef.current?.(...args)),
+    []
+  );
+}
+
+// src/use-controllable-state.ts
+function useControllableState({
+  prop,
+  defaultProp,
+  onChange = () => {
+  }
+}) {
+  const [uncontrolledProp, setUncontrolledProp] = useUncontrolledState({
+    defaultProp,
+    onChange
+  });
+  const isControlled = prop !== void 0;
+  const value = isControlled ? prop : uncontrolledProp;
+  const handleChange = useCallbackRef(onChange);
+  const setValue = useCallback(
+    (nextValue) => {
+      if (isControlled) {
+        const setter = nextValue;
+        const resolved = typeof nextValue === "function" ? setter(prop) : nextValue;
+        if (resolved !== prop) handleChange(resolved);
+      } else {
+        setUncontrolledProp(nextValue);
+      }
+    },
+    [isControlled, prop, setUncontrolledProp, handleChange]
+  );
+  return [value, setValue];
+}
+function useUncontrolledState({
+  defaultProp,
+  onChange
+}) {
+  const uncontrolledState = useState(defaultProp);
+  const [value] = uncontrolledState;
+  const prevValueRef = useRef(value);
+  const handleChange = useCallbackRef(onChange);
+  useEffect(() => {
+    if (prevValueRef.current !== value) {
+      handleChange(value);
+      prevValueRef.current = value;
+    }
+  }, [value, prevValueRef, handleChange]);
+  return uncontrolledState;
+}
+function useToggle(initial = false) {
+  const [value, setValue] = useState(initial);
+  const toggle = useCallback(() => setValue((v) => !v), []);
+  return [value, toggle, setValue];
+}
+function useBoolean(initial = false) {
+  const [value, setValue] = useState(initial);
+  const on = useCallback(() => setValue(true), []);
+  const off = useCallback(() => setValue(false), []);
+  const toggle = useCallback(() => setValue((v) => !v), []);
+  return { value, on, off, toggle, set: setValue };
+}
+function useCounter(initial = 0) {
+  const [count, setCount] = useState(initial);
+  const increment = useCallback((by = 1) => setCount((c) => c + by), []);
+  const decrement = useCallback((by = 1) => setCount((c) => c - by), []);
+  const reset = useCallback(() => setCount(initial), [initial]);
+  return { count, increment, decrement, reset, set: setCount };
+}
+function usePrevious(value) {
+  const ref = useRef(void 0);
+  useEffect(() => {
+    ref.current = value;
+  }, [value]);
+  return ref.current;
+}
+function setRef(ref, value) {
+  if (typeof ref === "function") ref(value);
+  else if (ref != null && typeof ref === "object")
+    ref.current = value;
+}
+function composeRefs(...refs) {
+  return (node) => refs.forEach((ref) => setRef(ref, node));
+}
+function useComposedRefs(...refs) {
+  return useCallback(composeRefs(...refs), refs);
+}
+function useLatest(value) {
+  const ref = useRef(value);
+  useIsomorphicLayoutEffect(() => {
+    ref.current = value;
+  });
+  return ref;
+}
+function useClickOutside(ref, handler, enabled = true) {
+  useEffect(() => {
+    if (!enabled) return;
+    const listener = (event) => {
+      const el = ref.current;
+      if (!el || el.contains(event.target)) return;
+      handler(event);
+    };
+    document.addEventListener("mousedown", listener);
+    document.addEventListener("touchstart", listener);
+    return () => {
+      document.removeEventListener("mousedown", listener);
+      document.removeEventListener("touchstart", listener);
+    };
+  }, [ref, handler, enabled]);
+}
+function useEventListener(eventName, handler, element) {
+  const savedHandler = useRef(handler);
+  useEffect(() => {
+    savedHandler.current = handler;
+  }, [handler]);
+  useEffect(() => {
+    const target = element ?? (typeof window !== "undefined" ? window : null);
+    if (!target?.addEventListener) return;
+    const listener = (event) => savedHandler.current(event);
+    target.addEventListener(eventName, listener);
+    return () => target.removeEventListener(eventName, listener);
+  }, [eventName, element]);
+}
+
+// src/use-key-press.ts
+function useKeyPress(targetKey, handler) {
+  useEventListener("keydown", (event) => {
+    if (event.key === targetKey) handler(event);
+  });
+}
+function useMediaQuery(query, defaultValue = false) {
+  const [matches, setMatches] = useState(defaultValue);
+  useEffect(() => {
+    if (typeof window === "undefined") return;
+    const mediaQuery = window.matchMedia(query);
+    setMatches(mediaQuery.matches);
+    const listener = (e) => setMatches(e.matches);
+    mediaQuery.addEventListener("change", listener);
+    return () => mediaQuery.removeEventListener("change", listener);
+  }, [query]);
+  return matches;
+}
+function useLocalStorage(key, initialValue) {
+  const readValue = useCallback(() => {
+    if (typeof window === "undefined") return initialValue;
+    try {
+      const item = window.localStorage.getItem(key);
+      return item ? JSON.parse(item) : initialValue;
+    } catch {
+      return initialValue;
+    }
+  }, [key, initialValue]);
+  const [storedValue, setStoredValue] = useState(readValue);
+  const setValue = useCallback(
+    (value) => {
+      try {
+        const newValue = value instanceof Function ? value(storedValue) : value;
+        setStoredValue(newValue);
+        if (typeof window !== "undefined") {
+          window.localStorage.setItem(key, JSON.stringify(newValue));
+          window.dispatchEvent(new StorageEvent("storage", { key }));
+        }
+      } catch (error) {
+        console.warn(`Error setting localStorage key "${key}":`, error);
+      }
+    },
+    [key, storedValue]
+  );
+  const remove = useCallback(() => {
+    try {
+      setStoredValue(initialValue);
+      if (typeof window !== "undefined") {
+        window.localStorage.removeItem(key);
+        window.dispatchEvent(new StorageEvent("storage", { key }));
+      }
+    } catch (error) {
+      console.warn(`Error removing localStorage key "${key}":`, error);
+    }
+  }, [key, initialValue]);
+  useEffect(() => {
+    const onStorage = (e) => {
+      if (e.key === key) setStoredValue(readValue());
+    };
+    window.addEventListener("storage", onStorage);
+    return () => window.removeEventListener("storage", onStorage);
+  }, [key, readValue]);
+  return [storedValue, setValue, remove];
+}
+function useCopyToClipboard() {
+  const [copied, setCopied] = useState(false);
+  const copy = useCallback(async (text) => {
+    if (typeof navigator === "undefined" || !navigator.clipboard) return false;
+    try {
+      await navigator.clipboard.writeText(text);
+      setCopied(true);
+      setTimeout(() => setCopied(false), 2e3);
+      return true;
+    } catch {
+      return false;
+    }
+  }, []);
+  const reset = useCallback(() => setCopied(false), []);
+  return { copy, copied, reset };
+}
+
+// src/use-dark-mode.ts
+function useDarkMode() {
+  return useMediaQuery("(prefers-color-scheme: dark)");
+}
+function useDebounce(value, delay = 300) {
+  const [debounced, setDebounced] = useState(value);
+  useEffect(() => {
+    const id = setTimeout(() => setDebounced(value), delay);
+    return () => clearTimeout(id);
+  }, [value, delay]);
+  return debounced;
+}
+function useThrottle(value, delay = 300) {
+  const [throttled, setThrottled] = useState(value);
+  const lastRan = useRef(Date.now());
+  useEffect(() => {
+    const handler = setTimeout(
+      () => {
+        if (Date.now() - lastRan.current >= delay) {
+          setThrottled(value);
+          lastRan.current = Date.now();
+        }
+      },
+      delay - (Date.now() - lastRan.current)
+    );
+    return () => clearTimeout(handler);
+  }, [value, delay]);
+  return throttled;
+}
+function useId(prefix) {
+  const id = useId$1();
+  return prefix ? `${prefix}-${id}` : id;
+}
+function useMount(callback) {
+  useEffect(() => {
+    callback();
+  }, []);
+}
+function useUnmount(callback) {
+  const cbRef = useLatest(callback);
+  useEffect(() => () => cbRef.current?.(), [cbRef]);
+}
+function useUpdateEffect(effect, deps) {
+  const isMounted = useRef(false);
+  useEffect(() => {
+    if (isMounted.current) return effect();
+    isMounted.current = true;
+    return void 0;
+  }, deps);
+}
+function useWindowSize() {
+  const [size, setSize] = useState({
+    width: typeof window === "undefined" ? 0 : window.innerWidth,
+    height: typeof window === "undefined" ? 0 : window.innerHeight
+  });
+  useEffect(() => {
+    if (typeof window === "undefined") return;
+    const handler = () => setSize({ width: window.innerWidth, height: window.innerHeight });
+    window.addEventListener("resize", handler);
+    return () => window.removeEventListener("resize", handler);
+  }, []);
+  return size;
+}
+function useHotkeys(keys, handler, options = {}) {
+  useEffect(() => {
+    const { enableOnFormTags = false, preventDefault = true } = options;
+    const tokens = keys.toLowerCase().split("+").map((s) => s.trim());
+    const targetKey = tokens[tokens.length - 1];
+    const listener = (event) => {
+      const target = event.target;
+      if (!enableOnFormTags && target && ["INPUT", "TEXTAREA", "SELECT"].includes(target.tagName)) {
+        return;
+      }
+      const expectsCtrl = tokens.includes("ctrl");
+      const expectsMeta = tokens.includes("meta");
+      const expectsMod = tokens.includes("mod");
+      const expectsShift = tokens.includes("shift");
+      const expectsAlt = tokens.includes("alt");
+      const isMacLike = typeof navigator !== "undefined" && /Mac|iPod|iPhone|iPad/.test(navigator.platform);
+      const modOk = expectsMod ? isMacLike ? event.metaKey : event.ctrlKey : true;
+      if (event.key.toLowerCase() === targetKey && (expectsCtrl ? event.ctrlKey : !expectsMod || !event.ctrlKey || isMacLike) && (expectsMeta ? event.metaKey : !expectsMod || !event.metaKey || !isMacLike) && modOk && (expectsShift ? event.shiftKey : !event.shiftKey || expectsShift) && (expectsAlt ? event.altKey : !event.altKey || expectsAlt)) {
+        if (preventDefault) event.preventDefault();
+        handler(event);
+      }
+    };
+    document.addEventListener("keydown", listener);
+    return () => document.removeEventListener("keydown", listener);
+  }, [keys, handler, options]);
+}
+
+export { composeRefs, useBoolean, useCallbackRef, useClickOutside, useComposedRefs, useControllableState, useCopyToClipboard, useCounter, useDarkMode, useDebounce, useEventListener, useHotkeys, useId, useIsomorphicLayoutEffect, useKeyPress, useLatest, useLocalStorage, useMediaQuery, useMount, usePrevious, useThrottle, useToggle, useUnmount, useUpdateEffect, useWindowSize };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/use-isomorphic-layout-effect.ts","../src/use-callback-ref.ts","../src/use-controllable-state.ts","../src/use-toggle.ts","../src/use-boolean.ts","../src/use-counter.ts","../src/use-previous.ts","../src/use-composed-refs.ts","../src/use-latest.ts","../src/use-click-outside.ts","../src/use-event-listener.ts","../src/use-key-press.ts","../src/use-media-query.ts","../src/use-local-storage.ts","../src/use-copy-to-clipboard.ts","../src/use-dark-mode.ts","../src/use-debounce.ts","../src/use-throttle.ts","../src/use-id.ts","../src/use-mount.ts","../src/use-unmount.ts","../src/use-update-effect.ts","../src/use-window-size.ts","../src/use-hotkeys.ts"],"names":["useRef","useEffect","useState","useCallback","useReactId"],"mappings":"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","file":"index.mjs","sourcesContent":["import { useEffect, useLayoutEffect } from 'react';\n\n/** Uses useLayoutEffect on the client, useEffect on the server. */\nexport const useIsomorphicLayoutEffect =\n  typeof window !== 'undefined' ? useLayoutEffect : useEffect;\n","import { useMemo, useRef } from 'react';\nimport { useIsomorphicLayoutEffect } from './use-isomorphic-layout-effect';\n\n/**\n * A custom hook that converts a callback to a ref to avoid triggering re-renders\n * when passed as a prop or in dependency arrays.\n */\nexport function useCallbackRef<T extends (...args: never[]) => unknown>(\n  callback: T | undefined,\n): T {\n  const callbackRef = useRef(callback);\n\n  useIsomorphicLayoutEffect(() => {\n    callbackRef.current = callback;\n  });\n\n  return useMemo(\n    () => ((...args) => callbackRef.current?.(...args)) as T,\n    [],\n  );\n}\n","import { useCallback, useEffect, useRef, useState } from 'react';\nimport { useCallbackRef } from './use-callback-ref';\n\ntype UseControllableStateParams<T> = {\n  prop?: T | undefined;\n  defaultProp?: T | undefined;\n  onChange?: (state: T) => void;\n};\n\ntype SetStateFn<T> = (prevState?: T) => T;\n\n/**\n * Manages state that can be either controlled by parent or uncontrolled internally.\n * The cornerstone hook of accessible component design.\n */\nexport function useControllableState<T>({\n  prop,\n  defaultProp,\n  onChange = () => {},\n}: UseControllableStateParams<T>): [T | undefined, (next: T | SetStateFn<T>) => void] {\n  const [uncontrolledProp, setUncontrolledProp] = useUncontrolledState({\n    defaultProp,\n    onChange,\n  });\n  const isControlled = prop !== undefined;\n  const value = isControlled ? prop : uncontrolledProp;\n  const handleChange = useCallbackRef(onChange);\n\n  const setValue = useCallback<(next: T | SetStateFn<T>) => void>(\n    (nextValue) => {\n      if (isControlled) {\n        const setter = nextValue as SetStateFn<T>;\n        const resolved =\n          typeof nextValue === 'function' ? setter(prop) : (nextValue as T);\n        if (resolved !== prop) handleChange(resolved);\n      } else {\n        setUncontrolledProp(nextValue);\n      }\n    },\n    [isControlled, prop, setUncontrolledProp, handleChange],\n  );\n\n  return [value, setValue];\n}\n\nfunction useUncontrolledState<T>({\n  defaultProp,\n  onChange,\n}: Omit<UseControllableStateParams<T>, 'prop'>): [T | undefined, (next: T | SetStateFn<T>) => void] {\n  const uncontrolledState = useState<T | undefined>(defaultProp);\n  const [value] = uncontrolledState;\n  const prevValueRef = useRef(value);\n  const handleChange = useCallbackRef(onChange);\n\n  useEffect(() => {\n    if (prevValueRef.current !== value) {\n      handleChange(value as T);\n      prevValueRef.current = value;\n    }\n  }, [value, prevValueRef, handleChange]);\n\n  return uncontrolledState;\n}\n","import { useCallback, useState } from 'react';\n\nexport function useToggle(initial = false): [boolean, () => void, (value: boolean) => void] {\n  const [value, setValue] = useState(initial);\n  const toggle = useCallback(() => setValue((v) => !v), []);\n  return [value, toggle, setValue];\n}\n","import { useCallback, useState } from 'react';\n\nexport function useBoolean(initial = false) {\n  const [value, setValue] = useState(initial);\n  const on = useCallback(() => setValue(true), []);\n  const off = useCallback(() => setValue(false), []);\n  const toggle = useCallback(() => setValue((v) => !v), []);\n  return { value, on, off, toggle, set: setValue };\n}\n","import { useCallback, useState } from 'react';\n\nexport function useCounter(initial = 0) {\n  const [count, setCount] = useState(initial);\n  const increment = useCallback((by = 1) => setCount((c) => c + by), []);\n  const decrement = useCallback((by = 1) => setCount((c) => c - by), []);\n  const reset = useCallback(() => setCount(initial), [initial]);\n  return { count, increment, decrement, reset, set: setCount };\n}\n","import { useEffect, useRef } from 'react';\n\nexport function usePrevious<T>(value: T): T | undefined {\n  const ref = useRef<T | undefined>(undefined);\n  useEffect(() => {\n    ref.current = value;\n  }, [value]);\n  return ref.current;\n}\n","import { useCallback, type Ref } from 'react';\n\ntype PossibleRef<T> = Ref<T> | undefined | ((value: T | null) => void);\n\nfunction setRef<T>(ref: PossibleRef<T>, value: T | null) {\n  if (typeof ref === 'function') ref(value as T);\n  else if (ref != null && typeof ref === 'object')\n    (ref as { current: T | null }).current = value;\n}\n\nexport function composeRefs<T>(...refs: PossibleRef<T>[]): (node: T | null) => void {\n  return (node) => refs.forEach((ref) => setRef(ref, node));\n}\n\nexport function useComposedRefs<T>(...refs: PossibleRef<T>[]): (node: T | null) => void {\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  return useCallback(composeRefs(...refs), refs);\n}\n","import { useRef } from 'react';\nimport { useIsomorphicLayoutEffect } from './use-isomorphic-layout-effect';\n\nexport function useLatest<T>(value: T): { readonly current: T } {\n  const ref = useRef(value);\n  useIsomorphicLayoutEffect(() => {\n    ref.current = value;\n  });\n  return ref;\n}\n","import { useEffect, type RefObject } from 'react';\n\nexport function useClickOutside<T extends HTMLElement>(\n  ref: RefObject<T | null>,\n  handler: (event: MouseEvent | TouchEvent) => void,\n  enabled = true,\n): void {\n  useEffect(() => {\n    if (!enabled) return;\n    const listener = (event: MouseEvent | TouchEvent) => {\n      const el = ref.current;\n      if (!el || el.contains(event.target as Node)) return;\n      handler(event);\n    };\n    document.addEventListener('mousedown', listener);\n    document.addEventListener('touchstart', listener);\n    return () => {\n      document.removeEventListener('mousedown', listener);\n      document.removeEventListener('touchstart', listener);\n    };\n  }, [ref, handler, enabled]);\n}\n","import { useEffect, useRef } from 'react';\n\nexport function useEventListener<K extends keyof WindowEventMap>(\n  eventName: K,\n  handler: (event: WindowEventMap[K]) => void,\n  element?: Window,\n): void;\nexport function useEventListener<K extends keyof DocumentEventMap>(\n  eventName: K,\n  handler: (event: DocumentEventMap[K]) => void,\n  element: Document,\n): void;\nexport function useEventListener<K extends keyof HTMLElementEventMap>(\n  eventName: K,\n  handler: (event: HTMLElementEventMap[K]) => void,\n  element: HTMLElement | null,\n): void;\nexport function useEventListener(\n  eventName: string,\n  handler: (event: Event) => void,\n  element?: Window | Document | HTMLElement | null,\n): void {\n  const savedHandler = useRef(handler);\n\n  useEffect(() => {\n    savedHandler.current = handler;\n  }, [handler]);\n\n  useEffect(() => {\n    const target = element ?? (typeof window !== 'undefined' ? window : null);\n    if (!target?.addEventListener) return;\n\n    const listener: EventListener = (event) => savedHandler.current(event);\n    target.addEventListener(eventName, listener);\n    return () => target.removeEventListener(eventName, listener);\n  }, [eventName, element]);\n}\n","import { useEventListener } from './use-event-listener';\n\nexport function useKeyPress(targetKey: string, handler: (event: KeyboardEvent) => void): void {\n  useEventListener('keydown', (event) => {\n    if (event.key === targetKey) handler(event);\n  });\n}\n","import { useEffect, useState } from 'react';\n\nexport function useMediaQuery(query: string, defaultValue = false): boolean {\n  const [matches, setMatches] = useState(defaultValue);\n\n  useEffect(() => {\n    if (typeof window === 'undefined') return;\n    const mediaQuery = window.matchMedia(query);\n    setMatches(mediaQuery.matches);\n    const listener = (e: MediaQueryListEvent) => setMatches(e.matches);\n    mediaQuery.addEventListener('change', listener);\n    return () => mediaQuery.removeEventListener('change', listener);\n  }, [query]);\n\n  return matches;\n}\n","import { useCallback, useEffect, useState } from 'react';\n\nexport function useLocalStorage<T>(\n  key: string,\n  initialValue: T,\n): [T, (value: T | ((val: T) => T)) => void, () => void] {\n  const readValue = useCallback((): T => {\n    if (typeof window === 'undefined') return initialValue;\n    try {\n      const item = window.localStorage.getItem(key);\n      return item ? (JSON.parse(item) as T) : initialValue;\n    } catch {\n      return initialValue;\n    }\n  }, [key, initialValue]);\n\n  const [storedValue, setStoredValue] = useState<T>(readValue);\n\n  const setValue = useCallback(\n    (value: T | ((val: T) => T)) => {\n      try {\n        const newValue =\n          value instanceof Function ? (value as (val: T) => T)(storedValue) : value;\n        setStoredValue(newValue);\n        if (typeof window !== 'undefined') {\n          window.localStorage.setItem(key, JSON.stringify(newValue));\n          window.dispatchEvent(new StorageEvent('storage', { key }));\n        }\n      } catch (error) {\n        console.warn(`Error setting localStorage key \"${key}\":`, error);\n      }\n    },\n    [key, storedValue],\n  );\n\n  const remove = useCallback(() => {\n    try {\n      setStoredValue(initialValue);\n      if (typeof window !== 'undefined') {\n        window.localStorage.removeItem(key);\n        window.dispatchEvent(new StorageEvent('storage', { key }));\n      }\n    } catch (error) {\n      console.warn(`Error removing localStorage key \"${key}\":`, error);\n    }\n  }, [key, initialValue]);\n\n  useEffect(() => {\n    const onStorage = (e: StorageEvent) => {\n      if (e.key === key) setStoredValue(readValue());\n    };\n    window.addEventListener('storage', onStorage);\n    return () => window.removeEventListener('storage', onStorage);\n  }, [key, readValue]);\n\n  return [storedValue, setValue, remove];\n}\n","import { useCallback, useState } from 'react';\n\nexport function useCopyToClipboard(): {\n  copy: (text: string) => Promise<boolean>;\n  copied: boolean;\n  reset: () => void;\n} {\n  const [copied, setCopied] = useState(false);\n\n  const copy = useCallback(async (text: string): Promise<boolean> => {\n    if (typeof navigator === 'undefined' || !navigator.clipboard) return false;\n    try {\n      await navigator.clipboard.writeText(text);\n      setCopied(true);\n      setTimeout(() => setCopied(false), 2000);\n      return true;\n    } catch {\n      return false;\n    }\n  }, []);\n\n  const reset = useCallback(() => setCopied(false), []);\n\n  return { copy, copied, reset };\n}\n","import { useMediaQuery } from './use-media-query';\n\nexport function useDarkMode(): boolean {\n  return useMediaQuery('(prefers-color-scheme: dark)');\n}\n","import { useEffect, useState } from 'react';\n\nexport function useDebounce<T>(value: T, delay = 300): T {\n  const [debounced, setDebounced] = useState(value);\n  useEffect(() => {\n    const id = setTimeout(() => setDebounced(value), delay);\n    return () => clearTimeout(id);\n  }, [value, delay]);\n  return debounced;\n}\n","import { useEffect, useRef, useState } from 'react';\n\nexport function useThrottle<T>(value: T, delay = 300): T {\n  const [throttled, setThrottled] = useState(value);\n  const lastRan = useRef(Date.now());\n\n  useEffect(() => {\n    const handler = setTimeout(\n      () => {\n        if (Date.now() - lastRan.current >= delay) {\n          setThrottled(value);\n          lastRan.current = Date.now();\n        }\n      },\n      delay - (Date.now() - lastRan.current),\n    );\n    return () => clearTimeout(handler);\n  }, [value, delay]);\n\n  return throttled;\n}\n","import { useId as useReactId } from 'react';\n\n/** SSR-safe stable ID. Wraps React.useId with optional prefix. */\nexport function useId(prefix?: string): string {\n  const id = useReactId();\n  return prefix ? `${prefix}-${id}` : id;\n}\n","import { useEffect } from 'react';\n\nexport function useMount(callback: () => void): void {\n  useEffect(() => {\n    callback();\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n}\n","import { useEffect } from 'react';\nimport { useLatest } from './use-latest';\n\nexport function useUnmount(callback: () => void): void {\n  const cbRef = useLatest(callback);\n  useEffect(() => () => cbRef.current?.(), [cbRef]);\n}\n","import { useEffect, useRef, type DependencyList, type EffectCallback } from 'react';\n\n/** Like useEffect, but skips the first run (on mount). */\nexport function useUpdateEffect(effect: EffectCallback, deps?: DependencyList): void {\n  const isMounted = useRef(false);\n  useEffect(() => {\n    if (isMounted.current) return effect();\n    isMounted.current = true;\n    return undefined;\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, deps);\n}\n","import { useEffect, useState } from 'react';\n\nexport function useWindowSize(): { width: number; height: number } {\n  const [size, setSize] = useState({\n    width: typeof window === 'undefined' ? 0 : window.innerWidth,\n    height: typeof window === 'undefined' ? 0 : window.innerHeight,\n  });\n\n  useEffect(() => {\n    if (typeof window === 'undefined') return;\n    const handler = () => setSize({ width: window.innerWidth, height: window.innerHeight });\n    window.addEventListener('resize', handler);\n    return () => window.removeEventListener('resize', handler);\n  }, []);\n\n  return size;\n}\n","import { useEffect } from 'react';\n\ntype Modifier = 'ctrl' | 'meta' | 'shift' | 'alt' | 'mod';\n\nexport function useHotkeys(\n  keys: string,\n  handler: (event: KeyboardEvent) => void,\n  options: { enableOnFormTags?: boolean; preventDefault?: boolean } = {},\n): void {\n  useEffect(() => {\n    const { enableOnFormTags = false, preventDefault = true } = options;\n    const tokens = keys.toLowerCase().split('+').map((s) => s.trim()) as (Modifier | string)[];\n    const targetKey = tokens[tokens.length - 1];\n\n    const listener = (event: KeyboardEvent) => {\n      const target = event.target as HTMLElement | null;\n      if (\n        !enableOnFormTags &&\n        target &&\n        ['INPUT', 'TEXTAREA', 'SELECT'].includes(target.tagName)\n      ) {\n        return;\n      }\n\n      const expectsCtrl = tokens.includes('ctrl');\n      const expectsMeta = tokens.includes('meta');\n      const expectsMod = tokens.includes('mod');\n      const expectsShift = tokens.includes('shift');\n      const expectsAlt = tokens.includes('alt');\n\n      const isMacLike =\n        typeof navigator !== 'undefined' && /Mac|iPod|iPhone|iPad/.test(navigator.platform);\n      const modOk = expectsMod ? (isMacLike ? event.metaKey : event.ctrlKey) : true;\n\n      if (\n        event.key.toLowerCase() === targetKey &&\n        (expectsCtrl ? event.ctrlKey : !expectsMod || !event.ctrlKey || isMacLike) &&\n        (expectsMeta ? event.metaKey : !expectsMod || !event.metaKey || !isMacLike) &&\n        modOk &&\n        (expectsShift ? event.shiftKey : !event.shiftKey || expectsShift) &&\n        (expectsAlt ? event.altKey : !event.altKey || expectsAlt)\n      ) {\n        if (preventDefault) event.preventDefault();\n        handler(event);\n      }\n    };\n\n    document.addEventListener('keydown', listener);\n    return () => document.removeEventListener('keydown', listener);\n  }, [keys, handler, options]);\n}\n"]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@structyl/hooks",
+  "version": "1.0.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "SSR-safe, tree-shakeable React hooks for state, refs, DOM, browser APIs, and performance, including useControllableState for headless UI",
+  "keywords": [
+    "react",
+    "typescript",
+    "structyl",
+    "hooks",
+    "react-hooks",
+    "ssr",
+    "use-controllable-state",
+    "use-debounce",
+    "use-media-query",
+    "use-local-storage",
+    "tree-shakeable"
+  ],
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.2"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo"
+  }
+}