miaoda-game-devkit 0.2.9 → 0.2.11

package/dist/react/testing.js

@@ -0,0 +1,82 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/react/manual-game-clock.ts
+var manual_game_clock_exports = {};
+__export(manual_game_clock_exports, {
+  ManualGameClock: () => ManualGameClock
+});
+module.exports = __toCommonJS(manual_game_clock_exports);
+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;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ManualGameClock
+});

package/dist/react/testing.mjs

@@ -0,0 +1,57 @@
+// 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;
+  }
+};
+export {
+  ManualGameClock
+};

package/dist/react/vitest-config.d.mts

@@ -0,0 +1,14 @@
+import { ViteUserConfig } from 'vitest/config';
+
+interface ReactGameVitestConfigOptions {
+    /** React 模板的绝对根目录，通常传入 `import.meta.dirname`。 */
+    projectRoot: string;
+    aliases?: Record<string, string>;
+    additionalSetupFiles?: string[];
+    testTimeout?: number;
+    hookTimeout?: number;
+}
+/** 创建默认使用 JSDOM 的 React 游戏 Vitest 配置。 */
+declare function defineReactGameVitestConfig(options: ReactGameVitestConfigOptions): ViteUserConfig;
+
+export { type ReactGameVitestConfigOptions, defineReactGameVitestConfig };

package/dist/react/vitest-config.d.ts

@@ -0,0 +1,14 @@
+import { ViteUserConfig } from 'vitest/config';
+
+interface ReactGameVitestConfigOptions {
+    /** React 模板的绝对根目录，通常传入 `import.meta.dirname`。 */
+    projectRoot: string;
+    aliases?: Record<string, string>;
+    additionalSetupFiles?: string[];
+    testTimeout?: number;
+    hookTimeout?: number;
+}
+/** 创建默认使用 JSDOM 的 React 游戏 Vitest 配置。 */
+declare function defineReactGameVitestConfig(options: ReactGameVitestConfigOptions): ViteUserConfig;
+
+export { type ReactGameVitestConfigOptions, defineReactGameVitestConfig };

package/dist/react/vitest-config.js

@@ -0,0 +1,57 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/react-vitest-config.ts
+var react_vitest_config_exports = {};
+__export(react_vitest_config_exports, {
+  defineReactGameVitestConfig: () => defineReactGameVitestConfig
+});
+module.exports = __toCommonJS(react_vitest_config_exports);
+var import_node_path = require("path");
+var import_config = require("vitest/config");
+function defineReactGameVitestConfig(options) {
+  return (0, import_config.defineConfig)({
+    resolve: {
+      alias: { ...options.aliases, "@": (0, import_node_path.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
+    }
+  });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defineReactGameVitestConfig
+});

package/dist/react/vitest-config.mjs

@@ -0,0 +1,32 @@
+// 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
+    }
+  });
+}
+export {
+  defineReactGameVitestConfig
+};

package/dist/react/vitest-setup.d.mts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/react/vitest-setup.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/react/vitest-setup.js

@@ -0,0 +1,35 @@
+"use strict";
+
+// src/react-vitest-setup.ts
+var import_vitest = require("@testing-library/jest-dom/vitest");
+var import_react = require("@testing-library/react");
+var import_vitest2 = require("vitest");
+var failures = [];
+var consoleError;
+var onError = (event) => failures.push(event.error ?? event.message);
+var onRejection = (event) => failures.push(event.reason);
+(0, import_vitest2.beforeEach)(() => {
+  failures = [];
+  window.addEventListener("error", onError);
+  window.addEventListener("unhandledrejection", onRejection);
+  consoleError = import_vitest2.vi.spyOn(console, "error").mockImplementation((...args) => {
+    failures.push(args);
+  });
+});
+(0, import_vitest2.afterEach)(() => {
+  try {
+    (0, import_react.cleanup)();
+  } catch (error) {
+    failures.push(error);
+  } finally {
+    window.removeEventListener("error", onError);
+    window.removeEventListener("unhandledrejection", onRejection);
+    consoleError?.mockRestore();
+    consoleError = void 0;
+  }
+  if (failures.length > 0) {
+    const captured = failures;
+    failures = [];
+    throw new AggregateError(captured, "Unexpected React/JSDOM runtime failures");
+  }
+});

package/dist/react/vitest-setup.mjs

