@dreamerbird/camera-studio 0.0.0-stage → 0.1.0

package/dist/poseMode/poseSession.d.ts

@@ -0,0 +1,58 @@
+export type { PoseFrameMode } from './poseFrame';
+import type { PoseFrameMode } from './poseFrame';
+export type PoseSession = {
+    key: string;
+};
+export declare function getPoseSession(): PoseSession | null;
+export declare function onPoseSessionChange(cb: (s: PoseSession | null) => void): () => void;
+/** PoseModeRig 订阅:外部请求退出时回调(提交 + clearPoseSession) */
+export declare function onPoseExitRequested(cb: (key: string) => void): () => void;
+/** 请求退出当前会话;监听者没清会话时兜底清掉,防状态卡死。
+ *  try/finally:监听抛异常(如 capturePose 失败)也兜底清理,异常照常上抛 */
+export declare function requestPoseExit(): void;
+/** 会话唯一:已在摆别的模型时,先按退出流程提交旧会话再开新的 */
+export declare function enterPoseSession(key: string): void;
+/** PoseModeRig 的 canvas pointerdown 监听调用:按下即记脏(见上)。
+ *  无会话不记:清会话后、监听卸载前的窗口期按下不污染下一个会话 */
+export declare function markPoseDirty(): void;
+/** 退出提交门控读;clearPoseSession 时已随会话清零 */
+export declare function isPoseDirty(): boolean;
+/** PoseModeRig 卸载清理用:按键清会话——只清自己的。
+ *  A→B 直接切换时 enterPoseSession('B') 先同步落 session,A 的 rig 后卸载,
+ *  无条件的 clearPoseSession 会把 B 的新会话抹掉(切换坍塌) */
+export declare function clearPoseSessionIfCurrent(key: string): void;
+export declare function clearPoseSession(): void;
+/** 记录当前会话的帧信息;非当前会话 key 忽略(A→B 切换防护,同 clearPoseSessionIfCurrent) */
+export declare function setPoseSessionFrame(key: string, frame: PoseFrameMode): void;
+export declare function getPoseSessionFrame(): PoseFrameMode | null;
+/** React 订阅hook:会话的帧模式,无会话为 null(与 usePoseSessionKey 同构) */
+export declare function usePoseFrameMode(): PoseFrameMode | null;
+export type PoseManipulatorMode = 'move' | 'rotate';
+export declare function getPoseManipulatorMode(): PoseManipulatorMode;
+export declare function setPoseManipulatorMode(m: PoseManipulatorMode): void;
+/** PoseModeRig 订阅(转发 threeIK)与浮动小条订阅(高亮当前模式) */
+export declare function onPoseManipulatorModeChange(cb: (m: PoseManipulatorMode) => void): () => void;
+export type PoseModeSupport = {
+    move: boolean;
+    rotate: boolean;
+};
+/** PoseModeRig 轮询 threeIK 选中态后写入;值没变不发通知(轮询每帧跑) */
+export declare function setPoseSelectionModes(m: PoseModeSupport): void;
+export declare function getPoseSelectionModes(): PoseModeSupport;
+/** React 订阅hook:选中目标的模式支持集(订阅先回读,同 usePoseFrameMode) */
+export declare function usePoseSelectionModes(): PoseModeSupport;
+/** React 订阅hook:会话命中的 placementKey,无会话为 null */
+export declare function usePoseSessionKey(): string | null;
+/** 模型的 onDoubleClick 第一件事就是记录 timeStamp:落在模型上的双击不算空白 */
+export declare function noteModelDoubleClick(timeStamp: number): void;
+export declare function isModelDoubleClick(timeStamp: number): boolean;
+/** PoseModeRig 注册/注销命中测试(被摆模型 + 控制球) */
+export declare function setPoseHitTester(fn: ((ev: {
+    clientX: number;
+    clientY: number;
+}) => boolean) | null): void;
+export declare function poseHitTest(ev: {
+    clientX: number;
+    clientY: number;
+}): boolean;
+//# sourceMappingURL=poseSession.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"poseSession.d.ts","sourceRoot":"","sources":["../../src/poseMode/poseSession.ts"],"names":[],"mappings":"AASA,YAAY,EAAC,aAAa,EAAC,MAAM,aAAa,CAAA;AAC9C,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,aAAa,CAAA;AAE9C,MAAM,MAAM,WAAW,GAAG;IAAC,GAAG,EAAE,MAAM,CAAA;CAAC,CAAA;AAQvC,wBAAgB,cAAc,IAAI,WAAW,GAAG,IAAI,CAEnD;AAED,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,GAClC,MAAM,IAAI,CAKZ;AAED,sDAAsD;AACtD,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAKzE;AAMD;sDACsD;AACtD,wBAAgB,eAAe,IAAI,IAAI,CAStC;AAED,oCAAoC;AACpC,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAOlD;AAWD;qCACqC;AACrC,wBAAgB,aAAa,IAAI,IAAI,CAGpC;AAED,uCAAuC;AACvC,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED;;8CAE8C;AAC9C,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE3D;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAOvC;AAID,oEAAoE;AACpE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI,CAI3E;AAED,wBAAgB,mBAAmB,IAAI,aAAa,GAAG,IAAI,CAE1D;AAED,4DAA4D;AAC5D,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,IAAI,CAavD;AAID,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,QAAQ,CAAA;AAMnD,wBAAgB,sBAAsB,IAAI,mBAAmB,CAE5D;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAInE;AAED,gDAAgD;AAChD,wBAAgB,2BAA2B,CACzC,EAAE,EAAE,CAAC,CAAC,EAAE,mBAAmB,KAAK,IAAI,GACnC,MAAM,IAAI,CAKZ;AAID,MAAM,MAAM,eAAe,GAAG;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAC,CAAA;AAO9D,mDAAmD;AACnD,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,eAAe,GAAG,IAAI,CAK9D;AAED,wBAAgB,qBAAqB,IAAI,eAAe,CAEvD;AAED,wDAAwD;AACxD,wBAAgB,qBAAqB,IAAI,eAAe,CASvD;AAED,gDAAgD;AAChD,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,IAAI,CAIjD;AAMD,wDAAwD;AACxD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAE5D;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE7D;AAKD,wCAAwC;AACxC,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAC,KAAK,OAAO,CAAC,GAAG,IAAI,GAC/D,IAAI,CAEN;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAC,GAAG,OAAO,CAE3E"}

