@dreamerbird/camera-studio 0.0.0-stage → 0.2.0

package/dist/poseMode/controlSpec.test.js

@@ -0,0 +1,196 @@
+// packages/camera-studio/src/poseMode/controlSpec.test.ts
+import { Bone, Group, Vector3 } from 'three';
+import { deriveHumanoidFacing, findRootBone, measureSkeletonScale, resolveControlSpec, } from './controlSpec';
+/** 按 Mixamo 命名习惯拼一棵骨架(平面树即可:映射只看骨名) */
+function skeletonWith(names) {
+    const root = new Group();
+    for (const n of names) {
+        const b = new Bone();
+        b.name = n;
+        root.add(b);
+    }
+    return root;
+}
+const MIXAMO_REQUIRED = [
+    'mixamorig:Hips',
+    'mixamorig:Spine',
+    'mixamorig:Spine1',
+    'mixamorig:Spine2',
+    'mixamorig:Neck',
+    'mixamorig:Head',
+    'mixamorig:LeftShoulder',
+    'mixamorig:LeftArm',
+    'mixamorig:LeftForeArm',
+    'mixamorig:LeftHand',
+    'mixamorig:RightShoulder',
+    'mixamorig:RightArm',
+    'mixamorig:RightForeArm',
+    'mixamorig:RightHand',
+    'mixamorig:LeftUpLeg',
+    'mixamorig:LeftLeg',
+    'mixamorig:LeftFoot',
+    'mixamorig:RightUpLeg',
+    'mixamorig:RightLeg',
+    'mixamorig:RightFoot',
+];
+test('Mixamo 全骨 → 完整控制点表,骨名用模型侧名字', () => {
+    const spec = resolveControlSpec(skeletonWith(MIXAMO_REQUIRED));
+    expect(spec).not.toBeNull();
+    const byName = new Map(spec.map((c) => [c.name, c]));
+    expect([...byName.keys()].sort()).toEqual(['armL', 'armR', 'chest', 'head', 'hips', 'legL', 'legR', 'spine'].sort());
+    expect(byName.get('hips').bone).toBe('mixamorig:Hips');
+    expect(byName.get('armL').rootBone).toBe('mixamorig:LeftArm');
+    expect(byName.get('armL').endBone).toBe('mixamorig:LeftHand');
+    expect(byName.get('spine').endBone).toBe('mixamorig:Neck');
+    expect(byName.get('head').rootBone).toBe('mixamorig:Neck');
+});
+test('缺关键骨(LeftHand)→ null', () => {
+    const names = MIXAMO_REQUIRED.filter((n) => n !== 'mixamorig:LeftHand');
+    expect(resolveControlSpec(skeletonWith(names))).toBeNull();
+});
+test('无前缀 Mixamo 命名(ReadyPlayerMe 风格)→ 可解析', () => {
+    const names = MIXAMO_REQUIRED.map((n) => n.replace('mixamorig:', ''));
+    const spec = resolveControlSpec(skeletonWith(names));
+    expect(spec).not.toBeNull();
+    expect(spec.find((c) => c.name === 'hips').bone).toBe('Hips');
+});
+test('VRM camelCase 命名 → 可解析', () => {
+    const names = [
+        'hips',
+        'spine',
+        'chest',
+        'upperChest',
+        'neck',
+        'head',
+        'leftShoulder',
+        'leftUpperArm',
+        'leftLowerArm',
+        'leftHand',
+        'rightShoulder',
+        'rightUpperArm',
+        'rightLowerArm',
+        'rightHand',
+        'leftUpperLeg',
+        'leftLowerLeg',
+        'leftFoot',
+        'rightUpperLeg',
+        'rightLowerLeg',
+        'rightFoot',
+    ];
+    const spec = resolveControlSpec(skeletonWith(names));
+    expect(spec).not.toBeNull();
+    expect(spec.find((c) => c.name === 'hips').bone).toBe('hips');
+});
+test('无骨骼 → null;findRootBone 找父不是 Bone 的第一根', () => {
+    expect(resolveControlSpec(new Group())).toBeNull();
+    expect(findRootBone(new Group())).toBeNull();
+    const root = new Group();
+    const hips = new Bone();
+    hips.name = 'Hips';
+    const spine = new Bone();
+    spine.name = 'Spine';
+    hips.add(spine);
+    root.add(hips);
+    expect(findRootBone(root)?.name).toBe('Hips');
+});
+// —— measureSkeletonScale ——
+function positionedSkeleton(positions) {
+    const root = new Group();
+    for (const [n, y] of Object.entries(positions)) {
+        const b = new Bone();
+        b.name = n;
+        b.position.y = y;
+        root.add(b);
+    }
+    return root;
+}
+test('measureSkeletonScale: 3.4 单位高人形 → 倍率 ≈ 2', () => {
+    // Mixamo 全骨平铺,Head 在 3.4、双脚在 0 → 高 3.4 → 3.4/1.7 = 2
+    const pos = {};
+    for (const n of MIXAMO_REQUIRED)
+        pos[n] = 0;
+    pos['mixamorig:Head'] = 3.4;
+    expect(measureSkeletonScale(positionedSkeleton(pos))).toBeCloseTo(2, 5);
+});
+test('measureSkeletonScale: 1.7 单位人形 → 倍率 1', () => {
+    const pos = {};
+    for (const n of MIXAMO_REQUIRED)
+        pos[n] = 0;
+    pos['mixamorig:Head'] = 1.7;
+    expect(measureSkeletonScale(positionedSkeleton(pos))).toBeCloseTo(1, 5);
+});
+test('measureSkeletonScale: 缺关键骨 → 1;全骨同高(测不出高度)→ 1;巨人不超上限 8', () => {
+    const partial = MIXAMO_REQUIRED.filter((n) => n !== 'mixamorig:Head');
+    expect(measureSkeletonScale(skeletonWith(partial))).toBe(1);
+    expect(measureSkeletonScale(skeletonWith(MIXAMO_REQUIRED))).toBe(1);
+    const pos = {};
+    for (const n of MIXAMO_REQUIRED)
+        pos[n] = 0;
+    pos['mixamorig:Head'] = 100;
+    expect(measureSkeletonScale(positionedSkeleton(pos))).toBe(8);
+});
+// —— deriveHumanoidFacing ——
+/**
+ * 有层级、有位置的 T 型骨架:面朝 +Z(左髋 +X、脊柱 +Y);
+ * 其余关键骨平铺兜底(coverage 只看骨名),facing 只读 髋/颈(或头)/左右大腿根
+ */
+function humanoidRig(rotateY = 0) {
+    const root = new Group();
+    const hips = new Bone();
+    hips.name = 'mixamorig:Hips';
+    hips.position.set(0, 1, 0);
+    const spine = new Bone();
+    spine.name = 'mixamorig:Spine';
+    spine.position.set(0, 0.15, 0);
+    hips.add(spine);
+    const neck = new Bone();
+    neck.name = 'mixamorig:Neck';
+    neck.position.set(0, 0.35, 0);
+    spine.add(neck);
+    const head = new Bone();
+    head.name = 'mixamorig:Head';
+    head.position.set(0, 0.15, 0);
+    neck.add(head);
+    const upLegL = new Bone();
+    upLegL.name = 'mixamorig:LeftUpLeg';
+    upLegL.position.set(0.1, -0.05, 0); // 面朝 +Z 时角色的左侧在 +X
+    hips.add(upLegL);
+    const upLegR = new Bone();
+    upLegR.name = 'mixamorig:RightUpLeg';
+    upLegR.position.set(-0.1, -0.05, 0);
+    hips.add(upLegR);
+    root.add(hips);
+    for (const n of MIXAMO_REQUIRED) {
+        if (root.getObjectByName(n))
+            continue;
+        const b = new Bone();
+        b.name = n;
+        root.add(b);
+    }
+    root.rotation.y = rotateY;
+    root.updateMatrixWorld(true);
+    return root;
+}
+test('deriveHumanoidFacing: 面朝 +Z 的 T 型 → (0,0,1)', () => {
+    const f = deriveHumanoidFacing(humanoidRig());
+    expect(f).not.toBeNull();
+    expect(f.angleTo(new Vector3(0, 0, 1))).toBeLessThan(1e-6);
+});
+test('deriveHumanoidFacing: 放置旋转 90° → 朝向跟着转(+1,0,0)', () => {
+    const f = deriveHumanoidFacing(humanoidRig(Math.PI / 2));
+    expect(f.angleTo(new Vector3(1, 0, 0))).toBeLessThan(1e-6);
+});
+test('deriveHumanoidFacing: 非人形/退化 → null', () => {
+    expect(deriveHumanoidFacing(new Group())).toBeNull();
+    const flat = skeletonWith(MIXAMO_REQUIRED); // 全骨原点,脊柱/髋轴退化
+    expect(deriveHumanoidFacing(flat)).toBeNull();
+});
+test('朝向决定肘/膝 pole 方位:面朝 +Z 时肘在后(-Z)、膝在前(+Z)', () => {
+    const spec = resolveControlSpec(humanoidRig(), new Vector3(0, 0, 1));
+    const byName = new Map(spec.map((c) => [c.name, c]));
+    const poleZ = (n) => byName.get(n).pole.position.z;
+    expect(poleZ('armL')).toBeLessThan(0); // 肘朝后
+    expect(poleZ('armR')).toBeLessThan(0);
+    expect(poleZ('legL')).toBeGreaterThan(0); // 膝朝前
+    expect(poleZ('legR')).toBeGreaterThan(0);
+});

