king-design-analyzer 2.2.0 → 2.2.2

package/docs_for_llm/vdrawer.doc.md

@@ -50,10 +50,39 @@ import { VDrawer } from '@ksyun-internal/versatile';
 ## 插槽 (Slots)
 | 插槽名 | 说明 | 模板写法 | 示例 |
 | --- | --- | --- | --- |
-| default | 抽屉主体内容区域 | `<VDrawer>...</VDrawer>` | - |
-| header | 自定义抽屉头部 | `<template #header>...</template>` | - |
-| footer | 自定义抽屉底部操作区 | `<template #footer>...</template>` | - |
-| trigger | 自定义触发按钮或触发区域 | `<template #trigger>...</template>` | - |
+| default | 抽屉主体内容区域 | `<VDrawer>...</VDrawer>` | `<VDrawer>
+  <template <VDrawer>...</VDrawer>>
+    自定义default内容
+  </template>
+</VDrawer>` |
+| header | 自定义抽屉头部 | `<template #header>...</template>` | `<VDrawer>
+  <template <template #header>...</template>>头部内容</template>
+</VDrawer>` |
+| footer | 自定义抽屉底部操作区 | `<template #footer>...</template>` | `<VDrawer>
+  <template <template #footer>...</template>>底部内容</template>
+</VDrawer>` |
+| trigger | 自定义触发按钮或触发区域 | `<template #trigger>...</template>` | `<VDrawer>
+  <template <template #trigger>...</template>>
+    自定义trigger内容
+  </template>
+</VDrawer>` |
+
+### 插槽参数说明
+**default**
+
+- 参数结构: 无参数
+
+**header**
+
+- 参数结构: 无参数
+
+**footer**
+
+- 参数结构: 无参数
+
+**trigger**
+
+- 参数结构: 无参数
 
 ## 使用示例
 ### 侧边编辑抽屉

package/docs_for_llm/virtuallist.doc.md

@@ -16,23 +16,188 @@ import { VirtualList } from '@king-design/vue';
 | --- | --- | --- | --- | --- | --- | --- |
 | disabled | `boolean` | `false` | 否 | 是否禁用虚拟化，禁用后会渲染所有元素 | - | `<VirtualList disabled></VirtualList>` |
 
+## 插槽 (Slots)
+| 插槽名 | 说明 | 模板写法 | 示例 |
+| --- | --- | --- | --- |
+| default | 列表项渲染内容，通常配合 v-for 渲染大量行。 | `#default` | `<VirtualList style="height: 400px;">
+  <template #default>
+    <div v-for="item in data" :key="item.value">{{ item.label }}</div>
+  </template>
+</VirtualList>` |
+
+### 插槽参数说明
+**default**
+
+- 参数结构: 无参数
+
 ## 子组件 (Sub-Components)
 ### VirtualListContainer
 虚拟列表容器组件，用于组合式使用
 
+#### 组合示例
+##### 组合式使用
+**场景**: 使用子组件进行复杂布局
+
+使用子组件进行组合
+
+```vue
+<script setup lang="ts">
+import { ref, onMounted } from 'vue';
+import { VirtualListContainer, VirtualListWrapper, VirtualListPhantom, VirtualListRows } from '@king-design/vue';
+
+const data = ref<{value: number; label: string}[]>([]);
+
+onMounted(() => {
+  const arr = [];
+  for (let i = 0; i < 10000; i++) {
+    arr.push({ value: i, label: `列表项 ${i}` });
+  }
+  data.value = arr;
+});
+</script>
+<template>
+  <div style="height: 400px;">
+    <VirtualListContainer>
+      <VirtualListPhantom />
+      <VirtualListWrapper tagName="ul">
+        <VirtualListRows>
+          <li v-for="item in data" :key="item.value" style="height: 40px; line-height: 40px;">
+            {{ item.label }}
+          </li>
+        </VirtualListRows>
+      </VirtualListWrapper>
+    </VirtualListContainer>
+  </div>
+</template>
+```
+
 ### VirtualListWrapper
 虚拟列表包装器组件，可通过 tagName 属性指定标签类型
 
