@intlayer/core 9.3.2 → 9.4.0-canary.0

package/dist/cjs/localization/getLocalizedPath.test-d.cjs

@@ -0,0 +1,83 @@
+const require_localization_getLocalizedPath = require('./getLocalizedPath.cjs');
+const require_localization_getLocalizedUrl = require('./getLocalizedUrl.cjs');
+let vitest = require("vitest");
+
+//#region src/localization/getLocalizedPath.test-d.ts
+/**
+* `getLocalizedPath` prefixes the rewritten path, so it reports the very type
+* its sibling reports for a relative URL. This package declares neither rewrite
+* rules nor a default locale, so the registry leaves both steps as no-ops.
+*/
+(0, vitest.describe)("getLocalizedPath", () => {
+	(0, vitest.it)("should report the same type as getLocalizedUrl", () => {
+		(0, vitest.expectTypeOf)(require_localization_getLocalizedPath.getLocalizedPath("/about", "fr")).toEqualTypeOf();
+		(0, vitest.expectTypeOf)(require_localization_getLocalizedPath.getLocalizedPath("/about", "fr")).toEqualTypeOf(require_localization_getLocalizedUrl.getLocalizedUrl("/about", "fr"));
+	});
+	(0, vitest.it)("should keep the literal path when nothing rewrites or prefixes it", () => {
+		(0, vitest.expectTypeOf)(require_localization_getLocalizedPath.getLocalizedPath("/about", "fr")).toEqualTypeOf();
+	});
+	(0, vitest.it)("should drop the origin of an absolute URL", () => {
+		(0, vitest.expectTypeOf)(require_localization_getLocalizedPath.getLocalizedPath("https://intlayer.org/about", "fr")).toEqualTypeOf();
+	});
+	(0, vitest.it)("should widen to string when the path is not a literal", () => {
+		(0, vitest.expectTypeOf)(require_localization_getLocalizedPath.getLocalizedPath("/about", "fr")).toEqualTypeOf();
+	});
+});
+/**
+* The resolution itself, exercised against explicit rules — the same shape the
+* generated module augmentation feeds it as `__RoutingRegistry['rewrite']`.
+*/
+(0, vitest.describe)("LocalizedPath", () => {
+	(0, vitest.it)("should rewrite a static path", () => {
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+	});
+	(0, vitest.it)("should keep a path no rule matches", () => {
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+	});
+	(0, vitest.it)("should substitute a route parameter", () => {
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+	});
+	(0, vitest.it)("should substitute several route parameters", () => {
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+	});
+	(0, vitest.it)("should not match a parameter across a segment boundary", () => {
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+	});
+	(0, vitest.it)("should keep the path when the locale declares no pattern", () => {
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+	});
+	(0, vitest.it)("should distribute over a union of locales", () => {
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+	});
+	(0, vitest.it)("should widen a variadic rule to string, but only for the paths it could match", () => {
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+	});
+	(0, vitest.it)("should keep every path when the project declares no rule", () => {
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+	});
+});
+/**
+* The return type of `getLocalizedPath`, exercised against an explicit routing
+* mode, default locale and locale set — this package declares none of them.
+*/
+(0, vitest.describe)("LocalizedPathname", () => {
+	(0, vitest.it)("should report the same type as LocalizedUrl for a relative path", () => {
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+	});
+	(0, vitest.it)("should drop the origin of an absolute URL", () => {
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+	});
+	(0, vitest.it)("should collapse an origin without a path to the root", () => {
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+	});
+	(0, vitest.it)("should replace a locale segment carried by an absolute URL", () => {
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+	});
+});
+
+//#endregion
+//# sourceMappingURL=getLocalizedPath.test-d.cjs.map

package/dist/cjs/localization/getLocalizedPath.test-d.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getLocalizedPath.test-d.cjs","names":["describe","getLocalizedPath","getLocalizedUrl"],"sources":["../../../src/localization/getLocalizedPath.test-d.ts"],"sourcesContent":["import type {\n  LocalizedPath,\n  LocalizedPathname,\n  LocalizedUrl,\n} from '@intlayer/types/module_augmentation';\nimport { describe, expectTypeOf, it } from 'vitest';\nimport { getLocalizedPath } from './getLocalizedPath';\nimport { getLocalizedUrl } from './getLocalizedUrl';\n\n/**\n * `getLocalizedPath` prefixes the rewritten path, so it reports the very type\n * its sibling reports for a relative URL. This package declares neither rewrite\n * rules nor a default locale, so the registry leaves both steps as no-ops.\n */\ndescribe('getLocalizedPath', () => {\n  it('should report the same type as getLocalizedUrl', () => {\n    expectTypeOf(getLocalizedPath('/about', 'fr')).toEqualTypeOf<\n      LocalizedUrl<'/about', 'fr'>\n    >();\n    expectTypeOf(getLocalizedPath('/about', 'fr')).toEqualTypeOf(\n      getLocalizedUrl('/about', 'fr')\n    );\n  });\n\n  it('should keep the literal path when nothing rewrites or prefixes it', () => {\n    expectTypeOf(getLocalizedPath('/about', 'fr')).toEqualTypeOf<'/about'>();\n  });\n\n  it('should drop the origin of an absolute URL', () => {\n    expectTypeOf(\n      getLocalizedPath('https://intlayer.org/about', 'fr')\n    ).toEqualTypeOf<'/about'>();\n  });\n\n  it('should widen to string when the path is not a literal', () => {\n    const dynamicPath = '/about' as string;\n\n    expectTypeOf(getLocalizedPath(dynamicPath, 'fr')).toEqualTypeOf<string>();\n  });\n});\n\n/**\n * The resolution itself, exercised against explicit rules — the same shape the\n * generated module augmentation feeds it as `__RoutingRegistry['rewrite']`.\n */\ndescribe('LocalizedPath', () => {\n  type Rules = {\n    '/about': { en: '/about'; fr: '/a-propos' };\n    '/product/:id': { en: '/product/:id'; fr: '/produit/:id' };\n    '/shop/:category/:id': { fr: '/boutique/:category/:id' };\n    '/docs/:path+': { fr: '/documentation/:path+' };\n  };\n\n  it('should rewrite a static path', () => {\n    expectTypeOf<\n      LocalizedPath<'/about', 'fr', Rules>\n    >().toEqualTypeOf<'/a-propos'>();\n  });\n\n  it('should keep a path no rule matches', () => {\n    expectTypeOf<\n      LocalizedPath<'/contact', 'fr', Rules>\n    >().toEqualTypeOf<'/contact'>();\n  });\n\n  it('should substitute a route parameter', () => {\n    expectTypeOf<\n      LocalizedPath<'/product/123', 'fr', Rules>\n    >().toEqualTypeOf<'/produit/123'>();\n  });\n\n  it('should substitute several route parameters', () => {\n    expectTypeOf<\n      LocalizedPath<'/shop/shoes/123', 'fr', Rules>\n    >().toEqualTypeOf<'/boutique/shoes/123'>();\n  });\n\n  it('should not match a parameter across a segment boundary', () => {\n    expectTypeOf<\n      LocalizedPath<'/product/123/reviews', 'fr', Rules>\n    >().toEqualTypeOf<'/product/123/reviews'>();\n  });\n\n  it('should keep the path when the locale declares no pattern', () => {\n    expectTypeOf<\n      LocalizedPath<'/shop/shoes/123', 'en', Rules>\n    >().toEqualTypeOf<'/shop/shoes/123'>();\n  });\n\n  it('should distribute over a union of locales', () => {\n    expectTypeOf<LocalizedPath<'/about', 'en' | 'fr', Rules>>().toEqualTypeOf<\n      '/about' | '/a-propos'\n    >();\n  });\n\n  it('should widen a variadic rule to string, but only for the paths it could match', () => {\n    expectTypeOf<\n      LocalizedPath<'/docs/getting-started', 'fr', Rules>\n    >().toEqualTypeOf<string>();\n    expectTypeOf<\n      LocalizedPath<'/about', 'fr', Rules>\n    >().toEqualTypeOf<'/a-propos'>();\n  });\n\n  it('should keep every path when the project declares no rule', () => {\n    expectTypeOf<LocalizedPath<'/about', 'fr', {}>>().toEqualTypeOf<'/about'>();\n  });\n});\n\n/**\n * The return type of `getLocalizedPath`, exercised against an explicit routing\n * mode, default locale and locale set — this package declares none of them.\n */\ndescribe('LocalizedPathname', () => {\n  type Locales = 'en' | 'fr' | 'es';\n  type Path<P extends string, L extends Locales> = LocalizedPathname<\n    P,\n    L,\n    'prefix-no-default',\n    'en',\n    Locales\n  >;\n\n  it('should report the same type as LocalizedUrl for a relative path', () => {\n    expectTypeOf<Path<'/about', 'es'>>().toEqualTypeOf<\n      LocalizedUrl<'/about', 'es', 'prefix-no-default', 'en', Locales>\n    >();\n    expectTypeOf<Path<'/about', 'es'>>().toEqualTypeOf<'/es/about'>();\n  });\n\n  it('should drop the origin of an absolute URL', () => {\n    expectTypeOf<\n      Path<'https://intlayer.org/about', 'es'>\n    >().toEqualTypeOf<'/es/about'>();\n    expectTypeOf<\n      Path<'https://intlayer.org/about', 'en'>\n    >().toEqualTypeOf<'/about'>();\n  });\n\n  it('should collapse an origin without a path to the root', () => {\n    expectTypeOf<Path<'https://intlayer.org', 'en'>>().toEqualTypeOf<'/'>();\n    expectTypeOf<Path<'https://intlayer.org/', 'es'>>().toEqualTypeOf<'/es'>();\n  });\n\n  it('should replace a locale segment carried by an absolute URL', () => {\n    expectTypeOf<\n      Path<'https://intlayer.org/fr/about', 'es'>\n    >().toEqualTypeOf<'/es/about'>();\n  });\n});\n"],"mappings":";;;;;;;;;;IAcAA,iBAAS,0BAA0B;CACjC,eAAG,wDAAwD;EACzD,yBAAaC,uDAAiB,UAAU,IAAI,CAAC,CAAC,CAAC,cAE7C;EACF,yBAAaA,uDAAiB,UAAU,IAAI,CAAC,CAAC,CAAC,cAC7CC,qDAAgB,UAAU,IAAI,CAChC;CACF,CAAC;CAED,eAAG,2EAA2E;EAC5E,yBAAaD,uDAAiB,UAAU,IAAI,CAAC,CAAC,CAAC,cAAwB;CACzE,CAAC;CAED,eAAG,mDAAmD;EACpD,yBACEA,uDAAiB,8BAA8B,IAAI,CACrD,CAAC,CAAC,cAAwB;CAC5B,CAAC;CAED,eAAG,+DAA+D;EAGhE,yBAAaA,uDAAiB,UAAa,IAAI,CAAC,CAAC,CAAC,cAAsB;CAC1E,CAAC;AACH,CAAC;;;;;IAMDD,iBAAS,uBAAuB;CAQ9B,eAAG,sCAAsC;EACvC,yBAEE,CAAC,CAAC,cAA2B;CACjC,CAAC;CAED,eAAG,4CAA4C;EAC7C,yBAEE,CAAC,CAAC,cAA0B;CAChC,CAAC;CAED,eAAG,6CAA6C;EAC9C,yBAEE,CAAC,CAAC,cAA8B;CACpC,CAAC;CAED,eAAG,oDAAoD;EACrD,yBAEE,CAAC,CAAC,cAAqC;CAC3C,CAAC;CAED,eAAG,gEAAgE;EACjE,yBAEE,CAAC,CAAC,cAAsC;CAC5C,CAAC;CAED,eAAG,kEAAkE;EACnE,yBAEE,CAAC,CAAC,cAAiC;CACvC,CAAC;CAED,eAAG,mDAAmD;EACpD,yBAA0D,CAAC,CAAC,cAE1D;CACJ,CAAC;CAED,eAAG,uFAAuF;EACxF,yBAEE,CAAC,CAAC,cAAsB;EAC1B,yBAEE,CAAC,CAAC,cAA2B;CACjC,CAAC;CAED,eAAG,kEAAkE;EACnE,yBAAgD,CAAC,CAAC,cAAwB;CAC5E,CAAC;AACH,CAAC;;;;;IAMDA,iBAAS,2BAA2B;CAUlC,eAAG,yEAAyE;EAC1E,yBAAmC,CAAC,CAAC,cAEnC;EACF,yBAAmC,CAAC,CAAC,cAA2B;CAClE,CAAC;CAED,eAAG,mDAAmD;EACpD,yBAEE,CAAC,CAAC,cAA2B;EAC/B,yBAEE,CAAC,CAAC,cAAwB;CAC9B,CAAC;CAED,eAAG,8DAA8D;EAC/D,yBAAiD,CAAC,CAAC,cAAmB;EACtE,yBAAkD,CAAC,CAAC,cAAqB;CAC3E,CAAC;CAED,eAAG,oEAAoE;EACrE,yBAEE,CAAC,CAAC,cAA2B;CACjC,CAAC;AACH,CAAC"}

package/dist/cjs/localization/getLocalizedUrl.cjs

@@ -1,9 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_utils_checkIsURLAbsolute = require('../utils/checkIsURLAbsolute.cjs');
-const require_localization_getPathWithoutLocale = require('./getPathWithoutLocale.cjs');
 const require_localization_domainUtils = require('./domainUtils.cjs');
 const require_localization_getPrefix = require('./getPrefix.cjs');
-const require_localization_rewriteUtils = require('./rewriteUtils.cjs');
+const require_localization_getLocalizedPath = require('./getLocalizedPath.cjs');
 let _intlayer_config_built = require("@intlayer/config/built");
 
 //#region src/localization/getLocalizedUrl.ts
@@ -13,6 +12,10 @@ let _intlayer_config_built = require("@intlayer/config/built");
 *
 * This function gets the locales, default locale, and routing mode from the configuration if not provided.
 *
