@siberiacancode/reactuse 0.3.1 → 0.3.3

package/dist/esm/utils/helpers/isTarget.mjs

@@ -1,6 +1,12 @@
-import { targetSymbol as t } from "./getElement.mjs";
-const r = (o) => typeof o == "object" && ("current" in o || o.type === t);
+const n = Symbol("target"), o = (e) => "current" in e ? e.current : typeof e.value == "function" ? e.value() : typeof e.value == "string" ? document.querySelector(e.value) : (e.value instanceof Document || e.value instanceof Window || e.value instanceof Element, e.value), l = (e) => ({
+  value: e,
+  type: n
+}), u = (e) => typeof e == "object" && ("current" in e || e && e.type === n);
+u.wrap = l;
+u.getElement = o;
 export {
-  r as isTarget
+  u as isTarget,
+  l as target,
+  n as targetSymbol
 };
 //# sourceMappingURL=isTarget.mjs.map

package/dist/esm/utils/helpers/isTarget.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"isTarget.mjs","sources":["../../../../src/utils/helpers/isTarget.ts"],"sourcesContent":["import type { HookTarget } from './getElement';\n\nimport { targetSymbol } from './getElement';\n\nexport const isTarget = (target: HookTarget) =>\n  typeof target === 'object' && ('current' in target || target.type === targetSymbol);\n"],"names":["isTarget","target","targetSymbol"],"mappings":";AAIO,MAAMA,IAAW,CAACC,MACvB,OAAOA,KAAW,aAAa,aAAaA,KAAUA,EAAO,SAASC;"}
+{"version":3,"file":"isTarget.mjs","sources":["../../../../src/utils/helpers/isTarget.ts"],"sourcesContent":["import type { RefObject } from 'react';\n\nexport const targetSymbol = Symbol('target');\n\nexport type Target = (() => Element) | string | Document | Element | Window;\n\nexport type HookTarget =\n  | RefObject<Element | null | undefined>\n  | {\n      value: Target;\n      type: symbol;\n    };\n\nconst getElement = (target: HookTarget) => {\n  if ('current' in target) {\n    return target.current;\n  }\n\n  if (typeof target.value === 'function') {\n    return target.value();\n  }\n\n  if (typeof target.value === 'string') {\n    return document.querySelector(target.value);\n  }\n\n  if (target.value instanceof Document) {\n    return target.value;\n  }\n\n  if (target.value instanceof Window) {\n    return target.value;\n  }\n\n  if (target.value instanceof Element) {\n    return target.value;\n  }\n\n  return target.value;\n};\n\nexport const target = (target: Target) => ({\n  value: target,\n  type: targetSymbol\n});\n\nexport const isTarget = (target: HookTarget) =>\n  typeof target === 'object' &&\n  ('current' in target || (target && (target as any).type === targetSymbol));\n\nisTarget.wrap = target;\nisTarget.getElement = getElement;\n"],"names":["targetSymbol","getElement","target","isTarget"],"mappings":"AAEO,MAAMA,IAAe,OAAO,QAAQ,GAWrCC,IAAa,CAACC,MACd,aAAaA,IACRA,EAAO,UAGZ,OAAOA,EAAO,SAAU,aACnBA,EAAO,MAAA,IAGZ,OAAOA,EAAO,SAAU,WACnB,SAAS,cAAcA,EAAO,KAAK,KAGxCA,EAAO,iBAAiB,YAIxBA,EAAO,iBAAiB,UAIxBA,EAAO,iBAAiB,SACnBA,EAAO,QAMLA,IAAS,CAACA,OAAoB;AAAA,EACzC,OAAOA;AAAAA,EACP,MAAMF;AACR,IAEaG,IAAW,CAACD,MACvB,OAAOA,KAAW,aACjB,aAAaA,KAAWA,KAAWA,EAAe,SAASF;AAE9DG,EAAS,OAAOD;AAChBC,EAAS,aAAaF;"}

package/dist/types/hooks/elements.d.ts

@@ -13,4 +13,5 @@ export * from './usePaint/usePaint';
 export * from './useRightClick/useRightClick';
 export * from './useScript/useScript';
 export * from './useSticky/useSticky';
