@dino-dev/bridge-core-ts 0.0.4 → 0.0.5

package/dist/src/iframe-host.d.ts

@@ -0,0 +1,24 @@
+/**
+ * iframe 宿主模式：H5 被嵌在网页 iframe 里（如教研后台的实时预览）时，把父窗口当作原生容器。
+ *
+ * 触发条件：页面在 iframe 内，且 URL 带 `nl_host=iframe&nl_host_origin=<父窗口 origin>`。
+ * 父窗口 origin 由宿主显式声明：只向它发消息、只收它发来的消息，其它来源一律忽略。
+ *
+ * H5 业务代码无需改动：`bridge.whenReady()` / `bindRenderProtocol` / `bindAgentProtocol`
+ * 照常工作。原生模块在预览里不可用（`system` 除外），调用返回 `null` 并通知宿主记录。
+ *
+ * 线格式（postMessage，均带 `__nlBridge: 1`）：
+ * - H5 → 宿主：`{ kind: 'send', type, action, payload }`
+ * - H5 → 宿主：`{ kind: 'module', namespace, method }`（预览里不可用的原生调用）
+ * - 宿主 → H5：`{ kind: 'message', type, action, payload }`
+ */
+export declare const IFRAME_HOST_PARAM = "nl_host";
+export declare const IFRAME_HOST_ORIGIN_PARAM = "nl_host_origin";
+export declare const IFRAME_HOST_MARK = "__nlBridge";
+/**
+ * 满足触发条件时安装 iframe 宿主桥；已在原生容器内或条件不满足时什么都不做。
+ *
+ * @returns 是否已安装
+ */
+export declare function installIframeHostBridge(): boolean;
+//# sourceMappingURL=iframe-host.d.ts.map

package/dist/src/iframe-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iframe-host.d.ts","sourceRoot":"","sources":["../../src/iframe-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,eAAO,MAAM,iBAAiB,YAAY,CAAC;AAC3C,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AACzD,eAAO,MAAM,gBAAgB,eAAe,CAAC;AA4C7C;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAmGjD"}

package/dist/src/iframe-host.js

