@spatialwalk/avatarkit 1.0.0-beta.1

package/dist/utils/reqId.d.ts

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

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

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

package/dist/utils/toast.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Toast Utility Library
+ * 使用原生API替代vue-sonner，提供环境感知的提示功能
+ * - Only shows debug/info/success toasts in test/dev environment
+ * - Only shows fatal errors in production environment
+ * - Loading toasts show detailed content only in test/dev environment
+ */
+/**
+ * Toast options interface
+ */
+export interface ToastOptions {
+    description?: string;
+    duration?: number;
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+}
+/**
+ * Native Toast Implementation
+ * 使用原生API替代vue-sonner
+ */
+export declare const toast: {
+    /**
+     * Success toast - only shown in test/dev environment
+     */
+    success(_message: string, _options?: ToastOptions): string | number | undefined;
+    /**
+     * Error toast - only shown for fatal errors in production
+     * In dev/test, all errors are shown
+     */
+    error(_message: string, _options?: ToastOptions): string | number | undefined;
+    /**
+     * Info toast - only shown in test/dev environment
+     */
+    info(message: string, options?: ToastOptions): string | number | undefined;
+    /**
+     * Warning toast - only shown in test/dev environment
+     */
+    warning(message: string, options?: ToastOptions): string | number | undefined;
+    /**
+     * Loading toast - only shown in test/dev environment
+     */
+    loading(_message: string, _options?: ToastOptions): string | number | undefined;
+    /**
+     * Dismiss toast
+     */
+    dismiss(_toastId: string | number): void;
+    /**
+     * Custom toast - only shown in test/dev environment
+     */
+    custom(_component: unknown, _options?: ToastOptions): string | number | undefined;
+    /**
+     * Promise toast - only shown in test/dev environment
+     */
+    promise<T>(promise: Promise<T>, options: {
+        loading: string;
+        success: string | ((data: T) => string);
+        error: string | ((error: unknown) => string);
+    }): Promise<T>;
+};
+/**
+ * Export individual functions for convenience
+ */
+export declare const success: (_message: string, _options?: ToastOptions) => string | number | undefined, error: (_message: string, _options?: ToastOptions) => string | number | undefined, info: (message: string, options?: ToastOptions) => string | number | undefined, warning: (message: string, options?: ToastOptions) => string | number | undefined, loading: (_message: string, _options?: ToastOptions) => string | number | undefined, dismiss: (_toastId: string | number) => void, custom: (_component: unknown, _options?: ToastOptions) => string | number | undefined, promise: <T>(promise: Promise<T>, options: {
+    loading: string;
+    success: string | ((data: T) => string);
+    error: string | ((error: unknown) => string);
+}) => Promise<T>;
+/**
+ * Default export
+ */
+export default toast;
+//# sourceMappingURL=toast.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toast.d.ts","sourceRoot":"","sources":["../../utils/toast.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE;QACP,KAAK,EAAE,MAAM,CAAA;QACb,OAAO,EAAE,MAAM,IAAI,CAAA;KACpB,CAAA;CACF;AAED;;;GAGG;AACH,eAAO,MAAM,KAAK;IAChB;;OAEG;sBACe,MAAM,aAAa,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS;IAS/E;;;OAGG;oBACa,MAAM,aAAa,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS;IAU7E;;OAEG;kBACW,MAAM,YAAY,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS;IAS1E;;OAEG;qBACc,MAAM,YAAY,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS;IAS7E;;OAEG;sBACe,MAAM,aAAa,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS;IAQ/E;;OAEG;sBACe,MAAM,GAAG,MAAM,GAAG,IAAI;IAMxC;;OAEG;uBACgB,OAAO,aAAa,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS;IAQjF;;OAEG;YACK,CAAC,WACE,OAAO,CAAC,CAAC,CAAC,WACV;QACP,OAAO,EAAE,MAAM,CAAA;QACf,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC,CAAA;QACvC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,CAAA;KAC7C,GACA,OAAO,CAAC,CAAC,CAAC;CAoBd,CAAA;AAED;;GAEG;AACH,eAAO,MAAQ,OAAO,aAjHF,MAAM,aAAa,YAAY,KAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EAiHzD,KAAK,aApGX,MAAM,aAAa,YAAY,KAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EAoGhD,IAAI,YAvFnB,MAAM,YAAY,YAAY,KAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EAuFvC,OAAO,YA3EzB,MAAM,YAAY,YAAY,KAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EA2EjC,OAAO,aA/DjC,MAAM,aAAa,YAAY,KAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EA+D1B,OAAO,aApD1C,MAAM,GAAG,MAAM,KAAG,IAAI,EAoDsB,MAAM,eA3CjD,OAAO,aAAa,YAAY,KAAG,MAAM,GAAG,MAAM,GAAG,SAAS,EA2CX,OAAO,GAhCrE,CAAC,WACE,OAAO,CAAC,CAAC,CAAC,WACV;IACP,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC,CAAA;IACvC,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC,CAAA;CAC7C,KACA,OAAO,CAAC,CAAC,CAyB2E,CAAA;AAEzF;;GAEG;AACH,eAAe,KAAK,CAAA"}

