@dreamerbird/camera-studio 0.0.0-stage → 0.1.0

package/dist/menuModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menuModel.d.ts","sourceRoot":"","sources":["../src/menuModel.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,6DAA6D,CAAA;AAChG,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,0BAA0B,CAAA;AAEvD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAA;AAEjD,KAAK,KAAK,GAAG,SAAS,CAAA;AAEtB,+CAA+C;AAC/C,wBAAgB,oBAAoB,CAClC,IAAI,EAAE;IACJ,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB,cAAc,EAAE,MAAM,IAAI,CAAA;CAC3B,EACD,CAAC,GAAE,KAAiB,GACnB,eAAe,EAAE,CAUnB;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE;IACJ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,OAAO,CAAA;IAChB,YAAY,EAAE,MAAM,IAAI,CAAA;IACxB,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,yCAAyC;IACzC,oBAAoB,CAAC,EAAE,MAAM,IAAI,CAAA;CAClC,EACD,CAAC,GAAE,KAAiB,GACnB,eAAe,EAAE,CAuBnB;AASD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE;IACJ,IAAI,EAAE,SAAS,CAAA;IACf,YAAY,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAA;IACvC,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;IACvB,8CAA8C;IAC9C,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,IAAI,CAAA;IACzB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IACxB,qBAAqB;IACrB,eAAe,CAAC,EAAE,MAAM,IAAI,CAAA;CAC7B,EACD,CAAC,GAAE,KAAiB,GACnB,eAAe,EAAE,CAkDnB;AAED,wBAAgB,oBAAoB,CAAC,CAAC,SAAS;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,EAC5D,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GACxB,eAAe,EAAE,CAMnB;AAED;+CAC+C;AAC/C,wBAAgB,oBAAoB,CAClC,IAAI,EAAE;IACJ,cAAc,EAAE,MAAM,IAAI,CAAA;CAC3B,EACD,CAAC,GAAE,KAAiB,GACnB,eAAe,EAAE,CAQnB"}

package/dist/menuModel.js

@@ -0,0 +1,111 @@
+import { translate } from '@dreamerbird/studio/i18n';
+/** 右键相机(视锥/机身):镜头视角入口 + 删除(真删:注册表移除+持久数据清理) */
+export function buildCameraMenuItems(opts, t = translate) {
+    return [
+        { type: 'normal', label: t('pg.menu.viewShot'), callback: opts.onViewShot },
+        { type: 'separator' },
+        {
+            type: 'normal',
+            label: t('pg.menu.deleteCamera'),
+            callback: opts.onDeleteCamera,
+        },
+    ];
+}
+export function buildPathMenuItems(opts, t = translate) {
+    return [
+        {
+            type: 'normal',
+            label: opts.editing ? t('pg.menu.exitEditPath') : t('pg.menu.editPath'),
+            callback: () => opts.onToggleEdit(),
+        },
+        ...(opts.onBindToActiveCamera
+            ? [
+                {
+                    type: 'normal',
+                    label: t('pg.menu.bindCamera'),
+                    callback: opts.onBindToActiveCamera,
+                },
+            ]
+            : []),
+        { type: 'separator' },
+        {
+            type: 'normal',
+            label: t('pg.menu.deletePath'),
+            callback: () => opts.onDelete(),
+        },
+    ];
+}
+const GIZMO_MODE_KEYS = {
+    select: 'pg.gizmo.select',
+    translate: 'pg.gizmo.translate',
+    rotate: 'pg.gizmo.rotate',
+    scale: 'pg.gizmo.scale',
+};
+export function buildObjectMenuItems(opts, t = translate) {
+    const modes = ['select', 'translate', 'rotate', 'scale'];
+    const applyItems = [];
+    if (opts.onPoseMode) {
+        const enabled = opts.poseModeEnabled !== false;
+        applyItems.push({
+            type: 'normal',
+            // 置灰时把原因拼进 label(ContextMenuItem 没有 tooltip 字段)
+            label: enabled
+                ? t('pg.menu.poseMode')
+                : `${t('pg.menu.poseMode')}(${opts.poseModeHint ?? ''})`,
+            enabled,
+            callback: enabled ? opts.onPoseMode : undefined,
+        });
+    }
+    if (opts.onChangePose) {
+        applyItems.push({
+            type: 'normal',
+            label: t('pg.menu.changePose'),
+            callback: opts.onChangePose,
+        });
+    }
+    if (opts.onClearPose) {
+        applyItems.push({
+            type: 'normal',
+            label: t('pg.menu.clearPose'),
+            callback: opts.onClearPose,
+        });
+    }
+    if (opts.onPlayAnimation) {
+        applyItems.push({
+            type: 'normal',
+            label: t('pg.menu.playAnimation'),
+            callback: opts.onPlayAnimation,
+        });
+    }
+    if (applyItems.length > 0)
+        applyItems.push({ type: 'separator' });
+    return [
+        ...applyItems,
+        ...modes.map((m) => ({
+            type: 'normal',
+            // 无前导图标位,用全角空格对齐文字
+            label: `${m === opts.mode ? '✓' : '　'}${t(GIZMO_MODE_KEYS[m])}`,
+            callback: () => opts.onSelectMode(m),
+        })),
+        { type: 'separator' },
+        { type: 'normal', label: t('pg.menu.delete'), callback: opts.onDelete },
+    ];
+}
+export function buildExportMenuItems(sinks, onPick) {
+    return sinks.map((sink) => ({
+        type: 'normal',
+        label: sink.label,
+        callback: () => onPick(sink),
+    }));
+}
+/** 右键锚点:仅「删除」一项;真删由 App 的回调实现(对象传给
+ * removeAnchor 做 forgetObject + 注册表移除,对齐相机) */
+export function buildAnchorMenuItems(opts, t = translate) {
+    return [
+        {
+            type: 'normal',
+            label: t('pg.menu.deleteAnchor'),
+            callback: opts.onDeleteAnchor,
+        },
+    ];
+}