@@ -0,0 +1,33 @@
+// src/react-vitest-setup.ts
+import "@testing-library/jest-dom/vitest";
+import { cleanup } from "@testing-library/react";
+import { afterEach, beforeEach, vi } from "vitest";
+var failures = [];
+var consoleError;
+var onError = (event) => failures.push(event.error ?? event.message);
+var onRejection = (event) => failures.push(event.reason);
+beforeEach(() => {
+  failures = [];
+  window.addEventListener("error", onError);
+  window.addEventListener("unhandledrejection", onRejection);
+  consoleError = vi.spyOn(console, "error").mockImplementation((...args) => {
+    failures.push(args);
+  });
+});
+afterEach(() => {
+  try {
+    cleanup();
+  } catch (error) {
+    failures.push(error);
+  } finally {
+    window.removeEventListener("error", onError);
+    window.removeEventListener("unhandledrejection", onRejection);
+    consoleError?.mockRestore();
+    consoleError = void 0;
+  }
+  if (failures.length > 0) {
+    const captured = failures;
+    failures = [];
+    throw new AggregateError(captured, "Unexpected React/JSDOM runtime failures");
+  }
+});

package/dist/vite.d.mts

@@ -0,0 +1,22 @@
+import { UserConfig, UserConfigFnObject, UserConfigFnPromise, UserConfigFn, UserConfigExport, Plugin } from 'vite';
+
+/**
+ * 将生产 Scene 对裸模块 `phaser` 的导入重定向到 devkit facade。
+ *
+ * 只处理 `src/scenes`，因为只有 Scene 的继承入口需要增强；其余模块继续直接使用
+ * Phaser，可减少构建影响面，并避免普通模块观察到被替换的 Scene 构造器。
+ */
+declare function phaserRexUIScenePlugin(projectRoot?: string): Plugin;
+/**
+ * 生成游戏项目的 Vite 配置，并把强制 Scene 重定向放在用户插件之前。
+ * 模板只暴露此稳定入口，具体拦截逻辑保留在生成项目只读的 devkit 内。
+ * 调用签名与 Vite `defineConfig` 保持一致，支持对象、Promise 和配置函数。
+ */
+declare function defineGameViteConfig(config: UserConfig): UserConfig;
+declare function defineGameViteConfig(config: Promise<UserConfig>): Promise<UserConfig>;
+declare function defineGameViteConfig(config: UserConfigFnObject): UserConfigFnObject;
+declare function defineGameViteConfig(config: UserConfigFnPromise): UserConfigFnPromise;
+declare function defineGameViteConfig(config: UserConfigFn): UserConfigFn;
+declare function defineGameViteConfig(config: UserConfigExport): UserConfigExport;
+
+export { defineGameViteConfig, phaserRexUIScenePlugin };

package/dist/vite.d.ts

@@ -0,0 +1,22 @@
+import { UserConfig, UserConfigFnObject, UserConfigFnPromise, UserConfigFn, UserConfigExport, Plugin } from 'vite';
+
+/**
+ * 将生产 Scene 对裸模块 `phaser` 的导入重定向到 devkit facade。
+ *
+ * 只处理 `src/scenes`，因为只有 Scene 的继承入口需要增强；其余模块继续直接使用
+ * Phaser，可减少构建影响面，并避免普通模块观察到被替换的 Scene 构造器。
+ */
+declare function phaserRexUIScenePlugin(projectRoot?: string): Plugin;
+/**
+ * 生成游戏项目的 Vite 配置，并把强制 Scene 重定向放在用户插件之前。
+ * 模板只暴露此稳定入口，具体拦截逻辑保留在生成项目只读的 devkit 内。
+ * 调用签名与 Vite `defineConfig` 保持一致，支持对象、Promise 和配置函数。
+ */
+declare function defineGameViteConfig(config: UserConfig): UserConfig;
+declare function defineGameViteConfig(config: Promise<UserConfig>): Promise<UserConfig>;
+declare function defineGameViteConfig(config: UserConfigFnObject): UserConfigFnObject;
+declare function defineGameViteConfig(config: UserConfigFnPromise): UserConfigFnPromise;
+declare function defineGameViteConfig(config: UserConfigFn): UserConfigFn;
+declare function defineGameViteConfig(config: UserConfigExport): UserConfigExport;
+
+export { defineGameViteConfig, phaserRexUIScenePlugin };

package/dist/vite.js

