@dreamerbird/camera-studio 0.0.0-stage → 0.1.0

package/dist/assetLibrary/pose.js

@@ -0,0 +1,41 @@
+/** 抓取骨骼树当前状态为姿势数据:按骨骼名记录四元数与位置 */
+export function capturePose(root) {
+    const bones = {};
+    root.traverse((o) => {
+        if (o.isBone) {
+            bones[o.name] = {
+                rotation: o.quaternion.toArray(),
+                position: o.position.toArray(),
+            };
+        }
+    });
+    return bones;
+}
+/** 语义别名:实例刚克隆出来时的 capture 即绑定姿势,用于"无姿势"时还原 */
+export const captureBindPose = capturePose;
+/**
+ * 把姿势数据按骨骼名写回骨骼树。实例里没有的骨骼名跳过并计入
+ * missed(跨族套用由调用方先过滤,这里只兜底)。
+ */
+export function applyPose(root, bones) {
+    const byName = new Map();
+    root.traverse((o) => {
+        if (o.isBone)
+            byName.set(o.name, o);
+    });
+    let applied = 0;
+    const missed = [];
+    for (const [name, v] of Object.entries(bones)) {
+        const bone = byName.get(name);
+        if (!bone) {
+            missed.push(name);
+            continue;
+        }
+        if (v.rotation)
+            bone.quaternion.fromArray(v.rotation);
+        if (v.position)
+            bone.position.fromArray(v.position);
+        applied++;
+    }
+    return { applied, missed };
+}

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

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

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

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

package/dist/assetLibrary/pose.test.js

@@ -0,0 +1,45 @@
+import { Bone, Group } from 'three';
+import { applyPose, capturePose } from './pose';
+function makeRig() {
+    const root = new Group();
+    const hips = new Bone();
+    hips.name = 'hips';
+    const spine = new Bone();
+    spine.name = 'spine';
+    hips.add(spine);
+    root.add(hips);
+    return { root, hips, spine };
+}
+describe('capturePose / applyPose', () => {
+    test('capture 记录每根骨骼的旋转与位置', () => {
+        const { root, hips } = makeRig();
+        hips.quaternion.set(0, 0, Math.SQRT1_2, Math.SQRT1_2);
+        hips.position.set(1, 2, 3);
+        const pose = capturePose(root);
+        expect(Object.keys(pose).sort()).toEqual(['hips', 'spine']);
+        expect(pose.hips.rotation[2]).toBeCloseTo(Math.SQRT1_2);
+        expect(pose.hips.position).toEqual([1, 2, 3]);
+    });
+    test('apply 把骨骼恢复到 capture 时的状态(往返)', () => {
+        const { root, hips, spine } = makeRig();
+        hips.quaternion.set(0.1, 0.2, 0.3, 0.9).normalize();
+        spine.position.set(0, 5, 0);
+        const pose = capturePose(root);
+        hips.quaternion.set(0, 0, 0, 1);
+        spine.position.set(9, 9, 9);
+        const r = applyPose(root, pose);
+        expect(r.applied).toBe(2);
+        expect(r.missed).toEqual([]);
+        expect(hips.quaternion.x).toBeCloseTo(0.1 / Math.sqrt(0.95), 5);
+        expect(spine.position.y).toBe(5);
+    });
+    test('apply 跳过实例里不存在的骨骼名,计入 missed', () => {
+        const { root } = makeRig();
+        const r = applyPose(root, {
+            ghost: { rotation: [0, 0, 0, 1] },
+            hips: { position: [7, 0, 0] },
+        });
+        expect(r.applied).toBe(1);
+        expect(r.missed).toEqual(['ghost']);
+    });
+});

package/dist/assetLibrary/poseThumbnail.d.ts

