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

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

@@ -0,0 +1,168 @@
+/**
+ * An accessory docking-point button rendered on a 2D element — the old planner's `addDPUI` ACC branch
+ * (AVO/AVU/AVC/AVN/AVS). A non-docking point lets the user attach an accessory there (click → filters
+ * the palette); a docking point acts as a delete for the already-attached accessory (`onElementId`).
+ */
+export interface DPButton2D {
+    /** Docking-point id (`DockingPoint.DpId`); passed back to the host on click. */
+    dpId: string;
+    /** Offset (cm) from the element's rotation-pivot centre, in the element's UNROTATED local frame
+     *  (`[+x = width, +z = depth]`). Rendered inside the element's rotated group so it tracks rotation. */
+    localOffset: [x: number, z: number];
+    /** The docking point's own yaw (deg) — orients a directional marker. */
+    iconRotDeg: number;
+    /** True when an accessory is already docked here; the button then deletes `onElementId`. */
+    isDocking: boolean;
+    /** Element id of the docked accessory (present when `isDocking`), for the delete action. */
+    onElementId?: number;
+}
+/**
+ * One docking point (ALL AV types, not just the accessory buttons in {@link DPButton2D}).
+ * Inspection data for the analyzer's `Element2DDebug` overlay; never interactive.
+ */
+export interface DockingPointDebug2D {
+    dpId: string;
+    /** AV docking type: AVL | AVR | AVC | AVO | AVU | AVS | AVN. */
+    type: string;
+    /** Offset (cm) from the element's rotation-pivot centre — same frame as {@link DPButton2D.localOffset}. */
+    localOffset: [x: number, z: number];
+    /** Yaw (deg) in planner convention: 0 = local +z ("down" in the SVG), clockwise in plan view. */
+    rotDeg: number;
+    isDocking: boolean;
+    /** Element id this point is docked to (present when `isDocking`). */
+    onElementId?: number;
+    /** Docking-point number (the 1 in AVO_1), when present. */
+    number?: number;
+}
+/**
+ * Per-element dimension-line configuration (catalog-driven; arrives via the article's
+ * DIMENSION_CONFIG meta tag once the catalog ships it). All fields optional — an element
+ * without a config renders exactly like before (both axes, outside, default color).
+ */
+export interface ElementDimensionConfig {
+    /** Whether to show the width dimension line. Default: true. */
+    showWidth?: boolean;
+    /** Whether to show the depth dimension line. Default: true. */
+    showDepth?: boolean;
+    /** Perpendicular offset (m) of the width dimension line from the element edge. Default: 0.15.
+     *  Stacked/layered elements use increasing values so their lines don't overlap. */
+    widthDimensionLineOffset?: number;
+    /** Perpendicular offset (m) of the depth dimension line from the element edge. Default: 0.15. */
+    depthDimensionLineOffset?: number;
+    /** Dimension lines placed INSIDE the element bounds. An axis listed here renders inside
+     *  instead of at the normal outside placement; unlisted axes keep the outside line. */
+    insideDimensions?: InsideDimensionConfig[];
+    /** Color override for this element's dimension lines. */
+    color?: string;
+    /** Stroke style of the measurement run (extension ticks and arrows stay solid). Default: solid. */
+    lineStyle?: 'solid' | 'dashed' | 'dotted';
+    /** Anchor this element's OUTSIDE lines at the plan edge instead of the element's own edge:
+     *  width below the whole drawing, depth right of it. The offsets then act as global "rows"
+     *  (0.15 = row 1, 0.30 = row 2, …), so lines from different elements stack cleanly.
+     *  Assumes axis-aligned elements. Default: false (line at the element's edge). */
+    dimensionsAtPlanEdge?: boolean;
+    /** Whether this element participates in automatic gap detection. Default: true. */
+    gapDimensions?: boolean;
+    /** Text before the width value (e.g. "Poolbreite "). Applies to inside and outside lines. */
+    widthPrefix?: string;
+    /** Text after the width value. */
+    widthPostfix?: string;
+    /** Text before the depth value (e.g. "4x"). Applies to inside and outside lines. */
+    depthPrefix?: string;
+    /** Text after the depth value. */
+    depthPostfix?: string;
+}
+export interface InsideDimensionConfig {
+    axis: 'width' | 'depth';
+    /** Position along the perpendicular axis (0 = start edge, 0.5 = center, 1 = end edge). */
+    positionFactor: number;
+    /** Label anchor along the line itself (0–1). Default: 0.5 (centered). Use an off-center
+     *  value when two inside lines cross and their labels would stack. */
+    labelPositionFactor?: number;
+    /** Override label value in mm (e.g. a measurement differing from the element's own size). */
+    valueMm?: number;
+    /** Color override for this single line (wins over `ElementDimensionConfig.color`). */
+    color?: string;
+}
+/** Free text rendered along one side of an element (e.g. "Frontwand: hochklappbar 18,5 cm"). */
+export interface ElementAnnotation {
+    side: 'left' | 'right' | 'top' | 'bottom';
+    /** Annotation text; supports line breaks via "\n". */
+    text: string;
+    /** Extra rotation (deg) on top of the side's automatic orientation (left/right read vertically). */
+    rotation?: number;
+    /** Extra distance (m) from the element edge, on top of the default margin — e.g. to clear
+     *  dimension lines running along the same side. */
+    offset?: number;
+}
+export interface RTVElement2D {
+    name: string;
+    setId: string;
+    elementId: number;
+    /** Rotation-pivot position in cm (WorldPosCenter — stays fixed during rotation) */
+    position: [x: number, z: number];
+    /** Local offset (cm) from the rotation pivot (`position`) to the plane's visual center, applied
+     *  INSIDE the rotated group so it rotates with the element. `[0, 0]` when `position` already is the
+     *  visual center (the standard planner: `position` = OLF center = the OLF plane's center). */
+    pivotOffset: [x: number, z: number];
+    /** Yaw rotation in degrees */
+    rotation: number;
+    /** Width in cm */
+    width: number;
+    /** Depth in cm */
+    depth: number;
+    /** Optional SVG data URL (`data:image/svg+xml;...`). When absent, a plain placeholder is rendered. */
+    svgDataUrl?: string;
+    /** Height in cm (for 3D dimension lines). Absent when unknown. */
+    height?: number;
+    /** Accessory docking-point buttons (AVO/AVU/AVC/…) to render on this element in planner mode. */
+    dockingButtons?: DPButton2D[];
+    /** ALL docking points, for the analyzer's `Element2DDebug` overlay. */
+    dockingPointsDebug?: DockingPointDebug2D[];
+    /** OLT (technical outline) and OLF (clearance outline) polygons for the analyzer's
+     *  `Element2DDebug` overlay — the exact geometry the planner's collision/placement logic uses,
+     *  so a missing entry means the planner has no such polygon for this element. Vertices in cm in
+     *  the element's UNROTATED local frame, relative to `position` (same frame as
+     *  {@link DockingPointDebug2D.localOffset}). */
+    outlinesDebug?: {
+        olt?: [x: number, z: number][];
+        olf?: [x: number, z: number][];
+    };
+    /** Stacking order for overlapping elements (higher = on top; drives the plane's y offset so
+     *  transparency and pointer picking resolve top-first). Absent = 0 (today's flat behavior).
+     *  Elements sharing a zLayer are tie-broken by creation order (higher `elementId` on top),
+     *  so coplanar planes never z-fight. */
+    zLayer?: number;
+    /** Opacity of the element plane (0–1). Default: 1. */
+    opacity?: number;
+    /** Dimension-line configuration for this element. Absent = default lines. */
+    dimensionConfig?: ElementDimensionConfig;
+    /** Text annotations rendered along the element's sides. */
+    annotations?: ElementAnnotation[];
+}
+export interface RTVScene2D {
+    elements: RTVElement2D[];
+    boundingBox: {
+        x: number;
+        z: number;
+        width: number;
+        depth: number;
+    };
+    /** Connected element groups from docking points. Each inner array = elementIds sharing docking connections.
+     *  Single-element groups are omitted. */
+    dockingGroups?: number[][];
+    /** URL to a font file (.woff/.ttf/.otf) for dimension-line and annotation text (troika fetches it
+     *  via HTTP — works headless, no CSS @font-face). Absent = the drei Text default font. */
+    fontUrl?: string;
+    /** Hide the unit suffix in dimension labels (e.g. "4300" instead of "4300 mm"). Default: false. */
+    hideUnit?: boolean;
+}
+/**
+ * True when an element carries finite, positive geometry that can be rendered as a plane. Guards
+ * against upstream data that never resolved a dimension — e.g. a planner element whose width/depth
+ * comes from a freetext option that was left empty, producing `NaN`/`undefined`/`0`. Rendering such
+ * an element would build a `NaN`-sized `planeGeometry` (Three throws `computeBoundingBox` NaN
+ * warnings and the plane is invisible), so the overlay skips it instead.
+ */
+export declare function isRenderable2DElement(el: RTVElement2D): boolean;
+//# sourceMappingURL=scene2d.d.ts.map

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

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

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