@@ -0,0 +1,138 @@
+/**
+ * iframe 宿主模式：H5 被嵌在网页 iframe 里（如教研后台的实时预览）时，把父窗口当作原生容器。
+ *
+ * 触发条件：页面在 iframe 内，且 URL 带 `nl_host=iframe&nl_host_origin=<父窗口 origin>`。
+ * 父窗口 origin 由宿主显式声明：只向它发消息、只收它发来的消息，其它来源一律忽略。
+ *
+ * H5 业务代码无需改动：`bridge.whenReady()` / `bindRenderProtocol` / `bindAgentProtocol`
+ * 照常工作。原生模块在预览里不可用（`system` 除外），调用返回 `null` 并通知宿主记录。
+ *
+ * 线格式（postMessage，均带 `__nlBridge: 1`）：
+ * - H5 → 宿主：`{ kind: 'send', type, action, payload }`
+ * - H5 → 宿主：`{ kind: 'module', namespace, method }`（预览里不可用的原生调用）
+ * - 宿主 → H5：`{ kind: 'message', type, action, payload }`
+ */
+export const IFRAME_HOST_PARAM = 'nl_host';
+export const IFRAME_HOST_ORIGIN_PARAM = 'nl_host_origin';
+export const IFRAME_HOST_MARK = '__nlBridge';
+const DESIGN_LONG_SIDE = 812;
+function isHostEnvelope(data) {
+    return (typeof data === 'object' &&
+        data !== null &&
+        data[IFRAME_HOST_MARK] === 1);
+}
+function resolveHostOrigin() {
+    if (!window.parent || window.parent === window || !window.location)
+        return null;
+    const params = new URLSearchParams(window.location.search);
+    if (params.get(IFRAME_HOST_PARAM) !== 'iframe')
+        return null;
+    const raw = params.get(IFRAME_HOST_ORIGIN_PARAM);
+    if (!raw)
+        return null;
+    try {
+        const origin = new URL(raw).origin;
+        return origin === 'null' ? null : origin;
+    }
+    catch {
+        return null;
+    }
+}
+function currentAdaptation() {
+    const screenWidth = window.innerWidth;
+    const screenHeight = window.innerHeight;
+    return {
+        designLongSide: DESIGN_LONG_SIDE,
+        screenWidth,
+        screenHeight,
+        scale: Math.max(screenWidth, screenHeight) / DESIGN_LONG_SIDE,
+        safeArea: { top: 0, bottom: 0, left: 0, right: 0 },
+    };
+}
+/**
+ * 满足触发条件时安装 iframe 宿主桥；已在原生容器内或条件不满足时什么都不做。
+ *
+ * @returns 是否已安装
+ */
+export function installIframeHostBridge() {
+    if (typeof window === 'undefined' || window.__FLUTTER_BRIDGE__)
+        return false;
+    const hostOrigin = resolveHostOrigin();
+    if (!hostOrigin)
+        return false;
+    const post = (kind, body) => {
+        window.parent.postMessage({ [IFRAME_HOST_MARK]: 1, kind, ...body }, hostOrigin);
+    };
+    const dispatch = (type, action, payload) => {
+        const message = {
+            type,
+            action,
+            payload,
+            timestamp: Date.now(),
+        };
+        window.dispatchEvent(new CustomEvent('flutterMessage', { detail: message }));
+    };
+    window.addEventListener('message', (event) => {
+        if (event.source !== window.parent || event.origin !== hostOrigin)
+            return;
+        const data = event.data;
+        if (!isHostEnvelope(data) || data.kind !== 'message')
+            return;
+        if (typeof data.type !== 'string' || typeof data.action !== 'string')
+            return;
+        const payload = typeof data.payload === 'object' && data.payload !== null
+            ? data.payload
+            : {};
+        dispatch(data.type, data.action, payload);
+    });
+    window.addEventListener('resize', () => {
+        dispatch('adaptation', 'changed', currentAdaptation());
+    });
+    const systemModule = {
+        isModuleAllowed: () => ({ allowed: false, namespace: '' }),
+        getAvailableModules: () => ({ modules: [] }),
+        getContainerInfo: () => ({
+            packageId: null,
+            registeredModules: [],
+            allowedModules: [],
+            adaptation: currentAdaptation(),
+            isIframeHost: true,
+        }),
+    };
+    const moduleProxy = (namespace) => new Proxy({}, {
+        // bridge.module() 用 `NativeModules[ns][method]` 做存在性判断，必须恒为真
+        has: () => true,
+        get: (_target, method) => {
+            if (typeof method !== 'string')
+                return undefined;
+            return async () => {
+                if (namespace === 'system' && method in systemModule) {
+                    return systemModule[method]();
+                }
+                post('module', { namespace, method });
+                return null;
+            };
+        },
+    });
+    window.NativeModules = new Proxy({}, {
+        has: () => true,
+        get: (_target, namespace) => typeof namespace === 'string' ? moduleProxy(namespace) : undefined,
+    });
+    window.__FLUTTER_BRIDGE__ = {
+        send: async (type, action, payload) => {
+            post('send', { type, action, payload });
+            return null;
+        },
+        onMessage: (jsonString) => {
+            try {
+                const message = JSON.parse(jsonString);
+                dispatch(message.type, message.action, message.payload);
+            }
+            catch (e) {
+                console.error('[MRP Bridge] iframe 宿主消息解析失败:', e);
+            }
+        },
+    };
+    return true;
+}
+//# sourceMappingURL=iframe-host.js.map

package/dist/src/iframe-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iframe-host.js","sourceRoot":"","sources":["../../src/iframe-host.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -9,6 +9,7 @@
  */
 export { bridge, MrpBridge } from './mrp-bridge';
 export type { BridgeMessage, MessageHandler, Unsubscribe } from './mrp-bridge';
+export { IFRAME_HOST_MARK, IFRAME_HOST_ORIGIN_PARAM, IFRAME_HOST_PARAM, } from './iframe-host';
 export { getSystemModule } from './system-module';
 export type { SystemModule, ModuleAllowedResult, AvailableModulesResult, ContainerInfoResult, ArAdaptationInfo, SafeAreaInsets, } from './system-module';
 export { ar, getArScale, getSafeArea, initArAdaptation, onArAdaptationChange, } from './adaptation';

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG/E,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EACX,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,GACd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACN,EAAE,EACF,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,oBAAoB,GACpB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGzD,cAAc,oBAAoB,CAAC;AAGnC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG1E,OAAO,EACN,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,cAAc,GACd,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACX,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,aAAa,GACb,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG/E,OAAO,EACN,gBAAgB,EAChB,wBAAwB,EACxB,iBAAiB,GACjB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EACX,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,GACd,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACN,EAAE,EACF,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,oBAAoB,GACpB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGzD,cAAc,oBAAoB,CAAC;AAGnC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAG1E,OAAO,EACN,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,cAAc,GACd,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACX,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,aAAa,GACb,MAAM,oBAAoB,CAAC"}

