@equinor/echo-framework 4.0.1 → 4.1.0

package/package.json

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

package/src/index.d.ts

@@ -31,7 +31,7 @@ export { PopoverLoading } from './lib/feature/legend/components/pdfMarkers/subCo
 export * from './lib/feature/legend/index';
 export { legendVisibleTagsSubscribeToStore } from './lib/feature/legend/stores/legendVisibleDataAsTagsStore/legendVisibleDataAsTagsStore';
 export { knownLegendIds } from './lib/feature/legend/types/legendType';
-export type { LegendDataId, LegendEquipmentId, LegendId, LegendState, LegendTagId } from './lib/feature/legend/types/legendType';
+export type { LegendDataId, LegendEquipmentId, LegendId, LegendState, LegendTagId, LegendWorkOrderId } from './lib/feature/legend/types/legendType';
 export { echoMapsIcon } from './lib/icons/echoMapsIcon';
 export type { Brand } from '@equinor/echo-utils';
 export { NewLegendToggler } from './lib/feature/legend/components/NewLegendToggler';

package/src/lib/feature/globalSelection/OpenGlobalSelectionIn3DButton.utils.d.ts

@@ -1,4 +1,6 @@
+import type { TagSummaryDto } from '@equinor/echo-search';
 import { PlantAndTagForOpenIn3d } from '../openItemsIn3d/logic/openItemsIn3d.utils';
+import type { PdmsTagSummaryDto } from './pdmsTag/pdmsTag.types';
 /**
  * Converts global selection items to plant tag pairs.
  *
@@ -12,3 +14,10 @@ import { PlantAndTagForOpenIn3d } from '../openItemsIn3d/logic/openItemsIn3d.uti
  * @returns {Promise<PlantAndTagForOpenIn3d[]>} A promise that resolves to an array of plant tag pairs.
  */
 export declare function convertGlobalSelectionItemsToPlantTagPairs(): Promise<PlantAndTagForOpenIn3d[]>;
+interface SeparatedTags {
+    readonly stidTags: ReadonlyArray<TagSummaryDto>;
+    readonly pdmsTags: ReadonlyArray<PdmsTagSummaryDto>;
+}
+export declare function separateStidAndPdmsTags(tags: ReadonlyArray<TagSummaryDto>): SeparatedTags;
+export declare function pdmsTagsToPlantTagPairs(pdmsTags: ReadonlyArray<PdmsTagSummaryDto>): ReadonlyArray<PlantAndTagForOpenIn3d>;
+export {};

package/src/lib/feature/globalSelection/components/SelectionActionBar/SelectionFeedbackDisplay.d.ts

@@ -0,0 +1,7 @@
+import type { SelectionFeedbackType } from './selectionFeedback.types';
+interface SelectionFeedbackDisplayProps {
+    readonly feedbackType: SelectionFeedbackType;
+    readonly className?: string;
+}
+export declare const SelectionFeedbackDisplay: React.FC<SelectionFeedbackDisplayProps>;
+export {};

package/src/lib/feature/globalSelection/components/SelectionActionBar/selectionFeedback.types.d.ts

@@ -0,0 +1 @@
+export type SelectionFeedbackType = 'added' | 'removed' | 'addError' | 'removeError' | 'colorChanged' | 'colorChangeError';

package/src/lib/feature/globalSelection/components/SelectionActionBar.d.ts

@@ -1,8 +1,7 @@
-import { Guid } from '@equinor/echo-utils';
 import { GlobalSelectionTypes } from '../globalSelectionStore/globalSelectionStore.types';
 export interface SelectionActionBarProps {
-    itemId: GlobalSelectionTypes.ItemId;
-    onAddItemClick: (groupId: Guid) => void;
-    className?: string;
+    readonly itemId: GlobalSelectionTypes.ItemId;
+    readonly className?: string;
+    readonly showPopoverUpdateDelay?: boolean;
 }
 export declare const SelectionActionBar: React.FC<SelectionActionBarProps>;

package/src/lib/feature/globalSelection/components/SelectionMenuTrigger/SelectionGroupMenuItem.d.ts

