ep-craft 0.1.41 → 0.2.0

package/dist-ai/components/table-v2.json

@@ -0,0 +1,486 @@
+{
+  "entry": {
+    "category": "data",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpTableV2 } from 'ep-craft'\n\nconst columns = [\n  { key: 'id', title: 'ID', width: 80 },\n  { key: 'name', title: '姓名', width: 160 },\n  { key: 'role', title: '角色', width: 160 },\n]\nconst data = Array.from({ length: 100 }, (_, index) => ({\n  id: index + 1,\n  name: `用户 ${index + 1}`,\n  role: '成员',\n}))\n</script>\n\n<template>\n  <ep-table-v2 :columns=\"columns\" :data=\"data\" :height=\"300\" />\n</template>",
+        "id": "table-v2-1",
+        "language": "vue",
+        "title": "虚拟化表格"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "滚动到指定位置",
+        "name": "scrollTo",
+        "type": "(params: { scrollLeft?: number; scrollTop?: number }) => void"
+      },
+      {
+        "description": "横向滚动到指定位置",
+        "name": "scrollToLeft",
+        "type": "(scrollLeft: number) => void"
+      },
+      {
+        "description": "纵向滚动到指定位置",
+        "name": "scrollToTop",
+        "type": "(scrollTop: number) => void"
+      },
+      {
+        "description": "滚动到指定行",
+        "name": "scrollToRow",
+        "type": "(row: number, strategy?: ScrollStrategy) => void"
+      }
+    ],
+    "hot": false,
+    "id": "component:table-v2",
+    "keywords": {
+      "en": [
+        "table-v2",
+        "table",
+        "v2",
+        "virtual",
+        "grid",
+        "data"
+      ],
+      "zh": [
+        "虚拟化表格",
+        "数据"
+      ]
+    },
+    "kind": "component",
+    "name": "EpTableV2",
+    "nonUseCases": [
+      "数据量极小且无需结构化展示时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "虚拟滚动缓存数量",
+        "hasDefault": true,
+        "name": "cache",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "估算行高，用于虚拟滚动",
+        "hasDefault": true,
+        "name": "estimatedRowHeight",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "id",
+        "description": "行数据唯一标识的字段名",
+        "hasDefault": true,
+        "name": "rowKey",
+        "required": false,
+        "type": "string | number | symbol"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "表头类名或返回类名的函数",
+        "hasDefault": false,
+        "name": "headerClass",
+        "required": false,
+        "type": "string | Function"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "表头属性或返回属性的函数",
+        "hasDefault": false,
+        "name": "headerProps",
+        "required": false,
+        "type": "object | Function"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "表头单元格属性或返回属性的函数",
+        "hasDefault": false,
+        "name": "headerCellProps",
+        "required": false,
+        "type": "object | Function"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "表头高度",
+        "hasDefault": true,
+        "name": "headerHeight",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "底部高度",
+        "hasDefault": true,
+        "name": "footerHeight",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "行类名或返回类名的函数",
+        "hasDefault": false,
+        "name": "rowClass",
+        "required": false,
+        "type": "string | Function"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "行属性或返回属性的函数",
+        "hasDefault": false,
+        "name": "rowProps",
+        "required": false,
+        "type": "object | Function"
+      },
+      {
+        "alias": null,
+        "defaultText": "50",
+        "description": "行高",
+        "hasDefault": true,
+        "name": "rowHeight",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "单元格属性或返回属性的函数",
+        "hasDefault": false,
+        "name": "cellProps",
+        "required": false,
+        "type": "object | Function"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "列配置（必填）",
+        "hasDefault": false,
+        "name": "columns",
+        "required": true,
+        "type": "Column[]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "数据源（必填）",
+        "hasDefault": false,
+        "name": "data",
+        "required": true,
+        "type": "any[]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "自定义数据获取器",
+        "hasDefault": false,
+        "name": "dataGetter",
+        "required": false,
+        "type": "DataGetter"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "固定列的数据",
+        "hasDefault": false,
+        "name": "fixedData",
+        "required": false,
+        "type": "any[]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "展开列的 key",
+        "hasDefault": false,
+        "name": "expandColumnKey",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "[]",
+        "description": "展开行的 key 数组",
+        "hasDefault": true,
+        "name": "expandedRowKeys",
+        "required": false,
+        "type": "KeyType[]"
+      },
+      {
+        "alias": null,
+        "defaultText": "[]",
+        "description": "默认展开行的 key 数组",
+        "hasDefault": true,
+        "name": "defaultExpandedRowKeys",
+        "required": false,
+        "type": "KeyType[]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "表格类名",
+        "hasDefault": false,
+        "name": "class",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否固定表格",
+        "hasDefault": false,
+        "name": "fixed",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "表格样式",
+        "hasDefault": false,
+        "name": "style",
+        "required": false,
+        "type": "CSSProperties"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "表格宽度（必填）",
+        "hasDefault": false,
+        "name": "width",
+        "required": true,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "表格高度（必填）",
+        "hasDefault": false,
+        "name": "height",
+        "required": true,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "表格最大高度",
+        "hasDefault": false,
+        "name": "maxHeight",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否使用 isScrolling 状态",
+        "hasDefault": false,
+        "name": "useIsScrolling",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "12",
+        "description": "树形数据缩进，单位 px",
+        "hasDefault": true,
+        "name": "indentSize",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "12",
+        "description": "图标尺寸，单位 px",
+        "hasDefault": true,
+        "name": "iconSize",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "横向滚动条尺寸",
+        "hasDefault": true,
+        "name": "hScrollbarSize",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "纵向滚动条尺寸",
+        "hasDefault": true,
+        "name": "vScrollbarSize",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "是否始终显示滚动条",
+        "hasDefault": false,
+        "name": "scrollbarAlwaysOn",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "{}",
+        "description": "排序配置",
+        "hasDefault": true,
+        "name": "sortBy",
+        "required": false,
+        "type": "{ key: KeyType; order: SortOrder }"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "排序状态",
+        "hasDefault": true,
+        "name": "sortState",
+        "required": false,
+        "type": "SortState"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "列排序时触发",
+        "hasDefault": false,
+        "name": "onColumnSort",
+        "required": false,
+        "type": "(params: ColumnSortParams) => void"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "展开行变化时触发",
+        "hasDefault": false,
+        "name": "onExpandedRowsChange",
+        "required": false,
+        "type": "(keys: KeyType[]) => void"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "滚动到底部时触发",
+        "hasDefault": false,
+        "name": "onEndReached",
+        "required": false,
+        "type": "(remainDistance: number) => void"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "行展开/收起时触发",
+        "hasDefault": false,
+        "name": "onRowExpand",
+        "required": false,
+        "type": "(params: { expanded: boolean; rowData: any; rowIndex: number }) => void"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "滚动时触发",
+        "hasDefault": false,
+        "name": "onScroll",
+        "required": false,
+        "type": "(params: { x: number; y: number }) => void"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "行渲染完成时触发",
+        "hasDefault": false,
+        "name": "onRowsRendered",
+        "required": false,
+        "type": "(params: { start: number; end: number }) => void"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "行事件处理器",
+        "hasDefault": false,
+        "name": "rowEventHandlers",
+        "required": false,
+        "type": "TableV2RowEventHandlers"
+      }
+    ],
+    "related": [
+      "EpTable",
+      "EpTableColumn"
+    ],
+    "relations": {
+      "children": [
+        "EpTableColumn"
+      ],
+      "combos": [
+        "EpTableV2 + EpTableColumn"
+      ],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义单元格内容，参数为 `{ columns, column, columnIndex, rowData, rowIndex }`",
+        "name": "cell"
+      },
+      {
+        "description": "自定义表头内容",
+        "name": "header"
+      },
+      {
+        "description": "自定义行内容",
+        "name": "row"
+      },
+      {
+        "description": "自定义底部内容",
+        "name": "footer"
+      },
+      {
+        "description": "无数据时的内容",
+        "name": "empty"
+      },
+      {
+        "description": "覆盖层内容",
+        "name": "overlay"
+      }
+    ],
+    "slug": "table-v2",
+    "summary": "虚拟化表格，结构化数据展示",
+    "tag": "ep-table-v2",
+    "useCases": [
+      "展示虚拟化表格类结构化数据",
+      "需要浏览、比较或定位数据时"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-border-color-lighter",
+        "--el-bg-color",
+        "--el-text-color-regular",
+        "--el-font-size-base"
+      ],
+      "density": "紧凑",
+      "shape": "块级数据区域",
+      "slotContent": [
+        "cell：自定义单元格内容，参数为 `{ columns, column, columnIndex, rowData, rowIndex }`",
+        "header：自定义表头内容",
+        "row：自定义行内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/table-v2.md

@@ -0,0 +1,123 @@
+# EpTableV2
+
+`ep-table-v2` · data（数据展示） · `component:table-v2`
+
+## 摘要
+
+虚拟化表格，结构化数据展示
+
+## 适用场景
+
+- 适用：展示虚拟化表格类结构化数据
+- 适用：需要浏览、比较或定位数据时
+- 不适用：数据量极小且无需结构化展示时
+
+## 关键词
+
+- 中文：虚拟化表格、数据
+- English: table-v2, table, v2, virtual, grid, data
+
+## Props
+
+- cache (number，默认 见文档)：虚拟滚动缓存数量
+- estimatedRowHeight (number，默认 见文档)：估算行高，用于虚拟滚动
+- rowKey (string | number | symbol，默认 id)：行数据唯一标识的字段名
+- headerClass (string | Function)：表头类名或返回类名的函数
+- headerProps (object | Function)：表头属性或返回属性的函数
+- headerCellProps (object | Function)：表头单元格属性或返回属性的函数
+- headerHeight (number，默认 见文档)：表头高度
+- footerHeight (number，默认 0)：底部高度
+- rowClass (string | Function)：行类名或返回类名的函数
+- rowProps (object | Function)：行属性或返回属性的函数
+- rowHeight (number，默认 50)：行高
+- cellProps (object | Function)：单元格属性或返回属性的函数
+- columns (Column[]，必填)：列配置（必填）
+- data (any[]，必填)：数据源（必填）
+- dataGetter (DataGetter)：自定义数据获取器
+- fixedData (any[])：固定列的数据
+- expandColumnKey (string)：展开列的 key
+- expandedRowKeys (KeyType[]，默认 [])：展开行的 key 数组
+- defaultExpandedRowKeys (KeyType[]，默认 [])：默认展开行的 key 数组
+- class (string)：表格类名
+- fixed (boolean)：是否固定表格
+- style (CSSProperties)：表格样式
+- width (number，必填)：表格宽度（必填）
+- height (number，必填)：表格高度（必填）
+- maxHeight (number)：表格最大高度
+- useIsScrolling (boolean)：是否使用 isScrolling 状态
+- indentSize (number，默认 12)：树形数据缩进，单位 px
+- iconSize (number，默认 12)：图标尺寸，单位 px
+- hScrollbarSize (number，默认 见文档)：横向滚动条尺寸
+- vScrollbarSize (number，默认 见文档)：纵向滚动条尺寸
+- scrollbarAlwaysOn (boolean)：是否始终显示滚动条
+- sortBy ({ key: KeyType; order: SortOrder }，默认 {})：排序配置
+- sortState (SortState，默认 见文档)：排序状态
+- onColumnSort ((params: ColumnSortParams) => void)：列排序时触发
+- onExpandedRowsChange ((keys: KeyType[]) => void)：展开行变化时触发
+- onEndReached ((remainDistance: number) => void)：滚动到底部时触发
+- onRowExpand ((params: { expanded: boolean; rowData: any; rowIndex: number }) => void)：行展开/收起时触发
+- onScroll ((params: { x: number; y: number }) => void)：滚动时触发
+- onRowsRendered ((params: { start: number; end: number }) => void)：行渲染完成时触发
+- rowEventHandlers (TableV2RowEventHandlers)：行事件处理器
+
+## Slots
+
+- cell：自定义单元格内容，参数为 `{ columns, column, columnIndex, rowData, rowIndex }`
+- header：自定义表头内容
+- row：自定义行内容
+- footer：自定义底部内容
+- empty：无数据时的内容
+- overlay：覆盖层内容
+
+## Exposes
+
+- scrollTo((params: { scrollLeft?: number; scrollTop?: number }) => void)：滚动到指定位置
+- scrollToLeft((scrollLeft: number) => void)：横向滚动到指定位置
+- scrollToTop((scrollTop: number) => void)：纵向滚动到指定位置
+- scrollToRow((row: number, strategy?: ScrollStrategy) => void)：滚动到指定行
+
+## 关系
+
+- 子级：EpTableColumn
+- 常用组合：EpTableV2 + EpTableColumn
+
+## 视觉提示
+
+- 形状：块级数据区域
+- 密度：紧凑
+- 插槽内容：cell：自定义单元格内容，参数为 `{ columns, column, columnIndex, rowData, rowIndex }`；header：自定义表头内容；row：自定义行内容
+- CSS 变量：--el-border-color-lighter、--el-bg-color、--el-text-color-regular、--el-font-size-base
+
+## 示例
+
+### 虚拟化表格
+
+```vue
+<script setup lang="ts">
+import { EpTableV2 } from 'ep-craft'
+
+const columns = [
+  { key: 'id', title: 'ID', width: 80 },
+  { key: 'name', title: '姓名', width: 160 },
+  { key: 'role', title: '角色', width: 160 },
+]
+const data = Array.from({ length: 100 }, (_, index) => ({
+  id: index + 1,
+  name: `用户 ${index + 1}`,
+  role: '成员',
+}))
+</script>
+
+<template>
+  <ep-table-v2 :columns="columns" :data="data" :height="300" />
+</template>
+```
+
+## 相关条目
+
+- EpTable
+- EpTableColumn
+
+---
+
+ep-craft 0.2.0