package/dist/src/index.js

@@ -9,6 +9,8 @@
  */
 // 核心 Bridge
 export { bridge, MrpBridge } from './mrp-bridge';
+// iframe 宿主模式（网页内嵌预览）的契约常量
+export { IFRAME_HOST_MARK, IFRAME_HOST_ORIGIN_PARAM, IFRAME_HOST_PARAM, } from './iframe-host';
 // 内置系统模块类型 + 工厂函数（容器核心契约）
 export { getSystemModule } from './system-module';
 // App/H5 统一屏幕适配

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY;AACZ,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGjD,0BAA0B;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAUlD,gBAAgB;AAChB,OAAO,EACN,EAAE,EACF,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,oBAAoB,GACpB,MAAM,cAAc,CAAC;AAGtB,yBAAyB;AACzB,cAAc,oBAAoB,CAAC;AAEnC,WAAW;AACX,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,iBAAiB;AACjB,OAAO,EACN,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,cAAc,GACd,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,YAAY;AACZ,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGjD,2BAA2B;AAC3B,OAAO,EACN,gBAAgB,EAChB,wBAAwB,EACxB,iBAAiB,GACjB,MAAM,eAAe,CAAC;AAEvB,0BAA0B;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAUlD,gBAAgB;AAChB,OAAO,EACN,EAAE,EACF,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,oBAAoB,GACpB,MAAM,cAAc,CAAC;AAGtB,yBAAyB;AACzB,cAAc,oBAAoB,CAAC;AAEnC,WAAW;AACX,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGxC,iBAAiB;AACjB,OAAO,EACN,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,cAAc,GACd,MAAM,oBAAoB,CAAC"}

package/dist/src/mock-bridge.d.ts