package/dist/poseMode/dragState.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 姿势会话脏检查:退出前判定用户是否真拖过控制点。
+ * 空进空出不提交(threeIK 首解有微小漂移,写回会产生幻影撤销步);
+ * 语义对齐 modalGrab 的 `commit && moved`。
+ */
+/** 各 kind 句柄上可拖的操纵器面:target 已在 ctl.targets 里,这里只补环与 pole */
+type Draggable = {
+    readonly isDragging: boolean;
+};
+/** names = 控制点装配表的 name 列表(resolveControlSpec 产物的 c.name) */
+export declare function anyControlDragging(ctl: {
+    readonly targets: readonly Draggable[];
+    get(name: string): unknown;
+}, names: readonly string[]): boolean;
+export {};
+//# sourceMappingURL=dragState.d.ts.map

package/dist/poseMode/dragState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dragState.d.ts","sourceRoot":"","sources":["../../src/poseMode/dragState.ts"],"names":[],"mappings":"AACA;;;;GAIG;AACH,4DAA4D;AAC5D,KAAK,SAAS,GAAG;IAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;CAAC,CAAA;AAQ/C,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAChC,GAAG,EAAE;IACH,QAAQ,CAAC,OAAO,EAAE,SAAS,SAAS,EAAE,CAAA;IACtC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;CAC3B,EACD,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,OAAO,CAaT"}

