@dreamerbird/camera-studio 0.0.0-stage → 0.1.0

package/dist/pathPresets.test.js

@@ -0,0 +1,154 @@
+import { PATH_PRESETS, findFreeSpot, presetPlacement, presetPoints, } from './pathPresets';
+const byId = (id) => {
+    const p = PATH_PRESETS.find((p) => p.id === id);
+    if (!p)
+        throw new Error(`missing preset ${id}`);
+    return p;
+};
+describe('presetPoints', () => {
+    const center = { x: 10, y: 4, z: -2 };
+    it('环绕圆:半径 5 的 8 点,全部与中心共面(y 相等)', () => {
+        const pts = presetPoints(byId('circle'), center);
+        expect(pts).toHaveLength(8);
+        for (const p of pts) {
+            expect(p.y).toBe(4);
+            expect(Math.hypot(p.x - 10, p.z + 2)).toBeCloseTo(5, 6);
+        }
+    });
+    it('直线往返:2 点,长 10,中点是落点', () => {
+        const pts = presetPoints(byId('line'), center);
+        expect(pts).toHaveLength(2);
+        expect(pts[0]).toEqual({ x: 5, y: 4, z: -2 });
+        expect(pts[1]).toEqual({ x: 15, y: 4, z: -2 });
+    });
+    it('弧线:半径 6 的 180° 弧,5 点共面', () => {
+        const pts = presetPoints(byId('arc'), center);
+        expect(pts).toHaveLength(5);
+        for (const p of pts) {
+            expect(p.y).toBe(4);
+            expect(Math.hypot(p.x - 10, p.z + 2)).toBeCloseTo(6, 6);
+        }
+        // 首尾张角 180°
+        expect(pts[0].x).toBeCloseTo(16, 6);
+        expect(pts[4].x).toBeCloseTo(4, 6);
+    });
+    it('8 字:12 点,两圆在落点相切', () => {
+        const pts = presetPoints(byId('figure8'), center);
+        expect(pts).toHaveLength(12);
+        for (const p of pts)
+            expect(p.y).toBe(4);
+        // 左圆右缘与右圆左缘都过落点
+        expect(pts[0].x).toBeCloseTo(10, 6);
+        expect(pts[0].z).toBeCloseTo(-2, 6);
+        expect(pts[6].x).toBeCloseTo(10, 6);
+        expect(pts[6].z).toBeCloseTo(-2, 6);
+    });
+    it('推近:两点直线,终点比起点离主体更近 8', () => {
+        const pts = presetPoints(byId('dollyIn'), center);
+        expect(pts).toHaveLength(2);
+        const dist = (p) => Math.hypot(p.x - 10, p.z + 2);
+        expect(dist(pts[0])).toBeCloseTo(10, 6);
+        expect(dist(pts[1])).toBeCloseTo(2, 6);
+    });
+    it('拉远拉升:高度与距离都单调递增', () => {
+        const pts = presetPoints(byId('reveal'), center);
+        expect(pts).toHaveLength(3);
+        for (let i = 1; i < pts.length; i++) {
+            expect(pts[i].y).toBeGreaterThan(pts[i - 1].y);
+            expect(Math.abs(pts[i].z + 2)).toBeGreaterThan(Math.abs(pts[i - 1].z + 2));
+        }
+    });
+    it('螺旋上升:16 点,半径恒定 5,高度从落点单调爬到 +5', () => {
+        const pts = presetPoints(byId('spiralUp'), center);
+        expect(pts).toHaveLength(16);
+        expect(pts[0].y).toBe(4);
+        expect(pts[15].y).toBeCloseTo(9, 6);
+        for (let i = 0; i < pts.length; i++) {
+            expect(Math.hypot(pts[i].x - 10, pts[i].z + 2)).toBeCloseTo(5, 6);
+            if (i > 0)
+                expect(pts[i].y).toBeGreaterThan(pts[i - 1].y);
+        }
+    });
+    it('升降摇臂:高度单调递增,水平位置基本不动(轻微前推)', () => {
+        const pts = presetPoints(byId('crane'), center);
+        expect(pts).toHaveLength(3);
+        expect(pts[0].y).toBeCloseTo(4.5, 6);
+        expect(pts[2].y).toBeCloseTo(10, 6);
+        // 前推幅度远小于爬升幅度
+        expect(Math.abs(pts[0].z - pts[2].z)).toBeLessThan(2);
+        expect(pts[2].y - pts[0].y).toBeGreaterThan(4);
+    });
+    it('环绕推近:12 点共面,半径从 7 单调收缩到 2.5', () => {
+        const pts = presetPoints(byId('orbitPush'), center);
+        expect(pts).toHaveLength(12);
+        const r = (p) => Math.hypot(p.x - 10, p.z + 2);
+        expect(r(pts[0])).toBeCloseTo(7, 6);
+        expect(r(pts[11])).toBeCloseTo(2.5, 6);
+        for (let i = 1; i < pts.length; i++) {
+            expect(r(pts[i])).toBeLessThan(r(pts[i - 1]));
+            expect(pts[i].y).toBe(4);
+        }
+    });
+    it('俯冲:高度单调递减,越来越靠近主体', () => {
+        const pts = presetPoints(byId('dive'), center);
+        expect(pts).toHaveLength(4);
+        for (let i = 1; i < pts.length; i++) {
+            expect(pts[i].y).toBeLessThan(pts[i - 1].y);
+            expect(Math.abs(pts[i].z + 2)).toBeLessThan(Math.abs(pts[i - 1].z + 2));
+        }
+        // 最低点不穿地
+        expect(pts[3].y).toBeGreaterThan(4);
+    });
+    it('立体 8 字:12 点,水平投影仍是相切双圆,高度有起伏', () => {
+        const pts = presetPoints(byId('figure8v'), center);
+        expect(pts).toHaveLength(12);
+        // 水平结构同平面 8 字
+        expect(pts[0].x).toBeCloseTo(10, 6);
+        expect(pts[0].z).toBeCloseTo(-2, 6);
+        expect(pts[6].x).toBeCloseTo(10, 6);
+        // 高度有正有负地围绕落点起伏
+        const ys = pts.map((p) => p.y - 4);
+        expect(Math.max(...ys)).toBeGreaterThan(0.5);
+        expect(Math.min(...ys)).toBeLessThan(-0.5);
+    });
+});
+describe('presetPlacement', () => {
+    const center = { x: 10, y: 4, z: -2 };
+    it('落点进路径位置变换,控制点围绕局部原点生成', () => {
+        for (const preset of PATH_PRESETS) {
+            const { points, position } = presetPlacement(preset, center);
+            expect(position).toEqual(center);
+            expect(points).toEqual(presetPoints(preset, { x: 0, y: 0, z: 0 }));
+        }
+    });
+    it('局部点 + 位置 = 直接以落点为中心的世界点(全部预设)', () => {
+        for (const preset of PATH_PRESETS) {
+            const { points, position } = presetPlacement(preset, center);
+            const world = presetPoints(preset, center);
+            expect(points).toHaveLength(world.length);
+            points.forEach((p, i) => {
+                expect(p.x + position.x).toBeCloseTo(world[i].x, 6);
+                expect(p.y + position.y).toBeCloseTo(world[i].y, 6);
+                expect(p.z + position.z).toBeCloseTo(world[i].z, 6);
+            });
+        }
+    });
+});
+describe('findFreeSpot', () => {
+    it('空场景落原点', () => {
+        expect(findFreeSpot([])).toEqual({ x: 0, y: 0, z: 0 });
+    });
+    it('原点被占沿 +X 每次错开 2,直到空位', () => {
+        expect(findFreeSpot([{ x: 0.5, y: 0, z: 0.5 }])).toEqual({ x: 2, y: 0, z: 0 });
+        expect(findFreeSpot([
+            { x: 0, y: 0, z: 0 },
+            { x: 2, y: 0, z: 0 },
+        ])).toEqual({ x: 4, y: 0, z: 0 });
+    });
+    it('远处占用不影响原点', () => {
+        expect(findFreeSpot([{ x: 10, y: 0, z: 10 }])).toEqual({ x: 0, y: 0, z: 0 });
+    });
+    it('自定义 base 生效', () => {
+        expect(findFreeSpot([], { x: 3, y: 0, z: 3 })).toEqual({ x: 3, y: 0, z: 3 });
+    });
+});