@@ -0,0 +1,30 @@
+import type { Library } from './library';
+import type { ModelEntry, PoseEntry } from './types';
+type Lib = Pick<Library, 'listEntries' | 'listBlobIds' | 'getBlobUrl' | 'putBlobWithEntry' | 'getEntrySource' | 'writable'>;
+/**
+ * 给缺图(或图引用已死)的身体姿势条目补缩略图,返回补图数量。
+ * 串行执行:渲染与写库都轻量,避免与交互抢主线程。
+ *
+ * 只回填可写源的条目(用户自存姿势):内置目录(seed-pose-*)等只读源
+ * 条目的图由所属源自己提供(catalog 静态文件/运行时渲染),写库既
+ * 存不下也不该写。
+ *
+ * opts.renderBatch:渲染器注入(测试用;缺省 = 真实 WebGL 离屏渲染)。
+ */
+export declare function backfillPoseThumbnails(lib: Lib, opts?: {
+    renderBatch?: (lib: Lib, model: ModelEntry, entries: PoseEntry[]) => Promise<number>;
+}): Promise<number>;
+/** 一个模特 GLB 的姿势缩略图渲染会话:解析+布景一次,逐姿势渲染 128×128 PNG */
+export type PoseThumbSession = {
+    /** 重置绑定姿势→套用 bones→渲染,返回 PNG blob(toBlob 失败为 undefined) */
+    render(bones: PoseEntry['bones']): Promise<Blob | undefined>;
+    dispose(): void;
+};
+/**
+ * 创建姿势缩略图渲染会话。WebGL 不可用/GLB 解析失败会抛错,调用方
+ * (回填批/目录渲染器)各自降级:回填按族告警跳过,目录渲染器缓存 null
+ * 安静降级为占位图标。
+ */
+export declare function createPoseThumbSession(glb: ArrayBuffer): Promise<PoseThumbSession>;
+export {};
+//# sourceMappingURL=poseThumbnail.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"poseThumbnail.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/poseThumbnail.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AACtC,OAAO,KAAK,EAAC,UAAU,EAAE,SAAS,EAAC,MAAM,SAAS,CAAA;AAGlD,KAAK,GAAG,GAAG,IAAI,CACb,OAAO,EACL,aAAa,GACb,aAAa,GACb,YAAY,GACZ,kBAAkB,GAClB,gBAAgB,GAChB,UAAU,CACb,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,GAAG,EACR,IAAI,GAAE;IACJ,WAAW,CAAC,EAAE,CACZ,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,SAAS,EAAE,KACjB,OAAO,CAAC,MAAM,CAAC,CAAA;CAChB,GACL,OAAO,CAAC,MAAM,CAAC,CA2BjB;AAYD,oDAAoD;AACpD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,2DAA2D;IAC3D,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAAA;IAC5D,OAAO,IAAI,IAAI,CAAA;CAChB,CAAA;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,WAAW,GACf,OAAO,CAAC,gBAAgB,CAAC,CAuD3B"}

package/dist/assetLibrary/poseThumbnail.js