@@ -0,0 +1,75 @@
+/** Milliseconds since the boot clock started. The single timeline for `[BOOT]` and `[REVEAL]` logs. */
+export declare function bootClockMs(): number;
+/** Detail bag attached to a mark. Values must be already known — never computed just for the log. */
+export type BootDetail = Record<string, string | number>;
+/** Re-zeroes the boot clock and drops the recorded timeline. Called by `resetSceneLoads`. */
+export declare function resetBootClock(): void;
+/**
+ * One-line `[BOOT] <phase> +<t>ms` trace on the shared boot clock, plus one entry in the timeline
+ * the consolidated report at reveal is drawn from. Debug level only, and every call site is a
+ * once-per-boot phase edge, never a per-frame path.
+ *
+ * @param phase short phase name, e.g. `'product-materials done'`
+ * @param detail already-known counts/durations to attach; must never be computed just for the log
+ */
+export declare function bootPhase(phase: string, detail?: BootDetail): void;
+/**
+ * Records a scene-load gate opening. SILENT by design: per-gate begin/end console lines were
+ * removed as noise, and the gate table in the reveal report replaces them.
+ */
+export declare function bootGateBegin(id: string): void;
+/** Records a scene-load gate closing. Silent — see {@link bootGateBegin}. */
+export declare function bootGateEnd(id: string): void;
+/**
+ * Records one completed request from the shared data layer, for the report's network section.
+ * Silent — a console line per request is exactly the spam the consolidated report replaces.
+ *
+ * @param name path-derived short name; callers MUST strip query strings, tokens and ids
+ * @param start page time the request started
+ * @param ms wall duration
+ */
+export declare function bootNetwork(name: string, start: number, ms: number, detail?: BootDetail): void;
+/**
+ * The diagnostics channel the host packages reach this recorder through.
+ *
+ * `web-planner-logic` cannot import this package (it does not depend on it), and
+ * `web-planner-react` must not import it outside its `React.lazy` chunk — a static import would
+ * pull the whole viewer into the eager bundle and defeat the split that keeps it out of the 2D
+ * boot. So the host calls `globalThis.__rtvBoot`, buffering into `globalThis.__rtvBootBuffer`
+ * until this module installs the channel and drains what accumulated. See
+ * `web-planner-logic/src/logic/bootMark.ts` for the host end of the same contract.
+ */
+interface RTVBootChannel {
+    /** Lifecycle mark at page time `t` (defaults to now). */
+    mark: (phase: string, detail?: BootDetail, t?: number) => void;
+    /** Completed request; see {@link bootNetwork}. */
+    net: (name: string, start: number, ms: number, detail?: BootDetail) => void;
+}
+type BufferedMark = ['mark', string, BootDetail | undefined, number];
+type BufferedNet = ['net', string, number, number, BootDetail | undefined];
+declare global {
+    /** Installed below; the host calls it directly. See {@link RTVBootChannel}. */
+    var __rtvBoot: RTVBootChannel | undefined;
+    /** Host marks buffered before this module was evaluated, drained on install. */
+    var __rtvBootBuffer: (BufferedMark | BufferedNet)[] | undefined;
+}
+/**
+ * Builds the consolidated boot report: header, chronological timeline, gate table, the largest
+ * gaps between consecutive events, and the slowest requests.
+ *
+ * Pure over the recorded state so the formatting is unit-testable; {@link logBootReport} is the
+ * caller that prints it as one console entry.
+ *
+ * @param revealT page time the gate set emptied
+ * @param lastGateId the gate whose end triggered the reveal — the critical path
+ */
+export declare function formatBootReport(revealT: number, lastGateId: string): string;
+/**
+ * Prints the whole boot report as ONE `LOG.debug` call, so it can be copied or screenshotted in
+ * one piece. Called from the reveal point in `endSceneLoad`; a no-op when debug is off.
+ *
+ * @param lastGateId the gate whose end emptied the registry
+ */
+export declare function logBootReport(lastGateId: string): void;
+export {};
+//# sourceMappingURL=bootPhase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bootPhase.d.ts","sourceRoot":"","sources":["../../../../../src/utils/bootPhase.ts"],"names":[],"mappings":"AAqBA,uGAAuG;AACvG,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,qGAAqG;AACrG,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAiCzD,6FAA6F;AAC7F,wBAAgB,cAAc,IAAI,IAAI,CAKrC;AAkBD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAKlE;AAWD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAO9C;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAO5C;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,IAAI,CAI9F;AAED;;;;;;;;;GASG;AACH,UAAU,cAAc;IACtB,yDAAyD;IACzD,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/D,kDAAkD;IAClD,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;CAC7E;AAED,KAAK,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,SAAS,EAAE,MAAM,CAAC,CAAC;AACrE,KAAK,WAAW,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC,CAAC;AAE3E,OAAO,CAAC,MAAM,CAAC;IACb,+EAA+E;IAE/E,IAAI,SAAS,EAAE,cAAc,GAAG,SAAS,CAAC;IAC1C,gFAAgF;IAEhF,IAAI,eAAe,EAAE,CAAC,YAAY,GAAG,WAAW,CAAC,EAAE,GAAG,SAAS,CAAC;CACjE;AAuDD;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAmD5E;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAGtD"}