package/dist/poseMode/dragState.js

@@ -0,0 +1,15 @@
+/** names = 控制点装配表的 name 列表(resolveControlSpec 产物的 c.name) */
+export function anyControlDragging(ctl, names) {
+    for (const t of ctl.targets)
+        if (t.isDragging)
+            return true;
+    for (const name of names) {
+        const h = ctl.get(name);
+        if (h?.pole?.isDragging ||
+            h?.rings?.isDragging ||
+            h?.elbowRings?.isDragging ||
+            h?.shoulderRings?.isDragging)
+            return true;
+    }
+    return false;
+}

package/dist/poseMode/dragState.test.d.ts

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

package/dist/poseMode/dragState.test.d.ts.map

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

package/dist/poseMode/dragState.test.js

@@ -0,0 +1,23 @@
+// packages/camera-studio/src/poseMode/dragState.test.ts
+import { anyControlDragging } from './dragState';
+const target = (dragging) => ({ isDragging: dragging });
+const ctl = (targets, handles = {}) => ({
+    targets: targets,
+    get: (name) => handles[name],
+});
+const NAMES = ['hips', 'armL', 'spine', 'chest'];
+test('无拖动 → false(空 targets、句柄缺面、未知名都不误报)', () => {
+    expect(anyControlDragging(ctl([]), NAMES)).toBe(false);
+    expect(anyControlDragging(ctl([target(false), target(false)], {
+        armL: { pole: { isDragging: false }, elbowRings: { isDragging: false } },
+    }), NAMES)).toBe(false);
+    expect(anyControlDragging(ctl([target(false)]), ['nope'])).toBe(false);
+});
+test('任一 target 拖动 → true', () => {
+    expect(anyControlDragging(ctl([target(false), target(true)]), NAMES)).toBe(true);
+});
+test('pole/elbowRings/rings/shoulderRings 任一拖动 → true', () => {
+    for (const surface of ['pole', 'elbowRings', 'rings', 'shoulderRings']) {
+        expect(anyControlDragging(ctl([target(false)], { armL: { [surface]: { isDragging: true } } }), NAMES)).toBe(true);
+    }
+});

