@equinor/echo-framework 0.23.1 → 0.23.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equinor/echo-framework",
-  "version": "0.23.1",
+  "version": "0.23.2",
   "peerDependencies": {
     "@equinor/echo-base": ">= 0.7.0 < 0.8.0",
     "@equinor/echo-components": ">= 0.12.0 < 0.13.0",
@@ -18,7 +18,9 @@
     "lodash": "4.17.21",
     "react-router-dom": "5.3.4",
     "zustand": ">= 4.4.7 < 5",
-    "immer": "10.1.1"
+    "immer": "10.1.1",
+    "ag-charts-react": ">= 11.1.1 < 12.0.0",
+    "ag-charts-community": ">= 11.1.1 < 12.0.0"
   },
   "dependencies": {
     "dexie": "4.0.11"

package/src/lib/feature/equipment/utils/equipmentUtils.d.ts

@@ -12,20 +12,20 @@ interface OpenMeasuringPointsArgs {
 export declare const openEquipmentIn3dWeb: ({ equipmentId, e3dRef, goToLink, pathname, instCode, tagNo }: OpenMeasuringPointsArgs) => Promise<void>;
 export declare const is3DEquipment: (equipment: Equipment) => boolean;
 export declare const sortMeasurementsInMeasuringPointsByNewestFirst: (measuringPoints: MeasuringPointDto[]) => {
+    measurements: import("../../measuringPoint").MeasurementDto[];
     measuringPointId: string;
-    measuringPosition?: string;
-    measuringPoint?: string;
-    functionalLocationId?: string;
-    tagPlantId?: string;
-    tagId?: string;
-    equipmentId?: string;
-    quantitativeCharacteristicId?: string;
-    quantitativeCharacteristicUnit?: string;
+    measuringPosition: string;
+    measuringPoint: string;
+    functionalLocationId: string | undefined;
+    tagPlantId: string | undefined;
+    tagId: string | undefined;
+    equipmentId: string | undefined;
+    quantitativeCharacteristicId: string | undefined;
+    quantitativeCharacteristicUnit: string | undefined;
     positionDetails_CoordinateSystemName?: string;
     positionDetails_E3DReferenceNumber?: string;
     positionDetails_CoordinateEast?: string;
     positionDetails_CoordinateNorth?: string;
     positionDetails_CoordinateUp?: string;
-    measurements: import("../../measuringPoint").MeasurementDto[];
 }[];
 export {};

package/src/lib/feature/globalSelection/panToEcho3d/panTo3DButton.d.ts

@@ -1,7 +1,9 @@
 import React from 'react';
-import { GlobalSelectionTypes } from '../globalSelectionStore/globalSelectionStore.types';
+import { GlobalSelectionItemType, GlobalSelectionTypes } from '../globalSelectionStore/globalSelectionStore.types';
 interface PanTo3DButtonProps {
-    item: GlobalSelectionTypes.SelectionItem;
+    itemId: GlobalSelectionTypes.ItemId;
+    itemType: GlobalSelectionItemType;
+    disabled: boolean;
 }
 export declare const PanTo3DButton: React.FC<PanTo3DButtonProps>;
 export {};

package/src/lib/feature/globalSelection/panToEcho3d/usePanTo3DWeb.d.ts

@@ -1,4 +1,4 @@
-import { GlobalSelectionTypes } from '../globalSelectionStore/globalSelectionStore.types';
+import { GlobalSelectionItemType, GlobalSelectionTypes } from '../globalSelectionStore/globalSelectionStore.types';
 export declare const usePanTo3dWeb: () => {
-    panTo3D: (item: GlobalSelectionTypes.SelectionItem) => Promise<void>;
+    panTo3D: (itemId: GlobalSelectionTypes.ItemId, itemType: GlobalSelectionItemType) => Promise<void>;
 };

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

@@ -11,6 +11,7 @@ export type AddItemArgs<ItemIdType extends GlobalSelectionTypes.ItemId> = {
 } & AddByLabel;
 export type AddItemsResponse<FetchResponseType> = {
     fetchResults: FetchResponseType;
+    itemsAdded: Readonly<GlobalSelectionTypes.ItemId[]>;
     actionResult: SelectionTreeActionResult;
 };
 export type SelectionTreeActionResult = 'ItemsUpdated' | 'ItemsAdded' | 'NewGroupCreated' | 'NoChanges';

package/src/lib/feature/legend/legendUpdater.d.ts

@@ -1,2 +1,3 @@
+export declare function unsubscribeToLegendDataChanged(): void;
 export declare function subscribeToLegendDataChanged(): void;
 export declare const sleep: (ms: number) => Promise<unknown>;

package/src/lib/feature/legend/legendVisibleDataStore.d.ts

@@ -52,6 +52,7 @@ export declare const useLegendVisibleDataStore: import("zustand").UseBoundStore<
         type: string;
     } | undefined): void;
 }>;
