@roomle/web-sdk 3.7.0-alpha.3 → 3.7.0

package/lib/roomle-headless.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';
@@ -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 {
@@ -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;
@@ -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;
@@ -1335,7 +1311,7 @@ export declare class ConfiguratorKernelAccess extends CommonKernelAccess {
     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,7 +1364,7 @@ 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;
@@ -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;
@@ -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 {
@@ -2067,11 +2044,11 @@ export declare class ConfiguratorViewModel implements ConfiguratorKernelCallback
     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;
@@ -2654,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;
@@ -2990,11 +2967,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 {
@@ -3006,12 +2991,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 {
@@ -3051,6 +3047,10 @@ export declare interface ExternalObjectRootModule {
     rotationY?: number;
 }
 
+export declare interface ExternalObjectRootModuleContextData {
+    dockedRoots: ExternalObjectDockedContext[];
+}
+
 export declare interface ExternalObjectSegment {
     cmd: string;
     x: number;
@@ -3165,6 +3165,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 {
@@ -3216,6 +3217,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 {
@@ -3392,7 +3407,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>;
@@ -3514,6 +3529,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 {
@@ -3532,6 +3559,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>);
@@ -3707,8 +3735,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;
@@ -3964,6 +3992,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;
@@ -4012,7 +4045,7 @@ export declare interface KernelComponent {
     rotation: KernelVector3;
     globalTransform: KernelMatrix4;
     boxForMeasurement: KernelCube;
-    geometryBounds: KernelCube[];
+    geometryBounds: KernelAssembledObjectBounds;
     parameters: KernelParameter[];
     parameterGroups: KernelParameterGroup[];
     possibleChildren: KernelPossibleChild[];
@@ -4080,6 +4113,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;
@@ -4169,6 +4210,11 @@ export declare interface KernelObject {
     getId(): number;
 }
 
+export declare interface KernelObjectBounds {
+    boundingBox: KernelCube;
+    rectangleBox: KernelExtrudedRectangle;
+}
+
 export declare interface KernelObjectConfiguration {
     runtimeId: number;
     serializedDefinition: string;
@@ -4428,7 +4474,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;
 }
 
@@ -4483,7 +4529,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;
 }
 
@@ -4963,6 +5009,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",
@@ -5479,7 +5530,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;
@@ -5543,7 +5594,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;
 }
 
@@ -5854,6 +5905,7 @@ export declare class PlannerSceneManager extends ConfiguratorSceneManager implem
     protected _updateConfigurationFromHistory(configurationString: string): Promise<void>;
     setMode(mode: Enumify_2<typeof CAMERA_TYPE>): void;
     private _clearHighlighting;
+    updateHighlightingOfPlanElements(): void;
     highlightPlanElementsById(runtimeIds: number[] | null): void;
     highlightPlanElementById(runtimeId: number | null): void;
     destroy(): void;
@@ -5968,7 +6020,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[];
 }
@@ -6002,9 +6054,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;
@@ -6127,7 +6179,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;
@@ -6136,7 +6188,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;
@@ -6146,11 +6198,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;
@@ -6225,7 +6277,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;
 }
 
@@ -6296,6 +6348,10 @@ export declare interface PosArticleInfo {
     isConfigDummy?: boolean;
 }
 
+export declare interface PosContextData {
+    dockedRoots?: PosDockedContext[];
+}
+
 export declare interface PosContour {
     level: number;
     segments: PosContourSegment[];
@@ -6324,6 +6380,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[];
@@ -6441,6 +6507,7 @@ export declare interface PosModuleRootData extends PosModuleData, PosPositionInf
     dockInfos: PosDockInfo[];
     insertLevelInfos?: PosInsertLevelInfo[];
     insertLevelFixed?: boolean;
+    contextData?: PosContextData;
 }
 
 export declare interface PosPartData {
@@ -6536,9 +6603,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 {
@@ -7408,6 +7477,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: {
@@ -7422,6 +7493,7 @@ export declare interface RoomleComponent extends RoomleEventedObject3D {
     runtimeId: number;
     parentObjectId: number;
     isRootComponent: boolean;
+    componentType: KernelComponentType;
     meshes: RoomleEventedMesh[];
     boundingBox: Box3;
     boundingBoxMesh: RoomleEventedMesh | null;
@@ -7450,7 +7522,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;
@@ -7458,9 +7530,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;
@@ -8291,7 +8363,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>;
@@ -9117,6 +9188,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;
@@ -9188,6 +9260,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;
@@ -9317,6 +9425,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;
@@ -9338,6 +9447,7 @@ export declare abstract class SceneManager implements Context, LifeCycleCallback
     removeEventListener(_listener: LifeCycleCallbacks): void;
     get lightCache(): LightCache | null;
     getRoomleRenderer(): GenericRoomleRenderer | null;
+    getRoomleRendererReady(): Promise<GenericRoomleRenderer | null>;
     getRenderer(): WebGLRenderer | WebGPURenderer | null;
     protected _changeCameraBehaviour(cameraBehaviour: CameraBehaviour): void;
     protected onCameraChanged(): void;
@@ -9373,11 +9483,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;
@@ -9404,6 +9514,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;
@@ -9699,6 +9810,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;
@@ -9925,7 +10047,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 };