@lhncbc/ucum-lhc 4.1.2 → 4.1.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lhncbc/ucum-lhc",
-  "version": "4.1.2",
+  "version": "4.1.5",
   "description": "Implements Unified Code for Units of Measure (UCUM) functions in a javascript library",
   "main": "source-cjs/ucumPkg.js",
   "homepage": "https://lhncbc.github.io/ucum-lhc/",
@@ -14,10 +14,10 @@
     "data/ucumDefs.min.json"
   ],
   "dependencies": {
+    "coffeescript": "^2.7.0",
     "csv-parse": "^4.4.6",
     "csv-stringify": "^1.0.4",
     "escape-html": "^1.0.3",
-    "grunt-extract-sourcemap": "^0.1.19",
     "is-integer": "^1.0.6",
     "jsonfile": "^2.2.3",
     "stream": "0.0.2",
@@ -26,7 +26,7 @@
     "xmldoc": "^0.4.0"
   },
   "devDependencies": {
-    "@babel/cli": "^7.2.3",
+    "@babel/cli": "^7.12.13",
     "@babel/core": "^7.3.4",
     "@babel/plugin-transform-modules-commonjs": "^7.8.3",
     "@babel/preset-env": "^7.6.2",
@@ -36,8 +36,7 @@
     "bootstrap": "^4.3.1",
     "bower": "^1.8.8",
     "browserify": "^16.2.3",
-    "browserify-fs": "https://github.com/eight04/browserify-fs#eb6645531326de3",
-    "grunt": "^1.0.4",
+    "grunt": "^1.5.3",
     "grunt-babel": "^8.0.0",
     "grunt-browserify": "^5.0.0",
     "grunt-cli": "^1.2.0",
@@ -45,14 +44,15 @@
     "grunt-contrib-connect": "^2.1.0",
     "grunt-contrib-cssmin": "^3.0.0",
     "grunt-contrib-uglify": "^2.0.0",
+    "grunt-extract-sourcemap": "^0.1.19",
     "grunt-mocha-test": "^0.13.2",
     "grunt-wiredep": "^3.0.1",
     "jit-grunt": "^0.10.0",
-    "mocha": "^5.2.0",
+    "mocha": "^8.2.1",
     "path": "^0.12.7",
     "semver": "^5.5.1",
     "time-grunt": "^1.4.0",
-    "webpack": "^4.41.0",
+    "webpack": "^5.20.2",
     "webpack-cli": "^3.3.9"
   },
   "scripts": {

package/source/dimension.js

@@ -81,7 +81,7 @@ export class Dimension {
    **/
   setElementAt(indexPos, value) {
 
-    if (!Number.isInteger(indexPos) ||
+    if (!isInteger(indexPos) ||
         indexPos < 0 || indexPos >= UC.Ucum.dimLen_) {
       throw(new Error(`Dimension.setElementAt called with an invalid index ` +
       `position (${indexPos})`));
@@ -107,7 +107,7 @@ export class Dimension {
    *   number or is less than 0 or greater than Ucum.dimLen_
    **/
   getElementAt(indexPos) {
-    if (!Number.isInteger(indexPos) ||
+    if (!isInteger(indexPos) ||
         indexPos < 0 || indexPos >= UC.Ucum.dimLen_) {
       throw(new Error(`Dimension.getElementAt called with an invalid index ` +
       `position (${indexPos})`));
@@ -132,8 +132,8 @@ export class Dimension {
    * @throws an error if the property is not found for this Dimension
    */
   getProperty(propertyName) {
-    let uProp = (!(propertyName.endsWith('_'))) ? propertyName + '_' :
-        propertyName ;
+    let uProp = propertyName.charAt(propertyName.length - 1) === '_' ? propertyName : propertyName + '_';
+
     return this[uProp] ;
 
   } // end getProperty

package/source/ucumLhcUtils.js

@@ -8,9 +8,6 @@ var Ucum = require('./config.js').Ucum;
 import {ucumJsonDefs} from './ucumJsonDefs.js';
 var UnitTables = require('./unitTables.js').UnitTables;
 var UnitString = require('./unitString.js').UnitString;
-var Unit = require('./unit.js').Unit;
-var Prefix = require('./prefix.js').Prefix;
-var fs = require('fs');
 
 import * as intUtils_ from "./ucumInternalUtils.js";
 
@@ -495,23 +492,6 @@ export class UcumLhcUtils {
     return [commUnits , retMsg];
   } // end commensurablesList
 
-
-  /**
-   * Creates a file containing a list of the units.  The file is created
-   * in the current directory.
-   */
-  printUnits() {
-
-    // for now, create a list of the units created and save it to a file
-    // for debugging.  This is a temporary file.
-    let utab = UnitTables.getInstance();
-    let uct = utab.unitsCount();
-    let uList = utab.printUnits(true);
-    fs.writeFileSync('JsonUnitsList.txt', uList,
-        {encoding: 'utf8', mode: 0o666, flag: 'w'} );
-  }
-
-
 } // end UcumLhcUtils class
 
 

package/source/ucumXmlDocument.js

@@ -228,7 +228,7 @@ export class UcumXmlDocument {
         attrs['class_'] = curUA.attr.class;
       }
       let valNode = curUA.childNamed('value');
-      if (this.moleCodes_.includes(curUA.attr.Code))
+      if (this.moleCodes_.indexOf(curUA.attr.Code) !== -1)
         attrs['moleExp_'] = 1;
       else
         attrs['moleExp_'] = 0;

package/source/unit.js

@@ -872,8 +872,8 @@ export class Unit {
    * concatenated string.   Basically it checks to see if the string
    * needs to be enclosed either in parentheses or square brackets.
    *
-   * The string is enclosed if it is not a number, does not start with
-   * a parenthesis or square bracket, and includes a period, and asterisk,
+   * The string is enclosed if it is not a number, is not already enclosed in a pair of
+   * parentheses or square brackets, and includes a period, and asterisk,
    * a slash or a blank space.
    *
    * @param str the string
@@ -887,11 +887,10 @@ export class Unit {
       ret = str;
     }
     else {
-      if (str.charAt(0) === '(' || str.charAt(0) === '[') {
+      if (str.charAt(0) === '(' && str.endsWith(')') || str.charAt(0) === '['  && str.endsWith(']')) {
         ret = str;
       }
-      else if (str.includes('.') || str.includes('/') ||
-               str.includes('*') || str.includes(' ')) {
+      else if (/[./* ]/.test(str)) {
         ret = startChar + str + endChar ;
       }
       else {

package/source/unitString.js

@@ -188,7 +188,7 @@ export class UnitString {
       // preceded by a prefix or followed by an operator and another unit.
       let sUnit = null ;
       for (sUnit in Ucum.specUnits_) {
-        while (uStr.includes(sUnit))
+        while (uStr.indexOf(sUnit) !== -1)
           uStr = uStr.replace(sUnit, Ucum.specUnits_[sUnit]);
       }
 
@@ -602,7 +602,7 @@ export class UnitString {
           numRes[2] !== '' && numRes[2].indexOf(this.braceFlag_) !== 0) {
           let dispVal = numRes[2] ;
 
-          if (!endProcessing && numRes[2].includes(this.parensFlag_)) {
+          if (!endProcessing && numRes[2].indexOf(this.parensFlag_) !== -1) {
             let parensback = this._getParensUnit(numRes[2], origString);
             numRes[2] = parensback[0]['csCode_'];
             dispVal = `(${numRes[2]})`;
@@ -643,7 +643,7 @@ export class UnitString {
             n = u1;
             endProcessing = true;
           }
-          else if (Ucum.validOps_.includes(uArray1[n])) {
+          else if (Ucum.validOps_.indexOf(uArray1[n]) !== -1) {
             this.retMsg_.push(`${origString} is not a valid UCUM code. ` +
               `A unit code is missing between${this.openEmph_}` +
               `${theOp}${this.closeEmph_}and${this.openEmph_}` +
@@ -666,7 +666,7 @@ export class UnitString {
               if (numRes2 && numRes2.length === 3 && numRes2[1] !== '' &&
                 numRes2[2] !== '' && numRes2[2].indexOf(this.braceFlag_) !== 0) {
                 let invalidString = numRes2[0];
-                if (!endProcessing && numRes2[2].includes(this.parensFlag_)) {
+                if (!endProcessing && numRes2[2].indexOf(this.parensFlag_) !== -1) {
                   let parensback = this._getParensUnit(numRes2[2], origString);
                   numRes2[2] = parensback[0]['csCode_'];
                   invalidString = `(${numRes2[2]})`;
@@ -1107,7 +1107,7 @@ export class UnitString {
         // whatever text (probably a prefix) goes with the unit string.
         let sUnit = null;
         for (sUnit in Ucum.specUnits_) {
-          if (uCode.includes(Ucum.specUnits_[sUnit]))
+          if (uCode.indexOf(Ucum.specUnits_[sUnit]) !== -1)
             uCode = uCode.replace(Ucum.specUnits_[sUnit], sUnit);
         }
         retUnit = this.utabs_.getUnitByCode(uCode);
@@ -1290,7 +1290,7 @@ export class UnitString {
 
     // Add the warning about annotations - just once.
 
-    if ((this.bracesMsg_) && (!this.retMsg_.includes(this.bracesMsg_)))
+    if (this.bracesMsg_ && this.retMsg_.indexOf(this.bracesMsg_) === -1)
       this.retMsg_.push(this.bracesMsg_);
 
     // If there's no text before or after the annotation, it's probably

package/source/unitTables.js

@@ -7,7 +7,6 @@
  */
 
 var Ucum = require('./config.js').Ucum;
-var fs = require('fs');
 
 class UnitTablesFactory {
 
@@ -709,31 +708,6 @@ class UnitTablesFactory {
     return codeList ;
   }
 
-
-  /**
-   * This creates a list of the synonyms in the unitSynonyms hash.  It writes
-   * it in synonym order and in csv format, and includes the synonym, the number
-   * of units for the synonym, and the list of unit codes for the synonym.
-   * It uses | as a separator rather than a comma, to keep from interfering
-   * with the JSON output for the unit code arrays kept for each synonym.
-   *
-   * @returns outputs to a file named "SynonymsList.txt'
-   */
-  printSynonyms() {
-    let sList = 'synonym|unit count|unit codes\n';
-    let sKeys = Object.keys(this.unitSynonyms_).sort();
-    let sLen = sKeys.length ;
-    for (let s = 0; s < sLen; s++) {
-      let sKey = sKeys[s];
-      let kLen = this.unitSynonyms_[sKey].length;
-      let codes = JSON.stringify(this.unitSynonyms_[sKey]);
-      codes = codes.substring(1, codes.length - 2);
-      sList += sKey + '|' + kLen + '|' + codes + '\n';
-    }
-    fs.writeFileSync('SynonymsList.txt', sList,
-        {encoding: 'utf8', mode: 0o666, flag: 'w'} );
-  } // printSynonyms
-
 } // end UnitTablesFactory
 
 

package/source-cjs/dimension.js

@@ -84,7 +84,7 @@ class Dimension {
 
 
   setElementAt(indexPos, value) {
-    if (!Number.isInteger(indexPos) || indexPos < 0 || indexPos >= UC.Ucum.dimLen_) {
+    if (!isInteger(indexPos) || indexPos < 0 || indexPos >= UC.Ucum.dimLen_) {
       throw new Error(`Dimension.setElementAt called with an invalid index ` + `position (${indexPos})`);
     }
 
@@ -107,7 +107,7 @@ class Dimension {
 
 
   getElementAt(indexPos) {
-    if (!Number.isInteger(indexPos) || indexPos < 0 || indexPos >= UC.Ucum.dimLen_) {
+    if (!isInteger(indexPos) || indexPos < 0 || indexPos >= UC.Ucum.dimLen_) {
       throw new Error(`Dimension.getElementAt called with an invalid index ` + `position (${indexPos})`);
     }
 
@@ -130,7 +130,7 @@ class Dimension {
 
 
   getProperty(propertyName) {
-    let uProp = !propertyName.endsWith('_') ? propertyName + '_' : propertyName;
+    let uProp = propertyName.charAt(propertyName.length - 1) === '_' ? propertyName : propertyName + '_';
     return this[uProp];
   } // end getProperty
 

package/source-cjs/dimension.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../source/dimension.js"],"names":["UC","require","isInteger","Dimension","constructor","dimSetting","Ucum","dimLen_","Error","undefined","assignZero","Array","length","JSON","stringify","dimVec_","d","push","setElementAt","indexPos","value","Number","getElementAt","ret","getProperty","propertyName","uProp","endsWith","toString","join","add","dim2","i","sub","minus","mul","s","equals","isEqual","dimVec2","assignDim","isZero","allZero","isNull","clone","that"],"mappings":"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","sourcesContent":["/**\n * This class implements an object containing the vector of exponents for\n * a unit and its operations for addition, subtraction, and multiplication\n * with a scalar.\n *\n * This object should exist for each unit that can be expressed as a\n * vector of numbers.   This excludes arbitrary units, e.g., (10*23), and\n * units that are not numbers but are an expression based solely on numbers,\n * e.g., mol (mole) which is based on 10*23.\n *\n * @author Lee Mericle, based on java version by Gunther Schadow\n */\nvar UC = require('./config.js');\nvar isInteger = require(\"is-integer\");\nexport class Dimension {\n\n  /**\n   * Constructor.\n   *\n   * @param dimSetting an optional parameter that may be:\n   *  null, which means that the dimVec_ attribute for this object will be null; or\n   *  an array, which must be the length defined by Ucum.dimLen_, and\n   *    whose contents will be copied to this new object's vector; or\n   *  an integer, which must be between 0 and 1 less than the vector length\n   *    defined by Ucum.dimLen_.  This new object's vector will be\n   *    initialized to zero for all elements except the one whose index\n   *    matches the number passed in.  That element will be set to one.\n\n   * @throws an error if the dimSetting parameter does not meet the types\n   *  listed above.\n   *  An error will also be thrown if Ucum.dimLen_ has not been set yet,\n   *  i.e., is still zero.   Currently that won't happen, because the\n   *  value is set in the config.js file.  But further down the road\n   *  the setting will come from a definitions input file, so we check\n   *  here anyway.\n   *\n   */\n  constructor(dimSetting) {\n\n    if (UC.Ucum.dimLen_ === 0) {\n      throw(new Error('Dimension.setDimensionLen must be called before ' +\n      'Dimension constructor'));\n    }\n    if (dimSetting === undefined || dimSetting === null) {\n      this.assignZero() ;\n    }\n    else if (dimSetting instanceof Array) {\n      if (dimSetting.length !== UC.Ucum.dimLen_) {\n        throw(new Error('Parameter error, incorrect length of vector passed to ' +\n            `Dimension constructor, vector = ${JSON.stringify(dimSetting)}`));\n      }\n      this.dimVec_ = [];\n      for (let d = 0; d < UC.Ucum.dimLen_; d++)\n        this.dimVec_.push(dimSetting[d]);\n    }\n\n    // In es6 this should be Number.isInteger(dimSetting).  But Babel\n    // doesn't transpile that correctly, so we need to use the isInteger\n    // module.  :0\n    else if (isInteger(dimSetting)) {\n      if (dimSetting < 0 || dimSetting >= UC.Ucum.dimLen_) {\n        throw(new Error('Parameter error, invalid element number specified for ' +\n        'Dimension constructor'));\n      }\n      this.assignZero() ;\n      this.dimVec_[dimSetting] = 1;\n    }\n  } // end constructor\n\n\n  /**\n   * Sets the element at the specified position to a specified value.  The\n   * default value is 1.  If the dimension vector is null when this is called\n   * a zero-filled vector is created and then the indicated position is set.\n   *\n   * @param indexPos the index of the element to be set\n   * @param value the value to assign to the specified element; optional,\n   *  default value is 1\n   * @throws an exception if the specified position is invalid, i.e., not a\n   *   number or is less than 0 or greater than Ucum.dimLen_\n   **/\n  setElementAt(indexPos, value) {\n\n    if (!Number.isInteger(indexPos) ||\n        indexPos < 0 || indexPos >= UC.Ucum.dimLen_) {\n      throw(new Error(`Dimension.setElementAt called with an invalid index ` +\n      `position (${indexPos})`));\n    }\n\n    if (!this.dimVec_) {\n      this.assignZero();\n    }\n    if (value === undefined || value === null)\n      value = 1 ;\n\n    this.dimVec_[indexPos] = value;\n  }\n\n\n  /**\n   * Gets the value of the element at the specified position\n   *\n   * @param indexPos the index of the element whose value is to be returned\n   * @return the value of the element at indexPos, or null if the dimension\n   *  vector is null\n   * @throws an exception if the specified position is invalid, i.e., not a\n   *   number or is less than 0 or greater than Ucum.dimLen_\n   **/\n  getElementAt(indexPos) {\n    if (!Number.isInteger(indexPos) ||\n        indexPos < 0 || indexPos >= UC.Ucum.dimLen_) {\n      throw(new Error(`Dimension.getElementAt called with an invalid index ` +\n      `position (${indexPos})`));\n    }\n    let ret = null;\n    if (this.dimVec_)\n      ret = this.dimVec_[indexPos];\n    return ret;\n  }\n\n\n  /**\n   * This returns the value of the property named by the parameter\n   * passed in.  Although we currently only have one property, dimVec_,\n   * that this will get, it's possible that we'll have additional\n   * properties.   If we don't this could just be replaced by a\n   * getVector function.\n   *\n   * @param propertyName name of the property to be returned, with\n   *        or without the trailing underscore.\n   * @return the requested property, if found for this Dimension\n   * @throws an error if the property is not found for this Dimension\n   */\n  getProperty(propertyName) {\n    let uProp = (!(propertyName.endsWith('_'))) ? propertyName + '_' :\n        propertyName ;\n    return this[uProp] ;\n\n  } // end getProperty\n\n\n  /**\n   * Return a string that represents the dimension vector.  Returns null if\n   * the dimension vector is null.\n   *\n   * @return the string that represents the dimension vector.  The\n   *         values are enclosed in square brackets, each separated\n   *         by a comma and a space\n   **/\n  toString() {\n    let ret = null ;\n    if (this.dimVec_)\n      ret = '[' + this.dimVec_.join(', ') + ']';\n    return ret ;\n  }\n\n\n  /**\n   * Adds the vector of the dimension object passed in to this\n   * dimension object's vector.  This object's vector is changed.\n   * If either dimension vector is null, no changes are made to this object.\n   *\n   *\n   * @param dim2 the dimension whose vector is to be added to this one\n   * @return this object\n   * @throws an exception if dim2 is not a Dimension object\n   **/\n  add(dim2) {\n    if (!dim2 instanceof Dimension) {\n      throw(new Error(`Dimension.add called with an invalid parameter - ` +\n      `${typeof dim2} instead of a Dimension object`));\n    }\n    if (this.dimVec_ && dim2.dimVec_) {\n      for (let i = 0; i < UC.Ucum.dimLen_; i++)\n        this.dimVec_[i] += dim2.dimVec_[i];\n    }\n    return this;\n  }\n\n\n  /**\n   * Subtracts the vector of the dimension object passed in from this\n   * dimension object's vector.  This object's vector is changed.\n   * If either dimension vector is null, no changes are made to this object.\n   *\n   * @param dim2 the dimension whose vector is to be subtracted from this one\n   * @return this object\n   * @throws an exception if dim2 is not a Dimension object\n   **/\n  sub(dim2) {\n    if (!dim2 instanceof Dimension) {\n      throw(new Error(`Dimension.sub called with an invalid parameter - ` +\n      `${typeof dim2} instead of a Dimension object`));\n    }\n    if (this.dimVec_ && dim2.dimVec_) {\n      for (let i = 0; i < UC.Ucum.dimLen_; i++)\n        this.dimVec_[i] -= dim2.dimVec_[i];\n    }\n    return this;\n  }\n\n\n  /**\n   * Inverts this dimension object's vector (by multiplying each element\n   * by negative 1).  This object's vector is changed - unless it is null,\n   * in which case it stays that way.\n   *\n   * @return this object\n   **/\n  minus() {\n    if (this.dimVec_) {\n      for (let i = 0; i < UC.Ucum.dimLen_; i++)\n        this.dimVec_[i] = -this.dimVec_[i];\n    }\n    return this;\n  }\n\n\n  /**\n   * Multiplies this dimension object's vector with a scalar.  This is used\n   * when a unit is raised to a power.  This object's vector is changed unless\n   * the vector is null, in which case it stays that way.\n   *\n   * @param s the scalar to use\n   * @return this object\n   * @throws an exception if s is not a number\n   */\n  mul(s) {\n    if (!isInteger(s)) {\n      throw(new Error(`Dimension.sub called with an invalid parameter - ` +\n      `${typeof dim2} instead of a number`));\n    }\n    if (this.dimVec_) {\n      for (let i = 0; i < UC.Ucum.dimLen_; i++)\n        this.dimVec_[i] *= s;\n    }\n    return this;\n  }\n\n\n  /**\n   * Tests for equality of this dimension object's vector and that of\n   * the dimension object passed in.  If the dimension vector for one of\n   * the objects is null, the dimension vector for the other object must\n   * also be null for the two to be equal.  (I know - duh.  still)\n   *\n   * @param dim2 the dimension object whose vector is to be compared to this one\n   * @return true if the two vectors are equal; false otherwise.\n   * @throws an exception if dim2 is not a Dimension object\n   */\n  equals(dim2) {\n    if (!dim2 instanceof Dimension) {\n      throw(new Error(`Dimension.equals called with an invalid parameter - ` +\n      `${typeof dim2} instead of a Dimension object`));\n    }\n    let isEqual = true ;\n    let dimVec2 = dim2.dimVec_;\n    if (this.dimVec_ && dimVec2) {\n      for (let i = 0; isEqual && i < UC.Ucum.dimLen_; i++)\n        isEqual = (this.dimVec_[i] === dimVec2[i]);\n    }\n    else {\n      isEqual = (this.dimVec_ === null && dimVec2 === null);\n    }\n    return isEqual;\n  }\n\n\n  /**\n   * Assigns the contents of the vector belonging to the dimension object\n   * passed in to this dimension's vector.  If this dimension vector is null\n   * and the other is not, this one will get the contents of the other.  If\n   * this dimension vector is not null but the one passed in is null, this\n   * one will be set to null.\n   *\n   * @param dim2 the dimension object with the vector whose contents are\n   *  to be assigned to this dimension's vector\n   * @return this object (not sure why)\n   * @throws an exception if dim2 is not a Dimension object\n   */\n  assignDim(dim2) {\n\n    if (!dim2 instanceof Dimension) {\n      throw(new Error(`Dimension.assignDim called with an invalid parameter - ` +\n      `${typeof dim2} instead of a Dimension object`));\n    }\n    if (dim2.dimVec_ === null)\n      this.dimVec_ = null;\n    else {\n      if (this.dimVec_ === null) {\n        this.dimVec_ = [] ;\n      }\n      for (let i = 0; i < UC.Ucum.dimLen_; i++)\n        this.dimVec_[i] = dim2.dimVec_[i];\n    }\n    return this;\n  }\n\n\n  /**\n   * Sets all elements of this dimension object's vector to zero.\n   * If this object's vector is null, it is created as a zero-filled vector.\n   *\n   * @return this object (not sure why)\n   */\n  assignZero() {\n    if (this.dimVec_ === null || this.dimVec_ === undefined)\n      this.dimVec_ = [];\n\n    for (let i = 0; i < UC.Ucum.dimLen_; i++) {\n      this.dimVec_.push(0);\n    }\n    return this;\n  }\n\n\n  /**\n   * Tests for a dimension vector set to all zeroes.\n   *\n   * @return true if exponents (elements) of this dimension's vector are all\n   * zero; false otherwise (including if the current vector is null).\n   *\n   */\n  isZero() {\n    let allZero = this.dimVec_ !== null ;\n    if (this.dimVec_) {\n      for (let i = 0; allZero && i < UC.Ucum.dimLen_; i++)\n        allZero = this.dimVec_[i] === 0;\n    }\n    return allZero;\n  }\n\n\n  /**\n   * Tests for a Dimension object with no dimension vector (dimVec_ is null).\n   *\n   * @return true the dimension vector is null; false if it is not\n   *\n   */\n  isNull() {\n    return (this.dimVec_ === null);\n  }\n\n\n  /**\n   * Creates and returns a clone of this Dimension object\n   *\n   * @return the clone\n   */\n  clone() {\n    let that = new Dimension();\n    that.assignDim(this);\n    return that;\n  }\n\n} // end Dimension class\n"],"file":"dimension.js"}
+{"version":3,"sources":["../source/dimension.js"],"names":["UC","require","isInteger","Dimension","constructor","dimSetting","Ucum","dimLen_","Error","undefined","assignZero","Array","length","JSON","stringify","dimVec_","d","push","setElementAt","indexPos","value","getElementAt","ret","getProperty","propertyName","uProp","charAt","toString","join","add","dim2","i","sub","minus","mul","s","equals","isEqual","dimVec2","assignDim","isZero","allZero","isNull","clone","that"],"mappings":"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","sourcesContent":["/**\n * This class implements an object containing the vector of exponents for\n * a unit and its operations for addition, subtraction, and multiplication\n * with a scalar.\n *\n * This object should exist for each unit that can be expressed as a\n * vector of numbers.   This excludes arbitrary units, e.g., (10*23), and\n * units that are not numbers but are an expression based solely on numbers,\n * e.g., mol (mole) which is based on 10*23.\n *\n * @author Lee Mericle, based on java version by Gunther Schadow\n */\nvar UC = require('./config.js');\nvar isInteger = require(\"is-integer\");\nexport class Dimension {\n\n  /**\n   * Constructor.\n   *\n   * @param dimSetting an optional parameter that may be:\n   *  null, which means that the dimVec_ attribute for this object will be null; or\n   *  an array, which must be the length defined by Ucum.dimLen_, and\n   *    whose contents will be copied to this new object's vector; or\n   *  an integer, which must be between 0 and 1 less than the vector length\n   *    defined by Ucum.dimLen_.  This new object's vector will be\n   *    initialized to zero for all elements except the one whose index\n   *    matches the number passed in.  That element will be set to one.\n\n   * @throws an error if the dimSetting parameter does not meet the types\n   *  listed above.\n   *  An error will also be thrown if Ucum.dimLen_ has not been set yet,\n   *  i.e., is still zero.   Currently that won't happen, because the\n   *  value is set in the config.js file.  But further down the road\n   *  the setting will come from a definitions input file, so we check\n   *  here anyway.\n   *\n   */\n  constructor(dimSetting) {\n\n    if (UC.Ucum.dimLen_ === 0) {\n      throw(new Error('Dimension.setDimensionLen must be called before ' +\n      'Dimension constructor'));\n    }\n    if (dimSetting === undefined || dimSetting === null) {\n      this.assignZero() ;\n    }\n    else if (dimSetting instanceof Array) {\n      if (dimSetting.length !== UC.Ucum.dimLen_) {\n        throw(new Error('Parameter error, incorrect length of vector passed to ' +\n            `Dimension constructor, vector = ${JSON.stringify(dimSetting)}`));\n      }\n      this.dimVec_ = [];\n      for (let d = 0; d < UC.Ucum.dimLen_; d++)\n        this.dimVec_.push(dimSetting[d]);\n    }\n\n    // In es6 this should be Number.isInteger(dimSetting).  But Babel\n    // doesn't transpile that correctly, so we need to use the isInteger\n    // module.  :0\n    else if (isInteger(dimSetting)) {\n      if (dimSetting < 0 || dimSetting >= UC.Ucum.dimLen_) {\n        throw(new Error('Parameter error, invalid element number specified for ' +\n        'Dimension constructor'));\n      }\n      this.assignZero() ;\n      this.dimVec_[dimSetting] = 1;\n    }\n  } // end constructor\n\n\n  /**\n   * Sets the element at the specified position to a specified value.  The\n   * default value is 1.  If the dimension vector is null when this is called\n   * a zero-filled vector is created and then the indicated position is set.\n   *\n   * @param indexPos the index of the element to be set\n   * @param value the value to assign to the specified element; optional,\n   *  default value is 1\n   * @throws an exception if the specified position is invalid, i.e., not a\n   *   number or is less than 0 or greater than Ucum.dimLen_\n   **/\n  setElementAt(indexPos, value) {\n\n    if (!isInteger(indexPos) ||\n        indexPos < 0 || indexPos >= UC.Ucum.dimLen_) {\n      throw(new Error(`Dimension.setElementAt called with an invalid index ` +\n      `position (${indexPos})`));\n    }\n\n    if (!this.dimVec_) {\n      this.assignZero();\n    }\n    if (value === undefined || value === null)\n      value = 1 ;\n\n    this.dimVec_[indexPos] = value;\n  }\n\n\n  /**\n   * Gets the value of the element at the specified position\n   *\n   * @param indexPos the index of the element whose value is to be returned\n   * @return the value of the element at indexPos, or null if the dimension\n   *  vector is null\n   * @throws an exception if the specified position is invalid, i.e., not a\n   *   number or is less than 0 or greater than Ucum.dimLen_\n   **/\n  getElementAt(indexPos) {\n    if (!isInteger(indexPos) ||\n        indexPos < 0 || indexPos >= UC.Ucum.dimLen_) {\n      throw(new Error(`Dimension.getElementAt called with an invalid index ` +\n      `position (${indexPos})`));\n    }\n    let ret = null;\n    if (this.dimVec_)\n      ret = this.dimVec_[indexPos];\n    return ret;\n  }\n\n\n  /**\n   * This returns the value of the property named by the parameter\n   * passed in.  Although we currently only have one property, dimVec_,\n   * that this will get, it's possible that we'll have additional\n   * properties.   If we don't this could just be replaced by a\n   * getVector function.\n   *\n   * @param propertyName name of the property to be returned, with\n   *        or without the trailing underscore.\n   * @return the requested property, if found for this Dimension\n   * @throws an error if the property is not found for this Dimension\n   */\n  getProperty(propertyName) {\n    let uProp = propertyName.charAt(propertyName.length - 1) === '_' ? propertyName : propertyName + '_';\n\n    return this[uProp] ;\n\n  } // end getProperty\n\n\n  /**\n   * Return a string that represents the dimension vector.  Returns null if\n   * the dimension vector is null.\n   *\n   * @return the string that represents the dimension vector.  The\n   *         values are enclosed in square brackets, each separated\n   *         by a comma and a space\n   **/\n  toString() {\n    let ret = null ;\n    if (this.dimVec_)\n      ret = '[' + this.dimVec_.join(', ') + ']';\n    return ret ;\n  }\n\n\n  /**\n   * Adds the vector of the dimension object passed in to this\n   * dimension object's vector.  This object's vector is changed.\n   * If either dimension vector is null, no changes are made to this object.\n   *\n   *\n   * @param dim2 the dimension whose vector is to be added to this one\n   * @return this object\n   * @throws an exception if dim2 is not a Dimension object\n   **/\n  add(dim2) {\n    if (!dim2 instanceof Dimension) {\n      throw(new Error(`Dimension.add called with an invalid parameter - ` +\n      `${typeof dim2} instead of a Dimension object`));\n    }\n    if (this.dimVec_ && dim2.dimVec_) {\n      for (let i = 0; i < UC.Ucum.dimLen_; i++)\n        this.dimVec_[i] += dim2.dimVec_[i];\n    }\n    return this;\n  }\n\n\n  /**\n   * Subtracts the vector of the dimension object passed in from this\n   * dimension object's vector.  This object's vector is changed.\n   * If either dimension vector is null, no changes are made to this object.\n   *\n   * @param dim2 the dimension whose vector is to be subtracted from this one\n   * @return this object\n   * @throws an exception if dim2 is not a Dimension object\n   **/\n  sub(dim2) {\n    if (!dim2 instanceof Dimension) {\n      throw(new Error(`Dimension.sub called with an invalid parameter - ` +\n      `${typeof dim2} instead of a Dimension object`));\n    }\n    if (this.dimVec_ && dim2.dimVec_) {\n      for (let i = 0; i < UC.Ucum.dimLen_; i++)\n        this.dimVec_[i] -= dim2.dimVec_[i];\n    }\n    return this;\n  }\n\n\n  /**\n   * Inverts this dimension object's vector (by multiplying each element\n   * by negative 1).  This object's vector is changed - unless it is null,\n   * in which case it stays that way.\n   *\n   * @return this object\n   **/\n  minus() {\n    if (this.dimVec_) {\n      for (let i = 0; i < UC.Ucum.dimLen_; i++)\n        this.dimVec_[i] = -this.dimVec_[i];\n    }\n    return this;\n  }\n\n\n  /**\n   * Multiplies this dimension object's vector with a scalar.  This is used\n   * when a unit is raised to a power.  This object's vector is changed unless\n   * the vector is null, in which case it stays that way.\n   *\n   * @param s the scalar to use\n   * @return this object\n   * @throws an exception if s is not a number\n   */\n  mul(s) {\n    if (!isInteger(s)) {\n      throw(new Error(`Dimension.sub called with an invalid parameter - ` +\n      `${typeof dim2} instead of a number`));\n    }\n    if (this.dimVec_) {\n      for (let i = 0; i < UC.Ucum.dimLen_; i++)\n        this.dimVec_[i] *= s;\n    }\n    return this;\n  }\n\n\n  /**\n   * Tests for equality of this dimension object's vector and that of\n   * the dimension object passed in.  If the dimension vector for one of\n   * the objects is null, the dimension vector for the other object must\n   * also be null for the two to be equal.  (I know - duh.  still)\n   *\n   * @param dim2 the dimension object whose vector is to be compared to this one\n   * @return true if the two vectors are equal; false otherwise.\n   * @throws an exception if dim2 is not a Dimension object\n   */\n  equals(dim2) {\n    if (!dim2 instanceof Dimension) {\n      throw(new Error(`Dimension.equals called with an invalid parameter - ` +\n      `${typeof dim2} instead of a Dimension object`));\n    }\n    let isEqual = true ;\n    let dimVec2 = dim2.dimVec_;\n    if (this.dimVec_ && dimVec2) {\n      for (let i = 0; isEqual && i < UC.Ucum.dimLen_; i++)\n        isEqual = (this.dimVec_[i] === dimVec2[i]);\n    }\n    else {\n      isEqual = (this.dimVec_ === null && dimVec2 === null);\n    }\n    return isEqual;\n  }\n\n\n  /**\n   * Assigns the contents of the vector belonging to the dimension object\n   * passed in to this dimension's vector.  If this dimension vector is null\n   * and the other is not, this one will get the contents of the other.  If\n   * this dimension vector is not null but the one passed in is null, this\n   * one will be set to null.\n   *\n   * @param dim2 the dimension object with the vector whose contents are\n   *  to be assigned to this dimension's vector\n   * @return this object (not sure why)\n   * @throws an exception if dim2 is not a Dimension object\n   */\n  assignDim(dim2) {\n\n    if (!dim2 instanceof Dimension) {\n      throw(new Error(`Dimension.assignDim called with an invalid parameter - ` +\n      `${typeof dim2} instead of a Dimension object`));\n    }\n    if (dim2.dimVec_ === null)\n      this.dimVec_ = null;\n    else {\n      if (this.dimVec_ === null) {\n        this.dimVec_ = [] ;\n      }\n      for (let i = 0; i < UC.Ucum.dimLen_; i++)\n        this.dimVec_[i] = dim2.dimVec_[i];\n    }\n    return this;\n  }\n\n\n  /**\n   * Sets all elements of this dimension object's vector to zero.\n   * If this object's vector is null, it is created as a zero-filled vector.\n   *\n   * @return this object (not sure why)\n   */\n  assignZero() {\n    if (this.dimVec_ === null || this.dimVec_ === undefined)\n      this.dimVec_ = [];\n\n    for (let i = 0; i < UC.Ucum.dimLen_; i++) {\n      this.dimVec_.push(0);\n    }\n    return this;\n  }\n\n\n  /**\n   * Tests for a dimension vector set to all zeroes.\n   *\n   * @return true if exponents (elements) of this dimension's vector are all\n   * zero; false otherwise (including if the current vector is null).\n   *\n   */\n  isZero() {\n    let allZero = this.dimVec_ !== null ;\n    if (this.dimVec_) {\n      for (let i = 0; allZero && i < UC.Ucum.dimLen_; i++)\n        allZero = this.dimVec_[i] === 0;\n    }\n    return allZero;\n  }\n\n\n  /**\n   * Tests for a Dimension object with no dimension vector (dimVec_ is null).\n   *\n   * @return true the dimension vector is null; false if it is not\n   *\n   */\n  isNull() {\n    return (this.dimVec_ === null);\n  }\n\n\n  /**\n   * Creates and returns a clone of this Dimension object\n   *\n   * @return the clone\n   */\n  clone() {\n    let that = new Dimension();\n    that.assignDim(this);\n    return that;\n  }\n\n} // end Dimension class\n"],"file":"dimension.js"}

package/source-cjs/ucumLhcUtils.js

@@ -25,12 +25,6 @@ var UnitTables = require('./unitTables.js').UnitTables;
 
 var UnitString = require('./unitString.js').UnitString;
 
-var Unit = require('./unit.js').Unit;
-
-var Prefix = require('./prefix.js').Prefix;
-
-var fs = require('fs');
-
 /**
  * UCUM external utilities class
  */
@@ -487,24 +481,6 @@ class UcumLhcUtils {
     return [commUnits, retMsg];
   } // end commensurablesList
 
-  /**
-   * Creates a file containing a list of the units.  The file is created
-   * in the current directory.
-   */
-
-
-  printUnits() {
-    // for now, create a list of the units created and save it to a file
-    // for debugging.  This is a temporary file.
-    let utab = UnitTables.getInstance();
-    let uct = utab.unitsCount();
-    let uList = utab.printUnits(true);
-    fs.writeFileSync('JsonUnitsList.txt', uList, {
-      encoding: 'utf8',
-      mode: 0o666,
-      flag: 'w'
-    });
-  }
 
 } // end UcumLhcUtils class
 

package/source-cjs/ucumLhcUtils.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../source/ucumLhcUtils.js"],"names":["Ucum","require","UnitTables","UnitString","Unit","Prefix","fs","UcumLhcUtils","constructor","getInstance","unitsCount","ucumJsonDefs","loadJsonDefs","uStrParser_","useHTMLInMessages","use","undefined","useBraceMsgForEachString","validateUnitString","uStr","suggest","valConv","resp","getSpecifiedUnit","theUnit","retObj","csCode_","name_","guidance_","convertUnitTo","fromUnitCode","fromVal","toUnitCode","molecularWeight","returnObj","trim","push","isNaN","intUtils_","isNumericString","fromUnit","parseResp","concat","toUnit","convertFrom","moleExp_","Error","isMoleMassCommensurable","convertMolToMass","convertMassToMol","err","message","needMoleWeightMsg_","checkSynonyms","theSyn","getSynonyms","uName","utab","getUnitByCode","parseString","console","log","unshift","commensurablesList","fromName","retMsg","commUnits","length","dimVec","fromDim","getProperty","getUnitsByDimension","printUnits","uct","uList","writeFileSync","encoding","mode","flag"],"mappings":"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","sourcesContent":["/**\n * This class provides a single point of access to the LHC UCUM utilities\n *\n * @author Lee Mericle\n *\n */\nvar Ucum = require('./config.js').Ucum;\nimport {ucumJsonDefs} from './ucumJsonDefs.js';\nvar UnitTables = require('./unitTables.js').UnitTables;\nvar UnitString = require('./unitString.js').UnitString;\nvar Unit = require('./unit.js').Unit;\nvar Prefix = require('./prefix.js').Prefix;\nvar fs = require('fs');\n\nimport * as intUtils_ from \"./ucumInternalUtils.js\";\n\n/**\n * UCUM external utilities class\n */\nexport class UcumLhcUtils {\n\n  /**\n   * Constructor.  This loads the json prefix and unit definitions if\n   * they haven't been loaded already and creates itself as a singleton object.\n   *\n   */\n  constructor() {\n\n      if (UnitTables.getInstance().unitsCount() === 0) {\n\n        // Load the prefix and unit objects\n        ucumJsonDefs.loadJsonDefs();\n      }\n\n      // Get the UnitString parser that will be used with this instance\n      // of the LHC Utilities\n      this.uStrParser_ = UnitString.getInstance();\n\n  } // end constructor\n\n\n  /**\n   * This method calls the useHTMLInMessages method on the UnitString\n   * object.  It should be called by web applications that use\n   * these utilities.\n   *\n   * @param use flag indicating whether or not to use the braces message;\n   *  defaults to true\n   */\n  useHTMLInMessages(use) {\n    if (use === undefined)\n      use = true ;\n    this.uStrParser_.useHTMLInMessages(use);\n  }\n\n\n  /**\n   * This method calls the useBraceMsgForEachString method on the UnitString\n   * object.  It should be called by web applications where unit\n   * strings are validated individually (as opposed to validating a whole\n   * file of unit strings).\n   *\n   * @param use flag indicating whether or not to use the braces message;\n   *  defaults to true\n   */\n  useBraceMsgForEachString(use) {\n    if (use === undefined)\n      use = true ;\n    this.uStrParser_.useBraceMsgForEachString(use);\n  }\n\n\n  /**\n   * This method validates a unit string.  It first checks to see if the\n   * string passed in is a unit code that is found in the unit codes table.\n   * If it is not found it parses the string to see if it resolves to a\n   * valid unit string.\n   *\n   * If a valid unit cannot be found, the string is tested for some common\n   * errors, such as missing brackets or a missing multiplication operator.\n   * If found, the error is reported in the messages array that is returned.\n   *\n   * If a valid unit cannot be found and an error cannot be discerned, this\n   * may return, if requested, a list of suggested units in the messages\n   * array that is returned.  Suggestions are based on matching the expression\n   * with unit names and synonyms.\n   *\n   * @param uStr the string to be validated\n   * @param suggest a boolean to indicate whether or not suggestions are\n   *  requested for a string that cannot be resolved to a valid unit;\n   *  true indicates suggestions are wanted; false indicates they are not,\n   *  and is the default if the parameter is not specified;\n   * @param valConv a string indicating if this validation request was initiated\n   *  by a validation task ('validate') or a conversion task ('convert'),\n   *  used only for the demo code, and the default is 'Validator' if the\n   *  parameter is not specified;\n   * @returns an object with five properties:\n   *  'status' will be 'valid' (the uStr is a valid UCUM code), 'invalid'\n   *     (the uStr is not a valid UCUM code, and substitutions or\n   *     suggestions may or may not be returned, depending on what was\n   *     requested and found); or 'error' (an input or programming error\n   *     occurred);\n   *  'ucumCode' the valid ucum code, which may differ from what was passed\n   *    in (e.g., if 'Gauss' is passed in, this will contain 'G') OR null if\n   *    the string was flagged as invalid or an error occurred;\n   *  'msg' is an array of one or more messages, if the string is invalid or\n   *        an error occurred, indicating the problem, or an explanation of a\n   *        substitution such as the substitution of 'G' for 'Gauss', or\n   *        an empty array if no messages were generated;\n   *  'unit' which is null if no unit is found, or a hash for a unit found:\n   *    'code' is the unit's ucum code (G in the above example;\n   *    'name' is the unit's name (Gauss in the above example); and\n   *    'guidance' is the unit's guidance/description data; and\n   *  'suggestions' if suggestions were requested and found, this is an array\n   *     of one or more hash objects.  Each hash contains three elements:\n   *     'msg' which is a message indicating what part of the uStr input\n   *        parameter the suggestions are for;\n   *     'invalidUnit' which is the unit expression the suggestions are\n   *        for; and\n   *     'units' which is an array of data for each suggested unit found.\n   *        Each array will contain the unit code, the unit name and the\n   *        unit guidance (if any).\n   *     If no suggestions were requested and found, this property is not\n   *     returned.\n   */\n  validateUnitString(uStr, suggest, valConv) {\n\n    if (suggest === undefined)\n      suggest = false ;\n\n    if (valConv === undefined)\n      valConv = 'validate' ;\n\n    let resp = this.getSpecifiedUnit(uStr, valConv, suggest);\n    let theUnit = resp['unit'];\n    let retObj = {};\n    if (!theUnit) {\n      retObj = {'status': (!resp['origString'] || resp['origString'] === null) ?\n                           'error' : 'invalid',\n                'ucumCode': null};\n    }\n    else {\n      retObj = {'status': resp['origString'] === uStr ? 'valid': 'invalid',\n                'ucumCode': resp['origString'],\n                'unit': {'code': theUnit.csCode_,\n                         'name': theUnit.name_,\n                         'guidance': theUnit.guidance_ }};\n    }\n    if (resp['suggestions']) {\n      retObj['suggestions'] = resp['suggestions'];\n    }\n    retObj['msg'] = resp['retMsg'];\n    return retObj;\n\n  } // end validateUnitString\n\n\n  /**\n   * This method converts one unit to another\n   *\n   * @param fromUnitCode the unit code/expression/string of the unit to be converted\n   * @param fromVal the number of \"from\" units to be converted to \"to\" units\n   * @param toUnitCode the unit code/expression/string of the unit that the from\n   *  field is to be converted to\n   * @param suggest a boolean to indicate whether or not suggestions are\n   *  requested for a string that cannot be resolved to a valid unit;\n   *  true indicates suggestions are wanted; false indicates they are not,\n   *  and is the default if the parameter is not specified;\n   * @param molecularWeight the molecular weight of the substance in question\n   *  when a conversion is being requested from mass to moles and vice versa.\n   *  This is required when one of the units represents a value in moles.  It is\n   *  ignored if neither unit includes a measurement in moles.\n   * @returns a hash with six elements:\n   *  'status' that will be: 'succeeded' if the conversion was successfully\n   *     calculated; 'failed' if the conversion could not be made, e.g., if\n   *     the units are not commensurable; or 'error' if an error occurred;\n   *  'toVal' the numeric value indicating the conversion amount, or null\n   *     if the conversion failed (e.g., if the units are not commensurable);\n   *  'msg' is an array message, if the string is invalid or an error occurred,\n   *        indicating the problem, or an explanation of a substitution such as\n   *        the substitution of 'G' for 'Gauss', or an empty array if no\n   *        messages were generated;\n   *  'suggestions' if suggestions were requested and found, this is a hash\n   *     that contains at most two elements:\n   *     'from' which, if the fromUnitCode input parameter or one or more of\n   *       its components could not be found, is an array one or more hash\n   *       objects.  Each hash contains three elements:\n   *         'msg' which is a message indicating what unit expression the\n   *            suggestions are for;\n   *         'invalidUnit' which is the unit expression the suggestions\n   *            are for; and\n   *         'units' which is an array of data for each suggested unit found.\n   *            Each array will contain the unit code, the unit name and the\n   *            unit guidance (if any).\n   *       If no suggestions were found for the fromUnitCode this element\n   *       will not be included.\n   *     'to' which, if the \"to\" unit expression or one or more of its\n   *       components could not be found, is an array one or more hash objects.  Each hash\n   *       contains three elements:\n   *         'msg' which is a message indicating what toUnitCode input\n   *            parameter the suggestions are for;\n   *         'invalidUnit' which is the unit expression the suggestions\n   *            are for; and\n   *         'units' which is an array of data for each suggested unit found.\n   *            Each array will contain the unit code, the unit name and the\n   *            unit guidance (if any).\n   *       If no suggestions were found for the toUnitCode this element\n   *       will not be included.\n   *    No 'suggestions' element will be included in the returned hash\n   *    object if none were found, whether or not they were requested.\n   *  'fromUnit' the unit object for the fromUnitCode passed in; returned\n   *     in case it's needed for additional data from the object; and\n   *  'toUnit' the unit object for the toUnitCode passed in; returned\n   *     in case it's needed for additional data from the object.\n   */\n  convertUnitTo(fromUnitCode, fromVal, toUnitCode, suggest, molecularWeight) {\n    if (suggest === undefined)\n      suggest = false ;\n\n    if (molecularWeight === undefined)\n      molecularWeight = null ;\n\n    let returnObj = {'status' : 'failed',\n                     'toVal' : null,\n                     'msg' : []} ;\n\n    if (fromUnitCode) {\n      fromUnitCode = fromUnitCode.trim();\n    }\n    if (!fromUnitCode || fromUnitCode == '') {\n      returnObj['status'] = 'error';\n      returnObj['msg'].push('No \"from\" unit expression specified.');\n    }\n    if (fromVal === null || isNaN(fromVal) || (typeof fromVal !== 'number' &&\n        !intUtils_.isNumericString(fromVal))) {\n      returnObj['status'] = 'error';\n      returnObj['msg'].push('No \"from\" value, or an invalid \"from\" value, ' +\n                         'was specified.');\n    }\n    if (toUnitCode) {\n      toUnitCode = toUnitCode.trim();\n    }\n    if (!toUnitCode || toUnitCode == '') {\n      returnObj['status'] = 'error';\n      returnObj['msg'].push('No \"to\" unit expression specified.');\n    }\n    if (returnObj['status'] !== 'error') {\n      try {\n        let fromUnit = null;\n\n        let parseResp = this.getSpecifiedUnit(fromUnitCode, 'convert', suggest);\n        fromUnit = parseResp['unit'];\n        if (parseResp['retMsg'])\n          returnObj['msg'] = returnObj['msg'].concat(parseResp['retMsg']);\n        if (parseResp['suggestions']) {\n          returnObj['suggestions'] = {};\n          returnObj['suggestions']['from'] = parseResp['suggestions'];\n        }\n        if (!fromUnit) {\n          returnObj['msg'].push(`Unable to find a unit for ${fromUnitCode}, ` +\n            `so no conversion could be performed.`);\n        }\n\n        let toUnit = null;\n        parseResp = this.getSpecifiedUnit(toUnitCode, 'convert', suggest);\n        toUnit = parseResp['unit'];\n        if (parseResp['retMsg'])\n          returnObj['msg'] = returnObj['msg'].concat(parseResp['retMsg']);\n        if (parseResp['suggestions']) {\n          if (!returnObj['suggestions'])\n            returnObj['suggestions'] = {} ;\n          returnObj['suggestions']['to'] = parseResp['suggestions'];\n        }\n        if (!toUnit) {\n          returnObj['msg'].push(`Unable to find a unit for ${toUnitCode}, ` +\n                                `so no conversion could be performed.`);\n        }\n\n        if (fromUnit && toUnit) {\n          try {\n            // if no molecular weight was specified perform a normal conversion\n            if (!molecularWeight) {\n              returnObj['toVal'] = toUnit.convertFrom(fromVal, fromUnit);\n            }\n            else {\n              if (fromUnit.moleExp_ !== 0 && toUnit.moleExp_ !== 0) {\n                throw(new Error('A molecular weight was specified ' +\n                  'but a mass <-> mole conversion cannot be executed for two ' +\n                  'mole-based units.  No conversion was attempted.'));\n              }\n              if (fromUnit.moleExp_ === 0 && toUnit.moleExp_ === 0) {\n                throw(new Error('A molecular weight was specified ' +\n                  'but a mass <-> mole conversion cannot be executed when ' +\n                  'neither unit is mole-based.  No conversion was attempted.'));\n              }\n              if (!fromUnit.isMoleMassCommensurable(toUnit)) {\n                throw(new Error(`Sorry.  ${fromUnitCode} cannot be ` +\n                  `converted to ${toUnitCode}.`));\n              }\n\n              // if the \"from\" unit is a mole-based unit, assume a mole to mass\n              // request\n              if (fromUnit.moleExp_ !== 0) {\n                returnObj['toVal'] =\n                  fromUnit.convertMolToMass(fromVal, toUnit, molecularWeight);\n              }\n              // else the \"to\" unit must be the mole-based unit, so assume a\n              // mass to mole request\n              else {\n                returnObj['toVal'] =\n                  fromUnit.convertMassToMol(fromVal, toUnit, molecularWeight);\n              }\n            } // end if a molecular weight was specified\n\n            // if an error hasn't been thrown - either from convertFrom or here,\n            // set the return object to show success\n            returnObj['status'] = 'succeeded';\n            returnObj['fromUnit'] = fromUnit;\n            returnObj['toUnit'] = toUnit;\n          }\n          catch (err) {\n            returnObj['status'] = 'failed';\n            returnObj['msg'].push(err.message);\n          }\n\n\n        }  // end if we have the from and to units\n      }\n      catch (err) {\n        if (err.message == Ucum.needMoleWeightMsg_)\n          returnObj['status'] = 'failed';\n        else\n          returnObj['status'] = 'error';\n        returnObj['msg'].push(err.message);\n      }\n    }\n\n    return returnObj ;\n\n  } // end convertUnitTo\n\n\n  /**\n   * This method accepts a term and looks for units that include it as\n   * a synonym - or that include the term in its name.\n   *\n   * @param theSyn the term to search for\n   * @returns a hash with up to three elements:\n   *  'status' contains the status of the request, which can be 'error',\n   *    'failed' or succeeded';\n   *  'msg' which contains a message for an error or if no units were found; and\n   *  'units' which is an array that contains one hash for each unit found:\n   *    'code' is the unit's csCode_\n   *    'name' is the unit's name_\n   *    'guidance' is the unit's guidance_\n   *\n   */\n  checkSynonyms(theSyn) {\n    let retObj = {} ;\n    if (theSyn === undefined || theSyn === null) {\n      retObj['status'] = 'error';\n      retObj['msg'] = 'No term specified for synonym search.'\n    }\n    else {\n      retObj = intUtils_.getSynonyms(theSyn);\n    } // end if a search synonym was supplied\n\n    return retObj ;\n\n  } // end checkSynonyms\n\n\n  /**\n   * This method parses a unit string to get (or try to get) the unit\n   * represented by the string.  It returns an error message if no string was specified\n   * or if any errors were encountered trying to get the unit.\n   *\n   * @param uName the expression/string representing the unit\n   * @param valConv indicates what type of request this is for - a request to\n   *  validate (pass in 'validate') or a request to convert (pass in 'convert')\n   * @param suggest a boolean to indicate whether or not suggestions are\n   *  requested for a string that cannot be resolved to a valid unit;\n   *  true indicates suggestions are wanted; false indicates they are not,\n   *  and is the default if the parameter is not specified;\n   * @returns a hash containing:\n   *   'unit' the unit object (or null if there were problems creating the\n   *     unit);\n   *   'origString' the possibly updated unit string passed in;\n   *   'retMsg' an array of user messages (informational, error or warning) if\n   *     any were generated (IF any were generated, otherwise will be an\n   *     empty array); and\n   *  'suggestions' is an array of 1 or more hash objects.  Each hash\n   *     contains three elements:\n   *       'msg' which is a message indicating what unit expression the\n   *          suggestions are for;\n   *       'invalidUnit' which is the unit expression the suggestions are\n   *          for; and\n   *       'units' which is an array of data for each suggested unit found.\n   *          Each array will contain the unit code, the unit name and the\n   *          unit guidance (if any).\n   *   The return hash will not contain a suggestions array if a valid unit\n   *   was found or if suggestions were not requested and found.\n   */\n  getSpecifiedUnit(uName, valConv, suggest) {\n\n    if (suggest === undefined)\n      suggest = false ;\n\n    let retObj = {};\n    retObj['retMsg'] = [];\n\n    if (!uName) {\n      retObj['retMsg'].push('No unit string specified.');\n    }\n    else {\n      let utab = UnitTables.getInstance();\n      uName = uName.trim();\n\n      // go ahead and just try using the name as the code.  This may or may not\n      // work, but if it does, it cuts out a lot of parsing.\n      let theUnit = utab.getUnitByCode(uName);\n\n      // If we found it, set the returned unit string to what was passed in;\n      // otherwise try parsing as a unit string\n      if (theUnit) {\n        retObj['unit'] = theUnit ;\n        retObj['origString'] = uName;\n      }\n      else {\n        try {\n          let resp = this.uStrParser_.parseString(uName, valConv, suggest);\n          retObj['unit'] = resp[0];\n          retObj['origString'] = resp[1];\n          if (resp[2])\n            retObj['retMsg'] = resp[2];\n          retObj['suggestions'] = resp[3];\n        }\n        catch (err) {\n          console.log(`Unit requested for unit string ${uName}.` +\n            'request unsuccessful; error thrown = ' + err.message);\n            retObj['retMsg'].unshift(`${uName} is not a valid unit.  ` +\n                                     `${err.message}`);\n        }\n      } // end if the unit was not found as a unit name\n    } // end if a unit expression was specified\n\n    return retObj;\n\n  } // end getSpecifiedUnit\n\n\n  /**\n   * This method retrieves a list of units commensurable, i.e., that can be\n   * converted from and to, a specified unit.  Returns an error if the \"from\"\n   * unit cannot be found.\n   *\n   * @param fromName the name/unit string of the \"from\" unit\n   * @returns an array containing two elements;\n   *   first element is the list of commensurable units if any were found\n   *   second element is an error message if the \"from\" unit is not found\n   */\n  commensurablesList(fromName) {\n\n    let retMsg = [];\n    let commUnits = null ;\n    let parseResp = this.getSpecifiedUnit(fromName, 'validate', false);\n    let fromUnit = parseResp['unit'];\n    if (parseResp['retMsg'].length > 0)\n      retMsg = parseResp['retMsg'] ;\n    if (!fromUnit) {\n      retMsg.push(`Could not find unit ${fromName}.`);\n    }\n    else {\n      let dimVec = null ;\n      let fromDim = fromUnit.getProperty('dim_');\n      if (!fromDim) {\n        retMsg.push('No commensurable units were found for ' + fromName) ;\n      }\n      else {\n        try {\n          dimVec = fromDim.getProperty('dimVec_');\n        }\n        catch (err) {\n          retMsg.push(err.message);\n          if (err.message ===\n            \"Dimension does not have requested property(dimVec_)\")\n            dimVec = null;\n        }\n        if (dimVec) {\n          let utab = UnitTables.getInstance();\n          commUnits = utab.getUnitsByDimension(dimVec);\n        }\n      } // end if the from unit has a dimension vector\n    } // end if we found a \"from\" unit\n    return [commUnits , retMsg];\n  } // end commensurablesList\n\n\n  /**\n   * Creates a file containing a list of the units.  The file is created\n   * in the current directory.\n   */\n  printUnits() {\n\n    // for now, create a list of the units created and save it to a file\n    // for debugging.  This is a temporary file.\n    let utab = UnitTables.getInstance();\n    let uct = utab.unitsCount();\n    let uList = utab.printUnits(true);\n    fs.writeFileSync('JsonUnitsList.txt', uList,\n        {encoding: 'utf8', mode: 0o666, flag: 'w'} );\n  }\n\n\n} // end UcumLhcUtils class\n\n\n/**\n *  This function exists ONLY until the original UcumLhcUtils constructor\n *  is called for the first time.  It's defined here in case getInstance\n *  is called before the constructor.   This calls the constructor.\n *\n *  The constructor redefines the getInstance function to return the\n *  singleton UcumLhcUtils object.  This is based on the UnitTables singleton\n *  implementation; see more detail in the UnitTables constructor description.\n *\n *  NO LONGER TRUE - not implemented as a singleton.  This method retained to\n *  avoid problems with calls to it that exist throughout the code.\n *\n *  @return the (formerly singleton) UcumLhcUtils object.\n */\nUcumLhcUtils.getInstance = function(){\n  return new UcumLhcUtils();\n} ;\n\n\n\n\n"],"file":"ucumLhcUtils.js"}
+{"version":3,"sources":["../source/ucumLhcUtils.js"],"names":["Ucum","require","UnitTables","UnitString","UcumLhcUtils","constructor","getInstance","unitsCount","ucumJsonDefs","loadJsonDefs","uStrParser_","useHTMLInMessages","use","undefined","useBraceMsgForEachString","validateUnitString","uStr","suggest","valConv","resp","getSpecifiedUnit","theUnit","retObj","csCode_","name_","guidance_","convertUnitTo","fromUnitCode","fromVal","toUnitCode","molecularWeight","returnObj","trim","push","isNaN","intUtils_","isNumericString","fromUnit","parseResp","concat","toUnit","convertFrom","moleExp_","Error","isMoleMassCommensurable","convertMolToMass","convertMassToMol","err","message","needMoleWeightMsg_","checkSynonyms","theSyn","getSynonyms","uName","utab","getUnitByCode","parseString","console","log","unshift","commensurablesList","fromName","retMsg","commUnits","length","dimVec","fromDim","getProperty","getUnitsByDimension"],"mappings":"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","sourcesContent":["/**\n * This class provides a single point of access to the LHC UCUM utilities\n *\n * @author Lee Mericle\n *\n */\nvar Ucum = require('./config.js').Ucum;\nimport {ucumJsonDefs} from './ucumJsonDefs.js';\nvar UnitTables = require('./unitTables.js').UnitTables;\nvar UnitString = require('./unitString.js').UnitString;\n\nimport * as intUtils_ from \"./ucumInternalUtils.js\";\n\n/**\n * UCUM external utilities class\n */\nexport class UcumLhcUtils {\n\n  /**\n   * Constructor.  This loads the json prefix and unit definitions if\n   * they haven't been loaded already and creates itself as a singleton object.\n   *\n   */\n  constructor() {\n\n      if (UnitTables.getInstance().unitsCount() === 0) {\n\n        // Load the prefix and unit objects\n        ucumJsonDefs.loadJsonDefs();\n      }\n\n      // Get the UnitString parser that will be used with this instance\n      // of the LHC Utilities\n      this.uStrParser_ = UnitString.getInstance();\n\n  } // end constructor\n\n\n  /**\n   * This method calls the useHTMLInMessages method on the UnitString\n   * object.  It should be called by web applications that use\n   * these utilities.\n   *\n   * @param use flag indicating whether or not to use the braces message;\n   *  defaults to true\n   */\n  useHTMLInMessages(use) {\n    if (use === undefined)\n      use = true ;\n    this.uStrParser_.useHTMLInMessages(use);\n  }\n\n\n  /**\n   * This method calls the useBraceMsgForEachString method on the UnitString\n   * object.  It should be called by web applications where unit\n   * strings are validated individually (as opposed to validating a whole\n   * file of unit strings).\n   *\n   * @param use flag indicating whether or not to use the braces message;\n   *  defaults to true\n   */\n  useBraceMsgForEachString(use) {\n    if (use === undefined)\n      use = true ;\n    this.uStrParser_.useBraceMsgForEachString(use);\n  }\n\n\n  /**\n   * This method validates a unit string.  It first checks to see if the\n   * string passed in is a unit code that is found in the unit codes table.\n   * If it is not found it parses the string to see if it resolves to a\n   * valid unit string.\n   *\n   * If a valid unit cannot be found, the string is tested for some common\n   * errors, such as missing brackets or a missing multiplication operator.\n   * If found, the error is reported in the messages array that is returned.\n   *\n   * If a valid unit cannot be found and an error cannot be discerned, this\n   * may return, if requested, a list of suggested units in the messages\n   * array that is returned.  Suggestions are based on matching the expression\n   * with unit names and synonyms.\n   *\n   * @param uStr the string to be validated\n   * @param suggest a boolean to indicate whether or not suggestions are\n   *  requested for a string that cannot be resolved to a valid unit;\n   *  true indicates suggestions are wanted; false indicates they are not,\n   *  and is the default if the parameter is not specified;\n   * @param valConv a string indicating if this validation request was initiated\n   *  by a validation task ('validate') or a conversion task ('convert'),\n   *  used only for the demo code, and the default is 'Validator' if the\n   *  parameter is not specified;\n   * @returns an object with five properties:\n   *  'status' will be 'valid' (the uStr is a valid UCUM code), 'invalid'\n   *     (the uStr is not a valid UCUM code, and substitutions or\n   *     suggestions may or may not be returned, depending on what was\n   *     requested and found); or 'error' (an input or programming error\n   *     occurred);\n   *  'ucumCode' the valid ucum code, which may differ from what was passed\n   *    in (e.g., if 'Gauss' is passed in, this will contain 'G') OR null if\n   *    the string was flagged as invalid or an error occurred;\n   *  'msg' is an array of one or more messages, if the string is invalid or\n   *        an error occurred, indicating the problem, or an explanation of a\n   *        substitution such as the substitution of 'G' for 'Gauss', or\n   *        an empty array if no messages were generated;\n   *  'unit' which is null if no unit is found, or a hash for a unit found:\n   *    'code' is the unit's ucum code (G in the above example;\n   *    'name' is the unit's name (Gauss in the above example); and\n   *    'guidance' is the unit's guidance/description data; and\n   *  'suggestions' if suggestions were requested and found, this is an array\n   *     of one or more hash objects.  Each hash contains three elements:\n   *     'msg' which is a message indicating what part of the uStr input\n   *        parameter the suggestions are for;\n   *     'invalidUnit' which is the unit expression the suggestions are\n   *        for; and\n   *     'units' which is an array of data for each suggested unit found.\n   *        Each array will contain the unit code, the unit name and the\n   *        unit guidance (if any).\n   *     If no suggestions were requested and found, this property is not\n   *     returned.\n   */\n  validateUnitString(uStr, suggest, valConv) {\n\n    if (suggest === undefined)\n      suggest = false ;\n\n    if (valConv === undefined)\n      valConv = 'validate' ;\n\n    let resp = this.getSpecifiedUnit(uStr, valConv, suggest);\n    let theUnit = resp['unit'];\n    let retObj = {};\n    if (!theUnit) {\n      retObj = {'status': (!resp['origString'] || resp['origString'] === null) ?\n                           'error' : 'invalid',\n                'ucumCode': null};\n    }\n    else {\n      retObj = {'status': resp['origString'] === uStr ? 'valid': 'invalid',\n                'ucumCode': resp['origString'],\n                'unit': {'code': theUnit.csCode_,\n                         'name': theUnit.name_,\n                         'guidance': theUnit.guidance_ }};\n    }\n    if (resp['suggestions']) {\n      retObj['suggestions'] = resp['suggestions'];\n    }\n    retObj['msg'] = resp['retMsg'];\n    return retObj;\n\n  } // end validateUnitString\n\n\n  /**\n   * This method converts one unit to another\n   *\n   * @param fromUnitCode the unit code/expression/string of the unit to be converted\n   * @param fromVal the number of \"from\" units to be converted to \"to\" units\n   * @param toUnitCode the unit code/expression/string of the unit that the from\n   *  field is to be converted to\n   * @param suggest a boolean to indicate whether or not suggestions are\n   *  requested for a string that cannot be resolved to a valid unit;\n   *  true indicates suggestions are wanted; false indicates they are not,\n   *  and is the default if the parameter is not specified;\n   * @param molecularWeight the molecular weight of the substance in question\n   *  when a conversion is being requested from mass to moles and vice versa.\n   *  This is required when one of the units represents a value in moles.  It is\n   *  ignored if neither unit includes a measurement in moles.\n   * @returns a hash with six elements:\n   *  'status' that will be: 'succeeded' if the conversion was successfully\n   *     calculated; 'failed' if the conversion could not be made, e.g., if\n   *     the units are not commensurable; or 'error' if an error occurred;\n   *  'toVal' the numeric value indicating the conversion amount, or null\n   *     if the conversion failed (e.g., if the units are not commensurable);\n   *  'msg' is an array message, if the string is invalid or an error occurred,\n   *        indicating the problem, or an explanation of a substitution such as\n   *        the substitution of 'G' for 'Gauss', or an empty array if no\n   *        messages were generated;\n   *  'suggestions' if suggestions were requested and found, this is a hash\n   *     that contains at most two elements:\n   *     'from' which, if the fromUnitCode input parameter or one or more of\n   *       its components could not be found, is an array one or more hash\n   *       objects.  Each hash contains three elements:\n   *         'msg' which is a message indicating what unit expression the\n   *            suggestions are for;\n   *         'invalidUnit' which is the unit expression the suggestions\n   *            are for; and\n   *         'units' which is an array of data for each suggested unit found.\n   *            Each array will contain the unit code, the unit name and the\n   *            unit guidance (if any).\n   *       If no suggestions were found for the fromUnitCode this element\n   *       will not be included.\n   *     'to' which, if the \"to\" unit expression or one or more of its\n   *       components could not be found, is an array one or more hash objects.  Each hash\n   *       contains three elements:\n   *         'msg' which is a message indicating what toUnitCode input\n   *            parameter the suggestions are for;\n   *         'invalidUnit' which is the unit expression the suggestions\n   *            are for; and\n   *         'units' which is an array of data for each suggested unit found.\n   *            Each array will contain the unit code, the unit name and the\n   *            unit guidance (if any).\n   *       If no suggestions were found for the toUnitCode this element\n   *       will not be included.\n   *    No 'suggestions' element will be included in the returned hash\n   *    object if none were found, whether or not they were requested.\n   *  'fromUnit' the unit object for the fromUnitCode passed in; returned\n   *     in case it's needed for additional data from the object; and\n   *  'toUnit' the unit object for the toUnitCode passed in; returned\n   *     in case it's needed for additional data from the object.\n   */\n  convertUnitTo(fromUnitCode, fromVal, toUnitCode, suggest, molecularWeight) {\n    if (suggest === undefined)\n      suggest = false ;\n\n    if (molecularWeight === undefined)\n      molecularWeight = null ;\n\n    let returnObj = {'status' : 'failed',\n                     'toVal' : null,\n                     'msg' : []} ;\n\n    if (fromUnitCode) {\n      fromUnitCode = fromUnitCode.trim();\n    }\n    if (!fromUnitCode || fromUnitCode == '') {\n      returnObj['status'] = 'error';\n      returnObj['msg'].push('No \"from\" unit expression specified.');\n    }\n    if (fromVal === null || isNaN(fromVal) || (typeof fromVal !== 'number' &&\n        !intUtils_.isNumericString(fromVal))) {\n      returnObj['status'] = 'error';\n      returnObj['msg'].push('No \"from\" value, or an invalid \"from\" value, ' +\n                         'was specified.');\n    }\n    if (toUnitCode) {\n      toUnitCode = toUnitCode.trim();\n    }\n    if (!toUnitCode || toUnitCode == '') {\n      returnObj['status'] = 'error';\n      returnObj['msg'].push('No \"to\" unit expression specified.');\n    }\n    if (returnObj['status'] !== 'error') {\n      try {\n        let fromUnit = null;\n\n        let parseResp = this.getSpecifiedUnit(fromUnitCode, 'convert', suggest);\n        fromUnit = parseResp['unit'];\n        if (parseResp['retMsg'])\n          returnObj['msg'] = returnObj['msg'].concat(parseResp['retMsg']);\n        if (parseResp['suggestions']) {\n          returnObj['suggestions'] = {};\n          returnObj['suggestions']['from'] = parseResp['suggestions'];\n        }\n        if (!fromUnit) {\n          returnObj['msg'].push(`Unable to find a unit for ${fromUnitCode}, ` +\n            `so no conversion could be performed.`);\n        }\n\n        let toUnit = null;\n        parseResp = this.getSpecifiedUnit(toUnitCode, 'convert', suggest);\n        toUnit = parseResp['unit'];\n        if (parseResp['retMsg'])\n          returnObj['msg'] = returnObj['msg'].concat(parseResp['retMsg']);\n        if (parseResp['suggestions']) {\n          if (!returnObj['suggestions'])\n            returnObj['suggestions'] = {} ;\n          returnObj['suggestions']['to'] = parseResp['suggestions'];\n        }\n        if (!toUnit) {\n          returnObj['msg'].push(`Unable to find a unit for ${toUnitCode}, ` +\n                                `so no conversion could be performed.`);\n        }\n\n        if (fromUnit && toUnit) {\n          try {\n            // if no molecular weight was specified perform a normal conversion\n            if (!molecularWeight) {\n              returnObj['toVal'] = toUnit.convertFrom(fromVal, fromUnit);\n            }\n            else {\n              if (fromUnit.moleExp_ !== 0 && toUnit.moleExp_ !== 0) {\n                throw(new Error('A molecular weight was specified ' +\n                  'but a mass <-> mole conversion cannot be executed for two ' +\n                  'mole-based units.  No conversion was attempted.'));\n              }\n              if (fromUnit.moleExp_ === 0 && toUnit.moleExp_ === 0) {\n                throw(new Error('A molecular weight was specified ' +\n                  'but a mass <-> mole conversion cannot be executed when ' +\n                  'neither unit is mole-based.  No conversion was attempted.'));\n              }\n              if (!fromUnit.isMoleMassCommensurable(toUnit)) {\n                throw(new Error(`Sorry.  ${fromUnitCode} cannot be ` +\n                  `converted to ${toUnitCode}.`));\n              }\n\n              // if the \"from\" unit is a mole-based unit, assume a mole to mass\n              // request\n              if (fromUnit.moleExp_ !== 0) {\n                returnObj['toVal'] =\n                  fromUnit.convertMolToMass(fromVal, toUnit, molecularWeight);\n              }\n              // else the \"to\" unit must be the mole-based unit, so assume a\n              // mass to mole request\n              else {\n                returnObj['toVal'] =\n                  fromUnit.convertMassToMol(fromVal, toUnit, molecularWeight);\n              }\n            } // end if a molecular weight was specified\n\n            // if an error hasn't been thrown - either from convertFrom or here,\n            // set the return object to show success\n            returnObj['status'] = 'succeeded';\n            returnObj['fromUnit'] = fromUnit;\n            returnObj['toUnit'] = toUnit;\n          }\n          catch (err) {\n            returnObj['status'] = 'failed';\n            returnObj['msg'].push(err.message);\n          }\n\n\n        }  // end if we have the from and to units\n      }\n      catch (err) {\n        if (err.message == Ucum.needMoleWeightMsg_)\n          returnObj['status'] = 'failed';\n        else\n          returnObj['status'] = 'error';\n        returnObj['msg'].push(err.message);\n      }\n    }\n\n    return returnObj ;\n\n  } // end convertUnitTo\n\n\n  /**\n   * This method accepts a term and looks for units that include it as\n   * a synonym - or that include the term in its name.\n   *\n   * @param theSyn the term to search for\n   * @returns a hash with up to three elements:\n   *  'status' contains the status of the request, which can be 'error',\n   *    'failed' or succeeded';\n   *  'msg' which contains a message for an error or if no units were found; and\n   *  'units' which is an array that contains one hash for each unit found:\n   *    'code' is the unit's csCode_\n   *    'name' is the unit's name_\n   *    'guidance' is the unit's guidance_\n   *\n   */\n  checkSynonyms(theSyn) {\n    let retObj = {} ;\n    if (theSyn === undefined || theSyn === null) {\n      retObj['status'] = 'error';\n      retObj['msg'] = 'No term specified for synonym search.'\n    }\n    else {\n      retObj = intUtils_.getSynonyms(theSyn);\n    } // end if a search synonym was supplied\n\n    return retObj ;\n\n  } // end checkSynonyms\n\n\n  /**\n   * This method parses a unit string to get (or try to get) the unit\n   * represented by the string.  It returns an error message if no string was specified\n   * or if any errors were encountered trying to get the unit.\n   *\n   * @param uName the expression/string representing the unit\n   * @param valConv indicates what type of request this is for - a request to\n   *  validate (pass in 'validate') or a request to convert (pass in 'convert')\n   * @param suggest a boolean to indicate whether or not suggestions are\n   *  requested for a string that cannot be resolved to a valid unit;\n   *  true indicates suggestions are wanted; false indicates they are not,\n   *  and is the default if the parameter is not specified;\n   * @returns a hash containing:\n   *   'unit' the unit object (or null if there were problems creating the\n   *     unit);\n   *   'origString' the possibly updated unit string passed in;\n   *   'retMsg' an array of user messages (informational, error or warning) if\n   *     any were generated (IF any were generated, otherwise will be an\n   *     empty array); and\n   *  'suggestions' is an array of 1 or more hash objects.  Each hash\n   *     contains three elements:\n   *       'msg' which is a message indicating what unit expression the\n   *          suggestions are for;\n   *       'invalidUnit' which is the unit expression the suggestions are\n   *          for; and\n   *       'units' which is an array of data for each suggested unit found.\n   *          Each array will contain the unit code, the unit name and the\n   *          unit guidance (if any).\n   *   The return hash will not contain a suggestions array if a valid unit\n   *   was found or if suggestions were not requested and found.\n   */\n  getSpecifiedUnit(uName, valConv, suggest) {\n\n    if (suggest === undefined)\n      suggest = false ;\n\n    let retObj = {};\n    retObj['retMsg'] = [];\n\n    if (!uName) {\n      retObj['retMsg'].push('No unit string specified.');\n    }\n    else {\n      let utab = UnitTables.getInstance();\n      uName = uName.trim();\n\n      // go ahead and just try using the name as the code.  This may or may not\n      // work, but if it does, it cuts out a lot of parsing.\n      let theUnit = utab.getUnitByCode(uName);\n\n      // If we found it, set the returned unit string to what was passed in;\n      // otherwise try parsing as a unit string\n      if (theUnit) {\n        retObj['unit'] = theUnit ;\n        retObj['origString'] = uName;\n      }\n      else {\n        try {\n          let resp = this.uStrParser_.parseString(uName, valConv, suggest);\n          retObj['unit'] = resp[0];\n          retObj['origString'] = resp[1];\n          if (resp[2])\n            retObj['retMsg'] = resp[2];\n          retObj['suggestions'] = resp[3];\n        }\n        catch (err) {\n          console.log(`Unit requested for unit string ${uName}.` +\n            'request unsuccessful; error thrown = ' + err.message);\n            retObj['retMsg'].unshift(`${uName} is not a valid unit.  ` +\n                                     `${err.message}`);\n        }\n      } // end if the unit was not found as a unit name\n    } // end if a unit expression was specified\n\n    return retObj;\n\n  } // end getSpecifiedUnit\n\n\n  /**\n   * This method retrieves a list of units commensurable, i.e., that can be\n   * converted from and to, a specified unit.  Returns an error if the \"from\"\n   * unit cannot be found.\n   *\n   * @param fromName the name/unit string of the \"from\" unit\n   * @returns an array containing two elements;\n   *   first element is the list of commensurable units if any were found\n   *   second element is an error message if the \"from\" unit is not found\n   */\n  commensurablesList(fromName) {\n\n    let retMsg = [];\n    let commUnits = null ;\n    let parseResp = this.getSpecifiedUnit(fromName, 'validate', false);\n    let fromUnit = parseResp['unit'];\n    if (parseResp['retMsg'].length > 0)\n      retMsg = parseResp['retMsg'] ;\n    if (!fromUnit) {\n      retMsg.push(`Could not find unit ${fromName}.`);\n    }\n    else {\n      let dimVec = null ;\n      let fromDim = fromUnit.getProperty('dim_');\n      if (!fromDim) {\n        retMsg.push('No commensurable units were found for ' + fromName) ;\n      }\n      else {\n        try {\n          dimVec = fromDim.getProperty('dimVec_');\n        }\n        catch (err) {\n          retMsg.push(err.message);\n          if (err.message ===\n            \"Dimension does not have requested property(dimVec_)\")\n            dimVec = null;\n        }\n        if (dimVec) {\n          let utab = UnitTables.getInstance();\n          commUnits = utab.getUnitsByDimension(dimVec);\n        }\n      } // end if the from unit has a dimension vector\n    } // end if we found a \"from\" unit\n    return [commUnits , retMsg];\n  } // end commensurablesList\n\n} // end UcumLhcUtils class\n\n\n/**\n *  This function exists ONLY until the original UcumLhcUtils constructor\n *  is called for the first time.  It's defined here in case getInstance\n *  is called before the constructor.   This calls the constructor.\n *\n *  The constructor redefines the getInstance function to return the\n *  singleton UcumLhcUtils object.  This is based on the UnitTables singleton\n *  implementation; see more detail in the UnitTables constructor description.\n *\n *  NO LONGER TRUE - not implemented as a singleton.  This method retained to\n *  avoid problems with calls to it that exist throughout the code.\n *\n *  @return the (formerly singleton) UcumLhcUtils object.\n */\nUcumLhcUtils.getInstance = function(){\n  return new UcumLhcUtils();\n} ;\n\n\n\n\n"],"file":"ucumLhcUtils.js"}

package/source-cjs/ucumXmlDocument.js

@@ -231,7 +231,7 @@ class UcumXmlDocument {
       }
 
       let valNode = curUA.childNamed('value');
-      if (this.moleCodes_.includes(curUA.attr.Code)) attrs['moleExp_'] = 1;else attrs['moleExp_'] = 0; // Process special units
+      if (this.moleCodes_.indexOf(curUA.attr.Code) !== -1) attrs['moleExp_'] = 1;else attrs['moleExp_'] = 0; // Process special units
 
       if (curUA.attr.isSpecial) {
         attrs['isSpecial_'] = curUA.attr.isSpecial === "yes";