@@ -0,0 +1,144 @@
+// packages/camera-studio/src/assetLibrary/poseThumbnail.ts
+/**
+ * 姿势缩略图运行时渲染(2026-10-05):QBX 手势的预览图随包播种
+ * (poseThumbsQbx),身体姿势(DPL/程序化基础)源包不在磁盘,改为运行
+ * 时离屏渲染——从库里取同骨架族模型的 GLB,套上姿势逐张渲染 128×128
+ * PNG,写库挂 thumbnailId。凡库里能找到同族模型的姿势条目(含用户
+ * 自存姿势)都能补图;纯手势条目跳过(有随包图,且全身取景看不清手)。
+ *
+ * 与模型缩略图(thumbnail.ts)同套路:WebGL 不可用/解析失败一律告警
+ * 降级,不阻塞主流程。一个骨架族只解析一次 GLB,逐姿势重置绑定姿势
+ * 再套用,避免骨骼残留串图。
+ */
+import { AmbientLight, Box3, DirectionalLight, PerspectiveCamera, Scene, Sphere, Vector3, WebGLRenderer, } from 'three';
+import { createGLTFLoader } from './gltfLoader';
+import { applyPose, captureBindPose } from './pose';
+import { isHandPoseEntry } from '../gestureProps';
+/**
+ * 给缺图(或图引用已死)的身体姿势条目补缩略图,返回补图数量。
+ * 串行执行:渲染与写库都轻量,避免与交互抢主线程。
+ *
+ * 只回填可写源的条目(用户自存姿势):内置目录(seed-pose-*)等只读源
+ * 条目的图由所属源自己提供(catalog 静态文件/运行时渲染),写库既
+ * 存不下也不该写。
+ *
+ * opts.renderBatch:渲染器注入(测试用;缺省 = 真实 WebGL 离屏渲染)。
+ */
+export async function backfillPoseThumbnails(lib, opts = {}) {
+    const render = opts.renderBatch ?? renderRigBatch;
+    const poses = (await lib.listEntries('pose'));
+    const liveBlobIds = new Set(await lib.listBlobIds());
+    const pending = poses.filter((e) => !isHandPoseEntry(e) &&
+        !(e.thumbnailId && liveBlobIds.has(e.thumbnailId)) &&
+        lib.getEntrySource(e.id) === lib.writable);
+    if (pending.length === 0)
+        return 0;
+    // 每个骨架族取第一个有 blob 的模型条目当「模特」
+    const modelByRig = new Map();
+    for (const m of (await lib.listEntries('model'))) {
+        if (m.blobId && !modelByRig.has(m.rig))
+            modelByRig.set(m.rig, m);
+    }
+    let rendered = 0;
+    for (const [rig, entries] of groupByRig(pending)) {
+        const model = modelByRig.get(rig);
+        if (!model)
+            continue; // 无同族模型可渲染,跳过(下回再试)
+        try {
+            rendered += await render(lib, model, entries);
+        }
+        catch (err) {
+            console.warn(`[assetLibrary] 姿势缩略图渲染失败(骨架族 ${rig})`, err);
+        }
+    }
+    return rendered;
+}
+function groupByRig(entries) {
+    const out = new Map();
+    for (const e of entries) {
+        const list = out.get(e.rig);
+        if (list)
+            list.push(e);
+        else
+            out.set(e.rig, [e]);
+    }
+    return out;
+}
+/**
+ * 创建姿势缩略图渲染会话。WebGL 不可用/GLB 解析失败会抛错,调用方
+ * (回填批/目录渲染器)各自降级:回填按族告警跳过,目录渲染器缓存 null
+ * 安静降级为占位图标。
+ */
+export async function createPoseThumbSession(glb) {
+    const canvas = document.createElement('canvas');
+    canvas.width = 128;
+    canvas.height = 128;
+    const renderer = new WebGLRenderer({
+        canvas,
+        antialias: true,
+        preserveDrawingBuffer: true,
+        alpha: true,
+    });
+    try {
+        const scene = new Scene();
+        scene.add(new AmbientLight(0xffffff, 1.4));
+        const dir = new DirectionalLight(0xffffff, 1.6);
+        dir.position.set(3, 5, 4);
+        scene.add(dir);
+        const gltf = await new Promise((resolve, reject) => createGLTFLoader().parse(glb, '', resolve, reject));
+        scene.add(gltf.scene);
+        const bindPose = captureBindPose(gltf.scene);
+        // 取景:绑定姿势包围球 + 正面微侧视角(Mixamo 系面朝 +Z)。
+        // 蒙皮网格的包围盒不随骨骼动,这里按绑定姿势取景并多留 25% 边距,
+        // 躺下/蹲下等大幅姿势也不出画
+        const box = new Box3().setFromObject(gltf.scene);
+        const sphere = box.getBoundingSphere(new Sphere());
+        const radius = sphere.radius || 1;
+        const fov = 40;
+        const distance = (radius / Math.tan(((fov / 2) * Math.PI) / 180)) * 1.25;
+        const camera = new PerspectiveCamera(fov, 1, distance / 100, distance * 10);
+        camera.position
+            .copy(sphere.center)
+            .add(new Vector3(0.25, 0.15, 1).normalize().multiplyScalar(distance));
+        camera.lookAt(sphere.center);
+        return {
+            async render(bones) {
+                applyPose(gltf.scene, bindPose);
+                applyPose(gltf.scene, bones);
+                scene.updateMatrixWorld(true);
+                renderer.render(scene, camera);
+                return new Promise((resolve) => canvas.toBlob((b) => resolve(b ?? undefined), 'image/png'));
+            },
+            dispose() {
+                renderer.dispose();
+            },
+        };
+    }
+    catch (err) {
+        renderer.dispose();
+        throw err;
+    }
+}
+/** 一个骨架族一批:解析 GLB 一次,逐姿势 重置绑定姿势→套用→渲染→写库 */
+async function renderRigBatch(lib, model, entries) {
+    const glbUrl = await lib.getBlobUrl(model.blobId);
+    const glb = await (await fetch(glbUrl)).arrayBuffer();
+    const session = await createPoseThumbSession(glb);
+    try {
+        let rendered = 0;
+        for (const entry of entries) {
+            const blob = await session.render(entry.bones);
+            if (!blob)
+                continue;
+            await lib.putBlobWithEntry(blob, (thumbnailId) => ({
+                ...entry,
+                thumbnailId,
+            }));
+            rendered++;
+        }
+        return rendered;
+    }
+    finally {
+        session.dispose();
+    }
+}

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

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

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

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