@@ -0,0 +1,93 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/vite.ts
+var vite_exports = {};
+__export(vite_exports, {
+  defineGameViteConfig: () => defineGameViteConfig,
+  phaserRexUIScenePlugin: () => phaserRexUIScenePlugin
+});
+module.exports = __toCommonJS(vite_exports);
+var import_node_fs = require("fs");
+var import_node_module = require("module");
+var import_node_path = require("path");
+var PHASER_MODULE_ID = "phaser";
+function isPromiseLike(value) {
+  return typeof value === "object" && value !== null && "then" in value && typeof value.then === "function";
+}
+function resolvePhaserFacade(projectRoot) {
+  const requireFromProject = (0, import_node_module.createRequire)((0, import_node_path.join)(projectRoot, "package.json"));
+  const viteEntry = requireFromProject.resolve("miaoda-game-devkit/vite");
+  const facade = (0, import_node_path.join)((0, import_node_path.dirname)(viteEntry), "phaser-facade.mjs");
+  if (!(0, import_node_fs.existsSync)(facade)) {
+    throw new Error(
+      `miaoda-game-devkit \u7F3A\u5C11 Phaser facade\uFF1A${facade}`
+    );
+  }
+  return facade;
+}
+function isInsideDirectory(filePath, directory) {
+  const normalizedFile = (0, import_node_path.normalize)(filePath);
+  const normalizedDirectory = `${(0, import_node_path.normalize)(directory)}${import_node_path.sep}`;
+  return normalizedFile.startsWith(normalizedDirectory);
+}
+function phaserRexUIScenePlugin(projectRoot) {
+  let scenesRoot = projectRoot ? (0, import_node_path.resolve)(projectRoot, "src/scenes") : void 0;
+  let phaserFacade = projectRoot ? resolvePhaserFacade(projectRoot) : void 0;
+  return {
+    name: "miaoda-phaser-rexui-scene",
+    enforce: "pre",
+    configResolved(config) {
+      const resolvedProjectRoot = projectRoot ?? config.root;
+      scenesRoot ??= (0, import_node_path.resolve)(resolvedProjectRoot, "src/scenes");
+      phaserFacade ??= resolvePhaserFacade(resolvedProjectRoot);
+    },
+    /** 查询参数属于构建工具元数据，去除后才能稳定判断真实源码位置。 */
+    resolveId(source, importer) {
+      if (source !== PHASER_MODULE_ID || !importer || !scenesRoot) {
+        return null;
+      }
+      const cleanImporter = importer.split("?", 1)[0] ?? importer;
+      return isInsideDirectory(cleanImporter, scenesRoot) ? phaserFacade ?? null : null;
+    }
+  };
+}
+function withGameDefaults(config) {
+  return {
+    ...config,
+    plugins: [
+      phaserRexUIScenePlugin(),
+      ...config.plugins ?? []
+    ]
+  };
+}
+function defineGameViteConfig(config) {
+  if (typeof config === "function") {
+    return (env) => {
+      const resolved = config(env);
+      return isPromiseLike(resolved) ? resolved.then(withGameDefaults) : withGameDefaults(resolved);
+    };
+  }
+  return isPromiseLike(config) ? config.then(withGameDefaults) : withGameDefaults(config);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defineGameViteConfig,
+  phaserRexUIScenePlugin
+});

package/dist/vite.mjs

@@ -0,0 +1,67 @@
+// src/vite.ts
+import { existsSync } from "fs";
+import { createRequire } from "module";
+import { dirname, join, normalize, resolve, sep } from "path";
+var PHASER_MODULE_ID = "phaser";
+function isPromiseLike(value) {
+  return typeof value === "object" && value !== null && "then" in value && typeof value.then === "function";
+}
+function resolvePhaserFacade(projectRoot) {
+  const requireFromProject = createRequire(join(projectRoot, "package.json"));
+  const viteEntry = requireFromProject.resolve("miaoda-game-devkit/vite");
+  const facade = join(dirname(viteEntry), "phaser-facade.mjs");
+  if (!existsSync(facade)) {
+    throw new Error(
+      `miaoda-game-devkit \u7F3A\u5C11 Phaser facade\uFF1A${facade}`
+    );
+  }
+  return facade;
+}
+function isInsideDirectory(filePath, directory) {
+  const normalizedFile = normalize(filePath);
+  const normalizedDirectory = `${normalize(directory)}${sep}`;
+  return normalizedFile.startsWith(normalizedDirectory);
+}
+function phaserRexUIScenePlugin(projectRoot) {
+  let scenesRoot = projectRoot ? resolve(projectRoot, "src/scenes") : void 0;
+  let phaserFacade = projectRoot ? resolvePhaserFacade(projectRoot) : void 0;
+  return {
+    name: "miaoda-phaser-rexui-scene",
+    enforce: "pre",
+    configResolved(config) {
+      const resolvedProjectRoot = projectRoot ?? config.root;
+      scenesRoot ??= resolve(resolvedProjectRoot, "src/scenes");
+      phaserFacade ??= resolvePhaserFacade(resolvedProjectRoot);
+    },
+    /** 查询参数属于构建工具元数据，去除后才能稳定判断真实源码位置。 */
+    resolveId(source, importer) {
+      if (source !== PHASER_MODULE_ID || !importer || !scenesRoot) {
+        return null;
+      }
+      const cleanImporter = importer.split("?", 1)[0] ?? importer;
+      return isInsideDirectory(cleanImporter, scenesRoot) ? phaserFacade ?? null : null;
+    }
+  };
+}
+function withGameDefaults(config) {
+  return {
+    ...config,
+    plugins: [
+      phaserRexUIScenePlugin(),
+      ...config.plugins ?? []
+    ]
+  };
+}
+function defineGameViteConfig(config) {
+  if (typeof config === "function") {
+    return (env) => {
+      const resolved = config(env);
+      return isPromiseLike(resolved) ? resolved.then(withGameDefaults) : withGameDefaults(resolved);
+    };
+  }
+  return isPromiseLike(config) ? config.then(withGameDefaults) : withGameDefaults(config);
+}
+export {
+  defineGameViteConfig,
+  phaserRexUIScenePlugin
+};

