@dino-dev/bridge-core-ts 0.0.1

package/README.md

@@ -0,0 +1,145 @@
+# Bridge Core TS
+
+H5 端与 Flutter 容器通信的核心 TypeScript SDK（零框架依赖）。
+适用于 React / Vue / Svelte / Vanilla JS 等任何前端框架。
+
+## 文件说明
+
+| 文件 | 用途 |
+|------|------|
+| `src/mrp-bridge.ts` | 核心 Bridge SDK（消息通信 + 模块代理） |
+| `src/system-module.ts` | 内置系统模块类型定义 + `getSystemModule()` 工厂 |
+| `src/index.ts` | 包入口，统一 re-export 所有 API |
+| `generated/*_module.ts` | 各模块的 TypeScript 类型定义（由 build_runner 自动生成，纯类型） |
+| `generated/index.ts` | 自动生成的模块类型 re-export + 工厂函数 |
+
+> **设计原则**：消费者只需从 `@h5-container/bridge-core-ts` 导入，无需感知 `generated/` 目录。
+
+## 安装
+
+通过 pnpm workspace 依赖引用：
+
+```json
+{
+  "dependencies": {
+    "@h5-container/bridge-core-ts": "workspace:*"
+  }
+}
+```
+
+## 基础用法
+
+```ts
+import { bridge, getAudio } from '@h5-container/bridge-core-ts';
+
+// 发送消息到 Flutter（type 为自由字符串）
+bridge.send('interaction', 'onFindTarget', { target: 'ladybug', position: { x: 100, y: 200 } });
+
+// 调用原生模块（通过工厂函数，无需手动指定 namespace）
+const audio = getAudio();
+await audio.play({ soundId: 'success', volume: 0.8 });
+
+// 监听 Flutter 发来的消息
+const unsubscribe = bridge.on('ai', 'highlight', (msg) => {
+  console.log('AI 指令:', msg.payload);
+});
+// 不再需要时取消监听
+unsubscribe();
+```
+
+## 在 React 中使用
+
+SDK 本身不依赖 React，搭配 `useMemo` / `useEffect` 即可：
+
+```tsx
+import { useMemo, useEffect, useCallback, useState } from 'react';
+import { bridge, getAudio, getDevice } from '@h5-container/bridge-core-ts';
+
+function FindBugGame({ bugs }) {
+  const audio = useMemo(() => getAudio(), []);
+  const device = useMemo(() => getDevice(), []);
+
+  // 监听 AI 指令（useEffect 自动清理）
+  const [aiState, setAiState] = useState('idle');
+  useEffect(() => {
+    return bridge.on('ai', null, (msg) => {
+      const s = (msg.payload as Record<string, unknown>)?.aiState as string;
+      if (s) setAiState(s);
+    });
+  }, []);
+
+  const handleClick = async (bugId: string) => {
+    bridge.send('interaction', 'onFindTarget', { target: bugId });
+    await audio.play({ soundId: 'success', volume: 0.8 });
+    await device.vibrate({ duration: 50 });
+  };
+
+  return <div>{/* ... */}</div>;
+}
+```
+
+## 在 Vue 中使用
+
+```ts
+import { bridge, getAudio } from '@h5-container/bridge-core-ts';
+
+const audio = getAudio();
+
+// 在 setup / onMounted 中使用
+onMounted(() => {
+  const unsubscribe = bridge.on('ai', 'highlight', (msg) => {
+    console.log('AI 指令:', msg.payload);
+  });
+  onUnmounted(() => unsubscribe());
+});
+
+async function playSound() {
+  await audio.play({ soundId: 'success', volume: 0.8 });
+}
+```
+
+## 原生模块调用
+
+Flutter 宿主通过 `registerModule()` 注册的模块，前端通过工厂函数获取类型安全的代理：
+
+```ts
+import { getAudio, getDevice, getUser } from '@h5-container/bridge-core-ts';
+
+const audio = getAudio();
+await audio.play({ soundId: 'success', volume: 0.8 });
+
+const device = getDevice();
+const info = await device.getDeviceInfo();
+
+// 仅导入类型
+import type { Audio, Device } from '@h5-container/bridge-core-ts';
+```
+
+## 内置系统模块
+
+容器自动注册的系统模块不受白名单限制，通过 `getSystemModule()` 访问：
+
+```ts
+import { getSystemModule } from '@h5-container/bridge-core-ts';
+
+const system = getSystemModule();
+const { allowed } = await system.isModuleAllowed({ namespace: 'audio' });
+const { modules } = await system.getAvailableModules();
+const info = await system.getContainerInfo();
+```
+
+## 协议规范
+
+所有消息遵循统一格式（`type` 为自由字符串，由业务层约定）：
+
+```json
+{
+  "type": "<自定义类别>",
+  "action": "onFindTarget",
+  "payload": { "target": "ladybug" },
+  "messageId": "optional-uuid",
+  "timestamp": 1708588800000
+}
+```
+
+> SDK 不硬编码任何消息类别。`type` 和 `action` 完全由业务定义，SDK 只负责序列化传输。