+export * from './useTextareaAutosize/useTextareaAutosize';
 export * from './useTextDirection/useTextDirection';

package/dist/types/hooks/useHash/useHash.d.ts

@@ -31,11 +31,7 @@ export interface UseHash {
  * @returns {UseHashReturn} An array containing the hash value and a function to set the hash value
  *
  * @example
- * const [hash, setHash] = useHash("initial", {
- *   enabled: true,
- *   mode: "replace",
- *   onChange: (newHash) => console.log('Hash changed:', newHash)
- * });
+ * const [hash, setHash] = useHash("initial");
  *
  * @overload
  * @param {string} [initialValue] The initial hash value if no hash exists
@@ -44,6 +40,23 @@ export interface UseHash {
  *
  * @example
  * const [hash, setHash] = useHash("initial", (newHash) => console.log('callback'));
+ *
+ * @overload
+ * @param {UseHashOptions} [options] Configuration options
+ * @param {boolean} [options.enabled] The enabled state of the hook
+ * @param {'initial' | 'replace'} [options.mode] The mode of hash setting
+ * @param {(hash: string) => void} [options.onChange] Callback function called when hash changes
+ * @returns {UseHashReturn} An array containing the hash value and a function to set the hash value
+ *
+ * @example
+ * const [hash, setHash] = useHash();
+ *
+ * @overload
+ * @param {(hash: string) => void} [callback] Callback function called when hash changes
+ * @returns {UseHashReturn} An array containing the hash value and a function to set the hash value
+ *
+ * @example
+ * const [hash, setHash] = useHash((newHash) => console.log('callback'));
  */
 export declare const useHash: UseHash;
 export {};

package/dist/types/hooks/useTextareaAutosize/useTextareaAutosize.d.ts

@@ -0,0 +1,60 @@
+import { HookTarget } from '../../utils/helpers';
+import { StateRef } from '../useRefState/useRefState';
+/** The use textarea autosize options */
+export interface UseTextareaAutosizeOptions {
+    /** The initial value for the textarea */
+    initialValue?: string;
+    /** Callback function called when the textarea size changes */
+    onResize?: () => void;
+}
+/** The use textarea autosize return type */
+export interface UseTextareaAutosizeReturn {
+    /** The current value of the textarea */
+    value: string;
+    /** Function to clear the textarea value */
+    clear: () => void;
+    /** Function to set the textarea value */
+    setValue: (value: string) => void;
+}
+export interface UseTextareaAutosize {
+    (target: HookTarget, options?: UseTextareaAutosizeOptions): UseTextareaAutosizeReturn;
+    <Target extends HTMLTextAreaElement = HTMLTextAreaElement>(initialValue: string, target?: never): UseTextareaAutosizeReturn & {
+        ref: StateRef<Target>;
+    };
+    <Target extends HTMLTextAreaElement = HTMLTextAreaElement>(options?: UseTextareaAutosizeOptions, target?: never): UseTextareaAutosizeReturn & {
+        ref: StateRef<Target>;
+    };
+}
+/**
+ * @name useTextareaAutosize
+ * @description - Hook that automatically adjusts textarea height based on content
+ * @category Elements
+ * @usage medium
+ *
+ * @overload
+ * @param {HookTarget} target The target textarea element
+ * @param {string} [options.initialValue] The initial value for the textarea
+ * @param {Function} [options.onResize] Callback function called when the textarea size changes
+ * @returns {UseTextareaAutosizeReturn} An object containing value, setValue and clear
+ *
+ * @example
+ * const { value, setValue, clear } = useTextareaAutosize(ref);
+ *
+ * @overload
+ * @template Target The textarea element type
+ * @param {string} initialValue The initial value for the textarea
+ * @returns {UseTextareaAutosizeReturn & { ref: StateRef<Target> }} An object containing ref, value, setValue and clear
+ *
+ * @example
+ * const { ref, value, setValue, clear } = useTextareaAutosize('initial');
+ *
+ * @overload
+ * @template Target The textarea element type
+ * @param {string} [options.initialValue] The initial value for the textarea
+ * @param {Function} [options.onResize] Callback function called when the textarea size changes
+ * @returns {UseTextareaAutosizeReturn & { ref: StateRef<Target> }} An object containing ref, value, setValue and clear
+ *
+ * @example
+ * const { ref, value, setValue, clear } = useTextareaAutosize();
+ */
+export declare const useTextareaAutosize: UseTextareaAutosize;

package/dist/types/utils/helpers/index.d.ts

@@ -1,7 +1,6 @@
 export * from './copy';
 export * from './debounce';
 export * from './getDate';
-export * from './getElement';
 export * from './getRetry';
 export * from './isTarget';
 export * from './throttle';

package/dist/types/utils/helpers/isTarget.d.ts

@@ -1,2 +1,19 @@
-import { HookTarget } from './getElement';
-export declare const isTarget: (target: HookTarget) => boolean;
+import { RefObject } from 'react';
+export declare const targetSymbol: unique symbol;
+export type Target = (() => Element) | string | Document | Element | Window;
+export type HookTarget = RefObject<Element | null | undefined> | {
+    value: Target;
+    type: symbol;
+};
+export declare const target: (target: Target) => {
+    value: Target;
+    type: symbol;
+};
+export declare const isTarget: {
+    (target: HookTarget): boolean;
+    wrap: (target: Target) => {
+        value: Target;
+        type: symbol;
+    };
+    getElement: (target: HookTarget) => Window | Document | Element | null | undefined;
+};

package/package.json

@@ -1,89 +1,89 @@
-{
-  "name": "@siberiacancode/reactuse",
-  "version": "0.3.1",
-  "description": "The ultimate collection of react hooks",
-  "author": {
-    "name": "SIBERIA CAN CODE 🧊",
-    "url": "https://github.com/siberiacancode"
-  },
-  "license": "MIT",
-  "homepage": "https://siberiacancode.github.io/reactuse/",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/siberiacancode/reactuse.git",
-    "directory": "packages/core"
-  },
-  "bugs": "https://github.com/siberiacancode/reactuse/issues",
-  "keywords": [
-    "react",
-    "react hooks",
-    "react use",
-    "use",
-    "hooks"
-  ],
-  "sideEffects": false,
-  "exports": {
-    "types": "./dist/types/index.d.ts",
-    "import": "./dist/esm/index.mjs",
-    "require": "./dist/cjs/index.cjs"
-  },
-  "main": "dist/cjs/index.cjs",
-  "module": "dist/esm/index.mjs",
-  "types": "dist/types/index.d.ts",
-  "files": [
-    "dist"
-  ],
-  "engines": {
-    "node": ">=14"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "prepublishOnly": "pnpm unit-test run && pnpm build",
-    "build": "shx rm -rf dist && vite build",
-    "build:js": "tsc --project tsconfig.build.json && prettier --write src/bundle",
-    "lint": "eslint . --fix",
-    "lint-inspector": "npx @eslint/config-inspector@latest",
-    "format": "prettier --write .",
-    "pretty": "pnpm lint && pnpm format",
-    "unit-test": "vitest",
-    "lint-staged": "lint-staged"
-  },
-  "peerDependencies": {
-    "@types/react": "^18 || ^19",
-    "react": "^18 || ^19",
-    "react-dom": "^18 || ^19"
-  },
-  "peerDependenciesMeta": {
-    "@types/react": {
-      "optional": true
-    }
-  },
-  "dependencies": {
-    "screenfull": "^6.0.2"
-  },
-  "devDependencies": {
-    "@siberiacancode/vitest": "^2.1.0",
-    "@testing-library/dom": "^10.4.1",
-    "@testing-library/react": "^16.3.0",
-    "@types/dom-speech-recognition": "^0.0.6",
-    "@types/react": "^19.1.10",
-    "@types/react-dom": "^19.1.7",
-    "@types/web-bluetooth": "^0.0.21",
-    "@vitejs/plugin-react": "^5.0.1",
-    "core-js": "^3.45.0",
-    "react": "^19.1.1",
-    "react-dom": "^19.1.1",
-    "shx": "^0.4.0",
-    "vite": "^7.1.3",
-    "vite-plugin-dts": "^4.5.4",
-    "vitest": "^3.2.4"
-  },
-  "lint-staged": {
-    "*.{js,ts,tsx}": [
-      "eslint --fix",
-      "prettier --write"
-    ]
-  }
-}
+{
+  "name": "@siberiacancode/reactuse",
+  "version": "0.3.3",
+  "description": "The ultimate collection of react hooks",
+  "author": {
+    "name": "SIBERIA CAN CODE 🧊",
+    "url": "https://github.com/siberiacancode"
+  },
+  "license": "MIT",
+  "homepage": "https://siberiacancode.github.io/reactuse/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/siberiacancode/reactuse.git",
+    "directory": "packages/core"
+  },
+  "bugs": "https://github.com/siberiacancode/reactuse/issues",
+  "keywords": [
+    "react",
+    "react hooks",
+    "react use",
+    "use",
+    "hooks"
+  ],
+  "sideEffects": false,
+  "exports": {
+    "types": "./dist/types/index.d.ts",
+    "import": "./dist/esm/index.mjs",
+    "require": "./dist/cjs/index.cjs"
+  },
+  "main": "dist/cjs/index.cjs",
+  "module": "dist/esm/index.mjs",
+  "types": "dist/types/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=14"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "prepublishOnly": "pnpm unit-test run && pnpm build",
+    "build": "shx rm -rf dist && vite build",
+    "build:js": "tsc --project tsconfig.build.json && prettier --write src/bundle",
+    "lint": "eslint . --fix",
+    "lint-inspector": "npx @eslint/config-inspector@latest",
+    "format": "prettier --write .",
+    "pretty": "pnpm lint && pnpm format",
+    "unit-test": "vitest",
+    "lint-staged": "lint-staged"
+  },
+  "peerDependencies": {
+    "@types/react": "^18 || ^19",
+    "react": "^18 || ^19",
+    "react-dom": "^18 || ^19"
+  },
+  "peerDependenciesMeta": {
+    "@types/react": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "screenfull": "^6.0.2"
+  },
+  "devDependencies": {
+    "@siberiacancode/vitest": "^2.2.0",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/react": "^16.3.0",
+    "@types/dom-speech-recognition": "^0.0.7",
+    "@types/react": "^19.2.2",
+    "@types/react-dom": "^19.2.2",
+    "@types/web-bluetooth": "^0.0.21",
+    "@vitejs/plugin-react": "^5.1.0",
+    "core-js": "^3.46.0",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "shx": "^0.4.0",
+    "vite": "^7.2.2",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^4.0.8"
+  },
+  "lint-staged": {
+    "*.{js,ts,tsx}": [
+      "eslint --fix",
+      "prettier --write"
+    ]
+  }
+}

