@wot-ui/cli 0.0.1-beta.10 → 0.0.1-beta.12

package/README.md

@@ -49,11 +49,11 @@ wot mcp
 
 ### 组件知识
 
-- `wot list`：列出可用的 wot-ui 组件
-- `wot info <Component>`：查看组件 props、events、slots、CSS 变量
-- `wot doc <Component>`：输出组件 markdown 文档
-- `wot demo <Component> [name]`：查看 demo 列表或指定 demo 源码
-- `wot token [Component]`：查看组件 CSS 变量与默认值
+- `wot list [keyword]`：列出可用的 wot-ui 组件，支持按名称过滤
+- `wot info <component>`：查看组件 props、events、slots、CSS 变量
+- `wot doc <component>`：输出组件 markdown 文档
+- `wot demo <component> [name]`：查看 demo 列表或指定 demo 源码
+- `wot token [component]`：查看组件 CSS 变量与默认值
 - `wot changelog [version] [component]`：查看版本更新记录
 
 ### 项目分析
@@ -66,9 +66,20 @@ wot mcp
 
 多数查询命令支持以下参数：
 
-- `--format text`
-- `--format json`
-- `--version v2`
+- `--format text`（默认）或 `--format json`：输出格式
+- `--version <ver>`：指定 wot-ui 版本，支持以下格式：
+  - `2.0`（minor，自动解析到最新 patch）
+  - `2.0.4`（exact patch）
+  - `latest`（始终使用最新稳定版）
+  - 不传时自动从项目 `node_modules/@wot-ui/ui` 或 `package.json` 依赖声明检测，检测不到则回退到最新版
+
+示例：
+
+```bash
+wot info Button --version 2.0.0
+wot doc Button --version 2.0
+wot list --format json --version latest
+```
 
 ## MCP 集成
 
@@ -103,20 +114,34 @@ wot mcp
 - `docs/guide/changelog.md`
 - `src/uni_modules/wot-ui/components/*/index.scss`
 
-重新生成本地数据有两种方式。
+`data/` 目录保存每个 stable patch 版本的独立快照（`v2.0.0.json`、`v2.0.1.json`、…），以及一个始终指向最新版的 `v2.json`。
+
+### 更新数据
 
-使用本地已有的 wot-ui 仓库：
+**全量同步所有历史 tag（推荐，首次或需要补全历史版本时使用）：**
 
 ```bash
-pnpm extract:cli --wot-dir ../wot-ui --output data/v2.json
+pnpm sync:clone
 ```
 
-直接克隆最新的 wot-ui 仓库并提取：
+克隆 wot-ui 仓库（`--filter=tree:0 --no-checkout`，不下载文件树），按所有 stable tag 逐一 checkout + 提取，已有快照自动跳过。
+
+**仅更新最新版本（快速，CI 单版本触发时使用）：**
 
 ```bash
 pnpm extract:clone
 ```
 
+**使用本地已有的 wot-ui 仓库：**
+
+```bash
+# 全量多版本
+pnpm sync --wot-dir ../wot-ui
+
+# 单个版本，手动指定 checkout 后提取
+pnpm extract --wot-dir ../wot-ui --output data/v2.0.4.json
+```
+
 ## 开发本仓库
 
 当前根目录就是主发布包，核心源码位于 `src`，离线数据位于 `data`，提取脚本位于 `scripts`。
@@ -135,13 +160,11 @@ pnpm install
 ### 常用开发命令
 
 ```bash
-pnpm lint
-pnpm test:all
-pnpm build:all
-pnpm typecheck:all
-pnpm build:cli
-pnpm test:cli
-pnpm typecheck:cli
+pnpm lint          # ESLint 检查
+pnpm typecheck     # TypeScript 类型检查
+pnpm test          # 单元测试
+pnpm build         # 构建产物到 dist/
+pnpm compress      # 压缩 data/*.json → data/*.json.gz（发布前自动执行）
 ```
 
 ### 本地调试 CLI
