@reekon-tools/boldr-utils 1.9.5 → 1.9.6

package/dist/calculator/units.d.ts

@@ -16,13 +16,34 @@ export interface CalculatorUnitInfo {
     mathUnit: string;
     /** Short display label, e.g. 'ft³'. */
     label: string;
+    /**
+     * Disambiguating suffix for the length units that share a `label`. Decimal
+     * and fractional inches are distinct display units but both read as 'in'
+     * (and both feet-inches units as 'ft-in'), so a picker listing a field's
+     * allowed units shows two identical-looking rows without this.
+     */
+    qualifier?: 'dec' | 'frac';
 }
 export declare const CALCULATOR_UNIT_INFO: Record<CalculatorUnit, CalculatorUnitInfo>;
 /** The math.js token for a dimension's canonical unit. '' for dimensionless. */
 export declare const canonicalMathUnit: (dimension: FieldDimension) => string;
 export declare const unitDimension: (unit: CalculatorUnit) => FieldDimension;
 export declare const unitsForDimension: (dimension: FieldDimension) => CalculatorUnit[];
-/** Short label for a unit ('ft³', 'in', '°'). */
+/**
+ * A unit's token and its disambiguating qualifier as separate pieces. The
+ * compact unit chip is fixed-width, so it stacks the qualifier beneath the
+ * token instead of widening; everything else wants the joined form below.
+ * `qualifier` is null for every unit that isn't ambiguous.
+ */
+export declare const calculatorUnitLabelParts: (unit: CalculatorUnit) => {
+    label: string;
+    qualifier: string | null;
+};
+/**
+ * Short label for a unit ('ft³', 'in frac', '°'). Note this is the label a
+ * user PICKS a unit by — `formatCanonical` keeps returning the bare token, so
+ * a rendered value stays "12 1/2 in", not "12 1/2 in frac".
+ */
 export declare const calculatorUnitLabel: (unit: CalculatorUnit) => string;
 /** Convert a display-unit numeric value to the dimension's canonical unit. */
 export declare const toCanonical: (value: number, unit: CalculatorUnit) => number;

package/dist/calculator/units.js

@@ -7,22 +7,30 @@ const LENGTH_UNIT_INFO = {
     [Units.Millimeters]: { dimension: 'length', mathUnit: 'mm', label: 'mm' },
     [Units.Centimeters]: { dimension: 'length', mathUnit: 'cm', label: 'cm' },
     [Units.Meters]: { dimension: 'length', mathUnit: 'm', label: 'm' },
-    [Units.Inches]: { dimension: 'length', mathUnit: 'in', label: 'in' },
+    [Units.Inches]: {
+        dimension: 'length',
+        mathUnit: 'in',
+        label: 'in',
+        qualifier: 'dec',
+    },
     [Units.FractionalInches]: {
         dimension: 'length',
         mathUnit: 'in',
         label: 'in',
+        qualifier: 'frac',
     },
     [Units.Feet]: { dimension: 'length', mathUnit: 'ft', label: 'ft' },
     [Units.FeetInchesDecimal]: {
         dimension: 'length',
         mathUnit: 'ft',
         label: 'ft-in',
+        qualifier: 'dec',
     },
     [Units.FeetInchesFractional]: {
         dimension: 'length',
         mathUnit: 'ft',
         label: 'ft-in',
+        qualifier: 'frac',
     },
 };
 export const CALCULATOR_UNIT_INFO = {
@@ -61,10 +69,30 @@ export const canonicalMathUnit = (dimension) => {
 };
 export const unitDimension = (unit) => CALCULATOR_UNIT_INFO[unit]?.dimension ?? 'none';
 export const unitsForDimension = (dimension) => Object.keys(CALCULATOR_UNIT_INFO).filter((u) => CALCULATOR_UNIT_INFO[u].dimension === dimension);
-/** Short label for a unit ('ft³', 'in', '°'). */
+/**
+ * A unit's token and its disambiguating qualifier as separate pieces. The
+ * compact unit chip is fixed-width, so it stacks the qualifier beneath the
+ * token instead of widening; everything else wants the joined form below.
+ * `qualifier` is null for every unit that isn't ambiguous.
+ */
+export const calculatorUnitLabelParts = (unit) => {
+    const info = CALCULATOR_UNIT_INFO[unit];
+    if (!info) {
+        return {
+            label: convertUnitsToReadableShort(unit) ?? String(unit),
+            qualifier: null,
+        };
+    }
+    return { label: info.label, qualifier: info.qualifier ?? null };
+};
+/**
+ * Short label for a unit ('ft³', 'in frac', '°'). Note this is the label a
+ * user PICKS a unit by — `formatCanonical` keeps returning the bare token, so
+ * a rendered value stays "12 1/2 in", not "12 1/2 in frac".
+ */
 export const calculatorUnitLabel = (unit) => {
-    const lengthLabel = convertUnitsToReadableShort(unit);
-    return CALCULATOR_UNIT_INFO[unit]?.label ?? lengthLabel ?? String(unit);
+    const { label, qualifier } = calculatorUnitLabelParts(unit);
+    return qualifier ? `${label} ${qualifier}` : label;
 };
 // All units here are pure scale factors relative to their canonical unit
 // (no affine offsets like °F), so conversion is a cached multiply.

package/package.json

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