@spatialwalk/avatarkit 1.0.0-beta.1

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * SPAvatar SDK - 统一公开接口
+ */
+export { APP_CONFIG } from './config/app-config';
+export { Avatar } from './core/Avatar';
+export { AvatarController } from './core/AvatarController';
+export { AvatarKit } from './core/AvatarKit';
+export { AvatarManager } from './core/AvatarManager';
+export { AvatarView } from './core/AvatarView';
+export * from './types';
+export type { CharacterInfo, FlameInfo } from './wasm/avatarCoreAdapter';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,19 @@
+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-DwhR9l52.js";
+export {
+  s as APP_CONFIG,
+  o as Avatar,
+  e 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
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/renderer/RenderSystem.d.ts

@@ -0,0 +1,77 @@
+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;
+}
+//# sourceMappingURL=RenderSystem.d.ts.map

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

@@ -0,0 +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"}

package/dist/renderer/covariance.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 3D 协方差矩阵计算工具
+ * 用于从缩放和旋转参数计算 Gaussian Splat 的协方差矩阵
+ */
+/**
+ * 计算 3D 协方差矩阵
+ *
+ * @param scale - 缩放向量 [sx, sy, sz]
+ * @param rotation - 四元数旋转 [qx, qy, qz, qw]
+ * @returns 3x3 协方差矩阵
+ */
+export declare function computeCovariance3D(scale: number[], rotation: number[]): number[][];
+//# sourceMappingURL=covariance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"covariance.d.ts","sourceRoot":"","sources":["../../renderer/covariance.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,EAAE,EACf,QAAQ,EAAE,MAAM,EAAE,GACjB,MAAM,EAAE,EAAE,CA6CZ"}

package/dist/renderer/renderer.d.ts

@@ -0,0 +1,8 @@
+export interface I3DGSRenderer {
+    initialize: () => Promise<void>;
+    loadSplatsFromPackedData: (packedData: Float32Array, pointCount: number, sortOrder?: Uint32Array) => void;
+    render: (viewMatrix: Float32Array, projectionMatrix: Float32Array, screenSize: [number, number]) => void;
+    dispose: () => void;
+}
+export type RenderBackend = 'webgl' | 'webgpu';
+//# sourceMappingURL=renderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../renderer/renderer.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/B,wBAAwB,EAAE,CACxB,UAAU,EAAE,YAAY,EACxB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,WAAW,KACpB,IAAI,CAAA;IACT,MAAM,EAAE,CACN,UAAU,EAAE,YAAY,EACxB,gBAAgB,EAAE,YAAY,EAC9B,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,KACzB,IAAI,CAAA;IACT,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,CAAA"}

package/dist/renderer/sortSplats.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Splat 深度排序（Radix Sort 优化版）
+ * 使用 11-bit 两轮基数排序，O(n) 时间复杂度
+ */
+/**
+ * 对 splats 进行深度排序（Radix Sort）
+ * @param packedData Packed 格式数据 [pos3, color4, cov6] x N
+ * @param cameraPosition 相机位置
+ * @param cameraForward 相机前向向量
+ */
+export declare function sortSplats(packedData: Float32Array, cameraPosition: [number, number, number], cameraForward: [number, number, number]): Uint32Array;
+//# sourceMappingURL=sortSplats.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sortSplats.d.ts","sourceRoot":"","sources":["../../renderer/sortSplats.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,UAAU,EAAE,YAAY,EACxB,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACxC,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GACtC,WAAW,CA4Db"}

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

