@maoyugames/phaser-framework 1.0.0

package/dist/platform/capacitor.d.ts

@@ -0,0 +1,34 @@
+import { p as PlatformName, h as IPlatformDevice, i as IPlatformLifecycle } from '../types-DtcRFbM0.js';
+import { B as BasePlatform } from '../BasePlatform-BCOkvvDW.js';
+
+/**
+ * Capacitor(原生 WebView 容器)平台适配器。
+ *
+ * - hasDOM=true(运行在原生 WebView), isMiniGame=false
+ * - net:fetch + 标准 WebSocket(继承 BasePlatform)
+ * - storage:localStorage(继承 BasePlatform;Capacitor WebView 的 localStorage 持久可靠)。
+ *            注:@capacitor/preferences 是异步 KV,与同步 IPlatformStorage 不匹配,
+ *            故不硬依赖;若业务需要更强持久化,可在 game 侧封装 Preferences 并自行迁移。
+ * - lifecycle:优先用 @capacitor/app 的 appStateChange(通过全局 Capacitor.Plugins.App 探测),
+ *              缺失则退回 DOM visibilitychange(BasePlatform 提供)。
+ * - device:vibrate 优先用 Haptics 插件(全局探测),缺失退回 navigator.vibrate;
+ *           clipboard / share 优先用对应插件,缺失退回浏览器 API。
+ * - ads / payment:Capacitor 无内置实现,保持 undefined。
+ *
+ * 如何接广告 / 内购(由具体游戏在 src/game 扩展):
+ *   1. 安装对应 Capacitor 插件,如 AdMob(@capacitor-community/admob)、
+ *      IAP(@capacitor-community/in-app-purchases / RevenueCat 等)。
+ *   2. 在 game 侧实现 IPlatformAds / IPlatformPayment 适配器(静态 import 插件),
+ *      并在自定义 startGame 流程里注入到平台实例,或扩展本类的子类覆盖 ads/payment。
+ *   3. 不要在本框架核心层硬依赖这些插件,以免污染其它平台构建。
+ */
+
+declare class CapacitorPlatform extends BasePlatform {
+    readonly platformName: PlatformName;
+    readonly isMiniGame = false;
+    readonly device: IPlatformDevice;
+    readonly lifecycle: IPlatformLifecycle;
+    init(): Promise<void>;
+}
+
+export { CapacitorPlatform };

package/dist/platform/capacitor.js

