@equinor/echo-framework 5.0.0 → 6.1.0

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@equinor/echo-framework",
-  "version": "5.0.0",
+  "version": "6.1.0",
   "peerDependencies": {
-    "@equinor/echo-base": ">= 5.0.0 < 6.0.0",
-    "@equinor/echo-components": ">= 5.0.0 < 6.0.0",
-    "@equinor/echo-core": ">= 5.0.0 < 6.0.0",
-    "@equinor/echo-search": ">= 5.0.0 < 6.0.0",
-    "@equinor/echo-utils": ">= 5.0.0 < 6.0.0",
+    "@equinor/echo-base": ">= 6.1.0 < 7.0.0",
+    "@equinor/echo-components": ">= 6.1.0 < 7.0.0",
+    "@equinor/echo-core": ">= 6.1.0 < 7.0.0",
+    "@equinor/echo-search": ">= 6.1.0 < 7.0.0",
+    "@equinor/echo-utils": ">= 6.1.0 < 7.0.0",
     "@equinor/eds-core-react": "0.49.0",
     "@equinor/eds-icons": "0.22.0",
     "@equinor/eds-tokens": "2.1.0",

package/src/lib/feature/globalSelection/coordinate/coordinate.clean.d.ts

@@ -0,0 +1,6 @@
+import type { CoordinateId } from './coordinate.types';
+/**
+ * Validates and coerces a CoordinateId from the API into a clean CoordinateId.
+ * Returns undefined if the data is invalid (e.g. NaN coordinates, missing fields).
+ */
+export declare function cleanCoordinateId(raw: CoordinateId): CoordinateId | undefined;

package/src/lib/feature/globalSelection/coordinate/coordinate.logic.d.ts

@@ -0,0 +1,3 @@
+import type { PlantAndTagForOpenIn3d } from '../../openItemsIn3d/logic/openItemsIn3d.utils';
+import type { CoordinateData } from './coordinate.types';
+export declare function coordinatesToPlantTagPairs(coordinates: ReadonlyArray<CoordinateData>): ReadonlyArray<PlantAndTagForOpenIn3d>;

package/src/lib/feature/globalSelection/coordinate/coordinate.types.d.ts

@@ -0,0 +1,19 @@
+export interface CoordinateId {
+    readonly x: number;
+    readonly y: number;
+    readonly z: number;
+    readonly name: string;
+    readonly description: string | undefined;
+    readonly instCode: string;
+    /** Echo 3D plantCode */
+    readonly plantCode: string;
+    /** Sap id */
+    readonly plantNo: string;
+}
+/**
+ * Coordinates have no additional data beyond their identifying fields,
+ * so `CoordinateData` and `CoordinateId` are intentionally the same shape.
+ * Kept as separate aliases to mirror the other selection item types
+ * (`*Id` vs `*Data`) and allow future divergence without a breaking rename.
+ */
+export type CoordinateData = CoordinateId;

package/src/lib/feature/globalSelection/globalSelection.api.d.ts

@@ -1,4 +1,6 @@
-import { GlobalSelectionTypes } from './globalSelectionStore/globalSelectionStore.types';
+import { GlobalSelectionItemType, GlobalSelectionTypes, SelectionItemTypeToItemIdMap } from './globalSelectionStore/globalSelectionStore.types';
+import { isPdmsTagInSelection } from './pdmsTag/pdmsTag.logic';
+import { AddItemArgs } from './selectionMenu/selectionTreeStore/actions/selectionTree.action.types';
 import { GlobalSelectionCategoryId, SelectionTreeTypes } from './selectionMenu/selectionTreeStore/selectionTree.store.types';
 export declare const globalSelectionApi: Readonly<{
     /**
@@ -75,31 +77,34 @@ export declare const globalSelectionApi: Readonly<{
          * - 'ItemsUpdated': Existing items were replaced with new tags.
          * - 'ItemsAdded': New tags were added to the existing items.
          */
-        tags: (args: import("./selectionMenu/selectionTreeStore/actions/selectionTree.action.types").AddItemArgs<GlobalSelectionTypes.TagId>) => import("./selectionMenu/selectionTreeStore/selectionTree.store.types").AddTagsReturnType;
         /**
-         * Adds work orders to a specified list in the selection menu panel.
+         * Adds items of the given type to a specified list in the selection menu panel.
+         * This is the primary generic method. Per-type aliases (`tags`, `workOrders`, etc.) delegate to this.
          *
-         * @param {Object} args - The arguments for adding work orders.
-         * @param {Guid} args.groupId - Optional. The ID of the list to which the items should be added. If not provided, it will be added to the "Local Selection".
-         * @param {Readonly<Readonly<GlobalSelectionTypes.WorkOrderId>[]>} args.items - An array of WorkOrderId objects representing the work orders to be added.
+         * @param {GlobalSelectionItemType} itemType - The type of items to add.
+         * @param {AddItemArgs} args - The arguments for adding items.
          */
-        workOrders: (args: import("./selectionMenu/selectionTreeStore/actions/selectionTree.action.types").AddItemArgs<GlobalSelectionTypes.WorkOrderId>) => import("./selectionMenu/selectionTreeStore/selectionTree.store.types").AddWorkOrdersReturnType;
+        byType: <T extends GlobalSelectionItemType>(itemType: T, args: AddItemArgs<SelectionItemTypeToItemIdMap[T]>) => Promise<import("./selectionMenu/selectionTreeStore/actions/selectionTree.action.types").AddItemsResponse<T>>;
         /**
-         * Adds equipments to a specified list in the selection menu panel.
-         *
-         * @param {Object} args - The arguments for adding equipments.
-         * @param {Guid} args.groupId - Optional. The ID of the list to which the items should be added. If not provided, it will be added to the "Local Selection".
-         * @param {Readonly<Readonly<GlobalSelectionTypes.EquipmentId>[]>} args.items - An array of EquipmentId objects representing the work orders to be added.
+         * @deprecated Use `globalSelectionApi.add.byType(GlobalSelectionItemType.Tag, args)` instead.
+         * Tracked for removal once Echo3DWeb migrates: #447925
          */
-        equipments: (args: import("./selectionMenu/selectionTreeStore/actions/selectionTree.action.types").AddItemArgs<GlobalSelectionTypes.EquipmentId>) => import("./selectionMenu/selectionTreeStore/selectionTree.store.types").AddEquipmentsReturnType;
+        tags: (args: AddItemArgs<GlobalSelectionTypes.TagId>) => Promise<import("./selectionMenu/selectionTreeStore/actions/selectionTree.action.types").AddItemsResponse<GlobalSelectionItemType.Tag>>;
         /**
-         * Adds measuring points to a specified list in the selection menu panel.
-         *
-         * @param {Object} args - The arguments for adding measuring points.
-         * @param {Guid} args.groupId - Optional. The ID of the list to which the items should be added. If not provided, it will be added to the "Local Selection".
-         * @param {Readonly<Readonly<GlobalSelectionTypes.EquipmentId>[]>} args.items - An array of MeasuringPointId objects representing the work orders to be added.
+         * @deprecated Use `globalSelectionApi.add.byType(GlobalSelectionItemType.WorkOrder, args)` instead.
+         * Tracked for removal once Echo3DWeb migrates: #447925
+         */
+        workOrders: (args: AddItemArgs<GlobalSelectionTypes.WorkOrderId>) => Promise<import("./selectionMenu/selectionTreeStore/actions/selectionTree.action.types").AddItemsResponse<GlobalSelectionItemType.WorkOrder>>;
+        /**
+         * @deprecated Use `globalSelectionApi.add.byType(GlobalSelectionItemType.Equipment, args)` instead.
+         * Tracked for removal once Echo3DWeb migrates: #447925
          */
-        measuringPoints: (args: import("./selectionMenu/selectionTreeStore/actions/selectionTree.action.types").AddItemArgs<GlobalSelectionTypes.MeasuringPointId>) => import("./selectionMenu/selectionTreeStore/selectionTree.store.types").AddMeasuringPointsReturnType;
+        equipments: (args: AddItemArgs<GlobalSelectionTypes.EquipmentId>) => Promise<import("./selectionMenu/selectionTreeStore/actions/selectionTree.action.types").AddItemsResponse<GlobalSelectionItemType.Equipment>>;
+        /**
+         * @deprecated Use `globalSelectionApi.add.byType(GlobalSelectionItemType.MeasuringPoint, args)` instead.
+         * Tracked for removal once Echo3DWeb migrates: #447925
+         */
+        measuringPoints: (args: AddItemArgs<GlobalSelectionTypes.MeasuringPointId>) => Promise<import("./selectionMenu/selectionTreeStore/actions/selectionTree.action.types").AddItemsResponse<GlobalSelectionItemType.MeasuringPoint>>;
         /**
          * Adds items to a specified list in the selection menu panel.
          *
@@ -128,11 +133,6 @@ export declare const globalSelectionApi: Readonly<{
         findGroupByLabel: (args: {
             label: string;
         }) => import("@equinor/echo-utils").Guid | undefined;
-        /**
-         * Retrieves a tag item from the selection by tagNo and instCode.
-         * Returns undefined if the tag is not in the selection.
-         */
-        getTag: typeof getTag;
     };
     /**
      * Moves items, categories, or groups within the selection tree structure.
@@ -195,6 +195,10 @@ export declare const globalSelectionApi: Readonly<{
             color: string;
         }) => void;
     }>;
+    setRelatedTo: (args: ReadonlyArray<{
+        readonly itemId: GlobalSelectionTypes.ItemId;
+        readonly relatedTo: ReadonlyArray<import("./globalSelectionStore/globalSelectionStore.types").RelatedToItem>;
+    }>) => void;
     errorStatus: Readonly<{
         /**
          * Sets the error status for specific items in the selection menu panel.
@@ -242,6 +246,10 @@ export declare const globalSelectionApi: Readonly<{
          * @returns {number} The total number of items in all categories of the given groups.
          */
         numberOfItemsInSelection: (groups?: SelectionTreeTypes.Group[]) => number;
+        /**
+         * Checks if a tag (by tagNo + instCode) is in the selection and is a PDMS tag.
+         */
+        isPdmsTagInSelection: typeof isPdmsTagInSelection;
     }>;
     /**
      * Removes all items from the selection menu panel.
@@ -263,8 +271,4 @@ export declare const globalSelectionApi: Readonly<{
 }>;
 declare function getStoreTagIds(): GlobalSelectionTypes.TagId[];
 declare function getStoreEquipmentIds(): GlobalSelectionTypes.EquipmentId[];
-declare function getTag(args: {
-    readonly tagNo: string;
-    readonly instCode: string;
-}): GlobalSelectionTypes.TagItem | undefined;
 export {};

package/src/lib/feature/globalSelection/globalSelectionStore/actions/setRelatedTo.action.d.ts

@@ -0,0 +1,7 @@
+import type { GlobalSelectionStore, GlobalSelectionTypes, RelatedToItem } from '../globalSelectionStore.types';
+type SetFunction = (updater: (state: GlobalSelectionStore) => void, shouldReplace?: boolean, action?: string) => void;
+export declare function setRelatedToAction(set: SetFunction, args: ReadonlyArray<{
+    readonly itemId: GlobalSelectionTypes.ItemId;
+    readonly relatedTo: ReadonlyArray<RelatedToItem>;
+}>): void;
+export {};

package/src/lib/feature/globalSelection/globalSelectionStore/globalSelectionStore.d.ts

@@ -3,6 +3,7 @@ export declare const initialWorkOrderList: GlobalSelectionTypes.WorkOrderList;
 export declare const initialTagList: GlobalSelectionTypes.TagList;
 export declare const initialEquipmentList: GlobalSelectionTypes.EquipmentList;
 export declare const initialMeasuringPointList: GlobalSelectionTypes.MeasuringPointList;
+export declare const initialCoordinateList: GlobalSelectionTypes.CoordinateList;
 /**
  * The single source of truth for items stored in Global Selection.
  * Each item is stored here once, does not store item grouping in any way.
@@ -54,6 +55,10 @@ export declare const useGlobalSelectionStore: import("zustand").UseBoundStore<Om
         setAllItemsVisibility: (args: {
             isVisible: boolean;
         }) => void;
+        setRelatedTo: (args: ReadonlyArray<{
+            readonly itemId: GlobalSelectionTypes.ItemId;
+            readonly relatedTo: ReadonlyArray<import("./globalSelectionStore.types").RelatedToItem>;
+        }>) => void;
         setItemMetaData: (args: ReadonlyArray<import("./globalSelectionStore.types").GlobalSelectionItemIdMetadata>) => void;
         resetItemErrorStatuses: () => void;
         getStoredItemIds: () => ReadonlyArray<GlobalSelectionTypes.ItemId>;
@@ -68,6 +73,15 @@ export declare const useGlobalSelectionStore: import("zustand").UseBoundStore<Om
             WorkOrder: {
                 items: Map<GlobalSelectionTypes.ItemIdString, {
                     id: {
+                        x: number;
+                        y: number;
+                        z: number;
+                        name: string;
+                        description: string | undefined;
+                        instCode: string;
+                        plantCode: string;
+                        plantNo: string;
+                    } | {
                         workOrderId: string;
                     } | {
                         instCode: string;
@@ -109,11 +123,51 @@ export declare const useGlobalSelectionStore: import("zustand").UseBoundStore<Om
                         errorStatus: string | undefined;
                         systemStatus: import("./globalSelectionStore.types").SelectionItemSystemStatus;
                     };
+                    relatedTo?: {
+                        id: {
+                            x: number;
+                            y: number;
+                            z: number;
+                            name: string;
+                            description: string | undefined;
+                            instCode: string;
+                            plantCode: string;
+                            plantNo: string;
+                        } | {
+                            workOrderId: string;
+                        } | {
+                            instCode: string;
+                            tagNo: string;
+                        } | {
+                            internalTagType: import("..").PdmsInternalTagType;
+                            plantNo: string;
+                            plantCode: string;
+                            instCode: string;
+                            tagNo: string;
+                        } | {
+                            equipmentId: string;
+                        } | {
+                            measuringPointId: string;
+                        } | {
+                            key: string;
+                            value: string;
+                        };
+                        type: import("./globalSelectionStore.types").RelatedToItemType;
+                    }[] | undefined;
                 }>;
             };
             Tag: {
                 items: Map<GlobalSelectionTypes.ItemIdString, {
                     id: {
+                        x: number;
+                        y: number;
+                        z: number;
+                        name: string;
+                        description: string | undefined;
+                        instCode: string;
+                        plantCode: string;
+                        plantNo: string;
+                    } | {
                         workOrderId: string;
                     } | {
                         instCode: string;
@@ -168,11 +222,51 @@ export declare const useGlobalSelectionStore: import("zustand").UseBoundStore<Om
                         errorStatus: string | undefined;
                         systemStatus: import("./globalSelectionStore.types").SelectionItemSystemStatus;
                     };
+                    relatedTo?: {
+                        id: {
+                            x: number;
+                            y: number;
+                            z: number;
+                            name: string;
+                            description: string | undefined;
+                            instCode: string;
+                            plantCode: string;
+                            plantNo: string;
+                        } | {
+                            workOrderId: string;
+                        } | {
+                            instCode: string;
+                            tagNo: string;
+                        } | {
+                            internalTagType: import("..").PdmsInternalTagType;
+                            plantNo: string;
+                            plantCode: string;
+                            instCode: string;
+                            tagNo: string;
+                        } | {
+                            equipmentId: string;
+                        } | {
+                            measuringPointId: string;
+                        } | {
+                            key: string;
+                            value: string;
+                        };
+                        type: import("./globalSelectionStore.types").RelatedToItemType;
+                    }[] | undefined;
                 }>;
             };
             Equipment: {
                 items: Map<GlobalSelectionTypes.ItemIdString, {
                     id: {
+                        x: number;
+                        y: number;
+                        z: number;
+                        name: string;
+                        description: string | undefined;
+                        instCode: string;
+                        plantCode: string;
+                        plantNo: string;
+                    } | {
                         workOrderId: string;
                     } | {
                         instCode: string;
@@ -212,11 +306,51 @@ export declare const useGlobalSelectionStore: import("zustand").UseBoundStore<Om
                         errorStatus: string | undefined;
                         systemStatus: import("./globalSelectionStore.types").SelectionItemSystemStatus;
                     };
+                    relatedTo?: {
+                        id: {
+                            x: number;
+                            y: number;
+                            z: number;
+                            name: string;
+                            description: string | undefined;
+                            instCode: string;
+                            plantCode: string;
+                            plantNo: string;
+                        } | {
+                            workOrderId: string;
+                        } | {
+                            instCode: string;
+                            tagNo: string;
+                        } | {
+                            internalTagType: import("..").PdmsInternalTagType;
+                            plantNo: string;
+                            plantCode: string;
+                            instCode: string;
+                            tagNo: string;
+                        } | {
+                            equipmentId: string;
+                        } | {
+                            measuringPointId: string;
+                        } | {
+                            key: string;
+                            value: string;
+                        };
+                        type: import("./globalSelectionStore.types").RelatedToItemType;
+                    }[] | undefined;
                 }>;
             };
             MeasuringPoint: {
                 items: Map<GlobalSelectionTypes.ItemIdString, {
                     id: {
+                        x: number;
+                        y: number;
+                        z: number;
+                        name: string;
+                        description: string | undefined;
+                        instCode: string;
+                        plantCode: string;
+                        plantNo: string;
+                    } | {
                         workOrderId: string;
                     } | {
                         instCode: string;
@@ -255,6 +389,114 @@ export declare const useGlobalSelectionStore: import("zustand").UseBoundStore<Om
                         errorStatus: string | undefined;
                         systemStatus: import("./globalSelectionStore.types").SelectionItemSystemStatus;
                     };
+                    relatedTo?: {
+                        id: {
+                            x: number;
+                            y: number;
+                            z: number;
+                            name: string;
+                            description: string | undefined;
+                            instCode: string;
+                            plantCode: string;
+                            plantNo: string;
+                        } | {
+                            workOrderId: string;
+                        } | {
+                            instCode: string;
+                            tagNo: string;
+                        } | {
+                            internalTagType: import("..").PdmsInternalTagType;
+                            plantNo: string;
+                            plantCode: string;
+                            instCode: string;
+                            tagNo: string;
+                        } | {
+                            equipmentId: string;
+                        } | {
+                            measuringPointId: string;
+                        } | {
+                            key: string;
+                            value: string;
+                        };
+                        type: import("./globalSelectionStore.types").RelatedToItemType;
+                    }[] | undefined;
+                }>;
+            };
+            Coordinate: {
+                items: Map<GlobalSelectionTypes.ItemIdString, {
+                    id: {
+                        x: number;
+                        y: number;
+                        z: number;
+                        name: string;
+                        description: string | undefined;
+                        instCode: string;
+                        plantCode: string;
+                        plantNo: string;
+                    } | {
+                        workOrderId: string;
+                    } | {
+                        instCode: string;
+                        tagNo: string;
+                    } | {
+                        internalTagType: import("..").PdmsInternalTagType;
+                        plantNo: string;
+                        plantCode: string;
+                        instCode: string;
+                        tagNo: string;
+                    } | {
+                        equipmentId: string;
+                    } | {
+                        measuringPointId: string;
+                    };
+                    type: GlobalSelectionItemType.Coordinate;
+                    data: {
+                        x: number;
+                        y: number;
+                        z: number;
+                        name: string;
+                        description: string | undefined;
+                        instCode: string;
+                        plantCode: string;
+                        plantNo: string;
+                    };
+                    metaData: {
+                        color: string;
+                        isHiddenByUser: boolean;
+                        errorStatus: string | undefined;
+                        systemStatus: import("./globalSelectionStore.types").SelectionItemSystemStatus;
+                    };
+                    relatedTo?: {
+                        id: {
+                            x: number;
+                            y: number;
+                            z: number;
+                            name: string;
+                            description: string | undefined;
+                            instCode: string;
+                            plantCode: string;
+                            plantNo: string;
+                        } | {
+                            workOrderId: string;
+                        } | {
+                            instCode: string;
+                            tagNo: string;
+                        } | {
+                            internalTagType: import("..").PdmsInternalTagType;
+                            plantNo: string;
+                            plantCode: string;
+                            instCode: string;
+                            tagNo: string;
+                        } | {
+                            equipmentId: string;
+                        } | {
+                            measuringPointId: string;
+                        } | {
+                            key: string;
+                            value: string;
+                        };
+                        type: import("./globalSelectionStore.types").RelatedToItemType;
+                    }[] | undefined;
                 }>;
             };
         };

package/src/lib/feature/globalSelection/globalSelectionStore/globalSelectionStore.mutableSelectionItem.d.ts

@@ -1,4 +1,4 @@
-import { GlobalSelectionItemType, GlobalSelectionMetaData, GlobalSelectionTypes } from './globalSelectionStore.types';
+import { GlobalSelectionItemType, GlobalSelectionMetaData, GlobalSelectionTypes, RelatedToItem } from './globalSelectionStore.types';
 /**
  * This file defines mutable versions of selection items and lists for internal use in the global selection store.
  * These types are used in Immer set() callbacks where the state is a mutable draft, allowing us to bypass
@@ -21,6 +21,7 @@ type MutableSelectionItem<T extends GlobalSelectionItemType> = {
     type: T;
     data: GlobalSelectionTypes.ItemTypeToDataMap[T];
     metaData: Mutable<GlobalSelectionMetaData>;
+    relatedTo?: RelatedToItem[];
 };
 /**
  * Mutable version of a selection list for store-internal Immer mutations.

package/src/lib/feature/globalSelection/globalSelectionStore/globalSelectionStore.testHelpers.d.ts

@@ -0,0 +1,5 @@
+import type { EquipmentData, WorkOrderData } from '@equinor/echo-search';
+export declare function dataToResultArray<T extends WorkOrderData | EquipmentData>(data: Partial<T>[]): {
+    values: Partial<T>[];
+    isSuccess: boolean;
+};

package/src/lib/feature/globalSelection/globalSelectionStore/globalSelectionStore.types.d.ts

@@ -1,28 +1,54 @@
 import type { EquipmentData, MeasuringPointData, ResultArray, TagSummaryDto, WorkOrderData } from '@equinor/echo-search';
 import { Brand } from '@equinor/echo-utils';
+import type { CoordinateData, CoordinateId as CoordinateId_Imported } from '../coordinate/coordinate.types';
 import type { PdmsTagId, StidTagId } from '../pdmsTag/pdmsTag.types';
 export declare enum GlobalSelectionItemType {
     WorkOrder = "WorkOrder",
     Tag = "Tag",
     Equipment = "Equipment",
-    MeasuringPoint = "MeasuringPoint"
+    MeasuringPoint = "MeasuringPoint",
+    Coordinate = "Coordinate"
 }
 type GlobalSelectionTagDto = TagSummaryDto;
 type GlobalSelectionWorkOrderDto = WorkOrderData;
 type GlobalSelectionEquipmentDto = EquipmentData;
 type GlobalSelectionMeasuringPointDto = MeasuringPointData;
+type GlobalSelectionCoordinateDto = CoordinateData;
 export type GlobalSelectionItemTypeToDataMap = {
     [GlobalSelectionItemType.WorkOrder]: GlobalSelectionWorkOrderDto;
     [GlobalSelectionItemType.Tag]: GlobalSelectionTagDto;
     [GlobalSelectionItemType.Equipment]: GlobalSelectionEquipmentDto;
     [GlobalSelectionItemType.MeasuringPoint]: GlobalSelectionMeasuringPointDto;
+    [GlobalSelectionItemType.Coordinate]: GlobalSelectionCoordinateDto;
 };
 export type SelectionItemTypeToItemIdMap = {
     [GlobalSelectionItemType.WorkOrder]: GlobalSelectionTypes.WorkOrderId;
     [GlobalSelectionItemType.Tag]: GlobalSelectionTypes.TagId;
     [GlobalSelectionItemType.Equipment]: GlobalSelectionTypes.EquipmentId;
     [GlobalSelectionItemType.MeasuringPoint]: GlobalSelectionTypes.MeasuringPointId;
+    [GlobalSelectionItemType.Coordinate]: GlobalSelectionTypes.CoordinateId;
 };
+/**
+ * CustomData is a flexible key-value pair type that can be used in the relatedTo field of selection tree items.
+ * It allows associating any arbitrary data with a selection item, as long as it follows the structure of having a string key and a string value.
+ * This is useful for scenarios where we want to link selection items to external systems or include additional metadata that doesn't fit into the predefined item types.
+ * Cannot be set as a top-level item in the global selection, it can only be used in relatedTo.
+ */
+export interface CustomDataId {
+    readonly key: string;
+    readonly value: string;
+}
+/**
+ * Types allowed in relatedTo: all top-level types + CustomData (which is relatedTo-only).
+ */
+export type RelatedToItemType = GlobalSelectionItemType | 'CustomData';
+export type RelatedToItemTypeToIdMap = SelectionItemTypeToItemIdMap & {
+    readonly CustomData: CustomDataId;
+};
+export interface RelatedToItem {
+    readonly id: RelatedToItemTypeToIdMap[RelatedToItemType];
+    readonly type: RelatedToItemType;
+}
 type GlobalSelectionList<T extends GlobalSelectionItemType> = {
     readonly items: Map<GlobalSelectionTypes.ItemIdString, GlobalSelectionGenericItem<T>>;
 };
