@smarterplan/ngx-smarterplan-core 1.4.6 → 1.4.7

package/lib/helpers.service.d.ts

@@ -29,6 +29,7 @@ export declare function openModalForVisitSwitch(modalService: NgbModal, model3D:
     sweepToMove: string;
     rotation: any;
 } | null): void;
+export declare function getCurrentLang(translate: TranslateService): string;
 /**
  * Return a string of a given date time in local format.
  * The format is determined by the current language.
@@ -77,3 +78,8 @@ export declare function isEmptyObject(object: any): boolean;
 export declare function shuffleArray(array: any[]): any[];
 export declare function numberToDateString(timestamp: number): string;
 export declare function durationToString(duration: number, translate: TranslateService): string;
+export declare function pointToString(point: {
+    x: number;
+    y: number;
+    z: number;
+}): string;

package/lib/mattertagData.d.ts

@@ -10,10 +10,11 @@ export declare class MattertagData {
     customIconIndex: number;
     private rotation;
     private poi;
+    private matterportSid;
     constructor(type: PoiType);
     setType(type: PoiType): void;
     setObject(object: DbObjectType, tagType: PoiType): void;
-    setElementID(ticketID: string): void;
+    setElementID(id: string): void;
     setPosition(position: {
         x: number;
         y: number;
@@ -31,6 +32,7 @@ export declare class MattertagData {
         y: number;
     }): void;
     setPoi(poi: POI): void;
+    setMatterportSid(sid: string): void;
     getData(): {
         label: string;
         description: string;
@@ -49,22 +51,62 @@ export declare class MattertagData {
             g: number;
             b: number;
         };
-        media: {
-            type: string;
-            src: string;
+    };
+    /**
+     * Get the descriptor for sdk.Tag.add(...descriptor)
+     * Format : [{ label, description, anchorPosition, stemVector, color, id? }]
+     * If matterportSid is defined (already known tag) we send it so the SDK
+     * reuse it instead of trying to create a new one and generate an error : "already in use".
+     */
+    getMattertagDescriptor(): [Record<string, any>];
+    /**
+     * Get data for sdk.Tag.editPosition() or sdk.Tag.editBillboard().
+     */
+    getTagSdkData(): {
+        anchorPosition: {
+            x: number;
+            y: number;
+            z: number;
+        };
+        stemVector: {
+            x: number;
+            y: number;
+            z: number;
         };
     };
+    /** Load the matterportSid from the poi metadata */
+    loadSidFromPoi(poi: POI): void;
+    /** Get the stem vector for the tag */
+    getStemVector(): {
+        x: number;
+        y: number;
+        z: number;
+    };
     getType(): PoiType;
-    getNormal(): any;
-    getCallbackActionMode(): MattertagActionMode;
-    getIcon(): "" | "icon_ticket.png" | "icon_equipment.png" | "icon_object3d.png";
-    getCoordinateString(): string;
-    getMetadataString(): string;
+    getNormal(): {
+        x: number;
+        y: number;
+        z: number;
+    };
+    getPosition(): {
+        x: number;
+        y: number;
+        z: number;
+    };
     getSweepID(): string;
     getObject(): any;
     getRotation(): {
         x: number;
         y: number;
-    };
+    } | null;
     getPoi(): POI;
+    getMatterportSid(): string | null;
+    /** Get the action mode for the tag */
+    getCallbackActionMode(): MattertagActionMode;
+    /** Get the icon for the tag */
+    getIcon(): string;
+    /** Get the coordinate string for the tag */
+    getCoordinateString(): string;
+    /** Get the metadata string for the tag */
+    getMetadataString(): string;
 }

package/lib/services/matterport-measurement.service.d.ts

@@ -0,0 +1,35 @@
+import { Router } from '@angular/router';
+import * as i0 from "@angular/core";
+export declare class MatterportMeasurementService {
+    private router;
+    private lastMeasure;
+    private distancesLastMeasure;
+    private lastScreenshotUri;
+    private resolution;
+    private visibility;
+    constructor(router: Router);
+    /**
+     * Callback after measurement is performed
+     */
+    getDistanceForLastMeasurement(sdk: any, currentSpaceID: string): void;
+    getLastDistances(): number[];
+    /**
+     * Takes screenshot and saves base64 in lastScreenshotUri
+     * @param sdk Matterport SDK
+     * @returns Promise
+     */
+    takeScreenShot(sdk: any): Promise<void>;
+    getScreenShotUri(): any;
+    getLastMeasurement(poseCamera: any): any;
+    setLastMeasure(points: any[]): void;
+    getResolution(): {
+        width: number;
+        height: number;
+    };
+    getVisibility(): {
+        mattertags: boolean;
+        sweeps: boolean;
+    };
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatterportMeasurementService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MatterportMeasurementService>;
+}

