@dreamerbird/camera-studio 0.0.0-stage → 0.2.0

package/dist/assetLibrary/ModelPickerSlot.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 模型选择框体槽位(2026-10-01 注册制):顶栏「添加模型」弹出的框体的
+ * 分派点。pickerRegistry 的 'model' 槽位注册了宿主组件就渲染宿主的
+ * (props = 库条目 + 缩略图懒加载 + 放置/拖拽/导入/关闭回调),没注册
+ * 回退内置 AssetLibraryPanel(kind='model')——零回归。
+ *
+ * 与 App 的 onOpenModelPicker 接管回调共存、两级优先:
+ *   onOpenModelPicker 存在 → 完全不弹这里(宿主全自控,App 已拦);
+ *   否则注册组件优先,内置兜底。
+ *
+ * 内置模型不再播种(2026-10-10 目录化):随包 GLB 由 StaticCatalogSource
+ * 以只读目录并入聚合库,框体无论内置/宿主都能列到,无需挂载期触发。
+ */
+import React from 'react';
+import type { ModelEntry } from './types';
+export type ModelPickerSlotProps = {
+    onPlaceModel: (entry: ModelEntry) => void;
+    onDragStartModel: (entry: ModelEntry) => void;
+    disabled?: boolean;
+    onClose: () => void;
+};
+export declare function ModelPickerSlot({ onPlaceModel, onDragStartModel, disabled, onClose, }: ModelPickerSlotProps): React.ReactElement;
+export default ModelPickerSlot;
+//# sourceMappingURL=ModelPickerSlot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ModelPickerSlot.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/ModelPickerSlot.tsx"],"names":[],"mappings":"AACA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,SAAS,CAAA;AAKvC,MAAM,MAAM,oBAAoB,GAAG;IACjC,YAAY,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;IACzC,gBAAgB,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;IAC7C,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB,CAAA;AAED,wBAAgB,eAAe,CAAC,EAC9B,YAAY,EACZ,gBAAgB,EAChB,QAAQ,EACR,OAAO,GACR,EAAE,oBAAoB,GAAG,KAAK,CAAC,YAAY,CA4B3C;AAED,eAAe,eAAe,CAAA"}

package/dist/assetLibrary/ModelPickerSlot.js

@@ -0,0 +1,32 @@
+// packages/camera-studio/src/assetLibrary/ModelPickerSlot.tsx
+/**
+ * 模型选择框体槽位(2026-10-01 注册制):顶栏「添加模型」弹出的框体的
+ * 分派点。pickerRegistry 的 'model' 槽位注册了宿主组件就渲染宿主的
+ * (props = 库条目 + 缩略图懒加载 + 放置/拖拽/导入/关闭回调),没注册
+ * 回退内置 AssetLibraryPanel(kind='model')——零回归。
+ *
+ * 与 App 的 onOpenModelPicker 接管回调共存、两级优先:
+ *   onOpenModelPicker 存在 → 完全不弹这里(宿主全自控,App 已拦);
+ *   否则注册组件优先,内置兜底。
+ *
+ * 内置模型不再播种(2026-10-10 目录化):随包 GLB 由 StaticCatalogSource
+ * 以只读目录并入聚合库,框体无论内置/宿主都能列到,无需挂载期触发。
+ */
+import React from 'react';
+import { getRegisteredPicker } from '../pickerRegistry';
+import { useLibraryEntries } from './library';
+import { useModelThumbUrl } from './useModelThumbUrl';
+import { importModelFile } from './importModelFile';
+import { AssetLibraryPanel } from './AssetLibraryPanel';
+export function ModelPickerSlot({ onPlaceModel, onDragStartModel, disabled, onClose, }) {
+    // hooks 无条件调用:注册分派只换渲染分支,不换订阅
+    const entries = useLibraryEntries('model');
+    const { getThumbUrl } = useModelThumbUrl();
+    // 每次开框现读注册表:宿主注册/注销无需订阅,下一次开框即生效
+    const HostPicker = getRegisteredPicker('model');
+    if (HostPicker) {
+        return (React.createElement(HostPicker, { entries: entries, getThumbUrl: getThumbUrl, onPlace: onPlaceModel, onDragStart: onDragStartModel, onImport: importModelFile, onClose: onClose }));
+    }
+    return (React.createElement(AssetLibraryPanel, { kind: "model", onPlaceModel: onPlaceModel, onDragStartModel: onDragStartModel, disabled: disabled, onClose: onClose }));
+}
+export default ModelPickerSlot;

