@spatialwalk/avatarkit 1.0.0-beta.27 → 1.0.0-beta.29

package/dist/index.d.ts

@@ -1,9 +1,6 @@
-/**
- * SPAvatar SDK - 统一公开接口
- */
 export { Avatar } from './core/Avatar';
 export { AvatarController } from './core/AvatarController';
-export { AvatarKit } from './core/AvatarKit';
+export { AvatarSDK } from './core/AvatarSDK';
 export { AvatarManager } from './core/AvatarManager';
 export { AvatarView } from './core/AvatarView';
 export * from './types';

package/dist/index.js

@@ -1,19 +1,19 @@
-import { b as e, c as s, d as t, f as o, j as v, g as n, C as i, i as A, D as c, E as S, k as g, h as C, L as d, R as l, S as E, m as L } from "./index-s9KqPWVW.js";
+import { b, c, f, d, j, g, C, i, D, E, k, h, L, R, S, m } from "./index-BpVIIm3g.js";
 export {
-  e as Avatar,
-  s as AvatarController,
-  t as AvatarKit,
-  o as AvatarManager,
-  v as AvatarState,
-  n as AvatarView,
-  i as ConnectionState,
-  A as ConversationState,
-  c as DrivingServiceMode,
-  S as Environment,
-  g as ErrorCode,
-  C as LoadProgress,
-  d as LogLevel,
-  l as ResourceType,
-  E as SPAvatarError,
-  L as extractResourceUrls
+  b as Avatar,
+  c as AvatarController,
+  f as AvatarManager,
+  d as AvatarSDK,
+  j as AvatarState,
+  g as AvatarView,
+  C as ConnectionState,
+  i as ConversationState,
+  D as DrivingServiceMode,
+  E as Environment,
+  k as ErrorCode,
+  h as LoadProgress,
+  L as LogLevel,
+  R as ResourceType,
+  S as SPAvatarError,
+  m as extractResourceUrls
 };

package/dist/renderer/RenderSystem.d.ts

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

package/dist/renderer/covariance.d.ts

@@ -1,12 +1 @@
-/**
- * 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[][];

package/dist/renderer/sortSplats.d.ts

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

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

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

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

@@ -12,54 +12,18 @@ export declare class WebGLRenderer implements I3DGSRenderer {
     private splatCount;
     private isInitialized;
     private splatBufferSize;
-    constructor(canvas: HTMLCanvasElement, backgroundColor?: [number, number, number, number]);
-    /**
-     * 初始化 WebGL 渲染器
-     */
+    constructor(canvas: HTMLCanvasElement, backgroundColor?: [number, number, number, number], alpha?: boolean);
+    private alpha;
     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;
-    /**
-     * 清理资源
-     */
+    updateBackgroundColor(backgroundColor: [number, number, number, number]): void;
     dispose(): void;
 }

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

@@ -15,39 +15,15 @@ export declare class WebGPURenderer implements I3DGSRenderer {
     private bindGroupNeedsUpdate;
     private splatCount;
     private presentationFormat;
-    constructor(canvas: HTMLCanvasElement, backgroundColor?: [number, number, number, number]);
-    /**
-     * 初始化 WebGPU 渲染器
-     */
+    private alpha;
+    constructor(canvas: HTMLCanvasElement, backgroundColor?: [number, number, number, number], alpha?: boolean);
     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;
-    /**
-     * 清理资源
-     */
+    updateBackgroundColor(backgroundColor: [number, number, number, number]): void;
     dispose(): void;
 }

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

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

package/dist/types/character.d.ts

@@ -1,8 +1,6 @@
 import { CharacterAsset } from '../generated/driveningress/v2/driveningress';
 import { CameraSettings, CharacterSettings } from './character-settings';
-/**
- * 角色元数据
- */
+
 export type CharacterMeta = CharacterAsset & {
     characterSettings?: CharacterSettings;
 };
