king-design-analyzer 2.2.0 → 2.2.2

package/dist/{chunk-KMIDURUR.mjs → chunk-YRGYDK2I.mjs}

@@ -32244,7 +32244,14 @@ var ComponentRegistry = class {
         newComponents.set(resolvedData.name, resolvedData);
         if (resolvedData.subComponents) {
           for (const sub of resolvedData.subComponents) {
-            newComponents.set(sub.name, sub);
+            newComponents.set(sub.name, {
+              id: sub.name,
+              name: sub.name,
+              props: sub.props || [],
+              events: sub.events || [],
+              slots: sub.slots || [],
+              methods: sub.methods || []
+            });
           }
         }
       }
@@ -33060,23 +33067,7 @@ function checkNestingRules(tagName, metadata, ancestors, violations) {
     });
   }
 }
-function checkComponentSpecificRules(tagName, node, violations) {
-  if (tagName === "Dropdown") {
-    node.children?.forEach((child) => {
-      if (child.type === 1 && child.tag === "template") {
-        const slotProp = child.props?.find(
-          (p) => p.type === 7 && p.name === "slot" && p.arg?.content === "menu"
-        );
-        if (slotProp) {
-          violations.push({
-            rule: "DropdownMenu \u4E0D\u80FD\u653E\u5728 #menu \u63D2\u69FD\u4E2D",
-            match: "<template #menu>",
-            suggestion: "\u8BF7\u79FB\u9664 <template #menu>\uFF0C\u5C06 DropdownMenu \u76F4\u63A5\u4F5C\u4E3A Dropdown \u7684\u7B2C\u4E8C\u4E2A\u5B50\u5143\u7D20"
-          });
-        }
-      }
-    });
-  }
+function checkComponentSpecificRules(tagName, node, metadata, violations) {
   if (tagName === "Table") {
     node.props.forEach((prop) => {
       if (prop.type === 6 && (prop.name === "rowKey" || prop.name === "row-key")) {
@@ -33099,23 +33090,110 @@ function checkComponentSpecificRules(tagName, node, violations) {
       }
     });
   }
-  if (tagName === "TableColumn") {
-    node.children?.forEach((child) => {
-      if (child.type === 1 && child.tag === "template") {
-        const slotProp = child.props?.find((p) => p.type === 7 && p.name === "slot");
-        if (slotProp && slotProp.exp && slotProp.exp.content) {
-          const exp = slotProp.exp.content.trim();
-          if (exp.startsWith("{") && exp.endsWith("}")) {
-            violations.push({
-              rule: "TableColumn \u63D2\u69FD\u53C2\u6570\u5E94\u4E3A\u6570\u7EC4\u7ED3\u6784",
-              match: exp,
-              suggestion: `King Design \u8868\u683C\u63D2\u69FD\u53C2\u6570\u4E3A\u6570\u7EC4\u987A\u5E8F\u4F20\u9012\uFF0C\u8BF7\u5C06 ${exp} \u6539\u4E3A [row]`
-            });
-          }
-        }
-      }
-    });
+  if (!metadata?.slots?.length) {
+    return;
+  }
+  const validateSlotBinding = (slotName, expression) => {
+    if (!expression) return;
+    const slot = metadata.slots.find((item) => item.name === slotName);
+    if (!slot) return;
+    const exp = expression.trim();
+    const bindingType = resolveSlotBindingType(slot);
+    if (!bindingType) return;
+    if (bindingType === "none") {
+      violations.push({
+        rule: `${tagName} \u63D2\u69FD #${slotName} \u4E0D\u63D0\u4F9B\u53C2\u6570`,
+        match: exp,
+        suggestion: `\u8BF7\u79FB\u9664 ${slotName} \u63D2\u69FD\u4E0A\u7684\u53C2\u6570\u58F0\u660E`
+      });
+      return;
+    }
+    if (bindingType === "array" && isObjectDestructuringExpression(exp)) {
+      violations.push({
+        rule: `${tagName} \u63D2\u69FD\u53C2\u6570\u5E94\u4E3A\u6570\u7EC4\u7ED3\u6784`,
+        match: exp,
+        suggestion: `\u8BF7\u5C06 ${exp} \u6539\u4E3A ${getSlotBindingExample(slot, "array")}`
+      });
+      return;
+    }
+    if (bindingType === "object" && isArrayDestructuringExpression(exp)) {
+      violations.push({
+        rule: `${tagName} \u63D2\u69FD\u53C2\u6570\u5E94\u4E3A\u5BF9\u8C61\u7ED3\u6784`,
+        match: exp,
+        suggestion: `\u8BF7\u5C06 ${exp} \u6539\u4E3A ${getSlotBindingExample(slot, "object")}`
+      });
+      return;
+    }
+    if (bindingType === "single" && (isArrayDestructuringExpression(exp) || isObjectDestructuringExpression(exp))) {
+      violations.push({
+        rule: `${tagName} \u63D2\u69FD\u53C2\u6570\u5E94\u4E3A\u5355\u503C\u7ED3\u6784`,
+        match: exp,
+        suggestion: `\u8BF7\u5C06 ${exp} \u6539\u4E3A ${getSlotBindingExample(slot, "single")}`
+      });
+    }
+  };
+  node.props.forEach((prop) => {
+    if (prop.type !== 7 || prop.name !== "slot") return;
+    validateSlotBinding(slotNameFromVSlotDirective(prop), getDirectiveExpressionContent(prop.exp));
+  });
+  node.children?.forEach((child) => {
+    if (child.type !== 1 || child.tag !== "template") return;
+    const slotProp = child.props?.find((p) => p.type === 7 && p.name === "slot");
+    if (!slotProp) return;
+    validateSlotBinding(slotNameFromVSlotDirective(slotProp), getDirectiveExpressionContent(slotProp.exp));
+  });
+}
+function isArrayDestructuringExpression(expression) {
+  return expression.startsWith("[") && expression.endsWith("]");
+}
+function isObjectDestructuringExpression(expression) {
+  return expression.startsWith("{") && expression.endsWith("}");
+}
+function extractBindingExpressionFromVueTemplate(vueTemplate) {
+  if (!vueTemplate) return void 0;
+  const match = vueTemplate.match(/=\s*"([^"]+)"/);
+  return match?.[1]?.trim();
+}
+function getDirectiveExpressionContent(exp) {
+  if (!exp || !("content" in exp)) return void 0;
+  return typeof exp.content === "string" ? exp.content : void 0;
+}
+function resolveSlotBindingType(slot) {
+  if (slot.bindingType) {
+    return slot.bindingType;
+  }
+  const templateExpression = extractBindingExpressionFromVueTemplate(slot.vueTemplate);
+  if (templateExpression) {
+    if (isArrayDestructuringExpression(templateExpression)) return "array";
+    if (isObjectDestructuringExpression(templateExpression)) return "object";
+  }
+  const destructuringExample = slot.slotProps?.find((prop) => prop.destructuringExample)?.destructuringExample?.trim();
+  if (destructuringExample) {
+    if (isArrayDestructuringExpression(destructuringExample)) return "array";
+    if (isObjectDestructuringExpression(destructuringExample)) return "object";
+  }
+  return void 0;
+}
+function getSlotBindingExample(slot, fallbackType) {
+  const templateExpression = extractBindingExpressionFromVueTemplate(slot.vueTemplate);
+  if (templateExpression) {
+    return templateExpression;
+  }
+  const destructuringExample = slot.slotProps?.find((prop) => prop.destructuringExample)?.destructuringExample?.trim();
+  if (destructuringExample) {
+    return destructuringExample;
+  }
+  const paramNames = slot.slotProps?.map((prop) => prop.name).filter(Boolean) || [];
+  if (paramNames.length > 0) {
+    if (fallbackType === "single") {
+      return paramNames[0];
+    }
+    return fallbackType === "array" ? `[${paramNames.join(", ")}]` : `{ ${paramNames.join(", ")} }`;
+  }
+  if (fallbackType === "single") {
+    return "slotProp";
   }
+  return fallbackType === "array" ? "[slotProps]" : "{ slotProps }";
 }
 function typeRawAllowsNumber(typeRaw) {
   if (!typeRaw) return false;
@@ -33281,7 +33359,7 @@ function checkTemplate(node, violations, ancestors) {
     if (metadata) {
       checkNestingRules(displayTag, metadata, ancestors, violations);
     }
-    checkComponentSpecificRules(displayTag, elementNode, violations);
+    checkComponentSpecificRules(displayTag, elementNode, metadata, violations);
     if (metadata) {
       checkProps(displayTag, elementNode, metadata, violations);
       checkEvents(displayTag, elementNode, metadata, violations);

package/dist/full/index.d.mts

@@ -2,6 +2,8 @@ interface ValidationLayer {
     name: string;
     passed: boolean;
     errors: string[];
+    warnings?: string[];
+    status?: 'passed' | 'failed' | 'env_dependent' | 'runtime_skipped';
 }
 interface UnifiedValidationResult {
     passed: boolean;

package/dist/full/index.d.ts

@@ -2,6 +2,8 @@ interface ValidationLayer {
     name: string;
     passed: boolean;
     errors: string[];
+    warnings?: string[];
+    status?: 'passed' | 'failed' | 'env_dependent' | 'runtime_skipped';
 }
 interface UnifiedValidationResult {
     passed: boolean;

package/dist/full/index.js

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkCJGGFVQJ_js = require('../chunk-CJGGFVQJ.js');
-require('../chunk-SZYVGYKK.js');
-require('../chunk-EYKZY2F3.js');
-require('../chunk-CR3GC4H3.js');
+var chunkHARQRI4F_js = require('../chunk-HARQRI4F.js');
+require('../chunk-XPHDD6XR.js');
+require('../chunk-V5N65MRP.js');
+require('../chunk-DHLWNT53.js');
 require('../chunk-KF5YBEM5.js');
 require('../chunk-JSBRDJBE.js');
 
@@ -11,9 +11,9 @@ require('../chunk-JSBRDJBE.js');
 
 Object.defineProperty(exports, "validateCode", {
   enumerable: true,
-  get: function () { return chunkCJGGFVQJ_js.validateCode; }
+  get: function () { return chunkHARQRI4F_js.validateCode; }
 });
 Object.defineProperty(exports, "validateCodeSync", {
   enumerable: true,
-  get: function () { return chunkCJGGFVQJ_js.validateCodeSync; }
+  get: function () { return chunkHARQRI4F_js.validateCodeSync; }
 });

package/dist/full/index.mjs

@@ -1,6 +1,6 @@
-export { validateCode, validateCodeSync } from '../chunk-XGPHQHLR.mjs';
-import '../chunk-KMIDURUR.mjs';
-import '../chunk-D2SXGGTX.mjs';
-import '../chunk-BI5TIQID.mjs';
+export { validateCode, validateCodeSync } from '../chunk-BSCASJTV.mjs';
+import '../chunk-YRGYDK2I.mjs';
+import '../chunk-6HOIRUQB.mjs';
+import '../chunk-4OTQAQ6J.mjs';
 import '../chunk-QC6VTSA3.mjs';
 import '../chunk-UJCSKKID.mjs';

package/dist/index.js

@@ -1,11 +1,11 @@
 'use strict';
 
-var chunkTA3SV4SP_js = require('./chunk-TA3SV4SP.js');
+var chunkJJ6AB4ZH_js = require('./chunk-JJ6AB4ZH.js');
 require('./chunk-YTEYDSDW.js');
-var chunkCJGGFVQJ_js = require('./chunk-CJGGFVQJ.js');
-var chunkSZYVGYKK_js = require('./chunk-SZYVGYKK.js');
-var chunkEYKZY2F3_js = require('./chunk-EYKZY2F3.js');
-var chunkCR3GC4H3_js = require('./chunk-CR3GC4H3.js');
+var chunkHARQRI4F_js = require('./chunk-HARQRI4F.js');
+var chunkXPHDD6XR_js = require('./chunk-XPHDD6XR.js');
+var chunkV5N65MRP_js = require('./chunk-V5N65MRP.js');
+var chunkDHLWNT53_js = require('./chunk-DHLWNT53.js');
 require('./chunk-KF5YBEM5.js');
 require('./chunk-JSBRDJBE.js');
 
@@ -13,33 +13,33 @@ require('./chunk-JSBRDJBE.js');
 
 Object.defineProperty(exports, "validateCompilation", {
   enumerable: true,
-  get: function () { return chunkTA3SV4SP_js.validateCompilation; }
+  get: function () { return chunkJJ6AB4ZH_js.validateCompilation; }
 });
 Object.defineProperty(exports, "validateCode", {
   enumerable: true,
-  get: function () { return chunkCJGGFVQJ_js.validateCode; }
+  get: function () { return chunkHARQRI4F_js.validateCode; }
 });
 Object.defineProperty(exports, "validateCodeSync", {
   enumerable: true,
-  get: function () { return chunkCJGGFVQJ_js.validateCodeSync; }
+  get: function () { return chunkHARQRI4F_js.validateCodeSync; }
 });
 Object.defineProperty(exports, "analyzeCodeWithAST", {
   enumerable: true,
-  get: function () { return chunkSZYVGYKK_js.analyzeCodeWithAST; }
+  get: function () { return chunkXPHDD6XR_js.analyzeCodeWithAST; }
 });
 Object.defineProperty(exports, "componentRegistry", {
   enumerable: true,
-  get: function () { return chunkSZYVGYKK_js.componentRegistry; }
+  get: function () { return chunkXPHDD6XR_js.componentRegistry; }
 });
 Object.defineProperty(exports, "validateRuntimePrecheck", {
   enumerable: true,
-  get: function () { return chunkEYKZY2F3_js.validateRuntimePrecheck; }
+  get: function () { return chunkV5N65MRP_js.validateRuntimePrecheck; }
 });
 Object.defineProperty(exports, "compileSFC", {
   enumerable: true,
-  get: function () { return chunkCR3GC4H3_js.compileSFC; }
+  get: function () { return chunkDHLWNT53_js.compileSFC; }
 });
 Object.defineProperty(exports, "scopeStyles", {
   enumerable: true,
-  get: function () { return chunkCR3GC4H3_js.scopeStyles; }
+  get: function () { return chunkDHLWNT53_js.scopeStyles; }
 });

package/dist/index.mjs

@@ -1,8 +1,8 @@
-export { validateCompilation } from './chunk-3LYQ5XFM.mjs';
+export { validateCompilation } from './chunk-NZL6T22V.mjs';
 import './chunk-5H7N2A5X.mjs';
-export { validateCode, validateCodeSync } from './chunk-XGPHQHLR.mjs';
-export { analyzeCodeWithAST, componentRegistry } from './chunk-KMIDURUR.mjs';
-export { validateRuntimePrecheck } from './chunk-D2SXGGTX.mjs';
-export { compileSFC, scopeStyles } from './chunk-BI5TIQID.mjs';
+export { validateCode, validateCodeSync } from './chunk-BSCASJTV.mjs';
+export { analyzeCodeWithAST, componentRegistry } from './chunk-YRGYDK2I.mjs';
+export { validateRuntimePrecheck } from './chunk-6HOIRUQB.mjs';
+export { compileSFC, scopeStyles } from './chunk-4OTQAQ6J.mjs';
 import './chunk-QC6VTSA3.mjs';
 import './chunk-UJCSKKID.mjs';

package/dist/metadata/index.d.mts

@@ -51,6 +51,21 @@ interface ComponentSlot {
     description: string;
     vueTemplate?: string;
     usageExample?: string;
+    bindingType?: 'array' | 'object' | 'single' | 'none';
+    slotProps?: {
+        name: string;
+        type?: string;
+        description?: string;
+        destructuringExample?: string;
+    }[];
+}
+interface ComponentSubComponent {
+    name: string;
+    description: string;
+    props?: ComponentProp[];
+    events?: ComponentEvent[];
+    slots?: ComponentSlot[];
+    methods?: ComponentMethod[];
 }
 interface ComponentMetadata {
     id: string;
@@ -64,7 +79,7 @@ interface ComponentMetadata {
     slots: ComponentSlot[];
     methods?: ComponentMethod[];
     examples?: any[];
-    subComponents?: any[];
+    subComponents?: ComponentSubComponent[];
     commonMistakes?: any[];
     searchKeywords?: string[];
     useCases?: string[];
@@ -94,4 +109,4 @@ declare function getComponentsDir(): string;
  */
 declare function getComponentPath(componentName: string): string;
 
-export { type ComponentActionParam, type ComponentEvent, type ComponentMetadata, type ComponentMethod, type ComponentProp, type ComponentSlot, getAllComponentsMetadata, getComponentMetadata, getComponentPath, getComponentsDir, getComponentsList };
+export { type ComponentActionParam, type ComponentEvent, type ComponentMetadata, type ComponentMethod, type ComponentProp, type ComponentSlot, type ComponentSubComponent, getAllComponentsMetadata, getComponentMetadata, getComponentPath, getComponentsDir, getComponentsList };

package/dist/metadata/index.d.ts

@@ -51,6 +51,21 @@ interface ComponentSlot {
     description: string;
     vueTemplate?: string;
     usageExample?: string;
+    bindingType?: 'array' | 'object' | 'single' | 'none';
+    slotProps?: {
+        name: string;
+        type?: string;
+        description?: string;
+        destructuringExample?: string;
+    }[];
+}
+interface ComponentSubComponent {
+    name: string;
+    description: string;
+    props?: ComponentProp[];
+    events?: ComponentEvent[];
+    slots?: ComponentSlot[];
+    methods?: ComponentMethod[];
 }
 interface ComponentMetadata {
     id: string;
@@ -64,7 +79,7 @@ interface ComponentMetadata {
     slots: ComponentSlot[];
     methods?: ComponentMethod[];
     examples?: any[];
-    subComponents?: any[];
+    subComponents?: ComponentSubComponent[];
     commonMistakes?: any[];
     searchKeywords?: string[];
     useCases?: string[];
@@ -94,4 +109,4 @@ declare function getComponentsDir(): string;
  */
 declare function getComponentPath(componentName: string): string;
 
-export { type ComponentActionParam, type ComponentEvent, type ComponentMetadata, type ComponentMethod, type ComponentProp, type ComponentSlot, getAllComponentsMetadata, getComponentMetadata, getComponentPath, getComponentsDir, getComponentsList };
+export { type ComponentActionParam, type ComponentEvent, type ComponentMetadata, type ComponentMethod, type ComponentProp, type ComponentSlot, type ComponentSubComponent, getAllComponentsMetadata, getComponentMetadata, getComponentPath, getComponentsDir, getComponentsList };

package/dist/runtime/index.d.mts

@@ -4,6 +4,8 @@ interface ValidationLayer {
     name: string;
     passed: boolean;
     errors: string[];
+    warnings?: string[];
+    status?: 'passed' | 'failed' | 'env_dependent' | 'runtime_skipped';
 }
 /**
  * 运行时预检查 (模拟执行)

package/dist/runtime/index.d.ts

@@ -4,6 +4,8 @@ interface ValidationLayer {
     name: string;
     passed: boolean;
     errors: string[];
+    warnings?: string[];
+    status?: 'passed' | 'failed' | 'env_dependent' | 'runtime_skipped';
 }
 /**
  * 运行时预检查 (模拟执行)

package/dist/runtime/index.js

@@ -1,16 +1,16 @@
 'use strict';
 
-var chunkEYKZY2F3_js = require('../chunk-EYKZY2F3.js');
-var chunkCR3GC4H3_js = require('../chunk-CR3GC4H3.js');
+var chunkV5N65MRP_js = require('../chunk-V5N65MRP.js');
+var chunkDHLWNT53_js = require('../chunk-DHLWNT53.js');
 require('../chunk-JSBRDJBE.js');
 
 
 
 Object.defineProperty(exports, "validateRuntimePrecheck", {
   enumerable: true,
-  get: function () { return chunkEYKZY2F3_js.validateRuntimePrecheck; }
+  get: function () { return chunkV5N65MRP_js.validateRuntimePrecheck; }
 });
 Object.defineProperty(exports, "compileSFC", {
   enumerable: true,
-  get: function () { return chunkCR3GC4H3_js.compileSFC; }
+  get: function () { return chunkDHLWNT53_js.compileSFC; }
 });

package/dist/runtime/index.mjs

@@ -1,3 +1,3 @@
-export { validateRuntimePrecheck } from '../chunk-D2SXGGTX.mjs';
-export { compileSFC } from '../chunk-BI5TIQID.mjs';
+export { validateRuntimePrecheck } from '../chunk-6HOIRUQB.mjs';
+export { compileSFC } from '../chunk-4OTQAQ6J.mjs';
 import '../chunk-UJCSKKID.mjs';

package/dist/static/index.js

@@ -1,20 +1,20 @@
 'use strict';
 
-var chunkTA3SV4SP_js = require('../chunk-TA3SV4SP.js');
-var chunkCR3GC4H3_js = require('../chunk-CR3GC4H3.js');
+var chunkJJ6AB4ZH_js = require('../chunk-JJ6AB4ZH.js');
+var chunkDHLWNT53_js = require('../chunk-DHLWNT53.js');
 require('../chunk-JSBRDJBE.js');
 
 
 
 Object.defineProperty(exports, "validateCompilation", {
   enumerable: true,
-  get: function () { return chunkTA3SV4SP_js.validateCompilation; }
+  get: function () { return chunkJJ6AB4ZH_js.validateCompilation; }
 });
 Object.defineProperty(exports, "compileSFC", {
   enumerable: true,
-  get: function () { return chunkCR3GC4H3_js.compileSFC; }
+  get: function () { return chunkDHLWNT53_js.compileSFC; }
 });
 Object.defineProperty(exports, "scopeStyles", {
   enumerable: true,
-  get: function () { return chunkCR3GC4H3_js.scopeStyles; }
+  get: function () { return chunkDHLWNT53_js.scopeStyles; }
 });

package/dist/static/index.mjs

@@ -1,3 +1,3 @@
-export { validateCompilation } from '../chunk-3LYQ5XFM.mjs';
-export { compileSFC, scopeStyles } from '../chunk-BI5TIQID.mjs';
+export { validateCompilation } from '../chunk-NZL6T22V.mjs';
+export { compileSFC, scopeStyles } from '../chunk-4OTQAQ6J.mjs';
 import '../chunk-UJCSKKID.mjs';

package/docs_for_llm/actions.doc.md

@@ -20,7 +20,17 @@ import { Actions } from '@ksyun-internal/versatile';
 ## 插槽 (Slots)
 | 插槽名 | 说明 | 模板写法 | 示例 |
 | --- | --- | --- | --- |
-| btnText | 自定义按钮文案渲染 | `<template #btnText="{ action }">...</template>` | - |
+| btnText | 自定义按钮文案渲染 | `<template #btnText="{ action }">...</template>` | `<Actions>
+  <template <template #btnText="{ action }">...</template>>
+    {{ action }}
+  </template>
+</Actions>` |
+
+### 插槽参数说明
+**btnText**
+
+- 参数结构: <template #btnText="{ action }">...</template>
+- 参数列表: `action: ActionConfig`
 
 ## 使用示例
 ### 表格操作列中的主次操作

package/docs_for_llm/advancedset.doc.md

@@ -33,7 +33,16 @@ import { AdvancedSet } from '@ksyun-internal/versatile';
 ## 插槽 (Slots)
 | 插槽名 | 说明 | 模板写法 | 示例 |
 | --- | --- | --- | --- |
-| default | 高级设置内容区域 | `<AdvancedSet>...</AdvancedSet>` | - |
+| default | 高级设置内容区域 | `<AdvancedSet>...</AdvancedSet>` | `<AdvancedSet>
+  <template <AdvancedSet>...</AdvancedSet>>
+    自定义default内容
+  </template>
+</AdvancedSet>` |
+
+### 插槽参数说明
+**default**
+
+- 参数结构: 无参数
 
 ## 使用示例
 ### 购买页中的高级设置折叠区

package/docs_for_llm/affix.doc.md

@@ -37,6 +37,11 @@ import { Affix } from '@king-design/vue';
 | --- | --- | --- | --- |
 | default | 需要被固定的元素 | `#default` | `<Affix><Button>Fixed Button</Button></Affix>` |
 
+### 插槽参数说明
+**default**
+
+- 参数结构: 无参数
+
 ## 常见错误与正确用法 (Anti-Hallucination)
 ### 父容器滚动问题
 > **错误用法**: `<div style="overflow: auto; height: 200px;">