@corva/convert-units 3.1.0

package/dist/index.cjs

@@ -0,0 +1,223 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  bucketMapping: () => bucketMapping,
+  convert: () => convert,
+  default: () => convert,
+  describe: () => describe,
+  getMeasures: () => getMeasures,
+  getUnit: () => getUnit,
+  getUnitForPair: () => getUnitForPair,
+  getUnitKeyByAlias: () => getUnitKeyByAlias,
+  listUnits: () => listUnits,
+  listUnitsWithAliases: () => listUnitsWithAliases,
+  possibilities: () => possibilities,
+  toBest: () => toBest
+});
+module.exports = __toCommonJS(index_exports);
+
+// node_modules/tsup/assets/cjs_shims.js
+var getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
+var importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
+
+// src/loader.ts
+var import_node_fs = __toESM(require("fs"), 1);
+var import_node_path = __toESM(require("path"), 1);
+var import_node_url = require("url");
+var UNIT_BUCKET_MAPPING_FILE = "unitBucketMapping.json";
+var DEFS_DIR = import_node_path.default.resolve(import_node_path.default.dirname((0, import_node_url.fileURLToPath)(importMetaUrl)), "..", "definitions");
+var loadDefinitions = () => {
+  const result = {};
+  const files = import_node_fs.default.readdirSync(DEFS_DIR).filter((f) => f.endsWith(".json") && f !== UNIT_BUCKET_MAPPING_FILE);
+  for (const file of files) {
+    const name = import_node_path.default.basename(file, ".json");
+    const raw = JSON.parse(import_node_fs.default.readFileSync(import_node_path.default.join(DEFS_DIR, file), "utf-8"));
+    if (raw._anchors) {
+      for (const key of Object.keys(raw._anchors)) {
+        const anchor = raw._anchors[key];
+        if (typeof anchor.transform === "string") {
+          anchor.transform = new Function("val", `return ${anchor.transform}`);
+        }
+      }
+    }
+    result[name] = raw;
+  }
+  if (result.density) result.formationDensity = result.density;
+  const DEPRIORITIZED = [
+    "density",
+    "formationDensity",
+    "concentration",
+    "gasConcentration",
+    "force",
+    "gravity",
+    "gasVolume",
+    "spontaneousPotential"
+  ];
+  const deprioritized = {};
+  for (const key of DEPRIORITIZED) {
+    if (result[key]) {
+      deprioritized[key] = result[key];
+      delete result[key];
+    }
+  }
+  return { ...result, ...deprioritized };
+};
+var measures = loadDefinitions();
+var bucketMapping = JSON.parse(
+  import_node_fs.default.readFileSync(import_node_path.default.join(DEFS_DIR, UNIT_BUCKET_MAPPING_FILE), "utf-8")
+);
+
+// src/errors.ts
+var throwUnsupportedUnitError = (what, validUnits) => {
+  throw new Error(`Unsupported unit ${what}, use one of: ${validUnits.join(", ")}`);
+};
+var throwUnsupportedCompatibilityError = (abbr, measure) => {
+  throw new Error(`Unsupported compatibility for unit ${abbr} and measure ${measure}`);
+};
+var throwIncompatibleMeasuresError = (destMeasure, originMeasure) => {
+  throw new Error(`Cannot convert incompatible measures of ${destMeasure} and ${originMeasure}`);
+};
+
+// src/core.ts
+var unitIndex = /* @__PURE__ */ new Map();
+var measureIndex = /* @__PURE__ */ new Map();
+var aliasMap = /* @__PURE__ */ new Map();
+var _buildIndexes = () => {
+  const all = [];
+  for (const [measure, systems] of Object.entries(measures)) {
+    for (const [system, units] of Object.entries(systems)) {
+      if (system === "_anchors") continue;
+      for (const [abbr, unit] of Object.entries(units)) {
+        const entry = { abbr, unit, system, measure };
+        all.push(entry);
+        if (!unitIndex.has(abbr)) unitIndex.set(abbr, entry);
+        if (!measureIndex.has(measure)) measureIndex.set(measure, []);
+        measureIndex.get(measure).push(entry);
+        aliasMap.set(abbr, abbr);
+        for (const alias of unit.aliases ?? []) aliasMap.set(alias, abbr);
+      }
+    }
+  }
+  return all;
+};
+var allUnits = _buildIndexes();
+var getUnit = (abbr, measure) => {
+  if (measure) {
+    const entry = measureIndex.get(measure)?.find((e) => e.abbr === abbr || e.unit.aliases?.includes(abbr));
+    if (!entry) throwUnsupportedCompatibilityError(abbr, measure);
+    return entry;
+  }
+  const canonical = aliasMap.get(abbr);
+  return canonical !== void 0 ? unitIndex.get(canonical) : void 0;
+};
+var getUnitForPair = (abbrOne, abbrTwo) => {
+  const one = unitIndex.get(abbrOne);
+  const two = unitIndex.get(abbrTwo);
+  return one && two && one.measure === two.measure ? [one, two] : null;
+};
+var toPlainUnit = ({ abbr, measure, system, unit }) => ({
+  abbr,
+  measure,
+  system,
+  singular: unit.name.singular,
+  plural: unit.name.plural,
+  display: unit.name.display
+});
+var _toPlainUnitWithAlias = (entry) => ({
+  ...toPlainUnit(entry),
+  aliases: entry.unit.aliases
+});
+var listUnits = (measure, withAliases = false) => {
+  const decorator = withAliases ? _toPlainUnitWithAlias : toPlainUnit;
+  const entries = measure ? measureIndex.get(measure) ?? [] : allUnits;
+  return entries.map(decorator);
+};
+var getPossibilities = (measure, origin) => {
+  const m = measure ?? origin?.measure;
+  if (!m) return [...unitIndex.keys()];
+  return (measureIndex.get(m) ?? []).map((e) => e.abbr);
+};
+var convert = (value, from, to, measure) => {
+  const origin = getUnit(from, measure) ?? throwUnsupportedUnitError(from, getPossibilities());
+  const dest = getUnit(to, measure) ?? throwUnsupportedUnitError(to, getPossibilities());
+  if (origin.abbr === dest.abbr) return value;
+  let src = origin;
+  let tgt = dest;
+  if (dest.measure !== origin.measure) {
+    if (measure) throwIncompatibleMeasuresError(dest.measure, origin.measure);
+    [tgt, src] = getUnitForPair(dest.abbr, origin.abbr) ?? throwIncompatibleMeasuresError(dest.measure, origin.measure);
+  }
+  let result = value * src.unit.to_anchor;
+  if (src.unit.anchor_shift) result -= src.unit.anchor_shift;
+  if (src.system !== tgt.system) {
+    const anchor = measures[src.measure]._anchors[src.system];
+    result = typeof anchor.transform === "function" ? anchor.transform(result) : result * anchor.ratio;
+  }
+  if (tgt.unit.anchor_shift) result += tgt.unit.anchor_shift;
+  return result / tgt.unit.to_anchor;
+};
+var toBest = (value, from, measure, exclude = []) => {
+  const origin = getUnit(from, measure);
+  if (!origin) return void 0;
+  let best;
+  for (const abbr of getPossibilities(origin.measure)) {
+    if (exclude.includes(abbr)) continue;
+    const entry = measureIndex.get(origin.measure)?.find((e) => e.abbr === abbr);
+    if (!entry || entry.system !== origin.system) continue;
+    const result = convert(value, from, abbr, origin.measure);
+    const { singular, plural, display } = toPlainUnit(entry);
+    if (!best || result >= 1 && result < best.val) {
+      best = { val: result, unit: abbr, singular, plural, display };
+    }
+  }
+  return best;
+};
+var getMeasures = () => Object.keys(measures);
+var describe = (abbr) => toPlainUnit(getUnit(abbr) ?? throwUnsupportedUnitError(abbr, getPossibilities()));
+var listUnitsWithAliases = (measure) => listUnits(measure, true);
+var possibilities = (measure) => getPossibilities(measure);
+var getUnitKeyByAlias = (alias) => aliasMap.get(alias);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  bucketMapping,
+  convert,
+  describe,
+  getMeasures,
+  getUnit,
+  getUnitForPair,
+  getUnitKeyByAlias,
+  listUnits,
+  listUnitsWithAliases,
+  possibilities,
+  toBest
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../node_modules/tsup/assets/cjs_shims.js","../src/loader.ts","../src/errors.ts","../src/core.ts"],"sourcesContent":["export type {\n  UnitDefinition,\n  MeasureDefinition,\n  SystemAnchor,\n  ResolvedUnit,\n  ConversionResult,\n  PlainUnit,\n  BucketMapping,\n  UnitNames,\n} from './types';\n\nexport {\n  convert,\n  getMeasures,\n  describe,\n  getUnit,\n  getUnitForPair,\n  listUnits,\n  listUnitsWithAliases,\n  possibilities,\n  toBest,\n  bucketMapping,\n  getUnitKeyByAlias,\n} from './core';\n\nexport { convert as default } from './core';\n","// Shim globals in cjs bundle\n// There's a weird bug that esbuild will always inject importMetaUrl\n// if we export it as `const importMetaUrl = ... __filename ...`\n// But using a function will not cause this issue\n\nconst getImportMetaUrl = () => \n  typeof document === \"undefined\" \n    ? new URL(`file:${__filename}`).href \n    : (document.currentScript && document.currentScript.tagName.toUpperCase() === 'SCRIPT') \n      ? document.currentScript.src \n      : new URL(\"main.js\", document.baseURI).href;\n\nexport const importMetaUrl = /* @__PURE__ */ getImportMetaUrl()\n","import fs from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { MeasureDefinition, BucketMapping } from './types';\n\nconst UNIT_BUCKET_MAPPING_FILE = 'unitBucketMapping.json';\nconst DEFS_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', 'definitions');\n\nconst loadDefinitions = (): Record<string, MeasureDefinition> => {\n  const result: Record<string, MeasureDefinition> = {};\n  const files = fs.readdirSync(DEFS_DIR).filter((f) => f.endsWith('.json') && f !== UNIT_BUCKET_MAPPING_FILE);\n\n  for (const file of files) {\n    const name = path.basename(file, '.json');\n    const raw = JSON.parse(fs.readFileSync(path.join(DEFS_DIR, file), 'utf-8'));\n\n    if (raw._anchors) {\n      for (const key of Object.keys(raw._anchors)) {\n        const anchor = raw._anchors[key];\n        if (typeof anchor.transform === 'string') {\n          anchor.transform = new Function('val', `return ${anchor.transform}`) as (val: number) => number;\n        }\n      }\n    }\n\n    result[name] = raw;\n  }\n\n  if (result.density) result.formationDensity = result.density;\n\n  // Restore the same lookup priority as the original library.\n  //\n  // Measures listed here are moved to the END of the insertion order so that\n  // \"first occurrence wins\" in buildIndexes() resolves shared unit keys correctly:\n  //\n  //   density / formationDensity — share kPa/m and psi/ft with pressureGradient;\n  //                                pressureGradient anchors must win\n  //   concentration              — shares ppm with partsPer; partsPer must win\n  //   gasConcentration           — shares ppm with partsPer; partsPer must win\n  //   force / gravity            — share g with mass; mass (gram) must win\n  //   gasVolume                  — shares gal/bbl/m3 with volume; liquid anchors must win\n  //   spontaneousPotential       — shares mV with voltage; voltage must win\n  const DEPRIORITIZED = [\n    'density',\n    'formationDensity',\n    'concentration',\n    'gasConcentration',\n    'force',\n    'gravity',\n    'gasVolume',\n    'spontaneousPotential',\n  ];\n  const deprioritized: Record<string, MeasureDefinition> = {};\n  for (const key of DEPRIORITIZED) {\n    if (result[key]) {\n      deprioritized[key] = result[key];\n      delete result[key];\n    }\n  }\n  return { ...result, ...deprioritized };\n};\n\nexport const measures: Record<string, MeasureDefinition> = loadDefinitions();\n\nexport const bucketMapping: BucketMapping = JSON.parse(\n  fs.readFileSync(path.join(DEFS_DIR, UNIT_BUCKET_MAPPING_FILE), 'utf-8'),\n);\n","export const throwUnsupportedUnitError = (what: string, validUnits: string[]): never => {\n  throw new Error(`Unsupported unit ${what}, use one of: ${validUnits.join(', ')}`);\n};\n\nexport const throwUnsupportedCompatibilityError = (abbr: string, measure: string): never => {\n  throw new Error(`Unsupported compatibility for unit ${abbr} and measure ${measure}`);\n};\n\nexport const throwIncompatibleMeasuresError = (destMeasure: string, originMeasure: string): never => {\n  throw new Error(`Cannot convert incompatible measures of ${destMeasure} and ${originMeasure}`);\n};\n","import { measures, bucketMapping } from './loader';\nimport {\n  throwUnsupportedCompatibilityError,\n  throwUnsupportedUnitError,\n  throwIncompatibleMeasuresError,\n} from './errors';\nimport type { UnitDefinition, ResolvedUnit, PlainUnit, ConversionResult } from './types';\n\nconst unitIndex = new Map<string, ResolvedUnit>();\nconst measureIndex = new Map<string, ResolvedUnit[]>();\nconst aliasMap = new Map<string, string>();\n\nconst _buildIndexes = (): ResolvedUnit[] => {\n  const all: ResolvedUnit[] = [];\n\n  for (const [measure, systems] of Object.entries(measures)) {\n    for (const [system, units] of Object.entries(systems)) {\n      if (system === '_anchors') continue;\n      for (const [abbr, unit] of Object.entries(units as Record<string, UnitDefinition>)) {\n        const entry: ResolvedUnit = { abbr, unit, system, measure };\n        all.push(entry);\n\n        // First occurrence wins (preserves density over formationDensity for global lookups).\n        if (!unitIndex.has(abbr)) unitIndex.set(abbr, entry);\n\n        if (!measureIndex.has(measure)) measureIndex.set(measure, []);\n        measureIndex.get(measure)!.push(entry);\n\n        aliasMap.set(abbr, abbr);\n        for (const alias of unit.aliases ?? []) aliasMap.set(alias, abbr);\n      }\n    }\n  }\n\n  return all;\n};\n\nconst allUnits = _buildIndexes();\n\n// Lookup helpers\nconst getUnit = (abbr: string, measure?: string): ResolvedUnit | undefined => {\n  if (measure) {\n    const entry = measureIndex.get(measure)?.find((e) => e.abbr === abbr || e.unit.aliases?.includes(abbr));\n    if (!entry) throwUnsupportedCompatibilityError(abbr, measure);\n    return entry;\n  }\n  const canonical = aliasMap.get(abbr);\n  return canonical !== undefined ? unitIndex.get(canonical) : undefined;\n};\n\nconst getUnitForPair = (abbrOne: string, abbrTwo: string): [ResolvedUnit, ResolvedUnit] | null => {\n  const one = unitIndex.get(abbrOne);\n  const two = unitIndex.get(abbrTwo);\n  return one && two && one.measure === two.measure ? [one, two] : null;\n};\n\nconst toPlainUnit = ({ abbr, measure, system, unit }: ResolvedUnit): PlainUnit => ({\n  abbr,\n  measure,\n  system,\n  singular: unit.name.singular,\n  plural: unit.name.plural,\n  display: unit.name.display,\n});\n\nconst _toPlainUnitWithAlias = (entry: ResolvedUnit): PlainUnit => ({\n  ...toPlainUnit(entry),\n  aliases: entry.unit.aliases,\n});\n\nconst listUnits = (measure?: string, withAliases = false): PlainUnit[] => {\n  const decorator = withAliases ? _toPlainUnitWithAlias : toPlainUnit;\n  const entries = measure ? (measureIndex.get(measure) ?? []) : allUnits;\n  return entries.map(decorator);\n};\n\nconst getPossibilities = (measure?: string, origin?: ResolvedUnit): string[] => {\n  const m = measure ?? origin?.measure;\n  if (!m) return [...unitIndex.keys()];\n  return (measureIndex.get(m) ?? []).map((e) => e.abbr);\n};\n\nconst convert = (value: number, from: string, to: string, measure?: string): number => {\n  const origin = getUnit(from, measure) ?? throwUnsupportedUnitError(from, getPossibilities());\n  const dest = getUnit(to, measure) ?? throwUnsupportedUnitError(to, getPossibilities());\n\n  if (origin.abbr === dest.abbr) return value;\n\n  let src = origin;\n  let tgt = dest;\n\n  if (dest.measure !== origin.measure) {\n    if (measure) throwIncompatibleMeasuresError(dest.measure, origin.measure);\n    [tgt, src] =\n      getUnitForPair(dest.abbr, origin.abbr) ?? throwIncompatibleMeasuresError(dest.measure, origin.measure);\n  }\n\n  let result = value * src.unit.to_anchor;\n  if (src.unit.anchor_shift) result -= src.unit.anchor_shift;\n\n  if (src.system !== tgt.system) {\n    const anchor = measures[src.measure]._anchors[src.system];\n    result = typeof anchor.transform === 'function' ? anchor.transform(result) : result * anchor.ratio!;\n  }\n\n  if (tgt.unit.anchor_shift) result += tgt.unit.anchor_shift;\n  return result / tgt.unit.to_anchor;\n};\n\nconst toBest = (\n  value: number,\n  from: string,\n  measure?: string,\n  exclude: string[] = [],\n): ConversionResult | undefined => {\n  const origin = getUnit(from, measure);\n  if (!origin) return undefined;\n\n  let best: ConversionResult | undefined;\n\n  for (const abbr of getPossibilities(origin.measure)) {\n    if (exclude.includes(abbr)) continue;\n    const entry = measureIndex.get(origin.measure)?.find((e) => e.abbr === abbr);\n    if (!entry || entry.system !== origin.system) continue;\n\n    const result = convert(value, from, abbr, origin.measure);\n    const { singular, plural, display } = toPlainUnit(entry);\n    if (!best || (result >= 1 && result < best.val)) {\n      best = { val: result, unit: abbr, singular, plural, display };\n    }\n  }\n\n  return best;\n};\n\nconst getMeasures = (): string[] => Object.keys(measures);\n\nconst describe = (abbr: string): PlainUnit =>\n  toPlainUnit(getUnit(abbr) ?? throwUnsupportedUnitError(abbr, getPossibilities()));\n\nconst listUnitsWithAliases = (measure?: string): PlainUnit[] => listUnits(measure, true);\n\nconst possibilities = (measure?: string): string[] => getPossibilities(measure);\n\nconst getUnitKeyByAlias = (alias: string): string | undefined => aliasMap.get(alias);\n\nexport {\n  measures,\n  bucketMapping,\n  aliasMap,\n  getUnit,\n  getUnitForPair,\n  toPlainUnit,\n  listUnits,\n  listUnitsWithAliases,\n  getMeasures,\n  describe,\n  possibilities,\n  getUnitKeyByAlias,\n  getPossibilities,\n  convert,\n  toBest,\n};\n"],"mappings":"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","names":["path","fs"]}

