@qin-ui/vant-pro 1.0.3 → 1.0.4

package/AI-CONTEXT.md

@@ -25,7 +25,7 @@ npm install @qin-ui/vant-pro vant vue
 
 每个字段支持：`path`, `label`, `component`, `hidden`, `disabled`, `rules`, `valueFormatter`, `fields`, `grid`, `slots`, `componentStyle`, `componentClass`, `componentContainer`, `formItemStyle`, `formItemClass`, `formItemContainer`, `modelProp`
 
-内置组件：input, textarea, input-search, input-password, input-number, select, cascader, date-picker, range-picker, time-picker, checkbox-group, radio-group, switch, slider, tree-select, transfer, custom
+内置组件：field, switch, stepper, rate, slider, uploader, checkbox-group, radio-group, picker, date-picker, time-picker, cascader, area, signature, button, custom
 
 ## 类型扩展
 

package/api.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-05-26T08:14:28.580Z",
+  "generatedAt": "2026-05-26T08:42:45.735Z",
   "name": "@qin-ui/vant-pro",
   "api": [
     {

package/bin/init-ai.mjs

@@ -0,0 +1,142 @@
+#!/usr/bin/env node
+
+/**
+ * @qin-ui/* AI 上下文初始化 CLI 工具
+ *
+ * 遵循 Agentic Collaboration Standard (ACS)，
+ * 在消费方项目中自动生成统一的 .agents 规范配置文件。
+ *
+ * 用法:
+ *   npx @qin-ui/vant-pro init-ai
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+// ==================== 常量 ====================
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const PKG_ROOT = path.resolve(__dirname, '..');
+
+const PKG_JSON = JSON.parse(
+  fs.readFileSync(path.join(PKG_ROOT, 'package.json'), 'utf-8')
+);
+const PKG_NAME = PKG_JSON.name;
+const PKG_SHORT = PKG_NAME.replace(/^@qin-ui\//, '');
+
+// ==================== 终端颜色 ====================
+
+const green = (s) => `\x1b[32m${s}\x1b[0m`;
+const cyan = (s) => `\x1b[36m${s}\x1b[0m`;
+const bold = (s) => `\x1b[1m${s}\x1b[0m`;
+const red = (s) => `\x1b[31m${s}\x1b[0m`;
+
+// ==================== 内容生成 ====================
+
+function getAiContextContent() {
+  const filePath = path.join(PKG_ROOT, 'AI-CONTEXT.md');
+  if (fs.existsSync(filePath)) {
+    return fs.readFileSync(filePath, 'utf-8').trim();
+  }
+  return `# ${PKG_NAME}\n\n> 基于 Vue 3 的配置驱动组件库。`;
+}
+
+function getUnifiedAgentContent() {
+  const aiContext = getAiContextContent();
+  const core = [
+    aiContext,
+    '',
+    '## 完整 API 参考',
+    '',
+    `使用 \`${PKG_NAME}\` 时，请阅读以下文件获取完整的 API 定义、类型签名和使用示例：`,
+    `- \`node_modules/${PKG_NAME}/README.md\` — 详细使用文档和代码示例`,
+    `- \`node_modules/${PKG_NAME}/api.json\` — 结构化 API 元数据（组件、Hook、类型的签名和 JSDoc 示例）`,
+    '',
+  ].join('\n');
+
+  // 包含兼容性的 Frontmatter（如 Cursor 支持的 globs 等）
+  return [
+    '---',
+    `description: "${PKG_NAME} 组件库使用规范"`,
+    'globs: ["**/*.vue", "**/*.ts", "**/*.tsx"]',
+    'alwaysApply: false',
+    '---',
+    '',
+    core,
+  ].join('\n');
+}
+
+// ==================== 文件写入 ====================
+
+function ensureDir(dirPath) {
+  if (!fs.existsSync(dirPath)) {
+    fs.mkdirSync(dirPath, { recursive: true });
+  }
+}
+
+// ==================== CLI 入口 ====================
+
+function printHelp() {
+  console.log(`
+${bold(`${PKG_NAME} CLI`)}
+
+${bold('用法:')}
+  npx ${PKG_NAME} init-ai
+
+${bold('命令:')}
+  init-ai    在当前项目中生成统一的 .agents 规范配置文件
+
+${bold('选项:')}
+  --help     显示帮助信息
+
+${bold('说明:')}
+  该命令将采用统一的 Agentic 标准，在项目的 .agents/rules/ 目录下
+  生成上下文文件。兼容支持读取 .agents 的主流 AI IDE 和 CLI 工具。
+`);
+}
+
+function main() {
+  const args = process.argv.slice(2);
+  const subcommand = args.find((a) => !a.startsWith('-'));
+  const flags = args.filter((a) => a.startsWith('-'));
+
+  if (!subcommand || flags.includes('--help') || flags.includes('-h')) {
+    printHelp();
+    process.exit(0);
+  }
+
+  if (subcommand !== 'init-ai') {
+    console.error(red(`\n  未知命令: ${subcommand}\n`));
+    printHelp();
+    process.exit(1);
+  }
+
+  console.log('');
+  console.log(bold(`📦 ${PKG_NAME} — AI 上下文初始化 (ACS 标准)`));
+  console.log('');
+  
+  const content = getUnifiedAgentContent();
+  const dirPath = '.agents/rules';
+  const fileName = `${PKG_SHORT}.md`;
+  
+  const fullDir = path.join(process.cwd(), dirPath);
+  const fullPath = path.join(fullDir, fileName);
+
+  ensureDir(fullDir);
+  fs.writeFileSync(fullPath, content, 'utf-8');
+
+  const relPath = path.join(dirPath, fileName);
+  console.log(`  ${green('✔')} ${cyan(relPath)}  ${green('[created/updated]')}`);
+
+  console.log('');
+  console.log(green('✅ 完成！已生成统一标准规则文件。'));
+  console.log('');
+  console.log(`${bold('下一步:')}`);
+  console.log(
+    `  将 ${cyan(dirPath)} 目录提交到 Git，团队即可自动享受 AI 增强\n`
+  );
+}
+
+main();

