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

package/README.md

@@ -129,6 +129,29 @@ const { modules } = await system.getAvailableModules();
 const info = await system.getContainerInfo();
 ```
 
+## App 统一屏幕适配
+
+在使用设计稿尺寸的 H5 中初始化一次，即可使用与 Flutter `.ar` 相同的缩放规则：
+
+```ts
+import {
+  ar,
+  getArScale,
+  initArAdaptation,
+  onArAdaptationChange,
+} from '@h5-container/bridge-core-ts';
+
+await initArAdaptation();
+const style = { width: ar(120), fontSize: ar(18) };
+
+// React 等框架可在回调中更新 state，触发使用 ar() 的样式重新计算。
+const unsubscribe = onArAdaptationChange(() => {
+  setScale(getArScale());
+});
+```
+
+App 横竖屏或窗口尺寸变化时，SDK 会自动更新比例并触发订阅回调。组件销毁时调用 `unsubscribe()`。当前工具覆盖 TS/TSX 数值样式；CSS 全局适配暂不自动修改页面根字号。
+
 ## 标准内容协议
 
 SDK 为内容型 H5 固定定义以下协议域：
@@ -140,7 +163,7 @@ SDK 为内容型 H5 固定定义以下协议域：
 | Flutter → H5 | `render` | `clear` | `{}` |
 | H5 → Flutter | `render` | `ready` | 应用能力信息 |
 | H5 → Flutter | `render` | `applied` | 已执行操作信息 |
-| H5 → Flutter | `interaction` | 业务动作 | `{ sourceId, value?, ... }` |
+| H5 → Flutter | `interaction` | 业务动作 | `{ source_id, value?, ... }` |
 | H5 → Flutter | `error` | `report` | `{ source, code, message, details? }` |
 
 H5 通过 `bindRenderProtocol()` 接收渲染消息，通过 `renderProtocol`、`interaction` 和 `bridgeError` 上报事件：
@@ -160,7 +183,7 @@ const unsubscribe = bindRenderProtocol({
 });
 
 await renderProtocol.ready({ supportedOrientations: ['portrait'] });
-await interaction.send('submit', { sourceId: 'choice-1', value: ['fast'] });
+await interaction.send('submit', { source_id: 'choice-1', value: ['fast'] });
 await bridgeError.report({
   source: 'render',
   code: 'INVALID_CONTENT',

package/dist/generated/data_provider.d.ts

@@ -0,0 +1,13 @@
+/** 页面预置数据模块 */
+export interface DataProvider {
+    /**
+     * 获取 App 预置的当前页面数据。
+     *
+     * App 端在加载 H5 前通过 `NlDataProviderModule.setPageData(data)` 预置，
+     * H5 通过本方法获取，不需要 key，永远只有一份当前页面数据。
+     *
+     * 返回类型由业务方自行约定；没有预置数据时返回 `null`。
+     */
+    getPageData<T = unknown>(): Promise<T | null>;
+}
+//# sourceMappingURL=data_provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data_provider.d.ts","sourceRoot":"","sources":["../../generated/data_provider.ts"],"names":[],"mappings":"AAKA,eAAe;AACf,MAAM,WAAW,YAAY;IACzB;;;;;;;OAOG;IACH,WAAW,CAAC,CAAC,GAAG,OAAO,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;CACjD"}

package/dist/generated/data_provider.js

@@ -0,0 +1,6 @@
+// ============================================================
+// 手动维护：与 Flutter 端 NlDataProviderModule 对齐。
+// Flutter 源：athena-xingqiu/lib/h5/modules/nl_data_provider_module.dart
+// ============================================================
+export {};
+//# sourceMappingURL=data_provider.js.map

package/dist/generated/data_provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data_provider.js","sourceRoot":"","sources":["../../generated/data_provider.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,4CAA4C;AAC5C,uEAAuE;AACvE,+DAA+D"}

package/dist/generated/index.d.ts

@@ -2,10 +2,18 @@ import type { AiTutor } from './ai_tutor';
 import type { Audio } from './audio';
 import type { Device } from './device';
 import type { User } from './user';
+import type { SoundEffects } from './sound_effects';
+import type { TtsPlayer } from './tts_player';
+import type { DataProvider } from './data_provider';
+import type { MessageRead } from './message_read';
 export type { AiTutor } from './ai_tutor';
 export type { Audio } from './audio';
 export type { Device } from './device';
 export type { User } from './user';
+export type { SoundEffects, SoundId } from './sound_effects';
+export type { TtsPlayer, TtsKind, TtsAccent, TtsPreset, TtsVoiceArgs, TtsSupportedVoices, } from './tts_player';
+export type { DataProvider } from './data_provider';
+export type { MessageRead, MarkReadResult } from './message_read';
 /** 获取 ai_tutor 的类型安全代理 */
 export declare function getAiTutor(): AiTutor;
 /** 获取 audio 的类型安全代理 */
@@ -14,4 +22,12 @@ export declare function getAudio(): Audio;
 export declare function getDevice(): Device;
 /** 获取 user 的类型安全代理 */
 export declare function getUser(): User;
+/** 获取 soundEffects 的类型安全代理 */
+export declare function getSoundEffects(): SoundEffects;
+/** 获取 ttsPlayer 的类型安全代理 */
+export declare function getTtsPlayer(): TtsPlayer;
+/** 获取 dataProvider 的类型安全代理 */
+export declare function getDataProvider(): DataProvider;
+/** 获取 messageRead 的类型安全代理 */
+export declare function getMessageRead(): MessageRead;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"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;AACnC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,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;AACnC,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC7D,YAAY,EACV,SAAS,EACT,OAAO,EACP,SAAS,EACT,SAAS,EACT,YAAY,EACZ,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAMlE,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;AAED,8BAA8B;AAC9B,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED,2BAA2B;AAC3B,wBAAgB,YAAY,IAAI,SAAS,CAExC;AAED,8BAA8B;AAC9B,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED,6BAA6B;AAC7B,wBAAgB,cAAc,IAAI,WAAW,CAE5C"}

package/dist/generated/index.js

@@ -22,4 +22,20 @@ export function getDevice() {
 export function getUser() {
     return bridge.module('user');
 }
+/** 获取 soundEffects 的类型安全代理 */
+export function getSoundEffects() {
+    return bridge.module('soundEffects');
+}
+/** 获取 ttsPlayer 的类型安全代理 */
+export function getTtsPlayer() {
+    return bridge.module('ttsPlayer');
+}
+/** 获取 dataProvider 的类型安全代理 */
+export function getDataProvider() {
+    return bridge.module('dataProvider');
+}
+/** 获取 messageRead 的类型安全代理 */
+export function getMessageRead() {
+    return bridge.module('messageRead');
+}
 //# sourceMappingURL=index.js.map

package/dist/generated/index.js.map

@@ -1 +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"}
+{"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;AA0B3C,+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;AAED,8BAA8B;AAC9B,MAAM,UAAU,eAAe;IAC7B,OAAO,MAAM,CAAC,MAAM,CAAe,cAAc,CAAC,CAAC;AACrD,CAAC;AAED,2BAA2B;AAC3B,MAAM,UAAU,YAAY;IAC1B,OAAO,MAAM,CAAC,MAAM,CAAY,WAAW,CAAC,CAAC;AAC/C,CAAC;AAED,8BAA8B;AAC9B,MAAM,UAAU,eAAe;IAC7B,OAAO,MAAM,CAAC,MAAM,CAAe,cAAc,CAAC,CAAC;AACrD,CAAC;AAED,6BAA6B;AAC7B,MAAM,UAAU,cAAc;IAC5B,OAAO,MAAM,CAAC,MAAM,CAAc,aAAa,CAAC,CAAC;AACnD,CAAC"}

package/dist/generated/message_read.d.ts

@@ -0,0 +1,18 @@
+/** 消息已读上报模块返回值 */
+export interface MarkReadResult {
+    success: boolean;
+    errorMessage?: string;
+}
+/** 消息已读上报模块 */
+export interface MessageRead {
+    /**
+     * 将指定消息标记为已读。
+     *
+     * 用于首页 webView 弹窗卡片：H5 通过 `getPageData()` 拿到 `messageId`，
+     * 在合适的时机（如"看完"）调用本方法，由 H5 业务方决定何时算已读。
+     */
+    markRead(args: {
+        messageId: number;
+    }): Promise<MarkReadResult>;
+}
+//# sourceMappingURL=message_read.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"message_read.d.ts","sourceRoot":"","sources":["../../generated/message_read.ts"],"names":[],"mappings":"AAKA,kBAAkB;AAClB,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,eAAe;AACf,MAAM,WAAW,WAAW;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAClE"}

package/dist/generated/message_read.js

@@ -0,0 +1,6 @@
+// ============================================================
+// 手动维护：与 Flutter 端 NlMessageReadModule 对齐。
+// Flutter 源：athena-xingqiu/lib/h5/modules/nl_data_provider_module.dart
+// ============================================================
+export {};
+//# sourceMappingURL=message_read.js.map

package/dist/generated/message_read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message_read.js","sourceRoot":"","sources":["../../generated/message_read.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,2CAA2C;AAC3C,uEAAuE;AACvE,+DAA+D"}

package/dist/generated/sound_effects.d.ts

@@ -0,0 +1,25 @@
+/** 支持的音效 ID 枚举（与 Flutter 端 _supportedSoundIds 保持一致） */
+export type SoundId = 'bubbleRight' | 'bubbleWrong' | 'right1' | 'right2' | 'error1' | 'error2' | 'errorTip' | 'successTip' | 'writing' | 'recording' | 'pageTurning' | 'coinDrop' | 'countDown' | 'hangUp' | 'magicUsing' | 'magicStar' | 'giftProps' | 'chuxian' | 'du' | 'saHua' | 'starDown' | 'bubbleAppear' | 'flyAway' | 'letPlay' | 'letPractice' | 'letWatch' | 'good' | 'great' | 'excellent' | 'awesome' | 'cool' | 'fantastic' | 'comboFrenzy' | 'appear' | 'wxConnect' | 'homeBg' | 'summary' | 'transition' | 'baoxiangDown' | 'baoxiangOpen' | 'gemAddVoice' | 'oneStar' | 'twoStar';
+/** 内置音效播放模块 */
+export interface SoundEffects {
+    /** 按 soundId 播放内置音效 */
+    play(args: {
+        soundId: SoundId;
+        /** 是否等待播放完成再 resolve（仅部分音效支持） */
+        waitForCompletion?: boolean;
+    }): Promise<{
+        success: boolean;
+        soundId: string;
+    }>;
+    /** 获取当前支持的 soundId 列表 */
+    supportedSounds(): Promise<string[]>;
+    /** 停止微信连接循环音效 */
+    stopWxConnect(): Promise<{
+        success: boolean;
+    }>;
+    /** 停止首页背景音乐 */
+    stopHomeBg(): Promise<{
+        success: boolean;
+    }>;
+}
+//# sourceMappingURL=sound_effects.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sound_effects.d.ts","sourceRoot":"","sources":["../../generated/sound_effects.ts"],"names":[],"mappings":"AAKA,uDAAuD;AACvD,MAAM,MAAM,OAAO,GACf,aAAa,GACb,aAAa,GACb,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,YAAY,GACZ,SAAS,GACT,WAAW,GACX,aAAa,GACb,UAAU,GACV,WAAW,GACX,QAAQ,GACR,YAAY,GACZ,WAAW,GACX,WAAW,GACX,SAAS,GACT,IAAI,GACJ,OAAO,GACP,UAAU,GACV,cAAc,GACd,SAAS,GACT,SAAS,GACT,aAAa,GACb,UAAU,GACV,MAAM,GACN,OAAO,GACP,WAAW,GACX,SAAS,GACT,MAAM,GACN,WAAW,GACX,aAAa,GACb,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,SAAS,GACT,YAAY,GACZ,cAAc,GACd,cAAc,GACd,aAAa,GACb,SAAS,GACT,SAAS,CAAC;AAEd,eAAe;AACf,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,IAAI,CAAC,IAAI,EAAE;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,iCAAiC;QACjC,iBAAiB,CAAC,EAAE,OAAO,CAAC;KAC7B,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEnD,yBAAyB;IACzB,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAErC,iBAAiB;IACjB,aAAa,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAE/C,eAAe;IACf,UAAU,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC7C"}

package/dist/generated/sound_effects.js

@@ -0,0 +1,6 @@
+// ============================================================
+// 手动维护：与 Flutter 端 NlSoundEffectsModule 对齐。
+// Flutter 源：athena-xingqiu/lib/h5/modules/nl_sound_effects_module.dart
+// ============================================================
+export {};
+//# sourceMappingURL=sound_effects.js.map

package/dist/generated/sound_effects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sound_effects.js","sourceRoot":"","sources":["../../generated/sound_effects.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,4CAA4C;AAC5C,uEAAuE;AACvE,+DAA+D"}

package/dist/generated/tts_player.d.ts

@@ -0,0 +1,69 @@
+/** TTS 请求类型 */
+export type TtsKind = 'sentence' | 'word' | 'tutor';
+/** 口音简写 */
+export type TtsAccent = 'uk' | 'us';
+/** 预设语色速写（对应 Flutter 端 _presets） */
+export type TtsPreset = 'sentence-default' | 'word-default' | 'sara-cheerful' | 'paige-supportive' | 'libby-uk' | 'nativeMentor-us';
+/** 公共语色参数，play 与 getUrl 共享 */
+export interface TtsVoiceArgs {
+    text: string;
+    kind?: TtsKind;
+    accent?: TtsAccent;
+    /** 指定 tutorId（白名单内），优先级高于 accent */
+    tutorId?: string;
+    /** 语气，如 newscast / cheerful / Supportive */
+    voiceStyle?: string;
+    /** 底层发音类型，如 BV503_streaming */
+    voiceType?: string;
+    /** 语速，如 '-20%' / '+10%' */
+    voiceRate?: string;
+    /** 仅 sentence 有效：是否按断句处理 */
+    isBreak?: 0 | 1;
+    /** 语色预设名 */
+    preset?: TtsPreset;
+}
+/** supportedVoices() 返回值 */
+export interface TtsSupportedVoices {
+    kinds: TtsKind[];
+    tutors: string[];
+    styles: string[];
+    types: string[];
+    presets: TtsPreset[];
+}
+/** 文本朗读（TTS）播放模块：传入文本由 App 原生链路请求 TTS 并播放 */
+export interface TtsPlayer {
+    /**
+     * 请求 TTS 音频并原生播放。
+     *
+     * 校验失败时 resolve `{ success:false, error, field }`，不会抛异常。
+     * 新一次 `play` 会自动打断本模块上一段音频。
+     */
+    play(args: TtsVoiceArgs & {
+        /** 是否等待播放完成再 resolve */
+        waitForCompletion?: boolean;
+    }): Promise<{
+        success: boolean;
+        /** 错误标识：noStudent / invalidText / invalidKind / invalidVoice / invalidPreset 等 */
+        error?: string;
+        /** 校验失败时指向的字段名（如 tutorId） */
+        field?: string;
+    }>;
+    /** 停止本模块当前播放的音频（不影响音效/录音等其他音频） */
+    stop(): Promise<{
+        success: boolean;
+    }>;
+    /** 暂停本模块当前播放的音频 */
+    pause(): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * 仅请求 TTS 音频 URL，不播放。适用于 H5 希望自己用 `<audio>` 控制进度/波形的场景。
+     */
+    getUrl(args: TtsVoiceArgs): Promise<{
+        /** 可直接给 `<audio>` 播放的 URL */
+        url: string;
+    }>;
+    /** 查询当前支持的 kind / tutorId / voiceStyle / voiceType / preset 白名单 */
+    supportedVoices(): Promise<TtsSupportedVoices>;
+}
+//# sourceMappingURL=tts_player.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tts_player.d.ts","sourceRoot":"","sources":["../../generated/tts_player.ts"],"names":[],"mappings":"AAKA,eAAe;AACf,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;AAEpD,WAAW;AACX,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpC,oCAAoC;AACpC,MAAM,MAAM,SAAS,GACjB,kBAAkB,GAClB,cAAc,GACd,eAAe,GACf,kBAAkB,GAClB,UAAU,GACV,iBAAiB,CAAC;AAEtB,8BAA8B;AAC9B,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAChB,YAAY;IACZ,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,4BAA4B;AAC5B,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAED,6CAA6C;AAC7C,MAAM,WAAW,SAAS;IACxB;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,YAAY,GAAG;QACxB,wBAAwB;QACxB,iBAAiB,CAAC,EAAE,OAAO,CAAC;KAC7B,GAAG,OAAO,CAAC;QACV,OAAO,EAAE,OAAO,CAAC;QACjB,kFAAkF;QAClF,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,6BAA6B;QAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IAEH,kCAAkC;IAClC,IAAI,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAEtC,mBAAmB;IACnB,KAAK,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAEvC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC;QAClC,6BAA6B;QAC7B,GAAG,EAAE,MAAM,CAAC;KACb,CAAC,CAAC;IAEH,mEAAmE;IACnE,eAAe,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAChD"}

package/dist/generated/tts_player.js

@@ -0,0 +1,6 @@
+// ============================================================
+// 手动维护：与 Flutter 端 NlTtsPlayerModule 对齐。
+// Flutter 源：athena-xingqiu/lib/h5/modules/nl_tts_player_module.dart
+// ============================================================
+export {};
+//# sourceMappingURL=tts_player.js.map

package/dist/generated/tts_player.js.map

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

package/dist/src/adaptation.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 与 Flutter `.ar` 相同的屏幕适配工具。
+ *
+ * App 端以 812 作为设计稿最长边基准，将 adaptation 注入 system 模块。
+ */
+import { type ArAdaptationInfo, type SafeAreaInsets } from './system-module';
+import { type Unsubscribe } from './mrp-bridge';
+export type ArAdaptationListener = (adaptation: ArAdaptationInfo) => void;
+/** 从容器读取初始适配信息，并注册横竖屏变化监听。 */
+export declare function initArAdaptation(): Promise<ArAdaptationInfo | null>;
+/** 将设计稿尺寸转换为当前 App 屏幕尺寸。 */
+export declare function ar(value: number): number;
+/** 获取当前适配比例，便于 Canvas 或自定义渲染使用。 */
+export declare function getArScale(): number;
+/** 获取 App 注入的设备安全区；不在容器内或 App 未注入时返回全 0。 */
+export declare function getSafeArea(): SafeAreaInsets;
+/** 监听 App 横竖屏或窗口尺寸变化，返回取消监听函数。 */
+export declare function onArAdaptationChange(listener: ArAdaptationListener): Unsubscribe;
+//# sourceMappingURL=adaptation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adaptation.d.ts","sourceRoot":"","sources":["../../src/adaptation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAEN,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AASxD,MAAM,MAAM,oBAAoB,GAAG,CAAC,UAAU,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAiC1E,8BAA8B;AAC9B,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAIzE;AAED,4BAA4B;AAC5B,wBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExC;AAED,mCAAmC;AACnC,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,4CAA4C;AAC5C,wBAAgB,WAAW,IAAI,cAAc,CAE5C;AAED,kCAAkC;AAClC,wBAAgB,oBAAoB,CACnC,QAAQ,EAAE,oBAAoB,GAC5B,WAAW,CAIb"}

package/dist/src/adaptation.js

@@ -0,0 +1,59 @@
+/**
+ * 与 Flutter `.ar` 相同的屏幕适配工具。
+ *
+ * App 端以 812 作为设计稿最长边基准，将 adaptation 注入 system 模块。
+ */
+import { getSystemModule, } from './system-module';
+import { bridge } from './mrp-bridge';
+const ZERO_SAFE_AREA = { top: 0, bottom: 0, left: 0, right: 0 };
+let currentScale = 1;
+let currentSafeArea = ZERO_SAFE_AREA;
+let bridgeUnsubscribe = null;
+const listeners = new Set();
+function applyAdaptation(adaptation) {
+    if (!adaptation ||
+        !Number.isFinite(adaptation.scale) ||
+        adaptation.scale <= 0) {
+        currentScale = 1;
+        currentSafeArea = ZERO_SAFE_AREA;
+        return null;
+    }
+    currentScale = adaptation.scale;
+    currentSafeArea = adaptation.safeArea ?? ZERO_SAFE_AREA;
+    for (const listener of listeners) {
+        listener(adaptation);
+    }
+    return adaptation;
+}
+function ensureAdaptationListener() {
+    if (bridgeUnsubscribe)
+        return;
+    bridgeUnsubscribe = bridge.on('adaptation', 'changed', (message) => {
+        applyAdaptation(message.payload);
+    });
+}
+/** 从容器读取初始适配信息，并注册横竖屏变化监听。 */
+export async function initArAdaptation() {
+    ensureAdaptationListener();
+    const info = await getSystemModule().getContainerInfo();
+    return applyAdaptation(info?.adaptation);
+}
+/** 将设计稿尺寸转换为当前 App 屏幕尺寸。 */
+export function ar(value) {
+    return value * currentScale;
+}
+/** 获取当前适配比例，便于 Canvas 或自定义渲染使用。 */
+export function getArScale() {
+    return currentScale;
+}
+/** 获取 App 注入的设备安全区；不在容器内或 App 未注入时返回全 0。 */
+export function getSafeArea() {
+    return currentSafeArea;
+}
+/** 监听 App 横竖屏或窗口尺寸变化，返回取消监听函数。 */
+export function onArAdaptationChange(listener) {
+    ensureAdaptationListener();
+    listeners.add(listener);
+    return () => listeners.delete(listener);
+}
+//# sourceMappingURL=adaptation.js.map

package/dist/src/adaptation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptation.js","sourceRoot":"","sources":["../../src/adaptation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACN,eAAe,GAGf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,MAAM,EAAoB,MAAM,cAAc,CAAC;AAExD,MAAM,cAAc,GAAmB,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAEhF,IAAI,YAAY,GAAG,CAAC,CAAC;AACrB,IAAI,eAAe,GAAmB,cAAc,CAAC;AACrD,IAAI,iBAAiB,GAAuB,IAAI,CAAC;AACjD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAwB,CAAC;AAIlD,SAAS,eAAe,CACvB,UAA+C;IAE/C,IACC,CAAC,UAAU;QACX,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC;QAClC,UAAU,CAAC,KAAK,IAAI,CAAC,EACpB,CAAC;QACF,YAAY,GAAG,CAAC,CAAC;QACjB,eAAe,GAAG,cAAc,CAAC;QACjC,OAAO,IAAI,CAAC;IACb,CAAC;IACD,YAAY,GAAG,UAAU,CAAC,KAAK,CAAC;IAChC,eAAe,GAAG,UAAU,CAAC,QAAQ,IAAI,cAAc,CAAC;IACxD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QAClC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,UAAU,CAAC;AACnB,CAAC;AAED,SAAS,wBAAwB;IAChC,IAAI,iBAAiB;QAAE,OAAO;IAC9B,iBAAiB,GAAG,MAAM,CAAC,EAAE,CAC5B,YAAY,EACZ,SAAS,EACT,CAAC,OAAO,EAAE,EAAE;QACX,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC,CACD,CAAC;AACH,CAAC;AAED,8BAA8B;AAC9B,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACrC,wBAAwB,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,MAAM,eAAe,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACxD,OAAO,eAAe,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AAC1C,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,EAAE,CAAC,KAAa;IAC/B,OAAO,KAAK,GAAG,YAAY,CAAC;AAC7B,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,UAAU;IACzB,OAAO,YAAY,CAAC;AACrB,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,WAAW;IAC1B,OAAO,eAAe,CAAC;AACxB,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,oBAAoB,CACnC,QAA8B;IAE9B,wBAAwB,EAAE,CAAC;IAC3B,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxB,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACzC,CAAC"}

package/dist/src/content-protocol.d.ts

@@ -3,6 +3,8 @@ export declare const bridgeMessageTypes: {
     readonly render: "render";
     readonly interaction: "interaction";
     readonly error: "error";
+    /** 宿主镜像给 H5 的回合事件（单向：宿主 → H5）。 */
+    readonly agent: "agent";
 };
 export declare const renderActions: {
     readonly set: "set";
@@ -21,7 +23,7 @@ export interface RenderHandlers<T = unknown> {
     clear(message: BridgeMessage<Record<string, unknown>>): void;
 }
 export interface InteractionPayload<T = unknown> {
-    sourceId: string;
+    source_id: string;
     value?: T;
     [key: string]: unknown;
 }
@@ -47,4 +49,45 @@ export declare const interaction: {
 export declare const bridgeError: {
     readonly report: (payload: BridgeErrorPayload) => Promise<unknown>;
 };
+/**
+ * 回合事件协议：宿主把「现在轮到谁、这一轮发生了什么」镜像给 H5。
+ *
+ * 用在 H5 页面**作为一个交互步骤**嵌在原生流程里的场景（AI 教学 / 问诊等）：
+ * 原生题型能收到宿主的回合事件，H5 题型也应该能。宿主只负责把事实发下来，
+ * 怎么响应（放开作答、复位重做、演完反馈再收尾）由 H5 自己决定。
+ *
+ * 线格式：`{ type: 'agent', action, payload: { iid, ... } }`
+ */
+export declare const agentEvents: {
+    /** 作答权交回给用户（宿主的开场播报已结束）。 */
+    readonly startLearn: "start_learn";
+    /** 本题重做。 */
+    readonly retryLearn: "retry_learn";
+    /** 本题判过；若宿主把收尾交给了 H5，H5 需回发一次收尾动作，否则流程不推进。 */
+    readonly passLearn: "pass_learn";
+    /** 用户**绕过这块 H5** 上行了一次作答（原生输入栏、原生选择器等）。 */
+    readonly externalAnswer: "external_answer";
+};
+export interface AgentEventPayload {
+    /**
+     * 这条事件属于哪一屏。
+     *
+     * 内容（`render/set`）和事件通常来自宿主上游的两条独立消息，到达先后不保证。
+     * 拿它对齐「这条事件说的是不是我现在这一屏」，不匹配就先扣着。
+     */
+    iid?: string;
+    [key: string]: unknown;
+}
+export interface ExternalAnswerPayload extends AgentEventPayload {
+    /** 那次绕过本页的上行负载（形态由宿主定义）。 */
+    answer?: Record<string, unknown>;
+}
+export interface AgentEventHandlers {
+    startLearn?(payload: AgentEventPayload, message: BridgeMessage<AgentEventPayload>): void;
+    retryLearn?(payload: AgentEventPayload, message: BridgeMessage<AgentEventPayload>): void;
+    passLearn?(payload: AgentEventPayload, message: BridgeMessage<AgentEventPayload>): void;
+    externalAnswer?(payload: ExternalAnswerPayload, message: BridgeMessage<ExternalAnswerPayload>): void;
+}
+/** 只订阅传了 handler 的那几个事件；返回的函数一次性退订。 */
+export declare function bindAgentProtocol(handlers: AgentEventHandlers, transport?: Pick<ProtocolTransport, 'on'>): Unsubscribe;
 //# sourceMappingURL=content-protocol.d.ts.map

package/dist/src/content-protocol.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content-protocol.d.ts","sourceRoot":"","sources":["../../src/content-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAE5E,eAAO,MAAM,kBAAkB;;;;CAIrB,CAAC;AAEX,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAC;AAEX,MAAM,WAAW,aAAa,CAAC,CAAC,GAAG,OAAO;IACxC,IAAI,EAAE,CAAC,CAAC;IACR,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,GAAG,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/E,MAAM,CAAC,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACnF,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;CAC9D;AAED,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,CACA,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC,GAAG,CAAC,KAAK,IAAI,GAC7C,WAAW,CAAC;IACf,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;CACrB;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,EAC3B,SAAS,GAAE,iBAA0B,GACpC,WAAW,CAcb;AAED,eAAO,MAAM,cAAc;+BACV,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAQ,OAAO,CAAC,OAAO,CAAC;iCAI7C,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAQ,OAAO,CAAC,OAAO,CAAC;CAGxD,CAAC;AAEX,eAAO,MAAM,WAAW;oBACjB,CAAC,UAAU,MAAM,WAAW,kBAAkB,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,OAAO,CAAC;CAGjE,CAAC;AAEX,eAAO,MAAM,WAAW;+BACN,kBAAkB,KAAG,OAAO,CAAC,OAAO,CAAC;CAG7C,CAAC"}
+{"version":3,"file":"content-protocol.d.ts","sourceRoot":"","sources":["../../src/content-protocol.ts"],"names":[],"mappings":"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"}

package/dist/src/content-protocol.js

@@ -3,6 +3,8 @@ export const bridgeMessageTypes = {
     render: 'render',
     interaction: 'interaction',
     error: 'error',
+    /** 宿主镜像给 H5 的回合事件（单向：宿主 → H5）。 */
+    agent: 'agent',
 };
 export const renderActions = {
     set: 'set',
@@ -43,4 +45,38 @@ export const bridgeError = {
         return bridge.send(bridgeMessageTypes.error, 'report', payload);
     },
 };
+/**
+ * 回合事件协议：宿主把「现在轮到谁、这一轮发生了什么」镜像给 H5。
+ *
+ * 用在 H5 页面**作为一个交互步骤**嵌在原生流程里的场景（AI 教学 / 问诊等）：
+ * 原生题型能收到宿主的回合事件，H5 题型也应该能。宿主只负责把事实发下来，
+ * 怎么响应（放开作答、复位重做、演完反馈再收尾）由 H5 自己决定。
+ *
+ * 线格式：`{ type: 'agent', action, payload: { iid, ... } }`
+ */
+export const agentEvents = {
+    /** 作答权交回给用户（宿主的开场播报已结束）。 */
+    startLearn: 'start_learn',
+    /** 本题重做。 */
+    retryLearn: 'retry_learn',
+    /** 本题判过；若宿主把收尾交给了 H5，H5 需回发一次收尾动作，否则流程不推进。 */
+    passLearn: 'pass_learn',
+    /** 用户**绕过这块 H5** 上行了一次作答（原生输入栏、原生选择器等）。 */
+    externalAnswer: 'external_answer',
+};
+/** 只订阅传了 handler 的那几个事件；返回的函数一次性退订。 */
+export function bindAgentProtocol(handlers, transport = bridge) {
+    const pairs = [
+        [agentEvents.startLearn, handlers.startLearn],
+        [agentEvents.retryLearn, handlers.retryLearn],
+        [agentEvents.passLearn, handlers.passLearn],
+        [agentEvents.externalAnswer, handlers.externalAnswer],
+    ];
+    const subscriptions = pairs
+        .filter(([, handler]) => handler !== undefined)
+        .map(([action, handler]) => transport.on(bridgeMessageTypes.agent, action, (message) => {
+        handler(message.payload ?? {}, message);
+    }));
+    return () => subscriptions.forEach((unsubscribe) => unsubscribe());
+}
 //# sourceMappingURL=content-protocol.js.map

package/dist/src/content-protocol.js.map

@@ -1 +1 @@
-{"version":3,"file":"content-protocol.js","sourceRoot":"","sources":["../../src/content-protocol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAwC,MAAM,cAAc,CAAC;AAE5E,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,aAAa;IAC1B,KAAK,EAAE,OAAO;CACN,CAAC;AAEX,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;CACV,CAAC;AAwCX,MAAM,UAAU,kBAAkB,CAChC,QAA2B,EAC3B,YAA+B,MAAM;IAErC,MAAM,aAAa,GAAG;QACpB,SAAS,CAAC,EAAE,CAAC,kBAAkB,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,EAAE,CAAC,OAAwC,EAAE,EAAE;YACtG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACzC,CAAC,CAAC;QACF,SAAS,CAAC,EAAE,CAAC,kBAAkB,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,EAAE,CAAC,OAAwC,EAAE,EAAE;YACzG,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC,CAAC;QACF,SAAS,CAAC,EAAE,CAAC,kBAAkB,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE;YACvE,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC,CAAC;KACH,CAAC;IAEF,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,KAAK,CAAC,UAAmC,EAAE;QACzC,OAAO,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,CAAC,UAAmC,EAAE;QAC3C,OAAO,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAChF,CAAC;CACO,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,IAAI,CAAI,MAAc,EAAE,OAA8B;QACpD,OAAO,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACtE,CAAC;CACO,CAAC;AAEX,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM,CAAC,OAA2B;QAChC,OAAO,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;CACO,CAAC"}
+{"version":3,"file":"content-protocol.js","sourceRoot":"","sources":["../../src/content-protocol.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -8,12 +8,14 @@
  * 所有 API 从此入口统一导出，消费者无需感知内部目录结构。
  */
 export { bridge, MrpBridge } from './mrp-bridge';
-export type { BridgeMessage, MessageHandler, Unsubscribe, } 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 type { SystemModule, ModuleAllowedResult, AvailableModulesResult, ContainerInfoResult, ArAdaptationInfo, SafeAreaInsets, } from './system-module';
+export { ar, getArScale, getSafeArea, initArAdaptation, onArAdaptationChange, } from './adaptation';
+export type { ArAdaptationListener } from './adaptation';
 export * from '../generated/index';
 export { lifecycle } from './lifecycle';
 export type { RouteChangedPayload, AppMountedPayload } from './lifecycle';
-export { bindRenderProtocol, bridgeError, bridgeMessageTypes, interaction, renderActions, renderProtocol, } from './content-protocol';
-export type { BridgeErrorPayload, InteractionPayload, ProtocolTransport, RenderHandlers, RenderPayload, } from './content-protocol';
+export { agentEvents, bindAgentProtocol, bindRenderProtocol, bridgeError, bridgeMessageTypes, interaction, renderActions, renderProtocol, } from './content-protocol';
+export type { AgentEventHandlers, AgentEventPayload, BridgeErrorPayload, ExternalAnswerPayload, InteractionPayload, ProtocolTransport, RenderHandlers, RenderPayload, } from './content-protocol';
 //# sourceMappingURL=index.d.ts.map

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,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;AAG1E,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,cAAc,GACf,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,aAAa,GACd,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,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

@@ -11,10 +11,12 @@
 export { bridge, MrpBridge } from './mrp-bridge';
 // 内置系统模块类型 + 工厂函数（容器核心契约）
 export { getSystemModule } from './system-module';
+// App/H5 统一屏幕适配
+export { ar, getArScale, getSafeArea, initArAdaptation, onArAdaptationChange, } from './adaptation';
 // Generated 模块：类型 + 工厂函数
 export * from '../generated/index';
 // 生命周期上报工具
 export { lifecycle } from './lifecycle';
 // 标准内容渲染、交互与错误协议
-export { bindRenderProtocol, bridgeError, bridgeMessageTypes, interaction, renderActions, renderProtocol, } from './content-protocol';
+export { agentEvents, bindAgentProtocol, bindRenderProtocol, bridgeError, bridgeMessageTypes, interaction, renderActions, renderProtocol, } from './content-protocol';
 //# sourceMappingURL=index.js.map

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;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;AAGxC,iBAAiB;AACjB,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,cAAc,GACf,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,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/system-module.d.ts

@@ -29,8 +29,25 @@ export interface ContainerInfoResult {
     packageId: string | null;
     registeredModules: string[];
     allowedModules: string[] | null;
+    adaptation?: ArAdaptationInfo;
     [key: string]: unknown;
 }
+/** App 与 H5 共用的 `.ar` 屏幕适配信息。 */
+export interface ArAdaptationInfo {
+    designLongSide: number;
+    screenWidth: number;
+    screenHeight: number;
+    scale: number;
+    /** 设备安全区（逻辑像素）。WebView 里 `env(safe-area-inset-*)` 常常拿不到，改由 App 注入。 */
+    safeArea?: SafeAreaInsets;
+}
+/** 设备四边的安全区尺寸，单位与 screenWidth/screenHeight 一致。 */
+export interface SafeAreaInsets {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+}
 /**
  * 容器内置系统模块接口。
  *

package/dist/src/system-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-module.d.ts","sourceRoot":"","sources":["../../src/system-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAQH,0BAA0B;AAC1B,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,8BAA8B;AAC9B,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,2BAA2B;AAC3B,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,eAAe,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC7E,yBAAyB;IACzB,mBAAmB,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACvD,cAAc;IACd,gBAAgB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAClD;AAMD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAE9C"}
+{"version":3,"file":"system-module.d.ts","sourceRoot":"","sources":["../../src/system-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAQH,0BAA0B;AAC1B,MAAM,WAAW,mBAAmB;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,8BAA8B;AAC9B,MAAM,WAAW,sBAAsB;IACtC,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,2BAA2B;AAC3B,MAAM,WAAW,mBAAmB;IACnC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAChC,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,kDAAkD;AAClD,MAAM,WAAW,cAAc;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACd;AAMD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC5B,qBAAqB;IACrB,eAAe,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAC7E,yBAAyB;IACzB,mBAAmB,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACvD,cAAc;IACd,gBAAgB,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACjD;AAMD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAE9C"}

package/dist/src/system-module.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-module.js","sourceRoot":"","sources":["../../src/system-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AA4CtC,+DAA+D;AAC/D,OAAO;AACP,+DAA+D;AAE/D;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,MAAM,CAAC,MAAM,CAAe,QAAQ,CAAC,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"system-module.js","sourceRoot":"","sources":["../../src/system-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AA+DtC,+DAA+D;AAC/D,OAAO;AACP,+DAA+D;AAE/D;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe;IAC9B,OAAO,MAAM,CAAC,MAAM,CAAe,QAAQ,CAAC,CAAC;AAC9C,CAAC"}

package/generated/data_provider.ts

@@ -0,0 +1,17 @@
+// ============================================================
+// 手动维护：与 Flutter 端 NlDataProviderModule 对齐。
+// Flutter 源：athena-xingqiu/lib/h5/modules/nl_data_provider_module.dart
+// ============================================================
+
+/** 页面预置数据模块 */
+export interface DataProvider {
+    /**
+     * 获取 App 预置的当前页面数据。
+     *
+     * App 端在加载 H5 前通过 `NlDataProviderModule.setPageData(data)` 预置，
+     * H5 通过本方法获取，不需要 key，永远只有一份当前页面数据。
+     *
+     * 返回类型由业务方自行约定；没有预置数据时返回 `null`。
+     */
+    getPageData<T = unknown>(): Promise<T | null>;
+}

package/generated/index.ts

@@ -8,11 +8,26 @@ import type { AiTutor } from './ai_tutor';
 import type { Audio } from './audio';
 import type { Device } from './device';
 import type { User } from './user';
+import type { SoundEffects } from './sound_effects';
+import type { TtsPlayer } from './tts_player';
+import type { DataProvider } from './data_provider';
+import type { MessageRead } from './message_read';
 
 export type { AiTutor } from './ai_tutor';
 export type { Audio } from './audio';
 export type { Device } from './device';
 export type { User } from './user';
+export type { SoundEffects, SoundId } from './sound_effects';
+export type {
+  TtsPlayer,
+  TtsKind,
+  TtsAccent,
+  TtsPreset,
+  TtsVoiceArgs,
+  TtsSupportedVoices,
+} from './tts_player';
+export type { DataProvider } from './data_provider';
+export type { MessageRead, MarkReadResult } from './message_read';
 
 // ============================================================
 // 工厂函数（适用于任何上下文）
@@ -38,3 +53,22 @@ export function getUser(): User {
   return bridge.module<User>('user');
 }
 
+/** 获取 soundEffects 的类型安全代理 */
+export function getSoundEffects(): SoundEffects {
+  return bridge.module<SoundEffects>('soundEffects');
+}
+
+/** 获取 ttsPlayer 的类型安全代理 */
+export function getTtsPlayer(): TtsPlayer {
+  return bridge.module<TtsPlayer>('ttsPlayer');
+}
+
+/** 获取 dataProvider 的类型安全代理 */
+export function getDataProvider(): DataProvider {
+  return bridge.module<DataProvider>('dataProvider');
+}
+
+/** 获取 messageRead 的类型安全代理 */
+export function getMessageRead(): MessageRead {
+  return bridge.module<MessageRead>('messageRead');
+}

package/generated/message_read.ts

@@ -0,0 +1,21 @@
+// ============================================================
+// 手动维护：与 Flutter 端 NlMessageReadModule 对齐。
+// Flutter 源：athena-xingqiu/lib/h5/modules/nl_data_provider_module.dart
+// ============================================================
+
+/** 消息已读上报模块返回值 */
+export interface MarkReadResult {
+    success: boolean;
+    errorMessage?: string;
+}
+
+/** 消息已读上报模块 */
+export interface MessageRead {
+    /**
+     * 将指定消息标记为已读。
+     *
+     * 用于首页 webView 弹窗卡片：H5 通过 `getPageData()` 拿到 `messageId`，
+     * 在合适的时机（如"看完"）调用本方法，由 H5 业务方决定何时算已读。
+     */
+    markRead(args: { messageId: number }): Promise<MarkReadResult>;
+}

package/generated/sound_effects.ts

@@ -0,0 +1,69 @@
+// ============================================================
+// 手动维护：与 Flutter 端 NlSoundEffectsModule 对齐。
+// Flutter 源：athena-xingqiu/lib/h5/modules/nl_sound_effects_module.dart
+// ============================================================
+
+/** 支持的音效 ID 枚举（与 Flutter 端 _supportedSoundIds 保持一致） */
+export type SoundId =
+  | 'bubbleRight'
+  | 'bubbleWrong'
+  | 'right1'
+  | 'right2'
+  | 'error1'
+  | 'error2'
+  | 'errorTip'
+  | 'successTip'
+  | 'writing'
+  | 'recording'
+  | 'pageTurning'
+  | 'coinDrop'
+  | 'countDown'
+  | 'hangUp'
+  | 'magicUsing'
+  | 'magicStar'
+  | 'giftProps'
+  | 'chuxian'
+  | 'du'
+  | 'saHua'
+  | 'starDown'
+  | 'bubbleAppear'
+  | 'flyAway'
+  | 'letPlay'
+  | 'letPractice'
+  | 'letWatch'
+  | 'good'
+  | 'great'
+  | 'excellent'
+  | 'awesome'
+  | 'cool'
+  | 'fantastic'
+  | 'comboFrenzy'
+  | 'appear'
+  | 'wxConnect'
+  | 'homeBg'
+  | 'summary'
+  | 'transition'
+  | 'baoxiangDown'
+  | 'baoxiangOpen'
+  | 'gemAddVoice'
+  | 'oneStar'
+  | 'twoStar';
+
+/** 内置音效播放模块 */
+export interface SoundEffects {
+  /** 按 soundId 播放内置音效 */
+  play(args: {
+    soundId: SoundId;
+    /** 是否等待播放完成再 resolve（仅部分音效支持） */
+    waitForCompletion?: boolean;
+  }): Promise<{ success: boolean; soundId: string }>;
+
+  /** 获取当前支持的 soundId 列表 */
+  supportedSounds(): Promise<string[]>;
+
+  /** 停止微信连接循环音效 */
+  stopWxConnect(): Promise<{ success: boolean }>;
+
+  /** 停止首页背景音乐 */
+  stopHomeBg(): Promise<{ success: boolean }>;
+}

package/generated/tts_player.ts

@@ -0,0 +1,84 @@
+// ============================================================
+// 手动维护：与 Flutter 端 NlTtsPlayerModule 对齐。
+// Flutter 源：athena-xingqiu/lib/h5/modules/nl_tts_player_module.dart
+// ============================================================
+
+/** TTS 请求类型 */
+export type TtsKind = 'sentence' | 'word' | 'tutor';
+
+/** 口音简写 */
+export type TtsAccent = 'uk' | 'us';
+
+/** 预设语色速写（对应 Flutter 端 _presets） */
+export type TtsPreset =
+  | 'sentence-default'
+  | 'word-default'
+  | 'sara-cheerful'
+  | 'paige-supportive'
+  | 'libby-uk'
+  | 'nativeMentor-us';
+
+/** 公共语色参数，play 与 getUrl 共享 */
+export interface TtsVoiceArgs {
+  text: string;
+  kind?: TtsKind;
+  accent?: TtsAccent;
+  /** 指定 tutorId（白名单内），优先级高于 accent */
+  tutorId?: string;
+  /** 语气，如 newscast / cheerful / Supportive */
+  voiceStyle?: string;
+  /** 底层发音类型，如 BV503_streaming */
+  voiceType?: string;
+  /** 语速，如 '-20%' / '+10%' */
+  voiceRate?: string;
+  /** 仅 sentence 有效：是否按断句处理 */
+  isBreak?: 0 | 1;
+  /** 语色预设名 */
+  preset?: TtsPreset;
+}
+
+/** supportedVoices() 返回值 */
+export interface TtsSupportedVoices {
+  kinds: TtsKind[];
+  tutors: string[];
+  styles: string[];
+  types: string[];
+  presets: TtsPreset[];
+}
+
+/** 文本朗读（TTS）播放模块：传入文本由 App 原生链路请求 TTS 并播放 */
+export interface TtsPlayer {
+  /**
+   * 请求 TTS 音频并原生播放。
+   *
+   * 校验失败时 resolve `{ success:false, error, field }`，不会抛异常。
+   * 新一次 `play` 会自动打断本模块上一段音频。
+   */
+  play(args: TtsVoiceArgs & {
+    /** 是否等待播放完成再 resolve */
+    waitForCompletion?: boolean;
+  }): Promise<{
+    success: boolean;
+    /** 错误标识：noStudent / invalidText / invalidKind / invalidVoice / invalidPreset 等 */
+    error?: string;
+    /** 校验失败时指向的字段名（如 tutorId） */
+    field?: string;
+  }>;
+
+  /** 停止本模块当前播放的音频（不影响音效/录音等其他音频） */
+  stop(): Promise<{ success: boolean }>;
+
+  /** 暂停本模块当前播放的音频 */
+  pause(): Promise<{ success: boolean }>;
+
+  /**
+   * 仅请求 TTS 音频 URL，不播放。适用于 H5 希望自己用 `<audio>` 控制进度/波形的场景。
+   */
+  getUrl(args: TtsVoiceArgs): Promise<{
+    /** 可直接给 `<audio>` 播放的 URL */
+    url: string;
+  }>;
+
+  /** 查询当前支持的 kind / tutorId / voiceStyle / voiceType / preset 白名单 */
+  supportedVoices(): Promise<TtsSupportedVoices>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dino-dev/bridge-core-ts",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "Bridge Core SDK for h5_app_container — H5 ↔ Flutter 通信 + 原生模块类型安全调用（零框架依赖）",
   "type": "module",
   "main": "dist/src/index.js",
@@ -23,6 +23,7 @@
   "scripts": {
     "build": "tsc",
     "prepublishOnly": "npm run build",
+    "release": "npm publish --registry https://registry.npmjs.org",
     "dev": "tsc --watch",
     "clean": "rm -rf dist"
   },
@@ -41,4 +42,4 @@
     "url": "https://github.com/nengli/h5_app_container",
     "directory": "packages/bridge_core_ts"
   }
-}
+}

package/src/adaptation.ts

@@ -0,0 +1,83 @@
+/**
+ * 与 Flutter `.ar` 相同的屏幕适配工具。
+ *
+ * App 端以 812 作为设计稿最长边基准，将 adaptation 注入 system 模块。
+ */
+
+import {
+	getSystemModule,
+	type ArAdaptationInfo,
+	type SafeAreaInsets,
+} from './system-module';
+import { bridge, type Unsubscribe } from './mrp-bridge';
+
+const ZERO_SAFE_AREA: SafeAreaInsets = { top: 0, bottom: 0, left: 0, right: 0 };
+
+let currentScale = 1;
+let currentSafeArea: SafeAreaInsets = ZERO_SAFE_AREA;
+let bridgeUnsubscribe: Unsubscribe | null = null;
+const listeners = new Set<ArAdaptationListener>();
+
+export type ArAdaptationListener = (adaptation: ArAdaptationInfo) => void;
+
+function applyAdaptation(
+	adaptation: ArAdaptationInfo | null | undefined,
+): ArAdaptationInfo | null {
+	if (
+		!adaptation ||
+		!Number.isFinite(adaptation.scale) ||
+		adaptation.scale <= 0
+	) {
+		currentScale = 1;
+		currentSafeArea = ZERO_SAFE_AREA;
+		return null;
+	}
+	currentScale = adaptation.scale;
+	currentSafeArea = adaptation.safeArea ?? ZERO_SAFE_AREA;
+	for (const listener of listeners) {
+		listener(adaptation);
+	}
+	return adaptation;
+}
+
+function ensureAdaptationListener(): void {
+	if (bridgeUnsubscribe) return;
+	bridgeUnsubscribe = bridge.on<ArAdaptationInfo>(
+		'adaptation',
+		'changed',
+		(message) => {
+			applyAdaptation(message.payload);
+		},
+	);
+}
+
+/** 从容器读取初始适配信息，并注册横竖屏变化监听。 */
+export async function initArAdaptation(): Promise<ArAdaptationInfo | null> {
+	ensureAdaptationListener();
+	const info = await getSystemModule().getContainerInfo();
+	return applyAdaptation(info?.adaptation);
+}
+
+/** 将设计稿尺寸转换为当前 App 屏幕尺寸。 */
+export function ar(value: number): number {
+	return value * currentScale;
+}
+
+/** 获取当前适配比例，便于 Canvas 或自定义渲染使用。 */
+export function getArScale(): number {
+	return currentScale;
+}
+
+/** 获取 App 注入的设备安全区；不在容器内或 App 未注入时返回全 0。 */
+export function getSafeArea(): SafeAreaInsets {
+	return currentSafeArea;
+}
+
+/** 监听 App 横竖屏或窗口尺寸变化，返回取消监听函数。 */
+export function onArAdaptationChange(
+	listener: ArAdaptationListener,
+): Unsubscribe {
+	ensureAdaptationListener();
+	listeners.add(listener);
+	return () => listeners.delete(listener);
+}

package/src/content-protocol.ts

@@ -4,6 +4,8 @@ export const bridgeMessageTypes = {
   render: 'render',
   interaction: 'interaction',
   error: 'error',
+  /** 宿主镜像给 H5 的回合事件（单向：宿主 → H5）。 */
+  agent: 'agent',
 } as const;
 
 export const renderActions = {
@@ -26,7 +28,7 @@ export interface RenderHandlers<T = unknown> {
 }
 
 export interface InteractionPayload<T = unknown> {
-  sourceId: string;
+  source_id: string;
   value?: T;
   [key: string]: unknown;
 }
@@ -91,4 +93,69 @@ export const bridgeError = {
   report(payload: BridgeErrorPayload): Promise<unknown> {
     return bridge.send(bridgeMessageTypes.error, 'report', payload);
   },
-} as const;
+} as const;
+
+/**
+ * 回合事件协议：宿主把「现在轮到谁、这一轮发生了什么」镜像给 H5。
+ *
+ * 用在 H5 页面**作为一个交互步骤**嵌在原生流程里的场景（AI 教学 / 问诊等）：
+ * 原生题型能收到宿主的回合事件，H5 题型也应该能。宿主只负责把事实发下来，
+ * 怎么响应（放开作答、复位重做、演完反馈再收尾）由 H5 自己决定。
+ *
+ * 线格式：`{ type: 'agent', action, payload: { iid, ... } }`
+ */
+export const agentEvents = {
+  /** 作答权交回给用户（宿主的开场播报已结束）。 */
+  startLearn: 'start_learn',
+  /** 本题重做。 */
+  retryLearn: 'retry_learn',
+  /** 本题判过；若宿主把收尾交给了 H5，H5 需回发一次收尾动作，否则流程不推进。 */
+  passLearn: 'pass_learn',
+  /** 用户**绕过这块 H5** 上行了一次作答（原生输入栏、原生选择器等）。 */
+  externalAnswer: 'external_answer',
+} as const;
+
+export interface AgentEventPayload {
+  /**
+   * 这条事件属于哪一屏。
+   *
+   * 内容（`render/set`）和事件通常来自宿主上游的两条独立消息，到达先后不保证。
+   * 拿它对齐「这条事件说的是不是我现在这一屏」，不匹配就先扣着。
+   */
+  iid?: string;
+  [key: string]: unknown;
+}
+
+export interface ExternalAnswerPayload extends AgentEventPayload {
+  /** 那次绕过本页的上行负载（形态由宿主定义）。 */
+  answer?: Record<string, unknown>;
+}
+
+export interface AgentEventHandlers {
+  startLearn?(payload: AgentEventPayload, message: BridgeMessage<AgentEventPayload>): void;
+  retryLearn?(payload: AgentEventPayload, message: BridgeMessage<AgentEventPayload>): void;
+  passLearn?(payload: AgentEventPayload, message: BridgeMessage<AgentEventPayload>): void;
+  externalAnswer?(payload: ExternalAnswerPayload, message: BridgeMessage<ExternalAnswerPayload>): void;
+}
+
+/** 只订阅传了 handler 的那几个事件；返回的函数一次性退订。 */
+export function bindAgentProtocol(
+  handlers: AgentEventHandlers,
+  transport: Pick<ProtocolTransport, 'on'> = bridge,
+): Unsubscribe {
+  const pairs: Array<[string, ((payload: never, message: never) => void) | undefined]> = [
+    [agentEvents.startLearn, handlers.startLearn],
+    [agentEvents.retryLearn, handlers.retryLearn],
+    [agentEvents.passLearn, handlers.passLearn],
+    [agentEvents.externalAnswer, handlers.externalAnswer],
+  ];
+  const subscriptions = pairs
+    .filter(([, handler]) => handler !== undefined)
+    .map(([action, handler]) =>
+      transport.on(bridgeMessageTypes.agent, action, (message: BridgeMessage<any>) => {
+        (handler as (payload: unknown, message: unknown) => void)(message.payload ?? {}, message);
+      }),
+    );
+
+  return () => subscriptions.forEach((unsubscribe) => unsubscribe());
+}

package/src/index.ts

@@ -10,21 +10,29 @@
 
 // 核心 Bridge
 export { bridge, MrpBridge } from './mrp-bridge';
-export type {
-  BridgeMessage,
-  MessageHandler,
-  Unsubscribe,
-} from './mrp-bridge';
+export type { BridgeMessage, MessageHandler, Unsubscribe } from './mrp-bridge';
 
 // 内置系统模块类型 + 工厂函数（容器核心契约）
 export { getSystemModule } from './system-module';
 export type {
-  SystemModule,
-  ModuleAllowedResult,
-  AvailableModulesResult,
-  ContainerInfoResult,
+	SystemModule,
+	ModuleAllowedResult,
+	AvailableModulesResult,
+	ContainerInfoResult,
+	ArAdaptationInfo,
+	SafeAreaInsets,
 } from './system-module';
 
+// App/H5 统一屏幕适配
+export {
+	ar,
+	getArScale,
+	getSafeArea,
+	initArAdaptation,
+	onArAdaptationChange,
+} from './adaptation';
+export type { ArAdaptationListener } from './adaptation';
+
 // Generated 模块：类型 + 工厂函数
 export * from '../generated/index';
 
@@ -34,17 +42,22 @@ export type { RouteChangedPayload, AppMountedPayload } from './lifecycle';
 
 // 标准内容渲染、交互与错误协议
 export {
-  bindRenderProtocol,
-  bridgeError,
-  bridgeMessageTypes,
-  interaction,
-  renderActions,
-  renderProtocol,
+	agentEvents,
+	bindAgentProtocol,
+	bindRenderProtocol,
+	bridgeError,
+	bridgeMessageTypes,
+	interaction,
+	renderActions,
+	renderProtocol,
 } from './content-protocol';
 export type {
-  BridgeErrorPayload,
-  InteractionPayload,
-  ProtocolTransport,
-  RenderHandlers,
-  RenderPayload,
+	AgentEventHandlers,
+	AgentEventPayload,
+	BridgeErrorPayload,
+	ExternalAnswerPayload,
+	InteractionPayload,
+	ProtocolTransport,
+	RenderHandlers,
+	RenderPayload,
 } from './content-protocol';

package/src/system-module.ts

@@ -23,22 +23,41 @@ import { bridge } from './mrp-bridge';
 
 /** isModuleAllowed 返回值 */
 export interface ModuleAllowedResult {
-  allowed: boolean;
-  namespace: string;
-  error?: string;
+	allowed: boolean;
+	namespace: string;
+	error?: string;
 }
 
 /** getAvailableModules 返回值 */
 export interface AvailableModulesResult {
-  modules: string[];
+	modules: string[];
 }
 
 /** getContainerInfo 返回值 */
 export interface ContainerInfoResult {
-  packageId: string | null;
-  registeredModules: string[];
-  allowedModules: string[] | null;
-  [key: string]: unknown;
+	packageId: string | null;
+	registeredModules: string[];
+	allowedModules: string[] | null;
+	adaptation?: ArAdaptationInfo;
+	[key: string]: unknown;
+}
+
+/** App 与 H5 共用的 `.ar` 屏幕适配信息。 */
+export interface ArAdaptationInfo {
+	designLongSide: number;
+	screenWidth: number;
+	screenHeight: number;
+	scale: number;
+	/** 设备安全区（逻辑像素）。WebView 里 `env(safe-area-inset-*)` 常常拿不到，改由 App 注入。 */
+	safeArea?: SafeAreaInsets;
+}
+
+/** 设备四边的安全区尺寸，单位与 screenWidth/screenHeight 一致。 */
+export interface SafeAreaInsets {
+	top: number;
+	bottom: number;
+	left: number;
+	right: number;
 }
 
 // ============================================================
@@ -51,12 +70,12 @@ export interface ContainerInfoResult {
  * 提供模块权限查询、可用模块列表、容器元信息获取等能力。
  */
 export interface SystemModule {
-  /** 查询指定模块是否被当前包授权 */
-  isModuleAllowed(params: { namespace: string }): Promise<ModuleAllowedResult>;
-  /** 获取当前包可用的所有模块命名空间列表 */
-  getAvailableModules(): Promise<AvailableModulesResult>;
-  /** 获取容器元信息 */
-  getContainerInfo(): Promise<ContainerInfoResult>;
+	/** 查询指定模块是否被当前包授权 */
+	isModuleAllowed(params: { namespace: string }): Promise<ModuleAllowedResult>;
+	/** 获取当前包可用的所有模块命名空间列表 */
+	getAvailableModules(): Promise<AvailableModulesResult>;
+	/** 获取容器元信息 */
+	getContainerInfo(): Promise<ContainerInfoResult>;
 }
 
 // ============================================================
@@ -73,5 +92,5 @@ export interface SystemModule {
  * ```
  */
 export function getSystemModule(): SystemModule {
-  return bridge.module<SystemModule>('system');
+	return bridge.module<SystemModule>('system');
 }