package/dist/wasm/avatarCoreAdapter.d.ts

@@ -0,0 +1,188 @@
+import { AvatarCoreMemoryManager } from './avatarCoreMemory';
+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;
+}
+interface PerformanceMetrics {
+    initTime: number;
+    loadTime: number;
+    computeFrames: number;
+    totalComputeTime: number;
+    averageComputeTime: number;
+}
+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 characterHandle;
+    private animationHandle;
+    private totalFrames;
+    private isInitialized;
+    private isCharacterLoaded;
+    private api;
+    private performanceMetrics;
+    wasmTime: number;
+    private errorCodes;
+    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（用于过渡或调试）
+     */
+    getCurrentFrameParams(frameIndex?: number): Promise<FlameParams>;
+    /**
+     * 初始化 Avatar Core 核心
+     */
+    private initializeAvatarCore;
+    /**
+     * 加载模板资源（从预加载的 ArrayBuffers）
+     */
+    loadTemplateResourcesFromBuffers(templateResources: Record<string, ArrayBuffer>): Promise<boolean>;
+    /**
+     * 加载角色数据（从预加载的 ArrayBuffers）
+     */
+    loadCharacterFromBuffers(shapeBuffer: ArrayBuffer, pointCloudBuffer: ArrayBuffer): Promise<boolean>;
+    private loadAnimationFromData;
+    /**
+     * Load animation from ArrayBuffer (for CDN-based dynamic loading)
+     */
+    loadAnimationFromBuffer(animData: ArrayBuffer): Promise<number>;
+    switchAnimationFile(animationFile: string): Promise<number>;
+    /**
+     * 获取动画总帧数
+     */
+    getAnimationTotalFrames(): Promise<number>;
+    /**
+     * 从动画中获取指定帧的参数
+     */
+    getAnimationFrameParams(frameIndex?: number): Promise<number>;
+    /**
+     * 设置眼部追踪配置（对齐 app 实现）
+     */
+    setEyeTrackingConfig(config: {
+        enabled: boolean;
+        auto_eyelid_adjustment?: boolean;
+        eyelid_threshold?: number;
+    }): Promise<boolean>;
+    /**
+     * 设置眼部追踪目标（高级功能）
+     */
+    setGazeTarget(x: number, y: number, z: number): Promise<boolean>;
+    /**
+     * 重置眼部追踪
+     */
+    resetEyeTracking(): Promise<boolean>;
+    /**
+     * 查询 FLAME 模型信息
+     */
+    private queryFlameInfo;
+    /**
+     * 查询角色信息
+     */
+    private queryCharacterInfo;
+    /**
+     * 检查错误码并抛出异常
+     */
+    private checkError;
+    /**
+     * 更新进度回调
+     */
+    private updateProgress;
+    /**
+     * 获取性能指标
+     */
+    getPerformanceMetrics(): PerformanceMetrics & {
+        memoryStats?: ReturnType<AvatarCoreMemoryManager['getMemoryStats']>;
+        flameInfo?: FlameInfo;
+        characterInfo?: CharacterInfo;
+        version?: string;
+    };
+    /**
+     * 释放当前角色和动画资源（但保留 core）
+     */
+    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]
+     */
+    computeCompleteFrameFlat(params?: {
+        frameIndex?: number;
+    }): Promise<Float32Array | null>;
+    /**
+     * 计算帧并返回 GPU 友好的 flat 格式（从 FLAME 参数）
+     * 🔑 用于 Realtime: 接受自定义 FLAME 参数并计算 Splat
+     */
+    computeFrameFlatFromParams(flameParams: FlameParams): Promise<Float32Array | null>;
+}
+export {};
+//# sourceMappingURL=avatarCoreAdapter.d.ts.map

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

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

package/dist/wasm/avatarCoreMemory.d.ts

@@ -0,0 +1,141 @@
+/**
+ * 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): 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 {};
+//# sourceMappingURL=avatarCoreMemory.d.ts.map

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

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

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@spatialwalk/avatarkit",
+  "type": "module",
+  "version": "1.0.0-beta.1",
+  "packageManager": "pnpm@10.18.2",
+  "description": "SPAvatar SDK - 3D Gaussian Splatting Avatar Rendering SDK",
+  "author": "SPAvatar Team",
+  "license": "MIT",
+  "keywords": [
+    "avatar",
+    "3d",
+    "gaussian-splatting",
+    "webgl",
+    "webgpu",
+    "wasm"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./*": {
+      "types": "./dist/*.d.ts",
+      "import": "./dist/*.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "README.md",
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/spatialwalk/avatarkit-web-sdk.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "SDK_BUILD=true vite build --mode library",
+    "dev": "vite build --mode library --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "@webgpu/types": "*"
+  },
+  "dependencies": {
+    "@bufbuild/protobuf": "^2.10.0",
+    "@guiiai/logg": "^1.2.4",
+    "nanoid": "^5.1.6",
+    "posthog-js": "^1.275.3"
+  },
+  "devDependencies": {
+    "@webgpu/types": "^0.1.65",
+    "typescript": "^5.0.0",
+    "vite": "^5.0.0",
+    "vite-plugin-dts": "^4.5.4"
+  }
+}