rxtutils 1.1.3 → 1.1.4-beta.2

package/cjs/hooks/index.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+var useCombineControlValue = require('./useCombineControlValue.cjs');
+
+
+
+exports.useCombineControlValue = useCombineControlValue.useCombineControlValue;

package/cjs/hooks/index.d.ts

@@ -0,0 +1 @@
+export { useCombineControlValue } from './useCombineControlValue.js';

package/cjs/hooks/useCombineControlValue.cjs

@@ -0,0 +1,32 @@
+'use strict';
+
+var react = require('react');
+
+/**
+ * @param param props 组件属性
+ * @param param valueKey 组件值的key，默认value, undefined 被认为是有值，只有当 key 不存在时，转换为非受控模式
+ * @param param defaultValue 默认值
+ * @param param onChange 值改变时的回调
+ * @returns value: 组件应该采用的值，onChange：值改变时的回调，处理非受控值与向父组件传递值的逻辑
+ */
+var useCombineControlValue = function (_a) {
+    var props = _a.props, _b = _a.valueKey, valueKey = _b === void 0 ? 'value' : _b, defaultValue = _a.defaultValue, onChange = _a.onChange;
+    var _c = props, _d = valueKey, value = _c[_d];
+    var hasValue = props.hasOwnProperty(valueKey);
+    var _e = react.useState(value !== null && value !== void 0 ? value : defaultValue), internalValue = _e[0], setInternalValue = _e[1];
+    var handleChange = react.useCallback(function (nextVal) {
+        setInternalValue(nextVal);
+        onChange === null || onChange === void 0 ? void 0 : onChange(nextVal);
+    }, [onChange]);
+    var finalValue = react.useMemo(function () {
+        if (hasValue)
+            return value;
+        return internalValue;
+    }, [hasValue, internalValue, value]);
+    return {
+        value: finalValue,
+        onChange: handleChange
+    };
+};
+
+exports.useCombineControlValue = useCombineControlValue;

package/cjs/hooks/useCombineControlValue.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @param param props 组件属性
+ * @param param valueKey 组件值的key，默认value, undefined 被认为是有值，只有当 key 不存在时，转换为非受控模式
+ * @param param defaultValue 默认值
+ * @param param onChange 值改变时的回调
+ * @returns value: 组件应该采用的值，onChange：值改变时的回调，处理非受控值与向父组件传递值的逻辑
+ */
+declare const useCombineControlValue: <V>({ props, valueKey, defaultValue, onChange }: {
+    props: Record<string, any>;
+    valueKey?: string;
+    defaultValue?: V;
+    onChange?: (val: V) => void;
+}) => {
+    value: any;
+    onChange: (nextVal: V) => void;
+};
+
+export { useCombineControlValue };

package/cjs/index.cjs

@@ -6,6 +6,7 @@ var index$3 = require('./store/createGetter/index.cjs');
 var index$2 = require('./store/createStateStore/index.cjs');
 var validator = require('./validator/validator.cjs');
 var decorators = require('./validator/decorators.cjs');
+var useCombineControlValue = require('./hooks/useCombineControlValue.cjs');
 
 
 
@@ -26,3 +27,4 @@ exports.VNumber = decorators.VNumber;
 exports.VPattern = decorators.VPattern;
 exports.VRequired = decorators.VRequired;
 exports.VString = decorators.VString;
+exports.useCombineControlValue = useCombineControlValue.useCombineControlValue;

package/cjs/index.d.ts

@@ -4,4 +4,5 @@ export { createStoreGetter, createStoreGetterMemo } from './store/createGetter/i
 export { IHookStateInitAction, IHookStateInitialSetter, IHookStateResolvable, IHookStateSetAction, IHookStateSetter, default as createStateStore } from './store/createStateStore/index.js';
 export { BaseValidator } from './validator/validator.js';
 export { VArray, VBoolean, VEmail, VMax, VMaxLength, VMin, VMinLength, VNumber, VPattern, VRequired, VString } from './validator/decorators.js';
