@vtx/components 4.0.0-beta.72 → 4.0.0-beta.74

package/README.md

@@ -1,19 +1,19 @@
-# @vtx/components
-
-> 公司 PC 端基础组件库
-
-## 安装
-
-```shell
-$ pnpm add @vtx/components -S
-```
-
-## 使用
-
-```js
-import { VtxDatePicker } from '@vtx/components';
-```
-
-## Doc
-
-[在线示例文档](http://front-end.pages.cloudhw.cn:8000/react-components/)
+# @vtx/components
+
+> 公司 PC 端基础组件库
+
+## 安装
+
+```shell
+$ pnpm add @vtx/components -S
+```
+
+## 使用
+
+```js
+import { VtxDatePicker } from '@vtx/components';
+```
+
+## Doc
+
+[在线示例文档](http://front-end.pages.cloudhw.cn:8000/react-components/)

package/es/utils/components/LabelIconTip/index.js

@@ -10,13 +10,13 @@ import classnames from 'classnames';
 import React, { useContext } from 'react';
 import { useStyle } from "./style";
 
-/**
- * 在 form 的 label 后面增加一个 tips 来展示一些说明文案
- * @param {Object} props
- * @param {React.ReactNode} props.label
- * @param {React.ReactNode} [props.subTitle]
- * @param {string|Object} [props.tooltip]
- * @param {boolean|Object} [props.ellipsis]
+/**
+ * 在 form 的 label 后面增加一个 tips 来展示一些说明文案
+ * @param {Object} props
+ * @param {React.ReactNode} props.label
+ * @param {React.ReactNode} [props.subTitle]
+ * @param {string|Object} [props.tooltip]
+ * @param {boolean|Object} [props.ellipsis]
  */
 import { Fragment as _Fragment } from "react/jsx-runtime";
 import { jsx as _jsx } from "react/jsx-runtime";

package/es/utils/conversionMomentValue/index.js

@@ -17,19 +17,19 @@ var dateFormatterMap = {
   dateTimeRange: 'YYYY-MM-DD HH:mm:ss'
 };
 
-/**
- * 判断是不是一个 object
- * @param  {any} o
- * @returns boolean
+/**
+ * 判断是不是一个 object
+ * @param  {any} o
+ * @returns boolean
  */
 function isObject(o) {
   return Object.prototype.toString.call(o) === '[object Object]';
 }
 
-/**
- * 判断是否是一个的简单的 object
- * @param  {{constructor:any}} o
- * @returns boolean
+/**
+ * 判断是否是一个的简单的 object
+ * @param  {{constructor:any}} o
+ * @returns boolean
  */
 export function isPlainObject(o) {
   if (isObject(o) === false) return false;
@@ -51,20 +51,20 @@ export function isPlainObject(o) {
   return true;
 }
 
-/**
- *  一个比较hack的moment判断工具
- * @param  {any} value
- * @returns boolean
+/**
+ *  一个比较hack的moment判断工具
+ * @param  {any} value
+ * @returns boolean
  */
 var isMoment = function isMoment(value) {
   return !!(value !== null && value !== void 0 && value._isAMomentObject);
 };
 
-/**
- * 根据不同的格式转化 dayjs
- * @param  {dayjs.Dayjs} value
- * @param  {string|((value:dayjs.Dayjs} dateFormatter
- * @param  {string} valueType
+/**
+ * 根据不同的格式转化 dayjs
+ * @param  {dayjs.Dayjs} value
+ * @param  {string|((value:dayjs.Dayjs} dateFormatter
+ * @param  {string} valueType
  */
 export var convertMoment = function convertMoment(value, dateFormatter, valueType) {
   if (!dateFormatter) {
@@ -87,14 +87,14 @@ export var convertMoment = function convertMoment(value, dateFormatter, valueTyp
   return value;
 };
 
-/**
- * 这里主要是来转化一下数据 将 dayjs 转化为 string 将 all 默认删除
- * @param  {T} value
- * @param  {DateFormatter} dateFormatter
- * @param  {Record<string} valueTypeMap
- * @param  {ProFieldValueType;dateFormat:string;}|any>} |{valueType
- * @param  {boolean} omitNil?
- * @param  {NamePath} parentKey?
+/**
+ * 这里主要是来转化一下数据 将 dayjs 转化为 string 将 all 默认删除
+ * @param  {T} value
+ * @param  {DateFormatter} dateFormatter
+ * @param  {Record<string} valueTypeMap
+ * @param  {ProFieldValueType;dateFormat:string;}|any>} |{valueType
+ * @param  {boolean} omitNil?
+ * @param  {NamePath} parentKey?
  */
 export var conversionMomentValue = function conversionMomentValue(value, dateFormatter, valueTypeMap, omitNil, parentKey) {
   var tmpValue = {};

package/es/utils/filterSpecialCharacters.js

@@ -55,12 +55,12 @@ export var SpecialCharacters = [
 '%', '％',
 // 其它
 '@', '#', '`', '~', '*', '^', '……', '|', '&'];
-/**
- * 过滤特殊字符
- * @param {String} value 值
- * @param {Object} option
- * @param {Array} [option.include] 新增
- * @param {Array} [option.exclude] 排除
+/**
+ * 过滤特殊字符
+ * @param {String} value 值
+ * @param {Object} option
+ * @param {Array} [option.include] 新增
+ * @param {Array} [option.exclude] 排除
  */
 export default function filterSpecialCharacters(value) {
   var _ref = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {},

package/es/utils/genCopyable/index.js

@@ -19,12 +19,12 @@ var getEllipsis = function getEllipsis(item) {
   return item.ellipsis;
 };
 
-/**
- * 生成 Copyable 或 Ellipsis 的 dom
- *
- * @param dom
- * @param item
- * @param text
+/**
+ * 生成 Copyable 或 Ellipsis 的 dom
+ *
+ * @param dom
+ * @param item
+ * @param text
  */
 export var genCopyable = function genCopyable(dom, item, text) {
   if (item.copyable || item.ellipsis) {

package/es/utils/getFieldPropsOrFormItemProps/index.js

@@ -1,12 +1,12 @@
 import { runFunction } from "../runFunction";
 
-/**
- * 因为 fieldProps 支持了 function 所以新增了这个方法
- *
- * @param {any} fieldProps
- * @param {any} [form]
- * @param {any} [extraProps]
- * @returns {Record<string, any> & { onChange: any, colSize: number }}
+/**
+ * 因为 fieldProps 支持了 function 所以新增了这个方法
+ *
+ * @param {any} fieldProps
+ * @param {any} [form]
+ * @param {any} [extraProps]
+ * @returns {Record<string, any> & { onChange: any, colSize: number }}
  */
 export var getFieldPropsOrFormItemProps = function getFieldPropsOrFormItemProps(fieldProps, form, extraProps) {
   if (form === undefined) {

package/es/utils/hooks/useDebounceFn/index.js

@@ -4,10 +4,10 @@ function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try
 function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
 import { useCallback, useEffect, useRef } from 'react';
 import { useRefFunction } from "../useRefFunction";
-/**
- * 一个去抖的 hook，传入一个 function，返回一个去抖后的 function
- * @param  {(...args:T) => Promise<any>} fn
- * @param  {number} wait?
+/**
+ * 一个去抖的 hook，传入一个 function，返回一个去抖后的 function
+ * @param  {(...args:T) => Promise<any>} fn
+ * @param  {number} wait?
  */
 export function useDebounceFn(fn, wait) {
   var callback = useRefFunction(fn);

package/es/utils/hooks/useDebounceValue/index.js

@@ -11,12 +11,12 @@ function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 import { useEffect, useState } from 'react';
 import { useLatest } from "../useLatest";
 
-/**
- * 一个去抖的setState，减少更新的频率
- * @param  {any} value
- * @param  {number} [delay=100]
- * @param  {any[]} deps
- * @returns {any}
+/**
+ * 一个去抖的setState，减少更新的频率
+ * @param  {any} value
+ * @param  {number} [delay=100]
+ * @param  {any[]} deps
+ * @returns {any}
  */
 export function useDebounceValue(value) {
   var delay = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 100;

package/es/utils/hooks/useDeepCompareMemo/index.js

@@ -1,13 +1,13 @@
 import React from 'react';
 import { useDeepCompareMemoize } from "../useDeepCompareEffect";
 
-/**
- * `useDeepCompareMemo` will only recompute the memoized value when one of the
- * `deps` has changed.
- *
- * Usage note: only use this if `deps` are objects or arrays that contain
- * objects. Otherwise you should just use React.useMemo.
- *
+/**
+ * `useDeepCompareMemo` will only recompute the memoized value when one of the
+ * `deps` has changed.
+ *
+ * Usage note: only use this if `deps` are objects or arrays that contain
+ * objects. Otherwise you should just use React.useMemo.
+ *
  */
 function useDeepCompareMemo(factory, dependencies) {
   return React.useMemo(factory, useDeepCompareMemoize(dependencies));

package/es/utils/hooks/useLatest/index.js

@@ -1,7 +1,7 @@
 import { useRef } from 'react';
 
-/**
- * @see https://github.com/streamich/react-use/blob/master/docs/useLatest.md
+/**
+ * @see https://github.com/streamich/react-use/blob/master/docs/useLatest.md
  */
 export var useLatest = function useLatest(value) {
   var ref = useRef(value);

package/es/utils/hooks/useRefCallback/index.js

@@ -1,10 +1,10 @@
 import { useMemo } from 'react';
 
-/**
- * useRefCallback
- * @param {Function} callback  ref.current 变化时触发
- * @param {any}      [initialValue]  初始值
- * @returns {Object} 代理后的 ref 对象
+/**
+ * useRefCallback
+ * @param {Function} callback  ref.current 变化时触发
+ * @param {any}      [initialValue]  初始值
+ * @returns {Object} 代理后的 ref 对象
  */
 export function useRefCallback(callback, initialValue) {
   var ref = useMemo(function () {

package/es/utils/isBrowser/index.js

@@ -1,12 +1,12 @@
 var isNode = typeof process !== 'undefined' && process.versions != null && process.versions.node != null;
 
-/**
- * 用于判断当前是否在浏览器环境中。
- * 首先会判断当前是否处于测试环境中（通过 process.env.NODE_ENV === 'TEST' 判断），
- * 如果是，则返回 true。否则，会进一步判断是否存在 window 对象、document 对象以及 matchMedia 方法
- * 同时通过 !isNode 判断当前不是在服务器（Node.js）环境下执行，
- * 如果都符合，则返回 true 表示当前处于浏览器环境中。
- * @returns  boolean
+/**
+ * 用于判断当前是否在浏览器环境中。
+ * 首先会判断当前是否处于测试环境中（通过 process.env.NODE_ENV === 'TEST' 判断），
+ * 如果是，则返回 true。否则，会进一步判断是否存在 window 对象、document 对象以及 matchMedia 方法
+ * 同时通过 !isNode 判断当前不是在服务器（Node.js）环境下执行，
+ * 如果都符合，则返回 true 表示当前处于浏览器环境中。
+ * @returns  boolean
  */
 export var isBrowser = function isBrowser() {
   if (typeof process !== 'undefined' && process.env.NODE_ENV === 'TEST') {

package/es/utils/isUrl/index.js

@@ -1,7 +1,7 @@
-/**
- * 判断是不是一个 url
- * @param  {string|undefined} path
- * @returns boolean
+/**
+ * 判断是不是一个 url
+ * @param  {string|undefined} path
+ * @returns boolean
  */
 export var isUrl = function isUrl(path) {
   if (!path) return false;

package/es/utils/merge/index.js

@@ -6,10 +6,10 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 /* eslint-disable prefer-rest-params */
 
-/**
- * 用于合并 n 个对象
- * @param  {any[]} ...rest
- * @returns T
+/**
+ * 用于合并 n 个对象
+ * @param  {any[]} ...rest
+ * @returns T
  */
 var merge = function merge() {
   var obj = {};

package/es/utils/nanoid/index.js

@@ -15,10 +15,10 @@ var genNanoid = function genNanoid() {
   return e;
 };
 
-/**
- * 生成uuid，如果不支持 randomUUID，就用 genNanoid
- *
- * @returns string
+/**
+ * 生成uuid，如果不支持 randomUUID，就用 genNanoid
+ *
+ * @returns string
  */
 export var nanoid = function nanoid() {
   if (typeof window === 'undefined') return genNanoid();

package/es/utils/omitBoolean/index.js

@@ -1,7 +1,7 @@
-/**
- * 剔除 boolean 值
- * @param  {boolean|T} obj
- * @returns T
+/**
+ * 剔除 boolean 值
+ * @param  {boolean|T} obj
+ * @returns T
  */
 export var omitBoolean = function omitBoolean(obj) {
   if (obj && obj !== true) {

package/es/utils/parseValueToMoment/index.js

@@ -3,10 +3,10 @@ import customParseFormat from 'dayjs/plugin/customParseFormat';
 import { isNil } from "../isNil";
 dayjs.extend(customParseFormat);
 
-/**
- * 一个比较hack的moment判断工具
- * @param value
- * @returns
+/**
+ * 一个比较hack的moment判断工具
+ * @param value
+ * @returns
  */
 var isMoment = function isMoment(value) {
   return !!(value !== null && value !== void 0 && value._isAMomentObject);

package/es/utils/proFieldParsingText/index.js

@@ -2,10 +2,10 @@ function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" ==
 import { Badge, Space } from 'antd';
 import React from 'react';
 
-/**
- * 获取类型的 type
- *
- * @param obj
+/**
+ * 获取类型的 type
+ *
+ * @param obj
  */
 import { jsx as _jsx } from "react/jsx-runtime";
 function getType(obj) {
@@ -103,12 +103,12 @@ var TableStatus = {
   }
 };
 
-/**
- * 转化 text 和 valueEnum 通过 type 来添加 Status
- *
- * @param text
- * @param valueEnum
- * @param pure 纯净模式，不增加 status
+/**
+ * 转化 text 和 valueEnum 通过 type 来添加 Status
+ *
+ * @param text
+ * @param valueEnum
+ * @param pure 纯净模式，不增加 status
  */
 export var proFieldParsingText = function proFieldParsingText(text, valueEnumParams, key) {
   if (Array.isArray(text)) {

package/es/utils/transformKeySubmitValue/index.js

@@ -10,12 +10,12 @@ import { get } from '@rc-component/util';
 import React from 'react';
 import { isNil } from "../isNil";
 
-/**
- * 判断一个值是否为普通对象（可以被遍历的对象）
- * 暂时还不支持 Set 和 Map 结构
- *
- * @param itemValue - 要检查的值
- * @returns 如果是普通对象返回 true，否则返回 false
+/**
+ * 判断一个值是否为普通对象（可以被遍历的对象）
+ * 暂时还不支持 Set 和 Map 结构
+ *
+ * @param itemValue - 要检查的值
+ * @returns 如果是普通对象返回 true，否则返回 false
  */
 export function isPlainObj(itemValue) {
   // 如果不是对象类型，直接返回 false
@@ -40,12 +40,12 @@ export function isPlainObj(itemValue) {
   return true;
 }
 
-/**
- * 将点号路径字符串转换为路径数组
- * 例如: 'users.0.name' => ['users', 0, 'name']
- *
- * @param dotPath - 点号分隔的路径字符串
- * @returns 路径数组，数字会被转换为数字类型
+/**
+ * 将点号路径字符串转换为路径数组
+ * 例如: 'users.0.name' => ['users', 0, 'name']
+ *
+ * @param dotPath - 点号分隔的路径字符串
+ * @returns 路径数组，数字会被转换为数字类型
  */
 function parseDotPath(dotPath) {
   return dotPath.split('.').map(function (segment) {
@@ -54,11 +54,11 @@ function parseDotPath(dotPath) {
   });
 }
 
-/**
- * 过滤掉空值的转换配置
- *
- * @param dataFormatMapRaw - 原始转换配置
- * @returns 过滤后的转换配置
+/**
+ * 过滤掉空值的转换配置
+ *
+ * @param dataFormatMapRaw - 原始转换配置
+ * @returns 过滤后的转换配置
  */
 function filterNilTransforms(dataFormatMapRaw) {
   var filtered = {};
@@ -71,11 +71,11 @@ function filterNilTransforms(dataFormatMapRaw) {
   return filtered;
 }
 
-/**
- * 将转换配置分为点号路径格式和传统嵌套对象格式
- *
- * @param dataFormatMapRaw - 原始转换配置
- * @returns 包含两种格式转换配置的对象
+/**
+ * 将转换配置分为点号路径格式和传统嵌套对象格式
+ *
+ * @param dataFormatMapRaw - 原始转换配置
+ * @returns 包含两种格式转换配置的对象
  */
 function separateTransformFormats(dataFormatMapRaw) {
   var dotPathTransforms = {};
@@ -95,12 +95,12 @@ function separateTransformFormats(dataFormatMapRaw) {
   };
 }
 
-/**
- * 处理点号路径格式的转换
- * 例如: 'users.0.name' => 转换 users[0].name 的值
- *
- * @param result - 要转换的数据对象
- * @param dotPathTransforms - 点号路径转换配置
+/**
+ * 处理点号路径格式的转换
+ * 例如: 'users.0.name' => 转换 users[0].name 的值
+ *
+ * @param result - 要转换的数据对象
+ * @param dotPathTransforms - 点号路径转换配置
  */
 function processDotPathTransforms(result, dotPathTransforms) {
   for (var dotPath in dotPathTransforms) {
@@ -143,13 +143,13 @@ function processDotPathTransforms(result, dotPathTransforms) {
   }
 }
 
-/**
- * 在嵌套转换配置中查找转换函数
- *
- * @param currentTransforms - 当前转换配置
- * @param parentsKey - 父级路径
- * @param entityKey - 当前实体键
- * @returns 找到的转换函数或 undefined
+/**
+ * 在嵌套转换配置中查找转换函数
+ *
+ * @param currentTransforms - 当前转换配置
+ * @param parentsKey - 父级路径
+ * @param entityKey - 当前实体键
+ * @returns 找到的转换函数或 undefined
  */
 function findNestedTransformFunction(currentTransforms, parentsKey, entityKey) {
   var nestedTransforms = currentTransforms;
@@ -177,11 +177,11 @@ function findNestedTransformFunction(currentTransforms, parentsKey, entityKey) {
   return undefined;
 }
 
-/**
- * 检查路径是否包含数组索引
- *
- * @param parentsKey - 父级路径数组
- * @returns 如果包含数组索引返回 true
+/**
+ * 检查路径是否包含数组索引
+ *
+ * @param parentsKey - 父级路径数组
+ * @returns 如果包含数组索引返回 true
  */
 function isInArrayPath(parentsKey) {
   return parentsKey.some(function (key) {
@@ -189,14 +189,14 @@ function isInArrayPath(parentsKey) {
   });
 }
 
-/**
- * 递归处理嵌套对象转换（传统格式）
- *
- * @param tempValues - 要处理的值
- * @param parentsKey - 父级路径
- * @param currentTransforms - 当前转换配置
- * @param rootMergeObjects - 存储需要在根级别合并的对象
- * @returns 处理后的结果
+/**
+ * 递归处理嵌套对象转换（传统格式）
+ *
+ * @param tempValues - 要处理的值
+ * @param parentsKey - 父级路径
+ * @param currentTransforms - 当前转换配置
+ * @param rootMergeObjects - 存储需要在根级别合并的对象
+ * @returns 处理后的结果
  */
 function processNestedObjectTransforms(tempValues, parentsKey, currentTransforms, rootMergeObjects) {
   var isArrayValues = Array.isArray(tempValues);
@@ -271,15 +271,15 @@ function processNestedObjectTransforms(tempValues, parentsKey, currentTransforms
   return tempResult;
 }
 
-/**
- * 转换提交值中的键名
- * 支持两种格式的转换配置：
- * 1. 点号路径格式：'users.0.name' => 转换嵌套路径的值
- * 2. 传统嵌套对象格式：{ users: { 0: { name: transformFn } } }
- *
- * @param values - 要转换的值对象
- * @param dataFormatMapRaw - 转换配置映射
- * @returns 转换后的值对象
+/**
+ * 转换提交值中的键名
+ * 支持两种格式的转换配置：
+ * 1. 点号路径格式：'users.0.name' => 转换嵌套路径的值
+ * 2. 传统嵌套对象格式：{ users: { 0: { name: transformFn } } }
+ *
+ * @param values - 要转换的值对象
+ * @param dataFormatMapRaw - 转换配置映射
+ * @returns 转换后的值对象
  */
 export var transformKeySubmitValue = function transformKeySubmitValue(values, dataFormatMapRaw) {
   // 过滤掉空值的转换配置