ep-craft 0.1.41 → 0.2.0

package/dist-ai/components/tab-pane.json

@@ -0,0 +1,137 @@
+{
+  "entry": {
+    "category": "navigation",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpTabPane, EpTabs } from 'ep-craft'\n</script>\n\n<template>\n  <ep-tabs model-value=\"first\">\n    <ep-tab-pane label=\"用户\" name=\"first\">用户管理</ep-tab-pane>\n    <ep-tab-pane label=\"配置\" name=\"second\">系统配置</ep-tab-pane>\n  </ep-tabs>\n</template>",
+        "id": "tab-pane-1",
+        "language": "vue",
+        "title": "标签面板"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:tab-pane",
+    "keywords": {
+      "en": [
+        "tab-pane",
+        "tab",
+        "pane",
+        "navigation"
+      ],
+      "zh": [
+        "标签面板",
+        "导航"
+      ]
+    },
+    "kind": "component",
+    "name": "EpTabPane",
+    "nonUseCases": [
+      "单步无层级的简单跳转时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "选项卡标题",
+        "hasDefault": true,
+        "name": "label",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "与选项卡 model-value 对应的标识符，表示选项卡别名",
+        "hasDefault": false,
+        "name": "name",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "标签是否可关闭",
+        "hasDefault": true,
+        "name": "closable",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否禁用",
+        "hasDefault": false,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "标签是否延迟渲染",
+        "hasDefault": false,
+        "name": "lazy",
+        "required": false,
+        "type": "boolean"
+      }
+    ],
+    "related": [
+      "EpTabs"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [
+        "EpTabs + EpTabPane"
+      ],
+      "parents": [
+        "EpTabs"
+      ],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "选项卡默认内容",
+        "name": "default"
+      },
+      {
+        "description": "选项卡标题内容",
+        "name": "label"
+      }
+    ],
+    "slug": "tab-pane",
+    "summary": "标签面板，页面导航与定位",
+    "tag": "ep-tab-pane",
+    "useCases": [
+      "在页面或模块间使用标签面板导航",
+      "指示当前位置与层级"
+    ],
+    "variants": [
+      {
+        "dimension": "state",
+        "values": [
+          "disabled"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-color-primary",
+        "--el-text-color-regular",
+        "--el-bg-color"
+      ],
+      "density": "中等",
+      "shape": "条状或列表",
+      "slotContent": [
+        "default：选项卡默认内容",
+        "label：选项卡标题内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/tab-pane.md

@@ -0,0 +1,72 @@
+# EpTabPane
+
+`ep-tab-pane` · navigation（导航） · `component:tab-pane`
+
+## 摘要
+
+标签面板，页面导航与定位
+
+## 适用场景
+
+- 适用：在页面或模块间使用标签面板导航
+- 适用：指示当前位置与层级
+- 不适用：单步无层级的简单跳转时
+
+## 关键词
+
+- 中文：标签面板、导航
+- English: tab-pane, tab, pane, navigation
+
+## 变体
+
+- state: disabled（通过布尔属性切换禁用、加载或选中状态）
+
+## Props
+
+- label (string，默认 见文档)：选项卡标题
+- name (string | number)：与选项卡 model-value 对应的标识符，表示选项卡别名
+- closable (boolean，默认 false)：标签是否可关闭
+- disabled (boolean)：是否禁用
+- lazy (boolean)：标签是否延迟渲染
+
+## Slots
+
+- default：选项卡默认内容
+- label：选项卡标题内容
+
+## 关系
+
+- 父级：EpTabs
+- 常用组合：EpTabs + EpTabPane
+
+## 视觉提示
+
+- 形状：条状或列表
+- 密度：中等
+- 插槽内容：default：选项卡默认内容；label：选项卡标题内容
+- CSS 变量：--el-color-primary、--el-text-color-regular、--el-bg-color
+
+## 示例
+
+### 标签面板
+
+```vue
+<script setup lang="ts">
+import { EpTabPane, EpTabs } from 'ep-craft'
+</script>
+
+<template>
+  <ep-tabs model-value="first">
+    <ep-tab-pane label="用户" name="first">用户管理</ep-tab-pane>
+    <ep-tab-pane label="配置" name="second">系统配置</ep-tab-pane>
+  </ep-tabs>
+</template>
+```
+
+## 相关条目
+
+- EpTabs
+
+---
+
+ep-craft 0.2.0

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

@@ -0,0 +1,368 @@
+{
+  "entry": {
+    "category": "data",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpTable, EpTableColumn } from 'ep-craft'\n\nconst rows = [\n  { name: '张三', province: '浙江' },\n  { name: '李四', province: '江苏' },\n]\n</script>\n\n<template>\n  <ep-table :data=\"rows\">\n    <ep-table-column prop=\"name\" label=\"姓名\" />\n    <ep-table-column prop=\"province\" label=\"省份\" />\n  </ep-table>\n</template>",
+        "id": "table-column-1",
+        "language": "vue",
+        "title": "表格列"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:table-column",
+    "keywords": {
+      "en": [
+        "table-column",
+        "table",
+        "column",
+        "data"
+      ],
+      "zh": [
+        "表格列",
+        "数据"
+      ]
+    },
+    "kind": "component",
+    "name": "EpTableColumn",
+    "nonUseCases": [
+      "数据量极小且无需结构化展示时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "对应列的类型",
+        "hasDefault": true,
+        "name": "type",
+        "required": false,
+        "type": "'selection' | 'index' | 'expand'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "显示的标题",
+        "hasDefault": false,
+        "name": "label",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "列的 className",
+        "hasDefault": false,
+        "name": "className",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "当前列标题的自定义类名",
+        "hasDefault": false,
+        "name": "labelClassName",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "property",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "字段名称",
+        "hasDefault": false,
+        "name": "prop",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "对应列的宽度",
+        "hasDefault": true,
+        "name": "width",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "对应列的最小宽度",
+        "hasDefault": true,
+        "name": "minWidth",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "列标题 Label 区域渲染使用的 Function",
+        "hasDefault": false,
+        "name": "renderHeader",
+        "required": false,
+        "type": "({ column, $index }) => VNode"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "对应列是否可以排序",
+        "hasDefault": true,
+        "name": "sortable",
+        "required": false,
+        "type": "boolean | 'custom'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "对数据进行排序的函数",
+        "hasDefault": false,
+        "name": "sortMethod",
+        "required": false,
+        "type": "(a, b) => number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "指定数据按照哪个属性进行排序",
+        "hasDefault": false,
+        "name": "sortBy",
+        "required": false,
+        "type": "string | string[] | ((row, index) => string)"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "对应列是否可以通过拖动改变宽度",
+        "hasDefault": true,
+        "name": "resizable",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "column 的 key",
+        "hasDefault": false,
+        "name": "columnKey",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "left",
+        "description": "对齐方式",
+        "hasDefault": false,
+        "name": "align",
+        "required": false,
+        "type": "'left' | 'center' | 'right'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "表头对齐方式",
+        "hasDefault": false,
+        "name": "headerAlign",
+        "required": false,
+        "type": "'left' | 'center' | 'right'"
+      },
+      {
+        "alias": null,
+        "defaultText": "undefined",
+        "description": "内容过长被隐藏时是否显示 tooltip",
+        "hasDefault": true,
+        "name": "showOverflowTooltip",
+        "required": false,
+        "type": "boolean | object"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "tooltipFormatter",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "列是否固定",
+        "hasDefault": false,
+        "name": "fixed",
+        "required": false,
+        "type": "'left' | 'right' | boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "用来格式化内容",
+        "hasDefault": false,
+        "name": "formatter",
+        "required": false,
+        "type": "(row, column, cellValue, index) => VNode | string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "仅对 type=selection 的列有效",
+        "hasDefault": false,
+        "name": "selectable",
+        "required": false,
+        "type": "(row, index) => boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "仅对 type=selection 的列有效，数据刷新后是否保留之前选中的数据",
+        "hasDefault": false,
+        "name": "reserveSelection",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "数据过滤使用的方法",
+        "hasDefault": false,
+        "name": "filterMethod",
+        "required": false,
+        "type": "(value, row, column) => boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "选中的数据过滤项",
+        "hasDefault": false,
+        "name": "filteredValue",
+        "required": false,
+        "type": "string[]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "数据过滤的选项",
+        "hasDefault": false,
+        "name": "filters",
+        "required": false,
+        "type": "{ text: string, value: string }[]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "过滤弹出框的定位",
+        "hasDefault": false,
+        "name": "filterPlacement",
+        "required": false,
+        "type": "Placement"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "数据过滤的选项是否多选",
+        "hasDefault": true,
+        "name": "filterMultiple",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "filterClassName",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "如果设置了 type=index，可自定义索引",
+        "hasDefault": false,
+        "name": "index",
+        "required": false,
+        "type": "number | ((index: number) => number)"
+      },
+      {
+        "alias": null,
+        "defaultText": "['ascending', 'descending', null]",
+        "description": "数据在排序时所使用排序策略的轮转顺序",
+        "hasDefault": true,
+        "name": "sortOrders",
+        "required": false,
+        "type": "('ascending' | 'descending' | null)[]"
+      }
+    ],
+    "related": [
+      "EpTable",
+      "EpTableV2"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [
+        "EpTable + EpTableColumn",
+        "EpTableV2 + EpTableColumn"
+      ],
+      "parents": [
+        "EpTable",
+        "EpTableV2"
+      ],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义列的内容",
+        "name": "default"
+      },
+      {
+        "description": "自定义表头的内容",
+        "name": "header"
+      }
+    ],
+    "slug": "table-column",
+    "summary": "表格列，结构化数据展示",
+    "tag": "ep-table-column",
+    "useCases": [
+      "展示表格列类结构化数据",
+      "需要浏览、比较或定位数据时"
+    ],
+    "variants": [
+      {
+        "dimension": "type",
+        "values": [
+          "selection",
+          "index",
+          "expand"
+        ],
+        "when": "通过 type 选择对应列的类型"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-border-color-lighter",
+        "--el-bg-color",
+        "--el-text-color-regular",
+        "--el-font-size-base"
+      ],
+      "density": "紧凑",
+      "shape": "块级数据区域",
+      "slotContent": [
+        "default：自定义列的内容",
+        "header：自定义表头的内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

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

@@ -0,0 +1,103 @@
+# EpTableColumn
+
+`ep-table-column` · data（数据展示） · `component:table-column`
+
+## 摘要
+
+表格列，结构化数据展示
+
+## 适用场景
+
+- 适用：展示表格列类结构化数据
+- 适用：需要浏览、比较或定位数据时
+- 不适用：数据量极小且无需结构化展示时
+
+## 关键词
+
+- 中文：表格列、数据
+- English: table-column, table, column, data
+
+## 变体
+
+- type: selection/index/expand（通过 type 选择对应列的类型）
+
+## Props
+
+- type ('selection' | 'index' | 'expand'，默认 见文档)：对应列的类型
+- label (string)：显示的标题
+- className (string)：列的 className
+- labelClassName (string)：当前列标题的自定义类名
+- property (unknown)
+- prop (string)：字段名称
+- width (string | number，默认 见文档)：对应列的宽度
+- minWidth (string | number，默认 见文档)：对应列的最小宽度
+- renderHeader (({ column, $index }) => VNode)：列标题 Label 区域渲染使用的 Function
+- sortable (boolean | 'custom'，默认 false)：对应列是否可以排序
+- sortMethod ((a, b) => number)：对数据进行排序的函数
+- sortBy (string | string[] | ((row, index) => string))：指定数据按照哪个属性进行排序
+- resizable (boolean，默认 true)：对应列是否可以通过拖动改变宽度
+- columnKey (string)：column 的 key
+- align ('left' | 'center' | 'right')：对齐方式
+- headerAlign ('left' | 'center' | 'right')：表头对齐方式
+- showOverflowTooltip (boolean | object，默认 undefined)：内容过长被隐藏时是否显示 tooltip
+- tooltipFormatter (unknown)
+- fixed ('left' | 'right' | boolean)：列是否固定
+- formatter ((row, column, cellValue, index) => VNode | string)：用来格式化内容
+- selectable ((row, index) => boolean)：仅对 type=selection 的列有效
+- reserveSelection (boolean)：仅对 type=selection 的列有效，数据刷新后是否保留之前选中的数据
+- filterMethod ((value, row, column) => boolean)：数据过滤使用的方法
+- filteredValue (string[])：选中的数据过滤项
+- filters ({ text: string, value: string }[])：数据过滤的选项
+- filterPlacement (Placement)：过滤弹出框的定位
+- filterMultiple (boolean，默认 true)：数据过滤的选项是否多选
+- filterClassName (unknown)
+- index (number | ((index: number) => number))：如果设置了 type=index，可自定义索引
+- sortOrders (('ascending' | 'descending' | null)[]，默认 ['ascending', 'descending', null])：数据在排序时所使用排序策略的轮转顺序
+
+## Slots
+
+- default：自定义列的内容
+- header：自定义表头的内容
+
+## 关系
+
+- 父级：EpTable、EpTableV2
+- 常用组合：EpTable + EpTableColumn、EpTableV2 + EpTableColumn
+
+## 视觉提示
+
+- 形状：块级数据区域
+- 密度：紧凑
+- 插槽内容：default：自定义列的内容；header：自定义表头的内容
+- CSS 变量：--el-border-color-lighter、--el-bg-color、--el-text-color-regular、--el-font-size-base
+
+## 示例
+
+### 表格列
+
+```vue
+<script setup lang="ts">
+import { EpTable, EpTableColumn } from 'ep-craft'
+
+const rows = [
+  { name: '张三', province: '浙江' },
+  { name: '李四', province: '江苏' },
+]
+</script>
+
+<template>
+  <ep-table :data="rows">
+    <ep-table-column prop="name" label="姓名" />
+    <ep-table-column prop="province" label="省份" />
+  </ep-table>
+</template>
+```
+
+## 相关条目
+
+- EpTable
+- EpTableV2
+
+---
+
+ep-craft 0.2.0