uconvert 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,153 @@
+# uconvert
+
+Unit conversion utilities.
+
+## 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
+```
+
+## 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: `CM`, `M`, `KG`, `KM_H`. |
+| `ImperialUnits` | Enum: `IN`, `FT`, `LB`, `MPH`. |
+| `UnitSystem` | Enum: `METRIC`, `IMPERIAL`. |
+| `Dimension` | Enum: `LENGTH`, `WEIGHT`, `SPEED`. |
+
+`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

@@ -38,4 +38,13 @@ declare const convert: (value: number, { fromUnits, toUnits, roundTo }: ConvertO
 
 declare const round: (value: number, decimalPlaces?: number) => number;
 
-export { Dimension, ImperialUnits, MeasurementType, MetricUnits, UnitSystem, type Units, convert, round };
+type FeetInches = [number, number];
+
+declare class Height {
+    toFeetInches(valueInCm: number, roundTo?: number): FeetInches;
+    toCentimeters([feet, inches]: FeetInches): number;
+    parseFeetInches(input: string): FeetInches;
+}
+declare const height: Height;
+
+export { type ConvertOptions, Dimension, ImperialUnits, MeasurementType, MetricUnits, UnitSystem, type Units, convert, height, round };

package/dist/index.d.ts

@@ -38,4 +38,13 @@ declare const convert: (value: number, { fromUnits, toUnits, roundTo }: ConvertO
 
 declare const round: (value: number, decimalPlaces?: number) => number;
 
-export { Dimension, ImperialUnits, MeasurementType, MetricUnits, UnitSystem, type Units, convert, round };
+type FeetInches = [number, number];
+
+declare class Height {
+    toFeetInches(valueInCm: number, roundTo?: number): FeetInches;
+    toCentimeters([feet, inches]: FeetInches): number;
+    parseFeetInches(input: string): FeetInches;
+}
+declare const height: Height;
+
+export { type ConvertOptions, Dimension, ImperialUnits, MeasurementType, MetricUnits, UnitSystem, type Units, convert, height, round };

package/dist/index.js

@@ -26,6 +26,7 @@ __export(index_exports, {
   MetricUnits: () => MetricUnits,
   UnitSystem: () => UnitSystem,
   convert: () => convert,
+  height: () => height_default,
   round: () => round
 });
 module.exports = __toCommonJS(index_exports);
@@ -139,6 +140,66 @@ var convert = (value, { fromUnits, toUnits, roundTo }) => {
   const factor = getFactor2(fromUnits, toUnits);
   return round(value * factor, roundTo);
 };
+
+// src/services/height/height.utils.ts
+var parseFeetInches = (input) => {
+  if (typeof input !== "string") return [0, 0];
+  const normalized = input.toLowerCase().replace(/[""]/g, "in").replace(/[''′]+/g, "ft").replace(/(feet|foot)/g, "ft").replace(/(inches|inch)/g, "in").replace(/[\s]+/g, " ").trim();
+  const parseNumber = (value) => parseFloat(value || "0");
+  const ftMatch = normalized.match(/([\d.]+)\s*ft/);
+  const inMatch = normalized.match(/([\d.]+)\s*in/);
+  const feet = parseNumber(ftMatch?.[1]);
+  const inches = parseNumber(inMatch?.[1]);
+  if (ftMatch && inMatch) {
+    return [feet, inches];
+  }
+  const [firstNumberString, secondNumberString] = normalized.match(
+    /[\d.]+/g
+  ) || ["0", "0"];
+  const firstNumber = parseNumber(firstNumberString);
+  const secondNumber = parseNumber(secondNumberString);
+  if (!ftMatch && !inMatch) {
+    return [firstNumber, secondNumber];
+  }
+  if (ftMatch && !inMatch) {
+    return [feet, secondNumber];
+  }
+  if (!ftMatch && inMatch) {
+    return [0, inches];
+  }
+  return [0, 0];
+};
+var heightUtils = {
+  parseFeetInches
+};
+var height_utils_default = heightUtils;
+
+// src/services/height/height.ts
+var { parseFeetInches: parseFeetInches2 } = height_utils_default;
+var Height = class {
+  toFeetInches(valueInCm, roundTo) {
+    const totalInches = convert(valueInCm, {
+      fromUnits: "cm" /* CM */,
+      toUnits: "in" /* IN */,
+      roundTo
+    });
+    const feet = Math.floor(totalInches / 12);
+    const inches = round(totalInches - feet * 12, roundTo);
+    return [feet, inches];
+  }
+  toCentimeters([feet, inches]) {
+    const totalInches = feet * 12 + inches;
+    return convert(totalInches, {
+      fromUnits: "in" /* IN */,
+      toUnits: "cm" /* CM */
+    });
+  }
+  parseFeetInches(input) {
+    return parseFeetInches2(input);
+  }
+};
+var height = new Height();
+var height_default = height;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Dimension,
@@ -147,6 +208,7 @@ var convert = (value, { fromUnits, toUnits, roundTo }) => {
   MetricUnits,
   UnitSystem,
   convert,
+  height,
   round
 });
 //# sourceMappingURL=index.js.map

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"],"sourcesContent":["export * from \"./constants/common/common.constants\";\nexport * from \"./utils/convert/convert\";\nexport * from \"./utils/math/math\";\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"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAO,IAAK,aAAL,kBAAKA,gBAAL;AACL,EAAAA,YAAA,YAAS;AACT,EAAAA,YAAA,cAAW;AAFD,SAAAA;AAAA,GAAA;AAKL,IAAK,YAAL,kBAAKC,eAAL;AACL,EAAAA,WAAA,YAAS;AACT,EAAAA,WAAA,YAAS;AACT,EAAAA,WAAA,WAAQ;AAHE,SAAAA;AAAA,GAAA;AAML,IAAK,kBAAL,kBAAKC,qBAAL;AACL,EAAAA,iBAAA,YAAS;AACT,EAAAA,iBAAA,YAAS;AACT,EAAAA,iBAAA,WAAQ;AACR,EAAAA,iBAAA,YAAS;AACT,EAAAA,iBAAA,iBAAc;AALJ,SAAAA;AAAA,GAAA;AAQL,IAAK,cAAL,kBAAKC,iBAAL;AACL,EAAAA,aAAA,QAAK;AACL,EAAAA,aAAA,OAAI;AACJ,EAAAA,aAAA,QAAK;AACL,EAAAA,aAAA,UAAO;AAJG,SAAAA;AAAA,GAAA;AAOL,IAAK,gBAAL,kBAAKC,mBAAL;AACL,EAAAA,eAAA,QAAK;AACL,EAAAA,eAAA,QAAK;AACL,EAAAA,eAAA,QAAK;AACL,EAAAA,eAAA,SAAM;AAJI,SAAAA;AAAA,GAAA;;;AC1BL,IAAM,QAAQ,CAAC,OAAe,kBAA2B;AAC9D,MAAI,kBAAkB,OAAW,QAAO;AAExC,SAAO,WAAW,MAAM,QAAQ,aAAa,CAAC;AAChD;;;ACIO,IAAM,oBAA2C;AAAA,EACtD,cAAe,GAAG;AAAA,EAClB,YAAc,GAAG;AAAA,EACjB,cAAiB,GAAG;AAAA,EACpB,cAAiB,GAAG;AAAA,EACpB,cAAe,GAAG;AAAA,EAClB,cAAiB,GAAG;AAAA,EACpB,kBAAiB,GAAG;AAAA,EACpB,gBAAkB,GAAG;AACvB;AAEO,IAAM,iBAA2C;AAAA,EACtD,cAAe;AAAA,EACf,YAAc;AAAA,EACd,cAAiB;AAAA,EACjB,cAAiB;AAAA,EACjB,cAAe;AAAA,EACf,cAAiB;AAAA,EACjB,kBAAiB;AAAA,EACjB,gBAAkB;AACpB;;;AC5BA,IAAM,UAAU;AAAA,EACd,0BACE;AACJ;AAEA,IAAO,kBAAQ;;;ACLR,IAAM,gBAAgB,CAAC,YAAoB,SAChD,QAAQ;AAAA,EAAQ;AAAA,EAAY,CAAC,OAAO,WAClC,KAAK,MAAM,MAAM,SAAY,KAAK,MAAM,IAAI;AAC9C;;;ACOF,IAAM,uBAAuB,CAAC,EAAE,WAAW,QAAQ,MAAsB;AACvE,QAAM,UAAU,eAAe,SAAS;AACxC,QAAM,QAAQ,eAAe,OAAO;AAEpC,QAAM,IAAI;AAAA,IACR;AAAA,MACE,gBAAQ;AAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAM,YAAY,CAAC,WAAkB,YAAmB;AACtD,MAAI,cAAc,QAAS,QAAO;AAElC,QAAM,UAAU,eAAe,SAAS;AACxC,QAAM,QAAQ,eAAe,OAAO;AAEpC,MAAI,YAAY,MAAO,sBAAqB,EAAE,WAAW,QAAQ,CAAC;AAElE,QAAM,kBAAkB,kBAAkB,SAAS;AACnD,QAAM,gBAAgB,kBAAkB,OAAO;AAC/C,SAAO,kBAAkB;AAC3B;AAEA,IAAM,eAAe;AAAA,EACnB;AACF;AAEA,IAAO,wBAAQ;;;ACtCf,IAAM,EAAE,WAAAC,WAAU,IAAI;AAEf,IAAM,UAAU,CACrB,OACA,EAAE,WAAW,SAAS,QAAQ,MAC3B;AACH,QAAM,SAASA,WAAU,WAAW,OAAO;AAE3C,SAAO,MAAM,QAAQ,QAAQ,OAAO;AACtC;","names":["UnitSystem","Dimension","MeasurementType","MetricUnits","ImperialUnits","getFactor"]}
+{"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"]}

