king-design-analyzer 2.1.9 → 2.2.1

package/components/anchorlink.json

@@ -0,0 +1,111 @@
+{
+    "id": "anchorlink",
+    "name": "AnchorLink",
+    "displayName": "锚点链接",
+    "category": "navigation",
+    "description": "Anchor 的子链接组件，用于声明单个锚点项。支持标题、禁用态以及嵌套层级，通常作为 Anchor 的默认插槽子节点出现。",
+    "importStatement": "import { AnchorLink } from '@king-design/vue';",
+    "props": [
+        {
+            "name": "href",
+            "description": "目标元素的 id 或锚点标识",
+            "type": {
+                "raw": "string",
+                "kind": "string"
+            },
+            "required": false,
+            "default": "undefined",
+            "usageExample": "<AnchorLink href=\"section1\" title=\"第一部分\" />"
+        },
+        {
+            "name": "title",
+            "description": "链接标题内容",
+            "type": {
+                "raw": "string | VNode",
+                "kind": "union"
+            },
+            "required": false,
+            "default": "undefined",
+            "usageExample": "<AnchorLink href=\"billing\" title=\"计费说明\" />"
+        },
+        {
+            "name": "disabled",
+            "description": "是否禁用当前锚点链接",
+            "type": {
+                "raw": "boolean",
+                "kind": "boolean"
+            },
+            "required": false,
+            "default": "false",
+            "usageExample": "<AnchorLink href=\"advanced\" title=\"高级设置\" disabled />"
+        }
+    ],
+    "events": [],
+    "slots": [
+        {
+            "name": "default",
+            "description": "自定义链接内容；未设置 title 时可直接通过默认插槽传入文字或节点",
+            "bindingType": "none",
+            "vueTemplate": "#default",
+            "usageExample": "<AnchorLink href=\"section2\">第二部分</AnchorLink>"
+        }
+    ],
+    "methods": [],
+    "examples": [
+        {
+            "id": "anchorlink_basic",
+            "title": "基础链接",
+            "description": "在 Anchor 中声明单个锚点链接。",
+            "difficulty": "easy",
+            "code": "<script setup lang=\"ts\">\nimport { Anchor, AnchorLink } from '@king-design/vue';\n</script>\n<template>\n  <Anchor>\n    <AnchorLink href=\"section1\" title=\"第一部分\" />\n    <AnchorLink href=\"section2\">第二部分</AnchorLink>\n  </Anchor>\n</template>",
+            "tags": [
+                "basic",
+                "default-slot"
+            ],
+            "usedProps": [
+                "href",
+                "title"
+            ],
+            "usedEvents": [],
+            "usedSlots": [
+                "default"
+            ],
+            "usedMethods": [],
+            "scenario": "为章节导航添加单个可点击锚点项。"
+        },
+        {
+            "id": "anchorlink_nested",
+            "title": "嵌套链接",
+            "description": "在纵向 Anchor 中构建层级导航。",
+            "difficulty": "medium",
+            "code": "<script setup lang=\"ts\">\nimport { Anchor, AnchorLink } from '@king-design/vue';\n</script>\n<template>\n  <Anchor>\n    <AnchorLink href=\"overview\" title=\"概览\">\n      <AnchorLink href=\"overview-base\" title=\"基础信息\" />\n      <AnchorLink href=\"overview-network\" title=\"网络配置\" />\n    </AnchorLink>\n    <AnchorLink href=\"billing\" title=\"计费\" />\n  </Anchor>\n</template>",
+            "tags": [
+                "nested",
+                "hierarchy"
+            ],
+            "usedProps": [
+                "href",
+                "title"
+            ],
+            "usedEvents": [],
+            "usedSlots": [
+                "default"
+            ],
+            "usedMethods": [],
+            "scenario": "构建多级目录结构的页面导航。"
+        }
+    ],
+    "searchKeywords": [
+        "anchorlink",
+        "锚点链接",
+        "目录项",
+        "Anchor"
+    ],
+    "useCases": [
+        "Anchor 子导航项",
+        "目录树层级导航"
+    ],
+    "relatedComponents": [
+        "Anchor"
+    ]
+}

package/components/az.json

@@ -78,9 +78,22 @@
     "az",
     "zone",
     "可用区",
