ep-craft 0.1.41 → 0.2.0

package/dist-ai/components/slider.json

@@ -0,0 +1,326 @@
+{
+  "entry": {
+    "category": "form",
+    "events": [
+      {
+        "description": "绑定值变化时触发",
+        "name": "update:modelValue",
+        "params": "(value: number | number[])"
+      },
+      {
+        "description": "数据改变时触发（使用鼠标拖曳时持续触发）",
+        "name": "input",
+        "params": "(value: number | number[])"
+      },
+      {
+        "description": "值改变时触发（使用鼠标拖曳时只在松开鼠标后触发）",
+        "name": "change",
+        "params": "(value: number | number[])"
+      }
+    ],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue'\nimport { EpSlider } from 'ep-craft'\n\nconst value = ref(30)\n</script>\n\n<template>\n  <ep-slider v-model=\"value\" :min=\"0\" :max=\"100\" show-input />\n</template>",
+        "id": "slider-1",
+        "language": "vue",
+        "title": "滑块"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:slider",
+    "keywords": {
+      "en": [
+        "slider",
+        "range",
+        "form"
+      ],
+      "zh": [
+        "滑块",
+        "表单"
+      ]
+    },
+    "kind": "component",
+    "name": "EpSlider",
+    "nonUseCases": [
+      "仅展示静态文本或只读数据时"
+    ],
+    "props": [
+      {
+        "alias": "v-model",
+        "defaultText": "0",
+        "description": "绑定值",
+        "hasDefault": true,
+        "name": "modelValue",
+        "required": false,
+        "type": "number | number[]"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "id",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "0",
+        "description": "最小值",
+        "hasDefault": true,
+        "name": "min",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "100",
+        "description": "最大值",
+        "hasDefault": true,
+        "name": "max",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "1",
+        "description": "步长",
+        "hasDefault": true,
+        "name": "step",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否显示输入框",
+        "hasDefault": false,
+        "name": "showInput",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "在显示输入框的情况下是否显示控制按钮",
+        "hasDefault": true,
+        "name": "showInputControls",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "default",
+        "description": "slider 包装器的大小",
+        "hasDefault": false,
+        "name": "size",
+        "required": false,
+        "type": "'large' | 'default' | 'small'"
+      },
+      {
+        "alias": null,
+        "defaultText": "default",
+        "description": "输入框的大小",
+        "hasDefault": false,
+        "name": "inputSize",
+        "required": false,
+        "type": "'large' | 'default' | 'small'"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否显示间断点",
+        "hasDefault": false,
+        "name": "showStops",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否显示 tooltip",
+        "hasDefault": true,
+        "name": "showTooltip",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "格式化 tooltip message",
+        "hasDefault": true,
+        "name": "formatTooltip",
+        "required": false,
+        "type": "(value: number) => number | string"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否禁用",
+        "hasDefault": true,
+        "name": "disabled",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否开启选择范围",
+        "hasDefault": false,
+        "name": "range",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "是否竖向模式",
+        "hasDefault": false,
+        "name": "vertical",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "slider 高度，竖向模式时必填",
+        "hasDefault": false,
+        "name": "height",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "当选择为范围时的屏幕阅读器标签",
+        "hasDefault": true,
+        "name": "rangeStartLabel",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "当选择为范围时的屏幕阅读器标签",
+        "hasDefault": true,
+        "name": "rangeEndLabel",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "显示屏幕阅读器的 aria-valuenow 属性的格式",
+        "hasDefault": true,
+        "name": "formatValueText",
+        "required": false,
+        "type": "(value: number) => string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "tooltip 的自定义类名",
+        "hasDefault": true,
+        "name": "tooltipClass",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "top",
+        "description": "Tooltip 出现的位置",
+        "hasDefault": true,
+        "name": "placement",
+        "required": false,
+        "type": "Placement"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "标记",
+        "hasDefault": false,
+        "name": "marks",
+        "required": false,
+        "type": "Record<number, string | { style: CSSProperties, label: string }>"
+      },
+      {
+        "alias": null,
+        "defaultText": "true",
+        "description": "是否触发表单验证",
+        "hasDefault": true,
+        "name": "validateEvent",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "persistent",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": false,
+        "name": "ariaLabel",
+        "required": false,
+        "type": "unknown"
+      }
+    ],
+    "related": [
+      "EpInputNumber"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [],
+    "slug": "slider",
+    "summary": "滑块，表单数据录入控件",
+    "tag": "ep-slider",
+    "useCases": [
+      "表单中收集或编辑滑块数据",
+      "与 EpForm、EpFormItem 组合完成校验"
+    ],
+    "variants": [
+      {
+        "dimension": "size",
+        "values": [
+          "large",
+          "default",
+          "small"
+        ],
+        "when": "按容器空间与信息密度选择尺寸"
+      },
+      {
+        "dimension": "state",
+        "values": [
+          "disabled"
+        ],
+        "when": "通过布尔属性切换禁用、加载或选中状态"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-border-color",
+        "--el-border-radius-base",
+        "--el-color-primary",
+        "--el-font-size-base"
+      ],
+      "density": "中等",
+      "shape": "矩形输入框",
+      "slotContent": []
+    }
+  },
+  "generatedAt": "2026-11-03T03:09:12.050Z",
+  "libraryVersion": "0.2.0",
+  "schemaVersion": 1
+}

package/dist-ai/components/slider.md

@@ -0,0 +1,88 @@
+# EpSlider
+
+`ep-slider` · form（表单） · `component:slider`
+
+## 摘要
+
+滑块，表单数据录入控件
+
+## 适用场景
+
+- 适用：表单中收集或编辑滑块数据
+- 适用：与 EpForm、EpFormItem 组合完成校验
+- 不适用：仅展示静态文本或只读数据时
+
+## 关键词
+
+- 中文：滑块、表单
+- English: slider, range, form
+
+## 变体
+
+- size: large/default/small（按容器空间与信息密度选择尺寸）
+- state: disabled（通过布尔属性切换禁用、加载或选中状态）
+
+## Props
+
+- modelValue（别名 v-model） (number | number[]，默认 0)：绑定值
+- id (unknown，默认 见文档)
+- min (number，默认 0)：最小值
+- max (number，默认 100)：最大值
+- step (number，默认 1)：步长
+- showInput (boolean)：是否显示输入框
+- showInputControls (boolean，默认 true)：在显示输入框的情况下是否显示控制按钮
+- size ('large' | 'default' | 'small')：slider 包装器的大小
+- inputSize ('large' | 'default' | 'small')：输入框的大小
+- showStops (boolean)：是否显示间断点
+- showTooltip (boolean，默认 true)：是否显示 tooltip
+- formatTooltip ((value: number) => number | string，默认 见文档)：格式化 tooltip message
+- disabled (boolean，默认 false)：是否禁用
+- range (boolean)：是否开启选择范围
+- vertical (boolean)：是否竖向模式
+- height (string)：slider 高度，竖向模式时必填
+- rangeStartLabel (string，默认 见文档)：当选择为范围时的屏幕阅读器标签
+- rangeEndLabel (string，默认 见文档)：当选择为范围时的屏幕阅读器标签
+- formatValueText ((value: number) => string，默认 见文档)：显示屏幕阅读器的 aria-valuenow 属性的格式
+- tooltipClass (string，默认 见文档)：tooltip 的自定义类名
+- placement (Placement，默认 top)：Tooltip 出现的位置
+- marks (Record<number, string | { style: CSSProperties, label: string }>)：标记
+- validateEvent (boolean，默认 true)：是否触发表单验证
+- persistent (unknown，默认 见文档)
+- ariaLabel (unknown)
+
+## Events
+
+- update:modelValue((value: number | number[]))：绑定值变化时触发
+- input((value: number | number[]))：数据改变时触发（使用鼠标拖曳时持续触发）
+- change((value: number | number[]))：值改变时触发（使用鼠标拖曳时只在松开鼠标后触发）
+
+## 视觉提示
+
+- 形状：矩形输入框
+- 密度：中等
+- CSS 变量：--el-border-color、--el-border-radius-base、--el-color-primary、--el-font-size-base
+
+## 示例
+
+### 滑块
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue'
+import { EpSlider } from 'ep-craft'
+
+const value = ref(30)
+</script>
+
+<template>
+  <ep-slider v-model="value" :min="0" :max="100" show-input />
+</template>
+```
+
+## 相关条目
+
+- EpInputNumber
+
+---
+
+ep-craft 0.2.0

package/dist-ai/components/space.json

@@ -0,0 +1,178 @@
+{
+  "entry": {
+    "category": "feedback",
+    "events": [],
+    "exampleOmittedReason": null,
+    "examples": [
+      {
+        "code": "<script setup lang=\"ts\">\nimport { EpButton, EpSpace } from 'ep-craft'\n</script>\n\n<template>\n  <ep-space size=\"large\">\n    <ep-button>取消</ep-button>\n    <ep-button type=\"primary\">确定</ep-button>\n  </ep-space>\n</template>",
+        "id": "space-1",
+        "language": "vue",
+        "title": "间距"
+      }
+    ],
+    "exposes": [],
+    "hot": false,
+    "id": "component:space",
+    "keywords": {
+      "en": [
+        "space",
+        "gap",
+        "spacing",
+        "feedback"
+      ],
+      "zh": [
+        "间距",
+        "反馈"
+      ]
+    },
+    "kind": "component",
+    "name": "EpSpace",
+    "nonUseCases": [
+      "无需用户感知状态变化时",
+      "需要完整业务弹窗流程时优先使用 Dialog"
+    ],
+    "props": [
+      {
+        "alias": null,
+        "defaultText": "horizontal",
+        "description": "排列的方向",
+        "hasDefault": true,
+        "name": "direction",
+        "required": false,
+        "type": "'vertical' | 'horizontal'"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "类名",
+        "hasDefault": true,
+        "name": "class",
+        "required": false,
+        "type": "string | Array | object"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "",
+        "hasDefault": true,
+        "name": "style",
+        "required": false,
+        "type": "unknown"
+      },
+      {
+        "alias": null,
+        "defaultText": "center",
+        "description": "对齐的方式",
+        "hasDefault": true,
+        "name": "alignment",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": "el-space",
+        "description": "给 space-items 的类名前缀",
+        "hasDefault": false,
+        "name": "prefixCls",
+        "required": false,
+        "type": "string"
+      },
+      {
+        "alias": null,
+        "defaultText": null,
+        "description": "间隔符",
+        "hasDefault": true,
+        "name": "spacer",
+        "required": false,
+        "type": "string | VNode"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "设置是否自动折行",
+        "hasDefault": false,
+        "name": "wrap",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "false",
+        "description": "子元素是否填充父容器",
+        "hasDefault": false,
+        "name": "fill",
+        "required": false,
+        "type": "boolean"
+      },
+      {
+        "alias": null,
+        "defaultText": "100",
+        "description": "填充父容器的比例",
+        "hasDefault": true,
+        "name": "fillRatio",
+        "required": false,
+        "type": "number"
+      },
+      {
+        "alias": null,
+        "defaultText": "small",
+        "description": "间隔大小",
+        "hasDefault": false,
+        "name": "size",
+        "required": false,
+        "type": "'large' | 'default' | 'small' | number | [number, number]"
+      }
+    ],
+    "related": [
+      "EpDivider",
+      "EpRow"
+    ],
+    "relations": {
+      "children": [],
+      "combos": [],
+      "parents": [],
+      "requiredChildren": []
+    },
+    "slots": [
+      {
+        "description": "需要添加间隔的元素",
+        "name": "default"
+      }
+    ],
+    "slug": "space",
+    "summary": "间距，状态与结果反馈",
+    "tag": "ep-space",
+    "useCases": [
+      "展示间距并向用户传达状态",
+      "在操作前后提供即时反馈"
+    ],
+    "variants": [
+      {
+        "dimension": "size",
+        "values": [
+          "large",
+          "default",
+          "small"
+        ],
+        "when": "按容器空间与信息密度选择尺寸"
+      }
+    ],
+    "visual": {
+      "cssVars": [
+        "--el-color-success",
+        "--el-color-warning",
+        "--el-color-danger",
+        "--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/space.md

@@ -0,0 +1,73 @@
+# EpSpace
+
+`ep-space` · feedback（反馈） · `component:space`
+
+## 摘要
+
+间距，状态与结果反馈
+
+## 适用场景
+
+- 适用：展示间距并向用户传达状态
+- 适用：在操作前后提供即时反馈
+- 不适用：无需用户感知状态变化时
+- 不适用：需要完整业务弹窗流程时优先使用 Dialog
+
+## 关键词
+
+- 中文：间距、反馈
+- English: space, gap, spacing, feedback
+
+## 变体
+
+- size: large/default/small（按容器空间与信息密度选择尺寸）
+
+## Props
+
+- direction ('vertical' | 'horizontal'，默认 horizontal)：排列的方向
+- class (string | Array | object，默认 见文档)：类名
+- style (unknown，默认 见文档)
+- alignment (string，默认 center)：对齐的方式
+- prefixCls (string)：给 space-items 的类名前缀
+- spacer (string | VNode，默认 见文档)：间隔符
+- wrap (boolean)：设置是否自动折行
+- fill (boolean)：子元素是否填充父容器
+- fillRatio (number，默认 100)：填充父容器的比例
+- size ('large' | 'default' | 'small' | number | [number, number])：间隔大小
+
+## Slots
+
+- default：需要添加间隔的元素
+
+## 视觉提示
+
+- 形状：行内或块级提示
+- 密度：中等
+- 插槽内容：default：需要添加间隔的元素
+- CSS 变量：--el-color-success、--el-color-warning、--el-color-danger、--el-font-size-base
+
+## 示例
+
+### 间距
+
+```vue
+<script setup lang="ts">
+import { EpButton, EpSpace } from 'ep-craft'
+</script>
+
+<template>
+  <ep-space size="large">
+    <ep-button>取消</ep-button>
+    <ep-button type="primary">确定</ep-button>
+  </ep-space>
+</template>
+```
+
+## 相关条目
+
+- EpDivider
+- EpRow
+
+---
+
+ep-craft 0.2.0