package/build/types/real-time-viewer-next/src/utils/bootPhase.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @jest-environment jsdom
+ */
+export {};
+//# sourceMappingURL=bootPhase.test.d.ts.map

package/build/types/real-time-viewer-next/src/utils/bootPhase.test.d.ts.map

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

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

@@ -0,0 +1,8 @@
+/** Re-export barrel for the camera math split across the framing, smoothing and animation modules. */
+export { sphericalPosition, computeCamera2D, computeCamera3D, computeCamera3DSceneFrontOn, sceneContentBox } from './cameraFraming';
+export type { CameraFrameContext, FrameResult } from './cameraFraming';
+export { smoothDampScalar, smoothDampVec3 } from './smoothDamp';
+export type { ScalarVel } from './smoothDamp';
+export { createAnimationState, startAnimation, updateAnimation } from '../core/camera/cameraAnimationEngine';
+export type { EasingFn, AnimationRequest, AnimationState, AnimUpHints, AnimInitialVel, AnimFrameResult } from '../core/camera/cameraAnimationEngine';
+//# sourceMappingURL=camera.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"camera.d.ts","sourceRoot":"","sources":["../../../../../src/utils/camera.ts"],"names":[],"mappings":"AAAA,sGAAsG;AACtG,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,eAAe,EAAE,2BAA2B,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACpI,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEvE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAChE,YAAY,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC7G,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC"}

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

