@intlayer/core 8.5.1 → 8.6.0

package/dist/esm/utils/intl.mjs

@@ -1,87 +1,102 @@
-import { ENGLISH } from "@intlayer/types/locales";
+import configuration from "@intlayer/config/built";
 
 //#region src/utils/intl.ts
 /**
-* Optimized Cache Key Generator
-* 1. Fast path: If no options, just use the locale string.
-* 2. Normal path: JSON.stringify for deterministic object comparison.
+* Cached Intl helper – drop‑in replacement for the global `Intl` object.
+* ‑‑‑
+* • Uses a `Proxy` to lazily wrap every *constructor* hanging off `Intl` (NumberFormat, DateTimeFormat, …).
+* • Each wrapped constructor keeps an in‑memory cache keyed by `[locales, options]` so that identical requests
+* reuse the same heavy instance instead of reparsing CLDR data every time.
+* • A polyfill warning for `Intl.DisplayNames` is emitted only once and only in dev.
+* • The public API is fully type‑safe and mirrors the native `Intl` surface exactly –
+* you can treat `CachedIntl` just like the built‑in `Intl`.
+*
+* Usage @example:
+* ---------------
+* ```ts
+* import { CachedIntl } from "./cached-intl";
+*
+* const nf = CachedIntl.NumberFormat("en-US", { style: "currency", currency: "USD" });
+* console.log(nf.format(1234));
+*
+* const dn = CachedIntl.DisplayNames(["fr"], { type: "language" });
+* console.log(dn.of("en")); * → "anglais"
+*
+* You can also spin up an isolated instance with its own caches (handy in test suites):
+* const TestIntl = createCachedIntl();
+* ```
 */
-const getCacheKey = (locales, options) => {
-	const localeKey = locales ? String(locales) : ENGLISH;
-	if (!options) return localeKey;
-	return `${localeKey}|${JSON.stringify(options)}`;
-};
+const MAX_CACHE_SIZE = 50;
+const cache = /* @__PURE__ */ new Map();
 /**
-* Generic wrapper for any `new Intl.*()` constructor.
+* Generic caching instantiator for Intl constructors.
 */