@@ -151,13 +174,16 @@ pnpm typecheck:cli
 ```bash
 pnpm exec tsx src/index.ts list
 pnpm exec tsx src/index.ts info Button
+pnpm exec tsx src/index.ts info Button --version 2.0.0
+pnpm exec tsx src/index.ts doc Button --version 2.0
 ```
 
 如果要调试构建产物：
 
 ```bash
-pnpm build:cli
+pnpm build
 node dist/index.mjs list
+node dist/index.mjs info Button --version 2.0.0
 ```
 
 ### 本地调试 MCP
@@ -170,9 +196,10 @@ MCP 走 stdio，终端无交互输出属于正常现象。若要查看 tools 与
 
 ## 自动化流程
 
-- `.github/workflows/ci.yml`：执行主包的 lint、typecheck、build、test
-- `.github/workflows/release.yml`：在 `v*` tag 上通过 reusable workflow 发布 `@wot-ui/cli`
-- `.github/workflows/sync.yml`：拉取上游 `wot-ui/wot-ui`，提取最新元数据，并自动创建同步 PR
+- `.github/workflows/ci.yml`：在 `push`/`PR` 时执行 lint、typecheck、build、test（多 OS × Node 版本矩阵）
+- `.github/workflows/sync.yml`：每日 02:00 UTC 自动检测 `@wot-ui/ui` 最新版本，有更新时拉取全量多版本快照并创建同步 PR；也可手动触发单版本提取
+- `.github/workflows/release.yml`：`v*` tag 触发自动发布 `@wot-ui/cli` 到 npm（发布前自动运行 `pnpm compress && pnpm build`，npm 包只含 `.json.gz`）
+- `.github/workflows/coverage-upload.yml`：`v*` tag 触发，上传测试覆盖率到 Codecov
 
 ## 当前边界
 

package/data/versions.json

@@ -1,10 +1,13 @@
 {
-  "latest": "2.0.0-alpha.5",
+  "latest": "2.0.4",
   "supported": [
-    "2.0.0-alpha.5"
+    "2.0.4"
   ],
   "aliases": {
-    "v2": "2.0.0-alpha.5",
-    "latest": "2.0.0-alpha.5"
+    "v2": "2.0.4",
+    "latest": "2.0.4"
+  },
+  "v2": {
+    "2.0": "2.0.4"
   }
 }

package/dist/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as resolveVersion, i as listComponents, n as lintProject, o as loadMetadataFile, r as findComponent, s as version, t as analyzeUsage } from "./scanner-_isnOGJK.mjs";
+import { a as detectVersion, c as version, i as listComponents, n as lintProject, o as resolveVersion, r as findComponent, s as loadMetadataFile, t as analyzeUsage } from "./scanner-BinA6BWi.mjs";
 import process from "node:process";
 import { Command } from "commander";
 import { existsSync, readFileSync } from "node:fs";
