@reekon-tools/boldr-utils 1.21.0 → 1.22.0

package/dist/formulas/groupFormula.js

@@ -0,0 +1,168 @@
+// A LIST group's batch formula, applied to one measurement value — the
+// evaluation every tile that shows a group-formula'd measurement performs.
+//
+// Ported from the two apps' `lib/calculator.ts` (`applyFormulaToMeasurement` +
+// `arrayToExpression`), which are byte-for-byte duplicates of each other, so
+// the server-side PDF export shows the same value the screens do. Kept
+// deliberately narrow: only the frame kinds a GROUP formula can hold. The
+// calculator's inspection-input frames are not group-formula content and are
+// emitted as an empty token here, exactly as the apps' `default:` branch does.
+import { create, all } from 'mathjs';
+import { Units } from '../types/firestore.js';
+const math = create(all);
+const MICROMETERS_PER_IN = 25400;
+const MICROMETERS_PER_FT = 304800;
+const MICROMETERS_PER_MM = 1000;
+const MICROMETERS_PER_CM = 10000;
+const MICROMETERS_PER_M = 1000000;
+/** Frame types of the stack-expression formula the apps persist. */
+export var GroupFormulaFrameType;
+(function (GroupFormulaFrameType) {
+    GroupFormulaFrameType["Operator"] = "operator";
+    GroupFormulaFrameType["Number"] = "number";
+    GroupFormulaFrameType["Paren"] = "paren";
+    GroupFormulaFrameType["Fraction"] = "fraction";
+    GroupFormulaFrameType["FeetInches"] = "feetInches";
+    GroupFormulaFrameType["MeasurementObj"] = "measurement";
+    GroupFormulaFrameType["InspectionInput"] = "InspectionInput";
+    GroupFormulaFrameType["Func"] = "func";
+    GroupFormulaFrameType["Output"] = "output";
+})(GroupFormulaFrameType || (GroupFormulaFrameType = {}));
+const toNumber = (v) => {
+    const n = parseInt(v, 10);
+    return Number.isNaN(n) ? 0 : n;
+};
+const fractionToDecimal = (f) => {
+    const numerator = parseInt(f.numerator, 10);
+    const denominator = parseInt(f.denominator, 10);
+    let frac = 0;
+    if (!(Number.isNaN(numerator) && Number.isNaN(denominator))) {
+        const den = Number.isNaN(denominator) ? 0 : denominator;
+        frac =
+            den === 0
+                ? 0
+                : math.number(math.fraction(Number.isNaN(numerator) ? 0 : numerator, den));
+    }
+    return frac + toNumber(f.int);
+};
+const feetInchesToDecimalFeet = (v) => {
+    const feet = parseInt(v.feet, 10);
+    const inchInt = parseInt(v.int, 10);
+    const numerator = parseInt(v.numerator, 10);
+    const denominator = parseInt(v.denominator, 10);
+    const inchFrac = !Number.isNaN(numerator) && !Number.isNaN(denominator) && denominator > 0
+        ? math.number(math.fraction(numerator, denominator))
+        : 0;
+    const inches = (Number.isNaN(inchInt) ? 0 : inchInt) + inchFrac;
+    const sign = v.feet.trim().startsWith('-') ? -1 : 1;
+    return (Number.isNaN(feet) ? 0 : feet) + (sign * inches) / 12;
+};
+/** Composite feet-inches units evaluate in decimal feet; everything else as-is. */
+const evaluationUnit = (u) => {
+    if (!u)
+        return Units.Inches;
+    return u === Units.FeetInchesDecimal || u === Units.FeetInchesFractional
+        ? Units.Feet
+        : u;
+};
+export const micrometersToUnitNumber = (um, unit) => {
+    switch (unit) {
+        case Units.Millimeters:
+            return um / MICROMETERS_PER_MM;
+        case Units.Centimeters:
+            return um / MICROMETERS_PER_CM;
+        case Units.Meters:
+            return um / MICROMETERS_PER_M;
+        case Units.Feet:
+        case Units.FeetInchesDecimal:
+        case Units.FeetInchesFractional:
+            return um / MICROMETERS_PER_FT;
+        case Units.Inches:
+        case Units.FractionalInches:
+            return um / MICROMETERS_PER_IN;
+        default:
+            return NaN;
+    }
+};
+export const unitNumberToMicrometers = (value, unit) => {
+    switch (unit) {
+        case Units.Millimeters:
+            return value * MICROMETERS_PER_MM;
+        case Units.Centimeters:
+            return value * MICROMETERS_PER_CM;
+        case Units.Meters:
+            return value * MICROMETERS_PER_M;
+        case Units.Feet:
+        case Units.FeetInchesDecimal:
+        case Units.FeetInchesFractional:
+            return value * MICROMETERS_PER_FT;
+        case Units.Inches:
+        case Units.FractionalInches:
+            return value * MICROMETERS_PER_IN;
+        default:
+            return NaN;
+    }
+};
+const findLastIndex = (arr, pred) => {
+    for (let i = arr.length - 1; i >= 0; i--)
+        if (pred(arr[i]))
+            return i;
+    return -1;
+};
+/** The mathjs expression string a stack formula evaluates to, for `valueUm`. */
+export const groupFormulaExpression = (frames, valueUm, unit) => {
+    const outputIndex = findLastIndex(frames, (f) => f.type === GroupFormulaFrameType.Output);
+    const sliced = outputIndex === -1 ? frames : frames.slice(outputIndex);
+    const evalUnit = evaluationUnit(unit);
+    return sliced
+        .map((item) => {
+        switch (item.type) {
+            case GroupFormulaFrameType.Fraction:
+                return String(fractionToDecimal(item.value));
+            case GroupFormulaFrameType.FeetInches:
+                return String(feetInchesToDecimalFeet(item.value));
+            case GroupFormulaFrameType.Number:
+            case GroupFormulaFrameType.Operator:
+            case GroupFormulaFrameType.Paren:
+            case GroupFormulaFrameType.Output:
+                return String(item.value ?? '');
+            case GroupFormulaFrameType.MeasurementObj:
+                // The measurement frame stands for THE measurement being displayed.
+                return String(micrometersToUnitNumber(valueUm, evalUnit));
+            case GroupFormulaFrameType.Func: {
+                const funcValue = String(item.value ?? '');
+                const m = item.measurement;
+                if (m && typeof m.value === 'number') {
+                    const converted = micrometersToUnitNumber(m.value, evalUnit);
+                    return funcValue.replace(m.value.toString(), converted.toString());
+                }
+                return funcValue;
+            }
+            default:
+                return '';
+        }
+    })
+        .join(' ');
+};
+/**
+ * Apply a group's stored `formula` to a measurement value (micrometers) and
+ * return the result in micrometers, or null when the group has no formula or
+ * the expression does not evaluate to a finite number (the caller falls back
+ * to the raw value, exactly like the tiles do).
+ */
+export const applyGroupFormulaUm = (formula, valueUm, unit) => {
+    if (!Array.isArray(formula) || formula.length === 0)
+        return null;
+    const expression = groupFormulaExpression(formula, valueUm, unit);
+    let result;
+    try {
+        result = math.evaluate(expression);
+    }
+    catch {
+        return null;
+    }
+    if (typeof result !== 'number' || !Number.isFinite(result))
+        return null;
+    const um = unitNumberToMicrometers(result, evaluationUnit(unit));
+    return Number.isFinite(um) ? um : null;
+};

