@intlayer/core 8.5.2 → 8.6.0

package/dist/cjs/utils/localeStorage.cjs

@@ -1,6 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
-const require_getStorageAttributes = require('../getStorageAttributes.cjs');
 const require_utils_getCookie = require('./getCookie.cjs');
 let _intlayer_config_built = require("@intlayer/config/built");
 _intlayer_config_built = require_runtime.__toESM(_intlayer_config_built);
@@ -16,78 +15,210 @@ const buildCookieString = (name, value, attributes) => {
 	return parts.join("; ");
 };
 /**
-* Retrieves the locale from various storage mechanisms (cookies, localStorage, sessionStorage, headers).
-* The function checks storage locations in order of priority as defined in the configuration.
-*
-* @returns The locale if found in any storage, or undefined if not found
+* Retrieves the locale from browser storage mechanisms
+* (cookies, localStorage, sessionStorage).
+* Does not read from headers — use `getLocaleFromStorageServer` for that.
 */
-const getLocaleFromStorage = (options) => {
+const getLocaleFromStorageClient = (options) => {
 	const { routing, internationalization } = _intlayer_config_built.default;
 	const { locales } = internationalization;
-	const { storage } = routing;
-	if (storage === false || options?.isCookieEnabled === false) return void 0;
-	const storageAttributes = require_getStorageAttributes.getStorageAttributes(storage);
-	const isValidLocale = (value) => {
-		if (!value) return false;
-		return locales.includes(value);
-	};
-	const readCookie = (name) => {
-		try {
-			const fromOption = options?.getCookie?.(name);
-			if (fromOption !== null && fromOption !== void 0) return fromOption;
-		} catch {}
-		return require_utils_getCookie.getCookie(name);
-	};
-	for (let i = 0; i < storageAttributes.cookies.length; i++) {
-		const { name } = storageAttributes.cookies[i];
-		const value = readCookie(name);
+	const storageAttributes = routing.storage;
+	if (options?.isCookieEnabled === false) return void 0;
+	const isValidLocale = (value) => !!value && locales.includes(value);
+	for (let i = 0; i < storageAttributes.cookies.length; i++) try {
+		const value = options?.getCookie?.(storageAttributes.cookies[i].name);
 		if (isValidLocale(value)) return value;
+	} catch {}
+	for (let i = 0; i < storageAttributes.localStorage.length; i++) try {
+		const value = options?.getLocaleStorage?.(storageAttributes.localStorage[i].name);
+		if (isValidLocale(value)) return value;
+	} catch {}
+	for (let i = 0; i < storageAttributes.sessionStorage.length; i++) try {
+		const value = options?.getSessionStorage?.(storageAttributes.sessionStorage[i].name);
+		if (isValidLocale(value)) return value;
+	} catch {}
+};
+/**
+* Stores the locale in browser storage mechanisms
+* (cookies, localStorage, sessionStorage).
+* Does not write to headers — use `setLocaleInStorageServer` for that.
+*/
+const setLocaleInStorageClient = (locale, options) => {
+	const { routing } = _intlayer_config_built.default;
+	const storageAttributes = routing.storage;
+	if (options?.isCookieEnabled === false) return;
+	for (let i = 0; i < storageAttributes.cookies.length; i++) {
+		const { name, attributes } = storageAttributes.cookies[i];
+		try {
+			if (options?.setCookieStore) options.setCookieStore(name, locale, {
+				...attributes,
+				expires: attributes.expires instanceof Date ? attributes.expires.getTime() : attributes.expires
+			});
+		} catch {
+			try {
+				if (options?.setCookieString) options.setCookieString(name, buildCookieString(name, locale, attributes));
+			} catch {}
+		}
 	}
-	for (let i = 0; i < storageAttributes.localStorage.length; i++) {
+	if (options?.setLocaleStorage) for (let i = 0; i < storageAttributes.localStorage.length; i++) {
 		const { name } = storageAttributes.localStorage[i];
 		try {
-			const value = options?.getLocaleStorage?.(name);
-			if (isValidLocale(value)) return value;
+			if (!(options?.overwrite ?? true) && options?.getLocaleStorage) {
+				if (options.getLocaleStorage(name)) continue;
+			}
+			options.setLocaleStorage(name, locale);
 		} catch {}
 	}
-	for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {
+	if (options?.setSessionStorage) for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {
 		const { name } = storageAttributes.sessionStorage[i];
 		try {
-			const value = options?.getSessionStorage?.(name);
-			if (isValidLocale(value)) return value;
+			if (!(options?.overwrite ?? true) && options?.getSessionStorage) {
+				if (options.getSessionStorage(name)) continue;
+			}
+			options.setSessionStorage(name, locale);
 		} catch {}
 	}
-	for (let i = 0; i < storageAttributes.headers.length; i++) {
-		const { name } = storageAttributes.headers[i];
+};
+/**
+* Client-side locale storage utility.
+* Handles cookies (browser), localStorage and sessionStorage.
+* Does not access headers.
+*
+* @example
+* ```ts
+* const storage = LocaleStorageClient(localeStorageOptions);
+* const locale = storage.getLocale();
+* storage.setLocale('fr');
+* ```
+*/
+const LocaleStorageClient = (options) => ({
+	getLocale: () => getLocaleFromStorageClient(options),
+	setLocale: (locale) => setLocaleInStorageClient(locale, options)
+});
+/**
+* Retrieves the locale from server-side storage mechanisms (cookies, headers).
+* Does not access localStorage or sessionStorage.
+* No browser cookie fallback — the caller must provide `getCookie`.
+*/
+const getLocaleFromStorageServer = (options) => {
+	const { routing, internationalization } = _intlayer_config_built.default;
+	const { locales } = internationalization;
+	const storageAttributes = routing.storage;
+	if (options?.isCookieEnabled === false) return void 0;
+	const isValidLocale = (value) => !!value && locales.includes(value);
+	for (let i = 0; i < storageAttributes.cookies.length; i++) try {
+		const value = options?.getCookie?.(storageAttributes.cookies[i].name);
+		if (isValidLocale(value)) return value;
+	} catch {}
+	for (let i = 0; i < storageAttributes.headers.length; i++) try {
+		const value = options?.getHeader?.(storageAttributes.headers[i].name);
+		if (isValidLocale(value)) return value;
+	} catch {}
+};
+/**
+* Stores the locale in server-side storage mechanisms (cookies, headers).
+* Does not write to localStorage or sessionStorage.
+*/
+const setLocaleInStorageServer = (locale, options) => {
+	const { routing } = _intlayer_config_built.default;
+	const storageAttributes = routing.storage;
+	if (options?.isCookieEnabled === false) return;
+	for (let i = 0; i < storageAttributes.cookies.length; i++) {
+		const { name, attributes } = storageAttributes.cookies[i];
 		try {
-			const value = options?.getHeader?.(name);
-			if (isValidLocale(value)) return value;
+			if (options?.setCookieStore) options.setCookieStore(name, locale, {
+				...attributes,
+				expires: attributes.expires instanceof Date ? attributes.expires.getTime() : attributes.expires
+			});
+		} catch {
+			try {
+				if (options?.setCookieString) options.setCookieString(name, buildCookieString(name, locale, attributes));
+			} catch {}
+		}
+	}
+	if (options?.setHeader) for (let i = 0; i < storageAttributes.headers.length; i++) try {
+		options.setHeader(storageAttributes.headers[i].name, locale);
+	} catch {}
+};
+/**
+* Server-side locale storage utility.
+* Handles cookies (via injected getter/setter) and headers.
+* Does not access localStorage or sessionStorage.
+*
+* @example
+* ```ts
+* const storage = LocaleStorageServer({
+*   getCookie: (name) => req.cookies[name],
+*   setCookieStore: (name, value, attrs) => res.cookie(name, value, attrs),
+*   getHeader: (name) => req.headers[name],
+*   setHeader: (name, value) => res.setHeader(name, value),
+* });
+* const locale = storage.getLocale();
+* storage.setLocale('fr');
+* ```
+*/
+const LocaleStorageServer = (options) => ({
+	getLocale: () => getLocaleFromStorageServer(options),
+	setLocale: (locale) => setLocaleInStorageServer(locale, options)
+});
+/**
+* Retrieves the locale from all storage mechanisms
+* (cookies, localStorage, sessionStorage, headers).
+*
+* @deprecated Use {@link getLocaleFromStorageClient} (browser) or
+* {@link getLocaleFromStorageServer} (server) instead.
+*/
+const getLocaleFromStorage = (options) => {
+	const { routing, internationalization } = _intlayer_config_built.default;
+	const { locales } = internationalization;
+	const storageAttributes = routing.storage;
+	if (options?.isCookieEnabled === false) return void 0;
+	const isValidLocale = (value) => !!value && locales.includes(value);
+	const readCookie = (name) => {
+		try {
+			const fromOption = options?.getCookie?.(name);
+			if (fromOption !== null && fromOption !== void 0) return fromOption;
 		} catch {}
+		return require_utils_getCookie.getCookie(name);
+	};
+	for (let i = 0; i < storageAttributes.cookies.length; i++) {
+		const value = readCookie(storageAttributes.cookies[i].name);
+		if (isValidLocale(value)) return value;
 	}
+	for (let i = 0; i < storageAttributes.localStorage.length; i++) try {
+		const value = options?.getLocaleStorage?.(storageAttributes.localStorage[i].name);
+		if (isValidLocale(value)) return value;
+	} catch {}
+	for (let i = 0; i < storageAttributes.sessionStorage.length; i++) try {
+		const value = options?.getSessionStorage?.(storageAttributes.sessionStorage[i].name);
+		if (isValidLocale(value)) return value;
+	} catch {}
+	for (let i = 0; i < storageAttributes.headers.length; i++) try {
+		const value = options?.getHeader?.(storageAttributes.headers[i].name);
+		if (isValidLocale(value)) return value;
+	} catch {}
 };
 /**
-* Stores the locale in various storage mechanisms (cookies, localStorage, sessionStorage, headers).
-* The function writes to all configured storage locations according to their attributes.
-* Respects overwrite flags for localStorage and sessionStorage.
+* Stores the locale in all configured storage mechanisms
+* (cookies, localStorage, sessionStorage, headers).
 *
-* @param locale - The locale to store
+* @deprecated Use {@link setLocaleInStorageClient} (browser) or
+* {@link setLocaleInStorageServer} (server) instead.
 */
 const setLocaleInStorage = (locale, options) => {
-	if (_intlayer_config_built.default.routing.storage === false || options?.isCookieEnabled === false) return;
-	const storageAttributes = require_getStorageAttributes.getStorageAttributes(_intlayer_config_built.default.routing.storage);
+	const { routing } = _intlayer_config_built.default;
+	const storageAttributes = routing.storage;
+	if (options?.isCookieEnabled === false) return;
 	for (let i = 0; i < storageAttributes.cookies.length; i++) {
 		const { name, attributes } = storageAttributes.cookies[i];
 		try {
-			if (options?.setCookieStore) options?.setCookieStore?.(name, locale, {
+			if (options?.setCookieStore) options.setCookieStore(name, locale, {
 				...attributes,
 				expires: attributes.expires instanceof Date ? attributes.expires.getTime() : attributes.expires
 			});
 		} catch {
 			try {
-				if (options?.setCookieString) {
-					const cookieString = buildCookieString(name, locale, attributes);
-					options?.setCookieString?.(name, cookieString);
-				}
+				if (options?.setCookieString) options.setCookieString(name, buildCookieString(name, locale, attributes));
 			} catch {}
 		}
 	}
@@ -95,39 +226,29 @@ const setLocaleInStorage = (locale, options) => {
 		const { name } = storageAttributes.localStorage[i];
 		try {
 			if (!(options?.overwrite ?? true) && options?.getLocaleStorage) {
-				if (options?.getLocaleStorage?.(name)) continue;
+				if (options.getLocaleStorage(name)) continue;
 			}
-			options?.setLocaleStorage?.(name, locale);
+			options.setLocaleStorage(name, locale);
 		} catch {}
 	}
 	if (options?.setSessionStorage) for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {
 		const { name } = storageAttributes.sessionStorage[i];
 		try {
 			if (!(options?.overwrite ?? true) && options?.getSessionStorage) {
-				if (options?.getSessionStorage?.(name)) continue;
+				if (options.getSessionStorage(name)) continue;
 			}
-			options?.setSessionStorage?.(name, locale);
-		} catch {}
-	}
-	if (options?.setHeader) for (let i = 0; i < storageAttributes.headers.length; i++) {
-		const { name } = storageAttributes.headers[i];
-		try {
-			options?.setHeader?.(name, locale);
+			options.setSessionStorage(name, locale);
 		} catch {}
 	}
+	if (options?.setHeader) for (let i = 0; i < storageAttributes.headers.length; i++) try {
+		options.setHeader(storageAttributes.headers[i].name, locale);
+	} catch {}
 };
 /**
-* Utility object to get and set the locale in the storage by considering the configuration
-*
-* @property getLocale - Retrieves the locale from various storage mechanisms (cookies, localStorage, sessionStorage, headers).
-* Retrieves the locale from various storage mechanisms (cookies, localStorage, sessionStorage, headers).
-* The function checks storage locations in order of priority as defined in the configuration.
-*
-* @property setLocale - Stores the locale in various storage mechanisms (cookies, localStorage, sessionStorage, headers).
-* The function writes to all configured storage locations according to their attributes.
-* Respects overwrite flags for localStorage and sessionStorage.
+* Utility object to get and set the locale in storage based on configuration.
 *
-* @returns The locale if found in any storage, or undefined if not found
+* @deprecated Use {@link LocaleStorageClient} (browser) or
+* {@link LocaleStorageServer} (server) instead.
 */
 const LocaleStorage = (options) => ({
 	getLocale: () => getLocaleFromStorage(options),
@@ -136,6 +257,12 @@ const LocaleStorage = (options) => ({
 
 //#endregion
 exports.LocaleStorage = LocaleStorage;
+exports.LocaleStorageClient = LocaleStorageClient;
+exports.LocaleStorageServer = LocaleStorageServer;
 exports.getLocaleFromStorage = getLocaleFromStorage;
+exports.getLocaleFromStorageClient = getLocaleFromStorageClient;
+exports.getLocaleFromStorageServer = getLocaleFromStorageServer;
 exports.setLocaleInStorage = setLocaleInStorage;
+exports.setLocaleInStorageClient = setLocaleInStorageClient;
+exports.setLocaleInStorageServer = setLocaleInStorageServer;
 //# sourceMappingURL=localeStorage.cjs.map

package/dist/cjs/utils/localeStorage.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"localeStorage.cjs","names":["configuration","getStorageAttributes","getCookie"],"sources":["../../../src/utils/localeStorage.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { CookiesAttributes } from '@intlayer/types/config';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { getStorageAttributes } from '../getStorageAttributes';\nimport { getCookie } from './getCookie';\n\ntype CookieBuildAttributes = {\n  /**\n   * Cookie domain to store the locale information\n   *\n   * Default: undefined\n   *\n   * Define the domain where the cookie is available. Defaults to\n   * the domain of the page where the cookie was created.\n   */\n  domain?: string;\n  /**\n   * Cookie path to store the locale information\n   *\n   * Default: undefined\n   *\n   * Define the path where the cookie is available. Defaults to '/'\n   */\n  path?: string;\n  /**\n   * Cookie secure to store the locale information\n   *\n   * Default: undefined\n   *\n   * A Boolean indicating if the cookie transmission requires a\n   * secure protocol (https). Defaults to false.\n   */\n  secure?: boolean;\n  /**\n   * Cookie httpOnly to store the locale information\n   *\n   * Default: undefined\n   *\n   * The cookie httpOnly where the locale information is stored.\n   */\n  httpOnly?: boolean;\n  /**\n   * Cookie sameSite to store the locale information\n   *\n   * Default: undefined\n   *\n   * Asserts that a cookie must not be sent with cross-origin requests,\n   * providing some protection against cross-site request forgery\n   * attacks (CSRF)\n   */\n  sameSite?: 'strict' | 'lax' | 'none';\n\n  /**\n   * Cookie expires to store the locale information\n   *\n   * Default: undefined\n   *\n   * Define when the cookie will be removed. Value can be a Number\n   * which will be interpreted as days from time of creation or a\n   * Date instance. If omitted, the cookie becomes a session cookie.\n   */\n  expires?: number | undefined;\n};\n\nconst buildCookieString = (\n  name: string,\n  value: string,\n  attributes: Omit<CookiesAttributes, 'name' | 'type'>\n): string => {\n  const encodedValue = encodeURIComponent(value);\n  const parts: string[] = [`${name}=${encodedValue}`];\n\n  if (attributes.path) parts.push(`Path=${attributes.path}`);\n  if (attributes.domain) parts.push(`Domain=${attributes.domain}`);\n  if (attributes.expires instanceof Date)\n    parts.push(`Expires=${attributes.expires.toUTCString()}`);\n\n  if (attributes.secure) parts.push('Secure');\n  if (attributes.sameSite) parts.push(`SameSite=${attributes.sameSite}`);\n  return parts.join('; ');\n};\n\nexport type LocaleStorageOptions = {\n  overwrite?: boolean;\n  isCookieEnabled?: boolean;\n  setCookieStore?: (\n    name: string,\n    value: string,\n    cookie: CookieBuildAttributes\n  ) => void;\n  setCookieString?: (name: string, cookie: string) => void;\n  getCookie?: (name: string) => string | undefined | null;\n  setSessionStorage?: (name: string, value: string) => void;\n  getSessionStorage?: (name: string) => string | undefined | null;\n  setLocaleStorage?: (name: string, value: string) => void;\n  getLocaleStorage?: (name: string) => string | undefined | null;\n  getHeader?: (name: string) => string | undefined | null;\n  setHeader?: (name: string, value: string) => void;\n};\n\n/**\n * Retrieves the locale from various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * The function checks storage locations in order of priority as defined in the configuration.\n *\n * @returns The locale if found in any storage, or undefined if not found\n */\nexport const getLocaleFromStorage = (\n  options: Pick<\n    LocaleStorageOptions,\n    | 'getCookie'\n    | 'getSessionStorage'\n    | 'getLocaleStorage'\n    | 'getHeader'\n    | 'isCookieEnabled'\n  >\n): Locale | undefined => {\n  const { routing, internationalization } = configuration;\n  const { locales } = internationalization;\n  const { storage } = routing;\n\n  // If storage is disabled, return undefined\n  if (storage === false || options?.isCookieEnabled === false) return undefined;\n\n  const storageAttributes = getStorageAttributes(storage);\n\n  const isValidLocale = (value: string | null | undefined): value is Locale => {\n    if (!value) return false;\n\n    return locales.includes(value as Locale);\n  };\n\n  const readCookie = (name: string): string | undefined => {\n    // Prefer provided getter (server or custom environment)\n    try {\n      const fromOption = options?.getCookie?.(name);\n\n      if (fromOption !== null && fromOption !== undefined) return fromOption;\n    } catch {}\n\n    // Fallback to browser cookie parsing\n    return getCookie(name);\n  };\n\n  // Check cookies first\n  for (let i = 0; i < storageAttributes.cookies.length; i++) {\n    const { name } = storageAttributes.cookies[i];\n\n    const value = readCookie(name);\n\n    if (isValidLocale(value)) return value;\n  }\n\n  // Then check localStorage candidates (browser only)\n  for (let i = 0; i < storageAttributes.localStorage.length; i++) {\n    const { name } = storageAttributes.localStorage[i];\n\n    try {\n      const value = options?.getLocaleStorage?.(name);\n\n      if (isValidLocale(value)) return value;\n    } catch {}\n  }\n\n  // Check sessionStorage candidates (browser only)\n  for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n    const { name } = storageAttributes.sessionStorage[i];\n\n    try {\n      const value = options?.getSessionStorage?.(name);\n\n      if (isValidLocale(value)) return value;\n    } catch {}\n  }\n\n  // Finally check header candidates (server only)\n  for (let i = 0; i < storageAttributes.headers.length; i++) {\n    const { name } = storageAttributes.headers[i];\n\n    try {\n      const value = options?.getHeader?.(name);\n\n      if (isValidLocale(value)) return value;\n    } catch {}\n  }\n};\n\n/**\n * Stores the locale in various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * The function writes to all configured storage locations according to their attributes.\n * Respects overwrite flags for localStorage and sessionStorage.\n *\n * @param locale - The locale to store\n */\nexport const setLocaleInStorage = (\n  locale: LocalesValues,\n  options?: LocaleStorageOptions\n): void => {\n  // If storage is disabled, do nothing\n  if (\n    configuration.routing.storage === false ||\n    options?.isCookieEnabled === false\n  )\n    return;\n\n  const storageAttributes = getStorageAttributes(configuration.routing.storage);\n\n  // Write to cookies (server via setCookie, client via cookieStore/document)\n  for (let i = 0; i < storageAttributes.cookies.length; i++) {\n    const { name, attributes } = storageAttributes.cookies[i];\n\n    try {\n      if (options?.setCookieStore) {\n        options?.setCookieStore?.(name, locale, {\n          ...attributes,\n          expires:\n            attributes.expires instanceof Date\n              ? attributes.expires.getTime()\n              : attributes.expires,\n        });\n      }\n    } catch {\n      try {\n        if (options?.setCookieString) {\n          const cookieString = buildCookieString(name, locale, attributes);\n\n          options?.setCookieString?.(name, cookieString);\n        }\n      } catch {}\n    }\n  }\n\n  // Write to localStorage (browser only)\n  if (options?.setLocaleStorage) {\n    for (let i = 0; i < storageAttributes.localStorage.length; i++) {\n      const { name } = storageAttributes.localStorage[i];\n\n      try {\n        const shouldOverwrite = options?.overwrite ?? true;\n\n        if (!shouldOverwrite && options?.getLocaleStorage) {\n          const existing = options?.getLocaleStorage?.(name);\n\n          if (existing) continue;\n        }\n        options?.setLocaleStorage?.(name, locale);\n      } catch {}\n    }\n  }\n\n  // Write to sessionStorage (browser only)\n  if (options?.setSessionStorage) {\n    for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n      const { name } = storageAttributes.sessionStorage[i];\n\n      try {\n        const shouldOverwrite = options?.overwrite ?? true;\n\n        if (!shouldOverwrite && options?.getSessionStorage) {\n          const existing = options?.getSessionStorage?.(name);\n          if (existing) continue;\n        }\n\n        options?.setSessionStorage?.(name, locale);\n      } catch {}\n    }\n  }\n\n  // Write to headers (server only)\n  if (options?.setHeader) {\n    for (let i = 0; i < storageAttributes.headers.length; i++) {\n      const { name } = storageAttributes.headers[i];\n\n      try {\n        options?.setHeader?.(name, locale);\n      } catch {}\n    }\n  }\n};\n\n/**\n * Utility object to get and set the locale in the storage by considering the configuration\n *\n * @property getLocale - Retrieves the locale from various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * Retrieves the locale from various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * The function checks storage locations in order of priority as defined in the configuration.\n *\n * @property setLocale - Stores the locale in various storage mechanisms (cookies, localStorage, sessionStorage, headers).\n * The function writes to all configured storage locations according to their attributes.\n * Respects overwrite flags for localStorage and sessionStorage.\n *\n * @returns The locale if found in any storage, or undefined if not found\n */\nexport const LocaleStorage = (options: LocaleStorageOptions) => ({\n  getLocale: () => getLocaleFromStorage(options),\n  setLocale: (locale: LocalesValues) => setLocaleInStorage(locale, options),\n});\n"],"mappings":"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"}
+{"version":3,"file":"localeStorage.cjs","names":["configuration","getCookie"],"sources":["../../../src/utils/localeStorage.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { CookiesAttributes } from '@intlayer/types/config';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { getCookie } from './getCookie';\n\n// ============================================================================\n// Shared types\n// ============================================================================\n\nexport type CookieBuildAttributes = {\n  domain?: string;\n  path?: string;\n  secure?: boolean;\n  httpOnly?: boolean;\n  sameSite?: 'strict' | 'lax' | 'none';\n  /** Expiry as milliseconds since epoch (Date.getTime()) or number of days */\n  expires?: number | undefined;\n};\n\n// ============================================================================\n// Shared helpers\n// ============================================================================\n\nconst buildCookieString = (\n  name: string,\n  value: string,\n  attributes: Omit<CookiesAttributes, 'name' | 'type'>\n): string => {\n  const encodedValue = encodeURIComponent(value);\n  const parts: string[] = [`${name}=${encodedValue}`];\n\n  if (attributes.path) parts.push(`Path=${attributes.path}`);\n  if (attributes.domain) parts.push(`Domain=${attributes.domain}`);\n  if (attributes.expires instanceof Date)\n    parts.push(`Expires=${attributes.expires.toUTCString()}`);\n  if (attributes.secure) parts.push('Secure');\n  if (attributes.sameSite) parts.push(`SameSite=${attributes.sameSite}`);\n  return parts.join('; ');\n};\n\n// ============================================================================\n// Client-specific types and functions\n// (cookies via browser APIs, localStorage, sessionStorage — no headers)\n// ============================================================================\n\nexport type LocaleStorageClientOptions = {\n  overwrite?: boolean;\n  isCookieEnabled?: boolean;\n  setCookieStore?: (\n    name: string,\n    value: string,\n    cookie: CookieBuildAttributes\n  ) => void;\n  setCookieString?: (name: string, cookie: string) => void;\n  getCookie?: (name: string) => string | undefined | null;\n  setSessionStorage?: (name: string, value: string) => void;\n  getSessionStorage?: (name: string) => string | undefined | null;\n  setLocaleStorage?: (name: string, value: string) => void;\n  getLocaleStorage?: (name: string) => string | undefined | null;\n};\n\n/**\n * Retrieves the locale from browser storage mechanisms\n * (cookies, localStorage, sessionStorage).\n * Does not read from headers — use `getLocaleFromStorageServer` for that.\n */\nexport const getLocaleFromStorageClient = (\n  options: LocaleStorageClientOptions\n): Locale | undefined => {\n  const { routing, internationalization } = configuration;\n  const { locales } = internationalization;\n  const storageAttributes = routing.storage;\n\n  if (options?.isCookieEnabled === false) return undefined;\n\n  const isValidLocale = (value: string | null | undefined): value is Locale =>\n    !!value && locales.includes(value as Locale);\n\n  for (let i = 0; i < storageAttributes.cookies.length; i++) {\n    try {\n      const value = options?.getCookie?.(storageAttributes.cookies[i].name);\n      if (isValidLocale(value)) return value;\n    } catch {}\n  }\n\n  for (let i = 0; i < storageAttributes.localStorage.length; i++) {\n    try {\n      const value = options?.getLocaleStorage?.(\n        storageAttributes.localStorage[i].name\n      );\n      if (isValidLocale(value)) return value;\n    } catch {}\n  }\n\n  for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n    try {\n      const value = options?.getSessionStorage?.(\n        storageAttributes.sessionStorage[i].name\n      );\n      if (isValidLocale(value)) return value;\n    } catch {}\n  }\n};\n\n/**\n * Stores the locale in browser storage mechanisms\n * (cookies, localStorage, sessionStorage).\n * Does not write to headers — use `setLocaleInStorageServer` for that.\n */\nexport const setLocaleInStorageClient = (\n  locale: LocalesValues,\n  options?: LocaleStorageClientOptions\n): void => {\n  const { routing } = configuration;\n  const storageAttributes = routing.storage;\n\n  if (options?.isCookieEnabled === false) return;\n\n  for (let i = 0; i < storageAttributes.cookies.length; i++) {\n    const { name, attributes } = storageAttributes.cookies[i];\n    try {\n      if (options?.setCookieStore) {\n        options.setCookieStore(name, locale, {\n          ...attributes,\n          expires:\n            attributes.expires instanceof Date\n              ? attributes.expires.getTime()\n              : attributes.expires,\n        });\n      }\n    } catch {\n      try {\n        if (options?.setCookieString) {\n          options.setCookieString(\n            name,\n            buildCookieString(name, locale, attributes)\n          );\n        }\n      } catch {}\n    }\n  }\n\n  if (options?.setLocaleStorage) {\n    for (let i = 0; i < storageAttributes.localStorage.length; i++) {\n      const { name } = storageAttributes.localStorage[i];\n      try {\n        if (!(options?.overwrite ?? true) && options?.getLocaleStorage) {\n          if (options.getLocaleStorage(name)) continue;\n        }\n        options.setLocaleStorage(name, locale);\n      } catch {}\n    }\n  }\n\n  if (options?.setSessionStorage) {\n    for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n      const { name } = storageAttributes.sessionStorage[i];\n      try {\n        if (!(options?.overwrite ?? true) && options?.getSessionStorage) {\n          if (options.getSessionStorage(name)) continue;\n        }\n        options.setSessionStorage(name, locale);\n      } catch {}\n    }\n  }\n};\n\n/**\n * Client-side locale storage utility.\n * Handles cookies (browser), localStorage and sessionStorage.\n * Does not access headers.\n *\n * @example\n * ```ts\n * const storage = LocaleStorageClient(localeStorageOptions);\n * const locale = storage.getLocale();\n * storage.setLocale('fr');\n * ```\n */\nexport const LocaleStorageClient = (options: LocaleStorageClientOptions) => ({\n  getLocale: () => getLocaleFromStorageClient(options),\n  setLocale: (locale: LocalesValues) =>\n    setLocaleInStorageClient(locale, options),\n});\n\n// ============================================================================\n// Server-specific types and functions\n// (cookies via injected getter/setter, headers — no localStorage/sessionStorage)\n// ============================================================================\n\nexport type LocaleStorageServerOptions = {\n  overwrite?: boolean;\n  isCookieEnabled?: boolean;\n  setCookieStore?: (\n    name: string,\n    value: string,\n    cookie: CookieBuildAttributes\n  ) => void;\n  setCookieString?: (name: string, cookie: string) => void;\n  getCookie?: (name: string) => string | undefined | null;\n  getHeader?: (name: string) => string | undefined | null;\n  setHeader?: (name: string, value: string) => void;\n};\n\n/**\n * Retrieves the locale from server-side storage mechanisms (cookies, headers).\n * Does not access localStorage or sessionStorage.\n * No browser cookie fallback — the caller must provide `getCookie`.\n */\nexport const getLocaleFromStorageServer = (\n  options: LocaleStorageServerOptions\n): Locale | undefined => {\n  const { routing, internationalization } = configuration;\n  const { locales } = internationalization;\n  const storageAttributes = routing.storage;\n\n  if (options?.isCookieEnabled === false) return undefined;\n\n  const isValidLocale = (value: string | null | undefined): value is Locale =>\n    !!value && locales.includes(value as Locale);\n\n  for (let i = 0; i < storageAttributes.cookies.length; i++) {\n    try {\n      const value = options?.getCookie?.(storageAttributes.cookies[i].name);\n      if (isValidLocale(value)) return value;\n    } catch {}\n  }\n\n  for (let i = 0; i < storageAttributes.headers.length; i++) {\n    try {\n      const value = options?.getHeader?.(storageAttributes.headers[i].name);\n      if (isValidLocale(value)) return value;\n    } catch {}\n  }\n};\n\n/**\n * Stores the locale in server-side storage mechanisms (cookies, headers).\n * Does not write to localStorage or sessionStorage.\n */\nexport const setLocaleInStorageServer = (\n  locale: LocalesValues,\n  options?: LocaleStorageServerOptions\n): void => {\n  const { routing } = configuration;\n  const storageAttributes = routing.storage;\n\n  if (options?.isCookieEnabled === false) return;\n\n  for (let i = 0; i < storageAttributes.cookies.length; i++) {\n    const { name, attributes } = storageAttributes.cookies[i];\n    try {\n      if (options?.setCookieStore) {\n        options.setCookieStore(name, locale, {\n          ...attributes,\n          expires:\n            attributes.expires instanceof Date\n              ? attributes.expires.getTime()\n              : attributes.expires,\n        });\n      }\n    } catch {\n      try {\n        if (options?.setCookieString) {\n          options.setCookieString(\n            name,\n            buildCookieString(name, locale, attributes)\n          );\n        }\n      } catch {}\n    }\n  }\n\n  if (options?.setHeader) {\n    for (let i = 0; i < storageAttributes.headers.length; i++) {\n      try {\n        options.setHeader(storageAttributes.headers[i].name, locale);\n      } catch {}\n    }\n  }\n};\n\n/**\n * Server-side locale storage utility.\n * Handles cookies (via injected getter/setter) and headers.\n * Does not access localStorage or sessionStorage.\n *\n * @example\n * ```ts\n * const storage = LocaleStorageServer({\n *   getCookie: (name) => req.cookies[name],\n *   setCookieStore: (name, value, attrs) => res.cookie(name, value, attrs),\n *   getHeader: (name) => req.headers[name],\n *   setHeader: (name, value) => res.setHeader(name, value),\n * });\n * const locale = storage.getLocale();\n * storage.setLocale('fr');\n * ```\n */\nexport const LocaleStorageServer = (options: LocaleStorageServerOptions) => ({\n  getLocale: () => getLocaleFromStorageServer(options),\n  setLocale: (locale: LocalesValues) =>\n    setLocaleInStorageServer(locale, options),\n});\n\n// ============================================================================\n// Deprecated: combined LocaleStorage\n// Use LocaleStorageClient or LocaleStorageServer instead\n// ============================================================================\n\n/**\n * @deprecated Use {@link LocaleStorageClientOptions} or {@link LocaleStorageServerOptions} instead.\n */\nexport type LocaleStorageOptions = LocaleStorageClientOptions &\n  LocaleStorageServerOptions;\n\n/**\n * Retrieves the locale from all storage mechanisms\n * (cookies, localStorage, sessionStorage, headers).\n *\n * @deprecated Use {@link getLocaleFromStorageClient} (browser) or\n * {@link getLocaleFromStorageServer} (server) instead.\n */\nexport const getLocaleFromStorage = (\n  options: Pick<\n    LocaleStorageOptions,\n    | 'getCookie'\n    | 'getSessionStorage'\n    | 'getLocaleStorage'\n    | 'getHeader'\n    | 'isCookieEnabled'\n  >\n): Locale | undefined => {\n  const { routing, internationalization } = configuration;\n  const { locales } = internationalization;\n  const storageAttributes = routing.storage;\n\n  if (options?.isCookieEnabled === false) return undefined;\n\n  const isValidLocale = (value: string | null | undefined): value is Locale =>\n    !!value && locales.includes(value as Locale);\n\n  const readCookie = (name: string): string | undefined => {\n    try {\n      const fromOption = options?.getCookie?.(name);\n      if (fromOption !== null && fromOption !== undefined) return fromOption;\n    } catch {}\n    // Browser fallback kept for backward compatibility\n    return getCookie(name);\n  };\n\n  for (let i = 0; i < storageAttributes.cookies.length; i++) {\n    const value = readCookie(storageAttributes.cookies[i].name);\n    if (isValidLocale(value)) return value;\n  }\n\n  for (let i = 0; i < storageAttributes.localStorage.length; i++) {\n    try {\n      const value = options?.getLocaleStorage?.(\n        storageAttributes.localStorage[i].name\n      );\n      if (isValidLocale(value)) return value;\n    } catch {}\n  }\n\n  for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n    try {\n      const value = options?.getSessionStorage?.(\n        storageAttributes.sessionStorage[i].name\n      );\n      if (isValidLocale(value)) return value;\n    } catch {}\n  }\n\n  for (let i = 0; i < storageAttributes.headers.length; i++) {\n    try {\n      const value = options?.getHeader?.(storageAttributes.headers[i].name);\n      if (isValidLocale(value)) return value;\n    } catch {}\n  }\n};\n\n/**\n * Stores the locale in all configured storage mechanisms\n * (cookies, localStorage, sessionStorage, headers).\n *\n * @deprecated Use {@link setLocaleInStorageClient} (browser) or\n * {@link setLocaleInStorageServer} (server) instead.\n */\nexport const setLocaleInStorage = (\n  locale: LocalesValues,\n  options?: LocaleStorageOptions\n): void => {\n  const { routing } = configuration;\n  const storageAttributes = routing.storage;\n\n  if (options?.isCookieEnabled === false) return;\n\n  for (let i = 0; i < storageAttributes.cookies.length; i++) {\n    const { name, attributes } = storageAttributes.cookies[i];\n    try {\n      if (options?.setCookieStore) {\n        options.setCookieStore(name, locale, {\n          ...attributes,\n          expires:\n            attributes.expires instanceof Date\n              ? attributes.expires.getTime()\n              : attributes.expires,\n        });\n      }\n    } catch {\n      try {\n        if (options?.setCookieString) {\n          options.setCookieString(\n            name,\n            buildCookieString(name, locale, attributes)\n          );\n        }\n      } catch {}\n    }\n  }\n\n  if (options?.setLocaleStorage) {\n    for (let i = 0; i < storageAttributes.localStorage.length; i++) {\n      const { name } = storageAttributes.localStorage[i];\n      try {\n        if (!(options?.overwrite ?? true) && options?.getLocaleStorage) {\n          if (options.getLocaleStorage(name)) continue;\n        }\n        options.setLocaleStorage(name, locale);\n      } catch {}\n    }\n  }\n\n  if (options?.setSessionStorage) {\n    for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n      const { name } = storageAttributes.sessionStorage[i];\n      try {\n        if (!(options?.overwrite ?? true) && options?.getSessionStorage) {\n          if (options.getSessionStorage(name)) continue;\n        }\n        options.setSessionStorage(name, locale);\n      } catch {}\n    }\n  }\n\n  if (options?.setHeader) {\n    for (let i = 0; i < storageAttributes.headers.length; i++) {\n      try {\n        options.setHeader(storageAttributes.headers[i].name, locale);\n      } catch {}\n    }\n  }\n};\n\n/**\n * Utility object to get and set the locale in storage based on configuration.\n *\n * @deprecated Use {@link LocaleStorageClient} (browser) or\n * {@link LocaleStorageServer} (server) instead.\n */\nexport const LocaleStorage = (options: LocaleStorageOptions) => ({\n  getLocale: () => getLocaleFromStorage(options),\n  setLocale: (locale: LocalesValues) => setLocaleInStorage(locale, options),\n});\n"],"mappings":"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"}

package/dist/esm/formatters/compact.mjs

@@ -1,4 +1,4 @@
-import { CachedIntl } from "../utils/intl.mjs";
+import { getCachedIntl } from "../utils/intl.mjs";
 import configuration from "@intlayer/config/built";
 
 //#region src/formatters/compact.ts
@@ -13,7 +13,7 @@ import configuration from "@intlayer/config/built";
 * compact("1000000", { locale: Locales.FRENCH, compactDisplay: "long" });
 * // "1 million"
 */
-const compact = (value, options) => new CachedIntl.NumberFormat(options?.locale ?? configuration?.internationalization?.defaultLocale, {
+const compact = (value, options) => getCachedIntl(Intl.NumberFormat, options?.locale ?? configuration?.internationalization?.defaultLocale, {
 	...options,
 	notation: "compact"
 }).format(Number(value));

package/dist/esm/formatters/compact.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"compact.mjs","names":[],"sources":["../../../src/formatters/compact.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { Intl as CachedIntl } from '../utils/intl';\n\n/**\n * Formats a numeric value using compact notation (e.g., 1K, 1M, 1B)\n * based on locale and formatting options.\n *\n * @example\n * compact(1200); // \"1.2K\"\n *\n * @example\n * compact(\"1000000\", { locale: Locales.FRENCH, compactDisplay: \"long\" });\n * // \"1 million\"\n */\nexport const compact = (\n  value: string | number,\n  options?: Intl.NumberFormatOptions & { locale?: LocalesValues }\n): string =>\n  new CachedIntl.NumberFormat(\n    options?.locale ?? configuration?.internationalization?.defaultLocale,\n    {\n      ...options,\n      notation: 'compact',\n    }\n  ).format(Number(value));\n"],"mappings":";;;;;;;;;;;;;;;AAeA,MAAa,WACX,OACA,YAEA,IAAI,WAAW,aACb,SAAS,UAAU,eAAe,sBAAsB,eACxD;CACE,GAAG;CACH,UAAU;CACX,CACF,CAAC,OAAO,OAAO,MAAM,CAAC"}
+{"version":3,"file":"compact.mjs","names":[],"sources":["../../../src/formatters/compact.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { getCachedIntl } from '../utils/intl';\n\n/**\n * Formats a numeric value using compact notation (e.g., 1K, 1M, 1B)\n * based on locale and formatting options.\n *\n * @example\n * compact(1200); // \"1.2K\"\n *\n * @example\n * compact(\"1000000\", { locale: Locales.FRENCH, compactDisplay: \"long\" });\n * // \"1 million\"\n */\nexport const compact = (\n  value: string | number,\n  options?: Intl.NumberFormatOptions & { locale?: LocalesValues }\n): string =>\n  getCachedIntl(\n    Intl.NumberFormat,\n    options?.locale ?? configuration?.internationalization?.defaultLocale,\n    {\n      ...options,\n      notation: 'compact',\n    }\n  ).format(Number(value));\n"],"mappings":";;;;;;;;;;;;;;;AAeA,MAAa,WACX,OACA,YAEA,cACE,KAAK,cACL,SAAS,UAAU,eAAe,sBAAsB,eACxD;CACE,GAAG;CACH,UAAU;CACX,CACF,CAAC,OAAO,OAAO,MAAM,CAAC"}

package/dist/esm/formatters/currency.mjs

@@ -1,4 +1,4 @@
-import { CachedIntl } from "../utils/intl.mjs";
+import { getCachedIntl } from "../utils/intl.mjs";
 import configuration from "@intlayer/config/built";
 
 //#region src/formatters/currency.ts
@@ -13,7 +13,7 @@ import configuration from "@intlayer/config/built";
 * currency("5000", { locale: Locales.FRENCH, currency: "CAD", currencyDisplay: "code" });
 * // "5 000,00 CAD"
 */
-const currency = (value, options) => new CachedIntl.NumberFormat(options?.locale ?? configuration?.internationalization?.defaultLocale, {
+const currency = (value, options) => getCachedIntl(Intl.NumberFormat, options?.locale ?? configuration?.internationalization?.defaultLocale, {
 	style: "currency",
 	currency: options?.currency ?? "USD",
 	currencyDisplay: options?.currencyDisplay ?? "symbol",

package/dist/esm/formatters/currency.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"currency.mjs","names":[],"sources":["../../../src/formatters/currency.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { Intl as CachedIntl } from '../utils/intl';\n\n/**\n * Formats a numeric or string value into a localized currency string using the Intl API.\n *\n * @example\n * currency(1234.5, { currency: 'EUR' });\n * // \"€1,234.50\"\n *\n * @example\n * currency(\"5000\", { locale: Locales.FRENCH, currency: \"CAD\", currencyDisplay: \"code\" });\n * // \"5 000,00 CAD\"\n */\nexport const currency = (\n  value: string | number,\n  options?: Intl.NumberFormatOptions & { locale?: LocalesValues }\n): string =>\n  new CachedIntl.NumberFormat(\n    options?.locale ?? configuration?.internationalization?.defaultLocale,\n    {\n      style: 'currency',\n      currency: options?.currency ?? 'USD',\n      currencyDisplay: options?.currencyDisplay ?? 'symbol',\n      minimumFractionDigits: options?.minimumFractionDigits ?? 2,\n      maximumFractionDigits: options?.maximumFractionDigits ?? 2,\n      ...options,\n    }\n  ).format(Number(value));\n"],"mappings":";;;;;;;;;;;;;;;AAeA,MAAa,YACX,OACA,YAEA,IAAI,WAAW,aACb,SAAS,UAAU,eAAe,sBAAsB,eACxD;CACE,OAAO;CACP,UAAU,SAAS,YAAY;CAC/B,iBAAiB,SAAS,mBAAmB;CAC7C,uBAAuB,SAAS,yBAAyB;CACzD,uBAAuB,SAAS,yBAAyB;CACzD,GAAG;CACJ,CACF,CAAC,OAAO,OAAO,MAAM,CAAC"}
+{"version":3,"file":"currency.mjs","names":[],"sources":["../../../src/formatters/currency.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { getCachedIntl } from '../utils/intl';\n\n/**\n * Formats a numeric or string value into a localized currency string using the Intl API.\n *\n * @example\n * currency(1234.5, { currency: 'EUR' });\n * // \"€1,234.50\"\n *\n * @example\n * currency(\"5000\", { locale: Locales.FRENCH, currency: \"CAD\", currencyDisplay: \"code\" });\n * // \"5 000,00 CAD\"\n */\nexport const currency = (\n  value: string | number,\n  options?: Intl.NumberFormatOptions & { locale?: LocalesValues }\n): string =>\n  getCachedIntl(\n    Intl.NumberFormat,\n    options?.locale ?? configuration?.internationalization?.defaultLocale,\n    {\n      style: 'currency',\n      currency: options?.currency ?? 'USD',\n      currencyDisplay: options?.currencyDisplay ?? 'symbol',\n      minimumFractionDigits: options?.minimumFractionDigits ?? 2,\n      maximumFractionDigits: options?.maximumFractionDigits ?? 2,\n      ...options,\n    }\n  ).format(Number(value));\n"],"mappings":";;;;;;;;;;;;;;;AAeA,MAAa,YACX,OACA,YAEA,cACE,KAAK,cACL,SAAS,UAAU,eAAe,sBAAsB,eACxD;CACE,OAAO;CACP,UAAU,SAAS,YAAY;CAC/B,iBAAiB,SAAS,mBAAmB;CAC7C,uBAAuB,SAAS,yBAAyB;CACzD,uBAAuB,SAAS,yBAAyB;CACzD,GAAG;CACJ,CACF,CAAC,OAAO,OAAO,MAAM,CAAC"}

package/dist/esm/formatters/date.mjs

@@ -1,4 +1,4 @@
-import { CachedIntl } from "../utils/intl.mjs";
+import { getCachedIntl } from "../utils/intl.mjs";
 import configuration from "@intlayer/config/built";
 
 //#region src/formatters/date.ts
@@ -51,7 +51,7 @@ const date = (date, options) => {
 	const dateTime = new Date(date);
 	const resolvedOptions = typeof options === "string" ? presets[options] ?? {} : options;
 	const locale = (typeof options === "object" ? options?.locale : void 0) ?? configuration?.internationalization?.defaultLocale;
-	return new CachedIntl.DateTimeFormat(locale, resolvedOptions).format(dateTime);
+	return getCachedIntl(Intl.DateTimeFormat, locale, resolvedOptions).format(dateTime);
 };
 
 //#endregion

package/dist/esm/formatters/date.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"date.mjs","names":[],"sources":["../../../src/formatters/date.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { Intl as CachedIntl } from '../utils/intl';\n\nexport type DateTimePreset =\n  | 'short'\n  | 'long'\n  | 'dateOnly'\n  | 'timeOnly'\n  | 'full';\n\nexport const presets: Record<DateTimePreset, Intl.DateTimeFormatOptions> = {\n  short: {\n    year: '2-digit',\n    month: '2-digit',\n    day: '2-digit',\n    hour: '2-digit',\n    minute: '2-digit',\n  },\n  long: {\n    year: 'numeric',\n    month: 'long',\n    day: 'numeric',\n    hour: 'numeric',\n    minute: 'numeric',\n  },\n  full: {\n    year: 'numeric',\n    month: 'long',\n    day: 'numeric',\n    hour: 'numeric',\n    minute: 'numeric',\n    hour12: false,\n  },\n  dateOnly: {\n    year: 'numeric',\n    month: 'short',\n    day: 'numeric',\n  },\n  timeOnly: {\n    hour: 'numeric',\n    minute: 'numeric',\n    second: 'numeric',\n  },\n};\n\n/**\n * Formats a date/time value into a localized string using Intl.DateTimeFormat.\n *\n * @example\n * date(new Date('2025-08-02T14:30:00Z'), { year: '2-digit', month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit' });\n * // \"08/02/25, 14:30\"\n *\n * @example\n * date(\"2025-08-02T14:30:00Z\", { locale: Locales.FRENCH, month: \"long\", day: \"numeric\" });\n * // \"2 août\"\n */\nexport const date = (\n  date: Date | string | number,\n  options?:\n    | (Intl.DateTimeFormatOptions & { locale?: LocalesValues })\n    | DateTimePreset\n): string => {\n  const dateTime = new Date(date);\n\n  const resolvedOptions =\n    typeof options === 'string' ? (presets[options] ?? {}) : options;\n\n  const locale =\n    (typeof options === 'object' ? options?.locale : undefined) ??\n    configuration?.internationalization?.defaultLocale;\n\n  const formatter = new CachedIntl.DateTimeFormat(locale, resolvedOptions);\n\n  return formatter.format(dateTime);\n};\n"],"mappings":";;;;AAWA,MAAa,UAA8D;CACzE,OAAO;EACL,MAAM;EACN,OAAO;EACP,KAAK;EACL,MAAM;EACN,QAAQ;EACT;CACD,MAAM;EACJ,MAAM;EACN,OAAO;EACP,KAAK;EACL,MAAM;EACN,QAAQ;EACT;CACD,MAAM;EACJ,MAAM;EACN,OAAO;EACP,KAAK;EACL,MAAM;EACN,QAAQ;EACR,QAAQ;EACT;CACD,UAAU;EACR,MAAM;EACN,OAAO;EACP,KAAK;EACN;CACD,UAAU;EACR,MAAM;EACN,QAAQ;EACR,QAAQ;EACT;CACF;;;;;;;;;;;;AAaD,MAAa,QACX,MACA,YAGW;CACX,MAAM,WAAW,IAAI,KAAK,KAAK;CAE/B,MAAM,kBACJ,OAAO,YAAY,WAAY,QAAQ,YAAY,EAAE,GAAI;CAE3D,MAAM,UACH,OAAO,YAAY,WAAW,SAAS,SAAS,WACjD,eAAe,sBAAsB;AAIvC,QAFkB,IAAI,WAAW,eAAe,QAAQ,gBAAgB,CAEvD,OAAO,SAAS"}
+{"version":3,"file":"date.mjs","names":[],"sources":["../../../src/formatters/date.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { getCachedIntl } from '../utils/intl';\n\nexport type DateTimePreset =\n  | 'short'\n  | 'long'\n  | 'dateOnly'\n  | 'timeOnly'\n  | 'full';\n\nexport const presets: Record<DateTimePreset, Intl.DateTimeFormatOptions> = {\n  short: {\n    year: '2-digit',\n    month: '2-digit',\n    day: '2-digit',\n    hour: '2-digit',\n    minute: '2-digit',\n  },\n  long: {\n    year: 'numeric',\n    month: 'long',\n    day: 'numeric',\n    hour: 'numeric',\n    minute: 'numeric',\n  },\n  full: {\n    year: 'numeric',\n    month: 'long',\n    day: 'numeric',\n    hour: 'numeric',\n    minute: 'numeric',\n    hour12: false,\n  },\n  dateOnly: {\n    year: 'numeric',\n    month: 'short',\n    day: 'numeric',\n  },\n  timeOnly: {\n    hour: 'numeric',\n    minute: 'numeric',\n    second: 'numeric',\n  },\n};\n\n/**\n * Formats a date/time value into a localized string using Intl.DateTimeFormat.\n *\n * @example\n * date(new Date('2025-08-02T14:30:00Z'), { year: '2-digit', month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit' });\n * // \"08/02/25, 14:30\"\n *\n * @example\n * date(\"2025-08-02T14:30:00Z\", { locale: Locales.FRENCH, month: \"long\", day: \"numeric\" });\n * // \"2 août\"\n */\nexport const date = (\n  date: Date | string | number,\n  options?:\n    | (Intl.DateTimeFormatOptions & { locale?: LocalesValues })\n    | DateTimePreset\n): string => {\n  const dateTime = new Date(date);\n\n  const resolvedOptions =\n    typeof options === 'string' ? (presets[options] ?? {}) : options;\n\n  const locale =\n    (typeof options === 'object' ? options?.locale : undefined) ??\n    configuration?.internationalization?.defaultLocale;\n\n  const formatter = getCachedIntl(Intl.DateTimeFormat, locale, resolvedOptions);\n\n  return formatter.format(dateTime);\n};\n"],"mappings":";;;;AAWA,MAAa,UAA8D;CACzE,OAAO;EACL,MAAM;EACN,OAAO;EACP,KAAK;EACL,MAAM;EACN,QAAQ;EACT;CACD,MAAM;EACJ,MAAM;EACN,OAAO;EACP,KAAK;EACL,MAAM;EACN,QAAQ;EACT;CACD,MAAM;EACJ,MAAM;EACN,OAAO;EACP,KAAK;EACL,MAAM;EACN,QAAQ;EACR,QAAQ;EACT;CACD,UAAU;EACR,MAAM;EACN,OAAO;EACP,KAAK;EACN;CACD,UAAU;EACR,MAAM;EACN,QAAQ;EACR,QAAQ;EACT;CACF;;;;;;;;;;;;AAaD,MAAa,QACX,MACA,YAGW;CACX,MAAM,WAAW,IAAI,KAAK,KAAK;CAE/B,MAAM,kBACJ,OAAO,YAAY,WAAY,QAAQ,YAAY,EAAE,GAAI;CAE3D,MAAM,UACH,OAAO,YAAY,WAAW,SAAS,SAAS,WACjD,eAAe,sBAAsB;AAIvC,QAFkB,cAAc,KAAK,gBAAgB,QAAQ,gBAAgB,CAE5D,OAAO,SAAS"}

package/dist/esm/formatters/index.mjs

@@ -1,4 +1,4 @@
-import { CachedIntl, bindIntl, createCachedIntl } from "../utils/intl.mjs";
+import { CachedIntl, bindIntl, getCachedIntl } from "../utils/intl.mjs";
 import { compact } from "./compact.mjs";
 import { currency } from "./currency.mjs";
 import { date, presets } from "./date.mjs";
@@ -8,4 +8,4 @@ import { percentage } from "./percentage.mjs";
 import { relativeTime } from "./relativeTime.mjs";
 import { units } from "./units.mjs";
 
-export { CachedIntl, CachedIntl as Intl, bindIntl, compact, createCachedIntl, currency, date, list, number, percentage, presets, relativeTime, units };
+export { CachedIntl, CachedIntl as Intl, bindIntl, compact, currency, date, getCachedIntl, list, number, percentage, presets, relativeTime, units };

package/dist/esm/formatters/list.mjs

@@ -1,4 +1,4 @@
-import { CachedIntl } from "../utils/intl.mjs";
+import { getCachedIntl } from "../utils/intl.mjs";
 import configuration from "@intlayer/config/built";
 
 //#region src/formatters/list.ts
@@ -17,7 +17,7 @@ import configuration from "@intlayer/config/built";
 * list([1, 2, 3], { type: 'unit' });
 * // "1, 2, 3"
 */
-const list = (values, options) => new CachedIntl.ListFormat(options?.locale ?? configuration?.internationalization?.defaultLocale, {
+const list = (values, options) => getCachedIntl(Intl.ListFormat, options?.locale ?? configuration?.internationalization?.defaultLocale, {
 	type: options?.type ?? "conjunction",
 	style: options?.style ?? "long",
 	...options

package/dist/esm/formatters/list.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"list.mjs","names":[],"sources":["../../../src/formatters/list.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { Intl as CachedIntl } from '../utils/intl';\n\n/** Locally defined subset of Intl.ListFormatOptions so consumers don't need ES2021.Intl in their lib. */\ntype ListFormatOptions = {\n  localeMatcher?: 'lookup' | 'best fit';\n  type?: 'conjunction' | 'disjunction' | 'unit';\n  style?: 'long' | 'short' | 'narrow';\n};\n\n/**\n * Formats an array of values into a localized list string using the Intl API.\n *\n * @example\n * list(['apple', 'banana', 'orange']);\n * // \"apple, banana, and orange\"\n *\n * @example\n * list(['red', 'green', 'blue'], { locale: Locales.FRENCH, type: 'disjunction' });\n * // \"rouge, vert ou bleu\"\n *\n * @example\n * list([1, 2, 3], { type: 'unit' });\n * // \"1, 2, 3\"\n */\nexport const list = (\n  values: (string | number)[],\n  options?: ListFormatOptions & { locale?: LocalesValues }\n): string =>\n  new CachedIntl.ListFormat(\n    options?.locale ?? configuration?.internationalization?.defaultLocale,\n    {\n      type: options?.type ?? 'conjunction',\n      style: options?.style ?? 'long',\n      ...options,\n    }\n  ).format(values.map(String));\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA0BA,MAAa,QACX,QACA,YAEA,IAAI,WAAW,WACb,SAAS,UAAU,eAAe,sBAAsB,eACxD;CACE,MAAM,SAAS,QAAQ;CACvB,OAAO,SAAS,SAAS;CACzB,GAAG;CACJ,CACF,CAAC,OAAO,OAAO,IAAI,OAAO,CAAC"}
+{"version":3,"file":"list.mjs","names":[],"sources":["../../../src/formatters/list.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { getCachedIntl } from '../utils/intl';\n\n/** Locally defined subset of Intl.ListFormatOptions so consumers don't need ES2021.Intl in their lib. */\ntype ListFormatOptions = {\n  localeMatcher?: 'lookup' | 'best fit';\n  type?: 'conjunction' | 'disjunction' | 'unit';\n  style?: 'long' | 'short' | 'narrow';\n};\n\n/**\n * Formats an array of values into a localized list string using the Intl API.\n *\n * @example\n * list(['apple', 'banana', 'orange']);\n * // \"apple, banana, and orange\"\n *\n * @example\n * list(['red', 'green', 'blue'], { locale: Locales.FRENCH, type: 'disjunction' });\n * // \"rouge, vert ou bleu\"\n *\n * @example\n * list([1, 2, 3], { type: 'unit' });\n * // \"1, 2, 3\"\n */\nexport const list = (\n  values: (string | number)[],\n  options?: ListFormatOptions & { locale?: LocalesValues }\n): string =>\n  getCachedIntl(\n    (Intl as any).ListFormat,\n    options?.locale ?? configuration?.internationalization?.defaultLocale,\n    {\n      type: options?.type ?? 'conjunction',\n      style: options?.style ?? 'long',\n      ...options,\n    }\n  ).format(values.map(String));\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA0BA,MAAa,QACX,QACA,YAEA,cACG,KAAa,YACd,SAAS,UAAU,eAAe,sBAAsB,eACxD;CACE,MAAM,SAAS,QAAQ;CACvB,OAAO,SAAS,SAAS;CACzB,GAAG;CACJ,CACF,CAAC,OAAO,OAAO,IAAI,OAAO,CAAC"}

package/dist/esm/formatters/number.mjs

@@ -1,4 +1,4 @@
-import { CachedIntl } from "../utils/intl.mjs";
+import { getCachedIntl } from "../utils/intl.mjs";
 import configuration from "@intlayer/config/built";
 
 //#region src/formatters/number.ts
@@ -11,7 +11,7 @@ import configuration from "@intlayer/config/built";
 * @example
 * number("1000000", { locale: Locales.FRENCH }); // "1 000 000"
 */
-const number = (value, options) => new CachedIntl.NumberFormat(options?.locale ?? configuration?.internationalization?.defaultLocale, options).format(Number(value));
+const number = (value, { locale, ...options } = {}) => getCachedIntl(Intl.NumberFormat, locale ?? configuration?.internationalization?.defaultLocale, options).format(Number(value));
 
 //#endregion
 export { number };

package/dist/esm/formatters/number.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"number.mjs","names":[],"sources":["../../../src/formatters/number.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { Intl as CachedIntl } from '../utils/intl';\n\n/**\n * Formats a numeric value using locale-aware formatting.\n *\n * @example\n * number(123456.789); // \"123,456.789\"\n *\n * @example\n * number(\"1000000\", { locale: Locales.FRENCH }); // \"1 000 000\"\n */\nexport const number = (\n  value: string | number,\n  options?: Intl.NumberFormatOptions & { locale?: LocalesValues }\n): string =>\n  new CachedIntl.NumberFormat(\n    options?.locale ?? configuration?.internationalization?.defaultLocale,\n    options\n  ).format(Number(value));\n"],"mappings":";;;;;;;;;;;;;AAaA,MAAa,UACX,OACA,YAEA,IAAI,WAAW,aACb,SAAS,UAAU,eAAe,sBAAsB,eACxD,QACD,CAAC,OAAO,OAAO,MAAM,CAAC"}
+{"version":3,"file":"number.mjs","names":[],"sources":["../../../src/formatters/number.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { getCachedIntl } from '../utils/intl';\n\n/**\n * Formats a numeric value using locale-aware formatting.\n *\n * @example\n * number(123456.789); // \"123,456.789\"\n *\n * @example\n * number(\"1000000\", { locale: Locales.FRENCH }); // \"1 000 000\"\n */\nexport const number = (\n  value: string | number,\n  {\n    locale,\n    ...options\n  }: Intl.NumberFormatOptions & { locale?: LocalesValues } = {}\n): string =>\n  getCachedIntl(\n    Intl.NumberFormat,\n    locale ?? configuration?.internationalization?.defaultLocale,\n    options\n  ).format(Number(value));\n"],"mappings":";;;;;;;;;;;;;AAaA,MAAa,UACX,OACA,EACE,QACA,GAAG,YACsD,EAAE,KAE7D,cACE,KAAK,cACL,UAAU,eAAe,sBAAsB,eAC/C,QACD,CAAC,OAAO,OAAO,MAAM,CAAC"}

package/dist/esm/formatters/percentage.mjs

@@ -1,4 +1,4 @@
-import { CachedIntl } from "../utils/intl.mjs";
+import { getCachedIntl } from "../utils/intl.mjs";
 import configuration from "@intlayer/config/built";
 
 //#region src/formatters/percentage.ts
@@ -11,10 +11,10 @@ import configuration from "@intlayer/config/built";
 * @example
 * percentage(0.25, { minimumFractionDigits: 2 }); // "25.00%"
 */
-const percentage = (value, options) => {
+const percentage = (value, { locale, ...options } = {}) => {
 	let numericValue = Number(value);
 	if (numericValue > 1) numericValue /= 100;
-	return new CachedIntl.NumberFormat(options?.locale ?? configuration?.internationalization?.defaultLocale, {
+	return getCachedIntl(Intl.NumberFormat, locale ?? configuration?.internationalization?.defaultLocale, {
 		style: "percent",
 		...options
 	}).format(Number(numericValue));

package/dist/esm/formatters/percentage.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"percentage.mjs","names":[],"sources":["../../../src/formatters/percentage.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { Intl as CachedIntl } from '../utils/intl';\n\n/**\n * Formats a number as a percentage string (e.g., 0.25 → \"25%\").\n *\n * @example\n * percentage(0.25); // \"25%\"\n *\n * @example\n * percentage(0.25, { minimumFractionDigits: 2 }); // \"25.00%\"\n */\nexport const percentage = (\n  value: string | number,\n  options?: Intl.NumberFormatOptions & { locale?: LocalesValues }\n): string => {\n  let numericValue = Number(value);\n\n  // Normalize: if user passes 10, treat it as 10% instead of 1000%\n  if (numericValue > 1) {\n    numericValue /= 100;\n  }\n\n  const formatter = new CachedIntl.NumberFormat(\n    options?.locale ?? configuration?.internationalization?.defaultLocale,\n    {\n      style: 'percent',\n      ...options,\n    }\n  );\n\n  return formatter.format(Number(numericValue));\n};\n"],"mappings":";;;;;;;;;;;;;AAaA,MAAa,cACX,OACA,YACW;CACX,IAAI,eAAe,OAAO,MAAM;AAGhC,KAAI,eAAe,EACjB,iBAAgB;AAWlB,QARkB,IAAI,WAAW,aAC/B,SAAS,UAAU,eAAe,sBAAsB,eACxD;EACE,OAAO;EACP,GAAG;EACJ,CACF,CAEgB,OAAO,OAAO,aAAa,CAAC"}
+{"version":3,"file":"percentage.mjs","names":[],"sources":["../../../src/formatters/percentage.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { getCachedIntl } from '../utils/intl';\n\n/**\n * Formats a number as a percentage string (e.g., 0.25 → \"25%\").\n *\n * @example\n * percentage(0.25); // \"25%\"\n *\n * @example\n * percentage(0.25, { minimumFractionDigits: 2 }); // \"25.00%\"\n */\nexport const percentage = (\n  value: string | number,\n  {\n    locale,\n    ...options\n  }: Intl.NumberFormatOptions & { locale?: LocalesValues } = {}\n): string => {\n  let numericValue = Number(value);\n\n  // Normalize: if user passes 10, treat it as 10% instead of 1000%\n  if (numericValue > 1) {\n    numericValue /= 100;\n  }\n\n  const formatter = getCachedIntl(\n    Intl.NumberFormat,\n    locale ?? configuration?.internationalization?.defaultLocale,\n    {\n      style: 'percent',\n      ...options,\n    }\n  );\n\n  return formatter.format(Number(numericValue));\n};\n"],"mappings":";;;;;;;;;;;;;AAaA,MAAa,cACX,OACA,EACE,QACA,GAAG,YACsD,EAAE,KAClD;CACX,IAAI,eAAe,OAAO,MAAM;AAGhC,KAAI,eAAe,EACjB,iBAAgB;AAYlB,QATkB,cAChB,KAAK,cACL,UAAU,eAAe,sBAAsB,eAC/C;EACE,OAAO;EACP,GAAG;EACJ,CACF,CAEgB,OAAO,OAAO,aAAa,CAAC"}

package/dist/esm/formatters/relativeTime.mjs

@@ -1,4 +1,4 @@
-import { CachedIntl } from "../utils/intl.mjs";
+import { getCachedIntl } from "../utils/intl.mjs";
 import configuration from "@intlayer/config/built";
 
 //#region src/formatters/relativeTime.ts
@@ -33,7 +33,7 @@ const relativeTime = (from, to = /* @__PURE__ */ new Date(), options) => {
 	const toDate = new Date(to);
 	const unit = options?.unit ?? "second";
 	const value = diffInUnit(fromDate, toDate, unit);
-	return new CachedIntl.RelativeTimeFormat(options?.locale ?? configuration?.internationalization?.defaultLocale, options).format(Math.round(value), unit);
+	return getCachedIntl(Intl.RelativeTimeFormat, options?.locale ?? configuration?.internationalization?.defaultLocale, options).format(Math.round(value), unit);
 };
 
 //#endregion

package/dist/esm/formatters/relativeTime.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"relativeTime.mjs","names":[],"sources":["../../../src/formatters/relativeTime.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { Intl as CachedIntl } from '../utils/intl';\n\ntype RelativeTimeUnit = Intl.RelativeTimeFormatUnit;\n\n/**\n * Calculate the difference between 2 dates in the given unit.\n */\nconst diffInUnit = (from: Date, to: Date, unit: RelativeTimeUnit): number => {\n  const msDiff = to.getTime() - from.getTime();\n  const sec = msDiff / 1000;\n\n  switch (unit) {\n    case 'second':\n      return sec;\n    case 'minute':\n      return sec / 60;\n    case 'hour':\n      return sec / 3600;\n    case 'day':\n      return sec / 86400;\n    case 'month':\n      return sec / (30 * 86400); // approx\n    case 'quarter':\n      return sec / (3 * 30 * 86400); // 3 months approx\n    case 'year':\n      return sec / (365 * 86400); // approx\n    default:\n      return sec;\n  }\n};\n\n/**\n * Formats the difference between two dates as a localized relative time string.\n *\n * @example\n * relativeTime(new Date(Date.now() - 30000)); // \"30 seconds ago\"\n *\n * @example\n * relativeTime(\"2025-01-01\", new Date(), { locale: Locales.FRENCH, unit: \"day\" });\n * // \"il y a 443 jours\"\n */\nexport const relativeTime = (\n  from: Date | string | number,\n  to: Date | string | number = new Date(),\n  options?: Intl.RelativeTimeFormatOptions & {\n    locale?: LocalesValues;\n    unit?: RelativeTimeUnit;\n  }\n): string => {\n  const fromDate = new Date(from);\n  const toDate = new Date(to);\n  const unit = options?.unit ?? 'second';\n\n  const value = diffInUnit(fromDate, toDate, unit);\n\n  return new CachedIntl.RelativeTimeFormat(\n    options?.locale ?? configuration?.internationalization?.defaultLocale,\n    options\n  ).format(Math.round(value), unit);\n};\n"],"mappings":";;;;;;;AASA,MAAM,cAAc,MAAY,IAAU,SAAmC;CAE3E,MAAM,OADS,GAAG,SAAS,GAAG,KAAK,SAAS,IACvB;AAErB,SAAQ,MAAR;EACE,KAAK,SACH,QAAO;EACT,KAAK,SACH,QAAO,MAAM;EACf,KAAK,OACH,QAAO,MAAM;EACf,KAAK,MACH,QAAO,MAAM;EACf,KAAK,QACH,QAAO,OAAO,KAAK;EACrB,KAAK,UACH,QAAO,OAAO,KAAS;EACzB,KAAK,OACH,QAAO,OAAO,MAAM;EACtB,QACE,QAAO;;;;;;;;;;;;;AAcb,MAAa,gBACX,MACA,qBAA6B,IAAI,MAAM,EACvC,YAIW;CACX,MAAM,WAAW,IAAI,KAAK,KAAK;CAC/B,MAAM,SAAS,IAAI,KAAK,GAAG;CAC3B,MAAM,OAAO,SAAS,QAAQ;CAE9B,MAAM,QAAQ,WAAW,UAAU,QAAQ,KAAK;AAEhD,QAAO,IAAI,WAAW,mBACpB,SAAS,UAAU,eAAe,sBAAsB,eACxD,QACD,CAAC,OAAO,KAAK,MAAM,MAAM,EAAE,KAAK"}
+{"version":3,"file":"relativeTime.mjs","names":[],"sources":["../../../src/formatters/relativeTime.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { getCachedIntl } from '../utils/intl';\n\ntype RelativeTimeUnit = Intl.RelativeTimeFormatUnit;\n\n/**\n * Calculate the difference between 2 dates in the given unit.\n */\nconst diffInUnit = (from: Date, to: Date, unit: RelativeTimeUnit): number => {\n  const msDiff = to.getTime() - from.getTime();\n  const sec = msDiff / 1000;\n\n  switch (unit) {\n    case 'second':\n      return sec;\n    case 'minute':\n      return sec / 60;\n    case 'hour':\n      return sec / 3600;\n    case 'day':\n      return sec / 86400;\n    case 'month':\n      return sec / (30 * 86400); // approx\n    case 'quarter':\n      return sec / (3 * 30 * 86400); // 3 months approx\n    case 'year':\n      return sec / (365 * 86400); // approx\n    default:\n      return sec;\n  }\n};\n\n/**\n * Formats the difference between two dates as a localized relative time string.\n *\n * @example\n * relativeTime(new Date(Date.now() - 30000)); // \"30 seconds ago\"\n *\n * @example\n * relativeTime(\"2025-01-01\", new Date(), { locale: Locales.FRENCH, unit: \"day\" });\n * // \"il y a 443 jours\"\n */\nexport const relativeTime = (\n  from: Date | string | number,\n  to: Date | string | number = new Date(),\n  options?: Intl.RelativeTimeFormatOptions & {\n    locale?: LocalesValues;\n    unit?: RelativeTimeUnit;\n  }\n): string => {\n  const fromDate = new Date(from);\n  const toDate = new Date(to);\n  const unit = options?.unit ?? 'second';\n\n  const value = diffInUnit(fromDate, toDate, unit);\n\n  return getCachedIntl(\n    Intl.RelativeTimeFormat,\n    options?.locale ?? configuration?.internationalization?.defaultLocale,\n    options\n  ).format(Math.round(value), unit);\n};\n"],"mappings":";;;;;;;AASA,MAAM,cAAc,MAAY,IAAU,SAAmC;CAE3E,MAAM,OADS,GAAG,SAAS,GAAG,KAAK,SAAS,IACvB;AAErB,SAAQ,MAAR;EACE,KAAK,SACH,QAAO;EACT,KAAK,SACH,QAAO,MAAM;EACf,KAAK,OACH,QAAO,MAAM;EACf,KAAK,MACH,QAAO,MAAM;EACf,KAAK,QACH,QAAO,OAAO,KAAK;EACrB,KAAK,UACH,QAAO,OAAO,KAAS;EACzB,KAAK,OACH,QAAO,OAAO,MAAM;EACtB,QACE,QAAO;;;;;;;;;;;;;AAcb,MAAa,gBACX,MACA,qBAA6B,IAAI,MAAM,EACvC,YAIW;CACX,MAAM,WAAW,IAAI,KAAK,KAAK;CAC/B,MAAM,SAAS,IAAI,KAAK,GAAG;CAC3B,MAAM,OAAO,SAAS,QAAQ;CAE9B,MAAM,QAAQ,WAAW,UAAU,QAAQ,KAAK;AAEhD,QAAO,cACL,KAAK,oBACL,SAAS,UAAU,eAAe,sBAAsB,eACxD,QACD,CAAC,OAAO,KAAK,MAAM,MAAM,EAAE,KAAK"}