@@ -0,0 +1,47 @@
+import { Vector3, Box3 } from 'three';
+import type { Scene } from 'three';
+import type { ViewAngle, CameraConfig } from '../types/camera';
+import type { RTVScene2D } from '../types/scene2d';
+/**
+ * Computes a world-space camera position on a sphere around `center`.
+ * Azimuth: degrees around Y axis (0 = +Z, 90 = +X). Elevation: degrees above XZ plane.
+ */
+export declare function sphericalPosition(center: Vector3, angle: ViewAngle, distance: number): Vector3;
+export interface CameraFrameContext {
+    threeScene: Scene;
+    bounds2d: RTVScene2D['boundingBox'] | undefined;
+    sceneCenter: [number, number, number];
+    sceneRadius: number;
+    aspect: number;
+    cameraConfig: CameraConfig;
+}
+export interface FrameResult {
+    position: Vector3;
+    target: Vector3;
+}
+/**
+ * Compute the 2D (top-down) camera position framing the full planning.
+ * 2D never focuses a single element — `useCameraActions` breaks out of every
+ * focus action while in 2D, so the whole-scene framing is the only case.
+ */
+export declare function computeCamera2D(ctx: CameraFrameContext): FrameResult;
+/**
+ * Union bounding box over all `Element#…` groups in the live scene — the
+ * "global content box" used to frame the full planning. Returns null when the
+ * planning has no placed elements (empty scene).
+ */
+export declare function sceneContentBox(scene: Scene): Box3 | null;
+/**
+ * Compute the 3D (orbital) camera position to frame either the entire scene,
+ * a specific element, or a specific geo within an element.
+ */
+export declare function computeCamera3D(ctx: CameraFrameContext, elementName?: string, geoName?: string, elevationOverrideDeg?: number, frontOn?: boolean, paddingScale?: number): FrameResult;
+/**
+ * Scene-overview framing whose azimuth is the element's world yaw — the exact azimuth a `frontOn`
+ * focus on that element uses — instead of the configured initial azimuth. Used to exit a shelf-
+ * accessory focus: the camera only dollies out to the overview, it never rotates (and for a corner
+ * element in an L-shape the facing of the grid plane the accessory sits on wins, not a wing's).
+ * Falls back to the standard scene framing when the element is gone (e.g. just deleted).
+ */
+export declare function computeCamera3DSceneFrontOn(ctx: CameraFrameContext, elementName: string): FrameResult;
+//# sourceMappingURL=cameraFraming.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cameraFraming.d.ts","sourceRoot":"","sources":["../../../../../src/utils/cameraFraming.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAqB,IAAI,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,KAAK,EAAE,KAAK,EAAY,MAAM,OAAO,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAKnD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAQ9F;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,KAAK,CAAC;IAClB,QAAQ,EAAE,UAAU,CAAC,aAAa,CAAC,GAAG,SAAS,CAAC;IAChD,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB;AAiBD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,kBAAkB,GAAG,WAAW,CAqBpE;AAiFD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,IAAI,CAWzD;AAsFD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,kBAAkB,EACvB,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,EAChB,oBAAoB,CAAC,EAAE,MAAM,EAC7B,OAAO,CAAC,EAAE,OAAO,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,WAAW,CAiBb;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,GAAG,WAAW,CAQrG"}

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

