@roomle/web-sdk 3.7.0 → 3.8.0-alpha.1

package/lib/roomle-sdk.d.ts

@@ -22,6 +22,7 @@ import { Intersection } from 'three';
 import { Layers } from 'three';
 import { Light } from 'three';
 import { Material } from 'three';
+import { MaterialEventMap } from 'three';
 import { Mesh } from 'three';
 import { MeshPhysicalMaterial } from 'three';
 import { MeshStandardMaterial } from 'three';
@@ -79,6 +80,13 @@ export declare class AddOnSpotArray extends EmsArray<KernelAddOnSpot> {
 export declare class AddOnSpotArray_2 extends EmsArray<KernelAddOnSpot> {
 }
 
+export declare class AdjustableCameraControl3D extends CameraControl3D {
+    shouldIgnoreStandardBehavior: boolean;
+    adjust(bounds: Vector3, position: Vector3, yaw: number, pitch: number, _fov: number): void;
+    protected _update(overrideTarget?: Vector3): void;
+    animateCamera(delta: number): boolean;
+}
+
 export declare interface Anchor {
     value: ResizingAnchor;
 }
@@ -120,6 +128,7 @@ export declare class AnimationValueMap {
     setValueAndGetOldValue(animationName: string, value: string, level: number): string;
     getPriorAnimations(animationName: string, level: number): string[];
     getSequentAnimations(animationName: string, level: number): string[];
+    getValues(): string[];
 }
 
 /**
@@ -631,7 +640,7 @@ export declare class CeilingLight extends PointLight {
     private _shouldCastShadow;
     getContainer(): Mesh | null;
     get shouldCastShadow(): boolean;
-    constructor(debug: boolean, maxQualityLevel: QualityLevel);
+    constructor(debug: boolean | undefined, maxQualityLevel: QualityLevel);
     recalculatePower(amountOfLights: number): void;
     update(qualityLevel: QualityLevel): void;
     addDebugUI(ceilingLightsParameters: GenericGUIParamFolder): void;
@@ -875,6 +884,7 @@ export declare interface CommonInitData {
 
 export declare abstract class CommonKernelAccess implements LifeCycleCallbacks, Context {
     _creator_: string;
+    private _kernelCallbackGuard;
     protected _rapiAccess: RapiAccess;
     private _materialProvider;
     protected _scriptLoader: ScriptLoader;
@@ -1238,6 +1248,7 @@ export declare class ConfiguratorKernelAccess extends CommonKernelAccess {
     muteKernelCallbacks: boolean;
     constructor(creator: string);
     init(kernelType: KERNEL_TYPE): void;
+    protected _getScriptLoaderKernelId(_kernelType: KERNEL_TYPE): string;
     protected _loadSuccess(): void;
     protected _loadError(): void;
     selectedComponent(componentId: number): void;
@@ -1296,7 +1307,7 @@ export declare class ConfiguratorKernelAccess extends CommonKernelAccess {
     componentParameters(): void;
     requestComponentDimensions(): void;
     planObjectCreated(conversationId: number, planObjectId: number): void;
-    planObjectUpdated(planObjectId: number, pendingDocking: boolean): void;
+    planObjectUpdated(planObjectId: number, pendingDocking: boolean, automaticCalculationUpdate: boolean): void;
     planObjectConfigurationUpdated(planObjectId: number, configuration: ConfigurationString, hash: string, _rootPlanComponentId: number, _valid: boolean, pendingDocking: boolean): Promise<void>;
     private _onBoundsUpdate;
     planObjectDeleted(): void;
@@ -1352,6 +1363,9 @@ export declare class ConfiguratorKernelAccess extends CommonKernelAccess {
     listOfVariantsError(dbId: RapiId, error: string): void;
     addDebugClient(debugClient: DebugClient): void;
     configureExternalObjectApi(_externalObjectSetting?: ExternalObjectApiConfiguration): void;
+    evaluateJsScript(objectOrComponentId: number, name: string, argumentObject: any): void;
+    getComponentBounds(componentId: number, animationValueMap?: AnimationValueMap): KernelComponentBounds;
+    updateComponentBounds(component: RoomleComponent): void;
 }
 
 export declare interface ConfiguratorKernelAccessCallbackI extends KernelAccessCallbackI {
@@ -1361,7 +1375,7 @@ export declare interface ConfiguratorKernelAccessCallbackI extends KernelAccessC
 
 export declare interface ConfiguratorKernelCallbackI extends CommonConfiguratorKernelCallbackI {
     planObjectCreated(conversationId: number, planObjectId: number): void;
-    planObjectUpdated(planObject: PlanObjectKernel, pendingDocking: boolean): void;
+    planObjectUpdated(planObject: PlanObjectKernel, pendingDocking: boolean, automaticCalculationUpdate: 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, componentType: KernelComponentType): void;
@@ -1410,7 +1424,7 @@ export declare interface ConfiguratorKernelClass {
     setPlanObjectParameter(planObjectId: number, parameterKey: string, value: string): void;
     dockComponent(childId: number, childDockId: number, parentId: number, parentDockId: number, position?: KernelVector3): void;
     getComponent(componentId: number): KernelComponent;
-    getComponentBounds(componentId: number, animationValues: string[]): KernelAssembledObjectBounds;
+    getComponentBounds(componentId: number, animationValues: string[]): KernelComponentBounds;
     getComponentId(componentId: number): RapiId;
     isExternalPlanObject(objectOrPlanComponentId: number): boolean;
     getComponentOrModuleInformation(objectOrPlanComponentId: number): KernelObjectInformation;
@@ -1443,6 +1457,10 @@ export declare interface ConfiguratorKernelClass {
     loadExternalAttributeDefinition(serializedDefinition: string): void;
     setExternalObjectConstructionProperties(serializedProperties: string): void;
     registerDebugClient(debugClient: DebugClient): void;
+    getGlobalParameterValue(objectOrComponentId: number, name: string): string;
+    getRuntimeIdOfRootComponent(objectOrComponentId: number): number;
+    getRuntimeIdsOfChildComponents(objectOrComponentId: number): number[];
+    getComponentParameterValue(objectOrComponentId: number, name: string): string;
 }
 
 export declare interface ConfiguratorKernelContainer {
@@ -1476,7 +1494,6 @@ export declare interface ConfiguratorKernelContainer {
 export declare class ConfiguratorPlanObjectViewModel extends PlanObjectViewModel {
     private _rootComponentRuntimeId;
     private _rootComponentId;
-    private _isExternalObject;
     constructor(planObject: PlanObject);
     addRootComponent(component: RoomleComponent): void;
     addChildEntityComponent(component: RoomleComponent): void;
@@ -1562,7 +1579,7 @@ export declare class ConfiguratorSceneManager extends SceneManager implements Co
     protected _configuratorUiCallbacks: ConfiguratorUiCallbacks;
     protected _plannerKernelAccess: PlannerKernelAccess;
     protected _globalInitData: GlobalInitData;
-    protected _viewModel: ConfiguratorViewModel;
+    _viewModel: ConfiguratorViewModel;
     private _componentFactory;
     protected _highlightHelper: HighlightHelper;
     private _dimensionHelper;
@@ -1582,7 +1599,7 @@ export declare class ConfiguratorSceneManager extends SceneManager implements Co
     enableEvents(): void;
     enableConfiguratorEvents(): void;
     disableConfiguratorEvents(): void;
-    protected _getViewModel(): ConfiguratorViewModel;
+    get viewModel(): ConfiguratorViewModel;
     protected _getKernelAccess(): PlannerKernelAccess;
     private _showDockings;
     cancelDockings(): void;
@@ -1592,6 +1609,7 @@ export declare class ConfiguratorSceneManager extends SceneManager implements Co
     private _onDimensionsAdded;
     private _onHoverOff;
     private _highlightComponent;
+    private _highlightSubModules;
     protected shouldClearShadowsAndAO(): boolean;
     resume(): void;
     private _materialLoaded;
@@ -1667,7 +1685,7 @@ export declare class ConfiguratorSceneManager extends SceneManager implements Co
     };
     private _permissionToDeleteComponent;
     componentUpdated(component: RoomleComponent, kernelComponent: KernelComponent): void;
-    planObjectUpdated(planObject: PlanObjectKernel, geometryChanged: boolean, pendingDocking: boolean): void;
+    planObjectUpdated(planObject: PlanObjectKernel, geometryChanged: boolean, pendingDocking: boolean, automaticCalculationUpdate: boolean): void;
     componentDeleted(component: RoomleComponent): void;
     previewConstructionDone(_component: RoomleComponent, hasPreviews: boolean): void;
     configurationLoaded(component: RoomleComponent, isFreeFlying: boolean): void;
@@ -1694,7 +1712,6 @@ export declare class ConfiguratorSceneManager extends SceneManager implements Co
     getComponent(componentRuntimeId: number): KernelComponent;
     cameraBehaviourChanged(updateDistance?: boolean): void;
     protected _setCameraControlListeners(): void;
-    protected _shouldRenderUi(): boolean;
     protected setEventHandlerObject(object: Object3D): void;
     protected _readyForRender(): void;
     getComponentFromRuntimeId(elementId: number): RoomleComponent | null;
@@ -1709,7 +1726,7 @@ export declare class ConfiguratorSceneManager extends SceneManager implements Co
     private _removeCustomComponentDimensions;
     clearHighlighting(): void;
     getExternalSubArticles(_id: number): PosArticle[];
-    protected _updateHighlightHelper(object?: Object3D | null): void;
+    protected _updateHighlightHelper(invalidate?: boolean, object?: Object3D | null): void;
 }
 
 export declare class ConfiguratorUiCallbacks extends UiCallback implements ConfiguratorDebugCallbacks {
@@ -2072,7 +2089,7 @@ export declare class ConfiguratorViewModel implements ConfiguratorKernelCallback
     finishParameterChange(resolve: () => void, _reject: () => void): void;
     planObjectConfigurationUpdated(planObjectId: number, _configuration: ConfigurationString, _hash: string, pendingDocking: boolean): void;
     planObjectCreated(_conversationId: number, configurationRuntimeId: number): void;
-    planObjectUpdated(planObject: PlanObjectKernel, pendingDocking: boolean): void;
+    planObjectUpdated(planObject: PlanObjectKernel, pendingDocking: boolean, automaticCalculationUpdate: boolean): void;
     sceneCleared(): void;
     setListener(listener: ConfiguratorViewModelCallbackI): void;
     getBoundingBox(excludeEnvironment?: boolean): Box3 | null;
@@ -2104,7 +2121,7 @@ export declare class ConfiguratorViewModel implements ConfiguratorKernelCallback
 export declare interface ConfiguratorViewModelCallbackI {
     componentUpdated(component: RoomleComponent, kernelComponent: KernelComponent): void;
     componentDeleted(component: RoomleComponent): void;
-    planObjectUpdated(planObject: PlanObjectKernel, geometryChanged: boolean, pendingDocking: boolean): void;
+    planObjectUpdated(planObject: PlanObjectKernel, geometryChanged: boolean, pendingDocking: boolean, automaticCalculationUpdate: boolean): void;
     planObjectConstructionDone(planObject: PlanObjectKernel): void;
     previewConstructionDone(component: RoomleComponent, hasPreviews: boolean): void;
     configurationLoaded(component: RoomleComponent, isFreeFlying: boolean): void;
@@ -2213,6 +2230,23 @@ export declare const CORE_DOCK_PAIR_TYPE: {
     readonly LINE: 1;
 };
 
+export declare const CORE_DRAWING_MODE: {
+    readonly WALL: 0;
+    readonly ROOM_CONTOUR: 1;
+    readonly CONTOUR: 2;
+};
+
+export declare const CORE_EDGE_TYPE: {
+    readonly WALL: 0;
+    readonly EDGE: 1;
+    readonly CONSTRUCTION: 2;
+};
+
+export declare const CORE_FLOOR_TYPE: {
+    readonly DEFAULT: 0;
+    readonly TERRAIN: 1;
+};
+
 export declare const CORE_HELP_LINE_TYPE: {
     readonly NONE: 0;
     readonly WALL_SNAP_LEVEL: 1;
@@ -2524,6 +2558,10 @@ export declare const DRAW_PREVIEW_MODES: {
     readonly VECTOR: "vector";
 };
 
+export declare interface DrawingMode {
+    value: Enumify<typeof CORE_DRAWING_MODE>;
+}
+
 export declare const enum DrawingType {
     CONTINOUS = 0,
     CLICK_PER_CLICK = 1
@@ -2566,6 +2604,10 @@ export declare interface DynamicLightSettingSource {
     ls?: PreDefinedLightSettings;
 }
 
+export declare interface EdgeType {
+    value: Enumify<typeof CORE_EDGE_TYPE>;
+}
+
 export declare interface Element_2 {
     id: string;
     label: string;
@@ -2943,12 +2985,14 @@ export declare interface ExternalObjectAPI {
     getExternalRoomInformation(): Promise<ExternalRoomInformation>;
     /**
      * It generates a snapshot of the external object in the plan without saving any data.
-     * The snapshot includes order data, room information, the plan XML, GLBs of the complete scene,
+     * By default, the snapshot includes order data, room information, the plan XML, GLBs of the complete scene,
      * and only the objects in the scene, as well as perspective images and a top image.
      * The complete XML plan is returned. The assets are returned as base64 strings.
+     * The `requestData` parameter can be used to control which parts of the snapshot are generated, returning only requested properties to improve performance. If `requestData` is passed, omitted properties will be `undefined`.
+     * @param requestData An optional filter object indicating which snapshot properties to generate.
      * @returns the snapshot of the external objects
      */
-    getExternalObjectSnapshot(): Promise<ExternalObjectSnapshotData | null>;
+    getExternalObjectSnapshot(requestData?: ExternalObjectSnapshotRequest): Promise<ExternalObjectSnapshotData | null>;
     /**
      * It generates a snapshot of the external object and saves the data and assets in the Roomle backend.
      * The snapshot includes order data, room information, the plan XML, GLBs of the complete scene,
@@ -3014,6 +3058,7 @@ export declare interface ExternalObjectLoadConfiguration {
     respondWithPositionInPlan: boolean;
     lockCallbacks: boolean;
     tryToMergeNewGroups: boolean;
+    calculationUpdate: boolean;
     moduleIdMap: ExternalObjectLoadingIdMap[];
 }
 
@@ -3056,13 +3101,23 @@ export declare interface ExternalObjectSegment {
 }
 
 export declare interface ExternalObjectSnapshotData {
-    orderData: HiOrderData | null | undefined;
-    planXML: string;
-    objectGlb: string | undefined;
-    perspectiveImage: string | undefined;
-    topImage: string | undefined;
-    perspectiveObjectImage: string | undefined;
-    topObjectImage: string | undefined;
+    orderData?: HiOrderData | null;
+    planXML?: string;
+    objectGlb?: string;
+    perspectiveImage?: string;
+    topImage?: string;
+    perspectiveObjectImage?: string;
+    topObjectImage?: string;
+}
+
+export declare interface ExternalObjectSnapshotRequest {
+    orderData?: boolean;
+    planXML?: boolean;
+    objectGlb?: boolean;
+    perspectiveImage?: boolean;
+    topImage?: boolean;
+    perspectiveObjectImage?: boolean;
+    topObjectImage?: boolean;
 }
 
 export declare interface ExternalObjectSnapshotSaveResult {
@@ -3162,6 +3217,7 @@ export declare interface FeatureFlags {
     /* Excluded from this release type: advancedDimensioning */
     /* Excluded from this release type: webGpu */
     /* Excluded from this release type: advancedHighlighting */
+    /* Excluded from this release type: fence */
 }
 
 export declare interface FetchOptions {
@@ -3201,7 +3257,7 @@ export declare interface FloorAreaData<Vector2Type = Vector3, Vector3Type = Vect
 
 export declare type FloorAreaDataTransferable = FloorAreaData<Position2, Position3>;
 
-export declare abstract class FloorMaterial extends BaseMaterial {
+export declare class FloorMaterial extends BaseMaterial {
     uvScale(): KernelVector3f;
     rotation(): KernelVector3f;
 }
@@ -3213,6 +3269,10 @@ export declare class FloorPlanElementViewModel extends PlanElementViewModel {
     private calculateTextVisibility;
 }
 
+export declare interface FloorType {
+    value: Enumify<typeof CORE_FLOOR_TYPE>;
+}
+
 /**
  * Minimal structural type that both dat.gui `GUI` folders (WebGL) and three.js
  * `ParametersGroup` (WebGPU) satisfy, this allows building
@@ -3247,6 +3307,12 @@ export declare class GeometryHelpLineArray extends EmsArray<GeometryHelpLine> {
 
 export declare const getCatalogIdFromConfigurationHash: (id: RapiId) => RapiId | null;
 
+export declare interface GLBRenderWorkerListener {
+    onStart(count: number): void;
+    onElementFinished(finishedElements: number): void;
+    onFinished(zip: any): void;
+}
+
 export declare class GlbViewer extends Main {
     private _viewer;
     protected setupGlobals(): void;
@@ -3258,6 +3324,39 @@ export declare class GlbViewer extends Main {
     protected getContextName(): string;
 }
 
+export declare class GlbViewerCameraBehaviour extends CameraBehaviour {
+    get cameraControl(): AdjustableCameraControl3D;
+    updateCameraOnItemLoaded(bounds: Box3): Promise<void>;
+    externalApiMoveCamera(cameraParameter: CameraParameter): Promise<void>;
+}
+
+export declare class GLBViewerSceneManager extends SceneManager implements GLBRenderWorkerListener {
+    private _glbInputManager;
+    private _rapiAccess;
+    private _currentGLB;
+    private _standardSceneBackgroundColor;
+    private _itemsCount;
+    constructor(creator: string, offset: CanvasOffset);
+    protected createCameraControl(_mode: Enumify_3<typeof CAMERA_TYPE>, _offset: CanvasOffset): void;
+    protected _getInputManager(): InputManager;
+    loadStaticItem(id: string, callback?: (percent: number) => void): Promise<void>;
+    loadGLB(url: string, automaticallyAdjustCamera?: boolean, scaling?: Vector3, callback?: (percent: number) => void): Promise<void>;
+    preparePerspectiveImage(options?: PrepareImageOptions, providedRenderer?: WebGLRenderer): Promise<Base64Image>;
+    adjustCamera(position: Vector3, yaw: number, pitch: number, fov: number): void;
+    onStart(count: number): void;
+    onElementFinished(itemsFinished: number): void;
+    onFinished(_zip: any): void;
+    clearScene(): void;
+    enableHD(): void;
+    sceneChanged(): void;
+    getBounds(): Box3 | null;
+    protected get glbViewerCameraBehaviour(): GlbViewerCameraBehaviour;
+    getGeometryBounds(): Box3 | null;
+    cameraBehaviourChanged(updateDistance?: boolean): void;
+    moveCamera(cameraParameter: CameraParameter): Promise<void>;
+    protected _readyForRender(): void;
+}
+
 export declare class GlbViewerUiCallbacks {
 }
 
@@ -3402,7 +3501,7 @@ export declare interface GlueLogic {
     getVerifiedGroupAttributeOptions(groupId: string, attributeIds?: string | string[]): Promise<Record<string, CheckDropDownResult> | undefined>;
     updateProperty(rootModuleId?: string, propertyName?: string, propertyValue?: string | number | boolean): void;
     findValidSubArticles(posGroupIds: string[] | string): PosArticle[];
-    getValidContainerModulesForSubArticle(posGroupIds: string[] | string, subArticleId: string): ExternalObjectValidContainerModules[];
+    getValidContainerModulesForSubArticle(posGroupIds: string[] | string, subArticleId: string): ValidContainerModules[];
     addSubArticle(articleId: string, rootModuleId: string, parentModuleId: string, insertPosition?: number[]): void;
     deleteSubArticles(groupId: string, subModuleId: string[] | string): Promise<void>;
     arrangeRootModulesOfGroup(changedGroup: ExternalObjectGroup): Promise<void>;
@@ -3490,6 +3589,7 @@ export declare interface HighlightHelper {
     checkPreviewVisibility(configuratorViewModel: ConfiguratorViewModel): void;
     areAllComponentsInFrustum(previews: RoomleComponent[]): boolean;
     onSelectionChanged(object: Object3D, componentIds: number[], callback?: () => void): void;
+    invalidate?(): void;
 }
 
 export declare type HiLoadObjectReason = (typeof HI_LOAD_OBJECT_REASON)[keyof typeof HI_LOAD_OBJECT_REASON];
@@ -3720,6 +3820,7 @@ export declare class InitData implements Context, Omit<InitDataDefinition, 'colo
     discardExternalObjectsWhenLoadingPlan?: boolean;
     featureFlags: FeatureFlags;
     meshRaycasting?: boolean;
+    defaultFloorMaterial?: number | string;
     mode?: Enumify_3<typeof CAMERA_TYPE>;
     edit?: boolean;
     moc?: boolean;
@@ -4002,6 +4103,11 @@ export declare interface KernelComponent {
     childAnimationTransformations: ComponentAnimationTransformation[];
 }
 
+export declare interface KernelComponentBounds {
+    boxForMeasurement: KernelCube;
+    geometryBounds: KernelAssembledObjectBounds;
+}
+
 export declare interface KernelComponentDocking {
     componentId: number;
     isRootComponent: boolean;
@@ -4071,6 +4177,7 @@ export declare interface KernelFloor extends KernelObject {
     area: number;
     material: KernelFloorMaterial;
     readonly parapetHeight: number;
+    readonly floorType: FloorType;
     getCenter: () => KernelVector3;
     getRandomPointInside: () => KernelVector3;
     getLabelPosition: () => KernelVector3;
@@ -4391,6 +4498,7 @@ export declare interface KernelWall extends KernelObject {
     readonly wallType: KernelEnum;
     readonly leftNormal: KernelVector3;
     readonly rightNormal: KernelVector3;
+    readonly edgeType: EdgeType;
     getAngle: () => number;
 }
 
@@ -4746,8 +4854,8 @@ export declare class MeasurementLinePlanElementViewModel extends PlanElementView
     private updatePointDraggableGeometry;
     getPoint1Draggable(): DraggableNode;
     getPoint2Draggable(): DraggableNode;
-    getPoint1DraggableBoundingBox(): Mesh<BufferGeometry<NormalBufferAttributes, BufferGeometryEventMap>, Material | Material[], Object3DEventMap>;
-    getPoint2DraggableBoundingBox(): Mesh<BufferGeometry<NormalBufferAttributes, BufferGeometryEventMap>, Material | Material[], Object3DEventMap>;
+    getPoint1DraggableBoundingBox(): Mesh<BufferGeometry<NormalBufferAttributes, BufferGeometryEventMap>, Material<MaterialEventMap> | Material<MaterialEventMap>[], Object3DEventMap>;
+    getPoint2DraggableBoundingBox(): Mesh<BufferGeometry<NormalBufferAttributes, BufferGeometryEventMap>, Material<MaterialEventMap> | Material<MaterialEventMap>[], Object3DEventMap>;
     hidePreviewBox(): void;
     selectPoint1Draggable(): void;
     selectPoint2Draggable(): void;
@@ -4811,7 +4919,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 | null, geometry: BufferGeometry): Mesh<BufferGeometry<NormalBufferAttributes, BufferGeometryEventMap>, Material, Object3DEventMap>;
+    protected _createMesh(runtimeComponentId: number, geometryId: string | null, geometry: BufferGeometry): Mesh<BufferGeometry<NormalBufferAttributes, BufferGeometryEventMap>, Material<MaterialEventMap>, Object3DEventMap>;
     protected _getComponentMeshId(runtimeComponentId: number, geometryId: string): string;
 }
 
@@ -5176,7 +5284,7 @@ export declare interface PlanInteractionHandler {
     addPlanObjects(list: KernelObjectPtrList, findFreeSpaceInPlan: boolean): PlanObject[];
     addPlanObjectFromItem(object: KernelObject, position: KernelVector3, type: number, findFreeSpaceInPlan: boolean): PlanObject;
     addOrUpdateExternalPlanObjects(serialzedConfiguration: string | string[], position: KernelVector3, rotationInRad: number, updateConfiguration: ExternalObjectLoadConfiguration, mergedGroupIds: string | string[]): PlanObject[];
-    createPreviewGeometryForAddOn(objectId: string, articleId: string, groupDefinitions: string, validContainerModules: ExternalValidContainerModule[]): void;
+    createPreviewGeometryForAddOn(objectId: string, objectConfiguration: string, articleId: string, groupDefinitions: string, validContainerModules: ExternalValidContainerModule[]): void;
     catalogItemLoaded(catalogItem: KernelCatalogItem): void;
     removeElement(planObject: KernelObject): void;
     removeObjectWithId(objectId: string): void;
@@ -5195,12 +5303,13 @@ export declare interface PlanInteractionHandler {
     undo(): void;
     redo(): void;
     isVectorPreviewModeEnabled(): boolean;
+    getDrawingMode(): DrawingMode;
     sCreateUnclosedSpaceEnabled(): boolean;
     beginDrawing(point: {
         x: number;
         y: number;
         z: number;
-    }, vectorPreviewMode: boolean, createUnclosedSpace: boolean): void;
+    }, drawingMode: DrawingMode, createUnclosedSpace: boolean): void;
     endDrawing(point: {
         x: number;
         y: number;
@@ -5249,6 +5358,8 @@ export declare interface PlanInteractionHandler {
     setWallRightMaterial(wall: KernelWall, material: KernelWallMaterial): void;
     setFloorMaterial(floor: KernelFloor, material: KernelFloorMaterial): void;
     setFloorLabelObject(floor: KernelFloor, serializedLabelObject: string): void;
+    setFloorType(floor: KernelFloor, floorType: FloorType): void;
+    setEdgeType(wall: KernelWall, edgeType: EdgeType): void;
     getContinuousDrawingManager(): ContinuousDrawingManager;
     setSnapFeedbackWhileDrawing(enabled: boolean): void;
     consistsOfMergedComponents(object: KernelObject): boolean;
@@ -5278,6 +5389,7 @@ export declare interface PlanInteractionHandler {
     objectToObjectSnapMode: SnapMode;
     dockWhenSnap: boolean;
     unDockOnMove: boolean;
+    enableTerrain: boolean;
 }
 
 export declare abstract class PlanMeasure extends PlanElement {
@@ -5396,6 +5508,11 @@ export declare class PlannerFpCameraBehaviour extends PlannerCameraBehaviour {
 }
 
 export declare interface PlannerInitData {
+    /**
+     * @description Sets the default floor material when creating a new plan or drawing.
+     * Can be a number (RGB color) or a string (material ID).
+     */
+    defaultFloorMaterial?: number | string;
     /**
      * @description Select with which camera mode to start initially.
      * usage: mode=2D
@@ -5414,14 +5531,17 @@ export declare interface PlannerInitData {
 }
 
 export declare class PlannerKernelAccess extends ConfiguratorKernelAccess {
-    private _kernelAccessCallback;
     private _roomlePlannerUiCallback;
     private _planInteractionHandler;
     private _plannerKernelCallbackListener;
+    private _plannerReadyListeners;
+    private _plannerReady;
+    addListener(listener: KernelAccessCallbackI): void;
+    removeListener(listener: KernelAccessCallbackI): void;
     private _homagIntelligence;
     get kernelContainer(): any;
     constructor(creator: string);
-    protected _loadSuccess(): void;
+    protected _loadSuccess(): Promise<void>;
     protected _loadError(): void;
     get homagIntelligence(): HomagIntelligence | null;
     setHomagIntelligence(homagIntelligence: HomagIntelligence | null): void;
@@ -5572,6 +5692,7 @@ export declare interface PlannerKernelContainer {
     WallMaterial: WallMaterial;
     Plan: Plan;
     DrawingType: DrawingType;
+    DrawingMode: DrawingMode;
     ResizingAnchor: ResizingAnchor;
     toResizingAnchor: (a: number) => ResizingAnchor;
     PlanInteractionHandler: PlanInteractionHandler;
@@ -5745,6 +5866,7 @@ export declare class PlannerSceneManager extends ConfiguratorSceneManager implem
     private _completelyLoaded;
     private _configurableItemGuard;
     private _planCompletelyLoadedGuard;
+    private _fullyReadyGuard;
     private _dragStartBounds;
     currentSelection: SelectionPayload | null;
     private _paperBackground;
@@ -5775,7 +5897,7 @@ export declare class PlannerSceneManager extends ConfiguratorSceneManager implem
     private _activateElement;
     planCleared(): void;
     planHistoryStateChanged(): void;
-    protected _getViewModel(): PlanViewModel;
+    get viewModel(): PlanViewModel;
     private _getDragPosition;
     private _hideAllMeasurementsNodeOnElementChange;
     private _onSelectionChange;
@@ -6527,6 +6649,7 @@ export declare interface PrepareImageOptions {
     showDimensions?: boolean;
     runtimeIds?: number[];
     rotationY?: number;
+    preserveSceneBackground?: boolean;
 }
 
 export declare interface PrepareImageOptionsPlanner extends PrepareImageOptions {
@@ -8204,6 +8327,7 @@ export declare class RoomleGLBViewer implements GlobalAPI, Context, ExternalEmbe
     getCameraOffset(): CanvasOffset;
     init(element: HTMLElement, initData?: InitDataDefinition): Promise<void>;
     private _initPromiseCallback;
+    getSceneManager(): GLBViewerSceneManager;
     /**
      * Remove the current glb from the scene if it exists
      */
@@ -8231,7 +8355,7 @@ export declare class RoomleGLBViewer implements GlobalAPI, Context, ExternalEmbe
      * @param sceneSettings
      */
     loadSceneSetting(sceneSettings: SceneSettings): Promise<void>;
-    preparePerspectiveImage(): Promise<Base64Image>;
+    preparePerspectiveImage(options?: PrepareImageOptions): Promise<Base64Image>;
     processRenderList(jsonString: string, width?: number, height?: number): void;
     setOverrides(initData: Partial<InitDataDefinition & GlobalInitDataDefinition> | InitData | undefined): void;
     updateSize(): void;
@@ -8406,7 +8530,6 @@ export declare class RoomlePlanner<P extends readonly PluginName[] = readonly []
     private _homagIntelligence;
     private _configuratorContext;
     private _domHelper;
-    private _kernelAccessCallback;
     private _plannerKernelAccess;
     private _rapiAccess;
     private _singlePromiseFactory;
@@ -8687,7 +8810,7 @@ export declare class RoomlePlanner<P extends readonly PluginName[] = readonly []
      * @param sceneEvents
      */
     setSceneEvents(sceneEvents: SceneEvents): void;
-    getExternalObjectSnapshot(): Promise<ExternalObjectSnapshotData | null>;
+    getExternalObjectSnapshot(requestData?: ExternalObjectSnapshotRequest): Promise<ExternalObjectSnapshotData | null>;
     saveExternalObjectSnapshot(parentPlanId?: RapiId): Promise<ExternalObjectSnapshotSaveResult | null>;
     private _getExternalObjectGroupsInPlan;
     private _savePlanSnapshotExternalObjects;
@@ -9215,9 +9338,12 @@ export declare class RoomleWebGPURenderer extends RoomleRenderer<WebGPURenderer>
     disableUiInteractionMode(): void;
     enableUiInteractionMode(): void;
     getQualityLevel(): QualityLevel;
+    setCameraType(cameraType: Enumify_3<typeof CAMERA_TYPE>): void;
+    switchToPlanner(renderMode: PlannerRenderMode): void;
     highlightObjects(selectedMeshes: Object3D[]): void;
     loadLutImages(_luts: LutImageDefinition[]): void;
     render(scene: Scene, camera: Camera): void;
+    private updateCameraProjectionMatrix;
     private assembleRenderPasses;
     setAutoQuality(_autoQuality: boolean): void;
     setCustomShadingParameters(_customShadingParameters: CustomShadingParameters | undefined, _customShadingParametersMoc: CustomShadingParameters | undefined): void;
@@ -9375,7 +9501,7 @@ export declare abstract class SceneManager implements Context, LifeCycleCallback
     protected _orthographicOffsetCamera: OrthographicOffsetCamera | null;
     protected abstract createCameraControl(mode: Enumify_3<typeof CAMERA_TYPE>, offset: CanvasOffset): void;
     protected abstract _getInputManager(): InputManager;
-    protected get cameraBehaviour(): CameraBehaviour;
+    get cameraBehaviour(): CameraBehaviour;
     abstract sceneChanged(): void;
     abstract getBounds(): Box3 | null;
     abstract getGeometryBounds(): Box3 | null;
@@ -9404,7 +9530,7 @@ export declare abstract class SceneManager implements Context, LifeCycleCallback
     protected _renderWithoutShadowsAndAO(): void;
     protected _requestRender(): void;
     protected _shouldRenderUi(): boolean;
-    private _renderUi;
+    private _renderUiWithDepthPrepass;
     private _animateCamera;
     protected shouldClearShadowsAndAO(): boolean;
     protected _setupScene(_offset?: CanvasOffset, transparent?: boolean): Promise<void>;
@@ -9825,6 +9951,11 @@ export declare interface UserAction {
     actionLabel: number;
 }
 
+export declare interface ValidContainerModules {
+    calculatedPosGroup: PosGroup;
+    validContainerModules: ExternalObjectValidContainerModules[];
+}
+
 export declare type ValuesFromObject<T> = T[keyof T];
 
 export declare class VariableArray extends EmsArray<KernelVariable> {
@@ -9898,7 +10029,7 @@ export declare interface WallExtensionType {
     ExtendBoth: EMSConstant;
 }
 
-export declare abstract class WallMaterial extends BaseMaterial {
+export declare class WallMaterial extends BaseMaterial {
 }
 
 export declare class WallPlanElementViewModel extends PlanElementViewModel {

package/lib/roomle-sdk.js

@@ -1,8 +1,8 @@
 import { i as e, t } from "./kernel-C7YDLxq8.mjs";
-import { A as n, B as r, E as i, G as a, H as o, M as s, N as c, P as l, R as u, U as d, V as f, _ as p, a as m, at as h, c as g, ct as _, g as v, j as y, n as b, ot as x, rt as S, s as C, v as w, y as T, z as E } from "./main-CJ5TNhBt.mjs";
-import { t as D } from "./configurator-Cg1a9XSL.mjs";
-import { t as O } from "./planner-CSboZram.mjs";
-import { n as k, t as A } from "./glb-viewer-tgKOPCaI.mjs";
-import { t as j } from "./api-X1dDTDvL.mjs";
-import "./packages-DuOz6rk6.mjs";
-export { t as CONFIGURATION_TYPE, e as CORE_PERMISSION_TO_DELETE, D as Configurator, m as ConfiguratorUiCallbacks, n as FloorPlanElementViewModel, A as GlbViewer, a as GlobalCallback, u as HI_CONTEXT_ACTION, h as IdbManager, b as Main, T as MeasurementLinePlanElementViewModel, v as PLAN_ELEMENT_CHANGE_TYPES, l as PlanElementViewModel, c as PlanObjectViewModel, O as Planner, S as RapiAccess, j as RoomDesignerApi, i as RoomleConfigurator, k as RoomleGLBViewer, _ as RoomleLightSource, C as RoomlePlanner, p as RoomlePlannerUiCallback, g as RoomleSdk, s as StaticPlanObjectViewModel, y as WallPlanElementViewModel, E as createExtObj, d as createExtObjId, x as getCatalogIdFromConfigurationHash, r as isExtObjId, f as isExternalObject, w as isSafari, o as removeExtObjIdPrefix };
+import { B as n, F as r, H as i, K as a, M as o, N as s, O as c, P as l, U as u, V as d, W as f, a as p, b as m, c as h, it as g, j as _, l as v, lt as y, n as b, ot as x, st as S, v as C, x as w, y as T, z as E } from "./main-CuqGqemT.mjs";
+import { t as D } from "./configurator-CP80d0HI.mjs";
+import { t as O } from "./planner-DKbmQVSf.mjs";
+import { n as k, t as A } from "./glb-viewer-B7pA8K_w.mjs";
+import { t as j } from "./api-CbHAzwVm.mjs";
+import "./packages-DALvuVA_.mjs";
+export { t as CONFIGURATION_TYPE, e as CORE_PERMISSION_TO_DELETE, D as Configurator, p as ConfiguratorUiCallbacks, _ as FloorPlanElementViewModel, A as GlbViewer, a as GlobalCallback, E as HI_CONTEXT_ACTION, x as IdbManager, b as Main, w as MeasurementLinePlanElementViewModel, C as PLAN_ELEMENT_CHANGE_TYPES, r as PlanElementViewModel, l as PlanObjectViewModel, O as Planner, g as RapiAccess, j as RoomDesignerApi, c as RoomleConfigurator, k as RoomleGLBViewer, y as RoomleLightSource, h as RoomlePlanner, T as RoomlePlannerUiCallback, v as RoomleSdk, s as StaticPlanObjectViewModel, o as WallPlanElementViewModel, n as createExtObj, f as createExtObjId, S as getCatalogIdFromConfigurationHash, d as isExtObjId, i as isExternalObject, m as isSafari, u as removeExtObjIdPrefix };