@zag-js/i18n-utils 1.24.1 → 1.24.2

package/dist/index.d.mts

@@ -11,7 +11,32 @@ interface FilterOptions extends Intl.CollatorOptions {
 declare function createFilter(options?: FilterOptions): FilterReturn;
 
 interface FormatBytesOptions {
+    /**
+     * The number of significant digits to include in the formatted output.
+     * @default 3
+     */
+    precision?: number | undefined;
+    /**
+     * The unit system to use for calculations.
+     * - "binary": Uses 1024 as the base (e.g., 1 KiB = 1024 bytes)
+     * - "decimal": Uses 1000 as the base (e.g., 1 KB = 1000 bytes)
+     * @default "decimal"
+     */
+    unitSystem?: "binary" | "decimal" | undefined;
+    /**
+     * The type of unit to format the value as.
+     * - "bit": Format as bits (b)
+     * - "byte": Format as bytes (B)
+     * @default "byte"
+     */
     unit?: "bit" | "byte" | undefined;
+    /**
+     * The display style for the unit.
+     * - "long": Full unit name (e.g., "kilobytes")
+     * - "short": Abbreviated unit (e.g., "KB")
+     * - "narrow": Compact unit (e.g., "K")
+     * @default "short"
+     */
     unitDisplay?: "long" | "short" | "narrow" | undefined;
 }
 declare const formatBytes: (bytes: number, locale?: string, options?: FormatBytesOptions) => string;

package/dist/index.d.ts

@@ -11,7 +11,32 @@ interface FilterOptions extends Intl.CollatorOptions {
 declare function createFilter(options?: FilterOptions): FilterReturn;
 
 interface FormatBytesOptions {
+    /**
+     * The number of significant digits to include in the formatted output.
+     * @default 3
+     */
+    precision?: number | undefined;
+    /**
+     * The unit system to use for calculations.
+     * - "binary": Uses 1024 as the base (e.g., 1 KiB = 1024 bytes)
+     * - "decimal": Uses 1000 as the base (e.g., 1 KB = 1000 bytes)
+     * @default "decimal"
+     */
+    unitSystem?: "binary" | "decimal" | undefined;
+    /**
+     * The type of unit to format the value as.
+     * - "bit": Format as bits (b)
+     * - "byte": Format as bytes (B)
+     * @default "byte"
+     */
     unit?: "bit" | "byte" | undefined;
+    /**
+     * The display style for the unit.
+     * - "long": Full unit name (e.g., "kilobytes")
+     * - "short": Abbreviated unit (e.g., "KB")
+     * - "narrow": Compact unit (e.g., "K")
+     * @default "short"
+     */
     unitDisplay?: "long" | "short" | "narrow" | undefined;
 }
 declare const formatBytes: (bytes: number, locale?: string, options?: FormatBytesOptions) => string;

package/dist/index.js

@@ -78,18 +78,17 @@ function formatNumber(v, locale, options = {}) {
 var bitPrefixes = ["", "kilo", "mega", "giga", "tera"];
 var bytePrefixes = ["", "kilo", "mega", "giga", "tera", "peta"];
 var formatBytes = (bytes, locale = "en-US", options = {}) => {
-  if (isNaN(bytes)) return "";
+  if (Number.isNaN(bytes)) return "";
   if (bytes === 0) return "0 B";
-  const { unit = "byte", unitDisplay = "short" } = options;
+  const { unitSystem = "decimal", precision = 3, unit = "byte", unitDisplay = "short" } = options;
+  const factor = unitSystem === "binary" ? 1024 : 1e3;
   const prefix = unit === "bit" ? bitPrefixes : bytePrefixes;
   const index = Math.max(0, Math.min(Math.floor(Math.log10(bytes) / 3), prefix.length - 1));
-  const _unit = prefix[index] + unit;
-  const _unitDisplay = unitDisplay || "short";
-  const v = parseFloat((bytes / Math.pow(1e3, index)).toPrecision(3));
+  const v = parseFloat((bytes / Math.pow(factor, index)).toPrecision(precision));
   return formatNumber(v, locale, {
     style: "unit",
-    unit: _unit,
-    unitDisplay: _unitDisplay
+    unit: prefix[index] + unit,
+    unitDisplay
   });
 };
 

package/dist/index.mjs

@@ -76,18 +76,17 @@ function formatNumber(v, locale, options = {}) {
 var bitPrefixes = ["", "kilo", "mega", "giga", "tera"];
 var bytePrefixes = ["", "kilo", "mega", "giga", "tera", "peta"];
 var formatBytes = (bytes, locale = "en-US", options = {}) => {
-  if (isNaN(bytes)) return "";
+  if (Number.isNaN(bytes)) return "";
   if (bytes === 0) return "0 B";
-  const { unit = "byte", unitDisplay = "short" } = options;
+  const { unitSystem = "decimal", precision = 3, unit = "byte", unitDisplay = "short" } = options;
+  const factor = unitSystem === "binary" ? 1024 : 1e3;
   const prefix = unit === "bit" ? bitPrefixes : bytePrefixes;
   const index = Math.max(0, Math.min(Math.floor(Math.log10(bytes) / 3), prefix.length - 1));
-  const _unit = prefix[index] + unit;
-  const _unitDisplay = unitDisplay || "short";
-  const v = parseFloat((bytes / Math.pow(1e3, index)).toPrecision(3));
+  const v = parseFloat((bytes / Math.pow(factor, index)).toPrecision(precision));
   return formatNumber(v, locale, {
     style: "unit",
-    unit: _unit,
-    unitDisplay: _unitDisplay
+    unit: prefix[index] + unit,
+    unitDisplay
   });
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zag-js/i18n-utils",
-  "version": "1.24.1",
+  "version": "1.24.2",
   "description": "Interationalization utilities for Zag.js",
   "keywords": [
     "js",
@@ -24,7 +24,7 @@
   },
   "clean-package": "../../../clean-package.config.json",
   "dependencies": {
-    "@zag-js/dom-query": "1.24.1"
+    "@zag-js/dom-query": "1.24.2"
   },
   "devDependencies": {
     "clean-package": "2.2.0",