datastake-daf 0.6.784 → 0.6.785

package/src/@daf/utils/numbers.js

@@ -32,3 +32,60 @@ export const renderPercentage = (val) => {
 
 	return val + "%";
 };
+
+/**
+ * Calculates stat change object for StatCard component based on current and previous values
+ * @param {Object} data - Object with current and previous values
+ * @param {number} data.current - Current value
+ * @param {number} data.previous - Previous value
+ * @param {Object} options - Optional configuration
+ * @param {string} options.tooltipText - Custom tooltip text
+ * @param {string} options.format - Format type: 'percentage' (default) or 'absolute'
+ * @param {number} options.decimalPlaces - Number of decimal places for percentage (default: 1)
+ * @returns {Object|null} Change object for StatCard or null if data is invalid
+ */
+export const calculateStatChange = (data, options = {}) => {
+    if (!data || typeof data !== 'object') {
+        return null;
+    }
+
+    const { current, previous } = data;
+    
+    // Validate that both values are numbers
+    if (typeof current !== 'number' || typeof previous !== 'number') {
+        return null;
+    }
+
+    // If previous is 0, we can't calculate percentage change
+    if (previous === 0) {
+        return null;
+    }
+
+    const {
+        tooltipText,
+        format = 'percentage',
+        decimalPlaces = 1,
+    } = options;
+
+    // Calculate the difference
+    const difference = current - previous;
+    const isPositive = difference >= 0;
+    const direction = isPositive ? 'up' : 'down';
+
+    // Format the value
+    let value;
+    if (format === 'absolute') {
+        // Show absolute difference
+        value = Math.abs(difference).toLocaleString();
+    } else {
+        // Show percentage change
+        const percentageChange = (Math.abs(difference) / previous) * 100;
+        value = `${percentageChange.toFixed(decimalPlaces)}%`;
+    }
+
+    return {
+        value,
+        direction,
+        tooltipText: tooltipText || undefined,
+    };
+};

package/src/pages.js

@@ -19,6 +19,7 @@ export { default as TablePage } from './@daf/pages/TablePage/index.jsx';
 export { default as OperatorSummary } from './@daf/pages/Summary/Operator/index.jsx';
 export { default as RestorationActivitySummary } from './@daf/pages/Summary/Activities/Restoration/index.jsx';
 export { default as PlantingCycleSummary } from './@daf/pages/Summary/Activities/PlantingCycle/index.jsx';
+export { default as MonitoringCampaignSummary } from './@daf/pages/Summary/Activities/MonitoringCampaign/index.jsx';
 export { default as MineSummary } from './@daf/pages/Summary/Minesite/index.jsx';
 
 // View

package/src/utils.js

@@ -31,7 +31,7 @@ export { convertUndefinedToNull, hasKeyInObject, removeKeysFromObject } from './
 
 export { default as ErrorFormat, formatErrors } from './helpers/ErrorFormater'
 
-export { renderNumber, renderPercentage } from "./@daf/utils/numbers.js"
+export { renderNumber, renderPercentage, calculateStatChange } from "./@daf/utils/numbers.js"
 
 export { MessageTypes, displayMessage} from './helpers/messages.js'