@dreamerbird/camera-studio 0.0.0-stage → 0.2.0

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

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

package/dist/App.hostFlows.test.js

@@ -0,0 +1,48 @@
+/*
+ * @jest-environment jsdom
+ */
+/**
+ * CameraScene 宿主接线:onFlows 透传与默认行为。CameraScene 内含
+ * R3F Canvas,jsdom 下渲染成本高——本文件只测纯接线逻辑
+ * (HostFlowsWiring 子组件抽出,见实现),不整树渲染 CameraScene。
+ * (文件名沿自 App 时代,App 已改名 CameraScene,T9。)
+ */
+import React from 'react';
+import { act } from 'react-dom/test-utils';
+import ReactDOM from 'react-dom/client';
+import { getHostFlowsHandle, getPlacingSnapshot } from './hostFlows';
+// CameraScene.tsx 顶层 import 场景 glb,jest 无法解析二进制模块;
+// three/examples/jsm 是纯 ESM,node_modules 不在 jest transform 范围。
+// jest-esbuild 不提升 jest.mock,故用 doMock 先行登记、再运行时 require
+// CameraScene(与 hostFlows 共享同一模块实例,句柄注册表可观测)。
+jest.doMock('./scene.glb', () => 'scene.glb');
+jest.doMock('three/examples/jsm/environments/RoomEnvironment.js', () => ({
+    RoomEnvironment: class RoomEnvironment {
+    },
+}));
+// 内置资产 2026-10-10 目录化后不再经 vite 目录 glob 播种:条目来自入库
+// 清单 + StaticCatalogSource,jest 下静态 import 链无 vite 专属语法
+const { HostFlowsWiring } = require('./CameraScene');
+describe('HostFlowsWiring', () => {
+    it('mount 时交付句柄并挂注册表,unmount 清空注册表', () => {
+        const flows = { fake: true };
+        const onFlows = jest.fn();
+        const el = document.createElement('div');
+        const root = ReactDOM.createRoot(el);
+        act(() => {
+            root.render(React.createElement(HostFlowsWiring, { flows: flows, onFlows: onFlows }));
+        });
+        expect(onFlows).toHaveBeenCalledWith(flows);
+        expect(getHostFlowsHandle()).toBe(flows);
+        act(() => {
+            root.unmount();
+        });
+        expect(getHostFlowsHandle()).toBeNull();
+        el.remove();
+    });
+});
+describe('默认行为等价(回归)', () => {
+    it('placing 快照接线未运行时为 null', () => {
+        expect(getPlacingSnapshot()).toBeNull();
+    });
+});

package/dist/CameraPath.d.ts

