@maoyugames/phaser-framework 1.0.3 → 1.0.5

package/dist/cli/index.js

@@ -1218,7 +1218,13 @@ async function runVerify(target, opts = {}) {
   const { server, port } = await serveDist(distDir);
   const url = `http://127.0.0.1:${port}/`;
   console.log(pc6.cyan(pc6.bold(`\u25B6 [verify] \u65E0\u5934\u6D4F\u89C8\u5668\u6253\u5F00 ${platform} \u4EA7\u7269`)));
-  const launchArgs = ["--no-sandbox", "--disable-webgl", "--disable-webgl2"];
+  const launchArgs = [
+    "--no-sandbox",
+    "--use-gl=angle",
+    "--use-angle=swiftshader",
+    "--enable-unsafe-swiftshader",
+    "--ignore-gpu-blocklist"
+  ];
   let browser;
   try {
     browser = await pw.chromium.launch({ channel: "chrome", headless: true, args: launchArgs });
@@ -1235,7 +1241,11 @@ async function runVerify(target, opts = {}) {
   const errors = [];
   let rendered = false;
   let distinctColors = 0;
+  let canvasInView = false;
   let canvasInfo = null;
+  const outDir = join(ctx.root, ".pf-verify");
+  mkdirSync(outDir, { recursive: true });
+  const shot = join(outDir, `${platform}.png`);
   try {
     const page = await browser.newPage({ viewport });
     page.on("pageerror", (e) => errors.push("PAGEERROR: " + e.message));
@@ -1245,41 +1255,47 @@ async function runVerify(target, opts = {}) {
     await page.goto(url, { waitUntil: "load", timeout: 3e4 });
     for (let i = 0; i < 20; i++) {
       await page.waitForTimeout(1e3);
-      const stat = await page.evaluate(() => {
+      const buf = await page.screenshot({ type: "png" }).catch(() => null);
+      if (buf) writeFileSync(shot, buf);
+      if (buf) {
+        const dataUrl = "data:image/png;base64," + buf.toString("base64");
+        distinctColors = await page.evaluate(async (u) => {
+          const img = new Image();
+          img.src = u;
+          await img.decode();
+          const cv = document.createElement("canvas");
+          cv.width = img.width;
+          cv.height = img.height;
+          const cx = cv.getContext("2d");
+          if (!cx) return 0;
+          cx.drawImage(img, 0, 0);
+          const data = cx.getImageData(0, 0, cv.width, cv.height).data;
+          const colors = /* @__PURE__ */ new Set();
+          const total = cv.width * cv.height;
+          const step = Math.max(1, Math.floor(total / 5e3));
+          for (let k = 0; k < total && colors.size < 40; k += step) {
+            const o = k * 4;
+            colors.add(`${data[o]},${data[o + 1]},${data[o + 2]}`);
+          }
+          return colors.size;
+        }, dataUrl).catch(() => 0);
+      }
+      const vis = await page.evaluate(() => {
         const c = document.querySelector("canvas");
-        if (!c) return { ok: false, distinct: 0, w: 0, h: 0 };
-        const cx = c.getContext("2d");
-        if (!cx) return { ok: false, distinct: 0, w: c.width, h: c.height };
-        const w = c.width;
-        const h = c.height;
-        const data = cx.getImageData(0, 0, w, h).data;
-        const colors = /* @__PURE__ */ new Set();
-        const total = w * h;
-        const step = Math.max(1, Math.floor(total / 3e3));
-        for (let k = 0; k < total && colors.size < 40; k += step) {
-          const o = k * 4;
-          colors.add(`${data[o]},${data[o + 1]},${data[o + 2]}`);
-        }
-        return { ok: true, distinct: colors.size, w, h };
-      }).catch(() => ({ ok: false, distinct: 0, w: 0, h: 0 }));
-      canvasInfo = stat.w ? { w: stat.w, h: stat.h } : canvasInfo;
-      distinctColors = stat.distinct;
-      if (stat.ok && stat.distinct > 3) {
+        if (!c) return { has: false, inView: false, w: 0, h: 0 };
+        const r = c.getBoundingClientRect();
+        const st = getComputedStyle(c);
+        const inView = r.bottom > 0 && r.right > 0 && r.top < innerHeight && r.left < innerWidth && r.width > 1 && r.height > 1 && st.display !== "none" && st.visibility !== "hidden" && Number(st.opacity) > 0;
+        return { has: true, inView, w: Math.round(r.width), h: Math.round(r.height) };
+      }).catch(() => ({ has: false, inView: false, w: 0, h: 0 }));
+      canvasInfo = vis.has ? { w: vis.w, h: vis.h } : canvasInfo;
+      canvasInView = vis.inView;
+      if (distinctColors > 3 && canvasInView) {
         rendered = true;
         break;
       }
     }
-    const durl = await page.evaluate(() => {
-      const c = document.querySelector("canvas");
-      return c ? c.toDataURL("image/png") : "";
-    }).catch(() => "");
-    if (durl) {
-      const outDir = join(ctx.root, ".pf-verify");
-      mkdirSync(outDir, { recursive: true });
-      const shot = join(outDir, `${platform}.png`);
-      writeFileSync(shot, Buffer.from(durl.split(",")[1], "base64"));
-      console.log(pc6.gray(`  \u622A\u56FE:${shot}`));
-    }
+    console.log(pc6.gray(`  \u622A\u56FE(\u5C4F\u5E55\u5B9E\u62CD):${shot}`));
   } catch (e) {
     errors.push("VERIFY: " + e.message);
   } finally {
@@ -1289,7 +1305,9 @@ async function runVerify(target, opts = {}) {
   const ok = errors.length === 0 && rendered;
   console.log("");
   console.log(pc6.bold("\u25B6 [verify] \u7ED3\u679C"));
-  console.log(`  canvas:${canvasInfo ? `${canvasInfo.w}\xD7${canvasInfo.h}` : "\u65E0"};\u753B\u9762\u989C\u8272\u6570:${distinctColors}(>3 \u89C6\u4E3A\u5DF2\u6E32\u67D3)`);
+  console.log(
+    `  canvas:${canvasInfo ? `${canvasInfo.w}\xD7${canvasInfo.h}` : "\u65E0"};\u5728\u89C6\u53E3\u5185:${canvasInView ? "\u662F" : "\u5426"};\u5C4F\u5E55\u989C\u8272\u6570:${distinctColors}(>3 \u89C6\u4E3A\u5DF2\u6E32\u67D3)`
+  );
   if (errors.length) {
     console.log(pc6.red(`  \u63A7\u5236\u53F0/\u9875\u9762\u9519\u8BEF(${errors.length}):`));
     errors.slice(0, 12).forEach((e) => console.log(pc6.red("    " + e)));
@@ -1298,10 +1316,11 @@ async function runVerify(target, opts = {}) {
   }
   if (ok) {
     console.log(pc6.green(pc6.bold(`
-\u2713 [verify] ${platform} \u5B9E\u8DD1\u901A\u8FC7(\u6E32\u67D3\u6B63\u5E38\u3001\u65E0\u8FD0\u884C\u671F\u9519\u8BEF)`)));
+\u2713 [verify] ${platform} \u5B9E\u8DD1\u901A\u8FC7(\u5C4F\u5E55\u6E32\u67D3\u6B63\u5E38\u3001\u65E0\u8FD0\u884C\u671F\u9519\u8BEF)`)));
   } else {
+    const reason = errors.length ? "\u5B58\u5728\u8FD0\u884C\u671F\u9519\u8BEF" : !canvasInView ? "canvas \u4E0D\u5728\u89C6\u53E3\u5185(\u88AB\u5E03\u5C40\u63A8\u51FA\u5C4F\u5E55/\u9690\u85CF \u2192 \u7528\u6237\u770B\u5230\u9ED1\u5C4F)" : "\u5C4F\u5E55\u753B\u9762\u672A\u6E32\u67D3\u51FA\u5185\u5BB9(\u7591\u4F3C\u5D29\u6E83/\u9ED1\u5C4F)";
     console.log(pc6.red(pc6.bold(`
-\u2717 [verify] ${platform} \u672A\u901A\u8FC7:${!rendered ? "\u753B\u9762\u672A\u6E32\u67D3\u51FA\u5185\u5BB9(\u7591\u4F3C\u5D29\u6E83/\u9ED1\u5C4F)" : "\u5B58\u5728\u8FD0\u884C\u671F\u9519\u8BEF"}`)));
+\u2717 [verify] ${platform} \u672A\u901A\u8FC7:${reason}`)));
   }
   return ok;
 }

package/dist/index.d.ts

@@ -620,7 +620,7 @@ declare abstract class BasePanel extends Phaser.GameObjects.Container {
         color?: number;
         alpha?: number;
         closeOnClick?: boolean;
-    }): Phaser.GameObjects.Graphics;
+    }): Phaser.GameObjects.Image;
     /**
      * 把一个子对象放到设计稿正中(以设计稿坐标系)。
      * 仅设置坐标,不负责 add(由调用方决定何时 add 进容器)。
@@ -1057,6 +1057,13 @@ interface ButtonConfig extends ButtonStyle {
 declare class Button extends Phaser.GameObjects.Container {
     private readonly bg;
     private readonly label;
+    /**
+     * 透明输入命中层(Image,使用默认 frame 命中区)。
+     * 不直接在容器上 setInteractive(自定义 Rectangle) 的原因:真机/高分屏 Phaser FIT
+     * 非整数缩放时,容器自定义矩形命中区会随离中心距离产生偏移,小按钮点不准;
+     * Image 的 frame 命中区不受此影响。故输入统一走这一层。
+     */
+    private readonly hit;
     private readonly style;
     private readonly onClick?;
     /** 是否禁用 */
@@ -1071,7 +1078,58 @@ declare class Button extends Phaser.GameObjects.Container {
     get disabled(): boolean;
     /** 绘制圆角背景(以中心为原点) */
     private drawBackground;
-    /** 绑定指针交互:悬停/按下/抬起,实现按下态与点击触发 */
+    /** 绑定指针交互:悬停/按下/抬起,实现按下态与点击触发(事件挂在命中层 hit 上) */
+    private bindEvents;
+}
+
+/**
+ * 圆形图标按钮 IconButton(基于 Phaser.GameObjects.Container)。
+ *
+ * 与 Button 的区别:Button 是「圆角矩形 + 文字」,IconButton 是「圆底 + 图标纹理」,
+ * 适合返回/设置/帮助等小图标按钮。
+ *
+ * 输入用透明 Image 命中层(默认 frame 命中区)+ down/up 触发——在真机/高分屏
+ * (Phaser FIT 非整数缩放)下命中可靠,规避「容器自定义 Rectangle 命中区小按钮点不准」的坑。
+ *
+ * 用法:
+ *   new IconButton(this, { x, y, size: 88, texture: 'icon_home', onClick: () => goMain() });
+ */
+
+interface IconButtonConfig {
+    x?: number;
+    y?: number;
+    /** 直径(圆底与命中区尺寸),默认 88 */
+    size?: number;
+    /** 图标纹理 key */
+    texture: string;
+    /** 图标帧(图集时用,可选) */
+    frame?: string | number;
+    /** 图标相对 size 的比例,默认 0.56 */
+    iconScale?: number;
+    /** 圆底颜色;传 null 不绘制底,默认深灰 0x232c44 */
+    bgColor?: number | null;
+    /** 圆底不透明度,默认 1 */
+    bgAlpha?: number;
+    /** 水平翻转图标(如用「下一关」箭头翻成「上一关」) */
+    flipX?: boolean;
+    /** 图标着色 */
+    iconTint?: number;
+    /** 点击回调(按下并在按钮内抬起才触发) */
+    onClick?: () => void;
+}
+declare class IconButton extends Phaser.GameObjects.Container {
+    private readonly icon;
+    /** 透明命中层(frame 命中区,真机/高分屏可靠) */
+    private readonly hit;
+    private readonly onClick?;
+    private _disabled;
+    private pressed;
+    constructor(scene: Phaser.Scene, config: IconButtonConfig);
+    /** 更新图标纹理 */
+    setIcon(texture: string, frame?: string | number): this;
+    /** 设置禁用态 */
+    setDisabled(disabled: boolean): this;
+    get disabled(): boolean;
     private bindEvents;
 }
 
@@ -1777,4 +1835,4 @@ interface PlatformConfig {
     capacitor?: CapacitorPlatformConfig;
 }
 
-export { AdResult, type AdsConfig, App, type AppConfig, BaseModule, BasePanel, BaseScene, Button, type ButtonConfig, type ButtonStyle, type CapacitorPlatformConfig, ConfigTable, ConfigTableManager, ErrorCode, type FacebookPlatformConfig, FrameworkError, Handler, HttpClient, type HttpClientConfig, HttpError, type HttpInterceptors, HttpRequestOptions, I18n, type I18nOptions, type IAccountService, type IAdsManager, type IAnalyticsManager, type IApp, type IAssetLoader, type IAudioManager, type IConfigService, type IEventBus, type IHttpClient, type IKcpTransport, type ILogger, type INetManager, type IPanelManager, type IPaymentManager, IPlatform, IPlatformLifecycle, type ISceneManager, type ISocketClient, type IStorageManager, JsonCodec, KcpClient, type KcpClientConfig, type KcpTransportFactory, type LayerName, Layers, LogLevel, LoginResult, MessageChannel, type MessageChannelOptions, type MessageCodec, type MessageEnvelope, MessageError, ModuleRegistry, NetManager, type NetManagerOptions, type NetProtocol, ObjectPool, type Orientation, type PanelCtor, PanelManager, type PlatformConfig, PlatformContext, PurchaseResult, SafeArea, SaveManager, type SaveSlot, type SaveSlotOptions, type ScheduleHandle, Scheduler, type SocketClientConfig, type SocketState, type StartGameOptions, type Store, type TikTokPlatformConfig, TypedEventBus, Unsubscribe, type WeChatPlatformConfig, type WebPlatformConfig, WebSocketClient, createStore, createTypedEventBus, isFrameworkError, normalizeLocale, startGame };
+export { AdResult, type AdsConfig, App, type AppConfig, BaseModule, BasePanel, BaseScene, Button, type ButtonConfig, type ButtonStyle, type CapacitorPlatformConfig, ConfigTable, ConfigTableManager, ErrorCode, type FacebookPlatformConfig, FrameworkError, Handler, HttpClient, type HttpClientConfig, HttpError, type HttpInterceptors, HttpRequestOptions, I18n, type I18nOptions, type IAccountService, type IAdsManager, type IAnalyticsManager, type IApp, type IAssetLoader, type IAudioManager, type IConfigService, type IEventBus, type IHttpClient, type IKcpTransport, type ILogger, type INetManager, type IPanelManager, type IPaymentManager, IPlatform, IPlatformLifecycle, type ISceneManager, type ISocketClient, type IStorageManager, IconButton, type IconButtonConfig, JsonCodec, KcpClient, type KcpClientConfig, type KcpTransportFactory, type LayerName, Layers, LogLevel, LoginResult, MessageChannel, type MessageChannelOptions, type MessageCodec, type MessageEnvelope, MessageError, ModuleRegistry, NetManager, type NetManagerOptions, type NetProtocol, ObjectPool, type Orientation, type PanelCtor, PanelManager, type PlatformConfig, PlatformContext, PurchaseResult, SafeArea, SaveManager, type SaveSlot, type SaveSlotOptions, type ScheduleHandle, Scheduler, type SocketClientConfig, type SocketState, type StartGameOptions, type Store, type TikTokPlatformConfig, TypedEventBus, Unsubscribe, type WeChatPlatformConfig, type WebPlatformConfig, WebSocketClient, createStore, createTypedEventBus, isFrameworkError, normalizeLocale, startGame };

package/dist/index.js

@@ -1,7 +1,7 @@
 import { PlatformUnsupportedError } from './chunk-II3JM4R3.js';
 export { PlatformUnsupportedError } from './chunk-II3JM4R3.js';
 import { __publicField } from './chunk-PKBMQBKP.js';
-import Phaser4 from 'phaser';
+import Phaser2 from 'phaser';
 
 // src/App.ts
 var parts = null;
@@ -2598,7 +2598,7 @@ var ModuleRegistry = class {
     return this.modules.size;
   }
 };
