@crystaldesign/real-time-viewer-next 26.11.0-beta.18

package/build/esm/index.js

@@ -0,0 +1,32 @@
+export { E as ENVIRONMENT_CONFIG, W as WHITE_ROOM_PRESET, R as default, e as emitConfig, i as internals, u as useRTVStore } from './index-920dd901.js';
+import 'react';
+import '@react-three/fiber';
+import 'three';
+import '@crystaldesign/diva-core';
+import '@babel/runtime/helpers/slicedToArray';
+import '@babel/runtime/helpers/toConsumableArray';
+import '@babel/runtime/helpers/asyncToGenerator';
+import '@babel/runtime/regenerator';
+import 'three/examples/jsm/loaders/DRACOLoader.js';
+import 'three/examples/jsm/loaders/GLTFLoader.js';
+import 'react/jsx-runtime';
+import '@babel/runtime/helpers/defineProperty';
+import 'zustand';
+import 'zustand/middleware';
+import '@babel/runtime/helpers/typeof';
+import 'postprocessing';
+import '@react-three/drei';
+import '@babel/runtime/helpers/classCallCheck';
+import '@babel/runtime/helpers/createClass';
+import '@babel/runtime/helpers/possibleConstructorReturn';
+import '@babel/runtime/helpers/getPrototypeOf';
+import '@babel/runtime/helpers/inherits';
+import 'classnames';
+import 'three-mesh-bvh';
+import '@babel/runtime/helpers/objectWithoutProperties';
+import 'three/examples/jsm/environments/RoomEnvironment.js';
+import 'three/examples/jsm/loaders/RGBELoader.js';
+import 'three/examples/jsm/loaders/EXRLoader.js';
+import '@react-three/postprocessing';
+import '@babel/runtime/helpers/construct';
+import 'detect-gpu';

package/build/types/real-time-viewer-next/src/RealTimeRendererNext.d.ts

@@ -0,0 +1,58 @@
+import React from 'react';
+import { type RTVCallbacks, type RTVConfig } from './store';
+import { type RTVAnalyzerComponentMap } from './analyzerComponents';
+import type { RTVScene2D } from './types/scene2d';
+import type { ElementOverlayInfo } from './types/plannerUi';
+/** Catalog identity of the planning, used as the fallback for the shelf-accessory grid fetch. */
+export interface RTVCatalogInfo {
+    catalogCodex: string;
+    iln?: string;
+}
+export interface RTVNextProps {
+    /**
+     * Catalog identity of the current planning. The shelf-accessory grid geometry is fetched per
+     * catalog, and falls back to this when nothing is placed yet to read it off.
+     */
+    catalogInfo?: RTVCatalogInfo;
+    /** The HQ render script JSON string produced by the constructor service — the 3D scene channel. */
+    hqRenderScript?: string;
+    scene2d?: RTVScene2D;
+    viewMode?: '3d' | '2d';
+    config: RTVConfig;
+    stopRender?: boolean;
+    callbacks?: RTVCallbacks;
+    analyzerComponents?: RTVAnalyzerComponentMap;
+    /** When set (or changed), the camera animates to focus on this element by its numeric ID. */
+    focusElementId?: number | null;
+    /** Per-element overlay metadata (posNr, capabilities). New reference when data changes. */
+    elementsInfo?: Map<string, ElementOverlayInfo>;
+    /** Enables planner-specific features: 3D grid floor and move/rotate toolbar on elements. */
+    plannerMode?: boolean;
+    /** ShelfPlanner: free cells for the currently selected accessory (shown as placeable boxes). */
+    freePlacesOnGrids?: import('./types/accessoryGrids').FreePlacesOnGrids[];
+    /** ShelfPlanner: placed accessories. Used for the geometry fetch body + catalogCodex/iln. */
+    plannedPlacesOnGrids?: import('./types/accessoryGrids').PlannedPlacesOnGrids[];
+    /**
+     * ShelfPlanner `autoPlaceDrag` mode only: a token identifying the article currently armed for
+     * placement from the host palette (codex, or codex+nonce). A transition to a new defined value
+     * triggers exactly one auto-placement at a default cell. MUST be distinct from the placed
+     * accessory's basketId (which changes on every placement) to avoid a place→refresh→place loop.
+     */
+    armedAccessoryCodex?: string;
+    /** ShelfPlanner palette drag & drop: the article codex being dragged from the host palette. */
+    draggedAccessoryCodex?: string;
+    /** Controlled selection: numeric element ID of the currently selected element, or null/undefined. */
+    selectedElementId?: number | null;
+    /**
+     * Controlled selection for a placed accessory by composite key ("2.0.6"), or null to clear an
+     * accessory selection (`undefined` leaves the canvas selection untouched). Accessories have no
+     * numeric element ID, so this is the channel that keeps the canvas in sync after a host-driven
+     * place/move re-assembles the scene.
+     */
+    selectedAccessoryKey?: string | null;
+    /** Show dimension line annotations (2D per-element/group/total, 3D selected element). */
+    showDimensionLines?: boolean;
+}
+declare const RealTimeRendererNext: React.MemoExoticComponent<(props: RTVNextProps) => React.JSX.Element | null>;
+export default RealTimeRendererNext;
+//# sourceMappingURL=RealTimeRendererNext.d.ts.map