package/dist/poseMode/poseDisplayText.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 姿势属性行值区域的显示文本,纯函数便于单测(2026-10-01 与用户对齐):
+ * 空值(绑定/默认)→「T 姿势」;库预设 → 预设名称(条目被删 → id +
+ * 缺失标记);自定义(直接摆的,或选预设后又编辑过)→「自定义姿势」。
+ */
+import type { PoseEntry } from '../assetLibrary/types';
+export declare function poseDisplayText(args: {
+    /** 当前 pose 属性值(JSON 字符串,''=绑定/T 姿势) */
+    poseJson: string;
+    libEntries: Pick<PoseEntry, 'id' | 'name' | 'rig'>[];
+    /** 显示名解析(poseEntryName:种子条目查 i18n 词典);缺省=条目名原文 */
+    nameOf?: (entry: {
+        id: string;
+        name: string;
+    }) => string;
+    t: (k: string) => string;
+}): string;
+//# sourceMappingURL=poseDisplayText.d.ts.map

package/dist/poseMode/poseDisplayText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poseDisplayText.d.ts","sourceRoot":"","sources":["../../src/poseMode/poseDisplayText.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,uBAAuB,CAAA;AAGpD,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,KAAK,CAAC,EAAE,CAAA;IACpD,kDAAkD;IAClD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,KAAK,MAAM,CAAA;IACtD,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAAA;CACzB,GAAG,MAAM,CAST"}

package/dist/poseMode/poseDisplayText.js

@@ -0,0 +1,13 @@
+import { parsePoseValue } from './poseValue';
+export function poseDisplayText(args) {
+    const { poseJson, libEntries, nameOf, t } = args;
+    const value = parsePoseValue(poseJson);
+    if (!value)
+        return t('pg.pose.tPose');
+    if (value.kind === 'custom')
+        return t('pg.pose.statusCustom');
+    const entry = libEntries.find((e) => e.id === value.id);
+    return entry
+        ? nameOf?.(entry) ?? entry.name
+        : `${value.id}${t('pg.pose.libMissing')}`;
+}

package/dist/poseMode/poseDisplayText.test.d.ts

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

package/dist/poseMode/poseDisplayText.test.d.ts.map

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

package/dist/poseMode/poseDisplayText.test.js

@@ -0,0 +1,35 @@
+/**
+ * 姿势属性行的值区域显示文本(2026-10-01 与用户对齐):
+ * - 空值(绑定)= 默认人体姿势 → 「T 姿势」;
+ * - 库预设 → 预设名称(条目被删 → id + 缺失标记);
+ * - 自定义(直接摆的,或选预设后又编辑过)→ 「自定义姿势」。
+ */
+import { poseDisplayText } from './poseDisplayText';
+import { serializeCustomPose, serializeLibPose } from './poseValue';
+const t = (k) => `#${k}#`;
+const libEntries = [
+    { id: 'lib-wave', name: '挥手', rig: 'mixamo' },
+    { id: 'lib-sit', name: '坐下', rig: 'mixamo' },
+];
+test('空值 → T 姿势', () => {
+    expect(poseDisplayText({ poseJson: '', libEntries, t })).toBe('#pg.pose.tPose#');
+});
+test('库预设命中 → 显示预设名称', () => {
+    expect(poseDisplayText({ poseJson: serializeLibPose('lib-wave'), libEntries, t })).toBe('挥手');
+});
+test('库预设缺失 → id + 缺失标记', () => {
+    const text = poseDisplayText({
+        poseJson: serializeLibPose('lib-gone'),
+        libEntries,
+        t,
+    });
+    expect(text).toContain('lib-gone');
+    expect(text).toContain('#pg.pose.libMissing#');
+});
+test('自定义 → 自定义姿势', () => {
+    expect(poseDisplayText({
+        poseJson: serializeCustomPose({ Hips: { rotation: [0, 0, 0, 1] } }),
+        libEntries,
+        t,
+    })).toBe('#pg.pose.statusCustom#');
+});

