@roomle/embedding-lib 5.31.0-alpha.7 → 5.32.0-alpha.1

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

@@ -1,4 +1,5 @@
 import { BakedGroundContactShadowParameters, GroundReflectionParameters, OutlineParameters, QualityMap, ShadowAndAoPassParameters, QualityLevel, LutImageDefinition, SceneRenderer } from './renderer/scene-renderer';
+import { default as WebGPURenderer } from 'three/src/renderers/webgpu/WebGPURenderer';
 import { Camera, Object3D, Scene, WebGLRenderer, Box3 } from 'three';
 import { ScreenSpaceShadowMapParameters } from './renderer/pass/screen-space-shadow-map-pass';
 import { CustomShadingParameters, SceneShadingType } from './renderer/shading-settings';
@@ -11,6 +12,7 @@ export declare enum RenderMode {
 }
 export declare const lutImages: LutImageDefinition[];
 export declare class RoomleWebGLRenderer {
+    _creator_: string;
     static enableRectAreaLightShadow: boolean;
     private static rectAreaLightsNeedsUpdate;
     private static updateNearAndFarPlaneOfPerspectiveCamera;
@@ -30,7 +32,7 @@ export declare class RoomleWebGLRenderer {
     private _customShadingParametersMoc;
     private _fpsCounter;
     private _onQualityLevelChange;
-    get renderer(): WebGLRenderer;
+    get renderer(): WebGLRenderer | WebGPURenderer;
     get sceneRenderer(): SceneRenderer;
     get isConfiguring(): boolean;
     get screenSpaceShadowParameters(): ScreenSpaceShadowMapParameters;
@@ -38,7 +40,7 @@ export declare class RoomleWebGLRenderer {
     get bakedGroundContactShadowParameters(): BakedGroundContactShadowParameters;
     get groundReflectionParameters(): GroundReflectionParameters;
     get outlineParameters(): OutlineParameters;
-    constructor(renderer: WebGLRenderer, width: number, height: number, linearAoFilter?: boolean);
+    constructor(creator: string, renderer: WebGLRenderer | WebGPURenderer, width: number, height: number, linearAoFilter?: boolean);
     dispose(): void;
     setSize(width: number, height: number): void;
     setCameraType(cameraType: Enumify<typeof CAMERA_TYPE>): void;

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

@@ -66,7 +66,8 @@ export default class ConfiguratorSceneManager extends SceneManager implements Co
     private _materialLoaded;
     waitForMaterialQueue(): Promise<void>;
     pause(): void;
-    protected _setupScene(offset?: CanvasOffset, transparent?: boolean, skipLightSetup?: boolean): void;
+    protected _setupScene(offset?: CanvasOffset, transparent?: boolean, skipLightSetup?: boolean): Promise<void>;
+    protected _initializeMeshGeneratorSettings(): void;
     sceneCleared(shouldHardReset: boolean): void;
     display(component: RoomleComponent): void;
     protected setRootComponentId(rootComponentId: number): void;
@@ -130,7 +131,6 @@ export default class ConfiguratorSceneManager extends SceneManager implements Co
     private _requestDockingsPreviewWithDrag;
     private _dockComponent;
     private _dockKernelComponent;
-    private _dockExternalComponent;
     private _onSelectedRuntimeComponentsChange;
     private _onSelectedRuntimeComponentChange;
     requestDeleteSelectedComponent(): void;
@@ -169,6 +169,7 @@ export default class ConfiguratorSceneManager extends SceneManager implements Co
     animateElement(elementId: number, parameterName: string, value: string, animationLevel: AnimationLevelType, animate: boolean): void;
     undo(): Promise<void>;
     redo(): Promise<void>;
+    protected _updateConfigurationFromHistory(configurationString: string): void;
     clearHistory(): void;
     private _callOnPartListUpdate;
     private _showCustomComponentDimensions;

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

@@ -1,37 +1,4 @@
 import { GlueLogic } from './glue-logic';
 import { default as RoomlePlanner } from '../../planner-core/src/roomle-planner';
 
-export interface ExternalObjectSegment {
-    cmd: string;
-    x: number;
-    y: number;
-    type?: string;
-    angle?: number;
-}
-export interface ExternalObjectContour {
-    level: number;
-    segments: ExternalObjectSegment[];
-}
-export interface ExternalObjectGroupPosition {
-    pos: number[];
-    rotationY?: number;
-    contours?: ExternalObjectContour[];
-}
-export interface ExternalObjectRootModule {
-    moduleId: string;
-    pos: number[];
-    rotationY?: number;
-}
-export interface ExternalObjectGroup {
-    groupId: string;
-    pos: number[];
-    rotationY?: number;
-    rootModules?: ExternalObjectRootModule[];
-    contours?: ExternalObjectContour[];
-}
-export interface ExternalModuleInformation {
-    groupId: string;
-    rootModuleId: string;
-    subModuleId: string | null;
-}
 export declare const initCallbacks: (roomlePlanner: RoomlePlanner, gluLogic: GlueLogic) => void;

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

@@ -2,9 +2,10 @@ import { HiCallbacks } from '../../../../embedding-lib/src/embedding-lib';
 import { GlueLogic, LibraryData, PlanSnapshot, RoomDesignerRequests } from './glue-logic';
 import { ExternalObjectGroup } from 'roomle-core-hsc/src/embind/plannerCoreInterface';
 import { ExternalModuleInformation } from '../../typings/kernel';
-import { CheckResult, PosGroup, PosSaveData } from './model/oc-scripts-domain.model';
+import { CheckResult, PosArticle, PosGroup, PosSaveData } from './model/oc-scripts-domain.model';
 import { HiObjectSelection } from './hi-object-selection';
 import { LoadExternalObjectOptions } from './external-object-api';
+import { ExternalObjectValidContainerModules } from './external-object-api-callbacks';
 
 export declare class GlueLayerRequestDebugLogging implements GlueLogic {
     private _glueLogic;
@@ -26,15 +27,20 @@ export declare class GlueLayerRequestDebugLogging implements GlueLogic {
     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;
+    findValidSubArticles(posGroupIds: string[] | string): PosArticle[];
+    getValidContainerModulesForSubArticle(posGroupIds: string[] | string, subArticleId: string): ExternalObjectValidContainerModules[];
+    addSubArticle(articleId: string, rootModuleId: string, parentModuleId: string): void;
     swapRootModule(groupId: string, rootModuleId: string, articleId: string): void;
     arrangeRootModulesOfGroup(changedGroup: ExternalObjectGroup): void;
     changedGroupPlanningSituation(changedGroup: ExternalObjectGroup): void;
-    changedGroup(posDataJson: PosGroup): void;
+    changedGroupFromHistory(posDataJson: PosGroup, reloadGroup: boolean): void;
     loadedGroup(posDataJson: PosGroup): void;
     groupsCompletelyLoaded(): void;
     removedGroup(groupId: string): void;
     openCloseGroup(groupId: string): void;
-    newPosDataFromId(id: string): PosGroup | undefined;
+    getSaveDataGroups(): Promise<PosGroup[] | null>;
+    newPosDataFromId(id: string): Promise<PosGroup>;
+    newPosDataFromGroup(posDataJson: PosGroup): Promise<PosGroup>;
     getGroupDataForOrder(roomlePlannerId?: string): Promise<any>;
     savePlanSnapshot(): Promise<PlanSnapshot | null>;
 }

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

@@ -1,4 +1,3 @@
-import { ExternalModuleInformation } from '../../typings/kernel';
 import { CancelSelectionReasons } from '../../typings/planner';
 
 export interface ExternalObjectSegment {
@@ -29,6 +28,16 @@ export interface ExternalObjectGroup {
     rootModules?: ExternalObjectRootModule[];
     contours?: ExternalObjectContour[];
 }
+export interface ExternalModuleInformation {
+    groupId: string;
+    rootModuleId: string;
+    subModuleId: string | null;
+}
+export interface ExternalObjectValidContainerModules {
+    rootId: string;
+    containerModuleId: string;
+    parentModuleId: string;
+}
 export interface ExternalObjectUiCallback {
     /** "onMergeExternalObjectGroup" is invoked when a group of root modules is merged into another group of root modules.
      * The group with the ID "sourceGroupId" is merged into the group with the ID "targetGroup.id".

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

@@ -1,5 +1,5 @@
 import { Position3 } from '../../common-core/src/common-interfaces';
-import { CheckResult, PosContour } from './model/oc-scripts-domain.model';
+import { CheckResult, PosArticle, PosContour } from './model/oc-scripts-domain.model';
 
 export interface ExternalObjectUiSliderRange {
     min: number;
@@ -61,6 +61,9 @@ export interface LoadExternalObjectOptions {
     position?: Position3;
     rotation?: number;
 }
+export interface LoadExternalObjectGroupResult {
+    id: number;
+}
 export interface ExternalObjectAPI {
     /**
      * With "configureExternalObjectApi" the default representation of the objects and UI and
@@ -91,11 +94,11 @@ export interface ExternalObjectAPI {
      * @param groupJson The group JSON as string or object.
      * @param options Options for loading the external object groups.
      */
-    loadExternalObjectGroups(groupJson: ExternalGroupData, options: LoadExternalObjectOptions): Promise<void>;
+    loadExternalObjectGroups(groupJson: ExternalGroupData, options: LoadExternalObjectOptions): Promise<LoadExternalObjectGroupResult[]>;
     /**
      * 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[], newAction?: boolean): Promise<void>;
+    loadExternalObjectGroup(groupJson: object | string | string[], findFreeSpaceInPlan: boolean, verifyArrangement?: boolean, mergedGroups?: string[], respondWithPositionInPlan?: boolean, moduleIdMap?: ExternalObjectModuleIdMap[], newAction?: boolean): Promise<LoadExternalObjectGroupResult[]>;
     /**
      * "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"
@@ -119,6 +122,17 @@ export interface ExternalObjectAPI {
      * @param additionalInfo The new additional info for the module.
      */
     updateExternalObjectAdditionalInfo(rootModuleId: string, additionalInfo: string): void;
+    /**
+     * "getExternalObjectValidSubArticles" returns the valid sub articles for a given pos group.
+     * If no pos group id is provided, the valid sub articles for all loaded pos groups are returned.
+     * @param posGroupId The ID of the pos group.
+     */
+    getExternalObjectValidSubArticles(posGroupId?: string): PosArticle[];
+    /**
+     * "selectExternalObjectSubArticle" selects a sub article in the planner.
+     * @param subArticleId The ID of the sub article to be selected.
+     */
+    selectExternalObjectSubArticle(subArticleId: string): void;
     /**
      * "renderImagesOfExternalObjectGroups" renders images of groups of modules.
      * @param groupJson The group JSON as string or object.

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

@@ -1,9 +1,13 @@
 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 { ExternalModuleInformation, ExternalObjectGroup, ExternalObjectValidContainerModules } from './external-object-api-callbacks';
+import { MasterData, PosModuleAttribute, PosGroup, PosModuleData, CheckResult, PosSaveData, PosArticle } from './model/oc-scripts-domain.model';
 import { HiObjectSelection } from './hi-object-selection';
 import { LoadExternalObjectOptions } from './external-object-api';
 
+export interface LibraryIdAndLibraryData {
+    libraryId?: string;
+    libraryData?: LibraryData;
+}
 export interface LibraryData {
     libraryId: string;
     get masterData(): MasterData | null;
@@ -12,6 +16,9 @@ export interface LibraryData {
     getOrderData(posGroup: PosGroup[], roomlePlannerId?: string): any;
     getAttributesDropDownValues(module: PosModuleData, attributeIds?: string | string[]): Promise<Record<string, any[]>>;
     solveModuleAttributeConflict(module: PosModuleData, attributeName: string, value: string | number | boolean): PosModuleAttribute[] | undefined;
+    getValidSubArticles(calculatedPosGroup: PosGroup, articles: PosArticle[], masterData: MasterData): PosArticle[];
+    getValidContainerModulesForSubArticle(calculatedPosGroup: PosGroup, subArticle: PosArticle, masterData: MasterData): ExternalObjectValidContainerModules[];
+    addSubArticle(targetPosGroup: PosGroup, article: PosArticle, rootId: string, parentModuleId: string): PosGroup;
 }
 export interface RoomDesignerRequests {
     loadMasterData(masterData: MasterData): void;
@@ -48,14 +55,19 @@ export interface GlueLogic {
     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;
+    findValidSubArticles(posGroupIds: string[] | string): PosArticle[];
+    getValidContainerModulesForSubArticle(posGroupIds: string[] | string, subArticleId: string): ExternalObjectValidContainerModules[];
+    addSubArticle(articleId: string, rootModuleId: string, parentModuleId: string): void;
     arrangeRootModulesOfGroup(changedGroup: ExternalObjectGroup): void;
     changedGroupPlanningSituation(changedGroup: ExternalObjectGroup): void;
-    changedGroup(posDataJson: PosGroup): void;
+    changedGroupFromHistory(historyGroup: PosGroup, reloadGroup: boolean): void;
     loadedGroup(posDataJson: PosGroup): void;
     groupsCompletelyLoaded(): void;
     removedGroup(groupId: string): void;
     openCloseGroup(groupId: string): void;
-    newPosDataFromId(id: string): PosGroup | undefined;
+    getSaveDataGroups(): Promise<PosGroup[] | null>;
+    newPosDataFromId(id: string): Promise<PosGroup>;
+    newPosDataFromGroup(posDataJson: PosGroup): Promise<PosGroup>;
     getGroupDataForOrder(roomlePlannerId?: string): Promise<any>;
     savePlanSnapshot(): Promise<PlanSnapshot | null>;
 }
@@ -74,13 +86,14 @@ export declare class GlueLogicImplementation implements GlueLogic {
     private _designerRequests;
     private _libraryData;
     private _posDataForLoading;
-    private _posDataJsonMap;
+    private _posArticleMap;
     private _groupMap;
     private _nextPosDataId;
     private _hiCallbacks;
     private _hiObjectSelection;
     private _pendingGroupsToBeLoaded;
     private _planCompletelyLoaded;
+    private _validSubArticles;
     constructor(designerRequests: RoomDesignerRequests, hiCallbacks?: HiCallbacks | null);
     get hiCallbacks(): HiCallbacks | null;
     get hiObjectSelection(): HiObjectSelection;
@@ -90,7 +103,9 @@ export declare class GlueLogicImplementation implements GlueLogic {
     addLibrary(libraryData: LibraryData): void;
     loadPosData(articleCatalogJson: any, libraryId: string): void;
     setPosDataForLoading(posData: PosSaveData | null): void;
-    newPosDataFromId(id: string): any;
+    getSaveDataGroups(): Promise<PosGroup[] | null>;
+    newPosDataFromId(id: string): Promise<PosGroup>;
+    newPosDataFromGroup(posDataJson: PosGroup): Promise<PosGroup>;
     selectGroup(groupId: string): Promise<void>;
     selectRoot(_groupId: any, rootId: string): Promise<void>;
     deleteRoot(_groupId: any, rootId: string): Promise<void>;
@@ -103,7 +118,7 @@ export declare class GlueLogicImplementation implements GlueLogic {
     splitRootModuleFromGroup(splitGroup: ExternalObjectGroup, newGroupedRootModules: ExternalObjectGroup[]): void;
     arrangeRootModulesOfGroup(changedGroup: ExternalObjectGroup): void;
     removedGroup(groupId: string): void;
-    changedGroup(posDataJson: PosGroup): void;
+    changedGroupFromHistory(historyGroup: PosGroup, reloadGroup: boolean): void;
     changedGroupPlanningSituation(changedGroup: ExternalObjectGroup): void;
     loadedGroup(posDataJson: PosGroup): void;
     private _loadPendingGroup;
@@ -120,7 +135,6 @@ export declare class GlueLogicImplementation implements GlueLogic {
     private _splitOffRootModulesFromGroup;
     private _calculateNewGroup;
     private _getLibraryIdForPosData;
-    private _calculate;
     private _populateRootFromMasterData;
     private _setSubmoduleImages;
     private _calculateAndUpdateGroupMap;
@@ -130,9 +144,13 @@ export declare class GlueLogicImplementation implements GlueLogic {
     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;
+    swapRootModule(groupId: string, rootModuleId: string, articleId: string): Promise<void>;
     _modifyAttributeOfModules(emulatorGroupItem: GroupItem, moduleIds: string[] | string, attributeId: string, value: string | boolean): PosGroup;
     private _setAttribute;
+    findValidSubArticles(posGroupIds: string[] | string): PosArticle[];
+    private _getValidSubArticle;
+    getValidContainerModulesForSubArticle(posGroupIds: string[] | string, subArticleId: string): ExternalObjectValidContainerModules[];
+    addSubArticle(articleId: string, rootModuleId: string, parentModuleId: string): void;
     savePlanSnapshot(): Promise<PlanSnapshot | null>;
     private _findRootModuleInAllGroups;
     private _findModuleInAllGroups;
@@ -142,5 +160,9 @@ export declare class GlueLogicImplementation implements GlueLogic {
     private _getNextID;
     private _groupsModified;
     private _calculatePrice;
+    private _calculate;
+    private _addSubArticle;
+    private _getLibrary;
+    private _takeOverPropertiesFromOriginalGroup;
 }
 export {};

package/packages/web-sdk/packages/homag-intelligence/src/model/oc-scripts-domain.model.d.ts

@@ -9,7 +9,7 @@ export declare const enum UserRightLevel {
     Master = 2
 }
 export declare const getUserRightLevel: (right?: PosUserRight | null) => UserRightLevel;
-export interface PosArticleInfo {
+interface PosArticleInfo {
     /**
      * Defined the library that is used / must match the MasterData
      */
@@ -29,6 +29,7 @@ export interface PosArticleInfo {
     desc?: string;
     imageUrl?: string;
     category?: string;
+    isConfigDummy?: boolean;
 }
 export interface PosPartData {
     id: string;
@@ -155,8 +156,11 @@ export interface PosContour {
     level: number;
     segments: PosContourSegment[];
 }
+export interface PosRooms {
+    rooms: PosContour[];
+}
 export interface PosGroup {
-    libraryId: string;
+    libraryId?: string;
     /**
      * The unique id of the Group
      */
@@ -199,6 +203,7 @@ export interface PosSaveData {
     topImageLink?: string;
     room3dLink?: string;
     room3dFullLink?: string;
+    rooms?: PosContour[];
 }
 export interface PosPriceData {
     Groups: PosPriceGroup[];
@@ -310,6 +315,7 @@ export interface CheckDropDownEntry {
 }
 export declare enum CheckDropDownEntryKind {
     Normal = 0,
-    Conflicting = 1
+    Conflicting = 1,
+    Invalid = 2
 }
 export {};

package/packages/web-sdk/packages/material-viewer/src/webgl/material-viewer-scene-manager.d.ts

@@ -24,6 +24,7 @@ export default class MaterialViewerSceneManager extends SceneManager {
     private _sceneParams;
     private _materialParams;
     constructor(creator: string, offset: CanvasOffset);
+    private _initializeRendererSettings;
     private _initScene;
     loadMaterialId(materialId: RapiId): Promise<void>;
     loadMaterial(material: RapiMaterial): Promise<void>;

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

@@ -9,7 +9,7 @@ import { Context } from '../../common-core/src/di/context';
 import { KernelAttic, PlanObject, WallSide, CancelSelectionReasons, KernelObject, KernelWall, PlanInteractionHandler, PlanModelViewHelper, PlanOverview } from '../../typings/planner';
 import { KernelAccessCallbackI } from '../../common-core/src/kernel-access-callback';
 import { default as InitData } from '../../common-core/src/utils/init-data';
-import { CanvasOffset, Position3 } from '../../common-core/src/common-interfaces';
+import { Base64Image, CanvasOffset, Position3 } from '../../common-core/src/common-interfaces';
 import { PrepareImageOptions } from '../../common-core/src/webgl/image-renderer';
 import { KernelParameter, KernelPartList, KernelPartListPrice, KernelVector3, RuntimeId, UiPlanObject } from '../../typings/kernel';
 import { default as UnitFormatter } from '../../configurator-core/src/services/unit-formatter';
@@ -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 { LoadExternalObjectOptions, ExternalObjectAPI, ExternalObjectApiConfiguration, ExternalObjectModuleIdMap, ExternalRoomInformation, HiContextAction } from '../../homag-intelligence/src/external-object-api';
+import { LoadExternalObjectGroupResult, 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';
@@ -30,7 +30,7 @@ import { MaybePromise } from '../../common-core/src/utils/common-utils';
 import { HomagIntelligence } from '../../homag-intelligence/src/homag-intelligence';
 import { RoomleLightSource } from '../../common-core/src/light/light-source';
 import { AnimationKeyAndValue } from '../../configurator-core/src/utils/animation/animation-value-map';
-import { CheckResult } from '../../homag-intelligence/src/model/oc-scripts-domain.model';
+import { CheckResult, PosArticle, PosGroup } from '../../homag-intelligence/src/model/oc-scripts-domain.model';
 
 export type ID_TYPE = 'rml_id' | 'tc_id' | 'rml_serialized' | 'tc_serialized';
 export declare const EXT_OBJ_EXCEPTION = "Could not retrieve configuration for external object! Did you implement onGetConfigurationForExternalObject?";
@@ -257,13 +257,13 @@ export default class RoomlePlanner<P extends readonly PluginName[] = readonly []
      * Generates a top image (birds eye view) and returns it as base64
      * @param options
      */
-    prepareTopImage(options?: PrepareImageOptions): Promise<import('../../common-core/src/common-interfaces').Base64Image>;
+    prepareTopImage(options?: PrepareImageOptions): Promise<Base64Image>;
     /**
      * Generates a perspective image (slightly from the side) and returns it as base64
      * @param options
      @param isolationMode - defaults to false. Determines whether to generate a perspective image for the current configuration.
      */
-    preparePerspectiveImage(options?: PrepareImageOptions, isolationMode?: boolean): Promise<import('../../common-core/src/common-interfaces').Base64Image>;
+    preparePerspectiveImage(options?: PrepareImageOptions, isolationMode?: boolean): Promise<Base64Image>;
     /**
      * Enables rotation of selected elements
      */
@@ -360,6 +360,21 @@ export default class RoomlePlanner<P extends readonly PluginName[] = readonly []
      * @param sceneEvents
      */
     setSceneEvents(sceneEvents: SceneEvents): void;
+    /**
+     * It generates a snapshot of the external object in the plan without saving any data.
+     * The snapshot includes order data, room information, the plan XML, GLBs of the complete scene,
+     * and only the objects in the scene, as well as perspective images and a top image.
+     * @returns the snapshot of the external objects
+     */
+    getExternalObjectSnapshot(): Promise<{
+        orderData: any;
+        planXML: string;
+        objectGlb: string;
+        perspectiveImage: string;
+        topImage: string;
+        perspectiveObjectImage: string;
+        topObjectImage: string;
+    }>;
     /**
      * Saves a snapshot of the external objects in the plan without walls and other objects
      * Also contains the urls to the glb and usdz files
@@ -367,6 +382,7 @@ export default class RoomlePlanner<P extends readonly PluginName[] = readonly []
      * @returns the snapshot of the external objects if there are no external objects it returns null
      */
     saveExternalObjectSnapshot(parentPlanId?: RapiId): Promise<Nullable<RapiPlanSnapshotGetDataWith3dUrls>>;
+    private _getExternalObjectGroupsInPlan;
     private _savePlanSnapshotExternalObjects;
     saveCurrentPlanSnapshot(parentPlanId?: RapiId, configurationHashOrGroupId?: string | string[]): Promise<RapiPlanSnapshotGetData>;
     getPlanXmlFrom(plan: RapiPlan | RapiPlanSnapshotGetData): any;
@@ -410,7 +426,7 @@ export default class RoomlePlanner<P extends readonly PluginName[] = readonly []
      * @param runtimeId runtime-id of the plan element, e.g.: a selected element
      * @param options PrepareImageOptions
      */
-    preparePerspectiveImageOf(runtimeId: RuntimeId, options?: PrepareImageOptions): Promise<import('../../common-core/src/common-interfaces').Base64Image>;
+    preparePerspectiveImageOf(runtimeId: RuntimeId, options?: PrepareImageOptions): Promise<Base64Image>;
     generateTCExport(planObjectIds?: string[]): Promise<any>;
     enableMeasurementLineDrawing(): void;
     disableMeasurementLineDrawing(): void;
@@ -435,8 +451,9 @@ export default class RoomlePlanner<P extends readonly PluginName[] = readonly []
     /**
      * 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>;
+    loadExternalObjectGroup(groupData: ExternalGroupData, findFreeSpaceInPlan: boolean, correctArrangement?: boolean, mergedGroups?: string[], respondWithPositionInPlan?: boolean, moduleIdMap?: ExternalObjectModuleIdMap[], newAction?: boolean): Promise<LoadExternalObjectGroupResult[]>;
+    getInitialExternalObjectGroup(): Promise<PosGroup | null>;
+    loadExternalObjectGroups(groupData: ExternalGroupData, options?: LoadExternalObjectOptions): Promise<LoadExternalObjectGroupResult[]>;
     private _loadExternalObjectGroup;
     private _loadExternalObjectGroupInConfigurator;
     private _loadExternalObjectGroupInPlanner;
@@ -450,6 +467,8 @@ export default class RoomlePlanner<P extends readonly PluginName[] = readonly []
     renderImagesOfExternalObjectGroup(groups: object): Promise<{
         [key: string]: string;
     }>;
+    getExternalObjectValidSubArticles(posGroupId?: string): PosArticle[];
+    selectExternalObjectSubArticle(subArticleId: string): void;
     /**
      * Deprecated API that can be deleted once the new API is fully integrated into the OC.
      */
@@ -571,7 +590,7 @@ export default class RoomlePlanner<P extends readonly PluginName[] = readonly []
      */
     redo(): Promise<void>;
     setHomagIntelligence(homagIntelligence: HomagIntelligence): void;
-    newPosDataFromId(id: string): import('../../homag-intelligence/src/model/oc-scripts-domain.model').PosGroup;
+    newPosDataFromId(id: string): Promise<PosGroup>;
     /**
      * deprecated, use placeOrder() instead
      */

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

@@ -31,6 +31,8 @@ export interface PlannerKernelCallbackI {
     startedDrawing(): void;
     stoppedDrawing(): void;
     requestCatalogItem(catalogItemId: string): void;
+    externalObjectRequestAddOnContainers(groupId: string, subArticleId: string): void;
+    externalObjectAddSubArticle(subArticleId: string, rootModuleId: string, parentModuleId: string): void;
 }
 export default class PlannerKernelAccess extends ConfiguratorKernelAccess {
     private _kernelAccessCallback;
@@ -79,6 +81,8 @@ export default class PlannerKernelAccess extends ConfiguratorKernelAccess {
     externalObjectConfigurationsMerged(plan: Plan, planObject: PlanObject, mergedGroup: ExternalObjectGroup, idsOfGroupsMerged: string | string[], targetRootModuleId: string): void;
     externalObjectComponentSplitOff(plan: Plan, planObject: PlanObject, splitGroups: ExternalObjectGroup[]): void;
     externalObjectArrangementChanged(plan: Plan, planObject: PlanObject, changedGroup: ExternalObjectGroup): void;
+    externalObjectRequestAddOnContainers(plan: Plan, planObject: PlanObject, groupId: string, subArticleId: string): void;
+    externalObjectAddSubArticle(plan: Plan, planObject: PlanObject, subArticleId: string, rootModuleId: string, parentModuleId: string): void;
     planObjectConfigurationLoaded(plan: Plan, element: PlanElement, success: boolean): Promise<void>;
     planObjectConfigurationChanged(plan: Plan, object: PlanObject): void;
     requestCatalogItem(catalogItemId: string): void;
@@ -113,7 +117,6 @@ export default class PlannerKernelAccess extends ConfiguratorKernelAccess {
     requestDeleteComponent(componentId: number): void;
     requestDeletePlanComponent(componentId: number): void;
     private _externalPlanComponentDeleted;
-    dockExternalObjectComponent(parentId: number, parentDockId: number, childId: number, childDockId: number): void;
     configureExternalObjectApi(externalObjectSettings?: ExternalObjectApiConfiguration): Promise<void>;
     setComponentParameter(componentId: number, interactionKey: string, newValue: any): void;
     protected _getAnimationLevelForObject(runtimeId: number, _animation: KernelAnimation): AnimationLevelType;

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

@@ -61,8 +61,8 @@ export default class MeasurementLinePlanElementViewModel extends PlanElementView
     private updatePointDraggableGeometry;
     getPoint1Draggable(): DraggableNode;
     getPoint2Draggable(): DraggableNode;
-    getPoint1DraggableBoundingBox(): Mesh<BufferGeometry<import('three').NormalBufferAttributes>, Material | Material[], import('three').Object3DEventMap>;
-    getPoint2DraggableBoundingBox(): Mesh<BufferGeometry<import('three').NormalBufferAttributes>, Material | Material[], import('three').Object3DEventMap>;
+    getPoint1DraggableBoundingBox(): Mesh<BufferGeometry<import('three').NormalBufferAttributes, import('three').BufferGeometryEventMap>, Material | Material[], import('three').Object3DEventMap>;
+    getPoint2DraggableBoundingBox(): Mesh<BufferGeometry<import('three').NormalBufferAttributes, import('three').BufferGeometryEventMap>, Material | Material[], import('three').Object3DEventMap>;
     hidePreviewBox(): void;
     selectPoint1Draggable(): void;
     selectPoint2Draggable(): void;

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

@@ -168,4 +168,6 @@ export default class PlanViewModel extends ConfiguratorViewModel implements Plan
     setNodeZoom(zoom: number): void;
     planCleared(): void;
     requestCatalogItem(_catalogItemId: string): void;
+    externalObjectRequestAddOnContainers(_groupId: string, _subArticleId: string): void;
+    externalObjectAddSubArticle(_subArticleId: string, _rootModuleId: string, _parentModuleId: string): void;
 }

package/packages/web-sdk/packages/planner-core/src/webgl/planner-mesh-generator.d.ts

@@ -19,5 +19,5 @@ export default class PlannerMeshGenerator extends MeshGenerator {
     private _checkWallMaterial;
     clear(): void;
     clearWallMeshes(): void;
-    get wallMeshes(): Mesh<BufferGeometry<import('three').NormalBufferAttributes>, import('three').Material | import('three').Material[], import('three').Object3DEventMap>[];
+    get wallMeshes(): Mesh<BufferGeometry<import('three').NormalBufferAttributes, import('three').BufferGeometryEventMap>, import('three').Material | import('three').Material[], import('three').Object3DEventMap>[];
 }

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

@@ -56,6 +56,7 @@ export default class PlannerSceneManager extends ConfiguratorSceneManager implem
     private _planElementHighlighter;
     private _debugSpheres;
     constructor(creator: string, offset: CanvasOffset, plannerCallback: RoomlePlannerCallback, mode: Enumify<typeof CAMERA_TYPE>);
+    protected _initializeMeshGeneratorSettings(): void;
     setHomagIntelligence(homagIntelligence: HomagIntelligence): void;
     get configuratorContext(): import('../../../common-core/src/webgl/configurator-context').default;
     get hasSingleRoom(): boolean;
@@ -72,7 +73,7 @@ export default class PlannerSceneManager extends ConfiguratorSceneManager implem
     private _onSelectionCancel;
     private _handleMeasurementLineDraggablePoints;
     resetConfiguratorContext(reason: CancelSelectionReasons): void;
-    protected _setupScene(offset?: CanvasOffset, transparent?: boolean): void;
+    protected _setupScene(offset?: CanvasOffset, transparent?: boolean): Promise<void>;
     protected onBeforeRender(): void;
     protected _getInputManager(): InputManager;
     protected createCameraControl(mode: Enumify<typeof CAMERA_TYPE>, _offset: CanvasOffset): void;
@@ -124,6 +125,7 @@ export default class PlannerSceneManager extends ConfiguratorSceneManager implem
     protected _onKeyUp(event: KeyboardEvent, cleanup?: boolean): void;
     undo(): Promise<void>;
     redo(): Promise<void>;
+    protected _updateConfigurationFromHistory(configurationString: string): Promise<void>;
     setMode(mode: Enumify<typeof CAMERA_TYPE>): void;
     private _clearHighlighting;
     highlightPlanElementsById(runtimeIds: number[] | null): void;
@@ -234,5 +236,7 @@ export default class PlannerSceneManager extends ConfiguratorSceneManager implem
     private _insertRapiItems;
     insertRapiObjects(rapiIds: InsertItemIdInfo[]): Promise<InsertItemResult[]>;
     private _saveConfiguration;
+    externalObjectRequestAddOnContainers(groupId: string, subArticleId: string): void;
+    externalObjectAddSubArticle(subArticleId: string, rootModuleId: string, parentModuleId: string): void;
 }
 export {};