@dreamerbird/camera-studio 0.1.0 → 0.3.0

package/dist/assetLibrary/exportGLB.test.js

@@ -1,5 +1,5 @@
-import { Bone, BoxGeometry, Group, Mesh, MeshBasicMaterial, MeshStandardMaterial, Texture, } from 'three';
-import { cloneBoneTree, exportModelGLB, stripInvalidTextures } from './exportGLB';
+import { Bone, Box3, BoxGeometry, Group, Mesh, MeshBasicMaterial, MeshStandardMaterial, Texture, Vector3, } from 'three';
+import { CENTIMETER_SOURCE_THRESHOLD, bakeMetricScale, cloneBoneTree, exportModelGLB, metricScaleFactor, stripInvalidTextures, } from './exportGLB';
 describe('cloneBoneTree', () => {
     it('只保留骨骼节点(名字/变换),剔除网格', () => {
         const root = new Group();
@@ -70,4 +70,58 @@ describe('exportModelGLB', () => {
         expect(glb.byteLength).toBeGreaterThan(0);
         expect(mat.map).toBeNull();
     });
+    it('入库时把厘米源换算成米烘进根节点缩放(放置时缩放基线才是 1)', async () => {
+        // 模拟 Mixamo FBX 厘米单位:180 单位高的人
+        const root = new Group();
+        root.add(new Mesh(new BoxGeometry(50, 180, 30), new MeshBasicMaterial()));
+        const glb = await exportModelGLB(root);
+        expect(glb.byteLength).toBeGreaterThan(0);
+        expect(root.scale.x).toBeCloseTo(0.01, 6);
+        expect(root.scale.y).toBe(root.scale.x);
+        expect(root.scale.z).toBe(root.scale.x);
+    });
+});
+describe('metricScaleFactor', () => {
+    it('厘米源(超过阈值)换算 0.01,米源不动', () => {
+        expect(metricScaleFactor(180)).toBe(0.01);
+        expect(metricScaleFactor(1.8)).toBe(1);
+    });
+    it('阈值边界:恰好阈值按米,超过才按厘米', () => {
+        expect(metricScaleFactor(CENTIMETER_SOURCE_THRESHOLD)).toBe(1);
+        expect(metricScaleFactor(CENTIMETER_SOURCE_THRESHOLD + 0.01)).toBe(0.01);
+    });
+});
+describe('bakeMetricScale', () => {
+    it('厘米源烘成米制真实尺寸(180 高的人 → 1.8)', () => {
+        const root = new Group();
+        root.add(new Mesh(new BoxGeometry(50, 180, 30), new MeshBasicMaterial()));
+        expect(bakeMetricScale(root)).toBeCloseTo(0.01, 6);
+        expect(root.scale.x).toBeCloseTo(0.01, 6);
+        // 烘完最长边 = 1.8 场景单位(米),人高占比不变
+        const box = new Box3().setFromObject(root);
+        expect(box.getSize(new Vector3()).y).toBeCloseTo(1.8, 6);
+    });
+    it('米制模型不动(幂等,重烘已烘焙资产系数为 1)', () => {
+        const root = new Group();
+        root.add(new Mesh(new BoxGeometry(1.8, 1.8, 1.8), new MeshBasicMaterial()));
+        expect(bakeMetricScale(root)).toBe(1);
+        expect(root.scale.x).toBe(1);
+    });
+    it('空模型(无边几何时)返回 1 且不动缩放', () => {
+        const root = new Group();
+        expect(bakeMetricScale(root)).toBe(1);
+        expect(root.scale.x).toBe(1);
+    });
+    it('骨骼局部数据不受影响(动画轨道寻址的那层)', () => {
+        const root = new Group();
+        const hips = new Bone();
+        hips.name = 'Hips';
+        hips.position.set(0, 90, 0);
+        const mesh = new Mesh(new BoxGeometry(50, 180, 30), new MeshBasicMaterial());
+        hips.add(mesh);
+        root.add(hips);
+        bakeMetricScale(root);
+        expect(hips.position.y).toBe(90); // 只有根节点 scale 变了
+        expect(root.scale.x).toBeCloseTo(0.01, 6);
+    });
 });

package/dist/assetLibrary/gltfLoader.d.ts

@@ -1,8 +1,9 @@
+import type { LoadingManager } from 'three';
 import { GLTFLoader } from 'three-stdlib';
 /**
  * 统一创建 GLTFLoader:接 Draco 解码(解码器文件在 public/draco,
  * 从 three 原样拷贝)。未压缩的 GLB 走原路径,不受影响;
  * DRACOLoader 全局一个,解码 wasm 只加载一次。
  */
-export declare function createGLTFLoader(): GLTFLoader;
+export declare function createGLTFLoader(manager?: LoadingManager): GLTFLoader;
 //# sourceMappingURL=gltfLoader.d.ts.map

package/dist/assetLibrary/gltfLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gltfLoader.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/gltfLoader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,UAAU,EAAC,MAAM,cAAc,CAAA;AAIpD;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAG7C"}
+{"version":3,"file":"gltfLoader.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/gltfLoader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,OAAO,CAAA;AACzC,OAAO,EAAc,UAAU,EAAC,MAAM,cAAc,CAAA;AAIpD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAGrE"}

package/dist/assetLibrary/gltfLoader.js

@@ -5,7 +5,7 @@ let dracoLoader;
  * 从 three 原样拷贝)。未压缩的 GLB 走原路径,不受影响;
  * DRACOLoader 全局一个,解码 wasm 只加载一次。
  */
-export function createGLTFLoader() {
+export function createGLTFLoader(manager) {
     dracoLoader ?? (dracoLoader = new DRACOLoader().setDecoderPath('/draco/'));
-    return new GLTFLoader().setDRACOLoader(dracoLoader);
+    return new GLTFLoader(manager).setDRACOLoader(dracoLoader);
 }

package/dist/assetLibrary/gltfResourceSet.d.ts

@@ -0,0 +1,6 @@
+import { LoadingManager } from 'three';
+export declare function createResourceUrlModifier(files: File[]): {
+    manager: LoadingManager;
+    dispose(): void;
+};
+//# sourceMappingURL=gltfResourceSet.d.ts.map

package/dist/assetLibrary/gltfResourceSet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gltfResourceSet.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/gltfResourceSet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAC,MAAM,OAAO,CAAA;AAEpC,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,IAAI,EAAE;;;EAuBtD"}

package/dist/assetLibrary/gltfResourceSet.js

@@ -0,0 +1,27 @@
+import { LoadingManager } from 'three';
+export function createResourceUrlModifier(files) {
+    const urls = new Map();
+    const byName = new Map(files.map((file) => [file.name, file]));
+    const manager = new LoadingManager();
+    manager.setURLModifier((url) => {
+        if (/^(blob:|data:|https?:)/.test(url))
+            return url;
+        const name = decodeURIComponent(url.split('/').pop() ?? url);
+        const file = byName.get(name);
+        if (!file)
+            throw new Error(`GLTF 外部资源缺失: ${name}`);
+        let objectUrl = urls.get(name);
+        if (!objectUrl) {
+            objectUrl = URL.createObjectURL(file);
+            urls.set(name, objectUrl);
+        }
+        return objectUrl;
+    });
+    return {
+        manager,
+        dispose() {
+            urls.forEach((url) => URL.revokeObjectURL(url));
+            urls.clear();
+        },
+    };
+}

package/dist/assetLibrary/gltfResourceSet.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gltfResourceSet.test.d.ts.map

package/dist/assetLibrary/gltfResourceSet.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gltfResourceSet.test.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/gltfResourceSet.test.ts"],"names":[],"mappings":""}

package/dist/assetLibrary/gltfResourceSet.test.js

@@ -0,0 +1,40 @@
+import { createResourceUrlModifier } from './gltfResourceSet';
+describe('createResourceUrlModifier', () => {
+    const originalCreateObjectURL = URL.createObjectURL;
+    const originalRevokeObjectURL = URL.revokeObjectURL;
+    let nextId = 0;
+    beforeEach(() => {
+        URL.createObjectURL = jest.fn(() => `blob:resource-${++nextId}`);
+        URL.revokeObjectURL = jest.fn();
+    });
+    afterEach(() => {
+        URL.createObjectURL = originalCreateObjectURL;
+        URL.revokeObjectURL = originalRevokeObjectURL;
+    });
+    it('按相对 URI 的文件名映射并复用 object URL,dispose 全部回收', () => {
+        const bin = new File([new Uint8Array(36)], 'triangle.bin');
+        const png = new File(['png'], 'tiny pixel.png', { type: 'image/png' });
+        const resources = createResourceUrlModifier([bin, png]);
+        const binUrl = resources.manager.resolveURL('./geometry/triangle.bin');
+        const pngUrl = resources.manager.resolveURL('./textures/tiny%20pixel.png');
+        expect(resources.manager.resolveURL('triangle.bin')).toBe(binUrl);
+        expect(URL.createObjectURL).toHaveBeenCalledTimes(2);
+        resources.dispose();
+        expect(URL.revokeObjectURL).toHaveBeenCalledTimes(2);
+        expect(URL.revokeObjectURL).toHaveBeenCalledWith(binUrl);
+        expect(URL.revokeObjectURL).toHaveBeenCalledWith(pngUrl);
+    });
+    it('保留已有绝对资源 URL,缺失文件报出资源名', () => {
+        const resources = createResourceUrlModifier([]);
+        for (const url of [
+            'blob:existing',
+            'data:image/png;base64,x',
+            'https://example.com/a.bin',
+            'http://example.com/a.bin',
+        ]) {
+            expect(resources.manager.resolveURL(url)).toBe(url);
+        }
+        expect(() => resources.manager.resolveURL('./missing.bin')).toThrow('GLTF 外部资源缺失: missing.bin');
+        resources.dispose();
+    });
+});

package/dist/assetLibrary/importModelFile.d.ts

@@ -1,3 +1,8 @@
+/**
+ * 宿主外部模型入库:单文件兼容入口,委托 importModelFiles。
+ * 放置管线只认库条目(按 id 解析 blob),外部模型必须真实入库,
+ * 姿势/骨架匹配/持久化全部照常。library/deps 可注入(测试用)。
+ */
 import type { ImportDeps } from './importPipeline';
 import type { Library } from './library';
 import type { ModelEntry } from './types';

package/dist/assetLibrary/importModelFile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"importModelFile.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/importModelFile.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAA;AAEhD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AACtC,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,SAAS,CAAA;AAEvC,wBAAsB,eAAe,CACnC,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,OAAsB,EAC/B,IAAI,GAAE,UAA6B,GAClC,OAAO,CAAC,UAAU,CAAC,CAerB"}
+{"version":3,"file":"importModelFile.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/importModelFile.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,kBAAkB,CAAA;AAGhD,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AACtC,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,SAAS,CAAA;AAEvC,wBAAsB,eAAe,CACnC,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,OAAsB,EAC/B,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CAAC,UAAU,CAAC,CAGrB"}

package/dist/assetLibrary/importModelFile.js

@@ -1,19 +1,6 @@
-/**
- * 宿主外部模型入库:File → 既有导入管线(planImport/executeImport)。
- * 放置管线只认库条目(按 id 解析 blob),外部模型必须真实入库,
- * 姿势/骨架匹配/持久化全部照常。library/deps 可注入(测试用)。
- */
-import { planImport, executeImport, realImportDeps } from './importPipeline';
+import { importModelFiles } from './importModelFiles';
 import { getLibrary } from './library';
-export async function importModelFile(file, library = getLibrary(), deps = realImportDeps()) {
-    const before = new Set((await library.listEntries('model')).map((e) => e.id));
-    const plan = await planImport([file], library, deps);
-    // 宿主场景无"相似条目"交互,一律保留为新条目
-    await executeImport(plan, plan.similar.map(() => 'keep'), library);
-    const models = await library.listEntries('model');
-    const created = models.find((m) => !before.has(m.id));
-    if (!created || created.kind !== 'model') {
-        throw new Error('[hostFlows] 模型导入失败:未找到新建条目');
-    }
+export async function importModelFile(file, library = getLibrary(), deps) {
+    const [created] = await importModelFiles([file], library, deps);
     return created;
 }

package/dist/assetLibrary/importModelFiles.d.ts

@@ -0,0 +1,15 @@
+import { type ImportDeps } from './importPipeline';
+import { type Library } from './library';
+import type { ModelEntry } from './types';
+export type ImportFileFailure = {
+    file: string;
+    message: string;
+};
+export declare class ImportModelFilesError extends Error {
+    readonly entries: ModelEntry[];
+    readonly failedItems: ImportFileFailure[];
+    readonly cause: unknown;
+    constructor(entries: ModelEntry[], failedItems: ImportFileFailure[], cause: unknown);
+}
+export declare function importModelFiles(files: File[], library?: Library, deps?: ImportDeps): Promise<ModelEntry[]>;
+//# sourceMappingURL=importModelFiles.d.ts.map

package/dist/assetLibrary/importModelFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importModelFiles.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/importModelFiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,UAAU,EAEhB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAa,KAAK,OAAO,EAAC,MAAM,WAAW,CAAA;AAClD,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,SAAS,CAAA;AAEvC,MAAM,MAAM,iBAAiB,GAAG;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAC,CAAA;AAE/D,qBAAa,qBAAsB,SAAQ,KAAK;IAE5C,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE;IAC9B,QAAQ,CAAC,WAAW,EAAE,iBAAiB,EAAE;IACzC,QAAQ,CAAC,KAAK,EAAE,OAAO;gBAFd,OAAO,EAAE,UAAU,EAAE,EACrB,WAAW,EAAE,iBAAiB,EAAE,EAChC,KAAK,EAAE,OAAO;CAS1B;AASD,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,GAAE,OAAsB,EAC/B,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CAAC,UAAU,EAAE,CAAC,CAkDvB"}

package/dist/assetLibrary/importModelFiles.js

@@ -0,0 +1,58 @@
+import { executeImport, ImportItemWriteError, planImport, realImportDeps, } from './importPipeline';
+import { getLibrary } from './library';
+export class ImportModelFilesError extends Error {
+    constructor(entries, failedItems, cause) {
+        super(`模型导入部分失败: ${failedItems
+            .map((item) => `${item.file}: ${item.message}`)
+            .join('; ')}`);
+        this.entries = entries;
+        this.failedItems = failedItems;
+        this.cause = cause;
+        this.name = 'ImportModelFilesError';
+    }
+}
+function failureOf(item) {
+    return {
+        file: item.sourceFile ?? item.name,
+        message: item.type === 'skip' ? item.reason : '写入失败',
+    };
+}
+export async function importModelFiles(files, library = getLibrary(), deps) {
+    const before = new Set((await library.listEntries('model')).map((e) => e.id));
+    const modelFiles = files.filter((file) => /\.(glb|gltf|fbx)$/i.test(file.name));
+    const plan = await planImport(modelFiles, library, deps ?? realImportDeps(files));
+    const failedItems = plan.items
+        .filter((item) => item.type === 'skip' && !item.duplicate)
+        .map(failureOf);
+    let executeError;
+    try {
+        await executeImport(plan, plan.similar.map(() => 'keep'), library);
+    }
+    catch (error) {
+        executeError = error;
+        if (error instanceof ImportItemWriteError) {
+            const cause = error.cause;
+            failedItems.push({
+                ...failureOf(error.item),
+                message: cause instanceof Error ? cause.message : String(cause),
+            });
+        }
+        else {
+            failedItems.push({
+                file: 'unknown',
+                message: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    const entries = (await library.listEntries('model')).filter((entry) => entry.kind === 'model' && !before.has(entry.id));
+    if (executeError || failedItems.length > 0) {
+        const cause = executeError instanceof ImportItemWriteError
+            ? executeError.cause
+            : executeError;
+        throw new ImportModelFilesError(entries, failedItems, cause);
+    }
+    if (entries.length === 0) {
+        throw new Error('[hostFlows] 模型导入失败:未找到新建条目');
+    }
+    return entries;
+}

package/dist/assetLibrary/importModelFiles.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=importModelFiles.test.d.ts.map

package/dist/assetLibrary/importModelFiles.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"importModelFiles.test.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/importModelFiles.test.ts"],"names":[],"mappings":""}

package/dist/assetLibrary/importModelFiles.test.js

@@ -0,0 +1,217 @@
+import { BoxGeometry, Group, Mesh, MeshBasicMaterial } from 'three';
+import { importModelFiles } from './importModelFiles';
+import { Library } from './library';
+const tinyPng = Buffer.from('iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII=', 'base64');
+function triangleGltf() {
+    const document = {
+        asset: { version: '2.0' },
+        scene: 0,
+        scenes: [{ nodes: [0] }],
+        nodes: [{ mesh: 0 }],
+        meshes: [
+            {
+                primitives: [{ attributes: { POSITION: 0 }, material: 0, mode: 4 }],
+            },
+        ],
+        materials: [
+            {
+                pbrMetallicRoughness: {
+                    baseColorTexture: { index: 0 },
+                    metallicFactor: 0,
+                    roughnessFactor: 1,
+                },
+            },
+        ],
+        textures: [{ source: 0 }],
+        images: [{ uri: 'textures/tiny.png' }],
+        buffers: [{ uri: 'geometry/triangle.bin', byteLength: 36 }],
+        bufferViews: [{ buffer: 0, byteOffset: 0, byteLength: 36 }],
+        accessors: [
+            {
+                bufferView: 0,
+                componentType: 5126,
+                count: 3,
+                type: 'VEC3',
+                min: [0, 0, 0],
+                max: [1, 1, 0],
+            },
+        ],
+    };
+    return new File([JSON.stringify(document)], 'triangle.gltf', {
+        type: 'model/gltf+json',
+    });
+}
+function triangleBin() {
+    const bytes = new ArrayBuffer(36);
+    const positions = new Float32Array(bytes);
+    positions.set([0, 0, 0, 1, 0, 0, 0, 1, 0]);
+    return new File([bytes], 'triangle.bin', {
+        type: 'application/octet-stream',
+    });
+}
+function tinyPngFile() {
+    return new File([tinyPng], 'tiny.png', { type: 'image/png' });
+}
+function memoryBackend() {
+    const entries = new Map();
+    const blobs = new Map();
+    const backend = {
+        id: 'mock',
+        listEntries: async (kind) => [...entries.values()].filter((entry) => !kind || entry.kind === kind),
+        getEntry: async (id) => entries.get(id),
+        putEntry: async (entry) => void entries.set(entry.id, entry),
+        deleteEntry: async (id) => void entries.delete(id),
+        putBlob: async (blob) => {
+            const id = `blob-${blobs.size}`;
+            blobs.set(id, blob);
+            return id;
+        },
+        getBlobUrl: async () => 'blob:stored',
+        deleteBlob: async (id) => void blobs.delete(id),
+        listBlobIds: async () => [...blobs.keys()],
+        getRigAliases: async () => [],
+        putRigAlias: async () => { },
+    };
+    return { backend, entries, blobs };
+}
+function modelDeps(names) {
+    return {
+        load: async (file) => {
+            if (!names.includes(file.name))
+                throw new Error('无法解析');
+            const root = new Group();
+            root.name = file.name;
+            root.add(new Mesh(new BoxGeometry(), new MeshBasicMaterial()));
+            return { root, animations: [] };
+        },
+        exportModel: async (root) => new TextEncoder().encode(root.name).buffer,
+        exportAnimation: async () => new TextEncoder().encode('anim').buffer,
+    };
+}
+function gltfJsonChunk(glb) {
+    const view = new DataView(glb);
+    const jsonLength = view.getUint32(12, true);
+    expect(view.getUint32(16, true)).toBe(0x4e4f534a);
+    return JSON.parse(new TextDecoder().decode(new Uint8Array(glb, 20, jsonLength)));
+}
+describe('importModelFiles', () => {
+    const originalFetch = globalThis.fetch;
+    const originalSelf = globalThis.self;
+    const originalCreateImageBitmap = globalThis.createImageBitmap;
+    const originalImageData = globalThis.ImageData;
+    const originalCreateObjectURL = URL.createObjectURL;
+    const originalRevokeObjectURL = URL.revokeObjectURL;
+    const originalCreateElement = document.createElement;
+    let objectUrls;
+    beforeEach(() => {
+        globalThis.self = globalThis;
+        let nextId = 0;
+        objectUrls = new Map();
+        URL.createObjectURL = jest.fn((blob) => {
+            const url = `blob:test-${++nextId}`;
+            objectUrls.set(url, blob);
+            return url;
+        });
+        URL.revokeObjectURL = jest.fn((url) => {
+            objectUrls.delete(url);
+        });
+        globalThis.fetch = jest.fn(async (input) => {
+            const url = typeof input === 'string' || input instanceof URL
+                ? String(input)
+                : input.url;
+            const blob = objectUrls.get(url);
+            if (!blob)
+                throw new Error(`未登记的测试 URL: ${url}`);
+            return {
+                ok: true,
+                status: 200,
+                statusText: 'OK',
+                url,
+                headers: { get: () => null },
+                arrayBuffer: () => blob.arrayBuffer(),
+                blob: async () => blob,
+            };
+        });
+        globalThis.createImageBitmap = jest.fn(async () => ({
+            data: new Uint8ClampedArray([255, 255, 255, 255]),
+            width: 1,
+            height: 1,
+            close: jest.fn(),
+        }));
+        globalThis.ImageData = class {
+            constructor(data, width, height) {
+                this.data = data;
+                this.width = width;
+                this.height = height;
+            }
+        };
+        document.createElement = jest.fn(() => ({
+            width: 0,
+            height: 0,
+            getContext: () => ({
+                translate: jest.fn(),
+                scale: jest.fn(),
+                drawImage: jest.fn(),
+                putImageData: jest.fn(),
+            }),
+            toBlob: (callback) => callback(new Blob([tinyPng], { type: 'image/png' })),
+        }));
+    });
+    afterEach(() => {
+        globalThis.fetch = originalFetch;
+        globalThis.self = originalSelf;
+        globalThis.createImageBitmap = originalCreateImageBitmap;
+        globalThis.ImageData = originalImageData;
+        URL.createObjectURL = originalCreateObjectURL;
+        URL.revokeObjectURL = originalRevokeObjectURL;
+        if (originalCreateElement)
+            document.createElement = originalCreateElement;
+        else
+            Reflect.deleteProperty(document, 'createElement');
+    });
+    it('把相对 buffer/image 一起装入一个自包含 GLB,并回收全部临时 URL', async () => {
+        const { backend, entries, blobs } = memoryBackend();
+        const library = new Library({ sources: [backend] });
+        const imported = await importModelFiles([triangleGltf(), triangleBin(), tinyPngFile()], library);
+        expect(imported).toHaveLength(1);
+        expect(imported[0]).toMatchObject({
+            kind: 'model',
+            name: 'triangle',
+            vertexCount: 3,
+        });
+        expect(entries.size).toBe(1);
+        const glb = await blobs.get(imported[0].blobId).arrayBuffer();
+        expect(new DataView(glb).getUint32(0, true)).toBe(0x46546c67);
+        const json = gltfJsonChunk(glb);
+        expect(json.buffers[0].uri).toBeUndefined();
+        expect(json.images[0].uri).toBeUndefined();
+        expect(json.images[0].bufferView).toEqual(expect.any(Number));
+        expect(URL.createObjectURL).toHaveBeenCalledTimes(2);
+        expect(URL.revokeObjectURL).toHaveBeenCalledTimes(2);
+        expect(objectUrls.size).toBe(0);
+    });
+    it('引用的 bin 缺失时不创建任何新条目,并回收已创建的 URL', async () => {
+        const { backend, entries } = memoryBackend();
+        const library = new Library({ sources: [backend] });
+        await expect(importModelFiles([triangleGltf(), tinyPngFile()], library)).rejects.toThrow();
+        expect(entries.size).toBe(0);
+        expect(objectUrls.size).toBe(0);
+        expect(URL.revokeObjectURL).toHaveBeenCalledWith(expect.stringMatching(/^blob:test-/));
+    });
+    it('多个模型根全部成功时按原数组契约返回全部新条目', async () => {
+        const { backend } = memoryBackend();
+        const library = new Library({ sources: [backend] });
+        const imported = await importModelFiles([new File(['a'], 'a.gltf'), new File(['b'], 'b.gltf')], library, modelDeps(['a.gltf', 'b.gltf']));
+        expect(imported.map((entry) => entry.name)).toEqual(['a', 'b']);
+        expect(await library.listEntries('model')).toHaveLength(2);
+    });
+    it('混合成功时保留成功条目并报告失败文件及原因', async () => {
+        const { backend } = memoryBackend();
+        const library = new Library({ sources: [backend] });
+        await expect(importModelFiles([new File(['a'], 'a.gltf'), new File(['x'], 'broken.gltf')], library, modelDeps(['a.gltf']))).rejects.toMatchObject({
+            entries: [expect.objectContaining({ kind: 'model', name: 'a' })],
+            failedItems: [{ file: 'broken.gltf', message: expect.any(String) }],
+        });
+        expect((await library.listEntries('model')).map((entry) => entry.name)).toEqual(['a']);
+    });
+});

package/dist/assetLibrary/importPipeline.d.ts

@@ -12,10 +12,11 @@ export type ImportDeps = {
     exportModel: (root: Object3D) => Promise<ArrayBuffer>;
     exportAnimation: (root: Object3D, clip: AnimationClip) => Promise<ArrayBuffer>;
 };
-export declare const realImportDeps: () => ImportDeps;
+export declare const realImportDeps: (files?: File[]) => ImportDeps;
 export type ImportItem = {
     type: 'model';
     name: string;
+    sourceFile?: string;
     rig: string;
     contentHash: string;
     boneCount: number;
@@ -24,6 +25,7 @@ export type ImportItem = {
 } | {
     type: 'animation';
     name: string;
+    sourceFile?: string;
     rig: string;
     contentHash: string;
     duration: number;
@@ -31,12 +33,15 @@ export type ImportItem = {
 } | {
     type: 'pose';
     name: string;
+    sourceFile?: string;
     rig: string;
     bones: PoseEntry['bones'];
 } | {
     type: 'skip';
     name: string;
+    sourceFile?: string;
     reason: string;
+    duplicate?: boolean;
 };
 /** 哈希不同但同族同结构的模型,入库前要用户选 reuse/keep */
 export type SimilarMatch = {
@@ -56,6 +61,15 @@ export declare function baseName(fileName: string): string;
  * 第二层:哈希不同但同族 + 顶点/骨骼数相同 → 记入 similar 交给用户。
  */
 export declare function planImport(files: File[], library: Pick<Library, 'listEntries'>, deps: ImportDeps, tr?: TFunction): Promise<ImportPlan>;
+export declare class ImportItemWriteError extends Error {
+    readonly item: Exclude<ImportItem, {
+        type: 'skip';
+    }>;
+    readonly cause: unknown;
+    constructor(item: Exclude<ImportItem, {
+        type: 'skip';
+    }>, cause: unknown);
+}
 /** 落库:choices 与 plan.similar 一一对应,'reuse' 丢弃对应 model 项 */
 export declare function executeImport(plan: ImportPlan, choices: Array<'reuse' | 'keep'>, library: Library): Promise<void>;
 //# sourceMappingURL=importPipeline.d.ts.map

package/dist/assetLibrary/importPipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"importPipeline.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/importPipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAC,MAAM,OAAO,CAAA;AACzD,OAAO,EAAY,KAAK,SAAS,EAAC,MAAM,0BAA0B,CAAA;AAKlE,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AAEtC,OAAO,KAAK,EAA6B,SAAS,EAAC,MAAM,SAAS,CAAA;AAElE,MAAM,MAAM,WAAW,GAAG;IAAC,IAAI,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,aAAa,EAAE,CAAA;CAAC,CAAA;AAEpE,+DAA+D;AAC/D,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,WAAW,CAAC,CAAA;IAC1C,WAAW,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,WAAW,CAAC,CAAA;IACrD,eAAe,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,WAAW,CAAC,CAAA;CAC/E,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,UAIjC,CAAA;AAmCF,MAAM,MAAM,UAAU,GAClB;IACE,IAAI,EAAE,OAAO,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,GAAG,EAAE,WAAW,CAAA;CACjB,GACD;IACE,IAAI,EAAE,WAAW,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,GAAG,EAAE,WAAW,CAAA;CACjB,GACD;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAA;CAAC,GACpE;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CAAA;AAEhD,uCAAuC;AACvC,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,UAAU,EAAE,CAAA;IACnB,OAAO,EAAE,YAAY,EAAE,CAAA;IACvB,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEjD;AAuBD;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,EACrC,IAAI,EAAE,UAAU,EAChB,EAAE,GAAE,SAAqB,GACxB,OAAO,CAAC,UAAU,CAAC,CAsJrB;AAED,0DAA0D;AAC1D,wBAAsB,aAAa,CACjC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,EAChC,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,IAAI,CAAC,CAgDf"}
+{"version":3,"file":"importPipeline.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/importPipeline.ts"],"names":[],"mappings":"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"}