package/dist/pathRegistry.d.ts

@@ -0,0 +1,46 @@
+import type { ISheet, ISheetObject } from '@dreamerbird/core';
+/** 注册表对象的 theatre key(大纲顶层 "Paths" 行,和 Cameras 同款) */
+export declare const PATHS_REGISTRY_KEY = "Paths";
+/** 一条路径 = 一个 theatre 对象;清单里只存 key */
+export type PathEntry = {
+    pathKey: string;
+};
+export declare function getPathsRegistry(sheet: ISheet): ISheetObject<{
+    list: import("@dreamerbird/core").PropTypeConfig_String;
+}>;
+/** 解析清单 JSON;坏数据一律回退空(注册表是底账,勿手改) */
+export declare function parsePathEntries(json: string): PathEntry[];
+export declare function readPathEntries(registry: ISheetObject<any>): PathEntry[];
+/** 多条路径(P2)的命名:第一条 Pos Path,之后 Pos Path 2 / 3… */
+export declare function nextPathEntry(existing: readonly PathEntry[]): PathEntry;
+/** 响应式读路径清单:scrub 提交/撤销/同步都会触发 onValuesChange */
+export declare function usePathsList(sheet: ISheet): PathEntry[];
+/** 添加路径:注册表加一行(App 按清单渲染,组件挂载即创建对象) */
+export declare function addPathToRegistry(sheet: ISheet, entry: PathEntry): void;
+/**
+ * 删除路径:单个事务完成 forgetObject(按地址清持久数据:静态覆盖 +
+ * 时间轴轨道,不要求对象已挂载)+ 绑定相机回退 + 注册表移除 =
+ * 一步撤销(2026-10-19,Task 14 合并;schema 编辑器对无持久数据的
+ * 对象先查后删,幂等不抛)。detachObject 显式脱离(路径对象不是
+ * editable,卸载不会自动脱离)是非 historic 清理,放在事务之后;
+ * 对象未挂载(不在对象表)时不脱离(避免空 detach 告警)。
+ *
+ * boundCameras:删除前由调用方收集的"绑定了这条路径的相机"(App 有
+ * 相机对象 refs)。它们的回退(定格机位 + 回手动 + 清绑定)折进同一个
+ * 事务——撤销删除会把清单行、绑定、机位一起还原,全程不留"绑定还在
+ * 但路径没了"的中间态。若不折进来,ShotCamera 的失效看护会在本地删除
+ * 后再补一笔回退:撤销删除时绑定先被还原成失效态,看护立刻再打回手动,
+ * 新事务把撤销游标归零并截断重做历史,撤销永远原地打转(实测确认的
+ * 撤销陷阱)
+ */
+/** 删除路径时一并回退的绑定相机;freeze 为 null 表示路径没点、没被驱动过,机位不动 */
+export type BoundCameraReset = {
+    obj: ISheetObject<any>;
+    freeze: {
+        x: number;
+        y: number;
+        z: number;
+    } | null;
+};
+export declare function removePathFromRegistry(sheet: ISheet, entry: PathEntry, boundCameras?: BoundCameraReset[]): void;
+//# sourceMappingURL=pathRegistry.d.ts.map