package/dist/poseMode/poseSession.js

@@ -0,0 +1,183 @@
+// packages/camera-studio/src/poseMode/poseSession.ts
+/**
+ * 姿势会话:哪个模型正在摆姿势(placementKey),全局唯一。
+ * App 管进入/退出的触发;PoseModeRig 订阅退出请求,负责提交骨骼写回。
+ * 双击空白退出的判定需要两处共享状态:模型双击的 timeStamp 去重、
+ * PoseModeRig 注册的命中测试(控制球/被摆模型不算空白)。
+ */
+import { useEffect, useState } from 'react';
+let session = null;
+// 会话的帧信息(帧模式判定结果):进会话时由 PoseModeRig 写入,随会话生灭
+let sessionFrame = null;
+const changeListeners = new Set();
+const exitListeners = new Set();
+export function getPoseSession() {
+    return session;
+}
+export function onPoseSessionChange(cb) {
+    changeListeners.add(cb);
+    return () => {
+        changeListeners.delete(cb);
+    };
+}
+/** PoseModeRig 订阅:外部请求退出时回调(提交 + clearPoseSession) */
+export function onPoseExitRequested(cb) {
+    exitListeners.add(cb);
+    return () => {
+        exitListeners.delete(cb);
+    };
+}
+function emitChange() {
+    for (const cb of changeListeners)
+        cb(session);
+}
+/** 请求退出当前会话;监听者没清会话时兜底清掉,防状态卡死。
+ *  try/finally:监听抛异常(如 capturePose 失败)也兜底清理,异常照常上抛 */
+export function requestPoseExit() {
+    if (!session)
+        return;
+    // 先快照 key:监听者可能在回调里清会话,循环里再读 session.key 会崩
+    const key = session.key;
+    try {
+        for (const cb of exitListeners)
+            cb(key);
+    }
+    finally {
+        if (session)
+            clearPoseSession();
+    }
+}
+/** 会话唯一:已在摆别的模型时,先按退出流程提交旧会话再开新的 */
+export function enterPoseSession(key) {
+    if (session?.key === key)
+        return;
+    if (session)
+        requestPoseExit();
+    session = { key };
+    sessionFrame = null; // 帧信息由新会话的 Rig 挂载后写入
+    selectionModes = BOTH_MODES; // 选中支持集同理(新会话从无限制造起)
+    emitChange();
+}
+// —— 退出提交的脏标记 ——
+/** 会话脏标记:用户在会话里按下过指针(可能拖了控制点)即为脏。
+ *  退出提交门控读它:空进空出不写 poseOverride、不产生幻影撤销步
+ *  (对齐 modalGrab 的 moved 语义)。
+ *  threeIK 的 isDragging 只能覆盖完整帧间隙的拖动;同帧间隙内按下-拖-松
+ *  (帧没跑、骨骼没动)也会被这里的按下事件记脏——多提交无害,漏提交才是 bug。 */
+let poseDirty = false;
+/** PoseModeRig 的 canvas pointerdown 监听调用:按下即记脏(见上)。
+ *  无会话不记:清会话后、监听卸载前的窗口期按下不污染下一个会话 */
+export function markPoseDirty() {
+    if (!session)
+        return;
+    poseDirty = true;
+}
+/** 退出提交门控读;clearPoseSession 时已随会话清零 */
+export function isPoseDirty() {
+    return poseDirty;
+}
+/** PoseModeRig 卸载清理用:按键清会话——只清自己的。
+ *  A→B 直接切换时 enterPoseSession('B') 先同步落 session,A 的 rig 后卸载,
+ *  无条件的 clearPoseSession 会把 B 的新会话抹掉(切换坍塌) */
+export function clearPoseSessionIfCurrent(key) {
+    if (session?.key === key)
+        clearPoseSession();
+}
+export function clearPoseSession() {
+    if (!session)
+        return;
+    session = null;
+    sessionFrame = null;
+    selectionModes = BOTH_MODES;
+    poseDirty = false;
+    emitChange();
+}
+// —— 会话帧信息(帧上=编辑该帧/帧间=新建帧,spec §8.1)——
+/** 记录当前会话的帧信息;非当前会话 key 忽略(A→B 切换防护,同 clearPoseSessionIfCurrent) */
+export function setPoseSessionFrame(key, frame) {
+    if (!session || session.key !== key)
+        return;
+    sessionFrame = frame;
+    emitChange();
+}
+export function getPoseSessionFrame() {
+    return session ? sessionFrame : null;
+}
+/** React 订阅hook:会话的帧模式,无会话为 null(与 usePoseSessionKey 同构) */
+export function usePoseFrameMode() {
+    const [frame, setFrame] = useState(getPoseSessionFrame());
+    useEffect(() => {
+        // 先回读再订阅:帧信息由 Rig 的挂载 effect 写入,订阅者(浮动小条)
+        // 与 Rig 同渲染批时,Rig 的通知先于本订阅注册——不回读就永远停在
+        // 初值 null(浮条帧文案缺失)。usePoseSessionKey 无此问题:会话本身
+        // 在触发渲染的事件里就已建立,useState 初值即正确。
+        setFrame(getPoseSessionFrame());
+        return onPoseSessionChange(() => setFrame(getPoseSessionFrame()));
+    }, []);
+    return frame;
+}
+/** 记住偏好:不随 clearPoseSession 清零,下次进入沿用上次的(Maya 习惯) */
+let manipulatorMode = 'move';
+const modeListeners = new Set();
+export function getPoseManipulatorMode() {
+    return manipulatorMode;
+}
+export function setPoseManipulatorMode(m) {
+    if (m === manipulatorMode)
+        return;
+    manipulatorMode = m;
+    for (const cb of modeListeners)
+        cb(m);
+}
+/** PoseModeRig 订阅(转发 threeIK)与浮动小条订阅(高亮当前模式) */
+export function onPoseManipulatorModeChange(cb) {
+    modeListeners.add(cb);
+    return () => {
+        modeListeners.delete(cb);
+    };
+}
+const BOTH_MODES = { move: true, rotate: true };
+/** 当前选中目标支持的模式;无选中/双通道=BOTH。随会话生灭(enter/clear 复位) */
+let selectionModes = BOTH_MODES;
+/** PoseModeRig 轮询 threeIK 选中态后写入;值没变不发通知(轮询每帧跑) */
+export function setPoseSelectionModes(m) {
+    if (m.move === selectionModes.move && m.rotate === selectionModes.rotate)
+        return;
+    selectionModes = m;
+    emitChange();
+}
+export function getPoseSelectionModes() {
+    return selectionModes;
+}
+/** React 订阅hook:选中目标的模式支持集(订阅先回读,同 usePoseFrameMode) */
+export function usePoseSelectionModes() {
+    const [modes, setModes] = useState(() => getPoseSelectionModes());
+    useEffect(() => {
+        setModes(getPoseSelectionModes());
+        return onPoseSessionChange(() => setModes(getPoseSelectionModes()));
+    }, []);
+    return modes;
+}
+/** React 订阅hook:会话命中的 placementKey,无会话为 null */
+export function usePoseSessionKey() {
+    const [key, setKey] = useState(getPoseSession()?.key ?? null);
+    useEffect(() => onPoseSessionChange((s) => setKey(s?.key ?? null)), []);
+    return key;
+}
+// —— 双击空白退出判定的共享状态 ——
+let lastModelDblClickAt = -1;
+/** 模型的 onDoubleClick 第一件事就是记录 timeStamp:落在模型上的双击不算空白 */
+export function noteModelDoubleClick(timeStamp) {
+    lastModelDblClickAt = timeStamp;
+}
+export function isModelDoubleClick(timeStamp) {
+    return timeStamp === lastModelDblClickAt;
+}
+let hitTester = null;
+/** PoseModeRig 注册/注销命中测试(被摆模型 + 控制球) */
+export function setPoseHitTester(fn) {
+    hitTester = fn;
+}
+export function poseHitTest(ev) {
+    return hitTester?.(ev) ?? false;
+}

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

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

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

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

