@intlayer/core 7.3.15 → 7.4.0

package/dist/cjs/dist/esm/getStorageAttributes.cjs

@@ -0,0 +1,134 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+let __intlayer_config_client = require("@intlayer/config/client");
+
+//#region dist/esm/getStorageAttributes.mjs
+/**
+* Creates a cookie entry with default values for missing attributes
+*/
+const createCookieEntry = (options) => {
+	const { name, path, expires, domain, secure, sameSite, httpOnly } = options ?? {};
+	return {
+		name: name ?? __intlayer_config_client.DefaultValues.Routing.COOKIE_NAME,
+		attributes: {
+			path,
+			expires,
+			domain,
+			secure,
+			sameSite,
+			httpOnly
+		}
+	};
+};
+/**
+* Creates a web storage entry (localStorage or sessionStorage) with default name
+*/
+const createWebStorageEntry = (options) => {
+	const { name } = options ?? {};
+	return { name: name ?? __intlayer_config_client.DefaultValues.Routing.LOCALE_STORAGE_NAME };
+};
+/**
+* Creates a header entry with default name
+*/
+const createHeaderEntry = (options) => {
+	const { name } = options ?? {};
+	return { name: name ?? __intlayer_config_client.DefaultValues.Routing.HEADER_NAME };
+};
+/**
+* Determines if a storage entry is a cookie based on its properties
+*/
+const isCookieEntry = (entry) => {
+	return entry.type === "cookie" || "sameSite" in entry || "httpOnly" in entry || "secure" in entry;
+};
+/**
+* Determines the storage type from a string literal
+*/
+const isStorageType = (value) => {
+	return value === "cookie" || value === "localStorage" || value === "sessionStorage" || value === "header";
+};
+/**
+* Processes a single storage entry and returns the appropriate storage attributes
+*/
+const processStorageEntry = (entry) => {
+	if (typeof entry === "string") {
+		if (!isStorageType(entry)) return {
+			cookies: [],
+			localStorage: [],
+			sessionStorage: [],
+			headers: []
+		};
+		if (entry === "cookie") return { cookies: [createCookieEntry()] };
+		if (entry === "localStorage") return { localStorage: [createWebStorageEntry()] };
+		if (entry === "sessionStorage") return { sessionStorage: [createWebStorageEntry()] };
+		if (entry === "header") return { headers: [createHeaderEntry()] };
+	}
+	if (typeof entry === "object" && entry !== null) {
+		const typedEntry = entry;
+		if (isCookieEntry(typedEntry)) return { cookies: [createCookieEntry(typedEntry)] };
+		if ("type" in typedEntry && typedEntry.type === "localStorage") {
+			const { name: name$1, ...rest$1 } = typedEntry;
+			return { localStorage: [createWebStorageEntry({
+				name: name$1,
+				...rest$1
+			})] };
+		}
+		if ("type" in typedEntry && typedEntry.type === "sessionStorage") {
+			const { name: name$1, ...rest$1 } = typedEntry;
+			return { sessionStorage: [createWebStorageEntry({
+				name: name$1,
+				...rest$1
+			})] };
+		}
+		if ("type" in typedEntry && typedEntry.type === "header") {
+			const { name: name$1, ...rest$1 } = typedEntry;
+			return { headers: [createHeaderEntry({
+				name: name$1,
+				...rest$1
+			})] };
+		}
+		const { name, ...rest } = typedEntry;
+		return { localStorage: [createWebStorageEntry({
+			name,
+			...rest
+		})] };
+	}
+	return {
+		cookies: [],
+		localStorage: [],
+		sessionStorage: [],
+		headers: []
+	};
+};
+/**
+* Merges multiple partial storage attributes into a single result
+*/
+const mergeStorageAttributes = (accumulated, partial) => {
+	return {
+		cookies: [...accumulated.cookies, ...partial.cookies ?? []],
+		localStorage: [...accumulated.localStorage, ...partial.localStorage ?? []],
+		sessionStorage: [...accumulated.sessionStorage, ...partial.sessionStorage ?? []],
+		headers: [...accumulated.headers, ...partial.headers ?? []]
+	};
+};
+/**
+* Extracts and normalizes storage configuration into separate arrays for each storage type
+*
+* @param options - The storage configuration from IntlayerConfig
+* @returns An object containing arrays for cookies, localStorage, and sessionStorage
+*/
+const getStorageAttributes = (options) => {
+	const emptyResult = {
+		cookies: [],
+		localStorage: [],
+		sessionStorage: [],
+		headers: []
+	};
+	if (options === false || options === void 0) return emptyResult;
+	if (Array.isArray(options)) return options.reduce((acc, entry) => {
+		return mergeStorageAttributes(acc, processStorageEntry(entry));
+	}, emptyResult);
+	return mergeStorageAttributes(emptyResult, processStorageEntry(options));
+};
+
+//#endregion
+exports.getStorageAttributes = getStorageAttributes;
+//# sourceMappingURL=getStorageAttributes.cjs.map

package/dist/cjs/dist/esm/getStorageAttributes.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getStorageAttributes.cjs","names":["DefaultValues"],"sources":["../../../esm/getStorageAttributes.mjs"],"sourcesContent":["import { DefaultValues } from \"@intlayer/config/client\";\n\n//#region src/getStorageAttributes.ts\n/**\n* Creates a cookie entry with default values for missing attributes\n*/\nconst createCookieEntry = (options) => {\n\tconst { name, path, expires, domain, secure, sameSite, httpOnly } = options ?? {};\n\treturn {\n\t\tname: name ?? DefaultValues.Routing.COOKIE_NAME,\n\t\tattributes: {\n\t\t\tpath,\n\t\t\texpires,\n\t\t\tdomain,\n\t\t\tsecure,\n\t\t\tsameSite,\n\t\t\thttpOnly\n\t\t}\n\t};\n};\n/**\n* Creates a web storage entry (localStorage or sessionStorage) with default name\n*/\nconst createWebStorageEntry = (options) => {\n\tconst { name } = options ?? {};\n\treturn { name: name ?? DefaultValues.Routing.LOCALE_STORAGE_NAME };\n};\n/**\n* Creates a header entry with default name\n*/\nconst createHeaderEntry = (options) => {\n\tconst { name } = options ?? {};\n\treturn { name: name ?? DefaultValues.Routing.HEADER_NAME };\n};\n/**\n* Determines if a storage entry is a cookie based on its properties\n*/\nconst isCookieEntry = (entry) => {\n\treturn entry.type === \"cookie\" || \"sameSite\" in entry || \"httpOnly\" in entry || \"secure\" in entry;\n};\n/**\n* Determines the storage type from a string literal\n*/\nconst isStorageType = (value) => {\n\treturn value === \"cookie\" || value === \"localStorage\" || value === \"sessionStorage\" || value === \"header\";\n};\n/**\n* Processes a single storage entry and returns the appropriate storage attributes\n*/\nconst processStorageEntry = (entry) => {\n\tif (typeof entry === \"string\") {\n\t\tif (!isStorageType(entry)) return {\n\t\t\tcookies: [],\n\t\t\tlocalStorage: [],\n\t\t\tsessionStorage: [],\n\t\t\theaders: []\n\t\t};\n\t\tif (entry === \"cookie\") return { cookies: [createCookieEntry()] };\n\t\tif (entry === \"localStorage\") return { localStorage: [createWebStorageEntry()] };\n\t\tif (entry === \"sessionStorage\") return { sessionStorage: [createWebStorageEntry()] };\n\t\tif (entry === \"header\") return { headers: [createHeaderEntry()] };\n\t}\n\tif (typeof entry === \"object\" && entry !== null) {\n\t\tconst typedEntry = entry;\n\t\tif (isCookieEntry(typedEntry)) return { cookies: [createCookieEntry(typedEntry)] };\n\t\tif (\"type\" in typedEntry && typedEntry.type === \"localStorage\") {\n\t\t\tconst { name: name$1, ...rest$1 } = typedEntry;\n\t\t\treturn { localStorage: [createWebStorageEntry({\n\t\t\t\tname: name$1,\n\t\t\t\t...rest$1\n\t\t\t})] };\n\t\t}\n\t\tif (\"type\" in typedEntry && typedEntry.type === \"sessionStorage\") {\n\t\t\tconst { name: name$1, ...rest$1 } = typedEntry;\n\t\t\treturn { sessionStorage: [createWebStorageEntry({\n\t\t\t\tname: name$1,\n\t\t\t\t...rest$1\n\t\t\t})] };\n\t\t}\n\t\tif (\"type\" in typedEntry && typedEntry.type === \"header\") {\n\t\t\tconst { name: name$1, ...rest$1 } = typedEntry;\n\t\t\treturn { headers: [createHeaderEntry({\n\t\t\t\tname: name$1,\n\t\t\t\t...rest$1\n\t\t\t})] };\n\t\t}\n\t\tconst { name, ...rest } = typedEntry;\n\t\treturn { localStorage: [createWebStorageEntry({\n\t\t\tname,\n\t\t\t...rest\n\t\t})] };\n\t}\n\treturn {\n\t\tcookies: [],\n\t\tlocalStorage: [],\n\t\tsessionStorage: [],\n\t\theaders: []\n\t};\n};\n/**\n* Merges multiple partial storage attributes into a single result\n*/\nconst mergeStorageAttributes = (accumulated, partial) => {\n\treturn {\n\t\tcookies: [...accumulated.cookies, ...partial.cookies ?? []],\n\t\tlocalStorage: [...accumulated.localStorage, ...partial.localStorage ?? []],\n\t\tsessionStorage: [...accumulated.sessionStorage, ...partial.sessionStorage ?? []],\n\t\theaders: [...accumulated.headers, ...partial.headers ?? []]\n\t};\n};\n/**\n* Extracts and normalizes storage configuration into separate arrays for each storage type\n*\n* @param options - The storage configuration from IntlayerConfig\n* @returns An object containing arrays for cookies, localStorage, and sessionStorage\n*/\nconst getStorageAttributes = (options) => {\n\tconst emptyResult = {\n\t\tcookies: [],\n\t\tlocalStorage: [],\n\t\tsessionStorage: [],\n\t\theaders: []\n\t};\n\tif (options === false || options === void 0) return emptyResult;\n\tif (Array.isArray(options)) return options.reduce((acc, entry) => {\n\t\treturn mergeStorageAttributes(acc, processStorageEntry(entry));\n\t}, emptyResult);\n\treturn mergeStorageAttributes(emptyResult, processStorageEntry(options));\n};\n\n//#endregion\nexport { getStorageAttributes };\n//# sourceMappingURL=getStorageAttributes.mjs.map"],"mappings":";;;;;;;AAMA,MAAM,qBAAqB,YAAY;CACtC,MAAM,EAAE,MAAM,MAAM,SAAS,QAAQ,QAAQ,UAAU,aAAa,WAAW,EAAE;AACjF,QAAO;EACN,MAAM,QAAQA,uCAAc,QAAQ;EACpC,YAAY;GACX;GACA;GACA;GACA;GACA;GACA;GACA;EACD;;;;;AAKF,MAAM,yBAAyB,YAAY;CAC1C,MAAM,EAAE,SAAS,WAAW,EAAE;AAC9B,QAAO,EAAE,MAAM,QAAQA,uCAAc,QAAQ,qBAAqB;;;;;AAKnE,MAAM,qBAAqB,YAAY;CACtC,MAAM,EAAE,SAAS,WAAW,EAAE;AAC9B,QAAO,EAAE,MAAM,QAAQA,uCAAc,QAAQ,aAAa;;;;;AAK3D,MAAM,iBAAiB,UAAU;AAChC,QAAO,MAAM,SAAS,YAAY,cAAc,SAAS,cAAc,SAAS,YAAY;;;;;AAK7F,MAAM,iBAAiB,UAAU;AAChC,QAAO,UAAU,YAAY,UAAU,kBAAkB,UAAU,oBAAoB,UAAU;;;;;AAKlG,MAAM,uBAAuB,UAAU;AACtC,KAAI,OAAO,UAAU,UAAU;AAC9B,MAAI,CAAC,cAAc,MAAM,CAAE,QAAO;GACjC,SAAS,EAAE;GACX,cAAc,EAAE;GAChB,gBAAgB,EAAE;GAClB,SAAS,EAAE;GACX;AACD,MAAI,UAAU,SAAU,QAAO,EAAE,SAAS,CAAC,mBAAmB,CAAC,EAAE;AACjE,MAAI,UAAU,eAAgB,QAAO,EAAE,cAAc,CAAC,uBAAuB,CAAC,EAAE;AAChF,MAAI,UAAU,iBAAkB,QAAO,EAAE,gBAAgB,CAAC,uBAAuB,CAAC,EAAE;AACpF,MAAI,UAAU,SAAU,QAAO,EAAE,SAAS,CAAC,mBAAmB,CAAC,EAAE;;AAElE,KAAI,OAAO,UAAU,YAAY,UAAU,MAAM;EAChD,MAAM,aAAa;AACnB,MAAI,cAAc,WAAW,CAAE,QAAO,EAAE,SAAS,CAAC,kBAAkB,WAAW,CAAC,EAAE;AAClF,MAAI,UAAU,cAAc,WAAW,SAAS,gBAAgB;GAC/D,MAAM,EAAE,MAAM,QAAQ,GAAG,WAAW;AACpC,UAAO,EAAE,cAAc,CAAC,sBAAsB;IAC7C,MAAM;IACN,GAAG;IACH,CAAC,CAAC,EAAE;;AAEN,MAAI,UAAU,cAAc,WAAW,SAAS,kBAAkB;GACjE,MAAM,EAAE,MAAM,QAAQ,GAAG,WAAW;AACpC,UAAO,EAAE,gBAAgB,CAAC,sBAAsB;IAC/C,MAAM;IACN,GAAG;IACH,CAAC,CAAC,EAAE;;AAEN,MAAI,UAAU,cAAc,WAAW,SAAS,UAAU;GACzD,MAAM,EAAE,MAAM,QAAQ,GAAG,WAAW;AACpC,UAAO,EAAE,SAAS,CAAC,kBAAkB;IACpC,MAAM;IACN,GAAG;IACH,CAAC,CAAC,EAAE;;EAEN,MAAM,EAAE,MAAM,GAAG,SAAS;AAC1B,SAAO,EAAE,cAAc,CAAC,sBAAsB;GAC7C;GACA,GAAG;GACH,CAAC,CAAC,EAAE;;AAEN,QAAO;EACN,SAAS,EAAE;EACX,cAAc,EAAE;EAChB,gBAAgB,EAAE;EAClB,SAAS,EAAE;EACX;;;;;AAKF,MAAM,0BAA0B,aAAa,YAAY;AACxD,QAAO;EACN,SAAS,CAAC,GAAG,YAAY,SAAS,GAAG,QAAQ,WAAW,EAAE,CAAC;EAC3D,cAAc,CAAC,GAAG,YAAY,cAAc,GAAG,QAAQ,gBAAgB,EAAE,CAAC;EAC1E,gBAAgB,CAAC,GAAG,YAAY,gBAAgB,GAAG,QAAQ,kBAAkB,EAAE,CAAC;EAChF,SAAS,CAAC,GAAG,YAAY,SAAS,GAAG,QAAQ,WAAW,EAAE,CAAC;EAC3D;;;;;;;;AAQF,MAAM,wBAAwB,YAAY;CACzC,MAAM,cAAc;EACnB,SAAS,EAAE;EACX,cAAc,EAAE;EAChB,gBAAgB,EAAE;EAClB,SAAS,EAAE;EACX;AACD,KAAI,YAAY,SAAS,YAAY,KAAK,EAAG,QAAO;AACpD,KAAI,MAAM,QAAQ,QAAQ,CAAE,QAAO,QAAQ,QAAQ,KAAK,UAAU;AACjE,SAAO,uBAAuB,KAAK,oBAAoB,MAAM,CAAC;IAC5D,YAAY;AACf,QAAO,uBAAuB,aAAa,oBAAoB,QAAQ,CAAC"}

