ep-craft 0.1.41 → 0.2.0

package/dist-ai/components/row.md

@@ -0,0 +1,68 @@
+# EpRow
+
+`ep-row` · layout（布局） · `component:row`
+
+## 摘要
+
+行，页面结构与浮层交互
+
+## 适用场景
+
+- 适用：使用行组织页面区域与间距
+- 适用：承载内容分组或浮层交互
+- 不适用：已有明确外层布局且无需此语义时
+
+## 关键词
+
+- 中文：行、布局
+- English: row, grid, layout
+
+## Props
+
+- tag (string，默认 div)：自定义元素标签
+- gutter (number，默认 0)：栅格间隔，单位 px
+- justify ('start' | 'center' | 'end' | 'space-around' | 'space-between' | 'space-evenly'，默认 start)：水平排列方式
+- align ('top' | 'middle' | 'bottom')：垂直排列方式
+
+## Slots
+
+- default：栅格内容，通常放置 ep-col
+
+## 关系
+
+- 子级：EpCol
+- 常用组合：EpRow + EpCol
+
+## 视觉提示
+
+- 形状：区块容器
+- 密度：宽松
+- 插槽内容：default：栅格内容，通常放置 ep-col
+- CSS 变量：--el-bg-color、--el-border-color、--el-border-radius-base
+
+## 示例
+
+### 栅格行
+
+```vue
+<script setup lang="ts">
+import { EpCol, EpRow } from 'ep-craft'
+</script>
+
+<template>
+  <ep-row :gutter="16">
+    <ep-col :span="8"><div class="grid-cell">span 8</div></ep-col>
+    <ep-col :span="8"><div class="grid-cell">span 8</div></ep-col>
+    <ep-col :span="8"><div class="grid-cell">span 8</div></ep-col>
+  </ep-row>
+</template>
+```
+
+## 相关条目
+
+- EpCol
+- EpContainer
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/scrollbar.json