package/dist/pathRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathRegistry.d.ts","sourceRoot":"","sources":["../src/pathRegistry.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAC,MAAM,EAAE,YAAY,EAAC,MAAM,mBAAmB,CAAA;AAQ3D,sDAAsD;AACtD,eAAO,MAAM,kBAAkB,UAAU,CAAA;AAEzC,qCAAqC;AACrC,MAAM,MAAM,SAAS,GAAG;IAAC,OAAO,EAAE,MAAM,CAAA;CAAC,CAAA;AAKzC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM;;GAO7C;AAED,qCAAqC;AACrC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CAc1D;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,SAAS,EAAE,CAExE;AAED,kDAAkD;AAClD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,CAOvE;AAED,iDAAiD;AACjD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,CAQvD;AAED,uCAAuC;AACvC,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,QAYhE;AAED;;;;;;;;;;;;;;;GAeG;AAEH,qDAAqD;AACrD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,CAAA;IACtB,MAAM,EAAE;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,IAAI,CAAA;CACjD,CAAA;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,EAChB,YAAY,GAAE,gBAAgB,EAAO,QAwBtC"}

package/dist/pathRegistry.js

@@ -0,0 +1,105 @@
+// packages/camera-studio/src/pathRegistry.ts
+/**
+ * 路径注册表:场景里有几条路径 = 注册表清单里有几行,每条路径是一个
+ * theatre 对象(变换 + 控制点 + 行进进度)。照搬相机注册表模式;
+ * P1 上限一条(工具条置灰),结构天然支持多条。
+ *
+ * 生命周期:添加 = 注册表加一行(App 按清单渲染 CameraPath,组件挂载
+ * 即创建对象、大纲行出现);删除 = forgetObject 清持久数据 + detachObject
+ * 显式脱离(路径对象不是 editable,卸载不会自动脱离)+ 注册表移除。
+ * 合并为单个事务 = 一步撤销,撤销一步完整回滚(2026-10-19,Task 14)。
+ *
+ * "没点就不出现":新路径落地即播第一个点;删掉最后一个点 = 删除整条
+ * 路径(走 removePathFromRegistry);启动自检清掉"对象在但清单没有"的
+ * 孤儿(老场景残留的空路径对象)。
+ */
+import { getStudioSync, types as t, val } from '@dreamerbird/core';
+// 内部 Studio 通道:合并事务需要 stateEditors.forgetObject(按地址清持久
+// 数据,不要求对象已挂载)——与 keyframeTracks/poseTrack 同先例
+import getStudio from '@dreamerbird/studio/getStudio';
+import { useEffect, useMemo, useState } from 'react';
+import { pathExists } from './CameraPath';
+/** 注册表对象的 theatre key(大纲顶层 "Paths" 行,和 Cameras 同款) */
+export const PATHS_REGISTRY_KEY = 'Paths';
+/** 第一条沿用既有 key:老场景的路径数据就是这个名字 */
+const FIRST_PATH = { pathKey: 'Pos Path' };
+export function getPathsRegistry(sheet) {
+    // 注册表只是存数据的对象,不出现在大纲树
+    return sheet.object(PATHS_REGISTRY_KEY, { list: t.string('[]') }, { hideFromOutline: true });
+}
+/** 解析清单 JSON;坏数据一律回退空(注册表是底账,勿手改) */
+export function parsePathEntries(json) {
+    try {
+        const list = JSON.parse(json);
+        if (!Array.isArray(list))
+            return [];
+        return list.filter((item) => typeof item === 'object' &&
+            item !== null &&
+            typeof item.pathKey === 'string' &&
+            item.pathKey.length > 0);
+    }
+    catch {
+        return [];
+    }
+}
+export function readPathEntries(registry) {
+    return parsePathEntries(val(registry.props.list));
+}
+/** 多条路径(P2)的命名:第一条 Pos Path,之后 Pos Path 2 / 3… */
+export function nextPathEntry(existing) {
+    if (existing.length === 0)
+        return FIRST_PATH;
+    const used = new Set(existing.map((e) => e.pathKey));
+    for (let n = 2;; n++) {
+        const pathKey = `Pos Path ${n}`;
+        if (!used.has(pathKey))
+            return { pathKey };
+    }
+}
+/** 响应式读路径清单:scrub 提交/撤销/同步都会触发 onValuesChange */
+export function usePathsList(sheet) {
+    const registry = useMemo(() => getPathsRegistry(sheet), [sheet]);
+    const [list, setList] = useState(() => readPathEntries(registry));
+    useEffect(() => {
+        setList(readPathEntries(registry));
+        return registry.onValuesChange(() => setList(readPathEntries(registry)));
+    }, [registry]);
+    return list;
+}
+/** 添加路径:注册表加一行(App 按清单渲染,组件挂载即创建对象) */
+export function addPathToRegistry(sheet, entry) {
+    const studio = getStudioSync();
+    if (!studio)
+        return;
+    const registry = getPathsRegistry(sheet);
+    const list = readPathEntries(registry);
+    // 连击/重入防护:同一 pathKey 已存在就不重复提交
+    if (list.some((e) => e.pathKey === entry.pathKey))
+        return;
+    const scrub = studio.scrub();
+    scrub.capture(({ set }) => set(registry.props.list, JSON.stringify([...list, entry])));
+    scrub.commit();
+}
+export function removePathFromRegistry(sheet, entry, boundCameras = []) {
+    const studio = getStudio();
+    if (!studio)
+        return;
+    const registry = getPathsRegistry(sheet);
+    const list = readPathEntries(registry);
+    studio.transaction(({ set, stateEditors }) => {
+        stateEditors.coreByProject.historic.sheetsById.forgetObject({
+            projectId: sheet.address.projectId,
+            sheetId: sheet.address.sheetId,
+            // 业务 key 跨适配层按不透明字符串传递,此处回到 core 的名义类型
+            objectKey: entry.pathKey,
+        });
+        for (const { obj, freeze } of boundCameras) {
+            if (freeze)
+                set(obj.props.position, { x: freeze.x, y: freeze.y, z: freeze.z });
+            set(obj.props.pathKey, '');
+        }
+        set(registry.props.list, JSON.stringify(list.filter((e) => e.pathKey !== entry.pathKey)));
+    });
+    if (pathExists(sheet, entry.pathKey))
+        sheet.detachObject(entry.pathKey);
+}

