@spatialwalk/avatarkit 1.0.0-beta.80 → 1.0.0-beta.82

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

@@ -1,79 +0,0 @@
-import { I3DGSRenderer, Transform } from '../renderer';
-export declare class WebGPURenderer implements I3DGSRenderer {
-    private canvas;
-    private backgroundColor;
-    private device;
-    private context;
-    private renderPipeline;
-    private renderTexturePipeline;
-    private quadVertexBuffer;
-    private uniformBuffer;
-    private uniformBindGroup;
-    private sortIndexBuffer;
-    private splatDataBuffer;
-    private storageBindGroup;
-    private bindGroupNeedsUpdate;
-    private splatCount;
-    private presentationFormat;
-    private alpha;
-    private renderTexture;
-    private renderTextureView;
-    private depthTexture;
-    private framebufferWidth;
-    private framebufferHeight;
-    private blitPipeline;
-    private blitUniformBuffer;
-    private blitQuadBuffer;
-    private blitSampler;
-    constructor(canvas: HTMLCanvasElement, backgroundColor?: [number, number, number, number], alpha?: boolean);
-    /**
-     * 初始化 WebGPU 渲染器
-     */
-    initialize(): Promise<void>;
-    /**
-     * 创建 Uniform Buffer
-     */
-    private createUniformBuffer;
-    /**
-     * 创建四边形顶点缓冲区（实例化渲染用）
-     */
-    private createQuadVertexBuffer;
-    /**
-     * 创建 Render Pipeline
-     */
-    private createRenderPipeline;
-    /**
-     * 创建 Blit Pipeline（用于绘制 render texture 到屏幕）
-     */
-    private createBlitPipeline;
-    /**
-     * 创建 render texture 和 depth texture
-     */
-    private createRenderTexture;
-    /**
-     * 从已打包数据加载
-     * 🚀 间接索引渲染：packedData 是原始数据，sortOrder 是排序索引
-     * 🚀 完全消除 CPU 重排序开销
-     */
-    loadSplatsFromPackedData(packedData: Float32Array, pointCount: number, sortOrder?: Uint32Array): void;
-    /**
-     * 渲染一帧
-     */
-    render(viewMatrix: Float32Array, projectionMatrix: Float32Array, screenSize: [number, number], transform?: Transform): void;
-    /**
-     * 将 render texture 绘制到屏幕（应用 transform）
-     */
-    private blitToScreen;
-    /**
-     * 更新 Uniform Buffer
-     */
-    private updateUniforms;
-    /**
-     * 更新背景颜色
-     */
-    updateBackgroundColor(backgroundColor: [number, number, number, number]): void;
-    /**
-     * 清理资源
-     */
-    dispose(): void;
-}

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

@@ -1,8 +0,0 @@
-/**
- * Animation Interpolation Utilities (SDK)
- * Layered interpolation with different timing for each facial component
- * Aligned with app implementation and iOS/Android behavior
- *
- * 贝塞尔曲线和时间缩放配置与 Android FlameFrameData.kt 保持一致
- */
-export {};

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

@@ -1,6 +0,0 @@
-/**
- * Client ID management utility
- * Used to generate and persist unique device identifier
- * @internal
- */
-export {};

package/dist/utils/conversationId.d.ts

@@ -1,10 +0,0 @@
-/**
- * Conversation ID generation utility
- *
- * Unified format: timestamp (UTC time, second-level, format: YYYYMMDDHHmmss) + underscore + 12-digit NanoID
- * Example: 20251027143034_aB3dEf9hIjKl
- *
- * Time part uses UTC time for easier cross-platform log troubleshooting with unified timezone conversion
- * @internal
- */
-export {};

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

