@roomle/embedding-lib 5.30.0-alpha.1 → 5.30.0-alpha.2

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

@@ -1,35 +1,51 @@
-## [5.30.0-alpha.1](https://github.com/roomle-dev/roomle-ui/compare/embedding-lib-v5.29.0...embedding-lib-v5.30.0-alpha.1) (2025-10-08)
+## [5.30.0-alpha.2](https://github.com/roomle-dev/roomle-ui/compare/embedding-lib-v5.30.0-alpha.1...embedding-lib-v5.30.0-alpha.2) (2025-10-14)
 
 
 ### Features
 
-* core api - PlanModelViewHelper.getObjectGeometryHelpLines ([d50c692](https://github.com/roomle-dev/roomle-ui/commit/d50c69250c139dcfb1d9d469109b02ae6f359183))
-* core api - PlanObjectComponent properties ([4936555](https://github.com/roomle-dev/roomle-ui/commit/493655574ef91136049daa9b5db960018ac89663))
-* created onPlaceOrder and onFetchPrice HI callbacks ([4b48864](https://github.com/roomle-dev/roomle-ui/commit/4b48864a4dc71bb9ce14254857caace4a87ebf33))
-* hi core api 'providePossibleChildren' ([a1d96c6](https://github.com/roomle-dev/roomle-ui/commit/a1d96c673b1ec7204cab88eb55e3fc4d16f92f13))
-* HI example debug logging ([605e63b](https://github.com/roomle-dev/roomle-ui/commit/605e63b344f34d7f35d67cca357b2e1511e61a45))
-* initial working implementation ([07ba92c](https://github.com/roomle-dev/roomle-ui/commit/07ba92c20a3a0886afb5abaafdcd24b954e0fd5d))
-* reselect object if object mode changes when clicking on the object ([03b1ea4](https://github.com/roomle-dev/roomle-ui/commit/03b1ea4eb6c7f0f2a1a0eb2c6d1bd85230820a01))
-* **core:** upgrade to version 2.61.0 ([8468dff](https://github.com/roomle-dev/roomle-ui/commit/8468dff9ae43a224dd563bc53e36543b79211391))
-* **core:** upgrade to version 2.62.0-alpha.1 ([e62b7f2](https://github.com/roomle-dev/roomle-ui/commit/e62b7f278ba0cd72e97b3a0de8ad47ac04fa860a))
-* **core:** upgrade to version 2.62.0-alpha.2 ([e679883](https://github.com/roomle-dev/roomle-ui/commit/e6798835befcce2e9f8b1749275d1b62aff5d621))
-* **core:** upgrade to version 2.62.0-alpha.4 ([788fc83](https://github.com/roomle-dev/roomle-ui/commit/788fc831445b3050b5188f8fa0100d36e377b30d))
-* **core:** upgrade to version 2.62.0-alpha.5 ([c2ee7d8](https://github.com/roomle-dev/roomle-ui/commit/c2ee7d8b48e9ecfa7074d4ec88aa4678da209b51))
-* upgrade to version 2.62.0-alpha.6 ([5383e89](https://github.com/roomle-dev/roomle-ui/commit/5383e89a1382f8e9599afc920914124d6a85fead))
+* add APIs for fetching sort connections ([ad9a3a8](https://github.com/roomle-dev/roomle-ui/commit/ad9a3a84a44a786d29cf2fe46cf9e4d16d55724c))
+* add sorting for tags according to the sort connection and add API for fetching tags sort connections ([f88443d](https://github.com/roomle-dev/roomle-ui/commit/f88443d6fa1f7b543996eb3d7e5ed26c9a05a99f))
+* animate child components ([ac51699](https://github.com/roomle-dev/roomle-ui/commit/ac51699914c54e0edae5ca93971d9ae4995d712d))
+* catch all errors in external calculation script ([53cac3d](https://github.com/roomle-dev/roomle-ui/commit/53cac3d5478a167a15c375bde2469c9f5a4426a7))
+* core api - component animation transformation ([4018eaf](https://github.com/roomle-dev/roomle-ui/commit/4018eaf13fa379b04ec7712430967670a9d8c789))
+* core api - useCustomColor ([9451e6a](https://github.com/roomle-dev/roomle-ui/commit/9451e6adde09b9d0f6eb41dce61181753a037245))
+* don't show the open close button for objects that cannot be animated ([54bcd88](https://github.com/roomle-dev/roomle-ui/commit/54bcd88516add9fdb00205d1eaf77d2ff1646f74))
+* emit hi selection callbacks ([378d46d](https://github.com/roomle-dev/roomle-ui/commit/378d46de2c421a13f7ed15352f0d0f42f7aa33eb))
+* glue layer - onGroupsCompletelyLoaded callback ([f5ff385](https://github.com/roomle-dev/roomle-ui/commit/f5ff385757214ab8881ab4aad8074bed8e342098))
+* glue layer api - getExternalObjectAttributeOptions ([57e6867](https://github.com/roomle-dev/roomle-ui/commit/57e6867ead57dabb38a9f10f184d53e2c91d0f1f))
+* glue layer api - loadExternalObjectLibrary ([eb84fbc](https://github.com/roomle-dev/roomle-ui/commit/eb84fbc67cb732c116a15b818411586a0a1ff3e8))
+* glue logic selection callback handler ([cf4ca24](https://github.com/roomle-dev/roomle-ui/commit/cf4ca247e848d8a1437394e0e0af064426060d1a))
+* glue-layer api - select and delete ([6a5cdfb](https://github.com/roomle-dev/roomle-ui/commit/6a5cdfb2332211e70944b5b8df7226b5fca3de14))
+* glue-layer api - setPosDataForLoading ([3203cb6](https://github.com/roomle-dev/roomle-ui/commit/3203cb62bcdae01b5191282b76e46d4a8a55f5a1))
+* glue-layer api - updateExternalObjectAdditionalInfo ([fc55f26](https://github.com/roomle-dev/roomle-ui/commit/fc55f26e22cbd565a882e593fd3f953cc242f84c))
+* handle groups loaded from the plan XML before the library is loaded ([abae83d](https://github.com/roomle-dev/roomle-ui/commit/abae83dc533c30610ffea669b6c2cd121c756ff2))
+* hi selection logic ([8ad66a6](https://github.com/roomle-dev/roomle-ui/commit/8ad66a6d4518324ffd4495ca730d8ca7cc067abb))
+* implement featureflag, add tests ([98d57e8](https://github.com/roomle-dev/roomle-ui/commit/98d57e8da4b68a42a37f240a4d647339742fe1e5))
+* notify glue logic on set sidbar ([607d07b](https://github.com/roomle-dev/roomle-ui/commit/607d07bc2dda9a02cf3061911ba944845a2feca9))
+* only emit hi selection callbacks if something has changed ([2a21339](https://github.com/roomle-dev/roomle-ui/commit/2a21339d7d9a48e50c862229af4b7bc4bca9ab54))
+* set component animation information ([da0889a](https://github.com/roomle-dev/roomle-ui/commit/da0889a2d460465bc41e662e4cd455fa03110e4c))
+* **core:** upgrade to version 2.62.0-alpha.7 ([091a1e5](https://github.com/roomle-dev/roomle-ui/commit/091a1e54fe18e5663f13a41240e4b855c9b915cd))
+* **core:** upgrade to version 2.62.0-alpha.8 ([fb17be6](https://github.com/roomle-dev/roomle-ui/commit/fb17be6436a9279b8fd6f2ccf3d6f5b4e20906ea))
 
 
 ### Bug Fixes
 
-* add library id back to HI callbacks ([ea30779](https://github.com/roomle-dev/roomle-ui/commit/ea3077936ef79ee737b551842441358e0365db6d))
-* article ID is the fallback label for catalog item ([a5449f0](https://github.com/roomle-dev/roomle-ui/commit/a5449f069485cfb29c07231b11a868cf2c14c9cd))
-* catch hi callback exceptions ([f650511](https://github.com/roomle-dev/roomle-ui/commit/f650511d2c8fb82a545ccfa6fb5800b03b843516))
-* consider that root module is moved to a new group on undock ([c293ba8](https://github.com/roomle-dev/roomle-ui/commit/c293ba87b9652ee363d98b772fe8640a5cd6f175))
-* consider that the object may be merged on drag-end ([b033cbd](https://github.com/roomle-dev/roomle-ui/commit/b033cbd977513cca7d918e5a98d417770e01a484))
-* drag-in hi objects by id instead of serialize json ([60df0bd](https://github.com/roomle-dev/roomle-ui/commit/60df0bd3e3fc07c14f9a5aebed4f06895cc6f93e))
-* only unmerge objects if advanced docking is enabled ([2679668](https://github.com/roomle-dev/roomle-ui/commit/2679668d803351a04281ac1d7860864e9d950ae4))
-* planner external object selection callback ([e631da9](https://github.com/roomle-dev/roomle-ui/commit/e631da99153e1bba809376989af7ea73970956a2))
-* remove unused imports ([da6645c](https://github.com/roomle-dev/roomle-ui/commit/da6645c6c1a305341d1d875debbf135f62bd7134))
-* remove unused params ([e22e84e](https://github.com/roomle-dev/roomle-ui/commit/e22e84e54861ca9bc37645db09a9f80aeb63859d))
-* reset scroll on select catalog item and remove wrong icon and unneeded dark mode ([7e2339d](https://github.com/roomle-dev/roomle-ui/commit/7e2339d58d6d4c8487cec03ac1beeddbe681b433))
-* type errors ([a64197f](https://github.com/roomle-dev/roomle-ui/commit/a64197f8a1f7af9003e5b9124ba0467355b6a9a1))
-* update outdated version for playwright docker image since we update our playwright version ([58eafba](https://github.com/roomle-dev/roomle-ui/commit/58eafba6d6ae8f294288fd8175a3bf47ba672c2a))
+* check if groups have elements before rendering them in the grid view ([63a2886](https://github.com/roomle-dev/roomle-ui/commit/63a288691a167bf2c4113b24000440749b108da4))
+* consider that an element may already be removed at drag-end ([02d6ced](https://github.com/roomle-dev/roomle-ui/commit/02d6ced085b0927ed5f99f49723d66e442f2974f))
+* do not lint dist folders ([a2b73b1](https://github.com/roomle-dev/roomle-ui/commit/a2b73b19542e2c98e3c26447034f848010dda0ee))
+* failing sdk test ([83202d8](https://github.com/roomle-dev/roomle-ui/commit/83202d8a036e292edc9e390c873ff0e877f4b199))
+* identify the detached component when merging objects ([7520da4](https://github.com/roomle-dev/roomle-ui/commit/7520da4c16f2b0e82c0992055568a31a87848aba))
+* load default library id when loading homag intelligence plugin ([aeb27f3](https://github.com/roomle-dev/roomle-ui/commit/aeb27f33b6c190e4c820ee8ead76561547cee763))
+* missing nullish coalesce ([9af38ed](https://github.com/roomle-dev/roomle-ui/commit/9af38edfee4d44348c5b1ee38ca199edad9f3146))
+* move the lights high into the sky when turning them off instead of hiding them ([d8d9d1e](https://github.com/roomle-dev/roomle-ui/commit/d8d9d1e84bd5ccfd8d06a816c11252d510f2dc90))
+* only apply animations to objects to which they belong ([4401ee9](https://github.com/roomle-dev/roomle-ui/commit/4401ee9f63e8423c766c591466d93c2734761ebd))
+* separate ui event and glue layer notification ([29cfd07](https://github.com/roomle-dev/roomle-ui/commit/29cfd0781230d3e2cf77a671701dcab575056bac))
+* set HomagIntelligence in scene manager ([780c7db](https://github.com/roomle-dev/roomle-ui/commit/780c7db5c903df8c2c0dba581af6e222ede1687d))
+* sort tags in catalog level 2 structure ([f1582f8](https://github.com/roomle-dev/roomle-ui/commit/f1582f8f33cf716161b557b5e55efe2c553d29f2))
+* typing issues ([4ed0904](https://github.com/roomle-dev/roomle-ui/commit/4ed09040e040c50c6fec15f4cf59b2fc9d3de9bc))
+* use labels as a fallback for the saved tabbed nav ([145f6f0](https://github.com/roomle-dev/roomle-ui/commit/145f6f0cfd3da079858d724e3ae29a970b14676d))
+
+
+### Reverts
+
+* onComponentSelectionCancel, but notify glue logic directly ([06987bd](https://github.com/roomle-dev/roomle-ui/commit/06987bd24a8ef7bbbbb31c7559985748d55e3d07))

package/index.d.ts

@@ -1,2 +1,3 @@
+export * from './packages/embedding-lib/src/embedding-lib'
 import _default from './packages/embedding-lib/src/embedding-lib'
 export default _default

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roomle/embedding-lib",
-  "version": "5.30.0-alpha.1",
+  "version": "5.30.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/embedding-lib/src/embedding-lib.d.ts

@@ -5,21 +5,50 @@ import { default as RoomleGLBViewer } from '@roomle/web-sdk/glb-viewer-core/src/
 import { default as RoomlePlanner } from '@roomle/web-sdk/planner-core/src/roomle-planner';
 import { DragIn } from './plugins/drag-in';
 import { Connector } from './connector';
-import { MasterData, PosGroup } from '@roomle/web-sdk/homag-intelligence/src/model/oc-scripts-domain.model';
+import { MasterData, PosGroup, PosSaveData } from '@roomle/web-sdk/homag-intelligence/src/model/oc-scripts-domain.model';
 
 interface PluginMap {
     dragIn: typeof DragIn;
 }
+export declare const HI_PANEL_ACTION: {
+    readonly HIDE: "hide";
+    readonly SHOW_ATTRIBUTES: "attributes";
+    readonly SHOW_ARTICLES: "articles";
+};
+export type HiPanelActionType = typeof HI_PANEL_ACTION[keyof typeof HI_PANEL_ACTION];
 export interface HiCallbacks {
+    /**
+     * Requests the calculation script for the given library ID.
+     * @param libraryId the ID of the library for which the calculation script is requested
+     * @returns the calculation script as a string
+     */
     onLoadJavascript: (libraryId: string) => Promise<string>;
+    /**
+     * Requests the master data for the given library ID.
+     * @param libraryId the ID of the library for which the master data is requested
+     * @returns the master data as a Promise
+     */
     onLoadMasterData: (libraryId: string) => Promise<MasterData>;
+    /**
+     * Requests the article catalog for the given library ID.
+     * @param libraryId the ID of the library for which the article catalog is requested
+     * @returns the article catalog as a Promise
+     */
     onLoadArticleCatalog: (libraryId: string) => Promise<any>;
+    /**
+     * Notifies the host application that a price calculation should be performed.
+     * @param posGroups all groups in the plan
+     */
     onPriceCalc?: (posGroups: PosGroup[]) => Promise<void>;
     /**
-     * "onLoadPosGroup" is invoked when a group is loaded from a plan.
-     * @param groupData The new group data JSON.
+     * Retrieves the current external load data which has to be used to replace the existing groups in the plan.
+     * @returns load data or null if no replacement is needed
      */
-    onLoadPosGroup?: (posGroup: PosGroup) => Promise<boolean>;
+    onGetSavedPosGroupData?: () => Promise<PosSaveData | null>;
+    /**
+     * "onCompletelyLoaded" is invoked when the groups in the plan are completely loaded.
+     */
+    onPosGroupsCompletelyLoaded?: () => void;
     /**
      * "onPosGroupAdded" is invoked when a new group was created. (e.g. duplicate object)
      * @param groupData The new group data JSON.
@@ -37,12 +66,25 @@ export interface HiCallbacks {
      */
     onPosGroupDeleted?: (posGroupIds: string[]) => Promise<void>;
     /**
-     * "onLogMessage" is invoked when the Homag Intelligence library wants to log a message.
-     * You can use this to log messages in your own UI.
-     * @param area
-     * @param message
+     * "onShowHidePanel" is invoked when a the content of the side panel should be changed or hidden.
+     * @param panel The panel to show or hide.
+     * @param posGroupId Optional ID of the selected group in case of SHOW_ATTRIBUTES.
+     * @param rootModuleId Optional ID of the selected root module in case of SHOW_ATTRIBUTES.
+     * @param subModuleId Optional ID of the selected sub module in case of SHOW_ATTRIBUTES.
+     */
+    onShowHidePanel?: (panel: HiPanelActionType, posGroupId?: string, rootModuleId?: string, subModuleId?: string) => void;
+    /**
+     * "onSelectModule" is invoked when a the selected object in the scene was changed.
+     * @param posGroupId ID of the selected group
+     * @param rootModuleId ID of the selected root module
+     * @param subModuleId Optional id of the selected sub module
+     */
+    onSelectModule?: (posGroupId: string, rootModuleId: string, subModuleId?: string) => void;
+    /**
+     * Request the price for the given order data.
+     * @param orderData order data
+     * @returns price data
      */
-    onLogMessage?: (area: string, message: string) => void;
     onFetchPrice?: (orderData: any) => Promise<any>;
     /**
      * "onPlaceOrder" is invoked when the user wants to place an order.
@@ -50,6 +92,13 @@ export interface HiCallbacks {
      * @param orderData
      */
     onPlaceOrder?: (orderData: any) => Promise<void>;
+    /**
+     * "onLogMessage" is invoked when the Homag Intelligence library wants to log a message.
+     * You can use this to log messages in your own UI.
+     * @param area
+     * @param message
+     */
+    onLogMessage?: (area: string, message: string) => void;
 }
 export type AvailablePlugins = {
     [K in keyof PluginMap]?: InstanceType<PluginMap[K]>;

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

@@ -1,11 +1,12 @@
 import { default as ConfiguratorContext } from './webgl/configurator-context';
-import { DebugClient, KernelDockPairToLine, KernelDockPairToPoint, EmscriptenString, KernelComponent, KernelParameter, KernelParameterGroup, KernelVector3, PlanObject, VariantsList } from '../../typings/kernel';
+import { DebugClient, KernelDockPairToLine, KernelDockPairToPoint, 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 { AnimationLevelType } from '../../configurator-core/src/utils/animation/animation-helper';
 
 export interface ConfiguratorKernelCallbackI extends CommonConfiguratorKernelCallbackI {
     planObjectCreated(conversationId: number, planObjectId: number): void;
@@ -20,7 +21,7 @@ export interface ConfiguratorKernelCallbackI extends CommonConfiguratorKernelCal
     Editor3dComponentDocked(componentId: number, isRootComponent: boolean, parentObjectRuntimeId: number, componentPosition: KernelVector3, componentRotation: KernelVector3): void;
     finishParameterChange(resolve: () => void, reject: () => void): void;
     updateAnimationParameters(elementId: number | number[], parameters: KernelParameter[]): void;
-    changeAnimationValue(elementId: number, parameterKey: string, value: string, level: number, applyToChildren: boolean, animate: boolean): void;
+    changeAnimationValue(elementId: number, parameterKey: string, value: string, level: number, animationLevel: AnimationLevelType, animate: boolean): void;
 }
 export default class ConfiguratorKernelAccess extends CommonKernelAccess {
     private _memoryManager;
@@ -62,9 +63,10 @@ export default class ConfiguratorKernelAccess extends CommonKernelAccess {
     loadConfiguration(configuration: ConfigurationString): void;
     changeCommonComponentParameter(componentIds: number[], parameterKey: string, type: string, value: string, resolve: () => void, reject: () => void): void;
     changeComponentParameter(componentId: number, parameterKey: string, type: string, value: string, resolve: () => void, reject: () => void): void;
-    changePlanObjectParameter(planObjectId: number, parameterKey: string, type: string, value: string, resolve: () => void, reject: () => void): void;
+    changePlanObjectParameter(runtimeId: number, parameterKey: string, type: string, value: string, resolve: () => void, reject: () => void): void;
+    protected _getAnimationLevelForObject(_runtimeId: number, animation: KernelAnimation): AnimationLevelType;
     updateAnimationParameters(elementId: number | number[], parameters: KernelParameter[]): void;
-    changeAnimationValue(elementId: number, parameterKey: string, value: string, level: number, applyToChildren: boolean, animate: boolean): void;
+    changeAnimationValue(elementId: number, parameterKey: string, value: string, level: number, animationLevel: AnimationLevelType, animate: boolean): void;
     private _finishParameterChange;
     requestDeleteComponents(componentIds: number[]): void;
     requestDeletePlanComponent(componentId: number): void;

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

@@ -1,10 +1,12 @@
 import { Light, Object3D } from 'three';
 import { KernelLightSourceAttributes } from '../../../typings/kernel';
 
+export declare const LIGHT_OFF_POSITION = 999;
 export declare const generateLightSource: (lightSourceAttributes: KernelLightSourceAttributes) => Light | null;
 export declare class RoomleLightSource {
     private _lightSourceId;
     private _light;
+    private _savedPosition;
     constructor(lightSourceId: number, lightSource?: Light);
     get light(): Light;
     set light(light: Light);

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

@@ -106,6 +106,18 @@ export default class RapiAccess implements Context {
     getMaterialsOf(rapiJson: RapiJson): Promise<RapiMaterial[]>;
     getComponentsOf(rapiJson: RapiJson): Promise<RapiComponent[]>;
     getAdditionalContentsOfItems(rapiItems: RapiItem[]): Promise<RapiAdditionalContent[]>;
+    /**
+     * Fetches item connections for a specific tag and returns a map of itemId -> sort
+     * @param tagId - The tag ID to fetch connections for
+     * @returns Promise resolving to a Map of itemId to sort value
+     */
+    getItemConnectionsForTag(tagId: RapiId): Promise<Map<string, number>>;
+    /**
+     * Fetches tag connections for a specific parent tag and returns a map of tagId -> sort
+     * @param parentTagId - The parent tag ID to fetch connections for
+     * @returns Promise resolving to a Map of tagId to sort value
+     */
+    getTagConnectionsForTag(parentTagId: RapiId): Promise<Map<string, number>>;
     getMaterial(id: RapiId): Promise<RapiMaterial>;
     peekMaterial(id: RapiId): RapiMaterial;
     peekComponent(id: RapiId): RapiComponent;

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

@@ -81,6 +81,10 @@ export interface GlobalInitDataDefinition {
 export interface FeatureFlags {
     pulsePreview?: boolean;
     reDock?: boolean;
+    /**
+     * @description Sets whether the snapping behavior of objects in the planner is initially enabled.
+     */
+    enableSnapping?: boolean;
     /**
      * @description If set to true we will not hide other items while configuring in the planner
      */

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

@@ -9,6 +9,7 @@ import { default as InitData } from '../utils/init-data';
 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 {
@@ -51,10 +52,10 @@ export default class ConfiguratorViewModel implements ConfiguratorKernelCallback
     private _applyMeshTransform;
     private _applyMeshUVTransform;
     updateAnimationParameters(elementId: number | number[], parameters: KernelParameter[]): void;
-    changeAnimationValue(elementId: number, parameterKey: string, value: string, level: number, applyToChildren: boolean, animate: boolean): void;
+    changeAnimationValue(elementId: number, parameterKey: string, value: string, level: number, animationLevel: AnimationLevelType, animate: boolean): void;
     saveExternalConfiguration(externalConfiguration: ExternalConfiguration): void;
     getExternalConfigurationById(id: string): ExternalConfiguration;
-    private getComponentFromElementId;
+    getComponentFromRuntimeId(elementId: number): RoomleComponent | null;
     private _addMeshToSubPart;
     private _addMeshToComponent;
     private _changeMeshOfComponent;

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

@@ -22,6 +22,7 @@ export interface RoomleComponent extends RoomleEventedObject3D {
     hash: string;
     geometryChanged: boolean;
     animationValueMap?: AnimationValueMap;
+    get childComponents(): RoomleComponent[];
     replaceMeshes(meshes: Mesh[]): void;
     addMesh(mesh: Mesh, transform?: Float32Array): void;
     removeMesh(mesh: Mesh): void;

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

@@ -1,5 +1,18 @@
+import { default as ConfiguratorPlanObjectViewModel } from '../../../../common-core/src/view-model/configurator-plan-object-view-model';
 import { RoomleComponent } from '../../../../common-core/src/webgl/roomle-component-factory';
-import { KernelParameter } from '../../../../typings/kernel';
+import { default as PlannerSceneManager } from '../../../../planner-core/src/webgl/planner-scene-manager';
+import { AnimationKeyAndValue } from './animation-value-map';
+import { ComponentAnimationTransformation, KernelParameter } from '../../../../typings/kernel';
 
+export declare const ANIMATION_LEVEL: {
+    readonly COMPONENT: 0;
+    readonly OBJECT_COMPONENT: 1;
+    readonly OBJECT: 2;
+};
+export type AnimationLevelType = (typeof ANIMATION_LEVEL)[keyof typeof ANIMATION_LEVEL];
 export declare const updateComponentAnimationParameters: (components: RoomleComponent[], parameters: KernelParameter[]) => void;
-export declare const changeComponentAnimationValueAndAnimate: (component: RoomleComponent, parameterKey: string, value: string, level: number, animate: boolean, invalidateRenderCallback: () => void) => 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 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/animation-value-map.d.ts

@@ -1,15 +1,17 @@
 import { KernelParameter } from '../../../../typings/kernel';
 
 export declare const ANIMATION_PARAMETER_PREFIX = "animation:";
+export interface AnimationKeyAndValue {
+    key: string;
+    value: string;
+}
 export declare class AnimationValueMap {
     private valueMap;
     static filterAnimationParameters(parameters: KernelParameter[]): KernelParameter[];
     static getAnimationName(parameterKey: string): string;
-    static getKeyAndValue(animationName: string): {
-        key: string;
-        value: string;
-    };
+    static getKeyAndValue(animationName: string): AnimationKeyAndValue;
     hasKeyAndValue(animationKeyAndValue: string): boolean;
+    getParameterValue(animationName: string): AnimationKeyAndValue | null;
     updateParameterValue(parameter: KernelParameter): void;
     setValue(animationName: string, value: string, level: number): void;
     setValueAndGetOldValue(animationName: string, value: string, level: number): string;

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

@@ -13,8 +13,10 @@ export declare class ObjectAnimations {
     static setObjectAnimations(object3d: Object3D, animations?: Record<string, KernelMeshAnimation>, component?: RoomleComponent): void;
     static addObjectAnimations(object3d: Object3D, animations?: AnimationTransformationMap, component?: RoomleComponent): void;
     static removeObjectAnimations(object3d: Object3D, animationName: string): void;
-    static animateObject(object3d: Object3D, animationName: string, animationTransition: AnimationTransition, animate?: boolean, onProgressUpdate?: () => void): import('@tweenjs/tween.js').Tween<any>;
+    static removeAllObjectAnimations(object3d: Object3D): void;
+    static animateObject(object3d: Object3D, animationName: string, animationTransition: AnimationTransition, subsequentAnimation?: boolean, animate?: boolean, onProgressUpdate?: () => void): import('@tweenjs/tween.js').Tween<any>;
     private _animate;
+    private _makePriorTransformation;
     private _calculateCombinedAnimationMatrix;
     private _calculateAnimationTransformation;
     private _animateMesh;

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

@@ -23,6 +23,7 @@ import { default as GlobalInitData } from '../../../common-core/src/utils/global
 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';
 
 export default class ConfiguratorSceneManager extends SceneManager implements ConfiguratorViewModelCallbackI {
     _creator_: string;
@@ -136,7 +137,7 @@ export default class ConfiguratorSceneManager extends SceneManager implements Co
     private _onSelectedRuntimeComponentsChange;
     private _onSelectedRuntimeComponentChange;
     requestDeleteSelectedComponent(): void;
-    componentUpdated(component: RoomleComponent, _kernelComponent: KernelComponent): void;
+    componentUpdated(component: RoomleComponent, kernelComponent: KernelComponent): void;
     planObjectUpdated(planObject: PlanObject, geometryChanged: boolean, pendingDocking: boolean): void;
     componentDeleted(component: RoomleComponent): void;
     previewConstructionDone(_component: RoomleComponent, hasPreviews: boolean): void;
@@ -167,7 +168,8 @@ export default class ConfiguratorSceneManager extends SceneManager implements Co
     protected _shouldRenderUi(): boolean;
     protected setEventHandlerObject(object: Object3D): void;
     protected _readyForRender(): void;
-    animateElement(elementId: number, parameterName: string, value: string, applyToChildren: boolean, animate: boolean): void;
+    getComponentFromRuntimeId(elementId: number): RoomleComponent | null;
+    animateElement(elementId: number, parameterName: string, value: string, animationLevel: AnimationLevelType, animate: boolean): void;
     undo(): Promise<void>;
     redo(): Promise<void>;
     clearHistory(): void;

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

@@ -15,7 +15,7 @@ export declare class RoomDesignerApi implements RoomDesignerRequests {
     selectRoot(rootModuleId: string): Promise<void>;
     selectModule(rootModuleId: string, subModuleId: string): Promise<void>;
     openCloseGroup(groupOrRootModuleId: string, subModuleId: string | null, open: boolean, animate: boolean): Promise<void>;
-    deleteGroup(groupId: string, wasMerged?: boolean): void;
+    deleteGroup(groupId: string): void;
     deleteRootModule(rootModuleId: string): void;
     getPosDataOfAllGroups(): Promise<PosGroup[]>;
     getRoomInformation(): Promise<import('../../planner-core/src/external-object-api').ExternalRoomInformation>;

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

@@ -1,16 +1,22 @@
 import { HiCallbacks } from '../../../../embedding-lib/src/embedding-lib';
-import { GlueLogic, RoomDesignerRequests } from './emulator';
+import { GlueLogic, LibraryData, RoomDesignerRequests } from './emulator';
 import { ExternalObjectGroup } from 'roomle-core-hsc/src/embind/plannerCoreInterface';
 import { ExternalModuleInformation } from '../../typings/kernel';
-import { PosGroup } from './model/oc-scripts-domain.model';
+import { CheckResult, PosGroup, PosSaveData } from './model/oc-scripts-domain.model';
 import { ExternalObjectModuleIdMap } from './api';
+import { HiObjectSelection } from './hi-object-selection';
 
 export declare class GlueLayerRequestDebugLogging implements GlueLogic {
     private _glueLogic;
     private _hiCallbacks;
     constructor(glueLogic: GlueLogic, hiCallbacks: HiCallbacks);
     get hiCallbacks(): HiCallbacks | null;
+    get hiObjectSelection(): HiObjectSelection;
     private _logRequest;
+    isLibraryLoaded(libraryId: string): boolean;
+    getLibraryData(libraryId: string): LibraryData | null;
+    addLibrary(libraryData: LibraryData): void;
+    setPosDataForLoading(posData: PosSaveData | null): void;
     loadPosData(articleCatalogJson: any, libraryId: string): void;
     mergeGroups(targetGroup: ExternalObjectGroup, idsOfGroupsMerged: string | string[], idOfTargetRootModule: string): void;
     deleteRootModule(remainingGroup: ExternalObjectGroup, rootModuleIdToDelete: string, splitOffGroups: ExternalObjectGroup[]): void;
@@ -18,12 +24,15 @@ export declare class GlueLayerRequestDebugLogging implements GlueLogic {
     duplicateGroup(sourceGroupId: string, duplicatedGroup: ExternalObjectGroup): void;
     modifyAttribute(groupId: string, moduleIdObjects: ExternalModuleInformation[], attributeName: string, value: string): void;
     updateAttribute(rootModuleId: string, moduleId: string, 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;
     removedGroup(groupId: string): void;
     openCloseGroup(groupId: string): void;
     newPosDataFromId(id: string): PosGroup | undefined;
@@ -41,7 +50,7 @@ export declare class GlueLayerResponseDebugLogging implements RoomDesignerReques
     selectRoot(rootModuleId: string): Promise<void>;
     selectModule(rootModuleId: string, subModuleId: string): Promise<void>;
     openCloseGroup(groupOrRootModuleId: string, subModuleId: string | null, open: boolean, animate: boolean): Promise<void>;
-    deleteGroup(groupId: string, wasMerged?: boolean): void;
+    deleteGroup(groupId: string): void;
     deleteRootModule(rootModuleId: string): void;
     getPosDataOfAllGroups(): Promise<PosGroup[]>;
     getRoomInformation(): Promise<any>;

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

@@ -1,7 +1,8 @@
 import { HiCallbacks } from '../../../../embedding-lib/src/embedding-lib';
 import { ExternalModuleInformation, ExternalObjectGroup } from './callbacks';
-import { MasterData, PosModuleAttribute, PosGroup, PosModuleData, PosModuleRootData } from './model/oc-scripts-domain.model';
+import { MasterData, PosModuleAttribute, PosGroup, PosModuleData, CheckResult, PosSaveData } from './model/oc-scripts-domain.model';
 import { ExternalObjectModuleIdMap } from './api';
+import { HiObjectSelection } from './hi-object-selection';
 
 export interface LibraryData {
     libraryId: string;
@@ -9,7 +10,7 @@ export interface LibraryData {
     get posGroupVersion(): number;
     calculateGroup(posGroup: PosGroup): PosGroup;
     getOrderData(posGroup: PosGroup[], roomlePlannerId?: string): any;
-    getAttributesDropDownValues(module: PosModuleRootData): Promise<any>;
+    getAttributesDropDownValues(module: PosModuleData, attributeIds?: string | string[]): Promise<Record<string, any[]>>;
     solveModuleAttributeConflict(module: PosModuleData, attributeName: string, value: string | number | boolean): PosModuleAttribute[] | undefined;
 }
 export interface RoomDesignerRequests {
@@ -19,7 +20,7 @@ export interface RoomDesignerRequests {
     selectRoot(rootModuleId: string): Promise<void>;
     selectModule(rootModuleId: string, subModuleId: string): Promise<void>;
     openCloseGroup(groupOrRootModuleId: string, subModuleId: string | null, open: boolean, animate: boolean): void;
-    deleteGroup(groupId: string, wasMerged?: boolean): void;
+    deleteGroup(groupId: string): void;
     deleteRootModule(rootModuleId: string): void;
     getPosDataOfAllGroups(): Promise<PosGroup[]>;
     getRoomInformation(): Promise<any>;
@@ -32,6 +33,11 @@ export interface RoomDesignerRequests {
 }
 export interface GlueLogic {
     hiCallbacks: HiCallbacks | null;
+    hiObjectSelection: HiObjectSelection;
+    isLibraryLoaded(libraryId: string): boolean;
+    getLibraryData(libraryId: string): LibraryData | null;
+    addLibrary(libraryData: LibraryData): void;
+    setPosDataForLoading(posData: PosSaveData | null): void;
     loadPosData(articleCatalogJson: any, libraryId: string): void;
     mergeGroups(targetGroup: ExternalObjectGroup, idsOfGroupsMerged: string | string[], idOfTargetRootModule: string): void;
     deleteRootModule(remainingGroup: ExternalObjectGroup, rootModuleIdToDelete: string, splitOffGroups: ExternalObjectGroup[]): void;
@@ -39,12 +45,15 @@ export interface GlueLogic {
     duplicateGroup(sourceGroupId: string, duplicatedGroup: ExternalObjectGroup): void;
     modifyAttribute(groupId: string, moduleIdObjects: ExternalModuleInformation[], attributeName: string, value: string): void;
     updateAttribute(rootModuleId: string, moduleId: string, 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;
     removedGroup(groupId: string): void;
     openCloseGroup(groupId: string): void;
     newPosDataFromId(id: string): PosGroup | undefined;
@@ -65,19 +74,25 @@ interface GroupItem {
 export declare class Emulator implements GlueLogic {
     private _designerRequests;
     private _libraryData;
+    private _posDataForLoading;
     private _posDataJsonMap;
     private _groupMap;
     private _nextPosDataId;
     private _hiCallbacks;
-    constructor(designerRequests: RoomDesignerRequests, libraryData: LibraryData, hiCallbacks?: HiCallbacks | null);
+    private _hiObjectSelection;
+    private _pendingGroupsToBeLoaded;
+    private _planCompletelyLoaded;
+    constructor(designerRequests: RoomDesignerRequests, hiCallbacks?: HiCallbacks | null);
     get hiCallbacks(): HiCallbacks | null;
-    getLibraryData(libraryId: string): LibraryData | null;
+    get hiObjectSelection(): HiObjectSelection;
+    getLibraryData(data: string | PosGroup): LibraryData | null;
+    isLibraryLoaded(libraryId: string): boolean;
     addLibrary(libraryData: LibraryData): void;
     loadPosData(articleCatalogJson: any, libraryId: string): void;
+    setPosDataForLoading(posData: PosSaveData | null): void;
     newPosDataFromId(id: string): any;
     deleteGroup(groupId: string): Promise<void>;
     selectGroup(groupId: string): Promise<void>;
-    selectCheckAttributes(libraryId: string, root: PosModuleRootData): Promise<void>;
     selectRoot(_groupId: any, rootId: string): Promise<void>;
     deleteRoot(_groupId: any, rootId: string): Promise<void>;
     selectSubModule(_groupId: any, rootId: string, moduleId: string): Promise<void>;
@@ -91,7 +106,12 @@ export declare class Emulator implements GlueLogic {
     removedGroup(groupId: string): void;
     changedGroup(posDataJson: PosGroup): void;
     changedGroupPlanningSituation(changedGroup: ExternalObjectGroup): void;
-    loadedGroup(posDataJson: PosGroup): Promise<void>;
+    loadedGroup(posDataJson: PosGroup): void;
+    private _loadPendingGroup;
+    private _loadedGroup;
+    _recalculateLoadedGroup(posDataJson: PosGroup): void;
+    groupsCompletelyLoaded(): void;
+    private _groupsCompletelyLoaded;
     getGroupDataForOrder(roomlePlannerId?: string): Promise<any>;
     private _setGroupContour;
     private _setGroupPosition;
@@ -100,16 +120,23 @@ export declare class Emulator implements GlueLogic {
     private _splitOffGroupsFromGroups;
     private _splitOffRootModulesFromGroup;
     private _calculateNewGroup;
+    private _getLibraryIdForPosData;
     private _calculate;
+    private _populateRootFromMasterData;
+    private _setSubmoduleImages;
     private _calculateAndUpdateGroupMap;
     private _addNewGroup;
     private _addGroupToMap;
     updateAttribute(rootModuleId: string, moduleId: string, attributeId: string, attributeValue: string | boolean): void;
     modifyAttribute(groupId: string, moduleIdObjects: ExternalModuleInformation[], attributeName: string, value: string): 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;
     _modifyAttributeOfModules(emulatorGroupItem: GroupItem, moduleIds: string[] | string, attributeName: string, value: string | boolean): PosGroup;
     private _setAttribute;
     savePlanSnapshot(): Promise<PlanSnapshot>;
+    private _findRootModuleInAllGroups;
+    private _findModuleInAllGroups;
     private _findModule;
     private _replacesIDs;
     private _replacesModuleIDs;