package/dist/pathRegistry.test.d.ts

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

package/dist/pathRegistry.test.d.ts.map

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

package/dist/pathRegistry.test.js

@@ -0,0 +1,23 @@
+// packages/camera-studio/src/pathRegistry.test.ts
+import { nextPathEntry, parsePathEntries } from './pathRegistry';
+describe('parsePathEntries', () => {
+    test('解析合法清单;坏 JSON/非数组回退空', () => {
+        expect(parsePathEntries('[]')).toEqual([]);
+        const one = [{ pathKey: 'Pos Path' }];
+        expect(parsePathEntries(JSON.stringify(one))).toEqual(one);
+        expect(parsePathEntries('not json')).toEqual([]);
+        expect(parsePathEntries('{"a":1}')).toEqual([]);
+    });
+    test('过滤畸形项', () => {
+        expect(parsePathEntries('[{"pathKey":"A"},{"foo":"bar"},{"pathKey":1}]')).toEqual([{ pathKey: 'A' }]);
+    });
+});
+describe('nextPathEntry', () => {
+    test('空清单给第一条(兼容既有状态的 key)', () => {
+        expect(nextPathEntry([])).toEqual({ pathKey: 'Pos Path' });
+    });
+    test('占用后递增编号,跳过已用的', () => {
+        const existing = [{ pathKey: 'Pos Path' }, { pathKey: 'Pos Path 3' }];
+        expect(nextPathEntry(existing)).toEqual({ pathKey: 'Pos Path 2' });
+    });
+});