package/dist/menuModel.test.d.ts

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

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

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

package/dist/menuModel.test.js

@@ -0,0 +1,197 @@
+import { buildCameraMenuItems, buildPathMenuItems, buildObjectMenuItems, buildExportMenuItems, } from './menuModel';
+import { makeDictT, zhCN } from './i18n';
+// 构建层不读全局单例:注入 zh-CN 词典 t,断言固定语言
+const t = makeDictT(zhCN);
+test('相机右键菜单:查看此镜头 / 删除相机', () => {
+    const onViewShot = jest.fn();
+    const onDeleteCamera = jest.fn();
+    const items = buildCameraMenuItems({ onViewShot, onDeleteCamera }, t);
+    expect(items).toHaveLength(3);
+    expect(items.map((i) => i.type)).toEqual(['normal', 'separator', 'normal']);
+    expect(items[0]).toMatchObject({ type: 'normal', label: '查看此镜头' });
+    expect(items[2]).toMatchObject({ type: 'normal', label: '删除相机' });
+    items[0].callback?.({});
+    expect(onViewShot).toHaveBeenCalled();
+    items[2].callback?.({});
+    expect(onDeleteCamera).toHaveBeenCalled();
+});
+test('路径右键菜单:编辑(带 Tab 标注)与删除,编辑中显示退出编辑', () => {
+    const onToggleEdit = jest.fn();
+    const onDelete = jest.fn();
+    const items = buildPathMenuItems({
+        metaKey: 'Pos Path',
+        editing: false,
+        onToggleEdit,
+        onDelete,
+    }, t);
+    // [编辑路径(Tab), separator, 删除路径]
+    expect(items.map((i) => i.type)).toEqual(['normal', 'separator', 'normal']);
+    expect(String(items[0].label)).toContain('编辑路径');
+    expect(String(items[0].label)).toContain('Tab');
+    expect(String(items[2].label)).toContain('删除路径');
+    const editingItems = buildPathMenuItems({
+        metaKey: 'Pos Path',
+        editing: true,
+        onToggleEdit,
+        onDelete,
+    }, t);
+    expect(String(editingItems[0].label)).toContain('退出编辑');
+});
+test('模型右键菜单:四种 gizmo 模式,当前模式打勾,末尾删除', () => {
+    const onSelectMode = jest.fn();
+    const onDelete = jest.fn();
+    const items = buildObjectMenuItems({
+        mode: 'rotate',
+        onSelectMode,
+        onDelete,
+    }, t);
+    // [select, translate, rotate, scale, separator, 删除]
+    expect(items).toHaveLength(6);
+    expect(String(items[0].label)).not.toContain('✓');
+    expect(String(items[2].label)).toContain('✓');
+    expect(String(items[5].label)).toContain('删除');
+});
+test('对象右键菜单:提供姿势/动作回调时多出两项,位于手柄模式上方', () => {
+    const onSelectMode = jest.fn();
+    const onDelete = jest.fn();
+    const onChangePose = jest.fn();
+    const onPlayAnimation = jest.fn();
+    const items = buildObjectMenuItems({
+        mode: 'rotate',
+        onSelectMode,
+        onDelete,
+        onChangePose,
+        onPlayAnimation,
+    }, t);
+    // [改变姿势, 播放动作, sep, select, translate, rotate, scale, sep, 删除]
+    expect(items.map((i) => i.type)).toEqual([
+        'normal',
+        'normal',
+        'separator',
+        'normal',
+        'normal',
+        'normal',
+        'normal',
+        'separator',
+        'normal',
+    ]);
+    expect(String(items[0].label)).toContain('改变姿势');
+    expect(String(items[1].label)).toContain('播放动作');
+    expect(String(items[8].label)).toContain('删除');
+    items[0].callback?.({});
+    expect(onChangePose).toHaveBeenCalled();
+    items[1].callback?.({});
+    expect(onPlayAnimation).toHaveBeenCalled();
+});
+test('对象右键菜单:只传姿势回调时只有「改变姿势」一项', () => {
+    const items = buildObjectMenuItems({
+        mode: 'translate',
+        onSelectMode: jest.fn(),
+        onDelete: jest.fn(),
+        onChangePose: jest.fn(),
+    }, t);
+    // [改变姿势, sep, select, translate, rotate, scale, sep, 删除]
+    expect(items).toHaveLength(8);
+    expect(String(items[0].label)).toContain('改变姿势');
+});
+test('对象右键菜单:传 onClearPose 时「清除姿势」排在姿势组末位', () => {
+    const onClearPose = jest.fn();
+    const items = buildObjectMenuItems({
+        mode: 'select',
+        onSelectMode: jest.fn(),
+        onDelete: jest.fn(),
+        onChangePose: jest.fn(),
+        onClearPose,
+    }, t);
+    // [改变姿势, 清除姿势, sep, select, translate, rotate, scale, sep, 删除]
+    expect(items.map((i) => i.type)).toEqual([
+        'normal',
+        'normal',
+        'separator',
+        'normal',
+        'normal',
+        'normal',
+        'normal',
+        'separator',
+        'normal',
+    ]);
+    expect(String(items[1].label)).toContain('清除姿势');
+    items[1].callback?.({});
+    expect(onClearPose).toHaveBeenCalled();
+});
+test('摆姿势菜单项:提供 onPoseMode 时排在最前,可点击', () => {
+    const onPoseMode = jest.fn();
+    const items = buildObjectMenuItems({
+        mode: 'select',
+        onSelectMode: jest.fn(),
+        onDelete: jest.fn(),
+        onPoseMode,
+    }, t);
+    expect(String(items[0].label)).toContain('摆姿势');
+    items[0].callback?.({});
+    expect(onPoseMode).toHaveBeenCalled();
+});
+test('摆姿势菜单项:poseModeEnabled=false 时置灰且不可点', () => {
+    const onPoseMode = jest.fn();
+    const items = buildObjectMenuItems({
+        mode: 'select',
+        onSelectMode: jest.fn(),
+        onDelete: jest.fn(),
+        onPoseMode,
+        poseModeEnabled: false,
+        poseModeHint: '骨架不支持摆姿势',
+    }, t);
+    expect(items[0].enabled).toBe(false);
+    expect(items[0].callback).toBeUndefined();
+    expect(String(items[0].label)).toContain('骨架不支持摆姿势');
+});
+test('摆姿势菜单项:与改变姿势共存时摆姿势在前', () => {
+    const items = buildObjectMenuItems({
+        mode: 'select',
+        onSelectMode: jest.fn(),
+        onDelete: jest.fn(),
+        onPoseMode: jest.fn(),
+        onChangePose: jest.fn(),
+    }, t);
+    expect(String(items[0].label)).toContain('摆姿势');
+    expect(String(items[1].label)).toContain('改变姿势');
+});
+test('导出菜单:每个 sink 一项,点击回传 sink', () => {
+    const onPick = jest.fn();
+    const sinks = [
+        { id: 'a', label: 'WebM' },
+        { id: 'b', label: 'MP4' },
+    ];
+    const items = buildExportMenuItems(sinks, onPick);
+    expect(items).toHaveLength(2);
+    items[1].callback?.({});
+    expect(onPick).toHaveBeenCalledWith(sinks[1]);
+});
+test('路径右键菜单:提供 onBindToActiveCamera 时出「绑定到活动相机」', () => {
+    const onBind = jest.fn();
+    const items = buildPathMenuItems({
+        metaKey: 'Pos Path 2',
+        editing: false,
+        onToggleEdit: jest.fn(),
+        onDelete: jest.fn(),
+        onBindToActiveCamera: onBind,
+    }, t);
+    // [编辑路径(Tab), 绑定到活动相机, separator, 删除路径]
+    expect(items.map((i) => i.type)).toEqual([
+        'normal',
+        'normal',
+        'separator',
+        'normal',
+    ]);
+    expect(items[1].label).toBe('绑定到活动相机');
+    items[1].callback?.({});
+    expect(onBind).toHaveBeenCalled();
+    // 不提供时结构不变(向后兼容)
+    const plain = buildPathMenuItems({
+        metaKey: 'Pos Path 2',
+        editing: false,
+        onToggleEdit: jest.fn(),
+        onDelete: jest.fn(),
+    }, t);
+    expect(plain.map((i) => i.type)).toEqual(['normal', 'separator', 'normal']);
+});