@@ -0,0 +1,100 @@
+/**
+ * 浏览器 Mock Bridge —— 让 H5 页面脱离 App 容器，在 Chrome 里直接开发调试。
+ *
+ * 不安装时，浏览器环境下 `whenReady()` 永不 resolve、所有原生调用静默返回 `null`，
+ * 页面会停在空状态且不报错。安装后即可拿到可控的假数据与事件。
+ *
+ * 仅供开发使用，请通过子路径引入，避免被打进生产包：
+ *
+ * @example
+ * ```ts
+ * if (import.meta.env.DEV) {
+ *   const { installMockBridge } = await import('@h5-container/bridge-core-ts/mock');
+ *   installMockBridge({
+ *     packageId: 'student_micro_pages',
+ *     allowedModules: ['user', 'audio', 'navigation'],
+ *     modules: {
+ *       user: { getProfile: { userId: '1', nickname: '测试同学' } },
+ *       audio: { play: async () => ({ ok: true }) },
+ *     },
+ *   });
+ * }
+ * ```
+ */
+import type { ArAdaptationInfo } from './system-module';
+/**
+ * 单个模块的 mock 实现。
+ *
+ * 值可以是函数（接收原始调用参数），也可以是静态数据（直接作为返回值）。
+ */
+export type MockModuleImpl = Record<string, ((...args: any[]) => unknown | Promise<unknown>) | unknown>;
+/** 一次原生调用的记录 */
+export interface MockCallRecord {
+    namespace: string;
+    method: string;
+    args: unknown[];
+    result: unknown;
+    /** 未命中 mock 定义时为 true */
+    missing: boolean;
+    timestamp: number;
+}
+export interface MockBridgeConfig {
+    /** 容器信息里的包 ID */
+    packageId?: string;
+    /**
+     * 授权模块白名单。
+     *
+     * 传入后会像真实容器一样拦截越权调用并返回 `MODULE_ACCESS_DENIED`，
+     * 可在浏览器阶段提前发现 `package.meta.json` 的 `allowedModules` 漏配。
+     * 不传则不做权限校验。
+     */
+    allowedModules?: string[];
+    /** 容器已注册模块列表，默认与 allowedModules 一致 */
+    registeredModules?: string[];
+    /** 屏幕适配信息，缺省字段按当前窗口尺寸推算 */
+    adaptation?: Partial<ArAdaptationInfo>;
+    /** 注入到 getContainerInfo().auth，供 h5_app_http 读取 */
+    auth?: Record<string, unknown>;
+    /** 追加到 getContainerInfo() 的其他字段 */
+    containerInfoExtra?: Record<string, unknown>;
+    /** 各命名空间的 mock 实现 */
+    modules?: Record<string, MockModuleImpl>;
+    /** 处理 `bridge.send()`，返回值作为调用方收到的结果 */
+    onSend?: (type: string, action: string, payload: Record<string, unknown>) => unknown;
+    /** 是否打印调用日志，默认 true */
+    log?: boolean;
+    /** 窗口尺寸变化时自动重算并广播 adaptation，默认 true */
+    followWindowResize?: boolean;
+}
+/** 安装后返回的控制句柄 */
+export interface MockBridgeHandle {
+    /** 模拟一条 Native → H5 消息 */
+    emit(type: string, action: string, payload?: Record<string, unknown>): void;
+    /** 更新屏幕适配信息并广播 `adaptation/changed` */
+    setAdaptation(patch: Partial<ArAdaptationInfo>): void;
+    /** 按时间顺序记录的原生调用 */
+    readonly calls: MockCallRecord[];
+    /** 打印所有未命中 mock 定义的调用，便于补齐 */
+    printMissing(): void;
+    /** 卸载 mock，恢复安装前的 window 状态 */
+    uninstall(): void;
+}
+declare global {
+    interface Window {
+        /** 已安装的 Mock Bridge 句柄，可在控制台直接操作 */
+        __MRP_MOCK__?: MockBridgeHandle;
+    }
+}
+/**
+ * 安装 Mock Bridge。
+ *
+ * 已经在真实容器中运行时会直接跳过，因此可以无条件调用。
+ */
+export declare function installMockBridge(config?: MockBridgeConfig): MockBridgeHandle | null;
+/**
+ * 仅在非容器环境安装 mock，在真机/App 中自动跳过。
+ *
+ * 等价于 `installMockBridge`，语义更明确，适合直接写在入口文件里。
+ */
+export declare const setupDevBridge: typeof installMockBridge;
+//# sourceMappingURL=mock-bridge.d.ts.map

package/dist/src/mock-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-bridge.d.ts","sourceRoot":"","sources":["../../src/mock-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,iBAAiB,CAAC;AAMxE;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,CAClC,MAAM,EACN,CAAC,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,OAAO,CAC1D,CAAC;AAEF,gBAAgB;AAChB,MAAM,WAAW,cAAc;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,yBAAyB;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAChC,iBAAiB;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,2BAA2B;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACvC,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,mCAAmC;IACnC,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACzC,uCAAuC;IACvC,MAAM,CAAC,EAAE,CACR,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC;IACb,uBAAuB;IACvB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,wCAAwC;IACxC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,iBAAiB;AACjB,MAAM,WAAW,gBAAgB;IAChC,0BAA0B;IAC1B,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5E,uCAAuC;IACvC,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAAC;IACtD,mBAAmB;IACnB,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,CAAC;IACjC,8BAA8B;IAC9B,YAAY,IAAI,IAAI,CAAC;IACrB,+BAA+B;IAC/B,SAAS,IAAI,IAAI,CAAC;CAClB;AAUD,OAAO,CAAC,MAAM,CAAC;IACd,UAAU,MAAM;QACf,oCAAoC;QACpC,YAAY,CAAC,EAAE,gBAAgB,CAAC;KAChC;CACD;AAuBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAChC,MAAM,GAAE,gBAAqB,GAC3B,gBAAgB,GAAG,IAAI,CAgPzB;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,0BAAoB,CAAC"}

package/dist/src/mock-bridge.js