@@ -0,0 +1,14 @@
+/**
+ * Packed Data 工具函数
+ *
+ * Packed 格式：[pos3, color4, cov6] x N 个点
+ * 每个点 13 个 float，共 52 bytes
+ */
+/**
+ * 重新排序 packed 数据（复用缓冲区）
+ * @param packedData 原始数据 [pos3, color4, cov6] x N
+ * @param sortOrder 排序索引数组
+ * @returns 重排序后的数据（复用的缓冲区引用）
+ */
+export declare function reorderPackedData(packedData: Float32Array, sortOrder: Uint32Array): Float32Array;
+//# sourceMappingURL=reorderData.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,66 @@
+import { I3DGSRenderer } from '../renderer';
+export declare class WebGLRenderer implements I3DGSRenderer {
+    private canvas;
+    private backgroundColor;
+    private gl;
+    private shaderProgram;
+    private uniformLocations;
+    private attributeLocations;
+    private splatBuffer;
+    private quadVertexBuffer;
+    private vertexArray;
+    private splatCount;
+    private isInitialized;
+    private splatBufferSize;
+    constructor(canvas: HTMLCanvasElement, backgroundColor?: [number, number, number, number]);
+    /**
+     * 初始化 WebGL 渲染器
+     */
+    initialize(): Promise<void>;
+    /**
+     * 设置着色器位置
+     */
+    private setupShaderLocations;
+    /**
+     * 设置 WebGL 渲染状态
+     */
+    private setupWebGLState;
+    /**
+     * 创建渲染缓冲区
+     */
+    private createBuffers;
+    /**
+     * 创建四边形顶点缓冲区（实例化渲染用）
+     */
+    private createQuadVertexBuffer;
+    /**
+     * 从已打包数据加载（零拷贝，GPU 优化路径）
+     * 🚀 性能优化版本：直接使用 WASM 输出的 packed 数据
+     * 🚀 Buffer 复用：避免每帧重新分配，使用 bufferSubData 更新
+     * @param packedData Float32Array [pos3, color4, cov6] x N 个点
+     * @param pointCount 点数
+     * @param _sortOrder WebGL 忽略此参数（已在 RenderSystem 中重排序）
+     */
+    loadSplatsFromPackedData(packedData: Float32Array, pointCount: number, _sortOrder?: Uint32Array): void;
+    /**
+     * 上传数据到 GPU
+     */
+    private uploadToGPU;
+    /**
+     * 设置实例化渲染顶点属性
+     */
+    private setupVertexAttributes;
+    /**
+     * 渲染一帧
+     */
+    render(viewMatrix: Float32Array, projectionMatrix: Float32Array, screenSize: [number, number]): void;
+    /**
+     * 创建着色器程序
+     */
+    private createShaderProgram;
+    /**
+     * 清理资源
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=webglRenderer.d.ts.map

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

@@ -0,0 +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"}

package/dist/renderer/webgpu/webgpuRenderer.d.ts

@@ -0,0 +1,54 @@
+import { I3DGSRenderer } from '../renderer';
+export declare class WebGPURenderer implements I3DGSRenderer {
+    private canvas;
+    private backgroundColor;
+    private device;
+    private context;
+    private renderPipeline;
+    private quadVertexBuffer;
+    private uniformBuffer;
+    private uniformBindGroup;
+    private sortIndexBuffer;
+    private splatDataBuffer;
+    private storageBindGroup;
+    private lastSortOrder;
+    private bindGroupNeedsUpdate;
+    private splatCount;
+    private presentationFormat;
+    constructor(canvas: HTMLCanvasElement, backgroundColor?: [number, number, number, number]);
+    /**
+     * 初始化 WebGPU 渲染器
+     */
+    initialize(): Promise<void>;
+    /**
+     * 创建 Uniform Buffer
+     */
+    private createUniformBuffer;
+    /**
+     * 创建四边形顶点缓冲区（实例化渲染用）
+     */
+    private createQuadVertexBuffer;
+    /**
+     * 创建 Render Pipeline
+     */
+    private createRenderPipeline;
+    /**
+     * 从已打包数据加载
+     * 🚀 间接索引渲染：packedData 是原始数据，sortOrder 是排序索引
+     * 🚀 完全消除 CPU 重排序开销
+     */
+    loadSplatsFromPackedData(packedData: Float32Array, pointCount: number, sortOrder?: Uint32Array): void;
+    /**
+     * 渲染一帧
+     */
+    render(viewMatrix: Float32Array, projectionMatrix: Float32Array, screenSize: [number, number]): void;
+    /**
+     * 更新 Uniform Buffer
+     */
+    private updateUniforms;
+    /**
+     * 清理资源
+     */
+    dispose(): void;
+}
+//# sourceMappingURL=webgpuRenderer.d.ts.map

