@spatialwalk/avatarkit 1.0.0-beta.69 → 1.0.0-beta.70

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /**
- *AvatarKit SDK - 统一公开接口
+ * AvatarKit SDK - Unified Public API
  */
 export { Avatar } from './core/Avatar';
 export { AvatarController } from './core/AvatarController';

package/dist/index.js

@@ -1,4 +1,4 @@
-import { b, c, m, f, d, j, g, C, i, D, E, k, h, L, R, n } from "./index-BT9yxWW8.js";
+import { b, c, m, f, d, j, g, C, i, D, E, k, h, L, R, n } from "./index-CvW_c7G-.js";
 export {
   b as Avatar,
   c as AvatarController,

package/dist/renderer/covariance.d.ts

@@ -1,12 +1,5 @@
 /**
- * 3D 协方差矩阵计算工具
- * 用于从缩放和旋转参数计算 Gaussian Splat 的协方差矩阵
+ * 3D Covariance Matrix Calculation Utility
+ * Used to calculate Gaussian Splat covariance matrix from scale and rotation parameters
  */
-/**
- * 计算 3D 协方差矩阵
- *
- * @param scale - 缩放向量 [sx, sy, sz]
- * @param rotation - 四元数旋转 [qx, qy, qz, qw]
- * @returns 3x3 协方差矩阵
- */
-export declare function computeCovariance3D(scale: number[], rotation: number[]): number[][];
+export {};

package/dist/renderer/sortSplats.d.ts

@@ -1,11 +1,5 @@
 /**
- * Splat 深度排序（Radix Sort 优化版）
- * 使用 11-bit 两轮基数排序，O(n) 时间复杂度
+ * Splat depth sorting (Radix Sort optimized version)
+ * Uses 11-bit radix sort, O(n) time complexity
  */
-/**
- * 对 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;
+export {};

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

@@ -1,13 +1,7 @@
 /**
- * Packed Data 工具函数
+ * Packed Data utility functions
  *
- * Packed 格式：[pos3, color4, cov6] x N 个点
- * 每个点 13 个 float，共 52 bytes
+ * Packed format: [pos3, color4, cov6] x N points
+ * Each point has 13 floats, 52 bytes total
  */
-/**
- * 重新排序 packed 数据（复用缓冲区）
- * @param packedData 原始数据 [pos3, color4, cov6] x N
- * @param sortOrder 排序索引数组
- * @returns 重排序后的数据（复用的缓冲区引用）
- */
-export declare function reorderPackedData(packedData: Float32Array, sortOrder: Uint32Array): Float32Array;
+export {};

package/dist/types/character.d.ts

@@ -1,7 +1,7 @@
 import { CharacterAsset } from '../generated/driveningress/v2/driveningress';
 import { CameraSettings, CharacterSettings } from './character-settings';
 /**
- * 角色元数据
+ * Character metadata
  */
 export type CharacterMeta = CharacterAsset & {
     characterSettings?: CharacterSettings;
@@ -13,7 +13,7 @@ export type PreloadCameraSettings = PreloadResources<{
     camera: CameraSettings;
 }>;
 /**
- * 资源类型枚举
+ * Resource type enumeration
  */
 export declare enum ResourceType {
     CAMERA = "camera",
@@ -22,6 +22,6 @@ export declare enum ResourceType {
     MODEL_GS = "gsStandard"
 }
 /**
- * 提取所有资源 URL
+ * Extract all resource URLs
  */
 export declare function extractResourceUrls(meta: CharacterMeta): Record<ResourceType, string | null>;

package/dist/types/index.d.ts

@@ -80,14 +80,6 @@ export declare class AvatarError extends Error {
     code?: (string | ErrorCode) | undefined;
     constructor(message: string, code?: (string | ErrorCode) | 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];

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

@@ -1,36 +1,6 @@
-import { Flame } from '../generated/driveningress/v1/driveningress';
 /**
- * 线性插值（旧实现）
- * @param from 起始 Flame
- * @param to 目标 Flame
- * @param progress 进度 (0-1)
+ * Animation Interpolation Utilities (SDK)
+ * Layered interpolation with different timing for each facial component
+ * Aligned with app implementation and iOS behavior
  */
-export declare function linearLerp(from: Flame, to: Flame, progress: number): Flame;
-/**
- * 使用线性插值生成过渡帧（旧实现，保留用于兼容）
- * @param from 起始 Flame
- * @param to 目标 Flame
- * @param durationMs 总过渡时长 (e.g. 400ms)
- * @param fps Frames per second (default 25)
- */
-export declare function generateTransitionFramesLinear(from: Flame, to: Flame, durationMs: number, fps?: number): Flame[];
-/**
- * Bezier 曲线插值（使用不同部位的不同曲线和时间缩放）
- * @param from 起始 Flame
- * @param to 目标 Flame
- * @param progress 全局进度 (0-1)
- */
-export declare function bezierLerp(from: Flame, to: Flame, progress: number): Flame;
-/**
- * Generate transition keyframes between two Flame states with layered timing
- * Different facial components transition at different speeds and timings
- * @param from 起始 Flame
- * @param to 目标 Flame
- * @param durationMs 总过渡时长 (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;
+export {};

package/dist/utils/client-id.d.ts

@@ -1,6 +1,6 @@
 /**
- * Client ID 管理工具
- * 用于生成和持久化用户设备唯一标识
+ * Client ID management utility
+ * Used to generate and persist unique device identifier
  * @internal
  */
 export {};

package/dist/utils/conversationId.d.ts

@@ -1,19 +1,10 @@
 /**
- * Conversation ID 生成工具
+ * Conversation ID generation utility
  *
- * 统一格式：时间戳（UTC时间，秒级，格式：YYYYMMDDHHmmss）+ 下划线 + 12位 NanoID
- * 示例：20251027143034_aB3dEf9hIjKl
+ * Unified format: timestamp (UTC time, second-level, format: YYYYMMDDHHmmss) + underscore + 12-digit NanoID
+ * Example: 20251027143034_aB3dEf9hIjKl
  *
- * 时间部分使用 UTC 时间，便于跨端日志排查时统一转换时区检索
+ * Time part uses UTC time for easier cross-platform log troubleshooting with unified timezone conversion
+ * @internal
  */
-/**
- * 生成统一的会话 ID
- *
- * 格式：时间戳（UTC时间，秒级，格式：YYYYMMDDHHmmss）+ 下划线 + 12位 NanoID
- * 时间部分使用 UTC 时间，便于跨端日志排查时统一转换时区检索
- *
- * @returns 格式为 YYYYMMDDHHmmss_nanoid 的会话 ID
- * @example
- * generateConversationId() // "20251027143034_aB3dEf9hIjKl"
- */
-export declare function generateConversationId(): string;
+export {};

package/dist/utils/id-manager.d.ts

@@ -1,10 +1,10 @@
 /**
- * ID 管理器
- * 统一管理 SDK 中所有类型的 ID
+ * ID Manager
+ * Unified management of all types of IDs in SDK
  * @internal
  */
 /**
- * ID 类型定义
+ * ID type definitions
  */
 export interface SdkIds {
     clientId: string;
@@ -24,41 +24,11 @@ declare class IdManager {
     getAppId(): string | null;
     setSessionToken(token: string | null): void;
     getSessionToken(): string | null;
-    /**
-     * 生成新的 connectionId（用于 WebSocket 连接）
-     */
-    generateConnectionId(): string;
-    /**
-     * 设置 connectionId（用于从服务器接收到的 connectionId）
-     */
-    setConnectionId(connectionId: string | null): void;
     getConnectionId(): string | null;
     clearConnectionId(): void;
-    /**
-     * 生成新的 conversationId（用于每次对话）
-     */
-    generateNewConversationId(): string;
     getConversationId(): string | null;
     setConversationId(conversationId: string | null): void;
     clearConversationId(): void;
-    /**
-     * 获取所有 ID（用于日志上报）
-     */
-    getAllIds(): Readonly<SdkIds>;
-    /**
-     * 获取公共日志参数（包含所有必要的 ID）
-     */
-    getLogContext(): {
-        client_id: string;
-        user_id: string;
-        app_id: string;
-        connection_id?: string;
-        conversation_id?: string;
-    };
-    /**
-     * 清理所有 ID（用于测试或重置）
-     */
-    clear(): void;
 }
 export declare const idManager: IdManager;
 export {};

package/dist/utils/logger.d.ts

@@ -1,11 +1,5 @@
 import { LogLevel as GuiiaiLogLevel } from '@guiiai/logg';
-import { LogLevel } from '../types';
 export declare const logger: import('@guiiai/logg').Logg;
-/**
- * 设置 SDK 日志等级
- * @param level SDK 的 LogLevel 枚举值
- */
-export declare function setLogLevel(level: LogLevel): void;
 export declare const loggerWithUnknown: {
     error: (message: string, error?: unknown) => void;
     warn: (message: string, error?: unknown) => void;

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

@@ -1,33 +1,8 @@
-import { Environment } from '../types';
 /**
- * 初始化 PostHog（需要传入环境信息和 SDK 版本）
+ * PostHog Telemetry Tool (Browser Version)
+ *
+ * Unified PostHog telemetry reporting, supports custom reporting
+ * Uses PostHog JS SDK for event tracking, suitable for browser environments
+ * @internal
  */
-export declare function initializePostHog(environment: Environment, version: string): void;
-/**
- * 上报事件到 PostHog
- * @param event 事件名称
- * @param level 日志级别
- * @param contents 事件内容
- */
-export declare function trackEvent(event: string, level?: 'debug' | 'info' | 'warning' | 'error', contents?: Record<string, unknown>): void;
-/**
- * 使用 sendBeacon 同步发送关键事件（用于页面关闭时）
- * PostHog 本身支持在页面关闭时自动发送，但我们可以手动触发
- * @param event 事件名称
- * @param level 日志级别
- * @param contents 事件内容
- * @returns 是否发送成功
- */
-export declare function sendEventViaBeacon(event: string, level?: 'debug' | 'info' | 'warning' | 'error', contents?: Record<string, unknown>): boolean;
-/**
- * 清理 PostHog（刷新剩余事件）
- */
-export declare function cleanupPostHog(): void;
-/**
- * 统一的 Telemetry 日志接口
- * 用于 SDK 内部上报日志到 PostHog
- * @param event 事件名称
- * @param level 日志级别
- * @param contents 日志内容
- */
-export declare function logEvent(event: string, level?: 'debug' | 'info' | 'warning' | 'error', contents?: Record<string, unknown>): void;
+export {};

package/dist/utils/pwa-cache-manager.d.ts

@@ -14,39 +14,4 @@ export declare class PwaCacheManager {
     private static readonly CHARACTER_CACHE_PREFIX;
     private static readonly CHARACTER_CACHE_SUFFIX;
     private static readonly MAX_CHARACTER_CACHE_ENTRIES;
-    /**
-     * 检查是否支持 Cache API
-     */
-    static isSupported(): boolean;
-    /**
-     * 获取角色缓存名称
-     */
-    private static getCharacterCacheName;
-    /**
-     * 从角色缓存获取资源
-     */
-    static getCharacterResource(characterId: string, url: string): Promise<ArrayBuffer | null>;
-    /**
-     * 将角色资源写入缓存
-     */
-    static putCharacterResource(characterId: string, url: string, data: ArrayBuffer): Promise<void>;
-    /**
-     * 从模板缓存获取资源
-     */
-    static getTemplateResource(url: string): Promise<ArrayBuffer | null>;
-    /**
-     * 将模板资源写入缓存
-     * 模板资源不设置数量限制，永久保留直到版本更新
-     */
-    static putTemplateResource(url: string, data: ArrayBuffer): Promise<void>;
-    /**
-     * 清理角色缓存
-     */
-    static clearCharacterCache(characterId: string): Promise<void>;
-    /**
-     * 检查模板缓存版本，如果版本变化则清理
-     * 使用独立的模板资源版本号（不依赖 SDK 版本），这样不同 SDK 版本可以共享相同模板资源的缓存
-     * @returns true 如果版本变化并清理了缓存，false 否则
-     */
-    static checkTemplateCacheVersion(): Promise<boolean>;
 }

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

@@ -1,20 +1,6 @@
 /**
- * 使用情况追踪工具
- * 用于判断首次使用、每日活跃等状态
+ * Usage tracking utility
+ * Used to determine first use, daily active status, etc.
  * @internal
  */
-/**
- * 检查是否为首次使用
- * @returns true 如果是首次使用，false 如果不是
- */
-export declare function isFirstUse(): boolean;
-/**
- * 检查今天是否已经活跃过
- * @returns true 如果今天首次活跃，false 如果今天已经活跃过
- */
-export declare function isDailyActive(): boolean;
-/**
- * 获取最后活跃日期
- * @returns 最后活跃日期（YYYY-MM-DD），如果不存在则返回 null
- */
-export declare function getLastActiveDate(): string | null;
+export {};

package/dist/wasm/avatarCoreAdapter.d.ts

@@ -1,8 +1,9 @@
 /**
- * Avatar Core WASM 适配器
+ * Avatar Core WASM Adapter
  *
- * 完全替换 FlameComplete3DGSManager，提供 avatar_core_wasm 的完整功能
- * 包括牙齿细分、眼部追踪等高级特性
+ * Completely replaces FlameComplete3DGSManager, provides full functionality of avatar_core_wasm
+ * Includes advanced features such as teeth subdivision, eye tracking, etc.
+ * @internal
  */
 export interface WasmModuleConfig {
     baseUrl?: string;
@@ -18,13 +19,6 @@ export interface AvatarCoreOptions {
     wasmConfig?: WasmModuleConfig;
     wasmPath?: string;
 }
-interface PerformanceMetrics {
-    initTime: number;
-    loadTime: number;
-    computeFrames: number;
-    totalComputeTime: number;
-    averageComputeTime: number;
-}
 export interface FlameInfo {
     vertexCount: number;
     faceCount: number;
@@ -65,60 +59,6 @@ export declare class AvatarCoreAdapter {
     private flameInfo?;
     private characterInfo?;
     constructor(options?: AvatarCoreOptions);
-    /**
-     * 加载 WASM 模块并设置 API
-     * 每次都创建全新的 WASM 实例，确保 C++ 内存是干净的
-     *
-     * 注意：这里使用动态 import() 导入 WASM 模块。
-     * Vite 在构建时会自动为 WASM 文件和 JS glue 代码添加 hash（如 avatar_core_wasm-CxWuw7eS.wasm），
-     * 确保浏览器缓存与版本一致，不会有缓存问题。
-     *
-     * Hash 的作用机制：
-     * - WASM 文件内容变化 → hash 自动变化 → URL 变化 → 浏览器拉取新版本
-     * - WASM 文件内容不变 → hash 保持不变 → URL 不变 → 浏览器使用缓存
-     * - Emscripten 生成的 JS 内部会使用 hard-coded 的 hash 路径加载 .wasm 文件
-     */
-    loadWASMModule(): Promise<void>;
-    /**
-     * 验证 WASM 模块功能
-     */
-    private validateWASMModule;
-    /**
-     * 初始化内存视图
-     */
-    private initializeMemoryViews;
-    /**
-     * 设置 C API 函数包装
-     */
-    private setupCAPIFunctions;
-    /**
-     * 读取当前动画帧的 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 核心
-     */
-    private initializeAvatarCore;
-    /**
-     * 加载模板资源（从预加载的 ArrayBuffers）
-     */
-    loadTemplateResourcesFromBuffers(templateResources: Record<string, ArrayBuffer>): Promise<boolean>;
-    /**
-     * 加载角色数据（从预加载的 ArrayBuffers）
-     */
-    /**
-     * 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)
@@ -128,121 +68,10 @@ export declare class AvatarCoreAdapter {
      */
     loadAnimationFromBuffer(animData: ArrayBuffer, characterId?: string): Promise<number>;
     switchAnimationFile(animationFile: string): Promise<number>;
-    /**
-     * 获取动画总帧数
-     * @param animationHandle Optional animation handle (for multi-character support)
-     */
-    getAnimationTotalFrames(animationHandle?: number): Promise<number>;
-    /**
-     * 从动画中获取指定帧的参数
-     * @param frameIndex Frame index
-     * @param characterId Optional character ID for multi-character support
-     */
-    getAnimationFrameParams(frameIndex?: number, characterId?: string): Promise<number>;
-    /**
-     * 设置眼部追踪配置（对齐 app 实现）
-     * @param config Eye tracking configuration
-     * @param characterId Optional character ID for multi-character support
-     */
-    setEyeTrackingConfig(config: {
-        enabled: boolean;
-        auto_eyelid_adjustment?: boolean;
-        eyelid_threshold?: number;
-    }, characterId?: string): Promise<boolean>;
-    /**
-     * 设置眼部追踪目标（高级功能）
-     * @param x Target X coordinate
-     * @param y Target Y coordinate
-     * @param z Target Z coordinate
-     * @param characterId Optional character ID for multi-character support
-     */
-    setGazeTarget(x: number, y: number, z: number, characterId?: string): Promise<boolean>;
-    /**
-     * 重置眼部追踪
-     */
-    resetEyeTracking(): Promise<boolean>;
-    /**
-     * 查询 FLAME 模型信息
-     */
-    private queryFlameInfo;
-    /**
-     * 查询角色信息
-     */
-    private queryCharacterInfo;
-    /**
-     * 检查错误码并抛出异常
-     */
-    private checkError;
-    /**
-     * 更新进度回调
-     */
-    private updateProgress;
-    /**
-     * 获取性能指标
-     */
-    getPerformanceMetrics(): PerformanceMetrics & {
-        flameInfo?: FlameInfo;
-        characterInfo?: CharacterInfo;
-        version?: string;
-    };
-    /**
-     * 获取角色的点云数量
-     * @param characterHandle 角色 handle（可选，默认使用当前角色）
-     * @returns 点云数量，如果角色未加载则返回 null
-     */
-    getPointCount(characterHandle?: number): number | null;
-    /**
-     * 释放当前角色和动画资源（但保留 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）
-     */
-    release(): void;
-    /**
-     * 兼容性接口：提供与 FlameComplete3DGSManager 相同的接口
-     */
-    loadFlameModel(_modelData: any): Promise<boolean>;
     load3DGSData(_original3DGSPoints: any, _binding: any, _flameFaces: any): Promise<boolean>;
-    /**
-     * 计算帧并返回 GPU 友好的 flat 格式（零拷贝，协方差预计算）
-     * 🚀 性能优化版本：
-     * - C++ 预计算协方差矩阵
-     * - 零拷贝直接访问 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;
-    }, characterHandle?: number): Promise<Float32Array | null>;
-    /**
-     * 计算帧并返回 GPU 友好的 flat 格式（从 FLAME 参数）
-     * 🔑 用于 Realtime: 接受自定义 FLAME 参数并计算 Splat
-     */
-    /**
-     * 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 {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@spatialwalk/avatarkit",
   "type": "module",
-  "version": "1.0.0-beta.69",
+  "version": "1.0.0-beta.70",
   "packageManager": "pnpm@10.18.2",
   "description": "AvatarKit SDK - 3D Gaussian Splatting Avatar Rendering SDK",
   "author": "AvatarKit Team",