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

package/lib/roomle-sdk.d.ts

@@ -29,7 +29,6 @@ import { HiOrderHeader } from '../../../../common/src/hi/hi-types';
 import { Intersection } from 'three';
 import { Layers } from 'three';
 import { Light } from 'three';
-import { LightShadow } from 'three';
 import { MagnificationTextureFilter } from 'three';
 import { Material } from 'three';
 import { Matrix3 } from 'three';
@@ -46,7 +45,6 @@ import { Object3DEventMap } from 'three';
 import { OrthographicCamera } from 'three';
 import { Pass } from 'three/examples/jsm/postprocessing/Pass.js';
 import { PerspectiveCamera } from 'three';
-import { Point } from 'roomle-core-hsc/src/embind/configuratorCoreInterface';
 import { PointLight } from 'three';
 import { RectAreaLight } from 'three';
 import { Scene } from 'three';
@@ -383,7 +381,7 @@ export declare interface Base64Image {
     image: Base64String;
     width: number;
     height: number;
-    blob: Blob;
+    blob: Blob | null;
 }
 
 export declare type Base64String = string;
@@ -450,7 +448,7 @@ export declare class CacheHolder {
     private _geometryCache;
     private _materialCache;
     private _lightCache;
-    get lightCache(): LightCache;
+    get lightCache(): LightCache | null;
     get componentCache(): Map<string, RoomleComponent>;
     get geometryCache(): Map<string, BufferGeometry>;
     get materialCache(): Map<string, Material>;
@@ -462,6 +460,18 @@ export declare type CacheKey = any;
 
 export declare type CallbackObjectType = 'static' | 'configuration' | 'wall' | 'measure' | 'attic' | 'door' | 'floor' | 'window' | 'unknown' | 'external-configuration';
 
+export declare const enum CAMERA_EVENT {
+    ORBIT_START = 0,
+    ORBIT_MOVE = 1,
+    ORBIT_END = 2,
+    ZOOM_IN = 3,
+    ZOOM_OUT = 4,
+    ZOOM_CHANGE = 5,
+    KEYBOARD_PRESSED = 6,
+    MOVING = 7,// general event when camera moves
+    IDLE = 8
+}
+
 export declare const CAMERA_TYPE: {
     readonly CAMERA_2D: "2D";
     readonly CAMERA_3D: "3D";
@@ -491,7 +501,7 @@ export declare class CameraBehaviourState implements Context {
     isWithinPlanBounds(position: Vector3, updatedBounds?: Box3): boolean;
 }
 
-export declare abstract class CameraControl extends EventDispatcher<any> implements Context {
+export declare abstract class CameraControl extends EventDispatcher<CameraEventMap> implements Context {
     _creator_: string;
     protected _domHelper: DomHelper;
     protected _initData: InitData;
@@ -501,7 +511,7 @@ export declare abstract class CameraControl extends EventDispatcher<any> impleme
     protected _boundingBox: Box3;
     protected _cameraPosition: Vector3;
     protected _targetPosition: Vector3;
-    protected _tweenEnd: CameraParameter;
+    protected _tweenEnd: CameraParameter | null;
     private _stateSaved;
     private _cameraStandingStill;
     protected _pitch: number;
@@ -509,7 +519,7 @@ export declare abstract class CameraControl extends EventDispatcher<any> impleme
     protected _distance: number;
     protected _locked: boolean;
     private _inputManager;
-    protected _inputListeners: Array<Listener<InputEvent_2>>;
+    protected _inputListeners: InputListenerEntry[];
     protected _lerpEnabled: boolean;
     constructor(creator: string, inputManager: InputManager, initialCameraParameters?: CameraParameter);
     getCamera(): PerspectiveOrOrthographicCamera;
@@ -521,7 +531,7 @@ export declare abstract class CameraControl extends EventDispatcher<any> impleme
     setUp(): void;
     cleanUp(): void;
     animateCamera(delta: number): boolean;
-    protected getDebugCameraPosition(): CameraParameter;
+    protected getDebugCameraPosition(): CameraParameter | null;
     protected saveDebugCameraPosition(): void;
     protected _dispatchCameraIdle(): void;
     protected _tweenCameraParameter(start: CameraParameter, end: CameraParameter, ignoreChecks?: boolean): Promise<void>;
@@ -530,7 +540,7 @@ export declare abstract class CameraControl extends EventDispatcher<any> impleme
     setCurrentCameraParameters(cameraParameters: CameraParameter): void;
     protected _rotateHorizontal(angle: number): void;
     protected _rotateVertical(angle: number): void;
-    saveState(override: boolean): CameraParameter;
+    saveState(override: boolean): CameraParameter | null;
     resetToState(): void;
     setToState(start: CameraParameter, state: CameraParameter): Promise<void>;
     hasSavedState(): boolean;
@@ -681,6 +691,18 @@ export declare class CameraControlFirstPerson extends CameraControl {
     getKernelZoomFactor(): number;
 }
 
+export declare interface CameraEventMap {
+    [CAMERA_EVENT.ORBIT_START]: INPUT_EVENT_TYPE | void;
+    [CAMERA_EVENT.ORBIT_MOVE]: INPUT_EVENT_TYPE | void;
+    [CAMERA_EVENT.ORBIT_END]: INPUT_EVENT_TYPE | void;
+    [CAMERA_EVENT.ZOOM_IN]: void;
+    [CAMERA_EVENT.ZOOM_OUT]: void;
+    [CAMERA_EVENT.ZOOM_CHANGE]: ZoomChangeEvent;
+    [CAMERA_EVENT.KEYBOARD_PRESSED]: void;
+    [CAMERA_EVENT.MOVING]: INPUT_EVENT_TYPE;
+    [CAMERA_EVENT.IDLE]: INPUT_EVENT_TYPE;
+}
+
 export declare interface CameraParameter {
     /**
      * Yaw of the camera in radians
@@ -815,10 +837,6 @@ export declare interface CheckResult {
     calcResult: CheckDropDownEntry[];
 }
 
-export declare interface ChildEntityMode {
-    value: Enumify<typeof CORE_CHILD_ENTITY_MODE>;
-}
-
 export declare interface CleanupOptions {
     resetCoreCache?: boolean;
     resetMeshCache?: boolean;
@@ -1022,6 +1040,11 @@ export declare interface CommonInitData {
      */
     restrictionLevel?: number;
     /* Excluded from this release type: hi */
+    /**
+     * @description disable injection of default styles for measurements and component dimension labels
+     * to enable easier customization of these styles (via the assigned classes)
+     */
+    disableDefaultLabelStyles?: boolean;
 }
 
 export declare abstract class CommonKernelAccess implements LifeCycleCallbacks, Context {
@@ -1246,16 +1269,16 @@ export declare class ConfiguratorContext {
     configurationRuntimeId: number;
     planElementId: number;
     rootComponentId: number;
-    dockingRootComponentId: number;
-    baseContext: BASE_CONTEXT;
+    dockingRootComponentId: number | null;
+    baseContext: BASE_CONTEXT | null;
     lastPossibleChild: UiPossibleChild;
     rootComponentParametersAsGlobal: boolean;
     requestPreviewsIsUserInitiated: boolean;
-    lastLoadedRapiId: RapiId;
-    lastLoadedPlanId: RapiId;
+    lastLoadedRapiId: RapiId | null;
+    lastLoadedPlanId: RapiId | null;
     selectedRuntimeComponentIds: number[];
     selectionMode: SELECTION_MODE;
-    get selectedRuntimeComponentId(): number;
+    get selectedRuntimeComponentId(): number | null;
 }
 
 export declare interface ConfiguratorDebugAPI {
@@ -1445,7 +1468,7 @@ export declare class ConfiguratorKernelAccess extends CommonKernelAccess {
     changeCommonComponentParameter(componentIds: number[], parameterKey: string, type: string, value: string, resolve: () => void, reject: () => void): void;
     changeComponentParameter(componentId: number, parameterKey: string, type: string, value: string, resolve: () => void, reject: () => void): void;
     changePlanObjectParameter(runtimeId: number, parameterKey: string, type: string, value: string, resolve: () => void, reject: () => void): void;
-    protected _getAnimationLevelForObject(_runtimeId: number, animation: KernelAnimation): AnimationLevelType;
+    protected _getAnimationLevelForObject(_runtimeId: number, animation: KernelAnimation | undefined): AnimationLevelType;
     updateAnimationParameters(elementId: number | number[], parameters: KernelParameter[]): void;
     changeAnimationValue(elementId: number, parameterKey: string, value: string, level: number, animationLevel: AnimationLevelType, animate: boolean): void;
     private _finishParameterChange;
@@ -1745,8 +1768,7 @@ export declare class ConfiguratorSceneManager extends SceneManager implements Co
     constructor(creator: string, offset: CanvasOffset, mode: Enumify_3<typeof CAMERA_TYPE>);
     /**
      * Single point for deciding whether to push HTML label positions to the UI.
-     * In ThreeJS mode this is a no-op — labels render in-scene.
-     * In HTML mode the scene manager must push screen positions after any change.
+     * the scene manager must push screen positions after any change.
      */
     private _notifyDimensionLabels;
     private _initOptionalModules;
@@ -1776,7 +1798,6 @@ export declare class ConfiguratorSceneManager extends SceneManager implements Co
     display(component: RoomleComponent): void;
     protected setRootComponentId(rootComponentId: number): void;
     debugSceneGraph(id?: number): void;
-    debugScene(): Scene<Object3DEventMap>;
     private _printObjectGraph;
     clearScene(): void;
     planObjectConstructionDone(_planObject: PlanObjectKernel): void;
@@ -1825,10 +1846,6 @@ export declare class ConfiguratorSceneManager extends SceneManager implements Co
     private _initDimensions;
     hideDimensions(): void;
     private _updateComponentDimensionLabels;
-    /**
-     * Resolve label collisions by hiding lower priority overlapping labels
-     */
-    private _resolveCollisions;
     loadSceneSettings(sceneSetting: SceneSettings): Promise<void>;
     protected onCameraChanged(): void;
     requestDockingsPreview(userInitiated: boolean, possibleChild?: UiPossibleChild, dragEvent?: DragEvent, dragIn?: boolean): void;
@@ -1879,6 +1896,7 @@ export declare class ConfiguratorSceneManager extends SceneManager implements Co
     animateElement(elementId: number, parameterName: string, value: string, animationLevel: AnimationLevelType, animate: boolean): void;
     undo(): Promise<void>;
     redo(): Promise<void>;
+    private reloadConfiguration;
     protected _updateConfigurationFromHistory(configurationString: string): void;
     clearHistory(): void;
     private _callOnPartListUpdate;
@@ -2040,7 +2058,7 @@ export declare class ConfiguratorUiCallbacks extends UiCallback implements Confi
      * @param parentDockId the number of the dock position to which is docked
      * @param position vector where the dock is done can be null
      */
-    onUserInitiatedDockDone: (childDbId: RapiId, childDockId: number, parentDbId: RapiId, parentDockId: number, position: KernelVector3) => void;
+    onUserInitiatedDockDone: (childDbId: RapiId, childDockId: number, parentDbId: RapiId, parentDockId: number, position: KernelVector3 | null) => void;
     /**
      * When user hovers over an addon plus symbol
      */
@@ -2109,6 +2127,10 @@ export declare class ConfiguratorUiCallbacks extends UiCallback implements Confi
      * @param rootComponentLabel
      */
     onConfigurationLabelChange: (catalogName: string, rapiItemLabel: string, rootComponentLabel: string) => void;
+    /**
+     * @deprecated Labels are now handled by the SDK directly and therefore this will never be called.
+     * Will be removed at some point in the future
+     */
     onDimensionLabelsUpdated: (labels: DimensionLabelsTransferable | null) => void;
     /**
      * When kernel failed to load a mesh
@@ -2247,10 +2269,10 @@ export declare class ConfiguratorViewModel implements ConfiguratorKernelCallback
     planObjectUpdated(planObject: PlanObjectKernel, pendingDocking: boolean): void;
     sceneCleared(): void;
     setListener(listener: ConfiguratorViewModelCallbackI): void;
-    getBoundingBox(excludeEnvironment?: boolean): Box3;
+    getBoundingBox(excludeEnvironment?: boolean): Box3 | null;
     private getBoundingBoxOfComponent;
-    getBoundingBoxOfGeometry(): Box3;
-    getBoundingBoxWithPreviews(): Box3;
+    getBoundingBoxOfGeometry(): Box3 | null;
+    getBoundingBoxWithPreviews(): Box3 | null;
     hasPreviews(): boolean;
     clearRootComponent(): void;
     debugSceneGraph(id?: number): void;
@@ -2263,7 +2285,7 @@ export declare class ConfiguratorViewModel implements ConfiguratorKernelCallback
     setGeometriesMergedListener(fun: () => void): void;
     removeGeometriesMergedListener(): void;
     setMergeThreshold(threshold: number): void;
-    protected _generateMesh(runtimeComponentId: number, geometryId: string, materialId: string, vertices: Float32Array, indices: Int32Array, uvCoords: Float32Array, normals: Float32Array, _type?: KernelEnum, _newGeometryInstance?: boolean, materialAttributes?: Record<string, string>): Mesh;
+    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 _setMaterial(mesh: Mesh, material: any, _type?: KernelEnum): void;
     constructComponents(planObjectId: number): void;
     requestSubPartConstruction(partId: number): Promise<Mesh>;
@@ -2395,12 +2417,6 @@ export declare const CORE_ASSET_TYPE: {
     readonly EXTERNAL_SVG_URL: 6;
 };
 
-export declare const CORE_CHILD_ENTITY_MODE: {
-    readonly OFF: 0;
-    readonly GROUND_COMPONENTS: 1;
-    readonly ALL_COMPONENTS: 2;
-};
-
 export declare const CORE_DOCK_PAIR_TYPE: {
     readonly POINT: 0;
     readonly LINE: 1;
@@ -2437,6 +2453,25 @@ export declare const createExtObj: (data: Record<string, unknown>) => Record<str
 
 export { createExtObjId }
 
+export declare class CSS2DRendererManager implements Context {
+    _creator_: string;
+    private domHelper;
+    private initData;
+    private componentDimensioningHelper;
+    private css2DRenderer?;
+    private dimensioningHelper?;
+    constructor(_creator: string);
+    initializeRenderer(width: number, height: number): void;
+    setSize(width: number, height: number): void;
+    setDimensioningHelper(dimensioningHelper: DimensioningHelper): void;
+    renderSnapshotToCanvasWithAspectRatio(scene: Scene, camera: Camera, aspectRatio: number): Promise<HTMLCanvasElement>;
+    private getCanvasDimensionsForAspectRatio;
+    renderSnapshotToCanvas(scene: Scene, camera: Camera): Promise<HTMLCanvasElement>;
+    render(scene: Scene, camera: Camera): void;
+    private logNotInitializedWarning;
+    private injectStyles;
+}
+
 export declare interface CustomShadingParameters {
     aoIntensity?: number;
     aoExtent?: number;
@@ -2466,7 +2501,7 @@ export declare class DataSyncer implements Context, CommunicationInterfaceCallba
     syncFloorTag(tagId: RapiId): Promise<any>;
     syncTypeChangeTag(tagId: RapiId): Promise<any>;
     private _syncFloorTag;
-    _syncTypeChangeTag(tagId: RapiId): Promise<any>;
+    _syncTypeChangeTag(tagId: RapiId | undefined): Promise<any>;
     getIsCatalogSynced(catalogId: RapiId): boolean;
     private _startWorker;
     onCommand(command: WORKER_MESSAGE, conversationId: number, data: any): void;
@@ -2480,7 +2515,7 @@ export declare class DataSyncer implements Context, CommunicationInterfaceCallba
     private _preCacheAsset;
     private _assetUrlToBase64;
     private _softReject;
-    requestAsset(url: string, urlAsFallback?: boolean): AssetUrl;
+    requestAsset(url: string, urlAsFallback?: boolean): AssetUrl | null;
     setAlwaysUseCache(alwaysUseCache: boolean): void;
     preFillAssetCache(key: string, url: string): void;
 }
@@ -2579,6 +2614,55 @@ export declare interface DimensioningAxis {
     alternativeOrigin?: KernelVector3;
 }
 
+export declare class DimensioningHelper {
+    _creator_: string;
+    private _unitFormatter;
+    private _object;
+    private _cameraPosition;
+    private _onVisibilityChange;
+    private _initialized;
+    private _origin;
+    private _dimensions;
+    private _lineMaterial;
+    private readonly _mainLineMaterial;
+    private readonly _widthLineGroup;
+    private readonly _heightLineGroup;
+    private readonly _depthLineGroup;
+    private _enabled;
+    private _dimensionsVisible;
+    private _dimensionLineGroup;
+    constructor(creator: string);
+    private _createLineGroup;
+    private _createLineFromConfig;
+    private addLinesToLineGroup;
+    private clearLineGroup;
+    private addLabelToLineGroup;
+    private _getWidthLineConfig;
+    private _getDepthLineConfig;
+    private _getHeightLineConfig;
+    private _getLocalCameraPosition;
+    private _getCameraDistanceInfo;
+    private _visibilityChangedCallback;
+    update(force?: boolean): void;
+    updateSize(boxForMeasurement: KernelCube): void;
+    removeFromObject(object: Object3D): void;
+    onDimensionsVisibilityChanged(handler: (visible: boolean) => void): void;
+    setObject(object: Object3D): void;
+    isInitialized(): Promise<void>;
+    areDimensionsEnabled(): boolean;
+    clearScene(_scene: Scene): void;
+    addToObject(object: Object3D): void;
+    enableDimensions(): void;
+    disableDimensions(): void;
+    enableTopDimensions(): void;
+    disableTopDimensions(): void;
+    getBoundingBox(): Box3;
+    moveCameraStart(position: Vector3): void;
+    moveCameraEnd(position: Vector3): void;
+    private _performUpdate;
+    private _clear;
+}
+
 export declare interface DimensionLabel {
     id: string;
     value: number;
@@ -2625,7 +2709,7 @@ export declare class DomHelper implements LifeCycleCallbacks, Context {
     private _lifeCycleManager;
     private _element;
     private _container;
-    get element(): HTMLElement;
+    get element(): HTMLElement | null;
     constructor(creator: string);
     setDomElement(element: HTMLElement): void;
     getClientDimensions(): Vector2;
@@ -2774,7 +2858,7 @@ export declare class EmsSet<T> {
 }
 
 export declare abstract class Environment {
-    protected _scene: Scene;
+    protected _scene: Scene | null;
     protected _bounds: Vector3;
     constructor(scene: Scene, oldEnvironment?: Environment);
     abstract needsBounds(): boolean;
@@ -2894,14 +2978,14 @@ export declare const enum ERROR_CODES {
     CONTENT_PROBLEM = 2
 }
 
-export declare class EventDispatcher<T> {
+export declare class EventDispatcher<TMap extends object> {
     private _listeners;
     private _disabled;
     private _addEventListener;
-    hasEventListener(eventName: number, callback: ListenerFunction<T>, scope: any): boolean;
-    addEventListener(eventName: number, callback: ListenerFunction<T>, scope: any): void;
-    dispatchEvent(eventName: number, arg?: T): void;
-    removeEventListener(eventName: number, fun: ListenerFunction<T>): void;
+    hasEventListener<K extends keyof TMap>(eventName: K, callback: ListenerFunction<TMap[K]>, scope: any): boolean;
+    addEventListener<K extends keyof TMap>(eventName: K, callback: ListenerFunction<TMap[K]>, scope: any): void;
+    dispatchEvent<K extends keyof TMap>(eventName: K, arg?: TMap[K]): void;
+    removeEventListener<K extends keyof TMap>(eventName: K, fun: ListenerFunction<TMap[K]>): void;
     enableEvents(): void;
     disableEvents(): void;
 }
@@ -3288,7 +3372,6 @@ 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: useHTMLMeasurementLabels */
 }
 
 export declare interface FetchOptions {
@@ -3414,7 +3497,7 @@ export declare interface GeometryHelpLine {
 export declare class GeometryHelpLineArray extends EmsArray<GeometryHelpLine> {
 }
 
-export declare const getCatalogIdFromConfigurationHash: (id: RapiId) => RapiId;
+export declare const getCatalogIdFromConfigurationHash: (id: RapiId) => RapiId | null;
 
 export declare class GlbViewer extends Main {
     private _viewer;
@@ -3490,14 +3573,14 @@ export declare class GlobalCallback extends UiCallback {
      * is called the scene is ready for rendering it as an image
      */
     onReadyForRender: () => void;
-    onFetchExternalData: <T extends keyof ExternalObjectOnFetchDataMap, K extends string | string[]>(_type: T, _ids: K) => Promise<K extends string ? ExternalObjectOnFetchDataMap[T] : K extends string[] ? Array<ExternalObjectOnFetchDataMap[T]> : never | undefined>;
+    onFetchExternalData: <T extends keyof ExternalObjectOnFetchDataMap, K extends string | string[]>(_type: T, _ids: K) => Promise<(K extends string ? ExternalObjectOnFetchDataMap[T] : K extends string[] ? Array<ExternalObjectOnFetchDataMap[T]> : never) | undefined>;
 }
 
 export declare class GlobalInitData implements Context, GlobalInitDataDefinition {
     _creator_: string;
     locale?: string;
     overrideTenant?: number;
-    overrideCountry?: string;
+    overrideCountry?: string | null;
     configuratorId?: string;
     overrideRapi?: RapiServerUrlType;
     alwaysUseCache?: boolean;
@@ -3521,7 +3604,7 @@ export declare interface GlobalInitDataDefinition {
     /**
      * @description Set country to use for the Roomle price service. If not used the customer IP address will be used to determine the location. usage: overrideCountry=de
      */
-    overrideCountry?: string;
+    overrideCountry?: string | null;
     /* Excluded from this release type: overrideRapi */
     /**
      * @description The id which should be used for this embedding instance. When this id is set all InitData parameter can be set and changed in Rubens Admin. This is the way we recommend to set init data params. Ask your Roomle contact for your configuratorId.
@@ -3554,7 +3637,7 @@ export declare interface GlueLogic {
     addLibrary(libraryData: LibraryData): Promise<void>;
     setPosDataForLoading(posData: PosSaveData | null): Promise<void>;
     loadPosData(articleCatalogJson: any, libraryId: string): void;
-    mergeGroups(targetGroup: ExternalObjectGroup, idsOfGroupsMerged: string | string[], idOfTargetRootModule: string): Promise<void>;
+    mergeGroups(targetGroup: ExternalObjectGroup, idsOfGroupsMerged: string | string[], idOfTargetRootModule: string, mergedWithDragging: boolean): Promise<void>;
     deleteRootModule(remainingGroup: ExternalObjectGroup, rootModuleIdToDelete: string, splitOffGroups: ExternalObjectGroup[]): Promise<void>;
     splitRootModuleFromGroup(splitGroup: ExternalObjectGroup, newGroupedRootModules: ExternalObjectGroup[]): Promise<void>;
     duplicateGroup(duplicatedGroup: ExternalObjectGroup): Promise<void>;
@@ -3678,11 +3761,13 @@ export declare const HI_LOAD_OBJECT_REASON: {
     readonly DUPLICATE: "duplicate";
     readonly INSERT_NEW: "insert_new";
     readonly LOAD: "load";
-    readonly MERGE: "merge";
+    readonly MERGE_WITH_DRAGGING: "merge_with_dragging";
+    readonly MERGE_WITH_ON_ACTION: "merge_with_on_action";
     readonly PLAN_CHANGED: "plan_changed";
     readonly POSITION_CHANGED: "position_changed";
     readonly SPLIT: "split";
     readonly SWAP_MODULE: "swap_module";
+    readonly SWAP_GROUP: "swap_group";
     readonly UNDO_REDO: "undo_redo";
 };
 
@@ -3834,18 +3919,25 @@ export declare class ImageRenderer {
     private _roomleRenderer;
     private _imageRenderer;
     private _thumbnailCamera;
-    protected _globalInitData: GlobalInitData;
+    private _globalInitData;
+    private _css2DRendererManager;
     private _getRenderer;
     switchToPlannerSettings(): void;
     switchToConfiguratorSettings(): void;
     updateBounds(bounds: Box3): void;
     static getCameraTargetForBBox(bbox: Box3, spacing?: number): CameraTarget;
-    preparePerspectiveImage(scene: Scene, uiScene: Scene, camera: PerspectiveCamera, cameraTarget: CameraTarget, options?: PrepareImageOptions, onBeforeRender?: (camera: Camera) => void): Promise<Base64Image>;
-    renderPerspectiveImage(scene: Scene, camera: PerspectiveCamera, cameraTarget: CameraTarget, size?: number): Promise<Base64Image>;
+    preparePerspectiveImage(scene: Scene, camera: PerspectiveCamera, cameraTarget?: CameraTarget, options?: PrepareImageOptions, onBeforeRender?: (camera: Camera) => void): Promise<Base64Image>;
     static placeCameraForPerspectiveImage(camera: PerspectiveCamera, cameraTarget: CameraTarget, angleX: number, angleY: number): void;
-    prepareTopImage(scene: Scene, uiScene: Scene, cameraTarget: CameraTarget, options?: PrepareImageOptions): Promise<Base64Image>;
+    prepareTopImage(scene: Scene, cameraTarget: CameraTarget, options?: PrepareImageOptions): Promise<Base64Image>;
+    /**
+     * Renders a frame with scene.background/fog temporarily nulled.
+     * All scene mutations and restoration happen synchronously — no await
+     * boundaries — so the main render loop never sees the modified state.
+     */
+    private _renderImageFrameWithCleanScene;
+    private _compositeWithDimensions;
     prepareThumbnailImage(scene: Scene, viewModel: PlanViewModel, cameraBehaviour: CameraBehaviour, perspectiveOffsetCamera: PerspectiveCamera, options: PrepareImageOptionsPlanner, onAfterRender: () => void): Promise<Base64Image>;
-    private _render;
+    private _renderImageFrame;
 }
 
 export declare class InitData implements Context, Omit<InitDataDefinition, 'colors'> {
@@ -3888,6 +3980,7 @@ export declare class InitData implements Context, Omit<InitDataDefinition, 'colo
     customShadingMoc?: CustomShadingParameters;
     restrictionLevel?: number;
     hi?: HomagIntelligenceInitData;
+    disableDefaultLabelStyles?: boolean;
     offlineSync?: string;
     highlighting?: Enumify_3<typeof ROOMLE_HIGHLIGHTNG>;
     initialFloorMaterial?: string;
@@ -3932,6 +4025,27 @@ export declare class InitData implements Context, Omit<InitDataDefinition, 'colo
 export declare interface InitDataDefinition extends CommonInitData, ConfiguratorInitData, PlannerInitData {
 }
 
+export declare const enum INPUT_EVENT {
+    DRAG_START = 0,
+    DRAG = 1,
+    DRAG_END = 2,
+    DOWN = 3,
+    UP = 4,
+    CLICK = 5,
+    MOVE = 6,
+    ZOOM_IN = 7,
+    ZOOM_OUT = 8,
+    ROTATE = 9,
+    ROTATE_END = 10,
+    PAN = 11,
+    DOUBLE_CLICK = 12,
+    TOUCH_END = 13,
+    LONG_TOUCH = 14,
+    MOUSE_LEAVE = 15,
+    KEY_DOWN = 16,
+    KEY_UP = 17
+}
+
 export declare const enum INPUT_EVENT_TYPE {
     UNKNOWN = 0,
     MOUSE = 1,
@@ -3940,21 +4054,40 @@ export declare const enum INPUT_EVENT_TYPE {
     KEYBOARD = 4
 }
 
-export declare class InputEvent_2 {
-    position: Position2;
-    positionRelative: Position2;
-    type: INPUT_EVENT_TYPE;
-    rotation: number;
-    event: Event;
-    constructor(position?: Position2, positionRelative?: Position2, type?: INPUT_EVENT_TYPE, rotation?: number, event?: Event);
-}
-
 export declare interface InputEventAttatchment {
     intersection: RoomleEventedIntersection;
     type: INPUT_EVENT_TYPE;
 }
 
-export declare class InputManager extends EventDispatcher<InputEvent_2> implements Context, EventListenerObject {
+export declare interface InputEventMap {
+    [INPUT_EVENT.DRAG_START]: PointerInputEvent;
+    [INPUT_EVENT.DRAG]: PointerInputEvent;
+    [INPUT_EVENT.DRAG_END]: PointerInputEvent;
+    [INPUT_EVENT.DOWN]: PointerInputEvent;
+    [INPUT_EVENT.UP]: PointerInputEvent;
+    [INPUT_EVENT.CLICK]: PointerInputEvent;
+    [INPUT_EVENT.MOVE]: PointerInputEvent;
+    [INPUT_EVENT.ZOOM_IN]: PointerInputEvent;
+    [INPUT_EVENT.ZOOM_OUT]: PointerInputEvent;
+    [INPUT_EVENT.ROTATE]: PointerInputEvent;
+    [INPUT_EVENT.ROTATE_END]: PointerInputEvent;
+    [INPUT_EVENT.PAN]: PointerInputEvent;
+    [INPUT_EVENT.DOUBLE_CLICK]: PointerInputEvent;
+    [INPUT_EVENT.TOUCH_END]: PointerInputEvent;
+    [INPUT_EVENT.LONG_TOUCH]: PointerInputEvent;
+    [INPUT_EVENT.MOUSE_LEAVE]: PointerInputEvent;
+    [INPUT_EVENT.KEY_DOWN]: KeyboardInputEvent;
+    [INPUT_EVENT.KEY_UP]: KeyboardInputEvent;
+}
+
+export declare type InputListenerEntry = {
+    [K in keyof InputEventMap]: {
+        key: K;
+        fun: (event: InputEventMap[K]) => void;
+    };
+}[keyof InputEventMap];
+
+export declare class InputManager extends EventDispatcher<InputEventMap> implements Context, EventListenerObject {
     _creator_: string;
     private _domHelper;
     private _downPosition;
@@ -4313,7 +4446,7 @@ export declare interface KernelParameter {
     sort: number;
     unitType: PARAMETER_UNIT_TYPES;
     validGroups: [RapiId];
-    validRange: KernelRange;
+    validRange: KernelRange | null;
     validValues: KernelValue[];
     group: string;
     visibleInPlanner?: boolean;
@@ -4345,12 +4478,12 @@ export declare interface KernelPart {
     componentId: string;
     isModule: boolean;
     count: number;
-    currencySymbol: string;
+    currencySymbol: string | null;
     permissionToDelete: KernelPermissionToDelete;
     permissionToDeleteInIsolation: KernelPermissionToDelete;
     label: string;
     parameters: KernelPartListParameter[];
-    price: number;
+    price: number | null;
     retailerPrice: number;
     [key: string]: any;
 }
@@ -4404,15 +4537,13 @@ export declare interface KernelPlanObjectBase {
     configuration: string;
     configurationRuntimeId: number;
     componentRuntimeId: number;
-    isChildObject: boolean;
+    childObjectLevel: number;
     isAGeneratedModule: boolean;
 }
 
 export declare interface KernelPlanObjectComponent extends KernelPlanObjectBase {
     isExternalObject: boolean;
     type: KernelComponentType;
-    isChildObject: boolean;
-    objectMode: ChildEntityMode;
     componentId: string;
     parentObjectId: number;
     childObjectIds: EmsArray<number>;
@@ -4456,7 +4587,7 @@ export declare interface KernelUtilityForUi {
 export declare interface KernelValue {
     value: string;
     label: string;
-    thumbnail: string;
+    thumbnail: string | null;
 }
 
 export declare interface KernelVariable {
@@ -4487,7 +4618,7 @@ export declare interface KernelVector3f {
 }
 
 export declare class KernelViewModel {
-    protected _coreReference: KernelObject;
+    protected _coreReference: KernelObject | null;
     constructor(reference: KernelObject);
     clearReference(): void;
     getKernelObject(): KernelObject;
@@ -4520,6 +4651,11 @@ export declare interface KernelWallMaterial extends KernelObject {
     useCustomColor: boolean;
 }
 
+export declare interface KeyboardInputEvent {
+    type: INPUT_EVENT_TYPE;
+    event: KeyboardEvent;
+}
+
 export declare interface LeftOrRightWallSide {
     value: Enumify<Pick<typeof WALL_SIDES, 'LEFT' | 'RIGHT'>>;
 }
@@ -4560,7 +4696,7 @@ export declare class LightCache {
     allowedToSpawnMoreLights(): boolean;
     addActiveLight(light: Light): void;
     cacheLight(light: Light): void;
-    getLightFromCache(type: KernelLightSourceType): Light<LightShadow<Camera>>;
+    getLightFromCache(type: KernelLightSourceType): Light;
     clear(): void;
     private _setMaximumLights;
 }
@@ -4620,11 +4756,6 @@ export declare interface LinksCollection {
     [key: string]: string;
 }
 
-export declare interface Listener<T> {
-    key: number;
-    fun: ListenerFunction<T>;
-}
-
 export declare type ListenerFunction<T> = (arg: T) => void;
 
 export declare interface LoadExternalObjectGroupResult {
@@ -4926,15 +5057,15 @@ export declare class MeshGenerator implements Context {
     protected _singlePromiseFactory: SinglePromiseFactory;
     protected _cacheHolder: CacheHolder;
     private _plannerMeshGenerator;
-    protected _materialLoaded: (material: Material) => void;
+    protected _materialLoaded: ((material: Material) => void) | undefined;
     protected _maxAnisotropy: number;
     protected _maxTextures: number;
     protected _textureLoader: TextureLoader;
     protected _previewMaterial: MeshStandardMaterial;
     protected _configuratorPreviewMaterial: MeshStandardMaterial;
     constructor(creator: string);
-    getGeometry(meshId: string): BufferGeometry;
-    protected _generateGeometry(meshId: string, vertices: Float32Array, indices: Int32Array, uvCoords: Float32Array, normals: Float32Array): BufferGeometry;
+    getGeometry(meshId: string): BufferGeometry | null;
+    protected _generateGeometry(meshId: string | null, vertices: Float32Array, indices: Int32Array, uvCoords: Float32Array, normals: Float32Array): BufferGeometry;
     changeMaterialOfMesh(mesh: Mesh, material: Material, materialAttributes?: Record<string, string>): void;
     private _updateMaterialProperties;
     private _updateStandardMaterialProperties;
@@ -4953,7 +5084,7 @@ export declare class MeshGenerator implements Context {
     protected _assignItem(mesh: Mesh, catalogItemId: string): Promise<void>;
     setMaterialLoadedListener(fun: () => void): void;
     removeMaterialLoadedListener(): void;
-    protected _createMesh(runtimeComponentId: number, geometryId: string, geometry: BufferGeometry): Mesh<BufferGeometry<NormalBufferAttributes, BufferGeometryEventMap>, Material, Object3DEventMap>;
+    protected _createMesh(runtimeComponentId: number, geometryId: string | null, geometry: BufferGeometry): Mesh<BufferGeometry<NormalBufferAttributes, BufferGeometryEventMap>, Material, Object3DEventMap>;
     protected _getComponentMeshId(runtimeComponentId: number, geometryId: string): string;
 }
 
@@ -5352,6 +5483,7 @@ export declare interface PlanElement_2 extends KernelObject {
     getMeshCenter(): KernelVector3;
     getMeshOffsetRelativeToObject(): KernelVector3;
     getId(): number;
+    getCustomDataJson(): string;
     readonly hidden: boolean;
 }
 
@@ -5387,7 +5519,7 @@ export declare class PlanElementViewModel extends KernelViewModel {
     getObject(): RoomleEventedObject3D;
     getObjectAsync(): Promise<Object3D<Object3DEventMap>>;
     addMesh(mesh: Object3D): void;
-    getMesh(material: any): Mesh;
+    getMesh(material: any): Mesh | null;
     getContainer(): Object3D;
     getId(): number;
     clear(): void;
@@ -5499,6 +5631,7 @@ export declare interface PlanInteractionHandler {
     setDefaultInteriorWallMaterial(wallMaterial: KernelWallMaterial): void;
     getDefaultFloorMaterial(): KernelFloorMaterial;
     setDefaultFloorMaterial(floorMaterial: KernelFloorMaterial): void;
+    setElementCustomDataJson(element: PlanElement_2, customDataJson: string): void;
     setWallLeftMaterial(wall: KernelWall, material: KernelWallMaterial): void;
     setWallRightMaterial(wall: KernelWall, material: KernelWallMaterial): void;
     setFloorMaterial(floor: KernelFloor, material: KernelFloorMaterial): void;
@@ -5510,6 +5643,7 @@ export declare interface PlanInteractionHandler {
     setObjectFlipX(anObject: KernelObject, shouldFlipX: boolean): void;
     setObjectFlipY(anObject: KernelObject, shouldFlipY: boolean): void;
     setObjectCustomColor(object: PlanObject, rgbColor: number, useCustomColor: boolean): void;
+    setObjectCustomLabel(object: PlanObject, label: string): void;
     setObjectFixedZ(anObject: KernelObject, shouldFlipZ: boolean): void;
     setMeasurePoint1(measure: PlanMeasure_2, point: KernelVector3f, snapToWalls: boolean, snapToObjects: boolean): void;
     setMeasurePoint2(measure: PlanMeasure_2, point: KernelVector3f, snapToWalls: boolean, snapToObjects: boolean): void;
@@ -5661,7 +5795,7 @@ export declare class PlannerKernelAccess extends ConfiguratorKernelAccess {
     externalObjectConfigurationDuplicated(plan: Plan_2, planObject: PlanObject, duplicatedGroup: ExternalObjectGroup): void;
     externalObjectPositionChanged(plan: Plan_2, planObject: PlanObject, movedGroup: ExternalObjectGroup): void;
     externalObjectPlanChanged(plan: Plan_2, planObject: PlanObject, movedGroup: ExternalObjectGroup): void;
-    externalObjectConfigurationsMerged(plan: Plan_2, planObject: PlanObject, mergedGroup: ExternalObjectGroup, idsOfGroupsMerged: string | string[], targetRootModuleId: string): void;
+    externalObjectConfigurationsMerged(plan: Plan_2, planObject: PlanObject, mergedGroup: ExternalObjectGroup, idsOfGroupsMerged: string | string[], targetRootModuleId: string, mergedWithDragging: boolean): void;
     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;
@@ -5692,7 +5826,7 @@ export declare class PlannerKernelAccess extends ConfiguratorKernelAccess {
     protected _externalObjectComponentDeleted(remainingGroupOrGroups: ExternalObjectGroup | ExternalObjectGroup[], deletedRootModuleId: string): void;
     _externalObjectConfigurationDuplicated(duplicatedGroup: ExternalObjectGroup): void;
     _externalObjectPlanChanged(movedGroup: ExternalObjectGroup, objectPositionChanged: boolean): Promise<void>;
-    _externalObjectConfigurationsMerged(mergedGroup: ExternalObjectGroup, idsOfGroupsMerged: string | string[], targetRootModuleId: string): Promise<void>;
+    _externalObjectConfigurationsMerged(mergedGroup: ExternalObjectGroup, idsOfGroupsMerged: string | string[], targetRootModuleId: string, mergedWithDragging: boolean): Promise<void>;
     _externalObjectComponentSplitOff(splitGroups: ExternalObjectGroup[]): void;
     _externalObjectArrangementChanged(changedGroup: ExternalObjectGroup): void;
     planSnapshotCreated(planSnapshot: RapiPlanSnapshotPostData): void;
@@ -5892,11 +6026,12 @@ export declare class PlannerSceneEventHandler extends SceneEventHandler<SceneEve
     stopDrawing(cancelDrawing?: boolean): void;
     startDrawing(): void;
     private _toggleDrawing;
-    endWallDrawing(event: InputEvent_2 | null, point?: KernelVector3): void;
+    endWallDrawing(event: PointerInputEvent | null, point?: KernelVector3): void;
     private _startWallDrawing;
     private _initMobileDrawing;
     private _drawWallOnMouseMove;
     private _createNode;
+    getIntersectionAtScreenPosition(positionRelative: Position2): KernelVector3;
     private _getIntersectionPointWithScene;
     private _setStateAndCursor;
     setKernelZoomFactor(kernelZoomFactor: number): void;
@@ -5921,6 +6056,7 @@ export declare interface PlanNode extends KernelObject {
 export declare interface PlanObject extends PlanElement_2 {
     size: KernelVector3;
     rotation: number;
+    customLabel: string;
     rgbColor: number;
     useCustomColor?: boolean;
     flipX: boolean;
@@ -6069,8 +6205,8 @@ export declare class PlanViewModel extends ConfiguratorViewModel implements Plan
     handleInitialLights(_maxTextures: number, qualityLevel: QualityLevel): void;
     handleCeilingLights(): void;
     handleLampLight(lamp: StaticPlanObjectViewModel, options: {
-        targetPos: Point;
-        lightPos: Point;
+        targetPos: KernelVector3f;
+        lightPos: KernelVector3f;
         color?: number;
         decay?: number;
         intensity?: number;
@@ -6081,9 +6217,9 @@ export declare class PlanViewModel extends ConfiguratorViewModel implements Plan
             width: number;
             height: number;
         };
-        lightPos: Point;
+        lightPos: KernelVector3f;
         color?: number;
-        rotation?: Point;
+        rotation?: KernelVector3f;
         active?: boolean;
     }): void;
     toggleCeilingLights(on: boolean): void;
@@ -6199,6 +6335,14 @@ export declare class PointArray extends EmsArray<KernelVector3f> {
 export declare class PointArray_2 extends EmsArray<KernelVector3f> {
 }
 
+export declare interface PointerInputEvent {
+    position: Position2;
+    positionRelative: Position2;
+    type: INPUT_EVENT_TYPE;
+    rotation: number;
+    event?: Event;
+}
+
 export declare interface PoissonDenoiseParameters {
     poissonDenoisePassParameters?: PoissonDenoisePassParameters;
     normalVectorSourceType?: NormalVectorSourceType;
@@ -6710,10 +6854,10 @@ export declare class RapiAccess implements Context {
      */
     getTagConnectionsForTag(parentTagId: RapiId): Promise<Map<string, number>>;
     getMaterial(id: RapiId): Promise<RapiMaterial>;
-    peekMaterial(id: RapiId): RapiMaterial;
-    peekComponent(id: RapiId): RapiComponent;
-    peekItem(id: RapiId): RapiItem;
-    peekConfiguration(id: RapiId): RapiConfiguration;
+    peekMaterial(id: RapiId): RapiMaterial | null;
+    peekComponent(id: RapiId): RapiComponent | null;
+    peekItem(id: RapiId): RapiItem | null;
+    peekConfiguration(id: RapiId): RapiConfiguration | null;
     getMaterials(ids: RapiId[]): Promise<RapiMaterial[]>;
     getPlan(id: RapiId): Promise<RapiPlan>;
     getPlanSnapshot(id: RapiPlanSnapshotId): Promise<RapiPlanSnapshotGetData>;
@@ -6873,8 +7017,8 @@ export declare interface RapiConfiguration extends RapiJson {
     configuration: ConfigurationString;
     configurationHash: string;
     parts: string;
-    perspectiveImage?: AssetUrl;
-    topImage?: AssetUrl;
+    perspectiveImage?: AssetUrl | null;
+    topImage?: AssetUrl | null;
     rootComponentId: RapiId;
     orderable?: boolean;
     requestable?: boolean;
@@ -6883,7 +7027,7 @@ export declare interface RapiConfiguration extends RapiJson {
     depth: number;
     catalog?: RapiId;
     assets?: AssetItem;
-    [key: string]: string | number | boolean | AssetUrl | RapiId | LinksCollection | AssetItem | undefined;
+    [key: string]: string | number | boolean | AssetUrl | RapiId | LinksCollection | AssetItem | null | undefined;
 }
 
 export declare interface RapiConfigurationEnhanced extends RapiConfiguration {
@@ -6954,7 +7098,7 @@ export declare interface RapiItem extends RapiElement {
 }
 
 export declare interface RapiJson {
-    id?: RapiId | number;
+    id?: RapiId | number | null;
     isLocally?: boolean;
     __rapi_path__?: string;
     links?: LinksCollection;
@@ -6986,12 +7130,12 @@ export declare interface RapiMaterial extends RapiJson {
 }
 
 export declare interface RapiMaterialGroup extends RapiJson {
-    id: RapiId;
-    label: string;
+    id: RapiId | null;
+    label?: string | null;
     materials: RapiMaterial[];
     legacyId?: RapiId;
     sort?: number;
-    [key: string]: string | RapiMaterial[] | RapiId | boolean | LinksCollection | number | undefined;
+    [key: string]: string | RapiMaterial[] | RapiId | boolean | LinksCollection | number | null | undefined;
 }
 
 export declare interface RapiMaterialShading {
@@ -7044,9 +7188,9 @@ export declare interface RapiPlan extends RapiJson {
     description: string;
     changeDate: string;
     created: string;
-    draftId: number;
+    draftId: number | null;
     thumbnail: string;
-    planObjects: string;
+    planObjects: string | null;
     active: boolean;
     right?: number;
     draft?: number;
@@ -7056,11 +7200,11 @@ export declare interface RapiPlan extends RapiJson {
     version: number;
     floorLevel: number;
     visibility: number;
-    user: RapiUser | RapiId;
-    tenant: RapiTenant | RapiId;
+    user: RapiUser | RapiId | null;
+    tenant: RapiTenant | RapiId | null;
     assets: RapiPlanAsset[];
-    parent: RapiPlan | RapiId;
-    setting: RapiPlanSetting;
+    parent: RapiPlan | RapiId | null;
+    setting: RapiPlanSetting | null;
 }
 
 export declare interface RapiPlanAsset extends RapiJson {
@@ -7185,7 +7329,7 @@ export declare interface RapiTagGeneric extends RapiJson {
     catalog: RapiId;
     tags: RapiId[];
     parents: RapiId[];
-    [key: string]: string | number | boolean | AssetUrl | RapiId | RapiId[] | RapiElement[] | RapiMaterial[] | LinksCollection | undefined;
+    [key: string]: string | number | boolean | AssetUrl | RapiId | RapiId[] | RapiElement[] | RapiMaterial[] | LinksCollection | null | undefined;
 }
 
 export declare interface RapiTenant extends RapiJson {
@@ -7215,7 +7359,7 @@ export declare interface RapiTexture extends RapiJson {
     mmWidth: number;
     tileable: boolean;
     material: RapiId;
-    [key: string]: string | number | boolean | AssetUrl | RapiId | LinksCollection | undefined;
+    [key: string]: string | number | boolean | AssetUrl | RapiId | LinksCollection | null | undefined;
 }
 
 export declare interface RapiUser extends RapiJson {
@@ -7256,9 +7400,13 @@ export declare interface RapiUserSetting extends RapiJson {
     user: RapiUser;
 }
 
+export declare const enum RAYCAST_EVENT {
+    CLICK_OUTSIDE = 0
+}
+
 export declare type RayCasterObjectFilter = (object3d: Object3D) => boolean;
 
-export declare class RaycastHelper extends EventDispatcher<SceneEventInfo> {
+export declare class RaycastHelper extends EventDispatcher<Record<RAYCAST_EVENT, SceneEventInfo>> {
     private _mode;
     private _object;
     private _camera;
@@ -7305,7 +7453,7 @@ export declare class RaycastHelper extends EventDispatcher<SceneEventInfo> {
     setCamera(camera: Camera): void;
     setObject(object: Object3D): void;
     setMode(mode: INTERSECTION_MODE): void;
-    intersectMouseOnScene(event: InputEvent_2): KernelVector3;
+    intersectMouseOnScene(event: Pick<PointerInputEvent, 'positionRelative'>): KernelVector3;
     enableOnWallSnapping(): void;
     disableOnWallSnapping(): void;
 }
@@ -7531,8 +7679,8 @@ export declare interface RoomleComponent extends RoomleEventedObject3D {
     isRootComponent: boolean;
     meshes: RoomleEventedMesh[];
     boundingBox: Box3;
-    boundingBoxMesh: RoomleEventedMesh;
-    loadingMesh: Mesh;
+    boundingBoxMesh: RoomleEventedMesh | null;
+    loadingMesh: Mesh | null;
     roomlePosition: KernelVector3;
     roomleRotation: KernelVector3;
     hash: string;
@@ -7544,12 +7692,12 @@ export declare interface RoomleComponent extends RoomleEventedObject3D {
     addMesh(mesh: Mesh, transform?: Float32Array): void;
     removeMesh(mesh: Mesh): void;
     removeMeshById(meshId: number): void;
-    getLightSourceById(lightSourceId: number): RoomleLightSource | null;
+    getLightSourceById(lightSourceId: number): RoomleLightSource | undefined;
     removeLightSourceById(lightSourceId: number): void;
     addExistingLightSource(lightSource: RoomleLightSource): void;
     addLightSource(lightSource: RoomleLightSource): void;
     getAllLightSources(): Map<number, RoomleLightSource>;
-    getMeshById(meshId: number): Mesh;
+    getMeshById(meshId: number): Mesh | undefined;
     removeAllMeshes(): void;
     select(): void;
     deselect(): void;
@@ -8366,7 +8514,7 @@ export declare class RoomleLightSource {
     private _lightSourceId;
     private _light;
     private _savedPosition;
-    constructor(lightSourceId: number, lightSource?: Light);
+    constructor(lightSourceId: number, lightSource: Light);
     get light(): Light;
     set light(light: Light);
     get lightSourceId(): number;
@@ -8641,7 +8789,7 @@ export declare class RoomlePlanner<P extends readonly PluginName[] = readonly []
      * @param rotation in radians
      */
     insertObject(id: RapiId | ExtObjId, position?: Position3, rotation?: number): Promise<RuntimeId>;
-    _insertObject(id: RapiId | ExtObjId, newUndoRedoStep: boolean, position?: Position3, rotation?: number): Promise<RuntimeId>;
+    private _insertObject;
     insertItemList(ids: Array<RapiId | ExtObjId>): Promise<RuntimeId[]>;
     /**
      * Inserts all of the items in the array into current plan
@@ -8789,7 +8937,8 @@ export declare class RoomlePlanner<P extends readonly PluginName[] = readonly []
     createNewSerializedConfiguration(configurationRuntimeId: number): Promise<ConfigurationString>;
     changeInteriorWallsMaterial(material: BatchPaintMaterial): void;
     changeExteriorWallsMaterial(material: BatchPaintMaterial): void;
-    changeFloorsMaterial(material: BatchPaintMaterial): void;
+    changeFloorsMaterial(floors: KernelFloor[], material: BatchPaintMaterial): void;
+    changeAllFloorsMaterial(material: BatchPaintMaterial): void;
     /**
      * Returns the wall angle in degrees relative to the camera
      * @param wall a WallPlanElementViewModel instance
@@ -8950,9 +9099,9 @@ export declare class RoomlePlanner<P extends readonly PluginName[] = readonly []
      */
     resumeInputListeners(): void;
     /**
-     * Returns all configurable element's light/lamp sources in the scene.
+     * Returns all toggleable light sources (lamps) in the scene.
      */
-    getScenePlanElementLightSources(): RoomleLightSource[];
+    getScenePlanElementLightSources(): ToggleableLightSource[];
     /**
      * Turns all lights in the scene on or off.
      * @param state whether the lights should be on or off
@@ -9281,6 +9430,7 @@ export declare class RoomleWebGLRenderer {
     constructor(creator: string, renderer: WebGLRenderer | WebGPURenderer, width: number, height: number, linearAoFilter?: boolean);
     dispose(): void;
     setSize(width: number, height: number): void;
+    getSize(target: Vector2): Vector2;
     setCameraType(cameraType: Enumify_3<typeof CAMERA_TYPE>): void;
     setShadingType(shadingType: SceneShadingType): void;
     setAutoQuality(autoQuality: boolean): void;
@@ -9350,7 +9500,7 @@ export declare const SCENE_SHADING_TYPES: {
     readonly BRIGHT: "bright";
 };
 
-export declare abstract class SceneEventHandler<EventType> extends EventDispatcher<EventType> implements Context {
+export declare abstract class SceneEventHandler<EventType> extends EventDispatcher<Record<number, EventType>> implements Context {
     _creator_: string;
     protected _inputManager: InputManager;
     protected _raycastHelper: RaycastHelper;
@@ -9410,6 +9560,7 @@ export declare interface SceneEvents {
 export declare abstract class SceneManager implements Context, LifeCycleCallbacks, EventListenerObject {
     _creator_: string;
     protected _domHelper: DomHelper;
+    protected _css2DRendererManager: CSS2DRendererManager;
     protected _scriptLoader: ScriptLoader;
     private _lifeCycleManager;
     private _staticItemLoader;
@@ -9435,18 +9586,18 @@ export declare abstract class SceneManager implements Context, LifeCycleCallback
     protected _renderer: WebGLRenderer | WebGPURenderer;
     private _clock;
     private _delta;
-    protected _renderLoopFunction: () => void;
-    protected _renderListener: () => void;
+    protected _renderLoopFunction: (() => void) | null;
+    protected _renderListener: (() => void) | null;
     protected _stopRendering: boolean;
     protected _roomleRenderer: Nullable_2<RoomleWebGLRenderer>;
     private _forceRender;
     private _lastChange;
     private _running;
     private _statsHelper;
-    private _canvasID;
+    private readonly _canvasID;
     protected _isInteriorLightActive: boolean;
-    protected _perspectiveOffsetCamera: PerspectiveOffsetCamera;
-    protected _orthographicOffsetCamera: OrthographicOffsetCamera;
+    protected _perspectiveOffsetCamera: PerspectiveOffsetCamera | null;
+    protected _orthographicOffsetCamera: OrthographicOffsetCamera | null;
     protected abstract createCameraControl(mode: Enumify_3<typeof CAMERA_TYPE>, offset: CanvasOffset): void;
     protected abstract _getInputManager(): InputManager;
     protected get cameraBehaviour(): CameraBehaviour;
@@ -9458,7 +9609,7 @@ export declare abstract class SceneManager implements Context, LifeCycleCallback
     protected constructor(creator: string, offset: CanvasOffset, canvasID: string, mode: Enumify_3<typeof CAMERA_TYPE>);
     addEventListener(_listener: LifeCycleCallbacks): void;
     removeEventListener(_listener: LifeCycleCallbacks): void;
-    get lightCache(): LightCache;
+    get lightCache(): LightCache | null;
     protected _changeCameraBehaviour(cameraBehaviour: CameraBehaviour): void;
     protected onCameraChanged(): void;
     cameraBehaviourChanged(updateDistance?: boolean): void;
@@ -9522,6 +9673,7 @@ export declare abstract class SceneManager implements Context, LifeCycleCallback
     protected _waitForAssets(): Promise<void>;
     exportCanvasScreenshot(quality?: number): Promise<string>;
     exportImageFromCamera(filename: string, shouldWaitForAssets?: boolean): Promise<void>;
+    private getCanvasScreenshotWithDimensions;
     changeEnvironmentMapIntensity(intensity: number): void;
     lockCamera(): void;
     unlockCamera(): void;
@@ -9595,8 +9747,8 @@ export declare class SceneRenderer {
     setShadingType(shadingType: SceneShadingType): void;
     setQualityLevel(qualityLevel: QualityLevel): void;
     setQualityMap(qualityMap: QualityMap): void;
-    setCustomShadingParameters(customShadingParameters: CustomShadingParameters): void;
-    setQualityMapAndShadingParameters(qualityMap: QualityMap, customShadingParameters: CustomShadingParameters): void;
+    setCustomShadingParameters(customShadingParameters: CustomShadingParameters | null): void;
+    setQualityMapAndShadingParameters(qualityMap: QualityMap, customShadingParameters: CustomShadingParameters | null): void;
     applyCurrentParameters(): void;
     requestUpdateOfPasses(): void;
     clearCache(): void;
@@ -9963,6 +10115,16 @@ export declare interface SubComponentWaiter {
 
 export declare type ThreeJsColorsIn3dScene = Record<keyof typeof ROOMLE_COLORS, Color>;
 
+/**
+ * Minimal interface for any object that can be toggled on or off like a light.
+ * Both {@link RoomleLightSource} (kernel-driven lights) and the static lamp
+ * wrappers used for Three.js child lights satisfy this contract.
+ */
+export declare interface ToggleableLightSource {
+    isLightOn: boolean;
+    setLightOnOff(on: boolean): void;
+}
+
 export declare class ToolsCore extends Main {
     private _tools;
     protected setupGlobals(): void;
@@ -10314,6 +10476,12 @@ export declare interface WallSide {
     value: Enumify<typeof WALL_SIDES>;
 }
 
+export declare class ZoomChangeEvent {
+    minZoom: boolean;
+    maxZoom: boolean;
+    constructor(minZoom?: boolean, maxZoom?: boolean);
+}
+
 export { }
 
 declare global {
@@ -10324,7 +10492,7 @@ declare global {
   // @ts-ignore -- just for testing
   const WebAssembly: any; // eslint-disable-line
   interface Window {
-    KernelCallback: { isReady: () => void };
+    KernelCallback?: { isReady: () => void } | null;
     __RML_GUI__: GUI; // eslint-disable-line
     __RML__DEBUG__?: Debug;
     __RML__ENV__?: ExternalEnv;