package/dist/index.mjs

@@ -107,6 +107,66 @@ var convert = (value, { fromUnits, toUnits, roundTo }) => {
   const factor = getFactor2(fromUnits, toUnits);
   return round(value * factor, roundTo);
 };
+
+// src/services/height/height.utils.ts
+var parseFeetInches = (input) => {
+  if (typeof input !== "string") return [0, 0];
+  const normalized = input.toLowerCase().replace(/[""]/g, "in").replace(/[''′]+/g, "ft").replace(/(feet|foot)/g, "ft").replace(/(inches|inch)/g, "in").replace(/[\s]+/g, " ").trim();
+  const parseNumber = (value) => parseFloat(value || "0");
+  const ftMatch = normalized.match(/([\d.]+)\s*ft/);
+  const inMatch = normalized.match(/([\d.]+)\s*in/);
+  const feet = parseNumber(ftMatch?.[1]);
+  const inches = parseNumber(inMatch?.[1]);
+  if (ftMatch && inMatch) {
+    return [feet, inches];
+  }
+  const [firstNumberString, secondNumberString] = normalized.match(
+    /[\d.]+/g
+  ) || ["0", "0"];
+  const firstNumber = parseNumber(firstNumberString);
+  const secondNumber = parseNumber(secondNumberString);
+  if (!ftMatch && !inMatch) {
+    return [firstNumber, secondNumber];
+  }
+  if (ftMatch && !inMatch) {
+    return [feet, secondNumber];
+  }
+  if (!ftMatch && inMatch) {
+    return [0, inches];
+  }
+  return [0, 0];
+};
+var heightUtils = {
+  parseFeetInches
+};
+var height_utils_default = heightUtils;
+
+// src/services/height/height.ts
+var { parseFeetInches: parseFeetInches2 } = height_utils_default;
+var Height = class {
+  toFeetInches(valueInCm, roundTo) {
+    const totalInches = convert(valueInCm, {
+      fromUnits: "cm" /* CM */,
+      toUnits: "in" /* IN */,
+      roundTo
+    });
+    const feet = Math.floor(totalInches / 12);
+    const inches = round(totalInches - feet * 12, roundTo);
+    return [feet, inches];
+  }
+  toCentimeters([feet, inches]) {
+    const totalInches = feet * 12 + inches;
+    return convert(totalInches, {
+      fromUnits: "in" /* IN */,
+      toUnits: "cm" /* CM */
+    });
+  }
+  parseFeetInches(input) {
+    return parseFeetInches2(input);
+  }
+};
+var height = new Height();
+var height_default = height;
 export {
   Dimension,
   ImperialUnits,
@@ -114,6 +174,7 @@ export {
   MetricUnits,
   UnitSystem,
   convert,
+  height_default as height,
   round
 };
 //# sourceMappingURL=index.mjs.map

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"],"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"],"mappings":";AAAO,IAAK,aAAL,kBAAKA,gBAAL;AACL,EAAAA,YAAA,YAAS;AACT,EAAAA,YAAA,cAAW;AAFD,SAAAA;AAAA,GAAA;AAKL,IAAK,YAAL,kBAAKC,eAAL;AACL,EAAAA,WAAA,YAAS;AACT,EAAAA,WAAA,YAAS;AACT,EAAAA,WAAA,WAAQ;AAHE,SAAAA;AAAA,GAAA;AAML,IAAK,kBAAL,kBAAKC,qBAAL;AACL,EAAAA,iBAAA,YAAS;AACT,EAAAA,iBAAA,YAAS;AACT,EAAAA,iBAAA,WAAQ;AACR,EAAAA,iBAAA,YAAS;AACT,EAAAA,iBAAA,iBAAc;AALJ,SAAAA;AAAA,GAAA;AAQL,IAAK,cAAL,kBAAKC,iBAAL;AACL,EAAAA,aAAA,QAAK;AACL,EAAAA,aAAA,OAAI;AACJ,EAAAA,aAAA,QAAK;AACL,EAAAA,aAAA,UAAO;AAJG,SAAAA;AAAA,GAAA;AAOL,IAAK,gBAAL,kBAAKC,mBAAL;AACL,EAAAA,eAAA,QAAK;AACL,EAAAA,eAAA,QAAK;AACL,EAAAA,eAAA,QAAK;AACL,EAAAA,eAAA,SAAM;AAJI,SAAAA;AAAA,GAAA;;;AC1BL,IAAM,QAAQ,CAAC,OAAe,kBAA2B;AAC9D,MAAI,kBAAkB,OAAW,QAAO;AAExC,SAAO,WAAW,MAAM,QAAQ,aAAa,CAAC;AAChD;;;ACIO,IAAM,oBAA2C;AAAA,EACtD,cAAe,GAAG;AAAA,EAClB,YAAc,GAAG;AAAA,EACjB,cAAiB,GAAG;AAAA,EACpB,cAAiB,GAAG;AAAA,EACpB,cAAe,GAAG;AAAA,EAClB,cAAiB,GAAG;AAAA,EACpB,kBAAiB,GAAG;AAAA,EACpB,gBAAkB,GAAG;AACvB;AAEO,IAAM,iBAA2C;AAAA,EACtD,cAAe;AAAA,EACf,YAAc;AAAA,EACd,cAAiB;AAAA,EACjB,cAAiB;AAAA,EACjB,cAAe;AAAA,EACf,cAAiB;AAAA,EACjB,kBAAiB;AAAA,EACjB,gBAAkB;AACpB;;;AC5BA,IAAM,UAAU;AAAA,EACd,0BACE;AACJ;AAEA,IAAO,kBAAQ;;;ACLR,IAAM,gBAAgB,CAAC,YAAoB,SAChD,QAAQ;AAAA,EAAQ;AAAA,EAAY,CAAC,OAAO,WAClC,KAAK,MAAM,MAAM,SAAY,KAAK,MAAM,IAAI;AAC9C;;;ACOF,IAAM,uBAAuB,CAAC,EAAE,WAAW,QAAQ,MAAsB;AACvE,QAAM,UAAU,eAAe,SAAS;AACxC,QAAM,QAAQ,eAAe,OAAO;AAEpC,QAAM,IAAI;AAAA,IACR;AAAA,MACE,gBAAQ;AAAA,MACR;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;AAEA,IAAM,YAAY,CAAC,WAAkB,YAAmB;AACtD,MAAI,cAAc,QAAS,QAAO;AAElC,QAAM,UAAU,eAAe,SAAS;AACxC,QAAM,QAAQ,eAAe,OAAO;AAEpC,MAAI,YAAY,MAAO,sBAAqB,EAAE,WAAW,QAAQ,CAAC;AAElE,QAAM,kBAAkB,kBAAkB,SAAS;AACnD,QAAM,gBAAgB,kBAAkB,OAAO;AAC/C,SAAO,kBAAkB;AAC3B;AAEA,IAAM,eAAe;AAAA,EACnB;AACF;AAEA,IAAO,wBAAQ;;;ACtCf,IAAM,EAAE,WAAAC,WAAU,IAAI;AAEf,IAAM,UAAU,CACrB,OACA,EAAE,WAAW,SAAS,QAAQ,MAC3B;AACH,QAAM,SAASA,WAAU,WAAW,OAAO;AAE3C,SAAO,MAAM,QAAQ,QAAQ,OAAO;AACtC;","names":["UnitSystem","Dimension","MeasurementType","MetricUnits","ImperialUnits","getFactor"]}
+{"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"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uconvert",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -19,7 +19,8 @@
     "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",
@@ -33,8 +34,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"