@dreamerbird/camera-studio 0.0.0-stage → 0.1.0

package/dist/hostFlows.test.js

@@ -0,0 +1,191 @@
+/*
+ * @jest-environment jsdom
+ */
+/**
+ * hostFlows:宿主能力句柄的基础设施——句柄注册表、placing 外部 store、
+ * usePlacing hook。模块级单例,场景 mount 时挂句柄、卸载时清句柄。
+ */
+import { act } from 'react-dom/test-utils';
+import ReactDOM from 'react-dom/client';
+import React from 'react';
+import { PerspectiveCamera } from 'three';
+import { createHostFlows, dropPointFromClient, getHostFlowsHandle, getPlacingSnapshot, pickerToggleHandler, setDropPointContext, setHostFlowsHandle, setPlacingSnapshot, subscribePlacing, usePlacing, } from './hostFlows';
+const placingA = {
+    url: 'blob:a',
+    label: 'A',
+    source: { type: 'library', entryId: 'e1' },
+};
+afterEach(() => {
+    setHostFlowsHandle(null);
+    setPlacingSnapshot(null);
+});
+describe('句柄注册表', () => {
+    it('未设置时返回 null,设置后可取回,清空后归 null', () => {
+        expect(getHostFlowsHandle()).toBeNull();
+        const fake = {};
+        setHostFlowsHandle(fake);
+        expect(getHostFlowsHandle()).toBe(fake);
+        setHostFlowsHandle(null);
+        expect(getHostFlowsHandle()).toBeNull();
+    });
+});
+describe('placing store', () => {
+    it('初始快照为 null', () => {
+        expect(getPlacingSnapshot()).toBeNull();
+    });
+    it('设置快照后订阅者被通知;同值重复设置不通知', () => {
+        const seen = [];
+        const unsub = subscribePlacing(() => seen.push(getPlacingSnapshot()));
+        setPlacingSnapshot(placingA);
+        setPlacingSnapshot(placingA);
+        expect(seen).toHaveLength(1);
+        expect(seen[0]).toBe(placingA);
+        unsub();
+        setPlacingSnapshot(null);
+        expect(seen).toHaveLength(1);
+    });
+});
+describe('usePlacing', () => {
+    it('跟随 store 变化重渲染', async () => {
+        const el = document.createElement('div');
+        document.body.appendChild(el);
+        const root = ReactDOM.createRoot(el);
+        let rendering = () => null;
+        function Probe() {
+            rendering = usePlacing;
+            return null;
+        }
+        function Host() {
+            const placing = usePlacing();
+            rendering = () => placing;
+            return null;
+        }
+        await act(async () => {
+            root.render(React.createElement(Host));
+        });
+        expect(rendering()).toBeNull();
+        await act(async () => {
+            setPlacingSnapshot(placingA);
+        });
+        expect(rendering()).toBe(placingA);
+        await act(async () => {
+            root.unmount();
+        });
+        el.remove();
+        // Probe 只为引用 usePlacing 而设,避免 lint 报未使用
+        void Probe;
+    });
+});
+describe('dropPointFromClient', () => {
+    afterEach(() => setDropPointContext(null));
+    it('未设置上下文时返回 null', () => {
+        expect(dropPointFromClient(50, 50)).toBeNull();
+    });
+    it('上下文就绪时按地面兜底规则返回落点(rect 中心的垂直射线打 y=0)', () => {
+        // 相机在 (0,10,1) 看向原点,rect 100×100,(50,50) = NDC 原点,
+        // 中心视线恰好穿过 (0,0,0)。不能放正上方 (0,10,0):lookAt 的
+        // up 与视线平行会触发 three 退化回退,给方向引入 ~1e-3 扰动。
+        const camera = new PerspectiveCamera();
+        camera.position.set(0, 10, 1);
+        camera.lookAt(0, 0, 0);
+        camera.updateMatrixWorld();
+        const domElement = {
+            getBoundingClientRect: () => ({ left: 0, top: 0, width: 100, height: 100 }),
+        };
+        setDropPointContext({
+            gl: { domElement },
+            camera,
+        });
+        const p = dropPointFromClient(50, 50);
+        expect(p).not.toBeNull();
+        expect(p.x).toBeCloseTo(0, 5);
+        expect(p.z).toBeCloseTo(0, 5);
+        expect(p.y).toBeCloseTo(0, 5);
+    });
+    it('清空上下文后回到 null', () => {
+        const camera = new PerspectiveCamera();
+        setDropPointContext({
+            gl: {
+                domElement: {
+                    getBoundingClientRect: () => ({ left: 0, top: 0, width: 100, height: 100 }),
+                },
+            },
+            camera,
+        });
+        setDropPointContext(null);
+        expect(dropPointFromClient(50, 50)).toBeNull();
+    });
+});
+function makeDeps() {
+    return {
+        startPlacingFromLibrary: jest.fn(async () => undefined),
+        placeLibraryEntryAt: jest.fn(),
+        placePresetPath: jest.fn(),
+        addCamera: jest.fn(),
+        addAnchor: jest.fn(),
+        cancelPlacing: jest.fn(),
+        importModel: jest.fn(async () => ({ id: 'm1' })),
+    };
+}
+const entry = { id: 'e1', name: 'A' };
+const preset = { id: 'p1' };
+describe('createHostFlows', () => {
+    it('七个动作逐一转发到注入的 deps,dropPointFromClient 挂上模块实现', async () => {
+        const deps = makeDeps();
+        const flows = createHostFlows(() => deps);
+        await flows.startPlacingModel(entry);
+        expect(deps.startPlacingFromLibrary).toHaveBeenCalledWith(entry);
+        flows.placeModelAt(entry, { x: 1, y: 2, z: 3 });
+        expect(deps.placeLibraryEntryAt).toHaveBeenCalledWith(entry, {
+            x: 1,
+            y: 2,
+            z: 3,
+        });
+        flows.addPresetPath(preset, { x: 0, y: 5, z: 0 });
+        expect(deps.placePresetPath).toHaveBeenCalledWith(preset, {
+            x: 0,
+            y: 5,
+            z: 0,
+        });
+        flows.addCamera();
+        expect(deps.addCamera).toHaveBeenCalled();
+        flows.addAnchor();
+        expect(deps.addAnchor).toHaveBeenCalled();
+        flows.cancelPlacing();
+        expect(deps.cancelPlacing).toHaveBeenCalled();
+        const file = new File(['x'], 'm.fbx');
+        await flows.importModel(file);
+        expect(deps.importModel).toHaveBeenCalledWith(file);
+        // 未设 dropPoint 上下文时按模块实现返 null
+        expect(flows.dropPointFromClient(0, 0)).toBeNull();
+    });
+    it('调用时才取 deps,无缓存:替换 deps 对象后新调用打到第二组', () => {
+        const depsA = makeDeps();
+        const depsB = makeDeps();
+        const holder = { deps: depsA };
+        const flows = createHostFlows(() => holder.deps);
+        flows.addCamera();
+        expect(depsA.addCamera).toHaveBeenCalledTimes(1);
+        expect(depsB.addCamera).not.toHaveBeenCalled();
+        // 模拟 App 侧依赖换代(activeCamera 切换级联重建 placePresetPath 等)
+        holder.deps = depsB;
+        flows.addCamera();
+        expect(depsB.addCamera).toHaveBeenCalledTimes(1);
+        // 第一组不再被追加调用——句柄转发的是最新实现,无陈旧闭包
+        expect(depsA.addCamera).toHaveBeenCalledTimes(1);
+    });
+});
+describe('pickerToggleHandler', () => {
+    it('宿主回调存在时只调宿主回调,toggleFrame 不执行', () => {
+        const hostCb = jest.fn();
+        const toggleFrame = jest.fn();
+        pickerToggleHandler(hostCb, toggleFrame, 'model')();
+        expect(hostCb).toHaveBeenCalledTimes(1);
+        expect(toggleFrame).not.toHaveBeenCalled();
+    });
+    it('宿主回调缺省时走 toggleFrame(kind)', () => {
+        const toggleFrame = jest.fn();
+        pickerToggleHandler(undefined, toggleFrame, 'path')();
+        expect(toggleFrame).toHaveBeenCalledWith('path');
+    });
+});

