@dreamerbird/camera-studio 0.0.0-stage → 0.2.0

package/dist/hostFlows.js

@@ -0,0 +1,77 @@
+/**
+ * 宿主能力句柄的基础设施(规格 §1–§3)。
+ * 句柄注册表:onFlows 一次性交付,宿主自存;模块级单例,场景卸载清空。
+ * placing store:useSyncExternalStore 的外部 store,宿主组件(含 portal
+ * 到 body 的 shadcn Dialog)用 usePlacing() 读放置状态,不依赖 context。
+ * dropPointFromClient 与 createHostFlows 在同文件后续任务补齐。
+ */
+import { useSyncExternalStore } from 'react';
+// ── 句柄注册表 ──────────────────────────────────────────────
+let currentHandle = null;
+export function setHostFlowsHandle(f) {
+    currentHandle = f;
+}
+export function getHostFlowsHandle() {
+    return currentHandle;
+}
+// ── placing 外部 store ──────────────────────────────────────
+let placingSnapshot = null;
+const placingListeners = new Set();
+export function setPlacingSnapshot(p) {
+    if (p === placingSnapshot)
+        return;
+    placingSnapshot = p;
+    placingListeners.forEach((l) => l());
+}
+export function getPlacingSnapshot() {
+    return placingSnapshot;
+}
+export function subscribePlacing(l) {
+    placingListeners.add(l);
+    return () => {
+        placingListeners.delete(l);
+    };
+}
+export function usePlacing() {
+    return useSyncExternalStore(subscribePlacing, getPlacingSnapshot);
+}
+// ── 落点换算 ────────────────────────────────────────────────
+// 场景内(HostFlowsDropPointCapture,App 的 Canvas 子树)把 gl/camera
+// 捕获进来;宿主 dragover/drop 事件里的 clientX/clientY 直接喂给
+// dropPointFromClient,规则与放置幽灵一致(表面优先、地面兜底)。
+import { Raycaster } from 'three';
+import { computeDropPoint } from './dropPoint';
+import { getPlacementSurfaces } from './PlacementManager';
+let dropCtx = null;
+export function setDropPointContext(ctx) {
+    dropCtx = ctx;
+}
+export function dropPointFromClient(clientX, clientY) {
+    if (!dropCtx)
+        return null;
+    const { gl, camera } = dropCtx;
+    const rect = gl.domElement.getBoundingClientRect();
+    const p = computeDropPoint(new Raycaster(), camera, getPlacementSurfaces(), rect, clientX, clientY);
+    return { x: p.x, y: p.y, z: p.z };
+}
+export function createHostFlows(getDeps) {
+    return {
+        startPlacingModel: (entry) => getDeps().startPlacingFromLibrary(entry),
+        placeModelAt: (entry, point) => getDeps().placeLibraryEntryAt(entry, point),
+        addPresetPath: (preset, at) => getDeps().placePresetPath(preset, at),
+        addCamera: () => getDeps().addCamera(),
+        addAnchor: () => getDeps().addAnchor(),
+        cancelPlacing: () => getDeps().cancelPlacing(),
+        importModel: (file) => getDeps().importModel(file),
+        dropPointFromClient,
+    };
+}
+/** 顶栏按钮分流:宿主接了选择框就只通知宿主,否则开内置框体(现状)。 */
+export function pickerToggleHandler(hostCb, toggleFrame, kind) {
+    return () => {
+        if (hostCb)
+            hostCb();
+        else
+            toggleFrame(kind);
+    };
+}

package/dist/hostFlows.test.d.ts

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

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

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

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);
+        }
+    });
+});