package/dist/generated/ai_tutor.d.ts

@@ -0,0 +1,63 @@
+/** AI Tutor 交互网关（宿主侧 AI 能力） */
+export interface AiTutor {
+    /** 将用户在绘本中的交互事件发送给 AI Tutor */
+    sendInteraction(args: {
+        /** 动作名称 */
+        action: string;
+        /** 事件负载 */
+        payload?: Record<string, unknown> | null;
+    }): Promise<{
+        /** 是否成功 */
+        success: boolean;
+    }>;
+    /** 发送文本消息给 AI Tutor */
+    sendTextMessage(args: {
+        /** 文本内容 */
+        text: string;
+    }): Promise<{
+        /** 是否成功 */
+        success: boolean;
+    }>;
+    /** 将当前截图发送给 AI Tutor（多模态视觉输入） */
+    sendScreenshot(args: {
+        /** Base64 编码的图片数据 */
+        imageBase64: string;
+    }): Promise<{
+        /** 是否成功 */
+        success: boolean;
+    }>;
+    /** 通知 AI Tutor 当前绘本场景已切换 */
+    notifySceneChanged(args: {
+        /** 当前页码 */
+        pageIndex: number;
+        /** 场景标识符 */
+        sceneId?: string | null;
+        /** 场景标题 */
+        title?: string | null;
+        /** 附加元数据 */
+        metadata?: Record<string, unknown> | null;
+    }): Promise<{
+        /** 是否成功 */
+        success: boolean;
+    }>;
+    /** 请求开启/关闭学生麦克风进行语音输入 */
+    setMicEnabled(args: {
+        /** 是否开启麦克风 */
+        enabled: boolean;
+    }): Promise<{
+        /** 是否成功 */
+        success: boolean;
+        /** 当前麦克风状态 */
+        enabled: boolean;
+    }>;
+    /** 获取 AI Tutor 当前状态 */
+    getState(): Promise<{
+        /** 状态标识（idle / thinking / speaking / waitingForResponse / error） */
+        state: string;
+        /** 麦克风是否开启 */
+        micEnabled: boolean;
+        /** 当前场景上下文（可能为 null） */
+        currentScene: Record<string, unknown> | null;
+    }>;
+}
+//# sourceMappingURL=ai_tutor.d.ts.map

