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

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

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

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

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

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

@@ -0,0 +1,20 @@
+import type { ResolvedDeckCutoutArticleRule, ResolvedDeckCutoutHole } from '../../../types/environment';
+import type { ArticleFootprint } from './articleFootprint';
+import type { ArticleMeasurement } from './measureArticle';
+export interface MeasureLogInput {
+    measurement: ArticleMeasurement;
+    rule: ResolvedDeckCutoutArticleRule | null;
+    primaryCodex: string | undefined;
+    footprint: ArticleFootprint;
+    hole: ResolvedDeckCutoutHole;
+}
+/**
+ * One line describing the whole cutout pipeline, plus the `key` it changes with:
+ * the caller logs only when the key moves, so the line appears once per codex /
+ * rule / outline state (bounds coarse-rounded to cm) rather than every measure.
+ */
+export declare function measureLog({ measurement, rule, primaryCodex, footprint, hole }: MeasureLogInput): {
+    key: string;
+    message: string;
+};
+//# sourceMappingURL=measureDiagnostics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"measureDiagnostics.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/environment/deckCutout/measureDiagnostics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACxG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,kBAAkB,CAAC;IAChC,IAAI,EAAE,6BAA6B,GAAG,IAAI,CAAC;IAC3C,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,SAAS,EAAE,gBAAgB,CAAC;IAC5B,IAAI,EAAE,sBAAsB,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,eAAe,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAoDlI"}

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

@@ -0,0 +1,16 @@
+import { type Texture } from 'three';
+import type { ResolvedDeckCutoutCollarMaterial } from '../../../types/environment';
+export interface CollarTextures {
+    map: Texture;
+    normalMap: Texture | null;
+    roughnessMap: Texture | null;
+}
+/**
+ * Load the collar's declared maps imperatively rather than through
+ * `useTexture`/`useLoader`: those suspend, and the collar mounts outside a
+ * Suspense boundary, so a slow texture would blank the whole scene group.
+ * Returns null until `mapUrl` resolves; the other maps are optional and simply
+ * aren't applied if they fail.
+ */
+export declare function useCollarTextures(material: ResolvedDeckCutoutCollarMaterial): CollarTextures | null;
+//# sourceMappingURL=useCollarTextures.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useCollarTextures.d.ts","sourceRoot":"","sources":["../../../../../../../src/core/environment/deckCutout/useCollarTextures.ts"],"names":[],"mappings":"AACA,OAAO,EAAiD,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AACpF,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,4BAA4B,CAAC;AAQnF,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,OAAO,CAAC;IACb,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,gCAAgC,GAAG,cAAc,GAAG,IAAI,CAqDnG"}

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