+* The path itself is localized by {@link getLocalizedPath}; this function only
+* resolves the origin to put in front of it — the one of an absolute input, or
+* the domain mapped to the target locale.
+*
 * Example:
 *
 * ```ts
@@ -52,33 +55,14 @@ let _intlayer_config_built = require("@intlayer/config/built");
 * not overridden via `options`.
 */
 const getLocalizedUrl = (url, currentLocale = _intlayer_config_built.internationalization?.defaultLocale, options = {}) => {
-	const { defaultLocale, mode, locales, rewrite, domains, currentDomain } = require_localization_getPrefix.resolveRoutingConfig(options);
-	const urlWithoutLocale = require_localization_getPathWithoutLocale.getPathWithoutLocale(url, locales);
-	const rewriteRules = require_localization_rewriteUtils.getRewriteRules(rewrite, "url");
-	if (!(process.env.INTLAYER_ROUTING_MODE && process.env.INTLAYER_ROUTING_MODE !== "no-prefix") && mode === "no-prefix") return require_localization_rewriteUtils.getLocalizedPath(require_localization_rewriteUtils.getCanonicalPath(urlWithoutLocale, void 0, rewriteRules), currentLocale, rewriteRules).path;
-	const isAbsoluteUrl = require_utils_checkIsURLAbsolute.checkIsURLAbsolute(urlWithoutLocale);
-	const parsedUrl = isAbsoluteUrl ? new URL(urlWithoutLocale) : new URL(urlWithoutLocale, "http://example.com");
-	const translatedPathname = require_localization_rewriteUtils.getLocalizedPath(require_localization_rewriteUtils.getCanonicalPath(parsedUrl.pathname, void 0, rewriteRules), currentLocale, rewriteRules).path;
+	const { domains, currentDomain } = require_localization_getPrefix.resolveRoutingConfig(options);
+	const isAbsoluteUrl = require_utils_checkIsURLAbsolute.checkIsURLAbsolute(url);
+	const parsedUrl = isAbsoluteUrl ? new URL(url) : new URL(url, "http://e.com");
 	const detectedCurrentHostname = process.env.INTLAYER_ROUTING_DOMAINS !== "false" ? require_localization_domainUtils.getDomainHostname(currentDomain ?? (isAbsoluteUrl ? parsedUrl.hostname : void 0) ?? (typeof window !== "undefined" ? window?.location?.hostname : void 0) ?? "") || null : null;
 	const localeDomain = process.env.INTLAYER_ROUTING_DOMAINS !== "false" ? domains?.[currentLocale] : void 0;
 	const localeDomainHostname = localeDomain ? require_localization_domainUtils.getDomainHostname(localeDomain) : null;
 	const normalizedDomain = localeDomainHostname !== null && (detectedCurrentHostname === null || localeDomainHostname !== detectedCurrentHostname) && localeDomain ? require_localization_domainUtils.getDomainOrigin(localeDomain) : null;
-	const baseUrl = normalizedDomain ? normalizedDomain : isAbsoluteUrl ? `${parsedUrl.protocol}//${parsedUrl.host}` : "";
-	if (!(process.env.INTLAYER_ROUTING_MODE && process.env.INTLAYER_ROUTING_MODE !== "search-params") && mode === "search-params") {
-		const searchParams = new URLSearchParams(parsedUrl.search);
-		searchParams.set("locale", currentLocale.toString());
-		const queryParams = searchParams.toString();
-		return `${baseUrl}${queryParams ? `${translatedPathname}?${queryParams}` : translatedPathname}${parsedUrl.hash}`;
-	}
-	const { prefix } = require_localization_getPrefix.getPrefix(currentLocale, {
-		defaultLocale,
-		mode,
-		locales,
-		domains
-	});
-	let localizedPath = `/${prefix}${translatedPathname}`.replace(/\/+/g, "/");
-	if (localizedPath.length > 1 && localizedPath.endsWith("/")) localizedPath = localizedPath.slice(0, -1);
-	return `${baseUrl}${localizedPath}${parsedUrl.search}${parsedUrl.hash}`;
+	return `${normalizedDomain ? normalizedDomain : isAbsoluteUrl ? `${parsedUrl.protocol}//${parsedUrl.host}` : ""}${require_localization_getLocalizedPath.getLocalizedPath(`${parsedUrl.pathname}${parsedUrl.search}${parsedUrl.hash}`, currentLocale, options)}`;
 };
 
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"getLocalizedUrl.cjs","names":["internationalization","resolveRoutingConfig","getPathWithoutLocale","getRewriteRules","getLocalizedPath","getCanonicalPath","checkIsURLAbsolute","getDomainHostname","getDomainOrigin","getPrefix"],"sources":["../../../src/localization/getLocalizedUrl.ts"],"sourcesContent":["import { internationalization } from '@intlayer/config/built';\n\n// ── Tree-shake constants ──────────────────────────────────────────────────────\n// When these env vars are injected at build time, bundlers eliminate the\n// branches guarded by these constants.\n\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type {\n  LocalesValues,\n  LocalizedUrl,\n  ResolvedDefaultLocale,\n} from '@intlayer/types/module_augmentation';\nimport { checkIsURLAbsolute } from '../utils/checkIsURLAbsolute';\nimport { getDomainHostname, getDomainOrigin } from './domainUtils';\nimport { getPathWithoutLocale } from './getPathWithoutLocale';\nimport {\n  getPrefix,\n  type RoutingOptions,\n  resolveRoutingConfig,\n} from './getPrefix';\nimport {\n  getCanonicalPath,\n  getLocalizedPath,\n  getRewriteRules,\n} from './rewriteUtils';\n\nexport type { RoutingOptions };\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 * @param options.currentDomain - Hostname of the page being rendered. Used to decide\n *   whether to emit a relative URL (same domain) or an absolute URL (cross-domain).\n *   Auto-detected from the input URL or `window.location` when omitted.\n * @returns The localized URL for the current locale.\n */\n/**\n * The return type is narrowed to a template-literal type when both `url` and\n * `currentLocale` are string literals and the routing mode / defaultLocale are\n * not overridden via `options`.\n */\nexport const getLocalizedUrl = <\n  const T extends string,\n  const L extends LocalesValues = ResolvedDefaultLocale,\n>(\n  url: T,\n  currentLocale: L = internationalization?.defaultLocale as L,\n  options: RoutingOptions = {}\n): LocalizedUrl<T, L> => {\n  const { defaultLocale, mode, locales, rewrite, domains, currentDomain } =\n    resolveRoutingConfig(options);\n\n  const urlWithoutLocale = getPathWithoutLocale(url, locales);\n  const rewriteRules = getRewriteRules(rewrite, 'url');\n\n  if (\n    !(\n      process.env.INTLAYER_ROUTING_MODE &&\n      process.env.INTLAYER_ROUTING_MODE !== 'no-prefix'\n    ) &&\n    mode === 'no-prefix'\n  ) {\n    return getLocalizedPath(\n      getCanonicalPath(urlWithoutLocale, undefined, rewriteRules),\n      currentLocale as Locale,\n      rewriteRules\n    ).path as LocalizedUrl<T, L>;\n  }\n\n  const isAbsoluteUrl = checkIsURLAbsolute(urlWithoutLocale);\n  const parsedUrl = isAbsoluteUrl\n    ? new URL(urlWithoutLocale)\n    : new URL(urlWithoutLocale, 'http://example.com');\n\n  const translatedPathname = getLocalizedPath(\n    getCanonicalPath(parsedUrl.pathname, undefined, rewriteRules),\n    currentLocale as Locale,\n    rewriteRules\n  ).path;\n\n  // ── Domain routing ────────────────────────────────────────────────────────\n  // Resolve the \"current\" hostname so we can choose between a relative URL\n  // (same domain) and an absolute URL (cross-domain).\n  //\n  // Detection priority:\n  //   1. Explicit `currentDomain` option passed by the caller.\n  //   2. Hostname extracted from an absolute input URL.\n  //   3. `window.location.hostname` in browser environments.\n  // When none of these is available we fall back to generating an absolute\n  // URL for domain-mapped locales (safe for SSR/static generation): the\n  // locale prefix may already be stripped for domain-exclusive locales, so a\n  // relative URL would silently point to the wrong locale on the current\n  // domain.\n  const detectedCurrentHostname =\n    process.env.INTLAYER_ROUTING_DOMAINS !== 'false'\n      ? getDomainHostname(\n          currentDomain ??\n            (isAbsoluteUrl ? parsedUrl.hostname : undefined) ??\n            (typeof window !== 'undefined'\n              ? window?.location?.hostname\n              : undefined) ??\n            ''\n        ) || null\n      : null;\n\n  const localeDomain =\n    process.env.INTLAYER_ROUTING_DOMAINS !== 'false'\n      ? domains?.[currentLocale as LocalesValues]\n      : undefined;\n\n  const localeDomainHostname = localeDomain\n    ? getDomainHostname(localeDomain)\n    : null;\n\n  // Prepend the locale's domain when it differs from the current hostname,\n  // or when the current hostname is unknown (SSR without `currentDomain`).\n  const isCrossDomain =\n    localeDomainHostname !== null &&\n    (detectedCurrentHostname === null ||\n      localeDomainHostname !== detectedCurrentHostname);\n\n  const normalizedDomain =\n    isCrossDomain && localeDomain ? getDomainOrigin(localeDomain) : null;\n\n  const baseUrl = normalizedDomain\n    ? normalizedDomain\n    : isAbsoluteUrl\n      ? `${parsedUrl.protocol}//${parsedUrl.host}`\n      : '';\n  // ─────────────────────────────────────────────────────────────────────────\n\n  if (\n    !(\n      process.env.INTLAYER_ROUTING_MODE &&\n      process.env.INTLAYER_ROUTING_MODE !== 'search-params'\n    ) &&\n    mode === 'search-params'\n  ) {\n    const searchParams = new URLSearchParams(parsedUrl.search);\n\n    searchParams.set('locale', currentLocale.toString());\n\n    const queryParams = searchParams.toString();\n    const path = queryParams\n      ? `${translatedPathname}?${queryParams}`\n      : translatedPathname;\n\n    return `${baseUrl}${path}${parsedUrl.hash}` as LocalizedUrl<T, L>;\n  }\n\n  const { prefix } = getPrefix(currentLocale, {\n    defaultLocale,\n    mode,\n    locales,\n    domains,\n  });\n\n  let localizedPath = `/${prefix}${translatedPathname}`.replace(/\\/+/g, '/');\n\n  if (localizedPath.length > 1 && localizedPath.endsWith('/')) {\n    localizedPath = localizedPath.slice(0, -1);\n  }\n\n  return `${baseUrl}${localizedPath}${parsedUrl.search}${parsedUrl.hash}` as LocalizedUrl<\n    T,\n    L\n  >;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwEA,MAAa,mBAIX,KACA,gBAAmBA,6CAAsB,eACzC,UAA0B,CAAC,MACJ;CACvB,MAAM,EAAE,eAAe,MAAM,SAAS,SAAS,SAAS,kBACtDC,oDAAqB,OAAO;CAE9B,MAAM,mBAAmBC,+DAAqB,KAAK,OAAO;CAC1D,MAAM,eAAeC,kDAAgB,SAAS,KAAK;CAEnD,IACE,EACE,QAAQ,IAAI,yBACZ,QAAQ,IAAI,0BAA0B,gBAExC,SAAS,aAET,OAAOC,mDACLC,mDAAiB,kBAAkB,QAAW,YAAY,GAC1D,eACA,YACF,CAAC,CAAC;CAGJ,MAAM,gBAAgBC,oDAAmB,gBAAgB;CACzD,MAAM,YAAY,gBACd,IAAI,IAAI,gBAAgB,IACxB,IAAI,IAAI,kBAAkB,oBAAoB;CAElD,MAAM,qBAAqBF,mDACzBC,mDAAiB,UAAU,UAAU,QAAW,YAAY,GAC5D,eACA,YACF,CAAC,CAAC;CAeF,MAAM,0BACJ,QAAQ,IAAI,6BAA6B,UACrCE,mDACE,kBACG,gBAAgB,UAAU,WAAW,YACrC,OAAO,WAAW,cACf,QAAQ,UAAU,WAClB,WACJ,EACJ,KAAK,OACL;CAEN,MAAM,eACJ,QAAQ,IAAI,6BAA6B,UACrC,UAAU,iBACV;CAEN,MAAM,uBAAuB,eACzBA,mDAAkB,YAAY,IAC9B;CASJ,MAAM,mBAJJ,yBAAyB,SACxB,4BAA4B,QAC3B,yBAAyB,4BAGV,eAAeC,iDAAgB,YAAY,IAAI;CAElE,MAAM,UAAU,mBACZ,mBACA,gBACE,GAAG,UAAU,SAAS,IAAI,UAAU,SACpC;CAGN,IACE,EACE,QAAQ,IAAI,yBACZ,QAAQ,IAAI,0BAA0B,oBAExC,SAAS,iBACT;EACA,MAAM,eAAe,IAAI,gBAAgB,UAAU,MAAM;EAEzD,aAAa,IAAI,UAAU,cAAc,SAAS,CAAC;EAEnD,MAAM,cAAc,aAAa,SAAS;EAK1C,OAAO,GAAG,UAJG,cACT,GAAG,mBAAmB,GAAG,gBACzB,qBAEuB,UAAU;CACvC;CAEA,MAAM,EAAE,WAAWC,yCAAU,eAAe;EAC1C;EACA;EACA;EACA;CACF,CAAC;CAED,IAAI,gBAAgB,IAAI,SAAS,qBAAqB,QAAQ,QAAQ,GAAG;CAEzE,IAAI,cAAc,SAAS,KAAK,cAAc,SAAS,GAAG,GACxD,gBAAgB,cAAc,MAAM,GAAG,EAAE;CAG3C,OAAO,GAAG,UAAU,gBAAgB,UAAU,SAAS,UAAU;AAInE"}
+{"version":3,"file":"getLocalizedUrl.cjs","names":["internationalization","resolveRoutingConfig","checkIsURLAbsolute","getDomainHostname","getDomainOrigin","getLocalizedPath"],"sources":["../../../src/localization/getLocalizedUrl.ts"],"sourcesContent":["import { internationalization } from '@intlayer/config/built';\nimport type {\n  LocalesValues,\n  LocalizedUrl,\n  ResolvedDefaultLocale,\n} from '@intlayer/types/module_augmentation';\nimport { checkIsURLAbsolute } from '../utils/checkIsURLAbsolute';\nimport { getDomainHostname, getDomainOrigin } from './domainUtils';\nimport { getLocalizedPath } from './getLocalizedPath';\nimport { type RoutingOptions, resolveRoutingConfig } 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 * The path itself is localized by {@link getLocalizedPath}; this function only\n * resolves the origin to put in front of it — the one of an absolute input, or\n * the domain mapped to the target locale.\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 * @param options.currentDomain - Hostname of the page being rendered. Used to decide\n *   whether to emit a relative URL (same domain) or an absolute URL (cross-domain).\n *   Auto-detected from the input URL or `window.location` when omitted.\n * @returns The localized URL for the current locale.\n */\n/**\n * The return type is narrowed to a template-literal type when both `url` and\n * `currentLocale` are string literals and the routing mode / defaultLocale are\n * not overridden via `options`.\n */\nexport const getLocalizedUrl = <\n  const T extends string,\n  const L extends LocalesValues = ResolvedDefaultLocale,\n>(\n  url: T,\n  currentLocale: L = internationalization?.defaultLocale as L,\n  options: RoutingOptions = {}\n): LocalizedUrl<T, L> => {\n  const { domains, currentDomain } = resolveRoutingConfig(options);\n\n  const isAbsoluteUrl = checkIsURLAbsolute(url);\n  const parsedUrl = isAbsoluteUrl ? new URL(url) : new URL(url, 'http://e.com');\n\n  // ── Domain routing ────────────────────────────────────────────────────────\n  // Resolve the \"current\" hostname so we can choose between a relative URL\n  // (same domain) and an absolute URL (cross-domain).\n  //\n  // Detection priority:\n  //   1. Explicit `currentDomain` option passed by the caller.\n  //   2. Hostname extracted from an absolute input URL.\n  //   3. `window.location.hostname` in browser environments.\n  // When none of these is available we fall back to generating an absolute\n  // URL for domain-mapped locales (safe for SSR/static generation): the\n  // locale prefix may already be stripped for domain-exclusive locales, so a\n  // relative URL would silently point to the wrong locale on the current\n  // domain.\n  const detectedCurrentHostname =\n    process.env.INTLAYER_ROUTING_DOMAINS !== 'false'\n      ? getDomainHostname(\n          currentDomain ??\n            (isAbsoluteUrl ? parsedUrl.hostname : undefined) ??\n            (typeof window !== 'undefined'\n              ? window?.location?.hostname\n              : undefined) ??\n            ''\n        ) || null\n      : null;\n\n  const localeDomain =\n    process.env.INTLAYER_ROUTING_DOMAINS !== 'false'\n      ? domains?.[currentLocale as LocalesValues]\n      : undefined;\n\n  const localeDomainHostname = localeDomain\n    ? getDomainHostname(localeDomain)\n    : null;\n\n  // Prepend the locale's domain when it differs from the current hostname,\n  // or when the current hostname is unknown (SSR without `currentDomain`).\n  const isCrossDomain =\n    localeDomainHostname !== null &&\n    (detectedCurrentHostname === null ||\n      localeDomainHostname !== detectedCurrentHostname);\n\n  const normalizedDomain =\n    isCrossDomain && localeDomain ? getDomainOrigin(localeDomain) : null;\n\n  const baseUrl = normalizedDomain\n    ? normalizedDomain\n    : isAbsoluteUrl\n      ? `${parsedUrl.protocol}//${parsedUrl.host}`\n      : '';\n  // ─────────────────────────────────────────────────────────────────────────\n\n  const localizedPath = getLocalizedPath(\n    `${parsedUrl.pathname}${parsedUrl.search}${parsedUrl.hash}`,\n    currentLocale,\n    options\n  );\n\n  return `${baseUrl}${localizedPath}` as LocalizedUrl<T, L>;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2DA,MAAa,mBAIX,KACA,gBAAmBA,6CAAsB,eACzC,UAA0B,CAAC,MACJ;CACvB,MAAM,EAAE,SAAS,kBAAkBC,oDAAqB,OAAO;CAE/D,MAAM,gBAAgBC,oDAAmB,GAAG;CAC5C,MAAM,YAAY,gBAAgB,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,KAAK,cAAc;CAe5E,MAAM,0BACJ,QAAQ,IAAI,6BAA6B,UACrCC,mDACE,kBACG,gBAAgB,UAAU,WAAW,YACrC,OAAO,WAAW,cACf,QAAQ,UAAU,WAClB,WACJ,EACJ,KAAK,OACL;CAEN,MAAM,eACJ,QAAQ,IAAI,6BAA6B,UACrC,UAAU,iBACV;CAEN,MAAM,uBAAuB,eACzBA,mDAAkB,YAAY,IAC9B;CASJ,MAAM,mBAJJ,yBAAyB,SACxB,4BAA4B,QAC3B,yBAAyB,4BAGV,eAAeC,iDAAgB,YAAY,IAAI;CAelE,OAAO,GAbS,mBACZ,mBACA,gBACE,GAAG,UAAU,SAAS,IAAI,UAAU,SACpC,KAGgBC,uDACpB,GAAG,UAAU,WAAW,UAAU,SAAS,UAAU,QACrD,eACA,OAG8B;AAClC"}

package/dist/cjs/localization/getLocalizedUrl.test-d.cjs

@@ -0,0 +1,42 @@
+let vitest = require("vitest");
+
+//#region src/localization/getLocalizedUrl.test-d.ts
+/**
+* `LocalizedUrl` mirrors what `getLocalizedUrl` builds at runtime. The routing
+* mode, default locale and declared locales are passed explicitly here — this
+* package declares none of them, so the registry defaults would collapse every
+* locale onto the default one.
+*/
+(0, vitest.describe)("LocalizedUrl", () => {
+	(0, vitest.it)("should prefix a path with a non-default locale", () => {
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+	});
+	(0, vitest.it)("should collapse the root to a bare prefix, never a trailing slash", () => {
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+	});
+	(0, vitest.it)("should leave the default locale unprefixed", () => {
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+	});
+	(0, vitest.it)("should drop the trailing slash of a non-root path", () => {
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+	});
+	(0, vitest.it)("should replace an existing locale segment", () => {
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+	});
+	(0, vitest.it)("should prefix the pathname of an absolute URL, not its origin", () => {
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+	});
+	(0, vitest.it)("should prefix every locale in prefix-all mode", () => {
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+	});
+	(0, vitest.it)("should strip the locale in no-prefix mode", () => {
+		(0, vitest.expectTypeOf)().toEqualTypeOf();
+	});
+});
+
+//#endregion
+//# sourceMappingURL=getLocalizedUrl.test-d.cjs.map

package/dist/cjs/localization/getLocalizedUrl.test-d.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"getLocalizedUrl.test-d.cjs","names":["describe"],"sources":["../../../src/localization/getLocalizedUrl.test-d.ts"],"sourcesContent":["import type { LocalizedUrl } from '@intlayer/types/module_augmentation';\nimport { describe, expectTypeOf, it } from 'vitest';\n\n/**\n * `LocalizedUrl` mirrors what `getLocalizedUrl` builds at runtime. The routing\n * mode, default locale and declared locales are passed explicitly here — this\n * package declares none of them, so the registry defaults would collapse every\n * locale onto the default one.\n */\ndescribe('LocalizedUrl', () => {\n  type Locales = 'en' | 'fr' | 'es';\n  type Url<Path extends string, L extends Locales> = LocalizedUrl<\n    Path,\n    L,\n    'prefix-no-default',\n    'en',\n    Locales\n  >;\n\n  it('should prefix a path with a non-default locale', () => {\n    expectTypeOf<Url<'/about', 'es'>>().toEqualTypeOf<'/es/about'>();\n  });\n\n  it('should collapse the root to a bare prefix, never a trailing slash', () => {\n    expectTypeOf<Url<'/', 'es'>>().toEqualTypeOf<'/es'>();\n  });\n\n  it('should leave the default locale unprefixed', () => {\n    expectTypeOf<Url<'/about', 'en'>>().toEqualTypeOf<'/about'>();\n    expectTypeOf<Url<'/', 'en'>>().toEqualTypeOf<'/'>();\n  });\n\n  it('should drop the trailing slash of a non-root path', () => {\n    expectTypeOf<Url<'/about/', 'fr'>>().toEqualTypeOf<'/fr/about'>();\n  });\n\n  it('should replace an existing locale segment', () => {\n    expectTypeOf<Url<'/en/about', 'fr'>>().toEqualTypeOf<'/fr/about'>();\n    expectTypeOf<Url<'/fr', 'es'>>().toEqualTypeOf<'/es'>();\n  });\n\n  it('should prefix the pathname of an absolute URL, not its origin', () => {\n    expectTypeOf<\n      Url<'https://example.com/about', 'fr'>\n    >().toEqualTypeOf<'https://example.com/fr/about'>();\n    expectTypeOf<\n      Url<'https://example.com/', 'fr'>\n    >().toEqualTypeOf<'https://example.com/fr'>();\n  });\n\n  it('should prefix every locale in prefix-all mode', () => {\n    expectTypeOf<\n      LocalizedUrl<'/', 'en', 'prefix-all', 'en', Locales>\n    >().toEqualTypeOf<'/en'>();\n    expectTypeOf<\n      LocalizedUrl<'/about', 'en', 'prefix-all', 'en', Locales>\n    >().toEqualTypeOf<'/en/about'>();\n  });\n\n  it('should strip the locale in no-prefix mode', () => {\n    expectTypeOf<\n      LocalizedUrl<'/fr/about', 'fr', 'no-prefix', 'en', Locales>\n    >().toEqualTypeOf<'/about'>();\n  });\n});\n"],"mappings":";;;;;;;;;IASAA,iBAAS,sBAAsB;CAU7B,eAAG,wDAAwD;EACzD,yBAAkC,CAAC,CAAC,cAA2B;CACjE,CAAC;CAED,eAAG,2EAA2E;EAC5E,yBAA6B,CAAC,CAAC,cAAqB;CACtD,CAAC;CAED,eAAG,oDAAoD;EACrD,yBAAkC,CAAC,CAAC,cAAwB;EAC5D,yBAA6B,CAAC,CAAC,cAAmB;CACpD,CAAC;CAED,eAAG,2DAA2D;EAC5D,yBAAmC,CAAC,CAAC,cAA2B;CAClE,CAAC;CAED,eAAG,mDAAmD;EACpD,yBAAqC,CAAC,CAAC,cAA2B;EAClE,yBAA+B,CAAC,CAAC,cAAqB;CACxD,CAAC;CAED,eAAG,uEAAuE;EACxE,yBAEE,CAAC,CAAC,cAA8C;EAClD,yBAEE,CAAC,CAAC,cAAwC;CAC9C,CAAC;CAED,eAAG,uDAAuD;EACxD,yBAEE,CAAC,CAAC,cAAqB;EACzB,yBAEE,CAAC,CAAC,cAA2B;CACjC,CAAC;CAED,eAAG,mDAAmD;EACpD,yBAEE,CAAC,CAAC,cAAwB;CAC9B,CAAC;AACH,CAAC"}