@@ -0,0 +1,145 @@
+import { BasePlatform, DomLifecycle } from '../chunk-H5CUVYCN.js';
+import { PlatformUnsupportedError } from '../chunk-II3JM4R3.js';
+import { __publicField } from '../chunk-PKBMQBKP.js';
+
+// src/platform/impl/capacitor/CapacitorPlatform.ts
+function getCapacitor() {
+  return typeof window !== "undefined" ? window.Capacitor : void 0;
+}
+function isNative() {
+  const cap = getCapacitor();
+  try {
+    return !!cap && cap.isNativePlatform();
+  } catch {
+    return false;
+  }
+}
+var CapacitorDevice = class {
+  vibrateShort() {
+    const haptics = getCapacitor()?.Plugins?.Haptics;
+    if (haptics?.impact) {
+      void haptics.impact({ style: "LIGHT" }).catch(() => {
+      });
+      return;
+    }
+    try {
+      navigator.vibrate?.(15);
+    } catch {
+    }
+  }
+  vibrateLong() {
+    const haptics = getCapacitor()?.Plugins?.Haptics;
+    if (haptics?.vibrate) {
+      void haptics.vibrate({ duration: 400 }).catch(() => {
+      });
+      return;
+    }
+    try {
+      navigator.vibrate?.(400);
+    } catch {
+    }
+  }
+  async setClipboard(text) {
+    const clip = getCapacitor()?.Plugins?.Clipboard;
+    if (clip?.write) {
+      await clip.write({ string: text });
+      return;
+    }
+    if (navigator.clipboard?.writeText) await navigator.clipboard.writeText(text);
+  }
+  async getClipboard() {
+    const clip = getCapacitor()?.Plugins?.Clipboard;
+    if (clip?.read) {
+      const res = await clip.read();
+      return res?.value ?? "";
+    }
+    if (navigator.clipboard?.readText) return navigator.clipboard.readText();
+    return "";
+  }
+  async share(payload) {
+    const share = getCapacitor()?.Plugins?.Share;
+    const url = typeof location !== "undefined" ? location.href + (payload.query ? `?${payload.query}` : "") : payload.imageUrl;
+    if (share?.share) {
+      await share.share({ title: payload.title, url });
+      return;
+    }
+    const navAny = navigator;
+    if (navAny.share) {
+      await navAny.share({ title: payload.title, url });
+      return;
+    }
+    throw new PlatformUnsupportedError("capacitor", "device.share");
+  }
+};
+var CapacitorLifecycle = class {
+  constructor(getLaunchOptions) {
+    __publicField(this, "domLifecycle");
+    __publicField(this, "getLaunch");
+    this.getLaunch = getLaunchOptions;
+    this.domLifecycle = new DomLifecycle(getLaunchOptions);
+  }
+  onShow(cb) {
+    const app = getCapacitor()?.Plugins?.App;
+    if (app?.addListener) {
+      const handle = app.addListener("appStateChange", (state) => {
+        if (state.isActive) cb(this.getLaunch());
+      });
+      return makeRemove(handle);
+    }
+    return this.domLifecycle.onShow(cb);
+  }
+  onHide(cb) {
+    const app = getCapacitor()?.Plugins?.App;
+    if (app?.addListener) {
+      const handle = app.addListener("appStateChange", (state) => {
+        if (!state.isActive) cb();
+      });
+      return makeRemove(handle);
+    }
+    return this.domLifecycle.onHide(cb);
+  }
+};
+function makeRemove(handle) {
+  let resolved;
+  let removedEarly = false;
+  if (handle instanceof Promise) {
+    void handle.then((h) => {
+      if (removedEarly) h.remove();
+      else resolved = h;
+    });
+  } else {
+    resolved = handle;
+  }
+  return () => {
+    if (resolved) resolved.remove();
+    else removedEarly = true;
+  };
+}
+var CapacitorPlatform = class extends BasePlatform {
+  constructor() {
+    super(...arguments);
+    __publicField(this, "platformName", "capacitor");
+    __publicField(this, "isMiniGame", false);
+    // device 提供;ads/payment 由具体游戏接插件后扩展,核心层保持 undefined
+    __publicField(this, "device", new CapacitorDevice());
+    __publicField(this, "lifecycle", new CapacitorLifecycle(
+      () => this.getLaunchOptions()
+    ));
+  }
+  async init() {
+    this.readDomSystemInfo();
+    this.readDomLaunchOptions();
+    const cap = getCapacitor();
+    if (cap && isNative()) {
+      try {
+        const p = cap.getPlatform();
+        if (p === "ios" || p === "android") {
+          this._system = { ...this._system, os: p };
+        }
+      } catch {
+      }
+    }
+  }
+};
+
+export { CapacitorPlatform };

package/dist/platform/facebook.d.ts