package/dist/cjs/utils/helpers/getElement.cjs

@@ -1,2 +0,0 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=Symbol("target"),u=e=>({value:e,type:n}),l=e=>"current"in e?e.current:typeof e.value=="function"?e.value():typeof e.value=="string"?document.querySelector(e.value):(e.value instanceof Document||e.value instanceof Window||e.value instanceof Element,e.value);exports.getElement=l;exports.target=u;exports.targetSymbol=n;
-//# sourceMappingURL=getElement.cjs.map

package/dist/cjs/utils/helpers/getElement.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"getElement.cjs","sources":["../../../../src/utils/helpers/getElement.ts"],"sourcesContent":["import type { RefObject } from 'react';\n\nexport type Target = (() => Element) | string | Document | Element | Window;\nexport type HookTarget =\n  | RefObject<Element | null | undefined>\n  | {\n      value: Target;\n      type: symbol;\n    };\n\nexport const targetSymbol = Symbol('target');\nexport const target = (target: Target) => ({\n  value: target,\n  type: targetSymbol\n});\n\nexport const getElement = (target: HookTarget) => {\n  if ('current' in target) {\n    return target.current;\n  }\n\n  if (typeof target.value === 'function') {\n    return target.value();\n  }\n\n  if (typeof target.value === 'string') {\n    return document.querySelector(target.value);\n  }\n\n  if (target.value instanceof Document) {\n    return target.value;\n  }\n\n  if (target.value instanceof Window) {\n    return target.value;\n  }\n\n  if (target.value instanceof Element) {\n    return target.value;\n  }\n\n  return target.value;\n};\n"],"names":["targetSymbol","target","getElement"],"mappings":"gFAUO,MAAMA,EAAe,OAAO,QAAQ,EAC9BC,EAAUA,IAAoB,CACzC,MAAOA,EACP,KAAMD,CACR,GAEaE,EAAcD,GACrB,YAAaA,EACRA,EAAO,QAGZ,OAAOA,EAAO,OAAU,WACnBA,EAAO,MAAA,EAGZ,OAAOA,EAAO,OAAU,SACnB,SAAS,cAAcA,EAAO,KAAK,GAGxCA,EAAO,iBAAiB,UAIxBA,EAAO,iBAAiB,QAIxBA,EAAO,iBAAiB,QACnBA,EAAO"}

