@tiny-codes/react-easy 1.0.4 → 1.0.5

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 # Changelog
 
+## 1.0.5
+
+2025-4-14
+
+### Features
+
+- 🔥 Add `useRefValue` hook
+
 ## 1.0.4
 
 2025-3-28

package/es/hooks/index.d.ts

@@ -1,3 +1,4 @@
+export { default as useRefValue } from './useRefValue';
 export { default as useRefFunction } from './useRefFunction';
 export type { ValidatorRuleMap } from './useValidators';
 export { default as useValidators } from './useValidators';

package/es/hooks/index.js

@@ -1,3 +1,4 @@
+export { default as useRefValue } from "./useRefValue";
 export { default as useRefFunction } from "./useRefFunction";
 export { default as useValidators } from "./useValidators";
 export { default as useValidator } from "./useValidator";

package/es/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["default","useRefFunction","useValidators","useValidator","useValidatorBuilder"],"sources":["../../src/hooks/index.ts"],"sourcesContent":["export { default as useRefFunction } from './useRefFunction';\n\nexport type { ValidatorRuleMap } from './useValidators';\nexport { default as useValidators } from './useValidators';\nexport { default as useValidator } from './useValidator';\nexport type { Validator, RuleRegExpFlags, ValidatorRule, BuilderOptions } from './useValidatorBuilder';\nexport { default as useValidatorBuilder } from './useValidatorBuilder';\n"],"mappings":"AAAA,SAASA,OAAO,IAAIC,cAAc;AAGlC,SAASD,OAAO,IAAIE,aAAa;AACjC,SAASF,OAAO,IAAIG,YAAY;AAEhC,SAASH,OAAO,IAAII,mBAAmB"}
+{"version":3,"names":["default","useRefValue","useRefFunction","useValidators","useValidator","useValidatorBuilder"],"sources":["../../src/hooks/index.ts"],"sourcesContent":["export { default as useRefValue } from './useRefValue';\nexport { default as useRefFunction } from './useRefFunction';\n\nexport type { ValidatorRuleMap } from './useValidators';\nexport { default as useValidators } from './useValidators';\nexport { default as useValidator } from './useValidator';\nexport type { Validator, RuleRegExpFlags, ValidatorRule, BuilderOptions } from './useValidatorBuilder';\nexport { default as useValidatorBuilder } from './useValidatorBuilder';\n"],"mappings":"AAAA,SAASA,OAAO,IAAIC,WAAW;AAC/B,SAASD,OAAO,IAAIE,cAAc;AAGlC,SAASF,OAAO,IAAIG,aAAa;AACjC,SAASH,OAAO,IAAII,YAAY;AAEhC,SAASJ,OAAO,IAAIK,mBAAmB"}

package/es/hooks/useRefValue.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="react" />
+/**
+ * **EN:** Get a mutable ref object and automatically update the value change
+ *
+ * **CN:** 获取一个可变的ref对象，并自动更新值变化
+ *
+ * @param value the wrapped value | 被包装的值
+ *
+ * @returns A mutable ref object, but the reference is immutable | 可变的ref对象，但引用不可变
+ */
+declare const useRefValue: <T>(value: T) => import("react").RefObject<T>;
+export default useRefValue;

package/es/hooks/useRefValue.js

@@ -0,0 +1,18 @@
+import { useRef } from 'react';
+
+/**
+ * **EN:** Get a mutable ref object and automatically update the value change
+ *
+ * **CN:** 获取一个可变的ref对象，并自动更新值变化
+ *
+ * @param value the wrapped value | 被包装的值
+ *
+ * @returns A mutable ref object, but the reference is immutable | 可变的ref对象，但引用不可变
+ */
+var useRefValue = function useRefValue(value) {
+  var ref = useRef(value);
+  ref.current = value;
+  return ref;
+};
+export default useRefValue;
+//# sourceMappingURL=useRefValue.js.map

package/es/hooks/useRefValue.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useRef","useRefValue","value","ref","current"],"sources":["../../src/hooks/useRefValue.ts"],"sourcesContent":["import { useRef } from 'react';\n\n/**\n * **EN:** Get a mutable ref object and automatically update the value change\n *\n * **CN:** 获取一个可变的ref对象，并自动更新值变化\n *\n * @param value the wrapped value | 被包装的值\n *\n * @returns A mutable ref object, but the reference is immutable | 可变的ref对象，但引用不可变\n */\nconst useRefValue = <T>(value: T) => {\n  const ref = useRef<T>(value);\n  ref.current = value;\n  return ref;\n};\n\nexport default useRefValue;\n"],"mappings":"AAAA,SAASA,MAAM,QAAQ,OAAO;;AAE9B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAMC,WAAW,GAAG,SAAdA,WAAWA,CAAOC,KAAQ,EAAK;EACnC,IAAMC,GAAG,GAAGH,MAAM,CAAIE,KAAK,CAAC;EAC5BC,GAAG,CAACC,OAAO,GAAGF,KAAK;EACnB,OAAOC,GAAG;AACZ,CAAC;AAED,eAAeF,WAAW"}