@@ -0,0 +1,280 @@
+{
+  "entry": {
+    "category": "data",
+    "events": [
+      {
+        "description": "滚动到达边界时触发",
+        "name": "endReached",
+        "params": "(direction: 'top' | 'bottom' | 'left' | 'right')"
+      },
+      {
+        "description": "滚动时触发",
+        "name": "scroll",
+        "params": "({ scrollTop: number; scrollLeft: number })"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpScrollbar } from 'ep-craft'\n</script>\n\n<template>\n  <ep-scrollbar height=\"200px\">\n    <div style=\"height: 600px\">滚动查看自定义滚动条</div>\n  </ep-scrollbar>\n</template>",
+        "id": "scrollbar-1",
+        "language": "vue",
+        "title": "自定义滚动条"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "滚动容器的 DOM 引用",
+        "name": "wrapRef",
+        "type": "Ref<HTMLDivElement | undefined>"
+      },
+      {
+        "description": "手动更新滚动条状态",
+        "name": "update",
+        "type": "() => void"
+      },
+      {
+        "description": "滚动到指定坐标",
+        "name": "scrollTo",
+        "type": "(arg1: unknown, arg2?: number) => void"
+      },
+      {
+        "description": "设置纵向滚动距离",
+        "name": "setScrollTop",
+        "type": "(value: number) => void"
+      },
+      {
+        "description": "设置横向滚动距离",
+        "name": "setScrollLeft",
+        "type": "(value: number) => void"
+      },
+      {
+        "description": "处理滚动事件",
+        "name": "handleScroll",
+        "type": "() => void"
+      }
+    ],
+    "hot": false,
+    "id": "component:scrollbar",
+    "keywords": {
+      "en": [
+        "scrollbar",
+        "scroll",
+        "data"
+      ],
+      "zh": [
+        "滚动条",
+        "数据"
+      ]
+    },
+    "kind": "component",
+    "name": "EpScrollbar",
+    "nonUseCases": [
+      "数据量极小且无需结构化展示时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "触发滚动条出现的距离，单位 px",
+        "hasDefault": true,
+        "name": "distance",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "滚动条高度",
+        "hasDefault": true,
+        "name": "height",
+        "required": false,
+        "type": "number | string"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "滚动条最大高度",
+        "hasDefault": true,
+        "name": "maxHeight",
+        "required": false,
+        "type": "number | string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否使用原生滚动条",
+        "hasDefault": false,
+        "name": "native",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "滚动容器样式",
+        "hasDefault": true,
+        "name": "wrapStyle",
+        "required": false,
+        "type": "StyleValue"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "滚动容器类名",
+        "hasDefault": true,
+        "name": "wrapClass",
+        "required": false,
+        "type": "string | string[]"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "视图元素类名",
+        "hasDefault": true,
+        "name": "viewClass",
+        "required": false,
+        "type": "string | string[]"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "视图元素样式",
+        "hasDefault": true,
+        "name": "viewStyle",
+        "required": false,
+        "type": "StyleValue"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "不响应容器尺寸变化（容器尺寸固定时可提升性能）",
+        "hasDefault": false,
+        "name": "noresize",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "div",
+        "description": "视图元素标签",
+        "hasDefault": true,
+        "name": "tag",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否始终显示滚动条",
+        "hasDefault": false,
+        "name": "always",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "20",
+        "description": "滚动条最小尺寸",
+        "hasDefault": true,
+        "name": "minSize",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "滚动容器的 tabindex",
+        "hasDefault": true,
+        "name": "tabindex",
+        "required": false,
+        "type": "number | string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "视图元素 id",
+        "hasDefault": false,
+        "name": "id",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "视图元素 role",
+        "hasDefault": false,
+        "name": "role",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 aria-label 属性",
+        "hasDefault": false,
+        "name": "ariaLabel",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 aria-orientation 属性",
+        "hasDefault": false,
+        "name": "ariaOrientation",
+        "required": false,
+        "type": "'horizontal' | 'vertical' | 'undefined'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "ariaLabelledby",
+        "required": false,
+        "type": "unknown"
+      }
+    ],
+    "related": [
+      "EpTable",
+      "EpTree"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "滚动内容",
+        "name": "default"
+      }
+    ],
+    "slug": "scrollbar",
+    "summary": "滚动条，结构化数据展示",
+    "tag": "ep-scrollbar",
+    "useCases": [
+      "展示滚动条类结构化数据",
+      "需要浏览、比较或定位数据时"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-border-color-lighter",
+        "--el-bg-color",
+        "--el-text-color-regular",
+        "--el-font-size-base"
+      ],
+      "density": "紧凑",
+      "shape": "块级数据区域",
+      "slotContent": [
+        "default：滚动内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/scrollbar.md

@@ -0,0 +1,89 @@
+# EpScrollbar
+
+`ep-scrollbar` · data（数据展示） · `component:scrollbar`
+
+## 摘要
+
+滚动条，结构化数据展示
+
+## 适用场景
+
+- 适用：展示滚动条类结构化数据
+- 适用：需要浏览、比较或定位数据时
+- 不适用：数据量极小且无需结构化展示时
+
+## 关键词
+
+- 中文：滚动条、数据
+- English: scrollbar, scroll, data
+
+## Props
+
+- distance (number，默认 0)：触发滚动条出现的距离，单位 px
+- height (number | string，默认 '')：滚动条高度
+- maxHeight (number | string，默认 '')：滚动条最大高度
+- native (boolean)：是否使用原生滚动条
+- wrapStyle (StyleValue，默认 '')：滚动容器样式
+- wrapClass (string | string[]，默认 '')：滚动容器类名
+- viewClass (string | string[]，默认 '')：视图元素类名
+- viewStyle (StyleValue，默认 '')：视图元素样式
+- noresize (boolean)：不响应容器尺寸变化（容器尺寸固定时可提升性能）
+- tag (string，默认 div)：视图元素标签
+- always (boolean)：是否始终显示滚动条
+- minSize (number，默认 20)：滚动条最小尺寸
+- tabindex (number | string，默认 见文档)：滚动容器的 tabindex
+- id (string)：视图元素 id
+- role (string)：视图元素 role
+- ariaLabel (string)：原生 aria-label 属性
+- ariaOrientation ('horizontal' | 'vertical' | 'undefined')：原生 aria-orientation 属性
+- ariaLabelledby (unknown)
+
+## Events
+
+- endReached((direction: 'top' | 'bottom' | 'left' | 'right'))：滚动到达边界时触发
+- scroll(({ scrollTop: number; scrollLeft: number }))：滚动时触发
+
+## Slots
+
+- default：滚动内容
+
+## Exposes
+
+- wrapRef(Ref<HTMLDivElement | undefined>)：滚动容器的 DOM 引用
+- update(() => void)：手动更新滚动条状态
+- scrollTo((arg1: unknown, arg2?: number) => void)：滚动到指定坐标
+- setScrollTop((value: number) => void)：设置纵向滚动距离
+- setScrollLeft((value: number) => void)：设置横向滚动距离
+- handleScroll(() => void)：处理滚动事件
+
+## 视觉提示
+
+- 形状：块级数据区域
+- 密度：紧凑
+- 插槽内容：default：滚动内容
+- CSS 变量：--el-border-color-lighter、--el-bg-color、--el-text-color-regular、--el-font-size-base
+
+## 示例
+
+### 自定义滚动条
+
+```vue
+<script setup lang="ts">
+import { EpScrollbar } from 'ep-craft'
+</script>
+
+<template>
+  <ep-scrollbar height="200px">
+    <div style="height: 600px">滚动查看自定义滚动条</div>
+  </ep-scrollbar>
+</template>
+```
+
+## 相关条目
+
+- EpTable
+- EpTree
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/segmented.json

@@ -0,0 +1,204 @@
+{
+  "entry": {
+    "category": "feedback",
+    "events": [
+      {
+        "description": "绑定值变化时触发",
+        "name": "update:modelValue",
+        "params": "(value: string | number | boolean)"
+      },
+      {
+        "description": "选中值变化时触发",
+        "name": "change",
+        "params": "(value: string | number | boolean)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpSegmented } from 'ep-craft'\n\nconst value = ref('week')\nconst options = ['day', 'week', 'month']\n</script>\n\n<template>\n  <ep-segmented v-model=\"value\" :options=\"options\" />\n</template>",
+        "id": "segmented-1",
+        "language": "vue",
+        "title": "分段控制器"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:segmented",
+    "keywords": {
+      "en": [
+        "segmented",
+        "toggle",
+        "feedback"
+      ],
+      "zh": [
+        "分段控制器",
+        "反馈"
+      ]
+    },
+    "kind": "component",
+    "name": "EpSegmented",
+    "nonUseCases": [
+      "无需用户感知状态变化时",
+      "需要完整业务弹窗流程时优先使用 Dialog"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "horizontal",
+        "description": "排列方向",
+        "hasDefault": true,
+        "name": "direction",
+        "required": false,
+        "type": "'horizontal' | 'vertical'"
+      },
+      {
+        "alias": null,
+        "defaultText": "[]",
+        "description": "选项列表",
+        "hasDefault": true,
+        "name": "options",
+        "required": false,
+        "type": "Option[]"
+      },
+      {
+        "alias": "v-model",
+        "defaultText": null,
+        "description": "绑定值",
+        "hasDefault": true,
+        "name": "modelValue",
+        "required": false,
+        "type": "string | number | boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "{ label: 'label', value: 'value', disabled: 'disabled' }",
+        "description": "选项字段映射",
+        "hasDefault": true,
+        "name": "props",
+        "required": false,
+        "type": "{ label?: string; value?: string; disabled?: string }"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否撑满父容器宽度",
+        "hasDefault": false,
+        "name": "block",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "尺寸",
+        "hasDefault": false,
+        "name": "size",
+        "required": false,
+        "type": "'large' | 'default' | 'small'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "是否禁用",
+        "hasDefault": true,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否触发表单校验",
+        "hasDefault": true,
+        "name": "validateEvent",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 input id",
+        "hasDefault": false,
+        "name": "id",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 input name 属性",
+        "hasDefault": false,
+        "name": "name",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "原生 aria-label 属性",
+        "hasDefault": false,
+        "name": "ariaLabel",
+        "required": false,
+        "type": "string"
+      }
+    ],
+    "related": [
+      "EpTabs",
+      "EpRadioGroup"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义选项内容，参数为 `{ item }`",
+        "name": "default"
+      }
+    ],
+    "slug": "segmented",
+    "summary": "分段控制器，状态与结果反馈",
+    "tag": "ep-segmented",
+    "useCases": [
+      "展示分段控制器并向用户传达状态",
+      "在操作前后提供即时反馈"
+    ],
+    "variants": [
+      {
+        "dimension": "size",
+        "values": [
+          "large",
+          "default",
+          "small"
+        ],
+        "when": "按容器空间与信息密度选择尺寸"
+      },
+      {
+        "dimension": "state",
+        "values": [
+          "disabled"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-color-success",
+        "--el-color-warning",
+        "--el-color-danger",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "行内或块级提示",
+      "slotContent": [
+        "default：自定义选项内容，参数为 `{ item }`"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}