package/dist/i18n.d.ts

@@ -0,0 +1,26 @@
+/**
+ * camera 场景的词条注册:en + zh-CN 两部词典,模块加载即注入 studio
+ * 的 i18n 单例(与宿主共享实例,宿主可后注册覆盖同名 key 做品牌定制)。
+ *
+ * 收编范围:顶栏 tooltip、右键/导出菜单、面板动作名、相机/放置对象的
+ * 属性标签、资产库框体文案、导入确认弹层。key 一律 `pg.` 前缀,避免与
+ * studio 内置词条撞车。
+ *
+ * 纯逻辑层(菜单构建/导入计划)不直接调 translate,而是由调用方把 t
+ * 传进来(默认 translate)——测试可以注入词典 stub 断言固定语言。
+ */
+import { translate, type InterpolationVars, type Messages } from '@dreamerbird/studio/i18n';
+export declare const en: Messages;
+export declare const zhCN: Messages;
+/**
+ * camera 词条显式注册(bootstrap 用它再注册一次;模块加载的自调用也走
+ * 这里——ShotCamera 模块加载期就 translate,副作用必须保留)。
+ * registerMessages/registerFallback 均为合并/覆盖语义,重复调用安全。
+ * 姿势名词典单独成册(poseNameMessages.ts,约 180 条 × 双语),此处合并注册。
+ */
+export declare function registerCameraMessages(): void;
+/** 测试/宿主定制用:从一部词典构造固定语言的 t(含 `{var}` 插值) */
+export declare function makeDictT(dict: Messages): (key: string, vars?: InterpolationVars) => string;
+/** 默认 t:走全局单例当前语言(菜单构建等纯逻辑层的缺省) */
+export declare const defaultT: typeof translate;
+//# sourceMappingURL=i18n.d.ts.map

