@collectui/bdui 0.1.8 → 0.1.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@collectui/bdui",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Add BoardUI components to your project.",
   "license": "MIT",
   "type": "module",

package/src/add.js

@@ -145,7 +145,8 @@ export async function cmdAdd(names, flags) {
 			)
 		);
 	}
-	if (nextImports.size) {
+	// Next 项目里 next/link 是一等公民,提示反而是噪音(盲测 #10)
+	if (nextImports.size && !project.deps?.next) {
 		console.log(
 			c.yellow(
 				`\nNote: ${[...nextImports].sort().join(", ")} imported by installed files — these only compile in a Next.js project.`

package/src/init.js

@@ -1,7 +1,7 @@
 // `bdui init` — 对齐 boardui init:装 foundations(cx/theme/typography/globals)
 // + agent 规则(AGENTS.md + .cursor/rules),内容全部来自 registry(与官方同源)
 
-import { existsSync } from "fs";
+import { appendFileSync, existsSync, readFileSync, writeFileSync } from "fs";
 import ora from "ora";
 import path from "path";
 import { installPackages, pkgBaseName } from "./add.js";
@@ -29,9 +29,25 @@ function frameworkSetup(project, cwd) {
 
 	if (!has("tailwindcss")) pkgs.push("tailwindcss");
 	if (project.deps?.next) {
-		// Next.js:官方模板自带 @/ alias 与 @types/node;仅补缺失的 tailwind 管道
+		// Next.js:官方模板自带 @/ alias 与 @types/node;仅补缺失的 tailwind 管道。
+		// postcss 配置是硬前提:模板没带 Tailwind 时 postcss.config 不存在,
+		// @tailwindcss/postcss 装了也不接管,组件样式静默失效(next build 只给
+		// "Unknown at rule: @apply" 警告仍报成功)——缺配置就补 v4 标准形态
 		if (!has("@tailwindcss/postcss")) pkgs.push("@tailwindcss/postcss");
-		return { pkgs, notes };
+		const hasPostcssCfg = [
+			"postcss.config.mjs",
+			"postcss.config.js",
+			"postcss.config.cjs",
+			"postcss.config.ts",
+		].some((f) => existsSync(path.join(cwd, f)));
+		const writes = [];
+		if (!hasPostcssCfg)
+			writes.push({
+				file: "postcss.config.mjs",
+				content:
+					'const config = {\n  plugins: { "@tailwindcss/postcss": {} },\n};\n\nexport default config;\n',
+			});
+		return { pkgs, notes, writes };
 	}
 	const viteConfig = [
 		"vite.config.ts",
@@ -59,7 +75,7 @@ function frameworkSetup(project, cwd) {
 			].join("\n")
 		);
 	}
-	return { pkgs, notes };
+	return { pkgs, notes, writes: [] };
 }
 
 export async function cmdInit(flags) {
@@ -68,8 +84,10 @@ export async function cmdInit(flags) {
 	if (!project.pkg)
 		throw new Error("No package.json found — run inside your app project.");
 
+	// alias 不在此行展示:tsconfig 的 @/ 别名与实际落位(components/base/<group>)
+	// 口径不同,曾让客户误读(2026-10-26 盲测 #6);落位在 ✓ 行明示
 	console.log(
-		`${c.cyan("init")}   detected ${project.packageManager}, src=${project.usesSrcDir}, alias=${project.alias}`
+		`${c.cyan("init")}   detected ${project.packageManager}, src=${project.usesSrcDir}`
 	);
 
 	// npm 依赖:foundation 用到的 + 可选 pro 依赖(官方 --pro 同款集)+ 框架适配
@@ -98,6 +116,60 @@ export async function cmdInit(flags) {
 		wrote += await writeItemFiles(item, outRoot, flags);
 	}
 
+	// 框架管道配置(postcss.config.mjs 等):样式静默失效的根因修复(盲测 #1)
+	for (const w of setup.writes ?? []) {
+		const target = path.join(cwd, w.file);
+		if (existsSync(target)) continue;
+		writeFileSync(target, w.content);
+		console.log(
+			`  ${c.green("add")}    ${w.file} (Tailwind v4 PostCSS pipeline)`
+		);
+	}
+
+	// .mcp.json 常嵌 license key(MCP 官方形态)——git 仓库防一次 commit 泄漏(盲测 #3)
+	const gitignore = path.join(cwd, ".gitignore");
+	if (existsSync(path.join(cwd, ".git")) || existsSync(gitignore)) {
+		const cur = existsSync(gitignore) ? readFileSync(gitignore, "utf8") : "";
+		if (!/^\s*\.mcp\.json\s*$/m.test(cur)) {
+			appendFileSync(
+				gitignore,
+				`${cur && !cur.endsWith("\n") ? "\n" : ""}\n# BoardUI MCP config (contains your license key)\n.mcp.json\n`
+			);
+			console.log(
+				`  ${c.green("add")}    .gitignore += .mcp.json (license key leak guard)`
+			);
+		}
+	}
+
+	// 样式入口自动接线:根布局存在且未引入时补 import,免手动 Note(盲测 #7)
+	const layoutFile = [
+		"app/layout.tsx",
+		"app/layout.ts",
+		"app/layout.jsx",
+		"app/layout.js",
+	]
+		.map((f) => path.join(project.sourceRoot, f))
+		.find((p) => existsSync(p));
+	let stylesWired = false;
+	if (layoutFile) {
+		const src = readFileSync(layoutFile, "utf8");
+		if (src.includes("@/styles/globals.css")) {
+			stylesWired = true;
+		} else {
+			const lines = src.split("\n");
+			// 插到最后一个顶层 import 之后;没有 import 则插到文件头
+			let at = 0;
+			for (let i = 0; i < lines.length; i++)
+				if (/^import[\s{"']/.test(lines[i])) at = i + 1;
+			lines.splice(at, 0, 'import "@/styles/globals.css";');
+			writeFileSync(layoutFile, lines.join("\n"));
+			stylesWired = true;
+			console.log(
+				`  ${c.green("add")}    ${path.relative(cwd, layoutFile)}: import "@/styles/globals.css"`
+			);
+		}
+	}
+
 	// agent 规则(AGENTS.md + .cursor/rules/boardui.mdc)
 	const ruleLines = await applyAgentRules(cwd);
 
@@ -118,11 +190,17 @@ export async function cmdInit(flags) {
 			throw e;
 		}
 	}
-	console.log(c.green(`\n✓ ${wrote} foundation file(s) written.`));
+	console.log(
+		c.green(
+			`\n✓ ${wrote} foundation file(s) written to ${path.relative(cwd, outRoot) || "."}.`
+		)
+	);
 	for (const note of setup.notes) console.log(c.yellow(`\n${note}\n`));
 	for (const line of ruleLines) console.log(line);
 	console.log(
-		`  ${c.dim('Note: import the styles in your root layout or global css: import "@/styles/globals.css";')}`
+		stylesWired
+			? `  ${c.dim('Note: BoardUI styles wired into your root layout (import "@/styles/globals.css").')}`
+			: `  ${c.dim('Note: import the styles in your root layout or global css: import "@/styles/globals.css";')}`
 	);
 	console.log(
 		c.green(

package/src/list.js

@@ -17,9 +17,11 @@ export async function cmdList() {
 	};
 	for (const [key, group] of groups) {
 		console.log(c.bold(labels[key] ?? key));
-		const width = Math.max(...group.map((i) => i.name.length)) + 2;
+		// Pro 标记:混排时无从分辨 Pro/免费(盲测 #5),对齐 MCP list 的 (pro) 口径
+		const label = (i) => (i.pro ? `${i.name} (pro)` : i.name);
+		const width = Math.max(...group.map((i) => label(i).length)) + 2;
 		for (const item of group) {
-			const name = item.name.padEnd(width);
+			const name = label(item).padEnd(width);
 			console.log(`  ${name}${item.description ?? ""}`);
 		}
 		console.log();

package/src/mcp.js

@@ -343,6 +343,11 @@ async function call(name, args, serverKey) {
 
 export async function cmdMcp(options = {}) {
 	const serverKey = options.key ?? undefined; // `bdui mcp --key <key>`:整会话兜底,见 loadItem 注释
+	// stderr 提示(stdio 协议,stdout 必须干净):key 常嵌 .mcp.json,防 commit 泄漏(盲测 #3)
+	if (serverKey)
+		console.error(
+			"[bdui] tip: if this key is embedded in .mcp.json, keep that file out of git (add it to .gitignore)."
+		);
 	const rl = createInterface({ input: process.stdin });
 	const write = (obj) => process.stdout.write(JSON.stringify(obj) + "\n");