@@ -1,26 +0,0 @@
-/**
- * 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;

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

@@ -1,34 +0,0 @@
-/**
- * ID Manager
- * Unified management of all types of IDs in SDK
- * @internal
- */
-/**
- * ID type definitions
- */
-export interface SdkIds {
-    clientId: string;
-    userId: string | null;
-    appId: string | null;
-    sessionToken: string | null;
-    connectionId: string | null;
-    conversationId: string | null;
-}
-declare class IdManager {
-    private ids;
-    constructor();
-    getClientId(): string;
-    setUserId(userId: string | null): void;
-    getUserId(): string | null;
-    setAppId(appId: string | null): void;
-    getAppId(): string | null;
-    setSessionToken(token: string | null): void;
-    getSessionToken(): string | null;
-    getConnectionId(): string | null;
-    clearConnectionId(): void;
-    getConversationId(): string | null;
-    setConversationId(conversationId: string | null): void;
-    clearConversationId(): void;
-}
-export declare const idManager: IdManager;
-export {};

package/dist/utils/log-sanitizer.d.ts

@@ -1,15 +0,0 @@
-/**
- * Log sanitizer for local log persistence.
- * Ensures: no sensitive content, no Chinese, no algorithm/internal terms (e.g. Flame, splat).
- * @internal
- */
-export interface SanitizeResult {
-    shouldPersist: boolean;
-    sanitized: string;
-}
-/**
- * Sanitize a log message for local persistence.
- * - Do not persist if message contains Chinese or algorithm terms.
- * - Otherwise persist, but redact sensitive content first.
- */
-export declare function sanitizeForLocalLog(message: string): SanitizeResult;

package/dist/utils/log-sink.d.ts

@@ -1,47 +0,0 @@
-/**
- * Log Sink - Local log storage and upload
- * Stores logs in IndexedDB and provides upload functionality
- * @internal
- */
-declare class LogSink {
-    private static instance;
-    private db;
-    private readonly dbName;
-    private readonly storeName;
-    private readonly version;
-    private readonly trimThreshold;
-    private readonly trimBufferSize;
-    private isFlushing;
-    private constructor();
-    static getInstance(): LogSink;
-    /**
-     * Initialize IndexedDB
-     */
-    initialize(): Promise<void>;
-    /**
-     * Append log entry to IndexedDB
-     */
-    append(entry: LogEntry): Promise<void>;
-    /**
-     * Get total log count
-     */
-    private getCount;
-    /**
-     * Trim logs to keep only recent entries
-     */
-    private trim;
-    /**
-     * Flush logs to server
-     */
-    flush(): Promise<void>;
-    /**
-     * Clear first N log entries
-     */
-    private clearFirst;
-    /**
-     * Gzip string data
-     */
-    private gzip;
-}
-export declare const logSink: LogSink;
-export {};

package/dist/utils/logger.d.ts

@@ -1,25 +0,0 @@
-/**
- * Logger Utility
- * Environment-aware logger wrapper with local log persistence
- * - Always writes to local log file (IndexedDB) regardless of logLevel
- * - Console output is controlled by logLevel
- * - Errors and warnings are always reported to PostHog (when enabled)
- *
- * Usage: Replace `console.log()` with `logger.log()`
- */
-export declare const logger: {
-    debug: (message: string, ...args: unknown[]) => void;
-    verbose: (message: string, ...args: unknown[]) => void;
-    log: (message: string, ...args: unknown[]) => void;
-    warn: (message: string, ...args: unknown[]) => void;
-    error: (message: string, ..._args: unknown[]) => void;
-    errorWithError: (message: string, error: Error | unknown) => void;
-};
-export declare const loggerWithUnknown: {
-    error: (message: string, error?: unknown) => void;
-    warn: (message: string, error?: unknown) => void;
-    debug: (message: string, ...args: unknown[]) => void;
-    verbose: (message: string, ...args: unknown[]) => void;
-    log: (message: string, ...args: unknown[]) => void;
-    errorWithError: (message: string, error: Error | unknown) => void;
-};

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