-    "机房"
+    "机房",
+    "availability zone",
+    "az select",
+    "可用区选择"
   ],
   "useCases": [
-    "购买页选择可用区"
+    "购买页选择可用区",
+    "与地域联动切换机房",
+    "资源部署位置选择",
+    "高可用架构中选择目标可用区"
+  ],
+  "typeDefinitions": [
+    {
+      "name": "AZItem",
+      "definition": "type AZItem = {\\n  code: string\\n  name: string\\n  regionCode?: string\\n}",
+      "description": "可用区配置项结构，包含可用区编码、名称和所属地域。"
+    }
   ]
 }

package/components/badge.json

@@ -46,6 +46,7 @@
     {
       "name": "default",
       "description": "徽标包裹的元素",
+      "bindingType": "none",
       "vueTemplate": "#default",
       "usageExample": "<Badge><Button>Button</Button></Badge>"
     }
@@ -158,5 +159,12 @@
     "新功能标记",
     "状态点"
   ],
+  "typeDefinitions": [
+    {
+      "name": "BadgeText",
+      "definition": "type BadgeText = string | number",
+      "description": "Badge 展示内容类型，可用于数字计数或短文本标识。"
+    }
+  ],
   "relatedComponents": []
 }

package/components/billtypes.json

@@ -82,9 +82,21 @@
     "price",
     "charge",
     "计费",
-    "价格"
+    "价格",
+    "计费模式",
+    "按量付费",
+    "包年包月"
   ],
   "useCases": [
-    "购买页选择计费模式"
+    "购买页选择计费模式",
+    "切换按量和包年包月",
+    "试用与正式计费方式选择"
+  ],
+  "typeDefinitions": [
+    {
+      "name": "BillTypeItem",
+      "definition": "type BillTypeItem = {\\n  id: number\\n  name: string\\n  trial?: boolean\\n}",
+      "description": "计费类型配置项结构，描述计费模式的标识、文案和试用态。"
+    }
   ]
 }

package/components/breadcrumb.json

@@ -22,7 +22,8 @@
   "slots": [
     {
       "name": "separator",
-      "description": "指定分隔符"
+      "description": "指定分隔符",
+      "bindingType": "none"
     }
   ],
   "methods": [],
@@ -213,6 +214,13 @@
     "多级分类导航",
     "后台管理系统导航"
   ],
+  "typeDefinitions": [
+    {
+      "name": "BreadcrumbLink",
+      "definition": "type BreadcrumbLink = string | { path?: string; name?: string }",
+      "description": "面包屑节点的跳转目标类型，可传字符串路径或路由对象。"
+    }
+  ],
   "relatedComponents": [
     "BreadcrumbItem",
     "Menu"

package/components/button.json

@@ -184,6 +184,17 @@
       ],
       "usageExample": "<Button htmlType=\"submit\">提交表单</Button>"
     },
+    {
+      "name": "color",
+      "description": "自定义按钮颜色，通常用于细粒度的主题色控制",
+      "type": {
+        "raw": "string",
+        "kind": "string"
+      },
+      "required": false,
+      "default": "undefined",
+      "usageExample": "<Button color=\"#1677ff\">自定义颜色按钮</Button>"
+    },
     {
       "name": "tagName",
       "description": "按钮渲染后的实际HTML元素，例如可以传入\"a\"来渲染成超链接",
@@ -195,6 +206,146 @@
       "default": "\"button\"",
       "usageExample": "<Button tagName=\"a\" href=\"https://example.com\" target=\"_blank\">链接按钮</Button>"
     },