package/dist/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAGL,SAAS,EACT,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACd,MAAM,0BAA0B,CAAA;AAGjC,eAAO,MAAM,EAAE,EAAE,QAqIhB,CAAA;AAED,eAAO,MAAM,IAAI,EAAE,QA8HlB,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAK7C;AAID,4CAA4C;AAC5C,wBAAgB,SAAS,CACvB,IAAI,EAAE,QAAQ,GACb,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,KAAK,MAAM,CAQnD;AAED,mCAAmC;AACnC,eAAO,MAAM,QAAQ,kBAAY,CAAA"}

package/dist/i18n.js

@@ -0,0 +1,271 @@
+/**
+ * camera 场景的词条注册:en + zh-CN 两部词典,模块加载即注入 studio
+ * 的 i18n 单例(与宿主共享实例,宿主可后注册覆盖同名 key 做品牌定制)。
+ *
+ * 收编范围:顶栏 tooltip、右键/导出菜单、面板动作名、相机/放置对象的
+ * 属性标签、资产库框体文案、导入确认弹层。key 一律 `pg.` 前缀,避免与
+ * studio 内置词条撞车。
+ *
+ * 纯逻辑层(菜单构建/导入计划)不直接调 translate,而是由调用方把 t
+ * 传进来(默认 translate)——测试可以注入词典 stub 断言固定语言。
+ */
+import { registerMessages, registerFallback, translate, } from '@dreamerbird/studio/i18n';
+import { poseNameEn, poseNameZhCN } from './poseNameMessages';
+export const en = {
+    'pg.toolbar.addModel': 'Add model',
+    'pg.toolbar.addModel.hint': 'Open the model library; click or drag to place a model',
+    'pg.toolbar.addPath': 'Add path',
+    'pg.toolbar.addPath.hint': 'Open the path preset library; click or drag to create a camera track',
+    'pg.toolbar.addCamera': 'Add camera',
+    'pg.toolbar.addCamera.hint': 'Create a camera from the current director view (becomes the active camera)',
+    'pg.toolbar.addAnchor': 'Add anchor',
+    'pg.toolbar.addAnchor.hint': 'Place an empty anchor in front of the current view (aim target / parentable)',
+    'pg.toolbar.pip': 'Picture in picture',
+    'pg.toolbar.pip.show': 'Show the shot preview in the bottom-right corner',
+    'pg.toolbar.pip.hide': 'Hide the shot preview',
+    'pg.toolbar.pip.disabled': 'Add a camera first',
+    'pg.toolbar.export': 'Export video',
+    'pg.toolbar.stopExport': 'Stop & save',
+    'pg.toolbar.export.esc': 'Press Esc to cancel',
+    'pg.toolbar.export.hint': 'Record the live shot: the sequence plays start to finish and saves automatically',
+    'pg.toolbar.placing': 'Placing: confirm or cancel the current placement first',
+    'pg.menu.viewShot': 'View this shot',
+    'pg.menu.deleteCamera': 'Delete camera',
+    'pg.menu.deleteAnchor': 'Delete anchor',
+    'pg.menu.editPath': 'Edit path (Tab)',
+    'pg.menu.exitEditPath': 'Exit editing (Tab)',
+    'pg.menu.bindCamera': 'Bind to active camera',
+    'pg.menu.deletePath': 'Delete path',
+    'pg.menu.poseMode': 'Pose interactively',
+    'pg.menu.poseModeUnsupported': 'skeleton not supported',
+    'pg.menu.changePose': 'Change pose',
+    'pg.menu.clearPose': 'Clear pose',
+    'pg.menu.playAnimation': 'Play animation',
+    'pg.menu.delete': 'Delete',
+    'pg.gizmo.select': 'Select',
+    'pg.gizmo.translate': 'Move',
+    'pg.gizmo.rotate': 'Rotate',
+    'pg.gizmo.scale': 'Scale',
+    'pg.gizmo.select.hint': 'Shortcut: W',
+    'pg.gizmo.translate.hint': 'Shortcut: G',
+    'pg.gizmo.rotate.hint': 'Shortcut: R',
+    'pg.gizmo.scale.hint': 'Shortcut: S',
+    'pg.posebar.posing': 'Posing',
+    'pg.posebar.esc': 'Esc to finish',
+    'pg.posebar.move.hint': 'Shortcut: W',
+    'pg.posebar.rotate.hint': 'Shortcut: E',
+    'pg.pose.editFrame': 'editing keyframe',
+    'pg.pose.newFrame': 'new keyframe',
+    'pg.pose.statusBind': 'Bind pose',
+    'pg.pose.statusCustom': 'Custom pose',
+    'pg.pose.statusLibPrefix': 'Library: ',
+    'pg.pose.tPose': 'T pose',
+    'pg.pose.keyframesUnit': 'keyframes',
+    'pg.pose.addKeyframe': 'Add keyframe',
+    'pg.pose.clear': 'Clear pose',
+    'pg.pose.libMissing': ' (missing)',
+    'pg.pose.selectorTitle': 'Pose source',
+    'pg.props.aimTarget': 'Aim target',
+    'pg.props.aimNone': 'None',
+    'pg.props.anchorParent': 'Parent',
+    'pg.props.parentNone': 'None',
+    'pg.props.pathKey': 'Bound path',
+    'pg.props.pathManual': 'None',
+    'pg.props.animation': 'Animation',
+    'pg.props.pose': 'Pose',
+    'pg.props.poseOverride': 'Pose override',
+    'pg.props.gestureL': 'Left gesture',
+    'pg.props.gestureR': 'Right gesture',
+    'pg.gesture.none': 'No gesture',
+    'pg.gesture.selectorTitleL': 'Left-hand gesture',
+    'pg.gesture.selectorTitleR': 'Right-hand gesture',
+    'pg.props.source': 'Source file',
+    'pg.parts.head': 'Head',
+    'pg.parts.chest': 'Chest',
+    'pg.parts.handL': 'Left hand',
+    'pg.parts.handR': 'Right hand',
+    'pg.parts.legL': 'Left leg',
+    'pg.parts.legR': 'Right leg',
+    'pg.props.pathProgress': 'Travel Progress',
+    'pg.props.position': 'Position',
+    'pg.props.rotationRadian': 'Rotation',
+    'pg.props.scale': 'Scale',
+    'pg.lib.title.model': 'Models',
+    'pg.lib.title.pose': 'Poses',
+    'pg.lib.title.animation': 'Animations',
+    'pg.lib.title.path': 'Path presets',
+    'pg.lib.import': 'Import files',
+    'pg.lib.close': 'Close',
+    'pg.lib.rigRenamePrompt': 'Rig family name',
+    'pg.lib.renamePrompt': 'Rename',
+    'pg.lib.delete.inUse': 'Delete "{name}"? {count} placed instance(s) use it; they will fall back to bind pose / no animation or fail to load.',
+    'pg.lib.delete.unused': 'Delete "{name}"? Placed instances are not affected.',
+    'pg.lib.rigTitle': '{rig}\nClick to name this rig',
+    'pg.lib.rigMismatch': ' · rig mismatch',
+    'pg.lib.modelCardTitle': 'Click to place at scene center; drag to a spot on the canvas',
+    'pg.lib.filterHint': 'Only entries of the same rig family can be applied; others are greyed out',
+    'pg.lib.savePose': 'Save current pose',
+    'pg.lib.savePoseDisabled': 'Select a placed model with a skeleton first',
+    'pg.lib.similar.title': 'Similar models detected, choose how to handle:',
+    'pg.lib.similar.desc': 'New file "{newName}" is similar to "{existingName}" in the library',
+    'pg.lib.similar.reuse': 'Reuse library entry (discard new file)',
+    'pg.lib.similar.keep': 'Keep as new entry',
+    'pg.lib.cancel': 'Cancel',
+    'pg.lib.confirm': 'Confirm',
+    'pg.lib.ctx.rename': 'Rename',
+    'pg.lib.ctx.delete': 'Delete',
+    'pg.import.summary.models': 'Models ×{count}',
+    'pg.import.summary.animations': 'Animations ×{count}',
+    'pg.import.summary.poses': 'Poses ×{count}',
+    'pg.import.summary.skips': 'Skipped ×{count}',
+    'pg.import.summary.prefix': 'Identified:',
+    'pg.import.summary.empty': 'Nothing to import',
+    'pg.import.reason.badPoseJson': 'Invalid pose JSON',
+    'pg.import.reason.parseFailed': 'Failed to parse the file',
+    'pg.import.reason.noContent': 'No mesh and no animation, unrecognized',
+    'pg.import.reason.modelExportFailed': 'Model export failed',
+    'pg.import.reason.modelExists': 'Model already exists (same as "{name}")',
+    'pg.import.reason.animationExportFailed': 'Animation export failed',
+    'pg.import.reason.animationExists': 'Animation already in the library',
+};
+export const zhCN = {
+    'pg.toolbar.addModel': '添加模型',
+    'pg.toolbar.addModel.hint': '打开模型库,点击或拖拽把模型放进场景',
+    'pg.toolbar.addPath': '添加路径',
+    'pg.toolbar.addPath.hint': '打开路径预设库,点击或拖拽生成相机轨迹',
+    'pg.toolbar.addCamera': '添加相机',
+    'pg.toolbar.addCamera.hint': '从当前导演视角创建一台相机(落地即活动相机)',
+    'pg.toolbar.addAnchor': '添加锚点',
+    'pg.toolbar.addAnchor.hint': '在当前视角前方放一个空锚点(可被相机瞄准、可绑父级)',
+    'pg.toolbar.pip': '画中画',
+    'pg.toolbar.pip.show': '显示右下角的镜头画中画',
+    'pg.toolbar.pip.hide': '隐藏右下角的镜头画中画',
+    'pg.toolbar.pip.disabled': '先添加相机',
+    'pg.toolbar.export': '导出视频',
+    'pg.toolbar.stopExport': '停止并保存',
+    'pg.toolbar.export.esc': 'Esc 取消',
+    'pg.toolbar.export.hint': '把镜头取景实时录成视频:序列从头播到尾,录完自动保存',
+    'pg.toolbar.placing': '放置中:先确认或取消当前放置',
+    'pg.menu.viewShot': '查看此镜头',
+    'pg.menu.deleteCamera': '删除相机',
+    'pg.menu.deleteAnchor': '删除锚点',
+    'pg.menu.editPath': '编辑路径(Tab)',
+    'pg.menu.exitEditPath': '退出编辑(Tab)',
+    'pg.menu.bindCamera': '绑定到活动相机',
+    'pg.menu.deletePath': '删除路径',
+    'pg.menu.poseMode': '摆姿势',
+    'pg.menu.poseModeUnsupported': '骨架不支持摆姿势',
+    'pg.menu.changePose': '改变姿势',
+    'pg.menu.clearPose': '清除姿势',
+    'pg.menu.playAnimation': '播放动作',
+    'pg.menu.delete': '删除',
+    'pg.gizmo.select': '选择',
+    'pg.gizmo.translate': '移动',
+    'pg.gizmo.rotate': '旋转',
+    'pg.gizmo.scale': '缩放',
+    'pg.gizmo.select.hint': '快捷键 W',
+    'pg.gizmo.translate.hint': '快捷键 G',
+    'pg.gizmo.rotate.hint': '快捷键 R',
+    'pg.gizmo.scale.hint': '快捷键 S',
+    'pg.posebar.posing': '正在摆姿势',
+    'pg.posebar.esc': 'Esc 完成',
+    'pg.posebar.move.hint': '快捷键 W',
+    'pg.posebar.rotate.hint': '快捷键 E',
+    'pg.pose.editFrame': '编辑关键帧',
+    'pg.pose.newFrame': '新建关键帧',
+    'pg.pose.statusBind': '绑定姿势',
+    'pg.pose.statusCustom': '自定义姿势',
+    'pg.pose.statusLibPrefix': '库:',
+    'pg.pose.tPose': 'T 姿势',
+    'pg.pose.keyframesUnit': '个关键帧',
+    'pg.pose.addKeyframe': '打帧',
+    'pg.pose.clear': '清除姿势',
+    'pg.pose.libMissing': '(缺失)',
+    'pg.pose.selectorTitle': '姿势来源',
+    'pg.props.aimTarget': '瞄准目标',
+    'pg.props.aimNone': '无',
+    'pg.props.anchorParent': '父级',
+    'pg.props.parentNone': '无',
+    'pg.props.pathKey': '绑定路径',
+    'pg.props.pathManual': '无',
+    'pg.props.animation': '动作',
+    'pg.props.pose': '姿势',
+    'pg.props.poseOverride': '姿势覆盖',
+    'pg.props.gestureL': '左手势',
+    'pg.props.gestureR': '右手势',
+    'pg.gesture.none': '无手势',
+    'pg.gesture.selectorTitleL': '选择左手势',
+    'pg.gesture.selectorTitleR': '选择右手势',
+    'pg.props.source': '来源文件',
+    'pg.parts.head': '头',
+    'pg.parts.chest': '胸口',
+    'pg.parts.handL': '左手',
+    'pg.parts.handR': '右手',
+    'pg.parts.legL': '左腿',
+    'pg.parts.legR': '右腿',
+    'pg.props.pathProgress': '行进进度',
+    'pg.props.position': '位置',
+    'pg.props.rotationRadian': '旋转',
+    'pg.props.scale': '缩放',
+    'pg.lib.title.model': '模型库',
+    'pg.lib.title.pose': '姿势库',
+    'pg.lib.title.animation': '动作库',
+    'pg.lib.title.path': '路径预设',
+    'pg.lib.import': '导入文件',
+    'pg.lib.close': '关闭',
+    'pg.lib.rigRenamePrompt': '骨架族名称',
+    'pg.lib.renamePrompt': '重命名',
+    'pg.lib.delete.inUse': '删除「{name}」?场景中有 {count} 个实例正在使用它,删除后这些实例将回退为绑定姿势/无动作或无法加载。',
+    'pg.lib.delete.unused': '删除「{name}」?场景里已放置的实例不受影响。',
+    'pg.lib.rigTitle': '{rig}\n点击给这套骨架起名',
+    'pg.lib.rigMismatch': ' · 骨架不匹配',
+    'pg.lib.modelCardTitle': '点击放到场景中心;按住拖到画布指定落点',
+    'pg.lib.filterHint': '只列出同骨架族的条目可套用,不同族的已置灰',
+    'pg.lib.savePose': '存当前姿势',
+    'pg.lib.savePoseDisabled': '先选中一个带骨架的已放置模型',
+    'pg.lib.similar.title': '检测到相似模型,请选择处理方式:',
+    'pg.lib.similar.desc': '新文件「{newName}」与库中「{existingName}」相似',
+    'pg.lib.similar.reuse': '复用库中(丢弃新文件)',
+    'pg.lib.similar.keep': '保留为新条目',
+    'pg.lib.cancel': '取消',
+    'pg.lib.confirm': '确认',
+    'pg.lib.ctx.rename': '重命名',
+    'pg.lib.ctx.delete': '删除',
+    'pg.import.summary.models': '模型 ×{count}',
+    'pg.import.summary.animations': '动作 ×{count}',
+    'pg.import.summary.poses': '姿势 ×{count}',
+    'pg.import.summary.skips': '跳过 ×{count}',
+    'pg.import.summary.prefix': '识别为:',
+    'pg.import.summary.empty': '没有可导入的内容',
+    'pg.import.reason.badPoseJson': '姿势 JSON 格式不正确',
+    'pg.import.reason.parseFailed': '文件解析失败',
+    'pg.import.reason.noContent': '无网格也无动画,无法识别',
+    'pg.import.reason.modelExportFailed': '模型导出失败',
+    'pg.import.reason.modelExists': '模型已存在(同库中「{name}」)',
+    'pg.import.reason.animationExportFailed': '动作导出失败',
+    'pg.import.reason.animationExists': '动作已在库中',
+};
+/**
+ * camera 词条显式注册(bootstrap 用它再注册一次;模块加载的自调用也走
+ * 这里——ShotCamera 模块加载期就 translate,副作用必须保留)。
+ * registerMessages/registerFallback 均为合并/覆盖语义,重复调用安全。
+ * 姿势名词典单独成册(poseNameMessages.ts,约 180 条 × 双语),此处合并注册。
+ */
+export function registerCameraMessages() {
+    registerMessages('en', { ...en, ...poseNameEn });
+    registerMessages('zh-CN', { ...zhCN, ...poseNameZhCN });
+    // navigator.language 是 'zh' / 'zh-TW' 等时也能落到 zh-CN 词典
+    registerFallback('zh', 'zh-CN');
+}
+registerCameraMessages();
+/** 测试/宿主定制用:从一部词典构造固定语言的 t(含 `{var}` 插值) */
+export function makeDictT(dict) {
+    return (key, vars) => {
+        const template = dict[key] ?? key;
+        if (!vars)
+            return template;
+        return template.replace(/\{(\w+)\}/g, (m, name) => vars[name] !== undefined ? String(vars[name]) : m);
+    };
+}
+/** 默认 t:走全局单例当前语言(菜单构建等纯逻辑层的缺省) */
+export const defaultT = translate;

