@equinor/echo-framework 5.0.0-beta-r19 → 5.0.0-beta-r19-1

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@equinor/echo-framework",
-  "version": "5.0.0-beta-r19",
+  "version": "5.0.0-beta-r19-1",
   "peerDependencies": {
-    "@equinor/echo-base": "5.0.0-beta-r19",
-    "@equinor/echo-components": "5.0.0-beta-r19",
-    "@equinor/echo-core": "5.0.0-beta-r19",
-    "@equinor/echo-search": "5.0.0-beta-r19",
-    "@equinor/echo-utils": "5.0.0-beta-r19",
+    "@equinor/echo-base": "5.0.0-beta-r19-1",
+    "@equinor/echo-components": "5.0.0-beta-r19-1",
+    "@equinor/echo-core": "5.0.0-beta-r19-1",
+    "@equinor/echo-search": "5.0.0-beta-r19-1",
+    "@equinor/echo-utils": "5.0.0-beta-r19-1",
     "@equinor/eds-core-react": "0.49.0",
     "@equinor/eds-icons": "0.22.0",
     "@equinor/eds-tokens": "2.1.0",
@@ -19,11 +19,11 @@
     "react-router-dom": ">= 6.30.3 < 7",
     "zustand": ">= 4.4.7 < 5",
     "immer": ">= 11.1.4 < 12.0.0",
-    "msw": "2.12.10",
+    "msw": ">= 2.0.0 < 3",
     "date-fns": "4.1.0"
   },
   "dependencies": {
-    "dexie": "4.3.0",
+    "dexie": "4.4.2",
     "mark.js": "8.11.1",
     "ag-charts-community": "12.3.1",
     "ag-charts-react": "12.3.1",

package/src/index.d.ts

@@ -19,9 +19,9 @@ export { ReturnToExternalAppButton } from './lib/feature/echoView/ReturnToExtern
 export { fetchEquipmentFromApi } from './lib/feature/equipment/api/api-equipmentWithMeasuringPoints';
 export * from './lib/feature/equipment/index';
 export * from './lib/feature/globalSelection';
-export { SelectionActionBar } from './lib/feature/globalSelection/components/SelectionActionBar';
+export { ItemDetailsSelectionActionBar, SelectionActionBar } from './lib/feature/globalSelection/components/selectionActionBar/SelectionActionBar';
 export { PanTo3DButton } from './lib/feature/globalSelection/panToEcho3d/panTo3DButton';
-export { useIsAllIGlobalSelectionItemsHidden } from './lib/feature/globalSelection/selectionMenu/hooks/useIsAllIGlobalSelectionItemsHidden';
+export { useIsAllGlobalSelectionItemsHidden } from './lib/feature/globalSelection/selectionMenu/hooks/useIsAllGlobalSelectionItemsHidden';
 export { useSelectionColorFrequencyByIds } from './lib/feature/globalSelection/selectionMenu/hooks/useSelectionColorFrequency';
 export { useSelectionTreeAutoSave } from './lib/feature/globalSelection/selectionMenu/selectionTreeStore/persist/useSelectionTreeAutoSave';
 export { GlobalSelectionCategoryId } from './lib/feature/globalSelection/selectionMenu/selectionTreeStore/selectionTree.store.types';
@@ -137,8 +137,8 @@ declare const EchoFramework: Readonly<{
         usePlantAvailableIn3dWeb(plantCode?: string): boolean;
         useScreenOrientation(): import("./lib/types/hookLibrary").ScreenOrientation;
         useScreenValues(): {
-            isScreenMobileSize: boolean;
-            screenOrientation: import("./lib/types/hookLibrary").ScreenOrientation;
+            readonly isScreenMobileSize: boolean;
+            readonly screenOrientation: import("./lib/types/hookLibrary").ScreenOrientation;
         };
         useSelectionGroupLabelsPerItem: () => Map<string, string[]>;
         useTabTitle(): void;

package/src/lib/components/prepview/panels/objects/objects.logic.d.ts

@@ -0,0 +1,7 @@
+import type { GlobalSelectionTypes } from '../../../../feature/globalSelection/globalSelectionStore/globalSelectionStore.types';
+import type { PrepviewObject } from '../../types/workorder';
+export declare function fetchWorkOrderObjectsWithSelectionIds(workOrderId: string): Promise<{
+    workOrderObjects: PrepviewObject[];
+    tagIds: GlobalSelectionTypes.TagId[];
+    equipmentIds: GlobalSelectionTypes.EquipmentId[];
+}>;

package/src/lib/components/prepview/panels/objects/objects.utils.d.ts

@@ -0,0 +1,14 @@
+import { GlobalSelectionTypes } from '../../../../feature/globalSelection/globalSelectionStore/globalSelectionStore.types';
+import type { PrepviewObject } from '../../types/workorder';
+/**
+ * Extracts tag IDs from the given work order objects.
+ * @param workOrderObjects The work order objects to extract tag IDs from.
+ * @returns A promise that resolves to an array of tag IDs.
+ */
+export declare function extractTagIdsFromWorkOrderObjects(workOrderObjects: ReadonlyArray<PrepviewObject>): Promise<GlobalSelectionTypes.TagId[]>;
+/**
+ * Extracts equipment IDs from the given work order objects.
+ * @param workOrderObjects The work order objects to extract equipment IDs from.
+ * @returns An array of equipment IDs.
+ */
+export declare function extractEquipmentIdsFromWorkOrderObjects(workOrderObjects: ReadonlyArray<PrepviewObject>): GlobalSelectionTypes.EquipmentId[];

package/src/lib/components/prepview/panels/objects/selectionActionBarMultiple/AddSelectionListWithSameNameDialog.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+interface AddSelectionListWithSameNameDialogProps {
+    readonly isOpen: boolean;
+    readonly onClose: () => void;
+    readonly onAddNewList: () => void | Promise<void>;
+}
+export declare const AddSelectionListWithSameNameDialog: React.FC<AddSelectionListWithSameNameDialogProps>;
+export {};

package/src/lib/components/prepview/panels/objects/selectionActionBarMultiple/SelectionActionBarMultiple.d.ts

@@ -0,0 +1,9 @@
+import { GlobalSelectionTypes } from '../../../../../feature/globalSelection/globalSelectionStore/globalSelectionStore.types';
+export interface SelectionActionBarMultipleProps {
+    readonly selectionItemIds: ReadonlyArray<GlobalSelectionTypes.ItemId>;
+    readonly hiddenSelectionItemIds?: ReadonlyArray<GlobalSelectionTypes.ItemId>;
+    readonly labelSelectionGroup: string;
+    readonly subLabelSelectionGroup?: string;
+    readonly className?: string;
+}
+export declare const SelectionActionBarMultiple: React.FC<SelectionActionBarMultipleProps>;

package/src/lib/components/prepview/panels/objects/selectionActionBarMultiple/logic/selectionActionBarMultiple.colors.d.ts

@@ -0,0 +1,2 @@
+import { GlobalSelectionItemType } from '../../../../../../feature/globalSelection/globalSelectionStore/globalSelectionStore.types';
+export declare function getUniqueSelectionItemTypes(itemTypes: ReadonlyArray<GlobalSelectionItemType>): ReadonlyArray<GlobalSelectionItemType>;

package/src/lib/components/prepview/panels/objects/selectionActionBarMultiple/logic/selectionActionBarMultiple.constants.d.ts

@@ -0,0 +1 @@
+export declare const OBJECT_LIST_FOR_WORK_ORDER_LABEL_PREFIX = "Object list for WO ";

package/src/lib/components/prepview/panels/objects/selectionActionBarMultiple/logic/selectionActionBarMultiple.logic.d.ts

@@ -0,0 +1,4 @@
+import { Guid } from '@equinor/echo-utils';
+import { GlobalSelectionTypes } from '../../../../../../feature/globalSelection/globalSelectionStore/globalSelectionStore.types';
+export declare function findWorkOrderColorInSelection(hiddenSelectionItemIds: ReadonlyArray<GlobalSelectionTypes.ItemId>): string | undefined;
+export declare function overrideGroupItemColors(groupId: Guid, color: string): void;

package/src/lib/components/prepview/panels/objects/selectionActionBarMultiple/logic/selectionActionBarMultiple.orchestration.d.ts

@@ -0,0 +1,10 @@
+import { Guid } from '@equinor/echo-utils';
+import { type GlobalSelectionTypes } from '../../../../../../feature/globalSelection/globalSelectionStore/globalSelectionStore.types';
+import { SelectionTreeTypes } from '../../../../../../feature/globalSelection/selectionMenu/selectionTreeStore/selectionTree.store.types';
+export declare function addSelectionItemsToNewSelectionGroup(args: {
+    readonly selectionItemIds: ReadonlyArray<GlobalSelectionTypes.ItemId>;
+    readonly hiddenSelectionItemIds: ReadonlyArray<GlobalSelectionTypes.ItemId>;
+    readonly label: string;
+    readonly subLabel: string;
+    readonly selectionGroups: ReadonlyArray<SelectionTreeTypes.Group>;
+}): Promise<Guid>;

package/src/lib/components/prepview/panels/objects/selectionActionBarMultiple/logic/selectionActionBarMultiple.utils.d.ts

@@ -0,0 +1,3 @@
+import { SelectionTreeTypes } from '../../../../../../feature/globalSelection/selectionMenu/selectionTreeStore/selectionTree.store.types';
+export declare function doesSelectionGroupLabelExist(label: string, groups: ReadonlyArray<SelectionTreeTypes.Group>): boolean;
+export declare function getNextAvailableGroupLabel(label: string, groups: ReadonlyArray<SelectionTreeTypes.Group>): string;

package/src/lib/components/prepview/panels/tagDocumentRefs/HorizontalDocumentGroups.d.ts

@@ -3,5 +3,5 @@ interface HorizontalDocumentGroupsProps {
     documentGroups: Array<PrepviewDocumentGroup>;
     tagNo: string;
 }
-declare function HorizontalDocumentGroups({ documentGroups, tagNo, }: HorizontalDocumentGroupsProps): import("react/jsx-runtime").JSX.Element;
+declare function HorizontalDocumentGroups({ documentGroups, tagNo }: HorizontalDocumentGroupsProps): import("react/jsx-runtime").JSX.Element;
 export { HorizontalDocumentGroups };

package/src/lib/feature/equipment/components/fullEquipmentItem/fullEquipmentItem.d.ts

@@ -1,7 +1,7 @@
 interface FullEquipmentItemProps {
-    equipmentId: string;
-    tagNo: string | undefined;
-    plantNo: string | undefined;
+    readonly equipmentId: string;
+    readonly tagNo: string | undefined;
+    readonly plantNo: string | undefined;
 }
 export declare const FullEquipmentItem: React.FC<FullEquipmentItemProps>;
 export {};

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

@@ -0,0 +1,14 @@
+import type { MarkerId } from '../../../shared/markerId.types';
+import { GlobalSelectionTypes } from '../../globalSelectionStore/globalSelectionStore.types';
+export interface SelectionActionBarProps {
+    readonly itemId: GlobalSelectionTypes.ItemId;
+    readonly className?: string;
+    /** MarkerId of the marker that owns this action bar. Scopes feedback to this popover only. */
+    readonly markerId?: MarkerId;
+}
+export declare const SelectionActionBar: React.FC<SelectionActionBarProps>;
+/**
+ * Simple wrapper to apply custom styles to the SelectionActionBar when used in the ItemDetails pages,
+ * without affecting the SelectionActionBar used elsewhere.
+ */
+export declare const ItemDetailsSelectionActionBar: (props: SelectionActionBarProps) => import("react/jsx-runtime").JSX.Element;

package/src/lib/feature/globalSelection/components/selectionActionBar/SelectionActionBarMenuItem.d.ts

@@ -0,0 +1,12 @@
+import { Guid } from '@equinor/echo-utils';
+import { GlobalSelectionTypes } from '../../globalSelectionStore/globalSelectionStore.types';
+import { type SelectionGroup } from '../../selectionMenu/selectionTreeStore/selectionTree.store.types';
+interface SelectionActionBarMenuItemProps {
+    readonly isInGroup: boolean;
+    readonly group: SelectionGroup;
+    readonly addToSelection: (groupId: Guid, itemId: GlobalSelectionTypes.ItemId) => void;
+    readonly removeFromSelection: (groupId: Guid, itemId: GlobalSelectionTypes.ItemId) => void;
+    readonly itemId: GlobalSelectionTypes.ItemId;
+}
+export declare const SelectionActionBarMenuItem: (props: SelectionActionBarMenuItemProps) => import("react/jsx-runtime").JSX.Element;
+export {};

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

@@ -0,0 +1,28 @@
+import { Guid } from '@equinor/echo-utils';
+import type { MarkerId } from '../../../../shared/markerId.types';
+import { GlobalSelectionTypes } from '../../../globalSelectionStore/globalSelectionStore.types';
+/**
+ * Hook to manage selection actions for global selection.
+ *
+ * Feedback state (isFeedbackActive, feedbackType, actionMarkerId) is stored in a dedicated
+ * micro Zustand store so it survives component remounts during the stale-marker holding period
+ * (e.g. when a remove action causes the colored marker variant to disappear and
+ * useStalePopoverMarkers briefly unmounts/remounts the popover tree).
+ *
+ * While isFeedbackActive is true, useMarkerPopover delays popover content refresh and
+ * useStalePopoverMarkers keeps the old marker rendered so the feedback stays visible —
+ * but only for the marker identified by actionPopoverId, not globally.
+ *
+ * @param markerId - Optional ID of the popover that owns this action bar. When provided,
+ *   feedback state is scoped to this popover: only the matching popover sees feedback,
+ *   and other popovers remain unaffected. Pass `undefined` for non-popover contexts
+ *   (e.g. ItemDetails pages).
+ * @returns Object containing loading state, feedback type, and functions to add/remove items from selection.
+ */
+export declare function useSelectionAction(markerId?: MarkerId): {
+    isFeedbackActive: boolean;
+    feedbackType: import("@equinor/echo-components").SelectionBarFeedbackType | undefined;
+    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/globalSelection.api.d.ts

@@ -29,7 +29,7 @@ export declare const globalSelectionApi: Readonly<{
         itemsById: (args: {
             groupId?: import("@equinor/echo-utils").Guid;
             categoryId: GlobalSelectionCategoryId;
-            itemIds: GlobalSelectionTypes.ItemId[];
+            itemIds: ReadonlyArray<GlobalSelectionTypes.ItemId>;
         }) => void;
         /**
          * Removes all items by their IDs, from all groups, from the state.
@@ -109,8 +109,9 @@ export declare const globalSelectionApi: Readonly<{
          *
          */
         addItems: (args: {
-            itemIds: GlobalSelectionTypes.ItemId[];
+            itemIds: ReadonlyArray<GlobalSelectionTypes.ItemId>;
             groupId?: import("@equinor/echo-utils").Guid;
+            useDefaultSelectionTypeColors?: boolean;
         }) => Promise<void>;
     }>;
     search: {

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

@@ -1,3 +1,4 @@
+import { SelectionColor } from './globalSelectionColorService.types';
 import { GlobalSelectionItemType } from './globalSelectionStore/globalSelectionStore.types';
 type ColorServiceState = {
     /**
@@ -43,8 +44,7 @@ export declare const SELECTION_COLOR_PICKER_COLORS: Readonly<string>[];
 declare const UNIFIED_COLOR_POOL: string[];
 export { UNIFIED_COLOR_POOL };
 /**
- * Should be only used in local selection context!
- *
+ * *
  * Returns the color associated with a given `GlobalSelectionItemType`.
  *
  * This function maps specific item types to their corresponding selection colors,
@@ -54,4 +54,4 @@ export { UNIFIED_COLOR_POOL };
  * @param itemType - The type of the global selection item for which to retrieve the color.
  * @returns The color string associated with the specified item type.
  */
-export declare function getLocalSelectionColorByItemType(itemType: GlobalSelectionItemType): string;
+export declare function getDefaultSelectionColorByItemType(itemType: GlobalSelectionItemType): SelectionColor;

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

@@ -1,3 +1,4 @@
 import { Brand } from '@equinor/echo-utils';
 export declare const SELECTION_PLACEHOLDER_COLOR = "#B0B0B0";
+export type SelectionColor = string;
 export type HexColor = Brand<string, 'ItemIdString'>;

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

@@ -0,0 +1,17 @@
+import type { ResultArray } from '@equinor/echo-search';
+import type { StoreApi } from 'zustand';
+import type { SelectionItemTypeStrategy } from '../../strategies/selectionItemTypeStrategy.types';
+import type { GlobalSelectionAddItemResult, GlobalSelectionItemType, GlobalSelectionItemTypeToDataMap, GlobalSelectionStore, SelectionItemTypeToItemIdMap } from '../globalSelectionStore.types';
+type SetFunction = (updater: (state: GlobalSelectionStore) => void, shouldReplace?: boolean, action?: string) => void;
+/**
+ * Generic store action that adds items of any type to the global selection store.
+ *
+ * Handles two paths based on whether the strategy implements `resolveSync`:
+ *  1. Resolved items (e.g. PDMS tags): written directly as `loadedSuccessfully` — no loading flicker.
+ *  2. Remaining items: written as `isLoading` placeholders, then fetched via `strategy.fetchAsync`.
+ */
+export declare function addItemsByStrategyAction<T extends GlobalSelectionItemType>(set: SetFunction, get: StoreApi<GlobalSelectionStore>['getState'], strategy: SelectionItemTypeStrategy<T>, args: {
+    itemIds: ReadonlyArray<SelectionItemTypeToItemIdMap[T]>;
+    color?: string;
+}): Promise<GlobalSelectionAddItemResult<ResultArray<GlobalSelectionItemTypeToDataMap[T]>[]>>;
+export {};

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

@@ -35,22 +35,11 @@ export declare const useGlobalSelectionStore: import("zustand").UseBoundStore<Om
     };
 }, "setState"> & {
     setState(nextStateOrUpdater: GlobalSelectionStore | Partial<GlobalSelectionStore> | ((state: {
-        addWorkOrdersToSelection: (args: {
-            workOrderIds: GlobalSelectionTypes.WorkOrderId[];
-            color?: string;
-        }) => Promise<import("./globalSelectionStore.types").GlobalSelectionAddItemResult<import("@equinor/echo-search").ResultArray<import("@equinor/echo-search").WorkOrderData>[]>>;
-        addTagsToSelection: (args: {
-            tagIds: GlobalSelectionTypes.TagId[];
-            color?: string;
-        }) => Promise<import("./globalSelectionStore.types").GlobalSelectionAddItemResult<import("@equinor/echo-search").ResultArray<import("@equinor/echo-search").TagSummaryDto>[]>>;
-        addEquipmentsToSelection: (args: {
-            equipmentIds: GlobalSelectionTypes.EquipmentId[];
-            color?: string;
-        }) => Promise<import("./globalSelectionStore.types").GlobalSelectionAddItemResult<import("@equinor/echo-search").ResultArray<import("@equinor/echo-search").EquipmentData>[]>>;
-        addMeasuringPointsToSelection: (args: {
-            measuringPointIds: GlobalSelectionTypes.MeasuringPointId[];
-            color?: string;
-        }) => Promise<import("./globalSelectionStore.types").GlobalSelectionAddItemResult<import("@equinor/echo-search").ResultArray<import("@equinor/echo-search").MeasuringPointData>[]>>;
+        addItemsToSelection: <T extends GlobalSelectionItemType>(args: {
+            readonly itemType: T;
+            readonly itemIds: ReadonlyArray<import("./globalSelectionStore.types").SelectionItemTypeToItemIdMap[T]>;
+            readonly color?: string;
+        }) => Promise<import("./globalSelectionStore.types").GlobalSelectionAddItemResult<import("@equinor/echo-search").ResultArray<import("./globalSelectionStore.types").GlobalSelectionItemTypeToDataMap[T]>[]>>;
         removeItemsFromSelection: (args: {
             itemIds: ReadonlyArray<GlobalSelectionTypes.ItemId>;
         }) => void;
@@ -160,6 +149,14 @@ export declare const useGlobalSelectionStore: import("zustand").UseBoundStore<Om
                             type: string;
                             value: string;
                         }[];
+                        coordinates: {
+                            tagSeqNo: number;
+                            xEasting: number;
+                            yNorthing: number;
+                            zElevation: number;
+                            uom: string;
+                            linePosition: number | undefined;
+                        }[];
                         tagNo: string;
                         description: string;
                         projectCode: string;

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

@@ -59,22 +59,15 @@ interface ItemErrorStatusUpdates {
     readonly errorStatus: string;
 }
 export interface GlobalSelectionStore extends GlobalSelectionStoreData {
-    addWorkOrdersToSelection: (args: {
-        workOrderIds: GlobalSelectionTypes.WorkOrderId[];
-        color?: string;
-    }) => Promise<GlobalSelectionAddItemResult<ResultArray<WorkOrderData>[]>>;
-    addTagsToSelection: (args: {
-        tagIds: GlobalSelectionTypes.TagId[];
-        color?: string;
-    }) => Promise<GlobalSelectionAddItemResult<ResultArray<TagSummaryDto>[]>>;
-    addEquipmentsToSelection: (args: {
-        equipmentIds: GlobalSelectionTypes.EquipmentId[];
-        color?: string;
-    }) => Promise<GlobalSelectionAddItemResult<ResultArray<EquipmentData>[]>>;
-    addMeasuringPointsToSelection: (args: {
-        measuringPointIds: GlobalSelectionTypes.MeasuringPointId[];
-        color?: string;
-    }) => Promise<GlobalSelectionAddItemResult<ResultArray<MeasuringPointData>[]>>;
+    /**
+     * Generic method to add items of any type to the selection.
+     * Replaces the 4 per-type methods below. Use this for all new code.
+     */
+    addItemsToSelection<T extends GlobalSelectionItemType>(args: {
+        readonly itemType: T;
+        readonly itemIds: ReadonlyArray<SelectionItemTypeToItemIdMap[T]>;
+        readonly color?: string;
+    }): Promise<GlobalSelectionAddItemResult<ResultArray<GlobalSelectionItemTypeToDataMap[T]>[]>>;
     removeItemsFromSelection: (args: {
         itemIds: ReadonlyArray<GlobalSelectionTypes.ItemId>;
     }) => void;

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

@@ -2,54 +2,20 @@ 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;
-/**
- * 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.
- *
- * @param {GlobalSelectionTypes.WorkOrderId} item - The work order item to be mapped.
- * @returns {GlobalSelectionTypes.WorkOrderId} - The mapped work order ID.
- */
-/**
- * @param {GlobalSelectionTypes.EquipmentId} item - The equipment item to be mapped.
- * @returns {GlobalSelectionTypes.EquipmentId} - The mapped equipment ID.
- */
-/**
- * @param {GlobalSelectionTypes.TagId} item - The tag item to be mapped.
- * @returns {GlobalSelectionTypes.TagId} - The mapped tag ID.
- */
-/**
- * Maps an item to its corresponding ID object by checking the item's type and returning the appropriate ID object,
- * removing leading zeros from the ID string and trimming whitespace.
- * If the item type is not recognized, an error is thrown.
- *
- * @param {GlobalSelectionTypes.ItemId} item - The data to be mapped to its ID type.
- * @returns {GlobalSelectionTypes.ItemId} - The mapped tag ID.
- */
-declare function mapToId(item: GlobalSelectionTypes.WorkOrderId): GlobalSelectionTypes.WorkOrderId;
-declare function mapToId(item: GlobalSelectionTypes.EquipmentId): GlobalSelectionTypes.EquipmentId;
-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;
 /**
  * A utility object that provides various functions for handling global selections.
  *
  * @namespace globalSelectionUtils
+ * @property {Function} isMeasuringPointId - Checks if the passed object is a global selection MeasuringPointID.
  * @property {Function} isWorkOrderId - Checks if the passed object is a global selection WorkOrderID.
  * @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, preserving all properties (including PDMS).
+ * @property {Function} mapIdToItemType - Returns the GlobalSelectionItemType enum value for a given ItemId.
  * @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<{

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

@@ -0,0 +1,30 @@
+import type { SelectionBarFeedbackType } from '@equinor/echo-components';
+import type { MarkerId } from '../../shared/markerId.types';
+/**
+ * How long selection-action feedback stays visible.
+ * Legend popovers reuse this same duration when holding stale markers rendered,
+ * so the popover lifecycle matches the feedback lifecycle exactly.
+ */
+export declare const FEEDBACK_DISPLAY_DURATION_MS = 2000;
+export interface SelectionActionFeedback {
+    readonly isFeedbackActive: boolean;
+    readonly feedbackType: SelectionBarFeedbackType | undefined;
+    /** MarkerId of the marker that initiated the action. Consumers compare this to their own markerId. */
+    readonly actionMarkerId: MarkerId | undefined;
+}
+interface SelectionActionFeedbackStore extends SelectionActionFeedback {
+    /**
+     * Updates the selection action feedback state (isFeedbackActive + feedbackType).
+     * Stored in a dedicated micro store so it survives component remounts during
+     * the stale-marker holding period. While `isFeedbackActive` is true, useMarkerPopover
+     * delays popover content refresh and useStalePopoverMarkers keeps the old marker
+     * rendered so the feedback ("Added ✓", "Removed ✓") stays visible.
+     */
+    setFeedback: (feedback: SelectionActionFeedback) => void;
+}
+export declare const useSelectionActionFeedbackStore: import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<SelectionActionFeedbackStore>, "setState"> & {
+    setState<A extends string | {
+        type: string;
+    }>(partial: SelectionActionFeedbackStore | Partial<SelectionActionFeedbackStore> | ((state: SelectionActionFeedbackStore) => SelectionActionFeedbackStore | Partial<SelectionActionFeedbackStore>), replace?: boolean | undefined, action?: A | undefined): void;
+}>;
+export {};

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

@@ -1,6 +1,8 @@
+import { GlobalSelectionTypes } from '../globalSelectionStore/globalSelectionStore.types';
+export interface GlobalSelectionList {
+    readonly items: readonly GlobalSelectionTypes.SelectionItem[];
+}
 /**
  * Hook for returning all lists stored in the global selection.
  */
-export declare function useGlobalSelectionLists(): {
-    items: (import("..").GlobalSelectionGenericItem<import("..").GlobalSelectionItemType.WorkOrder> | import("..").GlobalSelectionGenericItem<import("..").GlobalSelectionItemType.Tag> | import("..").GlobalSelectionGenericItem<import("..").GlobalSelectionItemType.Equipment> | import("..").GlobalSelectionGenericItem<import("..").GlobalSelectionItemType.MeasuringPoint>)[];
-}[];
+export declare function useGlobalSelectionLists(): readonly GlobalSelectionList[];

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

@@ -2,7 +2,6 @@ import { GlobalSelectionTypes } from '../globalSelectionStore/globalSelectionSto
 /**
  * Hook to check if an item is in the global selection
  * @param {GlobalSelectionTypes.ItemId} itemId - The itemId
- * @param {GlobalSelectionItemType} itemType - The item type
  * @returns {boolean} - True if the item is in global selection, false otherwise
  */
 export declare function useIsInGlobalSelection(itemId: GlobalSelectionTypes.ItemId): boolean;

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

@@ -1,9 +1,10 @@
 import { Guid } from '@equinor/echo-utils';
 import { SelectionTreeTypes } from '../selectionMenu/selectionTreeStore/selectionTree.store.types';
 /**
- * Custom hook to get the selection categories by group ID from the global selection tree hiearchy.
+ * Custom hook to get the selection categories by group ID from the global selection tree hierarchy.
  *
- * This hook retrieves the categories for a given group ID from the selection tree store.
+ * Zustand's Object.is equality check on the selector return value ensures re-renders only
+ * happen when this specific group's categories change, not on unrelated group mutations.
  *
  * @param {Guid} groupId - The ID of the group to get categories for.
  * @returns {SelectionTreeTypes.Category[] | undefined} The categories for the given group ID, or undefined if not found.

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

@@ -1,7 +1,7 @@
 export * from './globalSelectionStore/globalSelectionStore.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 { PDMS_INTERNAL_TAG_TYPES, isPdmsInternalTagType } from './pdmsTag/pdmsTag.types';
 export type { PdmsInternalTagType, PdmsTagId, PdmsTagSummaryDto, StidTagId } from './pdmsTag/pdmsTag.types';
 export { useAreAllItemsVisible } from './hooks/useAreAllItemsVisible';
 export { useGlobalSelectionByItemId } from './hooks/useGlobalSelectionByItemId';
@@ -18,7 +18,7 @@ export { useCurrentSelectionId } from './selectionMenu/hooks/useCurrentSelection
 export { useFetchSelectionHistory } from './selectionMenu/hooks/useFetchSelectionHistory';
 export { useGlobalSelectionGroups } from './selectionMenu/hooks/useGlobalSelectionGroups';
 export { useMostUsedSelectionColorByIds } from './selectionMenu/hooks/useSelectionColorFrequency';
-export { RemoveSelectionItemsConfirmDialog } from './components/RemoveSelectionItemsConfirmDialog';
+export { RemoveSelectionItemsConfirmDialog } from './components/selectionActionBar/RemoveSelectionItemsConfirmDialog';
 export { globalSelectionApi } from './globalSelection.api';
 export { globalSelectionInternal } from './globalSelection.internal';
 export { SELECTION_COLOR_PICKER_COLORS } from './globalSelectionColorService';

package/src/lib/feature/globalSelection/selectionMenu/hooks/{useIsAllIGlobalSelectionItemsHidden.d.ts → useIsAllGlobalSelectionItemsHidden.d.ts}

@@ -1,8 +1,4 @@
 import { Guid } from '@equinor/echo-utils';
-interface UseIsAllIGlobalSelectionItemsHiddenArgs {
-    groupId: Guid;
-    categoryId?: string;
-}
 /**
  * Custom hook to determine if all items in a selection list are hidden by the user.
  *
@@ -15,5 +11,7 @@ interface UseIsAllIGlobalSelectionItemsHiddenArgs {
  *
  * The hook returns `true` if all items in the list are hidden by the user, and `false` otherwise.
  */
-export declare const useIsAllIGlobalSelectionItemsHidden: (args: UseIsAllIGlobalSelectionItemsHiddenArgs) => boolean;
-export {};
+export declare const useIsAllGlobalSelectionItemsHidden: (args: {
+    groupId: Guid;
+    categoryId?: string;
+}) => boolean;

package/src/lib/feature/globalSelection/selectionMenu/hooks/useSelectionColorFrequency.d.ts

@@ -5,14 +5,17 @@ import { GlobalSelectionTypes } from '../../globalSelectionStore/globalSelection
  * This hook retrieves the global selection items and filters them based on the provided item IDs,
  * extracts their associated colors, and sorts the colors by frequency.
  *
+ * Callers must provide a referentially stable `itemIds` array (e.g. via `useMemo`)
+ * to avoid unnecessary recomputation on every render.
+ *
  * @param itemIds - An array of item IDs to match against global selection items.
  * @returns An array of color strings sorted by frequency, most frequent first.
  */
-export declare function useSelectionColorFrequencyByIds(itemIds: GlobalSelectionTypes.ItemId[]): string[];
+export declare function useSelectionColorFrequencyByIds(itemIds: ReadonlyArray<GlobalSelectionTypes.ItemId>): readonly string[];
 /**
  * Returns the most frequently used selection color from the provided item IDs.
  *
  * @param itemIds - An array of item IDs to analyze for color frequency.
  * @returns The most used selection color as a string, or `undefined` if no colors are present.
  */
-export declare function useMostUsedSelectionColorByIds(itemIds: GlobalSelectionTypes.ItemId[]): string | undefined;
+export declare function useMostUsedSelectionColorByIds(itemIds: ReadonlyArray<GlobalSelectionTypes.ItemId>): string | undefined;

package/src/lib/feature/globalSelection/selectionMenu/selectionTreeStore/actions/addItems.action.d.ts

@@ -1,6 +1,11 @@
 import { Guid } from '@equinor/echo-utils';
 import { GlobalSelectionTypes } from '../../../globalSelectionStore/globalSelectionStore.types';
 import { SelectionTreeStore } from '../selectionTree.store.types';
+export type AddItemsActionArgs = {
+    readonly itemIds: ReadonlyArray<GlobalSelectionTypes.ItemId>;
+    readonly groupId?: Guid;
+    readonly useDefaultSelectionTypeColors?: boolean;
+};
 /**
  * Adds items to the selection tree store by categorizing them into tags, work orders,
  * equipments, and measuring points, then dispatching the appropriate add actions for each type.
@@ -10,7 +15,3 @@ import { SelectionTreeStore } from '../selectionTree.store.types';
  * @returns A promise that resolves when all items have been added to the store.
  */
 export declare function addItems(get: () => SelectionTreeStore, args: AddItemsActionArgs): Promise<void>;
-export type AddItemsActionArgs = {
-    itemIds: GlobalSelectionTypes.ItemId[];
-    groupId?: Guid;
-};

package/src/lib/feature/globalSelection/selectionMenu/selectionTreeStore/actions/removeAllItemsById.action.d.ts

@@ -10,6 +10,6 @@ type SetFunction = (set: (state: SelectionTreeStore) => void, shouldReplace?: bo
  * @returns {void}
  */
 export declare function removeAllItemsById(set: SetFunction, args: {
-    itemIds: GlobalSelectionTypes.ItemId[];
+    itemIds: ReadonlyArray<GlobalSelectionTypes.ItemId>;
 }): void;
 export {};

package/src/lib/feature/globalSelection/selectionMenu/selectionTreeStore/actions/removeItemsById.action.d.ts

@@ -19,6 +19,6 @@ export declare function removeItemsById(set: SetFunction, args: RemoveItemsByIdA
 type RemoveItemsByIdArgs = {
     groupId?: Guid;
     categoryId: GlobalSelectionCategoryId;
-    itemIds: GlobalSelectionTypes.ItemId[];
+    itemIds: ReadonlyArray<GlobalSelectionTypes.ItemId>;
 };
 export {};

package/src/lib/feature/globalSelection/selectionMenu/selectionTreeStore/actions/selectionTree.action.types.d.ts

@@ -2,9 +2,10 @@ import { ResultArray } from '@equinor/echo-search';
 import { Guid } from '@equinor/echo-utils';
 import { GlobalSelectionItemType, GlobalSelectionItemTypeToDataMap, GlobalSelectionTypes, SelectionItemTypeToItemIdMap } from '../../../globalSelectionStore/globalSelectionStore.types';
 type AddItemArgsBase<ItemIdType extends GlobalSelectionTypes.ItemId> = {
-    itemIds: Readonly<ItemIdType[]>;
-    replaceItems?: boolean;
-    getActionResult?: boolean;
+    readonly itemIds: Readonly<ItemIdType[]>;
+    readonly replaceItems?: boolean;
+    readonly useDefaultSelectionTypeColors?: boolean;
+    readonly getActionResult?: boolean;
 };
 type AddItemArgsExclusive = {
     groupId: Guid;
@@ -20,7 +21,7 @@ export type AddItemsResponse<T extends GlobalSelectionItemType> = {
     fetchResults: ResultArray<GlobalSelectionItemTypeToDataMap[T]>[];
     itemsAdded: Readonly<SelectionItemTypeToItemIdMap[T][]>;
     actionResult: SelectionTreeActionResult;
-    affectedGroupId?: Guid;
+    affectedGroupId: Guid | undefined;
 };
 export type SelectionTreeActionResult = 'ItemsUpdated' | 'ItemsAdded' | 'NewGroupCreated' | 'NoChanges';
 export {};