@equinor/echo-framework 2.0.1 → 2.1.0

package/package.json

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

package/src/index.d.ts

@@ -43,6 +43,7 @@ export { useIsFullScreenModeEnabled } from './lib/hooks/useIsFullScreenModeEnabl
 export { useOpenPrepview } from './lib/hooks/useOpenPrepview';
 export { useScreenOrientation } from './lib/hooks/useScreenOrientation';
 export { useScreenValues } from './lib/hooks/useScreenValues';
+export { useSelectionGroupLabelsPerItem } from './lib/hooks/useSelectionGroupLabelsPerItem';
 export { getMeasurementsFromMaintenanceDataApi } from './lib/services/api/api-measuringPoints';
 export { getPlantsCachedOrApi, getPlantsFromApi } from './lib/services/api/api-plants';
 export { RegisteredComponentName } from './lib/services/componentRegistry/componentRegistry';
@@ -127,6 +128,7 @@ declare const EchoFramework: Readonly<{
             isScreenMobileSize: boolean;
             screenOrientation: import("./lib/types/hookLibrary").ScreenOrientation;
         };
+        useSelectionGroupLabelsPerItem: () => Map<string, string[]>;
         useTabTitle(): void;
         useTagDetails({ instCode, tagNo }: {
             tagNo: string;

package/src/lib/hooks/index.d.ts

@@ -8,5 +8,6 @@ export * from './usePlantAvailableIn3d';
 export * from './usePlantAvailableIn3dWeb';
 export * from './useScreenOrientation';
 export * from './useScreenValues';
+export * from './useSelectionGroupLabelsPerItem';
 export * from './useTabTitle';
 export * from './useTagDetails';

package/src/lib/hooks/useSelectionGroupLabelsPerItem.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Custom hook that creates a mapping between selection items and their associated group labels.
+ *
+ * This hook is primarily used in 3D Web for determining which selection groups
+ * contain specific items. It's particularly useful for Legend components that need to display
+ * which lists/groups items belong to and their associated colors.
+ *
+ * @returns {Map<string, string[]>} A Map where:
+ *   - Key: Item ID as a string (converted using globalSelectionUtils.itemIdToString)
+ *   - Value: Array of group labels that the item belongs to
+ *
+ * @example
+ * ```typescript
+ * const itemGroupLabels = useSelectionGroupLabelsPerItem();
+ * const groupsForItem = itemGroupLabels.get('item-123');
+ * // Returns: ['Group A', 'Group B'] if item-123 belongs to both groups
+ * ```
+ */
+export declare const useSelectionGroupLabelsPerItem: () => Map<string, string[]>;