+#### 属性 (Props)
 | 属性名 | 类型 | 说明 | 示例 |
 | --- | --- | --- | --- |
 | tagName | `string` | 指定渲染的标签名 | `<VirtualListWrapper tagName="ul"></VirtualListWrapper>` |
 
+#### 组合示例
+##### 组合式使用
+**场景**: 使用子组件进行复杂布局
+
+使用子组件进行组合
+
+**命中的子组件 API**: 属性: tagName
+
+```vue
+<script setup lang="ts">
+import { ref, onMounted } from 'vue';
+import { VirtualListContainer, VirtualListWrapper, VirtualListPhantom, VirtualListRows } from '@king-design/vue';
+
+const data = ref<{value: number; label: string}[]>([]);
+
+onMounted(() => {
+  const arr = [];
+  for (let i = 0; i < 10000; i++) {
+    arr.push({ value: i, label: `列表项 ${i}` });
+  }
+  data.value = arr;
+});
+</script>
+<template>
+  <div style="height: 400px;">
+    <VirtualListContainer>
+      <VirtualListPhantom />
+      <VirtualListWrapper tagName="ul">
+        <VirtualListRows>
+          <li v-for="item in data" :key="item.value" style="height: 40px; line-height: 40px;">
+            {{ item.label }}
+          </li>
+        </VirtualListRows>
+      </VirtualListWrapper>
+    </VirtualListContainer>
+  </div>
+</template>
+```
+
 ### VirtualListPhantom
 占位组件，用于撑开滚动高度
 
+#### 组合示例
+##### 组合式使用
+**场景**: 使用子组件进行复杂布局
+
+使用子组件进行组合
+
+```vue
+<script setup lang="ts">
+import { ref, onMounted } from 'vue';
+import { VirtualListContainer, VirtualListWrapper, VirtualListPhantom, VirtualListRows } from '@king-design/vue';
+
+const data = ref<{value: number; label: string}[]>([]);
+
+onMounted(() => {
+  const arr = [];
+  for (let i = 0; i < 10000; i++) {
+    arr.push({ value: i, label: `列表项 ${i}` });
+  }
+  data.value = arr;
+});
+</script>
+<template>
+  <div style="height: 400px;">
+    <VirtualListContainer>
+      <VirtualListPhantom />
+      <VirtualListWrapper tagName="ul">
+        <VirtualListRows>
+          <li v-for="item in data" :key="item.value" style="height: 40px; line-height: 40px;">
+            {{ item.label }}
+          </li>
+        </VirtualListRows>
+      </VirtualListWrapper>
+    </VirtualListContainer>
+  </div>
+</template>
+```
+
 ### VirtualListRows
 行渲染组件，包裹实际渲染的列表项
 
