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

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

@@ -0,0 +1,134 @@
+/**
+ * Shelf-planner accessory grid types.
+ *
+ * The first three interfaces mirror the host contract (`@crystaldesign/web-planner-logic`'s
+ * `ShelfAccessoiresView` / the old `real-time-viewer`'s `types.ts`) — kept local so rtv-next
+ * has no hard dependency on web-planner-logic. They are the *raw* host input.
+ *
+ * `AllGrids` mirrors the response of `POST {constructorServiceUrl}/articles/grids/all` — the
+ * server-computed grid + accessory geometry the client doesn't otherwise have.
+ *
+ * `ResolvedGridCell` is the **unification seam**: the renderer consumes only this
+ * resolved shape (cell + element-local transform + backend keys), never the raw input. Today it
+ * is produced from `FreePlacesOnGrids` + `AllGrids`; later it can be produced from
+ * `GeneralPlanningState` without touching the renderer.
+ */
+export interface FreePlacesOnGrids {
+    accessoire3DName: string;
+    articleCodex: string;
+    basketId: string;
+    elementId?: string;
+    plannedOptions: {
+        [key: string]: string;
+    };
+    grids: {
+        [gridName: string]: {
+            freeCells: number[];
+            idx: number;
+        };
+    };
+    /** Real catalog geometry (glb) name (e.g. `GEO_TAB_50_VR`) — used to load a variant's mesh during
+     *  a family-swap drag. Provided by the host; differs from accessoire3DName / articleCodex. */
+    geo3DName?: string;
+}
+export interface PlannedPlacesOnGrids {
+    shelf3DName: string;
+    basketId: string;
+    catalogCodex: string;
+    elementId?: string;
+    grids: {
+        [gridName: string]: {
+            accessories: ShelfAccessories[];
+            idx: number;
+        };
+    };
+    iln: string;
+    plannedOptions: {
+        [codex: string]: string;
+    };
+}
+export interface ShelfAccessories {
+    accessorie3DName: string;
+    basketId: string;
+    articleCodex: string;
+    plannedOptions: {
+        [key: string]: string;
+    };
+    index: number;
+    noDelete: boolean;
+    noMove: boolean;
+}
+export interface AccessoryGridGeo {
+    type: string;
+    rulePosition: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    geoPosition: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    geoSize: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    geoBboxSize: {
+        x: number;
+        y: number;
+        z: number;
+    };
+}
+export interface AccessoryGeoEntry {
+    artNr: string;
+    artType: string;
+    geo: AccessoryGridGeo;
+    gridPositionSize: {
+        x: number;
+        y: number;
+        z: number;
+    };
+}
+export interface AccessoryGridDef {
+    gridName: string;
+    originPosition: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    deltaGrid: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    rotation: number;
+    count: number;
+}
+export interface AllGrids {
+    elementId: string;
+    accessories: AccessoryGeoEntry[];
+    grids: AccessoryGridDef[];
+}
+/**
+ * One placeable cell, resolved into an element-local transform + the keys the place/move/delete
+ * backend calls need. `elementId` is the shelf element key (`'E'+shelfElementId`) used to match the
+ * Three.js scene group; positions are LOCAL to that element group (boxes are mounted as its children).
+ */
+export interface ResolvedGridCell {
+    /** Shelf element key, e.g. "E12" — matches the tail of the scene group name. */
+    elementId: string;
+    gridName: string;
+    gridIdx: number;
+    cellIdx: number;
+    parentBasketId: string;
+    articleCodex: string;
+    /** Element-local position (metres). */
+    localPosition: [number, number, number];
+    /** Element-local Y rotation (radians). */
+    rotationY: number;
+    /** Box dimensions (metres). */
+    size: [number, number, number];
+}
+//# sourceMappingURL=accessoryGrids.d.ts.map

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

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

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