package/build/types/real-time-viewer-next/src/RealTimeRendererNext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RealTimeRendererNext.d.ts","sourceRoot":"","sources":["../../../../src/RealTimeRendererNext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAe,MAAM,OAAO,CAAC;AAEpC,OAAO,EAAe,KAAK,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AACzE,OAAO,EAAuB,KAAK,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAIzF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,iGAAiG;AACjG,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,WAAW,CAAC,EAAE,cAAc,CAAC;IAC7B,mGAAmG;IACnG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,kBAAkB,CAAC,EAAE,uBAAuB,CAAC;IAC7C,6FAA6F;IAC7F,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,2FAA2F;IAC3F,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC/C,4FAA4F;IAC5F,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,gGAAgG;IAChG,iBAAiB,CAAC,EAAE,OAAO,wBAAwB,EAAE,iBAAiB,EAAE,CAAC;IACzE,6FAA6F;IAC7F,oBAAoB,CAAC,EAAE,OAAO,wBAAwB,EAAE,oBAAoB,EAAE,CAAC;IAC/E;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,+FAA+F;IAC/F,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,qGAAqG;IACrG,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,yFAAyF;IACzF,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,QAAA,MAAM,oBAAoB,oCAAgB,YAAY,8BAmCpD,CAAC;AAEH,eAAe,oBAAoB,CAAC"}

package/build/types/real-time-viewer-next/src/analyzerComponents.d.ts

@@ -0,0 +1,23 @@
+import React from 'react';
+import type { RTVElement2D } from './types/scene2d';
+export interface RTVAnalyzerComponentMap {
+    DebugPanel?: React.ComponentType;
+    DebugPanelCanvas?: React.ComponentType;
+    /** Renders nothing; mounted outside the `<Canvas>` at the same debug level as `DebugPanelCanvas`
+     *  so the analyzer's startup work (preset restore, asset warm-up) is not queued behind WebGL
+     *  context creation. */
+    DebugBoot?: React.ComponentType;
+    /** Per-element 2D debug overlay. Mounted inside each element's rotated group in
+     *  `Element2DPlane` (inherits the live transform); must gate its own visibility. */
+    Element2DDebug?: React.ComponentType<{
+        element: RTVElement2D;
+    }>;
+}
+interface ProviderProps {
+    components: RTVAnalyzerComponentMap;
+    children: React.ReactNode;
+}
+export declare const RTVAnalyzerProvider: ({ components, children }: ProviderProps) => React.JSX.Element;
+export declare const useRTVAnalyzerComponents: () => RTVAnalyzerComponentMap;
+export {};
+//# sourceMappingURL=analyzerComponents.d.ts.map