package/dist/assetLibrary/catalogThumbs.d.ts

@@ -0,0 +1,7 @@
+import type { StaticCatalogSource } from './staticCatalogSource';
+import type { ModelEntry, PoseEntry } from './types';
+/** 身体姿势缩略图:目录模特 GLB 上套姿势离屏渲染,blob: URL 返回 */
+export declare function renderCatalogPoseThumb(source: StaticCatalogSource, entry: PoseEntry): Promise<string | undefined>;
+/** 模型缩略图:目录 GLB 直接离屏渲染(复用导入管线的 renderThumbnail) */
+export declare function renderCatalogModelThumb(source: StaticCatalogSource, entry: ModelEntry): Promise<string | undefined>;
+//# sourceMappingURL=catalogThumbs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalogThumbs.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/catalogThumbs.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAC,mBAAmB,EAAC,MAAM,uBAAuB,CAAA;AAC9D,OAAO,KAAK,EAAC,UAAU,EAAE,SAAS,EAAC,MAAM,SAAS,CAAA;AAwDlD,6CAA6C;AAC7C,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,mBAAmB,EAC3B,KAAK,EAAE,SAAS,GACf,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAO7B;AAED,mDAAmD;AACnD,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,mBAAmB,EAC3B,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAU7B"}

package/dist/assetLibrary/catalogThumbs.js

@@ -0,0 +1,75 @@
+// packages/camera-studio/src/assetLibrary/catalogThumbs.ts
+/**
+ * 内置目录条目的运行时缩略图渲染器(StaticCatalogSource 的默认注入):
+ * 目录条目不落库存图——身体姿势/模型的缩略图按需从目录 GLB 离屏渲染,
+ * 与旧播种后回填(poseThumbnail/thumbnail)同一套渲染实现。
+ *
+ * 惰性 + 缓存:模特 GLB 的 fetch/解析按条目缓存(渲染会话含 WebGL
+ * 上下文,一个模特一份);单个姿势/模型的缩略图 URL 缓存由
+ * StaticCatalogSource 自身承担,这里不重复缓存。
+ * GL 不可用/取数失败:告警一次并缓存 null,之后安静降级为占位图标。
+ */
+import { createPoseThumbSession } from './poseThumbnail';
+import { renderThumbnail } from './thumbnail';
+/** 模特 GLB 字节缓存(按目录模型条目 id) */
+const glbByEntryId = new Map();
+function fetchModelGlb(source, model) {
+    let cached = glbByEntryId.get(model.id);
+    if (!cached) {
+        cached = source
+            .getBlobUrl(model.blobId)
+            .then((url) => fetch(url))
+            .then((res) => {
+            if (!res.ok)
+                throw new Error(`HTTP ${res.status}`);
+            return res.arrayBuffer();
+        });
+        cached.catch(() => glbByEntryId.delete(model.id)); // 瞬时故障不缓存
+        glbByEntryId.set(model.id, cached);
+    }
+    return cached;
+}
+/** 姿势渲染会话缓存(按目录模型条目 id);失败缓存 null 并只告警一次 */
+const sessionByEntryId = new Map();
+function poseSessionFor(source, model) {
+    let cached = sessionByEntryId.get(model.id);
+    if (!cached) {
+        cached = fetchModelGlb(source, model)
+            .then((glb) => createPoseThumbSession(glb))
+            .catch((err) => {
+            console.warn(`[assetLibrary] 内置姿势缩略图渲染会话创建失败(${model.name})`, err);
+            return null;
+        });
+        sessionByEntryId.set(model.id, cached);
+    }
+    return cached;
+}
+/** 同族第一个模型条目当「模特」(与回填 renderRigBatch 同规则) */
+async function modelForRig(source, rig) {
+    const models = (await source.listEntries('model'));
+    return models.find((m) => m.rig === rig && m.blobId);
+}
+/** 身体姿势缩略图:目录模特 GLB 上套姿势离屏渲染,blob: URL 返回 */
+export async function renderCatalogPoseThumb(source, entry) {
+    const model = await modelForRig(source, entry.rig);
+    if (!model)
+        return undefined;
+    const session = await poseSessionFor(source, model);
+    if (!session)
+        return undefined;
+    const blob = await session.render(entry.bones);
+    return blob ? URL.createObjectURL(blob) : undefined;
+}
+/** 模型缩略图:目录 GLB 直接离屏渲染(复用导入管线的 renderThumbnail) */
+export async function renderCatalogModelThumb(source, entry) {
+    let glb;
+    try {
+        glb = await fetchModelGlb(source, entry);
+    }
+    catch (err) {
+        console.warn(`[assetLibrary] 内置模型 GLB 拉取失败(${entry.name})`, err);
+        return undefined;
+    }
+    const blob = await renderThumbnail(glb);
+    return blob ? URL.createObjectURL(blob) : undefined;
+}