@@ -0,0 +1,247 @@
+/**
+ * 浏览器 Mock Bridge —— 让 H5 页面脱离 App 容器，在 Chrome 里直接开发调试。
+ *
+ * 不安装时，浏览器环境下 `whenReady()` 永不 resolve、所有原生调用静默返回 `null`，
+ * 页面会停在空状态且不报错。安装后即可拿到可控的假数据与事件。
+ *
+ * 仅供开发使用，请通过子路径引入，避免被打进生产包：
+ *
+ * @example
+ * ```ts
+ * if (import.meta.env.DEV) {
+ *   const { installMockBridge } = await import('@h5-container/bridge-core-ts/mock');
+ *   installMockBridge({
+ *     packageId: 'student_micro_pages',
+ *     allowedModules: ['user', 'audio', 'navigation'],
+ *     modules: {
+ *       user: { getProfile: { userId: '1', nickname: '测试同学' } },
+ *       audio: { play: async () => ({ ok: true }) },
+ *     },
+ *   });
+ * }
+ * ```
+ */
+import { bridge } from './mrp-bridge';
+// ============================================================
+// 内部状态
+// ============================================================
+const MOCK_FLAG = '__MRP_MOCK_BRIDGE__';
+const DEFAULT_DESIGN_LONG_SIDE = 812;
+const ZERO_SAFE_AREA = { top: 0, bottom: 0, left: 0, right: 0 };
+function buildAdaptation(patch) {
+    const screenWidth = patch?.screenWidth ?? window.innerWidth;
+    const screenHeight = patch?.screenHeight ?? window.innerHeight;
+    const designLongSide = patch?.designLongSide ?? DEFAULT_DESIGN_LONG_SIDE;
+    const scale = patch?.scale ?? Math.max(screenWidth, screenHeight) / designLongSide;
+    return {
+        designLongSide,
+        screenWidth,
+        screenHeight,
+        scale,
+        safeArea: patch?.safeArea ?? ZERO_SAFE_AREA,
+    };
+}
+// ============================================================
+// 安装
+// ============================================================
+/**
+ * 安装 Mock Bridge。
+ *
+ * 已经在真实容器中运行时会直接跳过，因此可以无条件调用。
+ */
+export function installMockBridge(config = {}) {
+    const existing = window.__MRP_MOCK__;
+    if (existing) {
+        console.warn('[Mock Bridge] 已安装，忽略重复调用');
+        return existing;
+    }
+    if (window.__FLUTTER_BRIDGE__) {
+        console.info('[Mock Bridge] 检测到真实原生容器，跳过安装');
+        return null;
+    }
+    const log = config.log ?? true;
+    const calls = [];
+    let adaptation = buildAdaptation(config.adaptation);
+    const previousNativeModules = window.NativeModules;
+    const emit = (type, action, payload = {}) => {
+        const message = {
+            type,
+            action,
+            payload,
+            timestamp: Date.now(),
+        };
+        if (log) {
+            console.log(`[Mock Bridge] → H5  ${type}/${action}`, payload);
+        }
+        window.dispatchEvent(new CustomEvent('flutterMessage', { detail: message }));
+    };
+    // ---- system 模块：容器内置，始终可用 ----
+    const systemModule = {
+        isModuleAllowed: (params) => ({
+            allowed: isAllowed(params?.namespace),
+            namespace: params?.namespace,
+        }),
+        getAvailableModules: () => ({
+            modules: config.registeredModules ?? config.allowedModules ?? [],
+        }),
+        getContainerInfo: () => ({
+            packageId: config.packageId ?? 'mock_package',
+            registeredModules: config.registeredModules ?? config.allowedModules ?? [],
+            allowedModules: config.allowedModules ?? null,
+            adaptation,
+            auth: config.auth,
+            debugEnabled: true,
+            isMockBridge: true,
+            ...config.containerInfoExtra,
+        }),
+    };
+    function isAllowed(namespace) {
+        if (namespace === 'system')
+            return true;
+        if (!config.allowedModules)
+            return true;
+        return config.allowedModules.includes(namespace);
+    }
+    function resolveImpl(namespace, method) {
+        if (namespace === 'system')
+            return systemModule[method];
+        return config.modules?.[namespace]?.[method];
+    }
+    // ---- NativeModules 代理 ----
+    const moduleProxyCache = new Map();
+    function createModuleProxy(namespace) {
+        const cached = moduleProxyCache.get(namespace);
+        if (cached)
+            return cached;
+        const proxy = new Proxy({}, {
+            // module() 用 `NativeModules[ns][method]` 做存在性判断，必须恒为真
+            has: () => true,
+            get: (_target, method) => {
+                if (typeof method !== 'string')
+                    return undefined;
+                return async (...args) => {
+                    if (!isAllowed(namespace)) {
+                        console.error(`[Mock Bridge] 模块 "${namespace}" 不在 allowedModules 中，` +
+                            `调用 ${namespace}.${method} 被拒绝。` +
+                            '请检查 package.meta.json 的 allowedModules。');
+                        return {
+                            __error__: 'MODULE_ACCESS_DENIED',
+                            __message__: `Module "${namespace}" not allowed`,
+                        };
+                    }
+                    const impl = resolveImpl(namespace, method);
+                    const missing = impl === undefined;
+                    const result = missing
+                        ? null
+                        : typeof impl === 'function'
+                            ? await impl(...args)
+                            : impl;
+                    calls.push({
+                        namespace,
+                        method,
+                        args,
+                        result,
+                        missing,
+                        timestamp: Date.now(),
+                    });
+                    if (missing) {
+                        console.warn(`[Mock Bridge] 未定义 ${namespace}.${method}，返回 null。` +
+                            `可在 installMockBridge 的 modules.${namespace}.${method} 中补充。`, { args });
+                    }
+                    else if (log) {
+                        console.log(`[Mock Bridge] ${namespace}.${method}`, {
+                            args,
+                            result,
+                        });
+                    }
+                    return result;
+                };
+            },
+        });
+        moduleProxyCache.set(namespace, proxy);
+        return proxy;
+    }
+    window.NativeModules = new Proxy({}, {
+        has: () => true,
+        get: (_target, namespace) => {
+            if (typeof namespace !== 'string')
+                return undefined;
+            return createModuleProxy(namespace);
+        },
+    });
+    // ---- __FLUTTER_BRIDGE__ ----
+    window.__FLUTTER_BRIDGE__ = {
+        send: async (type, action, payload) => {
+            const result = config.onSend?.(type, action, payload) ?? null;
+            if (log) {
+                console.log(`[Mock Bridge] H5 → ${type}/${action}`, payload);
+            }
+            return result;
+        },
+        onMessage: (jsonString) => {
+            try {
+                const message = JSON.parse(jsonString);
+                emit(message.type, message.action, message.payload);
+            }
+            catch (e) {
+                console.error('[Mock Bridge] onMessage 解析失败:', e);
+            }
+        },
+    };
+    window.__FLUTTER_BRIDGE__[MOCK_FLAG] = true;
+    // ---- 窗口尺寸联动 ----
+    const handleResize = () => {
+        adaptation = buildAdaptation({
+            ...config.adaptation,
+            screenWidth: window.innerWidth,
+            screenHeight: window.innerHeight,
+            scale: undefined,
+        });
+        emit('adaptation', 'changed', adaptation);
+    };
+    const followResize = config.followWindowResize ?? true;
+    if (followResize) {
+        window.addEventListener('resize', handleResize);
+    }
+    // ---- 句柄 ----
+    const handle = {
+        emit,
+        setAdaptation(patch) {
+            adaptation = buildAdaptation({ ...adaptation, ...patch });
+            emit('adaptation', 'changed', adaptation);
+        },
+        calls,
+        printMissing() {
+            const missing = calls.filter((c) => c.missing);
+            if (missing.length === 0) {
+                console.log('[Mock Bridge] 所有原生调用都已命中 mock 定义');
+                return;
+            }
+            console.table(missing.map((c) => ({
+                调用: `${c.namespace}.${c.method}`,
+                参数: JSON.stringify(c.args),
+            })));
+        },
+        uninstall() {
+            if (followResize) {
+                window.removeEventListener('resize', handleResize);
+            }
+            delete window.__FLUTTER_BRIDGE__;
+            window.NativeModules = previousNativeModules;
+            delete window.__MRP_MOCK__;
+        },
+    };
+    window.__MRP_MOCK__ = handle;
+    // 唤醒可能已结束的就绪轮询，让 whenReady() 立即 resolve
+    bridge.refreshReady();
+    console.info(`[Mock Bridge] 已安装（packageId=${config.packageId ?? 'mock_package'}）。` +
+        '控制台可用 window.__MRP_MOCK__ 手工触发事件、查看调用记录。');
+    return handle;
+}
+/**
+ * 仅在非容器环境安装 mock，在真机/App 中自动跳过。
+ *
+ * 等价于 `installMockBridge`，语义更明确，适合直接写在入口文件里。
+ */
+export const setupDevBridge = installMockBridge;
+//# sourceMappingURL=mock-bridge.js.map