package/dist/cjs/dist/esm/localization/localeResolver.cjs

@@ -0,0 +1,28 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+let __intlayer_config_built = require("@intlayer/config/built");
+__intlayer_config_built = require_rolldown_runtime.__toESM(__intlayer_config_built);
+
+//#region dist/esm/localization/localeResolver.mjs
+/**
+* Resolves the most specific locale from a user-provided list,
+* or falls back to the default locale if no match is found.
+*/
+const localeResolver = (selectedLocale, locales = __intlayer_config_built.default?.internationalization?.locales, defaultLocale = __intlayer_config_built.default?.internationalization?.defaultLocale) => {
+	const requestedLocales = [selectedLocale].flat();
+	const normalize = (locale) => locale.trim().toLowerCase();
+	try {
+		for (const requested of requestedLocales) {
+			const normalizedRequested = normalize(requested);
+			const exactMatch = locales.find((loc) => normalize(loc) === normalizedRequested);
+			if (exactMatch) return exactMatch;
+			const [requestedLang] = normalizedRequested.split("-");
+			const partialMatch = locales.find((loc) => normalize(loc).split("-")[0] === requestedLang);
+			if (partialMatch) return partialMatch;
+		}
+	} catch (_error) {}
+	return defaultLocale;
+};
+
+//#endregion
+exports.localeResolver = localeResolver;
+//# sourceMappingURL=localeResolver.cjs.map

package/dist/cjs/dist/esm/localization/localeResolver.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"localeResolver.cjs","names":["configuration"],"sources":["../../../../esm/localization/localeResolver.mjs"],"sourcesContent":["import configuration from \"@intlayer/config/built\";\n\n//#region src/localization/localeResolver.ts\n/**\n* Resolves the most specific locale from a user-provided list,\n* or falls back to the default locale if no match is found.\n*/\nconst localeResolver = (selectedLocale, locales = configuration?.internationalization?.locales, defaultLocale = configuration?.internationalization?.defaultLocale) => {\n\tconst requestedLocales = [selectedLocale].flat();\n\tconst normalize = (locale) => locale.trim().toLowerCase();\n\ttry {\n\t\tfor (const requested of requestedLocales) {\n\t\t\tconst normalizedRequested = normalize(requested);\n\t\t\tconst exactMatch = locales.find((loc) => normalize(loc) === normalizedRequested);\n\t\t\tif (exactMatch) return exactMatch;\n\t\t\tconst [requestedLang] = normalizedRequested.split(\"-\");\n\t\t\tconst partialMatch = locales.find((loc) => normalize(loc).split(\"-\")[0] === requestedLang);\n\t\t\tif (partialMatch) return partialMatch;\n\t\t}\n\t} catch (_error) {}\n\treturn defaultLocale;\n};\n\n//#endregion\nexport { localeResolver };\n//# sourceMappingURL=localeResolver.mjs.map"],"mappings":";;;;;;;;;AAOA,MAAM,kBAAkB,gBAAgB,UAAUA,iCAAe,sBAAsB,SAAS,gBAAgBA,iCAAe,sBAAsB,kBAAkB;CACtK,MAAM,mBAAmB,CAAC,eAAe,CAAC,MAAM;CAChD,MAAM,aAAa,WAAW,OAAO,MAAM,CAAC,aAAa;AACzD,KAAI;AACH,OAAK,MAAM,aAAa,kBAAkB;GACzC,MAAM,sBAAsB,UAAU,UAAU;GAChD,MAAM,aAAa,QAAQ,MAAM,QAAQ,UAAU,IAAI,KAAK,oBAAoB;AAChF,OAAI,WAAY,QAAO;GACvB,MAAM,CAAC,iBAAiB,oBAAoB,MAAM,IAAI;GACtD,MAAM,eAAe,QAAQ,MAAM,QAAQ,UAAU,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,cAAc;AAC1F,OAAI,aAAc,QAAO;;UAElB,QAAQ;AACjB,QAAO"}

package/dist/cjs/dist/esm/utils/getCookie.cjs

@@ -0,0 +1,32 @@
+
+//#region dist/esm/utils/getCookie.mjs
+/**
+* Retrieves a cookie by name from a cookie string or document.cookie
+* @param name - The name of the cookie to retrieve
+* @param cookieString - Optional cookie string to parse (defaults to document.cookie in browser)
+* @returns The cookie value or undefined if not found
+*/
+const getCookie = (name, cookieString) => {
+	try {
+		const str = cookieString ?? (typeof document !== "undefined" ? document.cookie : "");
+		if (!str) return void 0;
+		const pairs = str.split(";");
+		for (let i = 0; i < pairs.length; i++) {
+			const part = pairs[i].trim();
+			if (!part) continue;
+			const equalIndex = part.indexOf("=");
+			if ((equalIndex >= 0 ? part.substring(0, equalIndex) : part) === name) {
+				const rawValue = equalIndex >= 0 ? part.substring(equalIndex + 1) : "";
+				try {
+					return decodeURIComponent(rawValue);
+				} catch {
+					return rawValue;
+				}
+			}
+		}
+	} catch {}
+};
+
+//#endregion
+exports.getCookie = getCookie;
+//# sourceMappingURL=getCookie.cjs.map

