@dreamerbird/camera-studio 0.1.0 → 0.3.0

package/dist/bootstrap.test.js

@@ -31,11 +31,13 @@ const initSpy = jest.fn(async (_opts) => { });
 const fakeSheet = { fakeSheet: true };
 const getProjectSpy = jest.fn((_name, _opts) => ({
     fake: true,
+    address: { projectId: _name },
     sheet: jest.fn(() => fakeSheet),
 }));
 // studio.ui 替身:hide/restore 翻转 isHidden(与真 UI 行为一致;
 // bootstrap 仅在 isHidden 时才 restore)
 const setLeftStripHiddenSpy = jest.fn();
+const setPanelVisibilitySpy = jest.fn();
 const uiBox = {
     isHidden: false,
     hide: jest.fn(() => {
@@ -45,6 +47,7 @@ const uiBox = {
         uiBox.isHidden = false;
     }),
     setLeftStripHidden: setLeftStripHiddenSpy,
+    setPanelVisibility: setPanelVisibilitySpy,
 };
 const hideSpy = uiBox.hide;
 const restoreSpy = uiBox.restore;
@@ -103,6 +106,11 @@ initSpy.mockImplementation(async (opts) => {
 jest.doMock('@dreamerbird/studio', () => ({
     __esModule: true,
 }));
+jest.doMock('@dreamerbird/studio/UI/UINonSSRBits', () => ({
+    __esModule: true,
+    default: class {
+    },
+}));
 jest.doMock('@dreamerbird/core', () => ({
     __esModule: true,
     default: { init: initSpy },
@@ -158,6 +166,7 @@ beforeEach(async () => {
     uiBox.isHidden = false;
     initializedBox.promise = Promise.resolve();
     setLeftStripHiddenSpy.mockClear();
+    setPanelVisibilitySpy.mockClear();
     getStudioSyncSpy.mockClear();
     activateApiSpy.mockClear();
     disposeApiSpy.mockClear();
@@ -645,3 +654,105 @@ test('14. ui.hideLeftStrip → boot 经 studio.ui.setLeftStripHidden(true) 应
     expect(setLeftStripHiddenSpy).toHaveBeenCalledWith(true);
     await h.unmount();
 });
+test('flushState emits the pending throttled state exactly once', async () => {
+    let resolveState;
+    const onStateChange = jest.fn(() => new Promise((resolve) => {
+        resolveState = resolve;
+    }));
+    const h = hookHost({ state: { onStateChange, throttleMs: 60000 } });
+    await h.mount();
+    const historicCallback = onChangeSpy.mock.calls[1][1];
+    historicCallback({ rev: 1 });
+    let flushed = false;
+    const firstFlush = h.result.current.flushState().then(() => {
+        flushed = true;
+    });
+    await Promise.resolve();
+    expect(onStateChange).toHaveBeenCalledTimes(1);
+    expect(onStateChange).toHaveBeenCalledWith({ rev: 1 });
+    expect(flushed).toBe(false);
+    resolveState();
+    await firstFlush;
+    await h.result.current.flushState();
+    expect(onStateChange).toHaveBeenCalledTimes(1);
+    await h.unmount();
+});
+test('ui.panels hides only the requested panel without changing timeline visibility', async () => {
+    const h = hookHost({ ui: { panels: { outline: false, details: true } } });
+    await h.mount();
+    await flush();
+    expect(setPanelVisibilitySpy).toHaveBeenCalledWith({
+        outline: false,
+        details: true,
+    });
+    expect(hideSpy).not.toHaveBeenCalled();
+    expect(restoreSpy).not.toHaveBeenCalled();
+    const [{ default: UI }, { Atom, val }] = await Promise.all([
+        import('@dreamerbird/studio/UI/UI'),
+        import('@dreamerbird/dataverse'),
+    ]);
+    const studio = {
+        ephemeralAtom: new Atom({}),
+        atomP: { ahistoric: { visibilityState: 'everythingIsVisible' } },
+    };
+    UI.prototype.setPanelVisibility.call({ studio }, {
+        outline: false,
+        details: true,
+    });
+    expect(val(studio.ephemeralAtom.pointer.hiddenPanels)).toEqual({
+        outline: true,
+        details: false,
+    });
+    expect(studio.atomP.ahistoric.visibilityState).toBe('everythingIsVisible');
+    await h.unmount();
+});
+test('resetCameraStudio clears retained project/state config across A→B→A remounts', async () => {
+    const stateA = { objects: { a: { position: [1, 0, 0] } } };
+    const stateB = { objects: { b: { position: [2, 0, 0] } } };
+    const stateA2 = { objects: { a2: { position: [3, 0, 0] } } };
+    const onA = jest.fn();
+    const onB = jest.fn();
+    const onA2 = jest.fn();
+    const a = hookHost({
+        project: 'SceneA',
+        storage: false,
+        state: { initialState: stateA, onStateChange: onA },
+    });
+    await a.mount();
+    const projectA = a.result.current?.sceneProps.project;
+    expect(projectA).toBeDefined();
+    await a.unmount();
+    await bootstrap.resetCameraStudio();
+    const b = hookHost({
+        project: 'SceneB',
+        storage: false,
+        state: { initialState: stateB, onStateChange: onB },
+    });
+    await b.mount();
+    expect(b.result.current?.sceneProps.project).not.toBe(projectA);
+    const projectB = b.result.current?.sceneProps.project;
+    const stateCallbackB = onChangeSpy.mock.calls.at(-1)?.[1];
+    stateCallbackB({ scene: 'B' });
+    await b.result.current.flushState();
+    expect(onB).toHaveBeenCalledWith({ scene: 'B' });
+    expect(onA).not.toHaveBeenCalled();
+    await b.unmount();
+    await bootstrap.resetCameraStudio();
+    const a2 = hookHost({
+        project: 'SceneA',
+        storage: false,
+        state: { initialState: stateA2, onStateChange: onA2 },
+    });
+    await a2.mount();
+    expect(a2.result.current?.sceneProps.project).not.toBe(projectA);
+    expect(a2.result.current?.sceneProps.project).not.toBe(projectB);
+    const stateCallbackA2 = onChangeSpy.mock.calls.at(-1)?.[1];
+    stateCallbackA2({ scene: 'A2' });
+    await a2.result.current.flushState();
+    expect(onA2).toHaveBeenCalledWith({ scene: 'A2' });
+    expect(onB).toHaveBeenCalledTimes(1);
+    await a2.unmount();
+    expect(getProjectSpy).toHaveBeenCalledWith('SceneA', { state: stateA });
+    expect(getProjectSpy).toHaveBeenCalledWith('SceneB', { state: stateB });
+    expect(getProjectSpy).toHaveBeenCalledWith('SceneA', { state: stateA2 });
+});

package/dist/config.d.ts

@@ -4,7 +4,7 @@
  * CameraFlows 类型取自 ./hostFlows(定义所在);简报草样写 './App',
  * 但 App.tsx 只默认导出组件、不转出口该类型,从定义处引入才编译得过。
  */
-import type { IProject } from '@dreamerbird/core';
+import type { IProject, StudioPanelVisibility } from '@dreamerbird/core';
 import type { WritableLibrarySource } from './assetLibrary/source';
 import type { CameraStudioErrorHandler } from './errors';
 import type { CameraFlows } from './hostFlows';
@@ -60,12 +60,19 @@ export interface CameraStudioConfig {
     sync?: {
         serverUrl?: string;
     } | false;
+    scene?: {
+        /** 是否渲染内置 Thingy 演示模型;缺省 true */
+        includeDemoModel?: boolean;
+    };
     ui?: {
         portalContainer?: HTMLElement;
         zIndexBase?: number;
         locale?: string;
         /** 隐藏 studio 左上角带 logo 的整条 LeftStrip(应用 logo + 工作区按钮) */
         hideLeftStrip?: boolean;
+        panels?: StudioPanelVisibility;
+        /** Scene Tree 顶部项目节点的显示名;不改变持久化 projectId */
+        projectName?: string;
     };
     flows?: {
         onFlows?: (flows: CameraFlows) => void;
@@ -78,6 +85,7 @@ export type CameraSceneProps = {
     project: IProject;
     onFlows?: (flows: CameraFlows) => void;
     onError?: CameraStudioErrorHandler;
+    includeDemoModel?: boolean;
 };
 export interface CameraStudioHandle {
     ready: boolean;
@@ -88,5 +96,6 @@ export interface CameraStudioHandle {
      * 同一对象);`api.ready` 在 project+studio+Scene Runtime 就位后兑现
      */
     api: CameraStudioApi;
+    flushState(): Promise<void>;
 }
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAC,QAAQ,EAAC,MAAM,mBAAmB,CAAA;AAC/C,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,uBAAuB,CAAA;AAChE,OAAO,KAAK,EAAC,wBAAwB,EAAC,MAAM,UAAU,CAAA;AACtD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,aAAa,CAAA;AAC5C,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,aAAa,CAAA;AAEhD;;;;GAIG;AACH,MAAM,MAAM,6BAA6B,GAAG;IAC1C,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAA;IACX;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAA;IACb,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,kDAAkD;AAClD,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,6BAA6B,CAAA;CACvC,CAAA;AAED,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;IAC3B,kCAAkC;IAClC,KAAK,CAAC,EAAE;QACN,YAAY,CAAC,EAAE,OAAO,CAAA;QACtB,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;QAC1C,iDAAiD;QACjD,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB,CAAA;IACD,8CAA8C;IAC9C,OAAO,CAAC,EAAE,wBAAwB,CAAA;IAClC;4DACwD;IACxD,OAAO,CAAC,EAAE,qBAAqB,GAAG;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,KAAK,CAAA;IAC9D,0BAA0B;IAC1B,MAAM,CAAC,EAAE;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAC,CAAA;IAC3B,uBAAuB;IACvB,IAAI,CAAC,EAAE;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,KAAK,CAAA;IACnC,EAAE,CAAC,EAAE;QACH,eAAe,CAAC,EAAE,WAAW,CAAA;QAC7B,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,yDAAyD;QACzD,aAAa,CAAC,EAAE,OAAO,CAAA;KACxB,CAAA;IACD,KAAK,CAAC,EAAE;QAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;KAAC,CAAA;IAChD,uCAAuC;IACvC,KAAK,CAAC,EAAE,uBAAuB,CAAA;CAChC;AAED,iDAAiD;AACjD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,QAAQ,CAAA;IACjB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;IACtC,OAAO,CAAC,EAAE,wBAAwB,CAAA;CACnC,CAAA;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,EAAE,KAAK,GAAG,SAAS,CAAA;IACxB,UAAU,EAAE,gBAAgB,CAAA;IAC5B;;;OAGG;IACH,GAAG,EAAE,eAAe,CAAA;CACrB"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAC,QAAQ,EAAE,qBAAqB,EAAC,MAAM,mBAAmB,CAAA;AACtE,OAAO,KAAK,EAAC,qBAAqB,EAAC,MAAM,uBAAuB,CAAA;AAChE,OAAO,KAAK,EAAC,wBAAwB,EAAC,MAAM,UAAU,CAAA;AACtD,OAAO,KAAK,EAAC,WAAW,EAAC,MAAM,aAAa,CAAA;AAC5C,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,aAAa,CAAA;AAEhD;;;;GAIG;AACH,MAAM,MAAM,6BAA6B,GAAG;IAC1C,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAA;IACX;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAA;IACb,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,kDAAkD;AAClD,MAAM,MAAM,uBAAuB,GAAG;IACpC;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,8BAA8B;IAC9B,MAAM,CAAC,EAAE,6BAA6B,CAAA;CACvC,CAAA;AAED,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;IAC3B,kCAAkC;IAClC,KAAK,CAAC,EAAE;QACN,YAAY,CAAC,EAAE,OAAO,CAAA;QACtB,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;QAC1C,iDAAiD;QACjD,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB,CAAA;IACD,8CAA8C;IAC9C,OAAO,CAAC,EAAE,wBAAwB,CAAA;IAClC;4DACwD;IACxD,OAAO,CAAC,EAAE,qBAAqB,GAAG;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,KAAK,CAAA;IAC9D,0BAA0B;IAC1B,MAAM,CAAC,EAAE;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAC,CAAA;IAC3B,uBAAuB;IACvB,IAAI,CAAC,EAAE;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAC,GAAG,KAAK,CAAA;IACnC,KAAK,CAAC,EAAE;QACN,iCAAiC;QACjC,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAC3B,CAAA;IACD,EAAE,CAAC,EAAE;QACH,eAAe,CAAC,EAAE,WAAW,CAAA;QAC7B,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,yDAAyD;QACzD,aAAa,CAAC,EAAE,OAAO,CAAA;QACvB,MAAM,CAAC,EAAE,qBAAqB,CAAA;QAC9B,6CAA6C;QAC7C,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,CAAA;IACD,KAAK,CAAC,EAAE;QAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;KAAC,CAAA;IAChD,uCAAuC;IACvC,KAAK,CAAC,EAAE,uBAAuB,CAAA;CAChC;AAED,iDAAiD;AACjD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,QAAQ,CAAA;IACjB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAA;IACtC,OAAO,CAAC,EAAE,wBAAwB,CAAA;IAClC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B,CAAA;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,EAAE,KAAK,GAAG,SAAS,CAAA;IACxB,UAAU,EAAE,gBAAgB,CAAA;IAC5B;;;OAGG;IACH,GAAG,EAAE,eAAe,CAAA;IACpB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5B"}

package/dist/firstScreenGate.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 首屏就绪闸门(2026-10-22):聚合「工程就绪 + 首批场景资源加载落定」,
+ * 就绪前 CameraScene 盖加载遮罩——此前顶栏/轴向控制器等同步部件首帧就画,
+ * 模型和面板走各自异步(Suspense fallback=null / 库加载)settled 才补,
+ * 开场观感参差。闸门只闸首屏:落定一次后,后续放置/加载不再触发遮盖。
+ *
+ * 模块级单值通路(与 getLibrary/poseSession 同风格):CameraScene 创建并
+ * 安装;PlacementManager 各层经 getFirstScreenGate() 上报,免层层传 prop;
+ * 未安装时返回 no-op(测试或宿主绕过 CameraScene 直用 PlacementManager 不炸)。
+ */
+export interface FirstScreenGate {
+    /** 工程就绪(useProjectReady 变真时调;幂等) */
+    setProjectReady(): void;
+    /** 登记一个首屏要等的资源;已落定过的 key 不重复登记(清单重扫防回加) */
+    expect(key: string): void;
+    /** 上报一个资源落定(加载成功或失败都算;未登记的 key 忽略) */
+    settle(key: string): void;
+    /** 落定后 expect/settle 全是 no-op */
+    readonly fired: boolean;
+}
+export declare const FIRST_SCREEN_TIMEOUT_MS = 15000;
+export declare function createFirstScreenGate(onReady: () => void, timeoutMs?: number, warn?: (msg: string) => void): FirstScreenGate;
+/** CameraScene 装配期调用(必须在子树 effect 之前,见调用点注释) */
+export declare function installFirstScreenGate(gate: FirstScreenGate): void;
+export declare function getFirstScreenGate(): FirstScreenGate;
+/** CameraScene 卸载/测试复位用 */
+export declare function resetFirstScreenGate(): void;
+//# sourceMappingURL=firstScreenGate.d.ts.map

package/dist/firstScreenGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firstScreenGate.d.ts","sourceRoot":"","sources":["../src/firstScreenGate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,eAAe,IAAI,IAAI,CAAA;IACvB,2CAA2C;IAC3C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,sCAAsC;IACtC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB;AAED,eAAO,MAAM,uBAAuB,QAAQ,CAAA;AAE5C,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,IAAI,EACnB,SAAS,GAAE,MAAgC,EAC3C,IAAI,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAmB,GACzC,eAAe,CA8CjB;AAYD,gDAAgD;AAChD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAElE;AAED,wBAAgB,kBAAkB,IAAI,eAAe,CAEpD;AAED,2BAA2B;AAC3B,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C"}

package/dist/firstScreenGate.js

@@ -0,0 +1,67 @@
+export const FIRST_SCREEN_TIMEOUT_MS = 15000;
+export function createFirstScreenGate(onReady, timeoutMs = FIRST_SCREEN_TIMEOUT_MS, warn = console.warn) {
+    const pending = new Set();
+    const settled = new Set();
+    let projectReady = false;
+    let fired = false;
+    // 兜底:某个资源悬挂(网络卡死等)不能让用户永远看遮罩,超时强制揭幕
+    const timer = setTimeout(() => {
+        warn(`[firstScreen] 首屏等待超过 ${timeoutMs}ms 强制揭幕(未落定:${[...pending].join(', ') || '无'};工程就绪:${projectReady})`);
+        fire();
+    }, timeoutMs);
+    // Node 的 Timeout 才有 unref(浏览器返回 number):防测试进程被计时器挂住
+    if (typeof timer === 'object' && typeof timer.unref === 'function') {
+        timer.unref();
+    }
+    function fire() {
+        if (fired)
+            return;
+        fired = true;
+        clearTimeout(timer);
+        onReady();
+    }
+    function check() {
+        if (projectReady && pending.size === 0)
+            fire();
+    }
+    return {
+        get fired() {
+            return fired;
+        },
+        setProjectReady() {
+            projectReady = true;
+            check();
+        },
+        expect(key) {
+            if (fired || settled.has(key))
+                return;
+            pending.add(key);
+        },
+        settle(key) {
+            if (fired || !pending.has(key))
+                return;
+            pending.delete(key);
+            settled.add(key);
+            check();
+        },
+    };
+}
+/** 未安装时的默认闸门:fired=true 的 no-op,上报全部吞掉 */
+const noopGate = {
+    fired: true,
+    setProjectReady() { },
+    expect() { },
+    settle() { },
+};
+let current = noopGate;
+/** CameraScene 装配期调用(必须在子树 effect 之前,见调用点注释) */
+export function installFirstScreenGate(gate) {
+    current = gate;
+}
+export function getFirstScreenGate() {
+    return current;
+}
+/** CameraScene 卸载/测试复位用 */
+export function resetFirstScreenGate() {
+    current = noopGate;
+}

package/dist/firstScreenGate.test.d.ts

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

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

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

package/dist/firstScreenGate.test.js

@@ -0,0 +1,83 @@
+import { createFirstScreenGate } from './firstScreenGate';
+describe('createFirstScreenGate', () => {
+    it('工程就绪且无可等资源 → 立即落定', () => {
+        const onReady = jest.fn();
+        const gate = createFirstScreenGate(onReady);
+        expect(onReady).not.toHaveBeenCalled();
+        gate.setProjectReady();
+        expect(onReady).toHaveBeenCalledTimes(1);
+        expect(gate.fired).toBe(true);
+    });
+    it('有待载资源:全部 settle 且工程就绪才落定(先载完后就绪也成立)', () => {
+        const onReady = jest.fn();
+        const gate = createFirstScreenGate(onReady);
+        gate.expect('a');
+        gate.expect('b');
+        gate.settle('a');
+        gate.settle('b');
+        expect(onReady).not.toHaveBeenCalled(); // 工程未就绪
+        gate.setProjectReady();
+        expect(onReady).toHaveBeenCalledTimes(1);
+    });
+    it('部分 settle 不落定', () => {
+        const onReady = jest.fn();
+        const gate = createFirstScreenGate(onReady);
+        gate.expect('a');
+        gate.expect('b');
+        gate.setProjectReady();
+        gate.settle('a');
+        expect(onReady).not.toHaveBeenCalled();
+        gate.settle('b');
+        expect(onReady).toHaveBeenCalledTimes(1);
+    });
+    it('未登记的 settle 被忽略,不影响计数', () => {
+        const onReady = jest.fn();
+        const gate = createFirstScreenGate(onReady);
+        gate.expect('a');
+        gate.settle('陌生人');
+        gate.setProjectReady();
+        expect(onReady).not.toHaveBeenCalled();
+        gate.settle('a');
+        expect(onReady).toHaveBeenCalledTimes(1);
+    });
+    it('已落定的 key 再 expect 不回加(放置清单重扫场景)', () => {
+        const onReady = jest.fn();
+        const gate = createFirstScreenGate(onReady);
+        gate.expect('a');
+        gate.setProjectReady();
+        gate.settle('a');
+        expect(onReady).toHaveBeenCalledTimes(1);
+        // 清单重扫又把 a 登记一遍 + 新条目 b —— 闸门已落定,全部忽略
+        gate.expect('a');
+        gate.expect('b');
+        expect(onReady).toHaveBeenCalledTimes(1);
+    });
+    it('落定只触发一次(setProjectReady/settle 重复调用幂等)', () => {
+        const onReady = jest.fn();
+        const gate = createFirstScreenGate(onReady);
+        gate.setProjectReady();
+        gate.setProjectReady();
+        gate.settle('从未登记');
+        expect(onReady).toHaveBeenCalledTimes(1);
+    });
+    it('超时强制揭幕并告警,之后不再重复触发', () => {
+        jest.useFakeTimers();
+        try {
+            const onReady = jest.fn();
+            const warn = jest.fn();
+            const gate = createFirstScreenGate(onReady, 5000, warn);
+            gate.expect('卡住的模型');
+            jest.advanceTimersByTime(5000);
+            expect(warn).toHaveBeenCalledTimes(1);
+            expect(warn.mock.calls[0][0]).toContain('卡住的模型');
+            expect(onReady).toHaveBeenCalledTimes(1);
+            // 超时后迟到的 settle 不再触发
+            gate.settle('卡住的模型');
+            jest.advanceTimersByTime(10000);
+            expect(onReady).toHaveBeenCalledTimes(1);
+        }
+        finally {
+            jest.useRealTimers();
+        }
+    });
+});

package/dist/hostFlows.d.ts

@@ -32,6 +32,7 @@ export type DropPointContext = {
     camera: Camera;
 };
 export declare function setDropPointContext(ctx: DropPointContext | null): void;
+export declare function isDropPointInsideCanvas(clientX: number, clientY: number): boolean;
 export declare function dropPointFromClient(clientX: number, clientY: number): Vec3 | null;
 /**
  * App 用既有函数注入组装 CameraFlows;纯转发,可单测。

package/dist/hostFlows.d.ts.map

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

package/dist/hostFlows.js

@@ -46,6 +46,15 @@ let dropCtx = null;
 export function setDropPointContext(ctx) {
     dropCtx = ctx;
 }
+export function isDropPointInsideCanvas(clientX, clientY) {
+    if (!dropCtx)
+        return false;
+    const rect = dropCtx.gl.domElement.getBoundingClientRect();
+    return (clientX >= rect.left &&
+        clientX <= rect.right &&
+        clientY >= rect.top &&
+        clientY <= rect.bottom);
+}
 export function dropPointFromClient(clientX, clientY) {
     if (!dropCtx)
         return null;

package/dist/index.d.ts

@@ -6,7 +6,7 @@ export type { CameraStudioConfig, CameraStudioHandle, CameraSceneProps, CameraSt
 export type { CameraFlows, Vec3 } from './hostFlows';
 export type { PathPreset } from './pathPresets';
 export type { CameraStudioError, CameraStudioErrorHandler, CameraStudioErrorSource, } from './errors';
-export { initCameraStudio, disposeCameraStudio } from './bootstrap';
+export { initCameraStudio, disposeCameraStudio, resetCameraStudio, } from './bootstrap';
 export type { BootCtx } from './bootstrap';
 export type { CameraStudioApi } from './agent/api';
 export { AgentApiError, AGENT_API_ERROR_CODES } from './agent/errors';
@@ -16,6 +16,10 @@ export type { SceneObjectId, SceneObjectKind, JobSnapshot, JobState, AgentErrorD
 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 { PrimitivesApi } from './agent/commands/primitives';
+export type { PrimitiveKind } from './primitives';
+export type { MaterialsApi } from './agent/commands/materials';
+export type { MaterialSlot, MaterialValues } from './materials/types';
 export type { AssetsApi } from './agent/commands/assets';
 export type { PosesApi, PosesSessionApi } from './agent/commands/poses';
 export type { AnimationsApi, AnimationStatusDto, } from './agent/commands/animations';
@@ -35,8 +39,13 @@ export type { GizmoMode } from './PlacementManager';
 export type { PoseBones } from './poseMode/poseOverride';
 export type { GestureSide } from './gestureProps';
 export type { PoseFrameMode } from './poseMode/poseFrame';
+export { BUILTIN_POSE_RIG, BUILTIN_POSE_SOURCES, listBuiltinPoses, getBuiltinPose, applyPose, capturePose, captureBindPose, } from './poses';
+export type { BuiltinPoseSourceId } from './poses';
 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';
+export { importModelFiles } from './assetLibrary/importModelFiles';
+export { registerModelPicker, unregisterModelPicker } from './pickerRegistry';
+export type { ModelPickerProps } from './pickerRegistry';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -5,7 +5,12 @@ export { CameraScene } from './CameraScene';
 export { CAMERA_STUDIO_VERSION } from './version';
 export { useCameraStudio } from './useCameraStudio';
 // 测试与高级宿主可用:绕过 hook 直接管 init/dispose 生命周期
-export { initCameraStudio, disposeCameraStudio } from './bootstrap';
+export { initCameraStudio, disposeCameraStudio, resetCameraStudio, } from './bootstrap';
 export { AgentApiError, AGENT_API_ERROR_CODES } from './agent/errors';
+// 内置静态姿势库:引用本包的项目可直接取姿势数据并应用到自己的骨架,
+// 不必先启动编辑器。轻量消费可走 `@dreamerbird/camera-studio/poses` 子路径
+export { BUILTIN_POSE_RIG, BUILTIN_POSE_SOURCES, listBuiltinPoses, getBuiltinPose, applyPose, capturePose, captureBindPose, } from './poses';
 export { LibraryError, isWritableSource } from './assetLibrary/source';
 export { IndexedDBBackend } from './assetLibrary/indexedDBBackend';
+export { importModelFiles } from './assetLibrary/importModelFiles';
+export { registerModelPicker, unregisterModelPicker } from './pickerRegistry';

package/dist/materials/modelMaterials.d.ts

@@ -0,0 +1,19 @@
+import { type Texture, type Object3D } from 'three';
+import type { MaterialSlot, MaterialValues } from './types';
+type MaterialOverrides = Record<string, Partial<MaterialValues>>;
+export declare function cloneModelMaterials(root: Object3D): void;
+export declare function collectMaterialSlots(root: Object3D): MaterialSlot[];
+export declare function applyMaterialScalars(root: Object3D, slots: MaterialSlot[], overrides: MaterialOverrides): void;
+export declare function createMaterialOverridesConfig(slots: MaterialSlot[]): any;
+type TextureControllerOptions = {
+    getBlobUrl(blobId: string): Promise<string>;
+    loadTexture(url: string): Promise<Texture>;
+    onError?(error: unknown, slotId: string, property: string): void;
+    invalidate(): void;
+};
+export declare function createMaterialTextureController(options: TextureControllerOptions): {
+    update(root: Object3D, slots: MaterialSlot[], overrides: MaterialOverrides): Promise<void>;
+    dispose(): void;
+};
+export {};
+//# sourceMappingURL=modelMaterials.d.ts.map

package/dist/materials/modelMaterials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"modelMaterials.d.ts","sourceRoot":"","sources":["../../src/materials/modelMaterials.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,OAAO,EAEZ,KAAK,QAAQ,EACd,MAAM,OAAO,CAAA;AACd,OAAO,KAAK,EAAC,YAAY,EAAE,cAAc,EAAC,MAAM,SAAS,CAAA;AAWzD,KAAK,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC,CAAA;AAyDhE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAYxD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,EAAE,CAuBnE;AAqBD,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,YAAY,EAAE,EACrB,SAAS,EAAE,iBAAiB,GAC3B,IAAI,CA+BN;AAiBD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,YAAY,EAAE,OAkBlE;AAED,KAAK,wBAAwB,GAAG;IAC9B,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAC3C,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAC1C,OAAO,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAChE,UAAU,IAAI,IAAI,CAAA;CACnB,CAAA;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,wBAAwB;iBAyDvB,QAAQ,SACP,YAAY,EAAE,aACV,iBAAiB,GAC3B,OAAO,CAAC,IAAI,CAAC;eA4BL,IAAI;EAWlB"}