@zag-js/i18n-utils 1.34.0 → 1.35.0

package/dist/cache.d.mts

@@ -0,0 +1,4 @@
+type FormatOptions<T> = T extends Intl.NumberFormat ? Intl.NumberFormatOptions : T extends Intl.DateTimeFormat ? Intl.DateTimeFormatOptions : T extends Intl.RelativeTimeFormat ? Intl.RelativeTimeFormatOptions : T extends Intl.ListFormat ? Intl.ListFormatOptions : T extends Intl.PluralRules ? Intl.PluralRulesOptions : T extends Intl.Collator ? Intl.CollatorOptions : never;
+declare function i18nCache<T extends abstract new (...args: any) => any>(Ins: T): (locale: string, options?: FormatOptions<InstanceType<T>>) => InstanceType<T>;
+
+export { i18nCache };

package/dist/cache.d.ts

@@ -0,0 +1,4 @@
+type FormatOptions<T> = T extends Intl.NumberFormat ? Intl.NumberFormatOptions : T extends Intl.DateTimeFormat ? Intl.DateTimeFormatOptions : T extends Intl.RelativeTimeFormat ? Intl.RelativeTimeFormatOptions : T extends Intl.ListFormat ? Intl.ListFormatOptions : T extends Intl.PluralRules ? Intl.PluralRulesOptions : T extends Intl.Collator ? Intl.CollatorOptions : never;
+declare function i18nCache<T extends abstract new (...args: any) => any>(Ins: T): (locale: string, options?: FormatOptions<InstanceType<T>>) => InstanceType<T>;
+
+export { i18nCache };

package/dist/cache.js

@@ -0,0 +1,41 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/cache.ts
+var cache_exports = {};
+__export(cache_exports, {
+  i18nCache: () => i18nCache
+});
+module.exports = __toCommonJS(cache_exports);
+function i18nCache(Ins) {
+  const formatterCache = /* @__PURE__ */ new Map();
+  return function create(locale, options) {
+    const cacheKey = locale + (options ? Object.entries(options).sort((a, b) => a[0] < b[0] ? -1 : 1).join() : "");
+    if (formatterCache.has(cacheKey)) {
+      return formatterCache.get(cacheKey);
+    }
+    let formatter = new Ins(locale, options);
+    formatterCache.set(cacheKey, formatter);
+    return formatter;
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  i18nCache
+});

package/dist/cache.mjs

@@ -0,0 +1,16 @@
+// src/cache.ts
+function i18nCache(Ins) {
+  const formatterCache = /* @__PURE__ */ new Map();
+  return function create(locale, options) {
+    const cacheKey = locale + (options ? Object.entries(options).sort((a, b) => a[0] < b[0] ? -1 : 1).join() : "");
+    if (formatterCache.has(cacheKey)) {
+      return formatterCache.get(cacheKey);
+    }
+    let formatter = new Ins(locale, options);
+    formatterCache.set(cacheKey, formatter);
+    return formatter;
+  };
+}
+export {
+  i18nCache
+};

package/dist/collator.d.mts

@@ -0,0 +1,3 @@
+declare function createCollator(locale?: string, options?: Intl.CollatorOptions): Intl.Collator;
+
+export { createCollator };

package/dist/collator.d.ts

@@ -0,0 +1,3 @@
+declare function createCollator(locale?: string, options?: Intl.CollatorOptions): Intl.Collator;
+
+export { createCollator };

package/dist/collator.js

@@ -0,0 +1,34 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/collator.ts
+var collator_exports = {};
+__export(collator_exports, {
+  createCollator: () => createCollator
+});
+module.exports = __toCommonJS(collator_exports);
+var import_cache = require("./cache.cjs");
+var getCollator = (0, import_cache.i18nCache)(Intl.Collator);
+function createCollator(locale = "en-US", options = {}) {
+  return getCollator(locale, options);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createCollator
+});

package/dist/collator.mjs

@@ -0,0 +1,9 @@
+// src/collator.ts
+import { i18nCache } from "./cache.mjs";
+var getCollator = i18nCache(Intl.Collator);
+function createCollator(locale = "en-US", options = {}) {
+  return getCollator(locale, options);
+}
+export {
+  createCollator
+};