@@ -1,8 +0,0 @@
-/**
- * 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 {};

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

@@ -1,17 +0,0 @@
-/**
- * PWA Cache Manager
- * Manages Service Worker Cache for character resources and template resources
- * @internal
- */
-/**
- * PWA Cache Manager
- * Manages character resources cache (per character) and template resources cache (versioned)
- */
-export declare class PwaCacheManager {
-    private static readonly TEMPLATE_RESOURCE_VERSION;
-    private static readonly TEMPLATE_CACHE_NAME;
-    private static readonly TEMPLATE_VERSION_STORAGE_KEY;
-    private static readonly CHARACTER_CACHE_PREFIX;
-    private static readonly CHARACTER_CACHE_SUFFIX;
-    private static readonly MAX_CHARACTER_CACHE_ENTRIES;
-}

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

@@ -1,6 +0,0 @@
-/**
- * Usage tracking utility
- * Used to determine first use, daily active status, etc.
- * @internal
- */
-export {};

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

@@ -1,2 +0,0 @@
-declare const _default: any;
-export default _default;

package/dist/wasm/avatarCoreAdapter.d.ts

@@ -1,77 +0,0 @@
-/**
- * Avatar Core WASM Adapter
- *
- * 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;
-    [key: string]: unknown;
-}
-export interface AvatarCoreOptions {
-    logLevel?: 'basic' | 'verbose';
-    enableValidation?: boolean;
-    enablePerformanceMetrics?: boolean;
-    retryCount?: number;
-    baseAssetsPath?: string;
-    modelFolder?: string;
-    wasmConfig?: WasmModuleConfig;
-    wasmPath?: string;
-}
-export interface FlameInfo {
-    vertexCount: number;
-    faceCount: number;
-    jointCount: number;
-}
-export interface CharacterInfo {
-    pointCount: number;
-    hasAnimation: boolean;
-}
-export interface FlameParams {
-    shape_params?: number[];
-    expr_params?: number[];
-    rotation?: number[];
-    translation?: number[];
-    neck_pose?: number[];
-    jaw_pose?: number[];
-    eyes_pose?: number[];
-    eyelid?: number[];
-    has_eyelid?: boolean;
-}
-export declare class AvatarCoreAdapter {
-    private options;
-    private wasmConfig;
-    private wasmModule;
-    private memoryManager;
-    private coreHandle;
-    private characterHandles;
-    private animationHandles;
-    private characterHandle;
-    private animationHandle;
-    private totalFrames;
-    private isInitialized;
-    private isCharacterLoaded;
-    private api;
-    private performanceMetrics;
-    wasmTime: number;
-    private errorCodes;
-    private flameInfo?;
-    private characterInfo?;
-    constructor(options?: AvatarCoreOptions);
-    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, characterId?: string): Promise<number>;
-    switchAnimationFile(animationFile: string): Promise<number>;
-    /**
-     * Release current character (legacy method, kept for backward compatibility)
-     * @deprecated Use removeCharacter() instead for multi-character support
-     */
-    releaseCurrentCharacter(): void;
-    load3DGSData(_original3DGSPoints: any, _binding: any, _flameFaces: any): Promise<boolean>;
-}

package/dist/wasm/avatarCoreMemory.d.ts

