Merge remote-tracking branch 'origin' into rylan/fix/select/search

Author: RylanBot

package.json

@@ -82,7 +82,7 @@
     "@types/testing-library__jest-dom": "5.14.2",
     "@typescript-eslint/eslint-plugin": "^5.13.0",
     "@typescript-eslint/parser": "^5.13.0",
-    "@vitejs/plugin-react": "^4.3.1",
+    "@vitejs/plugin-react": "^5.1.1",
     "@vitest/coverage-istanbul": "^2.1.1",
     "@vitest/coverage-v8": "^2.1.1",
     "@vitest/ui": "^3.1.1",

packages/common

@@ -35,29 +35,6 @@ export function firstUpperCase(str: string): string {
   return str.toLowerCase().replace(/( |^)[a-z]/g, (char: string) => char.toUpperCase());
 }
 
-export type Gradients = { [percent: string]: string };
-export type FromTo = { from: string; to: string };
-export type LinearGradient = { direction?: string } & (Gradients | FromTo);
-export function getBackgroundColor(color: string | string[] | LinearGradient): string {
-  if (typeof color === 'string') {
-    return color;
-  }
-  if (Array.isArray(color)) {
-    if (color[0] && color[0][0] === '#') {
-      color.unshift('90deg');
-    }
-    return `linear-gradient( ${color.join(',')} )`;
-  }
-  const { from, to, direction = 'to right', ...rest } = color;
-  let keys = Object.keys(rest);
-  if (keys.length) {
-    keys = keys.sort((a, b) => parseFloat(a.substr(0, a.length - 1)) - parseFloat(b.substr(0, b.length - 1)));
-    const tempArr = keys.map((key: any) => `${rest[key]} ${key}`);
-    return `linear-gradient(${direction}, ${tempArr.join(',')})`;
-  }
-  return `linear-gradient(${direction}, ${from}, ${to})`;
-}
-
 // keyboard-event => onKeyboardEvent
 export function getPropsApiByEvent(eventName: string) {
   return camelCase(`on-${eventName}`);

packages/components/_util/helper.ts

@@ -1,28 +1,21 @@
-/**
- ** 加法函数，用来得到精确的加法结果
- ** 说明：javascript 的加法结果会有误差，在两个浮点数相加的时候会比较明显。这个函数返回较为精确的加法结果。
- ** 调用：accAdd(num1,num2)
- ** 返回值：num1 加上num2 的精确结果
- * */
-export function accAdd(num1: number, num2: number) {
-  const isFloat = (n: number) => typeof n === 'number' && !Number.isInteger(n);
-
-  if (isFloat(num1) && isFloat(num2)) {
-    const [integer1, precision1] = String(num1).split('.');
-    const [integer2, precision2] = String(num2).split('.');
+export const numberToPercent = (number: number) => `${number * 100}%`;
 
-    // 获取两个浮点数的最长精度
-    const maxPrecisionLen = Math.max(precision1.length, precision2.length);
-    // 对齐小数部分的精度长度
-    const wholePrecision1 = Number(precision1.padEnd(maxPrecisionLen, '0'));
-    const wholePrecision2 = Number(precision2.padEnd(maxPrecisionLen, '0'));
+/**
+ * 精确加法函数，避免 JavaScript 浮点误差
+ * - 浮点运算会导致类似 0.1 + 0.2 = 0.30000000000000004 的问题
+ * - 该函数通过将数字放大为整数进行运算，再缩小回原精度，得到更精确的结果
+ */
+export function accAdd(num1: number, num2: number): number {
+  // 获取每个数字的小数位长度
+  const precision1 = (num1.toString().split('.')[1] || '').length;
+  const precision2 = (num2.toString().split('.')[1] || '').length;
 
-    // 小数部分转化成整数相加之后除以精度最长的 10 的倍数
-    const precisionVal = (wholePrecision1 + wholePrecision2) / 10 ** maxPrecisionLen;
-    const integerVal = Number(integer1) + Number(integer2);
+  // 取两者中较大的小数位长度，用于计算放大倍数
+  const scale = 10 ** Math.max(precision1, precision2);
 
-    return integerVal + precisionVal;
-  }
+  // 将小数放大为整数
+  const sum = Math.round(num1 * scale) + Math.round(num2 * scale);
 
-  return num1 + num2;
+  // 缩放回原精度，得到最终结果
+  return sum / scale;
 }

packages/components/_util/linearGradient.ts

@@ -5,12 +5,12 @@
 
 name | type | default | description | required
 -- | -- | -- | -- | --
-className | String | - | 类名 | N
-style | Object | - | 样式，Typescript：`React.CSSProperties` | N
-children | TNode | - | Typescript：`string \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
-container | String / Function | () => (() => window) | Typescript：`ScrollContainer`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
-content | TNode | - | Typescript：`string \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
+className | String | - | className of component | N
+style | Object | - | CSS(Cascading Style Sheets)，Typescript: `React.CSSProperties` | N
+children | TNode | - | Typescript: `string \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
+container | String / Function | () => (() => window) | Typescript: `ScrollContainer`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
+content | TNode | - | Typescript: `string \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
 offsetBottom | Number | 0 | When the distance from the bottom of the container reaches the specified distance, the trigger is fixed | N
 offsetTop | Number | 0 | When the distance from the top of the container reaches the specified distance, the trigger is fixed | N
 zIndex | Number | - | \- | N
-onFixedChange | Function |  | Typescript：`(affixed: boolean, context: { top: number }) => void`<br/> | N
+onFixedChange | Function |  | Typescript: `(affixed: boolean, context: { top: number }) => void`<br/> | N

packages/components/_util/number.ts

@@ -3,7 +3,7 @@
 ## API
 ### Affix Props
 
-名称 | 类型 | 默认值 | 说明 | 必传
+名称 | 类型 | 默认值 | 描述 | 必传
 -- | -- | -- | -- | --
 className | String | - | 类名 | N
 style | Object | - | 样式，TS 类型：`React.CSSProperties` | N

packages/components/affix/affix.en-US.md

@@ -7,14 +7,14 @@
 name | type | default | description | required
 -- | -- | -- | -- | --
 className | String | - | className of component | N
-style | Object | - | CSS(Cascading Style Sheets)，Typescript：`React.CSSProperties` | N
-close | TNode | false | Deprecated, use closeBtn instead. Typescript：`string \| boolean \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
-closeBtn | TNode | false | Close button. Value "true" show the close button. Value "False" hide close button. Value type string display as is. Use TNode to custom the close trigger. Typescript：`string \| boolean \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
-icon | TElement | - | Typescript：`TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
+style | Object | - | CSS(Cascading Style Sheets)，Typescript: `React.CSSProperties` | N
+close | TNode | false | Deprecated, use closeBtn instead. Typescript: `string \| boolean \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
+closeBtn | TNode | false | Close button. Value "true" show the close button. Value "False" hide close button. Value type string display as is. Use TNode to custom the close trigger. Typescript: `string \| boolean \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
+icon | TElement | - | Typescript: `TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
 maxLine | Number | 0 | \- | N
-message | TNode | - | Typescript：`string \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
-operation | TElement | - | Typescript：`TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
+message | TNode | - | Typescript: `string \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
+operation | TElement | - | Typescript: `TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
 theme | String | info | options: success/info/warning/error | N
-title | TNode | - | Typescript：`string \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
-onClose | Function |  | Typescript：`(context: { e: MouseEvent }) => void`<br/> | N
-onClosed | Function |  | Typescript：`(context: { e: TransitionEvent }) => void`<br/> | N
+title | TNode | - | Typescript: `string \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
+onClose | Function |  | Typescript: `(context: { e: MouseEvent }) => void`<br/> | N
+onClosed | Function |  | Typescript: `(context: { e: TransitionEvent }) => void`<br/> | N

packages/components/affix/affix.md

@@ -5,33 +5,33 @@
 
 name | type | default | description | required
 -- | -- | -- | -- | --
-className | String | - | 类名 | N
-style | Object | - | 样式，Typescript：`React.CSSProperties` | N
-affixProps | Object | - | Typescript：`Omit<AffixProps, 'children'>`，[Affix API Documents](./affix?tab=api)。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/anchor/type.ts) | N
+className | String | - | className of component | N
+style | Object | - | CSS(Cascading Style Sheets)，Typescript: `React.CSSProperties` | N
+affixProps | Object | - | Typescript: `Omit<AffixProps, 'children'>`，[Affix API Documents](./affix?tab=api)。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/anchor/type.ts) | N
 bounds | Number | 5 | \- | N
