ts-number-lite 2.0.0 → 2.0.3

package/README.md

@@ -0,0 +1,45 @@
+# ts-number-lite
+
+Lightweight, type-safe number utility library for web developers.
+
+## Installation
+
+```bash
+npm install ts-number-lite
+```
+
+## Usage
+
+```typescript
+import { Injectable } from '@angular/core';
+import { NumberUtils } from 'ts-number-lite';
+
+@Injectable({ providedIn: 'root' })
+export class MyService {
+  constructor(private num: NumberUtils) { }
+  
+  myMethod(): void {
+    this.num.formatCurrency(1234.56);         // '$1,234.56'
+    this.num.formatBytes(1048576);           // '1 MB'
+    this.num.formatPercent(0.756);           // '75.6%'
+    this.num.clamp(150, 0, 100);             // 100
+    this.num.round(3.14159, 2);              // 3.14
+    this.num.randomInt(1, 10);               // random int 1-10
+  }
+}
+```
+
+## Methods
+
+| Method | Description | Example |
+|--------|-------------|---------|
+| `formatCurrency` | Format as currency | `1234.56` → `'$1,234.56'` |
+| `formatBytes` | Format as bytes | `1048576` → `'1 MB'` |
+| `formatPercent` | Format as percent | `0.756` → `'75.6%'` |
+| `clamp` | Clamp value to range | `150, 0, 100` → `100` |
+| `round` | Round to decimals | `3.14159, 2` → `3.14` |
+| `randomInt` | Random integer | `1, 10` → random 1-10 |
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from './number';

package/dist/index.js

@@ -0,0 +1 @@
+export * from './number';

package/dist/number.d.ts

@@ -0,0 +1,26 @@
+export declare class NumberUtils {
+    formatCurrency(value: number, currency?: string, locale?: string): string;
+    formatBytes(bytes: number, decimals?: number): string;
+    formatPercent(value: number, decimals?: number): string;
+    clamp(value: number, min: number, max: number): number;
+    round(value: number, decimals?: number): number;
+    randomInt(min: number, max: number): number;
+    randomFloat(min: number, max: number): number;
+    isEven(n: number): boolean;
+    isOdd(n: number): boolean;
+    isPositive(n: number): boolean;
+    isNegative(n: number): boolean;
+    isInteger(n: number): boolean;
+    isNaN(n: number): boolean;
+    isFinite(n: number): boolean;
+    abs(n: number): number;
+    floor(n: number): number;
+    ceil(n: number): number;
+    sqrt(n: number): number;
+    pow(n: number, exp: number): number;
+    sum(...nums: number[]): number;
+    avg(...nums: number[]): number;
+    min(...nums: number[]): number;
+    max(...nums: number[]): number;
+    range(start: number, end: number, step?: number): number[];
+}

package/dist/number.js

@@ -0,0 +1,51 @@
+export class NumberUtils {
+    formatCurrency(value, currency = 'USD', locale = 'en-US') {
+        return new Intl.NumberFormat(locale, { style: 'currency', currency }).format(value);
+    }
+    formatBytes(bytes, decimals = 2) {
+        if (bytes === 0)
+            return '0 Bytes';
+        const k = 1024;
+        const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];
+        const i = Math.floor(Math.log(bytes) / Math.log(k));
+        return parseFloat((bytes / Math.pow(k, i)).toFixed(decimals)) + ' ' + sizes[i];
+    }
+    formatPercent(value, decimals = 2) {
+        return (value * 100).toFixed(decimals) + '%';
+    }
+    clamp(value, min, max) {
+        return Math.min(Math.max(value, min), max);
+    }
+    round(value, decimals = 0) {
+        const factor = Math.pow(10, decimals);
+        return Math.round(value * factor) / factor;
+    }
+    randomInt(min, max) {
+        return Math.floor(Math.random() * (max - min + 1)) + min;
+    }
+    randomFloat(min, max) {
+        return Math.random() * (max - min) + min;
+    }
+    isEven(n) { return n % 2 === 0; }
+    isOdd(n) { return n % 2 !== 0; }
+    isPositive(n) { return n > 0; }
+    isNegative(n) { return n < 0; }
+    isInteger(n) { return Number.isInteger(n); }
+    isNaN(n) { return Number.isNaN(n); }
+    isFinite(n) { return Number.isFinite(n); }
+    abs(n) { return Math.abs(n); }
+    floor(n) { return Math.floor(n); }
+    ceil(n) { return Math.ceil(n); }
+    sqrt(n) { return Math.sqrt(n); }
+    pow(n, exp) { return Math.pow(n, exp); }
+    sum(...nums) { return nums.reduce((a, b) => a + b, 0); }
+    avg(...nums) { return nums.length ? this.sum(...nums) / nums.length : 0; }
+    min(...nums) { return Math.min(...nums); }
+    max(...nums) { return Math.max(...nums); }
+    range(start, end, step = 1) {
+        const result = [];
+        for (let i = start; i < end; i += step)
+            result.push(i);
+        return result;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ts-number-lite",
-  "version": "2.0.0",
+  "version": "2.0.3",
   "description": "Lightweight, type-safe number utility library for web developers",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -26,5 +26,9 @@
     "lite"
   ],
   "author": "Gaurang Mody - G8X",
-  "license": "MIT"
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gbmrocks/ts-utils-lite.git"
+  }
 }