package/dist/pickerRegistry.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 选择框体注册表(2026-10-01):宿主应用把自己的选择框体组件注册进来,
+ * 替换库内置框体。目前两个槽位:
+ * - 'pose':属性面板姿势行点值弹出的姿势选择框(内置 = PosePickerFrame)
+ * - 'model':顶栏「添加模型」弹出的模型选择框(内置 = AssetLibraryPanel)
+ *
+ * 库负责打开/关闭时机与数据组装,宿主组件经 props 拿数据、调回调完成
+ * 选择;不注册 = 内置框体,零回归。与 App 的 onOpenModelPicker 接管回调
+ * 共存:回调 = 完全不弹内置框(宿主全自控);注册 = 框体照弹、内芯换宿主。
+ *
+ * 注册时机:宿主应用启动时(App 挂载前后均可)调一次注册即可——每次打开
+ * 框体都现读注册表,无需订阅;卸载/热更对称调 unregister。
+ */
+import type React from 'react';
+import type { PoseCurrentKey, PoseOption, PoseOptionKey } from './poseMode/poseOptions';
+import type { ModelEntry } from './assetLibrary/types';
+/** 姿势选择框体 props:选项已组装(T 姿势卡/骨架族过滤/缺失卡),宿主只画 UI */
+export type PosePickerProps = {
+    options: PoseOption[];
+    current: PoseCurrentKey;
+    /** 选中一项:写值(打帧/撤销语义与内置一致)并关框,由库内完成 */
+    onPick: (key: PoseOptionKey) => void;
+    onClose: () => void;
+};
+/** 模型选择框体 props:清单/缩略图/放置/导入全由库喂,宿主只画 UI */
+export type ModelPickerProps = {
+    entries: ModelEntry[];
+    /** 缩略图 blob URL(懒加载;无缩略图或加载中返回 undefined) */
+    getThumbUrl: (entry: ModelEntry) => string | undefined;
+    /** 点选放置:进画布放置模式(幽灵跟随,点画布落定) */
+    onPlace: (entry: ModelEntry) => void;
+    /** 拖拽放置起点:宿主卡片按下并越过拖拽阈值时调,进放置幽灵 */
+    onDragStart: (entry: ModelEntry) => void;
+    /** 上传外部模型文件入库,返回正式条目 */
+    onImport: (file: File) => Promise<ModelEntry>;
+    onClose: () => void;
+};
+type PickerComponentMap = {
+    pose: React.FC<PosePickerProps>;
+    model: React.FC<ModelPickerProps>;
+};
+export declare function registerPosePicker(component: React.FC<PosePickerProps>): void;
+export declare function unregisterPosePicker(): void;
+export declare function registerModelPicker(component: React.FC<ModelPickerProps>): void;
+export declare function unregisterModelPicker(): void;
+/** 读当前注册的框体组件;未注册返回 undefined(调用方回退内置框体) */
+export declare function getRegisteredPicker<K extends keyof PickerComponentMap>(kind: K): PickerComponentMap[K] | undefined;
+export {};
+//# sourceMappingURL=pickerRegistry.d.ts.map