@@ -0,0 +1,33 @@
+import { p as PlatformName, m as IPlatformStorage, g as IPlatformAuth, e as IPlatformAds, k as IPlatformPayment, h as IPlatformDevice, i as IPlatformLifecycle } from '../types-DtcRFbM0.js';
+import { B as BasePlatform } from '../BasePlatform-BCOkvvDW.js';
+
+/**
+ * Facebook Instant Games 平台适配器。
+ *
+ * - hasDOM=true(Instant Games 运行在 webview), isMiniGame=true
+ * - net:fetch + 标准 WebSocket(继承 BasePlatform)
+ * - storage:FBInstant.player KV(getDataAsync/setDataAsync)是异步 KV,
+ *            而 IPlatformStorage 是同步接口 —— 采用"内存缓存 + 异步回写"策略:
+ *            init 时预拉一份到内存,getItem 读缓存,setItem 写缓存并异步 flush。
+ * - lifecycle:onShow 退回 DOM visibilitychange(FB 无 onResume,只有 onPause);onHide 用 FBInstant.onPause
+ * - auth:FBInstant.player(getID/getName/getPhoto)+ getSignedPlayerInfoAsync 作为 code
+ * - ads:getRewardedVideoAsync(loadAsync → showAsync);插屏同理
+ * - payment:FBInstant.payments
+ *
+ * init 流程:initializeAsync() → 上报加载进度 → startGameAsync() → 预拉存储。
+ */
+
+declare class FacebookPlatform extends BasePlatform {
+    readonly platformName: PlatformName;
+    readonly isMiniGame = true;
+    private readonly fbStorage;
+    readonly storage: IPlatformStorage;
+    readonly auth: IPlatformAuth;
+    readonly ads: IPlatformAds;
+    readonly payment: IPlatformPayment;
+    readonly device: IPlatformDevice;
+    readonly lifecycle: IPlatformLifecycle;
+    init(): Promise<void>;
+}
+
+export { FacebookPlatform };

package/dist/platform/facebook.js