package/dist/generated/ai_tutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai_tutor.d.ts","sourceRoot":"","sources":["../../generated/ai_tutor.ts"],"names":[],"mappings":"AAKA,+BAA+B;AAC/B,MAAM,WAAW,OAAO;IACtB,+BAA+B;IAC/B,eAAe,CAAC,IAAI,EAAE;QACpB,WAAW;QACX,MAAM,EAAE,MAAM,CAAC;QACf,WAAW;QACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;KAC1C,GAAG,OAAO,CAAC;QACV,WAAW;QACX,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC,CAAC;IAEH,uBAAuB;IACvB,eAAe,CAAC,IAAI,EAAE;QACpB,WAAW;QACX,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC;QACV,WAAW;QACX,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC,CAAC;IAEH,iCAAiC;IACjC,cAAc,CAAC,IAAI,EAAE;QACnB,qBAAqB;QACrB,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC;QACV,WAAW;QACX,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC,CAAC;IAEH,4BAA4B;IAC5B,kBAAkB,CAAC,IAAI,EAAE;QACvB,WAAW;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY;QACZ,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,WAAW;QACX,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,YAAY;QACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;KAC3C,GAAG,OAAO,CAAC;QACV,WAAW;QACX,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC,CAAC;IAEH,yBAAyB;IACzB,aAAa,CAAC,IAAI,EAAE;QAClB,cAAc;QACd,OAAO,EAAE,OAAO,CAAC;KAClB,GAAG,OAAO,CAAC;QACV,WAAW;QACX,OAAO,EAAE,OAAO,CAAC;QACjB,cAAc;QACd,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC,CAAC;IAEH,uBAAuB;IACvB,QAAQ,IAAI,OAAO,CAAC;QAClB,oEAAoE;QACpE,KAAK,EAAE,MAAM,CAAC;QACd,cAAc;QACd,UAAU,EAAE,OAAO,CAAC;QACpB,wBAAwB;QACxB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;KAC9C,CAAC,CAAC;CACJ"}

package/dist/generated/ai_tutor.js

@@ -0,0 +1,6 @@
+// ============================================================
+// 此文件由 h5_app_container_generator 自动生成，请勿手动修改。
+// 运行 `dart run build_runner build` 重新生成。
+// ============================================================
+export {};
+//# sourceMappingURL=ai_tutor.js.map

package/dist/generated/ai_tutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai_tutor.js","sourceRoot":"","sources":["../../generated/ai_tutor.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+CAA+C;AAC/C,yCAAyC;AACzC,+DAA+D"}

package/dist/generated/audio.d.ts

@@ -0,0 +1,29 @@
+/** 原生音频播放控制 */
+export interface Audio {
+    /** 播放音效 */
+    play(args: {
+        /** 音效 ID */
+        soundId: string;
+        /** 音量 0.0~1.0 */
+        volume?: number;
+    }): Promise<{
+        /** 是否正在播放 */
+        playing: boolean;
+        /** 音效 ID */
+        soundId: string;
+    }>;
+    /** 停止当前播放 */
+    stop(): Promise<{
+        /** 是否成功 */
+        success: boolean;
+    }>;
+    /** 预加载音效到内存 */
+    preload(args: {
+        /** 音效 ID 列表 */
+        soundIds: string[];
+    }): Promise<{
+        /** 成功预加载的资源数量 */
+        preloaded: number;
+    }>;
+}
+//# sourceMappingURL=audio.d.ts.map

package/dist/generated/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../generated/audio.ts"],"names":[],"mappings":"AAKA,eAAe;AACf,MAAM,WAAW,KAAK;IACpB,WAAW;IACX,IAAI,CAAC,IAAI,EAAE;QACT,YAAY;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,iBAAiB;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC;QACV,aAAa;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY;QACZ,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IAEH,aAAa;IACb,IAAI,IAAI,OAAO,CAAC;QACd,WAAW;QACX,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC,CAAC;IAEH,eAAe;IACf,OAAO,CAAC,IAAI,EAAE;QACZ,eAAe;QACf,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,GAAG,OAAO,CAAC;QACV,iBAAiB;QACjB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;CACJ"}

package/dist/generated/audio.js

@@ -0,0 +1,6 @@
+// ============================================================
+// 此文件由 h5_app_container_generator 自动生成，请勿手动修改。
+// 运行 `dart run build_runner build` 重新生成。
+// ============================================================
+export {};
+//# sourceMappingURL=audio.js.map

package/dist/generated/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.js","sourceRoot":"","sources":["../../generated/audio.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+CAA+C;AAC/C,yCAAyC;AACzC,+DAA+D"}

package/dist/generated/device.d.ts

@@ -0,0 +1,23 @@
+/** 设备能力调用 */
+export interface Device {
+    /** 触发设备震动 */
+    vibrate(args: {
+        /** 震动时长（毫秒） */
+        duration?: number;
+    }): Promise<{
+        /** 是否成功 */
+        success: boolean;
+    }>;
+    /** 获取设备信息 */
+    getDeviceInfo(): Promise<{
+        /** 平台标识（ios / android） */
+        platform: string;
+        /** 系统版本号 */
+        version: string;
+        /** 屏幕宽度（逻辑像素） */
+        screenWidth: number;
+        /** 屏幕高度（逻辑像素） */
+        screenHeight: number;
+    }>;
+}
+//# sourceMappingURL=device.d.ts.map