package/dist/modalGrab.d.ts

@@ -0,0 +1,29 @@
+import type { IScrub } from '@dreamerbird/core';
+import { Vector3 } from 'three';
+/**
+ * Blender 式模态抓取(G 键的对应物):开始后目标跟随鼠标在"过起点、
+ * 正对相机"的平面里移动;X/Y/Z 锁轴(再按同键解锁);Esc 取消(整个
+ * 拖拽废弃、弹回原位)。两种起手式:
+ *
+ * - 键盘起手(按 G):鼠标是抬起的,左键/回车确认,右键/Esc 取消
+ * - 鼠标起手(按住手柄圆点直接拖):松左键确认,Esc 取消
+ *
+ * 写回走 scrub:移动中逐帧 capture(theatre 状态实时可见),确认一次
+ * commit = 一步撤销;取消 discard 全部回滚。路径控制点/贝塞尔手柄
+ * (CameraPath)和放置物(PlacementManager)共用这一套。
+ */
+export type ModalGrabStart = {
+    /** 世界坐标起点(抓取的平面过这个点) */
+    startPos: Vector3;
+    /** true = 鼠标已经按着(直接拖),松手确认;false = 键盘起手,点击确认 */
+    dragging: boolean;
+    /** 移动中调用:把世界坐标新位置写进 scrub(逐帧 capture) */
+    capture: (scrub: IScrub, worldPos: Vector3) => void;
+};
+export declare function useModalGrab(): {
+    /** 已开始抓取返回 true;已有抓取进行中/无 studio 返回 false */
+    start: (opts: ModalGrabStart) => boolean;
+    /** 是否有抓取进行中(用来藏三轴箭头,避免两套拖动撞车) */
+    active: boolean;
+};
+//# sourceMappingURL=modalGrab.d.ts.map

