@reekon-tools/boldr-utils 1.26.0 → 1.26.1

package/dist/exports.d.ts

@@ -1,6 +1,6 @@
 export { evaluateFormula, createFormulaScope, createEnhancedFormulaScope, clearFormulaCache, micrometersToUnitNumber, type EnhancedMapping, type FormulaDefinition, type FormulaEvaluationOptions, } from './formulas/evaluateFormula.js';
 export { calculateFormula } from './formulas/calculateFormula.js';
-export { convertMicrometers } from './utils/micrometersToUnit.js';
+export { convertMicrometers, resultDisplayUnit, } from './utils/micrometersToUnit.js';
 export { parseMeasurement } from './utils/parseMeasurement.js';
 export { useParseMeasurement } from './utils/useParseMeasurement.js';
 export * from './types/firestore.js';

package/dist/exports.js

@@ -4,7 +4,7 @@
 // AnnotationCanvas import.
 export { evaluateFormula, createFormulaScope, createEnhancedFormulaScope, clearFormulaCache, micrometersToUnitNumber, } from './formulas/evaluateFormula.js';
 export { calculateFormula } from './formulas/calculateFormula.js';
-export { convertMicrometers } from './utils/micrometersToUnit.js';
+export { convertMicrometers, resultDisplayUnit, } from './utils/micrometersToUnit.js';
 export { parseMeasurement } from './utils/parseMeasurement.js';
 export { useParseMeasurement } from './utils/useParseMeasurement.js';
 export * from './types/firestore.js';

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export * from './exports.js';
 export { evaluateFormula, createFormulaScope, createEnhancedFormulaScope, clearFormulaCache, micrometersToUnitNumber, type EnhancedMapping, type FormulaDefinition, type FormulaEvaluationOptions, } from './formulas/evaluateFormula.js';
 export { calculateFormula } from './formulas/calculateFormula.js';
-export { convertMicrometers } from './utils/micrometersToUnit.js';
+export { convertMicrometers, resultDisplayUnit, } from './utils/micrometersToUnit.js';
 export { parseMeasurement } from './utils/parseMeasurement.js';
 export { useParseMeasurement } from './utils/useParseMeasurement.js';
 export * from './types/firestore.js';

package/dist/index.js

@@ -5,7 +5,7 @@
 export * from './exports.js';
 export { evaluateFormula, createFormulaScope, createEnhancedFormulaScope, clearFormulaCache, micrometersToUnitNumber, } from './formulas/evaluateFormula.js';
 export { calculateFormula } from './formulas/calculateFormula.js';
-export { convertMicrometers } from './utils/micrometersToUnit.js';
+export { convertMicrometers, resultDisplayUnit, } from './utils/micrometersToUnit.js';
 export { parseMeasurement } from './utils/parseMeasurement.js';
 export { useParseMeasurement } from './utils/useParseMeasurement.js';
 export * from './types/firestore.js';

package/dist/server.d.ts

@@ -1,6 +1,6 @@
 export { evaluateFormula, createFormulaScope, createEnhancedFormulaScope, clearFormulaCache, micrometersToUnitNumber, type EnhancedMapping, type FormulaDefinition, type FormulaEvaluationOptions, } from './formulas/evaluateFormula.js';
 export { calculateFormula } from './formulas/calculateFormula.js';
-export { convertMicrometers } from './utils/micrometersToUnit.js';
+export { convertMicrometers, resultDisplayUnit, } from './utils/micrometersToUnit.js';
 export { parseMeasurement } from './utils/parseMeasurement.js';
 export * from './types/firestore.js';
 export * from './types/layout.js';

package/dist/server.js

@@ -5,7 +5,7 @@
 // in their import graph may be re-exported from this file.
 export { evaluateFormula, createFormulaScope, createEnhancedFormulaScope, clearFormulaCache, micrometersToUnitNumber, } from './formulas/evaluateFormula.js';
 export { calculateFormula } from './formulas/calculateFormula.js';