+    {
+      "name": "autofocus",
+      "description": "原生 autofocus 属性，页面加载后自动聚焦按钮",
+      "type": {
+        "raw": "boolean",
+        "kind": "boolean"
+      },
+      "required": false,
+      "default": "undefined",
+      "usageExample": "<Button autofocus>自动聚焦</Button>",
+      "tags": [
+        "native"
+      ]
+    },
+    {
+      "name": "form",
+      "description": "原生 form 属性，指定按钮关联的表单 id",
+      "type": {
+        "raw": "string",
+        "kind": "string"
+      },
+      "required": false,
+      "default": "undefined",
+      "usageExample": "<Button form=\"loginForm\" htmlType=\"submit\">提交</Button>",
+      "tags": [
+        "native"
+      ]
+    },
+    {
+      "name": "formaction",
+      "description": "原生 formaction 属性，覆盖表单提交地址",
+      "type": {
+        "raw": "string",
+        "kind": "string"
+      },
+      "required": false,
+      "default": "undefined",
+      "usageExample": "<Button formaction=\"/api/submit\" htmlType=\"submit\">提交</Button>",
+      "tags": [
+        "native"
+      ]
+    },
+    {
+      "name": "formenctype",
+      "description": "原生 formenctype 属性，指定表单提交编码类型",
+      "type": {
+        "raw": "string",
+        "kind": "string"
+      },
+      "required": false,
+      "default": "undefined",
+      "usageExample": "<Button formenctype=\"multipart/form-data\" htmlType=\"submit\">上传</Button>",
+      "tags": [
+        "native"
+      ]
+    },
+    {
+      "name": "formmethod",
+      "description": "原生 formmethod 属性，指定表单提交方法",
+      "type": {
+        "raw": "\"post\" | \"get\" | \"dialog\" | string",
+        "kind": "union"
+      },
+      "required": false,
+      "default": "undefined",
+      "usageExample": "<Button formmethod=\"post\" htmlType=\"submit\">提交</Button>",
+      "tags": [
+        "native"
+      ]
+    },
+    {
+      "name": "formnovalidate",
+      "description": "原生 formnovalidate 属性，提交时跳过原生表单校验",
+      "type": {
+        "raw": "boolean",
+        "kind": "boolean"
+      },
+      "required": false,
+      "default": "undefined",
+      "usageExample": "<Button formnovalidate htmlType=\"submit\">跳过校验</Button>",
+      "tags": [
+        "native"
+      ]
+    },
+    {
+      "name": "formtarget",
+      "description": "原生 formtarget 属性，指定表单响应的打开位置",
+      "type": {
+        "raw": "string",
+        "kind": "string"
+      },
+      "required": false,
+      "default": "undefined",
+      "usageExample": "<Button formtarget=\"_blank\" htmlType=\"submit\">新窗口提交</Button>",
+      "tags": [
+        "native"
+      ]
+    },
+    {
+      "name": "href",
+      "description": "原生 href 属性，当 tagName=\"a\" 时指定跳转链接",
+      "type": {
+        "raw": "string",
+        "kind": "string"
+      },
+      "required": false,
+      "default": "undefined",
+      "usageExample": "<Button tagName=\"a\" href=\"https://example.com\">外部链接</Button>",
+      "tags": [
+        "native"
+      ]
+    },
+    {
+      "name": "target",
+      "description": "原生 target 属性，当 tagName=\"a\" 时指定打开方式",
+      "type": {
+        "raw": "string",
+        "kind": "string"
+      },
+      "required": false,
+      "default": "undefined",
+      "usageExample": "<Button tagName=\"a\" href=\"https://example.com\" target=\"_blank\">新窗口打开</Button>",
+      "tags": [
+        "native"
+      ]
+    },
+    {
+      "name": "download",
+      "description": "原生 download 属性，当 tagName=\"a\" 时提示浏览器下载资源",
+      "type": {
+        "raw": "string",
+        "kind": "string"
+      },
+      "required": false,
+      "default": "undefined",
+      "usageExample": "<Button tagName=\"a\" href=\"/file.pdf\" download=\"demo.pdf\">下载文件</Button>",
+      "tags": [
+        "native"
+      ]
+    },
     {
       "name": "value",
       "description": "对于radio/checkbox类型的按钮组，给按钮指定选中时的值",
@@ -206,6 +357,34 @@
       "default": "undefined",
       "usageExample": "<Button value=\"option1\">选项1</Button>"
     },
+    {
+      "name": "name",
+      "description": "原生 name 属性",
+      "type": {
+        "raw": "string",
+        "kind": "string"
+      },
+      "required": false,
+      "default": "undefined",
+      "usageExample": "<Button name=\"submitBtn\">提交</Button>",
+      "tags": [
+        "native"
+      ]
+    },
+    {
+      "name": "tabindex",
+      "description": "原生 tabindex 属性，控制键盘 Tab 导航顺序",
+      "type": {
+        "raw": "string | number",
+        "kind": "union"
+      },
+      "required": false,
+      "default": "undefined",
+      "usageExample": "<Button :tabindex=\"-1\">跳过焦点</Button>",
+      "tags": [
+        "native"
+      ]
+    },
     {
       "name": "ghost",
       "description": "展示透明背景的按钮，适用于深色背景",
@@ -234,6 +413,7 @@
     {
       "name": "default",
       "description": "按钮内容",
+      "bindingType": "none",
       "vueTemplate": "#default",
       "usageExample": "<Button>按钮文字</Button>"
     }
@@ -504,6 +684,18 @@
     "城市切换单选按钮组",
     "多选标签按钮组"
   ],