package/dist/assetLibrary/classify.d.ts

@@ -0,0 +1,14 @@
+import type { AnimationClip, Object3D } from 'three';
+import type { PoseEntry } from './types';
+export type ModelClass = 'model' | 'static-model' | 'animations-only' | 'unusable';
+/** 按内容识别导入文件的类型,决定生成哪些库条目 */
+export declare function classifyModel(root: Object3D, animations: AnimationClip[]): ModelClass;
+/**
+ * 校验 .pose.json 文件内容:必须是 {rig, bones:{骨骼名:{rotation?,position?}}},
+ * rotation 为四元数(4 个数),position 为三元组。合法返回内容,否则 null。
+ */
+export declare function validatePoseJson(json: unknown): {
+    rig: string;
+    bones: PoseEntry['bones'];
+} | null;
+//# sourceMappingURL=classify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/classify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAE,QAAQ,EAAC,MAAM,OAAO,CAAA;AAElD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,SAAS,CAAA;AAEtC,MAAM,MAAM,UAAU,GAClB,OAAO,GACP,cAAc,GACd,iBAAiB,GACjB,UAAU,CAAA;AAEd,6BAA6B;AAC7B,wBAAgB,aAAa,CAC3B,IAAI,EAAE,QAAQ,EACd,UAAU,EAAE,aAAa,EAAE,GAC1B,UAAU,CAMZ;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,OAAO,GACZ;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,CAAA;CAAC,GAAG,IAAI,CA4BjD"}

package/dist/assetLibrary/classify.js

@@ -0,0 +1,43 @@
+import { collectBoneNames, meshStats } from './rig';
+/** 按内容识别导入文件的类型,决定生成哪些库条目 */
+export function classifyModel(root, animations) {
+    const { meshCount } = meshStats(root);
+    const boneCount = collectBoneNames(root).length;
+    if (meshCount > 0)
+        return boneCount > 0 ? 'model' : 'static-model';
+    if (boneCount > 0 && animations.length > 0)
+        return 'animations-only';
+    return 'unusable';
+}
+/**
+ * 校验 .pose.json 文件内容:必须是 {rig, bones:{骨骼名:{rotation?,position?}}},
+ * rotation 为四元数(4 个数),position 为三元组。合法返回内容,否则 null。
+ */
+export function validatePoseJson(json) {
+    if (!json || typeof json !== 'object')
+        return null;
+    const { rig, bones } = json;
+    if (!bones || typeof bones !== 'object')
+        return null;
+    for (const [name, v] of Object.entries(bones)) {
+        if (!name)
+            return null;
+        const { rotation, position } = v;
+        if (rotation !== undefined &&
+            (!Array.isArray(rotation) ||
+                rotation.length !== 4 ||
+                !rotation.every((n) => Number.isFinite(n)))) {
+            return null;
+        }
+        if (position !== undefined &&
+            (!Array.isArray(position) ||
+                position.length !== 3 ||
+                !position.every((n) => Number.isFinite(n)))) {
+            return null;
+        }
+    }
+    return {
+        rig: typeof rig === 'string' ? rig : 'unknown',
+        bones: bones,
+    };
+}

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

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

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

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