@@ -48,12 +74,14 @@ export type GlobalSelectionGenericItem<T extends GlobalSelectionItemType> = {
     readonly type: T;
     readonly data: GlobalSelectionTypes.ItemTypeToDataMap[T];
     readonly metaData: GlobalSelectionMetaData;
+    readonly relatedTo?: RelatedToItem[];
 };
 type EquipmentGlobalSelectionList = GlobalSelectionTypes.List<GlobalSelectionItemType.Equipment>;
 type WorkOrderGlobalSelectionList = GlobalSelectionTypes.List<GlobalSelectionItemType.WorkOrder>;
 type TagGlobalSelectionList = GlobalSelectionTypes.List<GlobalSelectionItemType.Tag>;
 type MeasuringPointGlobalSelectionList = GlobalSelectionTypes.List<GlobalSelectionItemType.MeasuringPoint>;
-type GlobalSelectionListUnion = WorkOrderGlobalSelectionList | TagGlobalSelectionList | EquipmentGlobalSelectionList;
+type CoordinateGlobalSelectionList = GlobalSelectionTypes.List<GlobalSelectionItemType.Coordinate>;
+type GlobalSelectionListUnion = WorkOrderGlobalSelectionList | TagGlobalSelectionList | EquipmentGlobalSelectionList | MeasuringPointGlobalSelectionList | CoordinateGlobalSelectionList;
 interface ItemErrorStatusUpdates {
     readonly itemId: GlobalSelectionTypes.ItemId;
     readonly errorStatus: string;
@@ -82,6 +110,10 @@ export interface GlobalSelectionStore extends GlobalSelectionStoreData {
     setAllItemsVisibility: (args: {
         isVisible: boolean;
     }) => void;
+    setRelatedTo: (args: ReadonlyArray<{
+        readonly itemId: GlobalSelectionTypes.ItemId;
+        readonly relatedTo: ReadonlyArray<RelatedToItem>;
+    }>) => void;
     setItemMetaData: (args: ReadonlyArray<GlobalSelectionItemIdMetadata>) => void;
     resetItemErrorStatuses: () => void;
     getStoredItemIds: () => ReadonlyArray<GlobalSelectionTypes.ItemId>;
@@ -109,7 +141,9 @@ export declare namespace GlobalSelectionTypes {
      */
     type TagId = StidTagId | PdmsTagId;
     type MeasuringPointId = Pick<GlobalSelectionMeasuringPointDto, 'measuringPointId'>;
-    type ItemId = WorkOrderId | EquipmentId | TagId | MeasuringPointId;
+    type CoordinateId = CoordinateId_Imported;
+    type RelatedToItemId = WorkOrderId | EquipmentId | TagId | MeasuringPointId | CoordinateId | CustomDataId;
+    type ItemId = WorkOrderId | EquipmentId | TagId | MeasuringPointId | CoordinateId;
     type ItemIdString = Brand<string, 'ItemIdString'>;
     type TagDto = GlobalSelectionTagDto;
     type WorkOrderDto = GlobalSelectionWorkOrderDto;
@@ -119,9 +153,10 @@ export declare namespace GlobalSelectionTypes {
     type WorkOrderItem = GlobalSelectionGenericItem<GlobalSelectionItemType.WorkOrder>;
     type TagItem = GlobalSelectionGenericItem<GlobalSelectionItemType.Tag>;
     type MeasuringPointItem = GlobalSelectionGenericItem<GlobalSelectionItemType.MeasuringPoint>;
+    type CoordinateItem = GlobalSelectionGenericItem<GlobalSelectionItemType.Coordinate>;
     type List<T extends GlobalSelectionItemType> = GlobalSelectionList<T>;
-    type SelectionItem = EquipmentItem | WorkOrderItem | TagItem | MeasuringPointItem;
-    type SelectionItemList = EquipmentItem[] | WorkOrderItem[] | TagItem[] | MeasuringPointItem[];
+    type SelectionItem = EquipmentItem | WorkOrderItem | TagItem | MeasuringPointItem | CoordinateItem;
+    type SelectionItemList = EquipmentItem[] | WorkOrderItem[] | TagItem[] | MeasuringPointItem[] | CoordinateItem[];
     type GenericItem<T extends GlobalSelectionItemType> = GlobalSelectionGenericItem<T>;
     type Store = GlobalSelectionStore;
     type ItemErrorStatusUpdate = ItemErrorStatusUpdates;
@@ -129,11 +164,13 @@ export declare namespace GlobalSelectionTypes {
     type TagList = TagGlobalSelectionList;
     type EquipmentList = EquipmentGlobalSelectionList;
     type MeasuringPointList = MeasuringPointGlobalSelectionList;
+    type CoordinateList = CoordinateGlobalSelectionList;
     type ListUnion = GlobalSelectionListUnion;
     type ItemTypeToDataMap = GlobalSelectionItemTypeToDataMap;
     type AddTagResult = GlobalSelectionAddItemResult<ResultArray<TagSummaryDto>[]>;
     type AddEquipmentsResult = GlobalSelectionAddItemResult<ResultArray<EquipmentData>[]>;
     type AddMeasuringPointResult = GlobalSelectionAddItemResult<ResultArray<MeasuringPointData>[]>;
+    type AddCoordinateResult = GlobalSelectionAddItemResult<ResultArray<CoordinateData>[]>;
     type ActionResult = GlobalSelectionActionResult;
     type ItemSystemStatus = SelectionItemSystemStatus;
 }