package/dist/server.d.ts

@@ -15,3 +15,6 @@ export { desktopBaseUrlForFirebaseProject, desktopFileEditorUrl, type DesktopLin
 export { numberToLetterIndex, formGroupInputLabel, listGroupMeasurementLabel, } from './utils/indexLabels.js';
 export { toSelectedValues, formatSelectedValues, toStoredValue, } from './utils/selectValues.js';
 export * from './calculator/index.js';
+export * from './export/pdf/index.js';
+export { applyGroupFormulaUm, groupFormulaExpression, micrometersToUnitNumber, unitNumberToMicrometers, type GroupFormulaFrame, } from './formulas/groupFormula.js';
+export { MEASUREMENT_LINE_COLOR, MEASUREMENT_LINE_WIDTH, MEASUREMENT_RECT_WIDTH, } from './annotation/canvas/measurementLineStyle.js';

package/dist/server.js

@@ -20,3 +20,8 @@ export { desktopBaseUrlForFirebaseProject, desktopFileEditorUrl, } from './expor
 export { numberToLetterIndex, formGroupInputLabel, listGroupMeasurementLabel, } from './utils/indexLabels.js';
 export { toSelectedValues, formatSelectedValues, toStoredValue, } from './utils/selectValues.js';
 export * from './calculator/index.js';
+// Canvas → annotated PDF export (Cloud Function renderer). Pure pdf-lib; no
+// React or Skia anywhere in its import graph.
+export * from './export/pdf/index.js';
+export { applyGroupFormulaUm, groupFormulaExpression, micrometersToUnitNumber, unitNumberToMicrometers, } from './formulas/groupFormula.js';
+export { MEASUREMENT_LINE_COLOR, MEASUREMENT_LINE_WIDTH, MEASUREMENT_RECT_WIDTH, } from './annotation/canvas/measurementLineStyle.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reekon-tools/boldr-utils",
-  "version": "1.21.0",
+  "version": "1.22.0",
   "description": "Shared utilities for formulas and measurement conversion used in Reekon apps",
   "author": "REEKON Tools",
   "license": "MIT",
@@ -47,7 +47,9 @@
   "keywords": [],
   "repository": "https://gitlab.com/reekon-tools/software/rock-pro/boldr-utils#",
   "dependencies": {
+    "@pdf-lib/fontkit": "1.1.1",
     "mathjs": "^11.11.0",
+    "pdf-lib": "1.17.1",
     "zod": "^4.4.3"
   },
   "peerDependencies": {
@@ -70,6 +72,7 @@
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.1",
+    "@embedpdf/pdfium": "2.15.0",
     "@shopify/react-native-skia": "^2.6.2",
     "@types/node": "^22.15.18",
     "@types/react": "^19.0.8",