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

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

@@ -1,6 +1,27 @@
-## [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.2](https://github.com/roomle-dev/roomle-ui/compare/embedding-lib-v5.31.0-alpha.1...embedding-lib-v5.31.0-alpha.2) (2025-10-28)
+
+
+### Features
+
+* change the look and feel of the normal dimensions ([70a4944](https://github.com/roomle-dev/roomle-ui/commit/70a4944068b402c0dcf5311c0d502c6fd756d502))
+* core api - docking preview ([b59ebcb](https://github.com/roomle-dev/roomle-ui/commit/b59ebcb47c245dc08e2c4df1a0eb61ff4a6601be))
+* implement camera-aware dimension line positioning ([4f43eb4](https://github.com/roomle-dev/roomle-ui/commit/4f43eb487bef2ef43384a655f1231f8a1a8c7769))
+* insert item from external catalog on click ([4ea3635](https://github.com/roomle-dev/roomle-ui/commit/4ea3635a8fad46ba08de383320bdee0f8fbfb64d))
+* swap object in plan with item from external catalog ([aff3317](https://github.com/roomle-dev/roomle-ui/commit/aff3317d1129cca74b0693c5642a535ff9904795))
+* **core:** upgrade to version 2.63.0-alpha.5 ([8728856](https://github.com/roomle-dev/roomle-ui/commit/87288561dd628c775b70211c5566008fae77a16c))
+* **core:** upgrade to version 2.63.0-alpha.6 ([4194874](https://github.com/roomle-dev/roomle-ui/commit/4194874530ec7dcef5a15f52a8d76ec125f4cdf2))
 
 
 ### Bug Fixes
 
-* loading of multiple catalogs via init data url ([a8e816e](https://github.com/roomle-dev/roomle-ui/commit/a8e816eb2373830e750cc0f5c878bdb7c062c45d))
+* checked style ([736ff22](https://github.com/roomle-dev/roomle-ui/commit/736ff229985f3648e8cbda733129003aa810a2d4))
+* e2e tests ([84907b4](https://github.com/roomle-dev/roomle-ui/commit/84907b4d7ccdae1f174db714744f6a2973d8ce3b))
+* element length scaling ([4259eec](https://github.com/roomle-dev/roomle-ui/commit/4259eec32f83370f018aca72dc3ff97f80285d52))
+* feedback fixes ([56d4d74](https://github.com/roomle-dev/roomle-ui/commit/56d4d746e529f0d623626c1cc34218f8b4e780db))
+* hide the rotation icon on subcomponents in the planner ([a0e6c31](https://github.com/roomle-dev/roomle-ui/commit/a0e6c31b7bcd02e728b378ef706db0ecad5c79c2))
+* implement catalog management UX feedback ([eef28b4](https://github.com/roomle-dev/roomle-ui/commit/eef28b406a58df1a433d33423de760eb73532e4b))
+* merge conflicts ([8b891dd](https://github.com/roomle-dev/roomle-ui/commit/8b891ddf2c7641eda01eeb459e8cab1051c255c1))
+* remove unneeded comments ([ac8784f](https://github.com/roomle-dev/roomle-ui/commit/ac8784fc643d7c4e2b1ce0c46d225d67846dc67b))
+* replace generic inputs ([30e6acb](https://github.com/roomle-dev/roomle-ui/commit/30e6acbfe22858665606b3f33fcc17411f8ed676))
+* return return null if plan snapshot doesn't exist ([ba6d95c](https://github.com/roomle-dev/roomle-ui/commit/ba6d95c87260ebfa52b9a19368dfba33b08fb103))
+* use possible children component ([162e2e5](https://github.com/roomle-dev/roomle-ui/commit/162e2e505058d3aaeea104482da0cb3cc192e6a3))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roomle/embedding-lib",
-  "version": "5.30.1",
+  "version": "5.31.0-alpha.2",
   "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/design-system/build-webcomponents.d.ts

@@ -0,0 +1,5 @@
+
+declare const RadioToggle: import('vue').VueElementConstructor<unknown>;
+declare const RadioOption: import('vue').VueElementConstructor<unknown>;
+declare const BooleanToggle: import('vue').VueElementConstructor<unknown>;
+export { RadioToggle, RadioOption, BooleanToggle };

package/packages/design-system/src/utils/shadow-dom.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Checks if an element is inside a Shadow DOM (web component context)
+ * @param element - The HTML element to check
+ * @returns true if the element is inside a Shadow DOM, false otherwise
+ */
+export declare const inShadowDOM: (element: HTMLElement) => boolean;

package/packages/design-system/src/utils/toggle.d.ts

@@ -0,0 +1,19 @@
+/** Symbol key for providing/injecting radio toggle context */
+export declare const RADIO_TOGGLE_CONTEXT_KEY: unique symbol;
+/** Event name for radio group change events */
+export declare const RADIO_GROUP_CHANGE_EVENT = "rml-ds-radio-group-change";
+/** Detail data structure for radio group change events */
+export interface RadioGroupChangeDetail<T = any> {
+    value: T;
+    radioName: string;
+    sourceInput: HTMLInputElement;
+    labelElement: Element | null;
+    optionElement: HTMLInputElement;
+}
+/** Custom event type for radio group changes */
+export type RadioGroupChangeEvent<T = any> = CustomEvent<RadioGroupChangeDetail<T>>;
+/**
+ * Injects CSS variables for the design system toggle components
+ * This function ensures CSS tokens are only injected once into the document head
+ */
+export declare const injectCSSVariables: () => void;

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/embedding-lib/src/examples/utils/homag-intelligence/drag-in.d.ts

@@ -1,3 +1,4 @@
 import { RoomDesignerApiType } from './overlay';
 
+export declare const addClickEventListeners: (roomDesignerApi: RoomDesignerApiType, signal: AbortSignal, element?: HTMLElement | null) => void;
 export declare const addDragEventListeners: (roomDesignerApi: RoomDesignerApiType, catalogElements: NodeListOf<Element> | Element[], signal: AbortSignal, element?: HTMLElement | null) => void;

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, KernelDockPairPreview, 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 {
@@ -14,8 +14,7 @@ export interface ConfiguratorKernelCallbackI extends CommonConfiguratorKernelCal
     planObjectConfigurationUpdated(planObjectId: number, configuration: ConfigurationString, hash: string, pendingDocking: boolean): void;
     configurationLoaded(conversationId: number, objectId: number, componentId: number, hash: string, errors: any): void;
     Editor3dAddDockPreview(componentId: number, previewId: number): void;
-    Editor3dSetPreviewPointAssociations(dockPairs: KernelDockPairToPoint[], previewId: number): void;
-    Editor3dSetPreviewLineAssociations(dockLines: KernelDockPairToLine[], previewId: number): void;
+    Editor3dSetPreviewAssociations(dockPairs: KernelDockPairPreview[], previewId: number): void;
     Editor3dPreviewConstructionDone(componentId: number, objectId: number): void;
     Editor3dPlanObjectConstructionDone(planObjectId: number): void;
     Editor3dComponentDocked(componentId: number, isRootComponent: boolean, parentObjectRuntimeId: number, componentPosition: KernelVector3, componentRotation: KernelVector3): void;
@@ -106,8 +105,7 @@ export default class ConfiguratorKernelAccess extends CommonKernelAccess {
     Editor3dSetMaterial(): void;
     Editor3dLoadMaterial(): void;
     Editor3dAddDockPreview(componentId: number, previewId: number): void;
-    Editor3dSetPreviewPointAssociations(dockPairs: KernelDockPairToPoint[], previewId: number): void;
-    Editor3dSetPreviewLineAssociations(dockLines: KernelDockPairToLine[], previewId: number): void;
+    Editor3dSetPreviewAssociations(dockPairs: KernelDockPairPreview[], previewId: number): void;
     Editor3dPreviewConstructionDone(componentId: number, objectId: number): void;
     Editor3dTranslateBy(): void;
     Editor3dRotateBy(): void;
@@ -142,6 +140,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/utils/threejs-utils.d.ts

@@ -88,6 +88,9 @@ export declare const createEmptySceneFromCurrent: (currentScene: Scene) => Scene
 export declare const isBox3InFrustum: (camera: Camera, box3: Box3) => boolean;
 export type RoomleEventedMesh = Mesh<BufferGeometry<NormalBufferAttributes>, Material | Material[], Object3DRoomleEventMap>;
 export type RoomleEventedObject3D = Object3D<Object3DRoomleEventMap>;
+export interface RoomleEventedObject3DSubComponent extends RoomleEventedObject3D {
+    parentComponent?: RoomleEventedObject3D;
+}
 export type RoomleEventedIntersection = Intersection<RoomleEventedObject3D>;
 interface InputEventAttatchment {
     intersection: RoomleEventedIntersection;

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

@@ -1,6 +1,6 @@
 import { RoomleComponent, PreviewComponent, PreviewLineComponent, RoomleComponentFactory } from '../../../common-core/src/webgl/roomle-component-factory';
 import { ConfiguratorKernelCallbackI } from '../configurator-kernel-access';
-import { KernelComponent, KernelDockPairToLine, KernelDockPairToPoint, KernelEnum, KernelLightSourceAttributes, KernelMeshAttributes, KernelMeshBuffer, KernelParameter, KernelVector3, PlanObject } from '../../../typings/kernel';
+import { KernelComponent, KernelDockPairPreview, KernelEnum, KernelLightSourceAttributes, KernelMeshAttributes, KernelMeshBuffer, KernelParameter, KernelVector3, PlanObject } from '../../../typings/kernel';
 import { ConfigurationString } from '../../../typings/rapi-types';
 import { Context } from '../di/context';
 import { default as ConfiguratorContext } from '../webgl/configurator-context';
@@ -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;
@@ -90,8 +87,9 @@ export default class ConfiguratorViewModel implements ConfiguratorKernelCallback
     Editor3dGeometryNotReady(id: number): void;
     Editor3dPlanObjectConstructionDone(planObjectId: number): void;
     Editor3dPreviewConstructionDone(componentId: number, _objectId: number): void;
-    Editor3dSetPreviewLineAssociations(dockLines: KernelDockPairToLine[], previewId: number): void;
-    Editor3dSetPreviewPointAssociations(dockPairs: KernelDockPairToPoint[], previewId: number): void;
+    private _setPreviewLineAssociations;
+    Editor3dSetPreviewAssociations(dockPairs: KernelDockPairPreview[], previewId: number): void;
+    private _setPreviewPointAssociations;
     private _addDockPreviewAnimation;
     componentDeleted(componentId: number): void;
     componentMetaUpdated(kernelComponent: KernelComponent): void;

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/animation/drag-insert-animation.d.ts

@@ -1,5 +1,5 @@
 import { PreviewComponent, RoomleComponent } from '../../../../common-core/src/webgl/roomle-component-factory';
-import { KernelDockPairToPoint } from '../../../../typings/kernel';
+import { KernelDockPairPreview } from '../../../../typings/kernel';
 
 export declare class DragInsertAnimation {
     private _id;
@@ -8,7 +8,7 @@ export declare class DragInsertAnimation {
     private _displacementTransformation;
     private _invalidateRenderCallback;
     private _currentAnimation;
-    constructor(id: string, previewComponent: PreviewComponent, displacedComponents: RoomleComponent, dockPair: KernelDockPairToPoint, invalidateRenderCallback: () => void);
+    constructor(id: string, previewComponent: PreviewComponent, displacedComponents: RoomleComponent, dockPair: KernelDockPairPreview, invalidateRenderCallback: () => void);
     private _addObjectAnimationTransformations;
     private _addObjectAnimationValue;
     startInsert(): void;

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

@@ -2,47 +2,60 @@ 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;
+    opacity?: number;
+}
 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 _mainLineMaterial;
+    private _widthLineGroup;
+    private _heightLineGroup;
+    private _depthLineGroup;
     private _enabled;
     private _dimensionsVisible;
     private _dimensionLineGroup;
-    private _dimensionTextGroup;
+    private _onLabelsUpdate;
     constructor(creator: string);
+    private _createLineGroup;
+    private _createLineFromConfig;
+    private _updateLineGroup;
     private _loaded;
+    onLabelsUpdate(callback: (labels: DimensionLabelUIData[]) => void): void;
     private _performUpdate;
+    private _updateMaterialOpacity;
+    private _getCameraDistanceInfo;
     private _updateWidth;
     private _updateHeight;
     private _updateDepth;
+    private _getWidthLineConfig;
+    private _getDepthLineConfig;
+    private _getHeightLineConfig;
+    /**
+     * Helper to get camera position in the dimension line group's local space
+     */
+    private _getLocalCameraPosition;
     updateSize(boxForMeasurement: KernelCube): void;
     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;
-    private _getHeightEdge;
     onDimensionsVisibilityChanged(handler: (visible: boolean) => void): void;
     enableTopDimensions(): void;
     disableTopDimensions(): void;
@@ -56,7 +69,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, PlanSnapshot, 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;
@@ -21,15 +21,14 @@ export declare class GlueLayerRequestDebugLogging implements GlueLogic {
     mergeGroups(targetGroup: ExternalObjectGroup, idsOfGroupsMerged: string | string[], idOfTargetRootModule: string): void;
     deleteRootModule(remainingGroup: ExternalObjectGroup, rootModuleIdToDelete: string, splitOffGroups: ExternalObjectGroup[]): void;
     splitRootModuleFromGroup(splitGroup: ExternalObjectGroup, newGroupedRootModules: ExternalObjectGroup[]): void;
-    duplicateGroup(sourceGroupId: string, duplicatedGroup: ExternalObjectGroup): void;
+    duplicateGroup(duplicatedGroup: ExternalObjectGroup): void;
     modifyAttribute(groupId: string, moduleIdObjects: ExternalModuleInformation[], attributeName: string, value: string): void;
-    updateAttribute(rootModuleId: string, moduleId: string, attributeId: string, attributeValue: string | boolean): void;
+    updateAttribute(rootModuleId: string, moduleId: string | null, attributeId: string, attributeValue: string | boolean): void;
     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;
     arrangeRootModulesOfGroup(changedGroup: ExternalObjectGroup): void;
     changedGroupPlanningSituation(changedGroup: ExternalObjectGroup): void;
-    deleteGroup(groupId: string): Promise<void>;
     changedGroup(posDataJson: PosGroup): void;
     loadedGroup(posDataJson: PosGroup): void;
     groupsCompletelyLoaded(): void;
@@ -37,7 +36,7 @@ export declare class GlueLayerRequestDebugLogging implements GlueLogic {
     openCloseGroup(groupId: string): void;
     newPosDataFromId(id: string): PosGroup | undefined;
     getGroupDataForOrder(roomlePlannerId?: string): Promise<any>;
-    savePlanSnapshot(): Promise<any>;
+    savePlanSnapshot(): Promise<PlanSnapshot | null>;
 }
 export declare class GlueLayerResponseDebugLogging implements RoomDesignerRequests {
     private _roomDesignerRequests;
@@ -45,7 +44,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>;