package/dist/modalGrab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modalGrab.d.ts","sourceRoot":"","sources":["../src/modalGrab.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,mBAAmB,CAAA;AAE7C,OAAO,EAA4B,OAAO,EAAC,MAAM,OAAO,CAAA;AAExD;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,cAAc,GAAG;IAC3B,wBAAwB;IACxB,QAAQ,EAAE,OAAO,CAAA;IACjB,gDAAgD;IAChD,QAAQ,EAAE,OAAO,CAAA;IACjB,yCAAyC;IACzC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAA;CACpD,CAAA;AASD,wBAAgB,YAAY,IAAI;IAC9B,6CAA6C;IAC7C,KAAK,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,OAAO,CAAA;IACxC,iCAAiC;IACjC,MAAM,EAAE,OAAO,CAAA;CAChB,CA6HA"}

package/dist/modalGrab.js

@@ -0,0 +1,127 @@
+import { useThree } from '@react-three/fiber';
+import { getStudioSync } from '@dreamerbird/core';
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { Plane, Raycaster, Vector2, Vector3 } from 'three';
+const X_AXIS = new Vector3(1, 0, 0);
+const Y_AXIS = new Vector3(0, 1, 0);
+const Z_AXIS = new Vector3(0, 0, 1);
+/** 全局同时最多一个抓取(路径/放置物两套调用方互斥,谁先谁得) */
+let activeSession = null;
+export function useModalGrab() {
+    const camera = useThree((s) => s.camera);
+    const gl = useThree((s) => s.gl);
+    const invalidate = useThree((s) => s.invalidate);
+    const [active, setActive] = useState(false);
+    // 组件卸载时若抓取还活着,兜底取消(比如抓取中退出了编辑模式)
+    const endRef = useRef(null);
+    useEffect(() => () => {
+        endRef.current?.(false);
+    }, []);
+    const start = useCallback((opts) => {
+        if (activeSession)
+            return false;
+        const studio = getStudioSync();
+        if (!studio)
+            return false;
+        const scrub = studio.scrub();
+        // 过起点、法线朝相机的平面:鼠标射线与它的交点即目标位置
+        const plane = new Plane();
+        const normal = camera.getWorldDirection(new Vector3());
+        plane.setFromNormalAndCoplanarPoint(normal, opts.startPos.clone());
+        let axis = null;
+        let moved = false;
+        let finished = false;
+        const ndc = new Vector2();
+        const raycaster = new Raycaster();
+        const hit = new Vector3();
+        const delta = new Vector3();
+        const end = (commit) => {
+            if (finished)
+                return;
+            finished = true;
+            window.removeEventListener('pointermove', onMove);
+            window.removeEventListener('pointerdown', onDown, true);
+            window.removeEventListener('pointerup', onUp, true);
+            window.removeEventListener('keydown', onKey, true);
+            window.removeEventListener('contextmenu', onCtxMenu, true);
+            activeSession = null;
+            endRef.current = null;
+            setActive(false);
+            // 只在真的动过之后才提交:原地点击不产生空撤销步骤
+            if (commit && moved)
+                scrub.commit();
+            else
+                scrub.discard();
+            invalidate();
+        };
+        const updateFromPointer = (ev) => {
+            const rect = gl.domElement.getBoundingClientRect();
+            ndc.set(((ev.clientX - rect.left) / rect.width) * 2 - 1, -(((ev.clientY - rect.top) / rect.height) * 2 - 1));
+            raycaster.setFromCamera(ndc, camera);
+            if (!raycaster.ray.intersectPlane(plane, hit))
+                return;
+            if (axis) {
+                // 锁轴:只在轴方向上投影(Blender 的 G X/Y/Z)
+                delta.copy(hit).sub(opts.startPos);
+                hit.copy(opts.startPos).addScaledVector(axis, delta.dot(axis));
+            }
+            moved = true;
+            opts.capture(scrub, hit);
+            invalidate();
+        };
+        const onMove = (ev) => updateFromPointer(ev);
+        // 键盘起手的确认/取消键;captured 阶段拦下,不让画布的点击/选中逻辑吃到
+        const onDown = (ev) => {
+            if (opts.dragging)
+                return;
+            if (ev.button === 0) {
+                ev.stopPropagation();
+                end(true);
+            }
+            else if (ev.button === 2) {
+                ev.stopPropagation();
+                ev.preventDefault();
+                end(false);
+            }
+        };
+        // 鼠标起手:松左键确认
+        const onUp = (ev) => {
+            if (opts.dragging && ev.button === 0)
+                end(true);
+        };
+        const onKey = (ev) => {
+            if (ev.code === 'Escape') {
+                ev.stopPropagation();
+                end(false);
+                return;
+            }
+            if (!opts.dragging && ev.code === 'Enter') {
+                ev.stopPropagation();
+                end(true);
+                return;
+            }
+            const next = ev.code === 'KeyX'
+                ? X_AXIS
+                : ev.code === 'KeyY'
+                    ? Y_AXIS
+                    : ev.code === 'KeyZ'
+                        ? Z_AXIS
+                        : null;
+            // 锁轴开关:按一下锁,再按同键解;键本身不产生移动
+            if (next)
+                axis = axis === next ? null : next;
+        };
+        // 抓取期间屏蔽浏览器右键菜单(右键 = 取消,不是菜单)
+        const onCtxMenu = (ev) => ev.preventDefault();
+        activeSession = { end };
+        endRef.current = end;
+        setActive(true);
+        window.addEventListener('pointermove', onMove);
+        window.addEventListener('pointerdown', onDown, true);
+        window.addEventListener('pointerup', onUp, true);
+        window.addEventListener('keydown', onKey, true);
+        window.addEventListener('contextmenu', onCtxMenu, true);
+        return true;
+    }, [camera, gl, invalidate]);
+    return { start, active };
+}