package/dist/filter.d.mts

@@ -0,0 +1,11 @@
+interface FilterReturn {
+    startsWith(string: string, substring: string): boolean;
+    endsWith(string: string, substring: string): boolean;
+    contains(string: string, substring: string): boolean;
+}
+interface FilterOptions extends Intl.CollatorOptions {
+    locale?: string | undefined;
+}
+declare function createFilter(options?: FilterOptions): FilterReturn;
+
+export { type FilterOptions, type FilterReturn, createFilter };

package/dist/filter.d.ts

@@ -0,0 +1,11 @@
+interface FilterReturn {
+    startsWith(string: string, substring: string): boolean;
+    endsWith(string: string, substring: string): boolean;
+    contains(string: string, substring: string): boolean;
+}
+interface FilterOptions extends Intl.CollatorOptions {
+    locale?: string | undefined;
+}
+declare function createFilter(options?: FilterOptions): FilterReturn;
+
+export { type FilterOptions, type FilterReturn, createFilter };

package/dist/filter.js

@@ -0,0 +1,73 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/filter.ts
+var filter_exports = {};
+__export(filter_exports, {
+  createFilter: () => createFilter
+});
+module.exports = __toCommonJS(filter_exports);
+var import_cache = require("./cache.cjs");
+var collatorCache = (0, import_cache.i18nCache)(Intl.Collator);
+function createFilter(options) {
+  const { locale, ...rest } = options || {};
+  const collator = collatorCache(locale || "en-US", { usage: "search", ...rest });
+  function normalize(string) {
+    string = string.normalize("NFC");
+    if (collator.resolvedOptions().ignorePunctuation) {
+      string = string.replace(/\p{P}/gu, "");
+    }
+    return string;
+  }
+  function startsWith(string, substring) {
+    if (substring.length === 0) return true;
+    string = normalize(string);
+    substring = normalize(substring);
+    return collator.compare(string.slice(0, substring.length), substring) === 0;
+  }
+  function endsWith(string, substring) {
+    if (substring.length === 0) return true;
+    string = normalize(string);
+    substring = normalize(substring);
+    return collator.compare(string.slice(-substring.length), substring) === 0;
+  }
+  function contains(string, substring) {
+    if (substring.length === 0) return true;
+    string = normalize(string);
+    substring = normalize(substring);
+    let scan = 0;
+    let sliceLen = substring.length;
+    for (; scan + sliceLen <= string.length; scan++) {
+      let slice = string.slice(scan, scan + sliceLen);
+      if (collator.compare(substring, slice) === 0) {
+        return true;
+      }
+    }
+    return false;
+  }
+  return {
+    startsWith,
+    endsWith,
+    contains
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createFilter
+});

package/dist/filter.mjs

@@ -0,0 +1,48 @@
+// src/filter.ts
+import { i18nCache } from "./cache.mjs";
+var collatorCache = i18nCache(Intl.Collator);
+function createFilter(options) {
+  const { locale, ...rest } = options || {};
+  const collator = collatorCache(locale || "en-US", { usage: "search", ...rest });
+  function normalize(string) {
+    string = string.normalize("NFC");
+    if (collator.resolvedOptions().ignorePunctuation) {
+      string = string.replace(/\p{P}/gu, "");
+    }
+    return string;
+  }
+  function startsWith(string, substring) {
+    if (substring.length === 0) return true;
+    string = normalize(string);
+    substring = normalize(substring);
+    return collator.compare(string.slice(0, substring.length), substring) === 0;
+  }
+  function endsWith(string, substring) {
+    if (substring.length === 0) return true;
+    string = normalize(string);
+    substring = normalize(substring);
+    return collator.compare(string.slice(-substring.length), substring) === 0;
+  }
+  function contains(string, substring) {
+    if (substring.length === 0) return true;
+    string = normalize(string);
+    substring = normalize(substring);
+    let scan = 0;
+    let sliceLen = substring.length;
+    for (; scan + sliceLen <= string.length; scan++) {
+      let slice = string.slice(scan, scan + sliceLen);
+      if (collator.compare(substring, slice) === 0) {
+        return true;
+      }
+    }
+    return false;
+  }
+  return {
+    startsWith,
+    endsWith,
+    contains
+  };
+}
+export {
+  createFilter
+};