package/dist/index.d.cts

@@ -0,0 +1,58 @@
+type UnitNames = {
+    singular: string;
+    plural: string;
+    display: string;
+};
+type UnitDefinition = {
+    name: UnitNames;
+    to_anchor: number;
+    anchor_shift?: number;
+    aliases?: string[];
+};
+type SystemAnchor = {
+    unit: string;
+    ratio?: number;
+    transform?: (val: number) => number;
+};
+type MeasureDefinition = {
+    _anchors: Record<string, SystemAnchor>;
+    [system: string]: Record<string, UnitDefinition> | Record<string, SystemAnchor>;
+};
+type ResolvedUnit = {
+    abbr: string;
+    measure: string;
+    system: string;
+    unit: UnitDefinition;
+};
+type ConversionResult = {
+    val: number;
+    unit: string;
+    singular: string;
+    plural: string;
+    display: string;
+};
+type PlainUnit = {
+    abbr: string;
+    measure: string;
+    system: string;
+    singular: string;
+    plural: string;
+    display: string;
+    aliases?: string[];
+};
+type BucketMapping = Record<string, string[]>;
+
+declare const bucketMapping: BucketMapping;
+
+declare const getUnit: (abbr: string, measure?: string) => ResolvedUnit | undefined;
+declare const getUnitForPair: (abbrOne: string, abbrTwo: string) => [ResolvedUnit, ResolvedUnit] | null;
+declare const listUnits: (measure?: string, withAliases?: boolean) => PlainUnit[];
+declare const convert: (value: number, from: string, to: string, measure?: string) => number;
+declare const toBest: (value: number, from: string, measure?: string, exclude?: string[]) => ConversionResult | undefined;
+declare const getMeasures: () => string[];
+declare const describe: (abbr: string) => PlainUnit;
+declare const listUnitsWithAliases: (measure?: string) => PlainUnit[];
+declare const possibilities: (measure?: string) => string[];
+declare const getUnitKeyByAlias: (alias: string) => string | undefined;
+
+export { type BucketMapping, type ConversionResult, type MeasureDefinition, type PlainUnit, type ResolvedUnit, type SystemAnchor, type UnitDefinition, type UnitNames, bucketMapping, convert, convert as default, describe, getMeasures, getUnit, getUnitForPair, getUnitKeyByAlias, listUnits, listUnitsWithAliases, possibilities, toBest };

