@reekon-tools/boldr-utils 1.16.0 → 1.17.1

package/dist/server.d.ts

@@ -0,0 +1,16 @@
+export { evaluateFormula, createFormulaScope, createEnhancedFormulaScope, clearFormulaCache, type EnhancedMapping, type FormulaDefinition, type FormulaEvaluationOptions, } from './formulas/evaluateFormula.js';
+export { calculateFormula } from './formulas/calculateFormula.js';
+export { convertMicrometers } from './utils/micrometersToUnit.js';
+export { parseMeasurement } from './utils/parseMeasurement.js';
+export * from './types/firestore.js';
+export * from './types/layout.js';
+export * from './types/annotation.js';
+export { getToleranceColor, getToleranceSecondaryColor, calculateDeviationPercentage, isWithinTolerance, generateToleranceGradient, createDefaultToleranceThresholds, DEFAULT_TOLERANCE_COLORS, DEFAULT_TOLERANCE_SECONDARY_COLORS, type ToleranceThreshold, type ToleranceConfig, } from './utils/tolerance.js';
+export { DEFAULT_GROUP_INDEX, isDefaultGroup, findDefaultGroup, isFormGroupCompleted, } from './utils/groups.js';
+export { ALL_EXPORT_CATEGORIES, ALL_EXPORT_MEASUREMENT_DATA_FIELDS, ALL_EXPORT_OBJECT_TYPES, DEFAULT_EXPORT_CONFIG, EXPORT_EVERYTHING_CONFIG, normalizeExportConfig, type ExportCategory, type ExportConfig, type ExportImageFormat, type ExportMeasurementDataField, type ExportMeasurementFilter, type ExportObjectType, } from './export/config.js';
+export { classifyFileForExport } from './export/objectKinds.js';
+export { buildJobCsv, escapeCSVField, hyperlinkCell, type BuildJobCsvInput, type ExportObjectRow, type ExportScope, } from './export/buildJobCsv.js';
+export { desktopBaseUrlForFirebaseProject, desktopFileEditorUrl, type DesktopLinkContext, } from './export/desktopLinks.js';
+export { numberToLetterIndex, formGroupInputLabel, listGroupMeasurementLabel, } from './utils/indexLabels.js';
+export { toSelectedValues, formatSelectedValues, toStoredValue, } from './utils/selectValues.js';
+export * from './calculator/index.js';

package/dist/server.js

@@ -0,0 +1,21 @@
+// Server-safe entry point (package export "./server"). Node consumers —
+// boldr-api, Cloud Functions, scripts — import from here instead of the
+// root barrel, whose module graph statically pulls in `react` and
+// `@shopify/react-native-skia`. Only modules with no React/Skia anywhere
+// in their import graph may be re-exported from this file.
+export { evaluateFormula, createFormulaScope, createEnhancedFormulaScope, clearFormulaCache, } from './formulas/evaluateFormula.js';
+export { calculateFormula } from './formulas/calculateFormula.js';
+export { convertMicrometers } from './utils/micrometersToUnit.js';
+export { parseMeasurement } from './utils/parseMeasurement.js';
+export * from './types/firestore.js';
+export * from './types/layout.js';
+export * from './types/annotation.js';
+export { getToleranceColor, getToleranceSecondaryColor, calculateDeviationPercentage, isWithinTolerance, generateToleranceGradient, createDefaultToleranceThresholds, DEFAULT_TOLERANCE_COLORS, DEFAULT_TOLERANCE_SECONDARY_COLORS, } from './utils/tolerance.js';
+export { DEFAULT_GROUP_INDEX, isDefaultGroup, findDefaultGroup, isFormGroupCompleted, } from './utils/groups.js';
+export { ALL_EXPORT_CATEGORIES, ALL_EXPORT_MEASUREMENT_DATA_FIELDS, ALL_EXPORT_OBJECT_TYPES, DEFAULT_EXPORT_CONFIG, EXPORT_EVERYTHING_CONFIG, normalizeExportConfig, } from './export/config.js';
+export { classifyFileForExport } from './export/objectKinds.js';
+export { buildJobCsv, escapeCSVField, hyperlinkCell, } from './export/buildJobCsv.js';
+export { desktopBaseUrlForFirebaseProject, desktopFileEditorUrl, } from './export/desktopLinks.js';
+export { numberToLetterIndex, formGroupInputLabel, listGroupMeasurementLabel, } from './utils/indexLabels.js';
+export { toSelectedValues, formatSelectedValues, toStoredValue, } from './utils/selectValues.js';
+export * from './calculator/index.js';

