From 40da9069239c52e4a7309d92f7d13fd9822ea80d Mon Sep 17 00:00:00 2001
From: liaoxuezhi <2698393+2betop@users.noreply.github.com>
Date: Mon, 2 Dec 2024 13:50:39 +0800
Subject: [PATCH] bump: 6.10.0

---
 lerna.json                             |  2 +-
 packages/amis-core/package.json        |  6 ++--
 packages/amis-editor-core/package.json |  4 +--
 packages/amis-editor/package.json      |  6 ++--
 packages/amis-formula/package.json     |  2 +-
 packages/amis-formula/src/doc.md       | 46 ++++++++++++++++---------
 packages/amis-formula/src/doc.ts       | 47 +++++++++++++-------------
 packages/amis-ui/package.json          |  8 ++---
 packages/amis/package.json             |  8 ++---
 9 files changed, 72 insertions(+), 57 deletions(-)

diff --git a/lerna.json b/lerna.json
index 8e16361c150..a96dfa884d5 100644
--- a/lerna.json
+++ b/lerna.json
@@ -8,5 +8,5 @@
     "packages/amis-editor"
   ],
   "useWorkspaces": false,
-  "version": "6.9.0"
+  "version": "6.10.0"
 }
diff --git a/packages/amis-core/package.json b/packages/amis-core/package.json
index 858b6826800..492ce53d06d 100644
--- a/packages/amis-core/package.json
+++ b/packages/amis-core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "amis-core",
-  "version": "6.9.0",
+  "version": "6.10.0",
   "description": "amis-core",
   "main": "lib/index.js",
   "module": "esm/index.js",
