js-format-kit 1.0.0

package/README.md

@@ -0,0 +1,24 @@
+# js-format-kit
+
+Tiny zero-dependency helpers for formatting numbers, bytes and percentages.
+
+## Install
+```
+npm install js-format-kit
+```
+
+## Usage
+```js
+const { thousands, bytes, percent } = require('js-format-kit');
+
+thousands(1234567);   // "1,234,567"
+bytes(1048576);       // "1.0 MB"
+percent(3, 8);        // "37.5%"
+```
+
+## API
+- `thousands(n)` — group digits with commas
+- `bytes(n)` — human-readable byte size
+- `percent(part, whole, digits=1)` — formatted percentage
+
+MIT

package/index.js

@@ -0,0 +1,16 @@
+'use strict';
+// Small formatting helpers, no dependencies.
+function thousands(n) {
+  return String(n).replace(/\B(?=(\d{3})+(?!\d))/g, ',');
+}
+function bytes(n) {
+  const u = ['B', 'KB', 'MB', 'GB', 'TB'];
+  let i = 0;
+  while (n >= 1024 && i < u.length - 1) { n /= 1024; i++; }
+  return n.toFixed(i ? 1 : 0) + ' ' + u[i];
+}
+function percent(part, whole, digits = 1) {
+  if (!whole) return '0%';
+  return ((part / whole) * 100).toFixed(digits) + '%';
+}
+module.exports = { thousands, bytes, percent };

package/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "js-format-kit",
+  "version": "1.0.0",
+  "description": "Tiny zero-dependency helpers for formatting numbers, bytes and percentages.",
+  "keywords": ["format", "number", "bytes", "percent", "utility"],
+  "license": "MIT",
+  "main": "index.js"
+}