package/build/types/real-time-viewer-next/src/analyzerComponents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzerComponents.d.ts","sourceRoot":"","sources":["../../../../src/analyzerComponents.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoC,MAAM,OAAO,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IACjC,gBAAgB,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IACvC;;4BAEwB;IACxB,SAAS,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAChC;wFACoF;IACpF,cAAc,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;QAAE,OAAO,EAAE,YAAY,CAAA;KAAE,CAAC,CAAC;CACjE;AAID,UAAU,aAAa;IACrB,UAAU,EAAE,uBAAuB,CAAC;IACpC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,eAAO,MAAM,mBAAmB,6BAA8B,aAAa,sBAE1E,CAAC;AAEF,eAAO,MAAM,wBAAwB,+BAAuC,CAAC"}

package/build/types/real-time-viewer-next/src/analyzerStageContext.d.ts

@@ -0,0 +1,9 @@
+import React, { type RefObject } from 'react';
+/**
+ * Ref to the RTV stage wrapper (`SceneRenderer` root): same box as the WebGL
+ * canvas (`width/height: 100%` of the host). The analyzer debug DOM uses it
+ * to cap floating panels to the embedded viewer — not `100vh`.
+ */
+export declare const RTVAnalyzerStageRefContext: React.Context<React.RefObject<HTMLDivElement | null> | null>;
+export declare function useRTVAnalyzerStageRef(): RefObject<HTMLDivElement | null> | null;
+//# sourceMappingURL=analyzerStageContext.d.ts.map

package/build/types/real-time-viewer-next/src/analyzerStageContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzerStageContext.d.ts","sourceRoot":"","sources":["../../../../src/analyzerStageContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAA6B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAEzE;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,8DAA+D,CAAC;AAEvG,wBAAgB,sBAAsB,IAAI,SAAS,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,IAAI,CAEhF"}

package/build/types/real-time-viewer-next/src/capture/applyShot.d.ts

@@ -0,0 +1,8 @@
+import type { CaptureEngineContext, ShotConfig } from './types';
+/**
+ * Applies one shot's configuration: store overrides through the sealed capture channel, 2d material
+ * muting, camera pose and the shot resolution. Followed by `settleFrames` render frames before the
+ * canvas is read back.
+ */
+export declare function applyShotConfig(ctx: CaptureEngineContext, shot: ShotConfig): void;
+//# sourceMappingURL=applyShot.d.ts.map

package/build/types/real-time-viewer-next/src/capture/applyShot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyShot.d.ts","sourceRoot":"","sources":["../../../../../src/capture/applyShot.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAIhE;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,oBAAoB,EAAE,IAAI,EAAE,UAAU,QAiH1E"}

package/build/types/real-time-viewer-next/src/capture/blob.d.ts

@@ -0,0 +1,11 @@
+import type { ShotConfig, ShotResult } from './types';
+export interface EncodedShot {
+    blob: Blob;
+    format: ShotResult['format'];
+}
+/**
+ * Reads the canvas' current contents into a Blob in the shot's format. Synchronous (`toDataURL`
+ * rather than `toBlob`) because the caller must read the canvas inside the frame that drew it.
+ */
+export declare function encodeCanvas(canvas: HTMLCanvasElement, shot: ShotConfig): EncodedShot;
+//# sourceMappingURL=blob.d.ts.map

package/build/types/real-time-viewer-next/src/capture/blob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob.d.ts","sourceRoot":"","sources":["../../../../../src/capture/blob.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGtD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;CAC9B;AAcD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,EAAE,UAAU,GAAG,WAAW,CAMrF"}

package/build/types/real-time-viewer-next/src/capture/materialMute.d.ts

@@ -0,0 +1,16 @@
+import type { Material, Scene } from 'three';
+/** The per-material fields {@link hide3DMaterials} overwrites, kept so the mute is exactly reversible. */
+export interface SavedMatState {
+    opacity: number;
+    transparent: boolean;
+}
+/**
+ * Mutes every 3D mesh material in the scene (fully transparent) so a 2d shot captures the plan
+ * overlays only. Overlay subtrees are skipped — they are what the 2d shot is of.
+ *
+ * @returns the saved states, to be handed back to {@link restore3DMaterials}.
+ */
+export declare function hide3DMaterials(scene: Scene): Map<Material, SavedMatState>;
+/** Puts back the states captured by {@link hide3DMaterials} and empties the map (safe to call unmuted). */
+export declare function restore3DMaterials(saved: Map<Material, SavedMatState>): void;
+//# sourceMappingURL=materialMute.d.ts.map

