ep-craft 0.1.42 → 0.2.0

package/dist-ai/components/pagination.json

@@ -0,0 +1,325 @@
+{
+  "entry": {
+    "category": "navigation",
+    "events": [
+      {
+        "description": "当前页数变化时触发",
+        "name": "update:currentPage",
+        "params": "(currentPage: number)"
+      },
+      {
+        "description": "每页条目数变化时触发",
+        "name": "update:pageSize",
+        "params": "(pageSize: number)"
+      },
+      {
+        "description": "pageSize 改变时触发",
+        "name": "sizeChange",
+        "params": "(val: number)"
+      },
+      {
+        "description": "当前页数或每页条目数变化时触发",
+        "name": "change",
+        "params": "(currentPage: number, pageSize: number)"
+      },
+      {
+        "description": "currentPage 改变时触发",
+        "name": "currentChange",
+        "params": "(val: number)"
+      },
+      {
+        "description": "点击上一页按钮改变当前页时触发",
+        "name": "prevClick",
+        "params": "(val: number)"
+      },
+      {
+        "description": "点击下一页按钮改变当前页时触发",
+        "name": "nextClick",
+        "params": "(val: number)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpPagination } from 'ep-craft'\n\nconst page = ref(1)\n</script>\n\n<template>\n  <ep-pagination v-model:current-page=\"page\" :total=\"120\" layout=\"prev, pager, next\" />\n</template>",
+        "id": "pagination-1",
+        "language": "vue",
+        "title": "基础分页"
+      },
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpPagination } from 'ep-craft'\n\nconst page = ref(1)\nconst pageSize = ref(20)\n</script>\n\n<template>\n  <ep-pagination\n    v-model:current-page=\"page\"\n    v-model:page-size=\"pageSize\"\n    :total=\"200\"\n    :page-sizes=\"[10, 20, 50]\"\n    layout=\"total, sizes, prev, pager, next\"\n  />\n</template>",
+        "id": "pagination-2",
+        "language": "vue",
+        "title": "每页条数"
+      }
+    ],
+    "exposes": [],
+    "hot": true,
+    "id": "component:pagination",
+    "keywords": {
+      "en": [
+        "pagination",
+        "pager",
+        "pages",
+        "navigation"
+      ],
+      "zh": [
+        "分页",
+        "页码",
+        "翻页",
+        "导航"
+      ]
+    },
+    "kind": "component",
+    "name": "EpPagination",
+    "nonUseCases": [
+      "单步无层级的简单跳转时"
+    ],
+    "props": [
+      {
+        "alias": "v-model:page-size",
+        "defaultText": "10",
+        "description": "每页显示条目个数",
+        "hasDefault": false,
+        "name": "pageSize",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "每页默认的条目个数",
+        "hasDefault": false,
+        "name": "defaultPageSize",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "总条目数",
+        "hasDefault": false,
+        "name": "total",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "总页数",
+        "hasDefault": false,
+        "name": "pageCount",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "7",
+        "description": "设置最大页码按钮数",
+        "hasDefault": true,
+        "name": "pagerCount",
+        "required": false,
+        "type": "number (5-21 之间的奇数)"
+      },
+      {
+        "alias": "v-model:current-page",
+        "defaultText": "1",
+        "description": "当前页数",
+        "hasDefault": false,
+        "name": "currentPage",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "当前页数的默认初始值",
+        "hasDefault": false,
+        "name": "defaultCurrentPage",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "'prev, pager, next, jumper, ->, total'",
+        "description": "组件布局",
+        "hasDefault": true,
+        "name": "layout",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "[10, 20, 30, 40, 50, 100]",
+        "description": "每页显示个数选择器的选项设置",
+        "hasDefault": true,
+        "name": "pageSizes",
+        "required": false,
+        "type": "number[]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "每页显示个数选择器的下拉框类名",
+        "hasDefault": true,
+        "name": "popperClass",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "popperStyle",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "替代图标显示的上一页文字",
+        "hasDefault": true,
+        "name": "prevText",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "ArrowLeft",
+        "description": "上一页的图标",
+        "hasDefault": true,
+        "name": "prevIcon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "替代图标显示的下一页文字",
+        "hasDefault": true,
+        "name": "nextText",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "ArrowRight",
+        "description": "下一页的图标",
+        "hasDefault": true,
+        "name": "nextIcon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否将下拉菜单 teleport 至 body",
+        "hasDefault": true,
+        "name": "teleported",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否使用小型分页样式",
+        "hasDefault": false,
+        "name": "small",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "size",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否为分页按钮添加背景色",
+        "hasDefault": false,
+        "name": "background",
+        "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": "hideOnSinglePage",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "appendSizeTo",
+        "required": false,
+        "type": "unknown"
+      }
+    ],
+    "related": [
+      "EpTable"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "自定义默认内容",
+        "name": "default"
+      }
+    ],
+    "slug": "pagination",
+    "summary": "分页器，切换大数据集的页码",
+    "tag": "ep-pagination",
+    "useCases": [
+      "表格或列表分页浏览",
+      "控制每页条数与跳转"
+    ],
+    "variants": [
+      {
+        "dimension": "state",
+        "values": [
+          "disabled"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-color-primary",
+        "--el-text-color-regular",
+        "--el-bg-color"
+      ],
+      "density": "中等",
+      "shape": "条状或列表",
+      "slotContent": [
+        "default：自定义默认内容"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/pagination.md

@@ -0,0 +1,115 @@
+# EpPagination
+
+`ep-pagination` · navigation（导航） · `component:pagination`
+
+## 摘要
+
+分页器，切换大数据集的页码
+
+## 适用场景
+
+- 适用：表格或列表分页浏览
+- 适用：控制每页条数与跳转
+- 不适用：单步无层级的简单跳转时
+
+## 关键词
+
+- 中文：分页、页码、翻页、导航
+- English: pagination, pager, pages, navigation
+
+## 变体
+
+- state: disabled（通过布尔属性切换禁用、加载或选中状态）
+
+## Props
+
+- pageSize（别名 v-model:page-size） (number)：每页显示条目个数
+- defaultPageSize (number)：每页默认的条目个数
+- total (number)：总条目数
+- pageCount (number)：总页数
+- pagerCount (number (5-21 之间的奇数)，默认 7)：设置最大页码按钮数
+- currentPage（别名 v-model:current-page） (number)：当前页数
+- defaultCurrentPage (number)：当前页数的默认初始值
+- layout (string，默认 'prev, pager, next, jumper, ->, total')：组件布局
+- pageSizes (number[]，默认 [10, 20, 30, 40, 50, 100])：每页显示个数选择器的选项设置
+- popperClass (string，默认 见文档)：每页显示个数选择器的下拉框类名
+- popperStyle (unknown)
+- prevText (string，默认 见文档)：替代图标显示的上一页文字
+- prevIcon (string | Component，默认 ArrowLeft)：上一页的图标
+- nextText (string，默认 见文档)：替代图标显示的下一页文字
+- nextIcon (string | Component，默认 ArrowRight)：下一页的图标
+- teleported (boolean，默认 true)：是否将下拉菜单 teleport 至 body
+- small (boolean)：是否使用小型分页样式
+- size (unknown)
+- background (boolean)：是否为分页按钮添加背景色
+- disabled (boolean)：是否禁用分页
+- hideOnSinglePage (boolean)：只有一页时是否隐藏
+- appendSizeTo (unknown)
+
+## Events
+
+- update:currentPage((currentPage: number))：当前页数变化时触发
+- update:pageSize((pageSize: number))：每页条目数变化时触发
+- sizeChange((val: number))：pageSize 改变时触发
+- change((currentPage: number, pageSize: number))：当前页数或每页条目数变化时触发
+- currentChange((val: number))：currentPage 改变时触发
+- prevClick((val: number))：点击上一页按钮改变当前页时触发
+- nextClick((val: number))：点击下一页按钮改变当前页时触发
+
+## Slots
+
+- default：自定义默认内容
+
+## 视觉提示
+
+- 形状：条状或列表
+- 密度：中等
+- 插槽内容：default：自定义默认内容
+- CSS 变量：--el-color-primary、--el-text-color-regular、--el-bg-color
+
+## 示例
+
+### 基础分页
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { EpPagination } from 'ep-craft'
+
+const page = ref(1)
+</script>
+
+<template>
+  <ep-pagination v-model:current-page="page" :total="120" layout="prev, pager, next" />
+</template>
+```
+
+### 每页条数
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { EpPagination } from 'ep-craft'
+
+const page = ref(1)
+const pageSize = ref(20)
+</script>
+
+<template>
+  <ep-pagination
+    v-model:current-page="page"
+    v-model:page-size="pageSize"
+    :total="200"
+    :page-sizes="[10, 20, 50]"
+    layout="total, sizes, prev, pager, next"
+  />
+</template>
+```
+
+## 相关条目
+
+- EpTable
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/popconfirm.json

@@ -0,0 +1,240 @@
+{
+  "entry": {
+    "category": "layout",
+    "events": [
+      {
+        "description": "点击确认按钮时触发",
+        "name": "confirm",
+        "params": "(e: MouseEvent)"
+      },
+      {
+        "description": "点击取消按钮时触发",
+        "name": "cancel",
+        "params": "(e: MouseEvent)"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpButton, EpPopconfirm } from 'ep-craft'\n\nconst remove = () => {\n  // 执行删除逻辑\n}\n</script>\n\n<template>\n  <ep-popconfirm title=\"确认删除该记录？\" @confirm=\"remove\">\n    <template #reference>\n      <ep-button type=\"danger\">删除</ep-button>\n    </template>\n  </ep-popconfirm>\n</template>",
+        "id": "popconfirm-1",
+        "language": "vue",
+        "title": "气泡确认"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:popconfirm",
+    "keywords": {
+      "en": [
+        "popconfirm",
+        "confirm",
+        "layout"
+      ],
+      "zh": [
+        "气泡确认框",
+        "布局"
+      ]
+    },
+    "kind": "component",
+    "name": "EpPopconfirm",
+    "nonUseCases": [
+      "已有明确外层布局且无需此语义时"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "标题",
+        "hasDefault": false,
+        "name": "title",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "确认按钮文本",
+        "hasDefault": false,
+        "name": "confirmButtonText",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "取消按钮文本",
+        "hasDefault": false,
+        "name": "cancelButtonText",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "primary",
+        "description": "确认按钮类型",
+        "hasDefault": true,
+        "name": "confirmButtonType",
+        "required": false,
+        "type": "'default' | 'primary' | 'success' | 'warning' | 'info' | 'danger' | 'text'"
+      },
+      {
+        "alias": null,
+        "defaultText": "text",
+        "description": "取消按钮类型",
+        "hasDefault": true,
+        "name": "cancelButtonType",
+        "required": false,
+        "type": "'default' | 'primary' | 'success' | 'warning' | 'info' | 'danger' | 'text'"
+      },
+      {
+        "alias": null,
+        "defaultText": "QuestionFilled",
+        "description": "图标组件",
+        "hasDefault": true,
+        "name": "icon",
+        "required": false,
+        "type": "string | Component"
+      },
+      {
+        "alias": null,
+        "defaultText": "#f90",
+        "description": "图标颜色",
+        "hasDefault": true,
+        "name": "iconColor",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否隐藏图标",
+        "hasDefault": false,
+        "name": "hideIcon",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "200",
+        "description": "消失延迟，单位 ms",
+        "hasDefault": true,
+        "name": "hideAfter",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "light",
+        "description": "提示框主题",
+        "hasDefault": true,
+        "name": "effect",
+        "required": false,
+        "type": "'dark' | 'light'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "是否 teleport 到 body",
+        "hasDefault": true,
+        "name": "teleported",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "未激活且该值为 false 时是否销毁",
+        "hasDefault": false,
+        "name": "persistent",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "150",
+        "description": "宽度，最小 150px",
+        "hasDefault": true,
+        "name": "width",
+        "required": false,
+        "type": "string | number"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "是否启用虚拟触发",
+        "hasDefault": false,
+        "name": "virtualTriggering",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "虚拟触发时所依附的元素",
+        "hasDefault": false,
+        "name": "virtualRef",
+        "required": false,
+        "type": "HTMLElement | Component"
+      }
+    ],
+    "related": [
+      "EpTooltip",
+      "EpDialog"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "气泡确认框内容",
+        "name": "default"
+      },
+      {
+        "description": "触发元素内容",
+        "name": "reference"
+      },
+      {
+        "description": "自定义操作区，参数为 `{ confirm, cancel }`",
+        "name": "actions"
+      }
+    ],
+    "slug": "popconfirm",
+    "summary": "气泡确认框，页面结构与浮层交互",
+    "tag": "ep-popconfirm",
+    "useCases": [
+      "使用气泡确认框组织页面区域与间距",
+      "承载内容分组或浮层交互"
+    ],
+    "variants": [
+      {
+        "dimension": "effect",
+        "values": [
+          "dark",
+          "light"
+        ],
+        "when": "通过视觉修饰属性调整外观效果"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-bg-color",
+        "--el-border-color",
+        "--el-border-radius-base"
+      ],
+      "density": "宽松",
+      "shape": "区块容器",
+      "slotContent": [
+        "default：气泡确认框内容",
+        "reference：触发元素内容",
+        "actions：自定义操作区，参数为 `{ confirm, cancel }`"
+      ]
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}