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

package/build/types/real-time-viewer-next/src/core/environment/PlainGround.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import type { ResolvedGroundConfig } from '../../types/environment';
+interface PlainGroundProps {
+    config: ResolvedGroundConfig;
+}
+/**
+ * Lightweight production ground plane, two flavors selected by `surface`:
+ * - `'plain'`: a visible flat solid-color matte floor that also receives shadows.
+ * - `'shadow'`: an invisible shadow catcher (`shadowMaterial`) — transparent
+ *   except where a shadow lands, the Three.js equivalent of Babylon's
+ *   `ShadowOnlyMaterial` used by the old real-time-viewer's white-room.
+ *
+ * The mesh sits at the scene's floor (`metrics.floorY + yOffset`), centered on
+ * the scene, and receives shadows via the central shadow registry (`sceneGeo`),
+ * so it honors the same `Receivers › Scene Geometry` toggle as real geometry.
+ * A flat plane lit from above casts essentially nothing, so it's a receiver
+ * only in practice.
+ */
+export declare function PlainGround({ config }: PlainGroundProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=PlainGround.d.ts.map

package/build/types/real-time-viewer-next/src/core/environment/PlainGround.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlainGround.d.ts","sourceRoot":"","sources":["../../../../../../src/core/environment/PlainGround.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAiB,MAAM,OAAO,CAAC;AAItC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,UAAU,gBAAgB;IACxB,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,gBAAgB,qBA2BvD"}

package/build/types/real-time-viewer-next/src/core/environment/RuntimePerfAdjuster.d.ts

@@ -0,0 +1,15 @@
+/** [lower, upper] FPS bounds for the shared `<PerformanceMonitor>`. */
+export declare const PERF_BOUNDS: (refreshrate: number) => [number, number];
+/**
+ * Runtime profile adjuster: relays drei's sustained-FPS callbacks to the store,
+ * which steps the active tier (auto mode only) under its own oscillation guards.
+ *
+ * No `onFallback` handler on purpose: drei fires it when its incline/decline
+ * counter exceeds `flipflops`, which a vsync-capped-but-smooth scene trips via
+ * repeated inclines — demoting good frames. `SceneEnvironment` leaves
+ * `flipflops` at its default (Infinity) and the store guards handle oscillation.
+ *
+ * Must be mounted as a child of `<PerformanceMonitor>`.
+ */
+export declare function RuntimePerfAdjuster(): null;
+//# sourceMappingURL=RuntimePerfAdjuster.d.ts.map

package/build/types/real-time-viewer-next/src/core/environment/RuntimePerfAdjuster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimePerfAdjuster.d.ts","sourceRoot":"","sources":["../../../../../../src/core/environment/RuntimePerfAdjuster.tsx"],"names":[],"mappings":"AAGA,uEAAuE;AACvE,eAAO,MAAM,WAAW,gBAAiB,MAAM,KAAG,CAAC,MAAM,EAAE,MAAM,CAGhE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAgB1C"}

package/build/types/real-time-viewer-next/src/core/environment/SceneEnvironment.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+/**
+ * Mounts the env-driven scene surfaces.
+ *
+ * The lifetime/visibility split (see `core/viewMode/types.ts`) means
+ * `mount*` flags are capability-driven and immutable across 2D ↔ 3D
+ * toggles — every 3D-capable product keeps these subtrees mounted so
+ * the GLB / RT / shader cost is paid once. Per-frame visibility for
+ * the decoration cluster is gated by the single
+ * `<group visible={runtime.show3DDecoration}>` wrapper below, which
+ * three.js converts into a free per-frame skip (no GPU teardown).
+ *
+ * `EnvironmentDome` (IBL source) and `LightingRig` deliberately sit
+ * OUTSIDE the visibility group: the SVG planes use unlit
+ * `meshBasicMaterial` so lights/IBL don't affect them, and keeping
+ * lights warm avoids a re-entry flicker when toggling back to 3D.
+ */
+export declare function SceneEnvironment(): React.JSX.Element;
+//# sourceMappingURL=SceneEnvironment.d.ts.map

package/build/types/real-time-viewer-next/src/core/environment/SceneEnvironment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneEnvironment.d.ts","sourceRoot":"","sources":["../../../../../../src/core/environment/SceneEnvironment.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmB,MAAM,OAAO,CAAC;AAcxC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,sBAwD/B"}

package/build/types/real-time-viewer-next/src/core/environment/SkydomeBackground.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+/**
+ * Renders a user-provided image on a large sphere or hemisphere (equirectangular projection).
+ * Unlike HDRI, a skydome texture does NOT affect IBL lighting — it is purely visual.
+ * When active, it overrides the HDRI background but keeps HDRI-based reflections/lighting.
+ *
+ * Uses MeshBasicMaterial (unlit) on BackSide so the dome never blocks or receives
+ * light, never casts/receives shadows, and is invisible to raycasting.
+ */
+export declare function SkydomeBackground(): React.JSX.Element | null;
+//# sourceMappingURL=SkydomeBackground.d.ts.map

package/build/types/real-time-viewer-next/src/core/environment/SkydomeBackground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkydomeBackground.d.ts","sourceRoot":"","sources":["../../../../../../src/core/environment/SkydomeBackground.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuC,MAAM,OAAO,CAAC;AAmB5D;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,6BA2BhC"}

package/build/types/real-time-viewer-next/src/core/environment/SunLensflare.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+export interface SunLensflareProps {
+    /** World-space unit vector from origin toward the sun (same as `<Sky>` / directional sun). */
+    sunDirection: [number, number, number];
+    color?: string;
+    /** Multiplier on the camera-relative anchor distance ({@link FLARE_FORWARD_DISTANCE}). */
+    distanceScale?: number;
+    /** Multiplier applied to element sizes (burst and ghosts; default 1.0). */
+    sizeScale?: number;
+    /**
+     * When `true` (default), the flare alpha and anchor are shaped each frame by
+     * a 9-tap raycaster sampling around the sun direction. Set `false` to skip
+     * all raycasting and scene traversal — flare stays at full intensity. Use
+     * this on heavy scenes (lots of meshes, large `InstancedMesh`es nearby) when
+     * you don't need physical sun occlusion.
+     */
+    occlusionEnabled?: boolean;
+}
+/**
+ * Additive billboard lens flare on the sun direction: haze burst on the sun plus a chromatic
+ * ghost train (aperture hexagons, soft dots, a ring) laid out in screen space along the
+ * sun→screen-center axis, fading as the sun leaves the frame.
+ *
+ * Does **not** use `three/examples/jsm/objects/Lensflare.js`: that helper reads the framebuffer for
+ * occlusion (`copyFramebufferToTexture`), which fails or zeroes alpha when the scene is drawn through
+ * pmndrs `EffectComposer` / multisampled targets.
+ */
+export declare function SunLensflare({ sunDirection, color, distanceScale, sizeScale, occlusionEnabled }: SunLensflareProps): React.JSX.Element;
+//# sourceMappingURL=SunLensflare.d.ts.map

package/build/types/real-time-viewer-next/src/core/environment/SunLensflare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SunLensflare.d.ts","sourceRoot":"","sources":["../../../../../../src/core/environment/SunLensflare.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqC,MAAM,OAAO,CAAC;AA6M1D,MAAM,WAAW,iBAAiB;IAChC,8FAA8F;IAC9F,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0FAA0F;IAC1F,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,EAAE,YAAY,EAAE,KAAiB,EAAE,aAAmB,EAAE,SAAe,EAAE,gBAAuB,EAAE,EAAE,iBAAiB,qBAgMjJ"}

package/build/types/real-time-viewer-next/src/core/environment/SunLensflareLazy.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { SunLensflareProps } from './SunLensflare';
+/**
+ * Starts the lensflare chunk download. Called from `preloadLazySubsystems` as soon as the resolved
+ * config enables the flare, so the chunk lands with the scene's other assets rather than after the
+ * first frame that should already show it.
+ */
+export declare function preloadSunLensflare(): void;
+/** `SunLensflare` behind its chunk boundary — identical props. */
+export declare function SunLensflareLazy(props: SunLensflareProps): React.JSX.Element;
+//# sourceMappingURL=SunLensflareLazy.d.ts.map

package/build/types/real-time-viewer-next/src/core/environment/SunLensflareLazy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SunLensflareLazy.d.ts","sourceRoot":"","sources":["../../../../../../src/core/environment/SunLensflareLazy.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyB,MAAM,OAAO,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAiBxD;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAKD,kEAAkE;AAClE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,qBAMxD"}

package/build/types/real-time-viewer-next/src/core/environment/adaptive.config.d.ts

@@ -0,0 +1,24 @@
+import { type ConfigInput, type ConfigResolved } from '../../config/descriptor';
+/**
+ * Toggles for drei's adaptive helpers — small components `SceneEnvironment` mounts conditionally,
+ * composing with the existing `PerformanceMonitor` to react to frame-budget pressure. The single
+ * source for their types, defaults, round-trip and analyzer inputs (see `config/descriptor.ts`).
+ *
+ * This is the fine perf lever within a profile; the coarse lever is the runtime tier adjuster
+ * (`RuntimePerfAdjuster`). Both share one `<PerformanceMonitor>`.
+ */
+export declare const ADAPTIVE_CONFIG: import("../../config/descriptor").GroupDescriptor<{
+    /** Drops DPR when the monitor reports decline — a safety net beneath the static `renderer.dpr`. */
+    adaptiveDpr: import("../../config/descriptor").BooleanField;
+    /** Throttles pointer events when the frame budget is tight, at the cost of hover latency. */
+    adaptiveEvents: import("../../config/descriptor").BooleanField;
+    /**
+     * Bakes the shadow map once on the first frame and freezes it. Ideal for static planner scenes;
+     * not safe when shadow casters move. Surfaced in the analyzer's Shadows panel, next to the rest
+     * of the shadow controls.
+     */
+    bakeShadows: import("../../config/descriptor").BooleanField;
+}>;
+export type AdaptiveConfig = ConfigInput<typeof ADAPTIVE_CONFIG>;
+export type ResolvedAdaptiveConfig = ConfigResolved<typeof ADAPTIVE_CONFIG>;
+//# sourceMappingURL=adaptive.config.d.ts.map

package/build/types/real-time-viewer-next/src/core/environment/adaptive.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptive.config.d.ts","sourceRoot":"","sources":["../../../../../../src/core/environment/adaptive.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEvF;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe;IAC1B,mGAAmG;;IAKnG,6FAA6F;;IAK7F;;;;OAIG;;EAKH,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,WAAW,CAAC,OAAO,eAAe,CAAC,CAAC;AACjE,MAAM,MAAM,sBAAsB,GAAG,cAAc,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/build/types/real-time-viewer-next/src/core/environment/adaptive.config.test.d.ts

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

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

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

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/DeckCutoutArticleSync.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Drives the cutout outline, element placement and water volume from the live
+ * article geometry (`deckCutout.articleSync` and friends):
+ *
+ * 1. {@link measureArticle} takes the union AABB of all planner `Element#`
+ *    groups in the floor meshes' shared local space.
+ * 2. {@link deriveArticleFootprint} shapes the cutout outline →
+ *    `deckCutoutFootprintOverride`, which `DeckCutoutCollar` fills against the
+ *    deck's authored hole. Its traced rim replaces the measured extents for the
+ *    steps below, so parts under the deck don't inflate placement/water.
+ * 3. {@link deriveElementAnchor} repositions the elements so their bbox rests
+ *    inside the authored hole (HQS `PosPivot === 'CENTER'` grows articles from
+ *    center, so the resting spot has to be re-derived) → `elementAnchorOffsets`.
+ * 4. {@link deriveWaterVolume} follows the anchored rect → `waterVolumeOverride`.
+ *
+ * Re-converges (per-frame measuring) when article or decor geometry lands, and
+ * otherwise re-measures on a slow idle cadence for the inputs that have no
+ * event (imperative scene-transform edits). All writers are epsilon-compared,
+ * so unchanged measurements are no-ops.
+ */
+export declare function DeckCutoutArticleSync(): null;
+//# sourceMappingURL=DeckCutoutArticleSync.d.ts.map

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/DeckCutoutArticleSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeckCutoutArticleSync.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/environment/deckCutout/DeckCutoutArticleSync.tsx"],"names":[],"mappings":"AA6BA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,SAyKpC"}

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/DeckCutoutCollar.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+/**
+ * Generated coping collar for footprint-rule cutouts (`deckCutout.articleRules`):
+ * a flat ring filling the space between the deck's authored rectangular hole and
+ * the article's shaped outline. This is what makes the cutout follow the article
+ * — the deck GLB itself is never touched. Rendered only while
+ * `DeckCutoutArticleSync` publishes a footprint outline.
+ *
+ * It wears the DECK's material and continues the deck's own UV mapping (see
+ * {@link buildCollarGeometry}), unless the config declares own maps. The ring
+ * follows a name-matched floor mesh's world matrix every frame, so
+ * scene-transform edits need no rebuild.
+ */
+export declare function DeckCutoutCollar(): React.JSX.Element | null;
+//# sourceMappingURL=DeckCutoutCollar.d.ts.map

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/DeckCutoutCollar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeckCutoutCollar.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/environment/deckCutout/DeckCutoutCollar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AA8BjF;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,6BAkK/B"}

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/DeckCutoutLazy.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+/**
+ * Starts the deck-cutout chunk download. Called from `preloadLazySubsystems` as soon as the
+ * resolved config enables the cutout, so the chunk is in by the time the scene mounts — the collar
+ * holds the scene reveal from its own mount effect, and that hold must not wait on a network trip.
+ */
+export declare function preloadDeckCutout(): void;
+/** The deck-cutout subsystem behind its chunk boundary — same (prop-less) surface as the pair it wraps. */
+export declare function DeckCutoutLazy(): React.JSX.Element;
+//# sourceMappingURL=DeckCutoutLazy.d.ts.map

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/DeckCutoutLazy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeckCutoutLazy.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/environment/deckCutout/DeckCutoutLazy.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyB,MAAM,OAAO,CAAC;AAiB9C;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAKD,2GAA2G;AAC3G,wBAAgB,cAAc,sBAM7B"}

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/DeckCutoutSubsystem.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+/**
+ * The deck-cutout drivers as one unit: the sync measures the article and publishes the outline /
+ * water volume, the collar renders what the sync published. They are always mounted together, and
+ * pairing them here gives {@link DeckCutoutLazy} a single module to pull the whole subsystem
+ * across the chunk boundary.
+ */
+export declare function DeckCutoutSubsystem(): React.JSX.Element;
+//# sourceMappingURL=DeckCutoutSubsystem.d.ts.map

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/DeckCutoutSubsystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeckCutoutSubsystem.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/environment/deckCutout/DeckCutoutSubsystem.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B;;;;;GAKG;AACH,wBAAgB,mBAAmB,sBAOlC"}

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/anchorElements.d.ts

@@ -0,0 +1,40 @@
+import { type Matrix4, type Object3D } from 'three';
+import type { ResolvedDeckCutoutConfig, ResolvedDeckCutoutHole, DeckCutoutAnchorMode } from '../../../types/environment';
+import { type ArticleRect } from './measureArticle';
+/**
+ * Distance to move one axis so the anchored part of the measured article lands
+ * on the anchored part of the region. `'min'`/`'max'` pin that edge (the offset
+ * reads as an inset from it) so the article grows away from it; `'center'`
+ * centres, so it grows both ways.
+ */
+export declare function anchorDelta1D(mode: DeckCutoutAnchorMode, center: number, halfExtent: number, measuredMin: number, measuredMax: number, offset: number): number;
+export interface ElementAnchorInput {
+    /** Measured article rect, floor-local — it already includes the currently applied offsets. */
+    rect: ArticleRect;
+    hole: ResolvedDeckCutoutHole;
+    anchor: ResolvedDeckCutoutConfig['elementAnchor'];
+    floorWorld: Matrix4;
+    elementObjects: Object3D[];
+    deckTopLocalY: number;
+    currentOffsets: Record<string, [number, number, number]>;
+}
+export interface ElementAnchor {
+    /** Floor-local delta the elements move by. */
+    delta: {
+        dx: number;
+        dy: number;
+        dz: number;
+    };
+    /** `elementAnchorOffsets` to publish — the world correction accumulated onto the current offsets. */
+    offsets: Record<string, [number, number, number]>;
+}
+/**
+ * Nudge the top-level element groups so the measured article rect settles at
+ * the hole center (+ configured fine-tune offsets), optionally lifting it so
+ * its top meets the deck. The measured rect already includes the currently
+ * applied offsets, so the correction is incremental and converges in one
+ * measurement. Null once it is within {@link ANCHOR_EPSILON} — or when there is
+ * no top-level element to move.
+ */
+export declare function deriveElementAnchor({ rect, hole, anchor, floorWorld, elementObjects, deckTopLocalY, currentOffsets, }: ElementAnchorInput): ElementAnchor | null;
+//# sourceMappingURL=anchorElements.d.ts.map

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/anchorElements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchorElements.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/environment/deckCutout/anchorElements.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE7D,OAAO,KAAK,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AACzH,OAAO,EAAoB,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAQtE;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,oBAAoB,EAC1B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,MAAM,CAIR;AAED,MAAM,WAAW,kBAAkB;IACjC,8FAA8F;IAC9F,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,sBAAsB,CAAC;IAC7B,MAAM,EAAE,wBAAwB,CAAC,eAAe,CAAC,CAAC;IAClD,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,QAAQ,EAAE,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,KAAK,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,qGAAqG;IACrG,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,UAAU,EACV,cAAc,EACd,aAAa,EACb,cAAc,GACf,EAAE,kBAAkB,GAAG,aAAa,GAAG,IAAI,CAgC3C"}

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/anchorElements.test.d.ts

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

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/anchorElements.test.d.ts.map

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

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/articleFootprint.d.ts

@@ -0,0 +1,62 @@
+import { type TraceDiagnostics, type FootprintPoint } from '../../../utils/footprint';
+import type { ResolvedDeckCutoutArticleRule } from '../../../types/environment';
+import { type ArticleMeasurement, type ArticleRect, type ElementCodexArea } from './measureArticle';
+export interface GeometryFootprintCache {
+    signature: string;
+    /** Traced outline relative to the article union-bbox min corner (floor-local XZ) at trace time. */
+    relPoints: FootprintPoint[];
+    triCount: number;
+    vertexCount: number;
+}
+/** XZ extents of the article's traced rim. */
+export interface RimExtent {
+    minX: number;
+    maxX: number;
+    minZ: number;
+    maxZ: number;
+}
+export interface ArticleFootprint {
+    /** The collar's inner boundary in floor-local XZ (deck margin already applied), null when no usable outline came out. */
+    points: FootprintPoint[] | null;
+    /**
+     * Article RIM extents from a believable trace — they replace the measured XZ
+     * extents, so parts under the deck don't inflate placement and water. Null
+     * keeps the measured rect.
+     */
+    rim: RimExtent | null;
+    sampledCount: number;
+    /** Human-readable provenance of `points`; '' when no footprint rule applied. */
+    source: string;
+    /** Set when a guard had to repair or reject the traced outline. */
+    repairNote: string;
+    /** Traced bbox for the diagnostic, '' when nothing was traced. */
+    tracedBounds: string;
+    trace: TraceDiagnostics;
+}
+/**
+ * Rectangular fallback outline in floor-local XZ: the measured article rect
+ * grown by `margin` per side (negative laps the deck over the article). Null
+ * when the margin would collapse the rect.
+ */
+export declare function measuredRectFootprint(rect: ArticleRect, margin: number): FootprintPoint[] | null;
+/**
+ * First rule matching any element's codex, largest element first — but every
+ * element gets a look: an accessory bigger in plan than the article it belongs
+ * to (a roof, a surround) would otherwise name the scene, match nothing, and
+ * leave the deck area with no collar at all. `primaryCodex` reports whichever
+ * codex found the rule.
+ */
+export declare function pickArticleRule(rules: readonly ResolvedDeckCutoutArticleRule[], codexesByArea: readonly ElementCodexArea[]): {
+    rule: ResolvedDeckCutoutArticleRule | null;
+    primaryCodex: string | undefined;
+};
+/**
+ * The cutout outline for a measured article — offset by the deck margin, so it
+ * comes back as the collar's inner boundary. Needs no calibration: the trace
+ * follows the visible rim. Only `footprintFromGeometry` rules produce one;
+ * without such a rule the deck's authored hole stays fully open.
+ */
+export declare function deriveArticleFootprint(measurement: ArticleMeasurement, rule: ResolvedDeckCutoutArticleRule | null, margin: number, cache: {
+    current: GeometryFootprintCache | null;
+}): ArticleFootprint;
+//# sourceMappingURL=articleFootprint.d.ts.map

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/articleFootprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"articleFootprint.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/environment/deckCutout/articleFootprint.ts"],"names":[],"mappings":"AACA,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAoB,KAAK,kBAAkB,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAsBtH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,mGAAmG;IACnG,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,8CAA8C;AAC9C,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,yHAAyH;IACzH,MAAM,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IAChC;;;;OAIG;IACH,GAAG,EAAE,SAAS,GAAG,IAAI,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,gBAAgB,CAAC;CACzB;AAWD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE,GAAG,IAAI,CAYhG;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,6BAA6B,EAAE,EAC/C,aAAa,EAAE,SAAS,gBAAgB,EAAE,GACzC;IAAE,IAAI,EAAE,6BAA6B,GAAG,IAAI,CAAC;IAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAYlF;AA6FD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,kBAAkB,EAC/B,IAAI,EAAE,6BAA6B,GAAG,IAAI,EAC1C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;IAAE,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAAA;CAAE,GAChD,gBAAgB,CA6ElB"}

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/articleFootprint.test.d.ts

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

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/articleFootprint.test.d.ts.map

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

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/buildCollarGeometry.d.ts