package/dist/outlineObjectMenu.d.ts

@@ -0,0 +1,41 @@
+/**
+ * camera 场景的大纲右键菜单扩展:相机/锚点/放置模型/路径四类注册表
+ * 对象接管 studio 内置删除(role: 'delete'),走与画布右键同一套真删
+ * 流程(注册表移除 + forgetObject 清持久数据);删除后顺手把对象从
+ * 大纲伪集合名单里清掉。
+ *
+ * 纯函数 cameraOutlineMenuItems 注入 ctx,测试注入固定语言的 t;
+ * cameraOutlineObjectMenu 是注册给 studio extend() 的入口,读模块级
+ * ctx(App 每渲染刷新,菜单点开时拿到的是最新清单与处理器)。
+ */
+import { type InterpolationVars } from '@dreamerbird/studio/i18n';
+import type { ISheet, ISheetObject } from '@dreamerbird/core';
+import type { OutlineObjectMenuContribution } from '@dreamerbird/core/types/public';
+import type { CameraEntry } from './cameraRegistry';
+import type { PathEntry } from './pathRegistry';
+import type { PlacementEntry } from './PlacementManager';
+export declare const cameraOutlineMenuExtensionId = "@dreamerbird/camera-outline-menu";
+export type CameraOutlineMenuHandlers = {
+    removeCamera(entry: CameraEntry): void;
+    removeAnchor(key: string, object?: ISheetObject<any>): void;
+    removePlacement(key: string): void;
+    removePath(pathKey: string): void;
+};
+export type CameraOutlineMenuCtx = {
+    sheet: ISheet;
+    cameras: CameraEntry[];
+    anchors: string[];
+    placements: PlacementEntry[];
+    paths: PathEntry[];
+    handlers: CameraOutlineMenuHandlers;
+};
+export declare function setCameraOutlineMenuCtx(next: CameraOutlineMenuCtx | undefined): void;
+export declare function cameraOutlineObjectMenu(object: ISheetObject<any>): OutlineObjectMenuContribution | undefined;
+/**
+ * 用四个注册表反查对象归属;命中 → 返回接管删除的菜单项
+ * (role:'delete',studio 不再显示默认删除);未命中 → undefined,
+ * 走 studio 内置菜单(Thingy / Key Light / 导演相机组等)。
+ * 删除处理器与画布右键共用同一套函数,两个入口行为一致。
+ */
+export declare function cameraOutlineMenuItems(object: ISheetObject<any>, ctx: CameraOutlineMenuCtx, t?: (key: string, vars?: InterpolationVars) => string): OutlineObjectMenuContribution | undefined;
+//# sourceMappingURL=outlineObjectMenu.d.ts.map

