@spatialwalk/avatarkit 1.0.0-beta.2 → 1.0.0-beta.21

package/dist/index.d.ts

@@ -1,7 +1,6 @@
 /**
  * SPAvatar SDK - 统一公开接口
  */
-export { APP_CONFIG } from './config/app-config';
 export { Avatar } from './core/Avatar';
 export { AvatarController } from './core/AvatarController';
 export { AvatarKit } from './core/AvatarKit';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAE1D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAG9C,cAAc,SAAS,CAAA;AAGvB,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAE1D,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAG9C,cAAc,SAAS,CAAA;AAGvB,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA"}

package/dist/index.js

@@ -1,19 +1,18 @@
-import { A as s, a as o, b as e, c as t, d as n, f as A, e as v, C as l, E as c, L as g, R as i, S as u, g as C, h as M, i as P } from "./index-CNhquYUE.js";
+import { b as e, c as s, a as t, d as o, h as v, g as n, f as i, C as A, D as c, E as S, L as d, R as g, S as l, i as C } from "./index-ChKhyUK4.js";
 export {
-  s as APP_CONFIG,
-  o as Avatar,
-  e as AvatarController,
+  e as Avatar,
+  s as AvatarController,
   t as AvatarKit,
-  n as AvatarManager,
-  A as AvatarState,
-  v as AvatarView,
-  l as ConnectionState,
-  c as Environment,
-  g as LoadProgress,
-  i as ResourceType,
-  u as SPAvatarError,
-  C as extractResourceUrls,
-  M as hasMonologue,
-  P as hasMonologueFromModelInfo
+  o as AvatarManager,
+  v as AvatarPlaybackMode,
+  n as AvatarState,
+  i as AvatarView,
+  A as ConnectionState,
+  c as DrivingServiceMode,
+  S as Environment,
+  d as LoadProgress,
+  g as ResourceType,
+  l as SPAvatarError,
+  C as extractResourceUrls
 };
 //# sourceMappingURL=index.js.map

package/dist/renderer/RenderSystem.d.ts

@@ -1,77 +1,10 @@
-import { CameraConfig } from '../types';
-import { RenderBackend } from './renderer';
-export interface RenderSystemOptions {
-    canvas: HTMLCanvasElement;
-    preferBackend?: RenderBackend;
-    backgroundColor?: [number, number, number, number];
-    camera?: CameraConfig;
-}
-export declare class RenderSystem {
-    private renderer;
-    private backend;
-    private canvas;
-    private options;
-    private camera;
-    private viewMatrix;
-    private projectionMatrix;
-    private originalPackedData;
-    renderTime: number;
-    sortTime: number;
-    constructor(options: RenderSystemOptions);
-    /**
-     * 初始化渲染系统
-     */
-    initialize(): Promise<void>;
-    /**
-     * 加载已打包的 Splat 数据（零拷贝，GPU 格式）
-     * 直接接收 WASM 的 packed 数据
-     *
-     * @param packedData Float32Array [pos3, color4, cov6] x N 个点
-     */
-    loadSplatsFromPackedData(packedData: Float32Array): void;
-    /**
-     * 渲染一帧
-     */
-    renderFrame(): void;
-    /**
-     * 更新相机参数
-     */
-    updateCamera(params: Partial<CameraConfig>): void;
-    /**
-     * 处理窗口大小变化
-     */
-    handleResize(): void;
-    /**
-     * 获取当前使用的后端
-     */
-    getBackend(): RenderBackend | null;
-    /**
-     * 清理资源
-     */
-    dispose(): void;
-    /**
-     * 检查 WebGPU 支持
-     */
-    private checkWebGPUSupport;
-    /**
-     * 更新相机长宽比
-     */
-    private updateCameraAspect;
-    /**
-     * 更新相机矩阵
-     */
-    private updateCameraMatrices;
-    /**
-     * 获取相机前向向量
-     */
-    private getCameraForward;
-    /**
-     * 更新透视投影矩阵（复用缓冲区）
-     */
-    private updatePerspectiveMatrix;
-    /**
-     * 更新视图矩阵 (Look At，复用缓冲区)
-     */
-    private updateLookAtMatrix;
-}
+/**
+ * Render System - Unified WebGL/WebGPU rendering management
+ *
+ * Responsibilities:
+ * 1. Automatically select rendering backend (WebGPU preferred, fallback to WebGL)
+ * 2. Camera management
+ * 3. Matrix calculations
+ */
+export {};
 //# sourceMappingURL=RenderSystem.d.ts.map

