Initial commit

packages/utils/src/formaters/Readme.md

@@ -0,0 +1,32 @@
+# [←](../../Readme.md) Огляд Форматерів
+
+### # bytesToHumanReadableFormat(bytes: number, units?: string[]): string
+
+Перетворює кількість байт на читабельний рядок з одиницями виміру.
+
+За замовчуванням використовує поріг `1024` та одиниці: `Bytes`, `KB`, `MB`, `GB`, `TB`, `PB`, `EB`, `ZB`, `YB`.
+
+```ts
+bytesToHumanReadableFormat(500); // → '500 Bytes'
+bytesToHumanReadableFormat(1536); // → '1.5 KB'
+bytesToHumanReadableFormat(1048576); // → '1.0 MB'
+```
+
+Можна передати власні одиниці:
+
+```ts
+bytesToHumanReadableFormat(2048, ['Б', 'КБ', 'МБ']); // → '2.0 КБ'
+```
+
+### # numberToCompactFormat(num: number, digits?: number): string
+
+Скорочує велике число до компактного формату з суфіксом (`K`, `M`, `G`, `T`, `P`, `E`).
+
+`digits` — кількість знаків після коми (за замовчуванням `1`).
+
+```ts
+numberToCompactFormat(999); // → '999'
+numberToCompactFormat(1500); // → '1.5K'
+numberToCompactFormat(1500, 2); // → '1.50K'
+numberToCompactFormat(2500000); // → '2.5M'
+```