package/dist/src/mock-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-bridge.js","sourceRoot":"","sources":["../../src/mock-bridge.ts"],"names":[],"mappings":"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"}

package/dist/src/mrp-bridge.d.ts

@@ -41,6 +41,13 @@ declare global {
         NativeModules?: Record<string, Record<string, (...args: unknown[]) => Promise<unknown>>>;
     }
 }
+/** Bridge 就绪状态 */
+export type BridgeReadyState = 'pending' | 'ready' | 'unavailable';
+/** `whenReady()` 选项 */
+export interface WhenReadyOptions {
+    /** 超时毫秒数，超时后 Promise 以错误 reject；不传则沿用「永不 reject」的旧行为 */
+    timeoutMs?: number;
+}
 /**
  * Bridge SDK 主类。
  *
@@ -55,10 +62,25 @@ export declare class MrpBridge {
     private _readyPromiseResolve;
     private _readyPromise;
     private _retryCount;
+    private _readyState;
+    private _readyTimer;
     constructor();
     private _checkReady;
-    /** 等待 Bridge 就绪 */
-    whenReady(): Promise<void>;
+    /**
+     * 重新触发一次就绪检测。
+     *
+     * 供 Mock Bridge 在注入后立即生效使用；轮询已结束时也能重新唤醒。
+     */
+    refreshReady(): void;
+    /** 当前就绪状态：等待中 / 已就绪 / 判定为不在容器环境 */
+    get readyState(): BridgeReadyState;
+    /**
+     * 等待 Bridge 就绪。
+     *
+     * 默认沿用旧语义：未就绪时 Promise 一直挂起、不会 reject。
+     * 传入 `timeoutMs` 可在超时后 reject，便于页面给出明确的错误态。
+     */
+    whenReady(options?: WhenReadyOptions): Promise<void>;
     /** 是否在 Flutter WebView 容器中运行 */
     get isInContainer(): boolean;
     /**
@@ -102,7 +124,6 @@ export declare class MrpBridge {
      */
     module<T extends object = Record<string, (...args: any[]) => Promise<any>>>(namespace: string): T;
 }