@@ -49,9 +49,9 @@
   ],
   "dependencies": {
     "@rc-component/mini-decimal": "^1.0.1",
-    "cross-env": "^7.0.3",
-    "amis-formula": "*",
+    "amis-formula": "^6.10.0",
     "classnames": "2.3.2",
+    "cross-env": "^7.0.3",
     "file-saver": "^2.0.2",
     "hoist-non-react-statics": "^3.3.2",
     "lodash": "^4.17.15",
diff --git a/packages/amis-editor-core/package.json b/packages/amis-editor-core/package.json
index 76c297242e8..90c5a514dd5 100644
--- a/packages/amis-editor-core/package.json
+++ b/packages/amis-editor-core/package.json
@@ -1,6 +1,6 @@
 {
   "name": "amis-editor-core",
-  "version": "6.9.0",
+  "version": "6.10.0",
   "description": "amis 可视化编辑器",
   "main": "lib/index.js",
   "module": "esm/index.js",
@@ -60,7 +60,6 @@
     "sortablejs": "^1.14.0"
   },
   "devDependencies": {
-    "cross-env": "^7.0.3",
     "@fortawesome/fontawesome-free": "^6.1.1",
     "@rollup/plugin-commonjs": "^22.0.0",
     "@rollup/plugin-json": "^4.1.0",
@@ -84,6 +83,7 @@
     "ajv": "^8.8.2",
     "autoprefixer": "^10.4.12",
     "concurrently": "^6.2.0",
+    "cross-env": "^7.0.3",
     "css-loader": "^6.2.0",
     "faker": "^5.5.3",
     "i18n-command": "^0.0.23-beta.15",
diff --git a/packages/amis-editor/package.json b/packages/amis-editor/package.json
index 2f13f60c53c..4d24a86148f 100644
--- a/packages/amis-editor/package.json
+++ b/packages/amis-editor/package.json
@@ -1,6 +1,6 @@
 {
   "name": "amis-editor",
-  "version": "6.9.0",
+  "version": "6.10.0",
   "description": "amis 可视化编辑器",
   "main": "lib/index.js",
   "module": "esm/index.js",
@@ -41,7 +41,7 @@
   ],
   "dependencies": {
     "@webcomponents/webcomponentsjs": "^2.6.0",
-    "amis-editor-core": "^6.9.0",
+    "amis-editor-core": "^6.10.0",
     "amis-postcss": "1.0.0",
     "amis-theme-editor-helper": "*",
     "i18n-runtime": "*",
@@ -49,7 +49,6 @@
     "mobx-state-tree": "^3.17.3"
   },
   "devDependencies": {
-    "cross-env": "^7.0.3",
     "@fortawesome/fontawesome-free": "^6.1.1",
     "@rollup/plugin-commonjs": "^22.0.0",
     "@rollup/plugin-json": "^4.1.0",
@@ -73,6 +72,7 @@
     "ajv": "^8.8.2",
     "axios": "0.21.1",
     "concurrently": "^6.2.0",
+    "cross-env": "^7.0.3",
     "css-loader": "^6.2.0",
     "faker": "^5.5.3",
     "i18n-command": "^0.0.23-beta.15",
diff --git a/packages/amis-formula/package.json b/packages/amis-formula/package.json
index d5eb6342029..7606a93b06d 100644
--- a/packages/amis-formula/package.json
+++ b/packages/amis-formula/package.json
@@ -1,6 +1,6 @@
 {
   "name": "amis-formula",
-  "version": "6.9.0",
+  "version": "6.10.0",
   "description": "负责 amis 里面的表达式实现，内置公式，编辑器等",
   "main": "lib/index.js",
   "module": "esm/index.js",
diff --git a/packages/amis-formula/src/doc.md b/packages/amis-formula/src/doc.md
index ea51e564c58..9937f5081fd 100644
--- a/packages/amis-formula/src/doc.md
+++ b/packages/amis-formula/src/doc.md
@@ -89,7 +89,7 @@
 
 ### MAX
 
-用法：`MAX(num1, num2, ...numN)`
+用法：`MAX(num1, num2, ...numN) or MAX([num1, num2, ...numN])`
 
  * `num:...number` 数值
 
@@ -99,7 +99,7 @@
 
 ### MIN
 
-用法：`MIN(num1, num2, ...numN)`
+用法：`MIN(num1, num2, ...numN) or MIN([num1, num2, ...numN])`
 
  * `num:...number` 数值
 
@@ -109,7 +109,7 @@
 
 ### SUM
 
-用法：`SUM(num1, num2, ...numN)`
+用法：`SUM(num1, num2, ...numN) or SUM([num1, num2, ...numN])`
 
  * `num:...number` 数值
 
@@ -189,7 +189,7 @@
 
 ### AVG
 
-用法：`AVG(num1, num2, ...numN)`
+用法：`AVG(num1, num2, ...numN) or AVG([num1, num2, ...numN])`
 
  * `num:...number` 要处理的数字
 
@@ -515,7 +515,7 @@
  * `text:string` 文本
  * `startString:string` 起始文本
 
-返回：`string` 判断结果
+返回：`boolean` 判断结果
 
 判断字符串(text)是否以特定字符串(startString)开始，是则返回 true，否则返回 false。
 
@@ -526,7 +526,7 @@
  * `text:string` 文本
  * `endString:string` 结束文本
 
-返回：`string` 判断结果
+返回：`boolean` 判断结果
 
 判断字符串(text)是否以特定字符串(endString)结束，是则返回 true，否则返回 false。
 
@@ -537,7 +537,7 @@
  * `text:string` 文本
  * `searchText:string` 搜索文本
 
-返回：`string` 判断结果
+返回：`boolean` 判断结果
 
 判断参数 1 中的文本是否包含参数 2 中的文本，是则返回 true，否则返回 false。
 
@@ -573,10 +573,14 @@
  * `from:number` 起始位置
  * `len:number` 处理长度
 
-返回：`number` 命中的位置
+返回：`string` 命中的位置
 
 返回文本字符串中从指定位置开始的特定数目的字符。
 
+示例：`MID("amis.baidu.com", 6, 3)`，
+
+返回 `aid`。
+
 ### BASENAME
 
 用法：`BASENAME(text)`
@@ -589,7 +593,7 @@
 
 示例：`/home/amis/a.json`，
 
-返回：a.json`。
+返回：`a.json`。
 
 ### UUID
 
@@ -714,7 +718,7 @@ DATERANGESPLIT('1676563200, 1676735999', 'end' , 'YYYY.MM.DD hh:mm:ss') 得到 '
  * `unit:string` 比如可以传入 'day'、'month'、'year' 或者 `week` 等等
  * `format:string` 日期格式，可选
 
-返回：`date` 新的日期对象
+返回：`any` 新的日期对象, 如果传入 format 则返回格式化后的日期字符串
 
 返回日期的指定范围的开端。
 
@@ -726,7 +730,7 @@ DATERANGESPLIT('1676563200, 1676735999', 'end' , 'YYYY.MM.DD hh:mm:ss') 得到 '
  * `unit:string` 比如可以传入 'day'、'month'、'year' 或者 `week` 等等
  * `format:string` 日期格式，可选
 
-返回：`date` 新的日期对象
+返回：`any` 新的日期对象, 如果传入 format 则返回格式化后的日期字符串
 
 返回日期的指定范围的末尾。
 
@@ -936,7 +940,7 @@ DATEMODIFY(A, -2, 'month')，
 
  * `arr:Array<any>` 数组
 
-返回：`boolean` 结果
+返回：`number` 结果
 
 返回数组的长度。
 
@@ -947,10 +951,16 @@ DATEMODIFY(A, -2, 'month')，
  * `arr:Array<any>` 数组
  * `iterator:Array<any>` 箭头函数
 
-返回：`boolean` 结果
+返回：`Array<any>` 返回转换后的数组
 
 数组做数据转换，需要搭配箭头函数一起使用，注意箭头函数只支持单表达式用法。
 
+将数组中的每个元素转换成箭头函数返回的值。
+
+示例：
+
+ARRAYMAP([1, 2, 3], item => item + 1) 得到 [2, 3, 4]。
+
 ### ARRAYFILTER
 
 用法：`ARRAYFILTER(arr, item => item)`
@@ -958,11 +968,15 @@ DATEMODIFY(A, -2, 'month')，
  * `arr:Array<any>` 数组
  * `iterator:Array<any>` 箭头函数
 
-返回：`boolean` 结果
+返回：`Array<any>` 返回过滤后的数组
 
 数据做数据过滤，需要搭配箭头函数一起使用，注意箭头函数只支持单表达式用法。
 将第二个箭头函数返回为 false 的成员过滤掉。
 
+示例：
+
+ARRAYFILTER([1, 2, 3], item => item > 1) 得到 [2, 3]。
+
 ### ARRAYFINDINDEX
 
 用法：`ARRAYFINDINDEX(arr, item => item === 2)`
@@ -1063,7 +1077,7 @@ COMPACT([0, 1, false, 2, '', 3]) 得到 [1, 2, 3]。
  * `arr:Array<any>` 数组
  * `separator:String` 分隔符
 
-返回：`String` 结果
+返回：`string` 结果
 
 数组转成字符串。
 
@@ -1098,7 +1112,7 @@ CONCAT(['a', 'b', 'c'], ['1'], ['3']) 得到 ['a', 'b', 'c', '1', '3']。
 
 示例：
 
-UNIQ([{a: '1'}, {b: '2'}, {a: '1'}]， 'id')。
+UNIQ([{a: '1'}, {b: '2'}, {a: '1'}]) 得到 [{a: '1'}, {b: '2'}]。
 
 ## 编码
 
diff --git a/packages/amis-formula/src/doc.ts b/packages/amis-formula/src/doc.ts
index 218a24ab98c..3e2ec9939fe 100644
--- a/packages/amis-formula/src/doc.ts
+++ b/packages/amis-formula/src/doc.ts
@@ -134,7 +134,7 @@ bulkRegisterFunctionDoc([
   {
     name: 'MAX',
     description: '获取最大值，如果只有一个参数且是数组，则计算这个数组内的值。',
-    example: 'MAX(num1, num2, ...numN)',
+    example: 'MAX(num1, num2, ...numN) or MAX([num1, num2, ...numN])',
     params: [
       {
         type: '...number',
@@ -151,7 +151,7 @@ bulkRegisterFunctionDoc([
   {
     name: 'MIN',
     description: '获取最小值，如果只有一个参数且是数组，则计算这个数组内的值。',
-    example: 'MIN(num1, num2, ...numN)',
+    example: 'MIN(num1, num2, ...numN) or MIN([num1, num2, ...numN])',
     params: [
       {
         type: '...number',
@@ -168,7 +168,7 @@ bulkRegisterFunctionDoc([
   {
     name: 'SUM',
     description: '求和，如果只有一个参数且是数组，则计算这个数组内的值。',
-    example: 'SUM(num1, num2, ...numN)',
+    example: 'SUM(num1, num2, ...numN) or SUM([num1, num2, ...numN])',
     params: [
       {
         type: '...number',
@@ -319,7 +319,7 @@ bulkRegisterFunctionDoc([
     name: 'AVG',
     description:
       '返回所有参数的平均值，如果只有一个参数且是数组，则计算这个数组内的值。',
-    example: 'AVG(num1, num2, ...numN)',
+    example: 'AVG(num1, num2, ...numN) or AVG([num1, num2, ...numN])',
     params: [
       {
         type: '...number',
@@ -861,7 +861,7 @@ bulkRegisterFunctionDoc([
       }
     ],
     returns: {
-      type: 'string',
+      type: 'boolean',
       description: '判断结果'
     },
     namespace: '文本函数'
@@ -884,7 +884,7 @@ bulkRegisterFunctionDoc([
       }
     ],
     returns: {
-      type: 'string',
+      type: 'boolean',
       description: '判断结果'
     },
     namespace: '文本函数'
@@ -907,7 +907,7 @@ bulkRegisterFunctionDoc([
       }
     ],
     returns: {
-      type: 'string',
+      type: 'boolean',
       description: '判断结果'
     },
     namespace: '文本函数'
@@ -968,7 +968,8 @@ bulkRegisterFunctionDoc([
   },
   {
     name: 'MID',
-    description: '返回文本字符串中从指定位置开始的特定数目的字符。',
+    description:
+      '返回文本字符串中从指定位置开始的特定数目的字符。\n\n示例：`MID("amis.baidu.com", 6, 3)`，\n\n返回 `aid`。',
     example: 'MID(text, from, len)',
     params: [
       {
@@ -988,7 +989,7 @@ bulkRegisterFunctionDoc([
       }
     ],
     returns: {
-      type: 'number',
+      type: 'string',
       description: '命中的位置'
     },
     namespace: '文本函数'
@@ -996,7 +997,7 @@ bulkRegisterFunctionDoc([
   {
     name: 'BASENAME',
     description:
-      '返回路径中的文件名。\n\n示例：`/home/amis/a.json`，\n\n返回：a.json`。',
+      '返回路径中的文件名。\n\n示例：`/home/amis/a.json`，\n\n返回：`a.json`。',
     example: 'BASENAME(text)',
     params: [
       {
@@ -1210,8 +1211,8 @@ bulkRegisterFunctionDoc([
       }
     ],
     returns: {
-      type: 'date',
-      description: '新的日期对象'
+      type: 'any',
+      description: '新的日期对象, 如果传入 format 则返回格式化后的日期字符串'
     },
     namespace: '日期函数'
   },
@@ -1237,8 +1238,8 @@ bulkRegisterFunctionDoc([
       }
     ],
     returns: {
-      type: 'date',
-      description: '新的日期对象'
+      type: 'any',
+      description: '新的日期对象, 如果传入 format 则返回格式化后的日期字符串'
     },
     namespace: '日期函数'
   },
@@ -1641,7 +1642,7 @@ bulkRegisterFunctionDoc([
       }
     ],
     returns: {
-      type: 'boolean',
+      type: 'number',
       description: '结果'
     },
     namespace: '数组'
@@ -1649,7 +1650,7 @@ bulkRegisterFunctionDoc([
   {
     name: 'ARRAYMAP',
     description:
-      '数组做数据转换，需要搭配箭头函数一起使用，注意箭头函数只支持单表达式用法。',
+      '数组做数据转换，需要搭配箭头函数一起使用，注意箭头函数只支持单表达式用法。\n\n将数组中的每个元素转换成箭头函数返回的值。\n\n示例：\n\nARRAYMAP([1, 2, 3], item => item + 1) 得到 [2, 3, 4]。',
     example: 'ARRAYMAP(arr, item => item)',
     params: [
       {
@@ -1664,15 +1665,15 @@ bulkRegisterFunctionDoc([
       }
     ],
     returns: {
-      type: 'boolean',
-      description: '结果'
+      type: 'Array<any>',
+      description: '返回转换后的数组'
     },
     namespace: '数组'
   },
   {
     name: 'ARRAYFILTER',
     description:
-      '数据做数据过滤，需要搭配箭头函数一起使用，注意箭头函数只支持单表达式用法。\n将第二个箭头函数返回为 false 的成员过滤掉。',
+      '数据做数据过滤，需要搭配箭头函数一起使用，注意箭头函数只支持单表达式用法。\n将第二个箭头函数返回为 false 的成员过滤掉。\n\n示例：\n\nARRAYFILTER([1, 2, 3], item => item > 1) 得到 [2, 3]。',
     example: 'ARRAYFILTER(arr, item => item)',
     params: [
       {
@@ -1687,8 +1688,8 @@ bulkRegisterFunctionDoc([
       }
     ],
     returns: {
-      type: 'boolean',
-      description: '结果'
+      type: 'Array<any>',
+      description: '返回过滤后的数组'
     },
     namespace: '数组'
   },
@@ -1843,7 +1844,7 @@ bulkRegisterFunctionDoc([
       }
     ],
     returns: {
-      type: 'String',
+      type: 'string',
       description: '结果'
     },
     namespace: '数组'
@@ -1869,7 +1870,7 @@ bulkRegisterFunctionDoc([
   {
     name: 'UNIQ',
     description:
-      "数组去重，第二个参数「field」，可指定根据该字段去重。\n\n示例：\n\nUNIQ([{a: '1'}, {b: '2'}, {a: '1'}]， 'id')。",
+      "数组去重，第二个参数「field」，可指定根据该字段去重。\n\n示例：\n\nUNIQ([{a: '1'}, {b: '2'}, {a: '1'}]) 得到 [{a: '1'}, {b: '2'}]。",
     example: "UNIQ([{a: '1'}, {b: '2'}, {a: '1'}], 'x')",
     params: [
       {
diff --git a/packages/amis-ui/package.json b/packages/amis-ui/package.json
index 88678fe8a84..8b45780ceca 100644
--- a/packages/amis-ui/package.json
+++ b/packages/amis-ui/package.json
@@ -3,7 +3,7 @@
   "main": "lib/index.js",
   "module": "esm/index.js",
   "types": "lib/index.d.ts",
-  "version": "6.9.0",
+  "version": "6.10.0",
   "description": "",
   "scripts": {
     "build": "npm run clean-dist && cross-env NODE_ENV=production rollup -c ",
@@ -36,8 +36,8 @@
   },
   "dependencies": {
     "@rc-component/mini-decimal": "^1.0.1",
-    "amis-core": "^6.9.0",
-    "amis-formula": "^6.9.0",
+    "amis-core": "^6.10.0",
+    "amis-formula": "^6.10.0",
     "animate.css": "4.1.1",
     "classnames": "2.3.2",
     "codemirror": "^5.63.0",
@@ -77,7 +77,6 @@
     "uncontrollable": "7.2.1"
   },
   "devDependencies": {
-    "cross-env": "^7.0.3",
     "@rollup/plugin-commonjs": "^22.0.2",
     "@rollup/plugin-json": "^4.1.0",
     "@rollup/plugin-node-resolve": "^14.1.0",
@@ -89,6 +88,7 @@
     "@types/react": "^18.0.24",
     "@types/react-dom": "^18.0.8",
     "autoprefixer": "^10.4.12",
+    "cross-env": "^7.0.3",
     "jest": "^29.0.3",
     "jest-environment-jsdom": "^29.0.3",
     "moment-timezone": "^0.5.34",
diff --git a/packages/amis/package.json b/packages/amis/package.json
index 574c871dd04..41e0fe0d85f 100644
--- a/packages/amis/package.json
+++ b/packages/amis/package.json
@@ -1,6 +1,6 @@
 {
   "name": "amis",
-  "version": "6.9.0",
+  "version": "6.10.0",
   "description": "一种MIS页面生成工具",
   "main": "lib/index.js",
   "module": "esm/index.js",
@@ -37,8 +37,8 @@
     }
   ],
   "dependencies": {
-    "amis-core": "^6.9.0",
-    "amis-ui": "^6.9.0",
+    "amis-core": "^6.10.0",
+    "amis-ui": "^6.10.0",
     "attr-accept": "2.2.2",
     "blueimp-canvastoblob": "2.1.0",
     "classnames": "2.3.2",
@@ -76,7 +76,6 @@
     "xlsx": "^0.18.5"
   },
   "devDependencies": {
-    "cross-env": "^7.0.3",
     "@fortawesome/fontawesome-free": "^6.1.1",
     "@rollup/plugin-commonjs": "^22.0.2",
     "@rollup/plugin-json": "^4.1.0",
@@ -116,6 +115,7 @@
     "concurrently": "^7.3.0",
     "copy-to-clipboard": "3.3.1",
     "core-js": "^3.21.0",
+    "cross-env": "^7.0.3",
     "css": "3.0.0",
     "fs-walk": "0.0.2",
     "glob": "^7.2.0",