docs: optimize api docs (#6813)

* docs: optimize graph options docs

* docs: add element options docs

* docs: optimize element options docs

* docs: upload layout/plugin/transform docs

* docs: add behavior docs

* docs: 侧边栏更新

* fix: comment

* fix: update

Author: yvonneyx

packages/site/.dumirc.ts

@@ -59,14 +59,14 @@ export default defineConfig({
     },
     navs: [
       {
-        slug: 'docs/manual/introduction',
+        slug: 'docs/manual',
         title: {
           zh: '文档',
           en: 'Docs',
         },
       },
       {
-        slug: 'docs/api/graph/option',
+        slug: 'docs/api',
         title: {
           zh: 'API',
           en: 'API',
@@ -159,13 +159,15 @@ export default defineConfig({
           zh: 'Graph - 图',
           en: 'Graph',
         },
+        order: 1,
       },
       {
         slug: 'api/elements',
         title: {
           zh: 'Element - 元素',
           en: 'Element',
         },
+        order: 2,
       },
       {
         slug: 'api/elements/nodes',
@@ -194,41 +196,31 @@ export default defineConfig({
           zh: 'Layout - 布局',
           en: 'Layout',
         },
+        order: 3,
       },
       {
         slug: 'api/behaviors',
         title: {
           zh: 'Behavior - 交互',
           en: 'Behavior',
         },
+        order: 4,
       },
       {
         slug: 'api/plugins',
         title: {
           zh: 'Plugin - 插件',
           en: 'Plugin',
         },
+        order: 5,
       },
       {
         slug: 'api/transforms',
         title: {
           zh: 'Transform - 数据处理',
           en: 'Transform',
         },
-      },
-      {
-        slug: 'api/extension',
-        title: {
-          zh: 'Extension - 扩展',
-          en: 'Extension',
-        },
-      },
-      {
-        slug: 'api/reference',
-        title: {
-          zh: 'Export - 导出',
-          en: 'Export',
-        },
+        order: 6,
       },
     ],
     examples: [

packages/site/docs/api/behaviors/AutoAdaptLabel.en.md

@@ -0,0 +1,99 @@
+---
+title: AutoAdaptLabel
+---
+
+## Options
+
+### <Badge type="success">Required</Badge> type
+
+> _`auto-adapt-label`_
+
+Behavior type
+
+### enable
+
+> _boolean \| ((event:_ _IGraphLifeCycleEvent \| IAnimateEvent \| IElementLifeCycleEvent \| IViewportEvent \| IPointerEvent \| IWheelEvent \| IKeyboardEvent \| IDragEvent) => boolean)_ **Default:** ``
+
+Whether to enable
+
+### padding
+
+> _number \| number[]_ **Default:** `0`
+
+Set the padding of the label to determine whether the label overlaps to avoid the label being displayed too densely
+
+### sort
+
+> _(elementA:_ _NodeData \| EdgeData \| ComboData, elementB:_ _NodeData \| EdgeData \| ComboData) => -1 \| 0 \| 1_
+
+Sort elements by their importance in descending order; elements with higher importance have higher label display priority; usually combo > node > edge
+
+### sortCombo
+
+> _(comboA:_ [ComboData](/api/graph/option#combodata)_, comboB:_ [ComboData](/api/graph/option#combodata)_) => -1 \| 0 \| 1_
+
+Sort combos by importance in descending order; combos with higher importance have higher label display priority. By default, they are sorted according to the data. It should be noted that if `sort` is set, `sortCombo` will not take effect
+
+### sortEdge
+
+> _(edgeA:_ [EdgeData](/api/graph/option#edgedata)_, edgeB:_ [EdgeData](/api/graph/option#edgedata)_) => -1 \| 0 \| 1_
+
+Sort edges by importance in descending order; edges with higher importance have higher label display priority. By default, they are sorted according to the data. It should be noted that if `sort` is set, `sortEdge` will not take effect
+
+### sortNode
+
+Sort nodes by importance in descending order; nodes with higher importance have higher label display priority. Several centrality algorithms are built in, and custom sorting functions can also be defined. It should be noted that if `sort` is set, `sortNode` will not take effect
+
+### throttle
+
+> _number_ **Default:** `32`
+
+Throttle time
+
+## API
+
+### AutoAdaptLabel.destroy()
+
+```typescript
+destroy(): void;
+```
+
+### AutoAdaptLabel.update(options)
+
+```typescript
+update(options: Partial<AutoAdaptLabelOptions>): void;
+```
+
+<details><summary>View Parameters</summary>
+
+<table><thead><tr><th>
+
+Parameter
+
+</th><th>
+
+Type
+
+</th><th>
+
+Description
+
+</th></tr></thead>
+<tbody><tr><td>
+
+options
+
+</td><td>
+
+Partial&lt;[AutoAdaptLabelOptions](#options)>
+
+</td><td>
+
+</td></tr>
+</tbody></table>
+
+**Returns**:
+
+- **Type:** void
+
+</details>

packages/site/docs/api/behaviors/AutoAdaptLabel.zh.md

@@ -0,0 +1,86 @@
+---
+title: AutoAdaptLabel 标签自适应显示
+---
+
+> 如需深入了解交互的使用，请参阅 [API 文档 - 图配置项 - behaviors](/api/graph/option#behaviors) 章节。此章节将介绍完整的配置参数、类型定义以及应用示例。
+
+标签自适应显示是一种动态标签管理策略，旨在根据当前可视范围的空间分配、节点重要性等因素，智能调整哪些标签应显示或隐藏。通过对可视区域的实时分析，确保用户在不同的交互场景下获得最相关最清晰的信息展示，同时避免视觉过载和信息冗余。
+
+## 配置项
+
+### <Badge type="success">Required</Badge> type
+
+> _`auto-adapt-label` \| string_
+
+此插件已内置，你可以通过 `type: 'auto-adapt-label'` 来使用它。
+
+### enable
+
+> _boolean \| ((event:_ _IGraphLifeCycleEvent \| IAnimateEvent \| IElementLifeCycleEvent \| IViewportEvent \| IPointerEvent \| IWheelEvent \| IKeyboardEvent \| IDragEvent) => boolean)_ **Default:** ``
+
+是否启用
+
+### padding
+
+> _number \| number[]_ **Default:** `0`
+
+设置标签的内边距，用于判断标签是否重叠，以避免标签显示过于密集
+
+### sort
+
+> _(elementA:_ _NodeData \| EdgeData \| ComboData, elementB:_ _NodeData \| EdgeData \| ComboData) => -1 \| 0 \| 1_
+
+根据元素的重要性从高到低排序，重要性越高的元素其标签显示优先级越高。一般情况下 combo > node > edge
+
+### sortCombo
+
+> _(comboA:_ [ComboData](/api/graph/option#combodata)_, comboB:_ [ComboData](/api/graph/option#combodata)_) => -1 \| 0 \| 1_
+
+根据群组的重要性从高到低排序，重要性越高的群组其标签显示优先级越高。默认按照数据先后进行排序。需要注意，如果设置了 `sort`，则 `sortCombo` 不会生效
+
+### sortEdge
+
+> _(edgeA:_ [EdgeData](/api/graph/option#edgedata)_, edgeB:_ [EdgeData](/api/graph/option#edgedata)_) => -1 \| 0 \| 1_
+
+根据边的重要性从高到低排序，重要性越高的边其标签显示优先级越高。默认按照数据先后进行排序。需要注意，如果设置了 `sort`，则 `sortEdge` 不会生效
+
+### sortNode
+
+> _[NodeCentralityOptions](#nodecentralityoptions) \| ((nodeA: [NodeData](/api/graph/option#nodedata), nodeB: [NodeData](/api/graph/option#nodedata)) => -1 \| 0 \| 1)_ **Default:** `type: 'degree'`
+
+根据节点的重要性从高到低排序，重要性越高的节点其标签显示优先级越高。内置几种中心性算法，也可以自定义排序函数。需要注意，如果设置了 `sort`，则 `sortNode` 不会生效
+
+#### NodeCentralityOptions
+
+```typescript
+type NodeCentralityOptions =
+  | { type: 'degree'; direction?: 'in' | 'out' | 'both' }
+  | { type: 'betweenness'; directed?: boolean; weightPropertyName?: string }
+  | { type: 'closeness'; directed?: boolean; weightPropertyName?: string }
+  | { type: 'eigenvector'; directed?: boolean }
+  | { type: 'pagerank'; epsilon?: number; linkProb?: number };
+```
+
+### throttle
+
+> _number_ **Default:** `32`
+
+节流时间
+
+## API
+
+### AutoAdaptLabel.destroy()
+
+```typescript
+destroy(): void;
+```
+
+### AutoAdaptLabel.update(options)
+
+```typescript
+update(options: Partial<AutoAdaptLabelOptions>): void;
+```
+
+| 参数    | 类型                                      | 描述   | 默认值 | 必选 |
+| ------- | ----------------------------------------- | ------ | ------ | ---- |
+| options | Partial<[AutoAdaptLabelOptions](#配置项)> | 配置项 | -      | ✓    |

packages/site/docs/api/behaviors/BrushSelect.en.md

@@ -0,0 +1,92 @@
+---
+title: BrushSelect
+---
+
+<embed src="@/common/api/behaviors/brush-select.md"></embed>
+
+## Options
+
+### key
+
+> _string_
+
+Behavior key, that is, the unique identifier
+
+Used to identify the behavior for further operations
+
+```typescript
+// Update behavior options
+graph.updateBehavior({key: 'key', ...});
+```
+
+### <Badge type="success">Required</Badge> type
+
+> _string_
+
+Behavior type
+
+### animation
+
+> _boolean_ **Default:** `false`
+
+Whether to enable animation.
+
+### enable
+
+> _boolean \| ((event:_ [Event](/manual/graph-api/event#事件对象属性)_) => boolean)_ **Default:** `true`
+
+Whether to enable Brush select element function.
+
+### enableElements
+
+> _'node' \| 'edge' \| 'combo'\_\_[]_ **Default:** `['node', 'combo', 'edge']`
+
+Enable Elements type.
+
+### immediately
+
+> _boolean_ **Default:** `false`
+
+Whether to brush select immediately, only valid when the brush select mode is `default`
+
+### mode
+
+> _'union' \| 'intersect' \| 'diff' \| 'default'_ **Default:** `'default'`
+
+Brush select mode
+
+- `'union'`: Keep the current state of the selected elements and add the specified state.
+
+- `'intersect'`: If the selected elements already have the specified state, keep it; otherwise, clearBrush it.
+
+- `'diff'`: Perform a negation operation on the specified state of the selected elements.
+
+- `'default'`: Clear the current state of the selected elements and add the specified state.
+
+### onSelect
+
+> _(states:_ _Record**&lt;**string\_\_,_ _string_ _\|_ _string\_\_[]>) =>_ _Record**&lt;**string\_\_,_ _string_ _\|_ _string\_\_[]>_
+
+Callback when brush select elements.
+
+### state
+
+> _string_ **Default:** `'selected'`
+
+The state to switch to when selected.
+
+### style
+
+> _RectStyleProps_
+
+Timely screening.
+
+### trigger
+
+> _string[]_ **Default:** `['shift']`
+
+Press this shortcut key to apply brush select with mouse click.
+
+Note that setting `trigger` to `['drag']` will cause the `drag-canvas` behavior to fail. The two cannot be configured at the same time.
+
+## API