package/dist/renderer/RenderSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RenderSystem.d.ts","sourceRoot":"","sources":["../../renderer/RenderSystem.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAC5C,OAAO,KAAK,EAAiB,aAAa,EAAE,MAAM,YAAY,CAAA;AAQ9D,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,iBAAiB,CAAA;IACzB,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAClD,MAAM,CAAC,EAAE,YAAY,CAAA;CACtB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,OAAO,CAAqB;IAGpC,OAAO,CAAC,MAAM,CAGb;IAGD,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,gBAAgB,CAAuB;IAG/C,OAAO,CAAC,kBAAkB,CAA4B;IAG/C,UAAU,SAAI;IACd,QAAQ,SAAI;gBAEP,OAAO,EAAE,mBAAmB;IAoBxC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BjC;;;;;OAKG;IACH,wBAAwB,CAAC,UAAU,EAAE,YAAY,GAAG,IAAI;IAQxD;;OAEG;IACH,WAAW,IAAI,IAAI;IAwCnB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAKjD;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,UAAU,IAAI,aAAa,GAAG,IAAI;IAIlC;;OAEG;IACH,OAAO,IAAI,IAAI;IAOf;;OAEG;YACW,kBAAkB;IAYhC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAe5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmBxB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA4B/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAoD3B"}
+{"version":3,"file":"RenderSystem.d.ts","sourceRoot":"","sources":["../../renderer/RenderSystem.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/renderer/webgl/reorderData.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reorderData.d.ts","sourceRoot":"","sources":["../../../renderer/webgl/reorderData.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,YAAY,EACxB,SAAS,EAAE,WAAW,GACrB,YAAY,CAqBd"}
+{"version":3,"file":"reorderData.d.ts","sourceRoot":"","sources":["../../../renderer/webgl/reorderData.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,YAAY,EACxB,SAAS,EAAE,WAAW,GACrB,YAAY,CAwBd"}

package/dist/renderer/webgl/webglRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webglRenderer.d.ts","sourceRoot":"","sources":["../../../renderer/webgl/webglRenderer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAMhD,qBAAa,aAAc,YAAW,aAAa;IACjD,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,EAAE,CAA+B;IACzC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,gBAAgB,CAA6C;IACrE,OAAO,CAAC,kBAAkB,CAAwB;IAElD,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,OAAO,CAAC,WAAW,CAA+B;IAElD,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,eAAe,CAAQ;gBAEnB,MAAM,EAAE,iBAAiB,EAAE,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAqBzF;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAqCjC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAwB5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAcvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAsB9B;;;;;;;OAOG;IACH,wBAAwB,CAAC,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,WAAW;IAW/F;;OAEG;IACH,OAAO,CAAC,WAAW;IAkBnB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA4E7B;;OAEG;IACH,MAAM,CACJ,UAAU,EAAE,YAAY,EACxB,gBAAgB,EAAE,YAAY,EAC9B,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IA6B9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA2D3B;;OAEG;IACH,OAAO;CA+BR"}
+{"version":3,"file":"webglRenderer.d.ts","sourceRoot":"","sources":["../../../renderer/webgl/webglRenderer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAMhD,qBAAa,aAAc,YAAW,aAAa;IACjD,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,EAAE,CAA+B;IACzC,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,gBAAgB,CAA6C;IACrE,OAAO,CAAC,kBAAkB,CAAwB;IAElD,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,gBAAgB,CAAoB;IAC5C,OAAO,CAAC,WAAW,CAA+B;IAElD,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,eAAe,CAAQ;gBAEnB,MAAM,EAAE,iBAAiB,EAAE,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAqBzF;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAqCjC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAwB5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAcvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAsB9B;;;;;;;OAOG;IACH,wBAAwB,CAAC,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,WAAW;IAW/F;;OAEG;IACH,OAAO,CAAC,WAAW;IAkBnB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA4E7B;;OAEG;IACH,MAAM,CACJ,UAAU,EAAE,YAAY,EACxB,gBAAgB,EAAE,YAAY,EAC9B,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IA6B9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA2D3B;;OAEG;IACH,OAAO;CAiCR"}

package/dist/types/character.d.ts

@@ -18,8 +18,6 @@ export type PreloadCameraSettings = PreloadResources<{
 export declare enum ResourceType {
     CAMERA = "camera",
     ANIMATION_IDLE = "frameIdle",
-    ANIMATION_MONO = "frameMono",
-    AUDIO_MONO = "audioMono",
     MODEL_SHAPE = "shape",
     MODEL_GS = "gsStandard"
 }
@@ -27,13 +25,4 @@ export declare enum ResourceType {
  * 提取所有资源 URL
  */
 export declare function extractResourceUrls(meta: CharacterMeta): Record<ResourceType, string | null>;
-/**
- * 检查角色是否有完整的独白资源
- */
-export declare function hasMonologue(meta: CharacterMeta): boolean;
-/**
- * 从 RealtimeCharacter 的 modelInfo JSON 中解析是否有独白
- * modelInfo 是一个 JSON 字符串，包含角色的模型信息
- */
-export declare function hasMonologueFromModelInfo(modelInfo: string): boolean;
 //# sourceMappingURL=character.d.ts.map

package/dist/types/character.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"character.d.ts","sourceRoot":"","sources":["../../types/character.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAA;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAE7E;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG;IAC3C,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;CACtC,CAAA;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI;IAChC,OAAO,EAAE,MAAM,CAAA;CAChB,GAAG,CAAC,CAAA;AAEL,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,CAAC;IAAE,MAAM,EAAE,cAAc,CAAA;CAAE,CAAC,CAAA;AAEhF;;GAEG;AACH,oBAAY,YAAY;IACtB,MAAM,WAAW;IACjB,cAAc,cAAc;IAC5B,cAAc,cAAc;IAC5B,UAAU,cAAc;IACxB,WAAW,UAAU;IACrB,QAAQ,eAAe;CACxB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC,CAS5F;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAEzD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAYpE"}
+{"version":3,"file":"character.d.ts","sourceRoot":"","sources":["../../types/character.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAA;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAE7E;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,cAAc,GAAG;IAC3C,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;CACtC,CAAA;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI;IAChC,OAAO,EAAE,MAAM,CAAA;CAChB,GAAG,CAAC,CAAA;AAEL,MAAM,MAAM,qBAAqB,GAAG,gBAAgB,CAAC;IAAE,MAAM,EAAE,cAAc,CAAA;CAAE,CAAC,CAAA;AAEhF;;GAEG;AACH,oBAAY,YAAY;IACtB,MAAM,WAAW;IACjB,cAAc,cAAc;IAC5B,WAAW,UAAU;IACrB,QAAQ,eAAe;CACxB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC,CAO5F"}

package/dist/types/index.d.ts

@@ -6,8 +6,16 @@ export declare enum Environment {
     us = "us",
     test = "test"
 }
+export declare enum DrivingServiceMode {
+    /** 由 SDK 直接驱动（网络模式） */
+    sdk = "sdk",
+    /** 由宿主应用驱动（外部数据模式） */
+    host = "host"
+}
 export interface Configuration {
     readonly environment: Environment;
+    /** 驱动服务模式，默认为 sdk（网络模式） */
+    readonly drivingServiceMode?: DrivingServiceMode;
 }
 export interface SdkConfigResponse {
     endpoints: {
@@ -35,7 +43,8 @@ export declare enum ConnectionState {
 export declare enum AvatarState {
     idle = "idle",// 空闲状态，呈现呼吸态
     active = "active",// 活跃中，等待可播放内容
-    playing = "playing"
+    playing = "playing",// 播放中
+    paused = "paused"
 }
 export declare class SPAvatarError extends Error {
     code?: string | undefined;
@@ -58,11 +67,14 @@ export interface CameraConfig {
     up?: [number, number, number];
     aspect?: number;
 }
-export interface RenderPerformanceStats {
-    renderTime: number;
-    sortTime: number;
-    backend: 'webgpu' | 'webgl' | null;
-    pointCount?: number;
+/**
+ * 播放模式
+ */
+export declare enum AvatarPlaybackMode {
+    /** 网络模式：通过 WebSocket 发送音频，接收动画数据 */
+    network = "network",
+    /** 外部数据模式：外部提供音频和动画数据, SDK 负责同步播放 */
+    external = "external"
 }
 export * from './character';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,oBAAY,WAAW;IACrB,EAAE,OAAO;IACT,EAAE,OAAO;IACT,IAAI,SAAS;CACd;AAGD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;CAClC;AAGD,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE;QACT,EAAE,CAAC,EAAE,MAAM,CAAA;QACX,EAAE,CAAC,EAAE,MAAM,CAAA;QACX,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;CACF;AAGD,oBAAY,YAAY;IACtB,WAAW,gBAAgB;IAC3B,SAAS,cAAc;IACvB,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,YAAY,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAGD,oBAAY,eAAe;IACzB,YAAY,iBAAiB;IAC7B,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,MAAM,WAAW;CAClB;AAGD,oBAAY,WAAW;IACrB,IAAI,SAAS,CAAE,aAAa;IAC5B,MAAM,WAAW,CAAE,cAAc;IACjC,OAAO,YAAY;CACpB;AAGD,qBAAa,aAAc,SAAQ,KAAK;IACF,IAAI,CAAC,EAAE,MAAM;gBAArC,OAAO,EAAE,MAAM,EAAS,IAAI,CAAC,EAAE,MAAM,YAAA;CAIlD;AAID,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,YAAY,CAAA;IACvB,MAAM,EAAE,YAAY,CAAA;IACpB,SAAS,EAAE,YAAY,CAAA;IACvB,MAAM,EAAE,YAAY,CAAA;IACpB,SAAS,EAAE,YAAY,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAGD,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAA;IAClC,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAKD,cAAc,aAAa,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,oBAAY,WAAW;IACrB,EAAE,OAAO;IACT,EAAE,OAAO;IACT,IAAI,SAAS;CACd;AAGD,oBAAY,kBAAkB;IAC5B,uBAAuB;IACvB,GAAG,QAAQ;IACX,sBAAsB;IACtB,IAAI,SAAS;CACd;AAGD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IACjC,2BAA2B;IAC3B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAA;CACjD;AAGD,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE;QACT,EAAE,CAAC,EAAE,MAAM,CAAA;QACX,EAAE,CAAC,EAAE,MAAM,CAAA;QACX,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;CACF;AAGD,oBAAY,YAAY;IACtB,WAAW,gBAAgB;IAC3B,SAAS,cAAc;IACvB,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,YAAY,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,KAAK,CAAA;CACd;AAGD,oBAAY,eAAe;IACzB,YAAY,iBAAiB;IAC7B,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,MAAM,WAAW;CAClB;AAGD,oBAAY,WAAW;IACrB,IAAI,SAAS,CAAE,aAAa;IAC5B,MAAM,WAAW,CAAE,cAAc;IACjC,OAAO,YAAY,CAAE,MAAM;IAC3B,MAAM,WAAW;CAClB;AAGD,qBAAa,aAAc,SAAQ,KAAK;IACF,IAAI,CAAC,EAAE,MAAM;gBAArC,OAAO,EAAE,MAAM,EAAS,IAAI,CAAC,EAAE,MAAM,YAAA;CAIlD;AAID,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,YAAY,CAAA;IACvB,MAAM,EAAE,YAAY,CAAA;IACpB,SAAS,EAAE,YAAY,CAAA;IACvB,MAAM,EAAE,YAAY,CAAA;IACpB,SAAS,EAAE,YAAY,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAgBD;;GAEG;AACH,oBAAY,kBAAkB;IAC5B,oCAAoC;IACpC,OAAO,YAAY;IACnB,qCAAqC;IACrC,QAAQ,aAAa;CACtB;AAMD,cAAc,aAAa,CAAA"}

package/dist/utils/cls-tracker.d.ts

@@ -0,0 +1,17 @@
+import { Environment } from '../types';
+/**
+ * 初始化 CLS（需要传入环境信息）
+ */
+export declare function initializeCLS(environment: Environment): void;
+/**
+ * 上报日志到 CLS
+ * @param event 事件名称
+ * @param level 日志级别
+ * @param contents 日志内容
+ */
+export declare function trackEvent(event: string, level?: 'debug' | 'info' | 'warning' | 'error', contents?: Record<string, unknown>): void;
+/**
+ * 清理 CLS（刷新剩余日志并停止定时器）
+ */
+export declare function cleanupCLS(): void;
+//# sourceMappingURL=cls-tracker.d.ts.map

package/dist/utils/cls-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cls-tracker.d.ts","sourceRoot":"","sources":["../../utils/cls-tracker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAetC;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,CA4B5D;AAoHD;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAgB,EACtD,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,IAAI,CAmCN;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CASjC"}

package/dist/utils/{reqId.d.ts → conversationId.d.ts}

@@ -1,5 +1,5 @@
 /**
- * ReqID 生成工具
+ * Conversation ID 生成工具
  *
  * 统一格式：时间戳（UTC时间，秒级，格式：YYYYMMDDHHmmss）+ 下划线 + 12位 NanoID
  * 示例：20251027143034_aB3dEf9hIjKl
@@ -7,14 +7,14 @@
  * 时间部分使用 UTC 时间，便于跨端日志排查时统一转换时区检索
  */
 /**
- * 生成统一的请求 ID
+ * 生成统一的会话 ID
  *
  * 格式：时间戳（UTC时间，秒级，格式：YYYYMMDDHHmmss）+ 下划线 + 12位 NanoID
  * 时间部分使用 UTC 时间，便于跨端日志排查时统一转换时区检索
  *
- * @returns 格式为 YYYYMMDDHHmmss_nanoid 的请求 ID
+ * @returns 格式为 YYYYMMDDHHmmss_nanoid 的会话 ID
  * @example
- * generateReqId() // "20251027143034_aB3dEf9hIjKl"
+ * generateConversationId() // "20251027143034_aB3dEf9hIjKl"
  */
-export declare function generateReqId(): string;
-//# sourceMappingURL=reqId.d.ts.map
+export declare function generateConversationId(): string;
+//# sourceMappingURL=conversationId.d.ts.map

package/dist/utils/conversationId.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationId.d.ts","sourceRoot":"","sources":["../../utils/conversationId.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAkB/C"}

package/dist/utils/logger.d.ts

@@ -1,12 +1,4 @@
-/**
- * Logger Utility
- * Environment-aware logger wrapper
- * - Logs normally in test/dev environment
- * - In production: silently logs to console
- * - Errors and warnings are always reported to PostHog (when loaded)
- *
- * Usage: Replace `console.log()` with `logger.log()`
- */
+import { LogLevel } from '@guiiai/logg';
 export declare const logger: import('@guiiai/logg').Logg;
 export declare const loggerWithUnknown: {
     error: (message: string, error?: unknown) => void;
@@ -14,7 +6,7 @@ export declare const loggerWithUnknown: {
     useGlobalConfig: () => import('@guiiai/logg').Logg;
     child: (fields?: Record<string, any>) => import('@guiiai/logg').Logg;
     withContext: (context: string) => import('@guiiai/logg').Logg;
-    withLogLevel: (logLevel: import('@guiiai/logg').LogLevel) => import('@guiiai/logg').Logg;
+    withLogLevel: (logLevel: LogLevel) => import('@guiiai/logg').Logg;
     withLogLevelString: (logLevelString: import('@guiiai/logg').LogLevelString) => import('@guiiai/logg').Logg;
     withFormat: (format: import('@guiiai/logg').Format) => import('@guiiai/logg').Logg;
     withFields: (fields: Record<string, any>) => import('@guiiai/logg').Logg;

package/dist/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,eAAO,MAAM,MAAM,6BAKC,CAAA;AAGpB,eAAO,MAAM,iBAAiB;qBAEX,MAAM,UAAU,OAAO;oBASxB,MAAM,UAAU,OAAO;;kBAPK,CAAC;;;;;;;;;;aAyC0hC,CAAC;;0BAAoT,GAAI;4BAA0U,GAAI;wBAAkU,GAAI;yDAA2vB,GAAI;;;;CAzBpxF,CAAA"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../utils/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAgC,QAAQ,EAAE,MAAM,cAAc,CAAA;AAcrE,eAAO,MAAM,MAAM,6BAKC,CAAA;AAGpB,eAAO,MAAM,iBAAiB;qBAEX,MAAM,UAAU,OAAO;oBASxB,MAAM,UAAU,OAAO;;kBAxBzB,CAAC;;;;;;;;;;aAkDsgB,CAAC;;0BAAoT,GAAI;4BAA0U,GAAI;wBAAkU,GAAI;yDAA2vB,GAAI;;;;CAjBluE,CAAA"}

package/dist/vanilla/vite.config.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import('vite').UserConfig;
+export default _default;
+//# sourceMappingURL=vite.config.d.ts.map

package/dist/vanilla/vite.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite.config.d.ts","sourceRoot":"","sources":["../../vanilla/vite.config.ts"],"names":[],"mappings":";AAQA,wBAyCE"}

package/dist/wasm/avatarCoreAdapter.d.ts

@@ -1,4 +1,9 @@
-import { AvatarCoreMemoryManager } from './avatarCoreMemory';
+/**
+ * Avatar Core WASM 适配器
+ *
+ * 完全替换 FlameComplete3DGSManager，提供 avatar_core_wasm 的完整功能
+ * 包括牙齿细分、眼部追踪等高级特性
+ */
 export interface WasmModuleConfig {
     baseUrl?: string;
     [key: string]: unknown;
@@ -46,6 +51,8 @@ export declare class AvatarCoreAdapter {
     private wasmModule;
     private memoryManager;
     private coreHandle;
+    private characterHandles;
+    private animationHandles;
     private characterHandle;
     private animationHandle;
     private totalFrames;
@@ -87,7 +94,12 @@ export declare class AvatarCoreAdapter {
     /**
      * 读取当前动画帧的 FlameParams（用于过渡或调试）
      */
-    getCurrentFrameParams(frameIndex?: number): Promise<FlameParams>;
+    /**
+     * Get current frame parameters
+     * @param frameIndex Frame index
+     * @param characterId Optional character ID for multi-character support
+     */
+    getCurrentFrameParams(frameIndex?: number, characterId?: string): Promise<FlameParams>;
     /**
      * 初始化 Avatar Core 核心
      */
@@ -99,21 +111,34 @@ export declare class AvatarCoreAdapter {
     /**
      * 加载角色数据（从预加载的 ArrayBuffers）
      */
-    loadCharacterFromBuffers(shapeBuffer: ArrayBuffer, pointCloudBuffer: ArrayBuffer): Promise<boolean>;
+    /**
+     * Load character from buffers and return handle
+     * @param shapeBuffer Shape data buffer
+     * @param pointCloudBuffer Point cloud data buffer
+     * @param characterId Optional character ID for multi-character support
+     * @returns Character handle
+     */
+    loadCharacterFromBuffers(shapeBuffer: ArrayBuffer, pointCloudBuffer: ArrayBuffer, characterId?: string): Promise<number>;
     private loadAnimationFromData;
     /**
      * Load animation from ArrayBuffer (for CDN-based dynamic loading)
+     * @param animData Animation data buffer
+     * @param characterId Optional character ID for multi-character support
+     * @returns Animation handle
      */
-    loadAnimationFromBuffer(animData: ArrayBuffer): Promise<number>;
+    loadAnimationFromBuffer(animData: ArrayBuffer, characterId?: string): Promise<number>;
     switchAnimationFile(animationFile: string): Promise<number>;
     /**
      * 获取动画总帧数
+     * @param animationHandle Optional animation handle (for multi-character support)
      */
-    getAnimationTotalFrames(): Promise<number>;
+    getAnimationTotalFrames(animationHandle?: number): Promise<number>;
     /**
      * 从动画中获取指定帧的参数
+     * @param frameIndex Frame index
+     * @param characterId Optional character ID for multi-character support
      */
-    getAnimationFrameParams(frameIndex?: number): Promise<number>;
+    getAnimationFrameParams(frameIndex?: number, characterId?: string): Promise<number>;
     /**
      * 设置眼部追踪配置（对齐 app 实现）
      */
@@ -150,7 +175,6 @@ export declare class AvatarCoreAdapter {
      * 获取性能指标
      */
     getPerformanceMetrics(): PerformanceMetrics & {
-        memoryStats?: ReturnType<AvatarCoreMemoryManager['getMemoryStats']>;
         flameInfo?: FlameInfo;
         characterInfo?: CharacterInfo;
         version?: string;
@@ -158,6 +182,16 @@ export declare class AvatarCoreAdapter {
     /**
      * 释放当前角色和动画资源（但保留 core）
      */
+    /**
+     * Remove a specific character by handle
+     * @param characterHandle Character handle to remove
+     * @param characterId Optional character ID for cleanup
+     */
+    removeCharacter(characterHandle: number, characterId?: string): void;
+    /**
+     * Release current character (legacy method, kept for backward compatibility)
+     * @deprecated Use removeCharacter() instead for multi-character support
+     */
     releaseCurrentCharacter(): void;
     /**
      * 释放所有资源（包括 core）
@@ -175,14 +209,29 @@ export declare class AvatarCoreAdapter {
      * - 零拷贝直接访问 WASM 内存http://localhost:3000/us/
      * - 直接输出 GPU 格式 [pos3, color4, cov6]
      */
+    /**
+     * Compute complete frame from animation
+     * @param params Frame parameters
+     * @param characterHandle Optional character handle (for multi-character support)
+     */
     computeCompleteFrameFlat(params?: {
         frameIndex?: number;
-    }): Promise<Float32Array | null>;
+    }, characterHandle?: number): Promise<Float32Array | null>;
     /**
      * 计算帧并返回 GPU 友好的 flat 格式（从 FLAME 参数）
      * 🔑 用于 Realtime: 接受自定义 FLAME 参数并计算 Splat
      */
-    computeFrameFlatFromParams(flameParams: FlameParams): Promise<Float32Array | null>;
+    /**
+     * Compute frame from Flame parameters
+     * @param flameParams Flame parameters
+     * @param characterHandle Optional character handle (for multi-character support)
+     */
+    computeFrameFlatFromParams(flameParams: FlameParams, characterHandle?: number): Promise<Float32Array | null>;
+    /**
+     * 获取 WASM 内存使用情况（MB）
+     * @returns WASM 内存使用量（MB），如果模块未加载则返回 null
+     */
+    getWASMMemoryMB(): number | null;
 }
 export {};
 //# sourceMappingURL=avatarCoreAdapter.d.ts.map

package/dist/wasm/avatarCoreAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"avatarCoreAdapter.d.ts","sourceRoot":"","sources":["../../wasm/avatarCoreAdapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"avatarCoreAdapter.d.ts","sourceRoot":"","sources":["../../wasm/avatarCoreAdapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAGD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC9B,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,wBAAwB,CAAC,EAAE,OAAO,CAAA;IAClC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,gBAAgB,CAAA;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,MAAM,CAAA;IACrB,gBAAgB,EAAE,MAAM,CAAA;IACxB,kBAAkB,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,OAAO,CAAA;CACtB;AAMD,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,qBAAa,iBAAiB;IAE5B,OAAO,CAAC,OAAO,CAAqF;IACpG,OAAO,CAAC,UAAU,CAAkB;IAIpC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,aAAa,CAAgC;IAGrD,OAAO,CAAC,UAAU,CAAe;IAEjC,OAAO,CAAC,gBAAgB,CAAiC;IAEzD,OAAO,CAAC,gBAAgB,CAAyE;IAGjG,OAAO,CAAC,eAAe,CAAe;IACtC,OAAO,CAAC,eAAe,CAAe;IACtC,OAAO,CAAC,WAAW,CAAe;IAGlC,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,iBAAiB,CAAS;IAIlC,OAAO,CAAC,GAAG,CAAK;IAGhB,OAAO,CAAC,kBAAkB,CAAoB;IACvC,QAAQ,SAAI;IAGnB,OAAO,CAAC,UAAU,CAAwB;IAG1C,OAAO,CAAC,SAAS,CAAC,CAAW;IAC7B,OAAO,CAAC,aAAa,CAAC,CAAe;gBAEzB,OAAO,GAAE,iBAAsB;IAqD3C;;;;;;;;;;;;OAYG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IA+BrC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAwB7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAuC1B;;OAEG;IACH;;;;OAIG;IACG,qBAAqB,CAAC,UAAU,GAAE,MAAU,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAY/F;;OAEG;YACW,oBAAoB;IAwBlC;;OAEG;IACG,gCAAgC,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IA8BxG;;OAEG;IACH;;;;;;OAMG;IACG,wBAAwB,CAC5B,WAAW,EAAE,WAAW,EACxB,gBAAgB,EAAE,WAAW,EAC7B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC;YA+DJ,qBAAqB;IAgBnC;;;;;OAKG;IACG,uBAAuB,CAAC,QAAQ,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BrF,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA6BjE;;;OAGG;IACG,uBAAuB,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqCxE;;;;OAIG;IACG,uBAAuB,CAAC,UAAU,GAAE,MAAU,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuD5F;;OAEG;IACG,oBAAoB,CAAC,MAAM,EAAE;QACjC,OAAO,EAAE,OAAO,CAAA;QAChB,sBAAsB,CAAC,EAAE,OAAO,CAAA;QAChC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAC1B,GAAG,OAAO,CAAC,OAAO,CAAC;IAuBpB;;OAEG;IACG,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAkBtE;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IAkB1C;;OAEG;YACW,cAAc;IAkC5B;;OAEG;YACW,kBAAkB;IA2BhC;;OAEG;IACH,OAAO,CAAC,UAAU;IASlB;;OAEG;YACW,cAAc;IAM5B;;OAEG;IACH,qBAAqB,IAAI,kBAAkB,GAAG;QAC5C,SAAS,CAAC,EAAE,SAAS,CAAA;QACrB,aAAa,CAAC,EAAE,aAAa,CAAA;QAC7B,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB;IASD;;OAEG;IACH;;;;OAIG;IACH,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAmCpE;;;OAGG;IACH,uBAAuB,IAAI,IAAI;IAM/B;;OAEG;IACH,OAAO,IAAI,IAAI;IAiCf;;OAEG;IAIG,cAAc,CAAC,UAAU,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IAOjD,YAAY,CAAC,mBAAmB,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IAK/F;;;;;;OAMG;IACH;;;;OAIG;IACG,wBAAwB,CAAC,MAAM,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAiFxH;;;OAGG;IACH;;;;OAIG;IACG,0BAA0B,CAAC,WAAW,EAAE,WAAW,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IA6DlH;;;OAGG;IACH,eAAe,IAAI,MAAM,GAAG,IAAI;CAsBjC"}

package/dist/wasm/avatarCoreMemory.d.ts

@@ -58,7 +58,11 @@ export declare class AvatarCoreMemoryManager {
     /**
      * 创建 AvatarCharacterData 结构体 - 新版 Emscripten 方式
      */
-    createCharacterData(shapeBuffer: ArrayBuffer, plyBuffer: ArrayBuffer): number;
+    createCharacterData(shapeBuffer: ArrayBuffer, plyBuffer: ArrayBuffer, characterId?: string): {
+        dataPtr: number;
+        shapePtr: number;
+        plyPtr: number;
+    };
     /**
      * 读取 AvatarFlameParams 结构体数据
      * Used to extract current animation frame parameters from WASM memory

package/dist/wasm/avatarCoreMemory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"avatarCoreMemory.d.ts","sourceRoot":"","sources":["../../wasm/avatarCoreMemory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"avatarCoreMemory.d.ts","sourceRoot":"","sources":["../../wasm/avatarCoreMemory.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@spatialwalk/avatarkit",
   "type": "module",
-  "version": "1.0.0-beta.2",
+  "version": "1.0.0-beta.21",
   "packageManager": "pnpm@10.18.2",
   "description": "SPAvatar SDK - 3D Gaussian Splatting Avatar Rendering SDK",
   "author": "SPAvatar Team",
@@ -29,13 +29,18 @@
   "types": "./dist/index.d.ts",
   "files": [
     "README.md",
+    "CHANGELOG.md",
     "dist"
   ],
   "scripts": {
     "build": "SDK_BUILD=true vite build --mode library",
     "dev": "vite build --mode library --watch",
     "clean": "rm -rf dist",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "test": "cd tests && pnpm test",
+    "test:watch": "cd tests && pnpm run test:watch",
+    "test:e2e": "cd tests && pnpm run test:e2e",
+    "test:perf": "cd tests && pnpm run test:perf"
   },
   "peerDependencies": {
     "@webgpu/types": "*"
@@ -43,11 +48,12 @@
   "dependencies": {
     "@bufbuild/protobuf": "^2.10.0",
     "@guiiai/logg": "^1.2.4",
-    "nanoid": "^5.1.6",
-    "posthog-js": "^1.275.3"
+    "nanoid": "^5.1.6"
   },
   "devDependencies": {
+    "@types/node": "^20.11.30",
     "@webgpu/types": "^0.1.65",
+    "tsx": "^4.20.6",
     "typescript": "^5.0.0",
     "vite": "^5.0.0",
     "vite-plugin-dts": "^4.5.4"