package/dist/format-bytes.d.mts

@@ -0,0 +1,32 @@
+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;
+
+export { type FormatBytesOptions, formatBytes };

package/dist/format-bytes.d.ts

@@ -0,0 +1,32 @@
+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;
+
+export { type FormatBytesOptions, formatBytes };

package/dist/format-bytes.js

@@ -0,0 +1,54 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/format-bytes.ts
+var format_bytes_exports = {};
+__export(format_bytes_exports, {
+  formatBytes: () => formatBytes
+});
+module.exports = __toCommonJS(format_bytes_exports);
+var import_format_number = require("./format-number.cjs");
+var bitPrefixes = ["", "kilo", "mega", "giga", "tera"];
+var bytePrefixes = ["", "kilo", "mega", "giga", "tera", "peta"];
+var formatBytes = (bytes, locale = "en-US", options = {}) => {
+  if (Number.isNaN(bytes)) return "";
+  if (bytes === 0) return "0 B";
+  const { unitSystem = "decimal", precision = 3, unit = "byte", unitDisplay = "short" } = options;
+  const factor = unitSystem === "binary" ? 1024 : 1e3;
+  const prefix = unit === "bit" ? bitPrefixes : bytePrefixes;
+  const isNegative = bytes < 0;
+  const absoluteBytes = Math.abs(bytes);
+  let value = absoluteBytes;
+  let index = 0;
+  while (value >= factor && index < prefix.length - 1) {
+    value /= factor;
+    index++;
+  }
+  const v = parseFloat(value.toPrecision(precision));
+  const finalValue = isNegative ? -v : v;
+  return (0, import_format_number.formatNumber)(finalValue, locale, {
+    style: "unit",
+    unit: prefix[index] + unit,
+    unitDisplay
+  });
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  formatBytes
+});

package/dist/format-bytes.mjs

@@ -0,0 +1,29 @@
+// src/format-bytes.ts
+import { formatNumber } from "./format-number.mjs";
+var bitPrefixes = ["", "kilo", "mega", "giga", "tera"];
+var bytePrefixes = ["", "kilo", "mega", "giga", "tera", "peta"];
+var formatBytes = (bytes, locale = "en-US", options = {}) => {
+  if (Number.isNaN(bytes)) return "";
+  if (bytes === 0) return "0 B";
+  const { unitSystem = "decimal", precision = 3, unit = "byte", unitDisplay = "short" } = options;
+  const factor = unitSystem === "binary" ? 1024 : 1e3;
+  const prefix = unit === "bit" ? bitPrefixes : bytePrefixes;
+  const isNegative = bytes < 0;
+  const absoluteBytes = Math.abs(bytes);
+  let value = absoluteBytes;
+  let index = 0;
+  while (value >= factor && index < prefix.length - 1) {
+    value /= factor;
+    index++;
+  }
+  const v = parseFloat(value.toPrecision(precision));
+  const finalValue = isNegative ? -v : v;
+  return formatNumber(finalValue, locale, {
+    style: "unit",
+    unit: prefix[index] + unit,
+    unitDisplay
+  });
+};
+export {
+  formatBytes
+};

package/dist/format-date.d.mts

@@ -0,0 +1,7 @@
+/**
+ * Formats a date using the given format string as defined in:
+ * https://www.unicode.org/reports/tr35/tr35-dates.html#Date_Field_Symbol_Table
+ */
+declare function formatDate(date: Date, format: string, locale: string, timeZone?: string): string;
+
+export { formatDate };

package/dist/format-date.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Formats a date using the given format string as defined in:
+ * https://www.unicode.org/reports/tr35/tr35-dates.html#Date_Field_Symbol_Table
+ */
+declare function formatDate(date: Date, format: string, locale: string, timeZone?: string): string;
+
+export { formatDate };