miaoda-game-devkit 0.2.1 → 0.2.2

package/dist/lint/vitest-config.contract.mjs

@@ -3,8 +3,7 @@ import { resolve as resolve2 } from "path";
 import { describe, expect, it } from "vitest";
 
 // src/vitest-config.ts
-import { createRequire } from "module";
-import { dirname, resolve } from "path";
+import { resolve } from "path";
 import { defineConfig } from "vitest/config";
 
 // src/gameplay-audit.ts
@@ -338,21 +337,18 @@ function defineGameVitestConfig(options) {
 - ${auditIssues.join("\n- ")}`
     );
   }
-  const projectRequire = createRequire(
-    resolve(options.projectRoot, "package.json")
-  );
-  const phaserPackageRoot = dirname(
-    projectRequire.resolve("phaser/package.json")
-  );
-  const phaserBrowserBuild = resolve(phaserPackageRoot, "dist/phaser.js");
   return defineConfig({
     resolve: {
       alias: {
         ...options.aliases,
-        "@": resolve(options.projectRoot, "src"),
-        phaser: phaserBrowserBuild
+        "@": resolve(options.projectRoot, "src")
       }
     },
+    // devkit 作为 external ESM 加载时，应用测试也必须 externalize Phaser，
+    // 否则 Vite alias 与 Node 条件导出会创建两个 Phaser 单例，Scene 无法启动。
+    ssr: {
+      external: ["phaser"]
+    },
     test: {
       include: ["tests/**/*.test.ts"],
       testTimeout: options.testTimeout,
@@ -362,7 +358,8 @@ function defineGameVitestConfig(options) {
           // devkit 模块需要在配置和审计阶段使用 Node 内置模块。
           // 如果强制内联，Vite 会把这些模块按浏览器模块转换，
           // 最终触发 "No such built-in module: node:"。
-          external: [/miaoda-game-devkit/]
+          external: [/miaoda-game-devkit/],
+          inline: options.inlineDependencies
         }
       },
       environment: "jsdom",
@@ -417,14 +414,16 @@ describe("defineGameVitestConfig", () => {
   it("\u63D0\u4F9B Phaser \u8FD0\u884C\u65F6\u6D4B\u8BD5\u9700\u8981\u7684\u56FA\u5B9A\u57FA\u7EBF", () => {
     const config = defineGameVitestConfig({ projectRoot, gameplayAudit });
     expect(config.resolve?.alias).toMatchObject({
-      "@": resolve2(projectRoot, "src"),
-      phaser: expect.stringContaining("phaser/dist/phaser.js")
+      "@": resolve2(projectRoot, "src")
     });
+    expect(config.resolve?.alias).not.toHaveProperty("phaser");
+    expect(config.ssr).toMatchObject({ external: ["phaser"] });
     expect(config.test).toMatchObject({
       include: ["tests/**/*.test.ts"],
       server: {
         deps: {
-          external: [/miaoda-game-devkit/]
+          external: [/miaoda-game-devkit/],
+          inline: void 0
         }
       },
       environment: "jsdom",
@@ -454,6 +453,7 @@ describe("defineGameVitestConfig", () => {
     const config = defineGameVitestConfig({
       projectRoot,
       gameplayAudit,
+      inlineDependencies: [/phaser4-rex-plugins/],
       additionalSetupFiles: ["tests/custom-setup.ts"],
       testTimeout: 5e3,
       hookTimeout: 2e3

package/dist/vitest-config.d.mts

@@ -7,10 +7,12 @@ interface GameVitestConfigOptions {
     projectRoot: string;
     /** 测试前后都必须审计的生产 Scene 和玩法契约清单。 */
     gameplayAudit: GameplayAuditOptions;
-    /** 项目需要的额外路径别名；`@` 和 `phaser` 由 devkit 统一维护。 */
+    /** 项目需要的额外路径别名；`@` 由 devkit 统一维护。 */
     aliases?: Record<string, string>;
     /** 在 devkit 基础 setup 之后执行的项目级 setup 文件。 */
     additionalSetupFiles?: string[];
+    /** 需要由 Vite 转换的项目依赖，例如包含无扩展名 import 的插件。 */
+    inlineDependencies?: RegExp[];
     /** 单个游戏运行时测试的超时时间。 */
     testTimeout?: number;
     /** 单个游戏测试钩子的超时时间。 */

package/dist/vitest-config.d.ts

@@ -7,10 +7,12 @@ interface GameVitestConfigOptions {
     projectRoot: string;
     /** 测试前后都必须审计的生产 Scene 和玩法契约清单。 */
     gameplayAudit: GameplayAuditOptions;
-    /** 项目需要的额外路径别名；`@` 和 `phaser` 由 devkit 统一维护。 */
+    /** 项目需要的额外路径别名；`@` 由 devkit 统一维护。 */
     aliases?: Record<string, string>;
     /** 在 devkit 基础 setup 之后执行的项目级 setup 文件。 */
     additionalSetupFiles?: string[];
+    /** 需要由 Vite 转换的项目依赖，例如包含无扩展名 import 的插件。 */
+    inlineDependencies?: RegExp[];
     /** 单个游戏运行时测试的超时时间。 */
     testTimeout?: number;
     /** 单个游戏测试钩子的超时时间。 */

package/dist/vitest-config.js

@@ -23,7 +23,6 @@ __export(vitest_config_exports, {
   defineGameVitestConfig: () => defineGameVitestConfig
 });
 module.exports = __toCommonJS(vitest_config_exports);
-var import_node_module = require("module");
 var import_node_path2 = require("path");
 var import_config = require("vitest/config");
 
@@ -358,21 +357,18 @@ function defineGameVitestConfig(options) {
 - ${auditIssues.join("\n- ")}`
     );
   }