@@ -0,0 +1,25 @@
+import { type BufferGeometry } from 'three';
+import type { FootprintPoint } from '../../../utils/footprint';
+import type { ResolvedDeckCutoutCollar, ResolvedDeckCutoutCollarMaterial, ResolvedDeckCutoutHole } from '../../../types/environment';
+import { type DeckSurface } from './collectDeckTriangles';
+export interface CollarGeometryInput {
+    /** Collar inner boundary in floor-local XZ — at least 3 points. */
+    footprint: readonly FootprintPoint[];
+    hole: ResolvedDeckCutoutHole;
+    collar: ResolvedDeckCutoutCollar;
+    deck: Pick<DeckSurface, 'topY' | 'slabThickness' | 'triangles' | 'triangleCount' | 'uvFit'> & Partial<Pick<DeckSurface, 'triangleIndex'>>;
+    /** Declared own-material tiling, or null to continue the deck's own mapping. */
+    ownMaterial: ResolvedDeckCutoutCollarMaterial | null;
+}
+/**
+ * The collar ring, built in the floor meshes' shared local space (outline and
+ * hole rect are floor-local): a skirt is extruded downward along the inner edge
+ * so nothing shows through under the deck, the top sits `collar.recess` below
+ * the deck surface and the outer edge tucks `collar.overlap` under the deck —
+ * the last two kill z-fighting with the slab.
+ */
+export declare function buildCollarGeometry({ footprint, hole, collar, deck, ownMaterial }: CollarGeometryInput): {
+    geometry: BufferGeometry;
+    diagnostic: string;
+};
+//# sourceMappingURL=buildCollarGeometry.d.ts.map

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/buildCollarGeometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildCollarGeometry.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/environment/deckCutout/buildCollarGeometry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiD,KAAK,cAAc,EAAE,MAAM,OAAO,CAAC;AAE3F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,wBAAwB,EAAE,gCAAgC,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACrI,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAK/E,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;IACrC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,MAAM,EAAE,wBAAwB,CAAC;IACjC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,GAAG,WAAW,GAAG,eAAe,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC,CAAC;IAC1I,gFAAgF;IAChF,WAAW,EAAE,gCAAgC,GAAG,IAAI,CAAC;CACtD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,mBAAmB,GAAG;IACxG,QAAQ,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB,CAqGA"}

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/buildCollarGeometry.test.d.ts

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

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/buildCollarGeometry.test.d.ts.map

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

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/collectDeckTriangles.d.ts