package/dist/i18n.test.d.ts

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

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

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

package/dist/i18n.test.js

@@ -0,0 +1,41 @@
+/**
+ * 词条完整性 + 加载顺序回归。
+ *
+ * 回归背景:ShotCamera 在模块加载期就 translate 属性标签(配置是模块级
+ * 常量)。若词条注册被入口文件的 import 顺序绕过去(先 App 后 ./i18n),
+ * 原始 key 会被当文案烘焙进配置,界面上直接显示键名。这里用
+ * isolateModules 模拟最坏顺序——先加载 ShotCamera,断言取词不再返回
+ * key 原文。ShotCamera 自带的 './i18n' 副作用导入是本回归的修复本体。
+ */
+import { en, zhCN } from './i18n';
+test('en 与 zh-CN 词条 key 集合一致(漏翻会静默回退英文)', () => {
+    expect(Object.keys(zhCN).sort()).toEqual(Object.keys(en).sort());
+});
+test('词条值非空', () => {
+    for (const dict of [en, zhCN]) {
+        for (const [k, v] of Object.entries(dict)) {
+            expect(v.trim()).not.toBe('');
+            expect(v).not.toBe(k);
+        }
+    }
+});
+test('最坏 import 顺序下(先 ShotCamera)属性标签也不会烘焙 key', () => {
+    // studio i18n 自 usePropLabel 起传递依赖 @dreamerbird/core(react.tsx
+    // 导入 resolvePropLabel),本测试文件顶部 import 词典时已加载 core,
+    // 其 bundle 全局守卫(window.__TheatreJS_CoreBundle)在 isolateModules
+    // 的二次评估下会误报"被其他模块设置"。清掉它 = 模拟全新页面首载。
+    delete globalThis.__TheatreJS_CoreBundle;
+    jest.isolateModules(() => {
+        require('./ShotCamera');
+        const { translate } = require('@dreamerbird/studio/i18n');
+        for (const key of [
+            'pg.props.aimTarget',
+            'pg.props.pathKey',
+            'pg.props.pathManual',
+            'pg.props.animation',
+            'pg.props.pose',
+        ]) {
+            expect(translate(key)).not.toBe(key);
+        }
+    });
+});

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+import './i18n';
+export { CameraScene } from './CameraScene';
+export { CAMERA_STUDIO_VERSION } from './version';
+export { useCameraStudio } from './useCameraStudio';
+export type { CameraStudioConfig, CameraStudioHandle, CameraSceneProps, CameraStudioAgentConfig, CameraStudioAgentBridgeConfig, } from './config';
+export type { CameraFlows, Vec3 } from './hostFlows';
+export type { PathPreset } from './pathPresets';
+export type { CameraStudioError, CameraStudioErrorHandler, CameraStudioErrorSource, } from './errors';
+export { initCameraStudio, disposeCameraStudio } from './bootstrap';
+export type { BootCtx } from './bootstrap';
+export type { CameraStudioApi } from './agent/api';
+export { AgentApiError, AGENT_API_ERROR_CODES } from './agent/errors';
+export type { AgentApiErrorCode } from './agent/errors';
+export type { RegistryDescription, CommandDescription } from './agent/registry';
+export type { SceneObjectId, SceneObjectKind, JobSnapshot, JobState, AgentErrorDto, CompletionPhase, JsonSchema, CommandContext, CommandDefinition, } from './agent/types';
+export type { SceneApi, ObjectsApi, SceneSnapshot, SceneObjectSummary, } from './agent/commands/scene';
+export type { SelectionApi } from './agent/commands/selection';
+export type { ModelsApi } from './agent/commands/models';
+export type { AssetsApi } from './agent/commands/assets';
+export type { PosesApi, PosesSessionApi } from './agent/commands/poses';
+export type { AnimationsApi, AnimationStatusDto, } from './agent/commands/animations';
+export type { CamerasApi } from './agent/commands/cameras';
+export type { AnchorsApi } from './agent/commands/anchors';
+export type { PathsApi, PathsSessionApi, PathPresetInfo, } from './agent/commands/paths';
+export type { SequenceApi, SequenceState } from './agent/commands/sequence';
+export type { KeyframesApi, KeyframeInfo } from './agent/commands/keyframes';
+export type { HistoryApi } from './agent/commands/history';
+export type { ViewApi, ViewState } from './agent/commands/view';
+export type { UiApi, UiPanelKind } from './agent/commands/ui';
+export type { ProjectApi } from './agent/commands/project';
+export type { ExportsApi } from './agent/commands/exports';
+export type { JobsApi } from './agent/commands/jobs';
+export type { VideoExportResult } from './agent/runtime/exportRuntime';
+export type { GizmoMode } from './PlacementManager';
+export type { PoseBones } from './poseMode/poseOverride';
+export type { GestureSide } from './gestureProps';
+export type { PoseFrameMode } from './poseMode/poseFrame';
+export type { LibrarySource, LibrarySourceCapabilities, WritableLibrarySource, LibraryErrorCode, } from './assetLibrary/source';
+export { LibraryError, isWritableSource } from './assetLibrary/source';
+export type { RigId, RigAlias, EntryKind, ModelEntry, PoseEntry, AnimationEntry, LibraryEntry, } from './assetLibrary/types';
+export { IndexedDBBackend } from './assetLibrary/indexedDBBackend';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,11 @@
+// 词条注册必须最先执行:模块按 import 顺序求值,CameraScene 依赖链里有模块
+// 加载期就 translate 的调用(ShotCamera 属性标签)
+import './i18n';
+export { CameraScene } from './CameraScene';
+export { CAMERA_STUDIO_VERSION } from './version';
+export { useCameraStudio } from './useCameraStudio';
+// 测试与高级宿主可用:绕过 hook 直接管 init/dispose 生命周期
+export { initCameraStudio, disposeCameraStudio } from './bootstrap';
+export { AgentApiError, AGENT_API_ERROR_CODES } from './agent/errors';
+export { LibraryError, isWritableSource } from './assetLibrary/source';
+export { IndexedDBBackend } from './assetLibrary/indexedDBBackend';