package/dist/outlineObjectMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outlineObjectMenu.d.ts","sourceRoot":"","sources":["../src/outlineObjectMenu.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAY,KAAK,iBAAiB,EAAC,MAAM,0BAA0B,CAAA;AAC1E,OAAO,KAAK,EAAC,MAAM,EAAE,YAAY,EAAC,MAAM,mBAAmB,CAAA;AAC3D,OAAO,KAAK,EACV,6BAA6B,EAE9B,MAAM,gCAAgC,CAAA;AACvC,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,kBAAkB,CAAA;AACjD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,gBAAgB,CAAA;AAC7C,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,oBAAoB,CAAA;AAEtD,eAAO,MAAM,4BAA4B,qCAAqC,CAAA;AAE9E,MAAM,MAAM,yBAAyB,GAAG;IACtC,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAA;IACtC,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,IAAI,CAAA;IAC3D,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,UAAU,EAAE,cAAc,EAAE,CAAA;IAC5B,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,QAAQ,EAAE,yBAAyB,CAAA;CACpC,CAAA;AASD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,oBAAoB,GAAG,SAAS,GACrC,IAAI,CAEN;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,GACxB,6BAA6B,GAAG,SAAS,CAG3C;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,EACzB,GAAG,EAAE,oBAAoB,EACzB,CAAC,GAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,KAAK,MAAkB,GAC/D,6BAA6B,GAAG,SAAS,CAwB3C"}