package/dist/assetLibrary/poseThumbnail.test.js

@@ -0,0 +1,111 @@
+// packages/camera-studio/src/assetLibrary/poseThumbnail.test.ts
+/**
+ * 姿势缩略图回填的筛选/分组逻辑(WebGL 渲染本体经 renderBatch 注入替身,
+ * jsdom 不起 GL):只补「身体姿势 + 无图或死引用」的条目,按骨架族分组,
+ * 无同族模型的跳过,单族渲染失败不影响其他族。
+ */
+import { backfillPoseThumbnails } from './poseThumbnail';
+const BODY = {
+    mixamorigHips: { rotation: [0, 0, 0, 1] },
+};
+const FINGERS = {
+    mixamorigLeftHandThumb1: {
+        rotation: [0, 0, 0, 1],
+    },
+};
+function pose(id, rig, thumbnailId) {
+    return {
+        id,
+        kind: 'pose',
+        name: id,
+        rig,
+        bones: BODY,
+        ...(thumbnailId ? { thumbnailId } : {}),
+        createdAt: 1,
+    };
+}
+function fakeLib(args) {
+    const writable = { id: 'idb' };
+    const sourceById = args.sourceById ?? {};
+    return {
+        writable,
+        listEntries: async (kind) => kind === 'model'
+            ? [{ blobId: 'glb-1', rig: 'rig-a' }, ...(args.models ?? [])]
+            : args.poses ?? [],
+        listBlobIds: async () => args.blobIds ?? [],
+        getBlobUrl: async (b) => 'blob:' + b,
+        putBlobWithEntry: async () => { },
+        getEntrySource: (id) => sourceById[id] ?? writable,
+    };
+}
+test('回填筛选:无图/死引用的身体姿势才渲染;手势与活引用跳过', async () => {
+    const lib = fakeLib({
+        poses: [
+            pose('p-no-thumb', 'rig-a'),
+            pose('p-live', 'rig-a', 'blob-live'), // 活引用
+            pose('p-dead', 'rig-a', 'blob-gone'), // 死引用
+            // 纯手势条目(全身取景看不清手,且有随包图)
+            { ...pose('p-hand', 'rig-a'), bones: FINGERS },
+        ],
+        blobIds: ['blob-live'],
+    });
+    const seen = [];
+    const n = await backfillPoseThumbnails(lib, {
+        renderBatch: async (_lib, _model, entries) => {
+            seen.push(entries.map((e) => e.id));
+            return entries.length;
+        },
+    });
+    expect(seen).toEqual([['p-no-thumb', 'p-dead']]);
+    expect(n).toBe(2);
+});
+test('按骨架族分组渲染;无同族模型的族跳过', async () => {
+    const lib = fakeLib({
+        poses: [pose('p-a', 'rig-a'), pose('p-x', 'rig-x')],
+    });
+    const seen = [];
+    const n = await backfillPoseThumbnails(lib, {
+        renderBatch: async (_lib, model, entries) => {
+            seen.push([model.rig, ...entries.map((e) => e.id)]);
+            return entries.length;
+        },
+    });
+    expect(seen).toEqual([['rig-a', 'p-a']]);
+    expect(n).toBe(1);
+});
+test('单族渲染失败只告警,不影响其他族', async () => {
+    const lib = fakeLib({
+        poses: [pose('p-a', 'rig-a'), pose('p-b', 'rig-b')],
+        models: [{ blobId: 'glb-2', rig: 'rig-b' }],
+    });
+    const warn = jest.spyOn(console, 'warn').mockImplementation(() => { });
+    try {
+        const n = await backfillPoseThumbnails(lib, {
+            renderBatch: async (_lib, model, entries) => {
+                if (model.rig === 'rig-a')
+                    throw new Error('GL 崩了');
+                return entries.length;
+            },
+        });
+        expect(n).toBe(1);
+    }
+    finally {
+        warn.mockRestore();
+    }
+});
+test('内置目录条目不回填:来源不是可写源的条目跳过(目录图由 catalog 运行时渲染)', async () => {
+    const catalog = { id: 'catalog' };
+    const lib = fakeLib({
+        poses: [pose('seed-pose-dpl-x', 'rig-a'), pose('p-user', 'rig-a')],
+        sourceById: { 'seed-pose-dpl-x': catalog },
+    });
+    const seen = [];
+    const n = await backfillPoseThumbnails(lib, {
+        renderBatch: async (_lib, _model, entries) => {
+            seen.push(entries.map((e) => e.id));
+            return entries.length;
+        },
+    });
+    expect(seen).toEqual([['p-user']]);
+    expect(n).toBe(1);
+});

