unit-converter-package-roshan 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Roshan Patil
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,186 @@
+# unit-converter-package-roshan
+
+A lightweight, type-safe unit conversion utility for JavaScript and TypeScript projects.
+
+Supports **length** and **temperature** conversions with zero dependencies and full tree-shaking support.
+
+---
+
+## ✨ Features
+
+- 📏 Length conversion (`cm`, `m`, `km`)
+- 🌡️ Temperature conversion (`celsius`, `fahrenheit`, `kelvin`)
+- ⚡ Fast and lightweight
+- 🧠 Fully typed (TypeScript)
+- 🌳 Tree-shakeable
+- 🚫 No external dependencies
+- 🧪 Tested with Jest
+
+---
+
+## 📦 Installation
+
+```bash
+npm install unit-converter-package-roshan
+````
+
+or
+
+```bash
+yarn add unit-converter-package-roshan
+```
+
+---
+
+## 🚀 Usage
+
+### Importing
+
+```ts
+import {
+  convertLength,
+  convertTemperature,
+  LengthUnit,
+  TemperatureUnit
+} from "unit-converter-package-roshan";
+```
+
+---
+
+## 📏 Length Conversion
+
+### Supported Units
+
+* `cm`
+* `m`
+* `km`
+
+### Example
+
+```ts
+convertLength(100, "cm", "m"); // 1
+convertLength(2, "km", "m");   // 2000
+convertLength(1500, "m", "km"); // 1.5
+```
+
+### Type Safety
+
+```ts
+const unit: LengthUnit = "cm"; // ✅
+const wrongUnit: LengthUnit = "mm"; // ❌ TypeScript error
+```
+
+---
+
+## 🌡️ Temperature Conversion
+
+### Supported Units
+
+* `celsius`
+* `fahrenheit`
+* `kelvin`
+
+### Example
+
+```ts
+convertTemperature(0, "celsius", "fahrenheit"); // 32
+convertTemperature(32, "fahrenheit", "celsius"); // 0
+convertTemperature(0, "celsius", "kelvin"); // 273.15
+```
+
+### Floating Point Precision
+
+For temperature conversions, floating-point math is used.
+Use rounding if required:
+
+```ts
+const value = convertTemperature(32, "fahrenheit", "kelvin");
+value.toFixed(2); // "273.15"
+```
+
+---
+
+## 🧠 API Reference
+
+### `convertLength`
+
+```ts
+convertLength(
+  value: number,
+  from: LengthUnit,
+  to: LengthUnit
+): number
+```
+
+---
+
+### `convertTemperature`
+
+```ts
+convertTemperature(
+  value: number,
+  from: TemperatureUnit,
+  to: TemperatureUnit
+): number
+```
+
+---
+
+## 🧪 Testing
+
+This package is tested using **Jest**.
+
+```bash
+npm test
+```
+
+---
+
+## 🌳 Tree Shaking
+
+This package uses ES Modules and supports tree-shaking:
+
+```ts
+import { convertLength } from "unit-converter-package-roshan";
+```
+
+Unused functions are excluded from the final bundle.
+
+---
+
+## 🛠️ Built With
+
+* TypeScript
+* Jest
+* Zero runtime dependencies
+
+---
+
+## 🧩 Roadmap
+
+Planned enhancements:
+
+* Weight units (`g`, `kg`, `lb`)
+* Time units (`s`, `min`, `hr`)
+* Speed units (`m/s`, `km/h`)
+* Chainable API
+* Optional rounding helpers
+
+---
+
+## 🤝 Contributing
+
+Pull requests are welcome.
+
+1. Fork the repository
+2. Create a feature branch
+3. Add tests for your changes
+4. Submit a pull request
+
+---
+
+## 📄 License
+
+MIT License © Roshan
+
+---

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { convertLength } from "./length";
+export { convertTemperature } from "./temperature";
+export type { LengthUnit, TemperatureUnit, } from "./types";

package/dist/index.js

@@ -0,0 +1,2 @@
+export { convertLength } from "./length";
+export { convertTemperature } from "./temperature";

package/dist/length.d.ts

@@ -0,0 +1,2 @@
+import type { LengthUnit } from "./types";
+export declare function convertLength(value: number, from: LengthUnit, to: LengthUnit): number;

package/dist/length.js

@@ -0,0 +1,8 @@
+const TO_METERS = {
+    cm: 0.01,
+    m: 1,
+    km: 1000,
+};
+export function convertLength(value, from, to) {
+    return (value * TO_METERS[from]) / TO_METERS[to];
+}

package/dist/temperature.d.ts

@@ -0,0 +1,2 @@
+import type { TemperatureUnit } from "./types";
+export declare function convertTemperature(value: number, from: TemperatureUnit, to: TemperatureUnit): number;

package/dist/temperature.js

@@ -0,0 +1,13 @@
+const TO_CELSIUS = {
+    celsius: (v) => v,
+    fahrenheit: (v) => (v - 32) * (5 / 9),
+    kelvin: (v) => v - 273.15,
+};
+const FROM_CELSIUS = {
+    celsius: (v) => v,
+    fahrenheit: (v) => v * (9 / 5) + 32,
+    kelvin: (v) => v + 273.15,
+};
+export function convertTemperature(value, from, to) {
+    return FROM_CELSIUS[to](TO_CELSIUS[from](value));
+}

package/dist/types.d.ts

@@ -0,0 +1,4 @@
+export declare const LENGTH_UNITS: readonly ["cm", "m", "km"];
+export type LengthUnit = typeof LENGTH_UNITS[number];
+export declare const TEMPERATURE_UNITS: readonly ["celsius", "fahrenheit", "kelvin"];
+export type TemperatureUnit = typeof TEMPERATURE_UNITS[number];

package/dist/types.js

@@ -0,0 +1,6 @@
+export const LENGTH_UNITS = ["cm", "m", "km"];
+export const TEMPERATURE_UNITS = [
+    "celsius",
+    "fahrenheit",
+    "kelvin",
+];

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "unit-converter-package-roshan",
+  "version": "1.0.0",
+  "description": "Simple unit conversion utilities",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "unit",
+    "conversion", 
+    "temperature",  
+    "length"
+  ],
+  "author": "Roshan Patil",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6"
+  }
+}