@mwakidenis/logx-react 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+All notable changes to @mwakidenis/logx-react will be documented in this file.
+
+## [0.1.0] - 2026-11-05
+
+### Added
+
+- Initial release of @mwakidenis/logx-react.
+- Hooks: useToggle, useBoolean, useCounter, usePrevious, useLatest, useMounted, useArray, useObject, useDebouncedValue, useDebouncedCallback, useThrottle, useLocalStorage, useSessionStorage, useMediaQuery, useWindowSize, useClickOutside, useEventListener, useClipboard, useOnlineStatus, useTimeout, useInterval, useAsync.
+- Components: CopyButton, DebouncedInput, PasswordInput, Responsive, ErrorBoundary.
+- Providers: LogxProvider.
+- Utilities: array, object, string, number, validation, date, browser.
+- LOGX integration layer using @mwakidenis/logx at runtime.
+- Vitest + React Testing Library test suite (75 tests).
+- ESM, CommonJS, and TypeScript declaration builds via tsup.
+- GitHub Actions CI workflow.
+- Documentation and examples.

package/LICENSE

@@ -0,0 +1,23 @@
+# LOGX React Toolkit
+
+MIT License
+
+Copyright (c) 2026 Mwaki Denis
+
+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

@@ -1,3 +1,151 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @mwakidenis/logx-react
+
+A modular, lightweight, SSR-safe React utility toolkit built on [@mwakidenis/logx](https://github.com/mwakidenis/logx). Provides hooks, components, utilities, and providers for production React applications.
+
+[![npm version](https://img.shields.io/npm/v/@mwakidenis/logx-react.svg)](https://www.npmjs.com/package/@mwakidenis/logx-react)
+[![npm downloads](https://img.shields.io/npm/dm/@mwakidenis/logx-react)](https://www.npmjs.com/package/@mwakidenis/logx-react)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg)](https://www.typescriptlang.org/)
+
+## Installation
+
+```bash
+npm install @mwakidenis/logx-react @mwakidenis/logx
+```
+
+`@mwakidenis/logx` is a required peer/runtime dependency and must be installed alongside this package.
+
+```bash
+npm install --save react react-dom   # peer dependencies (React 18 or 19)
+```
+
+## Quick start
+
+```tsx
+import { useToggle, useDebouncedValue, CopyButton } from "@mwakidenis/logx-react";
+
+function Demo() {
+  const [open] = useToggle(false);
+  const value = useDebouncedValue("initial", { delay: 300 });
+
+  return (
+    <div>
+      <button aria-expanded={open}>{open ? "Open" : "Closed"}</button>
+      <CopyButton text={value} />
+    </div>
+  );
+}
+```
+
+## Feature overview
+
+**Hooks** — state, performance, browser, storage, and async utilities:
+
+| Hook | Purpose |
+|------|---------|
+| `useToggle` / `useBoolean` | Boolean state with stable actions |
+| `useCounter` | Numeric counter |
+| `usePrevious` / `useLatest` | Track previous / latest values |
+| `useMounted` | Mount status (SSR-safe) |
+| `useArray` / `useObject` | Array and object state with LOGX helpers |
+| `useDebouncedValue` | Debounce a changing value |
+| `useDebouncedCallback` / `useThrottle` | Debounce/throttle callbacks via LOGX |
+| `useLocalStorage` / `useSessionStorage` | Persisted state (exception-guarded) |
+| `useMediaQuery` / `useWindowSize` | Browser environment (SSR-safe) |
+| `useClickOutside` / `useEventListener` | DOM event handling |
+| `useClipboard` / `useOnlineStatus` | Clipboard and connectivity |
+| `useTimeout` / `useInterval` | Controllable timers |
+| `useAsync` | Async state with cancellation |
+
+**Components** — independently importable, no UI framework dependency:
+
+| Component | Purpose |
+|-----------|---------|
+| `CopyButton` | Accessible copy-to-clipboard button |
+| `DebouncedInput` | Input with immediate + debounced values |
+| `PasswordInput` | Show/hide password input |
+| `Responsive` | Media-query-based rendering (SSR-safe) |
+| `ErrorBoundary` | Descendant error capture with fallback |
+
+**Utilities** — array, object, string, number, validation, date, and browser helpers, many delegating to @mwakidenis/logx.
+
+**Providers** — `LogxProvider` exposes the LOGX integration layer via React context (optional).
+
+## Modular imports
+
+Every export supports tree-shaking. Import from the root or from a subpath:
+
+```ts
+import { useToggle } from "@mwakidenis/logx-react";
+import { useDebouncedValue } from "@mwakidenis/logx-react/hooks";
+import { useLocalStorage } from "@mwakidenis/logx-react/hooks/storage";
+import { CopyButton } from "@mwakidenis/logx-react/components";
+import { array } from "@mwakidenis/logx-react/utilities";
+```
+
+All advertised paths are wired through `package.json` `exports` with ESM, CommonJS, and TypeScript declarations.
+
+## LOGX integration
+
+This toolkit genuinely uses [`@mwakidenis/logx`](https://github.com/mwakidenis/logx) at runtime:
+
+- `useDebouncedCallback` and `useThrottle` wrap LOGX's `debounce` and `throttle` (`@mwakidenis/logx/function`).
+- `useArray` and `useObject` delegate pure transformations (unique, compact, pick, omit, merge, get, set, keys, values, entries, …) to LOGX's array and object modules.
+- `useLocalStorage` / `useSessionStorage` use LOGX's `safeStorage`, `localStorageHelpers`, and `sessionStorageHelpers` (`@mwakidenis/logx/browser`).
+- Validation and object helpers reuse LOGX's `validation`, `object`, `string`, `date`, `number`, and `async` modules.
+
+A dedicated integration layer (`src/internal/logx.ts`) keeps React-specific behavior separate from core utility behavior. No LOGX source is copied into this project, and the parent repository is not modified.
+
+See `docs/logx-integration.md` for details.
+
+## TypeScript
+
+Written in strict TypeScript (`strict`, `noImplicitAny`, `strictNullChecks`, declaration generation). All public APIs are generically typed. No `any` is used in public APIs.
+
+## SSR compatibility
+
+All hooks and components are safe to use during server-side rendering and hydration. Browser APIs (`window`, `document`, `localStorage`, `matchMedia`, `navigator`) are never accessed at module initialization; storage and media queries initialize after mount so server and client first renders match.
+
+## React compatibility
+
+`react` and `react-dom` are peer dependencies. Tested against React 18.2+ and React 19. Follows the Rules of Hooks and avoids deprecated React APIs.
+
+## Performance philosophy
+
+- Minimal runtime dependencies (`@mwakidenis/logx` only).
+- Tree-shakable modular imports; `sideEffects: false`.
+- No unnecessary re-renders; stable callbacks where appropriate.
+- Proper timer and event-listener cleanup to avoid memory leaks.
+
+No performance-superiority claims are made without benchmarks.
+
+## Browser support
+
+Modern browsers with React 18/19. Graceful degradation when browser APIs (localStorage, sessionStorage, Clipboard API, matchMedia) are unavailable.
+
+## Testing
+
+Tests use Vitest, React Testing Library, and jsdom. Run:
+
+```bash
+npm test
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md). Security issues: [SECURITY.md](SECURITY.md).
+
+## Roadmap
+
+See the [roadmap](docs/README.md) in the docs folder.
+
+## Author
+
+Mwaki Denis — https://github.com/mwakidenis
+
+## Links
+
+- Repository: https://github.com/mwakidenis/logx-react-toolkit
+- npm package: https://www.npmjs.com/package/@mwakidenis/logx-react
+- Parent library: https://github.com/mwakidenis/logx (@mwakidenis/logx)
+- License: [MIT](LICENSE)

package/dist/components/index.d.mts

@@ -0,0 +1,71 @@
+import { CopyButtonProps, DebouncedInputProps, PasswordInputProps, ResponsiveProps, ErrorBoundaryProps, ErrorBoundaryState } from '../types/index.mjs';
+import { Component, ReactNode } from 'react';
+
+/**
+ * Accessible copy-to-clipboard button.
+ *
+ * - Copies the supplied `text` to the clipboard.
+ * - Shows idle / copying / success / error states.
+ * - Supports custom labels per state and a custom className.
+ * - Keyboard accessible (native button). No icon library dependency.
+ *
+ * @param props - Component props
+ */
+declare function CopyButton({ text, label, copyingLabel, successLabel, errorLabel, className, onCopy, onError, timeout, }: CopyButtonProps): JSX.Element;
+
+/**
+ * Controlled input with a separate debounced value.
+ *
+ * - `value`/`defaultValue` for controlled/uncontrolled usage.
+ * - `delay` controls debounce duration.
+ * - `onChange` fires immediately; `onDebouncedChange` fires after debounce.
+ * - Accepts standard input attributes for form integration.
+ *
+ * @param props - Component props
+ */
+declare function DebouncedInput({ value, defaultValue, onChange, onDebouncedChange, delay, ...rest }: DebouncedInputProps): JSX.Element;
+
+/**
+ * Accessible show/hide password input.
+ *
+ * - Controlled/uncontrolled value.
+ * - Accessible toggle button labels.
+ * - Keyboard accessible; no external UI framework dependency.
+ *
+ * @param props - Component props
+ */
+declare function PasswordInput({ value, defaultValue, onChange, label, placeholder, disabled, required, name, id, showToggle, className, }: PasswordInputProps): JSX.Element;
+
+/**
+ * Conditionally render content based on a media query.
+ *
+ * SSR-safe: on the server and before mount, renders `fallback` (or null),
+ * avoiding hydration mismatches. After mount, renders `children(matches)` when
+ * the query matches, otherwise `fallback`.
+ *
+ * @param props - Component props
+ */
+declare function Responsive({ children, query, fallback }: ResponsiveProps): JSX.Element;
+
+/**
+ * React error boundary.
+ *
+ * Captures descendant rendering errors, supports a fallback UI (element or
+ * render function receiving the error and React error info), an optional
+ * onError callback, and optional reset via `resetKeys` changes.
+ *
+ * Limitations: does not catch errors in event handlers, asynchronous code
+ * (setTimeout, promises), or server-side rendering. Those must be handled
+ * separately (try/catch, error-first callbacks, etc.).
+ *
+ * @param props - Component props
+ */
+declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    state: ErrorBoundaryState;
+    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+    componentDidCatch(error: Error, info: React.ErrorInfo): void;
+    componentDidUpdate(prevProps: ErrorBoundaryProps): void;
+    render(): ReactNode;
+}
+
+export { CopyButton, DebouncedInput, ErrorBoundary, PasswordInput, Responsive };

package/dist/components/index.d.ts

@@ -0,0 +1,71 @@
+import { CopyButtonProps, DebouncedInputProps, PasswordInputProps, ResponsiveProps, ErrorBoundaryProps, ErrorBoundaryState } from '../types/index.js';
+import { Component, ReactNode } from 'react';
+
+/**
+ * Accessible copy-to-clipboard button.
+ *
+ * - Copies the supplied `text` to the clipboard.
+ * - Shows idle / copying / success / error states.
+ * - Supports custom labels per state and a custom className.
+ * - Keyboard accessible (native button). No icon library dependency.
+ *
+ * @param props - Component props
+ */
+declare function CopyButton({ text, label, copyingLabel, successLabel, errorLabel, className, onCopy, onError, timeout, }: CopyButtonProps): JSX.Element;
+
+/**
+ * Controlled input with a separate debounced value.
+ *
+ * - `value`/`defaultValue` for controlled/uncontrolled usage.
+ * - `delay` controls debounce duration.
+ * - `onChange` fires immediately; `onDebouncedChange` fires after debounce.
+ * - Accepts standard input attributes for form integration.
+ *
+ * @param props - Component props
+ */
+declare function DebouncedInput({ value, defaultValue, onChange, onDebouncedChange, delay, ...rest }: DebouncedInputProps): JSX.Element;
+
+/**
+ * Accessible show/hide password input.
+ *
+ * - Controlled/uncontrolled value.
+ * - Accessible toggle button labels.
+ * - Keyboard accessible; no external UI framework dependency.
+ *
+ * @param props - Component props
+ */
+declare function PasswordInput({ value, defaultValue, onChange, label, placeholder, disabled, required, name, id, showToggle, className, }: PasswordInputProps): JSX.Element;
+
+/**
+ * Conditionally render content based on a media query.
+ *
+ * SSR-safe: on the server and before mount, renders `fallback` (or null),
+ * avoiding hydration mismatches. After mount, renders `children(matches)` when
+ * the query matches, otherwise `fallback`.
+ *
+ * @param props - Component props
+ */
+declare function Responsive({ children, query, fallback }: ResponsiveProps): JSX.Element;
+
+/**
+ * React error boundary.
+ *
+ * Captures descendant rendering errors, supports a fallback UI (element or
+ * render function receiving the error and React error info), an optional
+ * onError callback, and optional reset via `resetKeys` changes.
+ *
+ * Limitations: does not catch errors in event handlers, asynchronous code
+ * (setTimeout, promises), or server-side rendering. Those must be handled
+ * separately (try/catch, error-first callbacks, etc.).
+ *
+ * @param props - Component props
+ */
+declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    state: ErrorBoundaryState;
+    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+    componentDidCatch(error: Error, info: React.ErrorInfo): void;
+    componentDidUpdate(prevProps: ErrorBoundaryProps): void;
+    render(): ReactNode;
+}
+
+export { CopyButton, DebouncedInput, ErrorBoundary, PasswordInput, Responsive };

package/dist/components/index.js

@@ -0,0 +1,268 @@
+'use strict';
+
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/components/CopyButton/index.tsx
+function useLatest(value) {
+  const ref = react.useRef(value);
+  ref.current = value;
+  return ref;
+}
+function useDebouncedValue(value, options = {}) {
+  const { delay = 300, leading = false } = options;
+  const [debounced, setDebounced] = react.useState(value);
+  const latest = useLatest(value);
+  const timerRef = react.useRef(null);
+  const lastLeadingRef = react.useRef(void 0);
+  react.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]);
+  react.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] = react.useState(false);
+  react.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 = react.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] = react.useState("idle");
+  const { copy } = useClipboard();
+  const handleCopy = react.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__ */ jsxRuntime.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] = react.useState(defaultValue ?? "");
+  const isControlled = value !== void 0;
+  const currentValue = isControlled ? value ?? "" : internalValue;
+  const handleChange = react.useCallback(
+    (event) => {
+      const next = event.target.value;
+      if (!isControlled) setInternalValue(next);
+      onChange?.(next);
+    },
+    [isControlled, onChange]
+  );
+  const debounced = useDebouncedValue(currentValue, { delay });
+  const initialized = react.useRef(false);
+  react.useEffect(() => {
+    if (!initialized.current) {
+      initialized.current = true;
+      return;
+    }
+    onDebouncedChange?.(debounced);
+  }, [debounced, onDebouncedChange]);
+  return /* @__PURE__ */ jsxRuntime.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] = react.useState(false);
+  const [internalValue, setInternalValue] = react.useState(defaultValue ?? "");
+  const isControlled = value !== void 0;
+  const currentValue = isControlled ? value ?? "" : internalValue;
+  const handleChange = react.useCallback(
+    (event) => {
+      const next = event.target.value;
+      if (!isControlled) setInternalValue(next);
+      onChange?.(next);
+    },
+    [isControlled, onChange]
+  );
+  const toggle = react.useCallback(() => setShow((current) => !current), []);
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className, children: [
+    label && /* @__PURE__ */ jsxRuntime.jsx("label", { htmlFor: id, children: label }),
+    /* @__PURE__ */ jsxRuntime.jsx(
+      "input",
+      {
+        id,
+        name,
+        type: show ? "text" : "password",
+        value: currentValue,
+        onChange: handleChange,
+        placeholder,
+        disabled,
+        required,
+        "aria-label": label
+      }
+    ),
+    showToggle && /* @__PURE__ */ jsxRuntime.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 = react.useCallback(
+    (m) => m ? children(m) : fallback ?? null,
+    [children, fallback]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: renderChildren(matches) });
+}
+var ErrorBoundary = class extends react.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;
+  }
+};
+
+exports.CopyButton = CopyButton;
+exports.DebouncedInput = DebouncedInput;
+exports.ErrorBoundary = ErrorBoundary;
+exports.PasswordInput = PasswordInput;
+exports.Responsive = Responsive;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/components/index.js.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","jsxs","Fragment","Component"],"mappings":"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","file":"index.js","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"]}