@zag-js/i18n-utils 1.34.1 → 1.35.0

package/dist/format-relative-time.mjs

@@ -0,0 +1,40 @@
+// src/format-relative-time.ts
+import { i18nCache } from "./cache.mjs";
+var getRelativeTimeFormatter = i18nCache(Intl.RelativeTimeFormat);
+function formatRelativeTime(value, locale, options = {}) {
+  const rtf = getRelativeTimeFormatter(locale, options);
+  const now = /* @__PURE__ */ new Date();
+  const diff = getDistance(now, value);
+  if (diff.years > 0) return rtf.format(diff.years * diff.sign, "year");
+  if (diff.months > 0) return rtf.format(diff.months * diff.sign, "month");
+  if (diff.weeks > 0) return rtf.format(diff.weeks * diff.sign, "week");
+  if (diff.days > 0) return rtf.format(diff.days * diff.sign, "day");
+  if (diff.hours > 0) return rtf.format(diff.hours * diff.sign, "hour");
+  if (diff.minutes > 0) return rtf.format(diff.minutes * diff.sign, "minute");
+  return rtf.format(diff.seconds * diff.sign, "second");
+}
+var SECOND_TO_MS = 1e3;
+var MINUTE_TO_MS = 1e3 * 60;
+var HOUR_TO_MS = 1e3 * 60 * 60;
+var DAY_TO_MS = 1e3 * 60 * 60 * 24;
+var WEEK_TO_MS = 1e3 * 60 * 60 * 24 * 7;
+var MONTH_TO_MS = 1e3 * 60 * 60 * 24 * 30;
+var YEAR_TO_MS = 1e3 * 60 * 60 * 24 * 365;
+function getDistance(startDate, endDate) {
+  const endTime = endDate.getTime();
+  const startTime = startDate.getTime();
+  const distance = Math.abs(endTime - startTime);
+  return {
+    sign: Math.sign(endTime - startTime),
+    days: Math.floor(distance / DAY_TO_MS),
+    hours: Math.floor(distance % DAY_TO_MS / HOUR_TO_MS),
+    minutes: Math.floor(distance % HOUR_TO_MS / MINUTE_TO_MS),
+    seconds: Math.floor(distance % MINUTE_TO_MS / SECOND_TO_MS),
+    weeks: Math.floor(distance / WEEK_TO_MS),
+    months: Math.floor(distance / MONTH_TO_MS),
+    years: Math.floor(distance / YEAR_TO_MS)
+  };
+}
+export {
+  formatRelativeTime
+};

package/dist/format-time.d.mts

@@ -0,0 +1,13 @@
+type TimeFormat = "12h" | "24h";
+interface AmPmLabels {
+    am: string;
+    pm: string;
+}
+interface FormatTimeOptions {
+    format?: TimeFormat;
+    amPmLabels?: AmPmLabels;
+    withSeconds?: boolean;
+}
+declare function formatTime(value: string | Date, locale: string, options?: FormatTimeOptions): string | null;
+
+export { type AmPmLabels, type FormatTimeOptions, type TimeFormat, formatTime };

package/dist/format-time.d.ts

@@ -0,0 +1,13 @@
+type TimeFormat = "12h" | "24h";
+interface AmPmLabels {
+    am: string;
+    pm: string;
+}
+interface FormatTimeOptions {
+    format?: TimeFormat;
+    amPmLabels?: AmPmLabels;
+    withSeconds?: boolean;
+}
+declare function formatTime(value: string | Date, locale: string, options?: FormatTimeOptions): string | null;
+
+export { type AmPmLabels, type FormatTimeOptions, type TimeFormat, formatTime };

package/dist/format-time.js