@@ -12,16 +10,12 @@ export type PreloadResources<T> = {
 export type PreloadCameraSettings = PreloadResources<{
     camera: CameraSettings;
 }>;
-/**
- * 资源类型枚举
- */
+
 export declare enum ResourceType {
     CAMERA = "camera",
     ANIMATION_IDLE = "frameIdle",
     MODEL_SHAPE = "shape",
     MODEL_GS = "gsStandard"
 }
-/**
- * 提取所有资源 URL
- */
+
 export declare function extractResourceUrls(meta: CharacterMeta): Record<ResourceType, string | null>;

package/dist/types/index.d.ts

@@ -1,32 +1,26 @@
-/**
- * 统一公开类型 & 接口
- */
 export declare enum Environment {
     cn = "cn",
-    intl = "intl",
-    test = "test"
+    intl = "intl"
 }
 export declare enum DrivingServiceMode {
-    /** 由 SDK 直接驱动 */
+
     sdk = "sdk",
-    /** 由宿主应用驱动 */
+
     host = "host"
 }
 export declare enum LogLevel {
-    /** 关闭所有日志 */
+
     off = "off",
-    /** 仅错误日志 */
+
     error = "error",
-    /** 警告和错误日志 */
+
     warning = "warning",
-    /** 所有日志（信息、警告、错误），默认值 */
+
     all = "all"
 }
 export interface Configuration {
     readonly environment: Environment;
-    /** 驱动服务模式，默认为 sdk */
     readonly drivingServiceMode?: DrivingServiceMode;
-    /** 日志等级，默认为 all */
     readonly logLevel?: LogLevel;
 }
 export interface SdkConfigResponse {
@@ -34,7 +28,6 @@ export interface SdkConfigResponse {
         cn?: string;
         intl?: string;
         us?: string;
-        test?: string;
     };
 }
 export declare enum LoadProgress {
@@ -54,21 +47,21 @@ export declare enum ConnectionState {
     failed = "failed"
 }
 export declare enum ConversationState {
-    /** 呼吸态 */
+
     idle = "idle",
-    /** 播放态 */
+
     playing = "playing"
 }
 export declare enum ErrorCode {
-    /** AppID 不可识别（预留，未来要做 appID 校验逻辑） */
+
     appIDUnrecognized = "appIDUnrecognized",
-    /** Session Token 不可用 */
+
     sessionTokenInvalid = "sessionTokenInvalid",
-    /** Session Token 已过期 */
+
     sessionTokenExpired = "sessionTokenExpired",
-    /** 加载数字人元数据失败 */
+
     failedToFetchAvatarMetadata = "failedToFetchAvatarMetadata",
-    /** 下载数字人资产失败 */
+
     failedToDownloadAvatarAssets = "failedToDownloadAvatarAssets"
 }
 export declare class SPAvatarError extends Error {

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

@@ -1,16 +1,7 @@
 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;

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

@@ -1,6 +1 @@
-/**
- * Client ID 管理工具
- * 用于生成和持久化用户设备唯一标识
- * @internal
- */
 export {};

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

@@ -1,32 +1,11 @@
 import { Environment } from '../types';
-/**
- * 初始化 CLS（需要传入环境信息和 SDK 版本）
- */
+
 export declare function initializeCLS(environment: Environment, version: string): void;
-/**
- * 使用 sendBeacon 同步发送关键日志（用于页面关闭时）
- * @param event 事件名称
- * @param level 日志级别
- * @param contents 日志内容
- * @returns 是否发送成功
- */
+
 export declare function sendEventViaBeacon(event: string, level?: 'debug' | 'info' | 'warning' | 'error', contents?: Record<string, unknown>): boolean;
-/**
- * 上报日志到 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;
-/**
- * 统一的 Telemetry 日志接口
- * 用于 SDK 内部上报日志到 CLS
- * @param event 事件名称
- * @param level 日志级别
- * @param contents 日志内容
- */
+
 export declare function logEvent(event: string, level?: 'debug' | 'info' | 'warning' | 'error', contents?: Record<string, unknown>): void;

package/dist/utils/conversationId.d.ts

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

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

@@ -1,26 +1,3 @@
-/**
- * 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/heartbeat-manager.d.ts

@@ -6,38 +6,12 @@ declare class HeartbeatManager {
     private currentEnvironment;
     private currentAppId;
     private failureCount;
-    /**
-     * 启动心跳管理器
-     */
     start(environment: Environment): void;
-    /**
-     * 停止心跳管理器
-     */
     stop(): void;
-    /**
-     * 启动心跳定时器（每2分钟上报一次）
-     * @private
-     */
     private startHeartbeatTimer;
-    /**
-     * 停止心跳定时器
-     * @private
-     */
     private stopHeartbeatTimer;
-    /**
-     * 上报心跳事件
-     * @private
-     */
     private reportHeartbeat;
-    /**
-     * 设置页面可见性监听器（用于页面重新可见时立即上报心跳）
-     * @private
-     */
     private setupVisibilityListener;
-    /**
-     * 移除页面可见性监听器
-     * @private
-     */
     private removeVisibilityListener;
 }
 export declare const heartbeatManager: HeartbeatManager;

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

@@ -1,11 +1,3 @@
-/**
- * ID 管理器
- * 统一管理 SDK 中所有类型的 ID
- * @internal
- */
-/**
- * ID 类型定义
- */
 export interface SdkIds {
     clientId: string;
     userId: string | null;
@@ -24,26 +16,14 @@ declare class IdManager {
     getAppId(): string | null;
     setSessionToken(token: string | null): void;
     getSessionToken(): string | null;
-    /**
-     * 生成新的 connectionId（用于 WebSocket 连接）
-     */
     generateConnectionId(): string;
     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;
@@ -51,9 +31,6 @@ declare class IdManager {
         connection_id?: string;
         conversation_id?: string;
     };
-    /**
-     * 清理所有 ID（用于测试或重置）
-     */
     clear(): void;
 }
 export declare const idManager: IdManager;

package/dist/utils/logger.d.ts

@@ -1,10 +1,7 @@
 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;

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

@@ -1,20 +1,5 @@
-/**
- * 使用情况追踪工具
- * 用于判断首次使用、每日活跃等状态
- * @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;