@@ -0,0 +1,288 @@
+export declare const CAMERA_FOV = 24;
+export declare const CAMERA_NEAR = 0.05;
+export declare const CAMERA_FAR = 2500;
+export type ViewAngle = {
+    azimuth: number;
+    elevation: number;
+};
+/**
+ * A directional tightening of the orbit limits, active inside one azimuth window.
+ *
+ * Angles are radians in the same convention as `getAzimuthalAngle()` / `limits.minAzimuthAngle`
+ * (0 = camera on +Z of the target, +90° = +X). The window runs from `fromAzimuth` to `toAzimuth`
+ * in the direction of increasing azimuth and may wrap across ±π. Equal values mean a full circle.
+ *
+ * Only the bounds a sector declares are affected, and a sector can only tighten the base limits,
+ * never widen them. Inside `feather` of either edge the override blends smoothly to the base value,
+ * so sweeping the camera across a boundary is a push, not a pop.
+ */
+export interface CameraSectorLimit {
+    fromAzimuth: number;
+    toAzimuth: number;
+    /** Blend band inside each edge, radians. Defaults to {@link DEFAULT_SECTOR_FEATHER}. */
+    feather?: number;
+    minDistance?: number;
+    maxDistance?: number;
+    minPolarAngle?: number;
+    maxPolarAngle?: number;
+    /**
+     * World-space ceiling for the camera inside this sector (meters, same Y space as
+     * `limits.floorY`). Converted at evaluation time into a minimum polar angle at the current
+     * orbit distance: `acos((maxHeight - targetY) / distance)`. Close to the target the whole
+     * polar range stays reachable (the camera is still under the ceiling); further out the limit
+     * engages earlier — unlike a fixed `minPolarAngle`, which cuts the same view angle at every
+     * distance. Combines with an explicit `minPolarAngle` most-restrictive-wins. Requires the
+     * evaluation context (distance + target Y); evaluations without one ignore the ceiling.
+     */
+    maxHeight?: number;
+}
+/**
+ * Per-element-type vertical look angle (degrees of elevation) used when the camera focuses an
+ * element. Azimuth still reorients to the element front; only the elevation is overridden.
+ * `planned`/unknown element types share the `main` policy.
+ *   - `shelfAccessoire` / `accessoire`: eye-level (0°) — look straight at the shelf front.
+ *   - `boxElement` / `main`: slightly elevated (15°).
+ */
+export declare const DEFAULT_FOCUS_ELEVATION: {
+    shelfAccessoire: number;
+    accessoire: number;
+    boxElement: number;
+    main: number;
+};
+/**
+ * Camera-controls feel presets.
+ *
+ * - `custom`  — fully user-tunable (raw OrbitControls feel sliders are visible).
+ * - `cinematic` — heavy inertia, slow rotate/zoom/pan, subtle FOV dolly on rotate.
+ * - `snappy`   — near-instant response, fast rotate/zoom/pan.
+ */
+export type ControlsPreset = 'custom' | 'cinematic' | 'snappy';
+/**
+ * 2D camera limits for the perspective top-down rig. `kind` is kept as an
+ * explicit tag so host configs stay self-describing.
+ */
+export type Limits2DPerspective = {
+    kind: 'perspective';
+    /** OrbitControls.minDistance — dolly distance lower bound (meters). Default 1. */
+    minDistance?: number;
+    /** OrbitControls.maxDistance — dolly distance upper bound (meters). Default 30. */
+    maxDistance?: number;
+    enableZoom?: boolean;
+    enablePan?: boolean;
+};
+export type Limits2DConfig = Limits2DPerspective;
+export interface ControlsConfig {
+    /** Preset feel — individual values below override the preset */
+    preset?: ControlsPreset;
+    /**
+     * OrbitControls' damping factor — drives **momentum**. After the user
+     * releases, OrbitControls keeps applying a decaying `sphericalDelta` /
+     * `panOffset` to the proxy camera each frame, so the proxy continues
+     * moving in the input direction with an exponential tail. That's the
+     * cinematic "coast." Lower values give a longer, floatier coast;
+     * higher values stop near-instantly.
+     *
+     * Range: `0..1` (clamped by OrbitControls). Useful band: ~0.02
+     * (very floaty / long momentum) to ~0.5 (snappy / minimal momentum).
+     *
+     * Independent of {@link smoothTime} — that controls the *rendered*
+     * camera's catch-up lag toward the proxy, while this controls how long
+     * the proxy itself keeps moving.
+     */
+    dampingFactor?: number;
+    /**
+     * Critically-damped spring time-constant (seconds) used by the rendered
+     * camera's chase spring — applied uniformly during drag AND post-release
+     * coast. Layered on top of OrbitControls' momentum: the proxy coasts via
+     * {@link dampingFactor}, and the rendered camera trails the proxy with
+     * this time-constant. Range ~0..0.5; ~0.18s reads as cinematic glide,
+     * ~0.02s as snappy.
+     *
+     * Must be a single T across drag and post-release: a T jump at `onEnd`
+     * leaves the spring's chase velocity (calibrated for the drag T) chasing
+     * through a suddenly weaker spring, producing a visible "smoothness stops
+     * at end of motion" artifact. The long post-release tail comes entirely
+     * from OrbitControls' momentum decay via {@link dampingFactor}.
+     */
+    smoothTime?: number;
+    rotateSpeed?: number;
+    zoomSpeed?: number;
+    panSpeed?: number;
+    /**
+     * Subtle FOV zoom during orbit rotation. Higher = more pronounced.
+     * 0 = disabled. Typical range: 1–5. The FOV narrows during fast rotation
+     * (zoom-in feel) and eases back to normal when the user stops.
+     */
+    dollyOnRotate?: number;
+    /**
+     * Master input-resistance scalar applied on top of the preset and any
+     * explicit `rotateSpeed` / `zoomSpeed` / `panSpeed` overrides.
+     *
+     * Range: `0..1`. 0 = no resistance (full sensitivity). 1 = max resistance —
+     * a given swipe / pinch / drag travels much less. Acts as a single
+     * "make all user input slower" knob so consumers don't have to dial
+     * three speeds in lockstep.
+     *
+     * Implementation: in {@link resolveControls} the three input speeds are
+     * multiplied by `1 - RESISTANCE_MAX_DAMP * resistance` (clamped). With
+     * the default `RESISTANCE_MAX_DAMP = 0.85`, `resistance = 1` leaves
+     * ~15% of the original speed — still usable but heavily slowed.
+     *
+     * Does NOT affect post-input damping (see {@link dampingFactor}).
+     */
+    resistance?: number;
+    /**
+     * Enables dolly/zoom from the user (mousewheel, pinch, and the dolly half of
+     * two-finger touch). Default `true`. Set to `false` to lock the camera
+     * distance to the target. Programmatic camera moves (focus, reframe,
+     * animations) are unaffected.
+     */
+    enableZoom?: boolean;
+    /**
+     * Enables pan from the user (right-drag, keyboard arrows, and the pan half
+     * of two-finger touch). Default `true`. Set to `false` to lock the orbit
+     * **target / focus point** in place — i.e. the user can still rotate the
+     * camera around the scene but can no longer slide what the camera looks at.
+     *
+     * Note: OrbitControls maps two-finger touch to `TOUCH.DOLLY_PAN`, so to
+     * make a two-finger gesture a complete no-op you need both
+     * `enableZoom = false` AND `enablePan = false`.
+     */
+    enablePan?: boolean;
+}
+export interface CameraConfig {
+    /**
+     * Vertical field of view in degrees. Default {@link CAMERA_FOV}.
+     *
+     * Reference points:
+     * - 20–30°: telephoto / portrait look (compresses space, "zoomed in" feel).
+     * - 35–50°: cinematic / catalog (most product viewers and films).
+     * - 50–75°: natural / "human eye" range (most game and walk-through engines).
+     * - 75–100°: wide-angle / FPS-like.
+     * - 100°+: extreme wide / fisheye (geometry distortion grows quickly).
+     */
+    fov?: number;
+    initialPosition?: [number, number, number];
+    initialTarget?: [number, number, number];
+    initialAngle?: ViewAngle;
+    /** Distance multiplier when focusing an element in 3D (default 1.7) */
+    focusPadding3D?: number;
+    /** Height multiplier when focusing an element in 2D top-down (default 3.0) */
+    focusPadding2D?: number;
+    /**
+     * Distance multiplier when focusing a geo (sub-element) in 3D. Geo focus
+     * uses geometry-derived viewing angles and a tighter framing radius, so
+     * its padding is independent of the element-level `focusPadding3D` value
+     * (default 1.15).
+     */
+    focusPaddingGeo?: number;
+    /** Multiplier for the initial 3D camera distance from scene center (default 1.7) */
+    initialZoomPadding3D?: number;
+    /** Multiplier for the initial 2D top-down camera height relative to scene size (default 3.0) */
+    initialZoomPadding2D?: number;
+    /** Y height (meters) the camera target sits above ground on initial frame (default 1) */
+    initialTargetHeight?: number;
+    /**
+     * Vertical position of the focus look-at target as a fraction of the framed
+     * bounding-box height (0 = bottom, 1 = top; default 0.56). Applied to both
+     * single-element focus (the element's own bbox) and full-scene focus (the
+     * global content bbox), so the two stay consistent. For full-scene focus,
+     * `initialTargetHeight` is only used as a fallback when the planning is empty
+     * (no content bbox to measure).
+     */
+    focusHeightFraction?: number;
+    /**
+     * Extra vertical lift (meters) of the focus look-at target, added after
+     * {@link focusHeightFraction} — applied to the same two paths: single-element
+     * focus and full-scene focus/reframe. Use when a fraction of the framed bbox
+     * height cannot express an absolute lift (e.g. a flat pool sunk into a deck,
+     * where the orbit pivot should sit above the water line). Default 0.
+     */
+    focusTargetYOffset?: number;
+    /**
+     * Automatic camera re-fit when the placed content's bounding box changes size
+     * (an element resize / config edit): in overview the camera re-frames to the
+     * new box, and a focused camera re-fits the focused element. Default `true`.
+     * Set `false` to keep the camera exactly where the user left it across scene
+     * size changes — selection-driven focus flights are unaffected.
+     */
+    reframeOnSceneChange?: boolean;
+    /**
+     * Whether selecting, deselecting or focusing an element is allowed to move the camera.
+     * Default `true` (fly to the element on select, out to the overview on deselect, recenter on a
+     * click into empty space).
+     *
+     * `false` decouples the camera from selection entirely: elements still select, highlight and
+     * drive the customization UI, and `focusedElementName` is still tracked — only the camera stays
+     * put. For a showcase scene the framing is authored (`limits`, `autoRotate`, `initialAngle`) and
+     * having a click re-frame it throws that away. Distinct from
+     * {@link CameraConfig.reframeOnSceneChange}, which covers bbox-size-driven re-fits, not selection.
+     */
+    selectionMovesCamera?: boolean;
+    limits?: {
+        minDistance?: number;
+        maxDistance?: number;
+        minPolarAngle?: number;
+        maxPolarAngle?: number;
+        minAzimuthAngle?: number;
+        maxAzimuthAngle?: number;
+        targetBoundsMargin?: number;
+        floorY?: number;
+        /**
+         * Keep the camera clear of scene geometry. Opt-in: it costs two full-scene raycasts on every
+         * frame the camera moves, which most scenes don't need because `minDistance` and the polar
+         * limits already bound the orbit. Floor, target-bounds and distance clamps are unaffected.
+         */
+        collision?: boolean;
+        /**
+         * Directional overrides of the limits above: each sector tightens distance and/or polar bounds
+         * within an azimuth window ("a wall to the west", "a roof overhang to the south"). Sectors can
+         * only restrict, never widen — the base limits stay authoritative on OrbitControls; sectors are
+         * enforced per-frame on top, with a spring-back once the camera leaves the sector (see
+         * `useCameraConstraints`). Evaluation: {@link evaluateCameraLimitsAt}. Free when empty.
+         */
+        sectors?: CameraSectorLimit[];
+    };
+    /**
+     * 2D-mode camera limits: dolly distance bounds + pan/zoom toggles, driving
+     * `OrbitControls.minDistance / maxDistance` while the top-down rig is active.
+     * Omitted falls back to `{ minDistance: 1, maxDistance: 30, enableZoom: true, enablePan: true }`.
+     */
+    limits2d?: Limits2DConfig;
+    controls?: ControlsConfig;
+    autoRotate?: {
+        enabled: boolean;
+        speed?: number;
+        idleDelayMs?: number;
+        startOnLoad?: boolean;
+        direction?: 'cw' | 'ccw';
+        /**
+         * Polar angle (degrees from the zenith) the camera eases toward while auto-rotate is active,
+         * so the idle sweep settles at an authored viewing height regardless of where the user left
+         * the camera. Clamped to the polar limits (base and sector). Omitted = azimuth sweep only.
+         */
+        polarAngle?: number;
+    };
+}
+type ResolvedControls = Required<Omit<ControlsConfig, 'preset' | 'resistance'>>;
+/**
+ * Per-preset "feel" baseline. Same shape as {@link ResolvedControls}, plus
+ * a baked-in `resistance` so each preset can ship its own input weight.
+ * Consumers read `resistance` separately; it's not part of the resolved
+ * controls object that reaches `OrbitControls`.
+ */
+type PresetValues = ResolvedControls & {
+    resistance: number;
+};
+export declare const PRESET_VALUES: Record<ControlsPreset, PresetValues>;
+/** Resolve a ControlsConfig (with optional preset + overrides) into concrete values */
+export declare function resolveControls(cfg?: ControlsConfig): ResolvedControls;
+export declare const DEFAULT_CAMERA_CONFIG: Required<Pick<CameraConfig, 'fov' | 'initialAngle' | 'focusPadding3D' | 'focusPadding2D' | 'focusPaddingGeo' | 'initialZoomPadding3D' | 'initialZoomPadding2D' | 'initialTargetHeight' | 'focusHeightFraction' | 'focusTargetYOffset' | 'reframeOnSceneChange' | 'selectionMovesCamera'>> & {
+    limits: Required<NonNullable<CameraConfig['limits']>>;
+};
+/** The fully-merged limits shape `CameraController` works with (defaults + host overrides). */
+export type ResolvedCameraLimits = Required<NonNullable<CameraConfig['limits']>>;
+/** Replaces orbit clamps when `cameraDevelopmentMode` is on (3D only). */
+export declare const CAMERA_DEV_ORBIT_LIMITS: Required<Pick<NonNullable<CameraConfig['limits']>, 'minDistance' | 'maxDistance' | 'minPolarAngle' | 'maxPolarAngle' | 'minAzimuthAngle' | 'maxAzimuthAngle'>>;
+export {};
+//# sourceMappingURL=camera.d.ts.map

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

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

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