package/dist/poseMode/poseSession.test.js

@@ -0,0 +1,159 @@
+// packages/camera-studio/src/poseMode/poseSession.test.ts
+import { enterPoseSession, getPoseSession, clearPoseSession, clearPoseSessionIfCurrent, requestPoseExit, onPoseSessionChange, onPoseExitRequested, noteModelDoubleClick, isModelDoubleClick, setPoseHitTester, poseHitTest, markPoseDirty, isPoseDirty, getPoseManipulatorMode, setPoseManipulatorMode, onPoseManipulatorModeChange, setPoseSessionFrame, getPoseSessionFrame, } from './poseSession';
+beforeEach(() => {
+    clearPoseSession();
+    setPoseHitTester(null);
+});
+test('进入会话后 getPoseSession 返回该模型;清空后回到 null', () => {
+    expect(getPoseSession()).toBeNull();
+    enterPoseSession('m1');
+    expect(getPoseSession()).toEqual({ key: 'm1' });
+    clearPoseSession();
+    expect(getPoseSession()).toBeNull();
+});
+test('会话唯一:已进入 A 再进入 B,先对 A 发退出请求再切到 B', () => {
+    const exited = [];
+    const off = onPoseExitRequested((key) => {
+        exited.push(key);
+        clearPoseSession(); // 仿 PoseModeRig:提交后清会话
+    });
+    enterPoseSession('A');
+    enterPoseSession('B');
+    expect(exited).toEqual(['A']);
+    expect(getPoseSession()).toEqual({ key: 'B' });
+    off();
+});
+test('重复进入同一会话是空操作,不发退出请求', () => {
+    const exited = [];
+    onPoseExitRequested((key) => exited.push(key));
+    enterPoseSession('A');
+    enterPoseSession('A');
+    expect(exited).toEqual([]);
+    expect(getPoseSession()).toEqual({ key: 'A' });
+});
+test('requestPoseExit 通知监听者;监听者没清会话时兜底清掉', () => {
+    const exited = [];
+    enterPoseSession('A');
+    const off = onPoseExitRequested((key) => exited.push(key));
+    requestPoseExit();
+    expect(exited).toEqual(['A']);
+    expect(getPoseSession()).toBeNull(); // 监听者没调 clear,模块兜底
+    off();
+});
+test('无会话时 requestPoseExit 空操作', () => {
+    const exited = [];
+    onPoseExitRequested((key) => exited.push(key));
+    requestPoseExit();
+    expect(exited).toEqual([]);
+});
+test('onPoseSessionChange 订阅进出', () => {
+    const seen = [];
+    onPoseSessionChange((s) => seen.push(s));
+    enterPoseSession('A');
+    clearPoseSession();
+    expect(seen).toEqual([{ key: 'A' }, null]);
+});
+test('双击判定:记录模型的双击 timeStamp 后判定命中', () => {
+    expect(isModelDoubleClick(111)).toBe(false);
+    noteModelDoubleClick(111);
+    expect(isModelDoubleClick(111)).toBe(true);
+    expect(isModelDoubleClick(222)).toBe(false);
+});
+test('命中测试:注册后代理调用,null 时恒 false', () => {
+    expect(poseHitTest({ clientX: 1, clientY: 2 })).toBe(false);
+    setPoseHitTester(() => true);
+    expect(poseHitTest({ clientX: 1, clientY: 2 })).toBe(true);
+    setPoseHitTester(null);
+    expect(poseHitTest({ clientX: 1, clientY: 2 })).toBe(false);
+});
+test('markPoseDirty 与 isDragging 轮询双通道或语义:任一通道记脏即提交', () => {
+    // 同帧间隙拖动(帧没跑,isDragging 轮询漏检)由按下事件兜底记脏
+    enterPoseSession('k');
+    expect(isPoseDirty()).toBe(false);
+    markPoseDirty(); // pointerdown 监听在帧外调用
+    expect(isPoseDirty()).toBe(true);
+    // 门控读后照常清理
+    clearPoseSession();
+    expect(isPoseDirty()).toBe(false);
+});
+test('脏标记随 clearPoseSession 清零(requestPoseExit 兜底清理同样生效)', () => {
+    enterPoseSession('k');
+    markPoseDirty();
+    expect(isPoseDirty()).toBe(true);
+    requestPoseExit(); // 无监听者,模块兜底 clearPoseSession
+    expect(getPoseSession()).toBeNull();
+    expect(isPoseDirty()).toBe(false);
+});
+test('clearPoseSessionIfCurrent:A→B 切换时 A 的卸载清理不能把 B 的新会话抹掉', () => {
+    // 镜像组件生命周期:enter(A) → enter(B)(A 的 rig 随后卸载,清理按键清)
+    enterPoseSession('A');
+    enterPoseSession('B');
+    clearPoseSessionIfCurrent('A'); // A 的 PoseModeRig 卸载清理
+    expect(getPoseSession()).toEqual({ key: 'B' }); // B 的会话必须存活
+    clearPoseSessionIfCurrent('B'); // B 自己卸载时才清得掉
+    expect(getPoseSession()).toBeNull();
+});
+test('clearPoseSessionIfCurrent:无会话时安全空操作', () => {
+    clearPoseSessionIfCurrent('A'); // 不抛即可
+    expect(getPoseSession()).toBeNull();
+});
+test('无会话时 markPoseDirty 不记脏(清理窗口期的按下不污染下一个会话)', () => {
+    markPoseDirty(); // 会话已清、监听未卸的窗口期按下
+    expect(isPoseDirty()).toBe(false);
+    enterPoseSession('k'); // 下一个会话进来是干净的
+    expect(isPoseDirty()).toBe(false);
+    markPoseDirty(); // 会话中的按下才记脏
+    expect(isPoseDirty()).toBe(true);
+});
+test('requestPoseExit:监听抛异常也兜底清会话(异常照常上抛)', () => {
+    enterPoseSession('k');
+    const off = onPoseExitRequested(() => {
+        throw new Error('listener boom');
+    });
+    expect(() => requestPoseExit()).toThrow('listener boom');
+    expect(getPoseSession()).toBeNull(); // 不卡死
+    off();
+});
+// —— 操纵器模式(浮动小条与 W/E 键共用)——
+test('操纵器模式默认 move', () => {
+    expect(getPoseManipulatorMode()).toBe('move');
+});
+test('setPoseManipulatorMode 切换并通知订阅;重复设同值不重复通知', () => {
+    const seen = [];
+    const off = onPoseManipulatorModeChange((m) => seen.push(m));
+    setPoseManipulatorMode('rotate');
+    expect(getPoseManipulatorMode()).toBe('rotate');
+    setPoseManipulatorMode('rotate'); // 同值去重
+    setPoseManipulatorMode('move');
+    expect(seen).toEqual(['rotate', 'move']);
+    off();
+});
+test('操纵器模式记住偏好:清会话/退出都不重置', () => {
+    setPoseManipulatorMode('rotate');
+    enterPoseSession('k');
+    clearPoseSession();
+    expect(getPoseManipulatorMode()).toBe('rotate'); // 下次进入沿用上次的
+    setPoseManipulatorMode('move'); // 复原,免得影响后面的用例
+});
+test('onPoseManipulatorModeChange 退订后不再收到', () => {
+    const seen = [];
+    const off = onPoseManipulatorModeChange((m) => seen.push(m));
+    off();
+    setPoseManipulatorMode('rotate');
+    expect(seen).toEqual([]);
+    setPoseManipulatorMode('move');
+});
+// —— 会话帧信息(帧模式:帧上=编辑/帧间=新建,随会话生灭)——
+test('会话帧信息随会话生灭:set/get/clear', () => {
+    enterPoseSession('k1');
+    setPoseSessionFrame('k1', { mode: 'edit', position: 2 });
+    expect(getPoseSessionFrame()).toEqual({ mode: 'edit', position: 2 });
+    clearPoseSession();
+    expect(getPoseSessionFrame()).toBe(null);
+});
+test('非当前会话 key 写入帧信息被忽略(A→B 切换防护)', () => {
+    enterPoseSession('kB');
+    setPoseSessionFrame('kA', { mode: 'edit', position: 2 });
+    expect(getPoseSessionFrame()).toBe(null);
+    clearPoseSession();
+});

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

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

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

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