@@ -0,0 +1,191 @@
+import { type ConfigInput, type ConfigResolved } from '../../config/descriptor';
+/** Drei preset names plus `'skydome'`, the computed IBL derived from the visible skydome image. */
+declare const HDR_OPTIONS: readonly ["skydome", "apartment", "city", "dawn", "forest", "lobby", "night", "park", "studio", "sunset", "warehouse"];
+/**
+ * Atmosphere parameters for the procedural sky shader (drei `<Sky>`, which wraps Three.js's `Sky`
+ * shader by zz85). Defaults match drei's.
+ */
+declare const SKY_PROCEDURAL_CONFIG: import("../../config/descriptor").GroupDescriptor<{
+    /**
+     * Far-plane distance the sky shell is rendered at. Preetham scattering math is calibrated for an
+     * earth-radius-scale shell; values below ~100000 wash out the gradient, so that is the floor.
+     */
+    distance: import("../../config/descriptor").NumberField;
+    /** Atmospheric haze. */
+    turbidity: import("../../config/descriptor").NumberField;
+    /** Blue-scattering strength — higher is bluer. Drei's documented range is 0–4. */
+    rayleigh: import("../../config/descriptor").NumberField;
+    /**
+     * Mie (forward) scattering coefficient. Effective Mie scale = `turbidity * mieCoefficient`;
+     * above ~0.03 the entire dome floods with isotropic Mie scatter and reads pure white, so that is
+     * the ceiling. The analyzer slider deliberately stops at the tighter 0.01.
+     */
+    mieCoefficient: import("../../config/descriptor").NumberField;
+    /**
+     * Mie directional anisotropy (Henyey-Greenstein `g`) — higher = tighter forward peak toward the
+     * sun. Below ~0.5 the white Mie halo spreads across the entire dome, so that is the floor. The
+     * analyzer slider deliberately starts at the tighter 0.65.
+     */
+    mieDirectionalG: import("../../config/descriptor").NumberField;
+}>;
+/** Visual background sphere — does NOT affect IBL lighting. */
+declare const SKYDOME_CONFIG: import("../../config/descriptor").GroupDescriptor<{
+    /**
+     * Equirect image URL for the dome, or `false` for none. `'blob:…'` works for a locally-uploaded
+     * file within the session; the analyzer re-caches the file in IndexedDB so a reload can rehydrate.
+     */
+    url: import("../../config/descriptor").ValueField<string | false>;
+    enabled: import("../../config/descriptor").BooleanField;
+    /** Source for the background dome. */
+    kind: import("../../config/descriptor").EnumField<"image" | "procedural">;
+    /** Sphere radius in world units. */
+    size: import("../../config/descriptor").NumberField;
+    /** Y-axis rotation in radians. */
+    rotation: import("../../config/descriptor").NumberField;
+    /** Dome geometry: full sphere or hemisphere + ground disc. */
+    shape: import("../../config/descriptor").EnumField<"sphere" | "hemisphere">;
+    /** Vertical offset of the dome center in world units. */
+    height: import("../../config/descriptor").NumberField;
+    /** Texture repeat on the U axis. */
+    tileX: import("../../config/descriptor").NumberField;
+    /** Texture repeat on the V axis. */
+    tileY: import("../../config/descriptor").NumberField;
+    /** Texture UV offset on the U axis. */
+    offsetX: import("../../config/descriptor").NumberField;
+    /** Texture UV offset on the V axis. */
+    offsetY: import("../../config/descriptor").NumberField;
+    /** Procedural sky parameters; only used when {@link SKYDOME_CONFIG}'s `kind` is 'procedural'. */
+    procedural: import("../../config/descriptor").GroupDescriptor<{
+        /**
+         * Far-plane distance the sky shell is rendered at. Preetham scattering math is calibrated for an
+         * earth-radius-scale shell; values below ~100000 wash out the gradient, so that is the floor.
+         */
+        distance: import("../../config/descriptor").NumberField;
+        /** Atmospheric haze. */
+        turbidity: import("../../config/descriptor").NumberField;
+        /** Blue-scattering strength — higher is bluer. Drei's documented range is 0–4. */
+        rayleigh: import("../../config/descriptor").NumberField;
+        /**
+         * Mie (forward) scattering coefficient. Effective Mie scale = `turbidity * mieCoefficient`;
+         * above ~0.03 the entire dome floods with isotropic Mie scatter and reads pure white, so that is
+         * the ceiling. The analyzer slider deliberately stops at the tighter 0.01.
+         */
+        mieCoefficient: import("../../config/descriptor").NumberField;
+        /**
+         * Mie directional anisotropy (Henyey-Greenstein `g`) — higher = tighter forward peak toward the
+         * sun. Below ~0.5 the white Mie halo spreads across the entire dome, so that is the floor. The
+         * analyzer slider deliberately starts at the tighter 0.65.
+         */
+        mieDirectionalG: import("../../config/descriptor").NumberField;
+    }>;
+}>;
+/**
+ * Dome / IBL config — the single source for its types, defaults, clamps, round-trip and analyzer
+ * inputs (see `config/descriptor.ts`). Drives `EnvironmentDome` + `SkydomeBackground`.
+ */
+export declare const DOME_CONFIG: import("../../config/descriptor").GroupDescriptor<{
+    /**
+     * HDRI source: a drei preset name (e.g. `'warehouse'`), a URL, `'skydome'` (derive the IBL from
+     * the skydome image so reflections match the visible sky), or a per-tier `TieredAsset` object
+     * that resolves to the right resolution for the active performance profile.
+     *
+     * Presets ship as prefiltered cubemaps; URLs go through our own PMREM path, which also honours
+     * tile/offset on the equirect. The library default is empty so a host that configures nothing
+     * gets no IBL rather than a surprise download.
+     */
+    hdr: import("../../config/descriptor").AssetField;
+    showBackground: import("../../config/descriptor").BooleanField;
+    backgroundBlur: import("../../config/descriptor").NumberField;
+    intensity: import("../../config/descriptor").NumberField;
+    /**
+     * Highlight expansion applied to a URL-loaded equirect before PMREM (1 = off). LDR sources
+     * (JPG/PNG, i.e. every `hdr: 'skydome'` setup) clamp at 1.0, so no sun or bright cloud can
+     * outshine the rest and reflections read flat. The boost is weighted by luminance³ — midtones
+     * stay put, the brightest pixels are pushed past 1.0. Raises overall IBL brightness too, so
+     * `intensity` usually wants trimming alongside. Ignored by drei presets and `'room'`.
+     */
+    iblHighlightBoost: import("../../config/descriptor").NumberField;
+    /** Y-axis rotation (yaw) for the IBL/background, in radians. */
+    rotation: import("../../config/descriptor").NumberField;
+    /** X-axis (pitch) rotation for the IBL/background, in radians. */
+    rotationX: import("../../config/descriptor").NumberField;
+    /** Z-axis (roll) rotation for the IBL/background, in radians. */
+    rotationZ: import("../../config/descriptor").NumberField;
+    /**
+     * Equirectangular HDRI texture repeat on the U axis. Applied via a pre-PMREM render pass; affects
+     * both lighting and background. Ignored for drei built-in presets.
+     */
+    tileX: import("../../config/descriptor").NumberField;
+    /** HDRI texture repeat on the V axis. */
+    tileY: import("../../config/descriptor").NumberField;
+    /** HDRI texture UV offset on the U axis. */
+    offsetX: import("../../config/descriptor").NumberField;
+    /** HDRI texture UV offset on the V axis. */
+    offsetY: import("../../config/descriptor").NumberField;
+    /** Flat background color, or `false` to show the HDRI / skydome instead. */
+    backgroundColor: import("../../config/descriptor").ValueField<string | false>;
+    /**
+     * Linear multiplier on `backgroundColor` — boost above 1 so the flat background still reads white
+     * after compressive tone mapping (Neutral/ACES pull pure white below 1).
+     */
+    backgroundIntensity: import("../../config/descriptor").NumberField;
+    skydome: import("../../config/descriptor").GroupDescriptor<{
+        /**
+         * Equirect image URL for the dome, or `false` for none. `'blob:…'` works for a locally-uploaded
+         * file within the session; the analyzer re-caches the file in IndexedDB so a reload can rehydrate.
+         */
+        url: import("../../config/descriptor").ValueField<string | false>;
+        enabled: import("../../config/descriptor").BooleanField;
+        /** Source for the background dome. */
+        kind: import("../../config/descriptor").EnumField<"image" | "procedural">;
+        /** Sphere radius in world units. */
+        size: import("../../config/descriptor").NumberField;
+        /** Y-axis rotation in radians. */
+        rotation: import("../../config/descriptor").NumberField;
+        /** Dome geometry: full sphere or hemisphere + ground disc. */
+        shape: import("../../config/descriptor").EnumField<"sphere" | "hemisphere">;
+        /** Vertical offset of the dome center in world units. */
+        height: import("../../config/descriptor").NumberField;
+        /** Texture repeat on the U axis. */
+        tileX: import("../../config/descriptor").NumberField;
+        /** Texture repeat on the V axis. */
+        tileY: import("../../config/descriptor").NumberField;
+        /** Texture UV offset on the U axis. */
+        offsetX: import("../../config/descriptor").NumberField;
+        /** Texture UV offset on the V axis. */
+        offsetY: import("../../config/descriptor").NumberField;
+        /** Procedural sky parameters; only used when {@link SKYDOME_CONFIG}'s `kind` is 'procedural'. */
+        procedural: import("../../config/descriptor").GroupDescriptor<{
+            /**
+             * Far-plane distance the sky shell is rendered at. Preetham scattering math is calibrated for an
+             * earth-radius-scale shell; values below ~100000 wash out the gradient, so that is the floor.
+             */
+            distance: import("../../config/descriptor").NumberField;
+            /** Atmospheric haze. */
+            turbidity: import("../../config/descriptor").NumberField;
+            /** Blue-scattering strength — higher is bluer. Drei's documented range is 0–4. */
+            rayleigh: import("../../config/descriptor").NumberField;
+            /**
+             * Mie (forward) scattering coefficient. Effective Mie scale = `turbidity * mieCoefficient`;
+             * above ~0.03 the entire dome floods with isotropic Mie scatter and reads pure white, so that is
+             * the ceiling. The analyzer slider deliberately stops at the tighter 0.01.
+             */
+            mieCoefficient: import("../../config/descriptor").NumberField;
+            /**
+             * Mie directional anisotropy (Henyey-Greenstein `g`) — higher = tighter forward peak toward the
+             * sun. Below ~0.5 the white Mie halo spreads across the entire dome, so that is the floor. The
+             * analyzer slider deliberately starts at the tighter 0.65.
+             */
+            mieDirectionalG: import("../../config/descriptor").NumberField;
+        }>;
+    }>;
+}>;
+export type DomeConfig = ConfigInput<typeof DOME_CONFIG>;
+export type ResolvedDomeConfig = ConfigResolved<typeof DOME_CONFIG>;
+export type SkydomeConfig = ConfigInput<typeof SKYDOME_CONFIG>;
+export type ResolvedSkydomeConfig = ConfigResolved<typeof SKYDOME_CONFIG>;
+export type SkydomeKind = ResolvedSkydomeConfig['kind'];
+export type SkyProceduralConfig = ConfigInput<typeof SKY_PROCEDURAL_CONFIG>;
+export type ResolvedSkyProceduralConfig = ConfigResolved<typeof SKY_PROCEDURAL_CONFIG>;
+export { HDR_OPTIONS };
+//# sourceMappingURL=dome.config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dome.config.d.ts","sourceRoot":"","sources":["../../../../../../src/core/environment/dome.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEvF,mGAAmG;AACnG,QAAA,MAAM,WAAW,wHAAyH,CAAC;AAI3I;;;GAGG;AACH,QAAA,MAAM,qBAAqB;IACzB;;;OAGG;;IAQH,wBAAwB;;IAQxB,kFAAkF;;IAQlF;;;;OAIG;;IAOH;;;;OAIG;;EASH,CAAC;AAEH,+DAA+D;AAC/D,QAAA,MAAM,cAAc;IAClB;;;OAGG;;;IAGH,sCAAsC;;IAEtC,oCAAoC;;IAEpC,kCAAkC;;IAElC,8DAA8D;;IAE9D,yDAAyD;;IAEzD,oCAAoC;;IAEpC,oCAAoC;;IAEpC,uCAAuC;;IAEvC,uCAAuC;;IAEvC,iGAAiG;;QA/EjG;;;WAGG;;QAQH,wBAAwB;;QAQxB,kFAAkF;;QAQlF;;;;WAIG;;QAOH;;;;WAIG;;;EAuCH,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,WAAW;IACtB;;;;;;;;OAQG;;;;;IAWH;;;;;;OAMG;;IAUH,gEAAgE;;IAEhE,kEAAkE;;IAQlE,iEAAiE;;IAQjE;;;OAGG;;IAQH,yCAAyC;;IAQzC,4CAA4C;;IAQ5C,4CAA4C;;IAQ5C,4EAA4E;;IAE5E;;;OAGG;;;QA9HH;;;WAGG;;;QAGH,sCAAsC;;QAEtC,oCAAoC;;QAEpC,kCAAkC;;QAElC,8DAA8D;;QAE9D,yDAAyD;;QAEzD,oCAAoC;;QAEpC,oCAAoC;;QAEpC,uCAAuC;;QAEvC,uCAAuC;;QAEvC,iGAAiG;;YA/EjG;;;eAGG;;YAQH,wBAAwB;;YAQxB,kFAAkF;;YAQlF;;;;eAIG;;YAOH;;;;eAIG;;;;EA8IH,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,WAAW,CAAC,CAAC;AACzD,MAAM,MAAM,kBAAkB,GAAG,cAAc,CAAC,OAAO,WAAW,CAAC,CAAC;AACpE,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC,OAAO,cAAc,CAAC,CAAC;AAC/D,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAAC,OAAO,cAAc,CAAC,CAAC;AAC1E,MAAM,MAAM,WAAW,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;AACxD,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAC5E,MAAM,MAAM,2BAA2B,GAAG,cAAc,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEvF,OAAO,EAAE,WAAW,EAAE,CAAC"}

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

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

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

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

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

