@dreamerbird/camera-studio 0.2.0 → 0.3.0

package/dist/assetLibrary/library.js

@@ -238,7 +238,16 @@ export class Library {
         await this.enqueue(async () => {
             const writable = this.requireWritable();
             const blobId = await writable.putBlob(data);
-            await writable.putEntry(makeEntry(blobId));
+            try {
+                await writable.putEntry(makeEntry(blobId));
+            }
+            catch (error) {
+                const referenced = await this.referencedBlobIdsForRollback().catch(() => undefined);
+                if (referenced && !referenced.has(blobId)) {
+                    await writable.deleteBlob(blobId).catch(() => { });
+                }
+                throw error;
+            }
             this.emit();
         });
     }
@@ -265,6 +274,18 @@ export class Library {
         }
         return ids;
     }
+    async referencedBlobIdsForRollback() {
+        const catalogs = await Promise.all(this.sources.map((source) => source.listEntries()));
+        const ids = new Set();
+        for (const entry of catalogs.flat()) {
+            if ('blobId' in entry)
+                ids.add(entry.blobId);
+            if ('thumbnailId' in entry && entry.thumbnailId) {
+                ids.add(entry.thumbnailId);
+            }
+        }
+        return ids;
+    }
     /** 删条目并清理它的 blob;blob 被其他条目共享时保留 */
     async deleteEntryDeep(id) {
         await this.enqueue(async () => {

package/dist/assetLibrary/library.test.js

@@ -400,6 +400,82 @@ describe('骨架族别名并集读(终审 M-4)', () => {
     });
 });
 describe('blob 生命周期', () => {
+    test('putBlobWithEntry rolls back the upload when entry creation fails', async () => {
+        const backend = memoryBackend();
+        const failure = new Error('entry write failed');
+        backend.putEntry = async () => {
+            throw failure;
+        };
+        backend.deleteBlob = jest.fn(async () => { });
+        const lib = new Library({ sources: [backend] });
+        await expect(lib.putBlobWithEntry(new Blob(['model']), model)).rejects.toBe(failure);
+        expect(backend.deleteBlob).toHaveBeenCalledWith('blob-x');
+    });
+    test('putBlobWithEntry preserves a blob referenced by an existing entry after a later failure', async () => {
+        const backend = new IndexedDBBackend();
+        const lib = new Library({ sources: [backend] });
+        const bytes = new Blob(['shared-model-bytes']);
+        let sharedBlobId = '';
+        await lib.putBlobWithEntry(bytes, (blobId) => {
+            sharedBlobId = blobId;
+            return { ...model('shared-original'), blobId, contentHash: blobId };
+        });
+        const failure = new Error('second entry write failed');
+        backend.putEntry = async () => {
+            throw failure;
+        };
+        await expect(lib.putBlobWithEntry(bytes, (blobId) => ({
+            ...model('shared-second'),
+            blobId,
+            contentHash: blobId,
+        }))).rejects.toBe(failure);
+        expect(await lib.listBlobIds()).toContain(sharedBlobId);
+        expect(await lib.getEntry('shared-original')).toMatchObject({
+            blobId: sharedBlobId,
+        });
+    });
+    test('putBlobWithEntry preserves shared bytes and the original error when any source cannot be enumerated', async () => {
+        const backend = new IndexedDBBackend();
+        const sourceFailure = new Error('catalog source unavailable');
+        let sourceEntries = [];
+        let sourceUnavailable = false;
+        const unavailableSource = {
+            id: 'unavailable-source',
+            listEntries: async () => {
+                if (sourceUnavailable)
+                    throw sourceFailure;
+                return sourceEntries;
+            },
+            getEntry: async (id) => sourceEntries.find((entry) => entry.id === id),
+            getBlobUrl: async () => {
+                throw sourceFailure;
+            },
+        };
+        const lib = new Library({ sources: [backend, unavailableSource] });
+        const bytes = new Blob(['shared-partial-catalog-bytes']);
+        let sharedBlobId = '';
+        await lib.putBlobWithEntry(bytes, (blobId) => {
+            sharedBlobId = blobId;
+            return { ...model('shared-partial-original'), blobId, contentHash: blobId };
+        });
+        sourceEntries = [(await backend.getEntry('shared-partial-original'))];
+        await backend.deleteEntry('shared-partial-original');
+        sourceUnavailable = true;
+        const failure = new Error('partial catalog entry write failed');
+        backend.putEntry = async () => {
+            throw failure;
+        };
+        await expect(lib.putBlobWithEntry(bytes, (blobId) => ({
+            ...model('shared-partial-second'),
+            blobId,
+            contentHash: blobId,
+        }))).rejects.toBe(failure);
+        await expect(backend.getBlobUrl(sharedBlobId)).resolves.toBe('blob:mock-url');
+        expect(await unavailableSource.getEntry('shared-partial-original')).toMatchObject({
+            blobId: sharedBlobId,
+        });
+        await backend.deleteBlob(sharedBlobId);
+    });
     test('deleteEntryDeep: 缩略图被两个模型共享时,删一个不删 blob', async () => {
         const lib = new Library({ sources: [new IndexedDBBackend()] });
         const thumbId = await lib.putBlob(new Blob(['thumb']));

package/dist/bootstrap.d.ts

@@ -7,7 +7,7 @@ export interface BootCtx {
     library: Library;
     unregisterEditors: () => void;
     /** 节流通道手动 flush:dispose 时调用,尾部变更不丢 */
-    flushState: () => void;
+    flushState: () => Promise<void>;
     /**
      * 状态通道入口:生产由 project 历史指针订阅喂入,测试可直接调。
      * 尾部节流(缺省 1000ms)后转给 config.state.onStateChange。
@@ -34,4 +34,5 @@ export declare function isBootedWithDifferentConfig(config: CameraStudioConfig):
 export declare function getBootConfig(): CameraStudioConfig | undefined;
 export declare function initCameraStudio(config: CameraStudioConfig): Promise<BootCtx>;
 export declare function disposeCameraStudio(ctx?: BootCtx): Promise<void>;
+export declare function resetCameraStudio(): Promise<void>;
 //# sourceMappingURL=bootstrap.d.ts.map

package/dist/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAuBA,OAAO,qBAAqB,CAAA;AAO5B,OAAO,KAAK,EAAC,gBAAgB,EAAE,kBAAkB,EAAC,MAAM,UAAU,CAAA;AAKlE,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,wBAAwB,CAAA;AAmBnD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,aAAa,CAAA;AAOhD,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,kBAAkB,CAAA;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,iBAAiB,EAAE,MAAM,IAAI,CAAA;IAC7B,sCAAsC;IACtC,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB;;;OAGG;IACH,iBAAiB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IAC7C,UAAU,EAAE,gBAAgB,CAAA;IAC5B,uDAAuD;IACvD,GAAG,EAAE,eAAe,CAAA;CACrB;AAYD;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AACD,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AAqBD,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,kBAAkB,GACzB,gBAAgB,CAMlB;AA0CD;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAIT;AAED,0DAA0D;AAC1D,wBAAgB,aAAa,IAAI,kBAAkB,GAAG,SAAS,CAE9D;AA6QD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CA4B7E;AAED,wBAAsB,mBAAmB,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAMtE"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAwBA,OAAO,qBAAqB,CAAA;AAS5B,OAAO,KAAK,EAAC,gBAAgB,EAAE,kBAAkB,EAAC,MAAM,UAAU,CAAA;AAKlE,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,wBAAwB,CAAA;AAqBnD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,aAAa,CAAA;AAOhD,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,kBAAkB,CAAA;IAC1B,OAAO,EAAE,OAAO,CAAA;IAChB,iBAAiB,EAAE,MAAM,IAAI,CAAA;IAC7B,sCAAsC;IACtC,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/B;;;OAGG;IACH,iBAAiB,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IAC7C,UAAU,EAAE,gBAAgB,CAAA;IAC5B,uDAAuD;IACvD,GAAG,EAAE,eAAe,CAAA;CACrB;AAaD;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AACD,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AAuBD,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,kBAAkB,GACzB,gBAAgB,CASlB;AA0CD;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAIT;AAED,0DAA0D;AAC1D,wBAAgB,aAAa,IAAI,kBAAkB,GAAG,SAAS,CAE9D;AAoRD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CA6B7E;AAED,wBAAsB,mBAAmB,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAMtE;AAED,wBAAgB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CA4CjD"}

package/dist/bootstrap.js

@@ -5,7 +5,8 @@
  *
  * 生命周期分层(R14):
  * - boot 级(一次性,initPromise 保留):Library 单例、IDB 连接、词典、
- *   theatre.init、project 解析、节流机械。重挂幂等复用,dispose 不拆。
+ *   theatre.init、project 解析、节流机械。重挂幂等复用,dispose 不拆;
+ *   显式场景切换可在全部消费者卸载后经 resetCameraStudio 清空重 boot。
  * - 会话级(每次挂载 acquire,dispose 拆解):3 个自定义属性编辑器注册、
  *   state 通道订阅、studio.ui 显隐。picker 注册表与宿主句柄由各自模块
  *   自管(CameraScene 组件挂载时接线),这里不碰。
@@ -18,6 +19,8 @@ import theatre, { getProject, getStudio, getStudioSync, onChange, } from '@dream
 import '@dreamerbird/studio';
 import { initState } from '@dreamerbird/core/initState';
 import { privateAPI } from '@dreamerbird/core/privateAPIs';
+import projectsSingleton from '@dreamerbird/core/projects/projectsSingleton';
+import getStudioInternal from '@dreamerbird/studio/getStudio';
 import { registerCustomPropEditor, unregisterCustomPropEditor, } from '@dreamerbird/studio/propEditors/customPropEditors';
 import { cameraErrorFromLibrary, cameraErrorFromUnknown } from './errors';
 import { registerCameraMessages } from './i18n';
@@ -28,9 +31,11 @@ import { StaticCatalogSource } from './assetLibrary/staticCatalogSource';
 import { isWritableSource } from './assetLibrary/source';
 import { cleanupLegacySeeds } from './assetLibrary/legacySeedCleanup';
 import { setUiConfig } from './uiConfig';
+import { mountStudioRootWhenReady } from './studioRoot';
 import PosePropEditor from './poseMode/PosePropEditor';
 import { GesturePropEditorLeft, GesturePropEditorRight, } from './gesturePropsEditor';
 import { createAgentRuntime } from './agent/runtime';
+import { clearSceneSheetObjects } from './agent/runtime/objectRuntime';
 import { activateCameraStudioApi, disposeCameraStudioApi, getActiveAgentRegistry, getCameraStudioApi, } from './agent/api';
 import { createAgentBridgeClient } from './agent/bridgeClient';
 /** 内置 IDB 缺省库名(与现状一字不差,硬约束:老用户浏览器里的库零迁移) */
@@ -40,6 +45,7 @@ let initPromise;
 let bootConfig;
 /** 漂移告警只发一次(同页多次重挂不同 config 不刷屏) */
 let warnedConfigDrift = false;
+let resetPromise;
 /** 会话拆解函数;undefined = 当前无活跃会话(acquire 幂等守卫) */
 let sessionTeardown;
 /** 消费者计数由 hook 管(acquire/release 成对);dispose 据此做末位守卫 */
@@ -65,7 +71,12 @@ function resolveProject(config) {
     }
     const name = config.project ?? 'Space';
     const initialState = config.state?.initialState;
-    return getProject(name, initialState === undefined ? {} : { state: initialState });
+    return getProject(name, {
+        ...(initialState === undefined ? {} : { state: initialState }),
+        ...(config.ui?.projectName === undefined
+            ? {}
+            : { name: config.ui.projectName }),
+    });
 }
 /** sceneProps 同步解析(hook 首帧就要返回;getProject 渲染期调用安全,App 既有先例) */
 export function resolveSceneProps(config) {
@@ -73,6 +84,9 @@ export function resolveSceneProps(config) {
         project: resolveProject(config),
         onFlows: config.flows?.onFlows,
         onError: config.onError,
+        ...(config.scene?.includeDemoModel === undefined
+            ? {}
+            : { includeDemoModel: config.scene.includeDemoModel }),
     };
 }
 /** 参与漂移比对的顶层配置键(flows 回调引用每次渲染都新,不比) */
@@ -185,6 +199,13 @@ async function boot(config) {
     if (config.ui?.hideLeftStrip) {
         withStudioUi((ui) => ui.setLeftStripHidden(true));
     }
+    if (config.ui?.panels) {
+        const panels = config.ui.panels;
+        withStudioUi((ui) => ui.setPanelVisibility(panels));
+    }
+    withStudioUi(() => {
+        void mountStudioRootWhenReady(config.ui?.portalContainer);
+    });
     // 1. 数据源:可写源(若有) + 内置目录,聚合进 Library 单例
     const { sources, idbName } = resolveSources(config);
     const catalog = new StaticCatalogSource({
@@ -238,7 +259,7 @@ async function boot(config) {
     let pendingContent;
     let hasPending = false;
     let timer;
-    const flushState = () => {
+    const flushState = async () => {
         if (timer !== undefined) {
             clearTimeout(timer);
             timer = undefined;
@@ -248,7 +269,7 @@ async function boot(config) {
         hasPending = false;
         const content = pendingContent;
         pendingContent = undefined;
-        config.state?.onStateChange?.(content);
+        await config.state?.onStateChange?.(content);
     };
     const notifyStateChange = (content) => {
         if (!config.state?.onStateChange)
@@ -277,7 +298,7 @@ async function boot(config) {
 }
 /** studio.ui 显隐操作:studio 未挂载(宿主以 studio:false init 等)时静默降级 */
 function withStudioUi(fn) {
-    Promise.resolve()
+    return Promise.resolve()
         .then(() => getStudio())
         .then(async (studio) => {
         // 必须等 studio 初始化收尾(持久化/同步状态恢复落库)再读写显隐:
@@ -352,11 +373,13 @@ function acquireSession(ctx) {
         ctx.unregisterEditors();
         unsubState?.();
         // 先断订阅再 flush:尾部变更带给宿主,不丢
-        ctx.flushState();
-        withStudioUi((ui) => ui.hide());
+        await ctx.flushState();
+        await withStudioUi((ui) => ui.hide());
     };
 }
 export function initCameraStudio(config) {
+    if (resetPromise)
+        return resetPromise.then(() => initCameraStudio(config));
     if (!initPromise) {
         bootConfig = config;
         const p = boot(config);
@@ -392,3 +415,42 @@ export async function disposeCameraStudio(ctx) {
         return;
     await sessionTeardown?.();
 }
+export function resetCameraStudio() {
+    if (resetPromise)
+        return resetPromise;
+    const previousInit = initPromise;
+    resetPromise = (async () => {
+        if (activeConsumers > 0) {
+            throw new Error('resetCameraStudio requires all camera-studio consumers to be unmounted');
+        }
+        const previousCtx = previousInit
+            ? await previousInit.catch(() => undefined)
+            : undefined;
+        if (activeConsumers > 0) {
+            throw new Error('resetCameraStudio requires all camera-studio consumers to be unmounted');
+        }
+        await sessionTeardown?.();
+        clearSceneSheetObjects();
+        if (previousCtx) {
+            const projectId = previousCtx.sceneProps.project.address.projectId;
+            projectsSingleton.remove(projectId);
+            const studio = getStudioInternal();
+            if (studio) {
+                studio.transaction(({ stateEditors }) => {
+                    stateEditors.deleteProject({ projectId });
+                }, false);
+                studio.ephemeralAtom.reduceByPointer((p) => p.coreByProject, (projects) => {
+                    const next = { ...projects };
+                    delete next[projectId];
+                    return next;
+                });
+            }
+        }
+        initPromise = undefined;
+        bootConfig = undefined;
+        warnedConfigDrift = false;
+    })().finally(() => {
+        resetPromise = undefined;
+    });
+    return resetPromise;
+}

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/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":"AAQA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,sBAAsB,CAAA;AACpD,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,eAAe,CAAA;AAI7C,YAAY,EAAC,IAAI,EAAC,MAAM,eAAe,CAAA;AACvC,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,eAAe,CAAA;AAEvC,MAAM,MAAM,WAAW,GAAG;IACxB,8BAA8B;IAC9B,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,6BAA6B;IAC7B,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,CAAA;IAClD,kCAAkC;IAClC,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IAClD,SAAS,IAAI,IAAI,CAAA;IACjB,SAAS,IAAI,IAAI,CAAA;IACjB,aAAa,IAAI,IAAI,CAAA;IACrB,gCAAgC;IAChC,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IAC5C,oCAAoC;IACpC,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;CACnE,CAAA;AAID,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAE9D;AACD,wBAAgB,kBAAkB,IAAI,WAAW,GAAG,IAAI,CAEvD;AAKD,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAI/D;AACD,wBAAgB,kBAAkB,IAAI,YAAY,GAAG,IAAI,CAExD;AACD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAK1D;AACD,wBAAgB,UAAU,IAAI,YAAY,GAAG,IAAI,CAEhD;AAOD,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,OAAO,CAAA;AAIjC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,EAAE,EAAE;QAAC,UAAU,EAAE,WAAW,CAAA;KAAC,CAAA;IAC7B,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI,CAEtE;AACD,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GACd,IAAI,GAAG,IAAI,CAab;AAGD;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,uBAAuB,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7D,mBAAmB,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,KAAK,IAAI,CAAA;IAC7D,eAAe,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC,EAAE,IAAI,KAAK,IAAI,CAAA;IACxD,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,aAAa,EAAE,MAAM,IAAI,CAAA;IACzB,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;CACjD,CAAA;AACD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,YAAY,GAAG,WAAW,CAWxE;AAED,wCAAwC;AACxC,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,EAChC,WAAW,EAAE,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,KAAK,IAAI,EAC7C,IAAI,EAAE,OAAO,GAAG,MAAM,GACrB,MAAM,IAAI,CAKZ"}
+{"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"}