package/dist/poseMode/poseExitGuard.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 姿势退出快捷键(Enter)的目标守卫:交互元素(输入框/按钮/链接/下拉/
+ * contentEditable)与 studio UI(shadow DOM)内的事件不触发退出——
+ * 前者把 Enter 让给控件自身(按钮 Enter=click,会在保存后误触),
+ * 后者让 studio 自己处理。
+ */
+export declare function isPoseExitGuardedTarget(target: EventTarget | null): boolean;
+//# sourceMappingURL=poseExitGuard.d.ts.map

package/dist/poseMode/poseExitGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poseExitGuard.d.ts","sourceRoot":"","sources":["../../src/poseMode/poseExitGuard.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAM3E"}

package/dist/poseMode/poseExitGuard.js

@@ -0,0 +1,13 @@
+// packages/camera-studio/src/poseMode/poseExitGuard.ts
+/**
+ * 姿势退出快捷键(Enter)的目标守卫:交互元素(输入框/按钮/链接/下拉/
+ * contentEditable)与 studio UI(shadow DOM)内的事件不触发退出——
+ * 前者把 Enter 让给控件自身(按钮 Enter=click,会在保存后误触),
+ * 后者让 studio 自己处理。
+ */
+export function isPoseExitGuardedTarget(target) {
+    const el = target;
+    if (!el || typeof el.closest !== 'function')
+        return false;
+    return !!el.closest('input, textarea, select, button, a, [contenteditable], [role="button"]');
+}

package/dist/poseMode/poseExitGuard.test.d.ts

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

package/dist/poseMode/poseExitGuard.test.d.ts.map

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

package/dist/poseMode/poseExitGuard.test.js

@@ -0,0 +1,41 @@
+/*
+ * @jest-environment jsdom
+ */
+// packages/camera-studio/src/poseMode/poseExitGuard.test.ts
+/**
+ * 姿势退出 Enter 守卫(spec §8.1 终审 F3):Enter 在交互元素(输入框/
+ * 按钮/链接/下拉/contentEditable)里是控件自身语义(按钮 Enter=click,
+ * 会在保存帧之后误触按钮处理器),不能触发退出保存。
+ */
+import { isPoseExitGuardedTarget } from './poseExitGuard';
+test('普通容器/画布目标不守卫', () => {
+    const div = document.createElement('div');
+    expect(isPoseExitGuardedTarget(div)).toBe(false);
+    const canvas = document.createElement('canvas');
+    expect(isPoseExitGuardedTarget(canvas)).toBe(false);
+});
+test('输入框/文本域/contentEditable 守卫', () => {
+    expect(isPoseExitGuardedTarget(document.createElement('input'))).toBe(true);
+    expect(isPoseExitGuardedTarget(document.createElement('textarea'))).toBe(true);
+    const editable = document.createElement('div');
+    editable.setAttribute('contenteditable', 'true');
+    expect(isPoseExitGuardedTarget(editable)).toBe(true);
+});
+test('按钮守卫(含按钮内嵌套子元素——span 命中最近的 button)', () => {
+    const button = document.createElement('button');
+    expect(isPoseExitGuardedTarget(button)).toBe(true);
+    const span = document.createElement('span');
+    button.appendChild(span);
+    expect(isPoseExitGuardedTarget(span)).toBe(true);
+});
+test('链接/下拉/role=button 守卫', () => {
+    expect(isPoseExitGuardedTarget(document.createElement('a'))).toBe(true);
+    expect(isPoseExitGuardedTarget(document.createElement('select'))).toBe(true);
+    const roleButton = document.createElement('div');
+    roleButton.setAttribute('role', 'button');
+    expect(isPoseExitGuardedTarget(roleButton)).toBe(true);
+});
+test('非元素目标(null/window 等)不守卫', () => {
+    expect(isPoseExitGuardedTarget(null)).toBe(false);
+    expect(isPoseExitGuardedTarget({})).toBe(false);
+});