@@ -0,0 +1,86 @@
+import { type Material, type Mesh, type Object3D } from 'three';
+import { type AffineUV, type TriangleGridIndex } from '../../../utils/localUVSampler';
+/**
+ * How far (m) a single fitted mapping may miss the deck's own triangles before
+ * it is rejected in favour of per-vertex sampling. Below this the deck's unwrap
+ * is one plane, and one mapping reproduces it without the shear per-vertex
+ * sampling introduces between neighbouring generated triangles.
+ */
+export declare const UV_FIT_MAX_RESIDUAL = 0.005;
+/** What the collar needs to look like a continuation of the deck it fills. */
+export interface DeckSurface {
+    meshName: string;
+    /** Deck top in floor-local Y. */
+    topY: number;
+    /** The deck slab's own thickness — the collar matches it unless `collar.skirtDepth` overrides. */
+    slabThickness: number;
+    /** Clone of the deck material, or null when the deck has no usable surface — then the configured collar color is used. */
+    material: Material | null;
+    /** Deck triangles around the cutout — (x, z, u, v) per vertex — in the reference floor's local space. */
+    triangles: Float32Array | null;
+    triangleCount: number;
+    /**
+     * Spatial index over {@link triangles}, or null when a linear scan is the
+     * better bet. Built here rather than at geometry-build time: it depends on the
+     * deck alone, and the deck is sampled as soon as its GLBs mount — well before
+     * the article publishes the outline the collar geometry needs.
+     */
+    triangleIndex: TriangleGridIndex | null;
+    /** Which UV attribute the deck's visible pattern samples, i.e. what the collar must continue. */
+    attributeName: string;
+    /** One mapping covering the whole deck, when its unwrap turns out to be a single plane. */
+    uvFit: AffineUV | null;
+    /**
+     * Union XZ extent of the matched deck meshes, deck-local. Reported because it
+     * IS the `authoredHole` rect to use if those meshes are dropped from the scene
+     * and the collar is made to own their whole area.
+     */
+    extent: {
+        minX: number;
+        maxX: number;
+        minZ: number;
+        maxZ: number;
+    } | null;
+}
+/** Every mesh under `root` whose name contains one of `patterns`, in traversal order. */
+export declare function meshesMatching(root: Object3D, patterns: string[]): Mesh[];
+/**
+ * The UV attribute the deck's VISIBLE pattern reads. Read from the material
+ * rather than assumed, because copying the wrong channel of a multi-unwrap
+ * asset yields a pattern that is subtly the wrong size.
+ */
+export declare function patternAttributeName(material: Material | Material[]): string;
+/**
+ * Collect the top-surface triangles of every matched deck mesh as a flat
+ * (x, z, u, v)-per-vertex soup in `reference`'s local space, reading the UV
+ * attribute the deck's pattern actually samples.
+ *
+ * No proximity filter: `nodeMatch` names the deck to continue, so everything it
+ * names is the sample set. Filtering by distance to the cutout drops slabs whose
+ * TRIANGLE CENTROIDS fall outside the radius — which silently discards a deck
+ * modelled as a few large quads and leaves the collar with no material at all.
+ */
+export declare function collectDeckTriangles(meshes: Mesh[], reference: Mesh, attributeName: string): {
+    triangles: Float32Array;
+    triangleCount: number;
+    /** Union XZ extent of the matched deck meshes in `reference`'s frame. */
+    extent: {
+        minX: number;
+        maxX: number;
+        minZ: number;
+        maxZ: number;
+    };
+} | null;
+/**
+ * Sample the deck the collar has to continue: the first name-matched mesh is the
+ * reference frame, all matched meshes feed the UV sample.
+ */
+export declare function sampleDeckSurface(scene: Object3D, patterns: string[]): {
+    reference: Mesh | null;
+    surface: DeckSurface | null;
+};
+/** Identity of a sampled surface — a fresh surface object rebuilds the collar geometry, so only an actual change may be applied. */
+export declare function deckSurfaceKey(surface: DeckSurface | null): string;
+/** One-shot diagnostic lines for a newly acquired deck surface. */
+export declare function describeDeckSurface(surface: DeckSurface, hasOwnMaterial: boolean): string[];
+//# sourceMappingURL=collectDeckTriangles.d.ts.map

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/collectDeckTriangles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectDeckTriangles.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/environment/deckCutout/collectDeckTriangles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmD,KAAK,QAAQ,EAAE,KAAK,IAAI,EAAE,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjH,OAAO,EAA2D,KAAK,QAAQ,EAAE,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAI/I;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AAOzC,8EAA8E;AAC9E,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,kGAAkG;IAClG,aAAa,EAAE,MAAM,CAAC;IACtB,0HAA0H;IAC1H,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,yGAAyG;IACzG,SAAS,EAAE,YAAY,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,aAAa,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACxC,iGAAiG;IACjG,aAAa,EAAE,MAAM,CAAC;IACtB,2FAA2F;IAC3F,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAC;IACvB;;;;OAIG;IACH,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC3E;AAED,yFAAyF;AACzF,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,CAOzE;AAkBD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,EAAE,GAAG,MAAM,CAI5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,IAAI,EAAE,EACd,SAAS,EAAE,IAAI,EACf,aAAa,EAAE,MAAM,GACpB;IACD,SAAS,EAAE,YAAY,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACpE,GAAG,IAAI,CAoEP;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG;IAAE,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;CAAE,CAyB9H;AAED,oIAAoI;AACpI,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,GAAG,MAAM,CAElE;AAED,mEAAmE;AACnE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,OAAO,GAAG,MAAM,EAAE,CAoB3F"}

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/deriveWaterVolume.d.ts