package/dist/poseMode/poseSessionHooks.test.js

@@ -0,0 +1,49 @@
+/*
+ * @jest-environment jsdom
+ */
+/**
+ * usePoseFrameMode 同渲染批竞态回归:
+ * PoseModeBar 与 PoseModeRig 在同一渲染批挂载(PlacementManager L1414 条件内),
+ * Rig 的挂载 effect 先跑——setPoseSessionFrame + emitChange 时 Bar 的订阅
+ * effect 还没注册,通知被错过。hook 必须在订阅时回读当前值,
+ * 而不是停在 useState 初值 null(浮条帧模式文案缺失)。
+ */
+import React from 'react';
+import { act } from 'react';
+import ReactDOM from 'react-dom/client';
+import { enterPoseSession, setPoseSessionFrame, clearPoseSession, usePoseFrameMode, } from './poseSession';
+/** 模拟 PoseModeRig:挂载 effect 里写帧信息(先挂载,effect 先跑) */
+function Writer({ frame }) {
+    React.useEffect(() => {
+        setPoseSessionFrame('M', frame);
+    }, [frame]);
+    return null;
+}
+/** 模拟 PoseModeBar:订阅帧模式(后挂载) */
+function Reader({ observed }) {
+    const frame = usePoseFrameMode();
+    observed.push(frame);
+    return null;
+}
+test('同渲染批内写入先于订阅:hook 收敛到帧信息而非停在 null', () => {
+    const frame = { mode: 'new', position: 2 };
+    // 对齐真实时序:双击事件先进会话,随后才渲染 Rig/Bar
+    enterPoseSession('M');
+    const observed = [];
+    const el = document.createElement('div');
+    document.body.appendChild(el);
+    const root = ReactDOM.createRoot(el);
+    try {
+        act(() => {
+            root.render(React.createElement(React.Fragment, null,
+                React.createElement(Writer, { frame: frame }),
+                React.createElement(Reader, { observed: observed })));
+        });
+        expect(observed[observed.length - 1]).toEqual(frame);
+    }
+    finally {
+        act(() => root.unmount());
+        el.remove();
+        clearPoseSession();
+    }
+});

