miaoda-game-devkit 0.2.10 → 0.2.12

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

@@ -2,11 +2,99 @@
 import { resolve as resolve4 } from "path";
 import { describe, expect, it } from "vitest";
 
+// src/react/manual-game-clock.ts
+var ManualGameClock = class {
+  time = 0;
+  nextId = 1;
+  frames = /* @__PURE__ */ new Map();
+  timers = /* @__PURE__ */ new Map();
+  now() {
+    return this.time;
+  }
+  requestFrame(callback) {
+    const id = this.nextId++;
+    this.frames.set(id, callback);
+    return id;
+  }
+  cancelFrame(id) {
+    this.frames.delete(id);
+  }
+  setTimeout(callback, delayMs) {
+    const id = this.nextId++;
+    this.timers.set(id, { callback, dueAt: this.time + delayMs });
+    return id;
+  }
+  clearTimeout(id) {
+    this.timers.delete(id);
+  }
+  advanceBy(deltaMs) {
+    if (!Number.isFinite(deltaMs) || deltaMs < 0) {
+      throw new RangeError("deltaMs must be a non-negative finite number");
+    }
+    this.time += deltaMs;
+    const dueTimers = [...this.timers.entries()].filter(([, timer]) => timer.dueAt <= this.time).sort((left, right) => left[1].dueAt - right[1].dueAt);
+    for (const [id, timer] of dueTimers) {
+      if (timer.dueAt <= this.time && this.timers.delete(id)) timer.callback();
+    }
+  }
+  stepFrame(deltaMs = 16) {
+    this.advanceBy(deltaMs);
+    const callbacks = [...this.frames.values()];
+    this.frames.clear();
+    for (const callback of callbacks) callback(this.time);
+  }
+  stepFrames(count, deltaMs = 16) {
+    if (!Number.isInteger(count) || count < 0) {
+      throw new RangeError("count must be a non-negative integer");
+    }
+    for (let index = 0; index < count; index += 1) this.stepFrame(deltaMs);
+  }
+  pendingFrameCount() {
+    return this.frames.size;
+  }
+  pendingTimerCount() {
+    return this.timers.size;
+  }
+};
+
+// src/react-vitest-config.ts
+import { resolve } from "path";
+import { defineConfig } from "vitest/config";
+function defineReactGameVitestConfig(options) {
+  return defineConfig({
+    resolve: {
+      alias: { ...options.aliases, "@": resolve(options.projectRoot, "src") }
+    },
+    test: {
+      include: [
+        "src/**/*.{test,spec}.{ts,tsx}",
+        "tests/**/*.{test,spec}.{ts,tsx}"
+      ],
+      environment: "jsdom",
+      environmentOptions: {
+        jsdom: { url: "http://localhost/", pretendToBeVisual: true }
+      },
+      setupFiles: [
+        "miaoda-game-devkit/react/vitest-setup",
+        ...options.additionalSetupFiles ?? []
+      ],
+      reporters: ["minimal"],
+      restoreMocks: true,
+      clearMocks: true,
+      testTimeout: options.testTimeout,
+      hookTimeout: options.hookTimeout
+    }
+  });
+}
+
 // src/vite.ts
 import { existsSync } from "fs";
 import { createRequire } from "module";
-import { dirname, join, normalize, resolve, sep } from "path";
+import { dirname, join, normalize, resolve as resolve2, sep } from "path";
 var PHASER_MODULE_ID = "phaser";
+var REXUI_OPTIMIZE_ENTRIES = [
+  "phaser4-rex-plugins/templates/ui/ui-plugin.js"
+];
 function isPromiseLike(value) {
   return typeof value === "object" && value !== null && "then" in value && typeof value.then === "function";
 }