package/dist/generated/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../generated/device.ts"],"names":[],"mappings":"AAKA,aAAa;AACb,MAAM,WAAW,MAAM;IACrB,aAAa;IACb,OAAO,CAAC,IAAI,EAAE;QACZ,eAAe;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC;QACV,WAAW;QACX,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC,CAAC;IAEH,aAAa;IACb,aAAa,IAAI,OAAO,CAAC;QACvB,0BAA0B;QAC1B,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,iBAAiB;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,iBAAiB;QACjB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ"}

package/dist/generated/device.js

@@ -0,0 +1,6 @@
+// ============================================================
+// 此文件由 h5_app_container_generator 自动生成，请勿手动修改。
+// 运行 `dart run build_runner build` 重新生成。
+// ============================================================
+export {};
+//# sourceMappingURL=device.js.map

package/dist/generated/device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.js","sourceRoot":"","sources":["../../generated/device.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+CAA+C;AAC/C,yCAAyC;AACzC,+DAA+D"}

package/dist/generated/index.d.ts

@@ -0,0 +1,17 @@
+import type { AiTutor } from './ai_tutor';
+import type { Audio } from './audio';
+import type { Device } from './device';
+import type { User } from './user';
+export type { AiTutor } from './ai_tutor';
+export type { Audio } from './audio';
+export type { Device } from './device';
+export type { User } from './user';
+/** 获取 ai_tutor 的类型安全代理 */
+export declare function getAiTutor(): AiTutor;
+/** 获取 audio 的类型安全代理 */
+export declare function getAudio(): Audio;
+/** 获取 device 的类型安全代理 */
+export declare function getDevice(): Device;
+/** 获取 user 的类型安全代理 */
+export declare function getUser(): User;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../generated/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,YAAY,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,YAAY,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAMnC,0BAA0B;AAC1B,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAED,uBAAuB;AACvB,wBAAgB,QAAQ,IAAI,KAAK,CAEhC;AAED,wBAAwB;AACxB,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,sBAAsB;AACtB,wBAAgB,OAAO,IAAI,IAAI,CAE9B"}

package/dist/generated/index.js

@@ -0,0 +1,25 @@
+// ============================================================
+// 此文件由 h5_app_container_generator 自动生成，请勿手动修改。
+// 运行 `dart run build_runner build` 重新生成。
+// ============================================================
+import { bridge } from '../src/mrp-bridge';
+// ============================================================
+// 工厂函数（适用于任何上下文）
+// ============================================================
+/** 获取 ai_tutor 的类型安全代理 */
+export function getAiTutor() {
+    return bridge.module('ai_tutor');
+}
+/** 获取 audio 的类型安全代理 */
+export function getAudio() {
+    return bridge.module('audio');
+}
+/** 获取 device 的类型安全代理 */
+export function getDevice() {
+    return bridge.module('device');
+}
+/** 获取 user 的类型安全代理 */
+export function getUser() {
+    return bridge.module('user');
+}
+//# sourceMappingURL=index.js.map

package/dist/generated/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../generated/index.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+CAA+C;AAC/C,yCAAyC;AACzC,+DAA+D;AAE/D,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAW3C,+DAA+D;AAC/D,iBAAiB;AACjB,+DAA+D;AAE/D,0BAA0B;AAC1B,MAAM,UAAU,UAAU;IACxB,OAAO,MAAM,CAAC,MAAM,CAAU,UAAU,CAAC,CAAC;AAC5C,CAAC;AAED,uBAAuB;AACvB,MAAM,UAAU,QAAQ;IACtB,OAAO,MAAM,CAAC,MAAM,CAAQ,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,wBAAwB;AACxB,MAAM,UAAU,SAAS;IACvB,OAAO,MAAM,CAAC,MAAM,CAAS,QAAQ,CAAC,CAAC;AACzC,CAAC;AAED,sBAAsB;AACtB,MAAM,UAAU,OAAO;IACrB,OAAO,MAAM,CAAC,MAAM,CAAO,MAAM,CAAC,CAAC;AACrC,CAAC"}