package/dist/assetLibrary/rig.d.ts

@@ -0,0 +1,14 @@
+import type { Object3D } from 'three';
+/** 收集整棵树的骨骼名,排序后返回(排序保证同名集合同结果) */
+export declare function collectBoneNames(root: Object3D): string[];
+/**
+ * 骨架族 id:骨骼名集合的哈希。同一套骨骼命名(如都是 Mixamo 导出)
+ * 的模型自动同族,姿势/动作在同族内通用;无骨骼的模型记 'static'。
+ */
+export declare function rigIdOf(root: Object3D): string;
+/** 网格数量与顶点总数:导入分类和"高度相似"去重比对用 */
+export declare function meshStats(root: Object3D): {
+    meshCount: number;
+    vertexCount: number;
+};
+//# sourceMappingURL=rig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rig.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/rig.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,OAAO,CAAA;AAGnC,mCAAmC;AACnC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CAMzD;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAI9C;AAED,iCAAiC;AACjC,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG;IACzC,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;CACpB,CAWA"}

package/dist/assetLibrary/rig.js

@@ -0,0 +1,33 @@
+import { hashString } from './hash';
+/** 收集整棵树的骨骼名,排序后返回(排序保证同名集合同结果) */
+export function collectBoneNames(root) {
+    const names = [];
+    root.traverse((obj) => {
+        if (obj.isBone)
+            names.push(obj.name);
+    });
+    return names.sort();
+}
+/**
+ * 骨架族 id:骨骼名集合的哈希。同一套骨骼命名(如都是 Mixamo 导出)
+ * 的模型自动同族,姿势/动作在同族内通用;无骨骼的模型记 'static'。
+ */
+export function rigIdOf(root) {
+    const names = collectBoneNames(root);
+    if (names.length === 0)
+        return 'static';
+    return 'rig-' + hashString(names.join(''));
+}
+/** 网格数量与顶点总数:导入分类和"高度相似"去重比对用 */
+export function meshStats(root) {
+    let meshCount = 0;
+    let vertexCount = 0;
+    root.traverse((obj) => {
+        const mesh = obj;
+        if (mesh.isMesh) {
+            meshCount++;
+            vertexCount += mesh.geometry?.attributes?.position?.count ?? 0;
+        }
+    });
+    return { meshCount, vertexCount };
+}

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

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

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

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

package/dist/assetLibrary/rig.test.js

