@roomle/web-sdk 3.7.0-alpha.2 → 3.7.0-alpha.4

package/lib/roomle-sdk.d.ts

@@ -3,6 +3,7 @@ import { BufferGeometry } from 'three';
 import { BufferGeometryEventMap } from 'three';
 import { Camera } from 'three';
 import { Color } from 'three';
+import { ColorRepresentation } from 'three';
 import { CommunicationInterfaceCallback } from '../../../workers/src/communication-interface';
 import { ConstructionObjectDoorArchArray } from 'roomle-core-hsc/src/embind/plannerCoreInterface';
 import { createExtObjId } from '../../../../../common/src/utils/external-objects';
@@ -14,7 +15,6 @@ import { Euler } from 'three';
 import { ExtObjId } from '../../../common/src/utils/external-objects';
 import { ExtObjId as ExtObjId_2 } from '../../../../../common/src/utils/external-objects';
 import { Group } from 'three';
-import { GUI } from 'dat.gui';
 import { HiCallbacks } from '../../../../common/src/hi/hi-types';
 import { HiOrderData } from '../../../../common/src/hi/hi-types';
 import { HiOrderHeader } from '../../../../common/src/hi/hi-types';
@@ -31,6 +31,7 @@ import { Nullable as Nullable_2 } from '../../../../../common/src/utils/types';
 import { Object3D } from 'three';
 import { Object3DEventMap } from 'three';
 import { OrthographicCamera } from 'three';
+import { ParametersGroup } from 'three/examples/jsm/inspector/tabs/Parameters.js';
 import { PerspectiveCamera } from 'three';
 import { PointLight } from 'three';
 import { Scene } from 'three';