package/dist/generated/user.d.ts

@@ -0,0 +1,25 @@
+/** 用户信息与进度管理 */
+export interface User {
+    /** 获取当前学生信息 */
+    getProfile(): Promise<{
+        /** 学生姓名 */
+        name: string;
+        /** 当前等级 */
+        level: number;
+        /** 头像 URL */
+        avatar: string;
+        /** 年龄 */
+        age: number;
+    }>;
+    /** 保存学习进度 */
+    saveProgress(args: {
+        /** 当前页码 */
+        pageIndex: number;
+        /** 得分 */
+        score: number;
+    }): Promise<{
+        /** 是否成功 */
+        success: boolean;
+    }>;
+}
+//# sourceMappingURL=user.d.ts.map

package/dist/generated/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../generated/user.ts"],"names":[],"mappings":"AAKA,gBAAgB;AAChB,MAAM,WAAW,IAAI;IACnB,eAAe;IACf,UAAU,IAAI,OAAO,CAAC;QACpB,WAAW;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW;QACX,KAAK,EAAE,MAAM,CAAC;QACd,aAAa;QACb,MAAM,EAAE,MAAM,CAAC;QACf,SAAS;QACT,GAAG,EAAE,MAAM,CAAC;KACb,CAAC,CAAC;IAEH,aAAa;IACb,YAAY,CAAC,IAAI,EAAE;QACjB,WAAW;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS;QACT,KAAK,EAAE,MAAM,CAAC;KACf,GAAG,OAAO,CAAC;QACV,WAAW;QACX,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC,CAAC;CACJ"}

package/dist/generated/user.js

@@ -0,0 +1,6 @@
+// ============================================================
+// 此文件由 h5_app_container_generator 自动生成，请勿手动修改。
+// 运行 `dart run build_runner build` 重新生成。
+// ============================================================
+export {};
+//# sourceMappingURL=user.js.map

package/dist/generated/user.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.js","sourceRoot":"","sources":["../../generated/user.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,+CAA+C;AAC/C,yCAAyC;AACzC,+DAA+D"}

package/dist/src/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @h5-container/bridge-core-ts
+ *
+ * H5 端与 Flutter 容器通信的核心 SDK（零框架依赖）。
+ * 提供 Bridge 消息通信 + 原生模块类型安全调用。
+ *
+ * 适用于 React / Vue / Svelte / Vanilla JS 等任何前端框架。
+ * 所有 API 从此入口统一导出，消费者无需感知内部目录结构。
+ */
+export { bridge, MrpBridge } from './mrp-bridge';
+export type { BridgeMessage, MessageHandler, Unsubscribe, } from './mrp-bridge';
+export { getSystemModule } from './system-module';
+export type { SystemModule, ModuleAllowedResult, AvailableModulesResult, ContainerInfoResult, } from './system-module';
+export * from '../generated/index';
+export { lifecycle } from './lifecycle';
+export type { RouteChangedPayload, AppMountedPayload } from './lifecycle';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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,EACV,aAAa,EACb,cAAc,EACd,WAAW,GACZ,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAGzB,cAAc,oBAAoB,CAAC;AAGnC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,18 @@
+/**
+ * @h5-container/bridge-core-ts
+ *
+ * H5 端与 Flutter 容器通信的核心 SDK（零框架依赖）。
+ * 提供 Bridge 消息通信 + 原生模块类型安全调用。
+ *
+ * 适用于 React / Vue / Svelte / Vanilla JS 等任何前端框架。
+ * 所有 API 从此入口统一导出，消费者无需感知内部目录结构。
+ */
+// 核心 Bridge
+export { bridge, MrpBridge } from './mrp-bridge';
+// 内置系统模块类型 + 工厂函数（容器核心契约）
+export { getSystemModule } from './system-module';
+// Generated 模块：类型 + 工厂函数
+export * from '../generated/index';
+// 生命周期上报工具
+export { lifecycle } from './lifecycle';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +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;AAOjD,0BAA0B;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAQlD,yBAAyB;AACzB,cAAc,oBAAoB,CAAC;AAEnC,WAAW;AACX,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC"}