@@ -0,0 +1,130 @@
+import { type ConfigInput, type ConfigResolved } from '../../config/descriptor';
+/**
+ * 2D top-down "Pristine Grid" tuning. Drives `core/PlannerGrid.tsx` — the derivative-aware shader
+ * that renders the planner grid in 2D mode. The 3D-tab grid still renders through drei's `<Grid>`
+ * and is NOT driven by these values (oblique camera angles + furniture occlusion make the pristine
+ * algorithm overkill there).
+ *
+ * Defaults reflect the live tuning policy: 25 cm minor sub-grid, 1 m major rhythm; a cool-grey
+ * palette (`#a8b1bb` / `#6a7482`) for ~1.6:1 / ~2.5:1 Weber contrast against a white planner
+ * backdrop; thicknesses picked at "design weight" because the pristine grid expands sub-pixel
+ * lines automatically; 200 m fade distance covers fit-zoomed multi-room layouts.
+ */
+declare const PLANNER_GRID_2D_CONFIG: import("../../config/descriptor").GroupDescriptor<{
+    /** Minor cell size in metres. */
+    cellSize: import("../../config/descriptor").NumberField;
+    /** Major section size in metres (typically `4 × cellSize`). */
+    sectionSize: import("../../config/descriptor").NumberField;
+    cellColor: import("../../config/descriptor").ColorField;
+    sectionColor: import("../../config/descriptor").ColorField;
+    /** Minor line width in screen pixels. ≥1 recommended. */
+    cellThickness: import("../../config/descriptor").NumberField;
+    /** Major line width in screen pixels. ≥1 recommended. */
+    sectionThickness: import("../../config/descriptor").NumberField;
+    /** Distance (m) past which the grid fully fades. */
+    fadeDistance: import("../../config/descriptor").NumberField;
+    /** 0–1: how aggressively distance fades the grid. */
+    fadeStrength: import("../../config/descriptor").NumberField;
+    /**
+     * Camera-distance (m) at which the minor (cell) lines start to disappear, leaving only the major
+     * (section) rhythm visible. Measured as the distance from the camera to the grid plane
+     * (= camera height in strict top-down 2D, or true ray distance in oblique views). The fade band
+     * is 30 % of the threshold, centred on it, so cells fade smoothly between `0.85 ×` and `1.15 ×`.
+     *
+     * 25 cm cells stop reading as a measurable sub-grid below ~3 px projected size; on a 1080p canvas
+     * with the default fov=24° that crossover lands around ~12 m camera height. Hiding the minors
+     * around there keeps the planner readable when fit-zoomed to a multi-room layout while still
+     * showing them at typical furniture-placement zooms (1–8 m).
+     */
+    cellHideDistance: import("../../config/descriptor").NumberField;
+    /**
+     * When `> 0`, the grid stops being an infinite camera-following plane and is instead
+     * sized/anchored to the current scene: it covers a disc of radius
+     * `sceneFitFactor × sceneHalfExtent` around the scene centre and fades out at that radius.
+     * `2` ≈ one scene-extent of grid beyond the content edge. This keeps the grid from streaking to
+     * the horizon during the oblique 2D↔3D camera fly. `0` (the default) = the classic infinite
+     * follow-camera grid used by the interactive planner; presets that want a scene-sized grid
+     * (e.g. white-room) set this > 0.
+     */
+    sceneFitFactor: import("../../config/descriptor").NumberField;
+}>;
+/**
+ * Production ground plane (`PlainGround`) + planner-grid visibility — the single source for their
+ * types, defaults, clamps, round-trip and analyzer inputs (see `config/descriptor.ts`).
+ *
+ * Routes through the standard env pipeline (`patchActiveProfile` → bundle auto-save →
+ * Import/Export) so the panel doesn't need its own localStorage key or snapshot/restore helpers.
+ */
+export declare const GROUND_CONFIG: import("../../config/descriptor").GroupDescriptor<{
+    /** Master toggle — when false the plane unmounts entirely. */
+    enabled: import("../../config/descriptor").BooleanField;
+    /**
+     * Surface style: `'plain'` is a flat solid-color matte plane (visible floor that also receives
+     * shadows); `'shadow'` is an invisible shadow catcher — transparent everywhere except where a
+     * shadow lands (the Babylon `ShadowOnlyMaterial` equivalent; the old white-room look).
+     */
+    surface: import("../../config/descriptor").EnumField<"shadow" | "plain">;
+    /** Solid color for the `'plain'` surface. Ignored otherwise. */
+    color: import("../../config/descriptor").ColorField;
+    /** PBR roughness for the `'plain'` surface. Ignored otherwise. */
+    roughness: import("../../config/descriptor").NumberField;
+    /** Shadow darkness for the `'shadow'` surface (opacity of the cast shadow). Ignored otherwise. */
+    shadowOpacity: import("../../config/descriptor").NumberField;
+    /** Shape of the visible plane (rectangular vs. fragment-discarded disc). */
+    shape: import("../../config/descriptor").EnumField<"rectangular" | "circular">;
+    /** Side length of the rectangular plane (meters). */
+    size: import("../../config/descriptor").NumberField;
+    /** Disc radius (meters), used when `shape === 'circular'`. */
+    radius: import("../../config/descriptor").NumberField;
+    /** Vertical offset from scene floor. */
+    yOffset: import("../../config/descriptor").NumberField;
+    /**
+     * Production planner-grid visibility — `'2d'` shows the grid only in 2D (top-down) view, `'on'`
+     * shows it in both 2D and 3D, `'off'` hides it everywhere.
+     */
+    plannerGridMode: import("../../config/descriptor").EnumField<"off" | "on" | "2d">;
+    plannerGrid2D: import("../../config/descriptor").GroupDescriptor<{
+        /** Minor cell size in metres. */
+        cellSize: import("../../config/descriptor").NumberField;
+        /** Major section size in metres (typically `4 × cellSize`). */
+        sectionSize: import("../../config/descriptor").NumberField;
+        cellColor: import("../../config/descriptor").ColorField;
+        sectionColor: import("../../config/descriptor").ColorField;
+        /** Minor line width in screen pixels. ≥1 recommended. */
+        cellThickness: import("../../config/descriptor").NumberField;
+        /** Major line width in screen pixels. ≥1 recommended. */
+        sectionThickness: import("../../config/descriptor").NumberField;
+        /** Distance (m) past which the grid fully fades. */
+        fadeDistance: import("../../config/descriptor").NumberField;
+        /** 0–1: how aggressively distance fades the grid. */
+        fadeStrength: import("../../config/descriptor").NumberField;
+        /**
+         * Camera-distance (m) at which the minor (cell) lines start to disappear, leaving only the major
+         * (section) rhythm visible. Measured as the distance from the camera to the grid plane
+         * (= camera height in strict top-down 2D, or true ray distance in oblique views). The fade band
+         * is 30 % of the threshold, centred on it, so cells fade smoothly between `0.85 ×` and `1.15 ×`.
+         *
+         * 25 cm cells stop reading as a measurable sub-grid below ~3 px projected size; on a 1080p canvas
+         * with the default fov=24° that crossover lands around ~12 m camera height. Hiding the minors
+         * around there keeps the planner readable when fit-zoomed to a multi-room layout while still
+         * showing them at typical furniture-placement zooms (1–8 m).
+         */
+        cellHideDistance: import("../../config/descriptor").NumberField;
+        /**
+         * When `> 0`, the grid stops being an infinite camera-following plane and is instead
+         * sized/anchored to the current scene: it covers a disc of radius
+         * `sceneFitFactor × sceneHalfExtent` around the scene centre and fades out at that radius.
+         * `2` ≈ one scene-extent of grid beyond the content edge. This keeps the grid from streaking to
+         * the horizon during the oblique 2D↔3D camera fly. `0` (the default) = the classic infinite
+         * follow-camera grid used by the interactive planner; presets that want a scene-sized grid
+         * (e.g. white-room) set this > 0.
+         */
+        sceneFitFactor: import("../../config/descriptor").NumberField;
+    }>;
+}>;
+export type GroundConfig = ConfigInput<typeof GROUND_CONFIG>;
+export type ResolvedGroundConfig = ConfigResolved<typeof GROUND_CONFIG>;
+export type PlannerGrid2DConfig = ConfigInput<typeof PLANNER_GRID_2D_CONFIG>;
+export type ResolvedPlannerGrid2DConfig = ConfigResolved<typeof PLANNER_GRID_2D_CONFIG>;
+export {};
+//# sourceMappingURL=ground.config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ground.config.d.ts","sourceRoot":"","sources":["../../../../../../src/core/environment/ground.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEvF;;;;;;;;;;GAUG;AACH,QAAA,MAAM,sBAAsB;IAC1B,iCAAiC;;IAQjC,+DAA+D;;;;IAU/D,yDAAyD;;IAQzD,yDAAyD;;IAEzD,oDAAoD;;IAQpD,qDAAqD;;IAErD;;;;;;;;;;OAUG;;IAYH;;;;;;;;OAQG;;EAEH,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;IACxB,8DAA8D;;IAE9D;;;;OAIG;;IASH,gEAAgE;;IAEhE,kEAAkE;;IAElE,kGAAkG;;IAQlG,4EAA4E;;IAS5E,qDAAqD;;IAErD,8DAA8D;;IAQ9D,wCAAwC;;IAExC;;;OAGG;;;QAnIH,iCAAiC;;QAQjC,+DAA+D;;;;QAU/D,yDAAyD;;QAQzD,yDAAyD;;QAEzD,oDAAoD;;QAQpD,qDAAqD;;QAErD;;;;;;;;;;WAUG;;QAYH;;;;;;;;WAQG;;;EAkEH,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,aAAa,CAAC,CAAC;AAC7D,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAC,OAAO,aAAa,CAAC,CAAC;AACxE,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAC7E,MAAM,MAAM,2BAA2B,GAAG,cAAc,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

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

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

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

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