package/dist/assetLibrary/classify.test.js

@@ -0,0 +1,44 @@
+import { AnimationClip, Bone, BoxGeometry, Group, Mesh, MeshBasicMaterial, } from 'three';
+import { classifyModel, validatePoseJson } from './classify';
+function withBone(root) {
+    const b = new Bone();
+    b.name = 'Hips';
+    root.add(b);
+    return root;
+}
+function withMesh(root) {
+    root.add(new Mesh(new BoxGeometry(), new MeshBasicMaterial()));
+    return root;
+}
+const clip = new AnimationClip('idle', 1, []);
+describe('classifyModel', () => {
+    it('网格+骨架 = model', () => {
+        expect(classifyModel(withMesh(withBone(new Group())), [])).toBe('model');
+    });
+    it('网格、无骨架 = static-model', () => {
+        expect(classifyModel(withMesh(new Group()), [])).toBe('static-model');
+    });
+    it('无网格、有骨架+动画 = animations-only', () => {
+        expect(classifyModel(withBone(new Group()), [clip])).toBe('animations-only');
+    });
+    it('无网格无动画/有骨架无动画/有网格空组 = unusable', () => {
+        expect(classifyModel(new Group(), [])).toBe('unusable');
+        expect(classifyModel(withBone(new Group()), [])).toBe('unusable');
+    });
+});
+describe('validatePoseJson', () => {
+    it('合法姿势返回 rig 和 bones', () => {
+        const out = validatePoseJson({
+            rig: 'rig-x',
+            bones: { Hips: { rotation: [0, 0, 0, 1], position: [0, 1, 0] } },
+        });
+        expect(out?.rig).toBe('rig-x');
+        expect(Object.keys(out?.bones ?? {})).toEqual(['Hips']);
+    });
+    it('缺 bones/旋转不是四元数/位置不是三元组 = null', () => {
+        expect(validatePoseJson({})).toBeNull();
+        expect(validatePoseJson({ bones: { Hips: { rotation: [0, 0, 1] } } })).toBeNull();
+        expect(validatePoseJson({ bones: { Hips: { position: [0, 1] } } })).toBeNull();
+        expect(validatePoseJson('x')).toBeNull();
+    });
+});

package/dist/assetLibrary/contract.indexeddb.test.d.ts

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

package/dist/assetLibrary/contract.indexeddb.test.d.ts.map

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

package/dist/assetLibrary/contract.indexeddb.test.js

@@ -0,0 +1,10 @@
+import { indexedDB as fakeIndexedDB } from 'fake-indexeddb';
+globalThis.indexedDB = fakeIndexedDB;
+URL.createObjectURL = jest.fn(() => 'blob:mock-url');
+URL.revokeObjectURL = jest.fn();
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+const { IndexedDBBackend } = require('./indexedDBBackend');
+import { runLibrarySourceContractTests } from './contractTests';
+runLibrarySourceContractTests(async () => ({
+    source: new IndexedDBBackend({ dbName: `contract-${Math.random()}` }),
+}));