package/dist/renderer/webgpu/webgpuRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webgpuRenderer.d.ts","sourceRoot":"","sources":["../../../renderer/webgpu/webgpuRenderer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAIhD,qBAAa,cAAe,YAAW,aAAa;IAClD,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,cAAc,CAAiC;IACvD,OAAO,CAAC,gBAAgB,CAAyB;IACjD,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,gBAAgB,CAA4B;IAGpD,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,gBAAgB,CAA4B;IACpD,OAAO,CAAC,aAAa,CAA2B;IAChD,OAAO,CAAC,oBAAoB,CAAQ;IAEpC,OAAO,CAAC,UAAU,CAAI;IACtB,OAAO,CAAC,kBAAkB,CAAiC;gBAE/C,MAAM,EAAE,iBAAiB,EAAE,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAKzF;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAmCjC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA0B9B;;OAEG;YACW,oBAAoB;IAiHlC;;;;OAIG;IACH,wBAAwB,CACtB,UAAU,EAAE,YAAY,EACxB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,WAAW,GACtB,IAAI;IAoFP;;OAEG;IACH,MAAM,CACJ,UAAU,EAAE,YAAY,EACxB,gBAAgB,EAAE,YAAY,EAC9B,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,IAAI;IA0CP;;OAEG;IACH,OAAO,CAAC,cAAc;IA8BtB;;OAEG;IACH,OAAO,IAAI,IAAI;CAiBhB"}

package/dist/types/character-settings.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Character settings type definitions for character templates
+ * Backend guarantees the schema although it is weakly typed in proto.
+ */
+export interface EyelidSettings {
+    auto_eyelid_adjustment: boolean;
+    enabled: boolean;
+    eyelid_threshold: number;
+    targets: number[];
+}
+export interface CameraSettings {
+    fovXRadians: number;
+    fovYRadians: number;
+    rotation: number;
+    translationX: number;
+    translationY: number;
+    translationZ: number;
+}
+export interface CharacterSettings {
+    eyelid: EyelidSettings;
+    camera: CameraSettings;
+}
+//# sourceMappingURL=character-settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"character-settings.d.ts","sourceRoot":"","sources":["../../types/character-settings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,sBAAsB,EAAE,OAAO,CAAA;IAC/B,OAAO,EAAE,OAAO,CAAA;IAChB,gBAAgB,EAAE,MAAM,CAAA;IACxB,OAAO,EAAE,MAAM,EAAE,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,cAAc,CAAA;IACtB,MAAM,EAAE,cAAc,CAAA;CACvB"}

package/dist/types/character.d.ts

