@roomle/embedding-lib 5.30.1 → 5.31.0-alpha.1

package/docs/md/web/embedding/CHANGELOG.md

@@ -1,6 +1,48 @@
-## [5.30.1](https://github.com/roomle-dev/roomle-ui/compare/embedding-lib-v5.30.0...embedding-lib-v5.30.1) (2025-10-22)
+## [5.31.0-alpha.1](https://github.com/roomle-dev/roomle-ui/compare/embedding-lib-v5.30.1...embedding-lib-v5.31.0-alpha.1) (2025-10-23)
+
+
+### Features
+
+* core api - isChildObjectRootComponent ([027e033](https://github.com/roomle-dev/roomle-ui/commit/027e0335af12b5c59a0c42a9403ed94ed3589291))
+* core api - plan object children ([33259e1](https://github.com/roomle-dev/roomle-ui/commit/33259e158b40cb0136d5a60a9a41f992666420e5))
+* core api - setObjectCustomColor ([70ce529](https://github.com/roomle-dev/roomle-ui/commit/70ce52925dc36824beb895b16cf686c5e93496c5))
+* custom color picker on static items ([1942a7d](https://github.com/roomle-dev/roomle-ui/commit/1942a7d15af8f8d6af3bf9b786c05da4737faefa))
+* do not allow dragging of modules in configurator ([adcd12a](https://github.com/roomle-dev/roomle-ui/commit/adcd12a44bd2d50018e05bedc1bf4b848e15b380))
+* hi example - article image ([996dca9](https://github.com/roomle-dev/roomle-ui/commit/996dca93850096c5560a24a8ec94dc5326a267d3))
+* homag intelligence example - debug ui ([47d635d](https://github.com/roomle-dev/roomle-ui/commit/47d635d55347bcb2da57f3672597db7cc086cd7d))
+* Implement html measurements for "normal" measurements ([60bccbb](https://github.com/roomle-dev/roomle-ui/commit/60bccbbe940cd1c03f434e22895d8ce7edaf84d1))
+* initial light working ([a8ed3eb](https://github.com/roomle-dev/roomle-ui/commit/a8ed3ebdf9ad5b9c2f5ea8f216cbb7a78b1f694c))
+* lock camera state when switching object in configurator ([ce4bd0c](https://github.com/roomle-dev/roomle-ui/commit/ce4bd0ce3f2acc19f06ff933a9d511508dfa6a34))
+* module selection logic in isolation mode ([b6736e1](https://github.com/roomle-dev/roomle-ui/commit/b6736e1e7bd846c5aa82a8435608e3756390f2ab))
+* save configuration on planObjectConfigurationChanged ([0a4a57e](https://github.com/roomle-dev/roomle-ui/commit/0a4a57e87db6759039f64373873a4fb4990f8b5c))
+* select the component of the child object on start configuring ([c7b7ed6](https://github.com/roomle-dev/roomle-ui/commit/c7b7ed656a538617efd0dee6de0c617518774aba))
+* setting maximum lights based on max anisotrophy ([f0aa240](https://github.com/roomle-dev/roomle-ui/commit/f0aa240c0bebe9ef11138a78bde9f993e262d2f5))
+* **core:** upgrade to version 2.63.0-alpha.1 ([f2301cc](https://github.com/roomle-dev/roomle-ui/commit/f2301cc82ea02d5d83da0df183a1b6a04c641123))
+* **core:** upgrade to version 2.63.0-alpha.2 ([eae6240](https://github.com/roomle-dev/roomle-ui/commit/eae62407b3116734a17271d3a687cf556326ede6))
+* **core:** upgrade to version 2.63.0-alpha.3 ([45ff1eb](https://github.com/roomle-dev/roomle-ui/commit/45ff1eb7067807299d93df40bd10d8fead846b3b))
+* **core:** upgrade to version 2.63.0-alpha.4 ([fc48712](https://github.com/roomle-dev/roomle-ui/commit/fc48712bd5de99b90197ba7cd91ee07b71f46079))
+* web api - disableChildObjectsOfAllPlanObjects ([b4a006b](https://github.com/roomle-dev/roomle-ui/commit/b4a006bbed50927869342a0c0d7348573d9dd1e9))
 
 
 ### Bug Fixes
 
-* loading of multiple catalogs via init data url ([a8e816e](https://github.com/roomle-dev/roomle-ui/commit/a8e816eb2373830e750cc0f5c878bdb7c062c45d))
+* add a copy of the generated root modules to the split-off group for attribute transfer ([88e21b2](https://github.com/roomle-dev/roomle-ui/commit/88e21b2090109c8af157030dcc822ea2153863db))
+* check if added or removed plan elements are children of plan object ([75cec14](https://github.com/roomle-dev/roomle-ui/commit/75cec14ee29bb8d3fa7f5038514a5593284d40e1))
+* create a single undo/redo step for "swap" object ([52bb02d](https://github.com/roomle-dev/roomle-ui/commit/52bb02d98ae1da1440345fad6bdfd14a72933522))
+* exception - calculateTotalSum ([7a84c34](https://github.com/roomle-dev/roomle-ui/commit/7a84c349915ea7bcc71470024f901eb0c3deaec4))
+* exception when executing object animation in standalone configurator ([f72c382](https://github.com/roomle-dev/roomle-ui/commit/f72c38233e830890e243da7b4be74c9573d2ba70))
+* failing playwright test case ([700a286](https://github.com/roomle-dev/roomle-ui/commit/700a2867b3a8646ce96a12717cd09c1a0fcbee63))
+* failing sdk test ([d148883](https://github.com/roomle-dev/roomle-ui/commit/d148883d15dae4b80d4c3767ef0c4578366f32ab))
+* glue-layer attribute value assignment ([33803f9](https://github.com/roomle-dev/roomle-ui/commit/33803f96d8580b742990f480f9be3c2475bf0407))
+* glue-layer group modification callbacks ([5fd2854](https://github.com/roomle-dev/roomle-ui/commit/5fd28549d2a35d0cd67ad354d3429da388a44754))
+* HF hi compatibility - load master data ([d5e8f1d](https://github.com/roomle-dev/roomle-ui/commit/d5e8f1d1ac93f949e66460312006f3820c689be0))
+* hi object undo/redo action steps ([1c0457a](https://github.com/roomle-dev/roomle-ui/commit/1c0457ab2e6dedaf6c507e6ee668c3c5c17e3c40))
+* highlighting of plan objects after merging ([0c05222](https://github.com/roomle-dev/roomle-ui/commit/0c05222e5fa2ea83194ea0d0e3acefced6105921))
+* linting issues ([8d6d4fc](https://github.com/roomle-dev/roomle-ui/commit/8d6d4fc8566e1db24131e5e2703fc2fbb39cb1b6))
+* make sure onPosGroupsCompletelyLoaded is sent when loading plan prior to library ([4bd834d](https://github.com/roomle-dev/roomle-ui/commit/4bd834d58b50c68f84a4febd0b94b55b57e8a846))
+* only check for children on configurable plan objects ([2667c18](https://github.com/roomle-dev/roomle-ui/commit/2667c184f96de47a1d8b6633ea60fb4cb804ef0a))
+* set "id" property in the external material's parameter value payload ([2adf311](https://github.com/roomle-dev/roomle-ui/commit/2adf31115aa2ab2c0cce42206f9e2d51b00f359c))
+* transfer attributes when root module of group is swapped ([3ae226a](https://github.com/roomle-dev/roomle-ui/commit/3ae226a65a6fdfb0e4ec803d4864efb3fb26ca88))
+* ts lint ([33b20c5](https://github.com/roomle-dev/roomle-ui/commit/33b20c5a18e4d27cbc0e50c60f41312aec942635))
+* update groups already loaded when PosSaveData is assigned ([6bf3943](https://github.com/roomle-dev/roomle-ui/commit/6bf39439b99b64b7af01c1322055035d9a3444ca))
+* wrong links in README in web-SDK package ([677a3c8](https://github.com/roomle-dev/roomle-ui/commit/677a3c807e2ba1f72175241c2704c798dba0ca6e))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roomle/embedding-lib",
-  "version": "5.30.1",
+  "version": "5.31.0-alpha.1",
   "description": "This is a small library which can be used to communicate with the Roomle Configurator",
   "type": "module",
   "main": "./roomle-embedding-lib.umd.js",

package/packages/embedding-lib/src/examples/homag-intelligence-example.d.ts

@@ -2,8 +2,19 @@ import { Example } from '../example';
 
 export default class HomagIntelligenceExample implements Example {
     private _abortController;
+    private _masterDataJson;
+    private _groupMap;
+    private _uiContainer;
+    private _uiMap;
+    private _roomDesignerApi;
     setupHtml(parent: HTMLElement): Promise<void>;
     closeExample(): Promise<void>;
     private start;
     runExample(): Promise<void>;
+    private _clearUiELements;
+    private _createUiElements;
+    private _getThumbnailUrl;
+    private _addUiElements;
+    private _removeUiElements;
+    private _addButton;
 }

package/packages/web-sdk/packages/common-core/src/configurator-kernel-access.d.ts

@@ -1,11 +1,11 @@
 import { default as ConfiguratorContext } from './webgl/configurator-context';
-import { DebugClient, KernelDockPairToLine, KernelDockPairToPoint, EmscriptenString, KernelAnimation, KernelComponent, KernelParameter, KernelParameterGroup, KernelVector3, PlanObject, VariantsList } from '../../typings/kernel';
+import { DebugClient, KernelDockPairToLine, KernelDockPairToPoint, KernelObjectInformation, EmscriptenString, KernelAnimation, KernelComponent, KernelParameter, KernelParameterGroup, KernelVector3, PlanObject, VariantsList } from '../../typings/kernel';
 import { default as CommonKernelAccess, KERNEL_TYPE } from './services/common-kernel-access';
 import { ArticleNumber, ConfigurationHash, ConfigurationString, RapiId, RapiPrice } from '../../typings/rapi-types';
 import { CommonConfiguratorKernelCallbackI } from './common-configurator-kernel-callback';
 import { PromiseQueue } from './utils/promise-queue';
 import { default as InitData } from './utils/init-data';
-import { ExternalObjectApiConfiguration } from '../../planner-core/src/external-object-api';
+import { ExternalObjectApiConfiguration } from '../../homag-intelligence/src/external-object-api';
 import { AnimationLevelType } from '../../configurator-core/src/utils/animation/animation-helper';
 
 export interface ConfiguratorKernelCallbackI extends CommonConfiguratorKernelCallbackI {
@@ -142,6 +142,7 @@ export default class ConfiguratorKernelAccess extends CommonKernelAccess {
     createNewSerializedConfiguration(configurationRuntimeId: number): string;
     getCurrentConfigurationHash(planObjectId: number): ConfigurationHash;
     isExternalObjectOrComponent(planObjectOrComponentId: number): boolean;
+    getComponentOrModuleInformation(planObjectOrComponentId: number): KernelObjectInformation | null;
     listOfVariants: (_componentId: RapiId, _list: VariantsList) => void;
     listOfVariantsError(dbId: RapiId, error: string): void;
     addDebugClient(debugClient: DebugClient): void;

package/packages/web-sdk/packages/common-core/src/services/cache-holder.d.ts

@@ -6,12 +6,15 @@ declare class LightCache {
     private _scene;
     availableLights: Light[];
     activeLights: Map<string, Light>;
+    maximumLights: number;
     private readonly _inactivePosition;
-    constructor(scene: Scene);
+    constructor(scene: Scene, maxAnisotropy: number);
+    allowedToSpawnMoreLights(): boolean;
     addActiveLight(light: Light): void;
     cacheLight(light: Light): void;
     getLightFromCache(type: KernelLightSourceType): Light<import('three').LightShadow<import('three').Camera>>;
     clear(): void;
+    private _setMaximumLights;
 }
 export default class CacheHolder {
     private _componentCache;
@@ -23,6 +26,6 @@ export default class CacheHolder {
     get geometryCache(): Map<string, BufferGeometry>;
     get materialCache(): Map<string, Material>;
     clear(): void;
-    setupLightCache(scene: Scene): void;
+    setupLightCache(scene: Scene, maxAnisotropy: number): void;
 }
 export {};

package/packages/web-sdk/packages/common-core/src/utils/common-utils.d.ts

@@ -49,6 +49,42 @@ export declare const throttle: <T extends (...args: any[]) => any>(func: T, dela
  */
 export declare const callAgainAfter: <T extends (...args: any[]) => any>(func: T, after?: number) => (...funcArgs: Parameters<T>) => void;
 export declare const debounce: <Params extends any[]>(func: (...args: Params) => any, timeout: number) => (...args: Params) => void;
+/**
+ * A generic type for a function.
+ */
+type AnyFunction = (...args: any[]) => any;
+/**
+ * Creates a debounced function that delays invoking `func` until after `delay`
+ * milliseconds have elapsed since the last time the debounced function was
+ * invoked with the same key. The debounced function comes with a `cancel`
+ * method to cancel delayed `func` invocations and a `flush` method to
+ * immediately invoke them.
+ *
+ * T The type of the function to debounce.
+ * @param {T} func The function to debounce.
+ * @param {number} delay The number of milliseconds to delay.
+ * @param {(...args: Parameters<T>) => unknown} [keyResolver]
+ * Optional. A function to resolve the key from the arguments.
+ * Defaults to using the first argument as the key.
+ * @returns {((...args: Parameters<T>) => void)} The new debounced function.
+ */
+export declare const debounceByKey: <T extends AnyFunction>(func: T, delay: number, keyResolver?: (...args: Parameters<T>) => unknown) => (this: ThisParameterType<T>, ...args: Parameters<T>) => void;
+/**
+ * Creates a debounced function that delays invoking `func` until after `delay`
+ * milliseconds have elapsed since the last time the debounced function was
+ * invoked with the same key. All calls made with the same key during the
+ * delay period will have their returned promises resolved with the result
+ * of the single final invocation.
+ *
+ * T The type of the function to debounce.
+ * @param {T} func The function to debounce. This function can be synchronous or asynchronous.
+ * @param {number} delay The number of milliseconds to delay.
+ * @param {(...args: Parameters<T>) => unknown} [keyResolver]
+ * Optional. A function to resolve the key from the arguments.
+ * Defaults to using the first argument as the key.
+ * @returns {((...args: Parameters<T>) => Promise<ReturnType<T>>)} The new debounced function.
+ */
+export declare const debounceByKeyAsync: <T extends AnyFunction>(func: T, delay: number, keyResolver?: (...args: Parameters<T>) => unknown) => (this: ThisParameterType<T>, ...args: Parameters<T>) => Promise<ReturnType<T>>;
 export declare const wait: (delay: number) => Promise<void>;
 export declare const nextTick: () => Promise<void>;
 export declare const roundWithPrecision: (float: number, precision: number) => number;
@@ -117,3 +153,4 @@ export declare const getIdQueryParam: (urlString: string) => string | null;
 export declare const isCtrlOrCmd: (event: KeyboardEvent) => boolean;
 export declare const ctrlOrCmd: (event: KeyboardEvent, checkIfItIsTheOnlyKey?: boolean) => boolean;
 export declare const runIfNotEmpty: <T extends any[]>(ids: string[], executor: () => Promise<T>) => Promise<T>;
+export {};

package/packages/web-sdk/packages/common-core/src/utils/init-data.d.ts

@@ -8,7 +8,7 @@ import { DefaultEnvironmentSceneType } from '../webgl/renderer/environment-scene
 import { CustomShadingParameters, SceneShadingType } from '../webgl/renderer/shading-settings';
 import { RapiId } from '../../../typings/rapi-types';
 import { CanvasOffset } from '../common-interfaces';
-import { ExternalObjectApiConfiguration } from '../../../planner-core/src/external-object-api';
+import { ExternalObjectApiConfiguration } from '../../../homag-intelligence/src/external-object-api';
 import { HomagIntelligenceInitData } from '../../../homag-intelligence/src/loader';
 
 export declare const DEFAULT_ENV_MAP_INTENSITY = 1.5;

package/packages/web-sdk/packages/common-core/src/view-model/configurator-view-model.d.ts

@@ -10,7 +10,6 @@ import { default as MeshGenerator } from '../webgl/mesh-generator';
 import { default as PlannerKernelAccess } from '../../../planner-core/src/services/planner-kernel-access';
 import { Box3, Mesh } from 'three';
 import { AnimationLevelType } from '../../../configurator-core/src/utils/animation/animation-helper';
-import { ExternalConfiguration } from '../../../typings/external-objects';
 
 export interface ConfiguratorViewModelCallbackI {
     componentUpdated(component: RoomleComponent, kernelComponent: KernelComponent): void;
@@ -31,6 +30,7 @@ export default class ConfiguratorViewModel implements ConfiguratorKernelCallback
     protected _configuratorContext: ConfiguratorContext;
     private _cacheHolder;
     protected _initData: InitData;
+    private _configuratorUiCallbacks;
     private _listener;
     private _mergeThreshold;
     private _componentsToMerge;
@@ -38,7 +38,6 @@ export default class ConfiguratorViewModel implements ConfiguratorKernelCallback
     private _geometriesMerged;
     private _subPartObject;
     private _subPartGuard;
-    private _externalConfigurations;
     protected _components: Map<number, RoomleComponent>;
     private _previews;
     protected _componentNumberOfPossibleChildren: Map<number, number>;
@@ -53,8 +52,6 @@ export default class ConfiguratorViewModel implements ConfiguratorKernelCallback
     private _applyMeshUVTransform;
     updateAnimationParameters(elementId: number | number[], parameters: KernelParameter[]): void;
     changeAnimationValue(elementId: number, parameterKey: string, value: string, level: number, animationLevel: AnimationLevelType, animate: boolean): void;
-    saveExternalConfiguration(externalConfiguration: ExternalConfiguration): void;
-    getExternalConfigurationById(id: string): ExternalConfiguration;
     getComponentFromRuntimeId(elementId: number): RoomleComponent | null;
     private _addMeshToSubPart;
     private _addMeshToComponent;

package/packages/web-sdk/packages/common-core/src/webgl/roomle-component-factory.d.ts

@@ -12,7 +12,6 @@ export interface RoomleComponent extends RoomleEventedObject3D {
     runtimeId: number;
     parentObjectId: number;
     isRootComponent: boolean;
-    isChildPlanObject: boolean;
     meshes: RoomleEventedMesh[];
     boundingBox: Box3;
     boundingBoxMesh: RoomleEventedMesh;
@@ -23,6 +22,7 @@ export interface RoomleComponent extends RoomleEventedObject3D {
     geometryChanged: boolean;
     animationValueMap?: AnimationValueMap;
     get childComponents(): RoomleComponent[];
+    get parentComponent(): RoomleComponent | null;
     replaceMeshes(meshes: Mesh[]): void;
     addMesh(mesh: Mesh, transform?: Float32Array): void;
     removeMesh(mesh: Mesh): void;

package/packages/web-sdk/packages/configurator-core/src/services/configurator-ui-callback.d.ts

@@ -299,5 +299,9 @@ export default class ConfiguratorUiCallbacks extends UiCallback implements Confi
      * is called when the external configuration should be saved
      */
     onExternalConfigurationSaved: (configuration: ExternalConfiguration) => void;
+    /**
+     * Is run when the maximum amount of lights the user's hardware can handle have been spawned into the scene.
+     */
+    onMaximumLightsReached: (maximumLights: number) => void;
     constructor(creator: string);
 }

package/packages/web-sdk/packages/configurator-core/src/utils/animation/animation-helper.d.ts

@@ -3,6 +3,7 @@ import { RoomleComponent } from '../../../../common-core/src/webgl/roomle-compon
 import { default as PlannerSceneManager } from '../../../../planner-core/src/webgl/planner-scene-manager';
 import { AnimationKeyAndValue } from './animation-value-map';
 import { ComponentAnimationTransformation, KernelParameter } from '../../../../typings/kernel';
+import { default as PlannerKernelAccess } from '../../../../planner-core/src/services/planner-kernel-access';
 
 export declare const ANIMATION_LEVEL: {
     readonly COMPONENT: 0;
@@ -11,8 +12,8 @@ export declare const ANIMATION_LEVEL: {
 };
 export type AnimationLevelType = (typeof ANIMATION_LEVEL)[keyof typeof ANIMATION_LEVEL];
 export declare const updateComponentAnimationParameters: (components: RoomleComponent[], parameters: KernelParameter[]) => void;
-export declare const getObjectAnimationValue: (component: RoomleComponent, animationName: string, onlyChildObject: boolean) => AnimationKeyAndValue | null;
-export declare const changeObjectAnimationValueAndAnimate: (component: RoomleComponent, parameterKey: string, value: string, level: number, animationLevel: AnimationLevelType, animate: boolean, invalidateRenderCallback: () => void) => void;
+export declare const getObjectAnimationValue: (component: RoomleComponent, animationName: string, onlyChildObject: boolean, plannerKernelAccess?: PlannerKernelAccess) => AnimationKeyAndValue | null;
+export declare const changeObjectAnimationValueAndAnimate: (component: RoomleComponent, parameterKey: string, value: string, level: number, animationLevel: AnimationLevelType, animate: boolean, invalidateRenderCallback: () => void, plannerKernelAccess?: PlannerKernelAccess) => void;
 export declare const hasObjectOpenCloseAnimation: (sceneManager: PlannerSceneManager, planObject: ConfiguratorPlanObjectViewModel) => boolean;
 export declare const getObjectOpenCloseAnimationValue: (sceneManager: PlannerSceneManager, planObject: ConfiguratorPlanObjectViewModel) => AnimationKeyAndValue | null;
 export declare const updateChildObjectAnimations: (component: RoomleComponent, childAnimationTransformations?: ComponentAnimationTransformation[]) => void;

package/packages/web-sdk/packages/configurator-core/src/utils/dimensioning-helper.d.ts

@@ -2,33 +2,39 @@ import { Object3D, Scene, Box3, Vector3 } from 'three';
 import { KernelCube } from '../../../typings/kernel';
 
 export declare const DIMENSIONING_GEOMETRY = "dimensioning";
+/**
+ * @interface DimensionLabelUIData
+ * Defines the structure for a single dimension label's data that will be sent to the UI.
+ */
+export interface DimensionLabelUIData {
+    id: 'width' | 'height' | 'depth';
+    text: string;
+    worldPosition: Vector3;
+    visible: boolean;
+}
 export default class DimensioningHelper {
     _creator_: string;
     private _unitFormatter;
-    private _uiScene;
     private _object;
     private _objectRotation;
     private _cameraPosition;
     private _font;
-    private _onChange;
+    private _onVisibilityChange;
     private _topDimensions;
     private _initialized;
     private _origin;
     private _dimensions;
     private _lineMaterial;
-    private _planeMaterial;
     private _widthLine;
     private _heightLine;
     private _depthLine;
-    private _widthText;
-    private _heightText;
-    private _depthText;
     private _enabled;
     private _dimensionsVisible;
     private _dimensionLineGroup;
-    private _dimensionTextGroup;
+    private _onLabelsUpdate;
     constructor(creator: string);
     private _loaded;
+    onLabelsUpdate(callback: (labels: DimensionLabelUIData[]) => void): void;
     private _performUpdate;
     private _updateWidth;
     private _updateHeight;
@@ -37,8 +43,6 @@ export default class DimensioningHelper {
     update(force?: boolean): void;
     addToObject(object: Object3D): void;
     removeFromObject(object: Object3D): void;
-    addToUiScene(uiScene: Scene): void;
-    removeFromUiScene(uiScene: Scene): void;
     private _isCameraInsideOrTooClose;
     private _getWidthEdge;
     private _getDepthEdge;
@@ -56,7 +60,6 @@ export default class DimensioningHelper {
     moveCameraEnd(position: Vector3): void;
     clearScene(_scene: Scene): void;
     setObject(object: Object3D, rotation?: number): void;
-    setUiScene(uiScene: Scene): void;
     isInitialized(): Promise<void>;
     areDimensionsEnabled(): boolean;
     private _getRotation;

package/packages/web-sdk/packages/configurator-core/src/webgl/configurator-scene-event-handler.d.ts

@@ -46,6 +46,7 @@ export default class ConfiguratorSceneEventHandler extends SceneEventHandler<Sce
     _creator_: string;
     private _selectionHandler;
     private _configuratorUiCallbacks;
+    private _plannerKernelAccess;
     private _cameraMoving;
     private _hoveredComponent;
     private _hoveredPreview;
@@ -75,6 +76,7 @@ export default class ConfiguratorSceneEventHandler extends SceneEventHandler<Sce
     private _updatePositionForPreviewLine;
     private _hoverOffPreviewLine;
     private _setDragComponentShadow;
+    private _isDraggingPossible;
     private _dragStart;
     private _drag;
     private _dragEnd;
@@ -91,4 +93,6 @@ export default class ConfiguratorSceneEventHandler extends SceneEventHandler<Sce
     setCameraMoving(cameraMoving: boolean): void;
     setCamera(camera: Camera): void;
     setObject(object: Object3D): void;
+    private _findComponentToBeSelected;
+    private isSiblingSelected;
 }

package/packages/web-sdk/packages/configurator-core/src/webgl/configurator-scene-manager.d.ts

@@ -21,7 +21,6 @@ import { default as CameraBehaviour } from '../../../common-core/src/cameracontr
 import { default as CameraBehaviour3d } from '../../../common-core/src/cameracontrol/camera-behaviour-3d';
 import { default as GlobalInitData } from '../../../common-core/src/utils/global-init-data';
 import { CancelSelectionReasons } from '../../../typings/planner';
-import { ExternalConfiguration } from '../../../typings/external-objects';
 import { default as UnitFormatter } from '../services/unit-formatter';
 import { AnimationLevelType } from '../utils/animation/animation-helper';
 
@@ -53,8 +52,6 @@ export default class ConfiguratorSceneManager extends SceneManager implements Co
     enableEvents(): void;
     enableConfiguratorEvents(): void;
     disableConfiguratorEvents(): void;
-    saveExternalConfiguration(externalConfiguration: ExternalConfiguration): void;
-    getExternalConfigurationById(id: string): ExternalConfiguration;
     protected _getViewModel(): ConfiguratorViewModel;
     protected _getKernelAccess(): PlannerKernelAccess;
     private _showDockings;

package/packages/web-sdk/packages/homag-intelligence/__tests__/glue-logic-test.d.ts

@@ -0,0 +1 @@
+export {};

package/packages/web-sdk/packages/homag-intelligence/src/api.d.ts

@@ -1,6 +1,7 @@
-import { RoomDesignerRequests } from './emulator';
+import { RoomDesignerRequests } from './glue-logic';
 import { MasterData, PosGroup } from './model/oc-scripts-domain.model';
 import { RoomlePlannerType } from '../../typings/external-objects';
+import { LoadExternalObjectOptions } from './external-object-api';
 
 export interface ExternalObjectModuleIdMap {
     originalModuleId: string;
@@ -10,7 +11,7 @@ export declare class RoomDesignerApi implements RoomDesignerRequests {
     private _roomlePlanner;
     constructor(roomlePlanner: RoomlePlannerType);
     loadMasterData(masterData: MasterData): void;
-    loadPosGroups(posDataJson: PosGroup | PosGroup[], findFreeSpaceInPlan: boolean, verifyArrangement: boolean, mergedGroups?: string[], respondWithPositionInPlan?: boolean, moduleIdMap?: ExternalObjectModuleIdMap[]): Promise<void>;
+    loadPosGroups(posDataJson: PosGroup | PosGroup[], options: LoadExternalObjectOptions): Promise<void>;
     selectGroup(groupId: string): Promise<void>;
     selectRoot(rootModuleId: string): Promise<void>;
     selectModule(rootModuleId: string, subModuleId: string): Promise<void>;
@@ -18,7 +19,7 @@ export declare class RoomDesignerApi implements RoomDesignerRequests {
     deleteGroup(groupId: string): void;
     deleteRootModule(rootModuleId: string): void;
     getPosDataOfAllGroups(): Promise<PosGroup[]>;
-    getRoomInformation(): Promise<import('../../planner-core/src/external-object-api').ExternalRoomInformation>;
+    getRoomInformation(): Promise<import('./external-object-api').ExternalRoomInformation>;
     generatePlanSnapshot(): Promise<{
         objectId: string;
         planId: string;

package/packages/web-sdk/packages/homag-intelligence/src/callbacks.d.ts

@@ -1,4 +1,4 @@
-import { GlueLogic } from './emulator';
+import { GlueLogic } from './glue-logic';
 import { default as RoomlePlanner } from '../../planner-core/src/roomle-planner';
 
 export interface ExternalObjectSegment {

package/packages/web-sdk/packages/homag-intelligence/src/debug-logging.d.ts

@@ -1,10 +1,10 @@
 import { HiCallbacks } from '../../../../embedding-lib/src/embedding-lib';
-import { GlueLogic, LibraryData, RoomDesignerRequests } from './emulator';
+import { GlueLogic, LibraryData, RoomDesignerRequests } from './glue-logic';
 import { ExternalObjectGroup } from 'roomle-core-hsc/src/embind/plannerCoreInterface';
 import { ExternalModuleInformation } from '../../typings/kernel';
 import { CheckResult, PosGroup, PosSaveData } from './model/oc-scripts-domain.model';
-import { ExternalObjectModuleIdMap } from './api';
 import { HiObjectSelection } from './hi-object-selection';
+import { LoadExternalObjectOptions } from './external-object-api';
 
 export declare class GlueLayerRequestDebugLogging implements GlueLogic {
     private _glueLogic;
@@ -45,7 +45,7 @@ export declare class GlueLayerResponseDebugLogging implements RoomDesignerReques
     constructor(roomDesignerRequests: RoomDesignerRequests, hiCallbacks: HiCallbacks);
     private _logResponse;
     loadMasterData(masterData: any): void;
-    loadPosGroups(posDataJson: PosGroup | PosGroup[], findFreeSpaceInPlan: boolean, verifyArrangement: boolean, mergedGroups?: string[], respondWithPositionInPlan?: boolean, moduleIdMap?: ExternalObjectModuleIdMap[]): Promise<void>;
+    loadPosGroups(posDataJson: PosGroup | PosGroup[], options: LoadExternalObjectOptions): Promise<void>;
     selectGroup(groupId: string): Promise<void>;
     selectRoot(rootModuleId: string): Promise<void>;
     selectModule(rootModuleId: string, subModuleId: string): Promise<void>;

package/packages/web-sdk/packages/{planner-core → homag-intelligence}/src/external-object-api.d.ts

@@ -1,4 +1,5 @@
-import { CheckResult, PosContour } from '../../homag-intelligence/src/model/oc-scripts-domain.model';
+import { Position3 } from '../../common-core/src/common-interfaces';
+import { CheckResult, PosContour } from './model/oc-scripts-domain.model';
 
 export interface ExternalObjectUiSliderRange {
     min: number;
@@ -44,7 +45,22 @@ export declare const HI_CONTEXT_ACTION: {
     readonly ROOM: "room";
     readonly ISOLATION: "isolation";
 };
-export type HiContextAction = typeof HI_CONTEXT_ACTION[keyof typeof HI_CONTEXT_ACTION];
+export type HiContextAction = (typeof HI_CONTEXT_ACTION)[keyof typeof HI_CONTEXT_ACTION];
+export type ExternalGroupData = object | object[] | string | string[];
+export interface LoadExternalObjectOptions {
+    dragIn?: boolean;
+    newAction?: boolean;
+    findFreeSpaceInPlan?: boolean;
+    correctArrangement?: boolean;
+    moduleIdMap?: Array<{
+        originalModuleId: string;
+        newModuleId: string;
+    }>;
+    respondWithPositionInPlan?: boolean;
+    mergedGroups?: string[];
+    position?: Position3;
+    rotation?: number;
+}
 export interface ExternalObjectAPI {
     /**
      * With "configureExternalObjectApi" the default representation of the objects and UI and
@@ -66,20 +82,20 @@ export interface ExternalObjectAPI {
      */
     loadExternalObjectMasterData(masterDataJson: string | object): void;
     /**
-     * "loadExternalObjectGroup" loads a group of modules and places them in the plan.
+     * "loadExternalObjectGroups" loads groups of modules and places them in the plan.
      * If the group has already been loaded, it is completely replaced by the new group.
      * This function therefore has 2 use cases:
      *   1. Load a new group of modules
      *   2. Update or modify an existing group of modules
      * The initial location of the group and the IDs of the modules are defined in the group JSON.
      * @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).
-     * @param respondWithPositionInPlan If true, loading the group is responded with the new planning situation of the group (`onChangedExternalObjectGroupPlan`).
-     * @param moduleIdMap Optional mapping of module IDs that associates original module IDs with new module IDs (required for the correction of the arrangement of root modules).
+     * @param options Options for loading the external object groups.
+     */
+    loadExternalObjectGroups(groupJson: ExternalGroupData, options: LoadExternalObjectOptions): Promise<void>;
+    /**
+     * Deprecated API that can be deleted once the new API is fully integrated into the OC.
      */
-    loadExternalObjectGroup(groupJson: object | string | string[], findFreeSpaceInPlan: boolean, verifyArrangement?: boolean, mergedGroups?: string[], respondWithPositionInPlan?: boolean, moduleIdMap?: ExternalObjectModuleIdMap[]): Promise<void>;
+    loadExternalObjectGroup(groupJson: object | string | string[], findFreeSpaceInPlan: boolean, verifyArrangement?: boolean, mergedGroups?: string[], respondWithPositionInPlan?: boolean, moduleIdMap?: ExternalObjectModuleIdMap[], newAction?: boolean): Promise<void>;
     /**
      * "updateExternalObjectGroupAttribute" modifies an attribute of a root module or sub module.
      * The attribute with the ID "attributeId" of the sub module with the ID "moduleId"
@@ -146,7 +162,7 @@ export interface ExternalObjectAPI {
      * @param groupOrRootModuleId The ID of the group or root module that should be selected.
      * @param subModuleId The optional ID of the sub module that should be selected.
      * @param contextAction The context action defines whether the selection is done in room context or isolation context or no context change is done.
-    */
+     */
     selectExternalObject(groupOrRootModuleId: string, subModuleId: string | null, contextAction: HiContextAction): Promise<void>;
     /**
      * "openOrCloseGeometryOfExternalObject" switches the geometry of the modules between closed and open representation.

package/packages/web-sdk/packages/homag-intelligence/src/{emulator.d.ts → glue-logic.d.ts}

@@ -1,8 +1,8 @@
 import { HiCallbacks } from '../../../../embedding-lib/src/embedding-lib';
 import { ExternalModuleInformation, ExternalObjectGroup } from './callbacks';
 import { MasterData, PosModuleAttribute, PosGroup, PosModuleData, CheckResult, PosSaveData } from './model/oc-scripts-domain.model';
-import { ExternalObjectModuleIdMap } from './api';
 import { HiObjectSelection } from './hi-object-selection';
+import { LoadExternalObjectOptions } from './external-object-api';
 
 export interface LibraryData {
     libraryId: string;
@@ -15,7 +15,7 @@ export interface LibraryData {
 }
 export interface RoomDesignerRequests {
     loadMasterData(masterData: MasterData): void;
-    loadPosGroups(posDataJson: PosGroup | PosGroup[], findFreeSpaceInPlan: boolean, verifyArrangement: boolean, mergedGroups?: string[], respondWithPositionInPlan?: boolean, moduleIdMap?: ExternalObjectModuleIdMap[]): Promise<void>;
+    loadPosGroups(posDataJson: PosGroup | PosGroup[], options: LoadExternalObjectOptions): Promise<void>;
     selectGroup(groupId: string): Promise<void>;
     selectRoot(rootModuleId: string): Promise<void>;
     selectModule(rootModuleId: string, subModuleId: string): Promise<void>;
@@ -71,7 +71,7 @@ interface GroupItem {
     posDataJson: PosGroup;
     opened: boolean;
 }
-export declare class Emulator implements GlueLogic {
+export declare class GlueLogicImplementation implements GlueLogic {
     private _designerRequests;
     private _libraryData;
     private _posDataForLoading;
@@ -85,6 +85,7 @@ export declare class Emulator implements GlueLogic {
     constructor(designerRequests: RoomDesignerRequests, hiCallbacks?: HiCallbacks | null);
     get hiCallbacks(): HiCallbacks | null;
     get hiObjectSelection(): HiObjectSelection;
+    private _getGroup;
     getLibraryData(data: string | PosGroup): LibraryData | null;
     isLibraryLoaded(libraryId: string): boolean;
     addLibrary(libraryData: LibraryData): void;
@@ -99,7 +100,7 @@ export declare class Emulator implements GlueLogic {
     openCloseGroup(groupId: string): Promise<void>;
     deleteRootModule(remainingGroup: ExternalObjectGroup, rootModuleIdToDelete: string, splitOffGroups: ExternalObjectGroup[]): void;
     duplicateGroup(_sourceGroupId: string, duplicatedGroup: ExternalObjectGroup): Promise<void>;
-    mergeGroups(targetGroup: ExternalObjectGroup, idsOfGroupsMerged: string | string[], idOfTargetRootModule: string): void;
+    mergeGroups(targetGroup: ExternalObjectGroup, idsOfGroupsMerged: string | string[], idOfTargetRootModule: string): Promise<void>;
     private _applyImplicitRelevantAttributes;
     splitRootModuleFromGroup(splitGroup: ExternalObjectGroup, newGroupedRootModules: ExternalObjectGroup[]): void;
     arrangeRootModulesOfGroup(changedGroup: ExternalObjectGroup): void;
@@ -132,7 +133,7 @@ export declare class Emulator implements GlueLogic {
     getVerifiedAttributeOptions(moduleId: string, attributeIds?: string | string[]): Promise<Record<string, CheckResult> | undefined>;
     updateAdditionalInfo(rootModuleId: string, additionalInfo: string): void;
     swapRootModule(groupId: string, rootModuleId: string, articleId: string): void;
-    _modifyAttributeOfModules(emulatorGroupItem: GroupItem, moduleIds: string[] | string, attributeName: string, value: string | boolean): PosGroup;
+    _modifyAttributeOfModules(emulatorGroupItem: GroupItem, moduleIds: string[] | string, attributeId: string, value: string | boolean): PosGroup;
     private _setAttribute;
     savePlanSnapshot(): Promise<PlanSnapshot>;
     private _findRootModuleInAllGroups;

package/packages/web-sdk/packages/homag-intelligence/src/hi-object-selection.d.ts

@@ -12,13 +12,13 @@ export declare const HI_SELECTION_TYPE: {
     readonly ROOT_MODULE: "rootModule";
     readonly SUB_MODULE: "subModule";
 };
-export type HiSelectionType = typeof HI_SELECTION_TYPE[keyof typeof HI_SELECTION_TYPE];
+export type HiSelectionType = (typeof HI_SELECTION_TYPE)[keyof typeof HI_SELECTION_TYPE];
 export declare const HI_SELECTION_MODE: {
     readonly MULTI_SELECT: "multiselect";
     readonly TC_CONFIG: "tc-config";
     readonly RML_OBJECT: "rml-object";
 };
-export type HiSelectionMode = typeof HI_SELECTION_MODE[keyof typeof HI_SELECTION_MODE];
+export type HiSelectionMode = (typeof HI_SELECTION_MODE)[keyof typeof HI_SELECTION_MODE];
 export declare class HiObjectSelection {
     private _callbacks;
     private _contextType;

package/packages/web-sdk/packages/homag-intelligence/src/hi-tag-catalog-callbacks.d.ts

@@ -1,4 +1,4 @@
-import { GlueLogic } from './emulator';
+import { GlueLogic } from './glue-logic';
 import { Context } from '../../common-core/src/di/context';
 
 export declare const FAKE_ROOT_TAG = "external:root-tag";

package/packages/web-sdk/packages/homag-intelligence/src/homag-intelligence.d.ts

@@ -1,5 +1,5 @@
 import { RmlPlugin } from './rml-plugin';
-import { GlueLogic } from './emulator';
+import { GlueLogic } from './glue-logic';
 import { HomagIntelligenceInitData } from './loader';
 import { MasterData } from './model/oc-scripts-domain.model';
 import { default as RoomlePlanner } from '../../planner-core/src/roomle-planner';

package/packages/web-sdk/packages/homag-intelligence/src/orders.d.ts

@@ -1,5 +1,5 @@
 import { default as RoomlePlanner } from '../../planner-core/src/roomle-planner';
-import { GlueLogic } from './emulator';
+import { GlueLogic } from './glue-logic';
 
 export declare const createEmptyOrder: () => {
     id: any;

package/packages/web-sdk/packages/planner-core/src/roomle-planner-ui-callback.d.ts

@@ -14,7 +14,7 @@ import { MeasurementLineDimension, MeasurementLineDimensionTransferable } from '
 import { ConstructionMeasurementsTransferable } from './utils/measurements';
 import { FloorAreaDataTransferable } from './view-model/floor-plan-element-view-model';
 import { BASE_CONTEXT } from '../../common-core/src/main';
-import { ExternalObjectGroup, ExternalObjectUiCallback } from './external-object-api-callbacks';
+import { ExternalObjectGroup, ExternalObjectUiCallback } from '../../homag-intelligence/src/external-object-api-callbacks';
 
 export interface SelectionPayload {
     item?: RapiItem;

package/packages/web-sdk/packages/planner-core/src/roomle-planner.d.ts

@@ -21,7 +21,7 @@ import { default as PlanElementViewModel } from '../../common-core/src/view-mode
 import { default as WallPlanElementViewModel } from './view-model/wall-plan-element-view-model';
 import { default as ConfiguratorContext } from '../../common-core/src/webgl/configurator-context';
 import { default as IdbManager } from '../../common-core/src/services/idb-manager';
-import { ExternalObjectAPI, ExternalObjectApiConfiguration, ExternalObjectModuleIdMap, ExternalRoomInformation, HiContextAction } from './external-object-api';
+import { LoadExternalObjectOptions, ExternalObjectAPI, ExternalObjectApiConfiguration, ExternalObjectModuleIdMap, ExternalRoomInformation, HiContextAction } from '../../homag-intelligence/src/external-object-api';
 import { GlobalCallback } from '../../common-core/src/services/global-callback';
 import { ExternalGroupData, ExternalObject, ExtObjId } from '../../typings/external-objects';
 import { PluginName } from '../../configurator-core/src/utils/plugin-types';
@@ -78,17 +78,10 @@ export interface InsertItemResult {
     runtimeId: RuntimeId;
     originalIndex: number;
 }
-export interface LoadExternalObjectOptions {
-    dragIn?: boolean;
-    findFreeSpaceInPlan?: boolean;
-    correctArrangement?: boolean;
-    moduleIdMap?: Array<{
-        originalModuleId: string;
-        newModuleId: string;
-    }>;
-    respondWithPositionInPlan?: boolean;
-    position?: Position3;
-    rotation?: number;
+export interface LightCacheInfo {
+    activeLights: number;
+    availableLights: number;
+    maximumLights: number;
 }
 export default class RoomlePlanner<P extends readonly PluginName[] = readonly []> implements KernelAccessCallbackI, RoomlePlannerCallback, GlobalAPI, Context, KernelUtilityForUi, ExternalEmbeddable<RoomlePlannerUiCallback>, RubensAPI, ExternalObjectAPI {
     _creator_: string;
@@ -167,7 +160,8 @@ export default class RoomlePlanner<P extends readonly PluginName[] = readonly []
     showBenchmarks(): void;
     getConfiguratorApi(): RoomleConfigurator<P>;
     startViewing(): void;
-    startConfiguring(): void;
+    startConfiguring(): Promise<void>;
+    private _getObjectComponentForStartConfiguring;
     /**
      * select an object in the scene based on its runtime id
      * @param runtimeId
@@ -234,6 +228,7 @@ export default 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>;
     insertItemList(ids: Array<RapiId | ExtObjId>): Promise<RuntimeId[]>;
     /**
      * Inserts all of the items in the array into current plan
@@ -312,15 +307,15 @@ export default class RoomlePlanner<P extends readonly PluginName[] = readonly []
     /**
      * returns true if interaction with the child components of a configuration object is enabled, and flashes otherwise
      */
-    showsChildrenOfPlanObject(planElementViewModel: PlanElementViewModel): boolean;
+    isEnabledChildObjectMode(planElementViewModel: PlanElementViewModel): boolean;
     /**
      * enable interaction with child components of configurable objects in the plan
      */
-    enableShowChildrenOfPlanObject(planElementViewModel: PlanElementViewModel): KernelObject;
+    enableChildObjects(planElementViewModel: PlanElementViewModel): KernelObject;
     /**
      * disable interaction with child components of configurable objects in the plan
      */
-    disableShowChildrenOfPlanObject(planElementViewModel: PlanElementViewModel): KernelObject;
+    disableChildObjects(planElementViewModel: PlanElementViewModel): KernelObject;
     /**
      * get the Partlist of certain runtimeID
      * can be used if partlist of a selected Item is needed
@@ -437,7 +432,11 @@ export default class RoomlePlanner<P extends readonly PluginName[] = readonly []
     configureExternalObjectApi(configurationJson: string | ExternalObjectApiConfiguration): Promise<void>;
     loadExternalObjectLibrary(libraryId: string): Promise<void>;
     loadExternalObjectMasterData(masterDataJson: string | object): void;
-    loadExternalObjectGroup(groupData: ExternalGroupData, findFreeSpaceInPlan: boolean, correctArrangement?: boolean, mergedGroups?: string[], respondWithPositionInPlan?: boolean, moduleIdMap?: ExternalObjectModuleIdMap[]): Promise<void>;
+    /**
+     * Deprecated API that can be deleted once the new API is fully integrated into the OC.
+     */
+    loadExternalObjectGroup(groupData: ExternalGroupData, findFreeSpaceInPlan: boolean, correctArrangement?: boolean, mergedGroups?: string[], respondWithPositionInPlan?: boolean, moduleIdMap?: ExternalObjectModuleIdMap[], newAction?: boolean): Promise<void>;
+    loadExternalObjectGroups(groupData: ExternalGroupData, options?: LoadExternalObjectOptions): Promise<void>;
     private _loadExternalObjectGroup;
     private _loadExternalObjectGroupInConfigurator;
     private _loadExternalObjectGroupInPlanner;
@@ -473,12 +472,8 @@ export default class RoomlePlanner<P extends readonly PluginName[] = readonly []
      */
     selectExternalObjectSubModule(rootModuleId: string, subModuleId: string): Promise<void>;
     selectExternalObject(groupOrRootModuleId: string, subModuleId: string | null, contextAction: HiContextAction): Promise<void>;
-    private _switchExternalObjectMode;
     openOrCloseGeometryOfExternalObject(groupIdOrRootModuleId: string, _subModuleId: string | null, open: boolean, animate: boolean): void;
     _selectExternalObjectGroup(groupId: string, switchToPlanner: 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[]>;
     getExternalRoomInformation(): Promise<ExternalRoomInformation>;
     /**
@@ -558,6 +553,10 @@ export default class RoomlePlanner<P extends readonly PluginName[] = readonly []
      * @param ids array of light IDs, see type interface RoomleLightSource._lightSourceId
      */
     setElementLightsOnOff(planElementViewModel: PlanElementViewModel, state: boolean): void;
+    /**
+     * Returns an object containing the amount of active, available and maximum lights for the scene.
+     */
+    getLightCache(): LightCacheInfo;
     getPlanObjectForRuntimeId(runtimeId: number): Promise<PlanElementViewModel | null>;
     rotateByRuntimeId(runtimeId: number, rotateBy: number): Promise<void>;
     deleteByRuntimeId(runtimeId: number): Promise<void>;

package/packages/web-sdk/packages/planner-core/src/services/planner-kernel-access.d.ts

@@ -1,14 +1,16 @@
-import { KernelAnimation, KernelComponent, KernelEnum, RuntimeId, PlanObject as ConfiguratorPlanObject } from '../../../typings/kernel';
+import { KernelAnimation, KernelPlanObjectComponent, KernelComponent, KernelEnum, RuntimeId, PlanObject as ConfiguratorPlanObject } from '../../../typings/kernel';
 import { default as PlanObjectViewModel } from '../../../common-core/src/view-model/plan-object-view-model';
-import { KernelObject, Plan, PlanElement, PlanInteractionHandler, PlanModelViewHelper, PlanObject } from '../../../typings/planner';
+import { KernelObject, Plan, PlanElement, PlanInteractionHandler, PlanModelViewHelper, PlanObject, CORE_TYPE_OF_CORE_ID } from '../../../typings/planner';
 import { RapiConfiguration, RapiItem, RapiPlanSnapshotPostData } from '../../../typings/rapi-types';
 import { default as RoomlePlannerUiCallback } from '../roomle-planner-ui-callback';
 import { default as PlanElementViewModel } from '../../../common-core/src/view-model/plan-element-view-model';
 import { Position3 } from '../../../common-core/src/common-interfaces';
 import { default as ConfiguratorKernelAccess } from '../../../common-core/src/configurator-kernel-access';
-import { ExternalObjectApiConfiguration } from '../external-object-api';
-import { ExternalObjectGroup } from '../external-object-api-callbacks';
+import { RoomleComponent } from '../../../common-core/src/webgl/roomle-component-factory';
+import { ExternalObjectApiConfiguration } from '../../../homag-intelligence/src/external-object-api';
+import { ExternalObjectGroup } from '../../../homag-intelligence/src/external-object-api-callbacks';
 import { AnimationLevelType } from '../../../configurator-core/src/utils/animation/animation-helper';
+import { Enumify } from '../../../common-core/src/types';
 
 export interface PlannerKernelCallbackI {
     handlerSwitchedPlans(fromPlan: Plan, toPlan: Plan): void;
@@ -48,7 +50,7 @@ export default class PlannerKernelAccess extends ConfiguratorKernelAccess {
     get planInteractionHandler(): PlanInteractionHandler;
     get planModelViewHelper(): PlanModelViewHelper;
     catalogItemLoaded(catalogItem: RapiItem): void;
-    insertItems(itemList: Array<RapiItem | RapiConfiguration>): Promise<RuntimeId[]>;
+    insertItems(itemList: Array<RapiItem | RapiConfiguration>, newUndoRedoStep?: boolean): Promise<RuntimeId[]>;
     duplicateItems(planObjects: PlanObject[]): PlanObject[];
     private _rapiItemToKernelItem;
     planObjectDeleted(): void;
@@ -90,7 +92,7 @@ export default class PlannerKernelAccess extends ConfiguratorKernelAccess {
     addPlanMesh(plan: Plan, material: any, vertices: Float32Array, indices: Int32Array, uvCoords: Float32Array, normals: Float32Array, type: KernelEnum): void;
     endPlanConstruction(plan: Plan): void;
     createPlanFromObject(rapiElement: RapiItem | RapiConfiguration, position?: Position3, rotation?: number): Plan;
-    addPlanObjectFromItem(rapiElement: RapiItem | RapiConfiguration, position?: Position3, rotation?: number): Promise<RuntimeId>;
+    addPlanObjectFromItem(rapiElement: RapiItem | RapiConfiguration, newUndoRedoStep: boolean, position?: Position3, rotation?: number): Promise<RuntimeId>;
     coupleReferences(jsObject: any, coreReference: KernelObject): void;
     private _decoupleReferences;
     isConstructionPlanElement(planElement: PlanElement): boolean;
@@ -115,4 +117,6 @@ export default class PlannerKernelAccess extends ConfiguratorKernelAccess {
     configureExternalObjectApi(externalObjectSettings?: ExternalObjectApiConfiguration): Promise<void>;
     setComponentParameter(componentId: number, interactionKey: string, newValue: any): void;
     protected _getAnimationLevelForObject(runtimeId: number, _animation: KernelAnimation): AnimationLevelType;
+    getObjectComponent(runtimeId: number, typeOfId: Enumify<typeof CORE_TYPE_OF_CORE_ID>): KernelPlanObjectComponent | null;
+    isChildObjectRootComponent(roomleComponent: RoomleComponent): boolean;
 }

package/packages/web-sdk/packages/planner-core/src/view-model/plan-view-model.d.ts

@@ -64,7 +64,6 @@ export default class PlanViewModel extends ConfiguratorViewModel implements Plan
     addPlanElementViewModel(planElementViewModel: PlanElementViewModel): void;
     private _handleConfiguratorPlanObjectViewModel;
     private _linkPlanObjectViewModelAndComponent;
-    private _detachPlanObjectViewModelFromComponent;
     private _handleConfiguratorConstructionPlanObjectViewModel;
     private _handleConstructionPlanObjectViewModel;
     private _handleStaticPlanObjectViewModel;
@@ -97,6 +96,7 @@ export default class PlanViewModel extends ConfiguratorViewModel implements Plan
     }): void;
     toggleCeilingLights(on: boolean): void;
     private commonHandlerForEditableAndTopView;
+    isChildObjectRootComponent(roomleComponent: RoomleComponent): boolean;
     protected dockComponent(componentId: number, isRootComponent: boolean, parentId: number, componentPosition: KernelVector3, componentRotation: KernelVector3): void;
     protected _addComponent(component: RoomleComponent): void;
     private _getPlanObjectViewModelForRuntimeId;

package/packages/web-sdk/packages/planner-core/src/webgl/planner-element-highlighter.d.ts

@@ -9,6 +9,7 @@ export default class PlanElementHighlighter {
     private _planViewModel;
     constructor(sceneEventHandler: PlannerSceneEventHandler, roomleRenderer: RoomleWebGLRenderer, planViewModel: PlanViewModel);
     private _processViewModel;
+    private _isChildObjectRootComponent;
     private _processSelectedPlanElementIds;
     private _highlightPlanElementsBase;
     highlightPlanElements(runtimeIds?: number[]): void;

package/packages/web-sdk/packages/planner-core/src/webgl/planner-scene-event-handler.d.ts

@@ -141,10 +141,10 @@ export default class PlannerSceneEventHandler extends SceneEventHandler<SceneEve
     disableSnapping(): void;
     enableAdvancedDocking(): void;
     disableAdvancedDocking(): void;
-    showsChildrenOfPlanObject(object: KernelObject): boolean;
-    enableShowChildrenOfPlanObject(object: KernelObject, switchChildModeOffForAllOtherObjects?: boolean): KernelObject | null;
-    disableShowChildrenOfPlanObject(object: KernelObject): KernelObject | null;
-    disableShowChildrenOfAllPlanObjects(): void;
+    isEnabledChildObjectMode(object: KernelObject): boolean;
+    enableChildObjects(object: KernelObject, switchChildModeOffForAllOtherObjects?: boolean): KernelObject | null;
+    disableChildObjects(object: KernelObject): KernelObject | null;
+    disableChildObjectsOfAllPlanObjects(): void;
     private _checkRaycasterSnapping;
     enableWallDrawing(): Group;
     cancelWallDrawing(): Group;

package/packages/web-sdk/packages/planner-core/src/webgl/planner-scene-manager.d.ts

@@ -52,6 +52,7 @@ export default class PlannerSceneManager extends ConfiguratorSceneManager implem
     currentSelection: SelectionPayload | null;
     private _paperBackground;
     private _cameraState;
+    private _cameraStateLocked;
     private _planElementHighlighter;
     private _debugSpheres;
     constructor(creator: string, offset: CanvasOffset, plannerCallback: RoomlePlannerCallback, mode: Enumify<typeof CAMERA_TYPE>);
@@ -159,9 +160,9 @@ export default class PlannerSceneManager extends ConfiguratorSceneManager implem
     disableSnapping(): void;
     enableAdvancedDocking(): void;
     disableAdvancedDocking(): void;
-    showsChildrenOfPlanObject(planElementViewModel: PlanElementViewModel): boolean;
-    enableShowChildrenOfPlanObject(planElementViewModel: PlanElementViewModel): import('../../../typings/planner').KernelObject;
-    disableShowChildrenOfPlanObject(planElementViewModel: PlanElementViewModel): import('../../../typings/planner').KernelObject;
+    isEnabledChildObjectMode(planElementViewModel: PlanElementViewModel): boolean;
+    enableChildObjects(planElementViewModel: PlanElementViewModel): import('../../../typings/planner').KernelObject;
+    disableChildObjects(planElementViewModel: PlanElementViewModel): import('../../../typings/planner').KernelObject;
     dragIn(dragEvent: DragEvent): void;
     getPlannerSceneEventHandler(): PlannerSceneEventHandler;
     disablePlannerEvents(): void;
@@ -221,13 +222,17 @@ export default class PlannerSceneManager extends ConfiguratorSceneManager implem
     protected notifyPlannerOnComponentSelectionCancel(isExternalObject: boolean, reason: CancelSelectionReasons): void;
     private _externalPlanObjectSelectionChanged;
     highlightExternalObject(planObjectComponent: KernelPlanObjectComponent): void;
-    private _selectExternalObjectModule;
-    getObjectComponent(id: number, typeOfId: Enumify<typeof CORE_TYPE_OF_CORE_ID>): KernelPlanObjectComponent;
+    private _selectExternalObjectComponent;
+    private _getSelectedPlanObjectComponent;
+    selectObjectComponent(planObjectComponent: KernelPlanObjectComponent, switchToConfigurator: boolean, selectComponent: boolean): Promise<void>;
+    _swapObjectInConfigurator(planObjectComponent: KernelPlanObjectComponent): Promise<void>;
+    getObjectComponent(id: number, typeOfId: Enumify<typeof CORE_TYPE_OF_CORE_ID>): KernelPlanObjectComponent | null;
     getExternalObjectComponent(groupOrRootModuleId: string, subModuleId: string): KernelPlanObjectComponent;
     getCameraParameters3d(): NonNullable<CameraParameter>;
     private _createCeilingLightGroup;
     toggleInteriorLightsSceneSettings(on: boolean): void;
     private _insertRapiItems;
     insertRapiObjects(rapiIds: InsertItemIdInfo[]): Promise<InsertItemResult[]>;
+    private _saveConfiguration;
 }
 export {};

package/packages/web-sdk/packages/typings/kernel.d.ts

@@ -234,7 +234,8 @@ export interface KernelPlanObjectBase {
     center: KernelVector3;
     rootComponentCenter: KernelVector3;
     rotation: number;
-    customColor: number;
+    rgbValue: number;
+    useCustomColor?: boolean;
     customLabel: string;
     catalogItemId: string;
     runtimeId: number;

package/packages/web-sdk/packages/typings/planner-kernel-container.d.ts

@@ -83,7 +83,7 @@ declare class PlanObjectPtrVector extends EmsArray<PlanObjectPtr> {
 }
 declare abstract class PlanObjectPtr extends AbstractModelWrapper {
     rotation: KernelVector3f;
-    customColor: number;
+    rgbColor: number;
     level: number;
     flipX: boolean;
     flipY: boolean;

package/packages/web-sdk/packages/typings/planner.d.ts

@@ -76,7 +76,8 @@ export interface ObjectFrontRotation {
 export interface PlanObject extends PlanElement {
     size: KernelVector3;
     rotation: number;
-    customColor: number;
+    rgbColor: number;
+    useCustomColor?: boolean;
     flipX: boolean;
     flipY: boolean;
     fixedZ: boolean;
@@ -264,18 +265,21 @@ export interface PlanInteractionHandler {
     getContinuousDrawingManager(): ContinuousDrawingManager;
     setSnapFeedbackWhileDrawing(enabled: boolean): void;
     consistsOfMergedComponents(object: KernelObject): boolean;
-    getShowChildrenOfPlanObject(object: KernelObject): ChildEntityMode;
-    setShowChildrenOfPlanObject(object: KernelObject, mode: ChildEntityMode, switchChildModeOffForAllOtherObjects: boolean): KernelObject;
-    setShowChildrenOfExternalObject(objectId: string, mode: ChildEntityMode, switchChildModeOffForAllOtherObjects: boolean): KernelObject;
     setObjectSize(anObject: KernelObject, aNewSize: KernelVector3, anAnchor: Anchor): void;
     setObjectFlipX(anObject: KernelObject, shouldFlipX: boolean): void;
     setObjectFlipY(anObject: KernelObject, shouldFlipY: boolean): void;
-    setObjectCustomColor(anObject: KernelObject, aCustomColor: number): void;
+    setObjectCustomColor(object: PlanObject, rgbColor: number, useCustomColor: boolean): void;
     setObjectFixedZ(anObject: KernelObject, shouldFlipZ: boolean): void;
     setMeasurePoint1(measure: PlanMeasure, point: KernelVector3f, snapToWalls: boolean, snapToObjects: boolean): void;
     setMeasurePoint2(measure: PlanMeasure, point: KernelVector3f, snapToWalls: boolean, snapToObjects: boolean): void;
     addMeasure(startPosition: KernelVector3f, endPosition: KernelVector3f): PlanMeasure;
     setDiscardExternalObjectsOnLoad(discard: boolean): void;
+    isEnabledChildObjectMode(object: KernelObject): boolean;
+    enableChildObjects(object: KernelObject, switchChildModeOffForAllOtherObjects: boolean): KernelObject;
+    disableChildObjects(object: KernelObject): KernelObject;
+    enableChildObjectsOfExternalObject(objectId: string, switchChildModeOffForAllOtherObjects: boolean): KernelObject;
+    disableChildObjectsOfExternalObject(objectId: string): KernelObject;
+    disableChildObjectsOfAllPlanObjects(): void;
     unit: string;
     enableRaster: boolean;
     customRaster: number;
@@ -285,7 +289,6 @@ export interface PlanInteractionHandler {
     objectToObjectSnapMode: SnapMode;
     dockWhenSnap: boolean;
     unDockOnMove: boolean;
-    showChildrenOfPlanObjects: ChildEntityMode;
 }
 export interface PlanOverview {
     area: number;
@@ -336,6 +339,7 @@ declare class GeometryHelpLineArray extends EmsArray<GeometryHelpLine> {
 export interface PlanModelViewHelper {
     getPlanOverview(planObject: KernelObject): PlanOverview;
     getPlanObject(plan: Plan, aRuntimeId: number): KernelPlanObject;
+    isChildObjectRootComponent(plan: Plan, componentRuntimeId: number): boolean;
     getRootPlanObjectId(plan: Plan, aRuntimeId: number): number;
     getObjectComponent(plan: Plan, typeOfId: TypeOfCoreId, anId: number): KernelPlanObjectComponent;
     getExternalObjectComponent(plan: Plan, groupId: string, moduleId: string): KernelPlanObjectComponent;

package/src/common/components/notifications/MaximumLightNotification.vue.d.ts

@@ -0,0 +1,8 @@
+declare const _default: import('vue').DefineComponent<{
+    close: () => void;
+    payload: number;
+}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{
+    close: () => void;
+    payload: number;
+}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/src/common/components/notifications/RenderingLightNotification.vue.d.ts

@@ -0,0 +1,6 @@
+declare const _default: import('vue').DefineComponent<{
+    close: () => void;
+}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{
+    close: () => void;
+}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/src/common/components/parameters/ColorParameter.vue.d.ts

@@ -1114,7 +1114,7 @@ declare const _default: import('vue').DefineComponent<{
     isExpanded?: boolean;
     onExpand?: () => void;
     onCollapse?: (_payload: MouseEvent) => void;
-    onSetColor?: (element: GridViewElement<any>, key?: string) => void | Promise<void>;
+    onSetColor?: (element: GridViewElement<any>, key?: string, isCustomColor?: boolean) => void | Promise<void>;
     value?: MinimalBoundValue<any>;
     label?: string;
     originalPayload?: any;
@@ -2224,7 +2224,7 @@ declare const _default: import('vue').DefineComponent<{
     isExpanded?: boolean;
     onExpand?: () => void;
     onCollapse?: (_payload: MouseEvent) => void;
-    onSetColor?: (element: GridViewElement<any>, key?: string) => void | Promise<void>;
+    onSetColor?: (element: GridViewElement<any>, key?: string, isCustomColor?: boolean) => void | Promise<void>;
     value?: MinimalBoundValue<any>;
     label?: string;
     originalPayload?: any;

package/src/common/components/side-bar/utils/configurator-sidebar-components.d.ts

@@ -1382,7 +1382,7 @@ declare const dynamicComponents: {
         isExpanded?: boolean;
         onExpand?: () => void;
         onCollapse?: (_payload: MouseEvent) => void;
-        onSetColor?: (element: import('../../../../configurator/components/grid-view/-utils/GridViewHelper').GridViewElement<any>, key?: string) => void | Promise<void>;
+        onSetColor?: (element: import('../../../../configurator/components/grid-view/-utils/GridViewHelper').GridViewElement<any>, key?: string, isCustomColor?: boolean) => void | Promise<void>;
         value?: import('../../../composables/use-core-bound-value').MinimalBoundValue<any>;
         label?: string;
         originalPayload?: any;
@@ -2492,7 +2492,7 @@ declare const dynamicComponents: {
         isExpanded?: boolean;
         onExpand?: () => void;
         onCollapse?: (_payload: MouseEvent) => void;
-        onSetColor?: (element: import('../../../../configurator/components/grid-view/-utils/GridViewHelper').GridViewElement<any>, key?: string) => void | Promise<void>;
+        onSetColor?: (element: import('../../../../configurator/components/grid-view/-utils/GridViewHelper').GridViewElement<any>, key?: string, isCustomColor?: boolean) => void | Promise<void>;
         value?: import('../../../composables/use-core-bound-value').MinimalBoundValue<any>;
         label?: string;
         originalPayload?: any;

package/src/common/components/utils/-utils/notifications.d.ts

@@ -13,6 +13,8 @@ export declare const NOTIFICATION_SHOW_TIMEOUTS: {
     readonly LONG: 8000;
 };
 export declare const NOTIFICATIONS: {
+    readonly RENDERING_LIGHT: "rendering-light-notification";
+    readonly MAXIMUM_LIGHTS: "maximum-lights-notification";
     readonly LOAD_IDB_CONFIG: "load-idb-config";
     readonly FIRST_PERSON_CONTROLS: "first-person-controls";
     readonly STOP_CONFIGURE_HINT: "stop-configure-hint";
@@ -43,8 +45,10 @@ export type InteractionNotificationStore = Record<InteractionTypes, Notification
     message: string;
 }>>;
 export interface NotificationsStore {
+    [NOTIFICATIONS.MAXIMUM_LIGHTS]: NotificationData<number>;
     [NOTIFICATIONS.LOAD_IDB_CONFIG]: NotificationData<SavedIdbData<string>>;
     [NOTIFICATIONS.FIRST_PERSON_CONTROLS]: NotificationData<null>;
+    [NOTIFICATIONS.RENDERING_LIGHT]: NotificationData<null>;
     [NOTIFICATIONS.INTERACTION_NOTE]: InteractionNotificationStore;
 }
 export {};

package/src/common/composables/use-static-item-parameters.d.ts

@@ -1109,5 +1109,5 @@ export declare const useStaticItemParameters: (api: RoomlePlannerWithExtObjs, ma
             readonly __IS_SAMPLE_COLOR__: 1;
         }];
     }] | RapiMaterialGroup[]>;
-    onMaterialSelection: (element: GridViewElement<MaterialsForObjects>) => Promise<void>;
+    onMaterialSelection: (element: GridViewElement<MaterialsForObjects>, _key?: string, isCustomColor?: boolean) => Promise<void>;
 };

package/src/configurator/embedding/types.d.ts

@@ -153,6 +153,9 @@ export interface UiInitData extends InitDataDefinition, GlobalInitDataDefinition
             [INTERACTION_NOTIFICATIONS.ADD_ELEMENT]?: boolean;
             [INTERACTION_NOTIFICATIONS.PARAMETER_CHANGED]?: boolean;
         };
+        [key: string]: boolean | {
+            [key: string]: boolean | undefined;
+        } | undefined;
     };
     /**
      * @description skin the embedding instance