package/build/types/real-time-viewer-next/src/capture/materialMute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialMute.d.ts","sourceRoot":"","sources":["../../../../../src/capture/materialMute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAkB,KAAK,EAAE,MAAM,OAAO,CAAC;AAG7D,0GAA0G;AAC1G,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,GAAG,CAAC,QAAQ,EAAE,aAAa,CAAC,CAiB1E;AAED,2GAA2G;AAC3G,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE,aAAa,CAAC,QAOrE"}

package/build/types/real-time-viewer-next/src/capture/shotState.d.ts

@@ -0,0 +1,24 @@
+import { Vector3 } from 'three';
+import type { CaptureRestoreState } from '../store';
+import type { CaptureEngineContext } from './types';
+/** The store fields restored after a batch (see `_captureRestore`) plus the renderer/camera pose. */
+export interface CaptureSnapshot extends CaptureRestoreState {
+    cameraPosition: Vector3;
+    cameraTarget: Vector3;
+    cameraUp: Vector3;
+    cameraFov: number;
+    canvasWidth: number;
+    canvasHeight: number;
+    pixelRatio: number;
+}
+/**
+ * Captures the pre-batch store fields and renderer/camera pose, for {@link restoreSnapshot}.
+ *
+ * The pose is read from the proxy camera, not the rendered one: the rendered camera lags the proxy
+ * by the active smoothTime, so a capture started mid-coast would restore a transient pose instead of
+ * the framing the user considers theirs.
+ */
+export declare function takeSnapshot({ gl, controlsRef, proxyCamRef, sizeRef }: CaptureEngineContext): CaptureSnapshot;
+/** Puts the pre-batch store fields, camera pose and drawing buffer back. */
+export declare function restoreSnapshot(ctx: CaptureEngineContext, snap: CaptureSnapshot): void;
+//# sourceMappingURL=shotState.d.ts.map

package/build/types/real-time-viewer-next/src/capture/shotState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shotState.d.ts","sourceRoot":"","sources":["../../../../../src/capture/shotState.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAGpD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,qGAAqG;AACrG,MAAM,WAAW,eAAgB,SAAQ,mBAAmB;IAC1D,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,oBAAoB,GAAG,eAAe,CAqB7G;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAAC,GAAG,EAAE,oBAAoB,EAAE,IAAI,EAAE,eAAe,QAgD/E"}

package/build/types/real-time-viewer-next/src/capture/types.d.ts

