@tfdesign/b-end 1.0.10 → 1.0.11

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tfdesign/b-end",
-  "version": "1.0.10",
+  "version": "1.0.11",
   "private": false,
   "type": "module",
   "description": "TFDS B-end React components + Tailwind v4 theme.css; self-contained npm install (no monorepo clone required).",

package/scripts/check-tfds-update.mjs

@@ -0,0 +1,163 @@
+#!/usr/bin/env node
+/**
+ * TFDS 版本更新检测（只读，不修改用户项目）
+ *
+ * 在对方项目根目录执行：
+ *   node node_modules/@tfdesign/b-end/scripts/check-tfds-update.mjs
+ *
+ * 也可以直接执行包内脚本：
+ *   node /path/to/node_modules/@tfdesign/b-end/scripts/check-tfds-update.mjs
+ */
+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 pkgRoot = path.resolve(__dirname, '..');
+const packageJsonPath = path.join(pkgRoot, 'package.json');
+const packageName = '@tfdesign/b-end';
+const registryUrl = `https://registry.npmjs.org/${encodeURIComponent(packageName).replace('%2F', '%2f')}`;
+
+function readPackageJson() {
+  try {
+    return JSON.parse(fs.readFileSync(packageJsonPath, 'utf8'));
+  } catch (error) {
+    console.log('\n[tfds-update-check] 无法读取本地 package.json');
+    console.log(`  路径：${packageJsonPath}`);
+    console.log(`  错误：${error?.message || error}`);
+    process.exit(1);
+  }
+}
+
+function formatDateToMinute(value) {
+  if (!value) return '未知';
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) return '未知';
+
+  const parts = new Intl.DateTimeFormat('zh-CN', {
+    timeZone: 'Asia/Shanghai',
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+    hour12: false,
+  }).formatToParts(date);
+
+  const byType = Object.fromEntries(parts.map((part) => [part.type, part.value]));
+  return `${byType.year}-${byType.month}-${byType.day} ${byType.hour}:${byType.minute}`;
+}
+
+function parseVersion(version) {
+  return String(version || '')
+    .trim()
+    .replace(/^v/i, '')
+    .split('-')[0]
+    .split('.')
+    .map((part) => Number.parseInt(part, 10) || 0);
+}
+
+function compareVersions(a, b) {
+  const av = parseVersion(a);
+  const bv = parseVersion(b);
+  const len = Math.max(av.length, bv.length, 3);
+
+  for (let i = 0; i < len; i += 1) {
+    const left = av[i] || 0;
+    const right = bv[i] || 0;
+    if (left > right) return 1;
+    if (left < right) return -1;
+  }
+  return 0;
+}
+
+async function fetchNpmMetadata() {
+  const response = await fetch(registryUrl, {
+    headers: {
+      accept: 'application/json',
+    },
+  });
+
+  if (!response.ok) {
+    throw new Error(`npm registry 返回 ${response.status} ${response.statusText}`);
+  }
+
+  return response.json();
+}
+
+function printUpdateCommand() {
+  console.log('\n  建议更新命令：');
+  console.log(`    npm install ${packageName}@latest --save`);
+  console.log('  或重新执行一键安装：');
+  console.log(`    npx -y -p ${packageName}@latest tfds-setup`);
+}
+
+async function main() {
+  const localPkg = readPackageJson();
+  const localVersion = localPkg.version;
+
+  console.log('\n╔══════════════════════════════════════════════════════╗');
+  console.log('║        TFDS NPM 版本更新检测                         ║');
+  console.log('╚══════════════════════════════════════════════════════╝');
+
+  if (localPkg.name !== packageName || !localVersion) {
+    console.log('\n[tfds-update-check] 当前脚本不在有效的 @tfdesign/b-end 包内。');
+    console.log(`  读取到的包名：${localPkg.name || '未知'}`);
+    console.log(`  读取到的版本：${localVersion || '未知'}\n`);
+    process.exit(1);
+  }
+
+  let metadata;
+  try {
+    metadata = await fetchNpmMetadata();
+  } catch (error) {
+    console.log('\n⚠ 暂时无法连接 npm registry，已跳过线上版本检测。');
+    console.log(`  当前本地版本：v ${localVersion}`);
+    console.log(`  原因：${error?.message || error}`);
+    console.log('\n  不影响继续使用 TFDS。网络恢复后可重新执行：');
+    console.log(`    node node_modules/${packageName}/scripts/check-tfds-update.mjs\n`);
+    process.exit(0);
+  }
+
+  const latestVersion = metadata?.['dist-tags']?.latest;
+  const localPublishedAt = metadata?.time?.[localVersion];
+  const latestPublishedAt = latestVersion ? metadata?.time?.[latestVersion] : metadata?.time?.modified;
+
+  if (!latestVersion) {
+    console.log('\n⚠ 已连接 npm registry，但没有读取到 latest 版本。');
+    console.log(`  当前本地版本：v ${localVersion}`);
+    console.log('  请稍后重试，或打开 npm 页面手动确认：');
+    console.log(`    https://www.npmjs.com/package/${packageName.replace('/', '%2F')}\n`);
+    process.exit(0);
+  }
+
+  const versionState = compareVersions(localVersion, latestVersion);
+
+  console.log(`\n  包名：${packageName}`);
+  console.log(`  当前版本：v ${localVersion}`);
+  console.log(`  当前版本更新时间：${formatDateToMinute(localPublishedAt)}`);
+  console.log(`  线上最新版本：v ${latestVersion}`);
+  console.log(`  最新版本更新时间：${formatDateToMinute(latestPublishedAt)}`);
+
+  if (versionState < 0) {
+    console.log('\n⚠ 检测到 TFDS 有新版本，可以选择更新后再生成页面。');
+    printUpdateCommand();
+    console.log('');
+    process.exit(0);
+  }
+
+  if (versionState > 0) {
+    console.log('\n✓ 当前本地版本高于 npm latest，可能是本地预发布或内部测试包。');
+    console.log('  如果你不是在调试 TFDS 包，请确认安装来源是否符合预期。\n');
+    process.exit(0);
+  }
+
+  console.log('\n✓ 当前已是 npm latest，可以继续使用 TFDS 生成页面。\n');
+}
+
+main().catch((error) => {
+  console.log('\n[tfds-update-check] 更新检测脚本异常退出。');
+  console.log(`  错误：${error?.message || error}\n`);
+  process.exit(1);
+});