package/lib/services/matterport-navigation.service.d.ts

@@ -0,0 +1,38 @@
+import { Subject } from 'rxjs';
+import { CameraMode } from '../types.service';
+import * as i0 from "@angular/core";
+export declare class MatterportNavigationService {
+    sweepCollection: any;
+    sweeps: Array<string> | null;
+    floors: Array<{
+        id: string;
+        name: string;
+        sequence: number;
+    }> | null;
+    forbiddenSweeps: string[];
+    currentSweep: Subject<string>;
+    onCameraModeChanged: Subject<CameraMode>;
+    /** Emits whenever the set of current rooms changes (sdk.Room.current). */
+    onRoomChanged: Subject<any[]>;
+    inTransitionMode: boolean;
+    inTransitionSweep: boolean;
+    currentCameraMode: CameraMode;
+    currentRooms: any[];
+    /** Sequence number of the floor currently visible in sdk.Floor.current (null = single-floor or unknown). */
+    currentFloorSequence: number | null;
+    constructor();
+    action_toolbox_floorplan(sdk: any): Promise<void>;
+    action_toolbox_inside_view(sdk: any): void;
+    actionShowAllFloors(sdk: any): void;
+    action_toolbox_dollhouse(sdk: any): Promise<void>;
+    action_go_to_floor(sdk: any, floorName: string, matterportFloorSequence?: number): Promise<void>;
+    action_go_to_sweep(sdk: any, sweep: string, rotation?: {
+        x: number;
+        y: number;
+    } | null): Promise<void>;
+    removeForbiddenSweeps(sdk: any, forbiddenSweeps: string[]): Promise<void>;
+    getCurrentSweep(poseCamera: any): string | null;
+    setCameraMode(mode: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatterportNavigationService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MatterportNavigationService>;
+}

package/lib/services/matterport-object3d.service.d.ts

@@ -0,0 +1,31 @@
+import { IObject3D, PoiType, POI, DbObjectType } from '../types.service';
+import * as i0 from "@angular/core";
+export declare class MatterportObject3DService {
+    dictionnaryObjects3D: Map<string, any>;
+    dictionnarySceneObjects3D: Map<string, any>;
+    lastObject3D: any;
+    objectControl: any;
+    securityCameraAnimator: any;
+    azimuthalCrown: any;
+    threeJSScene: any;
+    noLightForObjects: boolean;
+    constructor();
+    init3DObjectViewer(sdk: any): Promise<void>;
+    add3DObject(sdk: any, obj: IObject3D, mode?: 'translate' | 'rotate'): Promise<any>;
+    deleteObject3D(uuid: string): Promise<void>;
+    getObject3DModelNodeFromDictionnary(uuid: string): any;
+    toggleObjectVisibility(objectId: any): void;
+    isObjectVisible(objectId: any): boolean;
+    pointCameraTo3DObject(sdk: any, objectId: any, createTagCallback: (tagType: PoiType, object: DbObjectType, poi: POI) => Promise<any>, goToTagCallback: (sid: string) => Promise<any>, deleteLastTagCallback: () => void, getTagFromElementId: (id: string) => {
+        tag: string;
+        sweep: string;
+    }): Promise<void>;
+    getSceneNodeFromObject3DId(uuid: string): any;
+    displayAzimutalCrown(poseCamera: any): Promise<void>;
+    attachGizmoControlTo3DObject(sdk: any, modelNode: any, sceneObject: any, mode: 'translate' | 'rotate' | 'scale', visible: boolean, isNewObject: boolean): Promise<any>;
+    removeGizmoFromLastObject(): void;
+    toggleViewFrustum(): void;
+    clear(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatterportObject3DService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MatterportObject3DService>;
+}

package/lib/services/matterport-pointer.service.d.ts

@@ -0,0 +1,31 @@
+import * as i0 from "@angular/core";
+export declare class MatterportPointerService {
+    private pointerButton;
+    private getCursorPositionButton;
+    private textDisplayCursorPositionPanel;
+    private cursorPositionButtonDisplayed;
+    private intervalCursorPointerPosition;
+    private timerPointer;
+    private oldPoseMatterportPosition;
+    constructor();
+    init(container: HTMLElement, pointerButton: HTMLElement, getCursorPositionButton: HTMLElement, textDisplayCursorPositionPanel: HTMLElement, callbacks: {
+        onLeftClick: (evt: MouseEvent) => void;
+        onRightClick: (evt: MouseEvent) => void;
+        onMiddleClick: (evt: MouseEvent) => void;
+    }): void;
+    startPointerTrick(sdk: any, container: any, getPose: () => any, getPoseCamera: () => any, getInteractionMode: () => number, getMattertagToFollow: () => string | null): void;
+    stopPointerTrick(): void;
+    startAdminCursorTracker(sdk: any, container: any, getPose: () => any, getPoseCamera: () => any): void;
+    stopAdminCursorTracker(): void;
+    updatePointerTrick(sdk: any, container: any, poseMatterport: any, poseCamera: any, interactionMode: number, mattertagToFollow: string | null): void;
+    getDistPosition(sdk: any, container: any, poseCamera: any, pos1: any, pos2: any): number;
+    updateCursorDisplay(poseMatterport: any): void;
+    clear(callbacks: {
+        onLeftClick: (evt: MouseEvent) => void;
+        onRightClick: (evt: MouseEvent) => void;
+        onMiddleClick: (evt: MouseEvent) => void;
+    }): void;
+    setCursorPositionButtonDisplayed(value: boolean): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatterportPointerService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MatterportPointerService>;
+}

package/lib/services/matterport-tag.service.d.ts

@@ -0,0 +1,104 @@
+import { Subject } from 'rxjs';
+import { MattertagData } from '../mattertagData';
+import { PoiType, DbObjectType, POI, CameraMode } from '../types.service';
+import { MatterportNavigationService } from './matterport-navigation.service';
+import { BaseTagService } from './tag.service';
+import * as i0 from "@angular/core";
+export declare class MatterportTagService {
+    private navigationService;
+    dictionnaryTags: Map<string, MattertagData>;
+    tagAddQueue: Promise<any>;
+    mattertagToFollow: string | null;
+    onGoToTag: Subject<string>;
+    mattertagIDs: Array<string>;
+    tagsAttachments: Object;
+    tagMessengerOn: boolean;
+    tagService: BaseTagService | null;
+    private tagsCurrentOpacity;
+    private tagsCurrentEnabled;
+    constructor(navigationService: MatterportNavigationService);
+    setTagService(service: BaseTagService): void;
+    /** Opens a specific tag in the Matterport viewer by its ID. */
+    goToTag(sdk: any, sid: string): Promise<any>;
+    /** Opens the most recently created tag in the viewer. */
+    goToLastTag(sdk: any): Promise<any>;
+    /**
+     * Adds a Mattertag to the viewer, serializing calls to prevent SDK race conditions.
+     * Reuses existing IDs if the tag is already present in the session.
+     */
+    addMattertagToViewer(sdk: any, mattertagData: MattertagData): Promise<string | null>;
+    /**
+     * Internal method to add and configure a Mattertag with icon, opacity, and HTML content.
+     * Handles existing tags gracefully and queues operations to avoid SDK conflicts.
+     */
+    _doAddMattertag(sdk: any, mattertagData: MattertagData, setTagIconAndOpacity: (sid: string, mt: MattertagData) => Promise<void>, injectHtmlInTag: (type: PoiType, obj: DbObjectType, sid: string) => Promise<void>): Promise<string>;
+    getDistance(p1: any, p2: any): number;
+    /**
+     * Checks if a tag is within the bounding box of any active room (adding a slight margin to account for wall-mounted tags).
+     * If there are no active rooms (e.g., hallway), falls back to returning true.
+     */
+    isTagInRooms(mattertagData: MattertagData, rooms: any[]): boolean;
+    /**
+     * Computes the final context-aware opacity for a single tag.
+     * @param currentFloorSequence  Authoritative current floor sequence from sdk.Floor.current
+     *                              (null = single-floor model or unknown).
+     * @param currentRooms          Array of active rooms the camera is in.
+     */
+    /** Returns the ID of the most recently added tag. */
+    getLastTag(): string | null;
+    /**
+     * Updates the visibility (opacity) of all tags based on the current camera mode,
+     * floor and room context. Must be called after each sweep, floor or mode change.
+     *
+     * Rules:
+     *  - DOLLHOUSE / FLOORPLAN → all tags hidden (opacity 0).
+     *  - INSIDE → only tags whose sweep belongs to the current floor are shown;
+     *    proximity-based opacity is applied via computeTagOpacity().
+     *    Tags on other floors are hidden (opacity 0).
+     *  - TRANSITIONING → no change (skip update to avoid flickering).
+     *
+     * @param sdk          Matterport SDK instance.
+     * @param poseCamera   Current camera pose.
+     * @param sweepCollection  Full collection of sweeps.
+     * @param currentCameraMode  Current camera mode.
+     * @param mattertagToFollow  ID of the cursor tag (never touched).
+     */
+    updateTagsVisibilityForContext(sdk: any, sweepCollection: any, currentCameraMode: CameraMode, mattertagToFollow: string | null, currentFloorSequence?: number | null, currentRooms?: any[]): Promise<void>;
+    /** Removes a specific tag from the viewer and local dictionaries. */
+    deleteMattertagFromId(sdk: any, mattertagID: string): Promise<void>;
+    /** Removes the last added tag from the viewer. */
+    deleteLastMattertag(sdk: any): Promise<void>;
+    /** Clears all tags from the viewer and resets local state. */
+    action_delete_all_mattertags(sdk: any): Promise<void>;
+    /**
+     * Creates and configures a Mattertag from a POI, handling coordinates, normals, and sweep ID.
+     * Skips creation if a tag for the object already exists.
+     */
+    createMattertagFromPOI(sdk: any, tagType: PoiType, object: DbObjectType, poi: POI, poseCamera: any, getTagFromElementId: (id: string) => {
+        tag: string;
+        sweep: string;
+    }, setTagIconAndOpacity: (sid: string, mt: MattertagData) => Promise<void>, injectHtmlInTag: (type: PoiType, obj: DbObjectType, sid: string) => Promise<void>): Promise<any>;
+    /** Updates the icon, opacity, and HTML content of an existing tag. */
+    updateMatterTagContentForTagID(sdk: any, mattertagID: string, object: DbObjectType, poiType: PoiType, setTagIconAndOpacity: (sid: string, mt: MattertagData) => Promise<void>, injectHtmlInTag: (type: PoiType, obj: DbObjectType, sid: string) => Promise<void>): Promise<any>;
+    /** Registers a custom texture and applies it to a tag, optionally adjusting opacity. */
+    addNewIconAndSetForTag(sdk: any, mattertagID: string, iconPath: string, applyOpacity: boolean, opacity: number): Promise<void>;
+    /** Finds the tag ID and sweep ID associated with a specific element ID. */
+    getTagFromElementId(elementID: string, sweeps: string[] | null): {
+        tag: string | null;
+        sweep: string | null;
+    };
+    /** Retrieves the floor identifier associated with a tag based on its sweep data.
+     *  Handles both the object form ({ floorInfo: { id, sequence }, floor: { id } })
+     *  and the primitive form (floor: number) used by Matterport SDK v3.
+     */
+    getFloorIdForTag(mattertagData: MattertagData, sweepCollection: any): string | null;
+    /**
+     * Injects custom HTML or fallback billboard media into a Mattertag sandbox.
+     * Attaches event listeners for interactive elements within the tag.
+     */
+    injectHtmlInTag(sdk: any, tagType: PoiType, object: DbObjectType, tagID: string): Promise<void>;
+    /** Clears all local tag data and resets the addition queue. */
+    clear(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MatterportTagService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MatterportTagService>;
+}

package/lib/services/matterport.service.d.ts

@@ -7,6 +7,11 @@ import { BaseTagService } from './tag.service';
 import { BaseVisibilityService } from './baseVisibility.service';
 import { Config } from '../config';
 import { CameraMode } from '../types.service';
+import { MatterportMeasurementService } from './matterport-measurement.service';
+import { MatterportNavigationService } from './matterport-navigation.service';
+import { MatterportPointerService } from './matterport-pointer.service';
+import { MatterportObject3DService } from './matterport-object3d.service';
+import { MatterportTagService } from './matterport-tag.service';
 import * as i0 from "@angular/core";
 /**
  * Custom Threejs Object 3D interface
@@ -42,8 +47,11 @@ export declare class MatterportService {
     private activeRoute;
     private visibilityService;
     private ngZone;
-    private slots;
-    private nodes;
+    private measurementService;
+    private navigationService;
+    private pointerService;
+    private object3DService;
+    private matterportTagService;
     sdk: any;
     private container;
     private poseMatterport;
@@ -53,77 +61,81 @@ export declare class MatterportService {
         sweep: any;
     };
     lastCameraPosition: any;
-    private azimuthalCrown;
-    private pointerButton;
-    private getCursorPositionButton;
-    private cursorPositionButtonDisplayed;
-    private intervalCursorPointerPosition;
-    private textDisplayCursorPositionPanel;
-    private oldPoseMatterportPosition;
     private isMeasureModeOn;
     private interactionMode;
-    private mattertagIDs;
-    private dictionnaryTags;
-    private dictionnaryObjects3D;
-    private dictionnarySceneObjects3D;
-    threeJSScene: any;
-    private lastMeasure;
-    private distancesLastMeasure;
-    private resolution;
-    private visibility;
-    tagsAttachments: Object;
-    private lastScreenshotUri;
-    sweeps: Array<string> | null;
-    currentSweep: Subject<string>;
+    private cameraMode;
+    get mattertagIDs(): Array<string>;
+    set mattertagIDs(value: Array<string>);
+    get dictionnaryTags(): Map<string, MattertagData>;
+    get dictionnaryObjects3D(): Map<string, any>;
+    get dictionnarySceneObjects3D(): Map<string, any>;
+    get threeJSScene(): any;
+    set threeJSScene(value: any);
+    get azimuthalCrown(): any;
+    set azimuthalCrown(value: any);
+    get tagsAttachments(): Object;
+    get sweeps(): Array<string> | null;
+    set sweeps(value: Array<string> | null);
+    get sweepCollection(): any;
+    set sweepCollection(value: any);
+    get currentSweep(): Subject<string>;
     currentCameraPose: Subject<any>;
-    private floors?;
+    get floors(): Array<{
+        id: string;
+        name: string;
+        sequence: number;
+    }> | null;
+    set floors(value: Array<{
+        id: string;
+        name: string;
+        sequence: number;
+    }> | null);
     private _currentSpaceID;
-    private lastObject3D;
-    private currentFloor;
+    get lastObject3D(): any;
+    set lastObject3D(value: any);
+    get currentRooms(): any[];
+    set currentRooms(value: any[]);
     get currentSpaceID(): string;
     set currentSpaceID(value: string);
-    timerPointer: any;
-    forbiddenSweeps: string[];
+    get forbiddenSweeps(): string[];
+    set forbiddenSweeps(value: string[]);
     tagAction: Subject<{
         action: string;
         data: string;
     }>;
-    mattertagToFollow: string | null;
+    get mattertagToFollow(): string | null;
+    set mattertagToFollow(value: string | null);
+    get inTransitionMode(): boolean;
+    set inTransitionMode(value: boolean);
+    get inTransitionSweep(): boolean;
+    set inTransitionSweep(value: boolean);
+    private noLightForObjects;
+    get currentCameraMode(): CameraMode;
+    set currentCameraMode(value: CameraMode);
+    get onCameraModeChanged(): Subject<CameraMode>;
+    get onRoomChanged(): Subject<any[]>;
+    get onGoToTag(): Subject<string>;
     tagService: BaseTagService;
     config: Config;
-    inTransitionMode: boolean;
-    inTransitionSweep: boolean;
-    private noLightForObjects;
-    currentCameraMode: CameraMode;
-    onCameraModeChanged: Subject<CameraMode>;
-    onGoToTag: Subject<string>;
-    tagMessengerOn: boolean;
     SPModule: SpModule;
-    objectControl: any;
-    private securityCameraAnimator;
+    get objectControl(): any;
+    get securityCameraAnimator(): any;
     /**
      * Actions on left click when positioning mattertag in visit
      */
-    pointerLeftClickHandler: () => void;
+    pointerLeftClickHandler: (evt: MouseEvent) => void;
     pointerRightClickHandler: (e: any) => void;
     pointerMiddleClickHandler: (e: any) => void;
-    constructor(config: Config, router: Router, activeRoute: ActivatedRoute, visibilityService: BaseVisibilityService, ngZone: NgZone);
+    constructor(config: Config, router: Router, activeRoute: ActivatedRoute, visibilityService: BaseVisibilityService, ngZone: NgZone, measurementService: MatterportMeasurementService, navigationService: MatterportNavigationService, pointerService: MatterportPointerService, object3DService: MatterportObject3DService, matterportTagService: MatterportTagService);
     /**
-     * Initializes Matterport and all listeners/data
-     * @param tagService BaseTagService (to inject html)
-     * @param module SpModule (Museum, Immo) to subscribe only to needed functionnnalities
-     * @returns boolean
+     * Initializes the Matterport SDK, sets up event listeners, and configures assets.
+     * @param tagService Service used to generate and inject HTML into tags.
+     * @param module Application module (e.g., IMMO, MUSEUM) to enable specific features.
+     * @returns Promise resolving to true when initialization is complete.
      */
     initSdk(tagService: BaseTagService, module?: SpModule): Promise<boolean>;
+    getSweepUUIDForSid(sid: string): string | null;
     setLightingOff(): void;
-    pointToString(point: {
-        x: number;
-        y: number;
-        z: number;
-    }): string;
-    /**
-     * Callback after measurement is performed
-     */
     getDistanceForLastMeasurement(): void;
     getLastDistances(): number[];
     /**
@@ -133,10 +145,17 @@ export declare class MatterportService {
     takeScreenShot(): Promise<any>;
     getScreenShotUri(): any;
     getLastMeasurement(): Object;
+    private getFloorIdForTag;
     /**
      * Styling of pointer
      */
     updatePointerTrick(): void;
+    /**
+     * Triggers a tag visibility refresh based on current camera mode, floor and sweep.
+     * Delegates all logic to MatterportTagService.updateTagsVisibilityForContext().
+     * Called automatically on Mode, Sweep, Floor and Room changes.
+     */
+    refreshTagsVisibility(): void;
     /**
      * Realtime mattertag following the cursor
      * @param mattertag string
@@ -149,51 +168,31 @@ export declare class MatterportService {
      * @param pos2
      */
     getDistPosition(pos1: any, pos2: any): number;
-    /**
-     * Creates the Mattertag that will follow the cursor
-     * @param mattertagData MattertagData
-     */
+    /** Creates a temporary Mattertag that follows the user's cursor for positioning. */
     addCursorMattertag(mattertagData: MattertagData): Promise<void>;
-    /**
-     * Adds Mattertag to viewer for an existing object with coordinates (in mattertagData.poi)
-     * (position, injected html, set icon)
-     * @param mattertagData
-     * returns mattertagID
-     */
+    get tagAddQueue(): Promise<any>;
+    set tagAddQueue(value: Promise<any>);
     addMattertagToViewer(mattertagData: MattertagData): Promise<string | null>;
-    /**
-     * Actions when position of mattertag is validated by left click
-     */
+    /** Triggers callback actions after a tag's position is validated by a left click. */
     onValidatedMattertag(): void;
-    /**
-     * Registers new icon (path to image) and set its for Mattertag
-     * @param mattertagID string
-     * @param iconPath string
-     */
+    /** Registers a new icon texture and applies it to a specific Mattertag. */
     addNewIconAndSetForTag(mattertagID: string, iconPath: string): Promise<void>;
-    /**
-     * Changes icon of Mattertag (the iconName should be registered = one of default ones)
-     * @param mattertagID string
-     * @param iconName string
-     */
+    /** Applies a pre-registered icon to a Mattertag. */
     setRegistredIconForTag(mattertagID: string, iconName: string): Promise<void>;
-    /**
-     * Sets default icon for a tag (registered in initSdk) OR uses tagIcon from POI (available from MattertagData)
-     * @param mattertagID string
-     * @param mattertagData MattertagData
-     * @returns
-     */
+    /** Sets the appropriate icon and opacity for a tag based on its type and POI metadata. */
     setTagIconAndOpacity(mattertagID: string, mattertagData: MattertagData): Promise<void>;
-    /**
-     * Moves viewer to last tag created
-     */
-    goToLastTag(): void;
-    /**
-     * Moves viewer to Mattertag with ID provided
-     * @param mattertagID string
-     * @returns
-     */
+    /** Navigates the camera to the most recently created tag. */
+    goToLastTag(): Promise<void>;
+    /** Navigates the camera to a specific Mattertag by its ID. */
     goToTag(mattertagID: string): Promise<void>;
+    /**
+      * Computes the context-aware opacity for a single tag at the moment it is rendered.
+      * - Cursor tag: always use provided defaultOpacity.
+      * - DOLLHOUSE / FLOORPLAN: 0 (hidden).
+      * - INSIDE: floor-filtered proximity opacity via MatterportTagService.
+      * - Other / unknown: defaultOpacity.
+      */
+    private addCustomCss;
     /**
      * Updates content of Mattertag with mattertagID (billboard, injected html, tag icon)
      * @param mattertagID string
@@ -216,7 +215,7 @@ export declare class MatterportService {
     /**
      * Deletes latest created mattertag
      */
-    deleteLastMattertag(): void;
+    deleteLastMattertag(): Promise<void>;
     /**
      * Legacy: used to be called action_add_mattertag_from_POI
      * Adds and configures Mattertag for an object (Ticket, Equipment, Feature, etc) that corresponds to POI (coordinates, tagIcon)
@@ -238,7 +237,7 @@ export declare class MatterportService {
      * Deletes Mattertag from visit associated with object ID (ticketID, etc)
      * @param elementID string
      */
-    deleteMattertagForObject(elementID: string): Promise<void>;
+    deleteMattertagForObject(elementID: string): Promise<any>;
     /**
      * uuid from threejs
      * @param uuid
@@ -306,7 +305,7 @@ export declare class MatterportService {
     action_go_to_sweep(sweep: string, rotation?: {
         x: number;
         y: number;
-    }): Promise<void>;
+    } | null): Promise<void>;
     getCurrentSweep(): string | null;
     getCurrentCameraPosition(): {
         rotation: any;

package/lib/services/models/equipment.service.d.ts

@@ -1,5 +1,5 @@
 import { NgbModal } from '@ng-bootstrap/ng-bootstrap';
-import { Subject } from 'rxjs';
+import { BehaviorSubject, Subject } from 'rxjs';
 import { MattertagData } from '../../mattertagData';
 import { Note, Zone, Equipment, EquipmentDocument, Ticket, TypeNote, Mission, Operation, POI } from '../../types.service';
 import { FilterService } from '../filter.service';
@@ -31,7 +31,7 @@ export declare class EquipmentService extends BaseObjectService {
         space: Equipment[];
         zonesMap: Map<string, Equipment[]>;
     };
-    equipmentsTags: Subject<Equipment[]>;
+    equipmentsTags: BehaviorSubject<Equipment[]>;
     zoneIDFilter: string;
     currentZone: Zone;
     currentSpaceID: string;

package/lib/services/models/feature.service.d.ts

@@ -1,4 +1,4 @@
-import { Subject } from "rxjs";
+import { BehaviorSubject, Subject } from "rxjs";
 import { MattertagData } from "../../mattertagData";
 import { Feature, Hashtag, POI, Event } from "../../types.service";
 import { FilterService } from "../filter.service";
@@ -27,7 +27,7 @@ export declare class FeatureService extends BaseObjectService {
         space: Feature[];
         zone: Feature[];
     };
-    featureTags: Subject<Feature[]>;
+    featureTags: BehaviorSubject<Feature[]>;
     featureFiltered: Feature[];
     updateDone: Subject<boolean>;
     zoneIDFilter: string;

package/lib/services/models/measurement.service.d.ts

@@ -1,4 +1,4 @@
-import { Subject } from 'rxjs';
+import { BehaviorSubject, Subject } from 'rxjs';
 import { Measurement, Comment, Zone } from '../../types.service';
 import { FilterService } from '../filter.service';
 import { NavigatorService } from '../navigator.service';
@@ -21,7 +21,7 @@ export declare class MeasurementService {
         space: Measurement[];
         zone: Measurement[];
     };
-    measurementsTags: Subject<Comment[]>;
+    measurementsTags: BehaviorSubject<Comment[]>;
     measurementsUpdated: Subject<{
         space: Measurement[];
         zone: Measurement[];