package/dist/assetLibrary/contractTests.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 宿主存储实现的契约测试套件。宿主在自己仓库里:
+ *   import {runLibrarySourceContractTests} from '@dreamerbird/camera-studio/contract-tests'
+ *   runLibrarySourceContractTests(async () => ({source: new MyHttpSource(...)}))
+ * 每个用例拿全新空实例;套件对内置 IDB 实现自身也跑(contract.indexeddb.test.ts)。
+ */
+import type { WritableLibrarySource } from './source';
+export declare function runLibrarySourceContractTests(makeSource: () => Promise<{
+    source: WritableLibrarySource;
+    cleanup?: () => Promise<void>;
+}>): void;
+//# sourceMappingURL=contractTests.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contractTests.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/contractTests.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,UAAU,CAAA;AAEnD,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,MAAM,OAAO,CAAC;IACxB,MAAM,EAAE,qBAAqB,CAAA;IAC7B,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9B,CAAC,GACD,IAAI,CAyDN"}

package/dist/assetLibrary/contractTests.js

@@ -0,0 +1,51 @@
+export function runLibrarySourceContractTests(makeSource) {
+    describe('LibrarySource 契约', () => {
+        let ctx;
+        beforeEach(async () => {
+            ctx = await makeSource();
+        });
+        afterEach(async () => {
+            await ctx.cleanup?.();
+        });
+        test('条目 round-trip:put → get/list → delete', async () => {
+            const entry = {
+                id: 'c1',
+                kind: 'pose',
+                name: '契约姿势',
+                rig: 'r',
+                bones: {},
+            };
+            await ctx.source.putEntry(entry);
+            expect(await ctx.source.getEntry('c1')).toMatchObject({ id: 'c1' });
+            expect(await ctx.source.listEntries('pose')).toHaveLength(1);
+            expect(await ctx.source.listEntries('model')).toHaveLength(0);
+            await ctx.source.deleteEntry('c1');
+            expect(await ctx.source.getEntry('c1')).toBeUndefined();
+        });
+        test('getEntry(不存在)→ undefined,不抛', async () => {
+            await expect(ctx.source.getEntry('nope')).resolves.toBeUndefined();
+        });
+        test('同 id 重复 put = upsert 覆盖', async () => {
+            const e = { id: 'c2', kind: 'pose', name: 'v1', rig: 'r', bones: {} };
+            await ctx.source.putEntry(e);
+            await ctx.source.putEntry({ ...e, name: 'v2' });
+            expect((await ctx.source.getEntry('c2'))?.name).toBe('v2');
+            expect(await ctx.source.listEntries()).toHaveLength(1);
+        });
+        test('blob round-trip + 内容寻址:同内容两次同 id', async () => {
+            const data = new Blob(['hello'], { type: 'text/plain' });
+            const id1 = await ctx.source.putBlob(data);
+            const id2 = await ctx.source.putBlob(new Blob(['hello']));
+            expect(id1).toBe(id2);
+            const url = await ctx.source.getBlobUrl(id1);
+            expect(typeof url).toBe('string');
+            expect(url.length).toBeGreaterThan(0);
+            await ctx.source.deleteBlob(id1);
+        });
+        test('骨架别名 round-trip', async () => {
+            await ctx.source.putRigAlias({ rig: 'rig-x', name: '别名 X' });
+            const aliases = await ctx.source.getRigAliases();
+            expect(aliases.some((a) => a.rig === 'rig-x' && a.name === '别名 X')).toBe(true);
+        });
+    });
+}

package/dist/assetLibrary/dispose.d.ts

@@ -0,0 +1,4 @@
+import type { Object3D } from 'three';
+/** 递归释放对象树的 GPU 资源(几何体/材质/纹理),实例卸载时调用 */
+export declare function disposeObjectTree(root: Object3D): void;
+//# sourceMappingURL=dispose.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dispose.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/dispose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,QAAQ,EAAU,MAAM,OAAO,CAAA;AAEtD,yCAAyC;AACzC,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAqBtD"}

package/dist/assetLibrary/dispose.js