package/dist/outlineObjectMenu.js

@@ -0,0 +1,58 @@
+/**
+ * camera 场景的大纲右键菜单扩展:相机/锚点/放置模型/路径四类注册表
+ * 对象接管 studio 内置删除(role: 'delete'),走与画布右键同一套真删
+ * 流程(注册表移除 + forgetObject 清持久数据);删除后顺手把对象从
+ * 大纲伪集合名单里清掉。
+ *
+ * 纯函数 cameraOutlineMenuItems 注入 ctx,测试注入固定语言的 t;
+ * cameraOutlineObjectMenu 是注册给 studio extend() 的入口,读模块级
+ * ctx(App 每渲染刷新,菜单点开时拿到的是最新清单与处理器)。
+ */
+import { translate } from '@dreamerbird/studio/i18n';
+export const cameraOutlineMenuExtensionId = '@dreamerbird/camera-outline-menu';
+/**
+ * 模块级 ctx:App 每渲染刷新(见 App.tsx),菜单点开时读到的就是最新清单
+ * 与处理器。纯函数 cameraOutlineMenuItems 注入 ctx,测试对齐
+ * menuModel.test.ts 的模式。
+ */
+let ctx;
+export function setCameraOutlineMenuCtx(next) {
+    ctx = next;
+}
+export function cameraOutlineObjectMenu(object) {
+    if (!ctx)
+        return undefined;
+    return cameraOutlineMenuItems(object, ctx);
+}
+/**
+ * 用四个注册表反查对象归属;命中 → 返回接管删除的菜单项
+ * (role:'delete',studio 不再显示默认删除);未命中 → undefined,
+ * 走 studio 内置菜单(Thingy / Key Light / 导演相机组等)。
+ * 删除处理器与画布右键共用同一套函数,两个入口行为一致。
+ */
+export function cameraOutlineMenuItems(object, ctx, t = translate) {
+    const key = object.address.objectKey;
+    let onDelete;
+    const camera = ctx.cameras.find((e) => e.cameraKey === key);
+    if (camera) {
+        onDelete = () => ctx.handlers.removeCamera(camera);
+    }
+    else if (ctx.anchors.includes(key)) {
+        onDelete = () => ctx.handlers.removeAnchor(key, object);
+    }
+    else if (ctx.placements.some((e) => e.key === key)) {
+        onDelete = () => ctx.handlers.removePlacement(key);
+    }
+    else if (ctx.paths.some((e) => e.pathKey === key)) {
+        onDelete = () => ctx.handlers.removePath(key);
+    }
+    if (!onDelete)
+        return undefined;
+    const item = {
+        type: 'normal',
+        label: t('pg.menu.delete'),
+        onSelect: onDelete,
+        role: 'delete',
+    };
+    return { items: [item] };
+}