package/dist/poseMode/poseFrame.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 摆姿势进入的帧模式判定(spec §8.1):底姿 = 播放头处时间轴求值(画面
+ * 即求值,编辑态与画面一张皮);帧上进入 = 编辑该帧(保存覆盖),帧间
+ * 进入 = 新建帧(保存插入)。位置一律贴网格(theatre 写帧也会贴)。
+ */
+export type PoseFrameMode = {
+    mode: 'edit' | 'new';
+    position: number;
+};
+export declare function determinePoseFrameMode(keyframePositions: number[], position: number, snap: (t: number) => number): PoseFrameMode;
+//# sourceMappingURL=poseFrame.d.ts.map

package/dist/poseMode/poseFrame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poseFrame.d.ts","sourceRoot":"","sources":["../../src/poseMode/poseFrame.ts"],"names":[],"mappings":"AACA;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG;IAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAC,CAAA;AAEpE,wBAAgB,sBAAsB,CACpC,iBAAiB,EAAE,MAAM,EAAE,EAC3B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,GAC1B,aAAa,CAMf"}

package/dist/poseMode/poseFrame.js

@@ -0,0 +1,7 @@
+export function determinePoseFrameMode(keyframePositions, position, snap) {
+    const snapped = snap(position);
+    return {
+        mode: keyframePositions.includes(snapped) ? 'edit' : 'new',
+        position: snapped,
+    };
+}

package/dist/poseMode/poseFrame.test.d.ts

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

package/dist/poseMode/poseFrame.test.d.ts.map

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

package/dist/poseMode/poseFrame.test.js

@@ -0,0 +1,25 @@
+// packages/camera-studio/src/poseMode/poseFrame.test.ts
+/**
+ * 摆姿势进入的帧模式判定(spec §8.1):播放头贴网格后恰等于某姿势帧 =
+ * 编辑该帧(保存=覆盖);否则 = 新建帧(保存=插入)。
+ */
+import { determinePoseFrameMode } from './poseFrame';
+const snap = (t) => Math.round(t * 30) / 30; // 30fps 网格
+test('播放头贴网格后落在帧上 = edit', () => {
+    expect(determinePoseFrameMode([1, 2, 3], 2.001, snap)).toEqual({
+        mode: 'edit',
+        position: 2,
+    });
+});
+test('两帧之间 = new', () => {
+    expect(determinePoseFrameMode([1, 2, 3], 2.5, snap)).toEqual({
+        mode: 'new',
+        position: 2.5,
+    });
+});
+test('无帧轨道 = new(保存即建轨写首帧)', () => {
+    expect(determinePoseFrameMode([], 0, snap)).toEqual({
+        mode: 'new',
+        position: 0,
+    });
+});

package/dist/poseMode/poseInterpolate.d.ts

@@ -0,0 +1,4 @@
+import type { PoseBones } from './poseOverride';
+export declare function mixPoseBones(a: PoseBones, b: PoseBones, t: number): PoseBones;
+export declare function poseInterpolate(leftJson: string, rightJson: string, progression: number): string;
+//# sourceMappingURL=poseInterpolate.d.ts.map

package/dist/poseMode/poseInterpolate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poseInterpolate.d.ts","sourceRoot":"","sources":["../../src/poseMode/poseInterpolate.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,gBAAgB,CAAA;AAsB7C,wBAAgB,YAAY,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAmC7E;AAED,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,MAAM,CAKR"}

package/dist/poseMode/poseInterpolate.js