@@ -0,0 +1,77 @@
+"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-time.ts
+var format_time_exports = {};
+__export(format_time_exports, {
+  formatTime: () => formatTime
+});
+module.exports = __toCommonJS(format_time_exports);
+var import_cache = require("./cache.cjs");
+var getTimeFormatter = (0, import_cache.i18nCache)(Intl.DateTimeFormat);
+function splitTimeString(timeString) {
+  const [hours = null, minutes = null, seconds = null] = timeString.split(":");
+  const parsedHours = hours === null ? null : Number(hours);
+  const parsedMinutes = minutes === null ? null : Number(minutes);
+  const parsedSeconds = seconds === null ? null : Number(seconds);
+  return {
+    hours: Number.isNaN(parsedHours) ? null : parsedHours,
+    minutes: Number.isNaN(parsedMinutes) ? null : parsedMinutes,
+    seconds: Number.isNaN(parsedSeconds) ? null : parsedSeconds
+  };
+}
+function getTimeParts(value) {
+  if (value instanceof Date) {
+    if (Number.isNaN(value.getTime())) return null;
+    return {
+      date: value,
+      hours: value.getHours(),
+      minutes: value.getMinutes(),
+      seconds: value.getSeconds()
+    };
+  }
+  const { hours, minutes, seconds } = splitTimeString(value);
+  if (hours === null || minutes === null) return null;
+  if (hours < 0 || hours > 23 || minutes < 0 || minutes > 59) return null;
+  if (seconds !== null && (seconds < 0 || seconds > 59)) return null;
+  const date = /* @__PURE__ */ new Date(0);
+  date.setHours(hours, minutes, seconds ?? 0, 0);
+  return { date, hours, minutes, seconds: seconds ?? 0 };
+}
+function formatTime(value, locale, options = {}) {
+  const { format = "24h", amPmLabels, withSeconds = false } = options;
+  const parts = getTimeParts(value);
+  if (!parts) return null;
+  const formatter = getTimeFormatter(locale, {
+    hour: format === "24h" ? "2-digit" : "numeric",
+    minute: "2-digit",
+    second: withSeconds ? "2-digit" : void 0,
+    hour12: format === "12h"
+  });
+  if (format !== "12h" || !amPmLabels) {
+    return formatter.format(parts.date);
+  }
+  const isPm = parts.hours >= 12;
+  const tokens = formatter.formatToParts(parts.date);
+  return tokens.map((token) => token.type === "dayPeriod" ? isPm ? amPmLabels.pm : amPmLabels.am : token.value).join("");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  formatTime
+});

package/dist/format-time.mjs

@@ -0,0 +1,52 @@
+// src/format-time.ts
+import { i18nCache } from "./cache.mjs";
+var getTimeFormatter = i18nCache(Intl.DateTimeFormat);
+function splitTimeString(timeString) {
+  const [hours = null, minutes = null, seconds = null] = timeString.split(":");
+  const parsedHours = hours === null ? null : Number(hours);
+  const parsedMinutes = minutes === null ? null : Number(minutes);
+  const parsedSeconds = seconds === null ? null : Number(seconds);
+  return {
+    hours: Number.isNaN(parsedHours) ? null : parsedHours,
+    minutes: Number.isNaN(parsedMinutes) ? null : parsedMinutes,
+    seconds: Number.isNaN(parsedSeconds) ? null : parsedSeconds
+  };
+}
+function getTimeParts(value) {
+  if (value instanceof Date) {
+    if (Number.isNaN(value.getTime())) return null;
+    return {
+      date: value,
+      hours: value.getHours(),
+      minutes: value.getMinutes(),
+      seconds: value.getSeconds()
+    };
+  }
+  const { hours, minutes, seconds } = splitTimeString(value);
+  if (hours === null || minutes === null) return null;
+  if (hours < 0 || hours > 23 || minutes < 0 || minutes > 59) return null;
+  if (seconds !== null && (seconds < 0 || seconds > 59)) return null;
+  const date = /* @__PURE__ */ new Date(0);
+  date.setHours(hours, minutes, seconds ?? 0, 0);
+  return { date, hours, minutes, seconds: seconds ?? 0 };
+}
+function formatTime(value, locale, options = {}) {
+  const { format = "24h", amPmLabels, withSeconds = false } = options;
+  const parts = getTimeParts(value);
+  if (!parts) return null;
+  const formatter = getTimeFormatter(locale, {
+    hour: format === "24h" ? "2-digit" : "numeric",
+    minute: "2-digit",
+    second: withSeconds ? "2-digit" : void 0,
+    hour12: format === "12h"
+  });
+  if (format !== "12h" || !amPmLabels) {
+    return formatter.format(parts.date);
+  }
+  const isPm = parts.hours >= 12;
+  const tokens = formatter.formatToParts(parts.date);
+  return tokens.map((token) => token.type === "dayPeriod" ? isPm ? amPmLabels.pm : amPmLabels.am : token.value).join("");
+}
+export {
+  formatTime
+};

package/dist/index.d.mts