package/dist/cjs/localization/getPathWithoutLocale.cjs

@@ -45,7 +45,7 @@ const getPathWithoutLocale = (inputUrl, locales = _intlayer_config_built.interna
 	const isAbsoluteUrl = require_utils_checkIsURLAbsolute.checkIsURLAbsolute(inputUrl);
 	let fixedInputUrl = inputUrl;
 	if (inputUrl?.endsWith("/")) fixedInputUrl = inputUrl.slice(0, -1);
-	const url = isAbsoluteUrl ? new URL(fixedInputUrl) : new URL(fixedInputUrl, "http://example.com");
+	const url = isAbsoluteUrl ? new URL(fixedInputUrl) : new URL(fixedInputUrl, "http://e.com");
 	const pathname = url.pathname;
 	if (!pathname.startsWith("/")) url.pathname = `/${pathname}`;
 	if (!TREE_SHAKE_PREFIX_MODES) {
@@ -64,7 +64,7 @@ const getPathWithoutLocale = (inputUrl, locales = _intlayer_config_built.interna
 		}
 	}
 	if (isAbsoluteUrl) return url.toString();
-	return url.toString().replace("http://example.com", "");
+	return url.toString().replace("http://e.com", "");
 };
 
 //#endregion

package/dist/cjs/localization/getPathWithoutLocale.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"getPathWithoutLocale.cjs","names":["internationalization","checkIsURLAbsolute"],"sources":["../../../src/localization/getPathWithoutLocale.ts"],"sourcesContent":["import { internationalization } from '@intlayer/config/built';\n\n// ── Tree-shake constants ──────────────────────────────────────────────────────\n// When these env vars are injected at build time, bundlers eliminate the\n// branches guarded by these constants.\n\n/**\n * True when the build-time routing mode is known and is not a prefix-based\n * mode (neither 'prefix-all' nor 'prefix-no-default').\n */\nconst TREE_SHAKE_PREFIX_MODES =\n  process.env.INTLAYER_ROUTING_MODE &&\n  process.env.INTLAYER_ROUTING_MODE !== 'prefix-all' &&\n  process.env.INTLAYER_ROUTING_MODE !== 'prefix-no-default';\n\n/**\n * True when the build-time routing mode is known and is NOT 'search-params'.\n */\nconst TREE_SHAKE_SEARCH_PARAMS =\n  process.env.INTLAYER_ROUTING_MODE &&\n  process.env.INTLAYER_ROUTING_MODE !== 'search-params';\n\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n  PathWithoutLocale,\n} from '@intlayer/types/module_augmentation';\nimport { checkIsURLAbsolute } from '../utils/checkIsURLAbsolute';\n\n/**\n * Removes the locale segment from the given URL or pathname if present.\n * Also removes locale from search parameters if present.\n *\n * This function get the locales from the configuration if not provided.\n *\n * Example:\n *\n * ```ts\n * getPathWithoutLocale('/en/dashboard') // Returns '/dashboard'\n * getPathWithoutLocale('/fr/dashboard') // Returns '/dashboard'\n * getPathWithoutLocale('/dashboard') // Returns '/dashboard'\n * getPathWithoutLocale('dashboard') // Returns 'dashboard'\n * getPathWithoutLocale('/dashboard?locale=fr') // Returns '/dashboard'\n * getPathWithoutLocale('https://example.com/en/dashboard') // Returns 'https://example.com/dashboard'\n * getPathWithoutLocale('https://example.com/fr/dashboard') // Returns 'https://example.com/dashboard'\n * getPathWithoutLocale('https://example.com/dashboard') // Returns 'https://example.com/dashboard'\n * getPathWithoutLocale('https://example.com/dashboard?locale=fr') // Returns 'https://example.com/dashboard'\n * ```\n *\n * @param inputUrl - The complete URL string or pathname to process.\n * @param locales - Optional array of supported locales. Defaults to `localesDefault`.\n * @returns The URL string or pathname without the locale segment or locale search parameter.\n */\n/**\n * The return type is narrowed to a template-literal type when both `inputUrl`\n * and `locales` are string literals known at compile time. Absolute URLs fall\n * back to `string`.\n */\nexport const getPathWithoutLocale = <\n  const T extends string,\n  const L extends LocalesValues = DeclaredLocales,\n>(\n  inputUrl: T,\n  locales: L[] = internationalization?.locales as L[]\n): PathWithoutLocale<T, L> => {\n  // Determine if the original URL is absolute (includes protocol)\n  const isAbsoluteUrl = checkIsURLAbsolute(inputUrl);\n\n  let fixedInputUrl = inputUrl;\n\n  if (inputUrl?.endsWith('/')) {\n    fixedInputUrl = inputUrl.slice(0, -1);\n  }\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 url = isAbsoluteUrl\n    ? new URL(fixedInputUrl)\n    : new URL(fixedInputUrl, 'http://example.com');\n\n  const pathname = url.pathname;\n\n  // Ensure the pathname starts with '/'\n  if (!pathname.startsWith('/')) {\n    // If not, return the URL as is\n    url.pathname = `/${pathname}`;\n  }\n\n  // Only strip locale path prefix in prefix-based routing modes\n  if (!TREE_SHAKE_PREFIX_MODES) {\n    // Split the pathname to extract the first segment\n    const pathSegments = pathname.split('/');\n    const firstSegment = pathSegments[1]; // The segment after the first '/'\n\n    // Check if the first segment is a supported locale\n    if (locales?.includes(firstSegment as L)) {\n      // Remove the locale segment from the pathname\n      pathSegments.splice(1, 1); // Remove the first segment\n\n      // Reconstruct the pathname\n      const newPathname = pathSegments.join('/') ?? '/';\n      url.pathname = newPathname;\n    }\n  }\n\n  // Only strip locale from search parameters in search-params routing mode\n  if (!TREE_SHAKE_SEARCH_PARAMS) {\n    const searchParams = new URLSearchParams(url.search);\n    if (searchParams.has('locale')) {\n      searchParams.delete('locale');\n      url.search = searchParams.toString();\n    }\n  }\n\n  if (isAbsoluteUrl) {\n    return url.toString() as PathWithoutLocale<T, L>;\n  }\n\n  return url.toString().replace('http://example.com', '') as PathWithoutLocale<\n    T,\n    L\n  >;\n};\n"],"mappings":";;;;;;;;;AAUA,MAAM,0BACJ,QAAQ,IAAI,yBACZ,QAAQ,IAAI,0BAA0B,gBACtC,QAAQ,IAAI,0BAA0B;;;;AAKxC,MAAM,2BACJ,QAAQ,IAAI,yBACZ,QAAQ,IAAI,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCxC,MAAa,wBAIX,UACA,UAAeA,6CAAsB,YACT;CAE5B,MAAM,gBAAgBC,oDAAmB,QAAQ;CAEjD,IAAI,gBAAgB;CAEpB,IAAI,UAAU,SAAS,GAAG,GACxB,gBAAgB,SAAS,MAAM,GAAG,EAAE;CAKtC,MAAM,MAAM,gBACR,IAAI,IAAI,aAAa,IACrB,IAAI,IAAI,eAAe,oBAAoB;CAE/C,MAAM,WAAW,IAAI;CAGrB,IAAI,CAAC,SAAS,WAAW,GAAG,GAE1B,IAAI,WAAW,IAAI;CAIrB,IAAI,CAAC,yBAAyB;EAE5B,MAAM,eAAe,SAAS,MAAM,GAAG;EACvC,MAAM,eAAe,aAAa;EAGlC,IAAI,SAAS,SAAS,YAAiB,GAAG;GAExC,aAAa,OAAO,GAAG,CAAC;GAIxB,IAAI,WADgB,aAAa,KAAK,GAAG,KAAK;EAEhD;CACF;CAGA,IAAI,CAAC,0BAA0B;EAC7B,MAAM,eAAe,IAAI,gBAAgB,IAAI,MAAM;EACnD,IAAI,aAAa,IAAI,QAAQ,GAAG;GAC9B,aAAa,OAAO,QAAQ;GAC5B,IAAI,SAAS,aAAa,SAAS;EACrC;CACF;CAEA,IAAI,eACF,OAAO,IAAI,SAAS;CAGtB,OAAO,IAAI,SAAS,CAAC,CAAC,QAAQ,sBAAsB,EAAE;AAIxD"}
+{"version":3,"file":"getPathWithoutLocale.cjs","names":["internationalization","checkIsURLAbsolute"],"sources":["../../../src/localization/getPathWithoutLocale.ts"],"sourcesContent":["import { internationalization } from '@intlayer/config/built';\n\n// ── Tree-shake constants ──────────────────────────────────────────────────────\n// When these env vars are injected at build time, bundlers eliminate the\n// branches guarded by these constants.\n\n/**\n * True when the build-time routing mode is known and is not a prefix-based\n * mode (neither 'prefix-all' nor 'prefix-no-default').\n */\nconst TREE_SHAKE_PREFIX_MODES =\n  process.env.INTLAYER_ROUTING_MODE &&\n  process.env.INTLAYER_ROUTING_MODE !== 'prefix-all' &&\n  process.env.INTLAYER_ROUTING_MODE !== 'prefix-no-default';\n\n/**\n * True when the build-time routing mode is known and is NOT 'search-params'.\n */\nconst TREE_SHAKE_SEARCH_PARAMS =\n  process.env.INTLAYER_ROUTING_MODE &&\n  process.env.INTLAYER_ROUTING_MODE !== 'search-params';\n\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n  PathWithoutLocale,\n} from '@intlayer/types/module_augmentation';\nimport { checkIsURLAbsolute } from '../utils/checkIsURLAbsolute';\n\n/**\n * Removes the locale segment from the given URL or pathname if present.\n * Also removes locale from search parameters if present.\n *\n * This function get the locales from the configuration if not provided.\n *\n * Example:\n *\n * ```ts\n * getPathWithoutLocale('/en/dashboard') // Returns '/dashboard'\n * getPathWithoutLocale('/fr/dashboard') // Returns '/dashboard'\n * getPathWithoutLocale('/dashboard') // Returns '/dashboard'\n * getPathWithoutLocale('dashboard') // Returns 'dashboard'\n * getPathWithoutLocale('/dashboard?locale=fr') // Returns '/dashboard'\n * getPathWithoutLocale('https://example.com/en/dashboard') // Returns 'https://example.com/dashboard'\n * getPathWithoutLocale('https://example.com/fr/dashboard') // Returns 'https://example.com/dashboard'\n * getPathWithoutLocale('https://example.com/dashboard') // Returns 'https://example.com/dashboard'\n * getPathWithoutLocale('https://example.com/dashboard?locale=fr') // Returns 'https://example.com/dashboard'\n * ```\n *\n * @param inputUrl - The complete URL string or pathname to process.\n * @param locales - Optional array of supported locales. Defaults to `localesDefault`.\n * @returns The URL string or pathname without the locale segment or locale search parameter.\n */\n/**\n * The return type is narrowed to a template-literal type when both `inputUrl`\n * and `locales` are string literals known at compile time. Absolute URLs fall\n * back to `string`.\n */\nexport const getPathWithoutLocale = <\n  const T extends string,\n  const L extends LocalesValues = DeclaredLocales,\n>(\n  inputUrl: T,\n  locales: L[] = internationalization?.locales as L[]\n): PathWithoutLocale<T, L> => {\n  // Determine if the original URL is absolute (includes protocol)\n  const isAbsoluteUrl = checkIsURLAbsolute(inputUrl);\n\n  let fixedInputUrl = inputUrl;\n\n  if (inputUrl?.endsWith('/')) {\n    fixedInputUrl = inputUrl.slice(0, -1);\n  }\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 url = isAbsoluteUrl\n    ? new URL(fixedInputUrl)\n    : new URL(fixedInputUrl, 'http://e.com');\n\n  const pathname = url.pathname;\n\n  // Ensure the pathname starts with '/'\n  if (!pathname.startsWith('/')) {\n    // If not, return the URL as is\n    url.pathname = `/${pathname}`;\n  }\n\n  // Only strip locale path prefix in prefix-based routing modes\n  if (!TREE_SHAKE_PREFIX_MODES) {\n    // Split the pathname to extract the first segment\n    const pathSegments = pathname.split('/');\n    const firstSegment = pathSegments[1]; // The segment after the first '/'\n\n    // Check if the first segment is a supported locale\n    if (locales?.includes(firstSegment as L)) {\n      // Remove the locale segment from the pathname\n      pathSegments.splice(1, 1); // Remove the first segment\n\n      // Reconstruct the pathname\n      const newPathname = pathSegments.join('/') ?? '/';\n      url.pathname = newPathname;\n    }\n  }\n\n  // Only strip locale from search parameters in search-params routing mode\n  if (!TREE_SHAKE_SEARCH_PARAMS) {\n    const searchParams = new URLSearchParams(url.search);\n    if (searchParams.has('locale')) {\n      searchParams.delete('locale');\n      url.search = searchParams.toString();\n    }\n  }\n\n  if (isAbsoluteUrl) {\n    return url.toString() as PathWithoutLocale<T, L>;\n  }\n\n  return url.toString().replace('http://e.com', '') as PathWithoutLocale<T, L>;\n};\n"],"mappings":";;;;;;;;;AAUA,MAAM,0BACJ,QAAQ,IAAI,yBACZ,QAAQ,IAAI,0BAA0B,gBACtC,QAAQ,IAAI,0BAA0B;;;;AAKxC,MAAM,2BACJ,QAAQ,IAAI,yBACZ,QAAQ,IAAI,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCxC,MAAa,wBAIX,UACA,UAAeA,6CAAsB,YACT;CAE5B,MAAM,gBAAgBC,oDAAmB,QAAQ;CAEjD,IAAI,gBAAgB;CAEpB,IAAI,UAAU,SAAS,GAAG,GACxB,gBAAgB,SAAS,MAAM,GAAG,EAAE;CAKtC,MAAM,MAAM,gBACR,IAAI,IAAI,aAAa,IACrB,IAAI,IAAI,eAAe,cAAc;CAEzC,MAAM,WAAW,IAAI;CAGrB,IAAI,CAAC,SAAS,WAAW,GAAG,GAE1B,IAAI,WAAW,IAAI;CAIrB,IAAI,CAAC,yBAAyB;EAE5B,MAAM,eAAe,SAAS,MAAM,GAAG;EACvC,MAAM,eAAe,aAAa;EAGlC,IAAI,SAAS,SAAS,YAAiB,GAAG;GAExC,aAAa,OAAO,GAAG,CAAC;GAIxB,IAAI,WADgB,aAAa,KAAK,GAAG,KAAK;EAEhD;CACF;CAGA,IAAI,CAAC,0BAA0B;EAC7B,MAAM,eAAe,IAAI,gBAAgB,IAAI,MAAM;EACnD,IAAI,aAAa,IAAI,QAAQ,GAAG;GAC9B,aAAa,OAAO,QAAQ;GAC5B,IAAI,SAAS,aAAa,SAAS;EACrC;CACF;CAEA,IAAI,eACF,OAAO,IAAI,SAAS;CAGtB,OAAO,IAAI,SAAS,CAAC,CAAC,QAAQ,gBAAgB,EAAE;AAClD"}