@@ -0,0 +1,39 @@
+import { CharacterAsset } from '../generated/driveningress/v2/driveningress';
+import { CameraSettings, CharacterSettings } from './character-settings';
+/**
+ * 角色元数据
+ */
+export type CharacterMeta = CharacterAsset & {
+    characterSettings?: CharacterSettings;
+};
+export type PreloadResources<T> = {
+    version: string;
+} & T;
+export type PreloadCameraSettings = PreloadResources<{
+    camera: CameraSettings;
+}>;
+/**
+ * 资源类型枚举
+ */
+export declare enum ResourceType {
+    CAMERA = "camera",
+    ANIMATION_IDLE = "frameIdle",
+    ANIMATION_MONO = "frameMono",
+    AUDIO_MONO = "audioMono",
+    MODEL_SHAPE = "shape",
+    MODEL_GS = "gsStandard"
+}
+/**
+ * 提取所有资源 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

@@ -0,0 +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"}

package/dist/types/index.d.ts

@@ -0,0 +1,68 @@
+/**
+ * 统一公开类型 & 接口
+ */
+export declare enum Environment {
+    cn = "cn",
+    us = "us",
+    test = "test"
+}
+export interface Configuration {
+    readonly environment: Environment;
+}
+export interface SdkConfigResponse {
+    endpoints: {
+        cn?: string;
+        us?: string;
+        test?: string;
+    };
+}
+export declare enum LoadProgress {
+    downloading = "downloading",
+    completed = "completed",
+    failed = "failed"
+}
+export interface LoadProgressInfo {
+    type: LoadProgress;
+    progress?: number;
+    error?: Error;
+}
+export declare enum ConnectionState {
+    disconnected = "disconnected",
+    connecting = "connecting",
+    connected = "connected",
+    failed = "failed"
+}
+export declare enum AvatarState {
+    idle = "idle",// 空闲状态，呈现呼吸态
+    active = "active",// 活跃中，等待可播放内容
+    playing = "playing"
+}
+export declare class SPAvatarError extends Error {
+    code?: string | undefined;
+    constructor(message: string, code?: string | undefined);
+}
+export interface FlatSplatData {
+    positions: Float32Array;
+    scales: Float32Array;
+    rotations: Float32Array;
+    colors: Float32Array;
+    opacities: Float32Array;
+    pointCount: number;
+}
+export interface CameraConfig {
+    position: [number, number, number];
+    target: [number, number, number];
+    fov: number;
+    near: number;
+    far: number;
+    up?: [number, number, number];
+    aspect?: number;
+}
+export interface RenderPerformanceStats {
+    renderTime: number;
+    sortTime: number;
+    backend: 'webgpu' | 'webgl' | null;
+    pointCount?: number;
+}
+export * from './character';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/utils/animation-interpolation.d.ts

@@ -0,0 +1,17 @@
+import { Flame } from '../generated/driveningress/v1/driveningress';
+/**
+ * Linear interpolation with cosine easing (ease-in-ease-out)
+ * 0.5 - cos(progress * π) * 0.5
+ */
+export declare function linearLerp(from: Flame, to: Flame, progress: number): Flame;
+/**
+ * Generate transition keyframes between two Flame states
+ * @param durationMs Transition duration (e.g. 400ms)
+ * @param fps Frames per second (default 25)
+ */
+export declare function generateTransitionFrames(from: Flame, to: Flame, durationMs: number, fps?: number): Flame[];
+/**
+ * Create a neutral Flame
+ */
+export declare function createNeutralFlame(): Flame;
+//# sourceMappingURL=animation-interpolation.d.ts.map

package/dist/utils/animation-interpolation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animation-interpolation.d.ts","sourceRoot":"","sources":["../../utils/animation-interpolation.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,6CAA6C,CAAA;AAWxE;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,KAAK,CAkB1E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,KAAK,EACX,EAAE,EAAE,KAAK,EACT,UAAU,EAAE,MAAM,EAClB,GAAG,SAAK,GACP,KAAK,EAAE,CAQT;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,KAAK,CAU1C"}

package/dist/utils/error-utils.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Error Utility Functions
+ * Provides consistent error handling and formatting across the application
+ */
+/**
+ * Convert unknown error to a readable error message string
+ *
+ * @param err - Unknown error object (could be Error, string, object, etc.)
+ * @returns Formatted error message string
+ *
+ * @example
+ * try {
+ *   riskyOperation()
+ * } catch (err) {
+ *   const message = errorToMessage(err)
+ *   logger.error('Operation failed:', message)
+ * }
+ */
+export declare function errorToMessage(err: unknown): string;
+/**
+ * Convert unknown error to a detailed error message with stack trace (for logging)
+ *
+ * @param err - Unknown error object
+ * @returns Detailed error message with stack if available
+ */
+export declare function errorToDetailedMessage(err: unknown): string;
+//# sourceMappingURL=error-utils.d.ts.map