@@ -0,0 +1,80 @@
+import type { MutableRefObject } from 'react';
+import type { Size } from '@react-three/fiber';
+import type { Material, PerspectiveCamera, Scene, WebGLRenderer } from 'three';
+import type { OrbitControls as OrbitControlsImpl } from 'three-stdlib';
+import type { EnvironmentConfig } from '../types/environment';
+import type { SavedMatState } from './materialMute';
+export interface ShotConfig {
+    id: string;
+    name?: string;
+    environment?: EnvironmentConfig;
+    camera?: {
+        fov?: number;
+        /** Spherical angle around the scene center. */
+        angle?: {
+            azimuth: number;
+            elevation: number;
+        };
+        /** Distance multiplier — higher = more zoomed out (default: store's initialZoomPadding3D, or initialZoomPadding2D for 2d shots). */
+        padding?: number;
+    };
+    viewMode?: '3d' | '2d';
+    showGrid?: boolean;
+    showDimensionLines?: boolean;
+    showPosNr?: boolean;
+    resolution?: {
+        width: number;
+        height: number;
+    };
+    format?: 'png' | 'jpeg';
+    jpegQuality?: number;
+    /** Frames to wait after config is applied before capturing (default 10). */
+    settleFrames?: number;
+}
+export interface ShotBatch {
+    shots: ShotConfig[];
+}
+export interface ShotResult {
+    shotId: string;
+    name?: string;
+    blob: Blob;
+    width: number;
+    height: number;
+    format: 'png' | 'jpeg';
+}
+export interface CaptureProgress {
+    state: 'idle' | 'capturing' | 'done' | 'error';
+    current: number;
+    total: number;
+    currentShotId?: string;
+}
+export declare const CAPTURE_DEFAULTS: {
+    format: "png";
+    jpegQuality: number;
+    settleFrames: number;
+};
+/**
+ * @internal The live R3F handles the capture engine writes, assembled by `useCaptureEngine` and
+ * passed to its shot modules. The per-render values (`controls`, proxy camera, canvas size) are
+ * refs so they are read live instead of through a closure (see `useCaptureEngine`); `savedMats` and
+ * `releaseControls` are refs because they carry state across shots.
+ */
+export interface CaptureEngineContext {
+    gl: WebGLRenderer;
+    /** The camera R3F renders with — the proxy camera owns the pose, this one mirrors projection state. */
+    renderCam: PerspectiveCamera;
+    scene: Scene;
+    controlsRef: MutableRefObject<OrbitControlsImpl | null>;
+    /** The camera OrbitControls operates on: the source of truth for the user-intent pose. */
+    proxyCamRef: MutableRefObject<PerspectiveCamera>;
+    sizeRef: MutableRefObject<Size>;
+    /** Materials muted for a 2d shot, empty while nothing is muted. */
+    savedMatsRef: MutableRefObject<Map<Material, SavedMatState>>;
+    /**
+     * Controls lock held for the whole batch: taken by the first `applyShotConfig`, released when the
+     * batch finishes. Refcounted (see `controlsLock`), so a drag or a camera fly that ends mid-batch
+     * cannot hand the controls back to the user under the shutter.
+     */
+    releaseControlsRef: MutableRefObject<(() => void) | null>;
+}
+//# sourceMappingURL=types.d.ts.map

package/build/types/real-time-viewer-next/src/capture/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/capture/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,MAAM,CAAC,EAAE;QACP,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,+CAA+C;QAC/C,KAAK,CAAC,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/C,oIAAoI;QACpI,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,UAAU,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,gBAAgB;;;;CAI5B,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,aAAa,CAAC;IAClB,uGAAuG;IACvG,SAAS,EAAE,iBAAiB,CAAC;IAC7B,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,EAAE,gBAAgB,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IACxD,0FAA0F;IAC1F,WAAW,EAAE,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;IACjD,OAAO,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAChC,mEAAmE;IACnE,YAAY,EAAE,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IAC7D;;;;OAIG;IACH,kBAAkB,EAAE,gBAAgB,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;CAC3D"}

package/build/types/real-time-viewer-next/src/capture/useCaptureEngine.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Runs capture batches: one shot at a time, `applyShotConfig` → settle frames → canvas readback,
+ * then `restoreSnapshot` puts the interactive viewer back. Requests arrive through the store
+ * (`captureShots`), results resolve that request's promise.
+ */
+export declare function useCaptureEngine(): void;
+//# sourceMappingURL=useCaptureEngine.d.ts.map

package/build/types/real-time-viewer-next/src/capture/useCaptureEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCaptureEngine.d.ts","sourceRoot":"","sources":["../../../../../src/capture/useCaptureEngine.ts"],"names":[],"mappings":"AAuBA;;;;GAIG;AACH,wBAAgB,gBAAgB,SAwL/B"}

package/build/types/real-time-viewer-next/src/config/descriptor.d.ts