package/dist/cjs/dist/esm/utils/getCookie.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCookie.cjs","names":[],"sources":["../../../../esm/utils/getCookie.mjs"],"sourcesContent":["//#region src/utils/getCookie.ts\n/**\n* Retrieves a cookie by name from a cookie string or document.cookie\n* @param name - The name of the cookie to retrieve\n* @param cookieString - Optional cookie string to parse (defaults to document.cookie in browser)\n* @returns The cookie value or undefined if not found\n*/\nconst getCookie = (name, cookieString) => {\n\ttry {\n\t\tconst str = cookieString ?? (typeof document !== \"undefined\" ? document.cookie : \"\");\n\t\tif (!str) return void 0;\n\t\tconst pairs = str.split(\";\");\n\t\tfor (let i = 0; i < pairs.length; i++) {\n\t\t\tconst part = pairs[i].trim();\n\t\t\tif (!part) continue;\n\t\t\tconst equalIndex = part.indexOf(\"=\");\n\t\t\tif ((equalIndex >= 0 ? part.substring(0, equalIndex) : part) === name) {\n\t\t\t\tconst rawValue = equalIndex >= 0 ? part.substring(equalIndex + 1) : \"\";\n\t\t\t\ttry {\n\t\t\t\t\treturn decodeURIComponent(rawValue);\n\t\t\t\t} catch {\n\t\t\t\t\treturn rawValue;\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t} catch {}\n};\n\n//#endregion\nexport { getCookie };\n//# sourceMappingURL=getCookie.mjs.map"],"mappings":";;;;;;;;AAOA,MAAM,aAAa,MAAM,iBAAiB;AACzC,KAAI;EACH,MAAM,MAAM,iBAAiB,OAAO,aAAa,cAAc,SAAS,SAAS;AACjF,MAAI,CAAC,IAAK,QAAO,KAAK;EACtB,MAAM,QAAQ,IAAI,MAAM,IAAI;AAC5B,OAAK,IAAI,IAAI,GAAG,IAAI,MAAM,QAAQ,KAAK;GACtC,MAAM,OAAO,MAAM,GAAG,MAAM;AAC5B,OAAI,CAAC,KAAM;GACX,MAAM,aAAa,KAAK,QAAQ,IAAI;AACpC,QAAK,cAAc,IAAI,KAAK,UAAU,GAAG,WAAW,GAAG,UAAU,MAAM;IACtE,MAAM,WAAW,cAAc,IAAI,KAAK,UAAU,aAAa,EAAE,GAAG;AACpE,QAAI;AACH,YAAO,mBAAmB,SAAS;YAC5B;AACP,YAAO;;;;SAIH"}

package/dist/cjs/dist/esm/utils/localeStorage.cjs

@@ -0,0 +1,61 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+const require_getStorageAttributes = require('../getStorageAttributes.cjs');
+const require_getCookie = require('./getCookie.cjs');
+let __intlayer_config_built = require("@intlayer/config/built");
+__intlayer_config_built = require_rolldown_runtime.__toESM(__intlayer_config_built);
+
+//#region dist/esm/utils/localeStorage.mjs
+/**
+* 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
+*/
+const getLocaleFromStorage = (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_getCookie.getCookie(name);
+	};
+	for (let i = 0; i < storageAttributes.cookies.length; i++) {
+		const { name } = storageAttributes.cookies[i];
+		const value = readCookie(name);
+		if (isValidLocale(value)) return value;
+	}
+	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;
+		} catch {}
+	}
+	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;
+		} catch {}
+	}
+	for (let i = 0; i < storageAttributes.headers.length; i++) {
+		const { name } = storageAttributes.headers[i];
+		try {
+			const value = options?.getHeader?.(name);
+			if (isValidLocale(value)) return value;
+		} catch {}
+	}
+};
+
+//#endregion
+exports.getLocaleFromStorage = getLocaleFromStorage;
+//# sourceMappingURL=localeStorage.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"localeStorage.cjs","names":["configuration","getStorageAttributes","getCookie"],"sources":["../../../../esm/utils/localeStorage.mjs"],"sourcesContent":["import { getStorageAttributes } from \"../getStorageAttributes.mjs\";\nimport { getCookie } from \"./getCookie.mjs\";\nimport configuration from \"@intlayer/config/built\";\n\n//#region src/utils/localeStorage.ts\nconst buildCookieString = (name, value, attributes) => {\n\tconst parts = [`${name}=${encodeURIComponent(value)}`];\n\tif (attributes.path) parts.push(`Path=${attributes.path}`);\n\tif (attributes.domain) parts.push(`Domain=${attributes.domain}`);\n\tif (attributes.expires instanceof Date) parts.push(`Expires=${attributes.expires.toUTCString()}`);\n\tif (attributes.secure) parts.push(\"Secure\");\n\tif (attributes.sameSite) parts.push(`SameSite=${attributes.sameSite}`);\n\treturn parts.join(\"; \");\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*/\nconst getLocaleFromStorage = (options) => {\n\tconst { routing, internationalization } = configuration;\n\tconst { locales } = internationalization;\n\tconst { storage } = routing;\n\tif (storage === false || options?.isCookieEnabled === false) return void 0;\n\tconst storageAttributes = getStorageAttributes(storage);\n\tconst isValidLocale = (value) => {\n\t\tif (!value) return false;\n\t\treturn locales.includes(value);\n\t};\n\tconst readCookie = (name) => {\n\t\ttry {\n\t\t\tconst fromOption = options?.getCookie?.(name);\n\t\t\tif (fromOption !== null && fromOption !== void 0) return fromOption;\n\t\t} catch {}\n\t\treturn getCookie(name);\n\t};\n\tfor (let i = 0; i < storageAttributes.cookies.length; i++) {\n\t\tconst { name } = storageAttributes.cookies[i];\n\t\tconst value = readCookie(name);\n\t\tif (isValidLocale(value)) return value;\n\t}\n\tfor (let i = 0; i < storageAttributes.localStorage.length; i++) {\n\t\tconst { name } = storageAttributes.localStorage[i];\n\t\ttry {\n\t\t\tconst value = options?.getLocaleStorage?.(name);\n\t\t\tif (isValidLocale(value)) return value;\n\t\t} catch {}\n\t}\n\tfor (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n\t\tconst { name } = storageAttributes.sessionStorage[i];\n\t\ttry {\n\t\t\tconst value = options?.getSessionStorage?.(name);\n\t\t\tif (isValidLocale(value)) return value;\n\t\t} catch {}\n\t}\n\tfor (let i = 0; i < storageAttributes.headers.length; i++) {\n\t\tconst { name } = storageAttributes.headers[i];\n\t\ttry {\n\t\t\tconst value = options?.getHeader?.(name);\n\t\t\tif (isValidLocale(value)) return value;\n\t\t} catch {}\n\t}\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*/\nconst setLocaleInStorage = (locale, options) => {\n\tif (configuration.routing.storage === false || options?.isCookieEnabled === false) return;\n\tconst storageAttributes = getStorageAttributes(configuration.routing.storage);\n\tfor (let i = 0; i < storageAttributes.cookies.length; i++) {\n\t\tconst { name, attributes } = storageAttributes.cookies[i];\n\t\ttry {\n\t\t\tif (options?.setCookieStore) options?.setCookieStore?.(name, locale, {\n\t\t\t\t...attributes,\n\t\t\t\texpires: attributes.expires instanceof Date ? attributes.expires.getTime() : attributes.expires\n\t\t\t});\n\t\t} catch {\n\t\t\ttry {\n\t\t\t\tif (options?.setCookieString) {\n\t\t\t\t\tconst cookieString = buildCookieString(name, locale, attributes);\n\t\t\t\t\toptions?.setCookieString?.(name, cookieString);\n\t\t\t\t}\n\t\t\t} catch {}\n\t\t}\n\t}\n\tif (options?.setLocaleStorage) for (let i = 0; i < storageAttributes.localStorage.length; i++) {\n\t\tconst { name } = storageAttributes.localStorage[i];\n\t\ttry {\n\t\t\tif (!(options?.overwrite ?? true) && options?.getLocaleStorage) {\n\t\t\t\tif (options?.getLocaleStorage?.(name)) continue;\n\t\t\t}\n\t\t\toptions?.setLocaleStorage?.(name, locale);\n\t\t} catch {}\n\t}\n\tif (options?.setSessionStorage) for (let i = 0; i < storageAttributes.sessionStorage.length; i++) {\n\t\tconst { name } = storageAttributes.sessionStorage[i];\n\t\ttry {\n\t\t\tif (!(options?.overwrite ?? true) && options?.getSessionStorage) {\n\t\t\t\tif (options?.getSessionStorage?.(name)) continue;\n\t\t\t}\n\t\t\toptions?.setSessionStorage?.(name, locale);\n\t\t} catch {}\n\t}\n\tif (options?.setHeader) for (let i = 0; i < storageAttributes.headers.length; i++) {\n\t\tconst { name } = storageAttributes.headers[i];\n\t\ttry {\n\t\t\toptions?.setHeader?.(name, locale);\n\t\t} catch {}\n\t}\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*/\nconst LocaleStorage = (options) => ({\n\tgetLocale: () => getLocaleFromStorage(options),\n\tsetLocale: (locale) => setLocaleInStorage(locale, options)\n});\n\n//#endregion\nexport { LocaleStorage, getLocaleFromStorage, setLocaleInStorage };\n//# sourceMappingURL=localeStorage.mjs.map"],"mappings":";;;;;;;;;;;;;AAoBA,MAAM,wBAAwB,YAAY;CACzC,MAAM,EAAE,SAAS,yBAAyBA;CAC1C,MAAM,EAAE,YAAY;CACpB,MAAM,EAAE,YAAY;AACpB,KAAI,YAAY,SAAS,SAAS,oBAAoB,MAAO,QAAO,KAAK;CACzE,MAAM,oBAAoBC,kDAAqB,QAAQ;CACvD,MAAM,iBAAiB,UAAU;AAChC,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,QAAQ,SAAS,MAAM;;CAE/B,MAAM,cAAc,SAAS;AAC5B,MAAI;GACH,MAAM,aAAa,SAAS,YAAY,KAAK;AAC7C,OAAI,eAAe,QAAQ,eAAe,KAAK,EAAG,QAAO;UAClD;AACR,SAAOC,4BAAU,KAAK;;AAEvB,MAAK,IAAI,IAAI,GAAG,IAAI,kBAAkB,QAAQ,QAAQ,KAAK;EAC1D,MAAM,EAAE,SAAS,kBAAkB,QAAQ;EAC3C,MAAM,QAAQ,WAAW,KAAK;AAC9B,MAAI,cAAc,MAAM,CAAE,QAAO;;AAElC,MAAK,IAAI,IAAI,GAAG,IAAI,kBAAkB,aAAa,QAAQ,KAAK;EAC/D,MAAM,EAAE,SAAS,kBAAkB,aAAa;AAChD,MAAI;GACH,MAAM,QAAQ,SAAS,mBAAmB,KAAK;AAC/C,OAAI,cAAc,MAAM,CAAE,QAAO;UAC1B;;AAET,MAAK,IAAI,IAAI,GAAG,IAAI,kBAAkB,eAAe,QAAQ,KAAK;EACjE,MAAM,EAAE,SAAS,kBAAkB,eAAe;AAClD,MAAI;GACH,MAAM,QAAQ,SAAS,oBAAoB,KAAK;AAChD,OAAI,cAAc,MAAM,CAAE,QAAO;UAC1B;;AAET,MAAK,IAAI,IAAI,GAAG,IAAI,kBAAkB,QAAQ,QAAQ,KAAK;EAC1D,MAAM,EAAE,SAAS,kBAAkB,QAAQ;AAC3C,MAAI;GACH,MAAM,QAAQ,SAAS,YAAY,KAAK;AACxC,OAAI,cAAc,MAAM,CAAE,QAAO;UAC1B"}