+export declare function legendVisibleDataSnapshot(): LegendVisibleDataStore;
 /**
  * Visible items are all items on screen that should be affected by the legend.
  * @returns A function for adding visible items by type and key, which is automatically removed when the component unmounts.

package/src/lib/feature/legend/types/legendType.d.ts

@@ -1,6 +1,6 @@
 import { Brand } from '@equinor/echo-utils';
 import { GlobalSelectionTypes } from '../../globalSelection';
-type TemporaryLegendIdsForTesting = 'Fake Tag Legend' | 'Work Orders with Custom UI';
+type TemporaryLegendIdsForTesting = 'Tag Legend' | 'Work Orders with Custom UI';
 export type KnownLegendIds = 'Equipment' | TemporaryLegendIdsForTesting;
 export type LegendId = KnownLegendIds | Brand<string, 'LegendId'>;
 export declare function createLegendId(id: string): LegendId;

package/src/lib/feature/measuringPoint/components/measuringPointDetails/measuringPointHistoryList/components/PointCountSelector.d.ts

@@ -0,0 +1,15 @@
+/**
+ * PointCountSelector lets users choose how many data points to display,
+ * such as the last 5, 10, 15, 20, or all available points.
+ *
+ * @param maxPoints - The total number of points available for selection.
+ * @param pointCount - The currently selected number of points to display.
+ * @param onChange - Callback when the user selects a different point count.
+ */
+interface PointCountSelectorProps {
+    maxPoints: number;
+    pointCount: number;
+    onChange: (selectedValue: number) => void;
+}
+export declare const PointCountSelector: React.FC<PointCountSelectorProps>;
+export {};

package/src/lib/feature/measuringPoint/components/measuringPointDetails/measuringPointHistoryList/components/graphStyleControls.d.ts

@@ -0,0 +1,7 @@
+import { ActiveStyle, HandleInterpolationChange } from '../types/activeStyleType';
+type GraphStyleControlsProps = {
+    activeStyle: ActiveStyle;
+    onInterpolationChange: HandleInterpolationChange;
+};
+export declare const GraphStyleControls: React.FC<GraphStyleControlsProps>;
+export {};

package/src/lib/feature/measuringPoint/components/measuringPointDetails/measuringPointHistoryList/components/measuringHistoryGraphDialog.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+type DialogBox = {
+    open: boolean;
+    onClose: () => void;
+    content: React.ReactNode;
+};
+export declare const MeasuringHistoryGraphDialog: React.FC<DialogBox>;
+export {};

package/src/lib/feature/measuringPoint/components/measuringPointDetails/measuringPointHistoryList/components/measuringHistoryGraphTooltip.d.ts

@@ -0,0 +1,2 @@
+import { AgBarSeriesTooltipRendererParams } from 'ag-charts-community';
+export declare function measuringHistoryGraphTooltip(params: AgBarSeriesTooltipRendererParams): string;

package/src/lib/feature/measuringPoint/components/measuringPointDetails/measuringPointHistoryList/components/viewInFullScreenButton.d.ts

@@ -0,0 +1,5 @@
+export declare const ViewInFullScreenButton: React.FC<{
+    open: boolean;
+    onToggle: () => void;
+    children: React.ReactNode;
+}>;

package/src/lib/feature/measuringPoint/components/measuringPointDetails/measuringPointHistoryList/hooks/useActiveStyleGraph.d.ts

@@ -0,0 +1,5 @@
+import { ActiveStyle, SetActiveStyle } from '../types/activeStyleType';
+export declare const useActiveStyle: () => {
+    activeStyle: ActiveStyle;
+    setActiveStyle: SetActiveStyle;
+};

package/src/lib/feature/measuringPoint/components/measuringPointDetails/measuringPointHistoryList/hooks/useMeasuringChartConfig.d.ts

