@spatialwalk/avatarkit 1.0.0-beta.62 → 1.0.0-beta.64

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@spatialwalk/avatarkit",
   "type": "module",
-  "version": "1.0.0-beta.62",
+  "version": "1.0.0-beta.64",
+  "packageManager": "pnpm@10.18.2",
   "description": "SPAvatar SDK - 3D Gaussian Splatting Avatar Rendering SDK",
   "author": "SPAvatar Team",
   "license": "MIT",
@@ -18,6 +19,10 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
+    "./vite": {
+      "types": "./vite.d.ts",
+      "import": "./vite.js"
+    },
     "./*": {
       "types": "./dist/*.d.ts",
       "import": "./dist/*.js"
@@ -29,10 +34,24 @@
   "files": [
     "README.md",
     "CHANGELOG.md",
-    "dist"
+    "dist",
+    "vite.js",
+    "vite.d.ts"
   ],
+  "scripts": {
+    "build": "SDK_BUILD=true vite build --mode library && npm run build:vite-plugin",
+    "build:vite-plugin": "tsc vite.ts --outDir . --module esnext --target es2020 --moduleResolution bundler --esModuleInterop --skipLibCheck --declaration --declarationMap",
+    "dev": "vite build --mode library --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "cd tests && pnpm test",
+    "test:watch": "cd tests && pnpm run test:watch",
+    "test:e2e": "cd tests && pnpm run test:e2e",
+    "test:perf": "cd tests && pnpm run test:perf"
+  },
   "peerDependencies": {
-    "@webgpu/types": "*"
+    "@webgpu/types": "*",
+    "vite": "^5.0.0"
   },
   "dependencies": {
     "@bufbuild/protobuf": "^2.10.0",
@@ -47,15 +66,5 @@
     "typescript": "^5.0.0",
     "vite": "^5.0.0",
     "vite-plugin-dts": "^4.5.4"
-  },
-  "scripts": {
-    "build": "SDK_BUILD=true vite build --mode library",
-    "dev": "vite build --mode library --watch",
-    "clean": "rm -rf dist",
-    "typecheck": "tsc --noEmit",
-    "test": "cd tests && pnpm test",
-    "test:watch": "cd tests && pnpm run test:watch",
-    "test:e2e": "cd tests && pnpm run test:e2e",
-    "test:perf": "cd tests && pnpm run test:perf"
   }
-}
+}

package/vite.d.ts

@@ -0,0 +1,20 @@
+import type { Plugin } from 'vite';
+/**
+ * Vite plugin for @spatialwalk/avatarkit
+ * Automatically handles WASM file configuration for development and production builds
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from 'vite'
+ * import { avatarkitVitePlugin } from '@spatialwalk/avatarkit/vite'
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     avatarkitVitePlugin()
+ *   ]
+ * })
+ * ```
+ */
+export declare function avatarkitVitePlugin(): Plugin;
+export default avatarkitVitePlugin;
+//# sourceMappingURL=vite.d.ts.map

package/vite.js

@@ -0,0 +1,110 @@
+import { copyFileSync, existsSync, writeFileSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Vite plugin for @spatialwalk/avatarkit
+ * Automatically handles WASM file configuration for development and production builds
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from 'vite'
+ * import { avatarkitVitePlugin } from '@spatialwalk/avatarkit/vite'
+ *
+ * export default defineConfig({
+ *   plugins: [
+ *     avatarkitVitePlugin()
+ *   ]
+ * })
+ * ```
+ */
+export function avatarkitVitePlugin() {
+    let rootDir;
+    return {
+        name: 'avatarkit-wasm',
+        // 保存项目根目录
+        configResolved(config) {
+            rootDir = config.root;
+        },
+        // 开发服务器 MIME 类型配置
+        configureServer(server) {
+            server.middlewares.use((req, res, next) => {
+                if (req.url?.endsWith('.wasm')) {
+                    res.setHeader('Content-Type', 'application/wasm');
+                }
+                next();
+            });
+        },
+        // 构建时自动复制 WASM 文件和生成 headers
+        closeBundle() {
+            if (!rootDir)
+                return;
+            // 查找 node_modules 中的 WASM 文件
+            const wasmSource = join(rootDir, 'node_modules/@spatialwalk/avatarkit/dist/avatar_core_wasm.wasm');
+            // 查找 node_modules 中的 WASM JS glue 文件
+            // 注意：Vite 可能会给 JS 文件加 hash，所以我们需要查找所有可能的文件
+            const wasmJsSourcePattern = join(rootDir, 'node_modules/@spatialwalk/avatarkit/dist');
+            // 目标路径 - 根据实际使用情况，WASM 文件应该在 assets 目录
+            // 因为 Vite 通常会把资源放在 assets 目录，而 SDK 代码使用相对路径导入
+            const wasmDest = join(rootDir, 'dist/assets/avatar_core_wasm.wasm');
+            const wasmJsDest = join(rootDir, 'dist/assets/avatar_core_wasm.js');
+            const headersDest = join(rootDir, 'dist/_headers');
+            // 复制 WASM 文件
+            if (existsSync(wasmSource)) {
+                copyFileSync(wasmSource, wasmDest);
+                console.log('✅ [avatarkit] Copied WASM file to dist/assets/avatar_core_wasm.wasm');
+            }
+            else {
+                console.warn('⚠️ [avatarkit] WASM file not found at:', wasmSource);
+            }
+            // 尝试查找并复制 WASM JS glue 文件
+            // 由于 Vite 可能会给文件加 hash，我们尝试查找匹配的文件
+            try {
+                if (existsSync(wasmJsSourcePattern)) {
+                    const files = readdirSync(wasmJsSourcePattern);
+                    const wasmJsFile = files.find((f) => f.startsWith('avatar_core_wasm') && f.endsWith('.js'));
+                    if (wasmJsFile) {
+                        const wasmJsSource = join(wasmJsSourcePattern, wasmJsFile);
+                        copyFileSync(wasmJsSource, wasmJsDest);
+                        console.log(`✅ [avatarkit] Copied WASM JS file to dist/assets/avatar_core_wasm.js (from ${wasmJsFile})`);
+                    }
+                    else {
+                        console.log('ℹ️ [avatarkit] WASM JS file not found (may be handled by Vite):', wasmJsSourcePattern);
+                    }
+                }
+            }
+            catch (error) {
+                // 如果读取目录失败，不报错，因为 Vite 可能已经处理了 JS 文件
+                console.log('ℹ️ [avatarkit] Could not find WASM JS file (may be handled by Vite)');
+            }
+            // 生成 _headers 文件（用于 Cloudflare Pages 等平台）
+            const headersContent = '/*.wasm\n  Content-Type: application/wasm\n';
+            writeFileSync(headersDest, headersContent);
+            console.log('✅ [avatarkit] Created _headers file for Cloudflare Pages');
+        },
+        // 自动配置 Vite 选项
+        config() {
+            return {
+                optimizeDeps: {
+                    exclude: ['@spatialwalk/avatarkit']
+                },
+                assetsInclude: ['**/*.wasm'],
+                build: {
+                    assetsInlineLimit: 0, // 确保 WASM 文件不被内联
+                    rollupOptions: {
+                        output: {
+                            assetFileNames: (assetInfo) => {
+                                // WASM 文件使用固定名称
+                                if (assetInfo.name?.endsWith('.wasm')) {
+                                    return 'assets/[name][extname]';
+                                }
+                                // 其他资源使用 hash
+                                return 'assets/[name]-[hash][extname]';
+                            }
+                        }
+                    }
+                }
+            };
+        }
+    };
+}
+// 默认导出
+export default avatarkitVitePlugin;