package/dist/vitest-config.d.mts

@@ -1,5 +1,5 @@
 import { ViteUserConfig } from 'vitest/config';
-import { c as GameplayAuditOptions } from './gameplay-audit-CCJo4Qhk.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 { c as GameplayAuditOptions } from './gameplay-audit-CCJo4Qhk.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

@@ -23,7 +23,7 @@ __export(vitest_config_exports, {
   defineGameVitestConfig: () => defineGameVitestConfig
 });
 module.exports = __toCommonJS(vitest_config_exports);
-var import_node_path3 = require("path");
+var import_node_path4 = require("path");
 var import_config = require("vitest/config");
 
 // src/gameplay-audit.ts
@@ -627,7 +627,52 @@ GAMEPLAY_AUDIT: ALL CONTRACTS PASSED (${tests.filter((test) => test.metadata).le
   }
 };
 
+// src/vite.ts
+var import_node_fs2 = require("fs");
+var import_node_module = require("module");
+var import_node_path3 = require("path");
+var PHASER_MODULE_ID = "phaser";
+function resolvePhaserFacade(projectRoot) {
+  const requireFromProject = (0, import_node_module.createRequire)((0, import_node_path3.join)(projectRoot, "package.json"));
+  const viteEntry = requireFromProject.resolve("miaoda-game-devkit/vite");
+  const facade = (0, import_node_path3.join)((0, import_node_path3.dirname)(viteEntry), "phaser-facade.mjs");
+  if (!(0, import_node_fs2.existsSync)(facade)) {
+    throw new Error(
+      `miaoda-game-devkit \u7F3A\u5C11 Phaser facade\uFF1A${facade}`
+    );
+  }
+  return facade;
+}
+function isInsideDirectory(filePath, directory) {
+  const normalizedFile = (0, import_node_path3.normalize)(filePath);
+  const normalizedDirectory = `${(0, import_node_path3.normalize)(directory)}${import_node_path3.sep}`;
+  return normalizedFile.startsWith(normalizedDirectory);
+}
+function phaserRexUIScenePlugin(projectRoot) {
+  let scenesRoot = projectRoot ? (0, import_node_path3.resolve)(projectRoot, "src/scenes") : void 0;
+  let phaserFacade = projectRoot ? resolvePhaserFacade(projectRoot) : void 0;
+  return {
+    name: "miaoda-phaser-rexui-scene",
+    enforce: "pre",
+    configResolved(config) {
+      const resolvedProjectRoot = projectRoot ?? config.root;
+      scenesRoot ??= (0, import_node_path3.resolve)(resolvedProjectRoot, "src/scenes");
+      phaserFacade ??= resolvePhaserFacade(resolvedProjectRoot);
+    },
+    /** 查询参数属于构建工具元数据，去除后才能稳定判断真实源码位置。 */
+    resolveId(source, importer) {
+      if (source !== PHASER_MODULE_ID || !importer || !scenesRoot) {
+        return null;
+      }
+      const cleanImporter = importer.split("?", 1)[0] ?? importer;
+      return isInsideDirectory(cleanImporter, scenesRoot) ? phaserFacade ?? null : null;
+    }
+  };
+}
+
 // 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) {
@@ -637,10 +682,11 @@ function defineGameVitestConfig(options) {
     );
   }
   return (0, import_config.defineConfig)({
+    plugins: [phaserRexUIScenePlugin(options.projectRoot)],
     resolve: {
       alias: {
         ...options.aliases,
-        "@": (0, import_node_path3.resolve)(options.projectRoot, "src")
+        "@": (0, import_node_path4.resolve)(options.projectRoot, "src")
       }
     },
     // devkit 作为 external ESM 加载时，应用测试也必须 externalize Phaser，
@@ -658,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",