package/scripts/postinstall-cursor-skill.mjs

@@ -1,4 +1,4 @@
-// 安装 @tfdesign/b-end 后自动执行三件事：
+// 安装 @tfdesign/b-end 后自动执行四件事：
 //
 //  1. IDE Skill 自动写入（仅 opt-in 通道，不写 always-on）
 //     → .cursor/skills/tfds/    （Cursor      → /tfds 唤起）
@@ -21,11 +21,15 @@
 //     已有 theme.css import → 跳过；未找到 @import "tailwindcss" → 不改写，终端提示
 //     跳过：SKIP_TFDS_CSS_PATCH=1
 //
-//  3. 终端安装报告（已做了什么、还差什么、如何唤起规范）
+//  3. npm 最新版本检测（只读提醒，不阻断安装）
+//     跳过：SKIP_TFDS_UPDATE_CHECK=1
+//
+//  4. 终端安装报告（已做了什么、还差什么、如何唤起规范）
 
 import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
+import { spawnSync } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 
 const __filename = fileURLToPath(import.meta.url);
@@ -49,6 +53,7 @@ function readJson(p) {
 const projectPkg = readJson(path.join(projectRoot, 'package.json'));
 const isSelfPkg = projectPkg?.name === '@tfdesign/b-end';
 const hasNoPkg = !projectPkg;
+const updateCheckScript = path.join(pkgRoot, 'scripts', 'check-tfds-update.mjs');
 
 if (hasNoPkg || isSelfPkg) {
   console.log('\n╔══════════════════════════════════════════════════════╗');
@@ -107,6 +112,33 @@ function readText(p) {
   }
 }
 
+function runUpdateCheck() {
+  if (process.env.SKIP_TFDS_UPDATE_CHECK === '1') {
+    done.push('版本更新检测已跳过（SKIP_TFDS_UPDATE_CHECK=1）');
+    return;
+  }
+
+  if (!fs.existsSync(updateCheckScript)) {
+    todo.push('未找到版本更新检测脚本，已跳过 npm latest 检查。');
+    return;
+  }
+
+  const result = spawnSync(process.execPath, [updateCheckScript], {
+    cwd: projectRoot,
+    stdio: 'inherit',
+    env: process.env,
+  });
+
+  if (result.error) {
+    todo.push(`版本更新检测未完成：${result.error.message}`);
+    return;
+  }
+
+  if (result.status && result.status !== 0) {
+    todo.push('版本更新检测脚本返回异常，但不影响本次安装。可稍后手动执行：node node_modules/@tfdesign/b-end/scripts/check-tfds-update.mjs');
+  }
+}
+
 function hasSourceSkillDiff(dest) {
   return REQUIRED_TFDS_SKILL_FILES.some((file) => {
     const sourceFile = path.join(skillSrc, file);
@@ -344,7 +376,13 @@ function patchEntryCss() {
 }
 
 // ─────────────────────────────────────────────────────────────────
-// Step 3: 终端安装报告
+// Step 3: 版本更新检测（只读，不阻断安装）
+// ─────────────────────────────────────────────────────────────────
+
+runUpdateCheck();
+
+// ─────────────────────────────────────────────────────────────────
+// Step 4: 终端安装报告
 // ─────────────────────────────────────────────────────────────────
 
 console.log('\n╔══════════════════════════════════════════════════════╗');
@@ -375,7 +413,7 @@ console.log(
   '  自检（只读）：node node_modules/@tfdesign/b-end/scripts/check-tfds-integration.mjs',
 );
 console.log(
-  '  跳过 CSS 补丁：SKIP_TFDS_CSS_PATCH=1 npm i   |   跳过 Skill：SKIP_TFDS_CURSOR_SKILL=1 npm i   |   跳过 Codex 全局 Skill：SKIP_TFDS_CODEX_GLOBAL=1 npm i',
+  '  跳过 CSS 补丁：SKIP_TFDS_CSS_PATCH=1 npm i   |   跳过 Skill：SKIP_TFDS_CURSOR_SKILL=1 npm i   |   跳过版本检测：SKIP_TFDS_UPDATE_CHECK=1 npm i',
 );
 console.log('');
 

package/skills/tfds/components.index.json

@@ -1,7 +1,7 @@
 {
   "system": "b-end",
   "skill": "tfds",
-  "generatedAt": "2026-05-11T04:59:21.276Z",
+  "generatedAt": "2026-05-11T06:16:09.447Z",
   "summary": "B 端 COMPONENTS 36 条 + 列表页模板 4 + PATTERNS 6；import 一律来自 @tf-designsystem/b-end。",
   "components": [
     {

package/skills/tfds/components.summary.json

@@ -1,7 +1,7 @@
 {
   "system": "b-end",
   "skill": "tfds",
-  "generatedAt": "2026-05-11T04:59:21.276Z",
+  "generatedAt": "2026-05-11T06:16:09.447Z",
   "purpose": "轻量组件与页面模板目录。AI 先读本文件做选型；确定命中组件后，再到 components.index.json 按 id 读取 props / rules / examples。",
   "counts": {
     "total": 46,