@fps-games/vfx 0.3.3 → 0.3.4

package/CHANGELOG.md

@@ -12,6 +12,14 @@
 
 <!-- release.mjs 在此行下方插入新版本区块 -->
 
+## v0.3.4 — 2026-06-30
+
+### 改动
+- fix(tooling): use @fps-games package name
+
+### 特效
+- 无新增 / 删除(仍 37 个)。
+
 ## v0.3.3 — 2026-06-30
 
 ### 改动

package/README.md

@@ -1,4 +1,4 @@
-# @fps/vfx
+# @fps-games/vfx
 
 Babylon.js 共享 VFX 特效库。导入即用 + 项目内调试面板。消费模型 = **模型 C**(runtime/类型来自包,本地 `import.meta.glob` 装配注册表);发布 = **做法A**(dist 提交进 git + tag,消费端 clone 即用,无需 build)。
 
@@ -15,12 +15,12 @@ Babylon.js 共享 VFX 特效库。导入即用 + 项目内调试面板。消费
 
 ```jsonc
 // package.json —— git tag 即版本锁
-"@fps/vfx": "git+ssh://git@github.com/forge-play-studio/fps-vfx-library.git#v0.3.0"
+"@fps-games/vfx": "^0.3.4"
 ```
 ```ts
 // src/assets/vfx/index.ts —— 装配注册表(模型 C)
-import { buildRegistry, type VfxRegistry } from '@fps/vfx';
-export * from '@fps/vfx';
+import { buildRegistry, type VfxRegistry } from '@fps-games/vfx';
+export * from '@fps-games/vfx';
 const modules = import.meta.glob('./effects/*/index.ts', { eager: true }) as Record<string, Record<string, unknown>>;
 const params  = import.meta.glob('./effects/*/vfx-params.json', { eager: true }) as Record<string, { default: unknown }>;
 export const VFX_REGISTRY: VfxRegistry = buildRegistry({ modules, params });
@@ -31,7 +31,7 @@ const svc = new EffectPackageService(scene, { registry: VFX_REGISTRY });
 svc.playEffectPackage('thruster-flame', {}, { parent: engineSocket, offsetIsLocal: true });
 ```
 
-> ⚠️ 三个最易漏:① `@fps/vfx` 要加进 vite 构建白名单;② Babylon 要 `resolve.dedupe`;③ glob 只扫本地 `effects/*`,每个要用的特效都得建本地桩(re-export 库内预制即可)。详见 [INTEGRATION.md](./docs/INTEGRATION.md)。
+> ⚠️ 三个最易漏:① `@fps-games/vfx` 要加进 vite 构建白名单;② Babylon 要 `resolve.dedupe`;③ glob 只扫本地 `effects/*`,每个要用的特效都得建本地桩(re-export 库内预制即可)。详见 [INTEGRATION.md](./docs/INTEGRATION.md)。
 
 ## 开发
 

package/dist/effects/treasure-attention/index.d.ts