@@ -0,0 +1,34 @@
+import { Sphere, type Mesh, type Object3D, type Vector3 } from 'three';
+export interface CollisionTargets {
+    /** Flat list of collidable meshes — pass to `Raycaster.intersectObjects(meshes, false)`. */
+    meshes: Mesh[];
+    /** World bounding sphere over `meshes`, or null when there is nothing to hit. */
+    bounds: Sphere | null;
+}
+/**
+ * Collidable geometry for the camera-collision probe in `useCameraConstraints`.
+ *
+ * Raycasting `scene.children` instead costs a full graph walk plus a per-mesh bounding-sphere test
+ * every moving frame, and three's sphere test is against the infinite ray — so geometry far beyond
+ * `raycaster.far` (ground plane, backdrop, the 2D overlay) still reaches triangle level. Restricting
+ * the set is what makes the probe affordable; it also stops visual aids from shoving the camera.
+ *
+ * Two things are collidable, and nothing else:
+ * - the article: every mesh under a planner `Element#` group (mains and their accessories);
+ * - the environment decor GLB: meshes whose geometry carries a three-mesh-bvh `boundsTree`.
+ *   `enableBVHWhenIdle` exists solely to make that GLB cheap for THIS probe (see `core/meshBVH.ts`
+ *   and `EnvironmentSceneLoader`), and nothing else in the package calls it — so a bounds tree is
+ *   the decor's opt-in to blocking the camera, which the walkthrough-style presets rely on for
+ *   their walls. Trees are built lazily, which is why `useCameraConstraints` flushes the queue
+ *   before calling this: a pending tree here reads as "not collidable".
+ *
+ * `userData.outlineExclude` subtrees are pruned: those are the placement boxes and drag previews
+ * that sit inside an element group only to inherit its transform (see `SceneTree`).
+ */
+export declare function collectCollisionTargets(scene: Object3D): CollisionTargets;
+/**
+ * True when no ray of length `probeRange` cast from `cameraPos` can reach `bounds` — the cheap
+ * per-frame reason to skip the collision raycasts outright while the camera orbits at a distance.
+ */
+export declare function isOutOfCollisionRange(cameraPos: Vector3, bounds: Sphere | null, probeRange: number): boolean;
+//# sourceMappingURL=collisionTargets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collisionTargets.d.ts","sourceRoot":"","sources":["../../../../../src/utils/collisionTargets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,MAAM,EAAuB,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AAOlG,MAAM,WAAW,gBAAgB;IAC/B,4FAA4F;IAC5F,MAAM,EAAE,IAAI,EAAE,CAAC;IACf,iFAAiF;IACjF,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,GAAG,gBAAgB,CAQzE;AAeD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAI5G"}