package/dist/cjs/index.cjs

@@ -66,6 +66,7 @@ const require_localization_getPrefix = require('./localization/getPrefix.cjs');
 const require_localization_getLocalizedUrl = require('./localization/getLocalizedUrl.cjs');
 const require_localization_getMultilingualUrls = require('./localization/getMultilingualUrls.cjs');
 const require_localization_localeMapper = require('./localization/localeMapper.cjs');
+const require_localization_validatePrefix = require('./localization/validatePrefix.cjs');
 const require_utils_isSameKeyPath = require('./utils/isSameKeyPath.cjs');
 
 exports.CachedIntl = require_utils_intl.CachedIntl;
@@ -161,4 +162,5 @@ exports.setLocaleInStorage = require_utils_localeStorage.setLocaleInStorage;
 exports.t = require_transpiler_translation_translation.t;
 exports.translationPlugin = require_interpreter_getContent_plugins.translationPlugin;
 exports.units = require_formatters_units.units;
-exports.updateNodeChildren = require_dictionaryManipulator_updateNodeChildren.updateNodeChildren;
+exports.updateNodeChildren = require_dictionaryManipulator_updateNodeChildren.updateNodeChildren;
+exports.validatePrefix = require_localization_validatePrefix.validatePrefix;

package/dist/cjs/localization/getLocale.cjs

@@ -1,22 +1,23 @@
 const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_localeResolver = require('../dist/esm/localization/localeResolver.cjs');
+const require_localeStorage = require('../dist/esm/utils/localeStorage.cjs');
 const require_localization_localeDetector = require('./localeDetector.cjs');
 let __intlayer_config_client = require("@intlayer/config/client");
 let __intlayer_config_built = require("@intlayer/config/built");
 __intlayer_config_built = require_rolldown_runtime.__toESM(__intlayer_config_built);
