king-design-analyzer 2.1.9 → 2.2.1

package/components/checkbox.json

@@ -70,7 +70,10 @@
       },
       "required": false,
       "default": "undefined",
-      "usageExample": "<Checkbox name=\"agreement\"></Checkbox>"
+      "usageExample": "<Checkbox name=\"agreement\"></Checkbox>",
+      "tags": [
+        "native"
+      ]
     },
     {
       "name": "required",
@@ -81,7 +84,10 @@
       },
       "required": false,
       "default": "undefined",
-      "usageExample": "<Checkbox required></Checkbox>"
+      "usageExample": "<Checkbox required></Checkbox>",
+      "tags": [
+        "native"
+      ]
     },
     {
       "name": "form",
@@ -92,7 +98,10 @@
       },
       "required": false,
       "default": "undefined",
-      "usageExample": "<Checkbox form=\"myForm\"></Checkbox>"
+      "usageExample": "<Checkbox form=\"myForm\"></Checkbox>",
+      "tags": [
+        "native"
+      ]
     },
     {
       "name": "autofocus",
@@ -103,7 +112,38 @@
       },
       "required": false,
       "default": "undefined",
-      "usageExample": "<Checkbox autofocus></Checkbox>"
+      "usageExample": "<Checkbox autofocus></Checkbox>",
+      "tags": [
+        "native"
+      ]
+    },
+    {
+      "name": "autocomplete",
+      "description": "原生 autocomplete 属性，指定浏览器自动补全行为",
+      "type": {
+        "raw": "string",
+        "kind": "string"
+      },
+      "required": false,
+      "default": "undefined",
+      "usageExample": "<Checkbox autocomplete=\"off\"></Checkbox>",
+      "tags": [
+        "native"
+      ]
+    },
+    {
+      "name": "maxlength",
+      "description": "原生 maxlength 属性，组件透传到内部 input 元素",
+      "type": {
+        "raw": "number | string",
+        "kind": "union"
+      },
+      "required": false,
+      "default": "undefined",
+      "usageExample": "<Checkbox :maxlength=\"1\"></Checkbox>",
+      "tags": [
+        "native"
+      ]
     }
   ],
   "events": [
@@ -291,6 +331,13 @@
     "批量选择",
     "权限勾选"
   ],
+  "typeDefinitions": [
+    {
+      "name": "CheckboxValue",
+      "definition": "type CheckboxValue = boolean | string | number",
+      "description": "复选框绑定值类型，可使用布尔值或自定义 trueValue / falseValue。"
+    }
+  ],
   "relatedComponents": [
     "Radio",
     "Switch"

package/components/cidrinput.json

@@ -0,0 +1,140 @@
+{
+    "id": "cidrinput",
+    "name": "CidrInput",
+    "displayName": "CIDR 输入框",
+    "category": "form",
+    "description": "用于录入网段 CIDR 的业务输入组件，把 IP 地址与掩码选择组合在一起，常用于 VPC、子网和安全策略配置。",
+    "importStatement": "import { CidrInput } from '@ksyun-internal/versatile';",
+    "props": [
+        {
+            "name": "modelValue",
+            "description": "CIDR 值，如 192.168.0.0/24",
+            "type": {
+                "raw": "string",
+                "kind": "string"
+            },
+            "required": false
+        },
+        {
+            "name": "vpcCidr",
+            "description": "所属 VPC 的 CIDR，用于约束和提示",
+            "type": {
+                "raw": "string",
+                "kind": "string"
+            },
+            "required": false
+        },
+        {
+            "name": "disabled",
+            "description": "禁用状态或禁用分段配置",
+            "type": {
+                "raw": "boolean | any[]",
+                "kind": "union"
+            },
+            "required": false
+        },
+        {
+            "name": "tooltip",
+            "description": "各分段 tooltip 配置",
+            "type": {
+                "raw": "any[]",
+                "kind": "array"
+            },
+            "required": false
+        },
+        {
+            "name": "maskRange",
+            "description": "可选掩码范围",
+            "type": {
+                "raw": "number[]",
+                "kind": "array"
+            },
+            "required": false,
+            "default": "[0, 32]"
+        }
+    ],
+    "events": [
+        {
+            "name": "update:modelValue",
+            "vueEventName": "@update:modelValue",
+            "description": "CIDR 字符串变化时触发，可直接同步到网络配置表单。",
+            "params": [
+                {
+                    "name": "value",
+                    "type": "string",
+                    "description": "当前输入的 CIDR 字符串。",
+                    "optional": true
+                }
+            ]
+        }
+    ],
+    "slots": [],
+    "methods": [],
+    "examples": [
+        {
+            "id": "cidrinput_subnet",
+            "title": "子网网段录入",
+            "description": "限制掩码范围，并结合 VPC 网段给出约束。",
+            "difficulty": "easy",
+            "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue';\nimport { CidrInput } from '@ksyun-internal/versatile';\n\nconst cidr = ref('192.168.1.0/24');\n</script>\n\n<template>\n  <CidrInput\n    v-model=\"cidr\"\n    vpc-cidr=\"192.168.0.0/16\"\n    :mask-range=\"[16, 28]\"\n  />\n</template>",
+            "tags": [
+                "network",
+                "cidr"
+            ],
+            "usedProps": [
+                "modelValue",
+                "vpcCidr",
+                "maskRange"
+            ],
+            "usedEvents": [
+                "update:modelValue"
+            ],
+            "usedMethods": [],
+            "scenario": "创建子网时录入并校验目标网段。"
+        },
+        {
+            "id": "cidrinput_with_tooltips",
+            "title": "为分段输入补充提示",
+            "description": "给 CIDR 各段提供 tooltip，帮助用户理解输入规则。",
+            "difficulty": "medium",
+            "code": "<script setup lang=\"ts\">\nimport { ref } from 'vue';\nimport { CidrInput } from '@ksyun-internal/versatile';\n\nconst cidr = ref('10.0.0.0/24');\nconst tooltip = ['网络段', '子网段', '主机段', '预留', '掩码长度'];\n</script>\n\n<template>\n  <CidrInput v-model=\"cidr\" :tooltip=\"tooltip\" :mask-range=\"[24, 28]\" />\n</template>",
+            "tags": [
+                "network",
+                "tooltip"
+            ],
+            "usedProps": [
+                "modelValue",
+                "tooltip",
+                "maskRange"
+            ],
+            "usedEvents": [
+                "update:modelValue"
+            ],
+            "usedMethods": [],
+            "scenario": "在网络配置页中用提示文案降低 CIDR 输入门槛。"
+        }
+    ],
+    "searchKeywords": [
+        "cidr",
+        "cidr input",
+        "网段输入",
+        "子网配置",
+        "network cidr",
+        "掩码选择"
+    ],
+    "useCases": [
+        "网络配置",
+        "子网和路由录入",
+        "CIDR 分段输入与校验"
+    ],
+    "typeDefinitions": [
+        {
+            "name": "CidrValue",
+            "definition": "type CidrValue = string",
+            "description": "CIDR 字符串类型，例如 `192.168.0.0/24`。"
+        }
+    ],
+    "relatedComponents": [
+        "IPInput"
+    ]
+}

package/components/code.json

@@ -314,5 +314,12 @@
         "配置文件编辑",
         "JSON 编辑器"
     ],
+    "typeDefinitions": [
+        {
+            "name": "CodeLanguage",
+            "definition": "type CodeLanguage = string",
+            "description": "代码编辑器语言标识，通常使用 javascript、typescript、json 等 Monaco 语言名。"
+        }
+    ],
     "relatedComponents": []
-}
+}