docs: update arrayTrace

Author: axolo

docs/arrayTrace.md

@@ -1,13 +1,91 @@
-# arrayTrace
-
-trace source of id from array
-
-## 调用
+# 数组溯源
 
 ```js
 arrayTrace(array, id, [options])
 ```
 
+根据主键的值从数组中溯源，返回从根到自身溯源的顺序数组。
+
+## 参数
+
+|   参数    |   类型   | 默认 |                        说明                         |
+| --------- | -------- | ---- | --------------------------------------------------- |
+| `array`   | `array`  |      | [列表结构数据](./param.md#array)                    |
+| `id`      | `any`    |      | [主键](./param.md#id)的值，如：`chartIndexActiveMy` |
+| `options` | `object` |      | [配置选项](./param.md#options)                      |
+
 ## 返回
 
-array
+| 参数 |  类型   |           说明           |
+| ---- | ------- | ------------------------ |
+| *    | `array` | 从根到自身溯源的顺序数组 |
+
+## 示例
+
+::: code-group
+```js [调用]
+import { arrayTrace } from '@axolo/tree-array'
+
+const array = [{
+  id: 'chart',
+  path: '/chart',
+  parentId: null
+}, {
+  id: 'chartIndex',
+  path: '/chart/index',
+  parentId: 'chart'
+}, {
+  id: 'chartIndexActive',
+  path: '/chart/index/active',
+  parentId: 'chartIndex'
+}, {
+  id: 'chartIndexActiveMy',
+  path: '/chart/index/active/my',
+  parentId: 'chartIndexActive'
+}, {
+  id: 'chartReview',
+  path: '/chart/review',
+  parentId: 'chart'
+}, {
+  id: 'chartProject',
+  path: '/chart/project',
+  parentId: 'chart'
+}, {
+  id: 'smile',
+  path: '/smile',
+  parentId: null
+}, {
+  id: 'smileIndex',
+  path: '/smile/index',
+  parentId: 'smile',
+  test: true
+}]
+
+arrayTrace(array, 'chartIndexActiveMy')
+```
+
+```json [返回]
+[
+  {
+    "id": "chart",
+    "path": "/chart",
+    "parentId": null
+  },
+  {
+    "id": "chartIndex",
+    "path": "/chart/index",
+    "parentId": "chart"
+  },
+  {
+    "id": "chartIndexActive",
+    "path": "/chart/index/active",
+    "parentId": "chartIndex"
+  },
+  {
+    "id": "chartIndexActiveMy",
+    "path": "/chart/index/active/my",
+    "parentId": "chartIndexActive"
+  }
+]
+```
+:::

docs/randomId.md

@@ -4,7 +4,7 @@
 randomId(prefix = '')
 ```
 
-生成一个由小写字母和数字组成的自定义前缀（`prefix`）的随机字符串，如：`i_fang05da21`。
+生成一个由小写字母和数字组成的自定义前缀（`prefix`）的随机字符串，如：`i_9fang05da21`。
 
 ::: danger 碰撞几率
 基于`Math.random()`生成，碰撞几率取决于`Math.random()`的随机性，可能不适用于大数据场景。
@@ -18,20 +18,20 @@ randomId(prefix = '')
 
 ## 返回
 
-| 参数 |   类型   |              说明              |
-| ---- | -------- | ------------------------------ |
-|  *   | `string` | 随机字符串，如：`i_fang05da21` |
+| 参数 |   类型   |              说明               |
+| ---- | -------- | ------------------------------- |
+| *    | `string` | 随机字符串，如：`i_9fang05da21` |
 
 ## 示例
 
 ::: code-group
 ```js [调用]
 import { randomId } from '@axolo/tree-array'
 
-randomId('i_') // i_fang05da21
+randomId('i_') // i_9fang05da21
 ```
 
 ```text [返回]
-i_fang05da21
+i_9fang05da21
 ```
 :::

src/test/array.json

@@ -29,6 +29,6 @@
 }, {
   "id": "smileIndex",
   "path": "/smile/index",
-  "test": true,
-  "parentId": "smile"
+  "parentId": "smile",
+  "test": true
 }]