-let __intlayer_core = require("@intlayer/core");
 
 //#region src/localization/getLocale.ts
 const getLocale = async (ctx = {}) => {
 	const defaultLocale = __intlayer_config_built.default?.internationalization?.defaultLocale ?? __intlayer_config_client.DefaultValues.Internationalization.DEFAULT_LOCALE;
 	const availableLocales = __intlayer_config_built.default?.internationalization?.locales ?? __intlayer_config_client.DefaultValues.Internationalization.LOCALES;
-	const storedLocale = (0, __intlayer_core.getLocaleFromStorage)({
+	const storedLocale = require_localeStorage.getLocaleFromStorage({
 		getCookie: ctx.getCookie,
 		getHeader: ctx.getHeader
 	});
 	if (storedLocale) return storedLocale;
 	const acceptLanguageHeader = ctx.getHeader?.("accept-language");
 	if (!acceptLanguageHeader) return defaultLocale;
-	const userFallbackLocale = (0, __intlayer_core.localeResolver)(require_localization_localeDetector.getPreferredLanguages(acceptLanguageHeader, availableLocales), availableLocales, defaultLocale);
+	const userFallbackLocale = require_localeResolver.localeResolver(require_localization_localeDetector.getPreferredLanguages(acceptLanguageHeader, availableLocales), availableLocales, defaultLocale);
 	if (userFallbackLocale) return userFallbackLocale;
 	return defaultLocale;
 };

package/dist/cjs/localization/getLocale.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"getLocale.cjs","names":["configuration","DefaultValues","getPreferredLanguages"],"sources":["../../../src/localization/getLocale.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport { DefaultValues } from '@intlayer/config/client';\nimport { getLocaleFromStorage, localeResolver } from '@intlayer/core';\nimport type { Locale } from '@intlayer/types';\nimport { getPreferredLanguages } from './localeDetector';\n\nexport type RequestContext = {\n  getHeader?: (name: string) => string | null | undefined;\n  getCookie?: (name: string) => string | null | undefined;\n};\n\nexport const getLocale = async (ctx: RequestContext = {}): Promise<Locale> => {\n  const defaultLocale =\n    configuration?.internationalization?.defaultLocale ??\n    DefaultValues.Internationalization.DEFAULT_LOCALE;\n  const availableLocales =\n    configuration?.internationalization?.locales ??\n    DefaultValues.Internationalization.LOCALES;\n\n  // Try locale from storage (cookie or header)\n  const storedLocale = getLocaleFromStorage({\n    getCookie: ctx.getCookie,\n    getHeader: ctx.getHeader,\n  });\n\n  if (storedLocale) {\n    return storedLocale;\n  }\n\n  // Fallback to Accept-Language negotiation\n  const acceptLanguageHeader = ctx.getHeader?.('accept-language');\n\n  if (!acceptLanguageHeader) {\n    return defaultLocale;\n  }\n\n  const preferredLocaleStrings = getPreferredLanguages(\n    acceptLanguageHeader,\n    availableLocales\n  );\n\n  const userFallbackLocale = localeResolver(\n    preferredLocaleStrings,\n    availableLocales,\n    defaultLocale\n  );\n\n  if (userFallbackLocale) {\n    return userFallbackLocale;\n  }\n\n  // Default locale\n  return defaultLocale;\n};\n"],"mappings":";;;;;;;;AAWA,MAAa,YAAY,OAAO,MAAsB,EAAE,KAAsB;CAC5E,MAAM,gBACJA,iCAAe,sBAAsB,iBACrCC,uCAAc,qBAAqB;CACrC,MAAM,mBACJD,iCAAe,sBAAsB,WACrCC,uCAAc,qBAAqB;CAGrC,MAAM,yDAAoC;EACxC,WAAW,IAAI;EACf,WAAW,IAAI;EAChB,CAAC;AAEF,KAAI,aACF,QAAO;CAIT,MAAM,uBAAuB,IAAI,YAAY,kBAAkB;AAE/D,KAAI,CAAC,qBACH,QAAO;CAQT,MAAM,yDALyBC,0DAC7B,sBACA,iBACD,EAIC,kBACA,cACD;AAED,KAAI,mBACF,QAAO;AAIT,QAAO"}
+{"version":3,"file":"getLocale.cjs","names":["configuration","DefaultValues","getLocaleFromStorage","localeResolver","getPreferredLanguages"],"sources":["../../../src/localization/getLocale.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport { DefaultValues } from '@intlayer/config/client';\nimport { getLocaleFromStorage, localeResolver } from '@intlayer/core';\nimport type { Locale } from '@intlayer/types';\nimport { getPreferredLanguages } from './localeDetector';\n\nexport type RequestContext = {\n  getHeader?: (name: string) => string | null | undefined;\n  getCookie?: (name: string) => string | null | undefined;\n};\n\nexport const getLocale = async (ctx: RequestContext = {}): Promise<Locale> => {\n  const defaultLocale =\n    configuration?.internationalization?.defaultLocale ??\n    DefaultValues.Internationalization.DEFAULT_LOCALE;\n  const availableLocales =\n    configuration?.internationalization?.locales ??\n    DefaultValues.Internationalization.LOCALES;\n\n  // Try locale from storage (cookie or header)\n  const storedLocale = getLocaleFromStorage({\n    getCookie: ctx.getCookie,\n    getHeader: ctx.getHeader,\n  });\n\n  if (storedLocale) {\n    return storedLocale;\n  }\n\n  // Fallback to Accept-Language negotiation\n  const acceptLanguageHeader = ctx.getHeader?.('accept-language');\n\n  if (!acceptLanguageHeader) {\n    return defaultLocale;\n  }\n\n  const preferredLocaleStrings = getPreferredLanguages(\n    acceptLanguageHeader,\n    availableLocales\n  );\n\n  const userFallbackLocale = localeResolver(\n    preferredLocaleStrings,\n    availableLocales,\n    defaultLocale\n  );\n\n  if (userFallbackLocale) {\n    return userFallbackLocale;\n  }\n\n  // Default locale\n  return defaultLocale;\n};\n"],"mappings":";;;;;;;;;AAWA,MAAa,YAAY,OAAO,MAAsB,EAAE,KAAsB;CAC5E,MAAM,gBACJA,iCAAe,sBAAsB,iBACrCC,uCAAc,qBAAqB;CACrC,MAAM,mBACJD,iCAAe,sBAAsB,WACrCC,uCAAc,qBAAqB;CAGrC,MAAM,eAAeC,2CAAqB;EACxC,WAAW,IAAI;EACf,WAAW,IAAI;EAChB,CAAC;AAEF,KAAI,aACF,QAAO;CAIT,MAAM,uBAAuB,IAAI,YAAY,kBAAkB;AAE/D,KAAI,CAAC,qBACH,QAAO;CAQT,MAAM,qBAAqBC,sCALIC,0DAC7B,sBACA,iBACD,EAIC,kBACA,cACD;AAED,KAAI,mBACF,QAAO;AAIT,QAAO"}

package/dist/cjs/localization/getLocalizedUrl.cjs

@@ -44,7 +44,12 @@ __intlayer_config_built = require_rolldown_runtime.__toESM(__intlayer_config_bui
 * @returns The localized URL for the current locale.
 */
 const getLocalizedUrl = (url, currentLocale, options = {}) => {
-	const { locales = __intlayer_config_built.default?.internationalization?.locales ?? __intlayer_config_client.DefaultValues.Internationalization.LOCALES, defaultLocale = __intlayer_config_built.default?.internationalization?.defaultLocale ?? __intlayer_config_client.DefaultValues.Internationalization.DEFAULT_LOCALE, mode = __intlayer_config_built.default?.routing?.mode ?? __intlayer_config_client.DefaultValues.Routing.ROUTING_MODE } = options;
+	const { defaultLocale, mode, locales } = {
+		defaultLocale: __intlayer_config_built.default?.internationalization?.defaultLocale ?? __intlayer_config_client.DefaultValues.Internationalization.DEFAULT_LOCALE,
+		mode: __intlayer_config_built.default?.routing?.mode ?? __intlayer_config_client.DefaultValues.Routing.ROUTING_MODE,
+		locales: __intlayer_config_built.default?.internationalization?.locales ?? __intlayer_config_client.DefaultValues.Internationalization.LOCALES,
+		...options
+	};
 	const urlWithoutLocale = require_localization_getPathWithoutLocale.getPathWithoutLocale(url, locales);
 	if (mode === "no-prefix") return urlWithoutLocale;
 	const isAbsoluteUrl = require_utils_checkIsURLAbsolute.checkIsURLAbsolute(urlWithoutLocale);

package/dist/cjs/localization/getLocalizedUrl.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"getLocalizedUrl.cjs","names":["configuration","DefaultValues","getPathWithoutLocale","checkIsURLAbsolute","getPrefix"],"sources":["../../../src/localization/getLocalizedUrl.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport { DefaultValues } from '@intlayer/config/client';\nimport type { LocalesValues } from '@intlayer/types';\nimport { checkIsURLAbsolute } from '../utils/checkIsURLAbsolute';\nimport { getPathWithoutLocale } from './getPathWithoutLocale';\nimport { getPrefix } from './getPrefix';\n\n/**\n * Generate URL by prefixing the given URL with the referenced locale or adding search parameters\n * based on the routing mode. Handles both absolute and relative URLs appropriately.\n *\n * This function gets the locales, default locale, and routing mode from the configuration if not provided.\n *\n * Example:\n *\n * ```ts\n *  // prefix-no-default mode\n *  getLocalizedUrl('/about', 'fr', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'prefix-no-default' });\n *  // Returns '/fr/about' for the French locale\n *  // Returns '/about' for the English locale (default)\n *\n *  // prefix-all mode\n *  getLocalizedUrl('/about', 'en', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'prefix-all' });\n *  // Returns '/en/about' for the English locale\n *  // Returns '/fr/about' for the French locale\n *\n *  // search-params mode\n *  getLocalizedUrl('/about', 'fr', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'search-params' });\n *  // Returns '/about?locale=fr' for the French locale\n *\n *  // no-prefix mode\n *  getLocalizedUrl('/about', 'fr', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'no-prefix' });\n *  // Returns '/about' for any locale\n * ```\n *\n * @param url - The original URL string to be processed.\n * @param currentLocale - The current locale.\n * @param options - Configuration options\n * @param options.locales - Optional array of supported locales. Defaults to configured locales.\n * @param options.defaultLocale - The default locale. Defaults to configured default locale.\n * @param options.mode - URL routing mode for locale handling. Defaults to configured mode.\n * @returns The localized URL for the current locale.\n */\nexport const getLocalizedUrl = (\n  url: string,\n  currentLocale: LocalesValues,\n  options: {\n    locales?: LocalesValues[];\n    defaultLocale?: LocalesValues;\n    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';\n  } = {}\n): string => {\n  const {\n    locales = configuration?.internationalization?.locales ??\n      DefaultValues.Internationalization.LOCALES,\n    defaultLocale = configuration?.internationalization?.defaultLocale ??\n      DefaultValues.Internationalization.DEFAULT_LOCALE,\n    mode = configuration?.routing?.mode ?? DefaultValues.Routing.ROUTING_MODE,\n  } = options;\n  // Remove any existing locale segment from the URL\n  const urlWithoutLocale = getPathWithoutLocale(url, locales);\n\n  if (mode === 'no-prefix') {\n    // No locale prefixing\n    return urlWithoutLocale;\n  }\n\n  // Determine if the original URL is absolute (includes protocol)\n  const isAbsoluteUrl = checkIsURLAbsolute(urlWithoutLocale);\n\n  // Initialize a URL object if the URL is absolute\n  // For relative URLs, use a dummy base to leverage the URL API\n  const parsedUrl = isAbsoluteUrl\n    ? new URL(urlWithoutLocale)\n    : new URL(urlWithoutLocale, 'http://example.com');\n\n  // Prepare the base URL (protocol + host) if it's absolute\n  const baseUrl = isAbsoluteUrl\n    ? `${parsedUrl.protocol}//${parsedUrl.host}`\n    : '';\n\n  if (mode === 'search-params') {\n    // Use search parameters for locale handling\n    const searchParams = new URLSearchParams(parsedUrl.search);\n    searchParams.set('locale', currentLocale.toString());\n\n    const queryString = searchParams.toString();\n    const pathWithQuery = queryString\n      ? `${parsedUrl.pathname}?${queryString}`\n      : parsedUrl.pathname;\n\n    if (isAbsoluteUrl) {\n      return `${baseUrl}${pathWithQuery}${parsedUrl.hash}`;\n    }\n\n    return `${pathWithQuery}${parsedUrl.hash}`;\n  }\n\n  const { prefix } = getPrefix(currentLocale, {\n    defaultLocale,\n    mode,\n  });\n\n  // Construct the new pathname with or without the locale prefix\n  let localizedPath = `/${prefix}${parsedUrl.pathname}`;\n\n  // Remove double slashes\n  localizedPath = localizedPath.replaceAll(/\\/+/g, '/');\n\n  // Remove trailing slash for non-root paths\n  if (localizedPath.length > 1 && localizedPath.endsWith('/')) {\n    localizedPath = localizedPath.slice(0, -1);\n  }\n\n  // Combine with the base URL if the original URL was absolute\n  if (isAbsoluteUrl) {\n    return `${baseUrl}${localizedPath}${parsedUrl.search}${parsedUrl.hash}`;\n  }\n\n  return `${localizedPath}${parsedUrl.search}${parsedUrl.hash}`;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CA,MAAa,mBACX,KACA,eACA,UAII,EAAE,KACK;CACX,MAAM,EACJ,UAAUA,iCAAe,sBAAsB,WAC7CC,uCAAc,qBAAqB,SACrC,gBAAgBD,iCAAe,sBAAsB,iBACnDC,uCAAc,qBAAqB,gBACrC,OAAOD,iCAAe,SAAS,QAAQC,uCAAc,QAAQ,iBAC3D;CAEJ,MAAM,mBAAmBC,+DAAqB,KAAK,QAAQ;AAE3D,KAAI,SAAS,YAEX,QAAO;CAIT,MAAM,gBAAgBC,oDAAmB,iBAAiB;CAI1D,MAAM,YAAY,gBACd,IAAI,IAAI,iBAAiB,GACzB,IAAI,IAAI,kBAAkB,qBAAqB;CAGnD,MAAM,UAAU,gBACZ,GAAG,UAAU,SAAS,IAAI,UAAU,SACpC;AAEJ,KAAI,SAAS,iBAAiB;EAE5B,MAAM,eAAe,IAAI,gBAAgB,UAAU,OAAO;AAC1D,eAAa,IAAI,UAAU,cAAc,UAAU,CAAC;EAEpD,MAAM,cAAc,aAAa,UAAU;EAC3C,MAAM,gBAAgB,cAClB,GAAG,UAAU,SAAS,GAAG,gBACzB,UAAU;AAEd,MAAI,cACF,QAAO,GAAG,UAAU,gBAAgB,UAAU;AAGhD,SAAO,GAAG,gBAAgB,UAAU;;CAGtC,MAAM,EAAE,WAAWC,yCAAU,eAAe;EAC1C;EACA;EACD,CAAC;CAGF,IAAI,gBAAgB,IAAI,SAAS,UAAU;AAG3C,iBAAgB,cAAc,WAAW,QAAQ,IAAI;AAGrD,KAAI,cAAc,SAAS,KAAK,cAAc,SAAS,IAAI,CACzD,iBAAgB,cAAc,MAAM,GAAG,GAAG;AAI5C,KAAI,cACF,QAAO,GAAG,UAAU,gBAAgB,UAAU,SAAS,UAAU;AAGnE,QAAO,GAAG,gBAAgB,UAAU,SAAS,UAAU"}
+{"version":3,"file":"getLocalizedUrl.cjs","names":["configuration","DefaultValues","getPathWithoutLocale","checkIsURLAbsolute","getPrefix"],"sources":["../../../src/localization/getLocalizedUrl.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport { DefaultValues } from '@intlayer/config/client';\nimport type { LocalesValues } from '@intlayer/types';\nimport { checkIsURLAbsolute } from '../utils/checkIsURLAbsolute';\nimport { getPathWithoutLocale } from './getPathWithoutLocale';\nimport { getPrefix } from './getPrefix';\n\n/**\n * Generate URL by prefixing the given URL with the referenced locale or adding search parameters\n * based on the routing mode. Handles both absolute and relative URLs appropriately.\n *\n * This function gets the locales, default locale, and routing mode from the configuration if not provided.\n *\n * Example:\n *\n * ```ts\n *  // prefix-no-default mode\n *  getLocalizedUrl('/about', 'fr', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'prefix-no-default' });\n *  // Returns '/fr/about' for the French locale\n *  // Returns '/about' for the English locale (default)\n *\n *  // prefix-all mode\n *  getLocalizedUrl('/about', 'en', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'prefix-all' });\n *  // Returns '/en/about' for the English locale\n *  // Returns '/fr/about' for the French locale\n *\n *  // search-params mode\n *  getLocalizedUrl('/about', 'fr', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'search-params' });\n *  // Returns '/about?locale=fr' for the French locale\n *\n *  // no-prefix mode\n *  getLocalizedUrl('/about', 'fr', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'no-prefix' });\n *  // Returns '/about' for any locale\n * ```\n *\n * @param url - The original URL string to be processed.\n * @param currentLocale - The current locale.\n * @param options - Configuration options\n * @param options.locales - Optional array of supported locales. Defaults to configured locales.\n * @param options.defaultLocale - The default locale. Defaults to configured default locale.\n * @param options.mode - URL routing mode for locale handling. Defaults to configured mode.\n * @returns The localized URL for the current locale.\n */\nexport const getLocalizedUrl = (\n  url: string,\n  currentLocale: LocalesValues,\n  options: {\n    locales?: LocalesValues[];\n    defaultLocale?: LocalesValues;\n    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';\n  } = {}\n): string => {\n  const { defaultLocale, mode, locales } = {\n    defaultLocale:\n      configuration?.internationalization?.defaultLocale ??\n      DefaultValues.Internationalization.DEFAULT_LOCALE,\n    mode: configuration?.routing?.mode ?? DefaultValues.Routing.ROUTING_MODE,\n    locales:\n      configuration?.internationalization?.locales ??\n      DefaultValues.Internationalization.LOCALES,\n    ...options,\n  };\n\n  // Remove any existing locale segment from the URL\n  const urlWithoutLocale = getPathWithoutLocale(url, locales);\n\n  if (mode === 'no-prefix') {\n    // No locale prefixing\n    return urlWithoutLocale;\n  }\n\n  // Determine if the original URL is absolute (includes protocol)\n  const isAbsoluteUrl = checkIsURLAbsolute(urlWithoutLocale);\n\n  // Initialize a URL object if the URL is absolute\n  // For relative URLs, use a dummy base to leverage the URL API\n  const parsedUrl = isAbsoluteUrl\n    ? new URL(urlWithoutLocale)\n    : new URL(urlWithoutLocale, 'http://example.com');\n\n  // Prepare the base URL (protocol + host) if it's absolute\n  const baseUrl = isAbsoluteUrl\n    ? `${parsedUrl.protocol}//${parsedUrl.host}`\n    : '';\n\n  if (mode === 'search-params') {\n    // Use search parameters for locale handling\n    const searchParams = new URLSearchParams(parsedUrl.search);\n    searchParams.set('locale', currentLocale.toString());\n\n    const queryString = searchParams.toString();\n    const pathWithQuery = queryString\n      ? `${parsedUrl.pathname}?${queryString}`\n      : parsedUrl.pathname;\n\n    if (isAbsoluteUrl) {\n      return `${baseUrl}${pathWithQuery}${parsedUrl.hash}`;\n    }\n\n    return `${pathWithQuery}${parsedUrl.hash}`;\n  }\n\n  const { prefix } = getPrefix(currentLocale, {\n    defaultLocale,\n    mode,\n  });\n\n  // Construct the new pathname with or without the locale prefix\n  let localizedPath = `/${prefix}${parsedUrl.pathname}`;\n\n  // Remove double slashes\n  localizedPath = localizedPath.replaceAll(/\\/+/g, '/');\n\n  // Remove trailing slash for non-root paths\n  if (localizedPath.length > 1 && localizedPath.endsWith('/')) {\n    localizedPath = localizedPath.slice(0, -1);\n  }\n\n  // Combine with the base URL if the original URL was absolute\n  if (isAbsoluteUrl) {\n    return `${baseUrl}${localizedPath}${parsedUrl.search}${parsedUrl.hash}`;\n  }\n\n  return `${localizedPath}${parsedUrl.search}${parsedUrl.hash}`;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CA,MAAa,mBACX,KACA,eACA,UAII,EAAE,KACK;CACX,MAAM,EAAE,eAAe,MAAM,YAAY;EACvC,eACEA,iCAAe,sBAAsB,iBACrCC,uCAAc,qBAAqB;EACrC,MAAMD,iCAAe,SAAS,QAAQC,uCAAc,QAAQ;EAC5D,SACED,iCAAe,sBAAsB,WACrCC,uCAAc,qBAAqB;EACrC,GAAG;EACJ;CAGD,MAAM,mBAAmBC,+DAAqB,KAAK,QAAQ;AAE3D,KAAI,SAAS,YAEX,QAAO;CAIT,MAAM,gBAAgBC,oDAAmB,iBAAiB;CAI1D,MAAM,YAAY,gBACd,IAAI,IAAI,iBAAiB,GACzB,IAAI,IAAI,kBAAkB,qBAAqB;CAGnD,MAAM,UAAU,gBACZ,GAAG,UAAU,SAAS,IAAI,UAAU,SACpC;AAEJ,KAAI,SAAS,iBAAiB;EAE5B,MAAM,eAAe,IAAI,gBAAgB,UAAU,OAAO;AAC1D,eAAa,IAAI,UAAU,cAAc,UAAU,CAAC;EAEpD,MAAM,cAAc,aAAa,UAAU;EAC3C,MAAM,gBAAgB,cAClB,GAAG,UAAU,SAAS,GAAG,gBACzB,UAAU;AAEd,MAAI,cACF,QAAO,GAAG,UAAU,gBAAgB,UAAU;AAGhD,SAAO,GAAG,gBAAgB,UAAU;;CAGtC,MAAM,EAAE,WAAWC,yCAAU,eAAe;EAC1C;EACA;EACD,CAAC;CAGF,IAAI,gBAAgB,IAAI,SAAS,UAAU;AAG3C,iBAAgB,cAAc,WAAW,QAAQ,IAAI;AAGrD,KAAI,cAAc,SAAS,KAAK,cAAc,SAAS,IAAI,CACzD,iBAAgB,cAAc,MAAM,GAAG,GAAG;AAI5C,KAAI,cACF,QAAO,GAAG,UAAU,gBAAgB,UAAU,SAAS,UAAU;AAGnE,QAAO,GAAG,gBAAgB,UAAU,SAAS,UAAU"}

package/dist/cjs/localization/getMultilingualUrls.cjs

@@ -1,5 +1,6 @@
 const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
 const require_localization_getLocalizedUrl = require('./getLocalizedUrl.cjs');
+let __intlayer_config_client = require("@intlayer/config/client");
 let __intlayer_config_built = require("@intlayer/config/built");
 __intlayer_config_built = require_rolldown_runtime.__toESM(__intlayer_config_built);
 
@@ -39,7 +40,12 @@ __intlayer_config_built = require_rolldown_runtime.__toESM(__intlayer_config_bui
 * @returns An object mapping each locale to its corresponding multilingual URL.
 */
 const getMultilingualUrls = (url, options = {}) => {
-	const { locales = __intlayer_config_built.default?.internationalization?.locales, defaultLocale = __intlayer_config_built.default?.internationalization?.defaultLocale, mode = __intlayer_config_built.default?.routing?.mode } = options;
+	const { defaultLocale, mode, locales } = {
+		defaultLocale: __intlayer_config_built.default?.internationalization?.defaultLocale ?? __intlayer_config_client.DefaultValues.Internationalization.DEFAULT_LOCALE,
+		mode: __intlayer_config_built.default?.routing?.mode ?? __intlayer_config_client.DefaultValues.Routing.ROUTING_MODE,
+		locales: __intlayer_config_built.default?.internationalization?.locales ?? __intlayer_config_client.DefaultValues.Internationalization.LOCALES,
+		...options
+	};
 	return (locales ?? []).reduce((acc, locale) => {
 		acc[locale] = require_localization_getLocalizedUrl.getLocalizedUrl(url, locale, {
 			locales,

package/dist/cjs/localization/getMultilingualUrls.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"getMultilingualUrls.cjs","names":["configuration","getLocalizedUrl"],"sources":["../../../src/localization/getMultilingualUrls.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { LocalesValues, StrictModeLocaleMap } from '@intlayer/types';\nimport { getLocalizedUrl } from './getLocalizedUrl';\n\n/**\n * Generates multilingual URLs by prefixing the given URL with each supported locale\n * or adding search parameters based on the routing mode.\n * Handles both absolute and relative URLs appropriately.\n *\n * This function gets the locales, default locale, and routing mode from the configuration if not provided.\n *\n * Example:\n *\n * ```ts\n *  // prefix-no-default mode\n *  getMultilingualUrls('/dashboard', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'prefix-no-default' })\n *     // Returns { en: '/dashboard', fr: '/fr/dashboard' }\n *\n *  // prefix-all mode\n *  getMultilingualUrls('/dashboard', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'prefix-all' })\n *     // Returns { en: '/en/dashboard', fr: '/fr/dashboard' }\n *\n *  // search-params mode\n *  getMultilingualUrls('/dashboard', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'search-params' })\n *     // Returns { en: '/dashboard?locale=en', fr: '/dashboard?locale=fr' }\n *\n *  // no-prefix mode\n *  getMultilingualUrls('/dashboard', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'no-prefix' })\n *     // Returns { en: '/dashboard', fr: '/dashboard' }\n * ```\n *\n * @param url - The original URL string to be processed.\n * @param options - Configuration options\n * @param options.locales - Optional array of supported locales. Defaults to configured locales.\n * @param options.defaultLocale - The default locale. Defaults to configured default locale.\n * @param options.mode - URL routing mode for locale handling. Defaults to configured mode.\n * @returns An object mapping each locale to its corresponding multilingual URL.\n */\nexport const getMultilingualUrls = (\n  url: string,\n  options: {\n    locales?: LocalesValues[];\n    defaultLocale?: LocalesValues;\n    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';\n  } = {}\n): StrictModeLocaleMap<string> => {\n  const {\n    locales = configuration?.internationalization?.locales,\n    defaultLocale = configuration?.internationalization?.defaultLocale,\n    mode = configuration?.routing?.mode,\n  } = options;\n\n  // Generate multilingual URLs by iterating over each locale and calling getLocalizedUrl\n  const multilingualUrls = (locales ?? []).reduce<StrictModeLocaleMap<string>>(\n    (acc, locale) => {\n      // Get the localized URL for this locale\n      const localizedUrl = getLocalizedUrl(url, locale, {\n        locales,\n        defaultLocale,\n        mode,\n      });\n\n      // Assign the constructed URL to the corresponding locale key\n      acc[locale as unknown as keyof typeof acc] = localizedUrl;\n\n      return acc;\n    },\n    {} as StrictModeLocaleMap<string>\n  );\n\n  return multilingualUrls;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,MAAa,uBACX,KACA,UAII,EAAE,KAC0B;CAChC,MAAM,EACJ,UAAUA,iCAAe,sBAAsB,SAC/C,gBAAgBA,iCAAe,sBAAsB,eACrD,OAAOA,iCAAe,SAAS,SAC7B;AAoBJ,SAjB0B,WAAW,EAAE,EAAE,QACtC,KAAK,WAAW;AASf,MAAI,UAPiBC,qDAAgB,KAAK,QAAQ;GAChD;GACA;GACA;GACD,CAAC;AAKF,SAAO;IAET,EAAE,CACH"}
+{"version":3,"file":"getMultilingualUrls.cjs","names":["configuration","DefaultValues","getLocalizedUrl"],"sources":["../../../src/localization/getMultilingualUrls.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport { DefaultValues } from '@intlayer/config/client';\nimport type { LocalesValues, StrictModeLocaleMap } from '@intlayer/types';\nimport { getLocalizedUrl } from './getLocalizedUrl';\n\n/**\n * Generates multilingual URLs by prefixing the given URL with each supported locale\n * or adding search parameters based on the routing mode.\n * Handles both absolute and relative URLs appropriately.\n *\n * This function gets the locales, default locale, and routing mode from the configuration if not provided.\n *\n * Example:\n *\n * ```ts\n *  // prefix-no-default mode\n *  getMultilingualUrls('/dashboard', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'prefix-no-default' })\n *     // Returns { en: '/dashboard', fr: '/fr/dashboard' }\n *\n *  // prefix-all mode\n *  getMultilingualUrls('/dashboard', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'prefix-all' })\n *     // Returns { en: '/en/dashboard', fr: '/fr/dashboard' }\n *\n *  // search-params mode\n *  getMultilingualUrls('/dashboard', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'search-params' })\n *     // Returns { en: '/dashboard?locale=en', fr: '/dashboard?locale=fr' }\n *\n *  // no-prefix mode\n *  getMultilingualUrls('/dashboard', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'no-prefix' })\n *     // Returns { en: '/dashboard', fr: '/dashboard' }\n * ```\n *\n * @param url - The original URL string to be processed.\n * @param options - Configuration options\n * @param options.locales - Optional array of supported locales. Defaults to configured locales.\n * @param options.defaultLocale - The default locale. Defaults to configured default locale.\n * @param options.mode - URL routing mode for locale handling. Defaults to configured mode.\n * @returns An object mapping each locale to its corresponding multilingual URL.\n */\nexport const getMultilingualUrls = (\n  url: string,\n  options: {\n    locales?: LocalesValues[];\n    defaultLocale?: LocalesValues;\n    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';\n  } = {}\n): StrictModeLocaleMap<string> => {\n  const { defaultLocale, mode, locales } = {\n    defaultLocale:\n      configuration?.internationalization?.defaultLocale ??\n      DefaultValues.Internationalization.DEFAULT_LOCALE,\n    mode: configuration?.routing?.mode ?? DefaultValues.Routing.ROUTING_MODE,\n    locales:\n      configuration?.internationalization?.locales ??\n      DefaultValues.Internationalization.LOCALES,\n    ...options,\n  };\n\n  // Generate multilingual URLs by iterating over each locale and calling getLocalizedUrl\n  const multilingualUrls = (locales ?? []).reduce<StrictModeLocaleMap<string>>(\n    (acc, locale) => {\n      // Get the localized URL for this locale\n      const localizedUrl = getLocalizedUrl(url, locale, {\n        locales,\n        defaultLocale,\n        mode,\n      });\n\n      // Assign the constructed URL to the corresponding locale key\n      acc[locale as unknown as keyof typeof acc] = localizedUrl;\n\n      return acc;\n    },\n    {} as StrictModeLocaleMap<string>\n  );\n\n  return multilingualUrls;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,MAAa,uBACX,KACA,UAII,EAAE,KAC0B;CAChC,MAAM,EAAE,eAAe,MAAM,YAAY;EACvC,eACEA,iCAAe,sBAAsB,iBACrCC,uCAAc,qBAAqB;EACrC,MAAMD,iCAAe,SAAS,QAAQC,uCAAc,QAAQ;EAC5D,SACED,iCAAe,sBAAsB,WACrCC,uCAAc,qBAAqB;EACrC,GAAG;EACJ;AAoBD,SAjB0B,WAAW,EAAE,EAAE,QACtC,KAAK,WAAW;AASf,MAAI,UAPiBC,qDAAgB,KAAK,QAAQ;GAChD;GACA;GACA;GACD,CAAC;AAKF,SAAO;IAET,EAAE,CACH"}

package/dist/cjs/localization/getPrefix.cjs

@@ -1,4 +1,5 @@
 const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let __intlayer_config_client = require("@intlayer/config/client");
 let __intlayer_config_built = require("@intlayer/config/built");
 __intlayer_config_built = require_rolldown_runtime.__toESM(__intlayer_config_built);
 
@@ -37,8 +38,13 @@ __intlayer_config_built = require_rolldown_runtime.__toESM(__intlayer_config_bui
 * @returns An object containing pathPrefix, prefix, and localePrefix for the given locale.
 */
 const getPrefix = (locale, options = {}) => {
-	const { defaultLocale = __intlayer_config_built.default?.internationalization?.defaultLocale, mode = __intlayer_config_built.default?.routing?.mode } = options;
-	if (!locale) return {
+	const { defaultLocale, mode, locales } = {
+		defaultLocale: __intlayer_config_built.default?.internationalization?.defaultLocale ?? __intlayer_config_client.DefaultValues.Internationalization.DEFAULT_LOCALE,
+		mode: __intlayer_config_built.default?.routing?.mode ?? __intlayer_config_client.DefaultValues.Routing.ROUTING_MODE,
+		locales: __intlayer_config_built.default?.internationalization?.locales ?? __intlayer_config_client.DefaultValues.Internationalization.LOCALES,
+		...options
+	};
+	if (!locale || !locales.includes(locale)) return {
 		prefix: "",
 		localePrefix: void 0
 	};

package/dist/cjs/localization/getPrefix.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"getPrefix.cjs","names":["configuration"],"sources":["../../../src/localization/getPrefix.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { Locale, LocalesValues } from '@intlayer/types';\n\nexport type GetPrefixOptions = {\n  defaultLocale?: LocalesValues;\n  mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';\n};\n\nexport type GetPrefixResult = {\n  /**\n   * The complete base URL path with leading and trailing slashes.\n   *\n   * @example\n   * // https://example.com/fr/about -> '/fr'\n   * // https://example.com/about -> ''\n   */\n  prefix: string;\n  /**\n   * The locale identifier without slashes.\n   *\n   * @example\n   * // https://example.com/fr/about -> 'fr'\n   * // https://example.com/about -> undefined\n   */\n  localePrefix: Locale | undefined;\n};\n\n/**\n * Determines the URL prefix for a given locale based on the routing mode configuration.\n *\n * Example:\n *\n * ```ts\n *  // prefix-no-default mode with default locale\n *  getPrefix('en', { defaultLocale: 'en', mode: 'prefix-no-default' })\n *     // Returns { prefix: '', localePrefix: undefined }\n *\n *  // prefix-no-default mode with non-default locale\n *  getPrefix('fr', { defaultLocale: 'en', mode: 'prefix-no-default' })\n *     // Returns { prefix: '/fr', localePrefix: 'fr' }\n *\n *  // prefix-all mode\n *  getPrefix('en', { defaultLocale: 'en', mode: 'prefix-all' })\n *     // Returns { prefix: '/en', localePrefix: locale }\n *\n *  // search-params mode\n *  getPrefix('en', { defaultLocale: 'en', mode: 'search-params' })\n *     // Returns { prefix: '', localePrefix: undefined }\n *\n *  // no-prefix mode\n *  getPrefix('en', { defaultLocale: 'en', mode: 'no-prefix' })\n *     // Returns { prefix: '', localePrefix: undefined }\n * ```\n *\n * @param locale - The locale to check for prefix. If not provided, uses configured default locale.\n * @param options - Configuration options\n * @param options.defaultLocale - The default locale. Defaults to configured default locale.\n * @param options.mode - URL routing mode for locale handling. Defaults to configured mode.\n * @returns An object containing pathPrefix, prefix, and localePrefix for the given locale.\n */\nexport const getPrefix = (\n  locale: LocalesValues,\n  options: {\n    defaultLocale?: LocalesValues;\n    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';\n  } = {}\n): GetPrefixResult => {\n  const {\n    defaultLocale = configuration?.internationalization?.defaultLocale,\n    mode = configuration?.routing?.mode,\n  } = options;\n\n  if (!locale) {\n    return {\n      prefix: '',\n      localePrefix: undefined,\n    };\n  }\n\n  // Handle prefix-based modes (prefix-all or prefix-no-default)\n  const shouldPrefix =\n    mode === 'prefix-all' ||\n    (mode === 'prefix-no-default' && defaultLocale !== locale);\n\n  if (shouldPrefix) {\n    return {\n      prefix: `${locale}/`,\n      localePrefix: locale as Locale,\n    };\n  }\n\n  return {\n    prefix: '',\n    localePrefix: undefined,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4DA,MAAa,aACX,QACA,UAGI,EAAE,KACc;CACpB,MAAM,EACJ,gBAAgBA,iCAAe,sBAAsB,eACrD,OAAOA,iCAAe,SAAS,SAC7B;AAEJ,KAAI,CAAC,OACH,QAAO;EACL,QAAQ;EACR,cAAc;EACf;AAQH,KAHE,SAAS,gBACR,SAAS,uBAAuB,kBAAkB,OAGnD,QAAO;EACL,QAAQ,GAAG,OAAO;EAClB,cAAc;EACf;AAGH,QAAO;EACL,QAAQ;EACR,cAAc;EACf"}
+{"version":3,"file":"getPrefix.cjs","names":["configuration","DefaultValues"],"sources":["../../../src/localization/getPrefix.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport { DefaultValues } from '@intlayer/config/client';\nimport type { Locale, LocalesValues } from '@intlayer/types';\n\nexport type GetPrefixOptions = {\n  defaultLocale?: LocalesValues;\n  mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';\n};\n\nexport type GetPrefixResult = {\n  /**\n   * The complete base URL path with leading and trailing slashes.\n   *\n   * @example\n   * // https://example.com/fr/about -> '/fr'\n   * // https://example.com/about -> ''\n   */\n  prefix: string;\n  /**\n   * The locale identifier without slashes.\n   *\n   * @example\n   * // https://example.com/fr/about -> 'fr'\n   * // https://example.com/about -> undefined\n   */\n  localePrefix: Locale | undefined;\n};\n\n/**\n * Determines the URL prefix for a given locale based on the routing mode configuration.\n *\n * Example:\n *\n * ```ts\n *  // prefix-no-default mode with default locale\n *  getPrefix('en', { defaultLocale: 'en', mode: 'prefix-no-default' })\n *     // Returns { prefix: '', localePrefix: undefined }\n *\n *  // prefix-no-default mode with non-default locale\n *  getPrefix('fr', { defaultLocale: 'en', mode: 'prefix-no-default' })\n *     // Returns { prefix: '/fr', localePrefix: 'fr' }\n *\n *  // prefix-all mode\n *  getPrefix('en', { defaultLocale: 'en', mode: 'prefix-all' })\n *     // Returns { prefix: '/en', localePrefix: locale }\n *\n *  // search-params mode\n *  getPrefix('en', { defaultLocale: 'en', mode: 'search-params' })\n *     // Returns { prefix: '', localePrefix: undefined }\n *\n *  // no-prefix mode\n *  getPrefix('en', { defaultLocale: 'en', mode: 'no-prefix' })\n *     // Returns { prefix: '', localePrefix: undefined }\n * ```\n *\n * @param locale - The locale to check for prefix. If not provided, uses configured default locale.\n * @param options - Configuration options\n * @param options.defaultLocale - The default locale. Defaults to configured default locale.\n * @param options.mode - URL routing mode for locale handling. Defaults to configured mode.\n * @returns An object containing pathPrefix, prefix, and localePrefix for the given locale.\n */\nexport const getPrefix = (\n  locale: LocalesValues | undefined,\n  options: {\n    defaultLocale?: LocalesValues;\n    locales?: LocalesValues[];\n    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';\n  } = {}\n): GetPrefixResult => {\n  const { defaultLocale, mode, locales } = {\n    defaultLocale:\n      configuration?.internationalization?.defaultLocale ??\n      DefaultValues.Internationalization.DEFAULT_LOCALE,\n    mode: configuration?.routing?.mode ?? DefaultValues.Routing.ROUTING_MODE,\n    locales:\n      configuration?.internationalization?.locales ??\n      DefaultValues.Internationalization.LOCALES,\n    ...options,\n  };\n\n  if (!locale || !locales.includes(locale)) {\n    return {\n      prefix: '',\n      localePrefix: undefined,\n    };\n  }\n\n  // Handle prefix-based modes (prefix-all or prefix-no-default)\n  const shouldPrefix =\n    mode === 'prefix-all' ||\n    (mode === 'prefix-no-default' && defaultLocale !== locale);\n\n  if (shouldPrefix) {\n    return {\n      prefix: `${locale}/`,\n      localePrefix: locale as Locale,\n    };\n  }\n\n  return {\n    prefix: '',\n    localePrefix: undefined,\n  };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DA,MAAa,aACX,QACA,UAII,EAAE,KACc;CACpB,MAAM,EAAE,eAAe,MAAM,YAAY;EACvC,eACEA,iCAAe,sBAAsB,iBACrCC,uCAAc,qBAAqB;EACrC,MAAMD,iCAAe,SAAS,QAAQC,uCAAc,QAAQ;EAC5D,SACED,iCAAe,sBAAsB,WACrCC,uCAAc,qBAAqB;EACrC,GAAG;EACJ;AAED,KAAI,CAAC,UAAU,CAAC,QAAQ,SAAS,OAAO,CACtC,QAAO;EACL,QAAQ;EACR,cAAc;EACf;AAQH,KAHE,SAAS,gBACR,SAAS,uBAAuB,kBAAkB,OAGnD,QAAO;EACL,QAAQ,GAAG,OAAO;EAClB,cAAc;EACf;AAGH,QAAO;EACL,QAAQ;EACR,cAAc;EACf"}

package/dist/cjs/localization/index.cjs

@@ -10,6 +10,7 @@ const require_localization_getPrefix = require('./getPrefix.cjs');
 const require_localization_getLocalizedUrl = require('./getLocalizedUrl.cjs');
 const require_localization_getMultilingualUrls = require('./getMultilingualUrls.cjs');
 const require_localization_localeMapper = require('./localeMapper.cjs');
+const require_localization_validatePrefix = require('./validatePrefix.cjs');
 
 exports.getBrowserLocale = require_localization_getBrowserLocale.getBrowserLocale;
 exports.getHTMLTextDir = require_localization_getHTMLTextDir.getHTMLTextDir;
@@ -25,4 +26,5 @@ exports.localeFlatMap = require_localization_localeMapper.localeFlatMap;
 exports.localeMap = require_localization_localeMapper.localeMap;
 exports.localeRecord = require_localization_localeMapper.localeRecord;
 exports.localeResolver = require_localization_localeResolver.localeResolver;
-exports.localeStorageOptions = require_localization_getBrowserLocale.localeStorageOptions;
+exports.localeStorageOptions = require_localization_getBrowserLocale.localeStorageOptions;
+exports.validatePrefix = require_localization_validatePrefix.validatePrefix;

package/dist/cjs/localization/isValidLocale.cjs

@@ -0,0 +1,54 @@
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+const require_localization_getPrefix = require('./getPrefix.cjs');
+let __intlayer_config_client = require("@intlayer/config/client");
+let __intlayer_config_built = require("@intlayer/config/built");
+__intlayer_config_built = require_rolldown_runtime.__toESM(__intlayer_config_built);
+
+//#region src/localization/isValidLocale.ts
+/**
+* Checks whether a given locale is valid based on the configured locales.
+*
+* @param locale - The locale value to validate. Can be `undefined` or `null`.
+* @param options - Optional configuration to override default settings.
+* @param options.locales - Array of valid locales. Defaults to the configured internationalization locales.
+* @param options.defaultLocale - The default locale to use as fallback. Defaults to the configured default locale.
+* @param options.mode - The routing mode (`'prefix'`, `'prefix-all'`, or `'no-prefix'`). Defaults to the configured routing mode.
+* @returns `true` if the locale is valid or if no locale is provided and the routing mode allows it; `false` otherwise.
+*
+* @example
+* // Check if 'en' is a valid locale
+* const isValid = validatePrefix('en');
+*
+* @example
+* // Check with custom options
+* const isValid = validatePrefix('fr', {
+*   locales: ['en', 'fr', 'es'],
+*   defaultLocale: 'en',
+*   mode: 'prefix-all',
+* });
+*/
+const validatePrefix = (locale, options) => {
+	const { defaultLocale, mode, locales } = {
+		defaultLocale: __intlayer_config_built.default?.internationalization?.defaultLocale ?? __intlayer_config_client.DefaultValues.Internationalization.DEFAULT_LOCALE,
+		mode: __intlayer_config_built.default?.routing?.mode ?? __intlayer_config_client.DefaultValues.Routing.ROUTING_MODE,
+		locales: __intlayer_config_built.default?.internationalization?.locales ?? __intlayer_config_client.DefaultValues.Internationalization.LOCALES,
+		...options
+	};
+	const { localePrefix } = require_localization_getPrefix.getPrefix(locale || defaultLocale, {
+		mode,
+		locales,
+		defaultLocale
+	});
+	if (localePrefix === locale && locale === void 0) return {
+		isValid: true,
+		localePrefix: void 0
+	};
+	return {
+		isValid: locales.some((localeEl) => localeEl === locale),
+		localePrefix
+	};
+};
+
+//#endregion
+exports.validatePrefix = validatePrefix;
+//# sourceMappingURL=isValidLocale.cjs.map

package/dist/cjs/localization/isValidLocale.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"isValidLocale.cjs","names":["configuration","DefaultValues","getPrefix"],"sources":["../../../src/localization/isValidLocale.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport { DefaultValues } from '@intlayer/config/client';\nimport type { LocalesValues } from '@intlayer/types';\nimport { getPrefix } from './getPrefix';\n\n/**\n * Checks whether a given locale is valid based on the configured locales.\n *\n * @param locale - The locale value to validate. Can be `undefined` or `null`.\n * @param options - Optional configuration to override default settings.\n * @param options.locales - Array of valid locales. Defaults to the configured internationalization locales.\n * @param options.defaultLocale - The default locale to use as fallback. Defaults to the configured default locale.\n * @param options.mode - The routing mode (`'prefix'`, `'prefix-all'`, or `'no-prefix'`). Defaults to the configured routing mode.\n * @returns `true` if the locale is valid or if no locale is provided and the routing mode allows it; `false` otherwise.\n *\n * @example\n * // Check if 'en' is a valid locale\n * const isValid = validatePrefix('en');\n *\n * @example\n * // Check with custom options\n * const isValid = validatePrefix('fr', {\n *   locales: ['en', 'fr', 'es'],\n *   defaultLocale: 'en',\n *   mode: 'prefix-all',\n * });\n */\nexport const validatePrefix = (\n  locale: LocalesValues | undefined | null,\n  options?: {\n    locales?: LocalesValues[];\n    defaultLocale?: LocalesValues;\n    mode?: typeof configuration.routing.mode;\n  }\n): boolean => {\n  const { defaultLocale, mode, locales } = {\n    defaultLocale:\n      configuration?.internationalization?.defaultLocale ??\n      DefaultValues.Internationalization.DEFAULT_LOCALE,\n    mode: configuration?.routing?.mode ?? DefaultValues.Routing.ROUTING_MODE,\n    locales:\n      configuration?.internationalization?.locales ??\n      DefaultValues.Internationalization.LOCALES,\n    ...options,\n  };\n\n  // If no locale provided (optional param), will use default\n  // In `routing.mode = 'prefix-all'`, the locale is required to be a valid locale\n  const { localePrefix } = getPrefix(locale || defaultLocale, {\n    mode,\n    locales,\n    defaultLocale,\n  });\n\n  if (localePrefix === locale && locale === undefined) {\n    return { isValid: true, localePrefix: undefined };\n  }\n\n  // Check if the provided locale is valid\n  const isValidLocale: boolean = locales.some(\n    (localeEl) => localeEl === locale\n  );\n\n  return { isValid: isValidLocale, localePrefix: localePrefix };\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BA,MAAa,kBACX,QACA,YAKY;CACZ,MAAM,EAAE,eAAe,MAAM,YAAY;EACvC,eACEA,iCAAe,sBAAsB,iBACrCC,uCAAc,qBAAqB;EACrC,MAAMD,iCAAe,SAAS,QAAQC,uCAAc,QAAQ;EAC5D,SACED,iCAAe,sBAAsB,WACrCC,uCAAc,qBAAqB;EACrC,GAAG;EACJ;CAID,MAAM,EAAE,iBAAiBC,yCAAU,UAAU,eAAe;EAC1D;EACA;EACA;EACD,CAAC;AAEF,KAAI,iBAAiB,UAAU,WAAW,OACxC,QAAO;EAAE,SAAS;EAAM,cAAc;EAAW;AAQnD,QAAO;EAAE,SAJsB,QAAQ,MACpC,aAAa,aAAa,OAC5B;EAE8C;EAAc"}