+#### 组合示例
+##### 组合式使用
+**场景**: 使用子组件进行复杂布局
+
+使用子组件进行组合
+
+```vue
+<script setup lang="ts">
+import { ref, onMounted } from 'vue';
+import { VirtualListContainer, VirtualListWrapper, VirtualListPhantom, VirtualListRows } from '@king-design/vue';
+
+const data = ref<{value: number; label: string}[]>([]);
+
+onMounted(() => {
+  const arr = [];
+  for (let i = 0; i < 10000; i++) {
+    arr.push({ value: i, label: `列表项 ${i}` });
+  }
+  data.value = arr;
+});
+</script>
+<template>
+  <div style="height: 400px;">
+    <VirtualListContainer>
+      <VirtualListPhantom />
+      <VirtualListWrapper tagName="ul">
+        <VirtualListRows>
+          <li v-for="item in data" :key="item.value" style="height: 40px; line-height: 40px;">
+            {{ item.label }}
+          </li>
+        </VirtualListRows>
+      </VirtualListWrapper>
+    </VirtualListContainer>
+  </div>
+</template>
+```
+
 ## 常见错误与正确用法 (Anti-Hallucination)
 ### 容器未设置高度
 > **错误用法**: `<VirtualList> <!-- 没有高度，无法滚动 -->

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "king-design-analyzer",
-    "version": "2.2.0",
+    "version": "2.2.2",
     "description": "AST-based code analyzer for King Design Vue components with on-demand modular imports",
     "main": "./dist/index.js",
     "module": "./dist/index.mjs",
@@ -64,8 +64,8 @@
         "audit:versatile": "node scripts/audit_versatile.js",
         "audit:hooks": "node scripts/audit_hooks.js",
         "transform:md": "ts-node -P tsconfig.scripts.json scripts/transform_metadata.ts",
-        "test": "vitest run",
-        "test:watch": "vitest",
+        "test": "node --require ./scripts/vitest-webcrypto.cjs ./node_modules/vitest/vitest.mjs run",
+        "test:watch": "node --require ./scripts/vitest-webcrypto.cjs ./node_modules/vitest/vitest.mjs",
         "prepublishOnly": "npm run build",
         "release:patch": "npm version patch && npm publish",
         "release:minor": "npm version minor && npm publish",

package/dist/chunk-D2SXGGTX.mjs

@@ -1,162 +0,0 @@
-import { compileSFC } from './chunk-BI5TIQID.mjs';
-
-// src/runtime/index.ts
-var scopeIdCounter = 0;
-function createMockProxy(path) {
-  return new Proxy(() => {
-  }, {
-    get: (_target, prop) => {
-      if (prop === Symbol.toPrimitive) return () => 0;
-      if (prop === "then") return void 0;
-      return createMockProxy();
-    },
-    apply: () => createMockProxy()
-  });
-}
-function createWhitelistedModule(source, context) {
-  if (source === "vue" || source.startsWith("@vue/")) {
-    return context;
-  }
-  return new Proxy({}, {
-    get: (_target, prop) => {
-      if (prop === "default") return createMockProxy();
-      if (typeof prop === "string" && prop in context) {
-        return context[prop];
-      }
-      return createMockProxy();
-    }
-  });
-}
-var MOCK_VUE_CONTEXT = {
-  // Reactivity
-  ref: (v) => ({ value: v }),
-  reactive: (v) => v,
-  computed: (fn) => ({ value: typeof fn === "function" ? fn() : fn }),
-  readonly: (v) => v,
-  shallowRef: (v) => ({ value: v }),
-  shallowReactive: (v) => v,
-  toRef: () => ({ value: void 0 }),
-  toRefs: (obj) => Object.fromEntries(
-    Object.keys(obj || {}).map((k) => [k, { value: obj[k] }])
-  ),
-  toRaw: (v) => v,
-  markRaw: (v) => v,
-  isRef: () => false,
-  isReactive: () => false,
-  isReadonly: () => false,
-  isProxy: () => false,
-  triggerRef: () => {
-  },
-  customRef: (factory) => factory(() => {
-  }, () => {
-  }),
-  // Lifecycle
-  onMounted: () => {
-  },
-  onUnmounted: () => {
-  },
-  onBeforeMount: () => {
-  },
-  onBeforeUnmount: () => {
-  },
-  onUpdated: () => {
-  },
-  onBeforeUpdate: () => {
-  },
-  onActivated: () => {
-  },
-  onDeactivated: () => {
-  },
-  onErrorCaptured: () => {
-  },
-  // Watchers
-  watch: () => () => {
-  },
-  watchEffect: () => () => {
-  },
-  watchPostEffect: () => () => {
-  },
-  watchSyncEffect: () => () => {
-  },
-  // Composition API
-  defineProps: () => ({}),
-  defineEmits: () => () => {
-  },
-  defineExpose: () => {
-  },
-  defineOptions: () => {
-  },
-  defineSlots: () => ({}),
-  defineModel: () => ({ value: void 0 }),
-  withDefaults: (_props, defaults) => defaults,
-  useSlots: () => ({}),
-  useAttrs: () => ({}),
-  // Dependency Injection
-  inject: () => void 0,
-  provide: () => {
-  },
-  // Utilities
-  nextTick: () => Promise.resolve(),
-  getCurrentInstance: () => null,
-  h: () => ({}),
-  createVNode: () => ({}),
-  resolveComponent: () => ({}),
-  // =========================================================================
-  // @ksyun-internal/versatile Hooks
-  // =========================================================================
-  useToState: (_props, _key, _emit, defaultValue) => ({ value: defaultValue ?? void 0 }),
-  useIdEntity: () => ({ value: void 0 }),
-  // =========================================================================
-  // Module Mocking
-  // =========================================================================
-  __mockModule: (modulePath) => createMockProxy(),
-  __getWhitelistedModule: (source) => createWhitelistedModule(source, MOCK_VUE_CONTEXT)
-};
-function validateRuntimePrecheck(code) {
-  const scopeId = `runtime-${Date.now()}-${++scopeIdCounter}`;
-  const { script, bindings, strippedImports, error } = compileSFC(code, scopeId);
-  if (error) {
-    return {
-      name: "\u8FD0\u884C\u65F6\u9884\u68C0\u67E5",
-      passed: false,
-      errors: [error]
-    };
-  }
-  try {
-    const funcBody = `
-            "use strict";
-            ${script}
-            return { ${bindings.join(", ")} };
-        `;
-    const keys = Object.keys(MOCK_VUE_CONTEXT);
-    const values = Object.values(MOCK_VUE_CONTEXT);
-    const runner = new Function(...keys, funcBody);
-    const result = runner(...values);
-    const missingBindings = bindings.filter((binding) => !(binding in result));
-    if (missingBindings.length > 0) {
-      return {
-        name: "\u8FD0\u884C\u65F6\u9884\u68C0\u67E5",
-        passed: false,
-        errors: missingBindings.map((b) => `\u53D8\u91CF ${b} \u672A\u6B63\u786E\u5BFC\u51FA`)
-      };
-    }
-    return {
-      name: "\u8FD0\u884C\u65F6\u9884\u68C0\u67E5",
-      passed: true,
-      errors: []
-    };
-  } catch (e) {
-    const errorMessage = e.message || String(e);
-    const errorLocation = e.stack?.split("\n")[1]?.trim() || "";
-    return {
-      name: "\u8FD0\u884C\u65F6\u9884\u68C0\u67E5",
-      passed: false,
-      errors: [
-        `JavaScript \u6267\u884C\u9519\u8BEF: ${errorMessage}`,
-        ...errorLocation ? [`\u4F4D\u7F6E: ${errorLocation}`] : []
-      ]
-    };
-  }
-}
-
-export { validateRuntimePrecheck };

package/dist/chunk-EYKZY2F3.js

@@ -1,164 +0,0 @@
-'use strict';
-
-var chunkCR3GC4H3_js = require('./chunk-CR3GC4H3.js');
-
-// src/runtime/index.ts
-var scopeIdCounter = 0;
-function createMockProxy(path) {
-  return new Proxy(() => {
-  }, {
-    get: (_target, prop) => {
-      if (prop === Symbol.toPrimitive) return () => 0;
-      if (prop === "then") return void 0;
-      return createMockProxy();
-    },
-    apply: () => createMockProxy()
-  });
-}
-function createWhitelistedModule(source, context) {
-  if (source === "vue" || source.startsWith("@vue/")) {
-    return context;
-  }
-  return new Proxy({}, {
-    get: (_target, prop) => {
-      if (prop === "default") return createMockProxy();
-      if (typeof prop === "string" && prop in context) {
-        return context[prop];
-      }
-      return createMockProxy();
-    }
-  });
-}
-var MOCK_VUE_CONTEXT = {
-  // Reactivity
-  ref: (v) => ({ value: v }),
-  reactive: (v) => v,
-  computed: (fn) => ({ value: typeof fn === "function" ? fn() : fn }),
-  readonly: (v) => v,
-  shallowRef: (v) => ({ value: v }),
-  shallowReactive: (v) => v,
-  toRef: () => ({ value: void 0 }),
-  toRefs: (obj) => Object.fromEntries(
-    Object.keys(obj || {}).map((k) => [k, { value: obj[k] }])
-  ),
-  toRaw: (v) => v,
-  markRaw: (v) => v,
-  isRef: () => false,
-  isReactive: () => false,
-  isReadonly: () => false,
-  isProxy: () => false,
-  triggerRef: () => {
-  },
-  customRef: (factory) => factory(() => {
-  }, () => {
-  }),
-  // Lifecycle
-  onMounted: () => {
-  },
-  onUnmounted: () => {
-  },
-  onBeforeMount: () => {
-  },
-  onBeforeUnmount: () => {
-  },
-  onUpdated: () => {
-  },
-  onBeforeUpdate: () => {
-  },
-  onActivated: () => {
-  },
-  onDeactivated: () => {
-  },
-  onErrorCaptured: () => {
-  },
-  // Watchers
-  watch: () => () => {
-  },
-  watchEffect: () => () => {
-  },
-  watchPostEffect: () => () => {
-  },
-  watchSyncEffect: () => () => {
-  },
-  // Composition API
-  defineProps: () => ({}),
-  defineEmits: () => () => {
-  },
-  defineExpose: () => {
-  },
-  defineOptions: () => {
-  },
-  defineSlots: () => ({}),
-  defineModel: () => ({ value: void 0 }),
-  withDefaults: (_props, defaults) => defaults,
-  useSlots: () => ({}),
-  useAttrs: () => ({}),
-  // Dependency Injection
-  inject: () => void 0,
-  provide: () => {
-  },
-  // Utilities
-  nextTick: () => Promise.resolve(),
-  getCurrentInstance: () => null,
-  h: () => ({}),
-  createVNode: () => ({}),
-  resolveComponent: () => ({}),
-  // =========================================================================
-  // @ksyun-internal/versatile Hooks
-  // =========================================================================
-  useToState: (_props, _key, _emit, defaultValue) => ({ value: defaultValue ?? void 0 }),
-  useIdEntity: () => ({ value: void 0 }),
-  // =========================================================================
-  // Module Mocking
-  // =========================================================================
-  __mockModule: (modulePath) => createMockProxy(),
-  __getWhitelistedModule: (source) => createWhitelistedModule(source, MOCK_VUE_CONTEXT)
-};
-function validateRuntimePrecheck(code) {
-  const scopeId = `runtime-${Date.now()}-${++scopeIdCounter}`;
-  const { script, bindings, strippedImports, error } = chunkCR3GC4H3_js.compileSFC(code, scopeId);
-  if (error) {
-    return {
-      name: "\u8FD0\u884C\u65F6\u9884\u68C0\u67E5",
-      passed: false,
-      errors: [error]
-    };
-  }
-  try {
-    const funcBody = `
-            "use strict";
-            ${script}
-            return { ${bindings.join(", ")} };
-        `;
-    const keys = Object.keys(MOCK_VUE_CONTEXT);
-    const values = Object.values(MOCK_VUE_CONTEXT);
-    const runner = new Function(...keys, funcBody);
-    const result = runner(...values);
-    const missingBindings = bindings.filter((binding) => !(binding in result));
-    if (missingBindings.length > 0) {
-      return {
-        name: "\u8FD0\u884C\u65F6\u9884\u68C0\u67E5",
-        passed: false,
-        errors: missingBindings.map((b) => `\u53D8\u91CF ${b} \u672A\u6B63\u786E\u5BFC\u51FA`)
-      };
-    }
-    return {
-      name: "\u8FD0\u884C\u65F6\u9884\u68C0\u67E5",
-      passed: true,
-      errors: []
-    };
-  } catch (e) {
-    const errorMessage = e.message || String(e);
-    const errorLocation = e.stack?.split("\n")[1]?.trim() || "";
-    return {
-      name: "\u8FD0\u884C\u65F6\u9884\u68C0\u67E5",
-      passed: false,
-      errors: [
-        `JavaScript \u6267\u884C\u9519\u8BEF: ${errorMessage}`,
-        ...errorLocation ? [`\u4F4D\u7F6E: ${errorLocation}`] : []
-      ]
-    };
-  }
-}
-
-exports.validateRuntimePrecheck = validateRuntimePrecheck;