package/dist/outlineObjectMenu.test.d.ts

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

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

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

package/dist/outlineObjectMenu.test.js

@@ -0,0 +1,83 @@
+import { cameraOutlineMenuItems, cameraOutlineObjectMenu, setCameraOutlineMenuCtx, } from './outlineObjectMenu';
+import { makeDictT, en } from './i18n';
+const t = makeDictT(en);
+function makeCtx(overrides = {}) {
+    return {
+        sheet: {},
+        cameras: [],
+        anchors: [],
+        placements: [],
+        paths: [],
+        handlers: {
+            removeCamera: () => { },
+            removeAnchor: () => { },
+            removePlacement: () => { },
+            removePath: () => { },
+        },
+        ...overrides,
+    };
+}
+const asObject = (objectKey) => ({ address: { objectKey } });
+describe('cameraOutlineMenuItems', () => {
+    it('命中相机:delete 项接管内置删除(role)', () => {
+        const calls = [];
+        const ctx = makeCtx({
+            cameras: [{ cameraKey: 'Shot Camera' }],
+            handlers: {
+                removeCamera: (e) => calls.push(`camera:${e.cameraKey}`),
+                removeAnchor: () => { },
+                removePlacement: () => { },
+                removePath: () => { },
+            },
+        });
+        const contribution = cameraOutlineMenuItems(asObject('Shot Camera'), ctx, t);
+        expect(contribution).toBeDefined();
+        expect(contribution.items).toHaveLength(1);
+        expect(contribution.items[0].label).toBe('Delete');
+        expect(contribution.items[0].role).toBe('delete');
+        contribution.items[0].onSelect();
+        expect(calls).toEqual(['camera:Shot Camera']);
+    });
+    it('命中锚点:传 key 和对象本身', () => {
+        const calls = [];
+        const ctx = makeCtx({
+            anchors: ['Anchor 1'],
+            handlers: {
+                removeCamera: () => { },
+                removeAnchor: (key, obj) => calls.push(`anchor:${key}:${obj ? 'obj' : 'noobj'}`),
+                removePlacement: () => { },
+                removePath: () => { },
+            },
+        });
+        const obj = asObject('Anchor 1');
+        const contribution = cameraOutlineMenuItems(obj, ctx, t);
+        contribution.items[0].onSelect();
+        expect(calls).toEqual(['anchor:Anchor 1:obj']);
+    });
+    it('命中放置模型与路径', () => {
+        const calls = [];
+        const ctx = makeCtx({
+            placements: [{ key: 'Model A', position: { x: 0, y: 0, z: 0 } }],
+            paths: [{ pathKey: 'Path 1' }],
+            handlers: {
+                removeCamera: () => { },
+                removeAnchor: () => { },
+                removePlacement: (key) => calls.push(`placement:${key}`),
+                removePath: (key) => calls.push(`path:${key}`),
+            },
+        });
+        cameraOutlineMenuItems(asObject('Model A'), ctx, t).items[0].onSelect();
+        cameraOutlineMenuItems(asObject('Path 1'), ctx, t).items[0].onSelect();
+        expect(calls).toEqual(['placement:Model A', 'path:Path 1']);
+    });
+    it('未命中(Thingy/注册表等)返回 undefined,走 studio 默认菜单', () => {
+        const ctx = makeCtx({ cameras: [{ cameraKey: 'Shot Camera' }] });
+        expect(cameraOutlineMenuItems(asObject('Thingy'), ctx, t)).toBeUndefined();
+    });
+});
+describe('cameraOutlineObjectMenu(注册扩展用)', () => {
+    it('ctx 未设置时返回 undefined', () => {
+        setCameraOutlineMenuCtx(undefined);
+        expect(cameraOutlineObjectMenu(asObject('Shot Camera'))).toBeUndefined();
+    });
+});