package/dist/menuModel.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 菜单项/面板动作的纯构建层:所有右键菜单、下拉菜单、面板动作区的内容
+ * 都在这里组装成数据,组件层(App/TopToolbar/各右键挂载点)只负责渲染
+ * 和接回调。纯函数,单测直接断言结构。
+ *
+ * 文案一律经 t() 取(缺省 = 全局单例当前语言):测试注入固定词典的 t
+ * 即可断言任何语言;词条见 ./i18n.ts。
+ */
+import type { ContextMenuItem } from '@dreamerbird/studio/uiComponents/chordial/chordialInternals';
+import type { TFunction } from '@dreamerbird/studio/i18n';
+import type { GizmoMode } from './PlacementManager';
+type MenuT = TFunction;
+/** 右键相机(视锥/机身):镜头视角入口 + 删除(真删:注册表移除+持久数据清理) */
+export declare function buildCameraMenuItems(opts: {
+    onViewShot: () => void;
+    onDeleteCamera: () => void;
+}, t?: MenuT): ContextMenuItem[];
+export declare function buildPathMenuItems(opts: {
+    metaKey: string;
+    editing: boolean;
+    onToggleEdit: () => void;
+    onDelete: () => void;
+    /** 提供时出「绑定到活动相机」(无活动相机/已绑给活动相机时调用方不传) */
+    onBindToActiveCamera?: () => void;
+}, t?: MenuT): ContextMenuItem[];
+export declare function buildObjectMenuItems(opts: {
+    mode: GizmoMode;
+    onSelectMode: (mode: GizmoMode) => void;
+    onDelete: () => void;
+    /** 提供时菜单顶部出「摆姿势」(双击已选人形模型的入口同款) */
+    onPoseMode?: () => void;
+    /** 骨架不支持人形控制点映射时置灰(callback 不传,原因拼进 label) */
+    poseModeEnabled?: boolean;
+    poseModeHint?: string;
+    /** 提供时菜单顶部出「改变姿势」(右键库来源模型时由 App 传入) */
+    onChangePose?: () => void;
+    /** 提供时出「清除姿势」(删轨道+回默认;有骨骼的模型由 App 传入) */
+    onClearPose?: () => void;
+    /** 提供时菜单顶部出「播放动作」 */
+    onPlayAnimation?: () => void;
+}, t?: MenuT): ContextMenuItem[];
+export declare function buildExportMenuItems<S extends {
+    label: string;
+}>(sinks: readonly S[], onPick: (sink: S) => void): ContextMenuItem[];
+/** 右键锚点:仅「删除」一项;真删由 App 的回调实现(对象传给
+ * removeAnchor 做 forgetObject + 注册表移除,对齐相机) */
+export declare function buildAnchorMenuItems(opts: {
+    onDeleteAnchor: () => void;
+}, t?: MenuT): ContextMenuItem[];
+export {};
+//# sourceMappingURL=menuModel.d.ts.map