@@ -0,0 +1,75 @@
+// packages/camera-studio/src/poseMode/poseInterpolate.ts
+/**
+ * 姿势属性的自定义插值器(spec §4),注入 t.string 的 opts.interpolate。
+ * theatre 求值契约:(left, right, progression) => value,progression 已过
+ * 贝塞尔手柄缓动。语义:
+ *   两侧都解析出骨骼 → 逐骨骼 slerp/lerp,结果恒为 custom 快照——
+ *     两帧之间的求值产物天然可被 applyPose 直接回放;
+ *   任一侧为空/非法/库引用未解析 → 阶跃,原样返回 left(与 theatre 缺省
+ *     leftInterpolate 行为一致,可预测)。
+ * 性能:parse 按字符串值小容量 LRU;拖针/播放时帧值不变全部命中。
+ */
+import { Quaternion, Vector3 } from 'three';
+import { resolvePoseBones } from './poseLibResolve';
+import { parsePoseValue, serializeCustomPose } from './poseValue';
+const PARSE_CACHE_LIMIT = 64;
+const parseCache = new Map();
+// PoseEntry 骨骼字段可缺省,插值缺侧补单位旋转/零位移
+const IDENTITY_ROT = [0, 0, 0, 1];
+const ZERO_POS = [0, 0, 0];
+function parseCached(json) {
+    const hit = parseCache.get(json);
+    if (hit !== undefined || parseCache.has(json))
+        return hit ?? null;
+    const v = parsePoseValue(json);
+    if (parseCache.size >= PARSE_CACHE_LIMIT) {
+        parseCache.delete(parseCache.keys().next().value);
+    }
+    parseCache.set(json, v);
+    return v;
+}
+export function mixPoseBones(a, b, t) {
+    // 端点短路(跳过逐骨骼数学):共享骨骼取端点侧,只在一侧有的骨骼仍要
+    // 保留——否则 t=0 时右帧独有骨骼会凭空消失
+    if (t === 0)
+        return { ...b, ...a };
+    if (t === 1)
+        return { ...a, ...b };
+    const out = {};
+    const qa = new Quaternion();
+    const qb = new Quaternion();
+    const va = new Vector3();
+    const vb = new Vector3();
+    for (const name of new Set([...Object.keys(a), ...Object.keys(b)])) {
+        const ba = a[name];
+        const bb = b[name];
+        // 只在一侧有的骨骼全程取有数据侧(不淡入淡出,避免半姿势)
+        if (ba && !bb) {
+            out[name] = ba;
+            continue;
+        }
+        if (!ba && bb) {
+            out[name] = bb;
+            continue;
+        }
+        // 类型上 rotation/position 均可缺省(见 PoseEntry),缺失按单位旋转/零位移补
+        qa.fromArray(ba.rotation ?? IDENTITY_ROT);
+        qb.fromArray(bb.rotation ?? IDENTITY_ROT);
+        qa.slerp(qb, t);
+        va.fromArray(ba.position ?? ZERO_POS);
+        vb.fromArray(bb.position ?? ZERO_POS);
+        va.lerp(vb, t);
+        out[name] = {
+            rotation: [qa.x, qa.y, qa.z, qa.w],
+            position: [va.x, va.y, va.z],
+        };
+    }
+    return out;
+}
+export function poseInterpolate(leftJson, rightJson, progression) {
+    const lb = resolvePoseBones(parseCached(leftJson));
+    const rb = resolvePoseBones(parseCached(rightJson));
+    if (!lb || !rb)
+        return leftJson;
+    return serializeCustomPose(mixPoseBones(lb, rb, progression));
+}

package/dist/poseMode/poseInterpolate.test.d.ts

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

package/dist/poseMode/poseInterpolate.test.d.ts.map

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

package/dist/poseMode/poseInterpolate.test.js