@@ -0,0 +1,28 @@
+import { type Matrix4 } from 'three';
+import type { ResolvedDeckCutoutConfig } from '../../../types/environment';
+import type { ArticleRect } from './measureArticle';
+export interface WaterVolume {
+    center: [number, number, number];
+    size: [number, number, number];
+}
+export interface WaterVolumeInput {
+    /** Article rect where the element anchor settles it, floor-local. */
+    rect: ArticleRect;
+    waterSync: ResolvedDeckCutoutConfig['waterSync'];
+    floorWorld: Matrix4;
+    /** Measured article bottom in WORLD space — floor-local Y is not guaranteed world-up. */
+    articleWorldBottomY: number;
+    /** Configured waterline (`water.volume` center Y), the one value that is not derived. */
+    waterlineY: number;
+}
+/**
+ * Water volume following the MEASURED article rect — the water surface is a
+ * property of the pool, not of the cutout, so it tracks the pool wherever the
+ * element anchor settles it. No feedback: water never influences the measurement.
+ *
+ * The DEPTH is derived too: waterline down to the measured article bottom. The
+ * volume only needs to BOUND the pool interior; the PoolHeightMap finds the real
+ * floor within it.
+ */
+export declare function deriveWaterVolume({ rect, waterSync, floorWorld, articleWorldBottomY, waterlineY }: WaterVolumeInput): WaterVolume;
+//# sourceMappingURL=deriveWaterVolume.d.ts.map

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/deriveWaterVolume.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deriveWaterVolume.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/environment/deckCutout/deriveWaterVolume.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AACvD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAUpD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,wBAAwB,CAAC,WAAW,CAAC,CAAC;IACjD,UAAU,EAAE,OAAO,CAAC;IACpB,yFAAyF;IACzF,mBAAmB,EAAE,MAAM,CAAC;IAC5B,yFAAyF;IACzF,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,mBAAmB,EAAE,UAAU,EAAE,EAAE,gBAAgB,GAAG,WAAW,CAkBjI"}

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/deriveWaterVolume.test.d.ts

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

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/deriveWaterVolume.test.d.ts.map

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

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/measureArticle.d.ts