-var BasePanel = class extends Phaser4.GameObjects.Container {
+var BasePanel = class extends Phaser2.GameObjects.Container {
   constructor(scene) {
     super(scene, 0, 0);
     /** 打开本面板时所属的 key(由 PanelManager 在创建后注入,用于自我关闭) */
@@ -2683,12 +2683,11 @@ var BasePanel = class extends Phaser4.GameObjects.Container {
     const h = this.designHeight;
     const color = opts?.color ?? 0;
     const alpha = opts?.alpha ?? 0.6;
-    const dim = this.scene.make.graphics({}, false);
-    dim.fillStyle(color, alpha);
-    dim.fillRect(0, 0, w, h);
+    const dim = this.scene.make.image({ x: w / 2, y: h / 2, key: "__WHITE" }, false);
+    dim.setDisplaySize(w, h).setTint(color).setAlpha(alpha);
     if (opts?.closeOnClick) {
-      dim.setInteractive(new Phaser4.Geom.Rectangle(0, 0, w, h), Phaser4.Geom.Rectangle.Contains);
-      dim.on(Phaser4.Input.Events.POINTER_UP, () => this.close());
+      dim.setInteractive();
+      dim.on(Phaser2.Input.Events.POINTER_UP, () => this.close());
     }
     this.addAt(dim, 0);
     return dim;
@@ -2947,24 +2946,33 @@ async function startGame(opts) {
 }
 function createPhaserGameInstance(config, scenes) {
   const gameConfig = {
-    type: Phaser4.AUTO,
+    type: Phaser2.AUTO,
+    // 关键:把 canvas 挂进各平台外壳的 #game-root(外壳已为它写好布局/居中 CSS)。
+    // 不设 parent 时 Phaser 把 canvas 追加到 document.body —— 而外壳里 #game-root 占满
+    // 100% 高度,canvas 作为其后的块级兄弟会被挤到视口外,再被 body 的 overflow:hidden
+    // 裁掉 → 屏幕全黑(但 canvas 后备缓冲其实已渲染,故 toDataURL/getImageData 读不出问题)。
+    // wechat 无 DOM(weapp-adapter),'game-root' 不存在时 Phaser 自动回退,安全。
+    parent: "game-root",
     // 透明背景占位;业务场景自行绘制背景
     backgroundColor: "#1f2937",
     scale: {
       // FIT:按设计分辨率等比缩放铺满容器(保持比例,留黑边);CENTER_BOTH:居中
-      mode: Phaser4.Scale.FIT,
-      autoCenter: Phaser4.Scale.CENTER_BOTH,
+      mode: Phaser2.Scale.FIT,
+      autoCenter: Phaser2.Scale.CENTER_BOTH,
       width: config.designWidth,
+      // autoRound:把缩放后画布尺寸取整,避免非整数缩放(如真机 1.866x)产生亚像素偏移,
+      // 渲染更清晰、指针命中更准(配合 UI 组件用 frame 命中区,彻底解决高分屏小按钮点不准)。
+      autoRound: true,
       height: config.designHeight
     },
     scene: scenes
     // 微信等无 DOM 平台由 weapp-adapter 提供 canvas;有 DOM 平台 Phaser 自动建 canvas
   };
-  return new Phaser4.Game(gameConfig);
+  return new Phaser2.Game(gameConfig);
 }
 function waitForGameReady(game) {
   return new Promise((resolve) => {
-    game.events.once(Phaser4.Core.Events.READY, () => resolve());
+    game.events.once(Phaser2.Core.Events.READY, () => resolve());
   });
 }
 
@@ -3070,7 +3078,7 @@ var Scheduler = class {
 };
 
 // src/scene/BaseScene.ts
-var BaseScene = class extends Phaser4.Scene {
+var BaseScene = class extends Phaser2.Scene {
   constructor(config) {
     super(config);
     /* --------------------------- 自动清理 / 调度 --------------------------- */
@@ -3120,10 +3128,10 @@ var BaseScene = class extends Phaser4.Scene {
     this._cleanupArmed = true;
     const onShutdown = () => {
       this.runCleanup();
-      this.events.once(Phaser4.Scenes.Events.SHUTDOWN, onShutdown);
+      this.events.once(Phaser2.Scenes.Events.SHUTDOWN, onShutdown);
     };
-    this.events.once(Phaser4.Scenes.Events.SHUTDOWN, onShutdown);
-    this.events.once(Phaser4.Scenes.Events.DESTROY, () => this.runCleanup());
+    this.events.once(Phaser2.Scenes.Events.SHUTDOWN, onShutdown);
+    this.events.once(Phaser2.Scenes.Events.DESTROY, () => this.runCleanup());
   }
   /** 执行全部清理:解绑所有 bind 的订阅 + 清空场景调度器,并重置登记表 */
   runCleanup() {
@@ -3207,11 +3215,18 @@ var DEFAULTS = {
   fontSize: 32,
   fontFamily: "sans-serif"
 };
-var Button = class extends Phaser4.GameObjects.Container {
+var Button = class extends Phaser2.GameObjects.Container {
   constructor(scene, config) {
     super(scene, config.x ?? 0, config.y ?? 0);
     __publicField(this, "bg");
     __publicField(this, "label");
+    /**
+     * 透明输入命中层(Image,使用默认 frame 命中区)。
+     * 不直接在容器上 setInteractive(自定义 Rectangle) 的原因:真机/高分屏 Phaser FIT
+     * 非整数缩放时,容器自定义矩形命中区会随离中心距离产生偏移,小按钮点不准;
+     * Image 的 frame 命中区不受此影响。故输入统一走这一层。
+     */
+    __publicField(this, "hit");
     __publicField(this, "style");
     __publicField(this, "onClick");
     /** 是否禁用 */
@@ -3248,15 +3263,10 @@ var Button = class extends Phaser4.GameObjects.Container {
     this.label.setOrigin(0.5, 0.5);
     this.add(this.label);
     this.setSize(this.style.width, this.style.height);
-    this.setInteractive(
-      new Phaser4.Geom.Rectangle(
-        -this.style.width / 2,
-        -this.style.height / 2,
-        this.style.width,
-        this.style.height
-      ),
-      Phaser4.Geom.Rectangle.Contains
-    );
+    this.hit = scene.make.image({ x: 0, y: 0, key: "__WHITE" }, false);
+    this.hit.setDisplaySize(this.style.width, this.style.height).setAlpha(1e-3);
+    this.hit.setInteractive({ useHandCursor: true });
+    this.add(this.hit);
     this.bindEvents();
     scene.add.existing(this);
   }
@@ -3270,12 +3280,12 @@ var Button = class extends Phaser4.GameObjects.Container {
     this._disabled = disabled;
     this.setAlpha(disabled ? 0.5 : 1);
     if (disabled) {
-      this.disableInteractive();
+      this.hit.disableInteractive();
       this.pressed = false;
       this.drawBackground(this.style.backgroundColor);
       this.setScale(1);
     } else {
-      this.setInteractive();
+      this.hit.setInteractive({ useHandCursor: true });
     }
     return this;
   }
@@ -3289,25 +3299,25 @@ var Button = class extends Phaser4.GameObjects.Container {
     this.bg.fillStyle(color, 1);
     this.bg.fillRoundedRect(-width / 2, -height / 2, width, height, radius);
   }
-  /** 绑定指针交互:悬停/按下/抬起,实现按下态与点击触发 */
+  /** 绑定指针交互:悬停/按下/抬起,实现按下态与点击触发(事件挂在命中层 hit 上) */
   bindEvents() {
-    this.on(Phaser4.Input.Events.POINTER_OVER, () => {
+    this.hit.on(Phaser2.Input.Events.POINTER_OVER, () => {
       if (this._disabled) return;
       this.drawBackground(this.style.backgroundColorActive);
     });
-    this.on(Phaser4.Input.Events.POINTER_OUT, () => {
+    this.hit.on(Phaser2.Input.Events.POINTER_OUT, () => {
       if (this._disabled) return;
       this.pressed = false;
       this.drawBackground(this.style.backgroundColor);
       this.setScale(1);
     });
-    this.on(Phaser4.Input.Events.POINTER_DOWN, () => {
+    this.hit.on(Phaser2.Input.Events.POINTER_DOWN, () => {
       if (this._disabled) return;
       this.pressed = true;
       this.drawBackground(this.style.backgroundColorActive);
       this.setScale(0.96);
     });
-    this.on(Phaser4.Input.Events.POINTER_UP, () => {
+    this.hit.on(Phaser2.Input.Events.POINTER_UP, () => {
       if (this._disabled) return;
       this.setScale(1);
       this.drawBackground(this.style.backgroundColor);
@@ -3318,6 +3328,81 @@ var Button = class extends Phaser4.GameObjects.Container {
     });
   }
 };
+var DEFAULT_SIZE = 88;
+var DEFAULT_BG = 2305092;
+var IconButton = class extends Phaser2.GameObjects.Container {
+  constructor(scene, config) {
+    super(scene, config.x ?? 0, config.y ?? 0);
+    __publicField(this, "icon");
+    /** 透明命中层(frame 命中区,真机/高分屏可靠) */
+    __publicField(this, "hit");
+    __publicField(this, "onClick");
+    __publicField(this, "_disabled", false);
+    __publicField(this, "pressed", false);
+    const size = config.size ?? DEFAULT_SIZE;
+    this.onClick = config.onClick;
+    if (config.bgColor !== null) {
+      const bg = scene.make.graphics({}, false);
+      bg.fillStyle(config.bgColor ?? DEFAULT_BG, config.bgAlpha ?? 1);
+      bg.fillCircle(0, 0, size / 2);
+      this.add(bg);
+    }
+    this.icon = scene.make.image({ x: 0, y: 0, key: config.texture, frame: config.frame }, false);
+    const target = size * (config.iconScale ?? 0.56);
+    this.icon.setScale(target / Math.max(this.icon.width, this.icon.height || 1));
+    if (config.flipX) this.icon.setFlipX(true);
+    if (config.iconTint !== void 0) this.icon.setTint(config.iconTint);
+    this.add(this.icon);
+    this.hit = scene.make.image({ x: 0, y: 0, key: "__WHITE" }, false);
+    this.hit.setDisplaySize(size, size).setAlpha(1e-3);
+    this.hit.setInteractive({ useHandCursor: true });
+    this.add(this.hit);
+    this.setSize(size, size);
+    this.bindEvents();
+    scene.add.existing(this);
+  }
+  /** 更新图标纹理 */
+  setIcon(texture, frame) {
+    this.icon.setTexture(texture, frame);
+    return this;
+  }
+  /** 设置禁用态 */
+  setDisabled(disabled) {
+    this._disabled = disabled;
+    this.setAlpha(disabled ? 0.5 : 1);
+    if (disabled) {
+      this.hit.disableInteractive();
+      this.pressed = false;
+      this.setScale(1);
+    } else {
+      this.hit.setInteractive({ useHandCursor: true });
+    }
+    return this;
+  }
+  get disabled() {
+    return this._disabled;
+  }
+  bindEvents() {
+    this.hit.on(Phaser2.Input.Events.POINTER_DOWN, () => {
+      if (this._disabled) return;
+      this.pressed = true;
+      this.setScale(0.92);
+    });
+    this.hit.on(Phaser2.Input.Events.POINTER_OUT, () => {
+      if (this._disabled) return;
+      this.pressed = false;
+      this.setScale(1);
+    });
+    this.hit.on(Phaser2.Input.Events.POINTER_UP, () => {
+      if (this._disabled) return;
+      this.setScale(1);
+      if (this.pressed) {
+        this.pressed = false;
+        this.onClick?.();
+      }
+    });
+  }
+};
 
 // src/store/Store.ts
 function deepClone2(value) {
@@ -3806,4 +3891,4 @@ var MessageChannel = class {
   }
 };
 
-export { App, BaseModule, BasePanel, BaseScene, Button, ConfigTable, ConfigTableManager, ErrorCode, FrameworkError, HttpClient, HttpError, I18n, JsonCodec, KcpClient, Layers, LogLevel, MessageChannel, MessageError, ModuleRegistry, NetManager, ObjectPool, PanelManager, PlatformContext, SaveManager, Scheduler, TypedEventBus, WebSocketClient, createStore, createTypedEventBus, err, isFrameworkError, normalizeLocale, ok, startGame };
+export { App, BaseModule, BasePanel, BaseScene, Button, ConfigTable, ConfigTableManager, ErrorCode, FrameworkError, HttpClient, HttpError, I18n, IconButton, JsonCodec, KcpClient, Layers, LogLevel, MessageChannel, MessageError, ModuleRegistry, NetManager, ObjectPool, PanelManager, PlatformContext, SaveManager, Scheduler, TypedEventBus, WebSocketClient, createStore, createTypedEventBus, err, isFrameworkError, normalizeLocale, ok, startGame };

package/package.json

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