@@ -0,0 +1,21 @@
+/** 递归释放对象树的 GPU 资源(几何体/材质/纹理),实例卸载时调用 */
+export function disposeObjectTree(root) {
+    root.traverse((o) => {
+        const mesh = o;
+        if (!mesh.isMesh)
+            return;
+        mesh.geometry?.dispose();
+        const mats = Array.isArray(mesh.material)
+            ? mesh.material
+            : mesh.material
+                ? [mesh.material]
+                : [];
+        for (const m of mats) {
+            for (const v of Object.values(m)) {
+                if (v?.isTexture)
+                    v.dispose();
+            }
+            m.dispose();
+        }
+    });
+}

package/dist/assetLibrary/draco.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Draco 压缩 GLB(只压网格几何,骨骼/动画轨道不受影响)。
+ * 无网格的动作 GLB 没有可压内容,调用方不应走这里。
+ */
+export declare function compressGLBDraco(glb: ArrayBuffer): Promise<ArrayBuffer>;
+//# sourceMappingURL=draco.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"draco.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/draco.ts"],"names":[],"mappings":"AAsCA;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAO7E"}

package/dist/assetLibrary/draco.js

@@ -0,0 +1,45 @@
+import { WebIO } from '@gltf-transform/core';
+import { ALL_EXTENSIONS } from '@gltf-transform/extensions';
+import { draco } from '@gltf-transform/functions';
+import draco3dgltf from 'draco3dgltf';
+/**
+ * Draco 压缩的 IO 单例:wasm 模块编译一次,全局复用。
+ * 用 draco3dgltf(浏览器端按 /draco/ 定位 wasm,node/jest 走 fs 直读);
+ * draco3d 包的 main 是 node 专用实现,浏览器里会读 fs,不要用。
+ */
+let ioPromise;
+async function initIO() {
+    // 浏览器里胶水按页面 URL 相对路径取 wasm 会 404,指到 vite 服务的 /draco/;
+    // node(jest)里胶水走 fs 直读,不能给它 locateFile
+    const wasmOpts = typeof window === 'undefined'
+        ? undefined
+        : { locateFile: (file) => `/draco/${file}` };
+    const [decoder, encoder] = await Promise.all([
+        draco3dgltf.createDecoderModule(wasmOpts),
+        draco3dgltf.createEncoderModule(wasmOpts),
+    ]);
+    return new WebIO().registerExtensions(ALL_EXTENSIONS).registerDependencies({
+        'draco3d.decoder': decoder,
+        'draco3d.encoder': encoder,
+    });
+}
+function getIO() {
+    ioPromise ?? (ioPromise = initIO().catch((err) => {
+        // 初始化失败不缓存(wasm 404 等瞬时故障),下次调用重试
+        ioPromise = undefined;
+        throw err;
+    }));
+    return ioPromise;
+}
+/**
+ * Draco 压缩 GLB(只压网格几何,骨骼/动画轨道不受影响)。
+ * 无网格的动作 GLB 没有可压内容,调用方不应走这里。
+ */
+export async function compressGLBDraco(glb) {
+    const io = await getIO();
+    const doc = await io.readBinary(new Uint8Array(glb));
+    await doc.transform(draco());
+    const out = await io.writeBinary(doc);
+    // writeBinary 返回的 Uint8Array 可能带偏移,切出干净的 ArrayBuffer
+    return out.buffer.slice(out.byteOffset, out.byteOffset + out.byteLength);
+}

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

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

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

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

package/dist/assetLibrary/draco.test.js