package/package.json

@@ -1,7 +1,10 @@
 {
   "name": "@qin-ui/vant-pro",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "基于 vant 和 @qin-ui/core 封装的高级表单和列表组件库",
+  "bin": {
+    "vant-pro": "./bin/init-ai.mjs"
+  },
   "type": "module",
   "module": "es/index.js",
   "types": "es/index.d.ts",
@@ -14,6 +17,7 @@
   },
   "files": [
     "es",
+    "bin",
     "README.md",
     "LICENSE",
     "api.json",
@@ -24,6 +28,10 @@
     "type": "git",
     "url": "git+https://github.com/dufan3715/pro-components.git"
   },
+  "scripts": {
+    "prebuild": "tsx ../../scripts/generate-api-json.ts vant-pro",
+    "build": "vue-tsc && vite build"
+  },
   "author": "dufan3715",
   "bugs": {
     "url": "https://github.com/dufan3715/pro-components/issues"
@@ -38,10 +46,10 @@
     "vue-component-type-helpers": "^3.2.5"
   },
   "devDependencies": {
+    "@qin-ui/core": "workspace:^",
     "@types/lodash-es": "^4.17.12",
     "lodash-es": "^4.17.21",
-    "vant": "^4.9.15",
-    "@qin-ui/core": "^1.0.0"
+    "vant": "^4.9.15"
   },
   "sideEffects": false,
   "publishConfig": {
@@ -59,9 +67,5 @@
     "ui",
     "form",
     "pro-form"
-  ],
-  "scripts": {
-    "prebuild": "tsx ../../scripts/generate-api-json.ts vant-pro",
-    "build": "vue-tsc && vite build"
-  }
-}
+  ]
+}

package/LICENSE

@@ -1,9 +0,0 @@
-MIT License
-
-Copyright (c) 2023-present pro-components
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.