@@ -1,144 +0,0 @@
-/**
- * Avatar Core WASM 内存管理工具
- *
- * 提供高效的内存分配、数据传递和零拷贝访问功能
- * 专门为 avatar_core_wasm 优化
- */
-interface WASMModule {
-    _malloc: (size: number) => number;
-    _free: (ptr: number) => void;
-    writeArrayToMemory: (array: Uint8Array, ptr: number) => void;
-    HEAPU8: Uint8Array;
-    HEAP32: Int32Array;
-    HEAPF32: Float32Array;
-    getValue: (ptr: number, type: string) => number;
-    setValue: (ptr: number, value: number, type: string) => void;
-}
-interface MemoryAllocation {
-    ptr: number;
-    size: number;
-}
-export interface TemplateResources {
-    flameModel: ArrayBuffer;
-    flameTemplate: ArrayBuffer;
-    teethPb: ArrayBuffer;
-    teethNpz: ArrayBuffer;
-}
-export interface CharacterData {
-    shape: ArrayBuffer;
-    pointCloud: ArrayBuffer;
-}
-export interface ExpressionParams {
-    expression?: number[];
-    jaw?: number[];
-    eyeR?: number[];
-    eyeL?: number[];
-    pose?: number[];
-    neck?: number[];
-    translation?: number[];
-}
-export interface ArrayMetadata {
-    ptr: number;
-    size: number;
-    dtype: string;
-}
-export declare class AvatarCoreMemoryManager {
-    private module;
-    private allocatedPointers;
-    private structPointers;
-    constructor(wasmModule: WASMModule);
-    /**
-     * 分配 WASM 内存并复制数据 - 纯 API 方式
-     */
-    allocateAndCopy(arrayBuffer: ArrayBuffer): MemoryAllocation;
-    /**
-     * 创建 AvatarTemplateConfig 结构体
-     */
-    createTemplateConfig(resources: TemplateResources): number;
-    /**
-     * 创建 AvatarCharacterData 结构体 - 新版 Emscripten 方式
-     */
-    createCharacterData(shapeBuffer: ArrayBuffer, plyBuffer: ArrayBuffer, characterId?: string): {
-        dataPtr: number;
-        shapePtr: number;
-        plyPtr: number;
-    };
-    /**
-     * 读取 AvatarFlameParams 结构体数据
-     * Used to extract current animation frame parameters from WASM memory
-     */
-    readFlameParams(paramsPtr: number): {
-        shape_params: number[];
-        expr_params: number[];
-        rotation: number[];
-        translation: number[];
-        neck_pose: number[];
-        jaw_pose: number[];
-        eyes_pose: number[];
-        eyelid: number[];
-        has_eyelid: boolean;
-    };
-    /**
-     * 创建 AvatarFlameParams 结构体 - 新版 Emscripten 方式
-     */
-    createFlameParams(params: {
-        shape_params?: number[];
-        expr_params?: number[];
-        rotation?: number[];
-        translation?: number[];
-        neck_pose?: number[];
-        jaw_pose?: number[];
-        eyes_pose?: number[];
-        eyelid?: number[];
-        has_eyelid?: boolean;
-    }): number;
-    /**
-     * 读取 AvatarSplatPointFlatArray 结构体数据（预计算协方差）
-     *
-     * 结构体布局:
-     * - AvatarSplatPointFlat* points (0-3, 32位指针)
-     * - uint32_t point_count (4-7)
-     * - float compute_time_ms (8-11)
-     *
-     * 每个点布局 (52 bytes):
-     * - position[3]   (12 bytes)
-     * - color[4]      (16 bytes, RGBA)
-     * - covariance[6] (24 bytes, 预计算好的协方差矩阵上三角)
-     *
-     * ⚠️ 使用 getValue 逐个读取，避免动态内存的 HEAPF32 detachment 问题
-     */
-    readSplatPointFlatArray(arrayPtr: number): Float32Array | null;
-    /**
-     * 读取AvatarMeshData结构体数据
-     */
-    readMeshData(outputPtr: number): {
-        vertices: Float32Array;
-        vertexCount: number;
-        faces: Uint32Array;
-        faceCount: number;
-        landmarks: Float32Array | null;
-        landmarkCount: number;
-        computeTime: number;
-    };
-    /**
-     * 释放指定指针的内存
-     */
-    free(ptr: number): void;
-    /**
-     * 释放结构体内存
-     */
-    freeStruct(name: string): void;
-    /**
-     * 清理所有分配的内存
-     */
-    cleanup(): void;
-    /**
-     * 获取内存使用统计
-     */
-    getMemoryStats(): {
-        allocatedPointers: number;
-        structPointers: number;
-        totalAllocatedMB: number;
-    };
-}
-export {};