@mwakidenis/logx-react 0.0.0-stage → 0.1.0

package/dist/components/index.mjs

@@ -0,0 +1,262 @@
+import { useState, useCallback, useRef, useEffect, Component } from 'react';
+import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
+
+// src/components/CopyButton/index.tsx
+function useLatest(value) {
+  const ref = useRef(value);
+  ref.current = value;
+  return ref;
+}
+function useDebouncedValue(value, options = {}) {
+  const { delay = 300, leading = false } = options;
+  const [debounced, setDebounced] = useState(value);
+  const latest = useLatest(value);
+  const timerRef = useRef(null);
+  const lastLeadingRef = useRef(void 0);
+  useEffect(() => {
+    if (timerRef.current !== null) {
+      clearTimeout(timerRef.current);
+      timerRef.current = null;
+    }
+    timerRef.current = setTimeout(() => {
+      setDebounced(latest.current);
+      timerRef.current = null;
+    }, delay);
+    return () => {
+      if (timerRef.current !== null) {
+        clearTimeout(timerRef.current);
+        timerRef.current = null;
+      }
+    };
+  }, [value, delay]);
+  useEffect(() => {
+    if (!leading) return;
+    const current = latest.current;
+    if (lastLeadingRef.current !== current) {
+      lastLeadingRef.current = current;
+      setDebounced(current);
+    }
+  }, [value, leading]);
+  return debounced;
+}
+function useMediaQuery(query) {
+  const [matches, setMatches] = useState(false);
+  useEffect(() => {
+    if (typeof window === "undefined") return;
+    const media = window.matchMedia(query);
+    setMatches(media.matches);
+    const handler = (event) => setMatches(event.matches);
+    media.addEventListener("change", handler);
+    return () => {
+      media.removeEventListener("change", handler);
+    };
+  }, [query]);
+  return matches;
+}
+function useClipboard() {
+  const isSupported = typeof navigator !== "undefined" && !!navigator.clipboard && !!navigator.clipboard.writeText;
+  const copy = useCallback(async (text) => {
+    try {
+      if (isSupported && typeof navigator !== "undefined") {
+        await navigator.clipboard.writeText(text);
+        return true;
+      }
+      if (typeof document !== "undefined") {
+        const textarea = document.createElement("textarea");
+        textarea.value = text;
+        textarea.setAttribute("readonly", "");
+        textarea.style.position = "absolute";
+        textarea.style.position = "fixed";
+        textarea.style.opacity = "0";
+        document.body.appendChild(textarea);
+        textarea.select();
+        try {
+          document.execCommand("copy");
+        } finally {
+          document.body.removeChild(textarea);
+        }
+        return true;
+      }
+      return false;
+    } catch {
+      return false;
+    }
+  }, [isSupported]);
+  return { copy, isSupported };
+}
+function CopyButton({
+  text,
+  label = "Copy",
+  copyingLabel = "Copying...",
+  successLabel = "Copied!",
+  errorLabel = "Error",
+  className,
+  onCopy,
+  onError,
+  timeout = 2e3
+}) {
+  const [status, setStatus] = useState("idle");
+  const { copy } = useClipboard();
+  const handleCopy = useCallback(async () => {
+    setStatus("copying");
+    try {
+      const ok = await copy(text);
+      if (ok) {
+        setStatus("success");
+        onCopy?.(text);
+      } else {
+        setStatus("error");
+        onError?.(new Error("Failed to copy to clipboard"));
+      }
+    } catch (err) {
+      setStatus("error");
+      onError?.(err);
+    }
+    setTimeout(() => setStatus("idle"), timeout);
+  }, [text, copy, onCopy, onError, timeout]);
+  const displayLabel = status === "copying" ? copyingLabel : status === "success" ? successLabel : status === "error" ? errorLabel : label;
+  return /* @__PURE__ */ jsx(
+    "button",
+    {
+      type: "button",
+      className,
+      disabled: status === "copying",
+      onClick: handleCopy,
+      "aria-label": status === "success" ? "Copied to clipboard" : label,
+      "aria-pressed": status === "success",
+      children: displayLabel
+    }
+  );
+}
+function DebouncedInput({
+  value,
+  defaultValue,
+  onChange,
+  onDebouncedChange,
+  delay = 300,
+  ...rest
+}) {
+  const [internalValue, setInternalValue] = useState(defaultValue ?? "");
+  const isControlled = value !== void 0;
+  const currentValue = isControlled ? value ?? "" : internalValue;
+  const handleChange = useCallback(
+    (event) => {
+      const next = event.target.value;
+      if (!isControlled) setInternalValue(next);
+      onChange?.(next);
+    },
+    [isControlled, onChange]
+  );
+  const debounced = useDebouncedValue(currentValue, { delay });
+  const initialized = useRef(false);
+  useEffect(() => {
+    if (!initialized.current) {
+      initialized.current = true;
+      return;
+    }
+    onDebouncedChange?.(debounced);
+  }, [debounced, onDebouncedChange]);
+  return /* @__PURE__ */ jsx("input", { ...rest, value: currentValue, onChange: handleChange });
+}
+function PasswordInput({
+  value,
+  defaultValue,
+  onChange,
+  label = "Password",
+  placeholder,
+  disabled = false,
+  required = false,
+  name,
+  id,
+  showToggle = true,
+  className
+}) {
+  const [show, setShow] = useState(false);
+  const [internalValue, setInternalValue] = useState(defaultValue ?? "");
+  const isControlled = value !== void 0;
+  const currentValue = isControlled ? value ?? "" : internalValue;
+  const handleChange = useCallback(
+    (event) => {
+      const next = event.target.value;
+      if (!isControlled) setInternalValue(next);
+      onChange?.(next);
+    },
+    [isControlled, onChange]
+  );
+  const toggle = useCallback(() => setShow((current) => !current), []);
+  return /* @__PURE__ */ jsxs("div", { className, children: [
+    label && /* @__PURE__ */ jsx("label", { htmlFor: id, children: label }),
+    /* @__PURE__ */ jsx(
+      "input",
+      {
+        id,
+        name,
+        type: show ? "text" : "password",
+        value: currentValue,
+        onChange: handleChange,
+        placeholder,
+        disabled,
+        required,
+        "aria-label": label
+      }
+    ),
+    showToggle && /* @__PURE__ */ jsx(
+      "button",
+      {
+        type: "button",
+        onClick: toggle,
+        "aria-label": show ? "Hide password" : "Show password",
+        "aria-pressed": show,
+        children: show ? "Hide password" : "Show password"
+      }
+    )
+  ] });
+}
+function Responsive({ children, query, fallback }) {
+  const matches = useMediaQuery(query);
+  const renderChildren = useCallback(
+    (m) => m ? children(m) : fallback ?? null,
+    [children, fallback]
+  );
+  return /* @__PURE__ */ jsx(Fragment, { children: renderChildren(matches) });
+}
+var ErrorBoundary = class extends Component {
+  constructor() {
+    super(...arguments);
+    this.state = { hasError: false, error: null, info: null };
+  }
+  static getDerivedStateFromError(error) {
+    return { hasError: true, error, info: null };
+  }
+  componentDidCatch(error, info) {
+    this.setState({ info });
+    this.props.onError?.(error, info);
+  }
+  componentDidUpdate(prevProps) {
+    if (this.props.resetKeys !== prevProps.resetKeys) {
+      const prev = JSON.stringify(prevProps.resetKeys);
+      const next = JSON.stringify(this.props.resetKeys);
+      if (prev !== next) {
+        this.setState({ hasError: false, error: null, info: null });
+      }
+    }
+  }
+  render() {
+    if (this.state.hasError) {
+      const { fallback } = this.props;
+      if (fallback === void 0) return null;
+      if (typeof fallback === "function") {
+        return fallback(
+          this.state.error,
+          this.state.info
+        );
+      }
+      return fallback;
+    }
+    return this.props.children;
+  }
+};
+
+export { CopyButton, DebouncedInput, ErrorBoundary, PasswordInput, Responsive };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/components/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useLatest.ts","../../src/hooks/useDebouncedValue.ts","../../src/hooks/useMediaQuery.ts","../../src/hooks/useClipboard.ts","../../src/components/CopyButton/index.tsx","../../src/components/DebouncedInput/index.tsx","../../src/components/PasswordInput/index.tsx","../../src/components/Responsive/index.tsx","../../src/components/ErrorBoundary/index.tsx"],"names":["useRef","useState","useEffect","useCallback","jsx"],"mappings":"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","file":"index.mjs","sourcesContent":["import { useRef } from \"react\";\r\n\r\n/**\r\n * Returns a ref whose `.current` always holds the latest value without\r\n * triggering re-renders. Useful for accessing the most recent value inside\r\n * timers, callbacks or event listeners without stale closures.\r\n *\r\n * @param value - The value to track\r\n */\r\nexport function useLatest<T>(value: T): { current: T } {\r\n  const ref = useRef(value);\r\n  ref.current = value;\r\n  return ref;\r\n}\r\n","import { useEffect, useRef, useState } from \"react\";\r\nimport { useLatest } from \"./useLatest\";\r\nimport type { DebouncedValueOptions } from \"../types\";\r\n\r\n/**\r\n * Debounce a value.\r\n *\r\n * Returns the value after it has stopped changing for `delay` milliseconds.\r\n * Uses reference equality to detect changes; for objects/arrays pass a new\r\n * reference only when you want a debounce to restart.\r\n *\r\n * LOGX provides function debouncing (@mwakidenis/logx/function). This hook\r\n * implements value debouncing (a React-specific behaviour) on top of timers;\r\n * it does not map to an existing LOGX function.\r\n *\r\n * @param value - The value to debounce\r\n * @param options - delay (ms, default 300) and leading (default false)\r\n */\r\nexport function useDebouncedValue<T>(\r\n  value: T,\r\n  options: DebouncedValueOptions = {},\r\n): T {\r\n  const { delay = 300, leading = false } = options;\r\n  const [debounced, setDebounced] = useState(value);\r\n  const latest = useLatest(value);\r\n  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\r\n  const lastLeadingRef = useRef<T | undefined>(undefined);\r\n\r\n  useEffect(() => {\r\n    if (timerRef.current !== null) {\r\n      clearTimeout(timerRef.current);\r\n      timerRef.current = null;\r\n    }\r\n    timerRef.current = setTimeout(() => {\r\n      setDebounced(latest.current);\r\n      timerRef.current = null;\r\n    }, delay);\r\n    return () => {\r\n      if (timerRef.current !== null) {\r\n        clearTimeout(timerRef.current);\r\n        timerRef.current = null;\r\n      }\r\n    };\r\n  }, [value, delay]);\r\n\r\n  useEffect(() => {\r\n    if (!leading) return;\r\n    const current = latest.current;\r\n    if (lastLeadingRef.current !== current) {\r\n      lastLeadingRef.current = current;\r\n      setDebounced(current);\r\n    }\r\n  }, [value, leading]);\r\n\r\n  return debounced;\r\n}\r\n","import { useEffect, useState } from \"react\";\r\n\r\n/**\r\n * Track whether a media query matches.\r\n *\r\n * SSR-safe: returns `false` on the server and before mount, then reflects the\r\n * real match status after mount. Listens for `change` events and cleans up on\r\n * unmount.\r\n *\r\n * @param query - A CSS media query string\r\n */\r\nexport function useMediaQuery(query: string): boolean {\r\n  const [matches, setMatches] = useState(false);\r\n\r\n  useEffect(() => {\r\n    if (typeof window === \"undefined\") return;\r\n    const media = window.matchMedia(query);\r\n    setMatches(media.matches);\r\n    const handler = (event: MediaQueryListEvent) => setMatches(event.matches);\r\n    media.addEventListener(\"change\", handler);\r\n    return () => {\r\n      media.removeEventListener(\"change\", handler);\r\n    };\r\n  }, [query]);\r\n\r\n  return matches;\r\n}\r\n","import { useCallback } from \"react\";\r\n\r\n/**\r\n * Copy text to the clipboard.\r\n *\r\n * Uses the Clipboard API when available, with a textarea fallback for older\r\n * browsers. Never throws; returns false on failure.\r\n */\r\nexport function useClipboard(): {\r\n  copy: (text: string) => Promise<boolean>;\r\n  isSupported: boolean;\r\n} {\r\n  const isSupported =\r\n    typeof navigator !== \"undefined\" && !!navigator.clipboard && !!navigator.clipboard.writeText;\r\n\r\n  const copy = useCallback(async (text: string): Promise<boolean> => {\r\n    try {\r\n      if (isSupported && typeof navigator !== \"undefined\") {\r\n        await navigator.clipboard.writeText(text);\r\n        return true;\r\n      }\r\n      // Fallback for environments without the Clipboard API.\r\n      if (typeof document !== \"undefined\") {\r\n        const textarea = document.createElement(\"textarea\");\r\n        textarea.value = text;\r\n        textarea.setAttribute(\"readonly\", \"\");\r\n        textarea.style.position = \"absolute\";\r\n        textarea.style.position = \"fixed\";\r\n        textarea.style.opacity = \"0\";\r\n        document.body.appendChild(textarea);\r\n        textarea.select();\r\n        try {\r\n          document.execCommand(\"copy\");\r\n        } finally {\r\n          document.body.removeChild(textarea);\r\n        }\r\n        return true;\r\n      }\r\n      return false;\r\n    } catch {\r\n      return false;\r\n    }\r\n  }, [isSupported]);\r\n\r\n  return { copy, isSupported };\r\n}\r\n","import { useCallback, useState } from \"react\";\r\nimport { useClipboard } from \"../../hooks\";\r\nimport type { CopyButtonProps } from \"../../types\";\r\n\r\n/**\r\n * Accessible copy-to-clipboard button.\r\n *\r\n * - Copies the supplied `text` to the clipboard.\r\n * - Shows idle / copying / success / error states.\r\n * - Supports custom labels per state and a custom className.\r\n * - Keyboard accessible (native button). No icon library dependency.\r\n *\r\n * @param props - Component props\r\n */\r\nexport function CopyButton({\r\n  text,\r\n  label = \"Copy\",\r\n  copyingLabel = \"Copying...\",\r\n  successLabel = \"Copied!\",\r\n  errorLabel = \"Error\",\r\n  className,\r\n  onCopy,\r\n  onError,\r\n  timeout = 2000,\r\n}: CopyButtonProps): JSX.Element {\r\n  const [status, setStatus] = useState<\"idle\" | \"copying\" | \"success\" | \"error\">(\"idle\");\r\n  const { copy } = useClipboard();\r\n\r\n  const handleCopy = useCallback(async () => {\r\n    setStatus(\"copying\");\r\n    try {\r\n      const ok = await copy(text);\r\n      if (ok) {\r\n        setStatus(\"success\");\r\n        onCopy?.(text);\r\n      } else {\r\n        setStatus(\"error\");\r\n        onError?.(new Error(\"Failed to copy to clipboard\"));\r\n      }\r\n    } catch (err) {\r\n      setStatus(\"error\");\r\n      onError?.(err as Error);\r\n    }\r\n    setTimeout(() => setStatus(\"idle\"), timeout);\r\n  }, [text, copy, onCopy, onError, timeout]);\r\n\r\n  const displayLabel =\r\n    status === \"copying\"\r\n      ? copyingLabel\r\n      : status === \"success\"\r\n        ? successLabel\r\n        : status === \"error\"\r\n          ? errorLabel\r\n          : label;\r\n\r\n  return (\r\n    <button\r\n      type=\"button\"\r\n      className={className}\r\n      disabled={status === \"copying\"}\r\n      onClick={handleCopy}\r\n      aria-label={status === \"success\" ? \"Copied to clipboard\" : label}\r\n      aria-pressed={status === \"success\"}\r\n    >\r\n      {displayLabel}\r\n    </button>\r\n  );\r\n}\r\n","import { useCallback, useEffect, useRef, useState } from \"react\";\r\nimport type { ChangeEvent } from \"react\";\r\nimport { useDebouncedValue } from \"../../hooks\";\r\nimport type { DebouncedInputProps } from \"../../types\";\r\n\r\n/**\r\n * Controlled input with a separate debounced value.\r\n *\r\n * - `value`/`defaultValue` for controlled/uncontrolled usage.\r\n * - `delay` controls debounce duration.\r\n * - `onChange` fires immediately; `onDebouncedChange` fires after debounce.\r\n * - Accepts standard input attributes for form integration.\r\n *\r\n * @param props - Component props\r\n */\r\nexport function DebouncedInput({\r\n  value,\r\n  defaultValue,\r\n  onChange,\r\n  onDebouncedChange,\r\n  delay = 300,\r\n  ...rest\r\n}: DebouncedInputProps): JSX.Element {\r\n  const [internalValue, setInternalValue] = useState(defaultValue ?? \"\");\r\n  const isControlled = value !== undefined;\r\n  const currentValue = isControlled ? (value ?? \"\") : internalValue;\r\n\r\n  const handleChange = useCallback(\r\n    (event: ChangeEvent<HTMLInputElement>) => {\r\n      const next = event.target.value;\r\n      if (!isControlled) setInternalValue(next);\r\n      onChange?.(next);\r\n    },\r\n    [isControlled, onChange],\r\n  );\r\n\r\n  const debounced = useDebouncedValue(currentValue, { delay });\r\n  const initialized = useRef(false);\r\n\r\n  useEffect(() => {\r\n    if (!initialized.current) {\r\n      initialized.current = true;\r\n      return;\r\n    }\r\n    onDebouncedChange?.(debounced);\r\n  }, [debounced, onDebouncedChange]);\r\n\r\n  return <input {...rest} value={currentValue} onChange={handleChange} />;\r\n}\r\n","import { useCallback, useState } from \"react\";\r\nimport type { ChangeEvent } from \"react\";\r\nimport type { PasswordInputProps } from \"../../types\";\r\n\r\n/**\r\n * Accessible show/hide password input.\r\n *\r\n * - Controlled/uncontrolled value.\r\n * - Accessible toggle button labels.\r\n * - Keyboard accessible; no external UI framework dependency.\r\n *\r\n * @param props - Component props\r\n */\r\nexport function PasswordInput({\r\n  value,\r\n  defaultValue,\r\n  onChange,\r\n  label = \"Password\",\r\n  placeholder,\r\n  disabled = false,\r\n  required = false,\r\n  name,\r\n  id,\r\n  showToggle = true,\r\n  className,\r\n}: PasswordInputProps): JSX.Element {\r\n  const [show, setShow] = useState(false);\r\n  const [internalValue, setInternalValue] = useState(defaultValue ?? \"\");\r\n  const isControlled = value !== undefined;\r\n  const currentValue = isControlled ? (value ?? \"\") : internalValue;\r\n\r\n  const handleChange = useCallback(\r\n    (event: ChangeEvent<HTMLInputElement>) => {\r\n      const next = event.target.value;\r\n      if (!isControlled) setInternalValue(next);\r\n      onChange?.(next);\r\n    },\r\n    [isControlled, onChange],\r\n  );\r\n\r\n  const toggle = useCallback(() => setShow((current) => !current), []);\r\n\r\n  return (\r\n    <div className={className}>\r\n      {label && <label htmlFor={id}>{label}</label>}\r\n      <input\r\n        id={id}\r\n        name={name}\r\n        type={show ? \"text\" : \"password\"}\r\n        value={currentValue}\r\n        onChange={handleChange}\r\n        placeholder={placeholder}\r\n        disabled={disabled}\r\n        required={required}\r\n        aria-label={label}\r\n      />\r\n      {showToggle && (\r\n        <button\r\n          type=\"button\"\r\n          onClick={toggle}\r\n          aria-label={show ? \"Hide password\" : \"Show password\"}\r\n          aria-pressed={show}\r\n        >\r\n          {show ? \"Hide password\" : \"Show password\"}\r\n        </button>\r\n      )}\r\n    </div>\r\n  );\r\n}\r\n","import { useCallback } from \"react\";\r\nimport { useMediaQuery } from \"../../hooks\";\r\nimport type { ResponsiveProps } from \"../../types\";\r\n\r\n/**\r\n * Conditionally render content based on a media query.\r\n *\r\n * SSR-safe: on the server and before mount, renders `fallback` (or null),\r\n * avoiding hydration mismatches. After mount, renders `children(matches)` when\r\n * the query matches, otherwise `fallback`.\r\n *\r\n * @param props - Component props\r\n */\r\nexport function Responsive({ children, query, fallback }: ResponsiveProps): JSX.Element {\r\n  const matches = useMediaQuery(query);\r\n  const renderChildren = useCallback(\r\n    (m: boolean) => (m ? children(m) : fallback ?? null),\r\n    [children, fallback],\r\n  );\r\n  return <>{renderChildren(matches)}</>;\r\n}\r\n","import { Component, ReactNode } from \"react\";\r\nimport type { ErrorBoundaryProps, ErrorBoundaryState } from \"../../types\";\r\n\r\n/**\r\n * React error boundary.\r\n *\r\n * Captures descendant rendering errors, supports a fallback UI (element or\r\n * render function receiving the error and React error info), an optional\r\n * onError callback, and optional reset via `resetKeys` changes.\r\n *\r\n * Limitations: does not catch errors in event handlers, asynchronous code\r\n * (setTimeout, promises), or server-side rendering. Those must be handled\r\n * separately (try/catch, error-first callbacks, etc.).\r\n *\r\n * @param props - Component props\r\n */\r\nexport class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {\r\n  state: ErrorBoundaryState = { hasError: false, error: null, info: null };\r\n\r\n  static getDerivedStateFromError(error: Error): ErrorBoundaryState {\r\n    return { hasError: true, error, info: null };\r\n  }\r\n\r\n  componentDidCatch(error: Error, info: React.ErrorInfo): void {\r\n    this.setState({ info });\r\n    this.props.onError?.(error, info);\r\n  }\r\n\r\n  componentDidUpdate(prevProps: ErrorBoundaryProps): void {\r\n    if (this.props.resetKeys !== prevProps.resetKeys) {\r\n      const prev = JSON.stringify(prevProps.resetKeys);\r\n      const next = JSON.stringify(this.props.resetKeys);\r\n      if (prev !== next) {\r\n        this.setState({ hasError: false, error: null, info: null });\r\n      }\r\n    }\r\n  }\r\n\r\n  render(): ReactNode {\r\n    if (this.state.hasError) {\r\n      const { fallback } = this.props;\r\n      if (fallback === undefined) return null;\r\n      if (typeof fallback === \"function\") {\r\n        return (fallback as (error: Error, info: React.ErrorInfo) => ReactNode)(\r\n          this.state.error!,\r\n          this.state.info!,\r\n        );\r\n      }\r\n      return fallback;\r\n    }\r\n    return this.props.children;\r\n  }\r\n}\r\n"]}