package/dist/index.d.ts

@@ -0,0 +1,58 @@
+type UnitNames = {
+    singular: string;
+    plural: string;
+    display: string;
+};
+type UnitDefinition = {
+    name: UnitNames;
+    to_anchor: number;
+    anchor_shift?: number;
+    aliases?: string[];
+};
+type SystemAnchor = {
+    unit: string;
+    ratio?: number;
+    transform?: (val: number) => number;
+};
+type MeasureDefinition = {
+    _anchors: Record<string, SystemAnchor>;
+    [system: string]: Record<string, UnitDefinition> | Record<string, SystemAnchor>;
+};
+type ResolvedUnit = {
+    abbr: string;
+    measure: string;
+    system: string;
+    unit: UnitDefinition;
+};
+type ConversionResult = {
+    val: number;
+    unit: string;
+    singular: string;
+    plural: string;
+    display: string;
+};
+type PlainUnit = {
+    abbr: string;
+    measure: string;
+    system: string;
+    singular: string;
+    plural: string;
+    display: string;
+    aliases?: string[];
+};
+type BucketMapping = Record<string, string[]>;
+
+declare const bucketMapping: BucketMapping;
+
+declare const getUnit: (abbr: string, measure?: string) => ResolvedUnit | undefined;
+declare const getUnitForPair: (abbrOne: string, abbrTwo: string) => [ResolvedUnit, ResolvedUnit] | null;
+declare const listUnits: (measure?: string, withAliases?: boolean) => PlainUnit[];
+declare const convert: (value: number, from: string, to: string, measure?: string) => number;
+declare const toBest: (value: number, from: string, measure?: string, exclude?: string[]) => ConversionResult | undefined;
+declare const getMeasures: () => string[];
+declare const describe: (abbr: string) => PlainUnit;
+declare const listUnitsWithAliases: (measure?: string) => PlainUnit[];
+declare const possibilities: (measure?: string) => string[];
+declare const getUnitKeyByAlias: (alias: string) => string | undefined;
+
+export { type BucketMapping, type ConversionResult, type MeasureDefinition, type PlainUnit, type ResolvedUnit, type SystemAnchor, type UnitDefinition, type UnitNames, bucketMapping, convert, convert as default, describe, getMeasures, getUnit, getUnitForPair, getUnitKeyByAlias, listUnits, listUnitsWithAliases, possibilities, toBest };