@@ -0,0 +1,156 @@
+/**
+ * Config descriptors — one declaration per subsystem from which everything else derives.
+ *
+ * A descriptor tree carries, per field, the default, the clamp range, and the leva label/hint.
+ * From it TypeScript infers the input type ({@link ConfigInput}, all-optional) and the resolved
+ * type ({@link ConfigResolved}, all-required); {@link resolveConfig} / {@link emitConfig} give the
+ * runtime resolver and the round-trip emitter; the analyzer builds its leva inputs from the same
+ * leaf fields. Adding a field means adding one line to the descriptor and nothing else.
+ */
+/** Leva-facing metadata every field may carry. `label` is the leva key; `hint` its tooltip. */
+interface FieldMeta {
+    label?: string;
+    hint?: string;
+}
+export interface NumberField extends FieldMeta {
+    kind: 'number';
+    default: number;
+    /** Clamp bounds applied by {@link resolveConfig}; also the leva slider range. */
+    min?: number;
+    max?: number;
+    step?: number;
+    /** Leva renders a dropdown of these instead of a slider (e.g. render-target sizes). */
+    options?: Readonly<Record<string, number>>;
+}
+export interface BooleanField extends FieldMeta {
+    kind: 'boolean';
+    default: boolean;
+}
+/** CSS color string. */
+export interface ColorField extends FieldMeta {
+    kind: 'color';
+    default: string;
+}
+/**
+ * One of a closed set of string values. `options` is either the bare value list or a
+ * `label → value` map, which leva renders as the dropdown's display names.
+ */
+export interface EnumField<T extends string> extends FieldMeta {
+    kind: 'enum';
+    default: T;
+    options: readonly T[] | Readonly<Record<string, T>>;
+}
+/**
+ * A leaf whose type the descriptor does not model further — free text, a nullable URL, a
+ * `string | false` switch, a `number | [min, max]` range. Resolved by passthrough (no clamp, no
+ * leva range).
+ */
+export interface ValueField<T> extends FieldMeta {
+    kind: 'value';
+    default: T;
+}
+/**
+ * A value that can either be a single concrete value (same for every device) or a per-tier
+ * variant object. `high` is required (it's the baseline that always exists); `low` and `medium`
+ * are optional, and `resolveTieredAsset` defines the fallback when one is missing.
+ *
+ * Use for heavy URL-typed assets that should swap resolution per device (HDRIs, scene GLBs,
+ * particle textures). Don't use for arbitrary config scalars — those belong in the per-tier
+ * override partials.
+ */
+export type TieredAsset<T> = T | {
+    low?: T;
+    medium?: T;
+    high: T;
+};
+/**
+ * A URL / preset-name leaf that may be authored as a {@link TieredAsset}. `mergeProfile` collapses
+ * it for the active tier before the config reaches the resolver; {@link resolveConfig} collapses
+ * any leftover tier object to `high`, so the resolved value is always a plain string.
+ */
+export interface AssetField extends FieldMeta {
+    kind: 'asset';
+    default: string;
+    /** Leva renders a dropdown of these (plus the current value when it is a URL). */
+    options?: readonly string[];
+}
+/**
+ * A repeated field. Arrays are replaced wholesale (an element-wise merge would be ambiguous), and
+ * every entry is filled to `item`'s resolved shape. The resolved default is always `[]`.
+ */
+export interface ArrayDescriptor<D extends ConfigDescriptor> extends FieldMeta {
+    kind: 'array';
+    item: D;
+}
+/** Fixed-length numeric tuple (positions, sizes). */
+export interface TupleField<T extends readonly number[]> extends FieldMeta {
+    kind: 'tuple';
+    default: T;
+}
+/** Nested object of fields. */
+export interface GroupDescriptor<F extends FieldMap> extends FieldMeta {
+    kind: 'group';
+    fields: F;
+}
+/**
+ * A group that can be switched off: input `boolean | partial`, resolved `false | full`.
+ * `true` and a partial object both fill from the group's defaults; `default` is the switch's
+ * own default state.
+ */
+export interface ToggleDescriptor<F extends FieldMap> extends FieldMeta {
+    kind: 'toggle';
+    fields: F;
+    default: boolean;
+}
+export type LeafField = NumberField | BooleanField | ColorField | EnumField<string> | TupleField<readonly number[]> | ValueField<unknown> | AssetField;
+export type ConfigDescriptor = LeafField | GroupDescriptor<FieldMap> | ToggleDescriptor<FieldMap> | ArrayDescriptor<ConfigDescriptor>;
+export type FieldMap = Record<string, ConfigDescriptor>;
+/** Fully resolved value shape of a descriptor — every field present. */
+export type ConfigResolved<D> = D extends GroupDescriptor<infer F> ? {
+    [K in keyof F]: ConfigResolved<F[K]>;
+} : D extends ToggleDescriptor<infer F> ? false | {
+    [K in keyof F]: ConfigResolved<F[K]>;
+} : D extends ArrayDescriptor<infer I> ? ConfigResolved<I>[] : D extends AssetField ? string : D extends {
+    default: infer V;
+} ? V : never;
+/** Input (authoring) shape of a descriptor — every field optional, toggles accept `boolean`. */
+export type ConfigInput<D> = D extends GroupDescriptor<infer F> ? {
+    [K in keyof F]?: ConfigInput<F[K]>;
+} : D extends ToggleDescriptor<infer F> ? boolean | {
+    [K in keyof F]?: ConfigInput<F[K]>;
+} : D extends ArrayDescriptor<infer I> ? ConfigInput<I>[] : D extends AssetField ? TieredAsset<string> : D extends {
+    default: infer V;
+} ? V : never;
+/** Keys of a field map whose descriptor is a leaf (what a leva panel can render directly). */
+export type LeafKeys<F extends FieldMap> = {
+    [K in keyof F]: F[K] extends LeafField ? K : never;
+}[keyof F];
+type NumberOpts = Omit<NumberField, 'kind' | 'default'>;
+/** Builders that keep descriptor trees terse and let the literal types infer. */
+export declare const field: {
+    number(def: number, opts?: NumberOpts): NumberField;
+    boolean(def: boolean, meta?: FieldMeta): BooleanField;
+    color(def: string, meta?: FieldMeta): ColorField;
+    enum<const T extends string>(def: NoInfer<T>, options: readonly T[] | Readonly<Record<string, T>>, meta?: FieldMeta): EnumField<T>;
+    tuple<T extends number[]>(def: [...T], meta?: FieldMeta): TupleField<T>;
+    value<T>(def: T, meta?: FieldMeta): ValueField<T>;
+    asset(def: string, opts?: Omit<AssetField, "kind" | "default">): AssetField;
+    array<D extends ConfigDescriptor>(item: D, meta?: FieldMeta): ArrayDescriptor<D>;
+    group<F extends FieldMap>(fields: F, meta?: FieldMeta): GroupDescriptor<F>;
+    toggle<F extends FieldMap>(fields: F, def: boolean, meta?: FieldMeta): ToggleDescriptor<F>;
+};
+/**
+ * Fill `input` to the descriptor's full shape: missing fields take their default, numbers are
+ * clamped to `min`/`max`, toggles collapse to `false | full`. Unknown keys in `input` are dropped.
+ * The result is a fresh tree (no aliasing into `input`).
+ */
+export declare function resolveConfig<D extends ConfigDescriptor>(descriptor: D, input: ConfigInput<D> | undefined): ConfigResolved<D>;
+/**
+ * Project a resolved tree back to the input shape (every field emitted, tuples copied) — the
+ * round-trip used by the analyzer's export. `resolveConfig(d, emitConfig(d, r))` deep-equals `r`.
+ */
+export declare function emitConfig<D extends ConfigDescriptor>(descriptor: D, resolved: ConfigResolved<D>): ConfigInput<D>;
+/** The resolved tree with every field at its default. */
+export declare function configDefaults<D extends ConfigDescriptor>(descriptor: D): ConfigResolved<D>;
+export {};
+//# sourceMappingURL=descriptor.d.ts.map

package/build/types/real-time-viewer-next/src/config/descriptor.d.ts.map

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

package/build/types/real-time-viewer-next/src/config/descriptor.test.d.ts

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

package/build/types/real-time-viewer-next/src/config/descriptor.test.d.ts.map

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