package/dist/esm/utils/helpers/getElement.mjs

@@ -1,10 +0,0 @@
-const n = Symbol("target"), u = (e) => ({
-  value: e,
-  type: n
-}), l = (e) => "current" in e ? e.current : typeof e.value == "function" ? e.value() : typeof e.value == "string" ? document.querySelector(e.value) : (e.value instanceof Document || e.value instanceof Window || e.value instanceof Element, e.value);
-export {
-  l as getElement,
-  u as target,
-  n as targetSymbol
-};
-//# sourceMappingURL=getElement.mjs.map

package/dist/esm/utils/helpers/getElement.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"getElement.mjs","sources":["../../../../src/utils/helpers/getElement.ts"],"sourcesContent":["import type { RefObject } from 'react';\n\nexport type Target = (() => Element) | string | Document | Element | Window;\nexport type HookTarget =\n  | RefObject<Element | null | undefined>\n  | {\n      value: Target;\n      type: symbol;\n    };\n\nexport const targetSymbol = Symbol('target');\nexport const target = (target: Target) => ({\n  value: target,\n  type: targetSymbol\n});\n\nexport const getElement = (target: HookTarget) => {\n  if ('current' in target) {\n    return target.current;\n  }\n\n  if (typeof target.value === 'function') {\n    return target.value();\n  }\n\n  if (typeof target.value === 'string') {\n    return document.querySelector(target.value);\n  }\n\n  if (target.value instanceof Document) {\n    return target.value;\n  }\n\n  if (target.value instanceof Window) {\n    return target.value;\n  }\n\n  if (target.value instanceof Element) {\n    return target.value;\n  }\n\n  return target.value;\n};\n"],"names":["targetSymbol","target","getElement"],"mappings":"AAUO,MAAMA,IAAe,OAAO,QAAQ,GAC9BC,IAAS,CAACA,OAAoB;AAAA,EACzC,OAAOA;AAAAA,EACP,MAAMD;AACR,IAEaE,IAAa,CAACD,MACrB,aAAaA,IACRA,EAAO,UAGZ,OAAOA,EAAO,SAAU,aACnBA,EAAO,MAAA,IAGZ,OAAOA,EAAO,SAAU,WACnB,SAAS,cAAcA,EAAO,KAAK,KAGxCA,EAAO,iBAAiB,YAIxBA,EAAO,iBAAiB,UAIxBA,EAAO,iBAAiB,SACnBA,EAAO;"}

package/dist/types/utils/helpers/getElement.d.ts

@@ -1,12 +0,0 @@
-import { RefObject } from 'react';
-export type Target = (() => Element) | string | Document | Element | Window;
-export type HookTarget = RefObject<Element | null | undefined> | {
-    value: Target;
-    type: symbol;
-};
-export declare const targetSymbol: unique symbol;
-export declare const target: (target: Target) => {
-    value: Target;
-    type: symbol;
-};
-export declare const getElement: (target: HookTarget) => Window | Document | Element | null | undefined;