package/lib/hooks/index.d.ts

@@ -1,3 +1,4 @@
+export { default as useRefValue } from './useRefValue';
 export { default as useRefFunction } from './useRefFunction';
 export type { ValidatorRuleMap } from './useValidators';
 export { default as useValidators } from './useValidators';

package/lib/hooks/index.js

@@ -30,11 +30,13 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var hooks_exports = {};
 __export(hooks_exports, {
   useRefFunction: () => import_useRefFunction.default,
+  useRefValue: () => import_useRefValue.default,
   useValidator: () => import_useValidator.default,
   useValidatorBuilder: () => import_useValidatorBuilder.default,
   useValidators: () => import_useValidators.default
 });
 module.exports = __toCommonJS(hooks_exports);
+var import_useRefValue = __toESM(require("./useRefValue"));
 var import_useRefFunction = __toESM(require("./useRefFunction"));
 var import_useValidators = __toESM(require("./useValidators"));
 var import_useValidator = __toESM(require("./useValidator"));
@@ -42,6 +44,7 @@ var import_useValidatorBuilder = __toESM(require("./useValidatorBuilder"));
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   useRefFunction,
+  useRefValue,
   useValidator,
   useValidatorBuilder,
   useValidators

package/lib/hooks/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/hooks/index.ts"],
-  "sourcesContent": ["export { default as useRefFunction } from './useRefFunction';\n\nexport type { ValidatorRuleMap } from './useValidators';\nexport { default as useValidators } from './useValidators';\nexport { default as useValidator } from './useValidator';\nexport type { Validator, RuleRegExpFlags, ValidatorRule, BuilderOptions } from './useValidatorBuilder';\nexport { default as useValidatorBuilder } from './useValidatorBuilder';\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,4BAA0C;AAG1C,2BAAyC;AACzC,0BAAwC;AAExC,iCAA+C;",
+  "sourcesContent": ["export { default as useRefValue } from './useRefValue';\nexport { default as useRefFunction } from './useRefFunction';\n\nexport type { ValidatorRuleMap } from './useValidators';\nexport { default as useValidators } from './useValidators';\nexport { default as useValidator } from './useValidator';\nexport type { Validator, RuleRegExpFlags, ValidatorRule, BuilderOptions } from './useValidatorBuilder';\nexport { default as useValidatorBuilder } from './useValidatorBuilder';\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAAuC;AACvC,4BAA0C;AAG1C,2BAAyC;AACzC,0BAAwC;AAExC,iCAA+C;",
   "names": []
 }

package/lib/hooks/useRefValue.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="react" />
+/**
+ * **EN:** Get a mutable ref object and automatically update the value change
+ *
+ * **CN:** 获取一个可变的ref对象，并自动更新值变化
+ *
+ * @param value the wrapped value | 被包装的值
+ *
+ * @returns A mutable ref object, but the reference is immutable | 可变的ref对象，但引用不可变
+ */
+declare const useRefValue: <T>(value: T) => import("react").RefObject<T>;
+export default useRefValue;

package/lib/hooks/useRefValue.js

@@ -0,0 +1,32 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/hooks/useRefValue.ts
+var useRefValue_exports = {};
+__export(useRefValue_exports, {
+  default: () => useRefValue_default
+});
+module.exports = __toCommonJS(useRefValue_exports);
+var import_react = require("react");
+var useRefValue = (value) => {
+  const ref = (0, import_react.useRef)(value);
+  ref.current = value;
+  return ref;
+};
+var useRefValue_default = useRefValue;
+//# sourceMappingURL=useRefValue.js.map

package/lib/hooks/useRefValue.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/hooks/useRefValue.ts"],
+  "sourcesContent": ["import { useRef } from 'react';\n\n/**\n * **EN:** Get a mutable ref object and automatically update the value change\n *\n * **CN:** 获取一个可变的ref对象，并自动更新值变化\n *\n * @param value the wrapped value | 被包装的值\n *\n * @returns A mutable ref object, but the reference is immutable | 可变的ref对象，但引用不可变\n */\nconst useRefValue = <T>(value: T) => {\n  const ref = useRef<T>(value);\n  ref.current = value;\n  return ref;\n};\n\nexport default useRefValue;\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAuB;AAWvB,IAAM,cAAc,CAAI,UAAa;AACnC,QAAM,UAAM,qBAAU,KAAK;AAC3B,MAAI,UAAU;AACd,SAAO;AACT;AAEA,IAAO,sBAAQ;",
+  "names": []
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiny-codes/react-easy",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Helps you use React and AntDesign more easily",
   "keywords": [
     "react",