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

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

@@ -1,51 +1,51 @@
-## [5.29.0](https://github.com/roomle-dev/roomle-ui/compare/embedding-lib-v5.28.0...embedding-lib-v5.29.0) (2025-10-07)
+## [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
 
-* add the external object prefix to the ID if the object type is “tc_id” ([fa5188c](https://github.com/roomle-dev/roomle-ui/commit/fa5188cd5213fe7def41d5011231234df5eb4011))
-* added "respondWithPositionInPlan" argument to "loadExternalObjectGroup" ([a3fceb3](https://github.com/roomle-dev/roomle-ui/commit/a3fceb3f9449ae35372721278cac95f640dbaf28))
-* await group modification before calculating price ([8ce27c5](https://github.com/roomle-dev/roomle-ui/commit/8ce27c5e070cb75a7c1e112ebf47ffdee50f301e))
-* core api - external configuration module id map ([039de3f](https://github.com/roomle-dev/roomle-ui/commit/039de3f6ee9aaddca28f3a5ca57214f3f86cd7ba))
-* core api - external object update ([2dea816](https://github.com/roomle-dev/roomle-ui/commit/2dea81694e0257b6b2fb742d25cd5b0190ed3c23))
-* core api - object component ([bc8adfe](https://github.com/roomle-dev/roomle-ui/commit/bc8adfe0ccb6c926a083613ccc862846f7c9dcbc))
-* core api - return object when child mode is changed ([0001b31](https://github.com/roomle-dev/roomle-ui/commit/0001b31bafcb4f9085e4faf7aa1090a79dd382e1))
-* correct arrangement when swapping root modules ([6da5ed6](https://github.com/roomle-dev/roomle-ui/commit/6da5ed6c26d9524718f950ea9180b21564f7e5fa))
-* first implementation of exporters ([e1b4538](https://github.com/roomle-dev/roomle-ui/commit/e1b4538e979d03aa9966737f0b71e6b949347748))
-* glue layer - handle multiple libraries ([b91ff11](https://github.com/roomle-dev/roomle-ui/commit/b91ff11c14aa94765f6e216ccbe116acb2995bc7))
-* glue-layer group modification callback ([3437dfa](https://github.com/roomle-dev/roomle-ui/commit/3437dfa2474bfce6a06e450c8476ae4401919dda))
-* HI api - update attribute ([51d1a91](https://github.com/roomle-dev/roomle-ui/commit/51d1a91756fef48f9f1e31f4abf1c516bd876d84))
-* HI api - update attribute ([2106e97](https://github.com/roomle-dev/roomle-ui/commit/2106e9789547dab91d330715c0d1c2c2d66d5d41))
-* HI callback when group is laded from plan ([0e6392d](https://github.com/roomle-dev/roomle-ui/commit/0e6392da9989a05e744cee4afa7f981ced78a047))
-* HI group callbacks ([9e500af](https://github.com/roomle-dev/roomle-ui/commit/9e500afef9bc67db9be957f75a7bf0483f9161c5))
-* invoke HI group callbacks ([a72ddd5](https://github.com/roomle-dev/roomle-ui/commit/a72ddd5bec712b6b638df404914f7d78203fa1d7))
-* keep selection when swapping root modules ([a3cb518](https://github.com/roomle-dev/roomle-ui/commit/a3cb518466d67296f8ed73cdd3d22ada32d7f766))
-* keep the child selection when clicking on a sibling ([a2f6e1f](https://github.com/roomle-dev/roomle-ui/commit/a2f6e1f40a408075d21284b18cbbe359bccdf8f0))
-* make hi group callbacks optional ([589310e](https://github.com/roomle-dev/roomle-ui/commit/589310eb863fe9e6ecbe34443d276995e1e03afd))
-* Merge product in RD scene UI v2 (Double click to un-merge component and click to select the entire configuration) ([831e298](https://github.com/roomle-dev/roomle-ui/commit/831e298b8ebc8255ee92e3339c1c5b921af0cdd7))
-* onExternalObjectSwapRootModule request ([baafa95](https://github.com/roomle-dev/roomle-ui/commit/baafa95a89203427970b10a3ad89f3773161bd92))
-* show "swap product" button in hi example ([99c7820](https://github.com/roomle-dev/roomle-ui/commit/99c782006a191462b44a3d52a29aaea9d719a825))
-* show "undo" and "redo" buttons in hi example ([52dcda9](https://github.com/roomle-dev/roomle-ui/commit/52dcda958c82b0fc07cfa7c3342dc4f93f11c974))
-* start new interaction when parameter is changed ([176d0ac](https://github.com/roomle-dev/roomle-ui/commit/176d0ac9c2b439a08135d20a2c895ff25b499830))
-* swap root module in group ([45c3fea](https://github.com/roomle-dev/roomle-ui/commit/45c3fead5224417e22bc01f535d3da07b31c0596))
-* **core:** upgrade to version 2.61.0-alpha.1 ([540c602](https://github.com/roomle-dev/roomle-ui/commit/540c6025f6834a34b5167a6ed01e59a8ca8bdcfa))
-* **core:** upgrade to version 2.61.0-alpha.2 ([d364aff](https://github.com/roomle-dev/roomle-ui/commit/d364aff10df8e67b47900be7a7ef249546200a10))
-* **core:** upgrade to version 2.61.0-alpha.3 ([ecb1cf3](https://github.com/roomle-dev/roomle-ui/commit/ecb1cf3e8204fd74dbf11e9796978f08b61d5048))
-* **core:** upgrade to version 2.61.0-alpha.4 ([999ef76](https://github.com/roomle-dev/roomle-ui/commit/999ef767b46fbe80cbeb49aaef6d41e2b60cb3ff))
-* **core:** upgrade to version 2.61.0-alpha.6 ([101f9a8](https://github.com/roomle-dev/roomle-ui/commit/101f9a877603ef7b431145327a9d331ac8e11032))
-* **core:** upgrade to version 2.61.0-alpha.7 ([c9419cc](https://github.com/roomle-dev/roomle-ui/commit/c9419ccf703f74e87ba2184113c82ba175dae2db))
-* **core:** upgrade to version 2.61.0-alpha.8 ([03f3711](https://github.com/roomle-dev/roomle-ui/commit/03f37119298db55275bdd69e0e22534e6f7cfbbb))
+* 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
 
-* addons trigger should close open gridviews ([3fc7ba2](https://github.com/roomle-dev/roomle-ui/commit/3fc7ba2187a72f879eb468cbd0aca250fba09f48))
-* close open gridViews when selection changes in configurator ([f23c8c6](https://github.com/roomle-dev/roomle-ui/commit/f23c8c6e2f9627038d2c937db58b7edd3be4eacc))
-* configurator idb check not working ([702eb3b](https://github.com/roomle-dev/roomle-ui/commit/702eb3b0497d767853da672c9d2c5a5b078be2a6))
-* discard textures with identical mapping and keep only the first occurrence ([5f34165](https://github.com/roomle-dev/roomle-ui/commit/5f34165da80cb2d93ce095eafe4ab30ef6ff5982))
-* incorrect import ([674831f](https://github.com/roomle-dev/roomle-ui/commit/674831fd4961a69f001bf2a81a82cfd3c22da9b0))
-* new icon versions ([e1381a9](https://github.com/roomle-dev/roomle-ui/commit/e1381a922e4c6e6bad8bac01026245cd3165b0d1))
-* only allow child selection if advanced docking is enabled ([8daeb5b](https://github.com/roomle-dev/roomle-ui/commit/8daeb5bba7ce591fed4c3a5c77341cb7a61f9a84))
-* only select child if object is already selected ([e05e69b](https://github.com/roomle-dev/roomle-ui/commit/e05e69b15478fac67b6e6a980227e7c4a49dbffe))
-* remove double click handler and make merge and un-merge based on toggle the click event ([ffc7e3a](https://github.com/roomle-dev/roomle-ui/commit/ffc7e3a6aa48f8541ccaf4e0c634f78cb9cc1e17))
-* request the planning situation when a group is loaded from the plan ([f535c65](https://github.com/roomle-dev/roomle-ui/commit/f535c650dec30bcf0ab07a6a8f508382e3150072))
+* 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.29.0",
+  "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
+     */
+    onGetSavedPosGroupData?: () => Promise<PosSaveData | null>;
+    /**
+     * "onCompletelyLoaded" is invoked when the groups in the plan are completely loaded.
      */
-    onLoadPosGroup?: (posGroup: PosGroup) => Promise<boolean>;
+    onPosGroupsCompletelyLoaded?: () => void;
     /**
      * "onPosGroupAdded" is invoked when a new group was created. (e.g. duplicate object)
      * @param groupData The new group data JSON.
@@ -36,6 +65,40 @@ export interface HiCallbacks {
      * @param groupData The ID of the group which was deleted.
      */
     onPosGroupDeleted?: (posGroupIds: string[]) => Promise<void>;
+    /**
+     * "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
+     */
+    onFetchPrice?: (orderData: any) => Promise<any>;
+    /**
+     * "onPlaceOrder" is invoked when the user wants to place an order.
+     * You can use this to send the order data to Order Manager or to a 3rd party service.
+     * @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/embedding-lib/src/examples/homag-intelligence-catalog-load-async.d.ts

@@ -0,0 +1,14 @@
+import { Example } from '../example';
+import { RoomDesignerApiType } from './utils/homag-intelligence/overlay';
+
+export default class DragInExample implements Example {
+    private _abortController;
+    private _roomDesignerApi;
+    setupHtml(parent: HTMLElement): Promise<void>;
+    closeExample(): Promise<void>;
+    private start;
+    loadHiCatalogAsync(roomDesignerApi: RoomDesignerApiType): Promise<void>;
+    onRequestPlan(roomDesignerApi: RoomDesignerApiType): Promise<void>;
+    doPriceCalculation(roomDesignerApi: RoomDesignerApiType): Promise<void>;
+    runExample(): Promise<void>;
+}

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

@@ -1,5 +1,6 @@
 export declare const fetchJSONData: (url: string) => Promise<any>;
 export declare const fetchDataWithAuthorization: (url: string, type: string, property: string) => Promise<Response>;
+export declare const logInUi: (area: string, message: string, args?: (string | null)[]) => void;
 export declare const logMessage: (message: string, ...args: (string | null)[]) => void;
 export declare const logApiCall: (message: string) => void;
 export declare const logApiCallback: (message: string, ...args: (string | null)[]) => void;

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,11 +15,14 @@ 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>;
-    generatePlanSnapshot(): Promise<void>;
+    generatePlanSnapshot(): Promise<{
+        objectId: string;
+        planId: string;
+    }>;
     saveExternalObjectSnapshot(): Promise<import('../../typings/rapi-types').RapiPlanSnapshotGetDataWith3dUrls>;
     saveCurrentPlanSnapshot(): Promise<import('../../typings/rapi-types').RapiPlanSnapshotGetData>;
     renderPosDataImage(posDataJson: object): Promise<void>;

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

@@ -0,0 +1,63 @@
+import { HiCallbacks } from '../../../../embedding-lib/src/embedding-lib';
+import { GlueLogic, LibraryData, RoomDesignerRequests } from './emulator';
+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';
+
+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;
+    splitRootModuleFromGroup(splitGroup: ExternalObjectGroup, newGroupedRootModules: ExternalObjectGroup[]): void;
+    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;
+    getGroupDataForOrder(roomlePlannerId?: string): Promise<any>;
+    savePlanSnapshot(): Promise<any>;
+}
+export declare class GlueLayerResponseDebugLogging implements RoomDesignerRequests {
+    private _roomDesignerRequests;
+    private _hiCallbacks;
+    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>;
+    selectGroup(groupId: string): Promise<void>;
+    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): void;
+    deleteRootModule(rootModuleId: string): void;
+    getPosDataOfAllGroups(): Promise<PosGroup[]>;
+    getRoomInformation(): Promise<any>;
+    generatePlanSnapshot(): Promise<{
+        objectId: string;
+        planId: string;
+    }>;
+    saveExternalObjectSnapshot(): Promise<any>;
+    saveCurrentPlanSnapshot(): Promise<any>;
+}