@@ -0,0 +1,49 @@
+import { Matrix4, type Object3D } from 'three';
+import type { ElementOverlayInfo } from '../../../types/plannerUi';
+/** Article bounds in the deck mesh's local frame. */
+export interface ArticleRect {
+    minX: number;
+    maxX: number;
+    minY: number;
+    maxY: number;
+    minZ: number;
+    maxZ: number;
+}
+/** One planner element's article codex and its plan area, for the rule lookup. */
+export interface ElementCodexArea {
+    codex: string;
+    area: number;
+}
+export interface ArticleMeasurement {
+    rect: ArticleRect;
+    /** Article bottom (pool shell underside) in WORLD space — floor-local Y is not guaranteed world-up. */
+    worldBottomY: number;
+    /** Every planner `Element#` group in the scene, in traversal order. */
+    elementObjects: Object3D[];
+    /** Codex of every element that has one, largest in plan first. */
+    codexesByArea: ElementCodexArea[];
+    /** LIVE world matrix of the reference deck mesh — it tracks scene-transform edits. */
+    floorWorld: Matrix4;
+    /** World → deck-local. */
+    floorLocal: Matrix4;
+    /** Deck top in floor-local Y. */
+    floorTopY: number;
+}
+/** Top-level planner element groups (no `Element#` ancestor) — the ones the anchor moves and the projection walks. */
+export declare function topLevelElements(elementObjects: Object3D[]): Object3D[];
+/** Same rect moved by a floor-local delta. */
+export declare function shiftRect(rect: ArticleRect, delta: {
+    dx: number;
+    dy: number;
+    dz: number;
+}): ArticleRect;
+/**
+ * Union bounds of every planner `Element#` group, expressed in the floor meshes'
+ * shared local space via the first name-matched deck mesh's inverse world
+ * matrix. That mesh is the one `meshesMatching` also hands the collar as its
+ * reference, so both work in identical coordinates.
+ *
+ * Returns null while the article or the deck isn't in the scene yet.
+ */
+export declare function measureArticle(scene: Object3D, patterns: string[], elementsInfo: ReadonlyMap<string, ElementOverlayInfo>): ArticleMeasurement | null;
+//# sourceMappingURL=measureArticle.d.ts.map

package/build/types/real-time-viewer-next/src/core/environment/deckCutout/measureArticle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measureArticle.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/environment/deckCutout/measureArticle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEhE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAOnE,qDAAqD;AACrD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,kFAAkF;AAClF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,WAAW,CAAC;IAClB,uGAAuG;IACvG,YAAY,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,cAAc,EAAE,QAAQ,EAAE,CAAC;IAC3B,kEAAkE;IAClE,aAAa,EAAE,gBAAgB,EAAE,CAAC;IAClC,sFAAsF;IACtF,UAAU,EAAE,OAAO,CAAC;IACpB,0BAA0B;IAC1B,UAAU,EAAE,OAAO,CAAC;IACpB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,sHAAsH;AACtH,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAOvE;AAED,8CAA8C;AAC9C,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,CASvG;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,MAAM,EAAE,EAClB,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,GACpD,kBAAkB,GAAG,IAAI,CAyD3B"}