@@ -308,7 +309,7 @@ export declare abstract class CameraBehaviour {
     private _cameraChangeListener;
     constructor(cameraControl: CameraControl, state: CameraBehaviourState);
     abstract get cameraControl(): CameraControl;
-    protected get state(): CameraBehaviourState;
+    protected get state(): CameraBehaviourState | null;
     setCameraChangeListener(callback: () => void): void;
     removeCameraChangeListener(): void;
     protected _onCameraChanged(): void;
@@ -633,7 +634,7 @@ export declare class CeilingLight extends PointLight {
     constructor(debug: boolean, maxQualityLevel: QualityLevel);
     recalculatePower(amountOfLights: number): void;
     update(qualityLevel: QualityLevel): void;
-    private _addDebugUI;
+    addDebugUI(ceilingLightsParameters: GenericGUIParamFolder): void;
 }
 
 export declare interface CheckDropDownEntry {
@@ -671,7 +672,7 @@ export declare interface CleanupOptions {
 export declare type ColorsIn3dScene = Record<RoomleColors, HexColorString | HexColorNumber>;
 
 export declare interface CommonConfiguratorKernelCallbackI {
-    Editor3dComponentCreated(id: number, position: KernelVector3, eulerAngles: KernelVector3, isRootComponent: boolean, parentObjectRuntimeId: number): void;
+    Editor3dComponentCreated(componentDocking: KernelComponentDocking): void;
     Editor3dAddMesh(runtimeComponentId: number, meshId: number, geometryName: string, environmentGeometry: boolean, meshAttributes: KernelMeshAttributes, meshBuffer: KernelMeshBuffer): void;
     Editor3ChangedMesh(runtimeComponentId: number, meshId: number, geometryName: string, meshAttributes: KernelMeshAttributes): void;
     Editor3dRemoveMesh(runtimeComponentId: number, meshId: number): void;
@@ -679,7 +680,7 @@ export declare interface CommonConfiguratorKernelCallbackI {
     componentConfigurationUpdated(runtimeComponentId: number, geometryChanged: boolean): void;
     Editor3dBeginConstruction(componentId: number, isDeltaUpdate: boolean): void;
     Editor3dEndConstruction(id: number): void;
-    Editor3dComponentDocked(componentId: number, isRootComponent: boolean, parentId: number, componentPosition: KernelVector3, componentRotation: KernelVector3): void;
+    Editor3dComponentDocked(componentDocking: KernelComponentDocking): void;
     Editor3dGeometryReady(id: number): void;
     Editor3dGeometryNotReady(id: number): void;
     componentDeleted(componentId: number): void;
@@ -943,7 +944,6 @@ export declare abstract class CommonKernelAccess implements LifeCycleCallbacks,
     loadComponent(componentIds: string[]): void;
     loadItemConfigurations(itemIds: string[]): Promise<void>;
     requestDeleteComponent(componentId: number): void;
-    dockComponentWithPosition(parentId: number, parentDockId: number, childId: number, childDockId: number, position: KernelVector3): void;
     Editor3dAddMesh(runtimeComponentId: number, meshId: number, geometryName: string, environmentGeometry: boolean, meshAttributes: KernelMeshAttributes, meshBuffer: KernelMeshBuffer): void;
     Editor3ChangedMesh(runtimeComponentId: number, meshId: number, geometryName: string, meshAttributes: KernelMeshAttributes): void;
     Editor3dRemoveMesh(runtimeComponentId: number, meshId: number): void;
@@ -952,8 +952,8 @@ export declare abstract class CommonKernelAccess implements LifeCycleCallbacks,
     Editor3dChangedLightSource(runtimeComponentId: number, lightSourceId: number, lightSourceAttributes: KernelLightSourceAttributes): void;
     Editor3dBeginConstruction(id: number, isDeltaUpdate: boolean): void;
     Editor3dEndConstruction(id: number): void;
-    Editor3dComponentCreated(id: number, position: KernelVector3, eulerAngles: KernelVector3, isRootComponent: boolean, parentObjectRuntimeId: number): void;
-    Editor3dComponentDocked(componentId: number, isRootComponent: boolean, parentId: number, componentPosition: KernelVector3, componentRotation: KernelVector3): void;
+    Editor3dComponentCreated(componentDocking: KernelComponentDocking): void;
+    Editor3dComponentDocked(componentDocking: KernelComponentDocking): void;
     Editor3dGeometryReady(id: number): void;
     Editor3dGeometryNotReady(id: number): void;
     componentDeleted(componentId: number): void;
@@ -998,30 +998,6 @@ export declare class ComponentArray extends EmsArray<KernelComponent> {
 export declare class ComponentArray_2 extends EmsArray<KernelComponent> {
 }
 
-export declare class ComponentRaycastHelper {
-    private _object;
-    private _camera;
-    private _raycaster;
-    private _nonTransparentComponent;
-    constructor();
-    init(object: Object3D, camera: PerspectiveCamera): void;
-    setCamera(camera: PerspectiveCamera): void;
-    setObject(object: Object3D): void;
-    changeMaterialsOnSelect(object: Object3D, component: RoomleComponent | null, selected?: boolean, callback?: () => void): void;
-    private _changeMaterialsOnSelect;
-    isComponentVisible(component: RoomleComponent): boolean;
-    checkComponentAndPreviewVisibility(sceneEventHandler: ConfiguratorSceneEventHandler, configuratorViewModel: ConfiguratorViewModel): void;
-    checkComponentVisibility(sceneEventHandler: ConfiguratorSceneEventHandler, configuratorViewModel: ConfiguratorViewModel): void;
-    areAllPreviewsVisible(configuratorViewModel: ConfiguratorViewModel): boolean;
-    areAllComponentsInFrustum(previews: RoomleComponent[]): boolean;
-    checkPreviewVisibility(configuratorViewModel: ConfiguratorViewModel): void;
-    isComponentMeasurementLabelOccluded(labelWorldPos: Vector3, component: RoomleComponent): boolean;
-    checkMultipleLabelOcclusion(labelPositions: Array<{
-        id: string;
-        worldPos: Vector3;
-    }>, component: RoomleComponent): Set<string>;
-}
-
 export declare type ComponentType = 'preview' | 'component';
 
 export declare type ConfigForPlugin<P extends PluginName> = PluginConfigMap[P];
@@ -1284,7 +1260,7 @@ export declare class ConfiguratorKernelAccess extends CommonKernelAccess {
     private _updatePlanObjectChildren;
     updatePlanObjectDependencies(planObjectId: number): void;
     private _updateConfigurationHasChildren;
-    dockComponent(parentId: number, parentDockId: number, childId: number, childDockId: number): void;
+    dockComponent(parentId: number, parentDockId: number, childId: number, childDockId: number, position?: KernelVector3): void;
     changeUseOfHDGeometry(context: ConfiguratorContext, useHDGeometry: boolean): void;
     webGlPreviewDockings(context: ConfiguratorContext, dragIn: boolean): void;
     webGlPreviewDockingsForPlanObject(planObjectId: number, possibleChild: PossibleChildPreviewElement, dragIn: boolean): void;
@@ -1329,13 +1305,13 @@ export declare class ConfiguratorKernelAccess extends CommonKernelAccess {
         meshId: string;
         quality: number;
     }>): Promise<void>;
-    Editor3dComponentCreated(id: number, position: KernelVector3, eulerAngles: KernelVector3, isRootComponent: boolean, parentId: number): void;
+    Editor3dComponentCreated(componentDocking: KernelComponentDocking): void;
     Editor3dPlanObjectConstructionDone(planObjectId: number): void;
     Editor3dBeginGroup(): void;
     Editor3dEndGroup(): void;
     Editor3dSetMaterial(): void;
     Editor3dLoadMaterial(): void;
-    Editor3dAddDockPreview(componentId: number, previewId: number): void;
+    Editor3dAddDockPreview(componentId: number, previewId: number, componentType: KernelComponentType): void;
     Editor3dSetPreviewAssociations(dockPairs: KernelDockPairPreview[], previewId: number): void;
     Editor3dPreviewConstructionDone(componentId: number, objectId: number): void;
     Editor3dTranslateBy(): void;
@@ -1388,11 +1364,11 @@ export declare interface ConfiguratorKernelCallbackI extends CommonConfiguratorK
     planObjectUpdated(planObject: PlanObjectKernel, pendingDocking: boolean): void;
     planObjectConfigurationUpdated(planObjectId: number, configuration: ConfigurationString, hash: string, pendingDocking: boolean): void;
     configurationLoaded(conversationId: number, objectId: number, componentId: number, hash: string, errors: any, isFreeFlying: boolean): void;
-    Editor3dAddDockPreview(componentId: number, previewId: number): void;
+    Editor3dAddDockPreview(componentId: number, previewId: number, componentType: KernelComponentType): void;
     Editor3dSetPreviewAssociations(dockPairs: KernelDockPairPreview[], previewId: number): void;
     Editor3dPreviewConstructionDone(componentId: number, objectId: number): void;
     Editor3dPlanObjectConstructionDone(planObjectId: number): void;
-    Editor3dComponentDocked(componentId: number, isRootComponent: boolean, parentObjectRuntimeId: number, componentPosition: KernelVector3, componentRotation: KernelVector3): void;
+    Editor3dComponentDocked(componentDocking: KernelComponentDocking): void;
     finishParameterChange(resolve: () => void, reject: () => void): void;
     updateAnimationParameters(elementId: number | number[], parameters: KernelParameter[]): void;
     changeAnimationValue(elementId: number, parameterKey: string, value: string, level: number, animationLevel: AnimationLevelType, animate: boolean): void;
@@ -1411,7 +1387,6 @@ export declare interface ConfiguratorKernelClass {
     updateConfiguration(kernelConversationId: number, objectOrComponentId: number, serializedConfiguration: string): void;
     loadPlainComponent(conversationId: number, componentId: RapiId, configuration: ConfigurationString): void;
     loadFreeFlyingConfiguration(conversationId: number, configuration: ConfigurationString): void;
-    loadFreeFlyingExternalObject(conversationId: number, targetObjectId: number, serializedConfiguration: string): void;
     requestComponentDockPreview(targetObjectId: number, componentId: string, serializedComponent: string, dragIn: boolean, allowInsertInBetween: boolean): void;
     requestItemDockPreview(targetObjectId: number, serializedConfiguration: string, dragIn: boolean, allowInsertInBetween: boolean): void;
     requestExternalObjectDockPreview(targetObjectId: number, articleId: string, dragIn: boolean, allowInsertInBetween: boolean): void;
@@ -1433,9 +1408,9 @@ export declare interface ConfiguratorKernelClass {
     getPlanObjectParameters(planObjectId: number): KernelParameter[];
     getPlanObjectAnimations(planObjectId: number): KernelAnimation[];
     setPlanObjectParameter(planObjectId: number, parameterKey: string, value: string): void;
-    dockComponent(childId: number, childDockId: number, parentId: number, parentDockId: number): void;
-    dockComponentWithPosition(childId: number, childDockId: number, parentId: number, parentDockId: number, position: KernelVector3): void;
+    dockComponent(childId: number, childDockId: number, parentId: number, parentDockId: number, position?: KernelVector3): void;
     getComponent(componentId: number): KernelComponent;
+    getComponentBounds(componentId: number, animationValues: string[]): KernelAssembledObjectBounds;
     getComponentId(componentId: number): RapiId;
     isExternalPlanObject(objectOrPlanComponentId: number): boolean;
     getComponentOrModuleInformation(objectOrPlanComponentId: number): KernelObjectInformation;
@@ -1550,6 +1525,7 @@ export declare class ConfiguratorSceneEventHandler extends SceneEventHandler<Sce
     private _hoverOffPreview;
     private _hoverOnPreviewLine;
     private _hoverMovePreviewLine;
+    private _updatePositionForPreview;
     private _updatePositionForPreviewLine;
     private _hoverOffPreviewLine;
     private _setDragComponentShadow;
@@ -1571,7 +1547,7 @@ export declare class ConfiguratorSceneEventHandler extends SceneEventHandler<Sce
     setCamera(camera: Camera): void;
     setObject(object: Object3D): void;
     private _findComponentToBeSelected;
-    private isSiblingSelected;
+    private getRootComponent;
 }
 
 export declare class ConfiguratorSceneManager extends SceneManager implements ConfiguratorViewModelCallbackI {
@@ -1588,7 +1564,7 @@ export declare class ConfiguratorSceneManager extends SceneManager implements Co
     protected _globalInitData: GlobalInitData;
     protected _viewModel: ConfiguratorViewModel;
     private _componentFactory;
-    protected _componentRaycastHelper: ComponentRaycastHelper;
+    protected _highlightHelper: HighlightHelper;
     private _dimensionHelper;
     private _uiIntersectionHelper;
     private _sceneEventHandler;
@@ -1733,6 +1709,7 @@ export declare class ConfiguratorSceneManager extends SceneManager implements Co
     private _removeCustomComponentDimensions;
     clearHighlighting(): void;
     getExternalSubArticles(_id: number): PosArticle[];
+    protected _updateHighlightHelper(object?: Object3D | null): void;
 }
 
 export declare class ConfiguratorUiCallbacks extends UiCallback implements ConfiguratorDebugCallbacks {
@@ -2059,19 +2036,19 @@ export declare class ConfiguratorViewModel implements ConfiguratorKernelCallback
     private _removeLightSourceFromComponent;
     private _addLightSourceToComponent;
     private _changeLightSourceOfComponent;
-    getComponent(componentId: number): RoomleComponent;
-    getNumberOfPossibleChildrenForComponent(componentId: number): number;
+    getComponent(componentId: number): RoomleComponent | null;
+    getNumberOfPossibleChildrenForComponent(componentId: number): number | undefined;
     tryToMergeComponents(): void;
     private _requestMergeComponents;
     private _mergeNextComponent;
     private _mergeComponent;
     protected _addComponent(component: RoomleComponent): void;
     removeDockingComponent(): void;
-    protected dockComponent(componentId: number, isRootComponent: boolean, parentId: number, componentPosition: KernelVector3, componentRotation: KernelVector3): void;
+    protected dockComponent(componentDocking: KernelComponentDocking): void;
     dockComponentWithPosition(previewComponent: PreviewLineComponent, component?: RoomleComponent): void;
     removePreviews(): void;
     private _updatePlanObject;
-    Editor3dAddDockPreview(componentId: number, previewId: number): void;
+    Editor3dAddDockPreview(componentId: number, previewId: number, componentType: KernelComponentType): void;
     Editor3dAddMesh(runtimeComponentId: number, meshId: number, geometryName: string, environmentGeometry: boolean, meshAttributes: KernelMeshAttributes, meshBuffer: KernelMeshBuffer): void;
     Editor3ChangedMesh(runtimeComponentId: number, meshId: number, geometryName: string, meshAttributes: KernelMeshAttributes): void;
     Editor3dRemoveMesh(runtimeComponentId: number, meshId: number): void;
@@ -2079,8 +2056,8 @@ export declare class ConfiguratorViewModel implements ConfiguratorKernelCallback
     Editor3dAddLightSource(runtimeComponentId: number, lightSourceId: number, lightSourceAttributes: KernelLightSourceAttributes): void;
     Editor3dChangedLightSource(runtimeComponentId: number, lightSourceId: number, lightSourceAttributes: KernelLightSourceAttributes): void;
     Editor3dBeginConstruction(componentId: number, isDeltaUpdate: boolean): void;
-    Editor3dComponentCreated(id: number, position: KernelVector3, eulerAngles: KernelVector3, isRootComponent: boolean, parentObjectRuntimeId: number): void;
-    Editor3dComponentDocked(componentId: number, isRootComponent: boolean, parentId: number, componentPosition: KernelVector3, componentRotation: KernelVector3): void;
+    Editor3dComponentCreated(componentDocking: KernelComponentDocking): void;
+    Editor3dComponentDocked(componentDocking: KernelComponentDocking): void;
     Editor3dEndConstruction(id: number): void;
     Editor3dGeometryReady(id: number): void;
     Editor3dGeometryNotReady(id: number): void;
@@ -2114,7 +2091,7 @@ export declare class ConfiguratorViewModel implements ConfiguratorKernelCallback
     setGeometriesMergedListener(fun: () => void): void;
     removeGeometriesMergedListener(): void;
     setMergeThreshold(threshold: number): void;
-    protected _generateMesh(runtimeComponentId: number, geometryId: string | null, materialId: string | null, vertices: Float32Array, indices: Int32Array, uvCoords: Float32Array, normals: Float32Array, _type?: KernelEnum, _newGeometryInstance?: boolean, materialAttributes?: Record<string, string>): Mesh;
+    protected _generateMesh(runtimeComponentId: number | undefined, geometryId: string | null | undefined, materialId: string | null, vertices: Float32Array, indices: Int32Array, uvCoords: Float32Array, normals: Float32Array, _type?: KernelEnum, _newGeometryInstance?: boolean, materialAttributes?: Record<string, string>): Mesh;
     protected _setMaterial(mesh: Mesh, material: any, _type?: KernelEnum): void;
     constructComponents(planObjectId: number): void;
     requestSubPartConstruction(partId: number): Promise<Mesh>;
@@ -2259,6 +2236,12 @@ export declare const CORE_PLAN_COMPONENT_TYPE: {
     readonly SUB_ARTICLE: 4;
 };
 
+export declare const CORE_SNAP_STATE: {
+    readonly DEFAULT: 0;
+    readonly DOCKING: 1;
+    readonly COLLISION: 2;
+};
+
 export declare const CORE_TYPE_OF_CORE_ID: {
     readonly CONFIGURATOR: 0;
     readonly PLANNER: 1;
@@ -2648,7 +2631,7 @@ export declare abstract class Environment {
     updateCamera(_camera: PerspectiveCamera): void;
     abstract addToScene(): void;
     abstract removeFromScene(): void;
-    abstract showGUI(updateCallback: () => void): void;
+    abstract showGUI(sceneParameters: GenericGUIParamFolder): void;
     reload(): void;
     updateBounds(bounds: Vector3, _force?: boolean): void;
     cleanUp(): void;
@@ -2980,11 +2963,19 @@ export declare interface ExternalObjectAPI {
 export declare interface ExternalObjectApiConfiguration {
     loadExternalObjectsFromPlan?: boolean;
     enableArrangementCorrection?: boolean;
+    enableVerticalDocking?: boolean;
     providePossibleChildren?: boolean;
     uiConfiguration?: ExternalObjectUiConfiguration;
     materialConfiguration?: ExternalObjectMaterialConfiguration;
     debugConfiguration?: ExternalObjectDebugConfiguration;
     overlayUiDrawer?: boolean;
+    transparentHighlighting?: boolean;
+    maximumCatalogLevel?: number;
+}
+
+export declare interface ExternalObjectContextDataItem {
+    contextData: ExternalObjectRootModuleContextData;
+    rootModuleId: string;
 }
 
 export declare interface ExternalObjectContour {
@@ -2996,12 +2987,23 @@ export declare interface ExternalObjectDebugConfiguration {
     createDebugGeometry?: boolean;
 }
 
+export declare interface ExternalObjectDockedContext {
+    dockedRoots: ExternalObjectDockedRootModule[];
+    ownDockingVector: string;
+}
+
+export declare interface ExternalObjectDockedRootModule {
+    dockingVector: string;
+    id: string;
+}
+
 export declare interface ExternalObjectGroup {
     groupId: string;
     pos: number[];
     rotationY?: number;
     rootModules?: ExternalObjectRootModule[];
     contours?: ExternalObjectContour[];
+    contextData?: ExternalObjectContextDataItem[];
 }
 
 export declare interface ExternalObjectLoadConfiguration {
@@ -3041,6 +3043,10 @@ export declare interface ExternalObjectRootModule {
     rotationY?: number;
 }
 
+export declare interface ExternalObjectRootModuleContextData {
+    dockedRoots: ExternalObjectDockedContext[];
+}
+
 export declare interface ExternalObjectSegment {
     cmd: string;
     x: number;
@@ -3155,6 +3161,7 @@ export declare interface FeatureFlags {
     /* Excluded from this release type: interiorLights */
     /* Excluded from this release type: advancedDimensioning */
     /* Excluded from this release type: webGpu */
+    /* Excluded from this release type: advancedHighlighting */
 }
 
 export declare interface FetchOptions {
@@ -3206,6 +3213,20 @@ export declare class FloorPlanElementViewModel extends PlanElementViewModel {
     private calculateTextVisibility;
 }
 
+/**
+ * Minimal structural type that both dat.gui `GUI` folders (WebGL) and three.js
+ * `ParametersGroup` (WebGPU) satisfy, this allows building
+ * debug GUIs without coupling to a specific backend.
+ *
+ * `any` is intentional here — the two libraries have genuinely incompatible
+ * generic signatures that cannot be unified without it.
+ */
+export declare interface GenericGUIParamFolder {
+    add(object: any, property: string, ...args: any[]): any;
+    addColor(object: any, property: string): any;
+    addFolder(name: string): GenericGUIParamFolder;
+}
+
 export declare type GenericRoomleRenderer = RoomleRenderer<WebGLRenderer | WebGPURenderer>;
 
 export declare const enum GEOMETRY {
@@ -3382,7 +3403,7 @@ export declare interface GlueLogic {
     updateProperty(rootModuleId?: string, propertyName?: string, propertyValue?: string | number | boolean): void;
     findValidSubArticles(posGroupIds: string[] | string): PosArticle[];
     getValidContainerModulesForSubArticle(posGroupIds: string[] | string, subArticleId: string): ExternalObjectValidContainerModules[];
-    addSubArticle(articleId: string, rootModuleId: string, parentModuleId: string): void;
+    addSubArticle(articleId: string, rootModuleId: string, parentModuleId: string, insertPosition?: number[]): void;
     deleteSubArticles(groupId: string, subModuleId: string[] | string): Promise<void>;
     arrangeRootModulesOfGroup(changedGroup: ExternalObjectGroup): Promise<void>;
     changedGroupPlanningSituation(changedGroup: ExternalObjectGroup, objectPositionChanged: boolean): Promise<void>;
@@ -3459,6 +3480,18 @@ export declare type HiAttributeOptionsResult = CheckDropDownResult | CheckDropDo
 
 export declare type HiContextAction = (typeof HI_CONTEXT_ACTION)[keyof typeof HI_CONTEXT_ACTION];
 
+export declare interface HighlightHelper {
+    init(object: Object3D, camera: PerspectiveCamera): void;
+    setCamera(camera: PerspectiveCamera): void;
+    setObject(object: Object3D | null): void;
+    cancelDocking(object: Object3D, callback?: () => void): void;
+    checkComponentAndPreviewVisibility(sceneEventHandler: ConfiguratorSceneEventHandler, configuratorViewModel: ConfiguratorViewModel): void;
+    checkComponentVisibility(sceneEventHandler: ConfiguratorSceneEventHandler, configuratorViewModel: ConfiguratorViewModel): void;
+    checkPreviewVisibility(configuratorViewModel: ConfiguratorViewModel): void;
+    areAllComponentsInFrustum(previews: RoomleComponent[]): boolean;
+    onSelectionChanged(object: Object3D, componentIds: number[], callback?: () => void): void;
+}
+
 export declare type HiLoadObjectReason = (typeof HI_LOAD_OBJECT_REASON)[keyof typeof HI_LOAD_OBJECT_REASON];
 
 export declare interface HiObjectSelectionApi {
@@ -3477,6 +3510,7 @@ export declare class HiTagCatalogCallbacks implements Context {
     private _externalItems;
     private _externalConfigurations;
     private _tagIds;
+    private _initData;
     private _globalCallback;
     private _configuratorViewModel;
     constructor(creator: string, articles: Promise<any>);
@@ -3614,7 +3648,7 @@ export declare class ImageRenderer implements Context {
      */
     private _renderImageFrameWithCleanScene;
     private _compositeWithDimensions;
-    prepareThumbnailImage(scene: Scene, viewModel: PlanViewModel, cameraBehaviour: CameraBehaviour, perspectiveOffsetCamera: PerspectiveCamera, options: PrepareImageOptionsPlanner, onAfterRender: () => void): Promise<Base64Image>;
+    prepareThumbnailImage(scene: Scene, viewModel: PlanViewModel, cameraBehaviour: CameraBehaviour, perspectiveOffsetCamera: PerspectiveCamera, options: PrepareImageOptionsPlanner | undefined, onAfterRender: () => void): Promise<Base64Image>;
     private _renderImageFrame;
 }
 
@@ -3647,8 +3681,8 @@ export declare class InitData implements Context, Omit<InitDataDefinition, 'colo
     disableDebugGUI?: boolean;
     disableEnvMap?: boolean;
     envMapUrl?: string;
-    envMapIntensity?: number;
-    envMapRotation?: number;
+    envMapIntensity: number;
+    envMapRotation: number;
     maxLightSources?: number;
     legacyLight?: boolean;
     sceneLight?: DefaultEnvironmentSceneType;
@@ -3904,6 +3938,11 @@ export declare interface KernelAnimationAction {
     type: string;
 }
 
+export declare interface KernelAssembledObjectBounds {
+    boundingBox: KernelCube;
+    parts: KernelObjectBounds[];
+}
+
 export declare interface KernelAttic extends KernelObject {
     getFrom(): NodePlanObject;
     getTo(): NodePlanObject;
@@ -3952,7 +3991,7 @@ export declare interface KernelComponent {
     rotation: KernelVector3;
     globalTransform: KernelMatrix4;
     boxForMeasurement: KernelCube;
-    geometryBounds: KernelCube[];
+    geometryBounds: KernelAssembledObjectBounds;
     parameters: KernelParameter[];
     parameterGroups: KernelParameterGroup[];
     possibleChildren: KernelPossibleChild[];
@@ -3963,6 +4002,15 @@ export declare interface KernelComponent {
     childAnimationTransformations: ComponentAnimationTransformation[];
 }
 
+export declare interface KernelComponentDocking {
+    componentId: number;
+    isRootComponent: boolean;
+    parentId: number;
+    position: KernelVector3;
+    rotation: KernelVector3;
+    type: KernelComponentType;
+}
+
 export declare interface KernelComponentType {
     value: Enumify<typeof CORE_PLAN_COMPONENT_TYPE>;
 }
@@ -4011,6 +4059,14 @@ export declare interface KernelEnum {
     value: number;
 }
 
+export declare interface KernelExtrudedRectangle {
+    angle: number;
+    bottomCenter: KernelVector3;
+    eulerRotation: KernelVector3;
+    size: KernelVector3;
+    readonly cornerPoints: EmsArray<KernelVector3>;
+}
+
 export declare interface KernelFloor extends KernelObject {
     area: number;
     material: KernelFloorMaterial;
@@ -4100,6 +4156,11 @@ export declare interface KernelObject {
     getId(): number;
 }
 
+export declare interface KernelObjectBounds {
+    boundingBox: KernelCube;
+    rectangleBox: KernelExtrudedRectangle;
+}
+
 export declare interface KernelObjectConfiguration {
     runtimeId: number;
     serializedDefinition: string;
@@ -4310,7 +4371,7 @@ export declare class KernelViewModel {
     protected _coreReference: KernelObject | null;
     constructor(reference: KernelObject);
     clearReference(): void;
-    getKernelObject(): KernelObject;
+    getKernelObject(): KernelObject | null;
 }
 
 export declare interface KernelViewType {
@@ -4359,7 +4420,7 @@ export declare interface LibraryData {
     solveModuleAttributeConflict(module: PosModuleData, attributeName: string, value: string | number | boolean): PosModuleAttribute[] | undefined;
     getValidSubArticles(calculatedPosGroup: PosGroup, articles: PosArticle[], masterData: MasterData): PosArticle[];
     getValidContainerModulesForSubArticle(calculatedPosGroup: PosGroup, subArticle: PosArticle, masterData: MasterData): ExternalObjectValidContainerModules[];
-    addSubArticle(targetPosGroup: PosGroup, article: PosArticle, rootId: string, parentModuleId: string): PosGroup;
+    addSubArticle(targetPosGroup: PosGroup, article: PosArticle, rootId: string, parentModuleId: string, insertPosition?: number[]): PosGroup;
     deleteSubArticle(targetPosGroup: PosGroup, rootId: string, articleModuleId: string): PosGroup;
 }
 
@@ -4385,7 +4446,7 @@ export declare class LightCache {
     allowedToSpawnMoreLights(): boolean;
     addActiveLight(light: Light): void;
     cacheLight(light: Light): void;
-    getLightFromCache(type: KernelLightSourceType): Light;
+    getLightFromCache(type: KernelLightSourceType): Light | null;
     clear(): void;
     private _setMaximumLights;
 }
@@ -4414,7 +4475,7 @@ export declare abstract class LightSetting {
     abstract addToScene(): void;
     abstract removeFromScene(): void;
     abstract reload(): void;
-    abstract showGUI(): void;
+    abstract showGUI(sceneParameters: GenericGUIParamFolder): void;
     getCameraContainer(): Object3D;
 }
 
@@ -4867,6 +4928,11 @@ export declare interface ObjectMeasurementsTransferable {
     objectToWallsMeasurements: ObjectToWallDimensionTransferable[];
 }
 
+export declare interface ObjectSnapInformation {
+    geometryHelpLines: GeometryHelpLineArray;
+    snapState: SnapState;
+}
+
 export declare type ObjectToWallDimensionTransferable = DimensionDefinition<Position2, Position3>;
 
 export declare interface ObjectToWallLine {
@@ -4889,6 +4955,11 @@ export declare interface OffsetCamera {
 export declare interface OrthographicOffsetCamera extends OrthographicCamera, OffsetCamera {
 }
 
+export declare interface OutlineCustomParameters {
+    outlineVisibleEdgeColor: ColorRepresentation;
+    outlineHiddenEdgeColor: ColorRepresentation;
+}
+
 export declare const enum PARAMETER_KERNEL_TYPE {
     UNKNOWN = "",
     INTEGER = "Integer",
@@ -5243,7 +5314,7 @@ export declare interface PlanModelViewHelper_2 {
     getExternalObjectGroups(plan: Plan_2): KernelObjectConfigurationArray;
     getExternalRoomInformation(plan: Plan_2): RoomInformation;
     calculateLightSourceDistribution(plan: Plan_2, lightSourceConfiguration: LightSourceConfiguration): RoomLightSourceDistributionArray;
-    getObjectGeometryHelpLines(anObject: PlanObject, debugHelpLines: boolean): GeometryHelpLineArray;
+    getObjectSnapInformation(anObject: PlanObject, debugHelpLines: boolean): ObjectSnapInformation;
 }
 
 export declare class Planner<P extends readonly PluginName[] = readonly []> extends Main {
@@ -5352,7 +5423,7 @@ export declare class PlannerKernelAccess extends ConfiguratorKernelAccess {
     constructor(creator: string);
     protected _loadSuccess(): void;
     protected _loadError(): void;
-    get homagIntelligence(): HomagIntelligence;
+    get homagIntelligence(): HomagIntelligence | null;
     setHomagIntelligence(homagIntelligence: HomagIntelligence | null): void;
     private _createPlanInteractionHandler;
     addPlannerListener(listener: PlannerKernelCallbackI): void;
@@ -5398,7 +5469,7 @@ export declare class PlannerKernelAccess extends ConfiguratorKernelAccess {
     externalObjectComponentSplitOff(plan: Plan_2, planObject: PlanObject, splitGroups: ExternalObjectGroup[]): void;
     externalObjectArrangementChanged(plan: Plan_2, planObject: PlanObject, changedGroup: ExternalObjectGroup): void;
     externalObjectRequestAddOnContainers(plan: Plan_2, planObject: PlanObject, groupId: string, subArticleId: string): void;
-    externalObjectAddSubArticle(plan: Plan_2, planObject: PlanObject, subArticleId: string, rootModuleId: string, parentModuleId: string): void;
+    externalObjectAddSubArticle(plan: Plan_2, planObject: PlanObject, subArticleId: string, rootModuleId: string, parentModuleId: string, insertPosition?: number[]): void;
     externalObjectRemoveSubModule(plan: Plan_2, planObject: PlanObject, groupId: string, subModuleId: string): void;
     planObjectConfigurationLoaded(plan: Plan_2, element: PlanElement_2, success: boolean): Promise<void>;
     planObjectConfigurationChanged(plan: Plan_2, object: PlanObject): void;
@@ -5462,7 +5533,7 @@ export declare interface PlannerKernelCallbackI {
     stoppedDrawing(): void;
     requestCatalogItem(catalogItemId: string): void;
     externalObjectRequestAddOnContainers(groupId: string, subArticleId: string): void;
-    externalObjectAddSubArticle(subArticleId: string, rootModuleId: string, parentModuleId: string): void;
+    externalObjectAddSubArticle(subArticleId: string, rootModuleId: string, parentModuleId: string, insertPosition?: number[]): void;
     externalObjectRemoveSubModule(groupId: string, subModuleId: string): void;
 }
 
@@ -5563,7 +5634,7 @@ export declare class PlannerSceneEventHandler extends SceneEventHandler<SceneEve
     disable(): void;
     get planInteractionHandler(): PlanInteractionHandler;
     get planModelViewHelper(): PlanModelViewHelper_2;
-    get hoveredObjectId(): number;
+    get hoveredObjectId(): number | null;
     get isCurrentlyDrawing(): boolean;
     enable(): void;
     enableConstructionEvents(enable: boolean): void;
@@ -5773,6 +5844,7 @@ export declare class PlannerSceneManager extends ConfiguratorSceneManager implem
     protected _updateConfigurationFromHistory(configurationString: string): Promise<void>;
     setMode(mode: Enumify_3<typeof CAMERA_TYPE>): void;
     private _clearHighlighting;
+    updateHighlightingOfPlanElements(): void;
     highlightPlanElementsById(runtimeIds: number[] | null): void;
     highlightPlanElementById(runtimeId: number | null): void;
     destroy(): void;
@@ -5809,8 +5881,8 @@ export declare class PlannerSceneManager extends ConfiguratorSceneManager implem
     enableAdvancedDocking(): void;
     disableAdvancedDocking(): void;
     isEnabledChildObjectMode(planElementViewModel: PlanElementViewModel): boolean;
-    enableChildObjects(planElementViewModel: PlanElementViewModel): KernelObject;
-    disableChildObjects(planElementViewModel: PlanElementViewModel): KernelObject;
+    enableChildObjects(planElementViewModel: PlanElementViewModel): KernelObject | null;
+    disableChildObjects(planElementViewModel: PlanElementViewModel): KernelObject | null;
     dragIn(dragEvent: DragEvent): void;
     getPositionForDragEvent(dragEvent: DragEvent | TouchEvent): Vector3 | null;
     getPlannerSceneEventHandler(): PlannerSceneEventHandler;
@@ -5887,7 +5959,7 @@ export declare class PlannerSceneManager extends ConfiguratorSceneManager implem
     insertRapiObjects(rapiIds: InsertItemIdInfo[]): Promise<InsertItemResult[]>;
     private _saveConfiguration;
     externalObjectRequestAddOnContainers(groupId: string, subArticleId: string): Promise<void>;
-    externalObjectAddSubArticle(subArticleId: string, rootModuleId: string, parentModuleId: string): void;
+    externalObjectAddSubArticle(subArticleId: string, rootModuleId: string, parentModuleId: string, insertPosition?: number[]): void;
     externalObjectRemoveSubModule(groupId: string, subModuleId: string): void;
     getExternalSubArticles(id: number): PosArticle[];
 }
@@ -5921,9 +5993,9 @@ export declare interface PlanObject extends PlanElement_2 {
 }
 
 export declare interface PlanObjectKernel {
-    bounds: KernelVector3;
+    geometryBounds: KernelCube;
     boxForMeasurement: KernelCube;
-    boxOfGeometry: KernelCube;
+    geometryBoundsWithEnvironment: KernelCube;
     id: number;
     rootPlanComponentId: number;
     externalId: string;
@@ -6046,7 +6118,7 @@ export declare class PlanViewModel extends ConfiguratorViewModel implements Plan
     private _handleCeilingPlanElementViewModel;
     private _handleNodePlanElementViewModel;
     private _getCeilingLightsDistribution;
-    handleInitialLights(_maxTextures: number, qualityLevel: QualityLevel): void;
+    handleInitialCeilingLights(ceilingLightsParameters: GenericGUIParamFolder | undefined, qualityLevel: QualityLevel): void;
     handleCeilingLights(): void;
     handleLampLight(lamp: StaticPlanObjectViewModel, options: {
         targetPos: KernelVector3f;
@@ -6055,7 +6127,7 @@ export declare class PlanViewModel extends ConfiguratorViewModel implements Plan
         decay?: number;
         intensity?: number;
         active?: boolean;
-    }): void;
+    }, lampLightsParameters?: ParametersGroup): void;
     handleRectLampLight(lamp: StaticPlanObjectViewModel, options: {
         dimensions: {
             width: number;
@@ -6065,11 +6137,11 @@ export declare class PlanViewModel extends ConfiguratorViewModel implements Plan
         color?: number;
         rotation?: KernelVector3f;
         active?: boolean;
-    }): void;
+    }, rectLightsParameters?: ParametersGroup): void;
     toggleCeilingLights(on: boolean): void;
     private commonHandlerForEditableAndTopView;
     isChildObjectRootComponent(roomleComponent: RoomleComponent): boolean;
-    protected dockComponent(componentId: number, isRootComponent: boolean, parentId: number, componentPosition: KernelVector3, componentRotation: KernelVector3): void;
+    protected dockComponent(componentDocking: KernelComponentDocking): void;
     protected _addComponent(component: RoomleComponent): void;
     private _getPlanObjectViewModelForRuntimeId;
     getConfigurablePlanObjectForId(id: number): ConfiguratorPlanObjectViewModel | null;
@@ -6113,9 +6185,9 @@ export declare class PlanViewModel extends ConfiguratorViewModel implements Plan
     getFloorPlanObjectViewModels(): FloorPlanElementViewModel[];
     getMeasurementLineObjectViewModels(): MeasurementLinePlanElementViewModel[];
     getWallAtticsObjectViewModels(): WallAtticPlanElementViewModel[];
-    protected _generateMesh(runtimeComponentId: number, geometryId: string | null, material: any, vertices: Float32Array, indices: Int32Array, uvCoords: Float32Array, normals: Float32Array, type?: KernelEnum, newGeometryInstance?: boolean, materialAttributes?: Record<string, string>): Mesh;
+    protected _generateMesh(runtimeComponentId: number | undefined, geometryId: string | null | undefined, material: any, vertices: Float32Array, indices: Int32Array, uvCoords: Float32Array, normals: Float32Array, type?: KernelEnum, newGeometryInstance?: boolean, materialAttributes?: Record<string, string>): Mesh;
     protected _setMaterial(mesh: Mesh, material: any, _type?: KernelEnum, materialAttributes?: Record<string, string>): void;
-    Editor3dComponentCreated(id: number, position: KernelVector3, eulerAngles: KernelVector3, isRootComponent: boolean, parentObjectRuntimeId: number): void;
+    Editor3dComponentCreated(componentDocking: KernelComponentDocking): void;
     addPlanObjectToScene(_planViewModel: PlanObjectViewModel | null): void;
     handlerSwitchedPlans(_fromPlan: Plan_2, _toPlan: Plan_2): void;
     planCompletelyLoaded(_plan: Plan_2): void;
@@ -6144,7 +6216,7 @@ export declare class PlanViewModel extends ConfiguratorViewModel implements Plan
     planCleared(): void;
     requestCatalogItem(_catalogItemId: string): void;
     externalObjectRequestAddOnContainers(_groupId: string, _subArticleId: string): void;
-    externalObjectAddSubArticle(_subArticleId: string, _rootModuleId: string, _parentModuleId: string): void;
+    externalObjectAddSubArticle(_subArticleId: string, _rootModuleId: string, _parentModuleId: string, _insertPosition?: number[]): void;
     externalObjectRemoveSubModule(_groupId: string, _subModuleId: string): void;
 }
 
@@ -6215,6 +6287,10 @@ export declare interface PosArticleInfo {
     isConfigDummy?: boolean;
 }
 
+export declare interface PosContextData {
+    dockedRoots?: PosDockedContext[];
+}
+
 export declare interface PosContour {
     level: number;
     segments: PosContourSegment[];
@@ -6243,6 +6319,16 @@ export declare const enum PosDock {
     RightBackBottom = "RightBackBottom"
 }
 
+export declare interface PosDockedContext {
+    ownDockingVector: PosDock | string;
+    dockedRoots: PosDockedContextRoot[];
+}
+
+export declare interface PosDockedContextRoot {
+    id: string;
+    dockingVector: PosDock | string;
+}
+
 export declare interface PosDockInfo {
     id: PosDock;
     start: number[];
@@ -6360,6 +6446,7 @@ export declare interface PosModuleRootData extends PosModuleData, PosPositionInf
     dockInfos: PosDockInfo[];
     insertLevelInfos?: PosInsertLevelInfo[];
     insertLevelFixed?: boolean;
+    contextData?: PosContextData;
 }
 
 export declare interface PosPartData {
@@ -6455,9 +6542,11 @@ export declare interface PreviewComponent extends RoomleComponent {
     stringId: string;
     receivedPointAssociation: boolean;
     dockInsertAnimation?: DragInsertAnimation;
+    clickPosition?: Vector3;
     clonePreview(cloneId: string): PreviewComponent;
     preparePreview(): void;
     startPulsating(): void;
+    updateClickPosition(intersectionPoint: Vector3): void;
 }
 
 export declare interface PreviewLineComponent extends PreviewComponent {
@@ -6725,7 +6814,7 @@ export declare class RapiAccess implements Context {
     updateCache(rapiPath: RAPI_PATHS, data: RapiJson & {
         id: RapiId;
     }): void;
-    getExternalObjects(externalObjectIds: Array<`__ext__obj__#${string}`>): Promise<any[]>;
+    getExternalObjects(externalObjectIds: Array<`__ext__obj__#${string}`>): Promise<ExternalDataResponse<ExternalConfiguration>[] | undefined>;
 }
 
 export declare interface RapiAdditionalContent extends RapiJson {
@@ -7235,7 +7324,7 @@ export declare class RaycastHelper extends EventDispatcher<Record<RAYCAST_EVENT,
     setCamera(camera: Camera): void;
     setObject(object: Object3D): void;
     setMode(mode: INTERSECTION_MODE): void;
-    intersectMouseOnScene(event: Pick<PointerInputEvent, 'positionRelative'>): KernelVector3;
+    intersectMouseOnScene(event: Pick<PointerInputEvent, 'positionRelative'>): KernelVector3 | null;
     enableOnWallSnapping(): void;
     disableOnWallSnapping(): void;
     getCameraPosition(): Vector3;
@@ -7291,7 +7380,7 @@ export declare class RoomDesignerApi implements RoomDesignerRequests {
     deleteRootModule(rootModuleId: string): void;
     getPosDataOfAllGroups(): Promise<PosGroup[]>;
     getRoomInformation(): Promise<ExternalRoomInformation>;
-    saveExternalObjectSnapshot(): Promise<ExternalObjectSnapshotSaveResult>;
+    saveExternalObjectSnapshot(): Promise<ExternalObjectSnapshotSaveResult | null>;
     saveCurrentPlanSnapshot(): Promise<RapiPlanSnapshotGetData>;
     renderPosDataImage(posDataJson: object): Promise<void>;
 }
@@ -7327,6 +7416,8 @@ export declare const ROOMLE_COLORS: {
     readonly DEFAULT_BACKGROUND: 16250871;
     readonly SELECTION: 16777215;
     readonly PREVIEW_DOCKING_COLOR: 266198493;
+    readonly SNAP_DOCKING: 8454016;
+    readonly SNAP_COLLISION: 16744576;
 };
 
 export declare const ROOMLE_HIGHLIGHTNG: {
@@ -7341,6 +7432,7 @@ export declare interface RoomleComponent extends RoomleEventedObject3D {
     runtimeId: number;
     parentObjectId: number;
     isRootComponent: boolean;
+    componentType: KernelComponentType;
     meshes: RoomleEventedMesh[];
     boundingBox: Box3;
     boundingBoxMesh: RoomleEventedMesh | null;
@@ -7369,7 +7461,7 @@ export declare interface RoomleComponent extends RoomleEventedObject3D {
     hoverOff(): void;
     loading(): void;
     loadingFinished(): void;
-    computeBoundingBox(boxForMeasurements?: KernelCube, geometryBounds?: KernelCube[], useMeshes?: boolean): void;
+    computeBoundingBox(boxForMeasurements?: KernelCube, geometryBounds?: KernelAssembledObjectBounds, useMeshes?: boolean): void;
     recursiveMeshes(): Mesh[];
     isChild(componentId: number): boolean;
     getKernelPosition(newParent: RoomleComponent): KernelVector3;
@@ -7377,9 +7469,9 @@ export declare interface RoomleComponent extends RoomleEventedObject3D {
 }
 
 export declare interface RoomleComponentFactory {
-    create(creator: string, id: number, position: KernelVector3, eulerAngles: KernelVector3, parentObjectId: number, isRootComponent: boolean): RoomleComponent;
+    create(creator: string, id: number, position: KernelVector3, eulerAngles: KernelVector3, parentObjectId: number, isRootComponent: boolean, componentType: KernelComponentType): RoomleComponent;
     createStatic(creator: string, id: number, url: string): StaticComponent;
-    createPreview(id: number, parentObjectId: number, creator: string): PreviewComponent;
+    createPreview(id: number, parentObjectId: number, componentType: KernelComponentType, creator: string): PreviewComponent;
     createPreviewLine(id: number, previewComponent: PreviewComponent, creator: string): PreviewLineComponent;
     isPreview(obj: RoomleComponent): boolean;
     isPreviewLine(obj: RoomleComponent): boolean;
@@ -7654,7 +7746,7 @@ export declare class RoomleConfigurator<P extends readonly PluginName[] = readon
      * @param value
      * @param parameter
      */
-    formatValueToUnitString(value: number, parameter: KernelParameter): string | number;
+    formatValueToUnitString(value: number, parameter: KernelParameter): string | number | null;
     /**
      * Get tag for a given tag id
      *
@@ -7999,8 +8091,8 @@ export declare class RoomleConfigurator<P extends readonly PluginName[] = readon
      */
     getChildrenOfPlanComponent(componentRuntimeId: number, onlyPossible?: boolean, onlyVisible?: boolean): Promise<{
         tags: UiPossibleChildTag[];
-        defaultChild: UiPossibleChild;
-    }>;
+        defaultChild: UiPossibleChild | undefined;
+    } | null>;
     /**
      * Returns all possible children and the default child for the plan object
      * @param onlyPossible: boolean true if you only want possibleChildren
@@ -8008,8 +8100,8 @@ export declare class RoomleConfigurator<P extends readonly PluginName[] = readon
      */
     getChildrenOfPlanObject(onlyPossible?: boolean, onlyVisible?: boolean): Promise<{
         tags: UiPossibleChildTag[];
-        defaultChild: UiPossibleChild;
-    }>;
+        defaultChild: UiPossibleChild | undefined;
+    } | null>;
     private _addAdditionalInfoToPossibleChildren;
     private _getPossibleChildrenForKernelPossibleChildren;
     private _addPossibleChildren;
@@ -8210,7 +8302,6 @@ export declare class RoomleMaterialViewer implements GlobalAPI, Context, Externa
     get callbacks(): RoomleMaterialViewerUiCallback;
     set callbacks(callback: RoomleMaterialViewerUiCallback);
     loadMaterialShading(materialShading: RapiMaterialShading): Promise<void>;
-    resetMaterial(): void;
     loadMaterial(material: RapiMaterial, options?: {
         flushCache?: boolean;
     }): Promise<void>;
@@ -8547,11 +8638,11 @@ export declare class RoomlePlanner<P extends readonly PluginName[] = readonly []
     /**
      * enable interaction with child components of configurable objects in the plan
      */
-    enableChildObjects(planElementViewModel: PlanElementViewModel): KernelObject;
+    enableChildObjects(planElementViewModel: PlanElementViewModel): KernelObject | null;
     /**
      * disable interaction with child components of configurable objects in the plan
      */
-    disableChildObjects(planElementViewModel: PlanElementViewModel): KernelObject;
+    disableChildObjects(planElementViewModel: PlanElementViewModel): KernelObject | null;
     /**
      * get the Partlist of certain runtimeID
      * can be used if partlist of a selected Item is needed
@@ -8565,7 +8656,7 @@ export declare class RoomlePlanner<P extends readonly PluginName[] = readonly []
      * @param value
      * @param parameter
      */
-    formatValueToUnitString(value: number, parameter: KernelParameter): string | number;
+    formatValueToUnitString(value: number, parameter: KernelParameter): string | number | null;
     /**
      * Draws walls according to the wall definitions
      * this can be used to create a room on the fly
@@ -8801,24 +8892,24 @@ export declare class RoomlePlanner<P extends readonly PluginName[] = readonly []
     redo(): Promise<void>;
     setHomagIntelligence(homagIntelligence: HomagIntelligence): void;
     private _getSubArticleId;
-    newPosDataFromId(id: string): Promise<PosGroup>;
+    newPosDataFromId(id: string): Promise<PosGroup | undefined> | undefined;
     /**
      * deprecated, use placeOrder() instead
      */
-    sendToOM(withPrice?: boolean): Promise<void>;
+    sendToOM(withPrice?: boolean): Promise<void> | undefined;
     /**
      * Places an order via Homag Intelligence module
      * @param withPrice whether to include price information in the order
      * @param orderHeader optional order header information
      */
-    placeOrder(withPrice?: boolean, orderHeader?: HiOrderHeader): Promise<void>;
+    placeOrder(withPrice?: boolean, orderHeader?: HiOrderHeader): Promise<void> | undefined;
     /**
      * Fetches the price for the current plan via Homag Intelligence module
      * @param planId optional plan ID to fetch the price for
      * @param orderHeader optional order header information
      */
     fetchPrice(planId?: string, orderHeader?: HiOrderHeader): Promise<any>;
-    getOrderManagerGroupData(planId?: string): Promise<HiOrderData>;
+    getOrderManagerGroupData(planId?: string): Promise<HiOrderData | null | undefined>;
     getRapiAccess(): RapiAccess;
     getElementOpenCloseAnimation(planElement: PlanElementViewModel, componentIds?: number[]): AnimationKeyAndValue | null;
     /**
@@ -9036,6 +9127,7 @@ export declare abstract class RoomleRenderer<RendererType extends WebGLRenderer
     abstract getQualityLevel(): QualityLevel;
     abstract setQualityMap(qualityMap: QualityMap): void;
     abstract setCustomShadingParameters(customShadingParameters?: CustomShadingParameters, customShadingParametersMoc?: CustomShadingParameters): void;
+    abstract setCustomOutlineParameters(outlineCustomParameters: OutlineCustomParameters): void;
     abstract loadLutImages(luts: LutImageDefinition[]): void;
     abstract render(scene: Scene, camera: Camera): void;
     abstract showGUI(updateCallback: () => void): void;
@@ -9107,6 +9199,42 @@ export declare class RoomleToolsCore implements Context, ExternalEmbeddable<Room
 export declare interface RoomleToolsCoreUICallback {
 }
 
+export declare class RoomleWebGPURenderer extends RoomleRenderer<WebGPURenderer> {
+    private readonly renderPipeline;
+    private passNeedsReassembly;
+    private debugMode;
+    private readonly renderPasses;
+    private readonly guiParameterGroups;
+    private _domHelper;
+    constructor(creator: string, renderer: WebGPURenderer, outlineColors?: {
+        outlineVisibleEdgeColor: ColorRepresentation;
+        outlineHiddenEdgeColor: ColorRepresentation;
+    });
+    private addRenderPass;
+    clearCache(): void;
+    disableUiInteractionMode(): void;
+    enableUiInteractionMode(): void;
+    getQualityLevel(): QualityLevel;
+    highlightObjects(selectedMeshes: Object3D[]): void;
+    loadLutImages(_luts: LutImageDefinition[]): void;
+    render(scene: Scene, camera: Camera): void;
+    private assembleRenderPasses;
+    setAutoQuality(_autoQuality: boolean): void;
+    setCustomShadingParameters(_customShadingParameters: CustomShadingParameters | undefined, _customShadingParametersMoc: CustomShadingParameters | undefined): void;
+    setCustomOutlineParameters(customOutlineParameters: OutlineCustomParameters): void;
+    setGroundShadow(_enabled: boolean): void;
+    setOnQualityLevelChangeCallback(_callback: (qualityLevel: QualityLevel) => void): void;
+    private enableOutline;
+    private getOutlinePassOrUndefined;
+    setQualityLevel(_qualityLevel: QualityLevel): void;
+    setQualityMap(_qualityMap: QualityMap): void;
+    setShadingType(_shadingType: SceneShadingType): void;
+    showGUI(updateCallback: () => void): void;
+    private addDebugGUI;
+    getOrCreateGUIParameters(name: string): ParametersGroup;
+    private createAndCacheGUIParameters;
+}
+
 export declare interface RoomLightSourceDistribution {
     ceilingId: number;
     floorId: number;
@@ -9236,6 +9364,7 @@ export declare abstract class SceneManager implements Context, LifeCycleCallback
     protected _renderListener: (() => void) | null;
     protected _stopRendering: boolean;
     protected _roomleRenderer: GenericRoomleRenderer | null;
+    private _roomleRendererReady;
     private _forceRender;
     private _lastChange;
     private _running;
@@ -9256,7 +9385,8 @@ export declare abstract class SceneManager implements Context, LifeCycleCallback
     addEventListener(_listener: LifeCycleCallbacks): void;
     removeEventListener(_listener: LifeCycleCallbacks): void;
     get lightCache(): LightCache | null;
-    getRoomleRenderer(): GenericRoomleRenderer;
+    getRoomleRenderer(): GenericRoomleRenderer | null;
+    getRoomleRendererReady(): Promise<GenericRoomleRenderer | null>;
     getRenderer(): WebGLRenderer | WebGPURenderer | null;
     protected _changeCameraBehaviour(cameraBehaviour: CameraBehaviour): void;
     protected onCameraChanged(): void;
@@ -9292,11 +9422,11 @@ export declare abstract class SceneManager implements Context, LifeCycleCallback
     enableHD(source?: DynamicLightSettingSource): void;
     protected _loadGLTF(gltfJSON: string, position?: Vector3, rotation?: number, size?: Vector3, scale?: Vector3, color?: number, callback?: (percent: number) => void): Promise<Object3D>;
     protected _loadGLB(url: string, position?: Vector3, rotation?: number, size?: Vector3, scale?: Vector3, color?: number, colorable?: boolean, callback?: (percent: number) => void): Promise<Object3D>;
-    showGUI(): void;
-    protected _guiLoaded(): void;
-    protected _addGUIListener(gui: GUI): void;
-    protected _guiParamChanged(): void;
-    showStats(): void;
+    showGUI(): Promise<void>;
+    protected initializeWebGLGUI(): void;
+    protected initializeWebGPUGUI(roomleWebGPURenderer: RoomleWebGPURenderer): void;
+    private addEnvironmentMapGUIParameters;
+    showWebGLStats(): void;
     protected _onKeyDown(_event: KeyboardEvent): void;
     protected _onKeyUp(_event: KeyboardEvent, _cleanup?: boolean): void;
     pause(): void;
@@ -9323,6 +9453,7 @@ export declare abstract class SceneManager implements Context, LifeCycleCallback
     exportImageFromCamera(filename: string, shouldWaitForAssets?: boolean): Promise<void>;
     private getCanvasScreenshotWithDimensions;
     changeEnvironmentMapIntensity(intensity: number): void;
+    changeEnvironmentMapRotation(rotation: number): void;
     lockCamera(): void;
     unlockCamera(): void;
     setEnvironmentMap(url?: string, intensity?: number, rotation?: number, maxLightSources?: number): void;
@@ -9330,7 +9461,7 @@ export declare abstract class SceneManager implements Context, LifeCycleCallback
     protected _hasCameraControl2D(): boolean;
     protected _getCameraControl2D(): CameraControl2D;
     protected _getCameraControlFirstPerson(): CameraControlFirstPerson;
-    createUSDZExport(): Promise<Uint8Array<ArrayBuffer>>;
+    createUSDZExport(): Promise<Uint8Array<ArrayBuffer> | undefined>;
     exportUSDZ(): Promise<void>;
     createExportGLB(objectFilter?: (object: Object3D) => boolean): Promise<ArrayBuffer | null>;
     exportGLB(): Promise<void>;
@@ -9424,6 +9555,10 @@ export declare const enum SnapMode {
     WITHIN_SNAP_DISTANCE = 3
 }
 
+export declare interface SnapState {
+    value: Enumify<typeof CORE_SNAP_STATE>;
+}
+
 export declare interface StaticComponent extends RoomleComponent {
     glbUrl: string;
 }
@@ -9436,7 +9571,7 @@ export declare class StaticPlanObjectViewModel extends PlanObjectViewModel {
     constructor(planObject: PlanObject);
     setRapiItem(rapiItem: RapiItem): Promise<void>;
     private _addStaticItem;
-    getRapiItem(): RapiItem;
+    getRapiItem(): RapiItem | null;
     needsRapiItem(): boolean;
     getGLBUrl(): string | null;
     update(): void;
@@ -9592,8 +9727,8 @@ export declare class UnitFormatter implements Context {
     private _initActualUnitStringType;
     formatAngleValueToUnitString(value: number, parameter: KernelParameter): string;
     parseAngleValueFromUnitString(rotation: string): string;
-    parseValue(value: string, parameter: KernelParameter): string | number;
-    formatValueToUnitString(value: number, parameter: KernelParameter): string | number;
+    parseValue(value: string, parameter: KernelParameter): string | number | null;
+    formatValueToUnitString(value: number, parameter: KernelParameter): string | number | null;
     isParseableNumber(aString: string): boolean | null;
     isParseableUnitString(aString: string, parameter: KernelParameter): boolean | null;
     parseMMValueFromUnitString(aString: string, unitType: string): number | null;
@@ -9603,6 +9738,17 @@ export declare class UnitFormatter implements Context {
     formatMMValueToUnitString(aValue: number, unitType?: string): string | null;
     formatMMValueWithReqMaxLength(aValue: number, reqMaxSize: number): string | null;
     private _formatParameterValue;
+    private _getDecimalPlaces;
+    private _snapToNearestStep;
+    /**
+     * Returns the effective snap step (in mm) for a LENGTH parameter in inch mode.
+     *
+     * Prefers validRange.step when it is a positive number. When the kernel omits
+     * an explicit step (step === 0), falls back to precision-derived granularity
+     *
+     * Example: precision=3 → 1/8" → 25.4/8 = 3.175 mm per tick.
+     */
+    private _getInchSnapStep;
     formatPartListParameter(parameter: KernelPartListParameter): void;
     formatParameter(parameter: UiKernelParameter): void;
     isInch(): boolean;
@@ -9829,7 +9975,7 @@ declare global {
   const WebAssembly: any; // eslint-disable-line
   interface Window {
     KernelCallback?: { isReady: () => void } | null;
-    __RML_GUI__: GUI; // eslint-disable-line
+    __RML_WEBGL_GUI__: GUI; // eslint-disable-line
     __RML__DEBUG__?: Debug;
     __RML__ENV__?: ExternalEnv;
     _rsl: { [key: string]: ThreeShader };