+  "typeDefinitions": [
+    {
+      "name": "ButtonType",
+      "definition": "type ButtonType = 'default' | 'primary' | 'danger' | 'warning' | 'success' | 'link'",
+      "description": "按钮语义类型枚举，用于区分主要操作、危险操作和链接样式。"
+    },
+    {
+      "name": "ButtonGroupCheckType",
+      "definition": "type ButtonGroupCheckType = 'radio' | 'checkbox'",
+      "description": "按钮组选择模式枚举，控制单选或多选行为。"
+    }
+  ],
   "relatedComponents": [
     "ButtonGroup",
     "Icon"

package/components/buttonlink.json

@@ -0,0 +1,74 @@
+{
+    "id": "buttonlink",
+    "name": "ButtonLink",
+    "displayName": "链接按钮",
+    "category": "feedback",
+    "description": "外观接近按钮但语义偏链接的操作组件，适合放在详情页头部、说明区或空状态中承载跳转型动作。",
+    "importStatement": "import { ButtonLink } from '@ksyun-internal/versatile';",
+    "props": [],
+    "events": [],
+    "slots": [
+        {
+            "name": "default",
+            "description": "按钮内容",
+            "bindingType": "none",
+            "vueTemplate": "<ButtonLink>...</ButtonLink>"
+        }
+    ],
+    "methods": [],
+    "examples": [
+        {
+            "id": "buttonlink_doc",
+            "title": "详情页中的文档跳转入口",
+            "description": "用按钮样式突出跳转动作，同时保持链接语义。",
+            "difficulty": "easy",
+            "code": "<script setup lang=\"ts\">\nimport { ButtonLink } from '@ksyun-internal/versatile';\n</script>\n\n<template>\n  <ButtonLink>查看 API 文档</ButtonLink>\n</template>",
+            "tags": [
+                "link",
+                "action"
+            ],
+            "usedProps": [],
+            "usedEvents": [],
+            "usedMethods": [],
+            "scenario": "在操作区提供“查看文档”“前往控制台”等跳转动作。"
+        },
+        {
+            "id": "buttonlink_empty_action",
+            "title": "空状态跳转入口",
+            "description": "在空状态说明区域中用链接按钮承载引导操作。",
+            "difficulty": "medium",
+            "code": "<script setup lang=\"ts\">\nimport { ButtonLink } from '@ksyun-internal/versatile';\n</script>\n\n<template>\n  <div>\n    <p>当前没有可用项目。</p>\n    <ButtonLink>前往创建项目</ButtonLink>\n  </div>\n</template>",
+            "tags": [
+                "link",
+                "empty"
+            ],
+            "usedProps": [],
+            "usedEvents": [],
+            "usedMethods": [],
+            "scenario": "在空状态或帮助提示区提供跳转型操作。"
+        }
+    ],
+    "searchKeywords": [
+        "button link",
+        "link button",
+        "链接按钮",
+        "跳转按钮",
+        "文档入口"
+    ],
+    "useCases": [
+        "操作区链接按钮",
+        "详情页跳转入口",
+        "空状态引导操作"
+    ],
+    "typeDefinitions": [
+        {
+            "name": "ButtonLinkText",
+            "definition": "type ButtonLinkText = string",
+            "description": "链接按钮展示文案类型。"
+        }
+    ],
+    "relatedComponents": [
+        "IconTooltip",
+        "Actions"
+    ]
+}

package/components/card.json

@@ -84,15 +84,18 @@
     "slots": [
         {
             "name": "header",
-            "description": "扩展整个头部内容"
+            "description": "扩展整个头部内容",
+            "bindingType": "none"
         },
         {
             "name": "title",
-            "description": "扩展头部标题内容"
+            "description": "扩展头部标题内容",
+            "bindingType": "none"
         },
         {
             "name": "extra",
-            "description": "扩展头部附加内容"
+            "description": "扩展头部附加内容",
+            "bindingType": "none"
         }
     ],
     "methods": [],
@@ -327,8 +330,15 @@
         "设置面板",
         "内容分组展示"
     ],
+    "typeDefinitions": [
+        {
+            "name": "CardSize",
+            "definition": "type CardSize = 'default' | 'small' | 'mini'",
+            "description": "卡片尺寸枚举，用于控制内边距和布局密度。"
+        }
+    ],
     "relatedComponents": [
         "CardColumn",
         "Collapse"
     ]
-}
+}