-const createCachedConstructor = (Ctor) => {
-	const cache = /* @__PURE__ */ new Map();
-	const MAX_CACHE_SIZE = 50;
-	function Wrapped(locales, options) {
-		let resolvedLocales = locales;
-		let resolvedOptions = options;
-		if (typeof locales === "object" && !Array.isArray(locales) && locales !== null) {
-			resolvedOptions = locales;
-			resolvedLocales = locales.locale;
-		}
-		if (Ctor.name === "DisplayNames" && typeof Intl?.DisplayNames !== "function") {}
-		const key = getCacheKey(resolvedLocales, resolvedOptions);
-		let instance = cache.get(key);
-		if (instance) return instance;
-		instance = new Ctor(resolvedLocales, resolvedOptions);
-		if (cache.size >= MAX_CACHE_SIZE) {
-			const oldestKey = cache.keys().next().value;
-			if (oldestKey) cache.delete(oldestKey);
-		}
-		cache.set(key, instance);
-		return instance;
+const getCachedIntl = (Ctor, locale, options) => {
+	const resLoc = locale ?? configuration?.internationalization?.defaultLocale;
+	const key = `${resLoc}|${options ? JSON.stringify(options) : ""}`;
+	let ctorCache = cache.get(Ctor);
+	if (!ctorCache) {
+		ctorCache = /* @__PURE__ */ new Map();
+		cache.set(Ctor, ctorCache);
 	}
-	Wrapped.prototype = Ctor.prototype;
-	return Wrapped;
+	let instance = ctorCache.get(key);
+	if (!instance) {
+		if (ctorCache.size > MAX_CACHE_SIZE) ctorCache.clear();
+		instance = new Ctor(resLoc, options);
+		ctorCache.set(key, instance);
+	}
+	return instance;
 };
 /**
-* Factory that turns the global `Intl` into a cached clone.
+* Optional: Keep bindIntl if your library exports it publicly.
+* It now uses the much smaller getCachedIntl under the hood.
 */
-const createCachedIntl = () => {
-	const constructorCache = /* @__PURE__ */ new Map();
-	return new Proxy(Intl, { get: (target, prop, receiver) => {
-		if (constructorCache.has(prop)) return constructorCache.get(prop);
-		const value = Reflect.get(target, prop, receiver);
-		if (typeof value === "function" && typeof prop === "string" && /^[A-Z]/.test(prop)) {
-			const wrapped = createCachedConstructor(value);
-			constructorCache.set(prop, wrapped);
-			return wrapped;
-		}
-		return value;
-	} });
+const bindIntl = (boundLocale) => {
+	const bindWrap = (Ctor) => function intlConstructor(locales, options) {
+		const isOptsFirst = locales !== null && typeof locales === "object" && !Array.isArray(locales);
+		const resOpts = isOptsFirst ? locales : options;
+		return getCachedIntl(Ctor, isOptsFirst ? resOpts.locale || boundLocale : locales || boundLocale, resOpts);
+	};
+	return {
+		...Intl,
+		Collator: bindWrap(Intl.Collator),
+		DateTimeFormat: bindWrap(Intl.DateTimeFormat),
+		DisplayNames: bindWrap(Intl.DisplayNames),
+		ListFormat: bindWrap(Intl.ListFormat),
+		NumberFormat: bindWrap(Intl.NumberFormat),
+		PluralRules: bindWrap(Intl.PluralRules),
+		RelativeTimeFormat: bindWrap(Intl.RelativeTimeFormat),
+		Locale: bindWrap(Intl.Locale),
+		Segmenter: bindWrap(Intl.Segmenter)
+	};
 };
-const CachedIntl = createCachedIntl();
-/**
-* Creates a proxied Intl object with a preset locale.
-*
-* @example
-* const intl = bindIntl(Locales.FRENCH);
-* new intl.NumberFormat(undefined, { style: 'currency', currency: 'EUR' }).format(10);
-* // Uses 'fr' automatically
-*/
-const bindIntl = (locale) => {
-	return new Proxy(CachedIntl, { get: (target, prop) => {
-		const value = Reflect.get(target, prop);
-		if (typeof value === "function" && typeof prop === "string" && /^[A-Z]/.test(prop)) return new Proxy(value, {
-			construct: (Ctor, args) => {
-				let [locales, options] = args;
-				if (typeof locales === "object" && !Array.isArray(locales) && locales !== null) {
-					options = locales;
-					locales = options.locale ?? locale;
-				} else if (locales === void 0) locales = locale;
-				return new Ctor(locales, options);
-			},
-			get: (Ctor, key) => Reflect.get(Ctor, key)
-		});
-		return value;
-	} });
+const CachedIntl = {
+	Collator: function Collator(locales, options) {
+		return getCachedIntl(Intl.Collator, locales, options);
+	},
+	DateTimeFormat: function DateTimeFormat(locales, options) {
+		return getCachedIntl(Intl.DateTimeFormat, locales, options);
+	},
+	DisplayNames: function DisplayNames(locales, options) {
+		return getCachedIntl(Intl.DisplayNames, locales, options);
+	},
+	ListFormat: function ListFormat(locales, options) {
+		return getCachedIntl(Intl.ListFormat, locales, options);
+	},
+	NumberFormat: function NumberFormat(locales, options) {
+		return getCachedIntl(Intl.NumberFormat, locales, options);
+	},
+	PluralRules: function PluralRules(locales, options) {
+		return getCachedIntl(Intl.PluralRules, locales, options);
+	},
+	RelativeTimeFormat: function RelativeTimeFormat(locales, options) {
+		return getCachedIntl(Intl.RelativeTimeFormat, locales, options);
+	},
+	Segmenter: function Segmenter(locales, options) {
+		return getCachedIntl(Intl.Segmenter, locales, options);
+	}
 };
 
 //#endregion
-export { CachedIntl, CachedIntl as Intl, bindIntl, createCachedIntl };
+export { CachedIntl, CachedIntl as Intl, bindIntl, getCachedIntl };
 //# sourceMappingURL=intl.mjs.map

package/dist/esm/utils/intl.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"intl.mjs","names":[],"sources":["../../../src/utils/intl.ts"],"sourcesContent":["// Cached Intl helper – drop‑in replacement for the global `Intl` object.\n// ‑‑‑\n// • Uses a `Proxy` to lazily wrap every *constructor* hanging off `Intl` (NumberFormat, DateTimeFormat, …).\n// • Each wrapped constructor keeps an in‑memory cache keyed by `[locales, options]` so that identical requests\n// reuse the same heavy instance instead of reparsing CLDR data every time.\n// • A polyfill warning for `Intl.DisplayNames` is emitted only once and only in dev.\n// • The public API is fully type‑safe and mirrors the native `Intl` surface exactly –\n// you can treat `CachedIntl` just like the built‑in `Intl`.\n//\n// Usage examples:\n// ---------------\n// import { CachedIntl } from \"./cached-intl\";\n//\n// const nf = CachedIntl.NumberFormat(\"en-US\", { style: \"currency\", currency: \"USD\" });\n// console.log(nf.format(1234));\n//\n// const dn = CachedIntl.DisplayNames([\"fr\"], { type: \"language\" });\n// console.log(dn.of(\"en\")); // → \"anglais\"\n//\n// You can also spin up an isolated instance with its own caches (handy in test suites):\n// const TestIntl = createCachedIntl();\n//\n// ---------------------------------------------------------------------\n\nimport { ENGLISH } from '@intlayer/types/locales';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\n\n// Helper type that picks just the constructor members off `typeof Intl`.\n// The \"capital‑letter\" heuristic is 100 % accurate today and keeps the\n// mapping short‑lived, so we don't have to manually list every constructor.\ntype IntlConstructors = {\n  [K in keyof typeof Intl as (typeof Intl)[K] extends new (\n    ...args: any\n  ) => any\n    ? K\n    : never]: (typeof Intl)[K];\n};\n\n// Type wrapper to replace locale arguments with LocalesValues\ntype ReplaceLocaleWithLocalesValues<T> = T extends new (\n  locales: any,\n  options?: infer Options\n) => infer Instance\n  ? {\n      new (locales?: LocalesValues, options?: Options): Instance;\n      new (options?: Options & { locale?: LocalesValues }): Instance;\n    }\n  : T extends new (\n        locales: any\n      ) => infer Instance\n    ? {\n        new (locales?: LocalesValues): Instance;\n        new (options?: { locale?: LocalesValues }): Instance;\n      }\n    : T;\n\n// Wrapped Intl type with LocalesValues\nexport type WrappedIntl = {\n  [K in keyof typeof Intl]: K extends keyof IntlConstructors\n    ? ReplaceLocaleWithLocalesValues<(typeof Intl)[K]>\n    : (typeof Intl)[K];\n};\n\n// ... (Keep your Type Helper definitions here: IntlConstructors, ReplaceLocaleWithLocalesValues, WrappedIntl) ...\n\n/**\n * Optimized Cache Key Generator\n * 1. Fast path: If no options, just use the locale string.\n * 2. Normal path: JSON.stringify for deterministic object comparison.\n */\nconst getCacheKey = (\n  locales: LocalesValues | undefined,\n  options: unknown\n): string => {\n  const localeKey = locales ? String(locales) : ENGLISH;\n\n  if (!options) return localeKey;\n\n  // JSON.stringify is the most robust way to handle nested options objects\n  // without a heavy custom hashing function.\n  return `${localeKey}|${JSON.stringify(options)}`;\n};\n\n/**\n * Generic wrapper for any `new Intl.*()` constructor.\n */\nconst createCachedConstructor = <T extends new (...args: any[]) => any>(\n  Ctor: T\n) => {\n  // The cache lives here, inside the closure of the wrapped constructor.\n  const cache = new Map<string, InstanceType<T>>();\n  const MAX_CACHE_SIZE = 50;\n\n  function Wrapped(locales?: LocalesValues | any, options?: any) {\n    let resolvedLocales = locales;\n    let resolvedOptions = options;\n\n    // Handle case where first argument is an options object instead of locales\n    if (\n      typeof locales === 'object' &&\n      !Array.isArray(locales) &&\n      locales !== null\n    ) {\n      resolvedOptions = locales;\n      resolvedLocales = locales.locale;\n    }\n\n    // Handle DisplayNames Polyfill warning\n    if (\n      Ctor.name === 'DisplayNames' &&\n      typeof (Intl as any)?.DisplayNames !== 'function'\n    ) {\n      // ... (Existing polyfill logic would go here if needed, but let's keep it simple for now as it was empty in the read output)\n      // Actually the read output had \"// ... (Your existing polyfill warning logic) ...\"\n      // I should check what was there before or just preserve it.\n    }\n\n    // Generate Key\n    const key = getCacheKey(resolvedLocales, resolvedOptions);\n\n    // Check Cache\n    let instance = cache.get(key);\n    if (instance) return instance;\n\n    // Create New Instance\n    instance = new Ctor(resolvedLocales as never, resolvedOptions as never);\n\n    // Smart Eviction (LRU-ish)\n    // Map iterates in insertion order. Deleting the first key removes the \"oldest\".\n    if (cache.size >= MAX_CACHE_SIZE) {\n      const oldestKey = cache.keys().next().value;\n      if (oldestKey) cache.delete(oldestKey);\n    }\n\n    cache.set(key, instance as InstanceType<T>);\n    return instance as InstanceType<T>;\n  }\n\n  // Preserve prototype for `instanceof` checks\n  (Wrapped as any).prototype = (Ctor as any).prototype;\n\n  return Wrapped as unknown as ReplaceLocaleWithLocalesValues<T>;\n};\n\n/**\n * Factory that turns the global `Intl` into a cached clone.\n */\nexport const createCachedIntl = (): WrappedIntl => {\n  // We must cache the *wrapped constructors* themselves.\n  // Otherwise, the Proxy creates a new `Wrapped` function (and a new empty Map)\n  // on every single property access.\n  const constructorCache = new Map<string | symbol, any>();\n\n  return new Proxy(Intl as IntlConstructors, {\n    get: (target, prop, receiver) => {\n      // Fast return if we already wrapped this constructor\n      if (constructorCache.has(prop)) {\n        return constructorCache.get(prop);\n      }\n\n      const value = Reflect.get(target, prop, receiver);\n\n      // Wrap only Constructors (Heuristic: Function + starts with Uppercase)\n      // This prevents wrapping static methods like `Intl.getCanonicalLocales`\n      if (\n        typeof value === 'function' &&\n        typeof prop === 'string' &&\n        /^[A-Z]/.test(prop)\n      ) {\n        const wrapped = createCachedConstructor(value);\n        constructorCache.set(prop, wrapped);\n        return wrapped;\n      }\n\n      // Pass through everything else (static methods, constants)\n      return value;\n    },\n  }) as unknown as WrappedIntl;\n};\n\nexport const CachedIntl = createCachedIntl();\n\n/**\n * Creates a proxied Intl object with a preset locale.\n *\n * @example\n * const intl = bindIntl(Locales.FRENCH);\n * new intl.NumberFormat(undefined, { style: 'currency', currency: 'EUR' }).format(10);\n * // Uses 'fr' automatically\n */\nexport const bindIntl = (locale: LocalesValues): WrappedIntl => {\n  return new Proxy(CachedIntl, {\n    get: (target, prop) => {\n      const value = Reflect.get(target, prop);\n\n      // We only want to intercept Constructors (e.g., NumberFormat, DateTimeFormat)\n      // to inject the locale into their arguments.\n      if (\n        typeof value === 'function' &&\n        typeof prop === 'string' &&\n        /^[A-Z]/.test(prop)\n      ) {\n        return new Proxy(value, {\n          construct: (Ctor, args) => {\n            let [locales, options] = args;\n\n            // If the user provided a locale (args[0]), respect it.\n            // If args[0] is undefined, inject the bound locale.\n            // If args[0] is an object (not array), it's the options object.\n            if (\n              typeof locales === 'object' &&\n              !Array.isArray(locales) &&\n              locales !== null\n            ) {\n              options = locales;\n              locales = options.locale ?? locale;\n            } else if (locales === undefined) {\n              locales = locale;\n            }\n\n            // We pass it to `CachedIntl` which handles caching logic.\n            return new Ctor(locales, options);\n          },\n          // Ensure static methods (like supportedLocalesOf) still work\n          get: (Ctor, key) => Reflect.get(Ctor, key),\n        });\n      }\n\n      // Return constants or static methods as-is\n      return value;\n    },\n  }) as unknown as WrappedIntl;\n};\n\n// new CachedIntl.DisplayNames(Locales.FRENCH, { type: 'language' });\n// new CachedIntl.DisplayNames('fr', { type: 'language' });\n// new CachedIntl.DateTimeFormat('fr', {\n// year: 'numeric',\n// month: 'long',\n// day: 'numeric',\n// });\n// new CachedIntl.NumberFormat('fr', {\n// style: 'currency',\n// currency: 'EUR',\n// });\n// new CachedIntl.Collator('fr', { sensitivity: 'base' });\n// new CachedIntl.PluralRules('fr');\n// new CachedIntl.RelativeTimeFormat('fr', { numeric: 'auto' });\n// new CachedIntl.ListFormat('fr', { type: 'conjunction' });\nexport { CachedIntl as Intl };\n"],"mappings":";;;;;;;;AAsEA,MAAM,eACJ,SACA,YACW;CACX,MAAM,YAAY,UAAU,OAAO,QAAQ,GAAG;AAE9C,KAAI,CAAC,QAAS,QAAO;AAIrB,QAAO,GAAG,UAAU,GAAG,KAAK,UAAU,QAAQ;;;;;AAMhD,MAAM,2BACJ,SACG;CAEH,MAAM,wBAAQ,IAAI,KAA8B;CAChD,MAAM,iBAAiB;CAEvB,SAAS,QAAQ,SAA+B,SAAe;EAC7D,IAAI,kBAAkB;EACtB,IAAI,kBAAkB;AAGtB,MACE,OAAO,YAAY,YACnB,CAAC,MAAM,QAAQ,QAAQ,IACvB,YAAY,MACZ;AACA,qBAAkB;AAClB,qBAAkB,QAAQ;;AAI5B,MACE,KAAK,SAAS,kBACd,OAAQ,MAAc,iBAAiB,YACvC;EAOF,MAAM,MAAM,YAAY,iBAAiB,gBAAgB;EAGzD,IAAI,WAAW,MAAM,IAAI,IAAI;AAC7B,MAAI,SAAU,QAAO;AAGrB,aAAW,IAAI,KAAK,iBAA0B,gBAAyB;AAIvE,MAAI,MAAM,QAAQ,gBAAgB;GAChC,MAAM,YAAY,MAAM,MAAM,CAAC,MAAM,CAAC;AACtC,OAAI,UAAW,OAAM,OAAO,UAAU;;AAGxC,QAAM,IAAI,KAAK,SAA4B;AAC3C,SAAO;;AAIT,CAAC,QAAgB,YAAa,KAAa;AAE3C,QAAO;;;;;AAMT,MAAa,yBAAsC;CAIjD,MAAM,mCAAmB,IAAI,KAA2B;AAExD,QAAO,IAAI,MAAM,MAA0B,EACzC,MAAM,QAAQ,MAAM,aAAa;AAE/B,MAAI,iBAAiB,IAAI,KAAK,CAC5B,QAAO,iBAAiB,IAAI,KAAK;EAGnC,MAAM,QAAQ,QAAQ,IAAI,QAAQ,MAAM,SAAS;AAIjD,MACE,OAAO,UAAU,cACjB,OAAO,SAAS,YAChB,SAAS,KAAK,KAAK,EACnB;GACA,MAAM,UAAU,wBAAwB,MAAM;AAC9C,oBAAiB,IAAI,MAAM,QAAQ;AACnC,UAAO;;AAIT,SAAO;IAEV,CAAC;;AAGJ,MAAa,aAAa,kBAAkB;;;;;;;;;AAU5C,MAAa,YAAY,WAAuC;AAC9D,QAAO,IAAI,MAAM,YAAY,EAC3B,MAAM,QAAQ,SAAS;EACrB,MAAM,QAAQ,QAAQ,IAAI,QAAQ,KAAK;AAIvC,MACE,OAAO,UAAU,cACjB,OAAO,SAAS,YAChB,SAAS,KAAK,KAAK,CAEnB,QAAO,IAAI,MAAM,OAAO;GACtB,YAAY,MAAM,SAAS;IACzB,IAAI,CAAC,SAAS,WAAW;AAKzB,QACE,OAAO,YAAY,YACnB,CAAC,MAAM,QAAQ,QAAQ,IACvB,YAAY,MACZ;AACA,eAAU;AACV,eAAU,QAAQ,UAAU;eACnB,YAAY,OACrB,WAAU;AAIZ,WAAO,IAAI,KAAK,SAAS,QAAQ;;GAGnC,MAAM,MAAM,QAAQ,QAAQ,IAAI,MAAM,IAAI;GAC3C,CAAC;AAIJ,SAAO;IAEV,CAAC"}
+{"version":3,"file":"intl.mjs","names":[],"sources":["../../../src/utils/intl.ts"],"sourcesContent":["/**\n * Cached Intl helper – drop‑in replacement for the global `Intl` object.\n * ‑‑‑\n * • Uses a `Proxy` to lazily wrap every *constructor* hanging off `Intl` (NumberFormat, DateTimeFormat, …).\n * • Each wrapped constructor keeps an in‑memory cache keyed by `[locales, options]` so that identical requests\n * reuse the same heavy instance instead of reparsing CLDR data every time.\n * • A polyfill warning for `Intl.DisplayNames` is emitted only once and only in dev.\n * • The public API is fully type‑safe and mirrors the native `Intl` surface exactly –\n * you can treat `CachedIntl` just like the built‑in `Intl`.\n *\n * Usage @example:\n * ---------------\n * ```ts\n * import { CachedIntl } from \"./cached-intl\";\n *\n * const nf = CachedIntl.NumberFormat(\"en-US\", { style: \"currency\", currency: \"USD\" });\n * console.log(nf.format(1234));\n *\n * const dn = CachedIntl.DisplayNames([\"fr\"], { type: \"language\" });\n * console.log(dn.of(\"en\")); * → \"anglais\"\n *\n * You can also spin up an isolated instance with its own caches (handy in test suites):\n * const TestIntl = createCachedIntl();\n * ```\n */\n\nimport configuration from '@intlayer/config/built';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\n\nconst MAX_CACHE_SIZE = 50;\nconst cache = new Map<any, Map<string, any>>();\n\ntype IntlConstructors = {\n  [K in keyof typeof Intl as (typeof Intl)[K] extends new (\n    ...args: any\n  ) => any\n    ? K\n    : never]: (typeof Intl)[K];\n};\n\ntype ReplaceLocaleWithLocalesValues<T> = T extends new (\n  locales: any,\n  options?: infer Options\n) => infer Instance\n  ? {\n      new (locales?: LocalesValues, options?: Options): Instance;\n      new (options?: Options & { locale?: LocalesValues }): Instance;\n      (locales?: LocalesValues, options?: Options): Instance;\n      (options?: Options & { locale?: LocalesValues }): Instance;\n    }\n  : T extends new (\n        locales: any\n      ) => infer Instance\n    ? {\n        new (locales?: LocalesValues): Instance;\n        new (options?: { locale?: LocalesValues }): Instance;\n        (locales?: LocalesValues): Instance;\n        (options?: { locale?: LocalesValues }): Instance;\n      }\n    : T;\n\nexport type WrappedIntl = {\n  [K in keyof typeof Intl]: K extends keyof IntlConstructors\n    ? ReplaceLocaleWithLocalesValues<(typeof Intl)[K]>\n    : (typeof Intl)[K];\n};\n\n/**\n * Generic caching instantiator for Intl constructors.\n */\nexport const getCachedIntl = <T extends new (...args: any[]) => any>(\n  Ctor: T,\n  locale?: LocalesValues | string,\n  options?: any\n): InstanceType<T> => {\n  const resLoc = locale ?? configuration?.internationalization?.defaultLocale;\n  const optKey = options ? JSON.stringify(options) : '';\n  const key = `${resLoc}|${optKey}`;\n\n  let ctorCache = cache.get(Ctor);\n\n  if (!ctorCache) {\n    ctorCache = new Map();\n    cache.set(Ctor, ctorCache);\n  }\n\n  let instance = ctorCache.get(key);\n\n  if (!instance) {\n    if (ctorCache.size > MAX_CACHE_SIZE) ctorCache.clear();\n    instance = new Ctor(resLoc, options);\n    ctorCache.set(key, instance);\n  }\n  return instance;\n};\n\n/**\n * Optional: Keep bindIntl if your library exports it publicly.\n * It now uses the much smaller getCachedIntl under the hood.\n */\nexport const bindIntl = (boundLocale: LocalesValues): WrappedIntl => {\n  const bindWrap = (Ctor: any) =>\n    // function is used as a constructor, do not change in arrow function\n    function intlConstructor(locales?: any, options?: any) {\n      const isOptsFirst =\n        locales !== null &&\n        typeof locales === 'object' &&\n        !Array.isArray(locales);\n      const resOpts = isOptsFirst ? locales : options;\n      const resLoc = isOptsFirst\n        ? (resOpts as any).locale || boundLocale\n        : locales || boundLocale;\n\n      return getCachedIntl(Ctor, resLoc, resOpts);\n    };\n\n  return {\n    ...Intl,\n    Collator: bindWrap(Intl.Collator),\n    DateTimeFormat: bindWrap(Intl.DateTimeFormat),\n    DisplayNames: bindWrap(Intl.DisplayNames),\n    ListFormat: bindWrap(Intl.ListFormat),\n    NumberFormat: bindWrap(Intl.NumberFormat),\n    PluralRules: bindWrap(Intl.PluralRules),\n    RelativeTimeFormat: bindWrap(Intl.RelativeTimeFormat),\n    Locale: bindWrap(Intl.Locale),\n    Segmenter: bindWrap((Intl as any).Segmenter),\n  } as unknown as WrappedIntl;\n};\n\n// Add this to the bottom of utils/intl.ts ONLY if required for public API compatibility.\nexport const CachedIntl = {\n  // function is used as a constructor, do not change in arrow function\n  Collator: function Collator(locales?: any, options?: any) {\n    return getCachedIntl(Intl.Collator, locales, options);\n  },\n  DateTimeFormat: function DateTimeFormat(locales?: any, options?: any) {\n    return getCachedIntl(Intl.DateTimeFormat, locales, options);\n  },\n  DisplayNames: function DisplayNames(locales?: any, options?: any) {\n    return getCachedIntl(Intl.DisplayNames, locales, options);\n  },\n  ListFormat: function ListFormat(locales?: any, options?: any) {\n    return getCachedIntl(Intl.ListFormat as any, locales, options);\n  },\n  NumberFormat: function NumberFormat(locales?: any, options?: any) {\n    return getCachedIntl(Intl.NumberFormat, locales, options);\n  },\n  PluralRules: function PluralRules(locales?: any, options?: any) {\n    return getCachedIntl(Intl.PluralRules, locales, options);\n  },\n  RelativeTimeFormat: function RelativeTimeFormat(\n    locales?: any,\n    options?: any\n  ) {\n    return getCachedIntl(Intl.RelativeTimeFormat, locales, options);\n  },\n  Segmenter: function Segmenter(locales?: any, options?: any) {\n    return getCachedIntl((Intl as any).Segmenter, locales, options);\n  },\n} as any; // Cast to 'any' internally to avoid TS readonly errors\n\nexport { CachedIntl as Intl };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BA,MAAM,iBAAiB;AACvB,MAAM,wBAAQ,IAAI,KAA4B;;;;AAwC9C,MAAa,iBACX,MACA,QACA,YACoB;CACpB,MAAM,SAAS,UAAU,eAAe,sBAAsB;CAE9D,MAAM,MAAM,GAAG,OAAO,GADP,UAAU,KAAK,UAAU,QAAQ,GAAG;CAGnD,IAAI,YAAY,MAAM,IAAI,KAAK;AAE/B,KAAI,CAAC,WAAW;AACd,8BAAY,IAAI,KAAK;AACrB,QAAM,IAAI,MAAM,UAAU;;CAG5B,IAAI,WAAW,UAAU,IAAI,IAAI;AAEjC,KAAI,CAAC,UAAU;AACb,MAAI,UAAU,OAAO,eAAgB,WAAU,OAAO;AACtD,aAAW,IAAI,KAAK,QAAQ,QAAQ;AACpC,YAAU,IAAI,KAAK,SAAS;;AAE9B,QAAO;;;;;;AAOT,MAAa,YAAY,gBAA4C;CACnE,MAAM,YAAY,SAEhB,SAAS,gBAAgB,SAAe,SAAe;EACrD,MAAM,cACJ,YAAY,QACZ,OAAO,YAAY,YACnB,CAAC,MAAM,QAAQ,QAAQ;EACzB,MAAM,UAAU,cAAc,UAAU;AAKxC,SAAO,cAAc,MAJN,cACV,QAAgB,UAAU,cAC3B,WAAW,aAEoB,QAAQ;;AAG/C,QAAO;EACL,GAAG;EACH,UAAU,SAAS,KAAK,SAAS;EACjC,gBAAgB,SAAS,KAAK,eAAe;EAC7C,cAAc,SAAS,KAAK,aAAa;EACzC,YAAY,SAAS,KAAK,WAAW;EACrC,cAAc,SAAS,KAAK,aAAa;EACzC,aAAa,SAAS,KAAK,YAAY;EACvC,oBAAoB,SAAS,KAAK,mBAAmB;EACrD,QAAQ,SAAS,KAAK,OAAO;EAC7B,WAAW,SAAU,KAAa,UAAU;EAC7C;;AAIH,MAAa,aAAa;CAExB,UAAU,SAAS,SAAS,SAAe,SAAe;AACxD,SAAO,cAAc,KAAK,UAAU,SAAS,QAAQ;;CAEvD,gBAAgB,SAAS,eAAe,SAAe,SAAe;AACpE,SAAO,cAAc,KAAK,gBAAgB,SAAS,QAAQ;;CAE7D,cAAc,SAAS,aAAa,SAAe,SAAe;AAChE,SAAO,cAAc,KAAK,cAAc,SAAS,QAAQ;;CAE3D,YAAY,SAAS,WAAW,SAAe,SAAe;AAC5D,SAAO,cAAc,KAAK,YAAmB,SAAS,QAAQ;;CAEhE,cAAc,SAAS,aAAa,SAAe,SAAe;AAChE,SAAO,cAAc,KAAK,cAAc,SAAS,QAAQ;;CAE3D,aAAa,SAAS,YAAY,SAAe,SAAe;AAC9D,SAAO,cAAc,KAAK,aAAa,SAAS,QAAQ;;CAE1D,oBAAoB,SAAS,mBAC3B,SACA,SACA;AACA,SAAO,cAAc,KAAK,oBAAoB,SAAS,QAAQ;;CAEjE,WAAW,SAAS,UAAU,SAAe,SAAe;AAC1D,SAAO,cAAe,KAAa,WAAW,SAAS,QAAQ;;CAElE"}

package/dist/esm/utils/localeStorage.mjs

@@ -1,4 +1,3 @@
-import { getStorageAttributes } from "../getStorageAttributes.mjs";
 import { getCookie } from "./getCookie.mjs";
 import configuration from "@intlayer/config/built";
 
@@ -13,78 +12,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 } = configuration;
 	const { locales } = internationalization;
-	const { storage } = routing;
-	if (storage === false || options?.isCookieEnabled === false) return void 0;
-	const storageAttributes = 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 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 } = configuration;
+	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 } = configuration;
+	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 } = configuration;
+	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 } = configuration;
+	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 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 (configuration.routing.storage === false || options?.isCookieEnabled === false) return;
-	const storageAttributes = getStorageAttributes(configuration.routing.storage);
+	const { routing } = configuration;
+	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 {}
 		}
 	}
@@ -92,39 +223,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),
@@ -132,5 +253,5 @@ const LocaleStorage = (options) => ({
 });
 
 //#endregion
-export { LocaleStorage, getLocaleFromStorage, setLocaleInStorage };
+export { LocaleStorage, LocaleStorageClient, LocaleStorageServer, getLocaleFromStorage, getLocaleFromStorageClient, getLocaleFromStorageServer, setLocaleInStorage, setLocaleInStorageClient, setLocaleInStorageServer };
 //# sourceMappingURL=localeStorage.mjs.map

package/dist/esm/utils/localeStorage.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"localeStorage.mjs","names":[],"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.mjs","names":[],"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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"}