@@ -0,0 +1,10 @@
+import { AgCartesianChartOptions } from 'ag-charts-community';
+import { MeasurementDto } from '../../../../types/measuringPoint';
+import { ActiveStyle, HandleInterpolationChange } from '../types/activeStyleType';
+export declare function useMeasuringChartConfig(measurements: MeasurementDto[], activeStyle: ActiveStyle, setActiveStyle: (style: ActiveStyle) => void, isFullscreen: boolean): {
+    chartConfig: AgCartesianChartOptions;
+    sortedMeasurements: import("../utils/measuringPointHistoryListUtils").SortedMeasurement[];
+    pointCount: number;
+    setPointCount: import("react").Dispatch<import("react").SetStateAction<number>>;
+    updateInterpolation: HandleInterpolationChange;
+};

package/src/lib/feature/measuringPoint/components/measuringPointDetails/measuringPointHistoryList/measuringDocumentsHistoryGraph.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import { MeasurementDto } from '../../../types/measuringPoint';
+import { ActiveStyle, SetActiveStyle } from './types/activeStyleType';
+type MeasuringDocumentsHistoryGraphProps = {
+    measurements: MeasurementDto[];
+    activeStyle: ActiveStyle;
+    setActiveStyle: SetActiveStyle;
+    isFullSize?: boolean;
+    specifiedHeight?: string;
+    specifiedPadding?: string;
+    graphStyleControls?: boolean;
+};
+export declare const MeasuringDocumentsHistoryGraph: React.FC<MeasuringDocumentsHistoryGraphProps>;
+export {};

package/src/lib/feature/measuringPoint/components/measuringPointDetails/measuringPointHistoryList/measuringPointHistoryGraphSection.d.ts

@@ -0,0 +1,6 @@
+import { MeasurementDto } from '../../../types/measuringPoint';
+interface MeasuringPointHistoryGraphSectionProps {
+    measurements: MeasurementDto[];
+}
+export declare const MeasuringPointHistoryGraphSection: React.FC<MeasuringPointHistoryGraphSectionProps>;
+export {};

package/src/lib/feature/measuringPoint/components/measuringPointDetails/measuringPointHistoryList/measuringPointHistoryItem.d.ts

@@ -0,0 +1,6 @@
+import { MeasurementDto } from '../../../types/measuringPoint';
+export declare const MeasuringPointHistoryItem: React.FC<{
+    measurement: MeasurementDto;
+    quantitativeCharacteristicId: string | undefined;
+    instCode: string | undefined;
+}>;

package/src/lib/feature/measuringPoint/components/measuringPointDetails/{measuringPointHistoryList.d.ts → measuringPointHistoryList/measuringPointHistoryList.d.ts}

@@ -1,4 +1,4 @@
-import { MeasuringPointDto } from '../../types/measuringPoint';
+import { MeasuringPointDto } from '../../../types/measuringPoint';
 type MeasuringPointHistoryListProps = {
     measuringPoint: MeasuringPointDto;
 };

package/src/lib/feature/measuringPoint/components/measuringPointDetails/measuringPointHistoryList/types/activeStyleType.d.ts

@@ -0,0 +1,7 @@
+import { Position, Type } from './measuringDocumentsHistoryGraphType';
+export type ActiveStyle = {
+    type: Type;
+    position?: Position;
+};
+export type HandleInterpolationChange = (type: ActiveStyle['type'], position?: ActiveStyle['position']) => void;
+export type SetActiveStyle = (style: ActiveStyle) => void;

package/src/lib/feature/measuringPoint/components/measuringPointDetails/measuringPointHistoryList/types/measuringDocumentsHistoryGraphType.d.ts

@@ -0,0 +1,7 @@
+import { AgBaseAxisLabelOptions } from 'ag-charts-community';
+import { SortedMeasurement } from '../utils/measuringPointHistoryListUtils';
+export declare const strongRed: string;
+export declare const strongRedFade: string;
+export type Type = 'linear' | 'smooth' | 'step';
+export type Position = 'start' | 'middle' | 'end';
+export declare const createLabel: (fullScreenDialogOpen: boolean | undefined, sortedMeasurements: SortedMeasurement[], yAxisLabel?: boolean) => AgBaseAxisLabelOptions;

package/src/lib/feature/measuringPoint/components/measuringPointDetails/measuringPointHistoryList/utils/createMeasuringChartConfig.d.ts

@@ -0,0 +1,4 @@
+import { AgCartesianChartOptions } from 'ag-charts-community';
+import { ActiveStyle } from '../types/activeStyleType';
+import { SortedMeasurement } from './measuringPointHistoryListUtils';
+export declare function createMeasuringChartConfig(data: SortedMeasurement[], activeStyle: ActiveStyle, fullScreen?: boolean): AgCartesianChartOptions;