@@ -27,14 +115,14 @@ function isInsideDirectory(filePath, directory) {
   return normalizedFile.startsWith(normalizedDirectory);
 }
 function phaserRexUIScenePlugin(projectRoot2) {
-  let scenesRoot = projectRoot2 ? resolve(projectRoot2, "src/scenes") : void 0;
+  let scenesRoot = projectRoot2 ? resolve2(projectRoot2, "src/scenes") : void 0;
   let phaserFacade = projectRoot2 ? resolvePhaserFacade(projectRoot2) : void 0;
   return {
     name: "miaoda-phaser-rexui-scene",
     enforce: "pre",
     configResolved(config) {
       const resolvedProjectRoot = projectRoot2 ?? config.root;
-      scenesRoot ??= resolve(resolvedProjectRoot, "src/scenes");
+      scenesRoot ??= resolve2(resolvedProjectRoot, "src/scenes");
       phaserFacade ??= resolvePhaserFacade(resolvedProjectRoot);
     },
     /** 查询参数属于构建工具元数据，去除后才能稳定判断真实源码位置。 */
@@ -48,8 +136,18 @@ function phaserRexUIScenePlugin(projectRoot2) {
   };
 }
 function withGameDefaults(config) {
+  const optimizeDeps = config.optimizeDeps ?? {};
   return {
     ...config,
+    optimizeDeps: {
+      ...optimizeDeps,
+      include: [
+        .../* @__PURE__ */ new Set([
+          ...optimizeDeps.include ?? [],
+          ...REXUI_OPTIMIZE_ENTRIES
+        ])
+      ]
+    },
     plugins: [
       phaserRexUIScenePlugin(),
       ...config.plugins ?? []
@@ -67,8 +165,8 @@ function defineGameViteConfig(config) {
 }
 
 // src/vitest-config.ts
-import { resolve as resolve2 } from "path";
-import { defineConfig } from "vitest/config";
+import { resolve as resolve3 } from "path";
+import { defineConfig as defineConfig2 } from "vitest/config";
 
 // src/gameplay-audit.ts
 import { readdirSync, readFileSync, statSync } from "fs";
@@ -672,6 +770,8 @@ GAMEPLAY_AUDIT: ALL CONTRACTS PASSED (${tests.filter((test) => test.metadata).le
 };
 
 // src/vitest-config.ts
+var PHASER_FACADE_DEPENDENCY = /miaoda-game-devkit[\\/]dist[\\/]phaser-facade\.mjs$/;
+var REXUI_DEPENDENCY = /phaser4-rex-plugins/;
 function defineGameVitestConfig(options) {
   const auditIssues = validateGameplayAuditOptions(options.gameplayAudit, options.projectRoot);
   if (auditIssues.length > 0) {
@@ -680,12 +780,12 @@ function defineGameVitestConfig(options) {
 - ${auditIssues.join("\n- ")}`
     );
   }
-  return defineConfig({
+  return defineConfig2({
     plugins: [phaserRexUIScenePlugin(options.projectRoot)],
     resolve: {
       alias: {
         ...options.aliases,
-        "@": resolve2(options.projectRoot, "src")
+        "@": resolve3(options.projectRoot, "src")
       }
     },
     // devkit 作为 external ESM 加载时，应用测试也必须 externalize Phaser，
@@ -703,7 +803,11 @@ function defineGameVitestConfig(options) {
           // 如果强制内联，Vite 会把这些模块按浏览器模块转换，
           // 最终触发 "No such built-in module: node:"。
           external: [/miaoda-game-devkit/],
-          inline: options.inlineDependencies
+          inline: [
+            PHASER_FACADE_DEPENDENCY,
+            REXUI_DEPENDENCY,
+            ...options.inlineDependencies ?? []
+          ]
         }
       },
       environment: "jsdom",
@@ -745,91 +849,6 @@ function defineGameVitestConfig(options) {
   });
 }
 
-// src/react-vitest-config.ts
-import { resolve as resolve3 } from "path";
-import { defineConfig as defineConfig2 } from "vitest/config";
-function defineReactGameVitestConfig(options) {
-  return defineConfig2({
-    resolve: {
-      alias: { ...options.aliases, "@": resolve3(options.projectRoot, "src") }
-    },
-    test: {
-      include: [
-        "src/**/*.{test,spec}.{ts,tsx}",
-        "tests/**/*.{test,spec}.{ts,tsx}"
-      ],
-      environment: "jsdom",
-      environmentOptions: {
-        jsdom: { url: "http://localhost/", pretendToBeVisual: true }
-      },
-      setupFiles: [
-        "miaoda-game-devkit/react/vitest-setup",
-        ...options.additionalSetupFiles ?? []
-      ],
-      reporters: ["minimal"],
-      restoreMocks: true,
-      clearMocks: true,
-      testTimeout: options.testTimeout,
-      hookTimeout: options.hookTimeout
-    }
-  });
-}
-
-// src/react/manual-game-clock.ts
-var ManualGameClock = class {
-  time = 0;
-  nextId = 1;
-  frames = /* @__PURE__ */ new Map();
-  timers = /* @__PURE__ */ new Map();
-  now() {
-    return this.time;
-  }
-  requestFrame(callback) {
-    const id = this.nextId++;
-    this.frames.set(id, callback);
-    return id;
-  }
-  cancelFrame(id) {
-    this.frames.delete(id);
-  }
-  setTimeout(callback, delayMs) {
-    const id = this.nextId++;
-    this.timers.set(id, { callback, dueAt: this.time + delayMs });
-    return id;
-  }
-  clearTimeout(id) {
-    this.timers.delete(id);
-  }
-  advanceBy(deltaMs) {
-    if (!Number.isFinite(deltaMs) || deltaMs < 0) {
-      throw new RangeError("deltaMs must be a non-negative finite number");
-    }
-    this.time += deltaMs;
-    const dueTimers = [...this.timers.entries()].filter(([, timer]) => timer.dueAt <= this.time).sort((left, right) => left[1].dueAt - right[1].dueAt);
-    for (const [id, timer] of dueTimers) {
-      if (timer.dueAt <= this.time && this.timers.delete(id)) timer.callback();
-    }
-  }
-  stepFrame(deltaMs = 16) {
-    this.advanceBy(deltaMs);
-    const callbacks = [...this.frames.values()];
-    this.frames.clear();
-    for (const callback of callbacks) callback(this.time);
-  }
-  stepFrames(count, deltaMs = 16) {
-    if (!Number.isInteger(count) || count < 0) {
-      throw new RangeError("count must be a non-negative integer");
-    }
-    for (let index = 0; index < count; index += 1) this.stepFrame(deltaMs);
-  }
-  pendingFrameCount() {
-    return this.frames.size;
-  }
-  pendingTimerCount() {
-    return this.timers.size;
-  }
-};
-
 // src/lint/vitest-config.test.ts
 var projectRoot = resolve4(import.meta.dirname, "../..");
 var gameplayAudit = {
@@ -862,6 +881,21 @@ describe("defineGameVitestConfig", () => {
       name: "miaoda-phaser-rexui-scene"
     });
   });
+  it("defineGameViteConfig \u9884\u6784\u5EFA\u52A8\u6001 RexUI \u5165\u53E3\u5E76\u4FDD\u7559\u9879\u76EE\u914D\u7F6E", () => {
+    const config = defineGameViteConfig({
+      optimizeDeps: {
+        include: ["application-dependency"],
+        exclude: ["excluded-dependency"]
+      }
+    });
+    expect(config.optimizeDeps).toEqual({
+      include: [
+        "application-dependency",
+        "phaser4-rex-plugins/templates/ui/ui-plugin.js"
+      ],
+      exclude: ["excluded-dependency"]
+    });
+  });
   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({
@@ -877,7 +911,10 @@ describe("defineGameVitestConfig", () => {
       server: {
         deps: {
           external: [/miaoda-game-devkit/],
-          inline: void 0
+          inline: [
+            /miaoda-game-devkit[\\/]dist[\\/]phaser-facade\.mjs$/,
+            /phaser4-rex-plugins/
+          ]
         }
       },
       environment: "jsdom",
@@ -907,7 +944,7 @@ describe("defineGameVitestConfig", () => {
     const config = defineGameVitestConfig({
       projectRoot,
       gameplayAudit,
-      inlineDependencies: [/phaser4-rex-plugins/],
+      inlineDependencies: [/project-specific-inline-dependency/],
       additionalSetupFiles: ["tests/custom-setup.ts"],
       testTimeout: 5e3,
       hookTimeout: 2e3
@@ -915,6 +952,15 @@ describe("defineGameVitestConfig", () => {
     expect(config.test).toMatchObject({
       include: ["tests/**/*.test.ts"],
       setupFiles: ["miaoda-game-devkit/vitest-setup", "tests/custom-setup.ts"],
+      server: {
+        deps: {
+          inline: [
+            /miaoda-game-devkit[\\/]dist[\\/]phaser-facade\.mjs$/,
+            /phaser4-rex-plugins/,
+            /project-specific-inline-dependency/
+          ]
+        }
+      },
       testTimeout: 5e3,
       hookTimeout: 2e3
     });

package/dist/vite.js

@@ -28,6 +28,9 @@ var import_node_fs = require("fs");
 var import_node_module = require("module");
 var import_node_path = require("path");
 var PHASER_MODULE_ID = "phaser";
+var REXUI_OPTIMIZE_ENTRIES = [
+  "phaser4-rex-plugins/templates/ui/ui-plugin.js"
+];
 function isPromiseLike(value) {
   return typeof value === "object" && value !== null && "then" in value && typeof value.then === "function";
 }
@@ -69,8 +72,18 @@ function phaserRexUIScenePlugin(projectRoot) {
   };
 }
 function withGameDefaults(config) {
+  const optimizeDeps = config.optimizeDeps ?? {};
   return {
     ...config,
+    optimizeDeps: {
+      ...optimizeDeps,
+      include: [
+        .../* @__PURE__ */ new Set([
+          ...optimizeDeps.include ?? [],
+          ...REXUI_OPTIMIZE_ENTRIES
+        ])
+      ]
+    },
     plugins: [
       phaserRexUIScenePlugin(),
       ...config.plugins ?? []

package/dist/vite.mjs

@@ -3,6 +3,9 @@ import { existsSync } from "fs";
 import { createRequire } from "module";
 import { dirname, join, normalize, resolve, sep } from "path";
 var PHASER_MODULE_ID = "phaser";
+var REXUI_OPTIMIZE_ENTRIES = [
+  "phaser4-rex-plugins/templates/ui/ui-plugin.js"
+];
 function isPromiseLike(value) {
   return typeof value === "object" && value !== null && "then" in value && typeof value.then === "function";
 }
@@ -44,8 +47,18 @@ function phaserRexUIScenePlugin(projectRoot) {
   };
 }
 function withGameDefaults(config) {
+  const optimizeDeps = config.optimizeDeps ?? {};
   return {
     ...config,
+    optimizeDeps: {
+      ...optimizeDeps,
+      include: [
+        .../* @__PURE__ */ new Set([
+          ...optimizeDeps.include ?? [],
+          ...REXUI_OPTIMIZE_ENTRIES
+        ])
+      ]
+    },
     plugins: [
       phaserRexUIScenePlugin(),
       ...config.plugins ?? []

package/dist/vitest-config.d.mts

@@ -1,5 +1,5 @@
 import { ViteUserConfig } from 'vitest/config';
-import { G as GameplayAuditOptions } from './gameplay-audit-BwAobjIX.mjs';
+import { G as GameplayAuditOptions } from './gameplay-audit-DmbBA0M_.mjs';
 import 'phaser';
 
 interface GameVitestConfigOptions {
@@ -11,7 +11,7 @@ interface GameVitestConfigOptions {
     aliases?: Record<string, string>;
     /** 在 devkit 基础 setup 之后执行的项目级 setup 文件。 */
     additionalSetupFiles?: string[];
-    /** 需要由 Vite 转换的项目依赖，例如包含无扩展名 import 的插件。 */
+    /** 除 devkit 内置 Phaser/RexUI 边界外，还需要由 Vite 转换的项目依赖。 */
     inlineDependencies?: RegExp[];
     /** 单个游戏运行时测试的超时时间。 */
     testTimeout?: number;

package/dist/vitest-config.d.ts

@@ -1,5 +1,5 @@
 import { ViteUserConfig } from 'vitest/config';
-import { G as GameplayAuditOptions } from './gameplay-audit-BwAobjIX.js';
+import { G as GameplayAuditOptions } from './gameplay-audit-DmbBA0M_.js';
 import 'phaser';
 
 interface GameVitestConfigOptions {
@@ -11,7 +11,7 @@ interface GameVitestConfigOptions {
     aliases?: Record<string, string>;
     /** 在 devkit 基础 setup 之后执行的项目级 setup 文件。 */
     additionalSetupFiles?: string[];
-    /** 需要由 Vite 转换的项目依赖，例如包含无扩展名 import 的插件。 */
+    /** 除 devkit 内置 Phaser/RexUI 边界外，还需要由 Vite 转换的项目依赖。 */
     inlineDependencies?: RegExp[];
     /** 单个游戏运行时测试的超时时间。 */
     testTimeout?: number;

package/dist/vitest-config.js

@@ -671,6 +671,8 @@ function phaserRexUIScenePlugin(projectRoot) {
 }
 
 // src/vitest-config.ts
+var PHASER_FACADE_DEPENDENCY = /miaoda-game-devkit[\\/]dist[\\/]phaser-facade\.mjs$/;
+var REXUI_DEPENDENCY = /phaser4-rex-plugins/;
 function defineGameVitestConfig(options) {
   const auditIssues = validateGameplayAuditOptions(options.gameplayAudit, options.projectRoot);
   if (auditIssues.length > 0) {
@@ -702,7 +704,11 @@ function defineGameVitestConfig(options) {
           // 如果强制内联，Vite 会把这些模块按浏览器模块转换，
           // 最终触发 "No such built-in module: node:"。
           external: [/miaoda-game-devkit/],
-          inline: options.inlineDependencies
+          inline: [
+            PHASER_FACADE_DEPENDENCY,
+            REXUI_DEPENDENCY,
+            ...options.inlineDependencies ?? []
+          ]
         }
       },
       environment: "jsdom",

package/dist/vitest-config.mjs

@@ -647,6 +647,8 @@ function phaserRexUIScenePlugin(projectRoot) {
 }
 
 // src/vitest-config.ts
+var PHASER_FACADE_DEPENDENCY = /miaoda-game-devkit[\\/]dist[\\/]phaser-facade\.mjs$/;
+var REXUI_DEPENDENCY = /phaser4-rex-plugins/;
 function defineGameVitestConfig(options) {
   const auditIssues = validateGameplayAuditOptions(options.gameplayAudit, options.projectRoot);
   if (auditIssues.length > 0) {
@@ -678,7 +680,11 @@ function defineGameVitestConfig(options) {
           // 如果强制内联，Vite 会把这些模块按浏览器模块转换，
           // 最终触发 "No such built-in module: node:"。
           external: [/miaoda-game-devkit/],
-          inline: options.inlineDependencies
+          inline: [
+            PHASER_FACADE_DEPENDENCY,
+            REXUI_DEPENDENCY,
+            ...options.inlineDependencies ?? []
+          ]
         }
       },
       environment: "jsdom",

package/package.json

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