@@ -0,0 +1,61 @@
+// packages/camera-studio/src/poseMode/poseInterpolate.test.ts
+/**
+ * 姿势插值器(spec §4):两侧都能解析出骨骼 → 逐骨骼 slerp/lerp,结果恒为
+ * custom 快照(两帧之间的求值产物);任一侧不行 → 阶跃返回 left。
+ * parse 结果按字符串值 LRU 缓存,求值热路径不重复 parse。
+ */
+import { Quaternion, Vector3 } from 'three';
+import { mixPoseBones, poseInterpolate } from './poseInterpolate';
+import { __primeLibPoseCache, __resetLibPoseCache } from './poseLibResolve';
+import { serializeCustomPose, serializeLibPose } from './poseValue';
+const A = {
+    Hips: { rotation: [0, 0, 0, 1], position: [0, 1, 0] },
+};
+const B = {
+    // 绕 Z 转 90°:四元数 (0,0,sin45°,cos45°)
+    Hips: { rotation: [0, 0, Math.SQRT1_2, Math.SQRT1_2], position: [0, 2, 2] },
+};
+beforeEach(() => {
+    __resetLibPoseCache();
+    // 阶跃用例会触发 warn-once(库未解析/非法 JSON),统一压掉控制台噪音
+    jest.spyOn(console, 'warn').mockImplementation(() => { });
+});
+test('mixPoseBones:中点 = 旋转 slerp 一半 + 位置 lerp 一半', () => {
+    const mid = mixPoseBones(A, B, 0.5);
+    const q = new Quaternion().fromArray(mid.Hips.rotation);
+    const expected = new Quaternion().slerp(new Quaternion(0, 0, Math.SQRT1_2, Math.SQRT1_2), 0.5);
+    expect(q.angleTo(expected)).toBeLessThan(1e-6);
+    expect(new Vector3().fromArray(mid.Hips.position).toArray()).toEqual([
+        0, 1.5, 1,
+    ]);
+});
+test('mixPoseBones:端点恒等(t=0 回 a,t=1 回 b)', () => {
+    expect(mixPoseBones(A, B, 0)).toEqual(A);
+    expect(mixPoseBones(A, B, 1)).toEqual(B);
+});
+test('mixPoseBones:只在一侧有的骨骼全程取有数据侧', () => {
+    const onlyA = { ArmL: { rotation: [0, 0, 0, 1], position: [1, 0, 0] } };
+    const merged = { ...A, ...onlyA };
+    for (const t of [0, 0.3, 1]) {
+        expect(mixPoseBones(merged, B, t).ArmL).toEqual(onlyA.ArmL);
+        expect(mixPoseBones(A, { ...B, ...onlyA }, t).ArmL).toEqual(onlyA.ArmL);
+    }
+});
+test('poseInterpolate:custom↔custom 结果是可回读的 custom 快照', () => {
+    const out = poseInterpolate(serializeCustomPose(A), serializeCustomPose(B), 0.5);
+    expect(JSON.parse(out).kind).toBe('custom');
+    expect(out).toBe(serializeCustomPose(mixPoseBones(A, B, 0.5)));
+});
+test('poseInterpolate:lib 引用经缓存解析后参与混合(lib↔custom、lib↔lib)', () => {
+    __primeLibPoseCache('pa', A);
+    __primeLibPoseCache('pb', B);
+    expect(poseInterpolate(serializeLibPose('pa'), serializeCustomPose(B), 1)).toBe(serializeCustomPose(B));
+    expect(poseInterpolate(serializeLibPose('pa'), serializeLibPose('pb'), 0)).toBe(serializeCustomPose(A));
+});
+test('poseInterpolate:一侧空/非法/库未解析 → 阶跃返回 left 原串', () => {
+    const left = serializeCustomPose(A);
+    expect(poseInterpolate(left, '', 0.5)).toBe(left);
+    expect(poseInterpolate(left, '{oops', 0.5)).toBe(left);
+    expect(poseInterpolate(left, serializeLibPose('notFetched'), 0.5)).toBe(left);
+    expect(poseInterpolate('', serializeCustomPose(B), 0.5)).toBe('');
+});

package/dist/poseMode/poseLibResolve.d.ts

@@ -0,0 +1,9 @@
+import type { PoseBones } from './poseOverride';
+import type { PosePropValue } from './poseValue';
+export declare function resolveLibPoseBones(id: string): PoseBones | null;
+export declare function resolvePoseBones(value: PosePropValue | null): PoseBones | null;
+export declare function prefetchLibPoses(ids: Iterable<string>, onReady: () => void): Promise<void>;
+/** 测试与已知好数据(如刚解析过的库面板列表)直填缓存 */
+export declare function __primeLibPoseCache(id: string, bones: PoseBones): void;
+export declare function __resetLibPoseCache(): void;
+//# sourceMappingURL=poseLibResolve.d.ts.map