package/dist/cjs/localization/getPrefix.cjs

@@ -17,6 +17,19 @@ const resolveRoutingConfig = (options = {}) => ({
 	...options
 });
 /**
+* Narrows an arbitrary string to a declared locale by membership test.
+*
+* `locales` is typed as `DeclaredLocales[]`, so a plain `includes` rejects the
+* `string` values that actually need testing (a URL segment, a query param, a
+* stored value). This keeps the check honest and hands back a narrowed type
+* instead of forcing a cast at every call site.
+*
+* @param value - The candidate locale, from a URL segment / storage / header.
+* @param locales - The locales declared by the configuration.
+* @returns Whether `value` is one of the declared locales.
+*/
+const isDeclaredLocale = (value, locales) => !!value && (locales ?? _intlayer_config_built.internationalization.locales).includes(value);
+/**
 * Determines the URL prefix for a given locale based on the routing mode configuration.
 *
 * Example:
@@ -51,7 +64,7 @@ const resolveRoutingConfig = (options = {}) => ({
 */
 const getPrefix = (locale, options = {}) => {
 	const { defaultLocale, mode, locales, domains } = resolveRoutingConfig(options);
-	if (process.env.INTLAYER_ROUTING_MODE && process.env.INTLAYER_ROUTING_MODE !== "prefix-all" && process.env.INTLAYER_ROUTING_MODE !== "prefix-no-default" || !locale || !locales.includes(locale)) return {
+	if (process.env.INTLAYER_ROUTING_MODE && process.env.INTLAYER_ROUTING_MODE !== "prefix-all" && process.env.INTLAYER_ROUTING_MODE !== "prefix-no-default" || !locale || !isDeclaredLocale(locale, locales)) return {
 		prefix: "",
 		localePrefix: void 0
 	};
@@ -71,5 +84,6 @@ const getPrefix = (locale, options = {}) => {
 
 //#endregion
 exports.getPrefix = getPrefix;
+exports.isDeclaredLocale = isDeclaredLocale;
 exports.resolveRoutingConfig = resolveRoutingConfig;
 //# sourceMappingURL=getPrefix.cjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"getPrefix.cjs","names":["internationalization","DEFAULT_LOCALE","routing","ROUTING_MODE","LOCALES","isLocaleExclusiveOnDomain"],"sources":["../../../src/localization/getPrefix.ts"],"sourcesContent":["import { internationalization, routing } from '@intlayer/config/built';\nimport {\n  DEFAULT_LOCALE,\n  LOCALES,\n  ROUTING_MODE,\n} from '@intlayer/config/defaultValues';\n\n// ── Tree-shake constants ──────────────────────────────────────────────────────\n// When these env vars are injected at build time, bundlers eliminate the\n// branches guarded by these constants.\n\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { RoutingConfig } from '@intlayer/types/config';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n  ResolvedDefaultLocale,\n  ResolvedRoutingMode,\n} from '@intlayer/types/module_augmentation';\nimport { isLocaleExclusiveOnDomain } from './domainUtils';\n\n/**\n * Shared routing options used across all URL localization functions.\n */\nexport type RoutingOptions = {\n  locales?: LocalesValues[];\n  defaultLocale?: LocalesValues;\n  mode?: RoutingConfig['mode'];\n  rewrite?: RoutingConfig['rewrite'];\n  domains?: RoutingConfig['domains'];\n  /**\n   * The hostname of the page currently being rendered (e.g. `'intlayer.org'`).\n   * When provided, `getLocalizedUrl` returns a relative URL for locales whose\n   * configured domain matches `currentDomain`, and an absolute URL only when\n   * the target locale lives on a different domain.\n   *\n   * When omitted the function tries to infer it from:\n   *   1. The domain of an absolute input URL.\n   *   2. `window.location.hostname` in browser environments.\n   * Falls back to always generating absolute URLs when neither is available.\n   */\n  currentDomain?: string;\n};\n\n/**\n * Resolves routing configuration by merging provided options with configuration defaults.\n * Single source of truth for default routing config resolution across all localization functions.\n */\nexport const resolveRoutingConfig = (\n  options: RoutingOptions = {}\n): Omit<RoutingOptions, 'defaultLocale' | 'mode' | 'locales'> & {\n  defaultLocale: LocalesValues;\n  mode: RoutingConfig['mode'];\n  locales: LocalesValues[];\n} => ({\n  defaultLocale: internationalization?.defaultLocale ?? DEFAULT_LOCALE,\n  mode: routing?.mode ?? ROUTING_MODE,\n  locales: internationalization?.locales ?? LOCALES,\n  rewrite: routing?.rewrite,\n  domains: routing?.domains,\n  ...options,\n});\n\nexport type GetPrefixOptions = {\n  defaultLocale?: LocalesValues;\n  mode?: RoutingConfig['mode'];\n};\n\nexport type GetPrefixResult = {\n  /**\n   * The locale path segment appended to `/`, with a trailing slash (e.g. `'fr/'`).\n   * Empty string when no prefix is needed.\n   */\n  prefix: string;\n  /**\n   * The bare locale identifier (e.g. `'fr'`), or `undefined` when no prefix is applied.\n   */\n  localePrefix: Locale | undefined;\n};\n\n/**\n * Narrowed return type for {@link getPrefix} that carries the locale literal through.\n *\n * Distributes over union locales — calling `getPrefix('fr')` in `prefix-no-default`\n * mode with `defaultLocale = 'en'` resolves to `{ prefix: 'fr/'; localePrefix: 'fr' }`.\n *\n * Note: domain-based routing and \"locale not in locales\" edge cases may return an\n * empty result at runtime regardless of what this type reports.\n */\nexport type GetPrefixResultNarrowed<\n  L extends LocalesValues | undefined,\n  Mode extends string = ResolvedRoutingMode,\n  Default extends LocalesValues = ResolvedDefaultLocale,\n> = L extends string\n  ? [string] extends [L] // L is wide (string / LocalesValues) → distribute over declared locales\n    ? GetPrefixResultNarrowed<DeclaredLocales, Mode, Default>\n    : [string] extends [Mode]\n      ? GetPrefixResult // mode is wide → fall back to generic result\n      : Mode extends 'prefix-all'\n        ? { prefix: `${L}/`; localePrefix: L }\n        : Mode extends 'prefix-no-default'\n          ? L extends Default\n            ? { prefix: ''; localePrefix: undefined }\n            : { prefix: `${L}/`; localePrefix: L }\n          : { prefix: ''; localePrefix: undefined } // no-prefix / search-params\n  : { prefix: ''; localePrefix: undefined }; // locale is undefined\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 = <const L extends LocalesValues | undefined>(\n  locale: L,\n  options: RoutingOptions = {}\n): GetPrefixResultNarrowed<L> => {\n  const { defaultLocale, mode, locales, domains } =\n    resolveRoutingConfig(options);\n\n  if (\n    (process.env.INTLAYER_ROUTING_MODE &&\n      process.env.INTLAYER_ROUTING_MODE !== 'prefix-all' &&\n      process.env.INTLAYER_ROUTING_MODE !== 'prefix-no-default') ||\n    !locale ||\n    !locales.includes(locale)\n  ) {\n    return {\n      prefix: '',\n      localePrefix: undefined,\n    } as GetPrefixResultNarrowed<L>;\n  }\n\n  // If this locale is the only one assigned to its domain, no URL prefix is needed\n  // (the domain itself identifies the locale). Shared domains use normal prefix logic.\n  if (\n    process.env.INTLAYER_ROUTING_DOMAINS !== 'false' &&\n    isLocaleExclusiveOnDomain(locale as LocalesValues, domains)\n  ) {\n    return {\n      prefix: '',\n      localePrefix: undefined,\n    } as GetPrefixResultNarrowed<L>;\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    } as GetPrefixResultNarrowed<L>;\n  }\n\n  return {\n    prefix: '',\n    localePrefix: undefined,\n  } as GetPrefixResultNarrowed<L>;\n};\n"],"mappings":";;;;;;;;;;AAgDA,MAAa,wBACX,UAA0B,CAAC,OAKvB;CACJ,eAAeA,6CAAsB,iBAAiBC;CACtD,MAAMC,gCAAS,QAAQC;CACvB,SAASH,6CAAsB,WAAWI;CAC1C,SAASF,gCAAS;CAClB,SAASA,gCAAS;CAClB,GAAG;AACL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+EA,MAAa,aACX,QACA,UAA0B,CAAC,MACI;CAC/B,MAAM,EAAE,eAAe,MAAM,SAAS,YACpC,qBAAqB,OAAO;CAE9B,IACG,QAAQ,IAAI,yBACX,QAAQ,IAAI,0BAA0B,gBACtC,QAAQ,IAAI,0BAA0B,uBACxC,CAAC,UACD,CAAC,QAAQ,SAAS,MAAM,GAExB,OAAO;EACL,QAAQ;EACR,cAAc;CAChB;CAKF,IACE,QAAQ,IAAI,6BAA6B,WACzCG,2DAA0B,QAAyB,OAAO,GAE1D,OAAO;EACL,QAAQ;EACR,cAAc;CAChB;CAQF,IAHE,SAAS,gBACR,SAAS,uBAAuB,kBAAkB,QAGnD,OAAO;EACL,QAAQ,GAAG,OAAO;EAClB,cAAc;CAChB;CAGF,OAAO;EACL,QAAQ;EACR,cAAc;CAChB;AACF"}
+{"version":3,"file":"getPrefix.cjs","names":["internationalization","DEFAULT_LOCALE","routing","ROUTING_MODE","LOCALES","isLocaleExclusiveOnDomain"],"sources":["../../../src/localization/getPrefix.ts"],"sourcesContent":["import { internationalization, routing } from '@intlayer/config/built';\nimport {\n  DEFAULT_LOCALE,\n  LOCALES,\n  ROUTING_MODE,\n} from '@intlayer/config/defaultValues';\nimport type { RewriteRules, RoutingConfig } from '@intlayer/types/config';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n  ResolvedDefaultLocale,\n  ResolvedRoutingMode,\n} from '@intlayer/types/module_augmentation';\nimport { isLocaleExclusiveOnDomain } from './domainUtils';\n\n/**\n * Shared routing options used across all URL localization functions.\n */\nexport type RoutingOptions = {\n  locales?: LocalesValues[];\n  defaultLocale?: LocalesValues;\n  mode?: RoutingConfig['mode'];\n  rewrite?: RoutingConfig['rewrite'] | RewriteRules;\n  domains?: RoutingConfig['domains'];\n  /**\n   * The hostname of the page currently being rendered (e.g. `'intlayer.org'`).\n   * When provided, `getLocalizedUrl` returns a relative URL for locales whose\n   * configured domain matches `currentDomain`, and an absolute URL only when\n   * the target locale lives on a different domain.\n   *\n   * When omitted the function tries to infer it from:\n   *   1. The domain of an absolute input URL.\n   *   2. `window.location.hostname` in browser environments.\n   * Falls back to always generating absolute URLs when neither is available.\n   */\n  currentDomain?: string;\n};\n\n/**\n * Resolves routing configuration by merging provided options with configuration defaults.\n * Single source of truth for default routing config resolution across all localization functions.\n */\nexport const resolveRoutingConfig = (\n  options: RoutingOptions = {}\n): Omit<RoutingOptions, 'defaultLocale' | 'mode' | 'locales'> & {\n  defaultLocale: DeclaredLocales;\n  mode: RoutingConfig['mode'];\n  locales: DeclaredLocales[];\n} => ({\n  defaultLocale: internationalization?.defaultLocale ?? DEFAULT_LOCALE,\n  mode: routing?.mode ?? ROUTING_MODE,\n  locales: internationalization?.locales ?? LOCALES,\n  rewrite: routing?.rewrite,\n  domains: routing?.domains,\n  ...options,\n});\n\n/**\n * Narrows an arbitrary string to a declared locale by membership test.\n *\n * `locales` is typed as `DeclaredLocales[]`, so a plain `includes` rejects the\n * `string` values that actually need testing (a URL segment, a query param, a\n * stored value). This keeps the check honest and hands back a narrowed type\n * instead of forcing a cast at every call site.\n *\n * @param value - The candidate locale, from a URL segment / storage / header.\n * @param locales - The locales declared by the configuration.\n * @returns Whether `value` is one of the declared locales.\n */\nexport const isDeclaredLocale = (\n  value: LocalesValues | undefined | null,\n  locales?: readonly LocalesValues[]\n): value is DeclaredLocales =>\n  !!value && (locales ?? internationalization.locales).includes(value);\n\nexport type GetPrefixOptions = {\n  defaultLocale?: ResolvedDefaultLocale;\n  mode?: RoutingConfig['mode'];\n};\n\nexport type GetPrefixResult = {\n  /**\n   * The locale path segment appended to `/`, with a trailing slash (e.g. `'fr/'`).\n   * Empty string when no prefix is needed.\n   */\n  prefix: string;\n  /**\n   * The bare locale identifier (e.g. `'fr'`), or `undefined` when no prefix is applied.\n   */\n  localePrefix: DeclaredLocales | undefined;\n};\n\n/**\n * Narrowed return type for {@link getPrefix} that carries the locale literal through.\n *\n * Distributes over union locales — calling `getPrefix('fr')` in `prefix-no-default`\n * mode with `defaultLocale = 'en'` resolves to `{ prefix: 'fr/'; localePrefix: 'fr' }`.\n *\n * Note: domain-based routing and \"locale not in locales\" edge cases may return an\n * empty result at runtime regardless of what this type reports.\n */\nexport type GetPrefixResultNarrowed<\n  L extends LocalesValues | undefined,\n  Mode extends string = ResolvedRoutingMode,\n  Default extends LocalesValues = ResolvedDefaultLocale,\n> = L extends string\n  ? [string] extends [L] // L is wide (string / LocalesValues) → distribute over declared locales\n    ? GetPrefixResultNarrowed<DeclaredLocales, Mode, Default>\n    : [string] extends [Mode]\n      ? GetPrefixResult // mode is wide → fall back to generic result\n      : Mode extends 'prefix-all'\n        ? { prefix: `${L}/`; localePrefix: L }\n        : Mode extends 'prefix-no-default'\n          ? L extends Default\n            ? { prefix: ''; localePrefix: undefined }\n            : { prefix: `${L}/`; localePrefix: L }\n          : { prefix: ''; localePrefix: undefined } // no-prefix / search-params\n  : { prefix: ''; localePrefix: undefined }; // locale is undefined\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 = <const L extends LocalesValues | undefined>(\n  locale: L,\n  options: RoutingOptions = {}\n): GetPrefixResultNarrowed<L> => {\n  const { defaultLocale, mode, locales, domains } =\n    resolveRoutingConfig(options);\n\n  if (\n    (process.env.INTLAYER_ROUTING_MODE &&\n      process.env.INTLAYER_ROUTING_MODE !== 'prefix-all' &&\n      process.env.INTLAYER_ROUTING_MODE !== 'prefix-no-default') ||\n    !locale ||\n    !isDeclaredLocale(locale, locales)\n  ) {\n    return {\n      prefix: '',\n      localePrefix: undefined,\n    } as GetPrefixResultNarrowed<L>;\n  }\n\n  // If this locale is the only one assigned to its domain, no URL prefix is needed\n  // (the domain itself identifies the locale). Shared domains use normal prefix logic.\n  if (\n    process.env.INTLAYER_ROUTING_DOMAINS !== 'false' &&\n    isLocaleExclusiveOnDomain(locale as LocalesValues, domains)\n  ) {\n    return {\n      prefix: '',\n      localePrefix: undefined,\n    } as GetPrefixResultNarrowed<L>;\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 DeclaredLocales,\n    } as GetPrefixResultNarrowed<L>;\n  }\n\n  return {\n    prefix: '',\n    localePrefix: undefined,\n  } as GetPrefixResultNarrowed<L>;\n};\n"],"mappings":";;;;;;;;;;AA0CA,MAAa,wBACX,UAA0B,CAAC,OAKvB;CACJ,eAAeA,6CAAsB,iBAAiBC;CACtD,MAAMC,gCAAS,QAAQC;CACvB,SAASH,6CAAsB,WAAWI;CAC1C,SAASF,gCAAS;CAClB,SAASA,gCAAS;CAClB,GAAG;AACL;;;;;;;;;;;;;AAcA,MAAa,oBACX,OACA,YAEA,CAAC,CAAC,UAAU,WAAWF,4CAAqB,QAAO,CAAE,SAAS,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+ErE,MAAa,aACX,QACA,UAA0B,CAAC,MACI;CAC/B,MAAM,EAAE,eAAe,MAAM,SAAS,YACpC,qBAAqB,OAAO;CAE9B,IACG,QAAQ,IAAI,yBACX,QAAQ,IAAI,0BAA0B,gBACtC,QAAQ,IAAI,0BAA0B,uBACxC,CAAC,UACD,CAAC,iBAAiB,QAAQ,OAAO,GAEjC,OAAO;EACL,QAAQ;EACR,cAAc;CAChB;CAKF,IACE,QAAQ,IAAI,6BAA6B,WACzCK,2DAA0B,QAAyB,OAAO,GAE1D,OAAO;EACL,QAAQ;EACR,cAAc;CAChB;CAQF,IAHE,SAAS,gBACR,SAAS,uBAAuB,kBAAkB,QAGnD,OAAO;EACL,QAAQ,GAAG,OAAO;EAClB,cAAc;CAChB;CAGF,OAAO;EACL,QAAQ;EACR,cAAc;CAChB;AACF"}

package/dist/cjs/localization/index.cjs

@@ -4,6 +4,7 @@ const require_localization_comparePaths = require('./comparePaths.cjs');
 const require_localization_domainUtils = require('./domainUtils.cjs');
 const require_localization_getPrefix = require('./getPrefix.cjs');
 const require_localization_rewriteUtils = require('./rewriteUtils.cjs');
+const require_localization_getLocalizedPath = require('./getLocalizedPath.cjs');
 const require_localization_getLocalizedUrl = require('./getLocalizedUrl.cjs');
 const require_localization_getMultilingualUrls = require('./getMultilingualUrls.cjs');
 const require_localization_generateSitemap = require('./generateSitemap.cjs');
@@ -17,6 +18,7 @@ const require_localization_getLocaleLang = require('./getLocaleLang.cjs');
 const require_localization_getLocaleName = require('./getLocaleName.cjs');
 const require_localization_localeMapper = require('./localeMapper.cjs');
 const require_localization_proxyMode = require('./proxyMode.cjs');
+const require_localization_resolveBrowserLocale = require('./resolveBrowserLocale.cjs');
 const require_localization_validatePrefix = require('./validatePrefix.cjs');
 
 exports.comparePaths = require_localization_comparePaths.comparePaths;
@@ -34,13 +36,15 @@ exports.getLocaleFromDomain = require_localization_domainUtils.getLocaleFromDoma
 exports.getLocaleFromPath = require_localization_getLocaleFromPath.getLocaleFromPath;
 exports.getLocaleLang = require_localization_getLocaleLang.getLocaleLang;
 exports.getLocaleName = require_localization_getLocaleName.getLocaleName;
-exports.getLocalizedPath = require_localization_rewriteUtils.getLocalizedPath;
+exports.getLocalizedPath = require_localization_getLocalizedPath.getLocalizedPath;
 exports.getLocalizedUrl = require_localization_getLocalizedUrl.getLocalizedUrl;
 exports.getMultilingualUrls = require_localization_getMultilingualUrls.getMultilingualUrls;
 exports.getPathWithoutLocale = require_localization_getPathWithoutLocale.getPathWithoutLocale;
 exports.getPrefix = require_localization_getPrefix.getPrefix;
+exports.getPreloadLocale = require_localization_resolveBrowserLocale.getPreloadLocale;
 exports.getRewritePath = require_localization_rewriteUtils.getRewritePath;
 exports.getRewriteRules = require_localization_rewriteUtils.getRewriteRules;
+exports.isDeclaredLocale = require_localization_getPrefix.isDeclaredLocale;
 exports.isLocaleExclusiveOnDomain = require_localization_domainUtils.isLocaleExclusiveOnDomain;
 exports.isProxyStorageLocaleEnabled = require_localization_proxyMode.isProxyStorageLocaleEnabled;
 exports.localeDetector = require_localization_localeDetector.localeDetector;
@@ -49,5 +53,7 @@ exports.localeMap = require_localization_localeMapper.localeMap;
 exports.localeRecord = require_localization_localeMapper.localeRecord;
 exports.localeResolver = require_localization_localeResolver.localeResolver;
 exports.normalizePath = require_localization_comparePaths.normalizePath;
+exports.resolveBrowserLocale = require_localization_resolveBrowserLocale.resolveBrowserLocale;
+exports.resolveLocalizedPath = require_localization_rewriteUtils.resolveLocalizedPath;
 exports.resolveProxyMode = require_localization_proxyMode.resolveProxyMode;
 exports.validatePrefix = require_localization_validatePrefix.validatePrefix;

package/dist/cjs/localization/localeDetector.cjs

@@ -41,9 +41,11 @@ const parseAcceptLanguageHeader = (headerValue) => {
 	const rawTags = headerValue.split(",");
 	const preferences = [];
 	for (let index = 0; index < rawTags.length; index++) {
-		const tag = rawTags[index].trim();
-		const parsedLanguage = parseLanguageTag(tag, index);
-		if (parsedLanguage) preferences.push(parsedLanguage);
+		const tag = rawTags[index]?.trim();
+		if (tag) {
+			const parsedLanguage = parseLanguageTag(tag, index);
+			if (parsedLanguage) preferences.push(parsedLanguage);
+		}
 	}
 	return preferences;
 };

package/dist/cjs/localization/localeDetector.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"localeDetector.cjs","names":["localeResolver"],"sources":["../../../src/localization/localeDetector.ts"],"sourcesContent":["import type { Locale } from '@intlayer/types/allLocales';\nimport { localeResolver } from './localeResolver';\n\n/**\n * Constants\n */\nconst LANGUAGE_FORMAT_REGULAR_EXPRESSION =\n  /^\\s*([^\\s\\-;]+)(?:-([^\\s;]+))?\\s*(?:;(.*))?$/;\nconst DEFAULT_QUALITY_SCORE = 1;\n\n/**\n * Enumeration for specificity weights.\n * Higher values indicate a more precise match.\n */\nenum SpecificityWeight {\n  None = 0,\n  Broad = 1, // Matches prefix (e.g., 'en' matches 'en-US')\n  Prefix = 2, // Matches prefix in reverse (e.g., 'en-US' matches 'en')\n  Exact = 4, // Matches exact string (e.g., 'en-US' matches 'en-US')\n}\n\n/**\n * Represents a parsed language tag from the header.\n */\ntype LanguagePreference = {\n  languageCode: string;\n  regionCode?: string;\n  fullLocale: string;\n  qualityScore: number;\n  originalIndex: number;\n};\n\n/**\n * Represents the result of matching a requested language against an available language.\n */\ntype MatchResult = {\n  providedIndex: number;\n  headerIndex: number;\n  qualityScore: number;\n  specificityScore: number;\n};\n\n/**\n * Parses a single language tag string from the Accept-Language header.\n * Example input: \"en-US;q=0.8\"\n */\nconst parseLanguageTag = (\n  tagString: string,\n  index: number\n): LanguagePreference | null => {\n  const match = LANGUAGE_FORMAT_REGULAR_EXPRESSION.exec(tagString);\n  if (!match) {\n    return null;\n  }\n\n  const languageCode = match[1];\n  const regionCode = match[2];\n  const parameters = match[3];\n\n  // Construct the full locale string (e.g., \"en-US\" or \"en\")\n  const fullLocale = regionCode\n    ? `${languageCode}-${regionCode}`\n    : languageCode;\n\n  let qualityScore = DEFAULT_QUALITY_SCORE;\n\n  // Parse parameters to find the quality score (\"q\")\n  if (parameters) {\n    const parameterList = parameters.split(';');\n    for (const parameter of parameterList) {\n      const [key, value] = parameter.split('=');\n      if (key === 'q') {\n        qualityScore = parseFloat(value);\n      }\n    }\n  }\n\n  return {\n    languageCode,\n    regionCode,\n    qualityScore,\n    originalIndex: index,\n    fullLocale,\n  };\n};\n\n/**\n * Parses the entire Accept-Language header string into a list of preferences.\n */\nconst parseAcceptLanguageHeader = (\n  headerValue: string\n): LanguagePreference[] => {\n  const rawTags = headerValue.split(',');\n  const preferences: LanguagePreference[] = [];\n\n  for (let index = 0; index < rawTags.length; index++) {\n    const tag = rawTags[index].trim();\n    const parsedLanguage = parseLanguageTag(tag, index);\n\n    if (parsedLanguage) {\n      preferences.push(parsedLanguage);\n    }\n  }\n\n  return preferences;\n};\n\n/**\n * Calculates the specificity of a match between a provided language and a requested preference.\n */\nconst calculateMatchSpecificity = (\n  providedLanguage: string,\n  preference: LanguagePreference,\n  providedIndex: number\n): MatchResult | null => {\n  const parsedProvided = parseLanguageTag(providedLanguage, providedIndex);\n  if (!parsedProvided) {\n    return null;\n  }\n\n  let specificityScore = SpecificityWeight.None;\n\n  const preferenceFullLower = preference.fullLocale.toLowerCase();\n  const preferencePrefixLower = preference.languageCode.toLowerCase();\n  const providedFullLower = parsedProvided.fullLocale.toLowerCase();\n  const providedPrefixLower = parsedProvided.languageCode.toLowerCase();\n\n  if (preferenceFullLower === providedFullLower) {\n    specificityScore |= SpecificityWeight.Exact;\n  } else if (preferencePrefixLower === providedFullLower) {\n    specificityScore |= SpecificityWeight.Prefix;\n  } else if (preferenceFullLower === providedPrefixLower) {\n    specificityScore |= SpecificityWeight.Broad;\n  } else if (preference.fullLocale !== '*') {\n    return null;\n  }\n\n  return {\n    providedIndex,\n    headerIndex: preference.originalIndex,\n    qualityScore: preference.qualityScore,\n    specificityScore,\n  };\n};\n\n/**\n * Determines the best match for a specific available language against the list of user accepted languages.\n */\nconst getBestMatchForLanguage = (\n  providedLanguage: string,\n  acceptedPreferences: LanguagePreference[],\n  providedIndex: number\n): MatchResult => {\n  // Initialize with a non-match priority\n  let bestMatch: MatchResult = {\n    headerIndex: -1,\n    qualityScore: 0,\n    specificityScore: 0,\n    providedIndex,\n  };\n\n  for (const preference of acceptedPreferences) {\n    const matchSpec = calculateMatchSpecificity(\n      providedLanguage,\n      preference,\n      providedIndex\n    );\n\n    if (matchSpec) {\n      // Compare current best match with new match\n      const scoreDifference =\n        bestMatch.specificityScore - matchSpec.specificityScore ||\n        bestMatch.qualityScore - matchSpec.qualityScore ||\n        bestMatch.headerIndex - matchSpec.headerIndex;\n\n      // If the new match is better (difference < 0), update priority\n      if (scoreDifference < 0) {\n        bestMatch = matchSpec;\n      }\n    }\n  }\n\n  return bestMatch;\n};\n\n/**\n * Comparator function to sort language matches.\n * Sorting order:\n * 1. Quality Score (Descending)\n * 2. Specificity Score (Descending)\n * 3. Order in Header (Ascending - lower index is better)\n * 4. Order in Provided List (Ascending)\n */\nconst compareMatchResults = (a: MatchResult, b: MatchResult): number => {\n  return (\n    b.qualityScore - a.qualityScore ||\n    b.specificityScore - a.specificityScore ||\n    a.headerIndex - b.headerIndex ||\n    a.providedIndex - b.providedIndex ||\n    0\n  );\n};\n\n/**\n * Derives the list of preferred languages based on the Accept-Language header\n * and an optional list of available languages.\n */\nexport const getPreferredLanguages = (\n  acceptHeader: string | undefined,\n  availableLanguages?: string[]\n): string[] => {\n  // RFC 2616 sec 14.4: no header implies '*'\n  const headerValue = acceptHeader === undefined ? '*' : acceptHeader || '';\n  const acceptedPreferences = parseAcceptLanguageHeader(headerValue);\n\n  // If no specific languages are provided to filter against, return the header languages sorted by quality\n  if (!availableLanguages) {\n    return acceptedPreferences\n      .filter((preference) => preference.qualityScore > 0)\n      .sort((a, b) => b.qualityScore - a.qualityScore) // Simple sort by quality\n      .map((preference) => preference.fullLocale);\n  }\n\n  // Map available languages to their match priority against the header\n  const matchResults = availableLanguages.map((language, index) =>\n    getBestMatchForLanguage(language, acceptedPreferences, index)\n  );\n\n  return matchResults\n    .filter((result) => result.qualityScore > 0)\n    .sort(compareMatchResults)\n    .map((result) => availableLanguages[result.providedIndex]);\n};\n\n/**\n * Detects the locale from the request headers.\n *\n * Headers are provided by the browser/client and can be used to determine the user's preferred language.\n * This function intersects the user's `Accept-Language` header with the application's available locales.\n */\nexport const localeDetector = (\n  headers: Record<string, string | undefined>,\n  availableLocales?: Locale[],\n  defaultLocale?: Locale\n): Locale => {\n  const acceptLanguageHeader = headers['accept-language'];\n\n  const preferredLocaleStrings = getPreferredLanguages(\n    acceptLanguageHeader,\n    availableLocales as string[]\n  );\n\n  return localeResolver(\n    preferredLocaleStrings as Locale[],\n    availableLocales,\n    defaultLocale\n  );\n};\n"],"mappings":";;;;;;;AAMA,MAAM,qCACJ;AACF,MAAM,wBAAwB;;;;;AAsC9B,MAAM,oBACJ,WACA,UAC8B;CAC9B,MAAM,QAAQ,mCAAmC,KAAK,SAAS;CAC/D,IAAI,CAAC,OACH,OAAO;CAGT,MAAM,eAAe,MAAM;CAC3B,MAAM,aAAa,MAAM;CACzB,MAAM,aAAa,MAAM;CAGzB,MAAM,aAAa,aACf,GAAG,aAAa,GAAG,eACnB;CAEJ,IAAI,eAAe;CAGnB,IAAI,YAAY;EACd,MAAM,gBAAgB,WAAW,MAAM,GAAG;EAC1C,KAAK,MAAM,aAAa,eAAe;GACrC,MAAM,CAAC,KAAK,SAAS,UAAU,MAAM,GAAG;GACxC,IAAI,QAAQ,KACV,eAAe,WAAW,KAAK;EAEnC;CACF;CAEA,OAAO;EACL;EACA;EACA;EACA,eAAe;EACf;CACF;AACF;;;;AAKA,MAAM,6BACJ,gBACyB;CACzB,MAAM,UAAU,YAAY,MAAM,GAAG;CACrC,MAAM,cAAoC,CAAC;CAE3C,KAAK,IAAI,QAAQ,GAAG,QAAQ,QAAQ,QAAQ,SAAS;EACnD,MAAM,MAAM,QAAQ,MAAM,CAAC,KAAK;EAChC,MAAM,iBAAiB,iBAAiB,KAAK,KAAK;EAElD,IAAI,gBACF,YAAY,KAAK,cAAc;CAEnC;CAEA,OAAO;AACT;;;;AAKA,MAAM,6BACJ,kBACA,YACA,kBACuB;CACvB,MAAM,iBAAiB,iBAAiB,kBAAkB,aAAa;CACvE,IAAI,CAAC,gBACH,OAAO;CAGT,IAAI;CAEJ,MAAM,sBAAsB,WAAW,WAAW,YAAY;CAC9D,MAAM,wBAAwB,WAAW,aAAa,YAAY;CAClE,MAAM,oBAAoB,eAAe,WAAW,YAAY;CAChE,MAAM,sBAAsB,eAAe,aAAa,YAAY;CAEpE,IAAI,wBAAwB,mBAC1B;MACK,IAAI,0BAA0B,mBACnC;MACK,IAAI,wBAAwB,qBACjC;MACK,IAAI,WAAW,eAAe,KACnC,OAAO;CAGT,OAAO;EACL;EACA,aAAa,WAAW;EACxB,cAAc,WAAW;EACzB;CACF;AACF;;;;AAKA,MAAM,2BACJ,kBACA,qBACA,kBACgB;CAEhB,IAAI,YAAyB;EAC3B,aAAa;EACb,cAAc;EACd,kBAAkB;EAClB;CACF;CAEA,KAAK,MAAM,cAAc,qBAAqB;EAC5C,MAAM,YAAY,0BAChB,kBACA,YACA,aACF;EAEA,IAAI,WAQF;QALE,UAAU,mBAAmB,UAAU,oBACvC,UAAU,eAAe,UAAU,gBACnC,UAAU,cAAc,UAAU,eAGd,GACpB,YAAY;EACd;CAEJ;CAEA,OAAO;AACT;;;;;;;;;AAUA,MAAM,uBAAuB,GAAgB,MAA2B;CACtE,OACE,EAAE,eAAe,EAAE,gBACnB,EAAE,mBAAmB,EAAE,oBACvB,EAAE,cAAc,EAAE,eAClB,EAAE,gBAAgB,EAAE,iBACpB;AAEJ;;;;;AAMA,MAAa,yBACX,cACA,uBACa;CAGb,MAAM,sBAAsB,0BADR,iBAAiB,SAAY,MAAM,gBAAgB,EACN;CAGjE,IAAI,CAAC,oBACH,OAAO,oBACJ,QAAQ,eAAe,WAAW,eAAe,CAAC,CAAC,CACnD,MAAM,GAAG,MAAM,EAAE,eAAe,EAAE,YAAY,CAAC,CAC/C,KAAK,eAAe,WAAW,UAAU;CAQ9C,OAJqB,mBAAmB,KAAK,UAAU,UACrD,wBAAwB,UAAU,qBAAqB,KAAK,CAG5C,CAAC,CAChB,QAAQ,WAAW,OAAO,eAAe,CAAC,CAAC,CAC3C,KAAK,mBAAmB,CAAC,CACzB,KAAK,WAAW,mBAAmB,OAAO,cAAc;AAC7D;;;;;;;AAQA,MAAa,kBACX,SACA,kBACA,kBACW;CACX,MAAM,uBAAuB,QAAQ;CAErC,MAAM,yBAAyB,sBAC7B,sBACA,gBACF;CAEA,OAAOA,mDACL,wBACA,kBACA,aACF;AACF"}
+{"version":3,"file":"localeDetector.cjs","names":["localeResolver"],"sources":["../../../src/localization/localeDetector.ts"],"sourcesContent":["import type { Locale } from '@intlayer/types/allLocales';\nimport type { DeclaredLocales } from '@intlayer/types/module_augmentation';\nimport { localeResolver } from './localeResolver';\n\n/**\n * Constants\n */\nconst LANGUAGE_FORMAT_REGULAR_EXPRESSION =\n  /^\\s*([^\\s\\-;]+)(?:-([^\\s;]+))?\\s*(?:;(.*))?$/;\nconst DEFAULT_QUALITY_SCORE = 1;\n\n/**\n * Enumeration for specificity weights.\n * Higher values indicate a more precise match.\n */\nenum SpecificityWeight {\n  None = 0,\n  Broad = 1, // Matches prefix (e.g., 'en' matches 'en-US')\n  Prefix = 2, // Matches prefix in reverse (e.g., 'en-US' matches 'en')\n  Exact = 4, // Matches exact string (e.g., 'en-US' matches 'en-US')\n}\n\n/**\n * Represents a parsed language tag from the header.\n */\ntype LanguagePreference = {\n  languageCode: string;\n  regionCode?: string;\n  fullLocale: string;\n  qualityScore: number;\n  originalIndex: number;\n};\n\n/**\n * Represents the result of matching a requested language against an available language.\n */\ntype MatchResult = {\n  providedIndex: number;\n  headerIndex: number;\n  qualityScore: number;\n  specificityScore: number;\n};\n\n/**\n * Parses a single language tag string from the Accept-Language header.\n * Example input: \"en-US;q=0.8\"\n */\nconst parseLanguageTag = (\n  tagString: string,\n  index: number\n): LanguagePreference | null => {\n  const match = LANGUAGE_FORMAT_REGULAR_EXPRESSION.exec(tagString);\n  if (!match) {\n    return null;\n  }\n\n  const languageCode = match[1] as string;\n  const regionCode = match[2];\n  const parameters = match[3];\n\n  // Construct the full locale string (e.g., \"en-US\" or \"en\")\n  const fullLocale = regionCode\n    ? `${languageCode}-${regionCode}`\n    : languageCode;\n\n  let qualityScore = DEFAULT_QUALITY_SCORE;\n\n  // Parse parameters to find the quality score (\"q\")\n  if (parameters) {\n    const parameterList = parameters.split(';');\n\n    for (const parameter of parameterList) {\n      const [key, value] = parameter.split('=');\n\n      if (key === 'q') {\n        qualityScore = parseFloat(value as string);\n      }\n    }\n  }\n\n  return {\n    languageCode,\n    regionCode,\n    qualityScore,\n    originalIndex: index,\n    fullLocale,\n  };\n};\n\n/**\n * Parses the entire Accept-Language header string into a list of preferences.\n */\nconst parseAcceptLanguageHeader = (\n  headerValue: string\n): LanguagePreference[] => {\n  const rawTags = headerValue.split(',');\n  const preferences: LanguagePreference[] = [];\n\n  for (let index = 0; index < rawTags.length; index++) {\n    const tag = rawTags[index]?.trim();\n\n    if (tag) {\n      const parsedLanguage = parseLanguageTag(tag, index);\n\n      if (parsedLanguage) {\n        preferences.push(parsedLanguage);\n      }\n    }\n  }\n\n  return preferences;\n};\n\n/**\n * Calculates the specificity of a match between a provided language and a requested preference.\n */\nconst calculateMatchSpecificity = (\n  providedLanguage: string,\n  preference: LanguagePreference,\n  providedIndex: number\n): MatchResult | null => {\n  const parsedProvided = parseLanguageTag(providedLanguage, providedIndex);\n  if (!parsedProvided) {\n    return null;\n  }\n\n  let specificityScore = SpecificityWeight.None;\n\n  const preferenceFullLower = preference.fullLocale.toLowerCase();\n  const preferencePrefixLower = preference.languageCode.toLowerCase();\n  const providedFullLower = parsedProvided.fullLocale.toLowerCase();\n  const providedPrefixLower = parsedProvided.languageCode.toLowerCase();\n\n  if (preferenceFullLower === providedFullLower) {\n    specificityScore |= SpecificityWeight.Exact;\n  } else if (preferencePrefixLower === providedFullLower) {\n    specificityScore |= SpecificityWeight.Prefix;\n  } else if (preferenceFullLower === providedPrefixLower) {\n    specificityScore |= SpecificityWeight.Broad;\n  } else if (preference.fullLocale !== '*') {\n    return null;\n  }\n\n  return {\n    providedIndex,\n    headerIndex: preference.originalIndex,\n    qualityScore: preference.qualityScore,\n    specificityScore,\n  };\n};\n\n/**\n * Determines the best match for a specific available language against the list of user accepted languages.\n */\nconst getBestMatchForLanguage = (\n  providedLanguage: string,\n  acceptedPreferences: LanguagePreference[],\n  providedIndex: number\n): MatchResult => {\n  // Initialize with a non-match priority\n  let bestMatch: MatchResult = {\n    headerIndex: -1,\n    qualityScore: 0,\n    specificityScore: 0,\n    providedIndex,\n  };\n\n  for (const preference of acceptedPreferences) {\n    const matchSpec = calculateMatchSpecificity(\n      providedLanguage,\n      preference,\n      providedIndex\n    );\n\n    if (matchSpec) {\n      // Compare current best match with new match\n      const scoreDifference =\n        bestMatch.specificityScore - matchSpec.specificityScore ||\n        bestMatch.qualityScore - matchSpec.qualityScore ||\n        bestMatch.headerIndex - matchSpec.headerIndex;\n\n      // If the new match is better (difference < 0), update priority\n      if (scoreDifference < 0) {\n        bestMatch = matchSpec;\n      }\n    }\n  }\n\n  return bestMatch;\n};\n\n/**\n * Comparator function to sort language matches.\n * Sorting order:\n * 1. Quality Score (Descending)\n * 2. Specificity Score (Descending)\n * 3. Order in Header (Ascending - lower index is better)\n * 4. Order in Provided List (Ascending)\n */\nconst compareMatchResults = (a: MatchResult, b: MatchResult): number => {\n  return (\n    b.qualityScore - a.qualityScore ||\n    b.specificityScore - a.specificityScore ||\n    a.headerIndex - b.headerIndex ||\n    a.providedIndex - b.providedIndex ||\n    0\n  );\n};\n\n/**\n * Derives the list of preferred languages based on the Accept-Language header\n * and an optional list of available languages.\n */\nexport const getPreferredLanguages = (\n  acceptHeader: string | undefined,\n  availableLanguages?: string[]\n): string[] => {\n  // RFC 2616 sec 14.4: no header implies '*'\n  const headerValue = acceptHeader === undefined ? '*' : acceptHeader || '';\n  const acceptedPreferences = parseAcceptLanguageHeader(headerValue);\n\n  // If no specific languages are provided to filter against, return the header languages sorted by quality\n  if (!availableLanguages) {\n    return acceptedPreferences\n      .filter((preference) => preference.qualityScore > 0)\n      .sort((a, b) => b.qualityScore - a.qualityScore) // Simple sort by quality\n      .map((preference) => preference.fullLocale);\n  }\n\n  // Map available languages to their match priority against the header\n  const matchResults = availableLanguages.map((language, index) =>\n    getBestMatchForLanguage(language, acceptedPreferences, index)\n  );\n\n  return matchResults\n    .filter((result) => result.qualityScore > 0)\n    .sort(compareMatchResults)\n    .map((result) => availableLanguages[result.providedIndex]) as string[];\n};\n\n/**\n * Detects the locale from the request headers.\n *\n * Headers are provided by the browser/client and can be used to determine the user's preferred language.\n * This function intersects the user's `Accept-Language` header with the application's available locales.\n */\nexport const localeDetector = (\n  headers: Record<string, string | undefined>,\n  availableLocales?: Locale[],\n  defaultLocale?: Locale\n): DeclaredLocales => {\n  const acceptLanguageHeader = headers['accept-language'];\n\n  const preferredLocaleStrings = getPreferredLanguages(\n    acceptLanguageHeader,\n    availableLocales as string[]\n  );\n\n  return localeResolver(\n    preferredLocaleStrings as Locale[],\n    availableLocales,\n    defaultLocale\n  );\n};\n"],"mappings":";;;;;;;AAOA,MAAM,qCACJ;AACF,MAAM,wBAAwB;;;;;AAsC9B,MAAM,oBACJ,WACA,UAC8B;CAC9B,MAAM,QAAQ,mCAAmC,KAAK,SAAS;CAC/D,IAAI,CAAC,OACH,OAAO;CAGT,MAAM,eAAe,MAAM;CAC3B,MAAM,aAAa,MAAM;CACzB,MAAM,aAAa,MAAM;CAGzB,MAAM,aAAa,aACf,GAAG,aAAa,GAAG,eACnB;CAEJ,IAAI,eAAe;CAGnB,IAAI,YAAY;EACd,MAAM,gBAAgB,WAAW,MAAM,GAAG;EAE1C,KAAK,MAAM,aAAa,eAAe;GACrC,MAAM,CAAC,KAAK,SAAS,UAAU,MAAM,GAAG;GAExC,IAAI,QAAQ,KACV,eAAe,WAAW,KAAe;EAE7C;CACF;CAEA,OAAO;EACL;EACA;EACA;EACA,eAAe;EACf;CACF;AACF;;;;AAKA,MAAM,6BACJ,gBACyB;CACzB,MAAM,UAAU,YAAY,MAAM,GAAG;CACrC,MAAM,cAAoC,CAAC;CAE3C,KAAK,IAAI,QAAQ,GAAG,QAAQ,QAAQ,QAAQ,SAAS;EACnD,MAAM,MAAM,QAAQ,MAAM,EAAE,KAAK;EAEjC,IAAI,KAAK;GACP,MAAM,iBAAiB,iBAAiB,KAAK,KAAK;GAElD,IAAI,gBACF,YAAY,KAAK,cAAc;EAEnC;CACF;CAEA,OAAO;AACT;;;;AAKA,MAAM,6BACJ,kBACA,YACA,kBACuB;CACvB,MAAM,iBAAiB,iBAAiB,kBAAkB,aAAa;CACvE,IAAI,CAAC,gBACH,OAAO;CAGT,IAAI;CAEJ,MAAM,sBAAsB,WAAW,WAAW,YAAY;CAC9D,MAAM,wBAAwB,WAAW,aAAa,YAAY;CAClE,MAAM,oBAAoB,eAAe,WAAW,YAAY;CAChE,MAAM,sBAAsB,eAAe,aAAa,YAAY;CAEpE,IAAI,wBAAwB,mBAC1B;MACK,IAAI,0BAA0B,mBACnC;MACK,IAAI,wBAAwB,qBACjC;MACK,IAAI,WAAW,eAAe,KACnC,OAAO;CAGT,OAAO;EACL;EACA,aAAa,WAAW;EACxB,cAAc,WAAW;EACzB;CACF;AACF;;;;AAKA,MAAM,2BACJ,kBACA,qBACA,kBACgB;CAEhB,IAAI,YAAyB;EAC3B,aAAa;EACb,cAAc;EACd,kBAAkB;EAClB;CACF;CAEA,KAAK,MAAM,cAAc,qBAAqB;EAC5C,MAAM,YAAY,0BAChB,kBACA,YACA,aACF;EAEA,IAAI,WAQF;QALE,UAAU,mBAAmB,UAAU,oBACvC,UAAU,eAAe,UAAU,gBACnC,UAAU,cAAc,UAAU,eAGd,GACpB,YAAY;EACd;CAEJ;CAEA,OAAO;AACT;;;;;;;;;AAUA,MAAM,uBAAuB,GAAgB,MAA2B;CACtE,OACE,EAAE,eAAe,EAAE,gBACnB,EAAE,mBAAmB,EAAE,oBACvB,EAAE,cAAc,EAAE,eAClB,EAAE,gBAAgB,EAAE,iBACpB;AAEJ;;;;;AAMA,MAAa,yBACX,cACA,uBACa;CAGb,MAAM,sBAAsB,0BADR,iBAAiB,SAAY,MAAM,gBAAgB,EACN;CAGjE,IAAI,CAAC,oBACH,OAAO,oBACJ,QAAQ,eAAe,WAAW,eAAe,CAAC,CAAC,CACnD,MAAM,GAAG,MAAM,EAAE,eAAe,EAAE,YAAY,CAAC,CAC/C,KAAK,eAAe,WAAW,UAAU;CAQ9C,OAJqB,mBAAmB,KAAK,UAAU,UACrD,wBAAwB,UAAU,qBAAqB,KAAK,CAG5C,CAAC,CAChB,QAAQ,WAAW,OAAO,eAAe,CAAC,CAAC,CAC3C,KAAK,mBAAmB,CAAC,CACzB,KAAK,WAAW,mBAAmB,OAAO,cAAc;AAC7D;;;;;;;AAQA,MAAa,kBACX,SACA,kBACA,kBACoB;CACpB,MAAM,uBAAuB,QAAQ;CAErC,MAAM,yBAAyB,sBAC7B,sBACA,gBACF;CAEA,OAAOA,mDACL,wBACA,kBACA,aACF;AACF"}

package/dist/cjs/localization/localeMapper.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"localeMapper.cjs","names":["internationalization","DEFAULT_LOCALE","routing","getPrefix"],"sources":["../../../src/localization/localeMapper.ts"],"sourcesContent":["import { internationalization, routing } from '@intlayer/config/built';\nimport { DEFAULT_LOCALE } from '@intlayer/config/defaultValues';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { getPrefix } from './getPrefix';\n\nexport type LocaleData = {\n  locale: Locale;\n  defaultLocale: Locale;\n  isDefault: boolean;\n  locales: Locale[];\n  urlPrefix: string;\n};\n\n/**\n * Map the locale data to an array of objects\n *\n * @example\n * ```ts\n * const routes = localeMap((localizedData) =>\n * ({\n *    path: localizedData.urlPrefix,\n *    name: localizedData.locale,\n *    isDefault: localizedData.isDefault,\n *    locales: localizedData.locales,\n *    defaultLocale: localizedData.defaultLocale,\n *  }),\n * );\n *\n * // Result\n * [\n *   { path: '/', name: 'en', isDefault: true, locales: ['en'], defaultLocale: 'en', urlPrefix: '' },\n *   { path: '/fr', name: 'fr', isDefault: false, locales: ['fr'], defaultLocale: 'en', urlPrefix: '/fr' },\n *   { path: '/es', name: 'es', isDefault: false, locales: ['es'], defaultLocale: 'en', urlPrefix: '/es' },\n * ]\n * ```\n *\n * @param mapper - The mapper function that returns an object\n * @returns An array of objects\n */\nexport const localeMap = <T>(\n  mapper: (locale: LocaleData) => T,\n  locales: LocalesValues[] = internationalization.locales ?? [],\n  defaultLocale: LocalesValues = internationalization.defaultLocale ??\n    DEFAULT_LOCALE,\n  mode:\n    | 'prefix-no-default'\n    | 'prefix-all'\n    | 'no-prefix'\n    | 'search-params' = routing?.mode ?? 'prefix-no-default'\n): T[] =>\n  (locales ?? []).map((locale) =>\n    mapper({\n      locale,\n      defaultLocale,\n      locales,\n      isDefault: locale === defaultLocale,\n      urlPrefix: getPrefix(locale, { defaultLocale, mode, locales })\n        .localePrefix\n        ? `/${locale}`\n        : '',\n    } as LocaleData)\n  );\n\n/**\n * Flatten the locale map into a single array of objects\n *\n * @example\n * ```ts\n * const routes = localeMap((localizedData) =>\n * [{\n *    path: localizedData.urlPrefix,\n *    name: localizedData.locale,\n *    isDefault: localizedData.isDefault,\n *    locales: localizedData.locales,\n *    defaultLocale: localizedData.defaultLocale,\n *  }],\n * );\n *\n * // Result\n * [\n *   path: '/', name: 'en', isDefault: true, locales: ['en'], defaultLocale: 'en', urlPrefix: '' ,\n *   path: '/fr', name: 'fr', isDefault: false, locales: ['fr'], defaultLocale: 'en', urlPrefix: '/fr' ,\n *   path: '/es', name: 'es', isDefault: false, locales: ['es'], defaultLocale: 'en', urlPrefix: '/es' ,\n * ]\n * ```\n *\n * @param mapper - The mapper function that returns an array of objects\n * @returns An array of objects\n */\nexport const localeFlatMap = <T>(\n  mapper: (locale: LocaleData) => T[],\n  locales: LocalesValues[] = internationalization.locales ?? [],\n  defaultLocale: LocalesValues = internationalization.defaultLocale ??\n    DEFAULT_LOCALE,\n  mode:\n    | 'prefix-no-default'\n    | 'prefix-all'\n    | 'no-prefix'\n    | 'search-params' = routing?.mode ?? 'prefix-no-default'\n): T[] =>\n  locales.flatMap((locale) =>\n    mapper({\n      locale,\n      defaultLocale,\n      locales,\n      isDefault: locale === defaultLocale,\n      urlPrefix: getPrefix(locale, { defaultLocale, mode, locales })\n        .localePrefix\n        ? `/${locale}`\n        : '',\n    } as LocaleData)\n  );\n\n/**\n * Creates a record object mapping locales to values transformed by the mapper function\n *\n * @example\n * ```ts\n * const translations = localeRecord(({ locale }) =>\n *   require(`./translations/${locale}.json`)\n * );\n *\n * // Result\n *\n *   en: ... , // Content of translations/en.json\n *   fr: ... , // Content of translations/fr.json\n *   es: ...\n *\n * ```\n *\n * @param mapper - Function that takes locale data and returns a value for that locale\n * @param locales - Array of locale codes to map over (defaults to configured locales)\n * @param defaultLocale - The default locale (defaults to configured default)\n * @param mode - URL routing mode for locale handling (defaults to configured value)\n * @returns Record mapping locale codes to mapped values\n */\nexport const localeRecord = <T>(\n  mapper: (locale: LocaleData) => T,\n  locales: LocalesValues[] = internationalization.locales ?? [],\n  defaultLocale: LocalesValues = internationalization.defaultLocale ??\n    DEFAULT_LOCALE,\n  mode:\n    | 'prefix-no-default'\n    | 'prefix-all'\n    | 'no-prefix'\n    | 'search-params' = routing?.mode ?? 'prefix-no-default'\n): Record<LocalesValues, T> =>\n  (locales ?? []).reduce(\n    (acc, locale) => {\n      acc[locale] = mapper({\n        locale,\n        defaultLocale,\n        locales,\n        isDefault: locale === defaultLocale,\n        urlPrefix: getPrefix(locale, { defaultLocale, mode, locales })\n          .localePrefix\n          ? `/${locale}`\n          : '',\n      } as LocaleData);\n      return acc;\n    },\n    {} as Record<LocalesValues, T>\n  );\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCA,MAAa,aACX,QACA,UAA2BA,4CAAqB,WAAW,CAAC,GAC5D,gBAA+BA,4CAAqB,iBAClDC,+CACF,OAIsBC,gCAAS,QAAQ,yBAEtC,WAAW,CAAC,EAAC,CAAE,KAAK,WACnB,OAAO;CACL;CACA;CACA;CACA,WAAW,WAAW;CACtB,WAAWC,yCAAU,QAAQ;EAAE;EAAe;EAAM;CAAQ,CAAC,CAAC,CAC3D,eACC,IAAI,WACJ;AACN,CAAe,CACjB;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BF,MAAa,iBACX,QACA,UAA2BH,4CAAqB,WAAW,CAAC,GAC5D,gBAA+BA,4CAAqB,iBAClDC,+CACF,OAIsBC,gCAAS,QAAQ,wBAEvC,QAAQ,SAAS,WACf,OAAO;CACL;CACA;CACA;CACA,WAAW,WAAW;CACtB,WAAWC,yCAAU,QAAQ;EAAE;EAAe;EAAM;CAAQ,CAAC,CAAC,CAC3D,eACC,IAAI,WACJ;AACN,CAAe,CACjB;;;;;;;;;;;;;;;;;;;;;;;;AAyBF,MAAa,gBACX,QACA,UAA2BH,4CAAqB,WAAW,CAAC,GAC5D,gBAA+BA,4CAAqB,iBAClDC,+CACF,OAIsBC,gCAAS,QAAQ,yBAEtC,WAAW,CAAC,EAAC,CAAE,QACb,KAAK,WAAW;CACf,IAAI,UAAU,OAAO;EACnB;EACA;EACA;EACA,WAAW,WAAW;EACtB,WAAWC,yCAAU,QAAQ;GAAE;GAAe;GAAM;EAAQ,CAAC,CAAC,CAC3D,eACC,IAAI,WACJ;CACN,CAAe;CACf,OAAO;AACT,GACA,CAAC,CACH"}
+{"version":3,"file":"localeMapper.cjs","names":["internationalization","DEFAULT_LOCALE","routing","getPrefix"],"sources":["../../../src/localization/localeMapper.ts"],"sourcesContent":["import { internationalization, routing } from '@intlayer/config/built';\nimport { DEFAULT_LOCALE } from '@intlayer/config/defaultValues';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { getPrefix } from './getPrefix';\n\nexport type LocaleData = {\n  locale: DeclaredLocales;\n  defaultLocale: DeclaredLocales;\n  isDefault: boolean;\n  locales: DeclaredLocales[];\n  urlPrefix: string;\n};\n\n/**\n * Map the locale data to an array of objects\n *\n * @example\n * ```ts\n * const routes = localeMap((localizedData) =>\n * ({\n *    path: localizedData.urlPrefix,\n *    name: localizedData.locale,\n *    isDefault: localizedData.isDefault,\n *    locales: localizedData.locales,\n *    defaultLocale: localizedData.defaultLocale,\n *  }),\n * );\n *\n * // Result\n * [\n *   { path: '/', name: 'en', isDefault: true, locales: ['en'], defaultLocale: 'en', urlPrefix: '' },\n *   { path: '/fr', name: 'fr', isDefault: false, locales: ['fr'], defaultLocale: 'en', urlPrefix: '/fr' },\n *   { path: '/es', name: 'es', isDefault: false, locales: ['es'], defaultLocale: 'en', urlPrefix: '/es' },\n * ]\n * ```\n *\n * @param mapper - The mapper function that returns an object\n * @returns An array of objects\n */\nexport const localeMap = <T>(\n  mapper: (locale: LocaleData) => T,\n  locales: LocalesValues[] = internationalization.locales ?? [],\n  defaultLocale: LocalesValues = internationalization.defaultLocale ??\n    DEFAULT_LOCALE,\n  mode:\n    | 'prefix-no-default'\n    | 'prefix-all'\n    | 'no-prefix'\n    | 'search-params' = routing?.mode ?? 'prefix-no-default'\n): T[] =>\n  (locales ?? []).map((locale) =>\n    mapper({\n      locale,\n      defaultLocale,\n      locales,\n      isDefault: locale === defaultLocale,\n      urlPrefix: getPrefix(locale, { defaultLocale, mode, locales })\n        .localePrefix\n        ? `/${locale}`\n        : '',\n    } as LocaleData)\n  );\n\n/**\n * Flatten the locale map into a single array of objects\n *\n * @example\n * ```ts\n * const routes = localeMap((localizedData) =>\n * [{\n *    path: localizedData.urlPrefix,\n *    name: localizedData.locale,\n *    isDefault: localizedData.isDefault,\n *    locales: localizedData.locales,\n *    defaultLocale: localizedData.defaultLocale,\n *  }],\n * );\n *\n * // Result\n * [\n *   path: '/', name: 'en', isDefault: true, locales: ['en'], defaultLocale: 'en', urlPrefix: '' ,\n *   path: '/fr', name: 'fr', isDefault: false, locales: ['fr'], defaultLocale: 'en', urlPrefix: '/fr' ,\n *   path: '/es', name: 'es', isDefault: false, locales: ['es'], defaultLocale: 'en', urlPrefix: '/es' ,\n * ]\n * ```\n *\n * @param mapper - The mapper function that returns an array of objects\n * @returns An array of objects\n */\nexport const localeFlatMap = <T>(\n  mapper: (locale: LocaleData) => T[],\n  locales: LocalesValues[] = internationalization.locales ?? [],\n  defaultLocale: LocalesValues = internationalization.defaultLocale ??\n    DEFAULT_LOCALE,\n  mode:\n    | 'prefix-no-default'\n    | 'prefix-all'\n    | 'no-prefix'\n    | 'search-params' = routing?.mode ?? 'prefix-no-default'\n): T[] =>\n  locales.flatMap((locale) =>\n    mapper({\n      locale,\n      defaultLocale,\n      locales,\n      isDefault: locale === defaultLocale,\n      urlPrefix: getPrefix(locale, { defaultLocale, mode, locales })\n        .localePrefix\n        ? `/${locale}`\n        : '',\n    } as LocaleData)\n  );\n\n/**\n * Creates a record object mapping locales to values transformed by the mapper function\n *\n * @example\n * ```ts\n * const translations = localeRecord(({ locale }) =>\n *   require(`./translations/${locale}.json`)\n * );\n *\n * // Result\n *\n *   en: ... , // Content of translations/en.json\n *   fr: ... , // Content of translations/fr.json\n *   es: ...\n *\n * ```\n *\n * @param mapper - Function that takes locale data and returns a value for that locale\n * @param locales - Array of locale codes to map over (defaults to configured locales)\n * @param defaultLocale - The default locale (defaults to configured default)\n * @param mode - URL routing mode for locale handling (defaults to configured value)\n * @returns Record mapping locale codes to mapped values\n */\nexport const localeRecord = <T>(\n  mapper: (locale: LocaleData) => T,\n  locales: LocalesValues[] = internationalization.locales ?? [],\n  defaultLocale: LocalesValues = internationalization.defaultLocale ??\n    DEFAULT_LOCALE,\n  mode:\n    | 'prefix-no-default'\n    | 'prefix-all'\n    | 'no-prefix'\n    | 'search-params' = routing?.mode ?? 'prefix-no-default'\n): Record<LocalesValues, T> =>\n  (locales ?? []).reduce(\n    (acc, locale) => {\n      acc[locale] = mapper({\n        locale,\n        defaultLocale,\n        locales,\n        isDefault: locale === defaultLocale,\n        urlPrefix: getPrefix(locale, { defaultLocale, mode, locales })\n          .localePrefix\n          ? `/${locale}`\n          : '',\n      } as LocaleData);\n      return acc;\n    },\n    {} as Record<LocalesValues, T>\n  );\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,MAAa,aACX,QACA,UAA2BA,4CAAqB,WAAW,CAAC,GAC5D,gBAA+BA,4CAAqB,iBAClDC,+CACF,OAIsBC,gCAAS,QAAQ,yBAEtC,WAAW,CAAC,EAAC,CAAE,KAAK,WACnB,OAAO;CACL;CACA;CACA;CACA,WAAW,WAAW;CACtB,WAAWC,yCAAU,QAAQ;EAAE;EAAe;EAAM;CAAQ,CAAC,CAAC,CAC3D,eACC,IAAI,WACJ;AACN,CAAe,CACjB;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BF,MAAa,iBACX,QACA,UAA2BH,4CAAqB,WAAW,CAAC,GAC5D,gBAA+BA,4CAAqB,iBAClDC,+CACF,OAIsBC,gCAAS,QAAQ,wBAEvC,QAAQ,SAAS,WACf,OAAO;CACL;CACA;CACA;CACA,WAAW,WAAW;CACtB,WAAWC,yCAAU,QAAQ;EAAE;EAAe;EAAM;CAAQ,CAAC,CAAC,CAC3D,eACC,IAAI,WACJ;AACN,CAAe,CACjB;;;;;;;;;;;;;;;;;;;;;;;;AAyBF,MAAa,gBACX,QACA,UAA2BH,4CAAqB,WAAW,CAAC,GAC5D,gBAA+BA,4CAAqB,iBAClDC,+CACF,OAIsBC,gCAAS,QAAQ,yBAEtC,WAAW,CAAC,EAAC,CAAE,QACb,KAAK,WAAW;CACf,IAAI,UAAU,OAAO;EACnB;EACA;EACA;EACA,WAAW,WAAW;EACtB,WAAWC,yCAAU,QAAQ;GAAE;GAAe;GAAM;EAAQ,CAAC,CAAC,CAC3D,eACC,IAAI,WACJ;CACN,CAAe;CACf,OAAO;AACT,GACA,CAAC,CACH"}

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

@@ -1 +1 @@
-{"version":3,"file":"localeResolver.cjs","names":["internationalization"],"sources":["../../../src/localization/localeResolver.ts"],"sourcesContent":["import { internationalization } from '@intlayer/config/built';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\n\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 */\nexport const localeResolver = (\n  selectedLocale: LocalesValues | LocalesValues[],\n  locales: LocalesValues[] = internationalization?.locales,\n  defaultLocale: LocalesValues = internationalization?.defaultLocale\n): Locale => {\n  // Ensure we can handle both a single locale or an array of locales uniformly\n  const requestedLocales = [selectedLocale].flat();\n\n  // Simple helper to normalize locale strings (e.g. \"en-US\" => \"en-us\")\n  const normalize = (locale: string): string => locale.trim().toLowerCase();\n\n  try {\n    // Check each requested locale in order\n    for (const requested of requestedLocales) {\n      const normalizedRequested = normalize(requested);\n\n      // Attempt exact match\n      const exactMatch = locales.find(\n        (locale) => normalize(locale) === normalizedRequested\n      );\n      if (exactMatch) {\n        return exactMatch as Locale;\n      }\n\n      // Attempt partial match on language subtag\n      // e.g. if requested is \"en-US\" and not found,\n      // see if \"en\" is available among locales\n      const [requestedLang] = normalizedRequested.split('-');\n      const partialMatch = locales.find(\n        (locale) => normalize(locale).split('-')[0] === requestedLang\n      );\n      if (partialMatch) {\n        return partialMatch as Locale;\n      }\n    }\n  } catch {\n    // If anything unexpected happened, fall back to default\n  }\n\n  // If no match was found, return the default\n  return defaultLocale as Locale;\n};\n"],"mappings":";;;;;;;;AAQA,MAAa,kBACX,gBACA,UAA2BA,6CAAsB,SACjD,gBAA+BA,6CAAsB,kBAC1C;CAEX,MAAM,mBAAmB,CAAC,cAAc,CAAC,CAAC,KAAK;CAG/C,MAAM,aAAa,WAA2B,OAAO,KAAK,CAAC,CAAC,YAAY;CAExE,IAAI;EAEF,KAAK,MAAM,aAAa,kBAAkB;GACxC,MAAM,sBAAsB,UAAU,SAAS;GAG/C,MAAM,aAAa,QAAQ,MACxB,WAAW,UAAU,MAAM,MAAM,mBACpC;GACA,IAAI,YACF,OAAO;GAMT,MAAM,CAAC,iBAAiB,oBAAoB,MAAM,GAAG;GACrD,MAAM,eAAe,QAAQ,MAC1B,WAAW,UAAU,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,OAAO,aAClD;GACA,IAAI,cACF,OAAO;EAEX;CACF,QAAQ,CAER;CAGA,OAAO;AACT"}
+{"version":3,"file":"localeResolver.cjs","names":["internationalization"],"sources":["../../../src/localization/localeResolver.ts"],"sourcesContent":["import { internationalization } from '@intlayer/config/built';\nimport type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\n\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 */\nexport const localeResolver = (\n  selectedLocale: LocalesValues | LocalesValues[],\n  locales: LocalesValues[] = internationalization?.locales,\n  defaultLocale: LocalesValues = internationalization?.defaultLocale\n): DeclaredLocales => {\n  // Ensure we can handle both a single locale or an array of locales uniformly\n  const requestedLocales = [selectedLocale].flat();\n\n  // Simple helper to normalize locale strings (e.g. \"en-US\" => \"en-us\")\n  const normalize = (locale: string): string => locale.trim().toLowerCase();\n\n  try {\n    // Check each requested locale in order\n    for (const requested of requestedLocales) {\n      const normalizedRequested = normalize(requested);\n\n      // Attempt exact match\n      const exactMatch = locales.find(\n        (locale) => normalize(locale) === normalizedRequested\n      );\n      if (exactMatch) {\n        return exactMatch as DeclaredLocales;\n      }\n\n      // Attempt partial match on language subtag\n      // e.g. if requested is \"en-US\" and not found,\n      // see if \"en\" is available among locales\n      const [requestedLang] = normalizedRequested.split('-');\n      const partialMatch = locales.find(\n        (locale) => normalize(locale).split('-')[0] === requestedLang\n      );\n      if (partialMatch) {\n        return partialMatch as DeclaredLocales;\n      }\n    }\n  } catch {\n    // If anything unexpected happened, fall back to default\n  }\n\n  // If no match was found, return the default\n  return defaultLocale as DeclaredLocales;\n};\n"],"mappings":";;;;;;;;AAUA,MAAa,kBACX,gBACA,UAA2BA,6CAAsB,SACjD,gBAA+BA,6CAAsB,kBACjC;CAEpB,MAAM,mBAAmB,CAAC,cAAc,CAAC,CAAC,KAAK;CAG/C,MAAM,aAAa,WAA2B,OAAO,KAAK,CAAC,CAAC,YAAY;CAExE,IAAI;EAEF,KAAK,MAAM,aAAa,kBAAkB;GACxC,MAAM,sBAAsB,UAAU,SAAS;GAG/C,MAAM,aAAa,QAAQ,MACxB,WAAW,UAAU,MAAM,MAAM,mBACpC;GACA,IAAI,YACF,OAAO;GAMT,MAAM,CAAC,iBAAiB,oBAAoB,MAAM,GAAG;GACrD,MAAM,eAAe,QAAQ,MAC1B,WAAW,UAAU,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,OAAO,aAClD;GACA,IAAI,cACF,OAAO;EAEX;CACF,QAAQ,CAER;CAGA,OAAO;AACT"}