-/** Bridge 单例实例 */
 export declare const bridge: MrpBridge;
 export default bridge;
 //# sourceMappingURL=mrp-bridge.d.ts.map

package/dist/src/mrp-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mrp-bridge.d.ts","sourceRoot":"","sources":["../../src/mrp-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,kBAAkB;AAClB,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,aAAa;AACb,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CACxD,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,KACtB,IAAI,CAAC;AAEV,aAAa;AACb,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC;AAMrC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,oBAAoB;QACpB,SAAS,EAAE,SAAS,CAAC;QACrB,2BAA2B;QAC3B,kBAAkB,CAAC,EAAE;YACnB,IAAI,CACF,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,OAAO,CAAC,CAAC;YACpB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;SACrC,CAAC;QACF,yBAAyB;QACzB,aAAa,CAAC,EAAE,MAAM,CACpB,MAAM,EACN,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CACzD,CAAC;KACH;CACF;AAsBD;;;;;;GAMG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,gBAAgB,CAAwB;IAChD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,gBAAgB,CAAwB;IAChD,OAAO,CAAC,oBAAoB,CAA6B;IACzD,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,WAAW,CAAK;;IA0BxB,OAAO,CAAC,WAAW;IAkBnB,mBAAmB;IACnB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1B,gCAAgC;IAChC,IAAI,aAAa,IAAI,OAAO,CAE3B;IAID;;;;;OAKG;IACH,IAAI,CAAC,CAAC,GAAG,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACpC,OAAO,CAAC,CAAC,CAAC;IASb,OAAO,CAAC,OAAO;IAaf;;;OAGG;IACH,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GACzB,WAAW;IASd;;;;OAIG;IACH,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,GACzB,WAAW;IAmBd;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CACJ,CAAC,SAAS,MAAM,GAAG,MAAM,CACvB,MAAM,EACN,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CACjC,EACD,SAAS,EAAE,MAAM,GAAG,CAAC;CA8BxB;AAMD,kBAAkB;AAClB,eAAO,MAAM,MAAM,WAAkB,CAAC;AAKtC,eAAe,MAAM,CAAC"}
+{"version":3,"file":"mrp-bridge.d.ts","sourceRoot":"","sources":["../../src/mrp-bridge.ts"],"names":[],"mappings":"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"}