package/dist/src/lifecycle.d.ts

@@ -0,0 +1,85 @@
+/**
+ * H5 容器生命周期上报工具。
+ *
+ * 提供类型安全的生命周期事件上报接口，H5 应用通过此模块通知
+ * Flutter 宿主当前的运行状态。
+ *
+ * @example
+ * ```ts
+ * import { lifecycle } from '@h5-container/bridge-core-ts';
+ *
+ * // React
+ * useEffect(() => {
+ *   lifecycle.appMounted({ route: location.pathname });
+ *   return () => lifecycle.appDestroyed();
+ * }, []);
+ *
+ * // 路由跳转
+ * lifecycle.routeChanged({ from: '/home', to: '/game' });
+ *
+ * // 自定义事件
+ * lifecycle.custom('gameStarted', { level: 1 });
+ * ```
+ */
+/** SPA 路由跳转事件的 payload */
+export interface RouteChangedPayload {
+    /** 跳转前路由 */
+    from: string;
+    /** 跳转后路由 */
+    to: string;
+}
+/** appMounted 事件的 payload */
+export interface AppMountedPayload {
+    /** 当前路由（可选） */
+    route?: string;
+}
+/**
+ * H5 容器生命周期上报 API。
+ *
+ * 调用这些方法通知宿主 Flutter 应用当前 H5 的运行状态。
+ * 宿主通过 `controller.onContainerEvent` 流接收事件。
+ */
+export declare const lifecycle: {
+    /**
+     * 上报 H5 应用挂载完成。
+     *
+     * 建议在 React 根组件 `useEffect` 或 Vue `onMounted` 中调用。
+     */
+    readonly appMounted: (payload?: AppMountedPayload) => void;
+    /**
+     * 上报 H5 应用销毁。
+     *
+     * 建议在 React 根组件 `useEffect` 的 cleanup 或 Vue `onUnmounted` 中调用。
+     */
+    readonly appDestroyed: () => void;
+    /**
+     * 上报 SPA 内部路由跳转。
+     *
+     * 建议在路由守卫或 React Router 的 `useLocation` 变化时调用。
+     */
+    readonly routeChanged: (payload: RouteChangedPayload) => void;
+    /**
+     * 上报页面恢复可见（`visibilitychange: visible`）。
+     *
+     * 建议监听 `document.addEventListener('visibilitychange', ...)` 后调用。
+     */
+    readonly pageVisible: () => void;
+    /**
+     * 上报页面进入后台（`visibilitychange: hidden`）。
+     */
+    readonly pageHidden: () => void;
+    /**
+     * 上报自定义事件（业务自定义语义）。
+     *
+     * @param action  事件名称（宿主侧收到 `event.action` 即此值，type 为 `custom`）
+     * @param payload 事件数据
+     *
+     * @example
+     * ```ts
+     * lifecycle.custom('gameStarted', { level: 1, mode: 'easy' });
+     * lifecycle.custom('scoreUpdated', { score: 200 });
+     * ```
+     */
+    readonly custom: (action: string, payload?: Record<string, unknown>) => void;
+};
+//# sourceMappingURL=lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAMH,0BAA0B;AAC1B,MAAM,WAAW,mBAAmB;IAClC,YAAY;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,6BAA6B;AAC7B,MAAM,WAAW,iBAAiB;IAChC,eAAe;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqBD;;;;;GAKG;AACH,eAAO,MAAM,SAAS;IACpB;;;;OAIG;oCACkB,iBAAiB,KAAG,IAAI;IAI7C;;;;OAIG;iCACa,IAAI;IAIpB;;;;OAIG;qCACmB,mBAAmB,KAAG,IAAI;IAIhD;;;;OAIG;gCACY,IAAI;IAInB;;OAEG;+BACW,IAAI;IAIlB;;;;;;;;;;;OAWG;8BACY,MAAM,YAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAAI;CAGvD,CAAC"}

package/dist/src/lifecycle.js