-container | String / Function | () => window | Typescript：`ScrollContainer`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
-cursor | TElement | - | Typescript：`TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
-getCurrentAnchor | Function | - | Custom Highlighted Anchor Points。Typescript：`(activeLink: string) => string` | N
-size | String | medium | options: small/medium/large。Typescript：`SizeEnum`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
+container | String / Function | () => window | Typescript: `ScrollContainer`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
+cursor | TElement | - | Typescript: `TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
+getCurrentAnchor | Function | - | Custom Highlighted Anchor Points。Typescript: `(activeLink: string) => string` | N
+size | String | medium | options: small/medium/large。Typescript: `SizeEnum`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
 targetOffset | Number | 0 | \- | N
-onChange | Function |  | Typescript：`(currentLink: string, prevLink: string) => void`<br/> | N
-onClick | Function |  | Typescript：`(link: { href: string; title: string; e: MouseEvent }) => void`<br/> | N
+onChange | Function |  | Typescript: `(currentLink: string, prevLink: string) => void`<br/> | N
+onClick | Function |  | Typescript: `(link: { href: string; title: string; e: MouseEvent }) => void`<br/> | N
 
 ### AnchorItem Props
 
 name | type | default | description | required
 -- | -- | -- | -- | --
-className | String | - | 类名 | N
-style | Object | - | 样式，Typescript：`React.CSSProperties` | N
+className | String | - | className of component | N
+style | Object | - | CSS(Cascading Style Sheets)，Typescript: `React.CSSProperties` | N
 href | String | - | required | Y
 target | String | _self | options: _self/_blank/_parent/_top | N
