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

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,17 @@
+/**
+ * 与 Flutter `.ar` 相同的屏幕适配工具。
+ *
+ * App 端以 812 作为设计稿最长边基准，将 adaptation 注入 system 模块。
+ */
+import { type ArAdaptationInfo } 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 横竖屏或窗口尺寸变化，返回取消监听函数。 */
+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,EAAmB,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAU,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAMxD,MAAM,MAAM,oBAAoB,GAAG,CAAC,UAAU,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAqB1E,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,kCAAkC;AAClC,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,WAAW,CAIhF"}

package/dist/src/adaptation.js

@@ -0,0 +1,49 @@
+/**
+ * 与 Flutter `.ar` 相同的屏幕适配工具。
+ *
+ * App 端以 812 作为设计稿最长边基准，将 adaptation 注入 system 模块。
+ */
+import { getSystemModule } from './system-module';
+import { bridge } from './mrp-bridge';
+let currentScale = 1;
+let bridgeUnsubscribe = null;
+const listeners = new Set();
+function applyAdaptation(adaptation) {
+    if (!adaptation || !Number.isFinite(adaptation.scale) || adaptation.scale <= 0) {
+        currentScale = 1;
+        return null;
+    }
+    currentScale = adaptation.scale;
+    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 横竖屏或窗口尺寸变化，返回取消监听函数。 */
+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,EAAE,eAAe,EAAyB,MAAM,iBAAiB,CAAC;AACzE,OAAO,EAAE,MAAM,EAAoB,MAAM,cAAc,CAAC;AAExD,IAAI,YAAY,GAAG,CAAC,CAAC;AACrB,IAAI,iBAAiB,GAAuB,IAAI,CAAC;AACjD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAwB,CAAC;AAIlD,SAAS,eAAe,CAAC,UAA+C;IACtE,IAAI,CAAC,UAAU,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;QAC/E,YAAY,GAAG,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,YAAY,GAAG,UAAU,CAAC,KAAK,CAAC;IAChC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,wBAAwB;IAC/B,IAAI,iBAAiB;QAAE,OAAO;IAC9B,iBAAiB,GAAG,MAAM,CAAC,EAAE,CAAmB,YAAY,EAAE,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE;QACnF,eAAe,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,8BAA8B;AAC9B,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,wBAAwB,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,MAAM,eAAe,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACxD,OAAO,eAAe,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AAC3C,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,EAAE,CAAC,KAAa;IAC9B,OAAO,KAAK,GAAG,YAAY,CAAC;AAC9B,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,UAAU;IACxB,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,oBAAoB,CAAC,QAA8B;IACjE,wBAAwB,EAAE,CAAC;IAC3B,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxB,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC1C,CAAC"}

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

@@ -21,7 +21,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;
 }

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":"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,SAAS,EAAE,MAAM,CAAC;IAClB,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"}

package/dist/src/index.d.ts

@@ -10,7 +10,9 @@
 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 type { SystemModule, ModuleAllowedResult, AvailableModulesResult, ContainerInfoResult, ArAdaptationInfo, } from './system-module';
+export { ar, getArScale, initArAdaptation, onArAdaptationChange } from './adaptation';
+export type { ArAdaptationListener } from './adaptation';
 export * from '../generated/index';
 export { lifecycle } from './lifecycle';
 export type { RouteChangedPayload, AppMountedPayload } from './lifecycle';

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,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,EACnB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACtF,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,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"}

package/dist/src/index.js

@@ -11,6 +11,8 @@
 export { bridge, MrpBridge } from './mrp-bridge';
 // 内置系统模块类型 + 工厂函数（容器核心契约）
 export { getSystemModule } from './system-module';
+// App/H5 统一屏幕适配
+export { ar, getArScale, initArAdaptation, onArAdaptationChange } from './adaptation';
 // Generated 模块：类型 + 工厂函数
 export * from '../generated/index';
 // 生命周期上报工具

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;AAOjD,0BAA0B;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AASlD,gBAAgB;AAChB,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGtF,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"}

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

@@ -29,8 +29,16 @@ 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;
+}
 /**
  * 容器内置系统模块接口。
  *

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;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,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,iCAAiC;AACjC,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;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"}

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;AAqDtC,+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"}

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.3",
   "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,57 @@
+/**
+ * 与 Flutter `.ar` 相同的屏幕适配工具。
+ *
+ * App 端以 812 作为设计稿最长边基准，将 adaptation 注入 system 模块。
+ */
+
+import { getSystemModule, type ArAdaptationInfo } from './system-module';
+import { bridge, type Unsubscribe } from './mrp-bridge';
+
+let currentScale = 1;
+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;
+    return null;
+  }
+  currentScale = adaptation.scale;
+  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 横竖屏或窗口尺寸变化，返回取消监听函数。 */
+export function onArAdaptationChange(listener: ArAdaptationListener): Unsubscribe {
+  ensureAdaptationListener();
+  listeners.add(listener);
+  return () => listeners.delete(listener);
+}

package/src/content-protocol.ts

@@ -26,7 +26,7 @@ export interface RenderHandlers<T = unknown> {
 }
 
 export interface InteractionPayload<T = unknown> {
-  sourceId: string;
+  source_id: string;
   value?: T;
   [key: string]: unknown;
 }

package/src/index.ts

@@ -23,8 +23,13 @@ export type {
   ModuleAllowedResult,
   AvailableModulesResult,
   ContainerInfoResult,
+  ArAdaptationInfo,
 } from './system-module';
 
+// App/H5 统一屏幕适配
+export { ar, getArScale, initArAdaptation, onArAdaptationChange } from './adaptation';
+export type { ArAdaptationListener } from './adaptation';
+
 // Generated 模块：类型 + 工厂函数
 export * from '../generated/index';
 

package/src/system-module.ts

@@ -38,9 +38,18 @@ 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;
+}
+
 // ============================================================
 // System 模块接口
 // ============================================================