ep-craft 0.1.42 → 0.2.0

package/dist-ai/components/anchor.json

@@ -0,0 +1,179 @@
+{
+  "entry": {
+    "category": "navigation",
+    "events": [
+      {
+        "description": "当前锚点变化时触发",
+        "name": "change",
+        "params": "(href: string)"
+      },
+      {
+        "description": "点击锚点链接时触发",
+        "name": "click",
+        "params": "(e: MouseEvent, href?: string)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpAnchor, EpAnchorLink } from 'ep-craft'\n</script>\n\n<template>\n  <ep-anchor direction=\"vertical\">\n    <ep-anchor-link href=\"#section-1\" title=\"第一节\" />\n    <ep-anchor-link href=\"#section-2\" title=\"第二节\" />\n  </ep-anchor>\n  <div id=\"section-1\" style=\"height: 200px\">第一节内容</div>\n  <div id=\"section-2\" style=\"height: 200px\">第二节内容</div>\n</template>",
+        "id": "anchor-1",
+        "language": "vue",
+        "title": "锚点导航"
+      }
+    ],
+    "exposes": [
+      {
+        "description": "滚动到指定锚点",
+        "name": "scrollTo",
+        "type": "(href: string) => void"
+      }
+    ],
+    "hot": false,
+    "id": "component:anchor",
+    "keywords": {
+      "en": [
+        "anchor",
+        "toc",
+        "navigation"
+      ],
+      "zh": [
+        "锚点",
+        "导航"
+      ]
+    },
+    "kind": "component",
+    "name": "EpAnchor",
+    "nonUseCases": [
+      "单步无层级的简单跳转时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "滚动的容器",
+        "hasDefault": false,
+        "name": "container",
+        "required": false,
+        "type": "string | HTMLElement | Window | null"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "锚点滚动的偏移量",
+        "hasDefault": true,
+        "name": "offset",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "15",
+        "description": "触发锚点定位的元素偏移量",
+        "hasDefault": true,
+        "name": "bound",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "300",
+        "description": "点击锚点后容器滚动的时长，单位 ms",
+        "hasDefault": true,
+        "name": "duration",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否显示标记",
+        "hasDefault": true,
+        "name": "marker",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "default",
+        "description": "锚点类型",
+        "hasDefault": true,
+        "name": "type",
+        "required": false,
+        "type": "'default' | 'underline'"
+      },
+      {
+        "alias": null,
+        "defaultText": "vertical",
+        "description": "锚点方向",
+        "hasDefault": true,
+        "name": "direction",
+        "required": false,
+        "type": "'vertical' | 'horizontal'"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "滚动到顶部时是否选中第一个链接",
+        "hasDefault": false,
+        "name": "selectScrollTop",
+        "required": false,
+        "type": "boolean"
+      }
+    ],
+    "related": [
+      "EpMenu",
+      "EpAnchorLink"
+    ],
+    "relations": {
+      "children": [
+        "EpAnchorLink"
+      ],
+      "combos": [
+        "EpAnchor + EpAnchorLink"
+      ],
+      "parents": [],
+      "requiredChildren": [
+        "EpAnchorLink"
+      ]
+    },
+    "slots": [
+      {
+        "description": "锚点内容，通常放置 ep-anchor-link",
+        "name": "default"
+      }
+    ],
+    "slug": "anchor",
+    "summary": "锚点，页面导航与定位",
+    "tag": "ep-anchor",
+    "useCases": [
+      "在页面或模块间使用锚点导航",
+      "指示当前位置与层级"
+    ],
+    "variants": [
+      {
+        "dimension": "type",
+        "values": [
+          "default",
+          "underline"
+        ],
+        "when": "通过 type 选择锚点类型"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-color-primary",
+        "--el-text-color-regular",
+        "--el-bg-color"
+      ],
+      "density": "中等",
+      "shape": "条状或列表",
+      "slotContent": [
+        "default：锚点内容，通常放置 ep-anchor-link"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/anchor.md

@@ -0,0 +1,87 @@
+# EpAnchor
+
+`ep-anchor` · navigation（导航） · `component:anchor`
+
+## 摘要
+
+锚点，页面导航与定位
+
+## 适用场景
+
+- 适用：在页面或模块间使用锚点导航
+- 适用：指示当前位置与层级
+- 不适用：单步无层级的简单跳转时
+
+## 关键词
+
+- 中文：锚点、导航
+- English: anchor, toc, navigation
+
+## 变体
+
+- type: default/underline（通过 type 选择锚点类型）
+
+## Props
+
+- container (string | HTMLElement | Window | null)：滚动的容器
+- offset (number，默认 0)：锚点滚动的偏移量
+- bound (number，默认 15)：触发锚点定位的元素偏移量
+- duration (number，默认 300)：点击锚点后容器滚动的时长，单位 ms
+- marker (boolean，默认 true)：是否显示标记
+- type ('default' | 'underline'，默认 default)：锚点类型
+- direction ('vertical' | 'horizontal'，默认 vertical)：锚点方向
+- selectScrollTop (boolean)：滚动到顶部时是否选中第一个链接
+
+## Events
+
+- change((href: string))：当前锚点变化时触发
+- click((e: MouseEvent, href?: string))：点击锚点链接时触发
+
+## Slots
+
+- default：锚点内容，通常放置 ep-anchor-link
+
+## Exposes
+
+- scrollTo((href: string) => void)：滚动到指定锚点
+
+## 关系
+
+- 子级：EpAnchorLink
+- 必需子组件：EpAnchorLink
+- 常用组合：EpAnchor + EpAnchorLink
+
+## 视觉提示
+
+- 形状：条状或列表
+- 密度：中等
+- 插槽内容：default：锚点内容，通常放置 ep-anchor-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 direction="vertical">
+    <ep-anchor-link href="#section-1" title="第一节" />
+    <ep-anchor-link href="#section-2" title="第二节" />
+  </ep-anchor>
+  <div id="section-1" style="height: 200px">第一节内容</div>
+  <div id="section-2" style="height: 200px">第二节内容</div>
+</template>
+```
+
+## 相关条目
+
+- EpMenu
+- EpAnchorLink
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/aside.json

@@ -0,0 +1,87 @@
+{
+  "entry": {
+    "category": "layout",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpAside, EpContainer, EpMain } from 'ep-craft'\n</script>\n\n<template>\n  <ep-container style=\"height: 180px\">\n    <ep-aside width=\"180px\">侧边栏</ep-aside>\n    <ep-main>主体内容</ep-main>\n  </ep-container>\n</template>",
+        "id": "aside-1",
+        "language": "vue",
+        "title": "侧边栏"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:aside",
+    "keywords": {
+      "en": [
+        "aside",
+        "sidebar",
+        "layout"
+      ],
+      "zh": [
+        "侧边栏",
+        "布局"
+      ]
+    },
+    "kind": "component",
+    "name": "EpAside",
+    "nonUseCases": [
+      "已有明确外层布局且无需此语义时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "侧边栏宽度，缺省时由 theme-chalk 的 CSS 变量兜底",
+        "hasDefault": true,
+        "name": "width",
+        "required": false,
+        "type": "string"
+      }
+    ],
+    "related": [
+      "EpContainer"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [
+        "EpContainer + EpAside"
+      ],
+      "parents": [
+        "EpContainer"
+      ],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "侧边栏内容",
+        "name": "default"
+      }
+    ],
+    "slug": "aside",
+    "summary": "侧边栏，页面结构与浮层交互",
+    "tag": "ep-aside",
+    "useCases": [
+      "使用侧边栏组织页面区域与间距",
+      "承载内容分组或浮层交互"
+    ],
+    "variants": [],
+    "visual": {
+      "cssVars": [
+        "--el-bg-color",
+        "--el-border-color",
+        "--el-border-radius-base"
+      ],
+      "density": "宽松",
+      "shape": "区块容器",
+      "slotContent": [
+        "default：侧边栏内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/aside.md

@@ -0,0 +1,63 @@
+# EpAside
+
+`ep-aside` · layout（布局） · `component:aside`
+
+## 摘要
+
+侧边栏，页面结构与浮层交互
+
+## 适用场景
+
+- 适用：使用侧边栏组织页面区域与间距
+- 适用：承载内容分组或浮层交互
+- 不适用：已有明确外层布局且无需此语义时
+
+## 关键词
+
+- 中文：侧边栏、布局
+- English: aside, sidebar, layout
+
+## Props
+
+- width (string，默认 见文档)：侧边栏宽度，缺省时由 theme-chalk 的 CSS 变量兜底
+
+## Slots
+
+- default：侧边栏内容
+
+## 关系
+
+- 父级：EpContainer
+- 常用组合：EpContainer + EpAside
+
+## 视觉提示
+
+- 形状：区块容器
+- 密度：宽松
+- 插槽内容：default：侧边栏内容
+- CSS 变量：--el-bg-color、--el-border-color、--el-border-radius-base
+
+## 示例
+
+### 侧边栏
+
+```vue
+<script setup lang="ts">
+import { EpAside, EpContainer, EpMain } from 'ep-craft'
+</script>
+
+<template>
+  <ep-container style="height: 180px">
+    <ep-aside width="180px">侧边栏</ep-aside>
+    <ep-main>主体内容</ep-main>
+  </ep-container>
+</template>
+```
+
+## 相关条目
+
+- EpContainer
+
+---
+
+ep-craft 0.2.0