@@ -0,0 +1,256 @@
+import { BasePlatform, DomLifecycle } from '../chunk-H5CUVYCN.js';
+import { PlatformUnsupportedError } from '../chunk-II3JM4R3.js';
+import { __publicField } from '../chunk-PKBMQBKP.js';
+
+// src/platform/impl/facebook/FacebookPlatform.ts
+function hasFB() {
+  return typeof FBInstant !== "undefined";
+}
+function requireFB(capability) {
+  if (!hasFB()) throw new PlatformUnsupportedError("facebook", capability);
+}
+var _FacebookStorage = class _FacebookStorage {
+  constructor() {
+    /** 内存缓存:key -> value(string) */
+    __publicField(this, "cache", /* @__PURE__ */ new Map());
+    /** 待回写的脏 key */
+    __publicField(this, "dirty", /* @__PURE__ */ new Set());
+    __publicField(this, "flushTimer");
+    __publicField(this, "hydrated", false);
+  }
+  /** init 阶段调用:预拉整份 KV 到内存 */
+  async hydrate() {
+    if (!hasFB()) {
+      this.hydrated = true;
+      return;
+    }
+    try {
+      const data = await FBInstant.player.getDataAsync([_FacebookStorage.RECORD_KEY]);
+      const record = data?.[_FacebookStorage.RECORD_KEY];
+      if (record && typeof record === "object") {
+        for (const [k, v] of Object.entries(record)) {
+          this.cache.set(k, String(v));
+        }
+      }
+    } catch {
+    }
+    this.hydrated = true;
+  }
+  getItem(key) {
+    const v = this.cache.get(key);
+    return v === void 0 ? null : v;
+  }
+  setItem(key, value) {
+    this.cache.set(key, value);
+    this.dirty.add(key);
+    this.scheduleFlush();
+  }
+  removeItem(key) {
+    this.cache.delete(key);
+    this.dirty.add(key);
+    this.scheduleFlush();
+  }
+  clear() {
+    for (const k of this.cache.keys()) this.dirty.add(k);
+    this.cache.clear();
+    this.scheduleFlush();
+  }
+  /** 去抖:合并短时间内的多次写,统一异步回写 FB KV */
+  scheduleFlush() {
+    if (!hasFB()) return;
+    if (this.flushTimer) clearTimeout(this.flushTimer);
+    this.flushTimer = setTimeout(() => void this.flush(), 300);
+  }
+  async flush() {
+    if (!hasFB() || this.dirty.size === 0) return;
+    this.dirty.clear();
+    const record = {};
+    for (const [k, v] of this.cache.entries()) record[k] = v;
+    try {
+      await FBInstant.player.setDataAsync({ [_FacebookStorage.RECORD_KEY]: record });
+      await FBInstant.player.flushDataAsync?.();
+    } catch {
+    }
+  }
+};
+/** 存入 FB KV 时的统一外层 key(单条 record 装整个字典,减少 KV 配额占用) */
+__publicField(_FacebookStorage, "RECORD_KEY", "__fw_kv__");
+var FacebookStorage = _FacebookStorage;
+var FacebookAuth = class {
+  async login() {
+    requireFB("auth.login");
+    const info = await FBInstant.player.getSignedPlayerInfoAsync();
+    return {
+      code: info.getSignature(),
+      openId: info.getPlayerID(),
+      raw: info
+    };
+  }
+  async getProfile() {
+    requireFB("auth.getProfile");
+    const name = FBInstant.player.getName();
+    const photo = FBInstant.player.getPhoto();
+    if (!name && !photo) return null;
+    return { nickname: name ?? "", avatarUrl: photo ?? "" };
+  }
+};
+var FacebookAds = class {
+  constructor() {
+    __publicField(this, "rewarded");
+    __publicField(this, "interstitial");
+  }
+  async preloadRewarded(adUnitId) {
+    requireFB("ads.preloadRewarded");
+    if (!adUnitId)
+      throw new PlatformUnsupportedError("facebook", "ads.preloadRewarded(\u7F3A\u5C11 placementId)");
+    this.rewarded = await FBInstant.getRewardedVideoAsync(adUnitId);
+    await this.rewarded.loadAsync();
+  }
+  async showRewarded(adUnitId) {
+    requireFB("ads.showRewarded");
+    try {
+      if (!this.rewarded || adUnitId && this.rewarded.getPlacementID() !== adUnitId) {
+        if (!adUnitId)
+          throw new PlatformUnsupportedError("facebook", "ads.showRewarded(\u7F3A\u5C11 placementId)");
+        this.rewarded = await FBInstant.getRewardedVideoAsync(adUnitId);
+        await this.rewarded.loadAsync();
+      }
+      await this.rewarded.showAsync();
+      this.rewarded = void 0;
+      return "completed";
+    } catch {
+      this.rewarded = void 0;
+      return "failed";
+    }
+  }
+  async showInterstitial(adUnitId) {
+    requireFB("ads.showInterstitial");
+    try {
+      if (!this.interstitial || adUnitId && this.interstitial.getPlacementID() !== adUnitId) {
+        if (!adUnitId)
+          throw new PlatformUnsupportedError(
+            "facebook",
+            "ads.showInterstitial(\u7F3A\u5C11 placementId)"
+          );
+        this.interstitial = await FBInstant.getInterstitialAdAsync(adUnitId);
+        await this.interstitial.loadAsync();
+      }
+      await this.interstitial.showAsync();
+      this.interstitial = void 0;
+      return "closed";
+    } catch {
+      this.interstitial = void 0;
+      return "failed";
+    }
+  }
+};
+var FacebookPayment = class {
+  async purchase(productId, extra) {
+    requireFB("payment.purchase");
+    const developerPayload = extra && typeof extra.developerPayload === "string" ? extra.developerPayload : void 0;
+    const p = await FBInstant.payments.purchaseAsync({ productID: productId, developerPayload });
+    return {
+      productId: p.productID,
+      transactionId: p.paymentID ?? p.purchaseToken,
+      receipt: p.signedRequest,
+      raw: p
+    };
+  }
+  async restore() {
+    requireFB("payment.restore");
+    const list = await FBInstant.payments.getPurchasesAsync();
+    return (list ?? []).map((p) => ({
+      productId: p.productID,
+      transactionId: p.paymentID ?? p.purchaseToken,
+      receipt: p.signedRequest,
+      raw: p
+    }));
+  }
+};
+var FacebookDevice = class {
+  vibrateShort() {
+    try {
+      navigator.vibrate?.(15);
+    } catch {
+    }
+  }
+  vibrateLong() {
+    try {
+      navigator.vibrate?.(400);
+    } catch {
+    }
+  }
+  async setClipboard(text) {
+    if (navigator.clipboard?.writeText) await navigator.clipboard.writeText(text);
+  }
+  async getClipboard() {
+    if (navigator.clipboard?.readText) return navigator.clipboard.readText();
+    return "";
+  }
+  async share(payload) {
+    requireFB("device.share");
+    await FBInstant.shareAsync({
+      intent: "SHARE",
+      image: payload.imageUrl,
+      text: payload.title,
+      data: payload.query ? { query: payload.query } : void 0
+    });
+  }
+};
+var FacebookLifecycle = class {
+  constructor(getLaunchOptions) {
+    __publicField(this, "domLifecycle");
+    this.domLifecycle = new DomLifecycle(getLaunchOptions);
+  }
+  onShow(cb) {
+    return this.domLifecycle.onShow(cb);
+  }
+  onHide(cb) {
+    if (hasFB()) {
+      FBInstant.onPause(() => cb());
+      return this.domLifecycle.onHide(cb);
+    }
+    return this.domLifecycle.onHide(cb);
+  }
+};
+var FacebookPlatform = class extends BasePlatform {
+  constructor() {
+    super(...arguments);
+    __publicField(this, "platformName", "facebook");
+    __publicField(this, "isMiniGame", true);
+    __publicField(this, "fbStorage", new FacebookStorage());
+    __publicField(this, "storage", this.fbStorage);
+    __publicField(this, "auth", new FacebookAuth());
+    __publicField(this, "ads", new FacebookAds());
+    __publicField(this, "payment", new FacebookPayment());
+    __publicField(this, "device", new FacebookDevice());
+    __publicField(this, "lifecycle", new FacebookLifecycle(
+      () => this.getLaunchOptions()
+    ));
+  }
+  async init() {
+    this.readDomSystemInfo();
+    this.readDomLaunchOptions();
+    if (hasFB()) {
+      await FBInstant.initializeAsync();
+      FBInstant.setLoadingProgress(100);
+      await FBInstant.startGameAsync();
+      try {
+        this._system = { ...this._system, language: FBInstant.getLocale() };
+      } catch {
+      }
+      try {
+        const entry = FBInstant.getEntryPointData();
+        if (entry && typeof entry === "object") {
+          const query = { ...this._launchOptions.query };
+          for (const [k, v] of Object.entries(entry)) query[k] = String(v);
+          this._launchOptions = { ...this._launchOptions, query, raw: entry };
+        }
+      } catch {
+      }
+      await this.fbStorage.hydrate();
+    }
+  }
+};
+
+export { FacebookPlatform };