-export { convertMicrometers } from './utils/micrometersToUnit.js';
+export { convertMicrometers, resultDisplayUnit, } from './utils/micrometersToUnit.js';
 export { parseMeasurement } from './utils/parseMeasurement.js';
 export * from './types/firestore.js';
 export * from './types/layout.js';

package/dist/types/firestore.d.ts

@@ -435,6 +435,15 @@ interface ColumnConfigBase {
 export type ColumnConfig = ColumnConfigBase & ({
     type: ColumnType.Formula;
     columnData: FormulaColumnData;
+    /**
+     * Renders the computed result in the decimal/fractional counterpart
+     * of each viewer's unit (in_frac ⇄ in, ft_in_frac ⇄ ft_in_decimal;
+     * no-op for units with no counterpart). Absent = follow the unit's
+     * own format. Lives on the union member — NOT inside columnData,
+     * which every formula-editor save rebuilds wholesale. Clearing
+     * removes the key.
+     */
+    resultDisplay?: 'decimal' | 'fractional';
 } | {
     type: ColumnType.SingleSelect;
     columnData: SelectColumnData;

package/dist/utils/micrometersToUnit.d.ts

@@ -1,4 +1,15 @@
 import { DecimalTolerance, FractionalTolerance, Units } from '../types/firestore.js';
+/**
+ * The display unit for a formula column's result under its per-column
+ * decimal/fractional switch. Fraction-vs-decimal is decided entirely by the
+ * Units value (convertMicrometers has no format parameter), so the switch is
+ * a substitution between same-scale counterparts: in_frac ⇄ in and
+ * ft_in_frac ⇄ ft_in_decimal. Units with no counterpart — metric, and plain
+ * ft (the enum has no fractional-feet form) — pass through unchanged, so the
+ * setting is a no-op for those viewers. Same physical scale both ways: this
+ * can never change a computed number, only its rendering.
+ */
+export declare const resultDisplayUnit: (unit: Units, resultDisplay?: "decimal" | "fractional") => Units;
 export declare const roundToT1Values: (value: number, u: Units) => number;
 export declare const convertMicrometers: (micrometers: number | null | undefined, unit: Units, fractionalTolerance?: FractionalTolerance, decimalTolerance?: DecimalTolerance, device?: string) => {
     value: string;

package/dist/utils/micrometersToUnit.js

@@ -1,6 +1,33 @@
 import { DecimalTolerance, FractionalTolerance, Units, convertUnitsToReadable, } from '../types/firestore.js';
 import { create, all } from 'mathjs';
 const math = create(all);
+/**
+ * The display unit for a formula column's result under its per-column
+ * decimal/fractional switch. Fraction-vs-decimal is decided entirely by the
+ * Units value (convertMicrometers has no format parameter), so the switch is
+ * a substitution between same-scale counterparts: in_frac ⇄ in and
+ * ft_in_frac ⇄ ft_in_decimal. Units with no counterpart — metric, and plain
+ * ft (the enum has no fractional-feet form) — pass through unchanged, so the
+ * setting is a no-op for those viewers. Same physical scale both ways: this
+ * can never change a computed number, only its rendering.
+ */
+export const resultDisplayUnit = (unit, resultDisplay) => {
+    if (resultDisplay === 'decimal') {
+        if (unit === Units.FractionalInches)
+            return Units.Inches;
+        if (unit === Units.FeetInchesFractional)
+            return Units.FeetInchesDecimal;
+        return unit;
+    }
+    if (resultDisplay === 'fractional') {
+        if (unit === Units.Inches)
+            return Units.FractionalInches;
+        if (unit === Units.FeetInchesDecimal)
+            return Units.FeetInchesFractional;
+        return unit;
+    }
+    return unit;
+};
 // The T1 rounds differently depending on the selected measurement unit.
 // This function mirrors the rounding behavior implemented on the firmware.
 // The value being rounded is in microns.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reekon-tools/boldr-utils",
-  "version": "1.26.0",
+  "version": "1.26.1",
   "description": "Shared utilities for formulas and measurement conversion used in Reekon apps",
   "author": "REEKON Tools",
   "license": "MIT",