miaoda-game-devkit 0.2.9 → 0.2.10

package/dist/react/index.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/index.ts
+var react_exports = {};
+__export(react_exports, {
+  browserGameClock: () => browserGameClock,
+  useOwnedGameSession: () => useOwnedGameSession
+});
+module.exports = __toCommonJS(react_exports);
+
+// src/react/game-clock.ts
+var browserGameClock = {
+  now: () => performance.now(),
+  requestFrame: (callback) => requestAnimationFrame(callback),
+  cancelFrame: (id) => cancelAnimationFrame(id),
+  setTimeout: (callback, delayMs) => window.setTimeout(callback, delayMs),
+  clearTimeout: (id) => window.clearTimeout(id)
+};
+
+// src/react/use-owned-game-session.ts
+var import_react = require("react");
+function useOwnedGameSession(createSession) {
+  const [session] = (0, import_react.useState)(createSession);
+  const mounted = (0, import_react.useRef)(false);
+  (0, import_react.useEffect)(() => {
+    mounted.current = true;
+    return () => {
+      mounted.current = false;
+      queueMicrotask(() => {
+        if (!mounted.current) session.destroy();
+      });
+    };
+  }, [session]);
+  return session;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  browserGameClock,
+  useOwnedGameSession
+});

package/dist/react/index.mjs

@@ -0,0 +1,29 @@
+// src/react/game-clock.ts
+var browserGameClock = {
+  now: () => performance.now(),
+  requestFrame: (callback) => requestAnimationFrame(callback),
+  cancelFrame: (id) => cancelAnimationFrame(id),
+  setTimeout: (callback, delayMs) => window.setTimeout(callback, delayMs),
+  clearTimeout: (id) => window.clearTimeout(id)
+};
+
+// src/react/use-owned-game-session.ts
+import { useEffect, useRef, useState } from "react";
+function useOwnedGameSession(createSession) {
+  const [session] = useState(createSession);
+  const mounted = useRef(false);
+  useEffect(() => {
+    mounted.current = true;
+    return () => {
+      mounted.current = false;
+      queueMicrotask(() => {
+        if (!mounted.current) session.destroy();
+      });
+    };
+  }, [session]);
+  return session;
+}
+export {
+  browserGameClock,
+  useOwnedGameSession
+};

package/dist/react/testing.d.mts

@@ -0,0 +1,21 @@
+import { G as GameClock, a as GameFrameCallback } from '../game-clock-suUidZdT.mjs';
+
+/** 测试用确定性时钟；应用测试推进它，不直接伪造游戏状态。 */
+declare class ManualGameClock implements GameClock {
+    private time;
+    private nextId;
+    private readonly frames;
+    private readonly timers;
+    now(): number;
+    requestFrame(callback: GameFrameCallback): number;
+    cancelFrame(id: number): void;
+    setTimeout(callback: () => void, delayMs: number): number;
+    clearTimeout(id: number): void;
+    advanceBy(deltaMs: number): void;
+    stepFrame(deltaMs?: number): void;
+    stepFrames(count: number, deltaMs?: number): void;
+    pendingFrameCount(): number;
+    pendingTimerCount(): number;
+}
+
+export { ManualGameClock };

package/dist/react/testing.d.ts

@@ -0,0 +1,21 @@
+import { G as GameClock, a as GameFrameCallback } from '../game-clock-suUidZdT.js';
+
+/** 测试用确定性时钟；应用测试推进它，不直接伪造游戏状态。 */
+declare class ManualGameClock implements GameClock {
+    private time;
+    private nextId;
+    private readonly frames;
+    private readonly timers;
+    now(): number;
+    requestFrame(callback: GameFrameCallback): number;
+    cancelFrame(id: number): void;
+    setTimeout(callback: () => void, delayMs: number): number;
+    clearTimeout(id: number): void;
+    advanceBy(deltaMs: number): void;
+    stepFrame(deltaMs?: number): void;
+    stepFrames(count: number, deltaMs?: number): void;
+    pendingFrameCount(): number;
+    pendingTimerCount(): number;
+}
+
+export { ManualGameClock };

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
+};