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

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

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

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

@@ -1,8 +1,8 @@
 import { HiCallbacks } from '../../../../embedding-lib/src/embedding-lib';
 import { ExternalModuleInformation, ExternalObjectGroup } from './callbacks';
 import { MasterData, PosModuleAttribute, PosGroup, PosModuleData, CheckResult, PosSaveData } from './model/oc-scripts-domain.model';
-import { ExternalObjectModuleIdMap } from './api';
 import { HiObjectSelection } from './hi-object-selection';
+import { LoadExternalObjectOptions } from './external-object-api';
 
 export interface LibraryData {
     libraryId: string;
@@ -15,7 +15,7 @@ export interface LibraryData {
 }
 export interface RoomDesignerRequests {
     loadMasterData(masterData: MasterData): void;
-    loadPosGroups(posDataJson: PosGroup | PosGroup[], findFreeSpaceInPlan: boolean, verifyArrangement: boolean, mergedGroups?: string[], respondWithPositionInPlan?: boolean, moduleIdMap?: ExternalObjectModuleIdMap[]): Promise<void>;
+    loadPosGroups(posDataJson: PosGroup | PosGroup[], options: LoadExternalObjectOptions): Promise<void>;
     selectGroup(groupId: string): Promise<void>;
     selectRoot(rootModuleId: string): Promise<void>;
     selectModule(rootModuleId: string, subModuleId: string): Promise<void>;
@@ -42,15 +42,14 @@ export interface 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;
+    swapRootModule(groupId: string, rootModuleId: string, articleId: string): 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;
@@ -58,7 +57,7 @@ export interface GlueLogic {
     openCloseGroup(groupId: string): void;
     newPosDataFromId(id: string): PosGroup | undefined;
     getGroupDataForOrder(roomlePlannerId?: string): Promise<any>;
-    savePlanSnapshot(): Promise<PlanSnapshot>;
+    savePlanSnapshot(): Promise<PlanSnapshot | null>;
 }
 export interface PlanSnapshot {
     id: string;
@@ -71,7 +70,7 @@ interface GroupItem {
     posDataJson: PosGroup;
     opened: boolean;
 }
-export declare class Emulator implements GlueLogic {
+export declare class GlueLogicImplementation implements GlueLogic {
     private _designerRequests;
     private _libraryData;
     private _posDataForLoading;
@@ -85,20 +84,20 @@ export declare class Emulator implements GlueLogic {
     constructor(designerRequests: RoomDesignerRequests, hiCallbacks?: HiCallbacks | null);
     get hiCallbacks(): HiCallbacks | null;
     get hiObjectSelection(): HiObjectSelection;
+    private _getGroup;
     getLibraryData(data: string | PosGroup): LibraryData | null;
     isLibraryLoaded(libraryId: string): boolean;
     addLibrary(libraryData: LibraryData): void;
     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>;
     selectRoot(_groupId: any, rootId: string): Promise<void>;
     deleteRoot(_groupId: any, rootId: string): Promise<void>;
     selectSubModule(_groupId: any, rootId: string, moduleId: string): Promise<void>;
     openCloseGroup(groupId: string): Promise<void>;
     deleteRootModule(remainingGroup: ExternalObjectGroup, rootModuleIdToDelete: string, splitOffGroups: ExternalObjectGroup[]): void;
-    duplicateGroup(_sourceGroupId: string, duplicatedGroup: ExternalObjectGroup): Promise<void>;
+    duplicateGroup(duplicatedGroup: ExternalObjectGroup): void;
     mergeGroups(targetGroup: ExternalObjectGroup, idsOfGroupsMerged: string | string[], idOfTargetRootModule: string): void;
     private _applyImplicitRelevantAttributes;
     splitRootModuleFromGroup(splitGroup: ExternalObjectGroup, newGroupedRootModules: ExternalObjectGroup[]): void;
@@ -127,14 +126,14 @@ export declare class Emulator implements GlueLogic {
     private _calculateAndUpdateGroupMap;
     private _addNewGroup;
     private _addGroupToMap;
-    updateAttribute(rootModuleId: string, moduleId: string, attributeId: string, attributeValue: string | boolean): void;
+    updateAttribute(rootModuleId: string, moduleId: string | null, 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;
+    _modifyAttributeOfModules(emulatorGroupItem: GroupItem, moduleIds: string[] | string, attributeId: string, value: string | boolean): PosGroup;
     private _setAttribute;
-    savePlanSnapshot(): Promise<PlanSnapshot>;
+    savePlanSnapshot(): Promise<PlanSnapshot | null>;
     private _findRootModuleInAllGroups;
     private _findModuleInAllGroups;
     private _findModule;

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -1,11 +1,9 @@
-import { ConfiguratorKernelClass, KernelAddOnSpot, KernelComponent, KernelConfiguration, KernelDockPairToLine, KernelDockPairToPoint, KernelParameter, KernelParameterGroup, KernelParameterValue, KernelParamKeyValuePair, KernelPart, KernelPartListParameter, KernelPossibleChild, KernelRange, KernelVariable, KernelVariant } from './kernel';
+import { ConfiguratorKernelClass, KernelAddOnSpot, KernelComponent, KernelConfiguration, KernelDockPairPreview, KernelParameter, KernelParameterGroup, KernelParameterValue, KernelParamKeyValuePair, KernelPart, KernelPartListParameter, KernelPossibleChild, KernelRange, KernelVariable, KernelVariant } from './kernel';
 import { PlanObjectList } from './planner-kernel-container';
 
 import * as ems from './ems';
 declare const EmsArray: typeof ems.EmsArray;
-declare class DockPairToPointArray extends EmsArray<KernelDockPairToPoint> {
-}
-declare class DockPairToLineArray extends EmsArray<KernelDockPairToLine> {
+declare class DockPairPreviewArray extends EmsArray<KernelDockPairPreview> {
 }
 declare class ComponentArray extends EmsArray<KernelComponent> {
 }
@@ -72,8 +70,7 @@ declare class UnitMeasureFormatter {
     isParseableNumber(aString: string): boolean;
 }
 export interface ConfiguratorKernelContainer {
-    DockPairToPointArray: DockPairToPointArray;
-    DockPairToLineArray: DockPairToLineArray;
+    DockPairPreviewArray: DockPairPreviewArray;
     ComponentArray: ComponentArray;
     Type: Type;
     UnitType: UnitType;

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

@@ -234,7 +234,8 @@ export interface KernelPlanObjectBase {
     center: KernelVector3;
     rootComponentCenter: KernelVector3;
     rotation: number;
-    customColor: number;
+    rgbValue: number;
+    useCustomColor?: boolean;
     customLabel: string;
     catalogItemId: string;
     runtimeId: number;
@@ -388,16 +389,33 @@ export interface KernelContainer {
     registerConfiguratorCallback: (callbacksObject: any) => void;
     unregisterConfiguratorCallback: (callbacksObject: any) => void;
 }
-export interface KernelDockPairToPoint {
+export declare const CORE_DOCK_PAIR_TYPE: {
+    readonly POINT: 0;
+    readonly LINE: 1;
+};
+export interface DockPairType {
+    value: Enumify<typeof CORE_DOCK_PAIR_TYPE>;
+}
+export interface KernelDockPairPreview {
     parentId: number;
     parentDockId: number;
     childId: number;
     childDockId: number;
+    type: DockPairType;
     position: KernelVector3f;
     rotation: KernelVector3f;
     insertInBetween: boolean;
     displacedChildId: number;
     displacedChildTransform: KernelMatrix4;
+    displacedComponents: number[];
+    displacementRotation: KernelVector3f;
+    displacementVector: KernelVector3f;
+    positionFrom?: KernelVector3f;
+    positionTo?: KernelVector3f;
+    lineFrom?: KernelVector3f;
+    lineTo?: KernelVector3f;
+    lineSegments: DockingLineSegment[];
+    areaWidth?: number;
 }
 export interface KernelVector2f {
     x: number;
@@ -416,19 +434,6 @@ export interface KernelDockingLineSegment {
     from: number;
     to: number;
 }
-export interface KernelDockPairToLine {
-    parentId: number;
-    parentDockId: number;
-    childId: number;
-    childDockId: number;
-    position: KernelVector3f;
-    rotation: KernelVector3f;
-    positionFrom: KernelVector3f;
-    positionTo: KernelVector3f;
-    lineFrom: KernelVector3f;
-    lineTo: KernelVector3f;
-    lineSegments: KernelDockingLineSegment[];
-}
 export interface KernelVariable {
     key: string;
     type: string;

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

@@ -1,4 +1,4 @@
-import { ConfiguratorKernelClass, KernelAddOnSpot, KernelComponent, KernelConfiguration, KernelDockPairToLine, KernelDockPairToPoint, KernelEnum, KernelParameter, KernelParameterGroup, KernelParameterValue, KernelParamKeyValuePair, KernelPart, KernelPartListParameter, KernelPlanObject, KernelPossibleChild, KernelRange, KernelVariable, KernelVariant, KernelVector2f, KernelVector3f } from './kernel';
+import { ConfiguratorKernelClass, KernelAddOnSpot, KernelComponent, KernelConfiguration, KernelDockPairPreview, KernelEnum, KernelParameter, KernelParameterGroup, KernelParameterValue, KernelParamKeyValuePair, KernelPart, KernelPartListParameter, KernelPlanObject, KernelPossibleChild, KernelRange, KernelVariable, KernelVariant, KernelVector2f, KernelVector3f } from './kernel';
 import { PlanInteractionHandler, WallSide } from './planner';
 import { Enumify } from '../common-core/src/types';
 
@@ -83,7 +83,7 @@ declare class PlanObjectPtrVector extends EmsArray<PlanObjectPtr> {
 }
 declare abstract class PlanObjectPtr extends AbstractModelWrapper {
     rotation: KernelVector3f;
-    customColor: number;
+    rgbColor: number;
     level: number;
     flipX: boolean;
     flipY: boolean;
@@ -238,9 +238,7 @@ declare class Vector2fArray extends EmsArray<KernelVector2f> {
 }
 declare class LongArray extends EmsArray<number> {
 }
-declare class DockPairToPointArray extends EmsArray<KernelDockPairToPoint> {
-}
-declare class DockPairToLineArray extends EmsArray<KernelDockPairToLine> {
+declare class DockPairPreviewArray extends EmsArray<KernelDockPairPreview> {
 }
 declare class ComponentArray extends EmsArray<KernelComponent> {
 }
@@ -351,8 +349,7 @@ export interface PlannerKernelContainer {
     StringArray: StringArray;
     Vector2fArray: Vector2fArray;
     LongArray: LongArray;
-    DockPairToPointArray: DockPairToPointArray;
-    DockPairToLineArray: DockPairToLineArray;
+    DockPairPreviewArray: DockPairPreviewArray;
     ComponentArray: ComponentArray;
     Type: Type;
     UnitType: UnitType;

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

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