@wallarm-org/design-system 1.2.0 → 1.4.0

package/dist/utils/abbreviateNumber.d.ts

@@ -1,8 +1,8 @@
 /**
- * Abbreviate a number for table cells: `12042` → `"12k"`, `59614283` → `"59.6m"`.
+ * Abbreviate a number for table cells: `12042` → `"12k"`, `59614283` → `"59.6M"`.
  *
  * Rules (from the Number display & abbreviation guide):
- * - Suffixes: k (10³), m (10⁶), b (10⁹), t (10¹²) — lowercase, no space
+ * - Suffixes: k (10³), M (10⁶), B (10⁹), T (10¹²) — k lowercase, rest uppercase, no space
  * - Boundary: moves to next suffix when rounding would reach 1000×
  * - Precision: ≥100 → 0 decimals; 10–99 → 1 decimal (drop .0); 1–9.9 → 1 decimal
  * - Negative numbers supported
@@ -12,3 +12,19 @@ export declare const abbreviateNumber: (value: number) => string;
  * Format a number with thousand separators for tooltips: `59614283` → `"59,614,283"`.
  */
 export declare const formatFullNumber: (value: number) => string;
+/**
+ * Format a percentage with boundary safety:
+ * - Never show 100% when real value < 100 → ">99%" (or ">99.9%" etc.)
+ * - Never show 0% when real value > 0 → "<1%" (or "<0.1%" etc.)
+ * - `decimals` controls fractional precision (default 0)
+ */
+export declare const formatPercent: (value: number, decimals?: number) => string;
+/**
+ * Format bytes using decimal (SI) units: 512 B, 3.4 KB, 12.7 MB, 2.3 GB, 1.1 TB.
+ * Same decimal precision rules as abbreviateNumber.
+ * Returns `{ display, full }` where `full` = "2,345,678,901 bytes".
+ */
+export declare const formatBytes: (value: number) => {
+    display: string;
+    full: string;
+};

package/dist/utils/abbreviateNumber.js

@@ -2,17 +2,17 @@ const tiers = [
     [
         999500000000,
         1e12,
-        't'
+        'T'
     ],
     [
         999500000,
         1e9,
-        'b'
+        'B'
     ],
     [
         999500,
         1e6,
-        'm'
+        'M'
     ],
     [
         1000,
@@ -36,4 +36,62 @@ const abbreviateNumber = (value)=>{
     return `${sign}${formatted}${suffix}`;
 };
 const formatFullNumber = (value)=>fullFormatter.format(value);
-export { abbreviateNumber, formatFullNumber };
+const formatPercent = (value, decimals = 0)=>{
+    if (0 === value) return '0%';
+    if (100 === value) return '100%';
+    const factor = 10 ** decimals;
+    const rounded = Math.round(value * factor) / factor;
+    if (value > 0 && 0 === rounded) {
+        const threshold = 1 / factor;
+        return `<${threshold}%`;
+    }
+    if (value < 100 && 100 === rounded) {
+        const max = 100 - 1 / factor;
+        return `>${decimals > 0 ? max.toFixed(decimals) : String(max)}%`;
+    }
+    return `${decimals > 0 ? rounded.toFixed(decimals) : String(rounded)}%`;
+};
+const byteTiers = [
+    [
+        999500000000,
+        1e12,
+        'TB'
+    ],
+    [
+        999500000,
+        1e9,
+        'GB'
+    ],
+    [
+        999500,
+        1e6,
+        'MB'
+    ],
+    [
+        1000,
+        1e3,
+        'KB'
+    ]
+];
+const formatBytes = (value)=>{
+    const full = `${fullFormatter.format(value)} bytes`;
+    if (value < 1000) return {
+        display: `${value} B`,
+        full
+    };
+    const tier = byteTiers.find(([threshold])=>value >= threshold);
+    if (!tier) return {
+        display: `${value} B`,
+        full
+    };
+    const [, divisor, suffix] = tier;
+    const scaled = value / divisor;
+    const precision = scaled >= 100 ? 0 : 1;
+    const rounded = Math.round(scaled * 10 ** precision) / 10 ** precision;
+    const formatted = rounded % 1 === 0 ? String(rounded) : rounded.toFixed(1);
+    return {
+        display: `${formatted} ${suffix}`,
+        full
+    };
+};
+export { abbreviateNumber, formatBytes, formatFullNumber, formatPercent };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wallarm-org/design-system",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "description": "Core design system library with React components and Storybook documentation",
   "publishConfig": {
     "access": "public",