-title | TNode | '' | Typescript：`string \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
+title | TNode | '' | Typescript: `string \| TNode`。[see more ts definition](https://github.com/Tencent/tdesign-react/blob/develop/packages/components/common.ts) | N
 
 ### AnchorTarget Props
 
 name | type | default | description | required
 -- | -- | -- | -- | --
-className | String | - | 类名 | N
-style | Object | - | 样式，Typescript：`React.CSSProperties` | N
+className | String | - | className of component | N
+style | Object | - | CSS(Cascading Style Sheets)，Typescript: `React.CSSProperties` | N
 id | String | - | required | Y
 tag | String | div | \- | N

packages/components/alert/alert.en-US.md

@@ -3,7 +3,7 @@
 ## API
 ### Anchor Props
 
-名称 | 类型 | 默认值 | 说明 | 必传
+名称 | 类型 | 默认值 | 描述 | 必传
 -- | -- | -- | -- | --
 className | String | - | 类名 | N
 style | Object | - | 样式，TS 类型：`React.CSSProperties` | N
@@ -19,7 +19,7 @@ onClick | Function |  | TS 类型：`(link: { href: string; title: string; e: Mo
 
 ### AnchorItem Props
 
-名称 | 类型 | 默认值 | 说明 | 必传
+名称 | 类型 | 默认值 | 描述 | 必传
 -- | -- | -- | -- | --
 className | String | - | 类名 | N
 style | Object | - | 样式，TS 类型：`React.CSSProperties` | N
@@ -29,7 +29,7 @@ title | TNode | '' | 锚点文本。TS 类型：`string \| TNode`。[通用类
 
 ### AnchorTarget Props
 
-名称 | 类型 | 默认值 | 说明 | 必传
+名称 | 类型 | 默认值 | 描述 | 必传
 -- | -- | -- | -- | --
 className | String | - | 类名 | N
 style | Object | - | 样式，TS 类型：`React.CSSProperties` | N