package/dist/pickerRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickerRegistry.d.ts","sourceRoot":"","sources":["../src/pickerRegistry.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,aAAa,EACd,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAA;AAEpD,kDAAkD;AAClD,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,OAAO,EAAE,cAAc,CAAA;IACvB,qCAAqC;IACrC,MAAM,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,CAAA;IACpC,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB,CAAA;AAED,4CAA4C;AAC5C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,UAAU,EAAE,CAAA;IACrB,6CAA6C;IAC7C,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,MAAM,GAAG,SAAS,CAAA;IACtD,+BAA+B;IAC/B,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;IACpC,mCAAmC;IACnC,WAAW,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAA;IACxC,wBAAwB;IACxB,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;IAC7C,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB,CAAA;AAED,KAAK,kBAAkB,GAAG;IACxB,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAAC,CAAA;IAC/B,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAA;CAClC,CAAA;AAID,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAAC,GAAG,IAAI,CAE7E;AACD,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AACD,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAAC,GACpC,IAAI,CAEN;AACD,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C;AAED,4CAA4C;AAC5C,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,kBAAkB,EACpE,IAAI,EAAE,CAAC,GACN,kBAAkB,CAAC,CAAC,CAAC,GAAG,SAAS,CAEnC"}

package/dist/pickerRegistry.js

@@ -0,0 +1,17 @@
+const registry = new Map();
+export function registerPosePicker(component) {
+    registry.set('pose', component);
+}
+export function unregisterPosePicker() {
+    registry.delete('pose');
+}
+export function registerModelPicker(component) {
+    registry.set('model', component);
+}
+export function unregisterModelPicker() {
+    registry.delete('model');
+}
+/** 读当前注册的框体组件;未注册返回 undefined(调用方回退内置框体) */
+export function getRegisteredPicker(kind) {
+    return registry.get(kind);
+}

package/dist/pickerRegistry.test.d.ts

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

package/dist/pickerRegistry.test.d.ts.map

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

package/dist/pickerRegistry.test.js

@@ -0,0 +1,31 @@
+import { getRegisteredPicker, registerModelPicker, registerPosePicker, unregisterModelPicker, unregisterPosePicker, } from './pickerRegistry';
+const DummyA = () => null;
+const DummyB = () => null;
+afterEach(() => {
+    unregisterPosePicker();
+    unregisterModelPicker();
+});
+test('缺省未注册 = undefined(调用方回退内置框体)', () => {
+    expect(getRegisteredPicker('pose')).toBeUndefined();
+    expect(getRegisteredPicker('model')).toBeUndefined();
+});
+test('注册后可读回;注销后回退 undefined', () => {
+    registerPosePicker(DummyA);
+    expect(getRegisteredPicker('pose')).toBe(DummyA);
+    unregisterPosePicker();
+    expect(getRegisteredPicker('pose')).toBeUndefined();
+});
+test('pose 与 model 两个槽位互不干扰', () => {
+    registerPosePicker(DummyA);
+    registerModelPicker(DummyB);
+    expect(getRegisteredPicker('pose')).toBe(DummyA);
+    expect(getRegisteredPicker('model')).toBe(DummyB);
+    unregisterPosePicker();
+    expect(getRegisteredPicker('pose')).toBeUndefined();
+    expect(getRegisteredPicker('model')).toBe(DummyB);
+});
+test('重复注册后者覆盖前者', () => {
+    registerPosePicker(DummyA);
+    registerPosePicker(DummyB);
+    expect(getRegisteredPicker('pose')).toBe(DummyB);
+});

package/dist/pipLayout.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 画中画底部留白(px):时间轴面板展开时悬在它上方留 GAP_PX 空隙,
+ * 收拢/不存在时回落到 COLLAPSED_BOTTOM_PX。
+ * 面板高度可拖拽、可收拢,所以监听尺寸/DOM/窗口变化实时重算。
+ */
+export declare function usePipBottom(): number;
+//# sourceMappingURL=pipLayout.d.ts.map

package/dist/pipLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipLayout.d.ts","sourceRoot":"","sources":["../src/pipLayout.ts"],"names":[],"mappings":"AAcA;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAiDrC"}

package/dist/pipLayout.js

