uconvert 0.1.1 → 0.1.3

package/README.md

@@ -0,0 +1,198 @@
+# uconvert
+
+Lightweight utility for converting common measurement units.
+
+## Installation
+
+```bash
+npm install uconvert
+```
+
+## Usage
+
+### `convert(value, options)`
+
+Converts a numeric value from one unit to another.
+
+**Parameters:**
+
+- `value` (number) — The value in the source unit.
+- `options` (object):
+  - `fromUnits` — Source unit (use `MetricUnits` or `ImperialUnits`).
+  - `toUnits` — Target unit. Must be the same dimension as `fromUnits` (e.g. length ↔ length), or an error is thrown.
+  - `roundTo` (optional) — Number of decimal places to round the result. Omit to return the unrounded value.
+
+**Returns:** The value in the target unit (optionally rounded).
+
+**Example:**
+
+```ts
+import { convert, MetricUnits, ImperialUnits } from "uconvert";
+
+// 5 feet to meters, rounded to 2 decimals
+convert(5, {
+  fromUnits: ImperialUnits.FT,
+  toUnits: MetricUnits.M,
+  roundTo: 2,
+});
+// => 1.52
+
+// Same unit: returns value unchanged
+convert(100, { fromUnits: MetricUnits.CM, toUnits: MetricUnits.CM });
+// => 100
+```
+
+### `round(value, decimalPlaces?)`
+
+Rounds a number to a given number of decimal places.
+
+**Parameters:**
+
+- `value` (number) — The number to round.
+- `decimalPlaces` (optional) — Number of digits after the decimal point. Omit to return the value unchanged.
+
+**Returns:** The rounded number (or the original number if `decimalPlaces` is omitted).
+
+**Example:**
+
+```ts
+import { round } from "uconvert";
+
+round(1.2345, 2); // => 1.23
+round(1.2345); // => 1.2345
+```
+
+## Supported units
+
+Units are grouped by dimension. Use the **Code** value with `convert()`.
+
+### Length
+
+| Unit | Code               | System   |
+| ---- | ------------------ | -------- |
+| mm   | `MetricUnits.MM`   | Metric   |
+| cm   | `MetricUnits.CM`   | Metric   |
+| m    | `MetricUnits.M`    | Metric   |
+| km   | `MetricUnits.KM`   | Metric   |
+| in   | `ImperialUnits.IN` | Imperial |
+| ft   | `ImperialUnits.FT` | Imperial |
+| yd   | `ImperialUnits.YD` | Imperial |
+| mi   | `ImperialUnits.MI` | Imperial |
+
+### Weight
+
+| Unit | Code                | System   |
+| ---- | ------------------- | -------- |
+| g    | `MetricUnits.G`     | Metric   |
+| kg   | `MetricUnits.KG`    | Metric   |
+| t    | `MetricUnits.TONNE` | Metric   |
+| oz   | `ImperialUnits.OZ`  | Imperial |
+| lb   | `ImperialUnits.LB`  | Imperial |
+| st   | `ImperialUnits.ST`  | Imperial |
+
+### Speed
+
+| Unit | Code                 | System   |
+| ---- | -------------------- | -------- |
+| m/s  | `MetricUnits.M_S`    | Metric   |
+| km/h | `MetricUnits.KM_H`   | Metric   |
+| ft/s | `ImperialUnits.FT_S` | Imperial |
+| mph  | `ImperialUnits.MPH`  | Imperial |
+
+### Temperature
+
+| Unit   | Code                       | System   |
+| ------ | -------------------------- | -------- |
+| °C (C) | `MetricUnits.CELSIUS`      | Metric   |
+| K      | `MetricUnits.KELVIN`       | Metric   |
+| °F (F) | `ImperialUnits.FAHRENHEIT` | Imperial |
+
+## Exported types and enums
+
+Use these with `convert` for type-safe unit arguments:
+
+| Export           | Description                                                                          |
+| ---------------- | ------------------------------------------------------------------------------------ |
+| `ConvertOptions` | Options object for `convert`: `{ fromUnits, toUnits, roundTo? }`.                    |
+| `Units`          | Union type: `MetricUnits \| ImperialUnits`.                                          |
+| `MetricUnits`    | Enum: `MM`, `CM`, `M`, `KM`, `G`, `KG`, `TONNE`, `CELSIUS`, `KELVIN`, `M_S`, `KM_H`. |
+| `ImperialUnits`  | Enum: `IN`, `FT`, `YD`, `MI`, `OZ`, `LB`, `ST`, `FAHRENHEIT`, `FT_S`, `MPH`.         |
+| `UnitSystem`     | Enum: `METRIC`, `IMPERIAL`.                                                          |
+| `Dimension`      | Enum: `LENGTH`, `WEIGHT`, `SPEED`, `TEMPERATURE`.                                    |
+
+`fromUnits` and `toUnits` must use the same dimension (e.g. both length, or both weight); otherwise `convert` throws.
+
+---
+
+## Height utility
+
+The `height` object provides helpers for converting between centimeters and feet–inches and for parsing feet–inches strings.
+
+**Import:**
+
+```ts
+import { height } from "uconvert";
+```
+
+### `height.toFeetInches(valueInCm, roundTo?)`
+
+Converts a height in centimeters to feet and inches.
+
+**Parameters:**
+
+- `valueInCm` (number) — Height in centimeters.
+- `roundTo` (optional) — Number of decimal places for the inches part. Omit for unrounded.
+
+**Returns:** A `FeetInches` tuple `[feet, inches]`.
+
+**Example:**
+
+```ts
+height.toFeetInches(170); // => [5, 6.93...]
+height.toFeetInches(170, 1); // => [5, 6.9]
+```
+
+### `height.toCentimeters(feetInches)`
+
+Converts a feet–inches tuple to centimeters.
+
+**Parameters:**
+
+- `feetInches` — A `FeetInches` tuple `[feet, inches]` (e.g. from `toFeetInches` or `parseFeetInches`).
+
+**Returns:** Height in centimeters (number).
+
+**Example:**
+
+```ts
+height.toCentimeters([5, 10]); // => 177.8
+```
+
+### `height.parseFeetInches(input)`
+
+Parses a string into a `[feet, inches]` tuple. Accepts formats like `"5 ft 10 in"`, `"5'10\""`, `"5 10"`, and variations with "feet"/"foot"/"inches"/"inch".
+
+**Parameters:**
+
+- `input` (string) — String to parse.
+
+**Returns:** A `FeetInches` tuple `[feet, inches]`. Returns `[0, 0]` if parsing fails or input is not a string.
+
+**Example:**
+
+```ts
+height.parseFeetInches("5 ft 10 in"); // => [5, 10]
+height.parseFeetInches("5'10\""); // => [5, 10]
+height.parseFeetInches("6 2"); // => [6, 2]
+```
+
+### `FeetInches` type
+
+Tuple type `[number, number]`: first element is feet, second is inches. Use it when passing or receiving values from `toFeetInches`, `toCentimeters`, and `parseFeetInches`.
+
+```ts
+import { height, type FeetInches } from "uconvert";
+
+const fi: FeetInches = height.toFeetInches(170);
+height.toCentimeters(fi);
+```

package/dist/index.d.mts

@@ -3,30 +3,40 @@ declare enum UnitSystem {
     IMPERIAL = "Imperial"
 }
 declare enum Dimension {
-    LENGTH = "length",
-    WEIGHT = "weight",
-    SPEED = "speed"
-}
-declare enum MeasurementType {
     LENGTH = "length",
     WEIGHT = "weight",
     SPEED = "speed",
-    HEIGHT = "height",
-    LENGTH_FEET = "length_feet"
+    TEMPERATURE = "temperature"
 }
 declare enum MetricUnits {
+    MM = "mm",
     CM = "cm",
     M = "m",
+    KM = "km",
+    G = "g",
     KG = "kg",
+    TONNE = "t",
+    CELSIUS = "C",
+    KELVIN = "K",
+    M_S = "m/s",
     KM_H = "km/h"
 }
 declare enum ImperialUnits {
     IN = "in",
     FT = "ft",
+    YD = "yd",
+    MI = "mi",
+    OZ = "oz",
     LB = "lb",
+    ST = "st",
+    FAHRENHEIT = "F",
+    FT_S = "ft/s",
     MPH = "mph"
 }
 type Units = MetricUnits | ImperialUnits;
