@spatialwalk/avatarkit 1.0.0-beta.3 → 1.0.0-beta.4

package/dist/config/app-config.d.ts

@@ -2,19 +2,12 @@ export declare const APP_CONFIG: {
     testEnv: boolean;
     readonly debug: boolean;
     rendering: {
-        backgroundColor: [number, number, number, number];
         /**
          * 排序模式
          * - 'balance': 性能优先，首帧排序后复用（默认）
          * - 'quality': 质量优先，每帧重新排序
          */
         sortMode: "balance" | "quality";
-        /**
-         * 背景显示模式
-         * - 'cover': 保持宽高比，覆盖整个画布（默认）
-         * - 'stretch': 拉伸填充整个画布
-         */
-        backgroundMode: "cover" | "stretch";
     };
     camera: {
         position: [number, number, number];
@@ -26,6 +19,9 @@ export declare const APP_CONFIG: {
     animation: {
         fps: number;
     };
+    audio: {
+        sampleRate: number;
+    };
     avatar: {
         baseAssetsPath: string;
         wasmPath: string;

package/dist/config/app-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-config.d.ts","sourceRoot":"","sources":["../../config/app-config.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU;;;;yBAQc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;QAEjE;;;;WAIG;kBACoB,SAAS,GAAG,SAAS;QAE5C;;;;WAIG;wBACwB,OAAO,GAAG,SAAS;;;kBAIZ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;gBACrC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;kBA4BxB,OAAO,GAAG,SAAS;;;;CAI3C,CAAA"}
+{"version":3,"file":"app-config.d.ts","sourceRoot":"","sources":["../../config/app-config.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU;;;;QAQnB;;;;WAIG;kBACoB,SAAS,GAAG,SAAS;;;kBAIV,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;gBACrC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;kBAgCxB,OAAO,GAAG,SAAS;;;;CAI3C,CAAA"}

package/dist/config/constants.d.ts

@@ -1,6 +1,22 @@
-export declare const POSTHOG_HOST = "https://i.spatialwalk.ai";
-export declare const POSTHOG_API_KEY = "phc_TjwCYlnJCUMGPYAKePPxoRrCdMGsN8AQqprhWhCIShe";
-export declare const POSTHOG_TRACK_EVENTS: boolean;
+import { Environment } from '../types';
+export declare const CLS_TRACK_EVENTS: boolean;
+/**
+ * 获取 CLS 配置（需要传入环境）
+ */
+export declare function getCLSConfig(environment: Environment): {
+    endpoint: string;
+    topicId: string;
+    secretId: string;
+    secretKey: string;
+    token: string;
+};
+export declare const CLS_CONFIG: {
+    endpoint: string;
+    topicId: string;
+    secretId: string;
+    secretKey: string;
+    token: string;
+};
 export declare const ENV_TEST: boolean;
 /**
  * Comprehensive debug mode check

package/dist/config/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../config/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY,6BAA6B,CAAA;AACtD,eAAO,MAAM,eAAe,oDAAoD,CAAA;AAChF,eAAO,MAAM,oBAAoB,SAAuD,CAAA;AACxF,eAAO,MAAM,QAAQ,SAAsG,CAAA;AAa3H;;;;;;GAMG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAErC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../config/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAGtC,eAAO,MAAM,gBAAgB,SAAmD,CAAA;AA6ChF;;GAEG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,WAAW;;;;;;EAQpD;AAGD,eAAO,MAAM,UAAU;;;;;;CAMtB,CAAA;AAED,eAAO,MAAM,QAAQ,SAAsG,CAAA;AAa3H;;;;;;GAMG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAErC"}

package/dist/core/AvatarController.d.ts

@@ -1,50 +1,47 @@
 import { Flame } from '../generated/driveningress/v1/driveningress';
 import { Avatar } from './Avatar';
 import { AnimationPlayer } from '../audio/AnimationPlayer';
-import { AvatarState, ConnectionState } from '../types';
+import { AvatarState, ConnectionState, AvatarPlaybackMode } from '../types';
 export declare class AvatarController {
+    private networkLayer?;
+    readonly playbackMode: AvatarPlaybackMode;
     protected avatar: Avatar;
-    protected isConnected: boolean;
-    protected isMuted: boolean;
-    protected currentState: AvatarState;
     protected animationPlayer: AnimationPlayer | null;
     protected currentKeyframes: Flame[];
-    protected transitionKeyframes: Flame[];
-    protected currentReqId: string | null;
+    protected pendingAudioChunks: Array<{
+        data: Uint8Array;
+        isLast: boolean;
+    }>;
     protected isPlaying: boolean;
-    private hasSentEnd;
+    protected isConnected: boolean;
+    protected currentState: AvatarState;
     onConnectionState: ((state: ConnectionState) => void) | null;
     onAvatarState: ((state: AvatarState) => void) | null;
     onError: ((error: Error) => void) | null;
     private eventListeners;
-    private wsClient;
-    private pendingAudioChunks;
-    constructor(avatar: Avatar);
-    /**
-     * 启动服务
-     */
-    start(): Promise<void>;
+    private renderCallback?;
+    private transitionCompleteCallback?;
+    private playbackLoopId;
+    private lastRenderedFrameIndex;
+    constructor(avatar: Avatar, options?: {
+        playbackMode?: AvatarPlaybackMode;
+    });
     /**
-     * 发送音频数据
+     * 获取 Avatar ID（供 NetworkLayer 使用）
      */
-    send(audioData: ArrayBuffer, end?: boolean): void;
+    getAvatarId(): string;
     /**
-     * 发送文字消息（Animation Only 模式不支持文字输入）
+     * 获取播放状态（供 NetworkLayer 使用）
      */
-    sendText(_text: string): void;
+    getIsPlaying(): boolean;
     /**
-     * 打断当前对话
+     * 设置连接状态（供 NetworkLayer 使用）
      */
-    interrupt(): void;
+    setConnected(connected: boolean): void;
     /**
-     * 关闭服务（断开连接）
-     */
-    close(): void;
-    /**
-     * 静音切换
+     * 获取连接状态
      */
-    get mute(): boolean;
-    set mute(value: boolean);
+    get connected(): boolean;
     /**
      * 获取当前状态
      */
@@ -55,71 +52,101 @@ export declare class AvatarController {
      */
     getAnimationPlayer(): AnimationPlayer | null;
     /**
-     * 提供给视图层读取的过渡关键帧（Idle->Speaking），独立于主序列
+     * 启动服务（仅网络模式）
      */
-    protected getTransitionKeyframes(): Flame[];
+    start(): Promise<void>;
     /**
-     * 获取连接状态
+     * 发送音频到服务器（仅网络模式）
+     * 同时缓存到数据层用于播放
      */
-    get connected(): boolean;
+    send(audioData: ArrayBuffer, end?: boolean): void;
     /**
-     * 为 AvatarView 提供注册内部事件的接口
-     * @internal
+     * 关闭服务（仅网络模式）
      */
-    setupInternalEventListeners(callbacks: {
-        onKeyframesUpdate?: (keyframes: Flame[]) => void;
-        onStartRendering?: () => void;
-        onStopRendering?: () => void;
-    }): void;
+    close(): void;
     /**
-     * 初始化播放器和客户端
+     * 开始播放（外部数据模式）
+     * 必须先调用此方法，传入初始数据开始播放
      */
-    protected initializePlayers(): Promise<void>;
+    play(initialAudioChunks?: Array<{
+        data: Uint8Array;
+        isLast: boolean;
+    }>, initialKeyframes?: Flame[]): Promise<void>;
     /**
-     * 清理播放器和客户端
+     * 发送音频数据（外部数据模式）
+     * 在 play() 之后流式添加剩余音频数据
      */
-    protected cleanupPlayers(): void;
+    sendAudioChunk(data: Uint8Array, isLast?: boolean): void;
     /**
-     * 停止播放
+     * 发送动画关键帧（外部数据模式或网络模式）
+     * 在 play() 之后流式添加剩余动画数据
      */
-    protected stopPlayback(): void;
+    sendKeyframes(keyframes: Flame[]): void;
     /**
-     * 开始播放音频和动画
+     * 打断当前播放
      */
-    protected startPlayback(): Promise<void>;
+    interrupt(): void;
     /**
-     * 注册内部事件监听器（仅供内部使用）
+     * 清理所有数据和资源
      */
-    private registerEventListener;
+    clear(): void;
     /**
-     * 触发内部事件（仅供内部使用）
+     * 开始流式播放（内部方法，由 NetworkLayer 或 play() 调用）
      */
-    private emit;
+    startStreamingPlayback(): Promise<void>;
     /**
-     * 处理接收到的消息
+     * 设置渲染回调（由 AvatarView 调用）
      */
-    private handleMessage;
+    setRenderCallback(callback: (splatData: Float32Array, frameIndex: number) => void): void;
     /**
-     * 处理动画消息（从服务器接收）
+     * 设置过渡完成回调（由 AvatarView 调用）
      */
-    private handleAnimationMessage;
+    setTransitionCompleteCallback(callback: () => void): void;
     /**
-     * 开始流式播放（准备播放器、添加音频数据、开始播放动画）
+     * 过渡完成通知（由 AvatarView 调用）
+     */
+    onTransitionComplete(): void;
+    /**
+     * 为 AvatarView 提供注册内部事件的接口
+     * @internal
      */
-    private startStreamingPlayback;
+    setupInternalEventListeners(callbacks: {
+        onKeyframesUpdate?: (keyframes: Flame[]) => void;
+        onStartRendering?: () => void;
+        onStopRendering?: () => void;
+        onInterrupt?: () => void;
+    }): void;
     /**
-     * 开始同步播放（用户音频 + 动画）
-     * 注意：流式模式下，这个方法由 startStreamingPlayback() 调用
+     * 开始流式播放（内部实现）
      */
-    private startSynchronizedPlayback;
+    private startStreamingPlaybackInternal;
     /**
-     * 将 PCM 数据转换为 WAV Blob URL
-     * 注意：流式模式下不再需要此方法，保留用于兼容性
+     * 播放循环：根据音频时间计算动画帧，通知渲染层渲染
      */
-    private createAudioBlobURL;
+    private startPlaybackLoop;
+    /**
+     * 停止播放循环
+     */
+    private stopPlaybackLoop;
+    /**
+     * 停止播放
+     */
+    protected stopPlayback(): void;
+    /**
+     * 清理播放器
+     */
+    protected cleanupPlayers(): void;
+    /**
+     * 添加音频块到缓冲区
+     */
+    private addAudioChunkToBuffer;
+    /**
+     * 事件系统
+     */
+    private registerEventListener;
     /**
-     * 设置 WebSocket 事件监听器
+     * 触发事件
      */
-    private setupWebSocketListeners;
+    protected emit(event: string, data?: any): void;
 }
 //# sourceMappingURL=AvatarController.d.ts.map

package/dist/core/AvatarController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AvatarController.d.ts","sourceRoot":"","sources":["../../core/AvatarController.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"AvatarController.d.ts","sourceRoot":"","sources":["../../core/AvatarController.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6CAA6C,CAAA;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAItC,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,eAAe,EAAiB,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAK1F,qBAAa,gBAAgB;IAE3B,OAAO,CAAC,YAAY,CAAC,CAAc;IACnC,SAAgB,YAAY,EAAE,kBAAkB,CAAA;IAChD,SAAS,CAAC,MAAM,EAAE,MAAM,CAAA;IAGxB,SAAS,CAAC,eAAe,EAAE,eAAe,GAAG,IAAI,CAAO;IACxD,SAAS,CAAC,gBAAgB,EAAE,KAAK,EAAE,CAAK;IACxC,SAAS,CAAC,kBAAkB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAK;IAC/E,SAAS,CAAC,SAAS,UAAQ;IAG3B,SAAS,CAAC,WAAW,UAAQ;IAC7B,SAAS,CAAC,YAAY,EAAE,WAAW,CAAmB;IAG/C,iBAAiB,EAAE,CAAC,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC,GAAG,IAAI,CAAO;IACnE,aAAa,EAAE,CAAC,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC,GAAG,IAAI,CAAO;IAC3D,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,CAAO;IACtD,OAAO,CAAC,cAAc,CAA+C;IAGrE,OAAO,CAAC,cAAc,CAAC,CAAuD;IAC9E,OAAO,CAAC,0BAA0B,CAAC,CAAY;IAG/C,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,sBAAsB,CAAa;gBAE/B,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,kBAAkB,CAAA;KAAE;IAY3E;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,YAAY,IAAI,OAAO;IAIvB;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IAItC;;OAEG;IACH,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,WAAW,CAEvB;IAED;;;OAGG;IACI,kBAAkB,IAAI,eAAe,GAAG,IAAI;IAMnD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8B5B;;;OAGG;IACH,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,GAAE,OAAe,GAAG,IAAI;IAmBxD;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;;OAGG;IACG,IAAI,CACR,kBAAkB,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,EACjE,gBAAgB,CAAC,EAAE,KAAK,EAAE,GACzB,OAAO,CAAC,IAAI,CAAC;IAwChB;;;OAGG;IACH,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,GAAE,OAAe,GAAG,IAAI;IAa/D;;;OAGG;IACH,aAAa,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,IAAI;IAWvC;;OAEG;IACH,SAAS,IAAI,IAAI;IAajB;;OAEG;IACH,KAAK,IAAI,IAAI;IAcb;;OAEG;IACH,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvC;;OAEG;IACH,iBAAiB,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAIxF;;OAEG;IACH,6BAA6B,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAIzD;;OAEG;IACH,oBAAoB,IAAI,IAAI;IAQ5B;;;OAGG;IACI,2BAA2B,CAAC,SAAS,EAAE;QAC5C,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,IAAI,CAAA;QAChD,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAA;QAC7B,eAAe,CAAC,EAAE,MAAM,IAAI,CAAA;QAC5B,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;KACzB,GAAG,IAAI;IAiBR;;OAEG;YACW,8BAA8B;IA8D5C;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuEzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACH,SAAS,CAAC,YAAY,IAAI,IAAI;IAY9B;;OAEG;IACH,SAAS,CAAC,cAAc,IAAI,IAAI;IAOhC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;OAEG;IACH,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;CAMhD"}

package/dist/core/AvatarDownloader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AvatarDownloader.d.ts","sourceRoot":"","sources":["../../core/AvatarDownloader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAOpE,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,KAAK,gBAAgB,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAA;AAEpD,UAAU,iBAAiB;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAA;CAC3B;AAED,UAAU,cAAc;IACtB,UAAU,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAChC,aAAa,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACnC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7B,QAAQ,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC/B;AAED,UAAU,mBAAmB;IAC3B,KAAK,EAAE,WAAW,CAAA;IAClB,UAAU,EAAE,WAAW,CAAA;IACvB,aAAa,CAAC,EAAE,WAAW,CAAA;IAC3B,aAAa,CAAC,EAAE,WAAW,CAAA;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,iBAAiB,EAAE,iBAAiB,CAAA;IACpC,aAAa,EAAE,mBAAmB,CAAA;IAClC,qBAAqB,CAAC,EAAE,qBAAqB,CAAA;IAC7C,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;CACtC;AAkCD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,eAAe,CAA0B;gBAErC,cAAc,SAAM;IAKhC;;;OAGG;IACG,qBAAqB,CACzB,cAAc,CAAC,EAAE,cAAc,EAC/B,gBAAgB,GAAE,gBAAgB,GAAG,IAAW,GAC/C,OAAO,CAAC,iBAAiB,CAAC;IAuE7B;;;OAGG;YACW,wBAAwB;IA6DtC;;OAEG;IACG,kBAAkB,CAAC,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC;IAwBlG;;OAEG;IACG,iBAAiB,CACrB,aAAa,EAAE,aAAa,EAC5B,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAA;KAAE,GAChF,OAAO,CAAC,mBAAmB,CAAC;IAmG/B;;OAEG;IACG,gBAAgB,CACpB,aAAa,EAAE,aAAa,EAC5B,OAAO,CAAC,EAAE;QACR,aAAa,CAAC,EAAE,OAAO,CAAA;QACvB,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAA;KAC3C,GACA,OAAO,CAAC,aAAa,CAAC;IAkCzB;;OAEG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIvD;;OAEG;IACH,KAAK;IAML;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA+BxB;;;OAGG;IACH,OAAO,CAAC,eAAe;IA+BvB;;;;;OAKG;IACG,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAqBpE"}
+{"version":3,"file":"AvatarDownloader.d.ts","sourceRoot":"","sources":["../../core/AvatarDownloader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAC9E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAOpE,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,KAAK,gBAAgB,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAA;AAEpD,UAAU,iBAAiB;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,CAAA;CAC3B;AAED,UAAU,cAAc;IACtB,UAAU,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAChC,aAAa,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACnC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7B,QAAQ,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC/B;AAED,UAAU,mBAAmB;IAC3B,KAAK,EAAE,WAAW,CAAA;IAClB,UAAU,EAAE,WAAW,CAAA;IACvB,aAAa,CAAC,EAAE,WAAW,CAAA;IAC3B,aAAa,CAAC,EAAE,WAAW,CAAA;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,iBAAiB,EAAE,iBAAiB,CAAA;IACpC,aAAa,EAAE,mBAAmB,CAAA;IAClC,qBAAqB,CAAC,EAAE,qBAAqB,CAAA;IAC7C,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;CACtC;AAkCD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,eAAe,CAA0B;gBAErC,cAAc,SAAM;IAKhC;;;OAGG;IACG,qBAAqB,CACzB,cAAc,CAAC,EAAE,cAAc,EAC/B,gBAAgB,GAAE,gBAAgB,GAAG,IAAW,GAC/C,OAAO,CAAC,iBAAiB,CAAC;IAuE7B;;;OAGG;YACW,wBAAwB;IA6DtC;;OAEG;IACG,kBAAkB,CAAC,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC;IAwBlG;;OAEG;IACG,iBAAiB,CACrB,aAAa,EAAE,aAAa,EAC5B,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAA;KAAE,GAChF,OAAO,CAAC,mBAAmB,CAAC;IA+G/B;;OAEG;IACG,gBAAgB,CACpB,aAAa,EAAE,aAAa,EAC5B,OAAO,CAAC,EAAE;QACR,aAAa,CAAC,EAAE,OAAO,CAAA;QACvB,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAA;KAC3C,GACA,OAAO,CAAC,aAAa,CAAC;IAkCzB;;OAEG;IACH,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIvD;;OAEG;IACH,KAAK;IAML;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA+BxB;;;OAGG;IACH,OAAO,CAAC,eAAe;IA+BvB;;;;;OAKG;IACG,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CA0BpE"}

package/dist/core/AvatarKit.d.ts

@@ -8,6 +8,7 @@ export declare class AvatarKit {
     private static readonly _version;
     private static _avatarCore;
     private static _dynamicSdkConfig;
+    private static readonly _logLevels;
     /**
      * SDK 初始化
      * @param appId 前端需要在 HTTP Headers 和 WebSocket Headers 中都带上
@@ -56,5 +57,10 @@ export declare class AvatarKit {
         realtimeWsUrl: string;
         driveningressWsUrl: string;
     };
+    /**
+     * 统一的 Telemetry 日志接口，对齐 iOS 版本的 SPAvatarSDK.log
+     * 使用腾讯云 CLS 进行日志上报
+     */
+    static logEvent(event: string, level?: 'debug' | 'info' | 'warning' | 'error', contents?: Record<string, unknown>): void;
 }
 //# sourceMappingURL=AvatarKit.d.ts.map

package/dist/core/AvatarKit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AvatarKit.d.ts","sourceRoot":"","sources":["../../core/AvatarKit.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAK7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAE7D,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,cAAc,CAAQ;IACrC,OAAO,CAAC,MAAM,CAAC,cAAc,CAA6B;IAC1D,OAAO,CAAC,MAAM,CAAC,aAAa,CAAsB;IAClD,OAAO,CAAC,MAAM,CAAC,OAAO,CAAsB;IAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAA6E;IAC7G,OAAO,CAAC,MAAM,CAAC,WAAW,CAAiC;IAC3D,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAoD;IAEpF;;;;OAIG;WACU,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCnF;;OAEG;mBACkB,oBAAoB;IA2CzC;;;;OAIG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI3C;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKtC,MAAM,KAAK,aAAa,IAAI,OAAO,CAElC;IAED,MAAM,KAAK,aAAa,IAAI,aAAa,GAAG,IAAI,CAE/C;IAED,MAAM,KAAK,YAAY,IAAI,MAAM,GAAG,IAAI,CAEvC;IAED,MAAM,KAAK,MAAM,IAAI,MAAM,GAAG,IAAI,CAEjC;IAED,MAAM,KAAK,OAAO,IAAI,MAAM,CAE3B;IAED;;;OAGG;IACH,MAAM,CAAC,aAAa,IAAI,iBAAiB,GAAG,IAAI;IAIhD;;OAEG;IACH,MAAM,CAAC,OAAO,IAAI,IAAI;IA0BtB;;OAEG;mBACkB,eAAe;IAUpC;;OAEG;IACH,MAAM,CAAC,oBAAoB,IAAI;QAC7B,aAAa,EAAE,MAAM,CAAA;QACrB,kBAAkB,EAAE,MAAM,CAAA;QAC1B,aAAa,EAAE,MAAM,CAAA;QACrB,kBAAkB,EAAE,MAAM,CAAA;KAC3B;CA0CF"}
+{"version":3,"file":"AvatarKit.d.ts","sourceRoot":"","sources":["../../core/AvatarKit.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAM7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAE7D,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAC,cAAc,CAAQ;IACrC,OAAO,CAAC,MAAM,CAAC,cAAc,CAA6B;IAC1D,OAAO,CAAC,MAAM,CAAC,aAAa,CAAsB;IAClD,OAAO,CAAC,MAAM,CAAC,OAAO,CAAsB;IAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAA6E;IAC7G,OAAO,CAAC,MAAM,CAAC,WAAW,CAAiC;IAC3D,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAoD;IACpF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAKxB;IAEV;;;;OAIG;WACU,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IA2CnF;;OAEG;mBACkB,oBAAoB;IA2CzC;;;;OAIG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI3C;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKtC,MAAM,KAAK,aAAa,IAAI,OAAO,CAElC;IAED,MAAM,KAAK,aAAa,IAAI,aAAa,GAAG,IAAI,CAE/C;IAED,MAAM,KAAK,YAAY,IAAI,MAAM,GAAG,IAAI,CAEvC;IAED,MAAM,KAAK,MAAM,IAAI,MAAM,GAAG,IAAI,CAEjC;IAED,MAAM,KAAK,OAAO,IAAI,MAAM,CAE3B;IAED;;;OAGG;IACH,MAAM,CAAC,aAAa,IAAI,iBAAiB,GAAG,IAAI;IAIhD;;OAEG;IACH,MAAM,CAAC,OAAO,IAAI,IAAI;IA2BtB;;OAEG;mBACkB,eAAe;IAcpC;;OAEG;IACH,MAAM,CAAC,oBAAoB,IAAI;QAC7B,aAAa,EAAE,MAAM,CAAA;QACrB,kBAAkB,EAAE,MAAM,CAAA;QAC1B,aAAa,EAAE,MAAM,CAAA;QACrB,kBAAkB,EAAE,MAAM,CAAA;KAC3B;IA2CD;;;OAGG;IACH,MAAM,CAAC,QAAQ,CACb,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAgB,EACtD,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,IAAI;CAgBR"}

package/dist/core/AvatarManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AvatarManager.d.ts","sourceRoot":"","sources":["../../core/AvatarManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAIhD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAIjC,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,SAAS,CAA6B;IACrD,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,oBAAoB,CAAiB;IAE7C;;OAEG;IACH,MAAM,KAAK,MAAM,IAAI,aAAa,CAKjC;IAED;;;;;;OAMG;IACG,IAAI,CACR,EAAE,EAAE,MAAM,EACV,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,EACjD,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,GACtC,OAAO,CAAC,MAAM,CAAC;IAsElB;;OAEG;IACH,UAAU,IAAI,IAAI;CAKnB"}
+{"version":3,"file":"AvatarManager.d.ts","sourceRoot":"","sources":["../../core/AvatarManager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA;AAIhD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAIjC,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,SAAS,CAA6B;IACrD,OAAO,CAAC,gBAAgB,CAAgC;IACxD,OAAO,CAAC,oBAAoB,CAAiB;IAE7C;;OAEG;IACH,MAAM,KAAK,MAAM,IAAI,aAAa,CAKjC;IAED;;;;;;OAMG;IACG,IAAI,CACR,EAAE,EAAE,MAAM,EACV,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,EACjD,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,GACtC,OAAO,CAAC,MAAM,CAAC;IAiFlB;;OAEG;IACH,UAAU,IAAI,IAAI;CAKnB"}

package/dist/core/AvatarView.d.ts

@@ -1,10 +1,10 @@
-import { CameraConfig, RenderPerformanceStats } from '../types';
+import { CameraConfig, RenderPerformanceStats, AvatarViewOptions, AvatarPlaybackMode } from '../types';
 import { Avatar } from './Avatar';
 import { AvatarController } from './AvatarController';
 export declare class AvatarView {
-    readonly avatarController: AvatarController;
-    backgroundImage: string | null;
-    backgroundOpaque: boolean;
+    private readonly avatarController;
+    readonly playbackMode: AvatarPlaybackMode;
+    private readonly avatar;
     private canvas;
     private renderSystem;
     private isInitialized;
@@ -12,7 +12,6 @@ export declare class AvatarView {
     private isRealtimePlaying;
     private currentKeyframes;
     private lastRenderedFrameIndex;
-    private realtimeStartTime;
     private lastRealtimeProtoFrame;
     private idleResumeIndexPending;
     private idleAnimationLoopId;
@@ -44,9 +43,13 @@ export declare class AvatarView {
     private getCachedIdleFirstFrame;
     /**
      * 构造函数
-     * 使用 AvatarController（纯动画驱动模式）
+     * 创建统一的 AvatarController，内部根据配置自动组合网络层
      */
-    constructor(avatar: Avatar, canvasContainer?: HTMLElement);
+    constructor(avatar: Avatar, options?: AvatarViewOptions);
+    /**
+     * 获取控制器（公共接口）
+     */
+    get controller(): AvatarController;
     /**
      * 创建canvas元素
      */
@@ -68,9 +71,13 @@ export declare class AvatarView {
      */
     private getDefaultCameraConfig;
     /**
-     * 根据 PreloadCameraSettings 转换为 CameraConfig
+     * 根据资源解析最终的相机配置，优先使用角色设置，其次 camera.json
+     */
+    private resolveCameraConfig;
+    /**
+     * 从角色设置中推导相机配置
      */
-    private convertPreloadCameraToConfig;
+    private deriveCameraConfigFromSettings;
     /**
      * 渲染第一帧
      */
@@ -96,35 +103,33 @@ export declare class AvatarView {
      */
     private stopAllAnimationLoops;
     /**
-     * 渲染实时对话帧
+     * 渲染实时帧（由播放层回调调用）
      */
     private renderRealtimeFrame;
+    /**
+     * 过渡完成回调（通知播放层启动音频）
+     */
+    private onTransitionComplete;
+    /**
+     * 处理打断
+     */
+    private handleInterrupt;
     /**
      * 设置 AvatarController 事件监听器
      */
     private setupControllerEventListeners;
     /**
-     * 设置当前关键帧数据
+     * 准备实时渲染（生成 Idle -> Speaking 过渡）
      */
-    private setCurrentKeyframes;
+    private prepareRealtimeRendering;
     /**
-     * 开始实时对话渲染
+     * 开始实时渲染循环
      */
     private startRealtimeRendering;
     /**
      * 停止实时对话渲染
      */
     private stopRealtimeRendering;
-    /**
-     * 设置背景图
-     * 支持开发者来设置渲染数字人背景图
-     */
-    setBackgroundImage(imageUrl: string | null): void;
-    /**
-     * 设置背景是否不透明
-     * 支持开发者来设置是否背景不透明
-     */
-    setBackgroundOpaque(opaque: boolean): void;
     /**
      * 清理视图资源
      * 关闭 avatarController 并清理所有相关资源
@@ -147,12 +152,5 @@ export declare class AvatarView {
      * @returns 渲染性能统计数据，如果渲染系统未初始化则返回 null
      */
     getPerformanceStats(): RenderPerformanceStats | null;
-    /**
-     * 将 CameraInfo 转换为 CameraConfig
-     */
-    /**
-     * 设置 canvas 的 CSS 背景（与 app 对齐）
-     */
-    private setCanvasBackground;
 }
 //# sourceMappingURL=AvatarView.d.ts.map

package/dist/core/AvatarView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AvatarView.d.ts","sourceRoot":"","sources":["../../core/AvatarView.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAEpE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAQtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAErD,qBAAa,UAAU;IACrB,SAAgB,gBAAgB,EAAE,gBAAgB,CAAA;IAC3C,eAAe,EAAE,MAAM,GAAG,IAAI,CAAO;IACrC,gBAAgB,EAAE,OAAO,CAAQ;IAGxC,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,aAAa,CAAiB;IACtC,OAAO,CAAC,YAAY,CAA4B;IAGhD,OAAO,CAAC,iBAAiB,CAAiB;IAC1C,OAAO,CAAC,gBAAgB,CAAc;IACtC,OAAO,CAAC,sBAAsB,CAAa;IAC3C,OAAO,CAAC,iBAAiB,CAAY;IACrC,OAAO,CAAC,sBAAsB,CAAqB;IACnD,OAAO,CAAC,sBAAsB,CAAsB;IAGpD,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,uBAAuB,CAAsB;IACrD,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,cAAc,CAA4B;IAGlD,OAAO,CAAC,mBAAmB,CAAc;IACzC,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,mBAAmB,CAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAc;IACnD,OAAO,CAAC,wBAAwB,CAAiB;IACjD,OAAO,CAAC,oBAAoB,CAAqB;IACjD,OAAO,CAAC,qBAAqB,CAAY;IAEzC;;OAEG;IACH,OAAO,CAAC,cAAc;IA8BtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;IACH,OAAO,CAAC,gCAAgC;IAoBxC;;OAEG;YACW,uBAAuB;IAgBrC;;;OAGG;gBAED,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,WAAW;IAe/B;;OAEG;IACH,OAAO,CAAC,YAAY;IA4DpB;;OAEG;IACH,SAAS,IAAI,iBAAiB;IAI9B;;OAEG;YACW,cAAc;IAsD5B;;OAEG;YACW,sBAAsB;IA0BpC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAK9B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAoBpC;;OAEG;YACW,gBAAgB;IAsC9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAsE9B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAqFlC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IASjC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAO7B;;OAEG;YACW,mBAAmB;IAwFjC;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAcrC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAmD9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAwC7B;;;OAGG;IACH,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAIjD;;;OAGG;IACH,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAI1C;;;OAGG;IACH,OAAO,IAAI,IAAI;IAgDf;;OAEG;IACH,eAAe,IAAI,YAAY,GAAG,IAAI;IAItC;;OAEG;IACH,kBAAkB,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI;IAapD;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;;OAGG;IACH,mBAAmB,IAAI,sBAAsB,GAAG,IAAI;IAapD;;OAEG;IACH;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAkB5B"}
+{"version":3,"file":"AvatarView.d.ts","sourceRoot":"","sources":["../../core/AvatarView.ts"],"names":[],"mappings":"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"}

package/dist/core/NetworkLayer.d.ts

@@ -0,0 +1,59 @@
+import { AvatarController } from './AvatarController';
+export declare class NetworkLayer {
+    private wsClient;
+    private dataController;
+    private currentReqId;
+    private hasSentEnd;
+    private readonly audioBytesPerSecond;
+    private audioMetrics;
+    constructor(dataController: AvatarController);
+    /**
+     * 连接服务
+     */
+    connect(characterId: string): Promise<void>;
+    /**
+     * 发送音频数据到服务器
+     */
+    sendAudioData(audioData: ArrayBuffer, isLast: boolean): void;
+    /**
+     * 断开连接
+     */
+    disconnect(): void;
+    /**
+     * 获取当前请求ID
+     */
+    getCurrentReqId(): string | null;
+    /**
+     * 重置请求ID（用于打断后清理）
+     */
+    resetReqId(): void;
+    /**
+     * 设置 WebSocket 事件监听器
+     */
+    private setupWebSocketListeners;
+    /**
+     * 处理接收到的消息
+     */
+    private handleMessage;
+    /**
+     * 处理动画消息
+     */
+    private handleAnimationMessage;
+    /**
+     * 处理错误消息
+     */
+    private handleErrorMessage;
+    /**
+     * 创建音频指标
+     */
+    private createAudioMetrics;
+    /**
+     * 重置音频指标
+     */
+    private resetAudioMetrics;
+    /**
+     * 上报音频指标
+     */
+    private reportAudioMetrics;
+}
+//# sourceMappingURL=NetworkLayer.d.ts.map

package/dist/core/NetworkLayer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NetworkLayer.d.ts","sourceRoot":"","sources":["../../core/NetworkLayer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAsB1D,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAkC;IACtE,OAAO,CAAC,YAAY,CAA0C;gBAElD,cAAc,EAAE,gBAAgB;IAgB5C;;OAEG;IACG,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjD;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAyE5D;;OAEG;IACH,UAAU,IAAI,IAAI;IAMlB;;OAEG;IACH,eAAe,IAAI,MAAM,GAAG,IAAI;IAIhC;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA2C/B;;OAEG;IACH,OAAO,CAAC,aAAa;IAwBrB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAiD9B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA4C1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAc3B"}