package/src/lib/feature/measuringPoint/components/measuringPointDetails/measuringPointHistoryList/utils/measuringPointHistoryListUtils.d.ts

@@ -0,0 +1,63 @@
+import { AgAxisLabelFormatterParams, AgCartesianChartOptions } from 'ag-charts-community';
+import { MeasurementDto } from '../../../../types/measuringPoint';
+import { ActiveStyle } from '../types/activeStyleType';
+export interface SortedMeasurement {
+    date: string;
+    condition: number;
+    fullDateTime: Date;
+    unit: string;
+}
+/**
+ * Filters the given list of measurements to include only those with valid quantitative or qualitative readings.
+ *
+ * @param {MeasurementDto[]} measurements - The list of measurements to filter.
+ * @returns {MeasurementDto[]} - The filtered list of measurements.
+ */
+export declare const filterMeasurements: (measurements: MeasurementDto[]) => MeasurementDto[];
+/**
+ * Maps a MeasurementDto to a simplified sortable measurement object.
+ *
+ * @param {MeasurementDto} measurement - The measurement to transform.
+ * @returns {Omit<SortedMeasurement, 'date'> & { fullDateTime: Date, date: Date }} - The transformed measurement with full datetime info.
+ */
+export declare const mapToSortableMeasurement: (measurement: MeasurementDto) => Omit<SortedMeasurement, "date"> & {
+    fullDateTime: Date;
+    date: Date;
+};
+/**
+ * Sorts the given list of measurements by their measurement date and maps them to a simplified structure.
+ *
+ * @param {MeasurementDto[]} measurements - The list of measurements to sort and map.
+ * @returns {SortedMeasurement[]} - The sorted and mapped list of measurements.
+ */
+export declare const sortMeasurements: (measurements: MeasurementDto[]) => SortedMeasurement[];
+/**
+ * Formats the x-axis labels for the chart, where only a specified number of labels are displayed.
+ *
+ * @param {AgAxisLabelFormatterParams} params - The parameters for the axis label formatter.
+ * @returns {string} - The formatted label for the x-axis.
+ */
+export declare function xAxisLabelFormatter(args: {
+    params: AgAxisLabelFormatterParams;
+    sortedMeasurements: SortedMeasurement[];
+    numberOfLabels: 3 | number;
+}): any;
+/**
+ * Updates the chart interpolation style for the given chart options.
+ *
+ * @param {AgCartesianChartOptions} chartOptions - The chart options to update.
+ * @param {boolean} enableInterpolation - Whether to enable or disable interpolation.
+ * @returns {AgCartesianChartOptions} - The updated chart options with the interpolation setting applied.
+ */
+export declare function updateChartInterpolation(prevConfig: AgCartesianChartOptions, type: ActiveStyle['type'], position: ActiveStyle['position'] | undefined, isFullscreen: boolean): AgCartesianChartOptions;
+/**
+ * Formats a measurement value for display in the chart tooltip or list.
+ *
+ * @param {number} value - The measurement value to format.
+ * @param {string} unit - The unit of the measurement.
+ * @returns {string} - The formatted measurement value with the unit.
+ */
+export declare function formatMeasurement(measurement: {
+    quantitativeReading?: number;
+    quantitativeReadingUnitId?: string | null;
+}): string;

package/src/lib/feature/measuringPoint/types/measuringPoint.d.ts

@@ -1,3 +1,4 @@
+import { MeasuringPointData } from '@equinor/echo-search';
 export interface MeasurementDto {
     measurementId: string;
     measuringPointId: string;
@@ -14,20 +15,6 @@ export interface MeasurementDto {
     qualitativeCodeId?: string;
     longText?: object;
 }
-export interface MeasuringPointDto {
-    readonly measuringPointId: string;
-    readonly measuringPosition?: string;
-    readonly measuringPoint?: string;
-    readonly functionalLocationId?: string;
-    readonly tagPlantId?: string;
-    readonly tagId?: string;
-    readonly equipmentId?: string;
-    readonly quantitativeCharacteristicId?: string;
-    readonly quantitativeCharacteristicUnit?: string;
-    readonly positionDetails_CoordinateSystemName?: string;
-    readonly positionDetails_E3DReferenceNumber?: string;
-    readonly positionDetails_CoordinateEast?: string;
-    readonly positionDetails_CoordinateNorth?: string;
-    readonly positionDetails_CoordinateUp?: string;
+export interface MeasuringPointDto extends MeasuringPointData {
     readonly measurements: MeasurementDto[];
 }