@@ -0,0 +1,146 @@
+/**
+ * The environment config's public type surface.
+ *
+ * Every per-subsystem shape is DERIVED from that subsystem's descriptor, which lives next to the
+ * renderer that owns it (`core/<x>/<x>.config.ts`) — see `config/descriptor.ts` for the mechanism
+ * and `config/environment.config.ts` for the composition. This module only re-exports those names
+ * and holds the genuinely cross-cutting types: performance profiles, device detection, scene metrics.
+ */
+import type { TieredAsset } from '../config/descriptor';
+import type { EnvironmentConfig, ResolvedEnvironmentConfig } from '../config/environment.config';
+export type { EnvironmentConfig, ResolvedEnvironmentConfig };
+/** @see TieredAsset — declared alongside the `asset` field kind it belongs to. */
+export type { TieredAsset };
+export type { DomeConfig, SkydomeConfig, SkyProceduralConfig } from '../core/environment/dome.config';
+export type { LightingConfig, LightConfig, SunConfig, ResolvedSunLensflareConfig } from '../core/environment/lighting.config';
+export type { WaterConfig } from '../core/water/water.config';
+export type { ShadowsConfig } from '../core/shadows/shadows.config';
+export type { ResolvedPostProcessingConfig, ToneMappingMode, SSAOConfig, ScreenLensFlarePassConfig, } from '../core/postprocessing/postProcessing.config';
+export type { SelectionConfig, OverlayGroupConfig, OverlayAnchor, OverlayDirection } from '../core/interaction/selection.config';
+export type { DimensionLineUnit } from '../core/dimension-lines/dimensionLines.config';
+export type { RendererConfig } from '../core/renderer.config';
+export type { AdaptiveConfig } from '../core/environment/adaptive.config';
+export type { GroundConfig, ResolvedGroundConfig, PlannerGrid2DConfig } from '../core/environment/ground.config';
+export type { DeckCutoutConfig, ResolvedDeckCutoutConfig, ResolvedDeckCutoutHole, ResolvedDeckCutoutArticleRule, ResolvedDeckCutoutCollar, ResolvedDeckCutoutCollarMaterial, DeckCutoutAnchorMode, } from '../core/environment/scene.config';
+/**
+ * Recursively makes all properties optional.
+ * Uses a distributive helper so `false | { ... }` unions resolve correctly:
+ * `RecursivePartial<{ ssao: Partial<SSAOConfig> }>` style unions resolve correctly.
+ */
+type DistributePartial<T> = T extends object ? RecursivePartial<T> : T;
+export type RecursivePartial<T> = {
+    [P in keyof T]?: T[P] extends (infer U)[] ? RecursivePartial<U>[] : DistributePartial<T[P]>;
+};
+/**
+ * Performance profile tier. `high` is the baseline (always full config);
+ * every other tier is a sparse override applied on top of `high` via
+ * `mergeProfile`.
+ *
+ * Desktop tiers: `high` / `medium` / `low`.
+ * Mobile tiers: `mobileHigh` / `mobileLow` — selected when `detect-gpu`
+ * reports a mobile device. They are plain overrides off the SAME `high`
+ * baseline (they do NOT chain through medium/low), so the entire existing
+ * merge / diff / propagation / Leva-editing machinery applies unchanged —
+ * the tier set is simply wider.
+ */
+export type PerformanceProfileTier = 'low' | 'medium' | 'high' | 'mobileHigh' | 'mobileLow';
+/**
+ * Every tier that is stored as a sparse override on top of `high` (i.e. all
+ * tiers except `high` itself). Single source of truth for the loops that walk
+ * "all override tiers" — diff panel, propagation, debug logging. Add a tier
+ * here and those sites pick it up automatically.
+ */
+export declare const OVERRIDE_PROFILE_TIERS: readonly ["medium", "low", "mobileHigh", "mobileLow"];
+/** A tier stored as a sparse override (everything except `high`). */
+export type OverrideProfileTier = (typeof OVERRIDE_PROFILE_TIERS)[number];
+/**
+ * Selection mode for the active profile.
+ * - `auto`: device tier is detected at startup (e.g. via detect-gpu) and the runtime perf adjuster
+ *   may step it while the scene runs.
+ * - `detect`: device tier is detected at startup and then pinned — no runtime stepping. For scenes
+ *   whose tiers are hand-tuned and must not swap mid-session (a step remounts the composer and
+ *   shadow setup, which reads as a flicker) but still need mobile devices on the mobile tiers.
+ * - `low` / `medium` / `high` / `mobileHigh` / `mobileLow`: explicit override (e.g. from the analyzer
+ *   dropdown or a `?profile=` URL parameter — useful for testing without a real low-end device).
+ */
+export type PerformanceProfileMode = 'auto' | 'detect' | PerformanceProfileTier;
+/**
+ * Performance profile bundle. `high` is the baseline (full `EnvironmentConfig`);
+ * `medium` and `low` are sparse overrides applied via `deepMerge` on top of
+ * `high` when the corresponding tier is active.
+ *
+ * Sparse storage is deliberate: every per-tier delta is explicit and
+ * revertable (see `diffProfileFromHigh`). No automatic reduction happens —
+ * if a field doesn't appear in `medium`/`low`, it inherits the High value.
+ */
+export interface PerformanceProfiles {
+    high: EnvironmentConfig;
+    medium?: RecursivePartial<EnvironmentConfig>;
+    low?: RecursivePartial<EnvironmentConfig>;
+    /** Override for capable mobile devices (balanced: keep most visuals, cut the
+     * heaviest effects, cap FPS, raise DPR ceiling to fight retina pixelation). */
+    mobileHigh?: RecursivePartial<EnvironmentConfig>;
+    /** Override for weaker mobile devices (aggressive cuts). */
+    mobileLow?: RecursivePartial<EnvironmentConfig>;
+}
+/**
+ * Wrapper shape used by the analyzer Export / Import I/O. Combines the
+ * three profiles plus the user's tier selection (or `'auto'`).
+ *
+ * No explicit version field — schema evolves additively (new optional
+ * fields default to absent / `false` / `undefined`).
+ */
+export interface PerformanceProfilesBundle {
+    profileMode: PerformanceProfileMode;
+    profiles: PerformanceProfiles;
+}
+/**
+ * Result of device-tier detection. `unsupported` is a distinct state for
+ * tier 0 / WebGL-blocklisted devices that can't run the scene at all.
+ *
+ * For the playable tiers, `signals` carries the raw inputs the detection
+ * used (for telemetry / analyzer display / debugging "why is this device
+ * classified as X?").
+ */
+export type DetectedTier = {
+    tier: 'unsupported';
+    reason: 'webgl-blocked' | 'force-unsupported';
+    device: string | null;
+} | {
+    tier: PerformanceProfileTier;
+    signals: DetectionSignals;
+};
+export interface DetectionSignals {
+    /** detect-gpu result (0 = unknown / blocklisted, 1–3 = perf tier). */
+    gpu: {
+        tier: 0 | 1 | 2 | 3;
+        device: string | null;
+        /** detect-gpu's benchmark-estimated FPS for the matched GPU (when available). */
+        fps?: number;
+    };
+    /** `navigator.hardwareConcurrency` — logical CPU cores. */
+    hardwareConcurrency: number;
+    /** `navigator.deviceMemory` in GB (Chrome / Edge / Opera only; `null` elsewhere). */
+    deviceMemoryGB: number | null;
+    /** `navigator.userAgentData?.mobile`. */
+    isMobile: boolean;
+    /** `prefers-reduced-motion: reduce` media query. */
+    reducedMotion: boolean;
+    /**
+     * Source of the resolved tier:
+     * - `'detect'` — normal detection path.
+     * - `'url'` — `?profile=` URL parameter forced the choice.
+     * - `'cache'` — previously detected tier was read from localStorage.
+     */
+    source: 'detect' | 'url' | 'cache';
+}
+export interface SceneMetrics {
+    center: [number, number, number];
+    radius: number;
+    bbox: {
+        min: [number, number, number];
+        max: [number, number, number];
+    };
+    floorY: number;
+}
+//# sourceMappingURL=environment.d.ts.map

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

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

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