@@ -0,0 +1,93 @@
+import { Document, WebIO } from '@gltf-transform/core';
+import { ALL_EXTENSIONS } from '@gltf-transform/extensions';
+import draco3dgltf from 'draco3dgltf';
+import { compressGLBDraco } from './draco';
+/** 造一个 vertexCount 顶点的三角网格 GLB(不压缩) */
+async function buildGLB(vertexCount) {
+    const doc = new Document();
+    const buffer = doc.createBuffer();
+    const positions = new Float32Array(vertexCount * 3);
+    for (let i = 0; i < positions.length; i++)
+        positions[i] = Math.sin(i) * i;
+    const position = doc
+        .createAccessor()
+        .setType('VEC3')
+        .setArray(positions)
+        .setBuffer(buffer);
+    // Draco 需要显式索引才能稳定保留顶点数;用三角扇组织,顶点 0 为公共顶点。
+    const indices = new Uint16Array(Math.max(0, (vertexCount - 2) * 3));
+    for (let i = 0; i < vertexCount - 2; i++) {
+        indices[i * 3] = 0;
+        indices[i * 3 + 1] = i + 1;
+        indices[i * 3 + 2] = i + 2;
+    }
+    const index = doc
+        .createAccessor()
+        .setType('SCALAR')
+        .setArray(indices)
+        .setBuffer(buffer);
+    const prim = doc
+        .createPrimitive()
+        .setAttribute('POSITION', position)
+        .setIndices(index);
+    const mesh = doc.createMesh('m').addPrimitive(prim);
+    const node = doc.createNode('n').setMesh(mesh);
+    doc.createScene('s').addChild(node);
+    return new WebIO().registerExtensions(ALL_EXTENSIONS).writeBinary(doc);
+}
+describe('compressGLBDraco', () => {
+    it('压缩后体积更小且声明 draco 扩展', async () => {
+        const glb = await buildGLB(5000);
+        const raw = glb.buffer.slice(glb.byteOffset, glb.byteOffset + glb.byteLength);
+        const compressed = await compressGLBDraco(raw);
+        expect(compressed.byteLength).toBeLessThan(glb.byteLength);
+        const text = new TextDecoder().decode(new Uint8Array(compressed));
+        expect(text).toContain('KHR_draco_mesh_compression');
+    });
+    it('读回后顶点数不丢', async () => {
+        const glb = await buildGLB(5000);
+        const raw = glb.buffer.slice(glb.byteOffset, glb.byteOffset + glb.byteLength);
+        const compressed = await compressGLBDraco(raw);
+        const io = new WebIO()
+            .registerExtensions(ALL_EXTENSIONS)
+            .registerDependencies({
+            'draco3d.decoder': await draco3dgltf.createDecoderModule(),
+        });
+        const doc = await io.readBinary(new Uint8Array(compressed));
+        const pos = doc
+            .getRoot()
+            .listMeshes()[0]
+            .listPrimitives()[0]
+            .getAttribute('POSITION');
+        expect(pos.getCount()).toBe(5000);
+    });
+});
+describe('compressGLBDraco 初始化失败重试', () => {
+    afterEach(() => {
+        jest.dontMock('draco3dgltf');
+        jest.resetModules();
+    });
+    it('第一次初始化失败不缓存,第二次调用重试并成功', async () => {
+        let encoderCalls = 0;
+        const actual = jest.requireActual('draco3dgltf');
+        jest.doMock('draco3dgltf', () => ({
+            ...actual,
+            createEncoderModule: (...args) => {
+                encoderCalls++;
+                if (encoderCalls === 1) {
+                    return Promise.reject(new Error('wasm 404'));
+                }
+                return actual.createEncoderModule(...args);
+            },
+        }));
+        jest.resetModules();
+        const { compressGLBDraco: compressMocked } = require('./draco');
+        const glb = await buildGLB(5000);
+        const raw = glb.buffer.slice(glb.byteOffset, glb.byteOffset + glb.byteLength);
+        await expect(compressMocked(raw)).rejects.toThrow('wasm 404');
+        const compressed = await compressMocked(raw);
+        expect(compressed.byteLength).toBeLessThan(glb.byteLength);
+        const text = new TextDecoder().decode(new Uint8Array(compressed));
+        expect(text).toContain('KHR_draco_mesh_compression');
+    });
+});