package/build/types/real-time-viewer-next/src/utils/collisionTargets.test.d.ts

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

package/build/types/real-time-viewer-next/src/utils/collisionTargets.test.d.ts.map

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

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

@@ -0,0 +1,21 @@
+/**
+ * Stack arbiter for `document.body.style.cursor`.
+ *
+ * Hover handlers, the 2D plane, the free-grid cells and the accessory follow-drag all set the body
+ * cursor. Left to reset it each on its own, overlapping writers stomp each other's restore and leave
+ * a stale `pointer`/`grabbing` behind. Every writer pushes an entry instead: the most recently pushed
+ * cursor wins, releasing an entry falls back to the one below it, and an empty stack restores the
+ * document default.
+ */
+/**
+ * Shows `cursor` on the document body until the returned release is called. Releasing an entry that
+ * is no longer on the stack is a no-op, so a handler may release more than once.
+ */
+export declare function acquireCursor(cursor: string): () => void;
+/**
+ * Drops every entry. For a gesture that takes over the whole viewport (an orbit drag): the hover
+ * handlers holding the current entries never see a matching pointer-out once the controls capture
+ * the pointer, so nothing else would release them.
+ */
+export declare function clearCursors(): void;
+//# sourceMappingURL=cursorStack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cursorStack.d.ts","sourceRoot":"","sources":["../../../../../src/utils/cursorStack.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,CAUxD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAInC"}

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

@@ -0,0 +1,24 @@
+/**
+ * Multi-signal device-tier detection.
+ *
+ * Resolves the {@link PerformanceProfileTier} that should be used when
+ * `profileMode` is `'auto'` or `'detect'`. The result is cached in `localStorage` so
+ * subsequent loads skip the (synchronous-feeling but async) detect-gpu call.
+ *
+ * Override paths, in priority order:
+ *   1. URL query parameter `?profile=low | medium | high | unsupported`.
+ *   2. localStorage cache from a previous successful run.
+ *   3. Live detection (`detect-gpu` + a few `navigator` signals).
+ *
+ * The fusion is deliberately simple — detect-gpu's tier is the primary signal;
+ * the navigator fields are recorded for telemetry and used only as tie-breakers
+ * / safety nets.
+ */
+import type { DetectedTier } from '../types/environment';
+/**
+ * Detect the performance tier for the current device. Cached on success; the
+ * URL override always wins and is never cached (so flipping `?profile=`
+ * between page loads keeps working).
+ */
+export declare function detectDeviceTier(): Promise<DetectedTier>;
+//# sourceMappingURL=detectDeviceTier.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detectDeviceTier.d.ts","sourceRoot":"","sources":["../../../../../src/utils/detectDeviceTier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,YAAY,EAA4C,MAAM,sBAAsB,CAAC;AA4InG;;;;GAIG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,YAAY,CAAC,CAqF9D"}

package/build/types/real-time-viewer-next/src/utils/detectDeviceTier.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @jest-environment jsdom
+ */
+export {};
+//# sourceMappingURL=detectDeviceTier.test.d.ts.map

package/build/types/real-time-viewer-next/src/utils/detectDeviceTier.test.d.ts.map

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

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

@@ -0,0 +1,7 @@
+import type { RTVScene2D } from '../types/scene2d';
+/**
+ * Partition element ids into independent blocks: each docking group is one block, and every element
+ * not in a docking group is its own single-element block.
+ */
+export declare function partitionGroups(scene2d: RTVScene2D): number[][];
+//# sourceMappingURL=dockingGroups.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dockingGroups.d.ts","sourceRoot":"","sources":["../../../../../src/utils/dockingGroups.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,EAAE,EAAE,CAY/D"}

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