package/dist/platform/tiktok.d.ts

@@ -0,0 +1,30 @@
+import { p as PlatformName, g as IPlatformAuth, e as IPlatformAds, k as IPlatformPayment, h as IPlatformDevice, f as IPlatformAnalytics, i as IPlatformLifecycle } from '../types-DtcRFbM0.js';
+import { B as BasePlatform } from '../BasePlatform-BCOkvvDW.js';
+
+/**
+ * TikTok Mini Games(Minis)平台适配器。
+ *
+ * - hasDOM=true(HTML 运行时,真 webview), isMiniGame=true
+ * - net:fetch + 标准 WebSocket(webview 支持,继承 BasePlatform)
+ * - storage:localStorage(继承 BasePlatform)
+ * - lifecycle:优先用 TTMinis.game.onShow/onHide,缺失时退回 DOM visibilitychange
+ * - device:vibrate / clipboard / share 必须走 TTMinis 桥接(TikTok 禁用对应 Web API)
+ * - auth / ads / payment / analytics:全部走 TTMinis.game
+ *
+ * 所有 TTMinis 调用前判断 `typeof TTMinis !== 'undefined'`,缺失则抛 PlatformUnsupportedError
+ * 或优雅降级。SDK 由构建侧通过 <script src=".../minis.js"> 注入。
+ */
+
+declare class TikTokPlatform extends BasePlatform {
+    readonly platformName: PlatformName;
+    readonly isMiniGame = true;
+    readonly auth: IPlatformAuth;
+    readonly ads: IPlatformAds;
+    readonly payment: IPlatformPayment;
+    readonly device: IPlatformDevice;
+    readonly analytics: IPlatformAnalytics;
+    readonly lifecycle: IPlatformLifecycle;
+    init(): Promise<void>;
+}
+
+export { TikTokPlatform };