package/dist/poseMode/poseTrack.d.ts

@@ -0,0 +1,30 @@
+import type { ISheetObject } from '@dreamerbird/core';
+import type { $IntentionalAny } from '@dreamerbird/core/types/public';
+/** 仅测试:getPointerParts 依赖 dataverse 内部注册表,真指针无法伪造 */
+export declare function __setPointerRootResolverForTest(fn: (() => $IntentionalAny) | null): void;
+export declare function getTrackIdForProp(sheetObject: ISheetObject<$IntentionalAny>, propName: string): string | undefined;
+export declare function getPoseTrackId(sheetObject: ISheetObject<$IntentionalAny>): string | undefined;
+export declare function getPoseKeyframePositions(sheetObject: ISheetObject<$IntentionalAny>): number[];
+export declare function getPoseKeyframeCount(sheetObject: ISheetObject<$IntentionalAny>): number;
+/** 当前值 + 轨道全部帧值里的 lib 引用 id(prefetchLibPoses 的输入) */
+export declare function collectLibPoseIds(sheetObject: ISheetObject<$IntentionalAny>): string[];
+/** 多属性版(姿势 + 左手势/右手势):一并收集,预取一次全覆盖 */
+export declare function collectLibPoseIdsForProps(sheetObject: ISheetObject<$IntentionalAny>, propNames: string[]): string[];
+export declare function writePoseKeyframe(sheetObject: ISheetObject<$IntentionalAny>, json: string): void;
+export declare function setPoseValue(sheetObject: ISheetObject<$IntentionalAny>, json: string): void;
+/**
+ * 清除姿势值与轨道(CameraScene 清除按钮与 Agent poses.clear 共用):
+ * 单个事务 = 一个撤销步骤。经内部 Studio 的 stateEditors 直改 historic:
+ * setPrimitivePropAsStatic(有轨时把当前值落为静态)紧接着
+ * unsetValueOfPrimitiveProp(删掉落下来的静态)——两个编辑器都是幂等直写,
+ * 不经指针读轨道树,绕开「单事务里 unsequenceProp 后 unset(pointer) 读到
+ * 事务前轨道树、错走删播放头帧分支」的指针级限制(2026-10-01 冒烟记录),
+ * 无需拆两事务。行为由 agent/commands/poses.realStudio.test.ts 验证
+ * (删轨+清值一步撤销,undo 一并恢复)。
+ *
+ * 返回 'cleared' | 'empty' | 'unavailable':空姿势(无轨无静态)不开空事务,
+ * 调用方据此返回明确结果而非静默 no-op;Studio 不可用由调用方决定
+ * 报错(Agent SCENE_UNAVAILABLE)还是静默(UI)。
+ */
+export declare function clearPoseValue(sheetObject: ISheetObject<$IntentionalAny>): 'cleared' | 'empty' | 'unavailable';
+//# sourceMappingURL=poseTrack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"poseTrack.d.ts","sourceRoot":"","sources":["../../src/poseMode/poseTrack.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAA;AACnD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,gCAAgC,CAAA;AAiBnE,qDAAqD;AACrD,wBAAgB,+BAA+B,CAC7C,EAAE,EAAE,CAAC,MAAM,eAAe,CAAC,GAAG,IAAI,GACjC,IAAI,CAEN;AAWD,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,YAAY,CAAC,eAAe,CAAC,EAC1C,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,SAAS,CAMpB;AAED,wBAAgB,cAAc,CAC5B,WAAW,EAAE,YAAY,CAAC,eAAe,CAAC,GACzC,MAAM,GAAG,SAAS,CAEpB;AA4BD,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,YAAY,CAAC,eAAe,CAAC,GACzC,MAAM,EAAE,CAIV;AAED,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,YAAY,CAAC,eAAe,CAAC,GACzC,MAAM,CAER;AAED,qDAAqD;AACrD,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,YAAY,CAAC,eAAe,CAAC,GACzC,MAAM,EAAE,CAEV;AAED,sCAAsC;AACtC,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,YAAY,CAAC,eAAe,CAAC,EAC1C,SAAS,EAAE,MAAM,EAAE,GAClB,MAAM,EAAE,CAgBV;AAED,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,YAAY,CAAC,eAAe,CAAC,EAC1C,IAAI,EAAE,MAAM,GACX,IAAI,CAaN;AAED,wBAAgB,YAAY,CAC1B,WAAW,EAAE,YAAY,CAAC,eAAe,CAAC,EAC1C,IAAI,EAAE,MAAM,GACX,IAAI,CAQN;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,YAAY,CAAC,eAAe,CAAC,GACzC,SAAS,GAAG,OAAO,GAAG,aAAa,CAsBrC"}