@@ -0,0 +1,55 @@
+import { Bone, BoxGeometry, Group, Mesh, MeshBasicMaterial } from 'three';
+import { hashBytes, hashString } from './hash';
+import { collectBoneNames, meshStats, rigIdOf } from './rig';
+function makeRig(...names) {
+    const root = new Group();
+    let parent;
+    for (const name of names) {
+        const bone = new Bone();
+        bone.name = name;
+        if (parent)
+            parent.add(bone);
+        else
+            root.add(bone);
+        parent = bone;
+    }
+    return root;
+}
+describe('hashBytes', () => {
+    it('同样输入同样输出,不同输入不同输出', () => {
+        const a = new Uint8Array([1, 2, 3]);
+        expect(hashBytes(a)).toBe(hashBytes(new Uint8Array([1, 2, 3])));
+        expect(hashBytes(a)).not.toBe(hashBytes(new Uint8Array([1, 2, 4])));
+        expect(hashBytes(a)).toMatch(/^[0-9a-f]{16}$/);
+    });
+    it('hashString 对字符串稳定', () => {
+        expect(hashString('abc')).toBe(hashString('abc'));
+        expect(hashString('abc')).not.toBe(hashString('abd'));
+    });
+});
+describe('rigIdOf', () => {
+    it('同一套骨骼名(顺序不同)得到同一个骨架族 id', () => {
+        expect(rigIdOf(makeRig('Hips', 'Spine', 'Head'))).toBe(rigIdOf(makeRig('Head', 'Hips', 'Spine')));
+    });
+    it('不同骨骼名得到不同 id', () => {
+        expect(rigIdOf(makeRig('Hips'))).not.toBe(rigIdOf(makeRig('Legs')));
+    });
+    it('没有骨骼返回 static', () => {
+        const g = new Group();
+        g.add(new Mesh(new BoxGeometry(), new MeshBasicMaterial()));
+        expect(rigIdOf(g)).toBe('static');
+    });
+});
+describe('meshStats', () => {
+    it('统计网格数和顶点数', () => {
+        const g = makeRig('Hips');
+        g.add(new Mesh(new BoxGeometry(), new MeshBasicMaterial()));
+        g.add(new Mesh(new BoxGeometry(), new MeshBasicMaterial()));
+        expect(meshStats(g)).toEqual({ meshCount: 2, vertexCount: 48 });
+    });
+});
+describe('collectBoneNames', () => {
+    it('返回排序后的骨骼名', () => {
+        expect(collectBoneNames(makeRig('b', 'a', 'c'))).toEqual(['a', 'b', 'c']);
+    });
+});

package/dist/assetLibrary/seedAssetsManifest.d.ts

@@ -0,0 +1,24 @@
+export type SeedModelAsset = {
+    /** 运行时 id 用稳定 key(小写连字符),如 catalog:runtime/model/<key> */
+    key: string;
+    /** assets/models/ 下的文件名( served 相对路径 models/<file> ) */
+    file: string;
+    /** GLB 字节 FNV-1a;条目 id = seed-model-<contentHash> */
+    contentHash: string;
+    name: string;
+    /** 运行时 FBX 解析同一判定(rigIdOf);勿用 GLB joints 重算(剥骨/双套差异) */
+    rig: string;
+    boneCount: number;
+    vertexCount: number;
+};
+export type SeedPoseThumbAsset = {
+    /** 姿势种子 key(qbx-hands-*),与姿势条目 id 后缀一致 */
+    key: string;
+    file: string;
+};
+export type SeedAssetsManifest = {
+    models: SeedModelAsset[];
+    poseThumbs: SeedPoseThumbAsset[];
+};
+export declare const seedAssetsManifest: SeedAssetsManifest;
+//# sourceMappingURL=seedAssetsManifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seedAssetsManifest.d.ts","sourceRoot":"","sources":["../../src/assetLibrary/seedAssetsManifest.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,cAAc,GAAG;IAC3B,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAA;IACX,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAA;IACZ,qDAAqD;IACrD,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,0CAA0C;IAC1C,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,UAAU,EAAE,kBAAkB,EAAE,CAAA;CACjC,CAAA;AAED,eAAO,MAAM,kBAAkB,EAAE,kBA0VhC,CAAA"}