package/dist/utils/evaluateFormula.d.ts

@@ -0,0 +1,20 @@
+type MeasurementMap = Map<string, {
+    id: string;
+    value: number;
+}[]>;
+interface FormulaEvaluationOptions {
+    expression: string;
+    mappings: Record<string, string>;
+    group: {
+        id: string;
+        columns: Map<string, any>;
+    };
+    columns: {
+        id: string;
+        type: string;
+    }[];
+    measurementMap: MeasurementMap;
+    defaultUnit?: string;
+}
+export declare function evaluateFormula({ expression, mappings, group, columns, measurementMap, defaultUnit, }: FormulaEvaluationOptions): number | string;
+export {};

package/dist/utils/evaluateFormula.js

@@ -0,0 +1,31 @@
+import { create, all } from 'mathjs';
+const math = create(all);
+export function evaluateFormula({ expression, mappings, group, columns, measurementMap, defaultUnit = 'um', }) {
+    const scope = {};
+    for (const [variable, columnId] of Object.entries(mappings)) {
+        const rawValue = group.columns.get(columnId);
+        const columnDef = columns.find((c) => c.id === columnId);
+        if (columnDef?.type === 'Measurement') {
+            const groupMeasurements = measurementMap.get(group.id) || [];
+            const measurement = groupMeasurements.find((m) => m.id === rawValue);
+            if (measurement?.value !== undefined) {
+                scope[variable] = math.unit(measurement.value, defaultUnit);
+                continue;
+            }
+        }
+        const parsedValue = typeof rawValue === 'number' ? rawValue : parseFloat(rawValue || '');
+        scope[variable] = isNaN(parsedValue) ? 0 : parsedValue;
+    }
+    try {
+        const compiled = math.compile(expression);
+        const result = compiled.evaluate(scope);
+        if (math.typeOf(result) === 'Unit') {
+            return result.toNumber(defaultUnit);
+        }
+        return result;
+    }
+    catch (err) {
+        console.error(`Formula evaluation failed:`, err);
+        return 'Error';
+    }
+}

package/dist/utils/measurementKind.d.ts

@@ -0,0 +1,22 @@
+import { MeasurementType } from '../types/firestore.js';
+/**
+ * Angle and Number are BARE SCALARS: `value` is stored exactly as entered
+ * (signed degrees / a unitless decimal) and must never go through the
+ * micrometer parser or formatter. Only Length is micrometers — including a
+ * legacy doc with no `type` at all, which predates the field.
+ *
+ * These exist because the shorthand for "is this a length" was
+ * `type !== MeasurementType.Angle`. That read correctly while the enum had two
+ * members and became wrong the moment it gained a third: a unitless `25` fell
+ * into the length branch and rendered as `0 in`. Prefer these over an inline
+ * comparison so the next member added is a one-file change.
+ */
+export declare const isLengthMeasurement: (type?: MeasurementType) => boolean;
+/** Angle or Number — a value shown as-is, with no unit conversion. */
+export declare const isScalarMeasurement: (type?: MeasurementType) => boolean;
+/**
+ * The unit mark shown alongside a scalar value. Numbers are unitless by
+ * definition, so this is empty for them — callers must not substitute the
+ * user's selected unit.
+ */
+export declare const scalarValueSuffix: (type?: MeasurementType) => string;

package/dist/utils/measurementKind.js