+type TemperatureUnits = MetricUnits.CELSIUS | MetricUnits.KELVIN | ImperialUnits.FAHRENHEIT;
+
+type FeetInches = [number, number];
 
 interface ConvertOptions {
     fromUnits: Units;
@@ -34,12 +44,10 @@ interface ConvertOptions {
     roundTo?: number;
 }
 
-declare const convert: (value: number, { fromUnits, toUnits, roundTo }: ConvertOptions) => number;
+declare const convert: (value: number, options: ConvertOptions) => number;
 
 declare const round: (value: number, decimalPlaces?: number) => number;
 
-type FeetInches = [number, number];
-
 declare class Height {
     toFeetInches(valueInCm: number, roundTo?: number): FeetInches;
     toCentimeters([feet, inches]: FeetInches): number;
@@ -47,4 +55,4 @@ declare class Height {
 }
 declare const height: Height;
 
-export { type ConvertOptions, Dimension, ImperialUnits, MeasurementType, MetricUnits, UnitSystem, type Units, convert, height, round };
+export { type ConvertOptions, Dimension, type FeetInches, ImperialUnits, MetricUnits, type TemperatureUnits, UnitSystem, type Units, convert, height, round };

package/dist/index.d.ts

@@ -3,30 +3,40 @@ declare enum UnitSystem {
     IMPERIAL = "Imperial"
 }
 declare enum Dimension {
-    LENGTH = "length",
-    WEIGHT = "weight",
-    SPEED = "speed"
-}
-declare enum MeasurementType {
     LENGTH = "length",
     WEIGHT = "weight",
     SPEED = "speed",
-    HEIGHT = "height",
-    LENGTH_FEET = "length_feet"
+    TEMPERATURE = "temperature"
 }
 declare enum MetricUnits {
+    MM = "mm",
     CM = "cm",
     M = "m",
+    KM = "km",
+    G = "g",
     KG = "kg",
+    TONNE = "t",
+    CELSIUS = "C",
+    KELVIN = "K",
+    M_S = "m/s",
     KM_H = "km/h"
 }
 declare enum ImperialUnits {
     IN = "in",
     FT = "ft",
+    YD = "yd",
+    MI = "mi",
+    OZ = "oz",
     LB = "lb",
+    ST = "st",
+    FAHRENHEIT = "F",
+    FT_S = "ft/s",
     MPH = "mph"
 }
 type Units = MetricUnits | ImperialUnits;
+type TemperatureUnits = MetricUnits.CELSIUS | MetricUnits.KELVIN | ImperialUnits.FAHRENHEIT;
+
+type FeetInches = [number, number];
 
 interface ConvertOptions {
     fromUnits: Units;
@@ -34,12 +44,10 @@ interface ConvertOptions {
     roundTo?: number;
 }
 
-declare const convert: (value: number, { fromUnits, toUnits, roundTo }: ConvertOptions) => number;
+declare const convert: (value: number, options: ConvertOptions) => number;
 
 declare const round: (value: number, decimalPlaces?: number) => number;
 
-type FeetInches = [number, number];
-
 declare class Height {
     toFeetInches(valueInCm: number, roundTo?: number): FeetInches;
     toCentimeters([feet, inches]: FeetInches): number;
@@ -47,4 +55,4 @@ declare class Height {
 }
 declare const height: Height;
 
-export { type ConvertOptions, Dimension, ImperialUnits, MeasurementType, MetricUnits, UnitSystem, type Units, convert, height, round };
+export { type ConvertOptions, Dimension, type FeetInches, ImperialUnits, MetricUnits, type TemperatureUnits, UnitSystem, type Units, convert, height, round };

package/dist/index.js

@@ -22,7 +22,6 @@ var index_exports = {};
 __export(index_exports, {
   Dimension: () => Dimension,
   ImperialUnits: () => ImperialUnits,
-  MeasurementType: () => MeasurementType,
   MetricUnits: () => MetricUnits,
   UnitSystem: () => UnitSystem,
   convert: () => convert,
@@ -41,59 +40,129 @@ var Dimension = /* @__PURE__ */ ((Dimension2) => {
   Dimension2["LENGTH"] = "length";
   Dimension2["WEIGHT"] = "weight";
   Dimension2["SPEED"] = "speed";
+  Dimension2["TEMPERATURE"] = "temperature";
   return Dimension2;
 })(Dimension || {});
-var MeasurementType = /* @__PURE__ */ ((MeasurementType2) => {
-  MeasurementType2["LENGTH"] = "length";
-  MeasurementType2["WEIGHT"] = "weight";
-  MeasurementType2["SPEED"] = "speed";
-  MeasurementType2["HEIGHT"] = "height";
-  MeasurementType2["LENGTH_FEET"] = "length_feet";
-  return MeasurementType2;
-})(MeasurementType || {});
 var MetricUnits = /* @__PURE__ */ ((MetricUnits2) => {
+  MetricUnits2["MM"] = "mm";
   MetricUnits2["CM"] = "cm";
   MetricUnits2["M"] = "m";
+  MetricUnits2["KM"] = "km";
+  MetricUnits2["G"] = "g";
   MetricUnits2["KG"] = "kg";
+  MetricUnits2["TONNE"] = "t";
+  MetricUnits2["CELSIUS"] = "C";
+  MetricUnits2["KELVIN"] = "K";
+  MetricUnits2["M_S"] = "m/s";
   MetricUnits2["KM_H"] = "km/h";
   return MetricUnits2;
 })(MetricUnits || {});
 var ImperialUnits = /* @__PURE__ */ ((ImperialUnits2) => {
   ImperialUnits2["IN"] = "in";
   ImperialUnits2["FT"] = "ft";
+  ImperialUnits2["YD"] = "yd";
+  ImperialUnits2["MI"] = "mi";
+  ImperialUnits2["OZ"] = "oz";
   ImperialUnits2["LB"] = "lb";
+  ImperialUnits2["ST"] = "st";
+  ImperialUnits2["FAHRENHEIT"] = "F";
+  ImperialUnits2["FT_S"] = "ft/s";
   ImperialUnits2["MPH"] = "mph";
   return ImperialUnits2;
 })(ImperialUnits || {});
 
-// src/utils/math/math.ts
-var round = (value, decimalPlaces) => {
-  if (decimalPlaces === void 0) return value;
-  return parseFloat(value.toFixed(decimalPlaces));
-};
-
 // src/constants/conversion/conversion.constants.ts
 var UNIT_TO_CANONICAL = {
+  ["mm" /* MM */]: 0.1,
   ["cm" /* CM */]: 1,
   ["m" /* M */]: 100,
+  ["km" /* KM */]: 1e5,
   ["in" /* IN */]: 2.54,
   ["ft" /* FT */]: 30.48,
+  ["yd" /* YD */]: 91.44,
+  ["mi" /* MI */]: 160934.4,
+  ["g" /* G */]: 1e-3,
   ["kg" /* KG */]: 1,
+  ["t" /* TONNE */]: 1e3,
+  ["C" /* CELSIUS */]: 1,
+  ["K" /* KELVIN */]: 1,
+  ["F" /* FAHRENHEIT */]: 1,
+  ["oz" /* OZ */]: 0.028349523125,
   ["lb" /* LB */]: 0.45359237,
+  ["st" /* ST */]: 6.35029318,
+  ["m/s" /* M_S */]: 3.6,
   ["km/h" /* KM_H */]: 1,
+  ["ft/s" /* FT_S */]: 1.09728,
   ["mph" /* MPH */]: 1.609344
 };
 var UNIT_DIMENSION = {
+  ["mm" /* MM */]: "length" /* LENGTH */,
   ["cm" /* CM */]: "length" /* LENGTH */,
   ["m" /* M */]: "length" /* LENGTH */,
+  ["km" /* KM */]: "length" /* LENGTH */,
   ["in" /* IN */]: "length" /* LENGTH */,
   ["ft" /* FT */]: "length" /* LENGTH */,
+  ["yd" /* YD */]: "length" /* LENGTH */,
+  ["mi" /* MI */]: "length" /* LENGTH */,
+  ["g" /* G */]: "weight" /* WEIGHT */,
   ["kg" /* KG */]: "weight" /* WEIGHT */,
+  ["t" /* TONNE */]: "weight" /* WEIGHT */,
+  ["C" /* CELSIUS */]: "temperature" /* TEMPERATURE */,
+  ["K" /* KELVIN */]: "temperature" /* TEMPERATURE */,
+  ["F" /* FAHRENHEIT */]: "temperature" /* TEMPERATURE */,
+  ["oz" /* OZ */]: "weight" /* WEIGHT */,
   ["lb" /* LB */]: "weight" /* WEIGHT */,
+  ["st" /* ST */]: "weight" /* WEIGHT */,
+  ["m/s" /* M_S */]: "speed" /* SPEED */,
   ["km/h" /* KM_H */]: "speed" /* SPEED */,
+  ["ft/s" /* FT_S */]: "speed" /* SPEED */,
   ["mph" /* MPH */]: "speed" /* SPEED */
 };
 
+// src/constants/temperature/temperature.ts
+var TEMPERATURE_TO_KELVIN_SCALE = {
+  ["C" /* CELSIUS */]: 1,
+  ["K" /* KELVIN */]: 1,
+  ["F" /* FAHRENHEIT */]: 5 / 9
+};
+var TEMPERATURE_TO_KELVIN_OFFSET = {
+  ["C" /* CELSIUS */]: 273.15,
+  ["K" /* KELVIN */]: 0,
+  ["F" /* FAHRENHEIT */]: 273.15 - 32 * 5 / 9
+};
+var TEMPERATURE_FROM_KELVIN_SCALE = {
+  ["C" /* CELSIUS */]: 1,
+  ["K" /* KELVIN */]: 1,
+  ["F" /* FAHRENHEIT */]: 9 / 5
+};
+var TEMPERATURE_FROM_KELVIN_OFFSET = {
+  ["C" /* CELSIUS */]: -273.15,
+  ["K" /* KELVIN */]: 0,
+  ["F" /* FAHRENHEIT */]: -459.67
+};
+
+// src/utils/math/math.ts
+var round = (value, decimalPlaces) => {
+  if (decimalPlaces === void 0) return value;
+  return parseFloat(value.toFixed(decimalPlaces));
+};
+
+// src/utils/temperature/temperature.utils.ts
+var isTemperature = ({ fromUnits }) => UNIT_DIMENSION[fromUnits] === "temperature" /* TEMPERATURE */;
+var toKelvin = (value, units) => value * TEMPERATURE_TO_KELVIN_SCALE[units] + TEMPERATURE_TO_KELVIN_OFFSET[units];
+var fromKelvin = (value, units) => value * TEMPERATURE_FROM_KELVIN_SCALE[units] + TEMPERATURE_FROM_KELVIN_OFFSET[units];
+var convertTemperature = (value, { fromUnits, toUnits, roundTo }) => {
+  if (fromUnits === toUnits) return round(value, roundTo);
+  const valueInKelvin = toKelvin(value, fromUnits);
+  const result = fromKelvin(valueInKelvin, toUnits);
+  return round(result, roundTo);
+};
+var temperatureUtils = {
+  isTemperature,
+  convertTemperature
+};
+var temperature_utils_default = temperatureUtils;
+
 // src/constants/strings/strings.ts
 var strings = {
   convertDimensionMismatch: "Cannot convert between different dimensions: {0} ({1}) and {2} ({3})"
@@ -122,24 +191,42 @@ var throwConversionError = ({ fromUnits, toUnits }) => {
 };
 var getFactor = (fromUnits, toUnits) => {
   if (fromUnits === toUnits) return 1;
-  const fromDim = UNIT_DIMENSION[fromUnits];
-  const toDim = UNIT_DIMENSION[toUnits];
-  if (fromDim !== toDim) throwConversionError({ fromUnits, toUnits });
   const toCanonicalFrom = UNIT_TO_CANONICAL[fromUnits];
   const toCanonicalTo = UNIT_TO_CANONICAL[toUnits];
   return toCanonicalFrom / toCanonicalTo;
 };
+var ensureSameDimension = ({ fromUnits, toUnits }) => {
+  const fromDim = UNIT_DIMENSION[fromUnits];
+  const toDim = UNIT_DIMENSION[toUnits];
+  if (fromDim !== toDim) throwConversionError({ fromUnits, toUnits });
+};
+var convertDefault = (value, { fromUnits, toUnits, roundTo }) => {
+  const factor = getFactor(fromUnits, toUnits);
+  return round(value * factor, roundTo);
+};
 var convertUtils = {
-  getFactor
+  convertDefault,
+  ensureSameDimension
 };
 var convert_utils_default = convertUtils;
 
 // src/utils/convert/convert.ts
-var { getFactor: getFactor2 } = convert_utils_default;
-var convert = (value, { fromUnits, toUnits, roundTo }) => {
-  const factor = getFactor2(fromUnits, toUnits);
-  return round(value * factor, roundTo);
+var { convertDefault: convertDefault2, ensureSameDimension: ensureSameDimension2 } = convert_utils_default;
+var { isTemperature: isTemperature2, convertTemperature: convertTemperature2 } = temperature_utils_default;
+var convert = (value, options) => {
+  ensureSameDimension2(options);
+  if (isTemperature2(options)) {
+    return convertTemperature2(value, options);
+  }
+  return convertDefault2(value, options);
+};
+
+// src/services/height/height.constants.ts
+var inchesPerFoot = 12;
+var heightConstants = {
+  inchesPerFoot
 };
+var height_constants_default = heightConstants;
 
 // src/services/height/height.utils.ts
 var parseFeetInches = (input) => {
@@ -176,6 +263,7 @@ var height_utils_default = heightUtils;
 
 // src/services/height/height.ts
 var { parseFeetInches: parseFeetInches2 } = height_utils_default;
+var { inchesPerFoot: inchesPerFoot2 } = height_constants_default;
 var Height = class {
   toFeetInches(valueInCm, roundTo) {
     const totalInches = convert(valueInCm, {
@@ -183,12 +271,12 @@ var Height = class {
       toUnits: "in" /* IN */,
       roundTo
     });
-    const feet = Math.floor(totalInches / 12);
-    const inches = round(totalInches - feet * 12, roundTo);
+    const feet = Math.floor(totalInches / inchesPerFoot2);
+    const inches = round(totalInches - feet * inchesPerFoot2, roundTo);
     return [feet, inches];
   }
   toCentimeters([feet, inches]) {
-    const totalInches = feet * 12 + inches;
+    const totalInches = feet * inchesPerFoot2 + inches;
     return convert(totalInches, {
       fromUnits: "in" /* IN */,
       toUnits: "cm" /* CM */
@@ -204,7 +292,6 @@ var height_default = height;
 0 && (module.exports = {
   Dimension,
   ImperialUnits,
-  MeasurementType,
   MetricUnits,
   UnitSystem,
   convert,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/constants/common/common.constants.ts","../src/utils/math/math.ts","../src/constants/conversion/conversion.constants.ts","../src/constants/strings/strings.ts","../src/utils/strings/strings.utils.ts","../src/utils/convert/convert.utils.ts","../src/utils/convert/convert.ts","../src/services/height/height.utils.ts","../src/services/height/height.ts"],"sourcesContent":["export * from \"./constants/common/common.constants\";\nexport * from \"./utils/convert/convert\";\nexport * from \"./utils/convert/convert.types\";\nexport * from \"./utils/math/math\";\n\nexport { default as height } from \"./services/height/height\";\n","export enum UnitSystem {\n  METRIC = \"Si\",\n  IMPERIAL = \"Imperial\",\n}\n\nexport enum Dimension {\n  LENGTH = \"length\",\n  WEIGHT = \"weight\",\n  SPEED = \"speed\",\n}\n\nexport enum MeasurementType {\n  LENGTH = \"length\",\n  WEIGHT = \"weight\",\n  SPEED = \"speed\",\n  HEIGHT = \"height\",\n  LENGTH_FEET = \"length_feet\",\n}\n\nexport enum MetricUnits {\n  CM = \"cm\",\n  M = \"m\",\n  KG = \"kg\",\n  KM_H = \"km/h\",\n}\n\nexport enum ImperialUnits {\n  IN = \"in\",\n  FT = \"ft\",\n  LB = \"lb\",\n  MPH = \"mph\",\n}\n\nexport type Units = MetricUnits | ImperialUnits;\n","export const round = (value: number, decimalPlaces?: number) => {\n  if (decimalPlaces === undefined) return value;\n\n  return parseFloat(value.toFixed(decimalPlaces));\n};\n","import {\n  Dimension,\n  ImperialUnits,\n  MetricUnits,\n  Units,\n} from \"../common/common.constants\";\n\n/** Factor to multiply value by to get value in canonical unit for that dimension. */\nexport const UNIT_TO_CANONICAL: Record<Units, number> = {\n  [MetricUnits.CM]: 1,\n  [MetricUnits.M]: 100,\n  [ImperialUnits.IN]: 2.54,\n  [ImperialUnits.FT]: 30.48,\n  [MetricUnits.KG]: 1,\n  [ImperialUnits.LB]: 0.45359237,\n  [MetricUnits.KM_H]: 1,\n  [ImperialUnits.MPH]: 1.609344,\n};\n\nexport const UNIT_DIMENSION: Record<Units, Dimension> = {\n  [MetricUnits.CM]: Dimension.LENGTH,\n  [MetricUnits.M]: Dimension.LENGTH,\n  [ImperialUnits.IN]: Dimension.LENGTH,\n  [ImperialUnits.FT]: Dimension.LENGTH,\n  [MetricUnits.KG]: Dimension.WEIGHT,\n  [ImperialUnits.LB]: Dimension.WEIGHT,\n  [MetricUnits.KM_H]: Dimension.SPEED,\n  [ImperialUnits.MPH]: Dimension.SPEED,\n};\n","const strings = {\n  convertDimensionMismatch:\n    \"Cannot convert between different dimensions: {0} ({1}) and {2} ({3})\",\n};\n\nexport default strings;\n","export const formatMessage = (message: string, ...args: any[]) =>\n  message.replace(/{(\\d+)}/g, (match, number) =>\n    args[number] !== undefined ? args[number] : match,\n  );\n","import { Units } from \"../../constants/common/common.constants\";\nimport {\n  UNIT_DIMENSION,\n  UNIT_TO_CANONICAL,\n} from \"../../constants/conversion/conversion.constants\";\nimport strings from \"../../constants/strings/strings\";\nimport { round } from \"../math/math\";\nimport { formatMessage } from \"../strings/strings.utils\";\nimport { ConvertOptions } from \"./convert.types\";\n\nconst throwConversionError = ({ fromUnits, toUnits }: ConvertOptions) => {\n  const fromDim = UNIT_DIMENSION[fromUnits];\n  const toDim = UNIT_DIMENSION[toUnits];\n\n  throw new Error(\n    formatMessage(\n      strings.convertDimensionMismatch,\n      fromUnits,\n      fromDim,\n      toUnits,\n      toDim,\n    ),\n  );\n};\n\nconst getFactor = (fromUnits: Units, toUnits: Units) => {\n  if (fromUnits === toUnits) return 1;\n\n  const fromDim = UNIT_DIMENSION[fromUnits];\n  const toDim = UNIT_DIMENSION[toUnits];\n\n  if (fromDim !== toDim) throwConversionError({ fromUnits, toUnits });\n\n  const toCanonicalFrom = UNIT_TO_CANONICAL[fromUnits];\n  const toCanonicalTo = UNIT_TO_CANONICAL[toUnits];\n  return toCanonicalFrom / toCanonicalTo;\n};\n\nconst convertUtils = {\n  getFactor,\n};\n\nexport default convertUtils;\n","import { round } from \"../math/math\";\nimport { ConvertOptions } from \"./convert.types\";\nimport utils from \"./convert.utils\";\n\nconst { getFactor } = utils;\n\nexport const convert = (\n  value: number,\n  { fromUnits, toUnits, roundTo }: ConvertOptions,\n) => {\n  const factor = getFactor(fromUnits, toUnits);\n\n  return round(value * factor, roundTo);\n};\n","import { FeetInches } from \"./height.types\";\n\nconst parseFeetInches = (input: string): FeetInches => {\n  // NOTE: this function is AI generated, but it's well tested and works as expected. And it's covered by unit tests.\n  if (typeof input !== \"string\") return [0, 0];\n\n  const normalized = input\n    .toLowerCase()\n    .replace(/[\"\"]/g, \"in\")\n    .replace(/[''′]+/g, \"ft\")\n    .replace(/(feet|foot)/g, \"ft\")\n    .replace(/(inches|inch)/g, \"in\")\n    .replace(/[\\s]+/g, \" \")\n    .trim();\n\n  const parseNumber = (value: string | undefined): number =>\n    parseFloat(value || \"0\");\n\n  const ftMatch = normalized.match(/([\\d.]+)\\s*ft/);\n  const inMatch = normalized.match(/([\\d.]+)\\s*in/);\n\n  const feet = parseNumber(ftMatch?.[1]);\n  const inches = parseNumber(inMatch?.[1]);\n\n  if (ftMatch && inMatch) {\n    return [feet, inches];\n  }\n\n  const [firstNumberString, secondNumberString] = normalized.match(\n    /[\\d.]+/g,\n  ) || [\"0\", \"0\"];\n\n  const firstNumber = parseNumber(firstNumberString);\n  const secondNumber = parseNumber(secondNumberString);\n\n  if (!ftMatch && !inMatch) {\n    return [firstNumber, secondNumber];\n  }\n\n  if (ftMatch && !inMatch) {\n    return [feet, secondNumber];\n  }\n\n  if (!ftMatch && inMatch) {\n    return [0, inches];\n  }\n\n  return [0, 0];\n};\n\nconst heightUtils = {\n  parseFeetInches,\n};\n\nexport default heightUtils;\n","import {\n  ImperialUnits,\n  MetricUnits,\n} from \"../../constants/common/common.constants\";\nimport { convert } from \"../../utils/convert/convert\";\nimport { round } from \"../../utils/math/math\";\nimport { FeetInches } from \"./height.types\";\nimport utils from \"./height.utils\";\n\nconst { parseFeetInches } = utils;\n\nclass Height {\n  toFeetInches(valueInCm: number, roundTo?: number): FeetInches {\n    const totalInches = convert(valueInCm, {\n      fromUnits: MetricUnits.CM,\n      toUnits: ImperialUnits.IN,\n      roundTo,\n    });\n\n    const feet = Math.floor(totalInches / 12);\n    const inches = round(totalInches - feet * 12, roundTo);\n\n    return [feet, inches];\n  }\n\n  toCentimeters([feet, inches]: FeetInches): number {\n    const totalInches = feet * 12 + inches;\n\n    return convert(totalInches, {\n      fromUnits: ImperialUnits.IN,\n      toUnits: MetricUnits.CM,\n    });\n  }\n\n  parseFeetInches(input: string): FeetInches {\n    return parseFeetInches(input);\n  }\n}\n\nconst height = new Height();\n\nexport default height;\n"],"mappings":"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","names":["UnitSystem","Dimension","MeasurementType","MetricUnits","ImperialUnits","getFactor","parseFeetInches"]}
+{"version":3,"sources":["../src/index.ts","../src/constants/common/common.constants.ts","../src/constants/conversion/conversion.constants.ts","../src/constants/temperature/temperature.ts","../src/utils/math/math.ts","../src/utils/temperature/temperature.utils.ts","../src/constants/strings/strings.ts","../src/utils/strings/strings.utils.ts","../src/utils/convert/convert.utils.ts","../src/utils/convert/convert.ts","../src/services/height/height.constants.ts","../src/services/height/height.utils.ts","../src/services/height/height.ts"],"sourcesContent":["export * from \"./constants/common/common.constants\";\nexport * from \"./services/height/height.types\";\nexport * from \"./utils/convert/convert\";\nexport * from \"./utils/convert/convert.types\";\nexport * from \"./utils/math/math\";\n\nexport { default as height } from \"./services/height/height\";\n","export enum UnitSystem {\n  METRIC = \"Si\",\n  IMPERIAL = \"Imperial\",\n}\n\nexport enum Dimension {\n  LENGTH = \"length\",\n  WEIGHT = \"weight\",\n  SPEED = \"speed\",\n  TEMPERATURE = \"temperature\",\n}\n\nexport enum MetricUnits {\n  MM = \"mm\",\n  CM = \"cm\",\n  M = \"m\",\n  KM = \"km\",\n  G = \"g\",\n  KG = \"kg\",\n  TONNE = \"t\",\n  CELSIUS = \"C\",\n  KELVIN = \"K\",\n  M_S = \"m/s\",\n  KM_H = \"km/h\",\n}\n\nexport enum ImperialUnits {\n  IN = \"in\",\n  FT = \"ft\",\n  YD = \"yd\",\n  MI = \"mi\",\n  OZ = \"oz\",\n  LB = \"lb\",\n  ST = \"st\",\n  FAHRENHEIT = \"F\",\n  FT_S = \"ft/s\",\n  MPH = \"mph\",\n}\n\nexport type Units = MetricUnits | ImperialUnits;\n\nexport type TemperatureUnits =\n  | MetricUnits.CELSIUS\n  | MetricUnits.KELVIN\n  | ImperialUnits.FAHRENHEIT;\n","import {\n  Dimension,\n  ImperialUnits,\n  MetricUnits,\n  Units,\n} from \"../common/common.constants\";\n\n/** Factor to multiply value by to get value in canonical unit for that dimension. */\nexport const UNIT_TO_CANONICAL: Record<Units, number> = {\n  [MetricUnits.MM]: 0.1,\n  [MetricUnits.CM]: 1,\n  [MetricUnits.M]: 100,\n  [MetricUnits.KM]: 100_000,\n  [ImperialUnits.IN]: 2.54,\n  [ImperialUnits.FT]: 30.48,\n  [ImperialUnits.YD]: 91.44,\n  [ImperialUnits.MI]: 160934.4,\n  [MetricUnits.G]: 0.001,\n  [MetricUnits.KG]: 1,\n  [MetricUnits.TONNE]: 1000,\n  [MetricUnits.CELSIUS]: 1,\n  [MetricUnits.KELVIN]: 1,\n  [ImperialUnits.FAHRENHEIT]: 1,\n  [ImperialUnits.OZ]: 0.028349523125,\n  [ImperialUnits.LB]: 0.45359237,\n  [ImperialUnits.ST]: 6.35029318,\n  [MetricUnits.M_S]: 3.6,\n  [MetricUnits.KM_H]: 1,\n  [ImperialUnits.FT_S]: 1.09728,\n  [ImperialUnits.MPH]: 1.609344,\n};\n\nexport const UNIT_DIMENSION: Record<Units, Dimension> = {\n  [MetricUnits.MM]: Dimension.LENGTH,\n  [MetricUnits.CM]: Dimension.LENGTH,\n  [MetricUnits.M]: Dimension.LENGTH,\n  [MetricUnits.KM]: Dimension.LENGTH,\n  [ImperialUnits.IN]: Dimension.LENGTH,\n  [ImperialUnits.FT]: Dimension.LENGTH,\n  [ImperialUnits.YD]: Dimension.LENGTH,\n  [ImperialUnits.MI]: Dimension.LENGTH,\n  [MetricUnits.G]: Dimension.WEIGHT,\n  [MetricUnits.KG]: Dimension.WEIGHT,\n  [MetricUnits.TONNE]: Dimension.WEIGHT,\n  [MetricUnits.CELSIUS]: Dimension.TEMPERATURE,\n  [MetricUnits.KELVIN]: Dimension.TEMPERATURE,\n  [ImperialUnits.FAHRENHEIT]: Dimension.TEMPERATURE,\n  [ImperialUnits.OZ]: Dimension.WEIGHT,\n  [ImperialUnits.LB]: Dimension.WEIGHT,\n  [ImperialUnits.ST]: Dimension.WEIGHT,\n  [MetricUnits.M_S]: Dimension.SPEED,\n  [MetricUnits.KM_H]: Dimension.SPEED,\n  [ImperialUnits.FT_S]: Dimension.SPEED,\n  [ImperialUnits.MPH]: Dimension.SPEED,\n};\n","import {\n  ImperialUnits,\n  MetricUnits,\n  TemperatureUnits,\n} from \"../common/common.constants\";\n\n/** Temperature: value in Kelvin = value * scale + offset */\nexport const TEMPERATURE_TO_KELVIN_SCALE: Record<TemperatureUnits, number> = {\n  [MetricUnits.CELSIUS]: 1,\n  [MetricUnits.KELVIN]: 1,\n  [ImperialUnits.FAHRENHEIT]: 5 / 9,\n};\nexport const TEMPERATURE_TO_KELVIN_OFFSET: Record<TemperatureUnits, number> = {\n  [MetricUnits.CELSIUS]: 273.15,\n  [MetricUnits.KELVIN]: 0,\n  [ImperialUnits.FAHRENHEIT]: 273.15 - (32 * 5) / 9,\n};\n\n/** Temperature: value in unit = value_K * scale + offset */\nexport const TEMPERATURE_FROM_KELVIN_SCALE: Record<TemperatureUnits, number> = {\n  [MetricUnits.CELSIUS]: 1,\n  [MetricUnits.KELVIN]: 1,\n  [ImperialUnits.FAHRENHEIT]: 9 / 5,\n};\n\nexport const TEMPERATURE_FROM_KELVIN_OFFSET: Record<TemperatureUnits, number> =\n  {\n    [MetricUnits.CELSIUS]: -273.15,\n    [MetricUnits.KELVIN]: 0,\n    [ImperialUnits.FAHRENHEIT]: -459.67,\n  };\n","export const round = (value: number, decimalPlaces?: number) => {\n  if (decimalPlaces === undefined) return value;\n\n  return parseFloat(value.toFixed(decimalPlaces));\n};\n","import {\n  Dimension,\n  TemperatureUnits,\n} from \"../../constants/common/common.constants\";\nimport { UNIT_DIMENSION } from \"../../constants/conversion/conversion.constants\";\nimport {\n  TEMPERATURE_FROM_KELVIN_OFFSET,\n  TEMPERATURE_FROM_KELVIN_SCALE,\n  TEMPERATURE_TO_KELVIN_OFFSET,\n  TEMPERATURE_TO_KELVIN_SCALE,\n} from \"../../constants/temperature/temperature\";\nimport { ConvertOptions } from \"../convert/convert.types\";\nimport { round } from \"../math/math\";\n\nconst isTemperature = ({ fromUnits }: ConvertOptions): boolean =>\n  UNIT_DIMENSION[fromUnits] === Dimension.TEMPERATURE;\n\nconst toKelvin = (value: number, units: TemperatureUnits): number =>\n  value * TEMPERATURE_TO_KELVIN_SCALE[units] +\n  TEMPERATURE_TO_KELVIN_OFFSET[units];\n\nconst fromKelvin = (value: number, units: TemperatureUnits): number =>\n  value * TEMPERATURE_FROM_KELVIN_SCALE[units] +\n  TEMPERATURE_FROM_KELVIN_OFFSET[units];\n\nconst convertTemperature = (\n  value: number,\n  { fromUnits, toUnits, roundTo }: ConvertOptions,\n): number => {\n  if (fromUnits === toUnits) return round(value, roundTo);\n\n  const valueInKelvin = toKelvin(value, fromUnits as TemperatureUnits);\n\n  const result = fromKelvin(valueInKelvin, toUnits as TemperatureUnits);\n\n  return round(result, roundTo);\n};\n\nconst temperatureUtils = {\n  isTemperature,\n  convertTemperature,\n};\n\nexport default temperatureUtils;\n","const strings = {\n  convertDimensionMismatch:\n    \"Cannot convert between different dimensions: {0} ({1}) and {2} ({3})\",\n};\n\nexport default strings;\n","export const formatMessage = (message: string, ...args: any[]) =>\n  message.replace(/{(\\d+)}/g, (match, number) =>\n    args[number] !== undefined ? args[number] : match,\n  );\n","import { Units } from \"../../constants/common/common.constants\";\nimport {\n  UNIT_DIMENSION,\n  UNIT_TO_CANONICAL,\n} from \"../../constants/conversion/conversion.constants\";\nimport strings from \"../../constants/strings/strings\";\nimport { round } from \"../math/math\";\nimport { formatMessage } from \"../strings/strings.utils\";\nimport { ConvertOptions } from \"./convert.types\";\n\nconst throwConversionError = ({ fromUnits, toUnits }: ConvertOptions) => {\n  const fromDim = UNIT_DIMENSION[fromUnits];\n  const toDim = UNIT_DIMENSION[toUnits];\n\n  throw new Error(\n    formatMessage(\n      strings.convertDimensionMismatch,\n      fromUnits,\n      fromDim,\n      toUnits,\n      toDim,\n    ),\n  );\n};\n\nconst getFactor = (fromUnits: Units, toUnits: Units) => {\n  if (fromUnits === toUnits) return 1;\n\n  const toCanonicalFrom = UNIT_TO_CANONICAL[fromUnits];\n  const toCanonicalTo = UNIT_TO_CANONICAL[toUnits];\n  return toCanonicalFrom / toCanonicalTo;\n};\n\nconst ensureSameDimension = ({ fromUnits, toUnits }: ConvertOptions) => {\n  const fromDim = UNIT_DIMENSION[fromUnits];\n  const toDim = UNIT_DIMENSION[toUnits];\n\n  if (fromDim !== toDim) throwConversionError({ fromUnits, toUnits });\n};\n\nconst convertDefault = (\n  value: number,\n  { fromUnits, toUnits, roundTo }: ConvertOptions,\n): number => {\n  const factor = getFactor(fromUnits, toUnits);\n\n  return round(value * factor, roundTo);\n};\n\nconst convertUtils = {\n  convertDefault,\n  ensureSameDimension,\n};\n\nexport default convertUtils;\n","import temperatureUtils from \"../temperature/temperature.utils\";\nimport { ConvertOptions } from \"./convert.types\";\nimport utils from \"./convert.utils\";\n\nconst { convertDefault, ensureSameDimension } = utils;\nconst { isTemperature, convertTemperature } = temperatureUtils;\n\nexport const convert = (value: number, options: ConvertOptions) => {\n  ensureSameDimension(options);\n\n  if (isTemperature(options)) {\n    return convertTemperature(value, options);\n  }\n\n  return convertDefault(value, options);\n};\n","const inchesPerFoot = 12;\n\nconst heightConstants = {\n  inchesPerFoot,\n};\n\nexport default heightConstants;\n","import { FeetInches } from \"./height.types\";\n\nconst parseFeetInches = (input: string): FeetInches => {\n  // NOTE: this function is AI generated, but it's well tested and works as expected. And it's covered by unit tests.\n  if (typeof input !== \"string\") return [0, 0];\n\n  const normalized = input\n    .toLowerCase()\n    .replace(/[\"\"]/g, \"in\")\n    .replace(/[''′]+/g, \"ft\")\n    .replace(/(feet|foot)/g, \"ft\")\n    .replace(/(inches|inch)/g, \"in\")\n    .replace(/[\\s]+/g, \" \")\n    .trim();\n\n  const parseNumber = (value: string | undefined): number =>\n    parseFloat(value || \"0\");\n\n  const ftMatch = normalized.match(/([\\d.]+)\\s*ft/);\n  const inMatch = normalized.match(/([\\d.]+)\\s*in/);\n\n  const feet = parseNumber(ftMatch?.[1]);\n  const inches = parseNumber(inMatch?.[1]);\n\n  if (ftMatch && inMatch) {\n    return [feet, inches];\n  }\n\n  const [firstNumberString, secondNumberString] = normalized.match(\n    /[\\d.]+/g,\n  ) || [\"0\", \"0\"];\n\n  const firstNumber = parseNumber(firstNumberString);\n  const secondNumber = parseNumber(secondNumberString);\n\n  if (!ftMatch && !inMatch) {\n    return [firstNumber, secondNumber];\n  }\n\n  if (ftMatch && !inMatch) {\n    return [feet, secondNumber];\n  }\n\n  if (!ftMatch && inMatch) {\n    return [0, inches];\n  }\n\n  return [0, 0];\n};\n\nconst heightUtils = {\n  parseFeetInches,\n};\n\nexport default heightUtils;\n","import {\n  ImperialUnits,\n  MetricUnits,\n} from \"../../constants/common/common.constants\";\nimport { convert } from \"../../utils/convert/convert\";\nimport { round } from \"../../utils/math/math\";\nimport constants from \"./height.constants\";\nimport { FeetInches } from \"./height.types\";\nimport utils from \"./height.utils\";\n\nconst { parseFeetInches } = utils;\nconst { inchesPerFoot } = constants;\n\nclass Height {\n  toFeetInches(valueInCm: number, roundTo?: number): FeetInches {\n    const totalInches = convert(valueInCm, {\n      fromUnits: MetricUnits.CM,\n      toUnits: ImperialUnits.IN,\n      roundTo,\n    });\n\n    const feet = Math.floor(totalInches / inchesPerFoot);\n    const inches = round(totalInches - feet * inchesPerFoot, roundTo);\n\n    return [feet, inches];\n  }\n\n  toCentimeters([feet, inches]: FeetInches): number {\n    const totalInches = feet * inchesPerFoot + inches;\n\n    return convert(totalInches, {\n      fromUnits: ImperialUnits.IN,\n      toUnits: MetricUnits.CM,\n    });\n  }\n\n  parseFeetInches(input: string): FeetInches {\n    return parseFeetInches(input);\n  }\n}\n\nconst height = new Height();\n\nexport default height;\n"],"mappings":"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","names":["UnitSystem","Dimension","MetricUnits","ImperialUnits","convertDefault","ensureSameDimension","isTemperature","convertTemperature","parseFeetInches","inchesPerFoot"]}

package/dist/index.mjs

@@ -8,59 +8,129 @@ var Dimension = /* @__PURE__ */ ((Dimension2) => {
   Dimension2["LENGTH"] = "length";
   Dimension2["WEIGHT"] = "weight";
   Dimension2["SPEED"] = "speed";
+  Dimension2["TEMPERATURE"] = "temperature";
   return Dimension2;
 })(Dimension || {});
-var MeasurementType = /* @__PURE__ */ ((MeasurementType2) => {
-  MeasurementType2["LENGTH"] = "length";
-  MeasurementType2["WEIGHT"] = "weight";
-  MeasurementType2["SPEED"] = "speed";
-  MeasurementType2["HEIGHT"] = "height";
-  MeasurementType2["LENGTH_FEET"] = "length_feet";
-  return MeasurementType2;
-})(MeasurementType || {});
 var MetricUnits = /* @__PURE__ */ ((MetricUnits2) => {
+  MetricUnits2["MM"] = "mm";
   MetricUnits2["CM"] = "cm";
   MetricUnits2["M"] = "m";
+  MetricUnits2["KM"] = "km";
+  MetricUnits2["G"] = "g";
   MetricUnits2["KG"] = "kg";
+  MetricUnits2["TONNE"] = "t";
+  MetricUnits2["CELSIUS"] = "C";
+  MetricUnits2["KELVIN"] = "K";
+  MetricUnits2["M_S"] = "m/s";
   MetricUnits2["KM_H"] = "km/h";
   return MetricUnits2;
 })(MetricUnits || {});
 var ImperialUnits = /* @__PURE__ */ ((ImperialUnits2) => {
   ImperialUnits2["IN"] = "in";
   ImperialUnits2["FT"] = "ft";
+  ImperialUnits2["YD"] = "yd";
+  ImperialUnits2["MI"] = "mi";
+  ImperialUnits2["OZ"] = "oz";
   ImperialUnits2["LB"] = "lb";
+  ImperialUnits2["ST"] = "st";
+  ImperialUnits2["FAHRENHEIT"] = "F";
+  ImperialUnits2["FT_S"] = "ft/s";
   ImperialUnits2["MPH"] = "mph";
   return ImperialUnits2;
 })(ImperialUnits || {});
 
-// src/utils/math/math.ts
-var round = (value, decimalPlaces) => {
-  if (decimalPlaces === void 0) return value;
-  return parseFloat(value.toFixed(decimalPlaces));
-};
-
 // src/constants/conversion/conversion.constants.ts
 var UNIT_TO_CANONICAL = {
+  ["mm" /* MM */]: 0.1,
   ["cm" /* CM */]: 1,
   ["m" /* M */]: 100,
+  ["km" /* KM */]: 1e5,
   ["in" /* IN */]: 2.54,
   ["ft" /* FT */]: 30.48,
+  ["yd" /* YD */]: 91.44,
+  ["mi" /* MI */]: 160934.4,
+  ["g" /* G */]: 1e-3,
   ["kg" /* KG */]: 1,
+  ["t" /* TONNE */]: 1e3,
+  ["C" /* CELSIUS */]: 1,
+  ["K" /* KELVIN */]: 1,
+  ["F" /* FAHRENHEIT */]: 1,
+  ["oz" /* OZ */]: 0.028349523125,
   ["lb" /* LB */]: 0.45359237,
+  ["st" /* ST */]: 6.35029318,
+  ["m/s" /* M_S */]: 3.6,
   ["km/h" /* KM_H */]: 1,
+  ["ft/s" /* FT_S */]: 1.09728,
   ["mph" /* MPH */]: 1.609344
 };
 var UNIT_DIMENSION = {
+  ["mm" /* MM */]: "length" /* LENGTH */,
   ["cm" /* CM */]: "length" /* LENGTH */,
   ["m" /* M */]: "length" /* LENGTH */,
+  ["km" /* KM */]: "length" /* LENGTH */,
   ["in" /* IN */]: "length" /* LENGTH */,
   ["ft" /* FT */]: "length" /* LENGTH */,
+  ["yd" /* YD */]: "length" /* LENGTH */,
+  ["mi" /* MI */]: "length" /* LENGTH */,
+  ["g" /* G */]: "weight" /* WEIGHT */,
   ["kg" /* KG */]: "weight" /* WEIGHT */,
+  ["t" /* TONNE */]: "weight" /* WEIGHT */,
+  ["C" /* CELSIUS */]: "temperature" /* TEMPERATURE */,
+  ["K" /* KELVIN */]: "temperature" /* TEMPERATURE */,
+  ["F" /* FAHRENHEIT */]: "temperature" /* TEMPERATURE */,
+  ["oz" /* OZ */]: "weight" /* WEIGHT */,
   ["lb" /* LB */]: "weight" /* WEIGHT */,
+  ["st" /* ST */]: "weight" /* WEIGHT */,
+  ["m/s" /* M_S */]: "speed" /* SPEED */,
   ["km/h" /* KM_H */]: "speed" /* SPEED */,
+  ["ft/s" /* FT_S */]: "speed" /* SPEED */,
   ["mph" /* MPH */]: "speed" /* SPEED */
 };
 
+// src/constants/temperature/temperature.ts
+var TEMPERATURE_TO_KELVIN_SCALE = {
+  ["C" /* CELSIUS */]: 1,
+  ["K" /* KELVIN */]: 1,
+  ["F" /* FAHRENHEIT */]: 5 / 9
+};
+var TEMPERATURE_TO_KELVIN_OFFSET = {
+  ["C" /* CELSIUS */]: 273.15,
+  ["K" /* KELVIN */]: 0,
+  ["F" /* FAHRENHEIT */]: 273.15 - 32 * 5 / 9
+};
+var TEMPERATURE_FROM_KELVIN_SCALE = {
+  ["C" /* CELSIUS */]: 1,
+  ["K" /* KELVIN */]: 1,
+  ["F" /* FAHRENHEIT */]: 9 / 5
+};
+var TEMPERATURE_FROM_KELVIN_OFFSET = {
+  ["C" /* CELSIUS */]: -273.15,
+  ["K" /* KELVIN */]: 0,
+  ["F" /* FAHRENHEIT */]: -459.67
+};
+
+// src/utils/math/math.ts
+var round = (value, decimalPlaces) => {
+  if (decimalPlaces === void 0) return value;
+  return parseFloat(value.toFixed(decimalPlaces));
+};
+
+// src/utils/temperature/temperature.utils.ts
+var isTemperature = ({ fromUnits }) => UNIT_DIMENSION[fromUnits] === "temperature" /* TEMPERATURE */;
+var toKelvin = (value, units) => value * TEMPERATURE_TO_KELVIN_SCALE[units] + TEMPERATURE_TO_KELVIN_OFFSET[units];
+var fromKelvin = (value, units) => value * TEMPERATURE_FROM_KELVIN_SCALE[units] + TEMPERATURE_FROM_KELVIN_OFFSET[units];
+var convertTemperature = (value, { fromUnits, toUnits, roundTo }) => {
+  if (fromUnits === toUnits) return round(value, roundTo);
+  const valueInKelvin = toKelvin(value, fromUnits);
+  const result = fromKelvin(valueInKelvin, toUnits);
+  return round(result, roundTo);
+};
+var temperatureUtils = {
+  isTemperature,
+  convertTemperature
+};
+var temperature_utils_default = temperatureUtils;
+
 // src/constants/strings/strings.ts
 var strings = {
   convertDimensionMismatch: "Cannot convert between different dimensions: {0} ({1}) and {2} ({3})"
@@ -89,24 +159,42 @@ var throwConversionError = ({ fromUnits, toUnits }) => {
 };
 var getFactor = (fromUnits, toUnits) => {
   if (fromUnits === toUnits) return 1;
-  const fromDim = UNIT_DIMENSION[fromUnits];
-  const toDim = UNIT_DIMENSION[toUnits];
-  if (fromDim !== toDim) throwConversionError({ fromUnits, toUnits });
   const toCanonicalFrom = UNIT_TO_CANONICAL[fromUnits];
   const toCanonicalTo = UNIT_TO_CANONICAL[toUnits];
   return toCanonicalFrom / toCanonicalTo;
 };
+var ensureSameDimension = ({ fromUnits, toUnits }) => {
+  const fromDim = UNIT_DIMENSION[fromUnits];
+  const toDim = UNIT_DIMENSION[toUnits];
+  if (fromDim !== toDim) throwConversionError({ fromUnits, toUnits });
+};
+var convertDefault = (value, { fromUnits, toUnits, roundTo }) => {
+  const factor = getFactor(fromUnits, toUnits);
+  return round(value * factor, roundTo);
+};
 var convertUtils = {
-  getFactor
+  convertDefault,
+  ensureSameDimension
 };
 var convert_utils_default = convertUtils;
 
 // src/utils/convert/convert.ts
-var { getFactor: getFactor2 } = convert_utils_default;
-var convert = (value, { fromUnits, toUnits, roundTo }) => {
-  const factor = getFactor2(fromUnits, toUnits);
-  return round(value * factor, roundTo);
+var { convertDefault: convertDefault2, ensureSameDimension: ensureSameDimension2 } = convert_utils_default;
+var { isTemperature: isTemperature2, convertTemperature: convertTemperature2 } = temperature_utils_default;
+var convert = (value, options) => {
+  ensureSameDimension2(options);
+  if (isTemperature2(options)) {
+    return convertTemperature2(value, options);
+  }
+  return convertDefault2(value, options);
+};
+
+// src/services/height/height.constants.ts
+var inchesPerFoot = 12;
+var heightConstants = {
+  inchesPerFoot
 };
+var height_constants_default = heightConstants;
 
 // src/services/height/height.utils.ts
 var parseFeetInches = (input) => {
@@ -143,6 +231,7 @@ var height_utils_default = heightUtils;
 
 // src/services/height/height.ts
 var { parseFeetInches: parseFeetInches2 } = height_utils_default;
+var { inchesPerFoot: inchesPerFoot2 } = height_constants_default;
 var Height = class {
   toFeetInches(valueInCm, roundTo) {
     const totalInches = convert(valueInCm, {
@@ -150,12 +239,12 @@ var Height = class {
       toUnits: "in" /* IN */,
       roundTo
     });
-    const feet = Math.floor(totalInches / 12);
-    const inches = round(totalInches - feet * 12, roundTo);
+    const feet = Math.floor(totalInches / inchesPerFoot2);
+    const inches = round(totalInches - feet * inchesPerFoot2, roundTo);
     return [feet, inches];
   }
   toCentimeters([feet, inches]) {
-    const totalInches = feet * 12 + inches;
+    const totalInches = feet * inchesPerFoot2 + inches;
     return convert(totalInches, {
       fromUnits: "in" /* IN */,
       toUnits: "cm" /* CM */
@@ -170,7 +259,6 @@ var height_default = height;
 export {
   Dimension,
   ImperialUnits,
-  MeasurementType,
   MetricUnits,
   UnitSystem,
   convert,

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/constants/common/common.constants.ts","../src/utils/math/math.ts","../src/constants/conversion/conversion.constants.ts","../src/constants/strings/strings.ts","../src/utils/strings/strings.utils.ts","../src/utils/convert/convert.utils.ts","../src/utils/convert/convert.ts","../src/services/height/height.utils.ts","../src/services/height/height.ts"],"sourcesContent":["export enum UnitSystem {\n  METRIC = \"Si\",\n  IMPERIAL = \"Imperial\",\n}\n\nexport enum Dimension {\n  LENGTH = \"length\",\n  WEIGHT = \"weight\",\n  SPEED = \"speed\",\n}\n\nexport enum MeasurementType {\n  LENGTH = \"length\",\n  WEIGHT = \"weight\",\n  SPEED = \"speed\",\n  HEIGHT = \"height\",\n  LENGTH_FEET = \"length_feet\",\n}\n\nexport enum MetricUnits {\n  CM = \"cm\",\n  M = \"m\",\n  KG = \"kg\",\n  KM_H = \"km/h\",\n}\n\nexport enum ImperialUnits {\n  IN = \"in\",\n  FT = \"ft\",\n  LB = \"lb\",\n  MPH = \"mph\",\n}\n\nexport type Units = MetricUnits | ImperialUnits;\n","export const round = (value: number, decimalPlaces?: number) => {\n  if (decimalPlaces === undefined) return value;\n\n  return parseFloat(value.toFixed(decimalPlaces));\n};\n","import {\n  Dimension,\n  ImperialUnits,\n  MetricUnits,\n  Units,\n} from \"../common/common.constants\";\n\n/** Factor to multiply value by to get value in canonical unit for that dimension. */\nexport const UNIT_TO_CANONICAL: Record<Units, number> = {\n  [MetricUnits.CM]: 1,\n  [MetricUnits.M]: 100,\n  [ImperialUnits.IN]: 2.54,\n  [ImperialUnits.FT]: 30.48,\n  [MetricUnits.KG]: 1,\n  [ImperialUnits.LB]: 0.45359237,\n  [MetricUnits.KM_H]: 1,\n  [ImperialUnits.MPH]: 1.609344,\n};\n\nexport const UNIT_DIMENSION: Record<Units, Dimension> = {\n  [MetricUnits.CM]: Dimension.LENGTH,\n  [MetricUnits.M]: Dimension.LENGTH,\n  [ImperialUnits.IN]: Dimension.LENGTH,\n  [ImperialUnits.FT]: Dimension.LENGTH,\n  [MetricUnits.KG]: Dimension.WEIGHT,\n  [ImperialUnits.LB]: Dimension.WEIGHT,\n  [MetricUnits.KM_H]: Dimension.SPEED,\n  [ImperialUnits.MPH]: Dimension.SPEED,\n};\n","const strings = {\n  convertDimensionMismatch:\n    \"Cannot convert between different dimensions: {0} ({1}) and {2} ({3})\",\n};\n\nexport default strings;\n","export const formatMessage = (message: string, ...args: any[]) =>\n  message.replace(/{(\\d+)}/g, (match, number) =>\n    args[number] !== undefined ? args[number] : match,\n  );\n","import { Units } from \"../../constants/common/common.constants\";\nimport {\n  UNIT_DIMENSION,\n  UNIT_TO_CANONICAL,\n} from \"../../constants/conversion/conversion.constants\";\nimport strings from \"../../constants/strings/strings\";\nimport { round } from \"../math/math\";\nimport { formatMessage } from \"../strings/strings.utils\";\nimport { ConvertOptions } from \"./convert.types\";\n\nconst throwConversionError = ({ fromUnits, toUnits }: ConvertOptions) => {\n  const fromDim = UNIT_DIMENSION[fromUnits];\n  const toDim = UNIT_DIMENSION[toUnits];\n\n  throw new Error(\n    formatMessage(\n      strings.convertDimensionMismatch,\n      fromUnits,\n      fromDim,\n      toUnits,\n      toDim,\n    ),\n  );\n};\n\nconst getFactor = (fromUnits: Units, toUnits: Units) => {\n  if (fromUnits === toUnits) return 1;\n\n  const fromDim = UNIT_DIMENSION[fromUnits];\n  const toDim = UNIT_DIMENSION[toUnits];\n\n  if (fromDim !== toDim) throwConversionError({ fromUnits, toUnits });\n\n  const toCanonicalFrom = UNIT_TO_CANONICAL[fromUnits];\n  const toCanonicalTo = UNIT_TO_CANONICAL[toUnits];\n  return toCanonicalFrom / toCanonicalTo;\n};\n\nconst convertUtils = {\n  getFactor,\n};\n\nexport default convertUtils;\n","import { round } from \"../math/math\";\nimport { ConvertOptions } from \"./convert.types\";\nimport utils from \"./convert.utils\";\n\nconst { getFactor } = utils;\n\nexport const convert = (\n  value: number,\n  { fromUnits, toUnits, roundTo }: ConvertOptions,\n) => {\n  const factor = getFactor(fromUnits, toUnits);\n\n  return round(value * factor, roundTo);\n};\n","import { FeetInches } from \"./height.types\";\n\nconst parseFeetInches = (input: string): FeetInches => {\n  // NOTE: this function is AI generated, but it's well tested and works as expected. And it's covered by unit tests.\n  if (typeof input !== \"string\") return [0, 0];\n\n  const normalized = input\n    .toLowerCase()\n    .replace(/[\"\"]/g, \"in\")\n    .replace(/[''′]+/g, \"ft\")\n    .replace(/(feet|foot)/g, \"ft\")\n    .replace(/(inches|inch)/g, \"in\")\n    .replace(/[\\s]+/g, \" \")\n    .trim();\n\n  const parseNumber = (value: string | undefined): number =>\n    parseFloat(value || \"0\");\n\n  const ftMatch = normalized.match(/([\\d.]+)\\s*ft/);\n  const inMatch = normalized.match(/([\\d.]+)\\s*in/);\n\n  const feet = parseNumber(ftMatch?.[1]);\n  const inches = parseNumber(inMatch?.[1]);\n\n  if (ftMatch && inMatch) {\n    return [feet, inches];\n  }\n\n  const [firstNumberString, secondNumberString] = normalized.match(\n    /[\\d.]+/g,\n  ) || [\"0\", \"0\"];\n\n  const firstNumber = parseNumber(firstNumberString);\n  const secondNumber = parseNumber(secondNumberString);\n\n  if (!ftMatch && !inMatch) {\n    return [firstNumber, secondNumber];\n  }\n\n  if (ftMatch && !inMatch) {\n    return [feet, secondNumber];\n  }\n\n  if (!ftMatch && inMatch) {\n    return [0, inches];\n  }\n\n  return [0, 0];\n};\n\nconst heightUtils = {\n  parseFeetInches,\n};\n\nexport default heightUtils;\n","import {\n  ImperialUnits,\n  MetricUnits,\n} from \"../../constants/common/common.constants\";\nimport { convert } from \"../../utils/convert/convert\";\nimport { round } from \"../../utils/math/math\";\nimport { FeetInches } from \"./height.types\";\nimport utils from \"./height.utils\";\n\nconst { parseFeetInches } = utils;\n\nclass Height {\n  toFeetInches(valueInCm: number, roundTo?: number): FeetInches {\n    const totalInches = convert(valueInCm, {\n      fromUnits: MetricUnits.CM,\n      toUnits: ImperialUnits.IN,\n      roundTo,\n    });\n\n    const feet = Math.floor(totalInches / 12);\n    const inches = round(totalInches - feet * 12, roundTo);\n\n    return [feet, inches];\n  }\n\n  toCentimeters([feet, inches]: FeetInches): number {\n    const totalInches = feet * 12 + inches;\n\n    return convert(totalInches, {\n      fromUnits: ImperialUnits.IN,\n      toUnits: MetricUnits.CM,\n    });\n  }\n\n  parseFeetInches(input: string): FeetInches {\n    return parseFeetInches(input);\n  }\n}\n\nconst height = new Height();\n\nexport default height;\n"],"mappings":"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","names":["UnitSystem","Dimension","MeasurementType","MetricUnits","ImperialUnits","getFactor","parseFeetInches"]}
+{"version":3,"sources":["../src/constants/common/common.constants.ts","../src/constants/conversion/conversion.constants.ts","../src/constants/temperature/temperature.ts","../src/utils/math/math.ts","../src/utils/temperature/temperature.utils.ts","../src/constants/strings/strings.ts","../src/utils/strings/strings.utils.ts","../src/utils/convert/convert.utils.ts","../src/utils/convert/convert.ts","../src/services/height/height.constants.ts","../src/services/height/height.utils.ts","../src/services/height/height.ts"],"sourcesContent":["export enum UnitSystem {\n  METRIC = \"Si\",\n  IMPERIAL = \"Imperial\",\n}\n\nexport enum Dimension {\n  LENGTH = \"length\",\n  WEIGHT = \"weight\",\n  SPEED = \"speed\",\n  TEMPERATURE = \"temperature\",\n}\n\nexport enum MetricUnits {\n  MM = \"mm\",\n  CM = \"cm\",\n  M = \"m\",\n  KM = \"km\",\n  G = \"g\",\n  KG = \"kg\",\n  TONNE = \"t\",\n  CELSIUS = \"C\",\n  KELVIN = \"K\",\n  M_S = \"m/s\",\n  KM_H = \"km/h\",\n}\n\nexport enum ImperialUnits {\n  IN = \"in\",\n  FT = \"ft\",\n  YD = \"yd\",\n  MI = \"mi\",\n  OZ = \"oz\",\n  LB = \"lb\",\n  ST = \"st\",\n  FAHRENHEIT = \"F\",\n  FT_S = \"ft/s\",\n  MPH = \"mph\",\n}\n\nexport type Units = MetricUnits | ImperialUnits;\n\nexport type TemperatureUnits =\n  | MetricUnits.CELSIUS\n  | MetricUnits.KELVIN\n  | ImperialUnits.FAHRENHEIT;\n","import {\n  Dimension,\n  ImperialUnits,\n  MetricUnits,\n  Units,\n} from \"../common/common.constants\";\n\n/** Factor to multiply value by to get value in canonical unit for that dimension. */\nexport const UNIT_TO_CANONICAL: Record<Units, number> = {\n  [MetricUnits.MM]: 0.1,\n  [MetricUnits.CM]: 1,\n  [MetricUnits.M]: 100,\n  [MetricUnits.KM]: 100_000,\n  [ImperialUnits.IN]: 2.54,\n  [ImperialUnits.FT]: 30.48,\n  [ImperialUnits.YD]: 91.44,\n  [ImperialUnits.MI]: 160934.4,\n  [MetricUnits.G]: 0.001,\n  [MetricUnits.KG]: 1,\n  [MetricUnits.TONNE]: 1000,\n  [MetricUnits.CELSIUS]: 1,\n  [MetricUnits.KELVIN]: 1,\n  [ImperialUnits.FAHRENHEIT]: 1,\n  [ImperialUnits.OZ]: 0.028349523125,\n  [ImperialUnits.LB]: 0.45359237,\n  [ImperialUnits.ST]: 6.35029318,\n  [MetricUnits.M_S]: 3.6,\n  [MetricUnits.KM_H]: 1,\n  [ImperialUnits.FT_S]: 1.09728,\n  [ImperialUnits.MPH]: 1.609344,\n};\n\nexport const UNIT_DIMENSION: Record<Units, Dimension> = {\n  [MetricUnits.MM]: Dimension.LENGTH,\n  [MetricUnits.CM]: Dimension.LENGTH,\n  [MetricUnits.M]: Dimension.LENGTH,\n  [MetricUnits.KM]: Dimension.LENGTH,\n  [ImperialUnits.IN]: Dimension.LENGTH,\n  [ImperialUnits.FT]: Dimension.LENGTH,\n  [ImperialUnits.YD]: Dimension.LENGTH,\n  [ImperialUnits.MI]: Dimension.LENGTH,\n  [MetricUnits.G]: Dimension.WEIGHT,\n  [MetricUnits.KG]: Dimension.WEIGHT,\n  [MetricUnits.TONNE]: Dimension.WEIGHT,\n  [MetricUnits.CELSIUS]: Dimension.TEMPERATURE,\n  [MetricUnits.KELVIN]: Dimension.TEMPERATURE,\n  [ImperialUnits.FAHRENHEIT]: Dimension.TEMPERATURE,\n  [ImperialUnits.OZ]: Dimension.WEIGHT,\n  [ImperialUnits.LB]: Dimension.WEIGHT,\n  [ImperialUnits.ST]: Dimension.WEIGHT,\n  [MetricUnits.M_S]: Dimension.SPEED,\n  [MetricUnits.KM_H]: Dimension.SPEED,\n  [ImperialUnits.FT_S]: Dimension.SPEED,\n  [ImperialUnits.MPH]: Dimension.SPEED,\n};\n","import {\n  ImperialUnits,\n  MetricUnits,\n  TemperatureUnits,\n} from \"../common/common.constants\";\n\n/** Temperature: value in Kelvin = value * scale + offset */\nexport const TEMPERATURE_TO_KELVIN_SCALE: Record<TemperatureUnits, number> = {\n  [MetricUnits.CELSIUS]: 1,\n  [MetricUnits.KELVIN]: 1,\n  [ImperialUnits.FAHRENHEIT]: 5 / 9,\n};\nexport const TEMPERATURE_TO_KELVIN_OFFSET: Record<TemperatureUnits, number> = {\n  [MetricUnits.CELSIUS]: 273.15,\n  [MetricUnits.KELVIN]: 0,\n  [ImperialUnits.FAHRENHEIT]: 273.15 - (32 * 5) / 9,\n};\n\n/** Temperature: value in unit = value_K * scale + offset */\nexport const TEMPERATURE_FROM_KELVIN_SCALE: Record<TemperatureUnits, number> = {\n  [MetricUnits.CELSIUS]: 1,\n  [MetricUnits.KELVIN]: 1,\n  [ImperialUnits.FAHRENHEIT]: 9 / 5,\n};\n\nexport const TEMPERATURE_FROM_KELVIN_OFFSET: Record<TemperatureUnits, number> =\n  {\n    [MetricUnits.CELSIUS]: -273.15,\n    [MetricUnits.KELVIN]: 0,\n    [ImperialUnits.FAHRENHEIT]: -459.67,\n  };\n","export const round = (value: number, decimalPlaces?: number) => {\n  if (decimalPlaces === undefined) return value;\n\n  return parseFloat(value.toFixed(decimalPlaces));\n};\n","import {\n  Dimension,\n  TemperatureUnits,\n} from \"../../constants/common/common.constants\";\nimport { UNIT_DIMENSION } from \"../../constants/conversion/conversion.constants\";\nimport {\n  TEMPERATURE_FROM_KELVIN_OFFSET,\n  TEMPERATURE_FROM_KELVIN_SCALE,\n  TEMPERATURE_TO_KELVIN_OFFSET,\n  TEMPERATURE_TO_KELVIN_SCALE,\n} from \"../../constants/temperature/temperature\";\nimport { ConvertOptions } from \"../convert/convert.types\";\nimport { round } from \"../math/math\";\n\nconst isTemperature = ({ fromUnits }: ConvertOptions): boolean =>\n  UNIT_DIMENSION[fromUnits] === Dimension.TEMPERATURE;\n\nconst toKelvin = (value: number, units: TemperatureUnits): number =>\n  value * TEMPERATURE_TO_KELVIN_SCALE[units] +\n  TEMPERATURE_TO_KELVIN_OFFSET[units];\n\nconst fromKelvin = (value: number, units: TemperatureUnits): number =>\n  value * TEMPERATURE_FROM_KELVIN_SCALE[units] +\n  TEMPERATURE_FROM_KELVIN_OFFSET[units];\n\nconst convertTemperature = (\n  value: number,\n  { fromUnits, toUnits, roundTo }: ConvertOptions,\n): number => {\n  if (fromUnits === toUnits) return round(value, roundTo);\n\n  const valueInKelvin = toKelvin(value, fromUnits as TemperatureUnits);\n\n  const result = fromKelvin(valueInKelvin, toUnits as TemperatureUnits);\n\n  return round(result, roundTo);\n};\n\nconst temperatureUtils = {\n  isTemperature,\n  convertTemperature,\n};\n\nexport default temperatureUtils;\n","const strings = {\n  convertDimensionMismatch:\n    \"Cannot convert between different dimensions: {0} ({1}) and {2} ({3})\",\n};\n\nexport default strings;\n","export const formatMessage = (message: string, ...args: any[]) =>\n  message.replace(/{(\\d+)}/g, (match, number) =>\n    args[number] !== undefined ? args[number] : match,\n  );\n","import { Units } from \"../../constants/common/common.constants\";\nimport {\n  UNIT_DIMENSION,\n  UNIT_TO_CANONICAL,\n} from \"../../constants/conversion/conversion.constants\";\nimport strings from \"../../constants/strings/strings\";\nimport { round } from \"../math/math\";\nimport { formatMessage } from \"../strings/strings.utils\";\nimport { ConvertOptions } from \"./convert.types\";\n\nconst throwConversionError = ({ fromUnits, toUnits }: ConvertOptions) => {\n  const fromDim = UNIT_DIMENSION[fromUnits];\n  const toDim = UNIT_DIMENSION[toUnits];\n\n  throw new Error(\n    formatMessage(\n      strings.convertDimensionMismatch,\n      fromUnits,\n      fromDim,\n      toUnits,\n      toDim,\n    ),\n  );\n};\n\nconst getFactor = (fromUnits: Units, toUnits: Units) => {\n  if (fromUnits === toUnits) return 1;\n\n  const toCanonicalFrom = UNIT_TO_CANONICAL[fromUnits];\n  const toCanonicalTo = UNIT_TO_CANONICAL[toUnits];\n  return toCanonicalFrom / toCanonicalTo;\n};\n\nconst ensureSameDimension = ({ fromUnits, toUnits }: ConvertOptions) => {\n  const fromDim = UNIT_DIMENSION[fromUnits];\n  const toDim = UNIT_DIMENSION[toUnits];\n\n  if (fromDim !== toDim) throwConversionError({ fromUnits, toUnits });\n};\n\nconst convertDefault = (\n  value: number,\n  { fromUnits, toUnits, roundTo }: ConvertOptions,\n): number => {\n  const factor = getFactor(fromUnits, toUnits);\n\n  return round(value * factor, roundTo);\n};\n\nconst convertUtils = {\n  convertDefault,\n  ensureSameDimension,\n};\n\nexport default convertUtils;\n","import temperatureUtils from \"../temperature/temperature.utils\";\nimport { ConvertOptions } from \"./convert.types\";\nimport utils from \"./convert.utils\";\n\nconst { convertDefault, ensureSameDimension } = utils;\nconst { isTemperature, convertTemperature } = temperatureUtils;\n\nexport const convert = (value: number, options: ConvertOptions) => {\n  ensureSameDimension(options);\n\n  if (isTemperature(options)) {\n    return convertTemperature(value, options);\n  }\n\n  return convertDefault(value, options);\n};\n","const inchesPerFoot = 12;\n\nconst heightConstants = {\n  inchesPerFoot,\n};\n\nexport default heightConstants;\n","import { FeetInches } from \"./height.types\";\n\nconst parseFeetInches = (input: string): FeetInches => {\n  // NOTE: this function is AI generated, but it's well tested and works as expected. And it's covered by unit tests.\n  if (typeof input !== \"string\") return [0, 0];\n\n  const normalized = input\n    .toLowerCase()\n    .replace(/[\"\"]/g, \"in\")\n    .replace(/[''′]+/g, \"ft\")\n    .replace(/(feet|foot)/g, \"ft\")\n    .replace(/(inches|inch)/g, \"in\")\n    .replace(/[\\s]+/g, \" \")\n    .trim();\n\n  const parseNumber = (value: string | undefined): number =>\n    parseFloat(value || \"0\");\n\n  const ftMatch = normalized.match(/([\\d.]+)\\s*ft/);\n  const inMatch = normalized.match(/([\\d.]+)\\s*in/);\n\n  const feet = parseNumber(ftMatch?.[1]);\n  const inches = parseNumber(inMatch?.[1]);\n\n  if (ftMatch && inMatch) {\n    return [feet, inches];\n  }\n\n  const [firstNumberString, secondNumberString] = normalized.match(\n    /[\\d.]+/g,\n  ) || [\"0\", \"0\"];\n\n  const firstNumber = parseNumber(firstNumberString);\n  const secondNumber = parseNumber(secondNumberString);\n\n  if (!ftMatch && !inMatch) {\n    return [firstNumber, secondNumber];\n  }\n\n  if (ftMatch && !inMatch) {\n    return [feet, secondNumber];\n  }\n\n  if (!ftMatch && inMatch) {\n    return [0, inches];\n  }\n\n  return [0, 0];\n};\n\nconst heightUtils = {\n  parseFeetInches,\n};\n\nexport default heightUtils;\n","import {\n  ImperialUnits,\n  MetricUnits,\n} from \"../../constants/common/common.constants\";\nimport { convert } from \"../../utils/convert/convert\";\nimport { round } from \"../../utils/math/math\";\nimport constants from \"./height.constants\";\nimport { FeetInches } from \"./height.types\";\nimport utils from \"./height.utils\";\n\nconst { parseFeetInches } = utils;\nconst { inchesPerFoot } = constants;\n\nclass Height {\n  toFeetInches(valueInCm: number, roundTo?: number): FeetInches {\n    const totalInches = convert(valueInCm, {\n      fromUnits: MetricUnits.CM,\n      toUnits: ImperialUnits.IN,\n      roundTo,\n    });\n\n    const feet = Math.floor(totalInches / inchesPerFoot);\n    const inches = round(totalInches - feet * inchesPerFoot, roundTo);\n\n    return [feet, inches];\n  }\n\n  toCentimeters([feet, inches]: FeetInches): number {\n    const totalInches = feet * inchesPerFoot + inches;\n\n    return convert(totalInches, {\n      fromUnits: ImperialUnits.IN,\n      toUnits: MetricUnits.CM,\n    });\n  }\n\n  parseFeetInches(input: string): FeetInches {\n    return parseFeetInches(input);\n  }\n}\n\nconst height = new Height();\n\nexport default height;\n"],"mappings":"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","names":["UnitSystem","Dimension","MetricUnits","ImperialUnits","convertDefault","ensureSameDimension","isTemperature","convertTemperature","parseFeetInches","inchesPerFoot"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uconvert",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -12,20 +12,52 @@
       "require": "./dist/index.js"
     }
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsup",
     "dev": "tsup --watch",
     "example": "npm run build && node example/run.mjs",
     "example:cjs": "node example/run.cjs",
     "format": "prettier --write .",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "postinstall": "husky",
+    "test": "jest"
   },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/AndrewTkachuk42/uconvert.git"
   },
-  "keywords": [],
+  "keywords": [
+    "unit-conversion",
+    "unit-converter",
+    "convert-units",
+    "measurement",
+    "measurements",
+    "unit-system",
+    "metric",
+    "imperial",
+    "si-units",
+    "length",
+    "distance",
+    "height",
+    "weight",
+    "mass",
+    "speed",
+    "feet",
+    "inches",
+    "feet-inches",
+    "centimeters",
+    "meters",
+    "kilometers",
+    "miles",
+    "typescript",
+    "javascript",
+    "utility",
+    "math",
+    "precision",
+    "cross-units"
+  ],
   "author": "",
   "license": "MIT",
   "type": "commonjs",
@@ -33,8 +65,15 @@
     "url": "https://github.com/AndrewTkachuk42/uconvert/issues"
   },
   "homepage": "https://github.com/AndrewTkachuk42/uconvert#readme",
+  "overrides": {
+    "minimatch": "^10.2.2"
+  },
   "devDependencies": {
+    "@types/jest": "^29.5.14",
+    "husky": "^9.1.7",
+    "jest": "^30.2.0",
     "prettier": "^3.4.2",
+    "ts-jest": "^29.4.6",
     "prettier-plugin-organize-imports": "^4.1.0",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3"