@@ -0,0 +1,130 @@
+import { types as t } from '@dreamerbird/core';
+import type { ISheet, ISheetObject } from '@dreamerbird/core';
+import React from 'react';
+import { Vector3 } from 'three';
+import './i18n';
+import type { PathPointEntry, Vec3Like } from './pathModel';
+/**
+ * 运镜路径:一条可编辑的空间曲线(机位用,同一个组件将来可复用)。
+ * 模型对齐 Blender 的曲线对象:
+ *
+ * - 路径对象 = 变换(位置/旋转/缩放)+ 曲线(points:几何底账,隐藏)
+ *   + 行进(progress:0~1 行进进度,可见可打关键帧)三部分——对齐
+ *   Blender:物体模式动变换(整体移动/旋转/缩放),曲线数据里除了几何
+ *   还有 Path Animation(Evaluation Time),行进节奏的家是曲线
+ * - 控制点是纯数据,存在 `${metaKey}` 对象的 points 文本属性里(JSON 底账,
+ *   勿手改),坐标是相对路径原点的局部坐标——不是 theatre 对象,不进大纲、
+ *   不上时间轴,编辑全部在视口里;世界位置 = 变换矩阵 × 局部坐标
+ * - 平时(对象模式)显示路径线(实线,普通蓝色);方向箭头(沿线小圆锥,
+ *   指向行进进度 0→1 的方向,Blender 曲线方向刻度的对应物)只在编辑
+ *   模式出现。选中路径(点线/大纲)线变黄、路径原点出现小黄标,挂整体
+ *   移动箭头、G 整体抓取(改的是路径的变换属性,点数据不动);右键路径线
+ *   或按 Tab 进入编辑模式:线变亮黄、控制点圆点出现,可点选、挂三轴箭头
+ *   沿轴精拖,
+ *   或按 G 进入 Blender 式模态抓取:点跟随鼠标(视图平面),X/Y/Z 锁轴,
+ *   左键/回车确认,右键/Esc 取消
+ * - 选中的控制点显示贝塞尔手柄(小圆点+连线):按住小圆点直接拖;
+ *   默认自动(平滑穿过),拖动后转手动,两手柄方向共线(Blender 的"对齐");
+ *   App 层另有数值浮条(显示的是局部坐标);点级增删在编辑浮条
+ *   (PathEditBar:加点/删除选中点),不进全局菜单。
+ *   控制点/手柄都是屏幕恒定大小的实心标记(深度测试关掉、画在最上层),
+ *   对齐 Blender 的屏幕空间编辑 UI:任何缩放级别下同样清晰、同样好点
+ * - 拖动/增删都是一次 scrub 提交 = 一步撤销;镜头视角下整体隐藏
+ */
+export declare const POS_PATH_KEY = "Pos Path";
+/** 路径的显示名(目前只有机位路径一条;菜单/浮条里展示用) */
+export declare function pathLabel(metaKey: string): string;
+/** 路径对象自己的名字(大纲里显示的那个,如 "Pos Path"):取名单键
+ *  的最后一段。给"选目标"类的下拉用——选项显示对象真名,不是功能标签 */
+export declare function pathObjectName(metaKey: string): string;
+type PathMetaConfig = {
+    points: ReturnType<typeof t.string>;
+    progress: ReturnType<typeof t.number>;
+    position: ReturnType<typeof t.compound>;
+    rotation: ReturnType<typeof t.compound>;
+    scale: ReturnType<typeof t.compound>;
+};
+/**
+ * 路径对象 = 变换(位置/旋转/缩放,对齐 Blender 物体模式的对象变换,
+ * 可打关键帧 = 整条路径的动画)+ 曲线(points:几何底账,隐藏)
+ * + 行进(progress:0~1 行进进度,对齐曲线侧的 Evaluation Time,
+ * 行进节奏的家是曲线,不是跟随者)三部分。
+ *
+ * 控制点是相对路径原点的局部坐标;默认变换是单位阵,老场景的点
+ * (原本就是世界坐标)无缝过渡。
+ */
+export declare function getPathMeta(sheet: ISheet, metaKey: string): ISheetObject<PathMetaConfig>;
+/**
+ * 路径对象是否存在(只探测,不创建):走内部对象表——sheet.object
+ * 查不存在就会顺手创建,那是"没点就不出现"要躲开的
+ */
+export declare function pathExists(sheet: ISheet, metaKey: string): boolean;
+/** 响应式存在性:订阅内部对象表,任何途径增删对象都会触发。
+ *  返回渲染期直读的实时值(state 只负责触发重渲染)——
+ *  key 切换时不存在"上一 key 的过期存在性"窗口 */
+export declare function usePathExists(sheet: ISheet, metaKey: string): boolean;
+/**
+ * 响应式:路径是否有控制点。对象不存在(未注册/已删除)时算没有,
+ * 绝不顺手创建——创建只发生在注册表加行后的组件挂载。
+ * 空路径时驱动自动回退手动(见 ShotCamera),相机仍可拖;
+ * ShotCamera 用它决定要不要锁掉移动箭头
+ */
+export declare function usePathHasPoints(sheet: ISheet, metaKey: string): boolean;
+/**
+ * 按进度在路径上取点(世界坐标):锚点分段取局部点(进度落在哪两个点的
+ * 锚点之间,就在那段贝塞尔里按弧长取点;锚点全自动时 = 全程弧长等比),
+ * 再乘路径的整体变换矩阵。路径为空返回 false,调用方回退到手动驱动;
+ * 单点路径任何进度都取那个点。
+ */
+export declare function samplePathPoint(metaKey: string, u: number, out: Vector3): boolean;
+/**
+ * 加一个控制点:路径为空时用 seed 播种(机位路径=绕目标的弧),
+ * 否则沿最后一段方向延伸。seed 为空且名单为空时不动作。
+ *
+ * seed 给的是世界坐标(从相机/目标的当前位置算出来),控制点存的是
+ * 局部坐标——按路径当前变换的逆矩阵换算;变换是单位阵时两者相等。
+ *
+ * onSeeded:路径从无到有(播种)时,在同一次提交里顺带写入(比如
+ * 自动把驱动切到"沿路径"——Blender 的约束加上即生效,不存在
+ * "路径建好了却还停在手动"的中间态)。撤销一次 = 点和模式一起回退
+ */
+export declare function addPathPoint(sheet: ISheet, metaKey: string, seed: Vec3Like[] | undefined, onSeeded?: (set: (prop: any, value: any) => void) => void): void;
+/** 删掉指定控制点。点不在名单里返回 false,调用方提示 */
+export declare function deletePathPoint(sheet: ISheet, metaKey: string, pointKey: string): boolean;
+/** 直接读一次名单(菜单动作用;不是响应式,组件里要响应式用 usePathHasPoints) */
+export declare function readPathPoints(sheet: ISheet, metaKey: string): PathPointEntry[];
+export declare function CameraPath({ metaKey, color, hidden, editing, selectedKey, onSelectPoint, onContextMenu, progressOf, }: {
+    metaKey: string;
+    color: number;
+    /** true = 镜头视角:路径是调度工具,入镜没意义 */
+    hidden: boolean;
+    /** true = 编辑模式:控制点/手柄出现,可点可拖 */
+    editing: boolean;
+    /** App 管的选中控制点(跨两条路径全局唯一) */
+    selectedKey: string | null;
+    onSelectPoint: (key: string | null) => void;
+    /** 右键路径线:弹编辑模式菜单 */
+    onContextMenu: (metaKey: string, x: number, y: number) => void;
+    /** 读当前进度(0~1),给进度标记用;来源是 Shot Camera 的进度属性 */
+    progressOf: () => number;
+}): React.JSX.Element;
+export declare function PathEditBar({ hasSelection, onAddPoint, onDeleteSelected, }: {
+    hasSelection: boolean;
+    onAddPoint: () => void;
+    onDeleteSelected: () => void;
+}): React.JSX.Element;
+/** 一次输入提交 = 一步撤销;非法输入直接丢弃回显当前值 */
+export declare function PathPointEditor({ sheet, metaKey, pointKey, onPinAtPlayhead, progressKeyframes, }: {
+    sheet: ISheet;
+    metaKey: string;
+    pointKey: string;
+    /** 钉到播放头:给行进进度打一个值=锚点的关键帧(抵达时间上时间轴) */
+    onPinAtPlayhead?: (u: number) => void;
+    /** 行进进度轨道的关键帧(时刻秒 + 进度值),列出"这个点钉在了哪些时间"用 */
+    progressKeyframes?: readonly {
+        position: number;
+        value: number;
+    }[];
+}): React.JSX.Element | null;
+export {};
+//# sourceMappingURL=CameraPath.d.ts.map

package/dist/CameraPath.d.ts.map

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