miaoda-game-devkit 0.2.9 → 0.2.11

package/dist/vitest-config.mjs

@@ -1,5 +1,5 @@
 // src/vitest-config.ts
-import { resolve } from "path";
+import { resolve as resolve2 } from "path";
 import { defineConfig } from "vitest/config";
 
 // src/gameplay-audit.ts
@@ -603,7 +603,52 @@ GAMEPLAY_AUDIT: ALL CONTRACTS PASSED (${tests.filter((test) => test.metadata).le
   }
 };
 
+// src/vite.ts
+import { existsSync } from "fs";
+import { createRequire } from "module";
+import { dirname, join as join2, normalize, resolve, sep } from "path";
+var PHASER_MODULE_ID = "phaser";
+function resolvePhaserFacade(projectRoot) {
+  const requireFromProject = createRequire(join2(projectRoot, "package.json"));
+  const viteEntry = requireFromProject.resolve("miaoda-game-devkit/vite");
+  const facade = join2(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;
+    }
+  };
+}
+
 // 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) {
@@ -613,10 +658,11 @@ function defineGameVitestConfig(options) {
     );
   }
   return defineConfig({
+    plugins: [phaserRexUIScenePlugin(options.projectRoot)],
     resolve: {
       alias: {
         ...options.aliases,
-        "@": resolve(options.projectRoot, "src")
+        "@": resolve2(options.projectRoot, "src")
       }
     },
     // devkit 作为 external ESM 加载时，应用测试也必须 externalize Phaser，
@@ -634,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.9",
+  "version": "0.2.11",
   "description": "Shared lint and deterministic Phaser HEADLESS testing tools for Miaoda games",
   "license": "MIT",
   "main": "./dist/index.js",
@@ -30,7 +30,48 @@
         "default": "./dist/vitest-config.js"
       }
     },
+    "./vite": {
+      "import": {
+        "types": "./dist/vite.d.mts",
+        "default": "./dist/vite.mjs"
+      },
+      "require": {
+        "types": "./dist/vite.d.ts",
+        "default": "./dist/vite.js"
+      }
+    },
     "./vitest-setup": "./dist/lint/setup.mjs",
+    "./react": {
+      "import": {
+        "types": "./dist/react/index.d.mts",
+        "default": "./dist/react/index.mjs"
+      },
+      "require": {
+        "types": "./dist/react/index.d.ts",
+        "default": "./dist/react/index.js"
+      }
+    },
+    "./react/testing": {
+      "import": {
+        "types": "./dist/react/testing.d.mts",
+        "default": "./dist/react/testing.mjs"
+      },
+      "require": {
+        "types": "./dist/react/testing.d.ts",
+        "default": "./dist/react/testing.js"
+      }
+    },
+    "./react/vitest-config": {
+      "import": {
+        "types": "./dist/react/vitest-config.d.mts",
+        "default": "./dist/react/vitest-config.mjs"
+      },
+      "require": {
+        "types": "./dist/react/vitest-config.d.ts",
+        "default": "./dist/react/vitest-config.js"
+      }
+    },
+    "./react/vitest-setup": "./dist/react/vitest-setup.mjs",
     "./biome": "./biome-config.json",
     "./tsconfig-base": "./tsconfig-base.json"
   },
@@ -80,7 +121,36 @@
     "vitest": "^4.1.10"
   },
   "peerDependencies": {
-    "phaser": ">=4.0.0 <5"
+    "@testing-library/jest-dom": ">=6 <8",
+    "@testing-library/react": ">=16 <17",
+    "phaser": ">=4.0.0 <5",
+    "phaser4-rex-plugins": ">=4.0.0 <5",
+    "react": ">=19 <20",
+    "react-dom": ">=19 <20",
+    "vite": ">=6 <9"
+  },
+  "peerDependenciesMeta": {
+    "@testing-library/jest-dom": {
+      "optional": true
+    },
+    "@testing-library/react": {
+      "optional": true
+    },
+    "phaser": {
+      "optional": true
+    },
+    "phaser4-rex-plugins": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    },
+    "vite": {
+      "optional": true
+    }
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",