@@ -0,0 +1,27 @@
+export declare function parseElementId(nodeName: string): number;
+/**
+ * Composite element key matching the host's `DivaArticle.shelfElementId`:
+ *   - main element  → `"2"`            (== elementId as string)
+ *   - shelf accessory → `"2.0.6"`       (`parentElementId.gridId.cellIdx`)
+ *   - recursive       → `"2.0.6.0.3"`   (accessory placed on an accessory's grid)
+ *
+ * Derived from the node name suffix after the `E` separator (e.g.
+ * `"Element#PLANNING_xE2.0.6"` → `"2.0.6"`). This is the identity rtv-next keys
+ * `elementsInfo` by, so accessories — whose trailing number is only a cell index —
+ * resolve correctly instead of colliding on `parseElementId`. Assumes the setId
+ * carries no `E` before the element token (same convention as `deriveParentElementName`).
+ */
+export declare function parseElementKey(nodeName: string): string;
+/** A composite key is an accessory when it has more than one dot-separated segment. */
+export declare function isAccessoryKey(elementKey: string): boolean;
+export interface AccessoryPath {
+    /** Composite key of the element this accessory sits on (`"2"` or, recursively, `"2.0.6"`). */
+    parentElementKey: string;
+    gridId: number;
+    cellIdx: number;
+}
+/** Split a composite accessory key into its parent / grid / cell parts (null if not an accessory). */
+export declare function parseAccessoryPath(elementKey: string): AccessoryPath | null;
+export declare const ROT_CORRECTION = 5;
+export declare const AUTO_DOCKING_DISTANCE = 5;
+//# sourceMappingURL=elementIds.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"elementIds.d.ts","sourceRoot":"","sources":["../../../../../src/utils/elementIds.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKxD;AAED,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,MAAM,WAAW,aAAa;IAC5B,8FAA8F;IAC9F,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,sGAAsG;AACtG,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAQ3E;AAED,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,eAAO,MAAM,qBAAqB,IAAI,CAAC"}

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

@@ -0,0 +1,45 @@
+/**
+ * One download + decode per equirectangular source, shared by every consumer of that URL.
+ *
+ * The visible skydome (`SkydomeBackground`) and the IBL (`useEnvironmentMap`) routinely read the
+ * SAME image — `dome.hdr: 'skydome'` derives the environment map from the skydome picture — and
+ * used to fetch and decode it twice, which for the 5504×3072 panoramas the presets ship is the
+ * single most expensive thing in a cold boot.
+ *
+ * They cannot share a `Texture`, though: the two apply DIFFERENT settings to it (the IBL bakes a
+ * u-flipped `repeat`/`offset` in and then disposes the texture; the dome keeps the authored
+ * tile/offset and max anisotropy). So the cache holds one master texture per source that is never
+ * handed out and never mutated, and every caller gets `master.clone()` — a fresh `Texture` that
+ * shares the decoded image/data (`Texture.source`) but owns its own mapping, colorSpace, wrap,
+ * repeat/offset and anisotropy, and is safe to `dispose()`.
+ *
+ * This is deliberately NOT `core/materials/textureCache.ts`: that one caches a single mutated
+ * texture per URL for material maps, which is exactly what the two equirect consumers cannot do.
+ */
+import { type Texture } from 'three';
+/**
+ * Which three.js loader parses a source. Part of the cache key: the two consumers fall back
+ * differently on an unrecognised extension (see {@link skydomeEquirectKind} /
+ * {@link iblEquirectKind}), and a texture decoded by `RGBELoader` is not interchangeable with one
+ * decoded by `TextureLoader`.
+ */
+export type EquirectLoaderKind = 'hdr' | 'exr' | 'ldr';
+/** Loader choice for the visible skydome: an unrecognised extension falls back to `TextureLoader`. */
+export declare function skydomeEquirectKind(url: string): EquirectLoaderKind;
+/** Loader choice for the IBL: an unrecognised extension falls back to `RGBELoader`. */
+export declare function iblEquirectKind(url: string): EquirectLoaderKind;
+/** True when the string names a source these loaders can parse — used to skip preset names. */
+export declare function isEquirectUrl(url: string): boolean;
+/**
+ * Loads an equirectangular source and resolves with a texture the caller owns outright: it may set
+ * mapping / colorSpace / wrap / repeat / anisotropy on it and dispose it, without affecting any
+ * other consumer of the same URL. Only the fetch and the decode are shared.
+ */
+export declare function loadEquirectShared(url: string, kind: EquirectLoaderKind): Promise<Texture>;
+/**
+ * Starts the fetch + decode without waiting for it, so it overlaps whatever else the boot is doing
+ * (typically WebGL context creation). The consumer that actually needs the texture calls
+ * {@link loadEquirectShared} and reports any failure, so a rejection here is swallowed.
+ */
+export declare function preloadEquirect(url: string, kind: EquirectLoaderKind): void;
+//# sourceMappingURL=equirectCache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"equirectCache.d.ts","sourceRoot":"","sources":["../../../../../src/utils/equirectCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAgC,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AAMnE;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAEvD,sGAAsG;AACtG,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAInE;AAED,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAI/D;AAED,+FAA+F;AAC/F,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD;AA0DD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAE1F;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAE3E"}

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