package/dist/assetLibrary/exportGLB.d.ts

@@ -0,0 +1,45 @@
+import { Group } from 'three';
+import type { AnimationClip, Object3D } from 'three';
+/**
+ * 场景单位 = 米(2026-10-21 起,替代此前「最长边统一拉成 5 单位」的
+ * 归一化约定)。glTF 标准本来就是米,人高 1.8 单位、网格 1 小格 = 1 米,
+ * 模型之间保持真实世界的相对大小(车 4.5 / 人 1.8 / 杯子 0.1)。
+ * PlacementManager 的 useNormalizedModel 用同一套换算兜底未烘焙来源。
+ */
+export declare const SCENE_UNIT_METERS = 1;
+/**
+ * 厘米源判定阈值:最长边超过这个数就按厘米源处理(÷100)。
+ * Mixamo 等 FBX 是厘米(人 180),标准 GLB 是米(人 1.8)。取 50 是因为
+ * 米制模型最长边到 50(=50 米,一栋楼)在本系统里罕见,而厘米源几乎
+ * 都远超(一个人就 180)。猜错的入口(超大道具/建筑)保留手动改缩放。
+ */
+export declare const CENTIMETER_SOURCE_THRESHOLD = 50;
+/** 源尺寸最长边 → 米制换算系数(米源返回 1,厘米源返回 0.01) */
+export declare function metricScaleFactor(maxDim: number): number;
+/**
+ * 把「源单位 → 米」的换算系数烘进根节点 scale(入库前置)。
+ * 源文件单位五花八门(Mixamo FBX 是厘米、GLB 多是米),烘过之后任何
+ * 模型都是真实米制尺寸,放置时 theatre 对象的缩放属性才能以 1 为
+ * 干净基线(1 = 真实大小,2 = 两倍大)。只动根节点变换:蒙皮随骨骼
+ * 世界变换正确缩放,骨骼局部数据(动画轨道寻址的那层)不受影响。
+ * 返回应用的系数(1 = 本来就是米,没动)。
+ */
+export declare function bakeMetricScale(root: Object3D): number;
+/**
+ * 移除无法导出的贴图(image 数据缺失)。
+ * FBX 常引用本机不存在的外部贴图文件,加载失败后留下 image 为空的 Texture,
+ * GLTFExporter 遇到会直接抛错("No valid image data found")拖垮整个导入。
+ * 剥掉这些贴图后以灰模/部分贴图入库,不阻塞导入(P1 设计既定取舍)。
+ * 返回移除数量,供调用方告警。
+ */
+export declare function stripInvalidTextures(root: Object3D): number;
+/**
+ * 克隆纯骨骼层级(容器名 AnimationRig):动画轨道按骨骼名寻址,
+ * 纯动画 GLB 只需要这棵带名字的骨骼树,网格一律剔除。
+ */
+export declare function cloneBoneTree(root: Object3D): Group;
+/** 模型入库:剥掉动画,只留网格+骨架+绑定姿势;几何走 Draco 压缩 */
+export declare function exportModelGLB(root: Object3D): Promise<ArrayBuffer>;
+/** 动作入库:骨骼树克隆 + 单条动画,不含网格 */
+export declare function exportAnimationGLB(root: Object3D, clip: AnimationClip): Promise<ArrayBuffer>;
+//# sourceMappingURL=exportGLB.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exportGLB.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/exportGLB.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,EAAU,MAAM,OAAO,CAAA;AAChD,OAAO,KAAK,EAAC,aAAa,EAAQ,QAAQ,EAAU,MAAM,OAAO,CAAA;AAIjE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,IAAI,CAAA;AAElC;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,KAAK,CAAA;AAE7C,yCAAyC;AACzC,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAStD;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CA6B3D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,CAoBnD;AAgBD,0CAA0C;AAC1C,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,CAgBnE;AAED,6BAA6B;AAC7B,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,WAAW,CAAC,CAEtB"}