package/dist/hooks/index.d.mts

@@ -0,0 +1,316 @@
+import { DebouncedValueOptions, AsyncState } from '../types/index.mjs';
+export { useLocalStorage, useSessionStorage } from './storage/index.mjs';
+
+/**
+ * A boolean toggle hook.
+ *
+ * Returns the current boolean value and a stable set of actions to mutate it.
+ * All callbacks are stable (no unnecessary re-renders of consumers).
+ *
+ * @param initialValue - Initial boolean value (defaults to false)
+ */
+declare function useToggle(initialValue?: boolean): [
+    boolean,
+    {
+        toggle: () => void;
+        set: (next?: boolean) => void;
+        setTrue: () => void;
+        setFalse: () => void;
+    }
+];
+
+/**
+ * A boolean state hook with explicit setTrue/setFalse/toggle actions.
+ *
+ * Alias of useToggle with a more descriptive name. Provides stable callbacks.
+ *
+ * @param initialValue - Initial boolean value (defaults to false)
+ */
+declare function useBoolean(initialValue?: boolean): [
+    boolean,
+    {
+        setTrue: () => void;
+        setFalse: () => void;
+        toggle: () => void;
+        set: (next?: boolean) => void;
+    }
+];
+
+/**
+ * A numeric counter hook.
+ *
+ * @param initialValue - Starting value (defaults to 0)
+ */
+declare function useCounter(initialValue?: number): {
+    count: number;
+    increment: (step?: number) => void;
+    decrement: (step?: number) => void;
+    reset: () => void;
+    set: (value: number) => void;
+};
+
+/**
+ * Returns the previous value of a tracked value.
+ *
+ * On first render returns undefined (there is no previous value yet).
+ * The returned ref updates after each render so the value is always the
+ * value from the previous committed render.
+ *
+ * @param value - The value to track
+ */
+declare function usePrevious<T>(value: T): T | undefined;
+
+/**
+ * Returns a ref whose `.current` always holds the latest value without
+ * triggering re-renders. Useful for accessing the most recent value inside
+ * timers, callbacks or event listeners without stale closures.
+ *
+ * @param value - The value to track
+ */
+declare function useLatest<T>(value: T): {
+    current: T;
+};
+
+/**
+ * Returns whether the component is mounted.
+ *
+ * The value starts false (SSR-safe) and becomes true after mount. It returns
+ * to false on unmount. Use sparingly; prefer event-driven logic where possible.
+ *
+ * NOTE: Reading this during render can cause a flash of unmounted content on
+ * the client. Prefer using it inside effects or event handlers.
+ */
+declare function useMounted(): boolean;
+
+/**
+ * Array state with immutable helpers.
+ *
+ * Several helpers delegate to @mwakidenis/logx array utilities (unique,
+ * compact, first, last, take, drop, shuffle, partition, difference,
+ * intersection, union, flatten). React-specific state management is kept in
+ * this hook; LOGX provides the pure array transformations.
+ *
+ * @param initialValue - Initial array (defaults to [])
+ */
+declare function useArray<T>(initialValue?: T[]): {
+    array: T[];
+    set: (value: T[] | ((prev: T[]) => T[])) => void;
+    push: (...items: T[]) => void;
+    unshift: (...items: T[]) => void;
+    remove: (index: number) => void;
+    removeBy: (predicate: (value: T, index: number) => unknown) => void;
+    update: (index: number, value: T) => void;
+    clear: () => void;
+    reset: () => void;
+    unique: () => void;
+    compact: () => void;
+    shuffle: () => void;
+    first: () => T | undefined;
+    last: () => T | undefined;
+    take: (count: number) => T[];
+    drop: (count: number) => T[];
+    difference: (...others: T[][]) => T[];
+    intersection: (...others: T[][]) => T[];
+    union: (...others: T[][]) => T[];
+    partition: (predicate: (value: T, index: number) => unknown) => [T[], T[]];
+    flatten: () => unknown[];
+};
+
+/**
+ * Object state with immutable helpers.
+ *
+ * Several helpers delegate to @mwakidenis/logx object utilities (get, set,
+ * pick, omit, merge, keys, values, entries, clone, deepClone, mapValues).
+ * React-specific state management is kept in this hook; LOGX provides the pure
+ * object transformations.
+ *
+ * @param initialValue - Initial object (defaults to {})
+ */
+declare function useObject<T extends Record<string, unknown>>(initialValue?: T): {
+    object: T;
+    set: (value: T | ((prev: T) => T)) => void;
+    setKey: (key: string, value: unknown) => void;
+    removeKey: (key: string) => void;
+    clear: () => void;
+    reset: () => void;
+    pick: (keys: readonly string[]) => Partial<T>;
+    omit: (keys: readonly string[]) => Partial<T>;
+    merge: (sources: Partial<T>[]) => T;
+    get: (path: string | Array<string | number>) => unknown;
+    keys: () => string[];
+    values: () => unknown[];
+    entries: () => [string, unknown][];
+    clone: () => T;
+    deepClone: () => T;
+    mapValues: <U>(iteratee: (value: unknown, key: string) => U) => Record<string, U>;
+};
+
+/**
+ * Debounce a value.
+ *
+ * Returns the value after it has stopped changing for `delay` milliseconds.
+ * Uses reference equality to detect changes; for objects/arrays pass a new
+ * reference only when you want a debounce to restart.
+ *
+ * LOGX provides function debouncing (@mwakidenis/logx/function). This hook
+ * implements value debouncing (a React-specific behaviour) on top of timers;
+ * it does not map to an existing LOGX function.
+ *
+ * @param value - The value to debounce
+ * @param options - delay (ms, default 300) and leading (default false)
+ */
+declare function useDebouncedValue<T>(value: T, options?: DebouncedValueOptions): T;
+
+/**
+ * Debounce a callback using LOGX's `debounce` (@mwakidenis/logx/function).
+ *
+ * LOGX debounce is trailing-edge only: the function is invoked after `delay`
+ * milliseconds of inactivity. It exposes `cancel`, `flush` and `pending`.
+ *
+ * The latest callback reference is captured internally so the debounced
+ * function never holds a stale closure, even if `callback` changes every render.
+ *
+ * @param callback - Function to debounce
+ * @param delay - Delay in milliseconds
+ */
+declare function useDebouncedCallback<F extends (...args: unknown[]) => unknown>(callback: F, delay: number): {
+    (...args: Parameters<F>): void;
+    cancel: () => void;
+    flush: () => void;
+    pending: () => boolean;
+};
+
+/**
+ * Throttle a callback using LOGX's `throttle` (@mwakidenis/logx/function).
+ *
+ * LOGX throttle invokes on the leading edge and flushes the trailing edge at
+ * the end of the wait period. It exposes `cancel`, `flush` and `pending`.
+ *
+ * @param callback - Function to throttle
+ * @param wait - Wait period in milliseconds
+ */
+declare function useThrottle<F extends (...args: unknown[]) => unknown>(callback: F, wait: number): {
+    (...args: Parameters<F>): void;
+    cancel: () => void;
+    flush: () => void;
+    pending: () => boolean;
+};
+
+/**
+ * Track whether a media query matches.
+ *
+ * SSR-safe: returns `false` on the server and before mount, then reflects the
+ * real match status after mount. Listens for `change` events and cleans up on
+ * unmount.
+ *
+ * @param query - A CSS media query string
+ */
+declare function useMediaQuery(query: string): boolean;
+
+/**
+ * Track the window size (innerWidth / innerHeight).
+ *
+ * SSR-safe: returns { width: 0, height: 0 } on the server and first client
+ * render, then updates on resize. Cleans up the listener on unmount.
+ */
+declare function useWindowSize(): {
+    width: number;
+    height: number;
+};
+
+/**
+ * Fire a handler when a click occurs outside a ref'd element.
+ *
+ * Uses useLatest internally so the handler is always current without
+ * re-subscribing the document listeners every render.
+ *
+ * @param ref - A ref to the element to ignore clicks for
+ * @param handler - Callback fired on outside click
+ */
+declare function useClickOutside(ref: {
+    current: HTMLElement | null | undefined;
+}, handler: (event: MouseEvent | TouchEvent) => void): void;
+
+/**
+ * Attach an event listener with automatic cleanup on unmount.
+ *
+ * Supports window, document, element, or Document/Window targets. The listener
+ * is captured via a ref so it stays current without re-attaching.
+ *
+ * @param target - EventTarget (window, document, element) or null/undefined
+ * @param type - Event type
+ * @param listener - Event listener
+ * @param options - AddEventListenerOptions or capture boolean
+ */
+declare function useEventListener(target: EventTarget | null | undefined, type: string, listener: EventListener, options?: boolean | AddEventListenerOptions): void;
+
+/**
+ * Copy text to the clipboard.
+ *
+ * Uses the Clipboard API when available, with a textarea fallback for older
+ * browsers. Never throws; returns false on failure.
+ */
+declare function useClipboard(): {
+    copy: (text: string) => Promise<boolean>;
+    isSupported: boolean;
+};
+
+/**
+ * Track online/offline status.
+ *
+ * SSR-safe: assumes `true` on the server, then reads `navigator.onLine` after
+ * mount and listens for `online`/`offline` events.
+ */
+declare function useOnlineStatus(): boolean;
+
+/**
+ * A controllable timeout hook.
+ *
+ * Provides start/stop/reset and clears the timer on unmount. The callback is
+ * captured via useLatest so it never goes stale. `active` reflects whether a
+ * timeout is currently scheduled.
+ *
+ * @param callback - Function to invoke after the delay
+ * @param delay - Delay in milliseconds, or null to disable
+ */
+declare function useTimeout(callback: () => void, delay: number | null): {
+    start: () => void;
+    stop: () => void;
+    reset: () => void;
+    active: boolean;
+};
+
+/**
+ * A controllable interval hook.
+ *
+ * Provides start/stop and clears the interval on unmount. The callback is
+ * captured via useLatest so it never goes stale. `active` reflects whether an
+ * interval is currently scheduled.
+ *
+ * @param callback - Function to invoke every `delay` milliseconds
+ * @param delay - Delay in milliseconds, or null to disable
+ */
+declare function useInterval(callback: () => void, delay: number | null): {
+    start: () => void;
+    stop: () => void;
+    active: boolean;
+};
+
+/**
+ * Manage an asynchronous operation with loading, success and error states.
+ *
+ * Supports cancellation via AbortController, race-condition protection (only
+ * the latest invocation updates state), and manual execute / reset.
+ *
+ * @param asyncFn - Function returning a Promise
+ * @param immediate - Whether to invoke immediately on mount (default true)
+ */
+declare function useAsync<T>(asyncFn: () => Promise<T>, immediate?: boolean): AsyncState<T> & {
+    execute: () => Promise<void>;
+    setData: (data: T) => void;
+    setError: (error: Error) => void;
+    reset: () => void;
+    cancel: () => void;
+};
+
+export { useArray, useAsync, useBoolean, useClickOutside, useClipboard, useCounter, useDebouncedCallback, useDebouncedValue, useEventListener, useInterval, useLatest, useMediaQuery, useMounted, useObject, useOnlineStatus, usePrevious, useThrottle, useTimeout, useToggle, useWindowSize };