+export { useCombineControlValue } from './hooks/useCombineControlValue.js';
 export { default as RequestError, RequestErrorType } from './request/error.js';

package/es/hooks/index.d.ts

@@ -0,0 +1 @@
+export { useCombineControlValue } from './useCombineControlValue.js';

package/es/hooks/index.mjs

@@ -0,0 +1 @@
+export { useCombineControlValue } from './useCombineControlValue.mjs';

package/es/hooks/useCombineControlValue.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @param param props 组件属性
+ * @param param valueKey 组件值的key，默认value, undefined 被认为是有值，只有当 key 不存在时，转换为非受控模式
+ * @param param defaultValue 默认值
+ * @param param onChange 值改变时的回调
+ * @returns value: 组件应该采用的值，onChange：值改变时的回调，处理非受控值与向父组件传递值的逻辑
+ */
+declare const useCombineControlValue: <V>({ props, valueKey, defaultValue, onChange }: {
+    props: Record<string, any>;
+    valueKey?: string;
+    defaultValue?: V;
+    onChange?: (val: V) => void;
+}) => {
+    value: any;
+    onChange: (nextVal: V) => void;
+};
+
+export { useCombineControlValue };

package/es/hooks/useCombineControlValue.mjs

@@ -0,0 +1,30 @@
+import { useState, useCallback, useMemo } from 'react';
+
+/**
+ * @param param props 组件属性
+ * @param param valueKey 组件值的key，默认value, undefined 被认为是有值，只有当 key 不存在时，转换为非受控模式
+ * @param param defaultValue 默认值
+ * @param param onChange 值改变时的回调
+ * @returns value: 组件应该采用的值，onChange：值改变时的回调，处理非受控值与向父组件传递值的逻辑
+ */
+var useCombineControlValue = function (_a) {
+    var props = _a.props, _b = _a.valueKey, valueKey = _b === void 0 ? 'value' : _b, defaultValue = _a.defaultValue, onChange = _a.onChange;
+    var _c = props, _d = valueKey, value = _c[_d];
+    var hasValue = props.hasOwnProperty(valueKey);
+    var _e = useState(value !== null && value !== void 0 ? value : defaultValue), internalValue = _e[0], setInternalValue = _e[1];
+    var handleChange = useCallback(function (nextVal) {
+        setInternalValue(nextVal);
+        onChange === null || onChange === void 0 ? void 0 : onChange(nextVal);
+    }, [onChange]);
+    var finalValue = useMemo(function () {
+        if (hasValue)
+            return value;
+        return internalValue;
+    }, [hasValue, internalValue, value]);
+    return {
+        value: finalValue,
+        onChange: handleChange
+    };
+};
+
+export { useCombineControlValue };

package/es/index.d.ts

@@ -4,4 +4,5 @@ export { createStoreGetter, createStoreGetterMemo } from './store/createGetter/i
 export { IHookStateInitAction, IHookStateInitialSetter, IHookStateResolvable, IHookStateSetAction, IHookStateSetter, default as createStateStore } from './store/createStateStore/index.js';
 export { BaseValidator } from './validator/validator.js';
 export { VArray, VBoolean, VEmail, VMax, VMaxLength, VMin, VMinLength, VNumber, VPattern, VRequired, VString } from './validator/decorators.js';
+export { useCombineControlValue } from './hooks/useCombineControlValue.js';
 export { default as RequestError, RequestErrorType } from './request/error.js';

package/es/index.mjs

@@ -4,3 +4,4 @@ export { createStoreGetter, createStoreGetterMemo } from './store/createGetter/i
 export { default as createStateStore } from './store/createStateStore/index.mjs';
 export { BaseValidator } from './validator/validator.mjs';
 export { VArray, VBoolean, VEmail, VMax, VMaxLength, VMin, VMinLength, VNumber, VPattern, VRequired, VString } from './validator/decorators.mjs';
+export { useCombineControlValue } from './hooks/useCombineControlValue.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rxtutils",
-  "version": "1.1.3",
+  "version": "1.1.4-beta.2",
   "type": "module",
   "main": "cjs/index.cjs",
   "module": "es/index.mjs",