@@ -0,0 +1,58 @@
+import { useEffect, useState } from 'react';
+/**
+ * 时间轴面板在 studio 的 shadow DOM 里(studio UI 整体挂
+ * #theatrejs-studio-root 的开放 shadow root),普通 DOM 选择器够不到,
+ * 必须从 host 先进 shadowRoot 再 querySelector。
+ */
+const STUDIO_HOST_ID = 'theatrejs-studio-root';
+const SEQUENCE_PANEL_SELECTOR = '[data-panel-id="sequenceEditor"]';
+/** 画中画与时间轴面板之间的空隙 */
+const GAP_PX = 12;
+/** 时间轴收拢(只剩停靠条)时的底部留白 */
+const COLLAPSED_BOTTOM_PX = 48;
+/**
+ * 画中画底部留白(px):时间轴面板展开时悬在它上方留 GAP_PX 空隙,
+ * 收拢/不存在时回落到 COLLAPSED_BOTTOM_PX。
+ * 面板高度可拖拽、可收拢,所以监听尺寸/DOM/窗口变化实时重算。
+ */
+export function usePipBottom() {
+    const [bottom, setBottom] = useState(COLLAPSED_BOTTOM_PX);
+    useEffect(() => {
+        const findPanel = () => document
+            .getElementById(STUDIO_HOST_ID)
+            ?.shadowRoot?.querySelector(SEQUENCE_PANEL_SELECTOR) ??
+            null;
+        const shadowRoot = document.getElementById(STUDIO_HOST_ID)?.shadowRoot;
+        // 面板高度拖拽 → 尺寸变化;收拢/展开 → DOM 增删(面板元素会重建,
+        // ResizeObserver 每次重挂到当前元素上)
+        let observed = null;
+        const resizeObserver = new ResizeObserver(compute);
+        const mutationObserver = new MutationObserver(compute);
+        if (shadowRoot) {
+            mutationObserver.observe(shadowRoot, { subtree: true, childList: true });
+        }
+        window.addEventListener('resize', compute);
+        compute();
+        return () => {
+            resizeObserver.disconnect();
+            mutationObserver.disconnect();
+            window.removeEventListener('resize', compute);
+        };
+        function compute() {
+            const panel = findPanel();
+            if (panel !== observed) {
+                resizeObserver.disconnect();
+                if (panel)
+                    resizeObserver.observe(panel);
+                observed = panel;
+            }
+            if (!panel) {
+                setBottom(COLLAPSED_BOTTOM_PX);
+                return;
+            }
+            // 面板顶边距屏幕底 = 视口高 - top,再留一条空隙
+            setBottom(Math.max(COLLAPSED_BOTTOM_PX, window.innerHeight - panel.getBoundingClientRect().top + GAP_PX));
+        }
+    }, []);
+    return bottom;
+}

package/dist/placementKey.test.d.ts

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

package/dist/placementKey.test.d.ts.map

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

package/dist/placementKey.test.js

@@ -0,0 +1,32 @@
+// packages/camera-studio/src/placementKey.test.ts
+/**
+ * 放置模型取名(顶层扁平化,不再套 "Models /" 文件夹):
+ * 文件名净化、撞名追加序号、与全场景顶层路径防撞(相机/灯光/
+ * 演示模型,如 "Camera.fbx"、"Thingy.fbx"——sheetObjectExists 只查不建)。
+ */
+import { setPrivateAPI } from '@dreamerbird/core/privateAPIs';
+import { uniquePlacedModelKey } from './PlacementManager';
+/** 假 sheet:注册表读不了(uniquePlacedModelKey 按空清单处理),
+ *  getObject 按占用表只查不建 */
+function fakeSheet(occupied = []) {
+    const sheet = { type: 'Sheet' };
+    const taken = new Set(occupied);
+    setPrivateAPI(sheet, {
+        getObject: (key) => (taken.has(key) ? { key } : undefined),
+    });
+    return sheet;
+}
+describe('uniquePlacedModelKey', () => {
+    test('文件名去扩展名,不安全字符换下划线', () => {
+        expect(uniquePlacedModelKey(fakeSheet(), 'Robot.fbx')).toBe('Robot');
+        expect(uniquePlacedModelKey(fakeSheet(), 'a b.fbx')).toBe('a_b');
+        expect(uniquePlacedModelKey(fakeSheet(), '.fbx')).toBe('model');
+    });
+    test('顶层路径被占(相机/灯光/演示模型同名)时追加序号', () => {
+        expect(uniquePlacedModelKey(fakeSheet(['Robot']), 'Robot.fbx')).toBe('Robot-2');
+        expect(uniquePlacedModelKey(fakeSheet(['Robot', 'Robot-2']), 'Robot.fbx')).toBe('Robot-3');
+    });
+    test('裸 sheet(探测落空、注册表读不了):原名直出', () => {
+        expect(uniquePlacedModelKey({}, 'Robot.fbx')).toBe('Robot');
+    });
+});

package/dist/placementPoseProps.d.ts

