miaoda-game-devkit 0.2.9 → 0.2.10

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-BwAobjIX.mjs';
 import 'phaser';
 
 interface GameVitestConfigOptions {

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-BwAobjIX.js';
 import 'phaser';
 
 interface GameVitestConfigOptions {

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,6 +627,49 @@ 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
 function defineGameVitestConfig(options) {
   const auditIssues = validateGameplayAuditOptions(options.gameplayAudit, options.projectRoot);
@@ -637,10 +680,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，

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,6 +603,49 @@ 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
 function defineGameVitestConfig(options) {
   const auditIssues = validateGameplayAuditOptions(options.gameplayAudit, options.projectRoot);
@@ -613,10 +656,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，

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "miaoda-game-devkit",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "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/",