@@ -1,90 +1,11 @@
-declare function createCollator(locale?: string, options?: Intl.CollatorOptions): Intl.Collator;
-
-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;
-
-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;
-
-/**
- * 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;
-
-declare function formatList(list: string[], locale: string, options?: Intl.ListFormatOptions): string;
-
-declare function formatNumber(v: number, locale: string, options?: Intl.NumberFormatOptions): string;
-
-declare function formatRelativeTime(value: Date, locale: string, options?: Intl.RelativeTimeFormatOptions): string;
-
-type TimeFormat = "12h" | "24h";
-interface AmPmLabels {
-    am: string;
-    pm: string;
-}
-interface FormatTimeOptions {
-    format?: TimeFormat;
-    amPmLabels?: AmPmLabels;
-    withSeconds?: boolean;
-}
-declare function formatTime(value: string | Date, locale: string, options?: FormatTimeOptions): string | null;
-
-declare function isRTL(locale: string): boolean;
-declare function getLocaleDir(locale: string): "rtl" | "ltr";
-
-type Direction = "rtl" | "ltr";
-interface Locale {
-    locale: string;
-    dir: Direction;
-}
-declare global {
-    interface Navigator {
-        userLanguage?: string | undefined;
-    }
-}
-declare function getDefaultLocale(): Locale;
-
-interface LocaleOptions {
-    locale?: string | undefined;
-    getRootNode?: (() => ShadowRoot | Document | Node) | undefined;
-    onLocaleChange?: ((locale: Locale) => void) | undefined;
-}
-declare function trackLocale(options?: LocaleOptions): () => void;
-
-export { type AmPmLabels, type FilterOptions, type FilterReturn, type FormatBytesOptions, type FormatTimeOptions, type Locale, type LocaleOptions, type TimeFormat, createCollator, createFilter, formatBytes, formatDate, formatList, formatNumber, formatRelativeTime, formatTime, getDefaultLocale, getLocaleDir, isRTL, trackLocale };
+export { createCollator } from './collator.mjs';
+export { FilterOptions, FilterReturn, createFilter } from './filter.mjs';
+export { FormatBytesOptions, formatBytes } from './format-bytes.mjs';
+export { formatDate } from './format-date.mjs';
+export { formatList } from './format-list.mjs';
+export { formatNumber } from './format-number.mjs';
+export { formatRelativeTime } from './format-relative-time.mjs';
+export { AmPmLabels, FormatTimeOptions, TimeFormat, formatTime } from './format-time.mjs';
+export { getLocaleDir, isRTL } from './is-rtl.mjs';
+export { Locale, getDefaultLocale } from './locale.mjs';
+export { LocaleOptions, trackLocale } from './track-locale.mjs';

package/dist/index.d.ts

@@ -1,90 +1,11 @@
-declare function createCollator(locale?: string, options?: Intl.CollatorOptions): Intl.Collator;
-
-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;
-
-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;
-
-/**
- * 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;
-
-declare function formatList(list: string[], locale: string, options?: Intl.ListFormatOptions): string;
-
-declare function formatNumber(v: number, locale: string, options?: Intl.NumberFormatOptions): string;
-
-declare function formatRelativeTime(value: Date, locale: string, options?: Intl.RelativeTimeFormatOptions): string;
-
-type TimeFormat = "12h" | "24h";
-interface AmPmLabels {
-    am: string;
-    pm: string;
-}
-interface FormatTimeOptions {
-    format?: TimeFormat;
-    amPmLabels?: AmPmLabels;
-    withSeconds?: boolean;
-}
-declare function formatTime(value: string | Date, locale: string, options?: FormatTimeOptions): string | null;
-
-declare function isRTL(locale: string): boolean;
-declare function getLocaleDir(locale: string): "rtl" | "ltr";
-
-type Direction = "rtl" | "ltr";
-interface Locale {
-    locale: string;
-    dir: Direction;
-}
-declare global {
-    interface Navigator {
-        userLanguage?: string | undefined;
-    }
-}
-declare function getDefaultLocale(): Locale;
-
-interface LocaleOptions {
-    locale?: string | undefined;
-    getRootNode?: (() => ShadowRoot | Document | Node) | undefined;
-    onLocaleChange?: ((locale: Locale) => void) | undefined;
-}
-declare function trackLocale(options?: LocaleOptions): () => void;
-
-export { type AmPmLabels, type FilterOptions, type FilterReturn, type FormatBytesOptions, type FormatTimeOptions, type Locale, type LocaleOptions, type TimeFormat, createCollator, createFilter, formatBytes, formatDate, formatList, formatNumber, formatRelativeTime, formatTime, getDefaultLocale, getLocaleDir, isRTL, trackLocale };
+export { createCollator } from './collator.js';
+export { FilterOptions, FilterReturn, createFilter } from './filter.js';
+export { FormatBytesOptions, formatBytes } from './format-bytes.js';
+export { formatDate } from './format-date.js';
+export { formatList } from './format-list.js';
+export { formatNumber } from './format-number.js';
+export { formatRelativeTime } from './format-relative-time.js';
+export { AmPmLabels, FormatTimeOptions, TimeFormat, formatTime } from './format-time.js';
+export { getLocaleDir, isRTL } from './is-rtl.js';
+export { Locale, getDefaultLocale } from './locale.js';
+export { LocaleOptions, trackLocale } from './track-locale.js';