@@ -0,0 +1,29 @@
+import { poseInterpolate } from './poseMode/poseInterpolate';
+/** 库条目使用计数:姿势值(新旧格式通吃)是否引用了该条目 */
+export declare function isPoseEntryUsed(poseJson: string, entryId: string): boolean;
+/** pose 属性的注册形态(spec §6.1 + 2026-10-01 属性行化):值是 JSON 字符串,
+ *  面板显示为普通属性行,值区域由注册表里的 pose 编辑器渲染(弹框选预设,
+ *  显示 T 姿势/预设名/自定义姿势);自定义插值器让轨道帧间平滑混合 */
+export declare function posePropConfigShape(): {
+    defaultValue: string;
+    opts: {
+        label: () => string;
+        editor: string;
+        interpolate: typeof poseInterpolate;
+    };
+};
+/**
+ * 播放中是否逐帧应用求值姿势(spec §7.1):有轨道才应用——姿势对快照内含的
+ * 骨骼逐骨压过动作片段;无轨道保持现状(mixer 独占,停止时一次性回放)。
+ */
+export declare function shouldApplyPoseDuringPlayback(hasPoseTrack: boolean): boolean;
+/**
+ * 空闲(非播放)时是否把姿势值应用到骨骼:
+ * - 播放中不应用(mixer/播放求值独占骨骼);
+ * - 姿势模式会话中不应用——骨骼归 IK 骨架每帧重解算,applyPose 会被当帧
+ *   压回,抢了也白抢。会话期间值被弹框/撤销/同步改掉时,靠会话退出后
+ *   effect 依赖(poseModeActive)重跑把当前值补刷回骨骼,修「Esc 后模型
+ *   停在旧姿势、再点同值不生效」的脱节卡死。
+ */
+export declare function shouldApplyPoseWhenIdle(playing: boolean, poseModeActive: boolean): boolean;
+//# sourceMappingURL=placementPoseProps.d.ts.map

package/dist/placementPoseProps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placementPoseProps.d.ts","sourceRoot":"","sources":["../src/placementPoseProps.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,eAAe,EAAC,MAAM,4BAA4B,CAAA;AAG1D,kCAAkC;AAClC,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAG1E;AAED;;yCAEyC;AACzC,wBAAgB,mBAAmB,IAAI;IACrC,YAAY,EAAE,MAAM,CAAA;IACpB,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,MAAM,CAAA;QACnB,MAAM,EAAE,MAAM,CAAA;QACd,WAAW,EAAE,OAAO,eAAe,CAAA;KACpC,CAAA;CACF,CASA;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,YAAY,EAAE,OAAO,GAAG,OAAO,CAE5E;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,cAAc,EAAE,OAAO,GACtB,OAAO,CAET"}

package/dist/placementPoseProps.js

@@ -0,0 +1,43 @@
+// packages/camera-studio/src/placementPoseProps.ts
+/**
+ * PlacementManager 姿势属性注册的可测纯件(组件逻辑留 PlacementManager.tsx)。
+ */
+import { defaultT as translate } from './i18n';
+import { poseInterpolate } from './poseMode/poseInterpolate';
+import { parsePoseValue } from './poseMode/poseValue';
+/** 库条目使用计数:姿势值(新旧格式通吃)是否引用了该条目 */
+export function isPoseEntryUsed(poseJson, entryId) {
+    const v = parsePoseValue(poseJson);
+    return v?.kind === 'lib' && v.id === entryId;
+}
+/** pose 属性的注册形态(spec §6.1 + 2026-10-01 属性行化):值是 JSON 字符串,
+ *  面板显示为普通属性行,值区域由注册表里的 pose 编辑器渲染(弹框选预设,
+ *  显示 T 姿势/预设名/自定义姿势);自定义插值器让轨道帧间平滑混合 */
+export function posePropConfigShape() {
+    return {
+        defaultValue: '',
+        opts: {
+            label: () => translate('pg.props.pose'),
+            editor: 'pose',
+            interpolate: poseInterpolate,
+        },
+    };
+}
+/**
+ * 播放中是否逐帧应用求值姿势(spec §7.1):有轨道才应用——姿势对快照内含的
+ * 骨骼逐骨压过动作片段;无轨道保持现状(mixer 独占,停止时一次性回放)。
+ */
+export function shouldApplyPoseDuringPlayback(hasPoseTrack) {
+    return hasPoseTrack;
+}
+/**
+ * 空闲(非播放)时是否把姿势值应用到骨骼:
+ * - 播放中不应用(mixer/播放求值独占骨骼);
+ * - 姿势模式会话中不应用——骨骼归 IK 骨架每帧重解算,applyPose 会被当帧
+ *   压回,抢了也白抢。会话期间值被弹框/撤销/同步改掉时,靠会话退出后
+ *   effect 依赖(poseModeActive)重跑把当前值补刷回骨骼,修「Esc 后模型
+ *   停在旧姿势、再点同值不生效」的脱节卡死。
+ */
+export function shouldApplyPoseWhenIdle(playing, poseModeActive) {
+    return !playing && !poseModeActive;
+}

package/dist/placementPoseProps.test.d.ts

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

package/dist/placementPoseProps.test.d.ts.map

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