@@ -38,7 +38,7 @@ export interface CreateTreasureAttentionOptions {
     renderingGroupId?: number;
     glowLayer?: GlowLayer | null;
     disposeRoot?: boolean;
-    /** 经 @fps/vfx 包播放时为 true:root 的 transform 归 service 独占(placement/挂载由 service 管),特效不写 root.position(G6)。 */
+    /** 经 @fps-games/vfx 包播放时为 true:root 的 transform 归 service 独占(placement/挂载由 service 管),特效不写 root.position(G6)。 */
     serviceOwnedRoot?: boolean;
 }
 export interface TreasureAttentionHandle extends VfxEffectHandle {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fps-games/vfx",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "type": "module",
   "description": "Shared VFX library for Playable projects: engine-injected effect packages + runtime. Project-pure (no imports of host project code).",
   "publishConfig": {
@@ -45,7 +45,7 @@
     "demo:treasure-attention": "vite demo/treasure-attention --host 127.0.0.1",
     "release": "node scripts/release.mjs"
   },
-  "//": "分发=git tag + 提交 dist(做法A):发版前 pnpm build → 提交 dist/ → git tag。消费端 import '@fps/vfx' 解析到 dist;本地开发可用 FPS_VFX_LIBRARY_REPO 切回源码 alias。",
+  "//": "分发=git tag + 提交 dist(做法A):发版前 pnpm build → 提交 dist/ → git tag。消费端 import '@fps-games/vfx' 解析到 dist;本地开发可用 FPS_VFX_LIBRARY_REPO 切回源码 alias。",
   "devDependencies": {
     "@babylonjs/core": "^8.56.2",
     "@babylonjs/loaders": "^8.56.2",

package/tooling/vfx-cli.mjs

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
-// @fps/vfx CLI:把库特效以「re-export 桩 + 本地 vfx-params.json」装进项目(plan §6.2/§16 混合分发 模型C),
+// @fps-games/vfx CLI:把库特效以「re-export 桩 + 本地 vfx-params.json」装进项目(plan §6.2/§16 混合分发 模型C),
 // 并管理版本升级(issue #4)。消费方典型调用:
-//   node node_modules/@fps/vfx/tooling/vfx-cli.mjs <cmd> --project .
+//   node node_modules/@fps-games/vfx/tooling/vfx-cli.mjs <cmd> --project .
 //
 //   list                                      列出库里可用特效
 //   add <id> [--project <dir>] [--force]      装一个特效(桩 + vfx-params.json + .vfx-source.json)
-//   outdated [--project <dir>]                对比项目钉的 @fps/vfx 版本 / 各特效 provenance vs 最新
+//   outdated [--project <dir>]                对比项目钉的 @fps-games/vfx 版本 / 各特效 provenance vs 最新
 //   update [<id>] [--project <dir>] [--to vX.Y.Z]
-//                                             升级:改 package.json 的 @fps/vfx git-tag ref + 重同步桩
+//                                             升级:改 package.json 的 @fps-games/vfx git-tag ref + 重同步桩
 //                                             + 不动 vfx-params.json + 打印 CHANGELOG 区间(然后 pnpm install)
 import { readdirSync, statSync, existsSync, mkdirSync, readFileSync, writeFileSync, copyFileSync } from 'node:fs';
 import { execFileSync } from 'node:child_process';
@@ -16,6 +16,7 @@ import { fileURLToPath } from 'node:url';
 
 const LIB_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
 const LIB_EFFECTS = join(LIB_ROOT, 'packages', 'effects');
+const PACKAGE_NAME = '@fps-games/vfx';
 const LIB_VERSION = (() => { try { return JSON.parse(readFileSync(join(LIB_ROOT, 'package.json'), 'utf8')).version; } catch { return '0.0.0'; } })();
 const LIB_INDEX = (() => {
   try { return JSON.parse(readFileSync(join(LIB_ROOT, 'index.json'), 'utf8')); } catch { return null; }
@@ -45,11 +46,11 @@ function hasLibEffect(id) {
   return libEffectIds().includes(id) || existsSync(join(LIB_EFFECTS, id, 'vfx-params.json'));
 }
 function stub(id) {
-  return `// @fps/vfx re-export 桩(代码/资源在包内;本地仅 vfx-params.json + 此桩)。\nexport * from '@fps/vfx/effects/${id}';\n`;
+  return `// ${PACKAGE_NAME} re-export 桩(代码/资源在包内;本地仅 vfx-params.json + 此桩)。\nexport * from '${PACKAGE_NAME}/effects/${id}';\n`;
 }
 function effectsDestDir() { return join(projectRoot, 'src', 'assets', 'vfx', 'effects'); }
 function provenance(id, version) {
-  return JSON.stringify({ id, source: '@fps/vfx', version }, null, 2) + '\n';
+  return JSON.stringify({ id, source: PACKAGE_NAME, version }, null, 2) + '\n';
 }
 function normVer(v) { return String(v ?? '').replace(/^v/, ''); }
 function semverCmp(a, b) {
@@ -58,17 +59,17 @@ function semverCmp(a, b) {
   return 0;
 }
 
-// 读项目 package.json 里的 @fps/vfx 依赖(原始文本 + 解析值)。
+// 读项目 package.json 里的 VFX 依赖(原始文本 + 解析值)。
 function readProjectVfxDep() {
   const p = join(projectRoot, 'package.json');
   if (!existsSync(p)) return null;
   const raw = readFileSync(p, 'utf8');
   const json = JSON.parse(raw);
   for (const field of ['dependencies', 'devDependencies', 'optionalDependencies']) {
-    const val = json[field]?.['@fps/vfx'];
-    if (val) return { path: p, raw, json, field, value: val };
+    const deps = json[field] ?? {};
+    if (deps[PACKAGE_NAME]) return { path: p, raw, json, field, packageName: PACKAGE_NAME, value: deps[PACKAGE_NAME] };
   }
-  return { path: p, raw, json, field: null, value: null };
+  return { path: p, raw, json, field: null, packageName: null, value: null };
 }
 function pinFromValue(value) { const m = String(value ?? '').match(/#v?(\d+\.\d+\.\d+)/); return m ? m[1] : null; }
 function repoUrlFromValue(value) { return String(value ?? '').replace(/#.*$/, ''); }
@@ -150,7 +151,7 @@ function outdated() {
   const latestSource = remote ? '远端最新 tag' : `本库版本(远端不可达,回退)`;
 
   console.log(`项目:${projectRoot}`);
-  console.log(`@fps/vfx 钉版本:${pin ? `v${pin}` : '(未钉 / 非 git-tag)'}  →  最新:v${latest}(${latestSource})`);
+  console.log(`${dep.packageName ?? PACKAGE_NAME} 钉版本:${pin ? `v${pin}` : '(未钉 / 非 git-tag)'}  →  最新:v${latest}(${latestSource})`);
   const depBehind = pin && semverCmp(pin, latest) < 0;
   console.log(depBehind ? `⬆ 依赖落后:可升级到 v${latest}(\`vfx update --to v${latest}\` + pnpm install)` : `✓ 依赖已是最新(或无法判定)。`);
 
@@ -162,7 +163,7 @@ function outdated() {
       const tag = v == null ? '无 provenance(早期批量安装)' : (semverCmp(v, latest) < 0 ? `v${v} ⬆ 落后` : `v${v} ✓`);
       console.log(`  - ${e.id}  [${tag}]`);
     }
-    console.log(`\n注:模型C 下特效代码/资源在 @fps/vfx 包内,真实版本由上面的依赖钉版本决定;`);
+    console.log(`\n注:模型C 下特效代码/资源在 ${PACKAGE_NAME} 包内,真实版本由上面的依赖钉版本决定;`);
     console.log(`    .vfx-source.json 仅作 add 时的来源记录,落后不影响运行(随依赖升级即同步)。`);
   } else {
     console.log(`\n(项目 ${effectsDestDir()} 下暂无已装特效)`);
@@ -178,7 +179,7 @@ function update(onlyId) {
   const toFlag = flagVal('--to');
   const target = normVer(toFlag ?? latestRemoteTag(repoUrl) ?? LIB_VERSION);
 
-  // 1) 改 package.json 的 @fps/vfx git-tag ref(保留原 url 与格式,仅换 #ref)。
+  // 1) 改 package.json 的 VFX git-tag ref(保留原 url 与格式,仅换 #ref)。
   const isGitDep = /(^git\+|:\/\/|github\.com|\.git)/.test(dep.value ?? '');
   if (dep.field && dep.value && (/#/.test(dep.value) || isGitDep)) {
     let newValue;
@@ -186,21 +187,22 @@ function update(onlyId) {
     else newValue = `${dep.value}#v${target}`;
     if (newValue !== dep.value) {
       // 原文本就地替换,避免重排整份 package.json;用替换函数避免 newValue 里的 $ 被当替换记号。
-      const depValRe = new RegExp(`("@fps/vfx"\\s*:\\s*")${dep.value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}(")`);
+      const depName = dep.packageName ?? PACKAGE_NAME;
+      const depValRe = new RegExp(`("${depName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}"\\s*:\\s*")${dep.value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}(")`);
       const newRaw = dep.raw.replace(depValRe, (_m, p1, p2) => `${p1}${newValue}${p2}`);
       if (newRaw !== dep.raw) {
         writeFileSync(dep.path, newRaw);
-        console.log(`✓ package.json:@fps/vfx ${oldPin ? `#v${oldPin}` : dep.value} → #v${target}`);
+        console.log(`✓ package.json:${depName} ${oldPin ? `#v${oldPin}` : dep.value} → ${PACKAGE_NAME}#v${target}`);
       } else {
-        console.warn(`! 未能就地替换 @fps/vfx 依赖文本,请手动把 ref 改成 #v${target}。`);
+        console.warn(`! 未能就地替换 ${depName} 依赖文本,请手动把 ref 改成 ${PACKAGE_NAME}#v${target}。`);
       }
     } else {
-      console.log(`= package.json:@fps/vfx 已是 #v${target}。`);
+      console.log(`= package.json:${dep.packageName ?? PACKAGE_NAME} 已是 #v${target}。`);
     }
   } else if (dep.field && dep.value) {
-    console.warn(`! @fps/vfx 依赖 "${dep.value}" 不是 git-tag 形式,跳过 ref 升级(仅重同步桩)。如需固定版本,请手动改成 git+ssh://…#v${target}。`);
+    console.warn(`! ${dep.packageName ?? PACKAGE_NAME} 依赖 "${dep.value}" 不是 git-tag 形式,跳过 ref 升级(仅重同步桩)。如需固定版本,请手动改成 git+ssh://…#v${target}。`);
   } else {
-    console.warn(`! 项目 package.json 未声明 @fps/vfx 依赖,跳过 ref 升级(仅同步桩)。`);
+    console.warn(`! 项目 package.json 未声明 ${PACKAGE_NAME} 依赖,跳过 ref 升级(仅同步桩)。`);
   }
 
   // 2) 重同步桩 + bump .vfx-source.json(永不动 vfx-params.json)。
@@ -219,12 +221,12 @@ function update(onlyId) {
   const range = changelogRange(oldPin, target);
   if (range) { console.log(`\n── CHANGELOG ${oldPin ? `v${oldPin} → ` : ''}v${target} ──\n${range}\n`); }
 
-  console.log(`\n下一步:\`pnpm install\`(拉取 @fps/vfx#v${target} 新代码/资源)。`);
+  console.log(`\n下一步:\`pnpm install\`(拉取 ${PACKAGE_NAME}#v${target} 新代码/资源)。`);
 }
 
 // ── dispatch ──────────────────────────────────────────────────────────────────
 if (cmd === 'list') {
-  console.log(`@fps/vfx 可用特效(v${LIB_VERSION}):`);
+  console.log(`${PACKAGE_NAME} 可用特效(v${LIB_VERSION}):`);
   for (const id of libEffectIds().sort()) console.log(`  - ${id}`);
 } else if (cmd === 'add') {
   if (!positional[0]) { console.error('用法: add <id> [--project <dir>] [--force]'); process.exit(1); }

package/tooling/vfx-package-resolution.mjs

@@ -1,6 +1,6 @@
-// @fps/vfx 的 Vite 接入助手(plan §18.3:克隆 editor 蓝图,简化为单包)。
+// @fps-games/vfx 的 Vite 接入助手(plan §18.3:克隆 editor 蓝图,简化为单包)。
 // 消费方 vite.config:
-//   import { createVfxLibrarySourceAlias, VFX_BABYLON_DEDUPE } from '@fps/vfx/vite'(或本文件路径)
+//   import { createVfxLibrarySourceAlias, VFX_BABYLON_DEDUPE } from '@fps-games/vfx/vite'(或本文件路径)
 //   resolve: { alias: [...createVfxLibrarySourceAlias(process.env.FPS_VFX_LIBRARY_REPO)], dedupe: [...VFX_BABYLON_DEDUPE] }
 import { resolve } from 'node:path';
 
@@ -8,7 +8,7 @@ import { resolve } from 'node:path';
 export const VFX_BABYLON_DEDUPE = ['@babylonjs/core', '@babylonjs/loaders'];
 
 /**
- * 源码模式:把 `@fps/vfx` / `@fps/vfx/effects/<id>` 别名到本地库源(供 dev / SDK 联调)。
+ * 源码模式:把 `@fps-games/vfx` / `@fps-games/vfx/effects/<id>` 别名到本地库源(供 dev / SDK 联调)。
  * @param {string} libRepoRoot fps-vfx-library 仓库根(通常来自 process.env.FPS_VFX_LIBRARY_REPO)
  * @returns vite alias 数组(给 resolve.alias)
  */
@@ -18,11 +18,11 @@ export function createVfxLibrarySourceAlias(libRepoRoot) {
   }
   const pkgs = resolve(libRepoRoot, 'packages');
   return [
-    // 子路径:@fps/vfx/effects/<id> → packages/effects/<id>/index.ts
-    { find: /^@fps\/vfx\/effects\/(.+)$/, replacement: resolve(pkgs, 'effects') + '/$1/index.ts' },
-    // 根入口:@fps/vfx → packages/index.ts
-    { find: /^@fps\/vfx$/, replacement: resolve(pkgs, 'index.ts') },
+    // 子路径:@fps-games/vfx/effects/<id> → packages/effects/<id>/index.ts
+    { find: /^@fps-games\/vfx\/effects\/(.+)$/, replacement: resolve(pkgs, 'effects') + '/$1/index.ts' },
+    // 根入口:@fps-games/vfx → packages/index.ts
+    { find: /^@fps-games\/vfx$/, replacement: resolve(pkgs, 'index.ts') },
     // vite 助手子路径(本文件)
-    { find: /^@fps\/vfx\/vite$/, replacement: resolve(libRepoRoot, 'tooling', 'vfx-package-resolution.mjs') },
+    { find: /^@fps-games\/vfx\/vite$/, replacement: resolve(libRepoRoot, 'tooling', 'vfx-package-resolution.mjs') },
   ];
 }