@@ -22,9 +22,12 @@ function addQueryOptions(command) {
 	return command.option("--format <format>", "output format: text, json, markdown", "text").option("--version <version>", "target wot-ui version");
 }
 function normalizeQueryOptions(options) {
+	const format = options.format === "json" || options.format === "markdown" ? options.format : "text";
+	const info = detectVersion(typeof options.version === "string" ? options.version : void 0);
+	if (info.source === "fallback") process.stderr.write(`[wot] version not detected in project, falling back to ${info.version}\n`);
 	return {
-		format: options.format === "json" || options.format === "markdown" ? options.format : "text",
-		version: typeof options.version === "string" ? options.version : void 0
+		format,
+		version: info.version
 	};
 }
 function printError(message, format) {
@@ -321,7 +324,7 @@ function registerListCommand(program) {
 //#region src/commands/mcp.ts
 function registerMcpCommand(program) {
 	program.command("mcp").description("Start the wot-ui MCP server").action(async () => {
-		const { startMcpServer } = await import("./server-BLoIUV7u.mjs");
+		const { startMcpServer } = await import("./server-CVLPDRLu.mjs");
 		await startMcpServer();
 	});
 }
@@ -392,7 +395,7 @@ function registerUsageCommand(program) {
 //#region src/app.ts
 function createCliProgram() {
 	const program = new Command();
-	program.name("wot").description("wot-ui AI toolkit CLI").version(version);
+	program.name("wot").description("wot-ui AI toolkit CLI").version(version, "-V", "output the current version");
 	registerListCommand(program);
 	registerInfoCommand(program);
 	registerDocCommand(program);

package/dist/{scanner-_isnOGJK.mjs → scanner-BinA6BWi.mjs}

@@ -1,3 +1,4 @@
+import process from "node:process";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { dirname, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
@@ -5,7 +6,7 @@ import { gunzipSync } from "node:zlib";
 import { parse } from "@vue/compiler-sfc";
 
 //#region package.json
-var version = "0.0.1-beta.10";
+var version = "0.0.1-beta.12";
 
 //#endregion
 //#region src/data/loader.ts
@@ -39,14 +40,91 @@ function loadMetadataFile(versionKey) {
 
 //#endregion
 //#region src/data/version.ts
-const VERSION_KEY = "v2";
+/** Strip semver range operators (^, ~, >=, >, <=, <, =, whitespace). */
+function stripRange(ver) {
+	return ver.replace(/[\^~>=<\s]/g, "");
+}
+/**
+* Returns all stable version strings for major key 'v2',
+* sorted ascending by semver.
+*/
+function stableV2Versions() {
+	const map = loadVersionsFile().v2 ?? {};
+	return Object.values(map).filter((v) => !v.includes("-")).sort((a, b) => {
+		const pa = a.split(".").map(Number);
+		const pb = b.split(".").map(Number);
+		for (let i = 0; i < 3; i++) {
+			const diff = (pa[i] ?? 0) - (pb[i] ?? 0);
+			if (diff !== 0) return diff;
+		}
+		return 0;
+	});
+}
+/**
+* Auto-detect the wot-ui version to use.
+*
+* Priority:
+*   1. --version flag (flagVersion arg)
+*   2. node_modules/@wot-ui/ui/package.json in cwd
+*   3. package.json dependencies[@wot-ui/ui] in cwd
+*   4. Fallback to latest stable version from versions.json
+*/
+function detectVersion(flagVersion, cwd) {
+	const dir = cwd ?? process.cwd();
+	if (flagVersion) return {
+		version: flagVersion,
+		source: "flag"
+	};
+	const nmPath = join(dir, "node_modules", "@wot-ui", "ui", "package.json");
+	if (existsSync(nmPath)) try {
+		const pkg = JSON.parse(readFileSync(nmPath, "utf8"));
+		if (pkg.version) return {
+			version: pkg.version,
+			source: "node_modules"
+		};
+	} catch {}
+	const pkgPath = join(dir, "package.json");
+	if (existsSync(pkgPath)) try {
+		const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+		const depVersion = pkg.dependencies?.["@wot-ui/ui"] ?? pkg.devDependencies?.["@wot-ui/ui"] ?? pkg.peerDependencies?.["@wot-ui/ui"];
+		if (depVersion) return {
+			version: stripRange(depVersion),
+			source: "package.json"
+		};
+	} catch {}
+	return {
+		version: stableV2Versions().at(-1) ?? "2.0.0",
+		source: "fallback"
+	};
+}
+/**
+* Resolve a version string (from detectVersion or CLI flag) to a data file key.
+*
+* Examples:
+*   undefined / 'v2'    → 'v2'           (major alias, data/v2.json)
+*   'latest'            → 'v2.0.4'       (latest stable snapshot)
+*   '2.0'               → 'v2.0.4'       (minor → lookup in versions.json)
+*   '2.0.4'             → 'v2.0.4'       (exact patch)
+*   '2.0.0-alpha.5'     → 'v2.0.0-alpha.5' (pre-release exact)
+*/
 function resolveVersion(requested) {
-	const versions = loadVersionsFile();
-	if (!requested) return VERSION_KEY;
+	if (!requested || requested === "v2") return "v2";
 	const normalized = requested.trim();
-	if (versions.aliases[normalized]) return VERSION_KEY;
-	if (versions.supported.includes(normalized)) return VERSION_KEY;
-	if (normalized === VERSION_KEY) return VERSION_KEY;
+	if (normalized === "latest") {
+		const latest = stableV2Versions().at(-1);
+		if (!latest) return "v2";
+		return `v${latest}`;
+	}
+	const map = loadVersionsFile().v2 ?? {};
+	if (/^\d+\.\d+$/.test(normalized)) {
+		const patch = map[normalized];
+		if (!patch) throw new Error(`Unsupported wot-ui version: ${requested}`);
+		return `v${patch}`;
+	}
+	if (/^\d+\.\d+\.\d+/.test(normalized)) {
+		if (normalized.split(".")[0] !== "2") throw new Error(`Unsupported wot-ui version: ${requested}`);
+		return `v${normalized}`;
+	}
 	throw new Error(`Unsupported wot-ui version: ${requested}`);
 }
 
@@ -200,4 +278,4 @@ function lintProject(targetDir, version$1) {
 }
 
 //#endregion
-export { resolveVersion as a, listComponents as i, lintProject as n, loadMetadataFile as o, findComponent as r, version as s, analyzeUsage as t };
+export { detectVersion as a, version as c, listComponents as i, lintProject as n, resolveVersion as o, findComponent as r, loadMetadataFile as s, analyzeUsage as t };

package/dist/{server-BLoIUV7u.mjs → server-CVLPDRLu.mjs}

@@ -1,4 +1,4 @@
-import { a as resolveVersion, i as listComponents, n as lintProject, o as loadMetadataFile, r as findComponent, s as version } from "./scanner-_isnOGJK.mjs";
+import { c as version, i as listComponents, n as lintProject, o as resolveVersion, r as findComponent, s as loadMetadataFile } from "./scanner-BinA6BWi.mjs";
 import process from "node:process";
 import { McpServer, StdioServerTransport } from "@modelcontextprotocol/server";
 import * as z from "zod/v4";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wot-ui/cli",
   "type": "module",
-  "version": "0.0.1-beta.10",
+  "version": "0.0.1-beta.12",
   "description": "面向 wot-ui 的 CLI、MCP 与数据提取工具集",
   "license": "MIT",
   "funding": "https://github.com/sponsors/antfu",
@@ -67,16 +67,16 @@
     "build": "tsdown",
     "dev": "tsdown --watch",
     "extract": "tsx scripts/extract.ts",
-    "extract:cli": "pnpm extract",
     "extract:clone": "rm -rf /tmp/open-wot-wot-ui && git clone --depth 1 https://github.com/wot-ui/wot-ui.git /tmp/open-wot-wot-ui && pnpm extract --wot-dir /tmp/open-wot-wot-ui --output data/v2.json",
+    "sync": "tsx scripts/sync.ts",
+    "sync:clone": "rm -rf /tmp/open-wot-wot-ui && git clone --filter=tree:0 --no-checkout https://github.com/wot-ui/wot-ui.git /tmp/open-wot-wot-ui && pnpm sync --wot-dir /tmp/open-wot-wot-ui",
+    "compress": "tsx scripts/compress.ts",
     "lint": "eslint",
     "release": "bumpp",
     "start": "tsx src/index.ts",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage --coverage.reporter=lcov --coverage.reporter=text",
     "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "typecheck:all": "pnpm typecheck",
-    "typecheck:cli": "pnpm typecheck"
+    "typecheck": "tsc --noEmit"
   }
 }