@@ -0,0 +1,97 @@
+/**
+ * H5 容器生命周期上报工具。
+ *
+ * 提供类型安全的生命周期事件上报接口，H5 应用通过此模块通知
+ * Flutter 宿主当前的运行状态。
+ *
+ * @example
+ * ```ts
+ * import { lifecycle } from '@h5-container/bridge-core-ts';
+ *
+ * // React
+ * useEffect(() => {
+ *   lifecycle.appMounted({ route: location.pathname });
+ *   return () => lifecycle.appDestroyed();
+ * }, []);
+ *
+ * // 路由跳转
+ * lifecycle.routeChanged({ from: '/home', to: '/game' });
+ *
+ * // 自定义事件
+ * lifecycle.custom('gameStarted', { level: 1 });
+ * ```
+ */
+// ============================================================
+// 工具函数
+// ============================================================
+/** 底层上报函数，通过 Bridge 发送 lifecycle 类型消息。 */
+function report(action, payload = {}) {
+    if (window.__FLUTTER_BRIDGE__) {
+        window.__FLUTTER_BRIDGE__.send('lifecycle', action, payload);
+    }
+}
+// ============================================================
+// 生命周期对象（命名空间风格，方便 tree-shaking）
+// ============================================================
+/**
+ * H5 容器生命周期上报 API。
+ *
+ * 调用这些方法通知宿主 Flutter 应用当前 H5 的运行状态。
+ * 宿主通过 `controller.onContainerEvent` 流接收事件。
+ */
+export const lifecycle = {
+    /**
+     * 上报 H5 应用挂载完成。
+     *
+     * 建议在 React 根组件 `useEffect` 或 Vue `onMounted` 中调用。
+     */
+    appMounted(payload) {
+        report('appMounted', payload ?? {});
+    },
+    /**
+     * 上报 H5 应用销毁。
+     *
+     * 建议在 React 根组件 `useEffect` 的 cleanup 或 Vue `onUnmounted` 中调用。
+     */
+    appDestroyed() {
+        report('appDestroyed');
+    },
+    /**
+     * 上报 SPA 内部路由跳转。
+     *
+     * 建议在路由守卫或 React Router 的 `useLocation` 变化时调用。
+     */
+    routeChanged(payload) {
+        report('routeChanged', payload);
+    },
+    /**
+     * 上报页面恢复可见（`visibilitychange: visible`）。
+     *
+     * 建议监听 `document.addEventListener('visibilitychange', ...)` 后调用。
+     */
+    pageVisible() {
+        report('pageVisible');
+    },
+    /**
+     * 上报页面进入后台（`visibilitychange: hidden`）。
+     */
+    pageHidden() {
+        report('pageHidden');
+    },
+    /**
+     * 上报自定义事件（业务自定义语义）。
+     *
+     * @param action  事件名称（宿主侧收到 `event.action` 即此值，type 为 `custom`）
+     * @param payload 事件数据
+     *
+     * @example
+     * ```ts
+     * lifecycle.custom('gameStarted', { level: 1, mode: 'easy' });
+     * lifecycle.custom('scoreUpdated', { score: 200 });
+     * ```
+     */
+    custom(action, payload) {
+        report(action, payload ?? {});
+    },
+};
+//# sourceMappingURL=lifecycle.js.map

package/dist/src/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAoBH,+DAA+D;AAC/D,OAAO;AACP,+DAA+D;AAE/D,0CAA0C;AAC1C,SAAS,MAAM,CAAC,MAAc,EAAE,UAAkB,EAAE;IAClD,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;QAC9B,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAC5B,WAAW,EACX,MAAM,EACN,OAAkC,CACnC,CAAC;IACJ,CAAC;AACH,CAAC;AAED,+DAA+D;AAC/D,iCAAiC;AACjC,+DAA+D;AAE/D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB;;;;OAIG;IACH,UAAU,CAAC,OAA2B;QACpC,MAAM,CAAC,YAAY,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAED;;;;OAIG;IACH,YAAY;QACV,MAAM,CAAC,cAAc,CAAC,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,OAA4B;QACvC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACH,WAAW;QACT,MAAM,CAAC,aAAa,CAAC,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,UAAU;QACR,MAAM,CAAC,YAAY,CAAC,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,MAAc,EAAE,OAAiC;QACtD,MAAM,CAAC,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;CACO,CAAC"}