package/dist/index.js

@@ -0,0 +1,172 @@
+// src/loader.ts
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+var UNIT_BUCKET_MAPPING_FILE = "unitBucketMapping.json";
+var DEFS_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..", "definitions");
+var loadDefinitions = () => {
+  const result = {};
+  const files = fs.readdirSync(DEFS_DIR).filter((f) => f.endsWith(".json") && f !== UNIT_BUCKET_MAPPING_FILE);
+  for (const file of files) {
+    const name = path.basename(file, ".json");
+    const raw = JSON.parse(fs.readFileSync(path.join(DEFS_DIR, file), "utf-8"));
+    if (raw._anchors) {
+      for (const key of Object.keys(raw._anchors)) {
+        const anchor = raw._anchors[key];
+        if (typeof anchor.transform === "string") {
+          anchor.transform = new Function("val", `return ${anchor.transform}`);
+        }
+      }
+    }
+    result[name] = raw;
+  }
+  if (result.density) result.formationDensity = result.density;
+  const DEPRIORITIZED = [
+    "density",
+    "formationDensity",
+    "concentration",
+    "gasConcentration",
+    "force",
+    "gravity",
+    "gasVolume",
+    "spontaneousPotential"
+  ];
+  const deprioritized = {};
+  for (const key of DEPRIORITIZED) {
+    if (result[key]) {
+      deprioritized[key] = result[key];
+      delete result[key];
+    }
+  }
+  return { ...result, ...deprioritized };
+};
+var measures = loadDefinitions();
+var bucketMapping = JSON.parse(
+  fs.readFileSync(path.join(DEFS_DIR, UNIT_BUCKET_MAPPING_FILE), "utf-8")
+);
+
+// src/errors.ts
+var throwUnsupportedUnitError = (what, validUnits) => {
+  throw new Error(`Unsupported unit ${what}, use one of: ${validUnits.join(", ")}`);
+};
+var throwUnsupportedCompatibilityError = (abbr, measure) => {
+  throw new Error(`Unsupported compatibility for unit ${abbr} and measure ${measure}`);
+};
+var throwIncompatibleMeasuresError = (destMeasure, originMeasure) => {
+  throw new Error(`Cannot convert incompatible measures of ${destMeasure} and ${originMeasure}`);
+};
+
+// src/core.ts
+var unitIndex = /* @__PURE__ */ new Map();
+var measureIndex = /* @__PURE__ */ new Map();
+var aliasMap = /* @__PURE__ */ new Map();
+var _buildIndexes = () => {
+  const all = [];
+  for (const [measure, systems] of Object.entries(measures)) {
+    for (const [system, units] of Object.entries(systems)) {
+      if (system === "_anchors") continue;
+      for (const [abbr, unit] of Object.entries(units)) {
+        const entry = { abbr, unit, system, measure };
+        all.push(entry);
+        if (!unitIndex.has(abbr)) unitIndex.set(abbr, entry);
+        if (!measureIndex.has(measure)) measureIndex.set(measure, []);
+        measureIndex.get(measure).push(entry);
+        aliasMap.set(abbr, abbr);
+        for (const alias of unit.aliases ?? []) aliasMap.set(alias, abbr);
+      }
+    }
+  }
+  return all;
+};
+var allUnits = _buildIndexes();
+var getUnit = (abbr, measure) => {
+  if (measure) {
+    const entry = measureIndex.get(measure)?.find((e) => e.abbr === abbr || e.unit.aliases?.includes(abbr));
+    if (!entry) throwUnsupportedCompatibilityError(abbr, measure);
+    return entry;
+  }
+  const canonical = aliasMap.get(abbr);
+  return canonical !== void 0 ? unitIndex.get(canonical) : void 0;
+};
+var getUnitForPair = (abbrOne, abbrTwo) => {
+  const one = unitIndex.get(abbrOne);
+  const two = unitIndex.get(abbrTwo);
+  return one && two && one.measure === two.measure ? [one, two] : null;
+};
+var toPlainUnit = ({ abbr, measure, system, unit }) => ({
+  abbr,
+  measure,
+  system,
+  singular: unit.name.singular,
+  plural: unit.name.plural,
+  display: unit.name.display
+});
+var _toPlainUnitWithAlias = (entry) => ({
+  ...toPlainUnit(entry),
+  aliases: entry.unit.aliases
+});
+var listUnits = (measure, withAliases = false) => {
+  const decorator = withAliases ? _toPlainUnitWithAlias : toPlainUnit;
+  const entries = measure ? measureIndex.get(measure) ?? [] : allUnits;
+  return entries.map(decorator);
+};
+var getPossibilities = (measure, origin) => {
+  const m = measure ?? origin?.measure;
+  if (!m) return [...unitIndex.keys()];
+  return (measureIndex.get(m) ?? []).map((e) => e.abbr);
+};
+var convert = (value, from, to, measure) => {
+  const origin = getUnit(from, measure) ?? throwUnsupportedUnitError(from, getPossibilities());
+  const dest = getUnit(to, measure) ?? throwUnsupportedUnitError(to, getPossibilities());
+  if (origin.abbr === dest.abbr) return value;
+  let src = origin;
+  let tgt = dest;
+  if (dest.measure !== origin.measure) {
+    if (measure) throwIncompatibleMeasuresError(dest.measure, origin.measure);
+    [tgt, src] = getUnitForPair(dest.abbr, origin.abbr) ?? throwIncompatibleMeasuresError(dest.measure, origin.measure);
+  }
+  let result = value * src.unit.to_anchor;
+  if (src.unit.anchor_shift) result -= src.unit.anchor_shift;
+  if (src.system !== tgt.system) {
+    const anchor = measures[src.measure]._anchors[src.system];
+    result = typeof anchor.transform === "function" ? anchor.transform(result) : result * anchor.ratio;
+  }
+  if (tgt.unit.anchor_shift) result += tgt.unit.anchor_shift;
+  return result / tgt.unit.to_anchor;
+};
+var toBest = (value, from, measure, exclude = []) => {
+  const origin = getUnit(from, measure);
+  if (!origin) return void 0;
+  let best;
+  for (const abbr of getPossibilities(origin.measure)) {
+    if (exclude.includes(abbr)) continue;
+    const entry = measureIndex.get(origin.measure)?.find((e) => e.abbr === abbr);
+    if (!entry || entry.system !== origin.system) continue;
+    const result = convert(value, from, abbr, origin.measure);
+    const { singular, plural, display } = toPlainUnit(entry);
+    if (!best || result >= 1 && result < best.val) {
+      best = { val: result, unit: abbr, singular, plural, display };
+    }
+  }
+  return best;
+};
+var getMeasures = () => Object.keys(measures);
+var describe = (abbr) => toPlainUnit(getUnit(abbr) ?? throwUnsupportedUnitError(abbr, getPossibilities()));
+var listUnitsWithAliases = (measure) => listUnits(measure, true);
+var possibilities = (measure) => getPossibilities(measure);
+var getUnitKeyByAlias = (alias) => aliasMap.get(alias);
+export {
+  bucketMapping,
+  convert,
+  convert as default,
+  describe,
+  getMeasures,
+  getUnit,
+  getUnitForPair,
+  getUnitKeyByAlias,
+  listUnits,
+  listUnitsWithAliases,
+  possibilities,
+  toBest
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/loader.ts","../src/errors.ts","../src/core.ts"],"sourcesContent":["import fs from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport type { MeasureDefinition, BucketMapping } from './types';\n\nconst UNIT_BUCKET_MAPPING_FILE = 'unitBucketMapping.json';\nconst DEFS_DIR = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', 'definitions');\n\nconst loadDefinitions = (): Record<string, MeasureDefinition> => {\n  const result: Record<string, MeasureDefinition> = {};\n  const files = fs.readdirSync(DEFS_DIR).filter((f) => f.endsWith('.json') && f !== UNIT_BUCKET_MAPPING_FILE);\n\n  for (const file of files) {\n    const name = path.basename(file, '.json');\n    const raw = JSON.parse(fs.readFileSync(path.join(DEFS_DIR, file), 'utf-8'));\n\n    if (raw._anchors) {\n      for (const key of Object.keys(raw._anchors)) {\n        const anchor = raw._anchors[key];\n        if (typeof anchor.transform === 'string') {\n          anchor.transform = new Function('val', `return ${anchor.transform}`) as (val: number) => number;\n        }\n      }\n    }\n\n    result[name] = raw;\n  }\n\n  if (result.density) result.formationDensity = result.density;\n\n  // Restore the same lookup priority as the original library.\n  //\n  // Measures listed here are moved to the END of the insertion order so that\n  // \"first occurrence wins\" in buildIndexes() resolves shared unit keys correctly:\n  //\n  //   density / formationDensity — share kPa/m and psi/ft with pressureGradient;\n  //                                pressureGradient anchors must win\n  //   concentration              — shares ppm with partsPer; partsPer must win\n  //   gasConcentration           — shares ppm with partsPer; partsPer must win\n  //   force / gravity            — share g with mass; mass (gram) must win\n  //   gasVolume                  — shares gal/bbl/m3 with volume; liquid anchors must win\n  //   spontaneousPotential       — shares mV with voltage; voltage must win\n  const DEPRIORITIZED = [\n    'density',\n    'formationDensity',\n    'concentration',\n    'gasConcentration',\n    'force',\n    'gravity',\n    'gasVolume',\n    'spontaneousPotential',\n  ];\n  const deprioritized: Record<string, MeasureDefinition> = {};\n  for (const key of DEPRIORITIZED) {\n    if (result[key]) {\n      deprioritized[key] = result[key];\n      delete result[key];\n    }\n  }\n  return { ...result, ...deprioritized };\n};\n\nexport const measures: Record<string, MeasureDefinition> = loadDefinitions();\n\nexport const bucketMapping: BucketMapping = JSON.parse(\n  fs.readFileSync(path.join(DEFS_DIR, UNIT_BUCKET_MAPPING_FILE), 'utf-8'),\n);\n","export const throwUnsupportedUnitError = (what: string, validUnits: string[]): never => {\n  throw new Error(`Unsupported unit ${what}, use one of: ${validUnits.join(', ')}`);\n};\n\nexport const throwUnsupportedCompatibilityError = (abbr: string, measure: string): never => {\n  throw new Error(`Unsupported compatibility for unit ${abbr} and measure ${measure}`);\n};\n\nexport const throwIncompatibleMeasuresError = (destMeasure: string, originMeasure: string): never => {\n  throw new Error(`Cannot convert incompatible measures of ${destMeasure} and ${originMeasure}`);\n};\n","import { measures, bucketMapping } from './loader';\nimport {\n  throwUnsupportedCompatibilityError,\n  throwUnsupportedUnitError,\n  throwIncompatibleMeasuresError,\n} from './errors';\nimport type { UnitDefinition, ResolvedUnit, PlainUnit, ConversionResult } from './types';\n\nconst unitIndex = new Map<string, ResolvedUnit>();\nconst measureIndex = new Map<string, ResolvedUnit[]>();\nconst aliasMap = new Map<string, string>();\n\nconst _buildIndexes = (): ResolvedUnit[] => {\n  const all: ResolvedUnit[] = [];\n\n  for (const [measure, systems] of Object.entries(measures)) {\n    for (const [system, units] of Object.entries(systems)) {\n      if (system === '_anchors') continue;\n      for (const [abbr, unit] of Object.entries(units as Record<string, UnitDefinition>)) {\n        const entry: ResolvedUnit = { abbr, unit, system, measure };\n        all.push(entry);\n\n        // First occurrence wins (preserves density over formationDensity for global lookups).\n        if (!unitIndex.has(abbr)) unitIndex.set(abbr, entry);\n\n        if (!measureIndex.has(measure)) measureIndex.set(measure, []);\n        measureIndex.get(measure)!.push(entry);\n\n        aliasMap.set(abbr, abbr);\n        for (const alias of unit.aliases ?? []) aliasMap.set(alias, abbr);\n      }\n    }\n  }\n\n  return all;\n};\n\nconst allUnits = _buildIndexes();\n\n// Lookup helpers\nconst getUnit = (abbr: string, measure?: string): ResolvedUnit | undefined => {\n  if (measure) {\n    const entry = measureIndex.get(measure)?.find((e) => e.abbr === abbr || e.unit.aliases?.includes(abbr));\n    if (!entry) throwUnsupportedCompatibilityError(abbr, measure);\n    return entry;\n  }\n  const canonical = aliasMap.get(abbr);\n  return canonical !== undefined ? unitIndex.get(canonical) : undefined;\n};\n\nconst getUnitForPair = (abbrOne: string, abbrTwo: string): [ResolvedUnit, ResolvedUnit] | null => {\n  const one = unitIndex.get(abbrOne);\n  const two = unitIndex.get(abbrTwo);\n  return one && two && one.measure === two.measure ? [one, two] : null;\n};\n\nconst toPlainUnit = ({ abbr, measure, system, unit }: ResolvedUnit): PlainUnit => ({\n  abbr,\n  measure,\n  system,\n  singular: unit.name.singular,\n  plural: unit.name.plural,\n  display: unit.name.display,\n});\n\nconst _toPlainUnitWithAlias = (entry: ResolvedUnit): PlainUnit => ({\n  ...toPlainUnit(entry),\n  aliases: entry.unit.aliases,\n});\n\nconst listUnits = (measure?: string, withAliases = false): PlainUnit[] => {\n  const decorator = withAliases ? _toPlainUnitWithAlias : toPlainUnit;\n  const entries = measure ? (measureIndex.get(measure) ?? []) : allUnits;\n  return entries.map(decorator);\n};\n\nconst getPossibilities = (measure?: string, origin?: ResolvedUnit): string[] => {\n  const m = measure ?? origin?.measure;\n  if (!m) return [...unitIndex.keys()];\n  return (measureIndex.get(m) ?? []).map((e) => e.abbr);\n};\n\nconst convert = (value: number, from: string, to: string, measure?: string): number => {\n  const origin = getUnit(from, measure) ?? throwUnsupportedUnitError(from, getPossibilities());\n  const dest = getUnit(to, measure) ?? throwUnsupportedUnitError(to, getPossibilities());\n\n  if (origin.abbr === dest.abbr) return value;\n\n  let src = origin;\n  let tgt = dest;\n\n  if (dest.measure !== origin.measure) {\n    if (measure) throwIncompatibleMeasuresError(dest.measure, origin.measure);\n    [tgt, src] =\n      getUnitForPair(dest.abbr, origin.abbr) ?? throwIncompatibleMeasuresError(dest.measure, origin.measure);\n  }\n\n  let result = value * src.unit.to_anchor;\n  if (src.unit.anchor_shift) result -= src.unit.anchor_shift;\n\n  if (src.system !== tgt.system) {\n    const anchor = measures[src.measure]._anchors[src.system];\n    result = typeof anchor.transform === 'function' ? anchor.transform(result) : result * anchor.ratio!;\n  }\n\n  if (tgt.unit.anchor_shift) result += tgt.unit.anchor_shift;\n  return result / tgt.unit.to_anchor;\n};\n\nconst toBest = (\n  value: number,\n  from: string,\n  measure?: string,\n  exclude: string[] = [],\n): ConversionResult | undefined => {\n  const origin = getUnit(from, measure);\n  if (!origin) return undefined;\n\n  let best: ConversionResult | undefined;\n\n  for (const abbr of getPossibilities(origin.measure)) {\n    if (exclude.includes(abbr)) continue;\n    const entry = measureIndex.get(origin.measure)?.find((e) => e.abbr === abbr);\n    if (!entry || entry.system !== origin.system) continue;\n\n    const result = convert(value, from, abbr, origin.measure);\n    const { singular, plural, display } = toPlainUnit(entry);\n    if (!best || (result >= 1 && result < best.val)) {\n      best = { val: result, unit: abbr, singular, plural, display };\n    }\n  }\n\n  return best;\n};\n\nconst getMeasures = (): string[] => Object.keys(measures);\n\nconst describe = (abbr: string): PlainUnit =>\n  toPlainUnit(getUnit(abbr) ?? throwUnsupportedUnitError(abbr, getPossibilities()));\n\nconst listUnitsWithAliases = (measure?: string): PlainUnit[] => listUnits(measure, true);\n\nconst possibilities = (measure?: string): string[] => getPossibilities(measure);\n\nconst getUnitKeyByAlias = (alias: string): string | undefined => aliasMap.get(alias);\n\nexport {\n  measures,\n  bucketMapping,\n  aliasMap,\n  getUnit,\n  getUnitForPair,\n  toPlainUnit,\n  listUnits,\n  listUnitsWithAliases,\n  getMeasures,\n  describe,\n  possibilities,\n  getUnitKeyByAlias,\n  getPossibilities,\n  convert,\n  toBest,\n};\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@corva/convert-units",
+  "version": "3.1.0",
+  "description": "Convert between quantities in different units",
+  "type": "module",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "definitions"
+  ],
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "node --experimental-vm-modules node_modules/.bin/jest"
+  },
+  "devDependencies": {
+    "@types/jest": "^29",
+    "@types/node": "^24",
+    "jest": "^30",
+    "ts-jest": "^29",
+    "tsup": "^8.5.1",
+    "typescript": "^5.8"
+  },
+  "author": "Corva.ai",
+  "license": "MIT"
+}