package/dist/poseMode/poseTrack.js

@@ -0,0 +1,155 @@
+/**
+ * 姿势轨道的读取与写入通道(spec §7)。
+ *
+ * 读取:theatre 没有公共的轨道查询 API,经 props 指针根(内部 SheetObject)
+ * 的 template.getMapOfValidSequenceTracks_forStudio 取轨道映射——与
+ * createTransactionPrivateApi 内部读取同一数据源。getPointerParts 走
+ * dataverse 内部注册表,单测无法伪造真指针,根解析经
+ * __setPointerRootResolverForTest 注入(仅测试用)。
+ *
+ * 写入(spec §7.2/§7.3 两条通道):
+ *   writePoseKeyframe:摆姿势退出提交。有轨道 = scrub set(theatre 按当前
+ *   position 写贝塞尔帧,同 position 覆盖);无轨道 = transaction
+ *   sequenceProp 建轨 + scrub set 写首帧——两步事务为已知限制
+ *   (setPrimitivePropAsSequenced 的 trackId 随机生成,set 看不到同事务
+ *   草稿里的新轨道,spec §2.4)。面板打帧走属性行原生打帧钮,不经这里。
+ *   setPoseValue:右键菜单/弹框应用姿势。永不建轨:有轨道写帧、无轨道
+ *   写静态,theatre track-aware set 原生行为。
+ */
+import { getStudioSync } from '@dreamerbird/core';
+import { getPointerParts, val } from '@dreamerbird/dataverse';
+// clearPoseValue 需要 stateEditors 直改 historic(公共 transaction api
+// 不暴露),走内部 Studio 通道——与 agent/keyframeTracks、CameraScene
+// 诊断钩子同路径
+import getStudio from '@dreamerbird/studio/getStudio';
+import { parsePoseValue } from './poseValue';
+let pointerRootResolverForTest = null;
+/** 仅测试:getPointerParts 依赖 dataverse 内部注册表,真指针无法伪造 */
+export function __setPointerRootResolverForTest(fn) {
+    pointerRootResolverForTest = fn;
+}
+function internalRoot(sheetObject) {
+    if (pointerRootResolverForTest)
+        return pointerRootResolverForTest();
+    const { root } = getPointerParts(sheetObject.props.pose);
+    // props 指针的根恒为内部 SheetObject(sheet 对象属性的定义域)
+    return root;
+}
+export function getTrackIdForProp(sheetObject, propName) {
+    const tree = internalRoot(sheetObject)
+        .template.getMapOfValidSequenceTracks_forStudio()
+        .getValue();
+    const trackId = tree[propName];
+    return typeof trackId === 'string' ? trackId : undefined;
+}
+export function getPoseTrackId(sheetObject) {
+    return getTrackIdForProp(sheetObject, 'pose');
+}
+/** 轨道 BasicKeyframedTrack 的帧数据;无轨道回 undefined */
+function propTrackData(sheetObject, propName) {
+    const trackId = getTrackIdForProp(sheetObject, propName);
+    if (!trackId)
+        return undefined;
+    const root = internalRoot(sheetObject);
+    const { sheetId, objectKey } = sheetObject.address;
+    // 与 useEditingToolsForSimpleProp.tsx:181-187 同一读取路径
+    return val(root.template.project.pointers.historic.sheetsById[sheetId].sequence
+        .tracksByObject[objectKey].trackData[trackId]);
+}
+function poseTrackData(sheetObject) {
+    return propTrackData(sheetObject, 'pose');
+}
+export function getPoseKeyframePositions(sheetObject) {
+    const track = poseTrackData(sheetObject);
+    if (!track)
+        return [];
+    return Object.values(track.keyframes.byId).map((kf) => kf.position);
+}
+export function getPoseKeyframeCount(sheetObject) {
+    return getPoseKeyframePositions(sheetObject).length;
+}
+/** 当前值 + 轨道全部帧值里的 lib 引用 id(prefetchLibPoses 的输入) */
+export function collectLibPoseIds(sheetObject) {
+    return collectLibPoseIdsForProps(sheetObject, ['pose']);
+}
+/** 多属性版(姿势 + 左手势/右手势):一并收集,预取一次全覆盖 */
+export function collectLibPoseIdsForProps(sheetObject, propNames) {
+    const ids = new Set();
+    for (const propName of propNames) {
+        const current = parsePoseValue(val(sheetObject.props[propName]) ?? '');
+        if (current?.kind === 'lib')
+            ids.add(current.id);
+        const track = propTrackData(sheetObject, propName);
+        if (track) {
+            for (const kf of Object.values(track.keyframes.byId)) {
+                const v = parsePoseValue(typeof kf.value === 'string' ? kf.value : '');
+                if (v?.kind === 'lib')
+                    ids.add(v.id);
+            }
+        }
+    }
+    return [...ids];
+}
+export function writePoseKeyframe(sheetObject, json) {
+    const studio = getStudioSync();
+    if (!studio)
+        return;
+    if (!getPoseTrackId(sheetObject)) {
+        studio.transaction(({ sequenceProp }) => {
+            sequenceProp(sheetObject.props.pose);
+        });
+    }
+    const scrub = studio.scrub();
+    scrub.capture(({ set }) => {
+        set(sheetObject.props.pose, json);
+    });
+    scrub.commit();
+}
+export function setPoseValue(sheetObject, json) {
+    const studio = getStudioSync();
+    if (!studio)
+        return;
+    const scrub = studio.scrub();
+    scrub.capture(({ set }) => {
+        set(sheetObject.props.pose, json);
+    });
+    scrub.commit();
+}
+/**
+ * 清除姿势值与轨道(CameraScene 清除按钮与 Agent poses.clear 共用):
+ * 单个事务 = 一个撤销步骤。经内部 Studio 的 stateEditors 直改 historic:
+ * setPrimitivePropAsStatic(有轨时把当前值落为静态)紧接着
+ * unsetValueOfPrimitiveProp(删掉落下来的静态)——两个编辑器都是幂等直写,
+ * 不经指针读轨道树,绕开「单事务里 unsequenceProp 后 unset(pointer) 读到
+ * 事务前轨道树、错走删播放头帧分支」的指针级限制(2026-10-01 冒烟记录),
+ * 无需拆两事务。行为由 agent/commands/poses.realStudio.test.ts 验证
+ * (删轨+清值一步撤销,undo 一并恢复)。
+ *
+ * 返回 'cleared' | 'empty' | 'unavailable':空姿势(无轨无静态)不开空事务,
+ * 调用方据此返回明确结果而非静默 no-op;Studio 不可用由调用方决定
+ * 报错(Agent SCENE_UNAVAILABLE)还是静默(UI)。
+ */
+export function clearPoseValue(sheetObject) {
+    const studio = getStudio();
+    if (!studio)
+        return 'unavailable';
+    const hadTrack = Boolean(getPoseTrackId(sheetObject));
+    const current = val(sheetObject.props.pose) ?? '';
+    if (!hadTrack && current === '')
+        return 'empty';
+    studio.transaction(({ stateEditors }) => {
+        const editors = stateEditors.coreByProject.historic.sheetsById;
+        const address = {
+            projectId: sheetObject.address.projectId,
+            sheetId: sheetObject.address.sheetId,
+            objectKey: sheetObject.address.objectKey,
+            pathToProp: ['pose'],
+        };
+        if (hadTrack) {
+            // 先把当前求值落为静态(编辑器语义),随即删掉——净效果=回默认绑定
+            editors.sequence.setPrimitivePropAsStatic({ ...address, value: current });
+        }
+        editors.staticOverrides.byObject.unsetValueOfPrimitiveProp(address);
+    });
+    return 'cleared';
+}

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

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

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

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