@@ -0,0 +1,22 @@
+/**
+ * Format classification for equirectangular source URLs, shared by the IBL
+ * dome and the visible skydome.
+ *
+ * The extension decides which three.js loader can parse the file and whether
+ * its pixels arrive linear (Radiance `.hdr`, OpenEXR `.exr`) or as sRGB bytes
+ * (LDR image). Blob URLs from the file picker carry no extension at all, so
+ * `pickFile()` appends an `#ext=.hdr` / `#ext=.exr` hint that these predicates
+ * accept alongside a real extension.
+ *
+ * Each caller keeps its own fallback: an unrecognised URL goes to `RGBELoader`
+ * on the IBL side and to `TextureLoader` on the skydome side.
+ */
+/** Radiance HDR — parsed by `RGBELoader`, pixels already linear. */
+export declare function isHdrUrl(url: string): boolean;
+/** OpenEXR — parsed by `EXRLoader`, pixels already linear. */
+export declare function isExrUrl(url: string): boolean;
+/** LDR image formats — parsed by `TextureLoader`, pixels are sRGB bytes. */
+export declare function isLdrImageUrl(url: string): boolean;
+/** Strip the `#ext=…` hint so loaders receive a fetchable URL. */
+export declare function cleanEquirectUrl(url: string): string;
+//# sourceMappingURL=equirectUrl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"equirectUrl.d.ts","sourceRoot":"","sources":["../../../../../src/utils/equirectUrl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,oEAAoE;AACpE,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE7C;AAED,8DAA8D;AAC9D,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE7C;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD"}

package/build/types/real-time-viewer-next/src/utils/equirectUrl.test.d.ts

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

package/build/types/real-time-viewer-next/src/utils/equirectUrl.test.d.ts.map

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

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

@@ -0,0 +1,15 @@
+export { type FootprintPoint, ensureSimplePolygon, isSimplePolygon, polygonSignedArea, simplifyClosedPolygon } from './polygon2d';
+export { type TraceDiagnostics, type TraceFootprintOptions, traceFootprintFromTriangles } from './footprintTrace';
+/** The subset of a deckCutout article rule the matcher needs. */
+export interface ArticleRuleMatchable {
+    /** Comma-separated substrings OR-matched against the articleCodex; `''` or `'*'` matches every article (codex known or not). */
+    match: string;
+}
+/**
+ * First-match-wins lookup of an article rule by codex. Wildcard rules
+ * (`match: '*'` or empty) match even when no codex is known — they double as
+ * the fallback entry and keep footprints testable before the host ships
+ * per-element codexes.
+ */
+export declare function matchArticleRule<T extends ArticleRuleMatchable>(rules: readonly T[], articleCodex: string | undefined): T | null;
+//# sourceMappingURL=footprint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"footprint.d.ts","sourceRoot":"","sources":["../../../../../src/utils/footprint.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,KAAK,cAAc,EAAE,mBAAmB,EAAE,eAAe,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAClI,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAElH,iEAAiE;AACjE,MAAM,WAAW,oBAAoB;IACnC,gIAAgI;IAChI,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,oBAAoB,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,CAAC,GAAG,IAAI,CAahI"}

package/build/types/real-time-viewer-next/src/utils/footprint.test.d.ts

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

package/build/types/real-time-viewer-next/src/utils/footprint.test.d.ts.map

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