@roomle/web-sdk 2.94.0 → 2.95.1

package/lib/definitions/packages/common-core/src/utils/shims.d.ts

@@ -84,6 +84,11 @@ export interface FeatureFlags {
      * @description If true, the advanced docking behavior is enabled (for test purposes only)
      */
     advancedDocking?: boolean;
+    /**
+     * @internal
+     * @description If true, the sloping roof feature is enabled (for test purposes only)
+     */
+    slopingRoof?: boolean;
     /**
      * @internal
      * @description If “vector”, the vector preview is activated when drawing walls (for test purposes only).
@@ -227,6 +232,11 @@ export interface CommonInitData {
      *   - Free camera movement (no restrictions, camera stays after reload, panning using Shift key)
      */
     debug?: boolean;
+    /**
+     * @description This flag enables:
+     *   - External object docking vector debug geometry
+     */
+    debugGeometry?: boolean;
     /**
      * @description If set to true, prices are calculated using the Roomle price service.
      * For more information ask your Roomle contact.
@@ -281,6 +291,11 @@ export interface CommonInitData {
      * @groups scene-settings
      */
     customShading?: CustomShadingParameters;
+    /**
+     * @description Activates the linear AO filter mode to reduce AO anti-aliasing artifacts
+     * @groups scene-settings
+     */
+    linearAoFilter?: boolean;
     /**
      * @description Customized shading properties for the overall appearance in MOC
      * @groups scene-settings
@@ -303,7 +318,6 @@ export interface ConfiguratorInitData {
      */
     highlighting?: Enumify<typeof ROOMLE_HIGHLIGHTNG>;
     /**
-     * @deprecated
      * @description Set the floor material which is used when loading the configurator
      * For different options see {@link @roomle/web-sdk/configurator-core/src/environment/dynamic-environment-setting-loader#EnvironmentSetting}
      */

package/lib/definitions/packages/common-core/src/view-model/plan-element-view-model.d.ts

@@ -3,7 +3,7 @@ import type { PlanObject } from '../../../typings/planner';
 import { type RoomleEventedObject3D } from '../utils/threejs-utils';
 import { type RoomleEventedMesh } from '../utils/threejs-utils';
 import { Box3, Mesh, Object3D, Vector3 } from 'three';
-export declare const WALL_SELECTION_COLOR = 10526880;
+export declare const WALL_SELECTION_COLOR = 8421504;
 export default class PlanElementViewModel extends KernelViewModel {
     protected _container: Object3D;
     protected _boundingBox: RoomleEventedMesh;

package/lib/definitions/packages/common-core/src/webgl/renderer/scene-renderer.d.ts

@@ -62,6 +62,7 @@ export declare class SceneRenderer {
     debugOutput: string;
     outputColorSpace: string;
     toneMapping: string;
+    linearAoFilter: boolean;
     environmentLights: boolean;
     enableObjectSelection: boolean;
     groundLevel: number;
@@ -90,7 +91,7 @@ export declare class SceneRenderer {
     get shadowAndAoPass(): ShadowAndAoPass;
     get debugPass(): DebugPass;
     get shadowAndAoGroundPlane(): ShadowGroundPlane;
-    constructor(renderer: WebGLRenderer, width: number, height: number);
+    constructor(renderer: WebGLRenderer, width: number, height: number, linearAoFilter?: boolean);
     private _addEventListeners;
     dispose(): void;
     setSize(width: number, height: number): void;

package/lib/definitions/packages/common-core/src/webgl/roomle-webgl-renderer.d.ts

@@ -37,7 +37,7 @@ export declare class RoomleWebGLRenderer {
     get bakedGroundContactShadowParameters(): BakedGroundContactShadowParameters;
     get groundReflectionParameters(): GroundReflectionParameters;
     get outlineParameters(): OutlineParameters;
-    constructor(renderer: WebGLRenderer, width: number, height: number);
+    constructor(renderer: WebGLRenderer, width: number, height: number, linearAoFilter?: boolean);
     dispose(): void;
     setSize(width: number, height: number): void;
     setCameraType(cameraType: Enumify<typeof CAMERA_TYPE>): void;

package/lib/definitions/packages/configurator-core/src/roomle-configurator.d.ts

@@ -21,7 +21,9 @@ import type { GlobalCallback } from '../../common-core/src/services/global-callb
 import type RoomleToolsCore from '../../tools-core/src/roomle-tools-core';
 import type { Scene } from 'three';
 import type IdbManager from '../../common-core/src/services/idb-manager';
+import type { HomagIxArticleParams, HomagIxHeaderParams, HomagIxOrderParams } from './utils/imos-ix-poc-export-helper';
 import type { ConfiguratorDebugAPI } from './configurator-debug-api';
+import type { CancelSelectionReasons } from '../../typings/planner';
 interface ConfigurationLoadedResponse {
     partList: KernelPartList;
     errors: string[];
@@ -112,7 +114,10 @@ export default class RoomleConfigurator implements GlobalAPI, Context, KernelUti
     /**
      * Cancels the selection of all currently selected components
      */
-    cancelSelection(): void;
+    cancelSelection({ reason, resetCamera, }?: {
+        reason?: CancelSelectionReasons;
+        resetCamera?: boolean;
+    }): void;
     /**
      * Enable the use of HD geometry. Also reloads the object with HD geometry enabled
      */
@@ -670,7 +675,9 @@ export default class RoomleConfigurator implements GlobalAPI, Context, KernelUti
     generateProductionServiceExport(defaultExportDefinition?: string): Promise<any>;
     generateTCExport(defaultExportDefinition?: string): Promise<any>;
     generateIMOSiXExport(defaultExportDefinition?: string): Promise<any>;
-    generateExport(exportType: ExportType, defaultExportDefinition?: string): Promise<any>;
+    generateHOMAGiXExport(defaultExportDefinition?: string, homagIxOrderData?: HomagIxOrderParams, homagIxHeaderParams?: HomagIxHeaderParams, homagIxArticleParams?: HomagIxArticleParams): Promise<string>;
+    downloadHomagIxExportPoC(): Promise<any>;
+    generateHomagIxExport(exportType: ExportType, defaultExportDefinition?: string): Promise<any>;
     setEnvironmentMap(params: {
         url?: string;
         intensity?: number;

package/lib/definitions/packages/configurator-core/src/services/configurator-ui-callback.d.ts

@@ -7,6 +7,7 @@ import type { ConfiguratorKernelContainer } from '../../../typings/configurator-
 import type { PlannerKernelContainer } from '../../../typings/planner-kernel-container';
 import type { RoomleComponent } from '../../../common-core/src/webgl/roomle-component-factory';
 import type { ConfiguratorDebugCallbacks } from '../configurator-debug-api';
+import type { CancelSelectionReasons } from '../../../typings/planner';
 export type ComponentAction = 'edit' | 'add';
 export type ComponentType = 'preview' | 'component';
 export interface UIComponentInfo {
@@ -60,7 +61,7 @@ export default class ConfiguratorUiCallbacks extends UiCallback implements Confi
     /**
      * When a component or item selection has been canceled
      */
-    onSelectionCancel: () => void;
+    onSelectionCancel: (reason: CancelSelectionReasons) => void;
     /**
      * When part list has been changed/updated, this event is triggered
      * on start up and when a configuration changes

package/lib/definitions/packages/configurator-core/src/utils/imos-ix-poc-export-helper.d.ts

@@ -0,0 +1,43 @@
+import { type ConfigurationExporter, type ConfiguratorKernelClass, ExportType } from '../../../typings/kernel';
+import type { PlanOverview } from '../../../typings/planner';
+export interface HomagIxOrderParams {
+    orderNumber?: string;
+    dispatchDate?: string;
+    basketNumber?: string;
+}
+export interface HomagIxHeaderParams {
+    comm?: string;
+    articleno?: string;
+    customer?: string;
+    retailer?: string;
+    client?: string;
+    program?: string;
+    employee?: string;
+    textLong?: string;
+    textShort?: string;
+    colour?: string[];
+    info?: string[];
+    address?: string[];
+    billingAddress?: string[];
+    shippingAddress?: string[];
+    orderPriceInfo?: string[];
+    customInfo?: string[];
+}
+export interface HomagIxArticleParams {
+    articleTextInfo1?: string;
+    articleTextInfo2?: string;
+    articlePriceInfo1?: string;
+    articlePriceInfo2?: string;
+    articlePriceInfo3?: string;
+    deliveryPeriod?: string;
+    supplier?: string;
+    discount?: number;
+    discountAbs?: number;
+}
+export declare const createHomagIxXml: (orderData: HomagIxOrderParams, headerData: HomagIxHeaderParams, articleShopData: HomagIxArticleParams, articleCoreData: any) => string;
+export declare const getFakeOrderParams: () => HomagIxOrderParams;
+export declare const getFakeHeaderParams: () => HomagIxHeaderParams;
+export declare const getFakeArticleParams: () => HomagIxArticleParams;
+export declare const downloadHomagIxExportPoC: (planOverview: PlanOverview, exporter: ConfigurationExporter, kernelInstance: ConfiguratorKernelClass) => Promise<void>;
+export declare const generateExportHomagIxConfiguration: (planObjectId: number, exportType: ExportType, exporter: ConfigurationExporter, kernelInstance: ConfiguratorKernelClass, defaultExportDefinition?: string) => Promise<any>;
+export declare const homagIxMockUpData: (articles: any[], homagIxOrderData?: {}, homagIxHeaderParams?: {}, homagIxArticleParams?: {}) => string;

package/lib/definitions/packages/configurator-core/src/utils/selection-handler.d.ts

@@ -1,4 +1,5 @@
 import type { RoomleComponent } from '../../../common-core/src/webgl/roomle-component-factory';
+import type { CancelSelectionReasons } from '../../../typings/planner';
 import EventDispatcher from './event-dispatcher';
 export declare const enum SELECTION_MODE {
     STANDARD = "standard",
@@ -12,17 +13,19 @@ export declare class SelectionHandlerEvent {
     component: RoomleComponent;
     resetCamera: boolean;
     consecutive: boolean;
+    reason: CancelSelectionReasons;
     constructor(data: {
         component?: RoomleComponent;
         resetCamera?: boolean;
         consecutive?: boolean;
+        reason?: CancelSelectionReasons;
     });
 }
 export default class SelectionHandler extends EventDispatcher<SelectionHandlerEvent> {
     private _selectionMode;
     protected _selectedComponents: Map<number, RoomleComponent>;
     check(component: RoomleComponent): void;
-    cancelSelection(): void;
+    cancelSelection(reason: CancelSelectionReasons): boolean;
     private _checkStandard;
     private _checkMulti;
     setSelectionMode(mode: SELECTION_MODE): void;

package/lib/definitions/packages/configurator-core/src/webgl/configurator-scene-event-handler.d.ts

@@ -8,6 +8,7 @@ import type { Object3D, PerspectiveCamera, Scene } from 'three';
 import { type Vector3 } from 'three';
 import { type Camera } from 'three';
 import { type Enumify } from '../../../common-core/src/types';
+import type { CancelSelectionReasons } from '../../../typings/planner';
 export declare const enum SCENE_EVENT {
     INTERACTION = 0,
     HOVER_ON = 1,
@@ -27,6 +28,7 @@ export declare class SceneEventInfo {
     consecutive: boolean;
     type: INPUT_EVENT_TYPE;
     forceRender: boolean;
+    reason: CancelSelectionReasons;
     constructor(data: {
         component?: RoomleComponent;
         preview?: PreviewComponent;
@@ -34,6 +36,7 @@ export declare class SceneEventInfo {
         consecutive?: boolean;
         type?: INPUT_EVENT_TYPE;
         forceRender?: boolean;
+        reason?: CancelSelectionReasons;
     });
 }
 export interface ComponentEventInfo {
@@ -63,7 +66,7 @@ export default class ConfiguratorSceneEventHandler extends SceneEventHandler<Sce
     addPreviewLineHandlers(component: PreviewLineComponent): void;
     private _clickPreview;
     private _clickPreviewLine;
-    clickComponent(component: RoomleComponent): void;
+    clickComponent(component: RoomleComponent, triggerClickCallback?: boolean): void;
     private _clickOutside;
     private _hoverOn;
     private _hoverOff;
@@ -83,7 +86,7 @@ export default class ConfiguratorSceneEventHandler extends SceneEventHandler<Sce
     isDragIn(): boolean;
     isDragging(): boolean;
     setRootComponentId(rootComponentId: number): void;
-    cancelSelection(): void;
+    cancelSelection(reason: CancelSelectionReasons): boolean;
     setSelectionMode(mode: SELECTION_MODE): void;
     getSelectionMode(): SELECTION_MODE;
     getSelectedRuntimeComponentIds(): number[];

package/lib/definitions/packages/configurator-core/src/webgl/configurator-scene-manager.d.ts

@@ -58,6 +58,7 @@ export default class ConfiguratorSceneManager extends SceneManager implements Co
     protected shouldClearShadowsAndAO(): boolean;
     resume(): void;
     private _materialLoaded;
+    waitForMaterialQueue(): Promise<void>;
     pause(): void;
     protected _setupScene(offset?: CanvasOffset, transparent?: boolean, skipLightSetup?: boolean): void;
     sceneCleared(shouldHardReset: boolean): void;
@@ -98,7 +99,7 @@ export default class ConfiguratorSceneManager extends SceneManager implements Co
     protected enablePanning(): void;
     protected disablePanning(): void;
     cancelPreviousDockings(): void;
-    cancelComponentSelection(resetCamera?: boolean): void;
+    cancelComponentSelection(resetCamera?: boolean, reason?: CancelSelectionReasons): void;
     protected notifyPlannerOnComponentSelectionCancel(_isExternalObject: boolean, _reason: CancelSelectionReasons): void;
     private _cancelSelection;
     private _selectComponent;
@@ -133,7 +134,7 @@ export default class ConfiguratorSceneManager extends SceneManager implements Co
     protected _updateBounds(box: Box3, geometryBox?: Box3, geometryChanged?: boolean): void;
     moveCamera(cameraParameter: CameraParameter): Promise<void>;
     getSelectedRuntimeComponentIds(): number[];
-    selectComponent(runtimeId: number): void;
+    selectComponent(runtimeId: number, triggerClickCallback?: boolean): void;
     highlightParts(ids: number[]): void;
     private _shouldHighlightComponent;
     saveConfigToIdb(): void;

package/lib/definitions/packages/planner-core/src/camera-control/camera-control-first-person.d.ts

@@ -14,6 +14,7 @@ export default class CameraControlFirstPerson extends CameraControl {
     minPolarAngle: number;
     maxPolarAngle: number;
     constructor(creator: string, inputManager: InputManager, initialCameraParameters?: CameraParameter, camera?: PerspectiveCamera);
+    setUp(): void;
     private _gamepadConnected;
     private _gamepadDisconnected;
     private startButtonPressListener;

package/lib/definitions/packages/planner-core/src/external-object-api-callbacks.d.ts

@@ -1,23 +1,30 @@
 import type { CancelSelectionReasons } from '../../typings/planner';
-export interface ExternalObjectGroupPosition {
-    pos: number[];
-    rotation?: number;
+export interface ExternalObjectSegment {
+    cmd: string;
+    x: number;
+    y: number;
+    type: string;
 }
-export interface ExternalObjectGroup {
-    groupId: string;
+export interface ExternalObjectContour {
+    level: number;
+    segments: ExternalObjectSegment[];
+}
+export interface ExternalObjectGroupPosition {
     pos: number[];
     rotation?: number;
+    contours?: ExternalObjectContour[];
 }
 export interface ExternalObjectRootModule {
     moduleId: string;
     pos: number[];
     rotation?: number;
 }
-export interface ExternalObjectGroupAndModules {
+export interface ExternalObjectGroup {
     groupId?: string;
     pos: number[];
     rotation?: number;
-    rootModules: ExternalObjectRootModule[];
+    rootModules?: ExternalObjectRootModule[];
+    contours?: ExternalObjectContour[];
 }
 export interface ExternalObjectUiCallback {
     /** "onMergeExternalObjectGroup" is invoked when a group of root modules is merged into another group of root modules.
@@ -27,8 +34,9 @@ export interface ExternalObjectUiCallback {
      * "idsOfGroupsMerged" are the IDs of the groups whose modules must be merged into the target group and therefore the groups that must be deleted.
      * @param targetGroup The target group of root modules.
      * @param idsOfGroupsMerged The IDs of the groups merged into the target group.
+     * @param idOfTargetRootModule The ID of the root module which is the target of the merge operation.
      */
-    onMergeExternalObjectGroup(targetGroup: ExternalObjectGroupAndModules, idsOfGroupsMerged: string | string[]): void;
+    onMergeExternalObjectGroup(targetGroup: ExternalObjectGroup, idsOfGroupsMerged: string | string[], idOfTargetRootModule: string): void;
     /**
      * "onSplitExternalObjectGroup" is invoked when one or more root modules are split from a group of root modules.
      * The split root modules form a new group, which must be assigned a new ID.
@@ -37,13 +45,13 @@ export interface ExternalObjectUiCallback {
      * @param splitGroup The original group of root modules.
      * @param newGroupedRootModules The new group of root modules.
      */
-    onSplitExternalObjectGroup(splitGroup: ExternalObjectGroupAndModules, newGroupedRootModules: ExternalObjectGroupAndModules | ExternalObjectGroupAndModules[]): void;
+    onSplitExternalObjectGroup(splitGroup: ExternalObjectGroup, newGroupedRootModules: ExternalObjectGroup | ExternalObjectGroup[]): void;
     /**
      * "onExternalObjectGroupArrangementChanged" is invoked when the arrangement (position and rotation) of the root modules of a group has changed .
      * "changedGroup" contains the information about the root modules of the group.
      * @param changedGroup The new arranged group and its root modules .
      */
-    onExternalObjectGroupArrangementChanged(changedGroup: ExternalObjectGroupAndModules): void;
+    onExternalObjectGroupArrangementChanged(changedGroup: ExternalObjectGroup): void;
     /**
      * "onDeleteExternalObjectGroup" is invoked when a group of root modules and all the root modules it contains are deleted.
      * The group with the ID "groupIdToDelete" is removed from the plan and is completely deleted.
@@ -62,7 +70,7 @@ export interface ExternalObjectUiCallback {
      * @param rootModuleIdToDelete The ID of the root module.
      * @param splitGroups The new groups of root modules that have been split off.
      */
-    onDeleteExternalObjectRootModule(remainingGroup: ExternalObjectGroupAndModules, rootModuleIdToDelete: string, splitOffGroups?: ExternalObjectGroupAndModules[]): void;
+    onDeleteExternalObjectRootModule(remainingGroup: ExternalObjectGroup, rootModuleIdToDelete: string, splitOffGroups?: ExternalObjectGroup[]): void;
     /**
      * "onDeleteExternalObjectSubModule" is invoked when a sub module is deleted from a root module.
      * The sub module with the ID "subModuleIdToDelete" is removed from the root module with the ID "rootModuleId"
@@ -81,10 +89,16 @@ export interface ExternalObjectUiCallback {
      */
     onDuplicateExternalObjectGroup(sourceGroupId: string, newGroupPosition: ExternalObjectGroupPosition): void;
     /**
-     * “onMovedExternalObjectGroup” is invoked when a group of root modules is moved or rotated to a new position.
+     * “onChangedExternalObjectGroupPlan” is invoked when a group of root modules is moved or rotated to a new position
+     * or when the plan itself is changed.
      * The group with the ID "group.id" is moved to the new position and orientation defined in "group".
      * @param group The group of root modules.
      */
+    onChangedExternalObjectGroupPlan(group: ExternalObjectGroup): void;
+    /**
+     * @deprecated and replaced by “onChangedExternalObjectGroupPlan”.
+     * @param group The group of root modules.
+     */
     onMovedExternalObjectGroup(group: ExternalObjectGroup): void;
     /**
      * "onExternalObjectEnvironmentChanged" is invoked when the plan (walls, doors, windows, etc.) has changed.

package/lib/definitions/packages/planner-core/src/external-object-api.d.ts

@@ -1,4 +1,5 @@
 export interface ExternalObjectUiConfiguration {
+    userRight?: string;
     attributeGroupsVisibleInPlanner?: string | string[];
     showPossibleSubModules?: boolean;
     animatedOpenClose?: boolean;
@@ -45,20 +46,22 @@ export interface ExternalObjectAPI {
      * @param groupJson The group JSON as string or object.
      * @param findFreeSpaceInPlan A free space is automatically searched for in the plane.
      * @param verifyArrangement Verify whether the root modules of the group need to be rearranged as they have changed in size.
+     * @param mergedGroups Groups that were merged into another group and have to be delete (this is required to generate correct undo/redo steps).
      */
-    loadExternalObjectGroup(groupJson: string | object, findFreeSpaceInPlan: boolean, verifyArrangement?: boolean): Promise<void>;
+    loadExternalObjectGroup(groupJson: object | string | string[], findFreeSpaceInPlan: boolean, verifyArrangement?: boolean, mergedGroups?: string[]): Promise<void>;
     /**
      * "renderImagesOfExternalObjectGroups" renders images of groups of modules.
      * @param groupJson The group JSON as string or object.
      */
-    renderImagesOfExternalObjectGroup(groupsJson: string | object): Promise<{
+    renderImagesOfExternalObjectGroup(groupsJson: object): Promise<{
         [key: string]: string;
     }>;
     /**
      * "removeExternalObjectGroup" removes a group and all its modules from the plan.
      * @param groupId The ID of the group of modules.
+     * @param wasMerged Should be set to true if the group has been merged with another group (this is required to generate correct undo/redo steps).
      */
-    removeExternalObjectGroup(groupId: string): Promise<void>;
+    removeExternalObjectGroup(groupId: string, wasMerged: boolean): Promise<void>;
     /**
      * "removeExternalObjectRootModule" removes a root module from a group and splits the remaining group if the removed root module is located between other root modules.
      * If the group consists of only one root module, the group is removed.
@@ -95,5 +98,9 @@ export interface ExternalObjectAPI {
      * @param animate If true the opening or closing is animated else the geometry is switched instantly.
      */
     openOrCloseGeometryOfExternalObject(groupIdOrRootModuleId: string, subModuleId: string | null, open: boolean, animate: boolean): Promise<void>;
+    /**
+     * "getExternalObjectGroups" returns all groups of external objects modules (PosData) that are currently loaded in the plan.
+     */
+    getExternalObjectGroups(): Promise<object[]>;
 }
 export declare const getDefaultExternalObjectApiConfiguration: () => Promise<ExternalObjectApiConfiguration>;

package/lib/definitions/packages/planner-core/src/roomle-planner-ui-callback.d.ts

@@ -14,7 +14,7 @@ import type { MeasurementLineDimension, MeasurementLineDimensionTransferable } f
 import type { ConstructionMeasurementsTransferable } from './utils/measurements';
 import type { FloorAreaDataTransferable } from './view-model/floor-plan-element-view-model';
 import { type BASE_CONTEXT } from '../../common-core/src/main';
-import type { ExternalObjectGroup, ExternalObjectGroupAndModules, ExternalObjectGroupPosition, ExternalObjectUiCallback } from './external-object-api-callbacks';
+import type { ExternalObjectGroup, ExternalObjectGroupPosition, ExternalObjectUiCallback } from './external-object-api-callbacks';
 export interface SelectionPayload {
     item?: RapiItem;
     configuration?: RapiConfiguration;
@@ -24,6 +24,7 @@ export interface SelectionPayload {
     wall?: WallDimension;
     measurementLine?: MeasurementLineDimension;
     staticItemRuntimeId?: number;
+    externalConfigurationType?: string;
 }
 export declare const PLAN_ELEMENT_CHANGE_TYPES: {
     readonly ADDED: "added";
@@ -179,15 +180,15 @@ export default class RoomlePlannerUiCallback extends UiCallback implements Exter
     /**
      * documented in interface ExternalObjectUiCallback
      */
-    onMergeExternalObjectGroup: (targetGroup: ExternalObjectGroupAndModules, idsOfGroupsMerged: string | string[]) => void;
+    onMergeExternalObjectGroup: (targetGroup: ExternalObjectGroup, idsOfGroupsMerged: string | string[], idOfTargetRootModule: string) => void;
     /**
      * documented in interface ExternalObjectUiCallback
      */
-    onSplitExternalObjectGroup: (originalGroup: ExternalObjectGroupAndModules, newGroupedRootModules: ExternalObjectGroupAndModules | ExternalObjectGroupAndModules[]) => void;
+    onSplitExternalObjectGroup: (originalGroup: ExternalObjectGroup, newGroupedRootModules: ExternalObjectGroup | ExternalObjectGroup[]) => void;
     /**
      * documented in interface ExternalObjectUiCallback
      */
-    onExternalObjectGroupArrangementChanged: (changedGroup: ExternalObjectGroupAndModules) => void;
+    onExternalObjectGroupArrangementChanged: (changedGroup: ExternalObjectGroup) => void;
     /**
      * documented in interface ExternalObjectUiCallback
      */
@@ -195,7 +196,7 @@ export default class RoomlePlannerUiCallback extends UiCallback implements Exter
     /**
      * documented in interface ExternalObjectUiCallback
      */
-    onDeleteExternalObjectRootModule: (_remainingGroup: ExternalObjectGroupAndModules, _rootModuleIdToDelete: string, _splitOffGroups?: ExternalObjectGroupAndModules[]) => void;
+    onDeleteExternalObjectRootModule: (_remainingGroup: ExternalObjectGroup, _rootModuleIdToDelete: string, _splitOffGroups?: ExternalObjectGroup[]) => void;
     /**
      * documented in interface ExternalObjectUiCallback
      */
@@ -204,6 +205,10 @@ export default class RoomlePlannerUiCallback extends UiCallback implements Exter
      * documented in interface ExternalObjectUiCallback
      */
     onDuplicateExternalObjectGroup: (sourceGroupId: string, newGroupPosition: ExternalObjectGroupPosition) => void;
+    /**
+     * documented in interface ExternalObjectUiCallback
+     */
+    onChangedExternalObjectGroupPlan: (group: ExternalObjectGroup) => void;
     /**
      * documented in interface ExternalObjectUiCallback
      */

package/lib/definitions/packages/planner-core/src/roomle-planner.d.ts

@@ -6,7 +6,7 @@ import type { Configurator } from '../../configurator-core/src/configurator';
 import type { GlobalInitDataDefinition, InitDataDefinition } from '../../common-core/src/utils/shims';
 import type { ConfigurationString, RapiConfiguration, RapiId, RapiItem, RapiPlan, RapiPlanSnapshotGetData } from '../../typings/rapi-types';
 import type { Context } from '../../common-core/src/di/context';
-import type { CancelSelectionReasons, KernelObject, KernelWall, PlanInteractionHandler, PlanModelViewHelper, PlanOverview } from '../../typings/planner';
+import { type CancelSelectionReasons, type KernelObject, type KernelWall, type PlanInteractionHandler, type PlanModelViewHelper, type PlanOverview } from '../../typings/planner';
 import type { KernelAccessCallbackI } from '../../common-core/src/kernel-access-callback';
 import type InitData from '../../common-core/src/utils/init-data';
 import type { CanvasOffset, Position3 } from '../../common-core/src/common-interfaces';
@@ -20,7 +20,7 @@ import type { CameraParameter } from '../../common-core/src/cameracontrol/camera
 import type PlanElementViewModel from '../../common-core/src/view-model/plan-element-view-model';
 import type WallPlanElementViewModel from './view-model/wall-plan-element-view-model';
 import type ConfiguratorContext from '../../common-core/src/webgl/configurator-context';
-import type { PlanObject } from '../../typings/planner';
+import type { KernelAttic, PlanObject, WallSide } from '../../typings/planner';
 import type IdbManager from '../../common-core/src/services/idb-manager';
 import type { ExternalObjectAPI, ExternalObjectApiConfiguration } from './external-object-api';
 import type { GlobalCallback } from '../../common-core/src/services/global-callback';
@@ -28,7 +28,7 @@ export type ID_TYPE = 'rml_id' | 'tc_id' | 'rml_serialized' | 'tc_serialized';
 export interface RoomlePlannerCallback {
     switchToConfigurator: () => Promise<Configurator>;
     switchToViewer: () => Promise<GlbViewer>;
-    cancelSelection: () => void;
+    cancelSelection: (reason: CancelSelectionReasons) => void;
     deleteSelection: () => void;
     rotateSelection: (rotateBy: number) => void;
 }
@@ -158,6 +158,11 @@ export default class RoomlePlanner implements KernelAccessCallbackI, RoomlePlann
     update(): void;
     get callbacks(): RoomlePlannerUiCallback;
     set callbacks(callback: RoomlePlannerUiCallback);
+    /**
+     * Check if the 3D scene contains only one room
+     * @returns {boolean} True if there is only one room, false otherwise
+     */
+    get hasSingleRoom(): boolean;
     showStats(): void;
     onCloseHSC(): void;
     back(): void;
@@ -376,14 +381,19 @@ export default class RoomlePlanner implements KernelAccessCallbackI, RoomlePlann
     resolveShortUrl(shortUrl: string): Promise<string>;
     enableEvents(): void;
     disableEvents(): void;
+    downloadHomagIxExportPoC(): Promise<any>;
     configureExternalObjectApi(configurationJson: string | ExternalObjectApiConfiguration): Promise<void>;
     loadExternalObjectLibrary(libraryJson: string | object): void;
-    loadExternalObjectGroup(groupJson: string | object, findFreeSpaceInPlan: boolean, verifyArrangement?: boolean): Promise<void>;
+    loadExternalObjectGroup(groupData: object | string | string[], findFreeSpaceInPlan: boolean, verifyArrangement?: boolean, mergedGroups?: string[]): Promise<void>;
     private _loadExternalObjectGroup;
-    renderImagesOfExternalObjectGroup(groupsJson: string | object): Promise<{
+    private _loadExternalObjectGroupInConfigurator;
+    private _loadExternalObjectGroupInPlanner;
+    private _loadOrUpdateExternalObjectGroup;
+    private _createSerializedGroupCollection;
+    renderImagesOfExternalObjectGroup(groups: object): Promise<{
         [key: string]: string;
     }>;
-    removeExternalObjectGroup(groupId: string): Promise<void>;
+    removeExternalObjectGroup(groupId: string, wasMerged?: boolean): Promise<void>;
     removeExternalObjectRootModule(rootModuleId: string): void;
     selectExternalObjectGroup(groupId: string): Promise<void>;
     selectExternalObjectRootModule(rootModuleId: string): Promise<void>;
@@ -391,10 +401,56 @@ export default class RoomlePlanner implements KernelAccessCallbackI, RoomlePlann
     openOrCloseGeometryOfExternalObject(groupIdOrRootModuleId: string, subModuleId: string | null, open: boolean, animate: boolean): Promise<void>;
     private _selectKernelComponent;
     _selectExternalObjectGroup(groupId: string, switchToPlanner: boolean): Promise<void>;
-    _selectExternalObjectModule(rootModuleId: string, subModuleId: string | null, selectPlanObject: boolean, switchToConfigurator: boolean, selectComponent: boolean): Promise<void>;
+    _selectExternalObjectModule(rootModuleId: string, subModuleId: string | null, selectPlanObject: boolean, switchToConfigurator: boolean, selectComponent: boolean, highlightSelection: boolean): Promise<void>;
+    private _selectPlanObject;
+    private _getSelectedPlanObjectComponent;
+    getExternalObjectGroups(): Promise<object[]>;
     /**
      * @internal
      * Use this callbacks to hook in your functionality
      */
     get globalCallbacks(): GlobalCallback;
+    /**
+     * Handles interaction with the planner kernel, ensuring start and end interaction are tracked.
+     * @param action A function representing the action to perform.
+     * @returns The result of the action, if any.
+     */
+    private _executeWithInteraction;
+    /**
+     * Creates a sloping roof attic on a given wall.
+     * @param wall The wall to add an attic to.
+     * @param kneeHeight Height of the attic knee wall.
+     * @param width Width of the sloping roof.
+     * @param preferredSide The side where the attic should be added.
+     * @returns The newly created attic.
+     */
+    addAtticToWall(wall: KernelWall, kneeHeight: number, width: number, preferredSide?: WallSide): KernelAttic | null;
+    /**
+     * Removes an attic from a wall.
+     * @param attic The attic to be removed.
+     */
+    removeAttic(attic: KernelAttic): void;
+    /**
+     * Set the attic direction from a wall.
+     * @param attic The attic to be removed.
+     */
+    setAtticSide(attic: KernelAttic, side: WallSide): void;
+    /**
+     * Gets the attached attic from a wall.
+     * @param wall The wall to retrieve the attic from.
+     * @returns The first attached attic or null.
+     */
+    getAttachedAttic(wall: KernelWall): KernelAttic | null;
+    /**
+     * Updates the knee height of an attic.
+     * @param attic The attic to update.
+     * @param kneeHeight The new knee height value.
+     */
+    updateAtticKneeHeight(attic: KernelAttic, kneeHeight: number): void;
+    /**
+     * Updates the width of an attic.
+     * @param attic The attic to update.
+     * @param width The new width value.
+     */
+    updateAtticWidth(attic: KernelAttic, width: number): void;
 }

package/lib/definitions/packages/planner-core/src/services/planner-kernel-access.d.ts

@@ -6,7 +6,7 @@ import type RoomlePlannerUiCallback from '../roomle-planner-ui-callback';
 import type PlanElementViewModel from '../../../common-core/src/view-model/plan-element-view-model';
 import type { Position3 } from '../../../common-core/src/common-interfaces';
 import ConfiguratorKernelAccess from '../../../common-core/src/configurator-kernel-access';
-import type { ExternalObjectGroup, ExternalObjectGroupAndModules, ExternalObjectGroupPosition } from '../external-object-api-callbacks';
+import type { ExternalObjectGroup, ExternalObjectGroupPosition } from '../external-object-api-callbacks';
 export interface PlannerKernelCallbackI {
     handlerSwitchedPlans(fromPlan: Plan, toPlan: Plan): void;
     planCompletelyLoaded(plan: Plan): void;
@@ -67,12 +67,12 @@ export default class PlannerKernelAccess extends ConfiguratorKernelAccess {
     externalObjectConfigurationChanged(plan: Plan, planObject: PlanObject, configuration: string): void;
     externalObjectConfigurationLoaded(plan: Plan, planObject: PlanObject, configuration: string): void;
     externalObjectConfigurationDeleted(plan: Plan, planObject: PlanObject, uniqueId: string): void;
-    externalObjectComponentDeleted(plan: Plan, planObject: PlanObject, remainingGroupOrGroups: ExternalObjectGroupAndModules | ExternalObjectGroupAndModules[], deletedRootModuleId: string): void;
+    externalObjectComponentDeleted(plan: Plan, planObject: PlanObject, remainingGroupOrGroups: ExternalObjectGroup | ExternalObjectGroup[], deletedRootModuleId: string): void;
     externalObjectConfigurationDuplicated(plan: Plan, planObject: PlanObject, sourceGroupId: string, newGroupPosition: ExternalObjectGroupPosition): void;
-    externalObjectConfigurationMoved(plan: Plan, planObject: PlanObject, movedGroup: ExternalObjectGroup): void;
-    externalObjectConfigurationsMerged(plan: Plan, planObject: PlanObject, mergedGroup: ExternalObjectGroupAndModules, sourceGroupId: string): void;
-    externalObjectComponentSplitOff(plan: Plan, planObject: PlanObject, splitGroups: ExternalObjectGroupAndModules[]): void;
-    externalObjectArrangementChanged(plan: Plan, planObject: PlanObject, changedGroup: ExternalObjectGroupAndModules): void;
+    externalObjectPlanChanged(plan: Plan, planObject: PlanObject, movedGroup: ExternalObjectGroup): void;
+    externalObjectConfigurationsMerged(plan: Plan, planObject: PlanObject, mergedGroup: ExternalObjectGroup, idsOfGroupsMerged: string | string[], targetRootModuleId: string): void;
+    externalObjectComponentSplitOff(plan: Plan, planObject: PlanObject, splitGroups: ExternalObjectGroup[]): void;
+    externalObjectArrangementChanged(plan: Plan, planObject: PlanObject, changedGroup: ExternalObjectGroup): void;
     planObjectConfigurationLoaded(plan: Plan, element: PlanElement, success: boolean): Promise<void>;
     requestCatalogItem(catalogItemId: string): void;
     startedDrawing(): void;
@@ -95,12 +95,12 @@ export default class PlannerKernelAccess extends ConfiguratorKernelAccess {
     protected _externalObjectConfigurationChanged(objectId: number, configuration: string): void;
     protected _externalObjectConfigurationLoaded(objectId: number, configuration: string): void;
     protected _externalObjectConfigurationDeleted(groupId: string): void;
-    protected _externalObjectComponentDeleted(remainingGroupOrGroups: ExternalObjectGroupAndModules | ExternalObjectGroupAndModules[], deletedRootModuleId: string): void;
+    protected _externalObjectComponentDeleted(remainingGroupOrGroups: ExternalObjectGroup | ExternalObjectGroup[], deletedRootModuleId: string): void;
     _externalObjectConfigurationDuplicated(sourceGroupId: string, newGroupPosition: ExternalObjectGroupPosition): void;
-    _externalObjectConfigurationsMoved(movedGroup: ExternalObjectGroup): void;
-    _externalObjectConfigurationsMerged(mergedGroup: ExternalObjectGroupAndModules, sourceGroupId: string): void;
-    _externalObjectComponentSplitOff(splitGroups: ExternalObjectGroupAndModules[]): void;
-    _externalObjectArrangementChanged(changedGroup: ExternalObjectGroupAndModules): void;
+    _externalObjectPlanChanged(movedGroup: ExternalObjectGroup): void;
+    _externalObjectConfigurationsMerged(mergedGroup: ExternalObjectGroup, idsOfGroupsMerged: string | string[], targetRootModuleId: string): void;
+    _externalObjectComponentSplitOff(splitGroups: ExternalObjectGroup[]): void;
+    _externalObjectArrangementChanged(changedGroup: ExternalObjectGroup): void;
     planSnapshotCreated(planSnapshot: RapiPlanSnapshotPostData): void;
     requestDeleteComponents(componentIds: number[]): void;
     requestDeleteComponent(componentId: number): void;