@@ -0,0 +1,9 @@
+import { Guid } from '@equinor/echo-utils';
+import { SelectionGroup } from '../../selectionMenu/selectionTreeStore/selectionTree.store.types';
+interface SelectionGroupMenuItemProps {
+    readonly group: SelectionGroup;
+    readonly isItemInGroup: boolean;
+    readonly onSelectionChanged: (groupId: Guid) => void;
+}
+export declare const SelectionGroupMenuItem: (props: SelectionGroupMenuItemProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/src/lib/feature/globalSelection/components/SelectionMenuTrigger/SelectionMenuTrigger.d.ts

@@ -0,0 +1,12 @@
+import { Guid } from '@equinor/echo-utils';
+import { GlobalSelectionTypes } from '../../globalSelectionStore/globalSelectionStore.types';
+interface SelectionMenuTriggerProps {
+    readonly itemId: GlobalSelectionTypes.ItemId;
+    readonly onAddToSelection: (groupId: Guid) => void;
+    readonly onRemoveFromSelection: (groupId: Guid) => void;
+    readonly partOfListsText?: string;
+    readonly isError?: boolean;
+    readonly isLoading?: boolean;
+}
+export declare const SelectionMenuTrigger: (props: SelectionMenuTriggerProps) => import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -127,6 +127,11 @@ 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.
@@ -257,4 +262,8 @@ 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/globalSelectionStore.d.ts

@@ -55,11 +55,11 @@ export declare const useGlobalSelectionStore: import("zustand").UseBoundStore<Om
             itemIds: ReadonlyArray<GlobalSelectionTypes.ItemId>;
         }) => void;
         setColorByItemIds: (args: {
-            itemIds: readonly Readonly<GlobalSelectionTypes.ItemId>[];
+            itemIds: ReadonlyArray<Readonly<GlobalSelectionTypes.ItemId>>;
             color: string;
         }) => void;
         setVisibilityByItemIds: (args: {
-            itemIds: readonly Readonly<GlobalSelectionTypes.ItemId>[];
+            itemIds: ReadonlyArray<Readonly<GlobalSelectionTypes.ItemId>>;
             isVisible: boolean;
         }) => void;
         setAllItemsVisibility: (args: {
@@ -81,15 +81,14 @@ export declare const useGlobalSelectionStore: import("zustand").UseBoundStore<Om
                     id: {
                         workOrderId: string;
                     } | {
-                        tagNo: string;
                         instCode: string;
+                        tagNo: string;
+                    } | {
                         internalTagType: import("..").PdmsInternalTagType;
                         plantNo: string;
                         plantCode: string;
-                    } | {
                         instCode: string;
                         tagNo: string;
-                        internalTagType?: never | undefined;
                     } | {
                         equipmentId: string;
                     } | {
@@ -118,7 +117,7 @@ export declare const useGlobalSelectionStore: import("zustand").UseBoundStore<Om
                     metaData: {
                         color: string;
                         isHiddenByUser: boolean;
-                        errorStatus?: string | undefined;
+                        errorStatus: string | undefined;
                         systemStatus: import("./globalSelectionStore.types").SelectionItemSystemStatus;
                     };
                 }>;
@@ -128,15 +127,14 @@ export declare const useGlobalSelectionStore: import("zustand").UseBoundStore<Om
                     id: {
                         workOrderId: string;
                     } | {
-                        tagNo: string;
                         instCode: string;
+                        tagNo: string;
+                    } | {
                         internalTagType: import("..").PdmsInternalTagType;
                         plantNo: string;
                         plantCode: string;
-                    } | {
                         instCode: string;
                         tagNo: string;
-                        internalTagType?: never | undefined;
                     } | {
                         equipmentId: string;
                     } | {
@@ -170,7 +168,7 @@ export declare const useGlobalSelectionStore: import("zustand").UseBoundStore<Om
                     metaData: {
                         color: string;
                         isHiddenByUser: boolean;
-                        errorStatus?: string | undefined;
+                        errorStatus: string | undefined;
                         systemStatus: import("./globalSelectionStore.types").SelectionItemSystemStatus;
                     };
                 }>;
@@ -180,15 +178,14 @@ export declare const useGlobalSelectionStore: import("zustand").UseBoundStore<Om
                     id: {
                         workOrderId: string;
                     } | {
-                        tagNo: string;
                         instCode: string;
+                        tagNo: string;
+                    } | {
                         internalTagType: import("..").PdmsInternalTagType;
                         plantNo: string;
                         plantCode: string;
-                    } | {
                         instCode: string;
                         tagNo: string;
-                        internalTagType?: never | undefined;
                     } | {
                         equipmentId: string;
                     } | {
@@ -215,7 +212,7 @@ export declare const useGlobalSelectionStore: import("zustand").UseBoundStore<Om
                     metaData: {
                         color: string;
                         isHiddenByUser: boolean;
-                        errorStatus?: string | undefined;
+                        errorStatus: string | undefined;
                         systemStatus: import("./globalSelectionStore.types").SelectionItemSystemStatus;
                     };
                 }>;
@@ -225,15 +222,14 @@ export declare const useGlobalSelectionStore: import("zustand").UseBoundStore<Om
                     id: {
                         workOrderId: string;
                     } | {
-                        tagNo: string;
                         instCode: string;
+                        tagNo: string;
+                    } | {
                         internalTagType: import("..").PdmsInternalTagType;
                         plantNo: string;
                         plantCode: string;
-                    } | {
                         instCode: string;
                         tagNo: string;
-                        internalTagType?: never | undefined;
                     } | {
                         equipmentId: string;
                     } | {
@@ -259,7 +255,7 @@ export declare const useGlobalSelectionStore: import("zustand").UseBoundStore<Om
                     metaData: {
                         color: string;
                         isHiddenByUser: boolean;
-                        errorStatus?: string | undefined;
+                        errorStatus: string | undefined;
                         systemStatus: import("./globalSelectionStore.types").SelectionItemSystemStatus;
                     };
                 }>;

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

@@ -0,0 +1,37 @@
+import { GlobalSelectionItemType, GlobalSelectionMetaData, GlobalSelectionTypes } 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
+ * TypeScript's readonly constraints while keeping the source types in sync.
+ */
+/**
+ * Strips readonly from all properties of T while preserving optionality (?).
+ * Used internally by store mutation helpers inside Immer set() callbacks.
+ */
+type Mutable<T> = {
+    -readonly [K in keyof T]: T[K];
+};
+/**
+ * Mutable version of a selection item for store-internal Immer mutations.
+ * Derived from the readonly source types — stays in sync automatically.
+ * Only used where TypeScript cannot resolve Draft<MappedType>[GenericT].
+ */
+type MutableSelectionItem<T extends GlobalSelectionItemType> = {
+    id: GlobalSelectionTypes.ItemId;
+    type: T;
+    data: GlobalSelectionTypes.ItemTypeToDataMap[T];
+    metaData: Mutable<GlobalSelectionMetaData>;
+};
+/**
+ * Mutable version of a selection list for store-internal Immer mutations.
+ * Only use inside Immer set() callbacks where state is a mutable draft.
+ */
+export type MutableSelectionList<T extends GlobalSelectionItemType> = {
+    items: Map<GlobalSelectionTypes.ItemIdString, MutableSelectionItem<T>>;
+};
+/**
+ * Casts a readonly selection list to its mutable counterpart.
+ * Only use inside Immer set() callbacks where state is a mutable draft.
+ */
+export declare function asMutableSelectionList<T extends GlobalSelectionItemType>(list: GlobalSelectionTypes.List<T>): MutableSelectionList<T>;
+export {};

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

@@ -1,6 +1,6 @@
 import type { EquipmentData, MeasuringPointData, ResultArray, TagSummaryDto, WorkOrderData } from '@equinor/echo-search';
 import { Brand } from '@equinor/echo-utils';
-import type { PdmsTagId } from '../pdmsTag/pdmsTag.types';
+import type { PdmsTagId, StidTagId } from '../pdmsTag/pdmsTag.types';
 export declare enum GlobalSelectionItemType {
     WorkOrder = "WorkOrder",
     Tag = "Tag",
@@ -24,30 +24,30 @@ export type SelectionItemTypeToItemIdMap = {
     [GlobalSelectionItemType.MeasuringPoint]: GlobalSelectionTypes.MeasuringPointId;
 };
 type GlobalSelectionList<T extends GlobalSelectionItemType> = {
-    items: Map<GlobalSelectionTypes.ItemIdString, GlobalSelectionTypes.GenericItem<T>>;
+    readonly items: Map<GlobalSelectionTypes.ItemIdString, GlobalSelectionGenericItem<T>>;
 };
 export type GlobalSelectionObject = {
-    [K in GlobalSelectionItemType]: GlobalSelectionList<K>;
+    readonly [K in GlobalSelectionItemType]: GlobalSelectionList<K>;
 };
 export interface GlobalSelectionStoreData {
-    lists: GlobalSelectionObject;
+    readonly lists: GlobalSelectionObject;
 }
 export type SelectionItemSystemStatus = 'isLoading' | 'notFound' | 'loadedSuccessfully' | 'error';
 export interface GlobalSelectionMetaData {
-    color: string;
-    isHiddenByUser: boolean;
-    errorStatus?: string;
-    systemStatus: SelectionItemSystemStatus;
+    readonly color: string;
+    readonly isHiddenByUser: boolean;
+    readonly errorStatus: string | undefined;
+    readonly systemStatus: SelectionItemSystemStatus;
 }
 export interface GlobalSelectionItemIdMetadata {
-    itemId: GlobalSelectionTypes.ItemId;
-    metaData: Partial<PersistedGlobalSelectionMetaData>;
+    readonly itemId: GlobalSelectionTypes.ItemId;
+    readonly metaData: Partial<PersistedGlobalSelectionMetaData>;
 }
 export type GlobalSelectionGenericItem<T extends GlobalSelectionItemType> = {
-    id: GlobalSelectionTypes.ItemId;
-    type: T;
-    data: GlobalSelectionTypes.ItemTypeToDataMap[T];
-    metaData: GlobalSelectionMetaData;
+    readonly id: GlobalSelectionTypes.ItemId;
+    readonly type: T;
+    readonly data: GlobalSelectionTypes.ItemTypeToDataMap[T];
+    readonly metaData: GlobalSelectionMetaData;
 };
 type EquipmentGlobalSelectionList = GlobalSelectionTypes.List<GlobalSelectionItemType.Equipment>;
 type WorkOrderGlobalSelectionList = GlobalSelectionTypes.List<GlobalSelectionItemType.WorkOrder>;
@@ -55,8 +55,8 @@ type TagGlobalSelectionList = GlobalSelectionTypes.List<GlobalSelectionItemType.
 type MeasuringPointGlobalSelectionList = GlobalSelectionTypes.List<GlobalSelectionItemType.MeasuringPoint>;
 type GlobalSelectionListUnion = WorkOrderGlobalSelectionList | TagGlobalSelectionList | EquipmentGlobalSelectionList;
 interface ItemErrorStatusUpdates {
-    itemId: GlobalSelectionTypes.ItemId;
-    errorStatus: string;
+    readonly itemId: GlobalSelectionTypes.ItemId;
+    readonly errorStatus: string;
 }
 export interface GlobalSelectionStore extends GlobalSelectionStoreData {
     addWorkOrdersToSelection: (args: {
@@ -102,51 +102,46 @@ export interface GlobalSelectionStore extends GlobalSelectionStoreData {
 }
 type GlobalSelectionActionResult = 'NoChanges' | 'ItemsAdded';
 export type GlobalSelectionAddItemResult<DataType> = {
-    fetchResult: DataType;
-    actionResult: GlobalSelectionActionResult;
+    readonly fetchResult: DataType;
+    readonly actionResult: GlobalSelectionActionResult;
 };
 export type PersistedGlobalSelectionMetaData = Pick<GlobalSelectionMetaData, 'color' | 'isHiddenByUser'>;
 export declare namespace GlobalSelectionTypes {
-    export type WorkOrderId = Pick<GlobalSelectionWorkOrderDto, 'workOrderId'>;
-    export type EquipmentId = Pick<GlobalSelectionEquipmentDto, 'equipmentId'>;
+    type WorkOrderId = Pick<GlobalSelectionWorkOrderDto, 'workOrderId'>;
+    type EquipmentId = Pick<GlobalSelectionEquipmentDto, 'equipmentId'>;
     /**
      * TagId is the identifier for tags in the global selection.
      * - For STID tags: { tagNo, instCode }
      * - For internal tags (PDMS): { tagNo, instCode, internalTagType, plantNo, plantCode }
      */
-    type BaseTagId = Pick<GlobalSelectionTagDto, 'tagNo' | 'instCode'>;
-    type StidTagId = BaseTagId & {
-        readonly internalTagType?: never;
-    };
-    export type TagId = StidTagId | PdmsTagId;
-    export type MeasuringPointId = Pick<GlobalSelectionMeasuringPointDto, 'measuringPointId'>;
-    export type ItemId = WorkOrderId | EquipmentId | TagId | MeasuringPointId;
-    export type ItemIdString = Brand<string, 'ItemIdString'>;
-    export type TagDto = GlobalSelectionTagDto;
-    export type WorkOrderDto = GlobalSelectionWorkOrderDto;
-    export type EquipmentDto = GlobalSelectionEquipmentDto;
-    export type MeasuringPointDto = GlobalSelectionMeasuringPointDto;
-    export type EquipmentItem = GlobalSelectionGenericItem<GlobalSelectionItemType.Equipment>;
-    export type WorkOrderItem = GlobalSelectionGenericItem<GlobalSelectionItemType.WorkOrder>;
-    export type TagItem = GlobalSelectionGenericItem<GlobalSelectionItemType.Tag>;
-    export type MeasuringPointItem = GlobalSelectionGenericItem<GlobalSelectionItemType.MeasuringPoint>;
-    export type List<T extends GlobalSelectionItemType> = GlobalSelectionList<T>;
-    export type SelectionItem = EquipmentItem | WorkOrderItem | TagItem | MeasuringPointItem;
-    export type SelectionItemList = EquipmentItem[] | WorkOrderItem[] | TagItem[] | MeasuringPointItem[];
-    export type GenericItem<T extends GlobalSelectionItemType> = GlobalSelectionGenericItem<T>;
-    export type Store = GlobalSelectionStore;
-    export type ItemErrorStatusUpdate = ItemErrorStatusUpdates;
-    export type WorkOrderList = WorkOrderGlobalSelectionList;
-    export type TagList = TagGlobalSelectionList;
-    export type EquipmentList = EquipmentGlobalSelectionList;
-    export type MeasuringPointList = MeasuringPointGlobalSelectionList;
-    export type ListUnion = GlobalSelectionListUnion;
-    export type ItemTypeToDataMap = GlobalSelectionItemTypeToDataMap;
-    export type AddTagResult = GlobalSelectionAddItemResult<ResultArray<TagSummaryDto>[]>;
-    export type AddEquipmentsResult = GlobalSelectionAddItemResult<ResultArray<EquipmentData>[]>;
-    export type AddMeasuringPointResult = GlobalSelectionAddItemResult<ResultArray<MeasuringPointData>[]>;
-    export type ActionResult = GlobalSelectionActionResult;
-    export type ItemSystemStatus = SelectionItemSystemStatus;
-    export {};
+    type TagId = StidTagId | PdmsTagId;
+    type MeasuringPointId = Pick<GlobalSelectionMeasuringPointDto, 'measuringPointId'>;
+    type ItemId = WorkOrderId | EquipmentId | TagId | MeasuringPointId;
+    type ItemIdString = Brand<string, 'ItemIdString'>;
+    type TagDto = GlobalSelectionTagDto;
+    type WorkOrderDto = GlobalSelectionWorkOrderDto;
+    type EquipmentDto = GlobalSelectionEquipmentDto;
+    type MeasuringPointDto = GlobalSelectionMeasuringPointDto;
+    type EquipmentItem = GlobalSelectionGenericItem<GlobalSelectionItemType.Equipment>;
+    type WorkOrderItem = GlobalSelectionGenericItem<GlobalSelectionItemType.WorkOrder>;
+    type TagItem = GlobalSelectionGenericItem<GlobalSelectionItemType.Tag>;
+    type MeasuringPointItem = GlobalSelectionGenericItem<GlobalSelectionItemType.MeasuringPoint>;
+    type List<T extends GlobalSelectionItemType> = GlobalSelectionList<T>;
+    type SelectionItem = EquipmentItem | WorkOrderItem | TagItem | MeasuringPointItem;
+    type SelectionItemList = EquipmentItem[] | WorkOrderItem[] | TagItem[] | MeasuringPointItem[];
+    type GenericItem<T extends GlobalSelectionItemType> = GlobalSelectionGenericItem<T>;
+    type Store = GlobalSelectionStore;
+    type ItemErrorStatusUpdate = ItemErrorStatusUpdates;
+    type WorkOrderList = WorkOrderGlobalSelectionList;
+    type TagList = TagGlobalSelectionList;
+    type EquipmentList = EquipmentGlobalSelectionList;
+    type MeasuringPointList = MeasuringPointGlobalSelectionList;
+    type ListUnion = GlobalSelectionListUnion;
+    type ItemTypeToDataMap = GlobalSelectionItemTypeToDataMap;
+    type AddTagResult = GlobalSelectionAddItemResult<ResultArray<TagSummaryDto>[]>;
+    type AddEquipmentsResult = GlobalSelectionAddItemResult<ResultArray<EquipmentData>[]>;
+    type AddMeasuringPointResult = GlobalSelectionAddItemResult<ResultArray<MeasuringPointData>[]>;
+    type ActionResult = GlobalSelectionActionResult;
+    type ItemSystemStatus = SelectionItemSystemStatus;
 }
 export {};

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

@@ -1,10 +1,7 @@
 import { ResultArray } from '@equinor/echo-search';
 import { GlobalSelectionItemType, GlobalSelectionItemTypeToDataMap, GlobalSelectionTypes, SelectionItemTypeToItemIdMap } from './globalSelectionStore.types';
+import { isEquipmentId, isMeasuringPointId, isTagId, isWorkOrderId } from './itemIdTypeGuards';
 declare function idsEqual(itemA: GlobalSelectionTypes.ItemId, itemB: GlobalSelectionTypes.ItemId): boolean;
-declare function isWorkOrderId(itemId: GlobalSelectionTypes.ItemId): itemId is GlobalSelectionTypes.WorkOrderId;
-declare function isEquipmentId(itemId: GlobalSelectionTypes.ItemId): itemId is GlobalSelectionTypes.EquipmentId;
-declare function isTagId(itemId: GlobalSelectionTypes.ItemId): itemId is GlobalSelectionTypes.TagId;
-declare function isMeasuringPointId(itemId: GlobalSelectionTypes.ItemId): itemId is GlobalSelectionTypes.MeasuringPointId;
 /**
  * Overloaded function that maps an item to its corresponding ID type based on the item's properties.
  * The return type is specific to the type of item passed to the function.
@@ -33,6 +30,15 @@ declare function mapToId(item: GlobalSelectionTypes.EquipmentId): GlobalSelectio
 declare function mapToId(item: GlobalSelectionTypes.TagId): GlobalSelectionTypes.TagId;
 declare function mapToId(item: GlobalSelectionTypes.MeasuringPointId): GlobalSelectionTypes.MeasuringPointId;
 declare function mapToId(item: GlobalSelectionTypes.ItemId): GlobalSelectionTypes.ItemId;
+/**
+ * Converts an item ID to a string representation for use as Map keys.
+ * This is a ONE-WAY conversion - the string cannot be converted back to the original ID.
+ *
+ * For tags: Always returns `tagNo-instCode` regardless of whether it's a STID or PDMS tag.
+ * This ensures both tag types use the same key format for O(1) Map lookups.
+ *
+ * To preserve full ID properties (e.g., PDMS properties for API saving), use `mapToId` instead.
+ */
 declare function itemIdToString(itemId: GlobalSelectionTypes.ItemId): GlobalSelectionTypes.ItemIdString;
 export declare function mapIdToItemType(itemId: GlobalSelectionTypes.ItemId): GlobalSelectionItemType;
 /**
@@ -43,8 +49,8 @@ export declare function mapIdToItemType(itemId: GlobalSelectionTypes.ItemId): Gl
  * @property {Function} isEquipmentId - Checks if the passed object is a global selection EquipmentID.
  * @property {Function} isTagId - Checks if the passed object is a global selection TagID.
  * @property {Function} idsEqual - Compares two global selection item IDs for equality.
- * @property {Function} mapToId - Maps an object to its global selection item ID.
- * @property {Function} itemIdToString - Converts a global selection item id object to a string, each value is concatenated by a '-'
+ * @property {Function} mapToId - Maps an object to its global selection item ID, preserving all properties (including PDMS).
+ * @property {Function} itemIdToString - ONE-WAY conversion to string for Map keys. Cannot be reversed. For tags, uses only tagNo-instCode.
  */
 export declare const globalSelectionUtils: Readonly<{
     isMeasuringPointId: typeof isMeasuringPointId;

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

@@ -0,0 +1,7 @@
+import type { PdmsTagId } from '../pdmsTag/pdmsTag.types';
+import type { GlobalSelectionTypes } from './globalSelectionStore.types';
+export declare function isWorkOrderId(itemId: GlobalSelectionTypes.ItemId): itemId is GlobalSelectionTypes.WorkOrderId;
+export declare function isEquipmentId(itemId: GlobalSelectionTypes.ItemId): itemId is GlobalSelectionTypes.EquipmentId;
+export declare function isTagId(itemId: GlobalSelectionTypes.ItemId): itemId is GlobalSelectionTypes.TagId;
+export declare function isMeasuringPointId(itemId: GlobalSelectionTypes.ItemId): itemId is GlobalSelectionTypes.MeasuringPointId;
+export declare function isPdmsTagId(itemId: GlobalSelectionTypes.ItemId): itemId is PdmsTagId;

package/src/lib/feature/globalSelection/hooks/useGlobalSelectionLists.d.ts

@@ -2,5 +2,5 @@
  * Hook for returning all lists stored in the global selection.
  */
 export declare function useGlobalSelectionLists(): {
-    items: (import("..").GlobalSelectionTypes.GenericItem<import("..").GlobalSelectionItemType.WorkOrder> | import("..").GlobalSelectionTypes.GenericItem<import("..").GlobalSelectionItemType.Tag> | import("..").GlobalSelectionTypes.GenericItem<import("..").GlobalSelectionItemType.Equipment> | import("..").GlobalSelectionTypes.GenericItem<import("..").GlobalSelectionItemType.MeasuringPoint>)[];
+    items: (import("..").GlobalSelectionGenericItem<import("..").GlobalSelectionItemType.WorkOrder> | import("..").GlobalSelectionGenericItem<import("..").GlobalSelectionItemType.Tag> | import("..").GlobalSelectionGenericItem<import("..").GlobalSelectionItemType.Equipment> | import("..").GlobalSelectionGenericItem<import("..").GlobalSelectionItemType.MeasuringPoint>)[];
 }[];

package/src/lib/feature/globalSelection/hooks/useItemGroupMembership.d.ts

@@ -0,0 +1,13 @@
+import { Guid } from '@equinor/echo-utils';
+import { GlobalSelectionTypes } from '../globalSelectionStore/globalSelectionStore.types';
+/**
+ * Hook to get the group IDs that an item belongs to in the selection tree.
+ *
+ * @param {GlobalSelectionTypes.ItemId} itemId - The item ID to check
+ * @returns {Set<Guid>} - A set of group IDs that contain the item
+ *
+ * @example
+ * const groupIds = useItemGroupMembership(itemId);
+ * const isInGroup = groupIds.has(someGroupId);
+ */
+export declare function useItemGroupMembership(itemId: GlobalSelectionTypes.ItemId): Set<Guid>;

package/src/lib/feature/globalSelection/hooks/useSelectionAction.d.ts

@@ -0,0 +1,21 @@
+import { Guid } from '@equinor/echo-utils';
+import type { SelectionFeedbackType } from '../components/SelectionActionBar/selectionFeedback.types';
+import { GlobalSelectionTypes } from '../globalSelectionStore/globalSelectionStore.types';
+/**
+ *
+ * Hook to manage selection actions for global selection.
+ *
+ * When showPopoverUpdateDelay is true, isLoading and feedbackType are stored in legendUIStore
+ * so they survive component remounts during the stale-marker holding period.
+ * When false, they live in local React state.
+ *
+ * @param showPopoverUpdateDelay Whether to delay the popover update to avoid flickering. Temporary hack to be resolved in #397869
+ * @returns Object containing loading state, feedback type, and functions to add/remove items from selection.
+ */
+export declare function useSelectionAction(showPopoverUpdateDelay?: boolean): {
+    isLoading: boolean;
+    feedbackType: SelectionFeedbackType | null;
+    addToSelection: (groupId: Guid, itemId: GlobalSelectionTypes.ItemId) => Promise<void>;
+    removeFromSelection: (groupId: Guid, itemId: GlobalSelectionTypes.ItemId) => void;
+    changeColor: (itemId: GlobalSelectionTypes.ItemId, color: string) => void;
+};

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

@@ -1,7 +1,8 @@
 export * from './globalSelectionStore/globalSelectionStore.types';
-export * from './pdmsTag/pdmsTag.types';
 export * from './selectionMenu/selectionTreeStore/selectionTree.api.types';
 export * from './selectionMenu/selectionTreeStore/selectionTree.store.types';
+export { isPdmsInternalTagType, PDMS_INTERNAL_TAG_TYPES } from './pdmsTag/pdmsTag.types';
+export type { PdmsInternalTagType, PdmsTagId, PdmsTagSummaryDto, StidTagId } from './pdmsTag/pdmsTag.types';
 export { useAreAllItemsVisible } from './hooks/useAreAllItemsVisible';
 export { useGlobalSelectionByItemId } from './hooks/useGlobalSelectionByItemId';
 export { useGlobalSelectionItems } from './hooks/useGlobalSelectionItems';
@@ -11,6 +12,7 @@ export { useGlobalSelectionLists } from './hooks/useGlobalSelectionLists';
 export { useGlobalSelectionTags } from './hooks/useGlobalSelectionTags';
 export { useGlobalSelectionWorkOrders } from './hooks/useGlobalSelectionWorkOrders';
 export { useIsInGlobalSelection } from './hooks/useIsInGlobalSelection';
+export { useItemGroupMembership } from './hooks/useItemGroupMembership';
 export { useSelectionCategoriesByGroupId } from './hooks/useSelectionCategoriesByGroupId';
 export { useCurrentSelectionId } from './selectionMenu/hooks/useCurrentSelectionId';
 export { useFetchSelectionHistory } from './selectionMenu/hooks/useFetchSelectionHistory';
@@ -27,4 +29,6 @@ export { invalidateHistorySelectionQuery } from './selectionMenu/invalidateHisto
 export { saveEquipmentAsNewSelectionToApi } from './selectionMenu/selectionTreeStore/api/selectionTree.equipment';
 export { SelectionColorConflictDialog } from './selectionMenu/selectionTreeStore/colorConflictHandling/SelectionColorConflictDialog';
 export { simulatedSelectionTreeApiError } from './selectionMenu/selectionTreeStore/persist/devOnlySimulateOffline';
-export { createPdmsTagSummaryDto, isPdmsTagId, isPdmsTagSummaryDto } from './pdmsTag/pdmsTag.utils';
+export { isPdmsTagId } from './globalSelectionStore/itemIdTypeGuards';
+export { isPdmsTagInSelection } from './pdmsTag/pdmsTag.logic';
+export { createPdmsTagSummaryDto, isPdmsTagSummaryDto } from './pdmsTag/pdmsTag.utils';

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

@@ -0,0 +1 @@
+export declare function isPdmsTagInSelection(tagNo: string, instCode: string): boolean;

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

@@ -2,11 +2,20 @@ import type { TagSummaryDto } from '@equinor/echo-search';
 export declare const PDMS_INTERNAL_TAG_TYPES: readonly ["PdmsTag", "PdmsPart"];
 export type PdmsInternalTagType = (typeof PDMS_INTERNAL_TAG_TYPES)[number];
 export declare const isPdmsInternalTagType: (value: string) => value is PdmsInternalTagType;
-export interface PdmsTagId {
-    readonly tagNo: string;
-    readonly instCode: string;
+/**
+ * StidTagId contains only tagNo and instCode.
+ */
+export type StidTagId = Pick<TagSummaryDto, 'tagNo' | 'instCode'>;
+/**
+ * Identifies a PDMS tag. Extends the standard STID tag ID (tagNo + instCode) with additional PDMS-specific properties.
+ * @remarks STID tags only have `tagNo` and `instCode`. PDMS tags add `internalTagType`, `plantNo`, and `plantCode`.
+ */
+export interface PdmsTagId extends StidTagId {
+    /** @remarks Discriminator between PDMS tag types: 'PdmsTag' for tags not in STID, 'PdmsPart' for parts without a tag. */
     readonly internalTagType: PdmsInternalTagType;
+    /** @remarks Also known as sapId. */
     readonly plantNo: string;
+    /** @remarks Usually same as instCode, but for some plants it replaces last instCode character with A, B, C, etc. */
     readonly plantCode: string;
 }
 export interface PdmsTagSummaryDto extends TagSummaryDto, PdmsTagId {

package/src/lib/feature/globalSelection/pdmsTag/pdmsTag.utils.d.ts

@@ -1,6 +1,4 @@
 import { type TagSummaryDto } from '@equinor/echo-search';
-import type { GlobalSelectionTypes } from '../globalSelectionStore/globalSelectionStore.types';
 import type { PdmsTagId, PdmsTagSummaryDto } from './pdmsTag.types';
-export declare function isPdmsTagId(itemId: GlobalSelectionTypes.ItemId): itemId is PdmsTagId;
 export declare function isPdmsTagSummaryDto(dto: TagSummaryDto): dto is PdmsTagSummaryDto;
 export declare function createPdmsTagSummaryDto(pdmsTagId: PdmsTagId): PdmsTagSummaryDto;

package/src/lib/feature/globalSelection/selectionMenu/selectionTreeStore/selectionTree.store.d.ts

@@ -89,15 +89,14 @@ export declare const useSelectionTreeStore: import("zustand").UseBoundStore<Omit
                     id: {
                         workOrderId: string;
                     } | {
-                        tagNo: string;
                         instCode: string;
+                        tagNo: string;
+                    } | {
                         internalTagType: import("../..").PdmsInternalTagType;
                         plantNo: string;
                         plantCode: string;
-                    } | {
                         instCode: string;
                         tagNo: string;
-                        internalTagType?: never | undefined;
                     } | {
                         equipmentId: string;
                     } | {

package/src/lib/feature/globalSelection/selectionMenu/selectionTreeStore/selectionTree.store.utils.d.ts

@@ -104,7 +104,7 @@ export declare function isSelectionEmpty(groups: SelectionTreeTypes.Group[]): bo
  * @returns {void}
  */
 export declare function removeStaleItemsFromGlobalSelection(groups: SelectionTreeTypes.Group[], itemIds: GlobalSelectionTypes.ItemId[]): void;
-export declare function getItemsByIdsFromGlobalSelectionStore(itemIds: GlobalSelectionTypes.ItemId[]): GlobalSelectionTypes.GenericItem<GlobalSelectionItemType>[];
+export declare function getItemsByIdsFromGlobalSelectionStore(itemIds: GlobalSelectionTypes.ItemId[]): GlobalSelectionTypes.SelectionItem[];
 /**
  * Returns an array of selection colors sorted by their frequency for the specified item IDs within a group.
  *

package/src/lib/feature/legend/components/LegendFeedbackMessage.d.ts

@@ -1,4 +1,4 @@
-export type LegendFeedbackVariant = 'error' | 'info' | 'warning';
+import type { LegendFeedbackVariant } from '../stores/legendUIStore/legendUIStore.types';
 interface LegendFeedbackMessageProps {
     className?: string;
     variant?: LegendFeedbackVariant;