@roomle/embedding-lib 5.27.0-alpha.1 → 5.27.0-alpha.3

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

@@ -1,17 +1,7 @@
-## [5.27.0-alpha.1](https://github.com/roomle-dev/roomle-ui/compare/embedding-lib-v5.26.0...embedding-lib-v5.27.0-alpha.1) (2025-09-01)
+## [5.27.0-alpha.3](https://github.com/roomle-dev/roomle-ui/compare/embedding-lib-v5.27.0-alpha.2...embedding-lib-v5.27.0-alpha.3) (2025-09-03)
 
 
 ### Features
 
-* add open/close icon in the flying menu for construction elements ([a42ba31](https://github.com/roomle-dev/roomle-ui/commit/a42ba319980c42850b3f3d41e65b7d91f29d9712))
-* core api - room information ([d82ff87](https://github.com/roomle-dev/roomle-ui/commit/d82ff87b322a1c89953df360ceb70abcfc0aa406))
-* hi room information for order data ([3034df5](https://github.com/roomle-dev/roomle-ui/commit/3034df54a39680b5d58a66df06a60ca9a535f752))
-* **core:** upgrade to version 2.58.1-alpha.1 ([1f144ee](https://github.com/roomle-dev/roomle-ui/commit/1f144ee761c1604a89abcd7f28b01df28656d288))
-* **core:** upgrade to version 2.59.0-alpha.1 ([3021efa](https://github.com/roomle-dev/roomle-ui/commit/3021efabfa5aad20fef86c719b72f37faff5dd25))
-* **core:** upgrade to version 2.59.0-alpha.2 ([327b2f2](https://github.com/roomle-dev/roomle-ui/commit/327b2f2f8430f7280b93345709e9e84b68350d61))
-* **core:** upgrade to version 2.59.0-alpha.3 ([87d5a75](https://github.com/roomle-dev/roomle-ui/commit/87d5a75d9930face28c442598ed1ed506f52bc47))
-
-
-### Bug Fixes
-
-* update addons on "Add an element" ([a3768bc](https://github.com/roomle-dev/roomle-ui/commit/a3768bcf70d4b26ca11536179ae8642fbb0187f2))
+* extend swap object to also take planElement id ([8959345](https://github.com/roomle-dev/roomle-ui/commit/89593451ce7225fdeadf319cc64e797f2c620ee8))
+* **core:** upgrade to version 2.59.0-alpha.7 ([9b51309](https://github.com/roomle-dev/roomle-ui/commit/9b51309fe283b0f6f9adcdf25f3a30a9357bab14))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roomle/embedding-lib",
-  "version": "5.27.0-alpha.1",
+  "version": "5.27.0-alpha.3",
   "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/web-sdk/packages/configurator-core/src/roomle-configurator.d.ts

@@ -711,5 +711,12 @@ export default class RoomleConfigurator<P extends readonly PluginName[] = readon
      * Resumes all input event listeners on the canvas.
      */
     resumeInputListeners(): void;
+    /**
+     * Directly updates a component parameter.
+     * @param runtimeId - The runtime ID of the component to update.
+     * @param parameterKey - The key of the parameter to update.
+     * @param value - The new value to set for the parameter.
+     */
+    updateComponentParameter(runtimeId: number, parameterKey: string, value: string): void;
 }
 export {};

package/packages/web-sdk/packages/configurator-core/src/services/configurator-ui-callback.d.ts

@@ -9,6 +9,7 @@ import { RoomleComponent } from '../../../common-core/src/webgl/roomle-component
 import { ConfiguratorDebugCallbacks } from '../configurator-debug-api';
 import { CancelSelectionReasons } from '../../../typings/planner';
 import { ExternalConfiguration } from '../../../typings/external-objects';
+import { DimensionLabelsTransferable } from '../../../planner-core/src/utils/measurements';
 
 export type ComponentAction = 'edit' | 'add';
 export type ComponentType = 'preview' | 'component';
@@ -243,6 +244,7 @@ export default class ConfiguratorUiCallbacks extends UiCallback implements Confi
      * @param rootComponentLabel
      */
     onConfigurationLabelChange: (catalogName: string, rapiItemLabel: string, rootComponentLabel: string) => void;
+    onDimensionLabelsUpdated: (labels: DimensionLabelsTransferable | null) => void;
     /**
      * When kernel failed to load a mesh
      */

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

@@ -1,7 +1,17 @@
 import { RoomleComponent } from '../../../common-core/src/webgl/roomle-component-factory';
 import { Context } from '../../../common-core/src/di/context';
-import { PerspectiveCamera } from 'three';
+import { OrthographicCamera, Vector3, PerspectiveCamera } from 'three';
+import { Dimensioning, DimensioningAxis } from '../../../typings/kernel';
 
+export interface DimensionLabelData {
+    id: string;
+    value: number;
+    level: number;
+    maxLevel: number;
+    dimensioning: Dimensioning;
+    axis: DimensioningAxis | undefined;
+    interactionKey?: string;
+}
 export default class ComponentDimensioningHelper implements Context {
     _creator_: string;
     private _plannerKernelAccess;
@@ -9,9 +19,28 @@ export default class ComponentDimensioningHelper implements Context {
     private _camera;
     private _activeComponents;
     private _componentDimensioningsExist;
+    private _dimensionDataMap;
+    private _dimensionObjects;
+    private _lastCameraDirection;
+    private _regenerationThreshold;
     constructor(creator: string);
+    regenerateDimensions(component: RoomleComponent, updateRenderer?: () => void): Promise<boolean>;
+    needsDimensionRegeneration(camera: PerspectiveCamera | OrthographicCamera): boolean;
     setCamera(camera: PerspectiveCamera): void;
-    add(component: RoomleComponent, updateRenderer?: () => void): boolean;
+    add(component: RoomleComponent, updateRenderer?: () => void): Promise<boolean>;
+    /**
+     * Get dimension data for a component
+     */
+    getDimensionData(componentId: number): DimensionLabelData[];
+    /**
+     * Extract label data from dimension objects
+     * This gets the actual calculated positions and values from the Three.js objects
+     */
+    getLabelData(): DimensionLabelData[];
+    /**
+     * Get dimension objects to extract their current state
+     */
+    getDimensionObjects(componentId: number): any[];
     private _assembleDimensionings;
     private _findAxis;
     private _mapDimensioningToAxis;
@@ -22,4 +51,17 @@ export default class ComponentDimensioningHelper implements Context {
     hasComponentDimensions(): boolean;
     reset(): Promise<void>;
     invalidateDimensioningsCache(componentRuntimeId?: number): void;
+    /**
+     * Get all active components for iteration
+     */
+    getActiveComponents(): RoomleComponent[];
+    updateDimensionVisibility(componentId: number): void;
+    /**
+     * Get the center of the main dimension line (not extension lines)
+     */
+    getDimensionLineCenter(componentId: number, dimensionIndex: number): Vector3 | null;
+    /**
+     * Ensure dimension objects are ready
+     */
+    ensureDimensionObjectsReady(componentId: number): void;
 }

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

@@ -1,7 +1,7 @@
 import { RoomleComponent } from '../../../common-core/src/webgl/roomle-component-factory';
 import { default as ConfiguratorSceneEventHandler } from '../webgl/configurator-scene-event-handler';
 import { default as ConfiguratorViewModel } from '../../../common-core/src/view-model/configurator-view-model';
-import { Object3D, PerspectiveCamera } from 'three';
+import { Object3D, PerspectiveCamera, Vector3 } from 'three';
 
 export default class ComponentRaycastHelper {
     private _object;
@@ -20,4 +20,9 @@ export default class ComponentRaycastHelper {
     areAllPreviewsVisible(configuratorViewModel: ConfiguratorViewModel): boolean;
     areAllComponentsInFrustum(previews: RoomleComponent[]): boolean;
     checkPreviewVisibility(configuratorViewModel: ConfiguratorViewModel): void;
+    isComponentMeasurementLabelOccluded(labelWorldPos: Vector3, component: RoomleComponent): boolean;
+    checkMultipleLabelOcclusion(labelPositions: Array<{
+        id: string;
+        worldPos: Vector3;
+    }>, component: RoomleComponent): Set<string>;
 }

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

@@ -39,6 +39,7 @@ export default class DimensioningHelper {
     removeFromObject(object: Object3D): void;
     addToUiScene(uiScene: Scene): void;
     removeFromUiScene(uiScene: Scene): void;
+    private _isCameraInsideOrTooClose;
     private _getWidthEdge;
     private _getDepthEdge;
     private _getHeightEdge;

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

@@ -22,12 +22,14 @@ import { default as CameraBehaviour3d } from '../../../common-core/src/cameracon
 import { default as GlobalInitData } from '../../../common-core/src/utils/global-init-data';
 import { CancelSelectionReasons } from '../../../typings/planner';
 import { ExternalConfiguration } from '../../../typings/external-objects';
+import { default as UnitFormatter } from '../services/unit-formatter';
 
 export default class ConfiguratorSceneManager extends SceneManager implements ConfiguratorViewModelCallbackI {
     _creator_: string;
     private _configuratorInputManager;
     private _configuratorMeshGenerator;
     private _memoryManager;
+    protected _unitFormatter: UnitFormatter;
     protected _configuratorContext: ConfiguratorContext;
     private _componentDimensioningHelper;
     private _configuratorHistory;
@@ -42,6 +44,7 @@ export default class ConfiguratorSceneManager extends SceneManager implements Co
     private _sceneEventHandler;
     private _currentComponent;
     private _isComponentDimensionsVisible;
+    private _dimensionUpdateDebounced;
     constructor(creator: string, offset: CanvasOffset, mode: Enumify<typeof CAMERA_TYPE>);
     private _initOptionalModules;
     protected _changeCameraBehaviour(cameraBehaviour: CameraBehaviour): void;
@@ -118,6 +121,11 @@ export default class ConfiguratorSceneManager extends SceneManager implements Co
     showDimensions(): Promise<void>;
     private _initDimensions;
     hideDimensions(): void;
+    private _updateComponentDimensionLabels;
+    /**
+     * Resolve label collisions by hiding lower priority overlapping labels
+     */
+    private _resolveCollisions;
     loadSceneSettings(sceneSetting: SceneSettings): Promise<void>;
     protected onCameraChanged(): void;
     requestDockingsPreview(userInitiated: boolean, possibleChild?: UiPossibleChild, dragEvent?: DragEvent, dragIn?: boolean): void;

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

@@ -365,11 +365,11 @@ export default class RoomlePlanner<P extends readonly PluginName[] = readonly []
     calcPartsPriceSum(partList: KernelPartList): Promise<KernelPartListPrice>;
     /**
      * Swap two plan objects in the scene in the same position for example swap two object variants
-     * @param old this is the current selected plan object
+     * @param old this is the current selected plan object (runtime ID number or PlanElementViewModel)
      * @param idOfNew the RAPI id of the new plan object
-     * returns runtime ID of the new object
+     * @returns runtime ID of the new object
      */
-    swapObject(old: PlanElementViewModel, idOfNew: RapiId): Promise<number>;
+    swapObject(old: number | PlanElementViewModel, idOfNew: RapiId): Promise<number>;
     exportImageFromCamera(filename?: string, shouldWaitForAssets?: boolean): Promise<void>;
     exportCanvasScreenshot(quality?: number): Promise<string>;
     /**

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

@@ -112,4 +112,5 @@ export default class PlannerKernelAccess extends ConfiguratorKernelAccess {
     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;
 }

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

@@ -97,6 +97,30 @@ export interface DimensionDefinition<Vector2Type = Vector3 | Position2, Vector3T
     isCurrentlyDrawn?: boolean;
     attic?: AtticDimension<Vector2Type, Vector3Type>;
 }
+export interface DimensionLabelsTransferable {
+    labels: DimensionLabel[];
+    componentId: number;
+}
+export interface DimensionLabel {
+    id: string;
+    value: number;
+    formattedValue?: string;
+    position: {
+        x: number;
+        y: number;
+    };
+    level: number;
+    angle?: number;
+    maxLevel: number;
+    isVisible: boolean;
+    axisKey?: string;
+    interactionKey?: string | null;
+    direction?: {
+        x: number;
+        y: number;
+        z: number;
+    } | null;
+}
 export declare const transformMeasurement: (measurement: MeasurementBase<Vector3, Vector3>) => MeasurementBase<Position2, Position3>;
 export declare const calculateWallPlanPoints: (planObject: WallPlanObject | ConstructionPlanObject, preferredSide: LeftOrRightWallSide) => {
     from: Vector3;
@@ -118,3 +142,17 @@ export declare const getWallCenterPoints: (planViewModel: ConstructionPlanObject
     wallFromCenterPoint: Vector3;
     wallToCenterPoint: Vector3;
 };
+/**
+ * Check if two labels collide in screen space (Case of component dimensions labels)
+ */
+export declare const labelsCollide: (label1: {
+    position: {
+        x: number;
+        y: number;
+    };
+}, label2: {
+    position: {
+        x: number;
+        y: number;
+    };
+}, width: number, height: number, padding: number) => boolean;

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

@@ -13,7 +13,6 @@ import { CameraParameter } from '../../../common-core/src/cameracontrol/camera-c
 import { default as PlanViewModel } from '../view-model/plan-view-model';
 import { default as ConfiguratorSceneManager } from '../../../configurator-core/src/webgl/configurator-scene-manager';
 import { default as WallPlanElementViewModel } from '../view-model/wall-plan-element-view-model';
-import { default as UnitFormatter } from '../../../configurator-core/src/services/unit-formatter';
 import { Enumify } from '../../../common-core/src/types';
 import { Object3D, Box3 } from 'three';
 import { CameraTarget, PrepareImageOptions } from '../../../common-core/src/webgl/image-renderer';
@@ -34,7 +33,6 @@ export default class PlannerSceneManager extends ConfiguratorSceneManager implem
     private _plannerInputManager;
     private _roomlePlannerUiCallback;
     private _localStorageHelper;
-    protected _unitFormatter: UnitFormatter;
     private _plannerSceneEventHandler;
     private _roomlePlannerCallback;
     private _itemsLoadingStatePromises;

package/src/configurator/components/DimensionLabels.vue.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+export default _default;

package/src/configurator/components/parameters/ParameterGroupButton.vue.d.ts

@@ -15,9 +15,9 @@ declare const _default: __VLS_WithTemplateSlots<import('vue').DefineComponent<{
     adjustIcon?: boolean;
     isSelected?: boolean;
 }> & Readonly<{}>, {
+    isVisible: boolean;
     onClick: () => void;
     isSelected: boolean;
-    isVisible: boolean;
     showText: boolean;
     adjustIcon: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>, {

package/src/configurator/store/ui-state.d.ts

@@ -9,6 +9,7 @@ import { RapiTagForUi } from '@roomle/web-sdk/typings/rapi-types';
 import { GridViewVariantElement } from '../components/grid-view/-utils/GridViewHelper';
 import { WallDimensionTransferable } from '@roomle/web-sdk/planner-core/src/view-model/wall-plan-element-view-model';
 import { PlanObjectPosition } from '@roomle/web-sdk/typings/planner';
+import { DimensionLabelsTransferable } from '@roomle/web-sdk/planner-core/src/utils/measurements';
 
 export type EnsurePrefix<T extends string> = Record<string, `${T}${string}`>;
 type UiStateIdentifier = EnsurePrefix<'UI_STATE_'>;
@@ -71,6 +72,7 @@ export interface UiState extends SharedUiState {
     isInIframe: boolean;
     firstTimeRoomView: boolean;
     currentInteractionView: Enumify<typeof INTERACTION_VIEW_TYPE>;
+    dimensionLabels: Nullable<DimensionLabelsTransferable>;
 }
 export declare const UI_STATE_MUTATIONS: UiStateIdentifier;
 export declare const UI_STATE_ACTIONS: UiStateIdentifier;

package/src/planner/components/overlays/product-settings/ProductRangeControl.vue.d.ts

@@ -240,8 +240,8 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     isString: BooleanConstructor;
     disabled: BooleanConstructor;
 }>> & Readonly<{}>, {
-    disabled: boolean;
     isString: boolean;
+    disabled: boolean;
 }, {}, {
     NumericInput: import('vue').DefineComponent<{
         valueLabel: string;