ep-craft 0.1.42 → 0.2.0

package/dist-ai/components/affix.json

@@ -0,0 +1,152 @@
+{
+  "entry": {
+    "category": "basic",
+    "events": [
+      {
+        "description": "滚动时触发",
+        "name": "scroll",
+        "params": "({ scrollTop: number; fixed: boolean })"
+      },
+      {
+        "description": "固钉状态改变时触发",
+        "name": "change",
+        "params": "(fixed: boolean)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpAffix, EpButton } from 'ep-craft'\n</script>\n\n<template>\n  <ep-affix :offset=\"20\">\n    <ep-button type=\"primary\">滚动页面时保持可见</ep-button>\n  </ep-affix>\n</template>",
+        "id": "affix-1",
+        "language": "vue",
+        "title": "固钉内容"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "更新固钉状态",
+        "name": "update",
+        "type": "() => void"
+      },
+      {
+        "description": "更新根元素尺寸信息",
+        "name": "updateRoot",
+        "type": "() => void"
+      }
+    ],
+    "hot": false,
+    "id": "component:affix",
+    "keywords": {
+      "en": [
+        "affix",
+        "sticky",
+        "fixed",
+        "basic"
+      ],
+      "zh": [
+        "固钉",
+        "基础"
+      ]
+    },
+    "kind": "component",
+    "name": "EpAffix",
+    "nonUseCases": [
+      "需要完全自定义原生行为或视觉时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "100",
+        "description": "固钉元素的 z-index",
+        "hasDefault": true,
+        "name": "zIndex",
+        "required": false,
+        "type": "number | string"
+      },
+      {
+        "alias": null,
+        "defaultText": "''",
+        "description": "触发固钉的滚动容器选择器",
+        "hasDefault": true,
+        "name": "target",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "触发固钉的偏移距离，单位 px",
+        "hasDefault": true,
+        "name": "offset",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "top",
+        "description": "固钉位置",
+        "hasDefault": true,
+        "name": "position",
+        "required": false,
+        "type": "'top' | 'bottom'"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否将固钉元素 teleport 到 append-to 指定的位置",
+        "hasDefault": false,
+        "name": "teleported",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "body",
+        "description": "固钉元素挂载的容器",
+        "hasDefault": true,
+        "name": "appendTo",
+        "required": false,
+        "type": "string | HTMLElement"
+      }
+    ],
+    "related": [
+      "EpContainer",
+      "EpScrollbar"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "固钉内容",
+        "name": "default"
+      }
+    ],
+    "slug": "affix",
+    "summary": "固钉，基础交互与展示元素",
+    "tag": "ep-affix",
+    "useCases": [
+      "页面中的固钉展示与交互",
+      "为固钉提供统一视觉与状态"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-color-primary",
+        "--el-border-radius-base",
+        "--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/affix.md

@@ -0,0 +1,73 @@
+# EpAffix
+
+`ep-affix` · basic（基础） · `component:affix`
+
+## 摘要
+
+固钉，基础交互与展示元素
+
+## 适用场景
+
+- 适用：页面中的固钉展示与交互
+- 适用：为固钉提供统一视觉与状态
+- 不适用：需要完全自定义原生行为或视觉时
+
+## 关键词
+
+- 中文：固钉、基础
+- English: affix, sticky, fixed, basic
+
+## Props
+
+- zIndex (number | string，默认 100)：固钉元素的 z-index
+- target (string，默认 '')：触发固钉的滚动容器选择器
+- offset (number，默认 0)：触发固钉的偏移距离，单位 px
+- position ('top' | 'bottom'，默认 top)：固钉位置
+- teleported (boolean)：是否将固钉元素 teleport 到 append-to 指定的位置
+- appendTo (string | HTMLElement，默认 body)：固钉元素挂载的容器
+
+## Events
+
+- scroll(({ scrollTop: number; fixed: boolean }))：滚动时触发
+- change((fixed: boolean))：固钉状态改变时触发
+
+## Slots
+
+- default：固钉内容
+
+## Exposes
+
+- update(() => void)：更新固钉状态
+- updateRoot(() => void)：更新根元素尺寸信息
+
+## 视觉提示
+
+- 形状：圆角矩形
+- 密度：中等
+- 插槽内容：default：固钉内容
+- CSS 变量：--el-color-primary、--el-border-radius-base、--el-font-size-base
+
+## 示例
+
+### 固钉内容
+
+```vue
+<script setup lang="ts">
+import { EpAffix, EpButton } from 'ep-craft'
+</script>
+
+<template>
+  <ep-affix :offset="20">
+    <ep-button type="primary">滚动页面时保持可见</ep-button>
+  </ep-affix>
+</template>
+```
+
+## 相关条目
+
+- EpContainer
+- EpScrollbar
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/alert.json

@@ -0,0 +1,186 @@
+{
+  "entry": {
+    "category": "basic",
+    "events": [
+      {
+        "description": "关闭 Alert 时触发",
+        "name": "close",
+        "params": "()"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpAlert } from 'ep-craft'\n</script>\n\n<template>\n  <ep-alert title=\"保存成功\" type=\"success\" show-icon />\n  <ep-alert title=\"请检查填写内容\" type=\"warning\" description=\"部分字段校验未通过\" show-icon />\n</template>",
+        "id": "alert-1",
+        "language": "vue",
+        "title": "基础提示"
+      },
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpAlert } from 'ep-craft'\n\nconst visible = ref(true)\n</script>\n\n<template>\n  <ep-alert v-if=\"visible\" title=\"任务已结束\" type=\"info\" closable @close=\"visible = false\" />\n</template>",
+        "id": "alert-2",
+        "language": "vue",
+        "title": "可关闭提示"
+      }
+    ],
+    "exposes": [],
+    "hot": true,
+    "id": "component:alert",
+    "keywords": {
+      "en": [
+        "alert",
+        "banner",
+        "notice",
+        "basic"
+      ],
+      "zh": [
+        "提示",
+        "警告",
+        "通知条",
+        "基础"
+      ]
+    },
+    "kind": "component",
+    "name": "EpAlert",
+    "nonUseCases": [
+      "需要用户确认或阻断操作时使用 MessageBox"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "标题",
+        "hasDefault": true,
+        "name": "title",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "描述性文本",
+        "hasDefault": true,
+        "name": "description",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "info",
+        "description": "类型",
+        "hasDefault": true,
+        "name": "type",
+        "required": false,
+        "type": "'success' | 'warning' | 'info' | 'error'"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否可关闭",
+        "hasDefault": true,
+        "name": "closable",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "自定义关闭按钮文本",
+        "hasDefault": true,
+        "name": "closeText",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否显示类型图标",
+        "hasDefault": false,
+        "name": "showIcon",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "文字是否居中",
+        "hasDefault": false,
+        "name": "center",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "light",
+        "description": "主题样式",
+        "hasDefault": true,
+        "name": "effect",
+        "required": false,
+        "type": "'light' | 'dark'"
+      }
+    ],
+    "related": [
+      "EpResult",
+      "EpNotification"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "Alert 内容描述",
+        "name": "default"
+      },
+      {
+        "description": "标题的内容",
+        "name": "title"
+      }
+    ],
+    "slug": "alert",
+    "summary": "页面提示条，展示说明、警告或错误",
+    "tag": "ep-alert",
+    "useCases": [
+      "页面顶部说明与风险提示",
+      "操作结果或系统状态告知"
+    ],
+    "variants": [
+      {
+        "dimension": "type",
+        "values": [
+          "success",
+          "warning",
+          "info",
+          "error"
+        ],
+        "when": "通过 type 选择类型"
+      },
+      {
+        "dimension": "effect",
+        "values": [
+          "light",
+          "dark"
+        ],
+        "when": "通过视觉修饰属性调整外观效果"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-color-primary",
+        "--el-border-radius-base",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "圆角矩形",
+      "slotContent": [
+        "default：Alert 内容描述",
+        "title：标题的内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/alert.md

@@ -0,0 +1,89 @@
+# EpAlert
+
+`ep-alert` · basic（基础） · `component:alert`
+
+## 摘要
+
+页面提示条，展示说明、警告或错误
+
+## 适用场景
+
+- 适用：页面顶部说明与风险提示
+- 适用：操作结果或系统状态告知
+- 不适用：需要用户确认或阻断操作时使用 MessageBox
+
+## 关键词
+
+- 中文：提示、警告、通知条、基础
+- English: alert, banner, notice, basic
+
+## 变体
+
+- type: success/warning/info/error（通过 type 选择类型）
+- effect: light/dark（通过视觉修饰属性调整外观效果）
+
+## Props
+
+- title (string，默认 见文档)：标题
+- description (string，默认 见文档)：描述性文本
+- type ('success' | 'warning' | 'info' | 'error'，默认 info)：类型
+- closable (boolean，默认 true)：是否可关闭
+- closeText (string，默认 见文档)：自定义关闭按钮文本
+- showIcon (boolean)：是否显示类型图标
+- center (boolean)：文字是否居中
+- effect ('light' | 'dark'，默认 light)：主题样式
+
+## Events
+
+- close(())：关闭 Alert 时触发
+
+## Slots
+
+- default：Alert 内容描述
+- title：标题的内容
+
+## 视觉提示
+
+- 形状：圆角矩形
+- 密度：中等
+- 插槽内容：default：Alert 内容描述；title：标题的内容
+- CSS 变量：--el-color-primary、--el-border-radius-base、--el-font-size-base
+
+## 示例
+
+### 基础提示
+
+```vue
+<script setup lang="ts">
+import { EpAlert } from 'ep-craft'
+</script>
+
+<template>
+  <ep-alert title="保存成功" type="success" show-icon />
+  <ep-alert title="请检查填写内容" type="warning" description="部分字段校验未通过" show-icon />
+</template>
+```
+
+### 可关闭提示
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { EpAlert } from 'ep-craft'
+
+const visible = ref(true)
+</script>
+
+<template>
+  <ep-alert v-if="visible" title="任务已结束" type="info" closable @close="visible = false" />
+</template>
+```
+
+## 相关条目
+
+- EpResult
+- EpNotification
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/anchor-link.json

@@ -0,0 +1,102 @@
+{
+  "entry": {
+    "category": "navigation",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpAnchor, EpAnchorLink } from 'ep-craft'\n</script>\n\n<template>\n  <ep-anchor>\n    <ep-anchor-link href=\"#overview\" title=\"概览\" />\n    <ep-anchor-link href=\"#usage\" title=\"用法\" />\n  </ep-anchor>\n  <div id=\"overview\" style=\"height: 160px\">概览</div>\n  <div id=\"usage\" style=\"height: 160px\">用法</div>\n</template>",
+        "id": "anchor-link-1",
+        "language": "vue",
+        "title": "锚点链接"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:anchor-link",
+    "keywords": {
+      "en": [
+        "anchor-link",
+        "anchor",
+        "link",
+        "navigation"
+      ],
+      "zh": [
+        "锚点链接",
+        "导航"
+      ]
+    },
+    "kind": "component",
+    "name": "EpAnchorLink",
+    "nonUseCases": [
+      "单步无层级的简单跳转时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "锚点链接的文本内容",
+        "hasDefault": false,
+        "name": "title",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "锚点链接的地址",
+        "hasDefault": false,
+        "name": "href",
+        "required": false,
+        "type": "string"
+      }
+    ],
+    "related": [
+      "EpAnchor"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [
+        "EpAnchor + EpAnchorLink"
+      ],
+      "parents": [
+        "EpAnchor"
+      ],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "锚点链接内容，缺省时显示 title",
+        "name": "default"
+      },
+      {
+        "description": "子链接内容（垂直方向时生效）",
+        "name": "sub-link"
+      }
+    ],
+    "slug": "anchor-link",
+    "summary": "锚点链接，页面导航与定位",
+    "tag": "ep-anchor-link",
+    "useCases": [
+      "在页面或模块间使用锚点链接导航",
+      "指示当前位置与层级"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-color-primary",
+        "--el-text-color-regular",
+        "--el-bg-color"
+      ],
+      "density": "中等",
+      "shape": "条状或列表",
+      "slotContent": [
+        "default：锚点链接内容，缺省时显示 title",
+        "sub-link：子链接内容（垂直方向时生效）"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/anchor-link.md

@@ -0,0 +1,67 @@
+# EpAnchorLink
+
+`ep-anchor-link` · navigation（导航） · `component:anchor-link`
+
+## 摘要
+
+锚点链接，页面导航与定位
+
+## 适用场景
+
+- 适用：在页面或模块间使用锚点链接导航
+- 适用：指示当前位置与层级
+- 不适用：单步无层级的简单跳转时
+
+## 关键词
+
+- 中文：锚点链接、导航
+- English: anchor-link, anchor, link, navigation
+
+## Props
+
+- title (string)：锚点链接的文本内容
+- href (string)：锚点链接的地址
+
+## Slots
+
+- default：锚点链接内容，缺省时显示 title
+- sub-link：子链接内容（垂直方向时生效）
+
+## 关系
+
+- 父级：EpAnchor
+- 常用组合：EpAnchor + EpAnchorLink
+
+## 视觉提示
+
+- 形状：条状或列表
+- 密度：中等
+- 插槽内容：default：锚点链接内容，缺省时显示 title；sub-link：子链接内容（垂直方向时生效）
+- CSS 变量：--el-color-primary、--el-text-color-regular、--el-bg-color
+
+## 示例
+
+### 锚点链接
+
+```vue
+<script setup lang="ts">
+import { EpAnchor, EpAnchorLink } from 'ep-craft'
+</script>
+
+<template>
+  <ep-anchor>
+    <ep-anchor-link href="#overview" title="概览" />
+    <ep-anchor-link href="#usage" title="用法" />
+  </ep-anchor>
+  <div id="overview" style="height: 160px">概览</div>
+  <div id="usage" style="height: 160px">用法</div>
+</template>
+```
+
+## 相关条目
+
+- EpAnchor
+
+---
+
+ep-craft 0.2.0