@@ -0,0 +1,68 @@
+/**
+ * Planner overlay data — posNr, delete, copy, move/rotate capability flags.
+ * Host builds a Map keyed by the composite element key (`DivaArticle.shelfElementId`:
+ * `"2"` for mains, `"2.0.6"` for accessories).
+ */
+/**
+ * - `selected`     the picked element (Level-2 selection); gets the selected badge style.
+ * - `selectable`   user can pick it; hover outline on hover, badge in hover/selectable style.
+ * - `active`       navigated/in-scope context (e.g. the shelf step's main group) — NOT individually
+ *                  pickable. Shows an active badge, but no hover/select outline and clicking is a no-op.
+ * - `unselectable` out of scope / greyed; click walks up to a selectable ancestor.
+ */
+export type ElementOverlayState = 'selected' | 'selectable' | 'unselectable' | 'active';
+/**
+ * Element type discriminator (mirrors the planner taxonomy). rtv-next branches UI + interaction
+ * behavior on this: `accessoire` / `shelfAccessoire` route select + delete through the dedicated
+ * `onAccessorySelect` / `onAccessoryDelete` callbacks; mains use `onElementSelected` /
+ * `onElementDeleted`. Defaults to `'planned'` when omitted.
+ */
+export type ElementOverlayType = 'planned' | 'boxElement' | 'accessoire' | 'shelfAccessoire';
+export interface ElementOverlayInfo {
+    setId: string;
+    posNr?: string;
+    state: ElementOverlayState;
+    /** Element type — drives which interaction/UI path applies. Defaults to `'planned'`. */
+    type?: ElementOverlayType;
+    canDelete?: boolean;
+    canMove?: boolean;
+    canRotate?: boolean;
+    /** Standard planner element copy */
+    canCopy?: boolean;
+    /** Box planner directional copy */
+    canCopyLeft?: boolean;
+    canCopyRight?: boolean;
+    canCopyTop?: boolean;
+    /** Show the directional copy buttons even when the element is not selected (AVL/AVR copy). */
+    copyAlwaysVisible?: boolean;
+    /** Numeric element ID of this element's parent (for accessoire / sub-element hierarchy). */
+    parentElementId?: number;
+    /** Display label shown as tooltip on posNr badge (hover / selected). */
+    articleName?: string;
+    /** Article codex of the planned element — drives per-family cutout rules (`deckCutout.articleRules`). */
+    articleCodex?: string;
+}
+export type RTVPlannerMode = '2DGrid' | '3DImage' | 'BoxPlanner' | 'No' | 'ProductList' | 'RTViewer' | '3DCOMB';
+export interface UIConfig {
+    templateConfig: 'standard' | 'gold' | 'hidden';
+    posTrashIcon: 'TOP_RIGHT_BACK' | 'POSNUM_TOP';
+    hideUiIcons: boolean;
+    plannerMode: RTVPlannerMode;
+    /**
+     * Accessory placement interaction mode (parallel + toggleable):
+     * - `cellBoxes` (default): render a placeable bbox at every free cell; click a box to place.
+     * - `autoPlaceDrag`: selecting an article auto-places it at a default cell, then the user
+     *   free-follow/snap drags it to reposition (no boxes). IKEA-style.
+     */
+    accessoryPlacement: 'cellBoxes' | 'autoPlaceDrag';
+}
+export declare const DEFAULT_UI_CONFIG: UIConfig;
+/**
+ * Selection chrome (posNr + outline) shows only when a MAIN element is `selectable`. A configurator
+ * step (mains `active`/`selected`, none selectable) suppresses it; a planner with selectable mains
+ * shows it. Falls back to any-selectable when no mains are present.
+ */
+export declare function isSelectionPossible(info: Map<string, ElementOverlayInfo>): boolean;
+/** Avoids store churn when the host passes a new Map with identical entries each render. */
+export declare function elementOverlayMapsEqual(a: Map<string, ElementOverlayInfo>, b: Map<string, ElementOverlayInfo>): boolean;
+//# sourceMappingURL=plannerUi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plannerUi.d.ts","sourceRoot":"","sources":["../../../../../src/types/plannerUi.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,UAAU,GAAG,YAAY,GAAG,cAAc,GAAG,QAAQ,CAAC;AAExF;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,YAAY,GAAG,YAAY,GAAG,iBAAiB,CAAC;AAE7F,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,mBAAmB,CAAC;IAC3B,wFAAwF;IACxF,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oCAAoC;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mCAAmC;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8FAA8F;IAC9F,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,4FAA4F;IAC5F,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wEAAwE;IACxE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yGAAyG;IACzG,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,SAAS,GACT,YAAY,GACZ,IAAI,GACJ,aAAa,GACb,UAAU,GACV,QAAQ,CAAC;AAEb,MAAM,WAAW,QAAQ;IACvB,cAAc,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC/C,YAAY,EAAE,gBAAgB,GAAG,YAAY,CAAC;IAC9C,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,cAAc,CAAC;IAC5B;;;;;OAKG;IACH,kBAAkB,EAAE,WAAW,GAAG,eAAe,CAAC;CACnD;AAED,eAAO,MAAM,iBAAiB,EAAE,QAM/B,CAAC;AAOF;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,OAAO,CAYlF;AAED,4FAA4F;AAC5F,wBAAgB,uBAAuB,CACrC,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,EAClC,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,GACjC,OAAO,CA0BT"}