-  const projectRequire = (0, import_node_module.createRequire)(
-    (0, import_node_path2.resolve)(options.projectRoot, "package.json")
-  );
-  const phaserPackageRoot = (0, import_node_path2.dirname)(
-    projectRequire.resolve("phaser/package.json")
-  );
-  const phaserBrowserBuild = (0, import_node_path2.resolve)(phaserPackageRoot, "dist/phaser.js");
   return (0, import_config.defineConfig)({
     resolve: {
       alias: {
         ...options.aliases,
-        "@": (0, import_node_path2.resolve)(options.projectRoot, "src"),
-        phaser: phaserBrowserBuild
+        "@": (0, import_node_path2.resolve)(options.projectRoot, "src")
       }
     },
+    // devkit 作为 external ESM 加载时，应用测试也必须 externalize Phaser，
+    // 否则 Vite alias 与 Node 条件导出会创建两个 Phaser 单例，Scene 无法启动。
+    ssr: {
+      external: ["phaser"]
+    },
     test: {
       include: ["tests/**/*.test.ts"],
       testTimeout: options.testTimeout,
@@ -382,7 +378,8 @@ function defineGameVitestConfig(options) {
           // devkit 模块需要在配置和审计阶段使用 Node 内置模块。
           // 如果强制内联，Vite 会把这些模块按浏览器模块转换，
           // 最终触发 "No such built-in module: node:"。
-          external: [/miaoda-game-devkit/]
+          external: [/miaoda-game-devkit/],
+          inline: options.inlineDependencies
         }
       },
       environment: "jsdom",

package/dist/vitest-config.mjs

@@ -1,6 +1,5 @@
 // src/vitest-config.ts
-import { createRequire } from "module";
-import { dirname, resolve } from "path";
+import { resolve } from "path";
 import { defineConfig } from "vitest/config";
 
 // src/gameplay-audit.ts
@@ -334,21 +333,18 @@ function defineGameVitestConfig(options) {
 - ${auditIssues.join("\n- ")}`
     );
   }
-  const projectRequire = createRequire(
-    resolve(options.projectRoot, "package.json")
-  );
-  const phaserPackageRoot = dirname(
-    projectRequire.resolve("phaser/package.json")
-  );
-  const phaserBrowserBuild = resolve(phaserPackageRoot, "dist/phaser.js");
   return defineConfig({
     resolve: {
       alias: {
         ...options.aliases,
-        "@": resolve(options.projectRoot, "src"),
-        phaser: phaserBrowserBuild
+        "@": resolve(options.projectRoot, "src")
       }
     },
+    // devkit 作为 external ESM 加载时，应用测试也必须 externalize Phaser，
+    // 否则 Vite alias 与 Node 条件导出会创建两个 Phaser 单例，Scene 无法启动。
+    ssr: {
+      external: ["phaser"]
+    },
     test: {
       include: ["tests/**/*.test.ts"],
       testTimeout: options.testTimeout,
@@ -358,7 +354,8 @@ function defineGameVitestConfig(options) {
           // devkit 模块需要在配置和审计阶段使用 Node 内置模块。
           // 如果强制内联，Vite 会把这些模块按浏览器模块转换，
           // 最终触发 "No such built-in module: node:"。
-          external: [/miaoda-game-devkit/]
+          external: [/miaoda-game-devkit/],
+          inline: options.inlineDependencies
         }
       },
       environment: "jsdom",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "miaoda-game-devkit",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Shared lint and deterministic Phaser HEADLESS testing tools for Miaoda games",
   "license": "MIT",
   "main": "./dist/index.js",