@@ -0,0 +1,22 @@
+import { MeasurementType } from '../types/firestore.js';
+/**
+ * Angle and Number are BARE SCALARS: `value` is stored exactly as entered
+ * (signed degrees / a unitless decimal) and must never go through the
+ * micrometer parser or formatter. Only Length is micrometers — including a
+ * legacy doc with no `type` at all, which predates the field.
+ *
+ * These exist because the shorthand for "is this a length" was
+ * `type !== MeasurementType.Angle`. That read correctly while the enum had two
+ * members and became wrong the moment it gained a third: a unitless `25` fell
+ * into the length branch and rendered as `0 in`. Prefer these over an inline
+ * comparison so the next member added is a one-file change.
+ */
+export const isLengthMeasurement = (type) => (type ?? MeasurementType.Length) === MeasurementType.Length;
+/** Angle or Number — a value shown as-is, with no unit conversion. */
+export const isScalarMeasurement = (type) => !isLengthMeasurement(type);
+/**
+ * The unit mark shown alongside a scalar value. Numbers are unitless by
+ * definition, so this is empty for them — callers must not substitute the
+ * user's selected unit.
+ */
+export const scalarValueSuffix = (type) => type === MeasurementType.Angle ? '°' : '';

package/dist/utils/measurementSort.d.ts

@@ -0,0 +1,2 @@
+import type { Measurement } from '../types/firestore.js';
+export declare const sortMeasurementsByCompleted: (groupMeasurements: Measurement[]) => Measurement[];

package/dist/utils/measurementSort.js

@@ -0,0 +1,45 @@
+// Firestore Timestamp doesn't support relational comparison operators, which
+// silently degrades sort comparators to insertion order. The shared model
+// types createdAt as Date, but both apps deliver Timestamps at runtime — read
+// via the methods Timestamps actually expose.
+const createdAtMillis = (createdAt) => {
+    if (createdAt == null)
+        return 0;
+    if (createdAt instanceof Date)
+        return createdAt.getTime();
+    const ts = createdAt;
+    if (typeof ts.toMillis === 'function')
+        return ts.toMillis();
+    if (typeof ts.seconds === 'number') {
+        return ts.seconds * 1000 + Math.floor((ts.nanoseconds ?? 0) / 1e6);
+    }
+    return 0;
+};
+// Canonical display order for a LIST group's measurements, shared by
+// rock-desktop and rock-pro-app so cards, tables and exports all agree:
+// incomplete first, then by capture time. Callers that hide completed
+// measurements filter at render time — completed entries sort to the tail, so
+// the visible positional indexes are unaffected either way.
+export const sortMeasurementsByCompleted = (groupMeasurements) => {
+    return [...groupMeasurements].sort((a, b) => {
+        const isCompletedA = a.isCompleted === true;
+        const isCompletedB = b.isCompleted === true;
+        if (isCompletedA !== isCompletedB)
+            return isCompletedA ? 1 : -1;
+        const ms = createdAtMillis(a.createdAt) - createdAtMillis(b.createdAt);
+        if (ms !== 0)
+            return ms;
+        // Synced floods collapse createdAt into a millisecond-wide window and
+        // legacy data has identical timestamps for whole batches. Device capture
+        // sequence is the right tiebreaker — it's monotonic per device session.
+        const aNum = a.deviceMeasurementNumber;
+        const bNum = b.deviceMeasurementNumber;
+        if (aNum != null && bNum != null)
+            return aNum - bNum;
+        if (aNum != null)
+            return -1;
+        if (bNum != null)
+            return 1;
+        return 0;
+    });
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reekon-tools/boldr-utils",
-  "version": "1.16.0",
+  "version": "1.17.1",
   "description": "Shared utilities for formulas and measurement conversion used in Reekon apps",
   "author": "REEKON Tools",
   "license": "MIT",
@@ -24,6 +24,11 @@
       "import": "./dist/theme/colors.js",
       "default": "./dist/theme/colors.js"
     },
+    "./server": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js",
+      "default": "./dist/server.js"
+    },
     "./package.json": "./package.json"
   },
   "scripts": {