package/dist/utils/error-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-utils.d.ts","sourceRoot":"","sources":["../../utils/error-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAyBnD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAM3D"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 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()`
+ */
+export declare const logger: import('@guiiai/logg').Logg;
+export declare const loggerWithUnknown: {
+    error: (message: string, error?: unknown) => void;
+    warn: (message: string, error?: unknown) => void;
+    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;
+    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;
+    withField: (key: string, value: any) => import('@guiiai/logg').Logg;
+    withError: (err: Error | unknown) => import('@guiiai/logg').Logg;
+    withCallStack: (errorLike: {
+        message: string;
+        stack?: string;
+    }) => import('@guiiai/logg').Logg;
+    debug: (message: any, ...optionalParams: [...any, string?]) => void;
+    verbose: (message: any, ...optionalParams: [...any, string?]) => void;
+    log: (message: any, ...optionalParams: any[]) => void;
+    errorWithError: (message: any, err: Error | unknown, ...optionalParams: any[]) => void;
+    withTimeFormat: (format: string) => import('@guiiai/logg').Logg;
+    withTimeFormatter: (fn: (inputDate: Date) => string) => import('@guiiai/logg').Logg;
+    withErrorProcessor: (fn: (err: Error | unknown) => Error | unknown) => import('@guiiai/logg').Logg;
+};
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,82 @@
+/**
+ * PostHog Error & Event Tracking Utility
+ *
+ * Centralized tracking for realtime mode errors, warnings, and events.
+ * Provides type-safe event tracking with privacy-aware property filtering.
+ *
+ * Environment-aware tracking:
+ * - Development (DEV=true): Tracking disabled for faster development
+ * - Test (VITE_ENV_TEST=true): Full detailed tracking enabled
+ * - Production (default): Minimal tracking without verbose debug info
+ */
+/**
+ * Event categories for organizing telemetry data
+ */
+export type EventCategory = 'connection' | 'audio' | 'vad' | 'sync' | 'playback' | 'wasm' | 'rendering' | 'user_action';
+/**
+ * Connection tracking functions
+ */
+export declare const PostHogTracker: {
+    connection: {
+        connectStart: (characterId: string) => void;
+        connectSuccess: (characterId: string, durationMs: number) => void;
+        connectFailed: (characterId: string, error: string, retryCount?: number) => void;
+        reconnectAttempt: (retryCount: number) => void;
+        reconnectFailed: (retryCount: number, error: string) => void;
+        messageSendError: (messageType: string, error: string) => void;
+        messageDecodeError: (error: string) => void;
+        stateChange: (oldState: string, newState: string) => void;
+    };
+    audio: {
+        deviceAccessRequest: (deviceType: "microphone" | "speaker") => void;
+        deviceAccessGranted: (deviceType: "microphone" | "speaker") => void;
+        deviceAccessDenied: (deviceType: "microphone" | "speaker", error: string) => void;
+        bufferUnderrun: (bufferSize: number) => void;
+        decodeError: (error: string) => void;
+        contextInitFailed: (error: string) => void;
+        contextSuspended: () => void;
+        contextResumed: () => void;
+    };
+    vad: {
+        initializeStart: () => void;
+        initializeSuccess: (durationMs: number) => void;
+        initializeFailed: (error: string) => void;
+        speechStart: () => void;
+        speechEnd: (durationMs: number) => void;
+        speechReady: (audioDurationMs: number) => void;
+        blocked: (reason: string) => void;
+        unblocked: () => void;
+        restartFailed: (error: string) => void;
+    };
+    sync: {
+        bufferOverflow: (sessionId: string, bufferDurationMs: number) => void;
+        alignmentIssue: (sessionId: string, driftMs: number) => void;
+        sessionCreated: (sessionId: string) => void;
+        sessionCleanup: (sessionId: string, audioChunks: number, flameKeyframes: number) => void;
+        keyframeStarvation: (sessionId: string) => void;
+        audioChunkStarvation: (sessionId: string) => void;
+    };
+    playback: {
+        started: (sessionId: string) => void;
+        ended: (sessionId: string, durationMs: number, chunksPlayed: number) => void;
+        scheduleFailed: (sessionId: string, error: string) => void;
+        interrupted: (sessionId: string) => void;
+    };
+    wasm: {
+        computeError: (error: string) => void;
+        conversionError: (error: string) => void;
+        loadError: (error: string) => void;
+    };
+    rendering: {
+        renderLoopError: (error: string) => void;
+        splatLoadError: (error: string) => void;
+        textOnlyStateDetected: (durationMs: number) => void;
+    };
+    user: {
+        manualInterrupt: () => void;
+        textSent: (success: boolean, error?: string) => void;
+        speechSent: (success: boolean, error?: string) => void;
+        vadToggled: (enabled: boolean) => void;
+    };
+};
+//# sourceMappingURL=posthog-tracker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"posthog-tracker.d.ts","sourceRoot":"","sources":["../../utils/posthog-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAgBH;;GAEG;AACH,MAAM,MAAM,aAAa,GACnB,YAAY,GACZ,OAAO,GACP,KAAK,GACL,MAAM,GACN,UAAU,GACV,MAAM,GACN,WAAW,GACX,aAAa,CAAA;AAyLnB;;GAEG;AACH,eAAO,MAAM,cAAc;;oCAGK,MAAM,KAAG,IAAI;sCAOX,MAAM,cAAc,MAAM,KAAG,IAAI;qCAQlC,MAAM,SAAS,MAAM,eAAc,MAAM,KAAO,IAAI;uCASlD,MAAM,KAAG,IAAI;sCAOd,MAAM,SAAS,MAAM,KAAG,IAAI;wCAQ1B,MAAM,SAAS,MAAM,KAAG,IAAI;oCAOhC,MAAM,KAAG,IAAI;gCAOjB,MAAM,YAAY,MAAM,KAAG,IAAI;;;0CAUrB,YAAY,GAAG,SAAS,KAAG,IAAI;0CAO/B,YAAY,GAAG,SAAS,KAAG,IAAI;yCAQhC,YAAY,GAAG,SAAS,SAAS,MAAM,KAAG,IAAI;qCASlD,MAAM,KAAG,IAAI;6BAOrB,MAAM,KAAG,IAAI;mCAOP,MAAM,KAAG,IAAI;gCAOlB,IAAI;8BAMN,IAAI;;;+BASH,IAAI;wCAOO,MAAM,KAAG,IAAI;kCAQnB,MAAM,KAAG,IAAI;2BAQtB,IAAI;gCAOG,MAAM,KAAG,IAAI;uCAON,MAAM,KAAG,IAAI;0BAO1B,MAAM,KAAG,IAAI;yBAOhB,IAAI;+BAMI,MAAM,KAAG,IAAI;;;oCAUR,MAAM,oBAAoB,MAAM,KAAG,IAAI;oCAQvC,MAAM,WAAW,MAAM,KAAG,IAAI;oCAQ9B,MAAM,KAAG,IAAI;oCAOb,MAAM,eAAe,MAAM,kBAAkB,MAAM,KAAG,IAAI;wCAStD,MAAM,KAAG,IAAI;0CAOX,MAAM,KAAG,IAAI;;;6BAU1B,MAAM,KAAG,IAAI;2BAOf,MAAM,cAAc,MAAM,gBAAgB,MAAM,KAAG,IAAI;oCAS9C,MAAM,SAAS,MAAM,KAAG,IAAI;iCAQ/B,MAAM,KAAG,IAAI;;;8BAUhB,MAAM,KAAG,IAAI;iCAQV,MAAM,KAAG,IAAI;2BAQnB,MAAM,KAAG,IAAI;;;iCAWP,MAAM,KAAG,IAAI;gCAOd,MAAM,KAAG,IAAI;4CAOD,MAAM,KAAG,IAAI;;;+BAU5B,IAAI;4BAQL,OAAO,UAAU,MAAM,KAAG,IAAI;8BAS5B,OAAO,UAAU,MAAM,KAAG,IAAI;8BAS9B,OAAO,KAAG,IAAI;;CAQvC,CAAA"}