package/dist/platform/tiktok.js

@@ -0,0 +1,170 @@
+import { BasePlatform } from '../chunk-H5CUVYCN.js';
+import { PlatformUnsupportedError } from '../chunk-II3JM4R3.js';
+import { __publicField } from '../chunk-PKBMQBKP.js';
+
+// src/platform/impl/tiktok/TikTokPlatform.ts
+function hasTT() {
+  return typeof TTMinis !== "undefined" && !!TTMinis.game;
+}
+function requireTT(capability) {
+  if (!hasTT()) throw new PlatformUnsupportedError("tiktok", capability);
+}
+var TikTokAuth = class {
+  async login() {
+    requireTT("auth.login");
+    const res = await TTMinis.game.login();
+    return { code: res.code, openId: res.openId, raw: res };
+  }
+  async getProfile() {
+    requireTT("auth.getProfile");
+    const info = await TTMinis.game.getUserInfo();
+    if (!info) return null;
+    return { nickname: info.nickName ?? "", avatarUrl: info.avatarUrl ?? "" };
+  }
+};
+var TikTokAds = class {
+  async preloadRewarded(adUnitId) {
+    requireTT("ads.preloadRewarded");
+    await TTMinis.game.preloadRewardedVideo(adUnitId ? { adUnitId } : void 0);
+  }
+  async showRewarded(adUnitId) {
+    requireTT("ads.showRewarded");
+    try {
+      const res = await TTMinis.game.showRewardedVideo(adUnitId ? { adUnitId } : void 0);
+      return res?.isEnded ? "completed" : "skipped";
+    } catch {
+      return "failed";
+    }
+  }
+  async showInterstitial(adUnitId) {
+    requireTT("ads.showInterstitial");
+    try {
+      await TTMinis.game.showInterstitialAd(adUnitId ? { adUnitId } : void 0);
+      return "closed";
+    } catch {
+      return "failed";
+    }
+  }
+};
+var TikTokPayment = class {
+  async purchase(productId, extra) {
+    requireTT("payment.purchase");
+    const res = await TTMinis.game.requestPayment({ productId, ...extra ?? {} });
+    return {
+      productId: res.productId ?? productId,
+      transactionId: res.transactionId ?? "",
+      receipt: res.receipt ?? "",
+      raw: res
+    };
+  }
+  async restore() {
+    requireTT("payment.restore");
+    const fn = TTMinis.game.getUnfinishedPurchases;
+    if (!fn) return [];
+    const list = await fn.call(TTMinis.game) ?? [];
+    return list.map((res) => ({
+      productId: res.productId,
+      transactionId: res.transactionId ?? "",
+      receipt: res.receipt ?? "",
+      raw: res
+    }));
+  }
+};
+var TikTokDevice = class {
+  vibrateShort() {
+    if (!hasTT()) return;
+    TTMinis.game.vibrateShort();
+  }
+  vibrateLong() {
+    if (!hasTT()) return;
+    TTMinis.game.vibrateLong();
+  }
+  async setClipboard(text) {
+    requireTT("device.setClipboard");
+    await TTMinis.game.setClipboardData({ data: text });
+  }
+  async getClipboard() {
+    requireTT("device.getClipboard");
+    const res = await TTMinis.game.getClipboardData();
+    return res?.data ?? "";
+  }
+  async share(payload) {
+    requireTT("device.share");
+    await TTMinis.game.shareAppMessage({
+      title: payload.title,
+      imageUrl: payload.imageUrl,
+      query: payload.query
+    });
+  }
+};
+var TikTokAnalytics = class {
+  reportEvent(name, params) {
+    if (!hasTT()) return;
+    TTMinis.game.reportEvent(name, params);
+  }
+};
+var TikTokLifecycle = class {
+  onShow(cb) {
+    if (!hasTT()) return () => {
+    };
+    const handler = (res) => {
+      cb({ scene: res?.scene, query: res?.query ?? {}, raw: res });
+    };
+    TTMinis.game.onShow(handler);
+    return () => TTMinis.game.offShow?.(handler);
+  }
+  onHide(cb) {
+    if (!hasTT()) return () => {
+    };
+    const handler = () => cb();
+    TTMinis.game.onHide(handler);
+    return () => TTMinis.game.offHide?.(handler);
+  }
+};
+var TikTokPlatform = class extends BasePlatform {
+  constructor() {
+    super(...arguments);
+    __publicField(this, "platformName", "tiktok");
+    __publicField(this, "isMiniGame", true);
+    __publicField(this, "auth", new TikTokAuth());
+    __publicField(this, "ads", new TikTokAds());
+    __publicField(this, "payment", new TikTokPayment());
+    __publicField(this, "device", new TikTokDevice());
+    __publicField(this, "analytics", new TikTokAnalytics());
+    // 用 TTMinis 桥接的生命周期,缺失时由其内部退回 noop;DOM 退路在 init 中按需补
+    __publicField(this, "lifecycle", new TikTokLifecycle());
+  }
+  async init() {
+    this.readDomSystemInfo();
+    this.readDomLaunchOptions();
+    if (hasTT()) {
+      const sysFn = TTMinis.game.getSystemInfoSync;
+      if (sysFn) {
+        const sys = sysFn.call(TTMinis.game);
+        this._system = {
+          screenWidth: sys.screenWidth ?? this._system.screenWidth,
+          screenHeight: sys.screenHeight ?? this._system.screenHeight,
+          pixelRatio: sys.pixelRatio ?? this._system.pixelRatio,
+          os: sys.platform ?? this._system.os,
+          language: sys.language ?? this._system.language,
+          hostVersion: sys.version ?? this._system.hostVersion
+        };
+        if (sys.safeArea) {
+          this._safeArea = {
+            top: sys.safeArea.top,
+            bottom: sys.safeArea.bottom,
+            left: sys.safeArea.left,
+            right: sys.safeArea.right
+          };
+        }
+      }
+      const launchFn = TTMinis.game.getLaunchOptionsSync;
+      if (launchFn) {
+        const lo = launchFn.call(TTMinis.game);
+        this._launchOptions = { scene: lo.scene, query: lo.query ?? {}, raw: lo };
+      }
+    }
+  }
+};
+
+export { TikTokPlatform };

package/dist/platform/web.d.ts

@@ -0,0 +1,22 @@
+import { p as PlatformName, h as IPlatformDevice } from '../types-DtcRFbM0.js';
+import { B as BasePlatform } from '../BasePlatform-BCOkvvDW.js';
+
+/**
+ * Web(普通浏览器 / H5)平台适配器。
+ *
+ * - hasDOM=true, isMiniGame=false
+ * - net:fetch + 标准 WebSocket(继承 BasePlatform)
+ * - storage:localStorage(继承 BasePlatform)
+ * - lifecycle:document.visibilitychange(继承 BasePlatform)
+ * - device:navigator.vibrate / navigator.clipboard / Web Share API
+ * - 无 auth / ads / payment(浏览器无统一登录/广告/内购体系,保持 undefined)
+ */
+
+declare class WebPlatform extends BasePlatform {
+    readonly platformName: PlatformName;
+    readonly isMiniGame = false;
+    readonly device: IPlatformDevice;
+    init(): Promise<void>;
+}
+
+export { WebPlatform };