@maoyugames/phaser-framework 1.0.0 → 1.0.2

package/dist/cli/index.js

@@ -236,7 +236,15 @@ function createPlatformConfig(platform, opts) {
       __FRAMEWORK_VERSION__: JSON.stringify(frameworkVersion)
     },
     resolve: {
-      alias: createAlias(projectRoot)
+      alias: createAlias(projectRoot),
+      // 去重 phaser:避免框架包与业务解析到不同 phaser 实例
+      dedupe: ["phaser"]
+    },
+    // dev 模式必须预打包 phaser(及框架包)为带 default 导出的 ESM,
+    // 否则 vite dev 下 `import Phaser from 'phaser'` 报
+    // "phaser does not provide an export named 'default'"(build 模式 rollup 自带 CJS 互操作,不受影响)。
+    optimizeDeps: {
+      include: ["phaser", "@maoyugames/phaser-framework"]
     },
     esbuild: {
       // 兼容低端 webview / 小游戏 JS 引擎
@@ -1043,27 +1051,25 @@ async function runDev(target) {
   const config = await loadPlatformConfig(ctx);
   const vite = await loadViteFromRoot(ctx.root);
   const cache = cacheDir2(ctx.root);
-  fse4.ensureDirSync(cache);
   const hash = randomBytes(4).toString("hex");
-  const entryFileName = `main.${platform}.${hash}.ts`;
-  const entryPath = join(cache, entryFileName);
-  const htmlName = `index.${platform}.${hash}.html`;
-  const htmlPath = join(cache, htmlName);
+  const runDir = join(cache, `dev-${platform}-${hash}`);
+  fse4.ensureDirSync(runDir);
+  const entryFileName = `main.${platform}.ts`;
+  const entryPath = join(runDir, entryFileName);
+  const htmlPath = join(runDir, "index.html");
   fse4.writeFileSync(entryPath, renderEntry({ platform, projectRoot: ctx.root }), "utf-8");
   fse4.writeFileSync(htmlPath, renderHtmlShell2(platform, config, `./${entryFileName}`), "utf-8");
   const cleanup = () => {
-    for (const f of [entryPath, htmlPath]) {
-      try {
-        fse4.removeSync(f);
-      } catch {
-      }
+    try {
+      fse4.removeSync(runDir);
+    } catch {
     }
   };
   try {
     const server = await vite.createServer({
-      // root 设为缓存目录(临时 HTML 所在),入口页直接是 /index.<p>.<hash>.html;
-      // alias/publicDir 用绝对路径不受影响
-      root: cache,
+      // root 设为本次 dev 的独立子目录(其根有 index.html),浏览器打开 / 即入口页;
+      // alias/publicDir 用绝对路径不受 root 影响
+      root: runDir,
       base: "/",
       configFile: false,
       define: {
@@ -1075,7 +1081,14 @@ async function runDev(target) {
         alias: [
           { find: /^@game$/, replacement: resolve(ctx.root, "src/game") },
           { find: /^@game\//, replacement: resolve(ctx.root, "src/game") + "/" }
-        ]
+        ],
+        // 去重 phaser,避免框架包与业务解析到不同实例
+        dedupe: ["phaser"]
+      },
+      // 必须预打包 phaser(及框架包)为带 default 导出的 ESM,
+      // 否则 dev 下 `import Phaser from 'phaser'` 报 "does not provide an export named 'default'"。
+      optimizeDeps: {
+        include: ["phaser", "@maoyugames/phaser-framework"]
       },
       publicDir: resolve(ctx.root, "src/game/public"),
       server: { open: false }
@@ -1084,7 +1097,7 @@ async function runDev(target) {
     const info = server.resolvedUrls;
     const url = info?.local?.[0] ?? "http://localhost:5173/";
     console.log(pc4.green(pc4.bold(`\u25B6 [${platform}] dev server \u5C31\u7EEA`)));
-    console.log(`  \u6253\u5F00:${pc4.cyan(url + htmlName)}`);
+    console.log(`  \u6253\u5F00:${pc4.cyan(url)}`);
     console.log(pc4.gray("  (Ctrl+C \u9000\u51FA,\u4E34\u65F6\u5165\u53E3\u4F1A\u81EA\u52A8\u6E05\u7406)"));
     const onExit = async () => {
       cleanup();

package/dist/index.d.ts

@@ -962,14 +962,16 @@ declare abstract class BaseScene extends Phaser.Scene {
     private readonly _bindings;
     /** 清理钩子是否已注册(防止同一实例重复注册) */
     private _cleanupArmed;
+    constructor(config?: string | Phaser.Types.Scenes.SettingsConfig);
     /**
-     * E4 构造时挂上场景生命周期清理钩子。
+     * Phaser 生命周期 init:此时 this.events 已就绪。在此挂场景清理钩子(E4)。
+     *
+     * Phaser 场景实例可被复用(stop → start 重启):每次重启都会再次触发 init / create。
+     * armCleanupHooks 内部用 once + 自重注册覆盖每一轮 SHUTDOWN;DESTROY(实例被移除)只需一次。
      *
-     * Phaser 场景实例可被复用(stop → start 重启):重启时不会再走 constructor,
-     * 但会再次触发 create。因此清理逻辑必须在每次 SHUTDOWN 都执行,并在执行后
-     * 重新登记(re-arm),保证下一轮生命周期同样被覆盖;DESTROY(实例被移除)只需一次。
+     * 注意:业务场景若覆写 init(data),请调用 super.init(data) 以保留自动清理(this.bind / this.scheduler)。
      */
-    constructor(config?: string | Phaser.Types.Scenes.SettingsConfig);
+    init(_data?: object): void;
     /**
      * 登记需在场景关闭时清理的订阅(E4)。
      * @param unsub App.events.on / socket.onMessage 等返回的 Unsubscribe

package/dist/index.js

@@ -2107,13 +2107,20 @@ var SceneManager = class {
       console.warn("[SceneManager] Phaser.Game \u5C1A\u672A\u5C31\u7EEA,goto \u88AB\u5FFD\u7565:", key);
       return;
     }
-    for (const scene of manager.getScenes(true)) {
+    const sceneData = asSceneData(data);
+    const all = manager.getScenes(false);
+    const vehicle = all.find((s) => s.scene.key !== key);
+    for (const scene of all) {
       const sceneKey = scene.scene.key;
-      if (sceneKey !== key) {
+      if (sceneKey !== key && scene !== vehicle) {
         manager.stop(sceneKey);
       }
     }
-    manager.start(key, asSceneData(data));
+    if (vehicle) {
+      vehicle.scene.start(key, sceneData);
+    } else {
+      manager.start(key, sceneData);
+    }
   }
   push(key, data) {
     const manager = this.game?.scene;
@@ -3056,13 +3063,6 @@ var Scheduler = class {
 
 // src/scene/BaseScene.ts
 var BaseScene = class extends Phaser4.Scene {
-  /**
-   * E4 构造时挂上场景生命周期清理钩子。
-   *
-   * Phaser 场景实例可被复用(stop → start 重启):重启时不会再走 constructor,
-   * 但会再次触发 create。因此清理逻辑必须在每次 SHUTDOWN 都执行,并在执行后
-   * 重新登记(re-arm),保证下一轮生命周期同样被覆盖;DESTROY(实例被移除)只需一次。
-   */
   constructor(config) {
     super(config);
     /* --------------------------- 自动清理 / 调度 --------------------------- */
@@ -3080,12 +3080,22 @@ var BaseScene = class extends Phaser4.Scene {
     __publicField(this, "_bindings", []);
     /** 清理钩子是否已注册(防止同一实例重复注册) */
     __publicField(this, "_cleanupArmed", false);
-    this.armCleanupHooks();
   }
   /** App 门面:业务在场景内访问网络/音频/存储等的统一入口 */
   get app() {
     return App;
   }
+  /**
+   * Phaser 生命周期 init:此时 this.events 已就绪。在此挂场景清理钩子(E4)。
+   *
+   * Phaser 场景实例可被复用(stop → start 重启):每次重启都会再次触发 init / create。
+   * armCleanupHooks 内部用 once + 自重注册覆盖每一轮 SHUTDOWN;DESTROY(实例被移除)只需一次。
+   *
+   * 注意:业务场景若覆写 init(data),请调用 super.init(data) 以保留自动清理(this.bind / this.scheduler)。
+   */
+  init(_data) {
+    this.armCleanupHooks();
+  }
   /**
    * 登记需在场景关闭时清理的订阅(E4)。
    * @param unsub App.events.on / socket.onMessage 等返回的 Unsubscribe

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maoyugames/phaser-framework",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "多平台 Phaser 游戏框架:业务/底层分离,HTTP/WebSocket/KCP,Web/TikTok/微信/Facebook/App 隔离打包",
   "type": "module",
   "license": "MIT",