@intlayer/core 8.4.4 → 8.4.5

package/dist/esm/localization/index.mjs

@@ -1 +1,18 @@
-import{getStorageAttributes as e}from"../getStorageAttributes.mjs";import{localeResolver as t}from"./localeResolver.mjs";import{localeDetector as n}from"./localeDetector.mjs";import{getBrowserLocale as r,localeStorageOptions as i}from"./getBrowserLocale.mjs";import{getHTMLTextDir as a}from"./getHTMLTextDir.mjs";import{getLocale as o}from"./getLocale.mjs";import{getLocaleFromPath as s}from"./getLocaleFromPath.mjs";import{getLocaleLang as c}from"./getLocaleLang.mjs";import{getLocaleName as l}from"./getLocaleName.mjs";import{getPathWithoutLocale as u}from"./getPathWithoutLocale.mjs";import{getPrefix as d}from"./getPrefix.mjs";import{getCanonicalPath as f,getInternalPath as p,getLocalizedPath as m,getRewritePath as h,getRewriteRules as g}from"./rewriteUtils.mjs";import{getLocalizedUrl as _}from"./getLocalizedUrl.mjs";import{getMultilingualUrls as v}from"./getMultilingualUrls.mjs";import{localeFlatMap as y,localeMap as b,localeRecord as x}from"./localeMapper.mjs";import{validatePrefix as S}from"./validatePrefix.mjs";export{r as getBrowserLocale,f as getCanonicalPath,a as getHTMLTextDir,p as getInternalPath,o as getLocale,s as getLocaleFromPath,c as getLocaleLang,l as getLocaleName,m as getLocalizedPath,_ as getLocalizedUrl,v as getMultilingualUrls,u as getPathWithoutLocale,d as getPrefix,h as getRewritePath,g as getRewriteRules,e as getStorageAttributes,n as localeDetector,y as localeFlatMap,b as localeMap,x as localeRecord,t as localeResolver,i as localeStorageOptions,S as validatePrefix};
+import { getStorageAttributes } from "../getStorageAttributes.mjs";
+import { localeResolver } from "./localeResolver.mjs";
+import { localeDetector } from "./localeDetector.mjs";
+import { getBrowserLocale, localeStorageOptions } from "./getBrowserLocale.mjs";
+import { getHTMLTextDir } from "./getHTMLTextDir.mjs";
+import { getLocale } from "./getLocale.mjs";
+import { getPrefix } from "./getPrefix.mjs";
+import { getLocaleFromPath } from "./getLocaleFromPath.mjs";
+import { getLocaleLang } from "./getLocaleLang.mjs";
+import { getLocaleName } from "./getLocaleName.mjs";
+import { getPathWithoutLocale } from "./getPathWithoutLocale.mjs";
+import { getCanonicalPath, getInternalPath, getLocalizedPath, getRewritePath, getRewriteRules } from "./rewriteUtils.mjs";
+import { getLocalizedUrl } from "./getLocalizedUrl.mjs";
+import { getMultilingualUrls } from "./getMultilingualUrls.mjs";
+import { localeFlatMap, localeMap, localeRecord } from "./localeMapper.mjs";
+import { validatePrefix } from "./validatePrefix.mjs";
+
+export { getBrowserLocale, getCanonicalPath, getHTMLTextDir, getInternalPath, getLocale, getLocaleFromPath, getLocaleLang, getLocaleName, getLocalizedPath, getLocalizedUrl, getMultilingualUrls, getPathWithoutLocale, getPrefix, getRewritePath, getRewriteRules, getStorageAttributes, localeDetector, localeFlatMap, localeMap, localeRecord, localeResolver, localeStorageOptions, validatePrefix };

package/dist/esm/localization/localeDetector.mjs

@@ -1,2 +1,132 @@
-import{localeResolver as e}from"./localeResolver.mjs";const t=/^\s*([^\s\-;]+)(?:-([^\s;]+))?\s*(?:;(.*))?$/;var n=function(e){return e[e.None=0]=`None`,e[e.Broad=1]=`Broad`,e[e.Prefix=2]=`Prefix`,e[e.Exact=4]=`Exact`,e}(n||{});const r=(e,n)=>{let r=t.exec(e);if(!r)return null;let i=r[1],a=r[2],o=r[3],s=a?`${i}-${a}`:i,c=1;if(o){let e=o.split(`;`);for(let t of e){let[e,n]=t.split(`=`);e===`q`&&(c=parseFloat(n))}}return{languageCode:i,regionCode:a,qualityScore:c,originalIndex:n,fullLocale:s}},i=e=>{let t=e.split(`,`),n=[];for(let e=0;e<t.length;e++){let i=r(t[e].trim(),e);i&&n.push(i)}return n},a=(e,t,i)=>{let a=r(e,i);if(!a)return null;let o=n.None,s=t.fullLocale.toLowerCase(),c=t.languageCode.toLowerCase(),l=a.fullLocale.toLowerCase(),u=a.languageCode.toLowerCase();if(s===l)o|=n.Exact;else if(c===l)o|=n.Prefix;else if(s===u)o|=n.Broad;else if(t.fullLocale!==`*`)return null;return{providedIndex:i,headerIndex:t.originalIndex,qualityScore:t.qualityScore,specificityScore:o}},o=(e,t,n)=>{let r={headerIndex:-1,qualityScore:0,specificityScore:0,providedIndex:n};for(let i of t){let t=a(e,i,n);t&&(r.specificityScore-t.specificityScore||r.qualityScore-t.qualityScore||r.headerIndex-t.headerIndex)<0&&(r=t)}return r},s=(e,t)=>t.qualityScore-e.qualityScore||t.specificityScore-e.specificityScore||e.headerIndex-t.headerIndex||e.providedIndex-t.providedIndex||0,c=(e,t)=>{let n=i(e===void 0?`*`:e||``);return t?t.map((e,t)=>o(e,n,t)).filter(e=>e.qualityScore>0).sort(s).map(e=>t[e.providedIndex]):n.filter(e=>e.qualityScore>0).sort((e,t)=>t.qualityScore-e.qualityScore).map(e=>e.fullLocale)},l=(t,n,r)=>{let i=t[`accept-language`];return e(c(i,n),n,r)};export{c as getPreferredLanguages,l as localeDetector};
+import { localeResolver } from "./localeResolver.mjs";
+
+//#region src/localization/localeDetector.ts
+/**
+* Constants
+*/
+const LANGUAGE_FORMAT_REGULAR_EXPRESSION = /^\s*([^\s\-;]+)(?:-([^\s;]+))?\s*(?:;(.*))?$/;
+const DEFAULT_QUALITY_SCORE = 1;
+/**
+* Enumeration for specificity weights.
+* Higher values indicate a more precise match.
+*/
+var SpecificityWeight = /* @__PURE__ */ function(SpecificityWeight) {
+	SpecificityWeight[SpecificityWeight["None"] = 0] = "None";
+	SpecificityWeight[SpecificityWeight["Broad"] = 1] = "Broad";
+	SpecificityWeight[SpecificityWeight["Prefix"] = 2] = "Prefix";
+	SpecificityWeight[SpecificityWeight["Exact"] = 4] = "Exact";
+	return SpecificityWeight;
+}(SpecificityWeight || {});
+/**
+* Parses a single language tag string from the Accept-Language header.
+* Example input: "en-US;q=0.8"
+*/
+const parseLanguageTag = (tagString, index) => {
+	const match = LANGUAGE_FORMAT_REGULAR_EXPRESSION.exec(tagString);
+	if (!match) return null;
+	const languageCode = match[1];
+	const regionCode = match[2];
+	const parameters = match[3];
+	const fullLocale = regionCode ? `${languageCode}-${regionCode}` : languageCode;
+	let qualityScore = DEFAULT_QUALITY_SCORE;
+	if (parameters) {
+		const parameterList = parameters.split(";");
+		for (const parameter of parameterList) {
+			const [key, value] = parameter.split("=");
+			if (key === "q") qualityScore = parseFloat(value);
+		}
+	}
+	return {
+		languageCode,
+		regionCode,
+		qualityScore,
+		originalIndex: index,
+		fullLocale
+	};
+};
+/**
+* Parses the entire Accept-Language header string into a list of preferences.
+*/
+const parseAcceptLanguageHeader = (headerValue) => {
+	const rawTags = headerValue.split(",");
+	const preferences = [];
+	for (let index = 0; index < rawTags.length; index++) {
+		const parsedLanguage = parseLanguageTag(rawTags[index].trim(), index);
+		if (parsedLanguage) preferences.push(parsedLanguage);
+	}
+	return preferences;
+};
+/**
+* Calculates the specificity of a match between a provided language and a requested preference.
+*/
+const calculateMatchSpecificity = (providedLanguage, preference, providedIndex) => {
+	const parsedProvided = parseLanguageTag(providedLanguage, providedIndex);
+	if (!parsedProvided) return null;
+	let specificityScore = SpecificityWeight.None;
+	const preferenceFullLower = preference.fullLocale.toLowerCase();
+	const preferencePrefixLower = preference.languageCode.toLowerCase();
+	const providedFullLower = parsedProvided.fullLocale.toLowerCase();
+	const providedPrefixLower = parsedProvided.languageCode.toLowerCase();
+	if (preferenceFullLower === providedFullLower) specificityScore |= SpecificityWeight.Exact;
+	else if (preferencePrefixLower === providedFullLower) specificityScore |= SpecificityWeight.Prefix;
+	else if (preferenceFullLower === providedPrefixLower) specificityScore |= SpecificityWeight.Broad;
+	else if (preference.fullLocale !== "*") return null;
+	return {
+		providedIndex,
+		headerIndex: preference.originalIndex,
+		qualityScore: preference.qualityScore,
+		specificityScore
+	};
+};
+/**
+* Determines the best match for a specific available language against the list of user accepted languages.
+*/
+const getBestMatchForLanguage = (providedLanguage, acceptedPreferences, providedIndex) => {
+	let bestMatch = {
+		headerIndex: -1,
+		qualityScore: 0,
+		specificityScore: 0,
+		providedIndex
+	};
+	for (const preference of acceptedPreferences) {
+		const matchSpec = calculateMatchSpecificity(providedLanguage, preference, providedIndex);
+		if (matchSpec) {
+			if ((bestMatch.specificityScore - matchSpec.specificityScore || bestMatch.qualityScore - matchSpec.qualityScore || bestMatch.headerIndex - matchSpec.headerIndex) < 0) bestMatch = matchSpec;
+		}
+	}
+	return bestMatch;
+};
+/**
+* Comparator function to sort language matches.
+* Sorting order:
+* 1. Quality Score (Descending)
+* 2. Specificity Score (Descending)
+* 3. Order in Header (Ascending - lower index is better)
+* 4. Order in Provided List (Ascending)
+*/
+const compareMatchResults = (a, b) => {
+	return b.qualityScore - a.qualityScore || b.specificityScore - a.specificityScore || a.headerIndex - b.headerIndex || a.providedIndex - b.providedIndex || 0;
+};
+/**
+* Derives the list of preferred languages based on the Accept-Language header
+* and an optional list of available languages.
+*/
+const getPreferredLanguages = (acceptHeader, availableLanguages) => {
+	const acceptedPreferences = parseAcceptLanguageHeader(acceptHeader === void 0 ? "*" : acceptHeader || "");
+	if (!availableLanguages) return acceptedPreferences.filter((preference) => preference.qualityScore > 0).sort((a, b) => b.qualityScore - a.qualityScore).map((preference) => preference.fullLocale);
+	return availableLanguages.map((language, index) => getBestMatchForLanguage(language, acceptedPreferences, index)).filter((result) => result.qualityScore > 0).sort(compareMatchResults).map((result) => availableLanguages[result.providedIndex]);
+};
+/**
+* Detects the locale from the request headers.
+*
+* Headers are provided by the browser/client and can be used to determine the user's preferred language.
+* This function intersects the user's `Accept-Language` header with the application's available locales.
+*/
+const localeDetector = (headers, availableLocales, defaultLocale) => {
+	const acceptLanguageHeader = headers["accept-language"];
+	return localeResolver(getPreferredLanguages(acceptLanguageHeader, availableLocales), availableLocales, defaultLocale);
+};
+
+//#endregion
+export { getPreferredLanguages, localeDetector };
 //# sourceMappingURL=localeDetector.mjs.map

package/dist/esm/localization/localeDetector.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"localeDetector.mjs","names":[],"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":"sDAMA,MAAM,EACJ,+CAOF,IAAK,EAAL,SAAA,EAAA,OACE,GAAA,EAAA,KAAA,GAAA,OACA,EAAA,EAAA,MAAA,GAAA,QACA,EAAA,EAAA,OAAA,GAAA,SACA,EAAA,EAAA,MAAA,GAAA,WAJG,GAAA,EAAA,CAKJ,CA2BD,MAAM,GACJ,EACA,IAC8B,CAC9B,IAAM,EAAQ,EAAmC,KAAK,EAAU,CAChE,GAAI,CAAC,EACH,OAAO,KAGT,IAAM,EAAe,EAAM,GACrB,EAAa,EAAM,GACnB,EAAa,EAAM,GAGnB,EAAa,EACf,GAAG,EAAa,GAAG,IACnB,EAEA,EAAe,EAGnB,GAAI,EAAY,CACd,IAAM,EAAgB,EAAW,MAAM,IAAI,CAC3C,IAAK,IAAM,KAAa,EAAe,CACrC,GAAM,CAAC,EAAK,GAAS,EAAU,MAAM,IAAI,CACrC,IAAQ,MACV,EAAe,WAAW,EAAM,GAKtC,MAAO,CACL,eACA,aACA,eACA,cAAe,EACf,aACD,EAMG,EACJ,GACyB,CACzB,IAAM,EAAU,EAAY,MAAM,IAAI,CAChC,EAAoC,EAAE,CAE5C,IAAK,IAAI,EAAQ,EAAG,EAAQ,EAAQ,OAAQ,IAAS,CAEnD,IAAM,EAAiB,EADX,EAAQ,GAAO,MAAM,CACY,EAAM,CAE/C,GACF,EAAY,KAAK,EAAe,CAIpC,OAAO,GAMH,GACJ,EACA,EACA,IACuB,CACvB,IAAM,EAAiB,EAAiB,EAAkB,EAAc,CACxE,GAAI,CAAC,EACH,OAAO,KAGT,IAAI,EAAmB,EAAkB,KAEnC,EAAsB,EAAW,WAAW,aAAa,CACzD,EAAwB,EAAW,aAAa,aAAa,CAC7D,EAAoB,EAAe,WAAW,aAAa,CAC3D,EAAsB,EAAe,aAAa,aAAa,CAErE,GAAI,IAAwB,EAC1B,GAAoB,EAAkB,cAC7B,IAA0B,EACnC,GAAoB,EAAkB,eAC7B,IAAwB,EACjC,GAAoB,EAAkB,cAC7B,EAAW,aAAe,IACnC,OAAO,KAGT,MAAO,CACL,gBACA,YAAa,EAAW,cACxB,aAAc,EAAW,aACzB,mBACD,EAMG,GACJ,EACA,EACA,IACgB,CAEhB,IAAI,EAAyB,CAC3B,YAAa,GACb,aAAc,EACd,iBAAkB,EAClB,gBACD,CAED,IAAK,IAAM,KAAc,EAAqB,CAC5C,IAAM,EAAY,EAChB,EACA,EACA,EACD,CAEG,IAGA,EAAU,iBAAmB,EAAU,kBACvC,EAAU,aAAe,EAAU,cACnC,EAAU,YAAc,EAAU,aAGd,IACpB,EAAY,GAKlB,OAAO,GAWH,GAAuB,EAAgB,IAEzC,EAAE,aAAe,EAAE,cACnB,EAAE,iBAAmB,EAAE,kBACvB,EAAE,YAAc,EAAE,aAClB,EAAE,cAAgB,EAAE,eACpB,EAQS,GACX,EACA,IACa,CAGb,IAAM,EAAsB,EADR,IAAiB,IAAA,GAAY,IAAM,GAAgB,GACL,CAelE,OAZK,EAQgB,EAAmB,KAAK,EAAU,IACrD,EAAwB,EAAU,EAAqB,EAAM,CAC9D,CAGE,OAAQ,GAAW,EAAO,aAAe,EAAE,CAC3C,KAAK,EAAoB,CACzB,IAAK,GAAW,EAAmB,EAAO,eAAe,CAdnD,EACJ,OAAQ,GAAe,EAAW,aAAe,EAAE,CACnD,MAAM,EAAG,IAAM,EAAE,aAAe,EAAE,aAAa,CAC/C,IAAK,GAAe,EAAW,WAAW,EAoBpC,GACX,EACA,EACA,IACW,CACX,IAAM,EAAuB,EAAQ,mBAOrC,OAAO,EALwB,EAC7B,EACA,EACD,CAIC,EACA,EACD"}
+{"version":3,"file":"localeDetector.mjs","names":[],"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;;;;;AAM9B,IAAK,oBAAL;AACE;AACA;AACA;AACA;;EAJG,wBAKJ;;;;;AA2BD,MAAM,oBACJ,WACA,UAC8B;CAC9B,MAAM,QAAQ,mCAAmC,KAAK,UAAU;AAChE,KAAI,CAAC,MACH,QAAO;CAGT,MAAM,eAAe,MAAM;CAC3B,MAAM,aAAa,MAAM;CACzB,MAAM,aAAa,MAAM;CAGzB,MAAM,aAAa,aACf,GAAG,aAAa,GAAG,eACnB;CAEJ,IAAI,eAAe;AAGnB,KAAI,YAAY;EACd,MAAM,gBAAgB,WAAW,MAAM,IAAI;AAC3C,OAAK,MAAM,aAAa,eAAe;GACrC,MAAM,CAAC,KAAK,SAAS,UAAU,MAAM,IAAI;AACzC,OAAI,QAAQ,IACV,gBAAe,WAAW,MAAM;;;AAKtC,QAAO;EACL;EACA;EACA;EACA,eAAe;EACf;EACD;;;;;AAMH,MAAM,6BACJ,gBACyB;CACzB,MAAM,UAAU,YAAY,MAAM,IAAI;CACtC,MAAM,cAAoC,EAAE;AAE5C,MAAK,IAAI,QAAQ,GAAG,QAAQ,QAAQ,QAAQ,SAAS;EAEnD,MAAM,iBAAiB,iBADX,QAAQ,OAAO,MAAM,EACY,MAAM;AAEnD,MAAI,eACF,aAAY,KAAK,eAAe;;AAIpC,QAAO;;;;;AAMT,MAAM,6BACJ,kBACA,YACA,kBACuB;CACvB,MAAM,iBAAiB,iBAAiB,kBAAkB,cAAc;AACxE,KAAI,CAAC,eACH,QAAO;CAGT,IAAI,mBAAmB,kBAAkB;CAEzC,MAAM,sBAAsB,WAAW,WAAW,aAAa;CAC/D,MAAM,wBAAwB,WAAW,aAAa,aAAa;CACnE,MAAM,oBAAoB,eAAe,WAAW,aAAa;CACjE,MAAM,sBAAsB,eAAe,aAAa,aAAa;AAErE,KAAI,wBAAwB,kBAC1B,qBAAoB,kBAAkB;UAC7B,0BAA0B,kBACnC,qBAAoB,kBAAkB;UAC7B,wBAAwB,oBACjC,qBAAoB,kBAAkB;UAC7B,WAAW,eAAe,IACnC,QAAO;AAGT,QAAO;EACL;EACA,aAAa,WAAW;EACxB,cAAc,WAAW;EACzB;EACD;;;;;AAMH,MAAM,2BACJ,kBACA,qBACA,kBACgB;CAEhB,IAAI,YAAyB;EAC3B,aAAa;EACb,cAAc;EACd,kBAAkB;EAClB;EACD;AAED,MAAK,MAAM,cAAc,qBAAqB;EAC5C,MAAM,YAAY,0BAChB,kBACA,YACA,cACD;AAED,MAAI,WAQF;QALE,UAAU,mBAAmB,UAAU,oBACvC,UAAU,eAAe,UAAU,gBACnC,UAAU,cAAc,UAAU,eAGd,EACpB,aAAY;;;AAKlB,QAAO;;;;;;;;;;AAWT,MAAM,uBAAuB,GAAgB,MAA2B;AACtE,QACE,EAAE,eAAe,EAAE,gBACnB,EAAE,mBAAmB,EAAE,oBACvB,EAAE,cAAc,EAAE,eAClB,EAAE,gBAAgB,EAAE,iBACpB;;;;;;AAQJ,MAAa,yBACX,cACA,uBACa;CAGb,MAAM,sBAAsB,0BADR,iBAAiB,SAAY,MAAM,gBAAgB,GACL;AAGlE,KAAI,CAAC,mBACH,QAAO,oBACJ,QAAQ,eAAe,WAAW,eAAe,EAAE,CACnD,MAAM,GAAG,MAAM,EAAE,eAAe,EAAE,aAAa,CAC/C,KAAK,eAAe,WAAW,WAAW;AAQ/C,QAJqB,mBAAmB,KAAK,UAAU,UACrD,wBAAwB,UAAU,qBAAqB,MAAM,CAC9D,CAGE,QAAQ,WAAW,OAAO,eAAe,EAAE,CAC3C,KAAK,oBAAoB,CACzB,KAAK,WAAW,mBAAmB,OAAO,eAAe;;;;;;;;AAS9D,MAAa,kBACX,SACA,kBACA,kBACW;CACX,MAAM,uBAAuB,QAAQ;AAOrC,QAAO,eALwB,sBAC7B,sBACA,iBACD,EAIC,kBACA,cACD"}

package/dist/esm/localization/localeMapper.mjs

@@ -1,2 +1,120 @@
-import{DEFAULT_LOCALE as e}from"@intlayer/config/defaultValues";import t from"@intlayer/config/built";const n=(e,t,n)=>n===`no-prefix`||n===`search-params`?!1:n===`prefix-all`?!0:e!==t,r=(r,i=t?.internationalization.locales??[],a=t?.internationalization.defaultLocale??e,o=t?.routing?.mode??`prefix-no-default`)=>(i??[]).map(e=>r({locale:e,defaultLocale:a,locales:i,isDefault:e===a,urlPrefix:n(e,a,o)?`/${e}`:``})),i=(r,i=t?.internationalization.locales??[],a=t?.internationalization.defaultLocale??e,o=t?.routing?.mode??`prefix-no-default`)=>i.flatMap(e=>r({locale:e,defaultLocale:a,locales:i,isDefault:e===a,urlPrefix:n(e,a,o)?`/${e}`:``})),a=(r,i=t?.internationalization.locales??[],a=t?.internationalization.defaultLocale??e,o=t?.routing?.mode??`prefix-no-default`)=>(i??[]).reduce((e,t)=>(e[t]=r({locale:t,defaultLocale:a,locales:i,isDefault:t===a,urlPrefix:n(t,a,o)?`/${t}`:``}),e),{});export{i as localeFlatMap,r as localeMap,a as localeRecord};
+import { getPrefix } from "./getPrefix.mjs";
+import { DEFAULT_LOCALE } from "@intlayer/config/defaultValues";
+import configuration from "@intlayer/config/built";
+
+//#region src/localization/localeMapper.ts
+/**
+* Map the locale data to an array of objects
+*
+* @example
+* ```ts
+* const routes = localeMap((localizedData) =>
+* ({
+*    path: localizedData.urlPrefix,
+*    name: localizedData.locale,
+*    isDefault: localizedData.isDefault,
+*    locales: localizedData.locales,
+*    defaultLocale: localizedData.defaultLocale,
+*  }),
+* );
+*
+* // Result
+* [
+*   { path: '/', name: 'en', isDefault: true, locales: ['en'], defaultLocale: 'en', urlPrefix: '' },
+*   { path: '/fr', name: 'fr', isDefault: false, locales: ['fr'], defaultLocale: 'en', urlPrefix: '/fr' },
+*   { path: '/es', name: 'es', isDefault: false, locales: ['es'], defaultLocale: 'en', urlPrefix: '/es' },
+* ]
+* ```
+*
+* @param mapper - The mapper function that returns an object
+* @returns An array of objects
+*/
+const localeMap = (mapper, locales = configuration?.internationalization.locales ?? [], defaultLocale = configuration?.internationalization.defaultLocale ?? DEFAULT_LOCALE, mode = configuration?.routing?.mode ?? "prefix-no-default") => (locales ?? []).map((locale) => mapper({
+	locale,
+	defaultLocale,
+	locales,
+	isDefault: locale === defaultLocale,
+	urlPrefix: getPrefix(locale, {
+		defaultLocale,
+		mode,
+		locales
+	}).localePrefix ? `/${locale}` : ""
+}));
+/**
+* Flatten the locale map into a single array of objects
+*
+* @example
+* ```ts
+* const routes = localeMap((localizedData) =>
+* [{
+*    path: localizedData.urlPrefix,
+*    name: localizedData.locale,
+*    isDefault: localizedData.isDefault,
+*    locales: localizedData.locales,
+*    defaultLocale: localizedData.defaultLocale,
+*  }],
+* );
+*
+* // Result
+* [
+*   path: '/', name: 'en', isDefault: true, locales: ['en'], defaultLocale: 'en', urlPrefix: '' ,
+*   path: '/fr', name: 'fr', isDefault: false, locales: ['fr'], defaultLocale: 'en', urlPrefix: '/fr' ,
+*   path: '/es', name: 'es', isDefault: false, locales: ['es'], defaultLocale: 'en', urlPrefix: '/es' ,
+* ]
+* ```
+*
+* @param mapper - The mapper function that returns an array of objects
+* @returns An array of objects
+*/
+const localeFlatMap = (mapper, locales = configuration?.internationalization.locales ?? [], defaultLocale = configuration?.internationalization.defaultLocale ?? DEFAULT_LOCALE, mode = configuration?.routing?.mode ?? "prefix-no-default") => locales.flatMap((locale) => mapper({
+	locale,
+	defaultLocale,
+	locales,
+	isDefault: locale === defaultLocale,
+	urlPrefix: getPrefix(locale, {
+		defaultLocale,
+		mode,
+		locales
+	}).localePrefix ? `/${locale}` : ""
+}));
+/**
+* Creates a record object mapping locales to values transformed by the mapper function
+*
+* @example
+* ```ts
+* const translations = localeRecord(({ locale }) =>
+*   require(`./translations/${locale}.json`)
+* );
+*
+* // Result
+*
+*   en: ... , // Content of translations/en.json
+*   fr: ... , // Content of translations/fr.json
+*   es: ...
+*
+* ```
+*
+* @param mapper - Function that takes locale data and returns a value for that locale
+* @param locales - Array of locale codes to map over (defaults to configured locales)
+* @param defaultLocale - The default locale (defaults to configured default)
+* @param mode - URL routing mode for locale handling (defaults to configured value)
+* @returns Record mapping locale codes to mapped values
+*/
+const localeRecord = (mapper, locales = configuration?.internationalization.locales ?? [], defaultLocale = configuration?.internationalization.defaultLocale ?? DEFAULT_LOCALE, mode = configuration?.routing?.mode ?? "prefix-no-default") => (locales ?? []).reduce((acc, locale) => {
+	acc[locale] = mapper({
+		locale,
+		defaultLocale,
+		locales,
+		isDefault: locale === defaultLocale,
+		urlPrefix: getPrefix(locale, {
+			defaultLocale,
+			mode,
+			locales
+		}).localePrefix ? `/${locale}` : ""
+	});
+	return acc;
+}, {});
+
+//#endregion
+export { localeFlatMap, localeMap, localeRecord };
 //# sourceMappingURL=localeMapper.mjs.map

package/dist/esm/localization/localeMapper.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"localeMapper.mjs","names":[],"sources":["../../../src/localization/localeMapper.ts"],"sourcesContent":["import configuration 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';\n\nexport type LocaleData = {\n  locale: Locale;\n  defaultLocale: Locale;\n  isDefault: boolean;\n  locales: Locale[];\n  urlPrefix: string;\n};\n\n/**\n * Determine if the locale should be prefixed in the URL based on routing mode\n */\nconst shouldPrefixLocale = (\n  locale: LocalesValues,\n  defaultLocale: LocalesValues,\n  mode: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params'\n): boolean => {\n  if (mode === 'no-prefix' || mode === 'search-params') {\n    return false;\n  }\n  if (mode === 'prefix-all') {\n    return true;\n  }\n  // 'prefix-no-default'\n  return locale !== defaultLocale;\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[] = configuration?.internationalization.locales ?? [],\n  defaultLocale: LocalesValues = configuration?.internationalization\n    .defaultLocale ?? DEFAULT_LOCALE,\n  mode:\n    | 'prefix-no-default'\n    | 'prefix-all'\n    | 'no-prefix'\n    | 'search-params' = configuration?.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: shouldPrefixLocale(locale, defaultLocale, mode)\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[] = configuration?.internationalization.locales ?? [],\n  defaultLocale: LocalesValues = configuration?.internationalization\n    .defaultLocale ?? DEFAULT_LOCALE,\n  mode:\n    | 'prefix-no-default'\n    | 'prefix-all'\n    | 'no-prefix'\n    | 'search-params' = configuration?.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: shouldPrefixLocale(locale, defaultLocale, mode)\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[] = configuration?.internationalization.locales ?? [],\n  defaultLocale: LocalesValues = configuration?.internationalization\n    .defaultLocale ?? DEFAULT_LOCALE,\n  mode:\n    | 'prefix-no-default'\n    | 'prefix-all'\n    | 'no-prefix'\n    | 'search-params' = configuration?.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: shouldPrefixLocale(locale, defaultLocale, mode)\n          ? `/${locale}`\n          : '',\n      } as LocaleData);\n      return acc;\n    },\n    {} as Record<LocalesValues, T>\n  );\n"],"mappings":"sGAgBA,MAAM,GACJ,EACA,EACA,IAEI,IAAS,aAAe,IAAS,gBAC5B,GAEL,IAAS,aACJ,GAGF,IAAW,EA6BP,GACX,EACA,EAA2B,GAAe,qBAAqB,SAAW,EAAE,CAC5E,EAA+B,GAAe,qBAC3C,eAAiB,EACpB,EAIsB,GAAe,SAAS,MAAQ,uBAErD,GAAW,EAAE,EAAE,IAAK,GACnB,EAAO,CACL,SACA,gBACA,UACA,UAAW,IAAW,EACtB,UAAW,EAAmB,EAAQ,EAAe,EAAK,CACtD,IAAI,IACJ,GACL,CAAe,CACjB,CA4BU,GACX,EACA,EAA2B,GAAe,qBAAqB,SAAW,EAAE,CAC5E,EAA+B,GAAe,qBAC3C,eAAiB,EACpB,EAIsB,GAAe,SAAS,MAAQ,sBAEtD,EAAQ,QAAS,GACf,EAAO,CACL,SACA,gBACA,UACA,UAAW,IAAW,EACtB,UAAW,EAAmB,EAAQ,EAAe,EAAK,CACtD,IAAI,IACJ,GACL,CAAe,CACjB,CAyBU,GACX,EACA,EAA2B,GAAe,qBAAqB,SAAW,EAAE,CAC5E,EAA+B,GAAe,qBAC3C,eAAiB,EACpB,EAIsB,GAAe,SAAS,MAAQ,uBAErD,GAAW,EAAE,EAAE,QACb,EAAK,KACJ,EAAI,GAAU,EAAO,CACnB,SACA,gBACA,UACA,UAAW,IAAW,EACtB,UAAW,EAAmB,EAAQ,EAAe,EAAK,CACtD,IAAI,IACJ,GACL,CAAe,CACT,GAET,EAAE,CACH"}
+{"version":3,"file":"localeMapper.mjs","names":[],"sources":["../../../src/localization/localeMapper.ts"],"sourcesContent":["import configuration 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[] = configuration?.internationalization.locales ?? [],\n  defaultLocale: LocalesValues = configuration?.internationalization\n    .defaultLocale ?? DEFAULT_LOCALE,\n  mode:\n    | 'prefix-no-default'\n    | 'prefix-all'\n    | 'no-prefix'\n    | 'search-params' = configuration?.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[] = configuration?.internationalization.locales ?? [],\n  defaultLocale: LocalesValues = configuration?.internationalization\n    .defaultLocale ?? DEFAULT_LOCALE,\n  mode:\n    | 'prefix-no-default'\n    | 'prefix-all'\n    | 'no-prefix'\n    | 'search-params' = configuration?.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[] = configuration?.internationalization.locales ?? [],\n  defaultLocale: LocalesValues = configuration?.internationalization\n    .defaultLocale ?? DEFAULT_LOCALE,\n  mode:\n    | 'prefix-no-default'\n    | 'prefix-all'\n    | 'no-prefix'\n    | 'search-params' = configuration?.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,UAA2B,eAAe,qBAAqB,WAAW,EAAE,EAC5E,gBAA+B,eAAe,qBAC3C,iBAAiB,gBACpB,OAIsB,eAAe,SAAS,QAAQ,yBAErD,WAAW,EAAE,EAAE,KAAK,WACnB,OAAO;CACL;CACA;CACA;CACA,WAAW,WAAW;CACtB,WAAW,UAAU,QAAQ;EAAE;EAAe;EAAM;EAAS,CAAC,CAC3D,eACC,IAAI,WACJ;CACL,CAAe,CACjB;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BH,MAAa,iBACX,QACA,UAA2B,eAAe,qBAAqB,WAAW,EAAE,EAC5E,gBAA+B,eAAe,qBAC3C,iBAAiB,gBACpB,OAIsB,eAAe,SAAS,QAAQ,wBAEtD,QAAQ,SAAS,WACf,OAAO;CACL;CACA;CACA;CACA,WAAW,WAAW;CACtB,WAAW,UAAU,QAAQ;EAAE;EAAe;EAAM;EAAS,CAAC,CAC3D,eACC,IAAI,WACJ;CACL,CAAe,CACjB;;;;;;;;;;;;;;;;;;;;;;;;AAyBH,MAAa,gBACX,QACA,UAA2B,eAAe,qBAAqB,WAAW,EAAE,EAC5E,gBAA+B,eAAe,qBAC3C,iBAAiB,gBACpB,OAIsB,eAAe,SAAS,QAAQ,yBAErD,WAAW,EAAE,EAAE,QACb,KAAK,WAAW;AACf,KAAI,UAAU,OAAO;EACnB;EACA;EACA;EACA,WAAW,WAAW;EACtB,WAAW,UAAU,QAAQ;GAAE;GAAe;GAAM;GAAS,CAAC,CAC3D,eACC,IAAI,WACJ;EACL,CAAe;AAChB,QAAO;GAET,EAAE,CACH"}

package/dist/esm/localization/localeResolver.mjs

@@ -1,2 +1,26 @@
-import e from"@intlayer/config/built";const t=(t,n=e?.internationalization?.locales,r=e?.internationalization?.defaultLocale)=>{let i=[t].flat(),a=e=>e.trim().toLowerCase();try{for(let e of i){let t=a(e),r=n.find(e=>a(e)===t);if(r)return r;let[i]=t.split(`-`),o=n.find(e=>a(e).split(`-`)[0]===i);if(o)return o}}catch{}return r};export{t as localeResolver};
+import configuration from "@intlayer/config/built";
+
+//#region src/localization/localeResolver.ts
+/**
+* Resolves the most specific locale from a user-provided list,
+* or falls back to the default locale if no match is found.
+*/
+const localeResolver = (selectedLocale, locales = configuration?.internationalization?.locales, defaultLocale = configuration?.internationalization?.defaultLocale) => {
+	const requestedLocales = [selectedLocale].flat();
+	const normalize = (locale) => locale.trim().toLowerCase();
+	try {
+		for (const requested of requestedLocales) {
+			const normalizedRequested = normalize(requested);
+			const exactMatch = locales.find((loc) => normalize(loc) === normalizedRequested);
+			if (exactMatch) return exactMatch;
+			const [requestedLang] = normalizedRequested.split("-");
+			const partialMatch = locales.find((loc) => normalize(loc).split("-")[0] === requestedLang);
+			if (partialMatch) return partialMatch;
+		}
+	} catch (_error) {}
+	return defaultLocale;
+};
+
+//#endregion
+export { localeResolver };
 //# sourceMappingURL=localeResolver.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"localeResolver.mjs","names":[],"sources":["../../../src/localization/localeResolver.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport type { Locale } from '@intlayer/types/allLocales';\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[] = configuration?.internationalization?.locales,\n  defaultLocale: LocalesValues = configuration?.internationalization\n    ?.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      // 1) Attempt exact match\n      const exactMatch = locales.find(\n        (loc) => normalize(loc) === normalizedRequested\n      );\n      if (exactMatch) {\n        return exactMatch as Locale;\n      }\n\n      // 2) 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        (loc) => normalize(loc).split('-')[0] === requestedLang\n      );\n      if (partialMatch) {\n        return partialMatch as Locale;\n      }\n    }\n  } catch (_error) {\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":"sCAQA,MAAa,GACX,EACA,EAA2B,GAAe,sBAAsB,QAChE,EAA+B,GAAe,sBAC1C,gBACO,CAEX,IAAM,EAAmB,CAAC,EAAe,CAAC,MAAM,CAG1C,EAAa,GAA2B,EAAO,MAAM,CAAC,aAAa,CAEzE,GAAI,CAEF,IAAK,IAAM,KAAa,EAAkB,CACxC,IAAM,EAAsB,EAAU,EAAU,CAG1C,EAAa,EAAQ,KACxB,GAAQ,EAAU,EAAI,GAAK,EAC7B,CACD,GAAI,EACF,OAAO,EAMT,GAAM,CAAC,GAAiB,EAAoB,MAAM,IAAI,CAChD,EAAe,EAAQ,KAC1B,GAAQ,EAAU,EAAI,CAAC,MAAM,IAAI,CAAC,KAAO,EAC3C,CACD,GAAI,EACF,OAAO,QAGI,EAKjB,OAAO"}
+{"version":3,"file":"localeResolver.mjs","names":[],"sources":["../../../src/localization/localeResolver.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport type { Locale } from '@intlayer/types/allLocales';\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[] = configuration?.internationalization?.locales,\n  defaultLocale: LocalesValues = configuration?.internationalization\n    ?.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      // 1) Attempt exact match\n      const exactMatch = locales.find(\n        (loc) => normalize(loc) === normalizedRequested\n      );\n      if (exactMatch) {\n        return exactMatch as Locale;\n      }\n\n      // 2) 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        (loc) => normalize(loc).split('-')[0] === requestedLang\n      );\n      if (partialMatch) {\n        return partialMatch as Locale;\n      }\n    }\n  } catch (_error) {\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,UAA2B,eAAe,sBAAsB,SAChE,gBAA+B,eAAe,sBAC1C,kBACO;CAEX,MAAM,mBAAmB,CAAC,eAAe,CAAC,MAAM;CAGhD,MAAM,aAAa,WAA2B,OAAO,MAAM,CAAC,aAAa;AAEzE,KAAI;AAEF,OAAK,MAAM,aAAa,kBAAkB;GACxC,MAAM,sBAAsB,UAAU,UAAU;GAGhD,MAAM,aAAa,QAAQ,MACxB,QAAQ,UAAU,IAAI,KAAK,oBAC7B;AACD,OAAI,WACF,QAAO;GAMT,MAAM,CAAC,iBAAiB,oBAAoB,MAAM,IAAI;GACtD,MAAM,eAAe,QAAQ,MAC1B,QAAQ,UAAU,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,cAC3C;AACD,OAAI,aACF,QAAO;;UAGJ,QAAQ;AAKjB,QAAO"}

package/dist/esm/localization/rewriteUtils.mjs

@@ -1,2 +1,105 @@
-const e=(e,t=`url`)=>{if(e)return`url`in e?e[t]:{rules:Object.entries(e).map(([e,t])=>({canonical:e.startsWith(`/`)?e.replace(/\[([^\]]+)\]/g,`:$1`):`/${e.replace(/\[([^\]]+)\]/g,`:$1`)}`,localized:Object.fromEntries(Object.entries(t).map(([e,t])=>[e,t?.startsWith(`/`)?t.replace(/\[([^\]]+)\]/g,`:$1`):`/${(t||``).replace(/\[([^\]]+)\]/g,`:$1`)}`]))}))}},t=e=>{let t=e.replace(/\//g,`\\/`).replace(/\\\/:(?:[^/\\*+?]+)\*/g,`(?:\\/(.*))?`).replace(/\\\/:(?:[^/\\*+?]+)\?/g,`(?:\\/([^\\/]+))?`).replace(/:([^/\\*+?]+)\*/g,`(.*)`).replace(/:([^/\\*+?]+)\?/g,`([^\\/]*)`).replace(/:([^/\\*+?]+)\+/g,`(.+)`).replace(/:([^/\\*+?]+)/g,`([^\\/]+)`);return RegExp(`^${t}$`)},n=(e,t)=>{let n=0;return e.replace(/:([^/\\*+?]+)[*+?]?/g,()=>t[n++]??``).replace(/\/+/g,`/`).replace(/\/$/,``)||`/`},r=(e,n)=>{let r=t(n),i=e.match(r);return i?i.slice(1):null},i=(e,t,i)=>{if(!i)return e;for(let a of i.rules){let{canonical:i,localized:o}=a,s=t?[t]:Object.keys(o);for(let t of s){let a=o[t];if(!a)continue;let s=r(e,a);if(s)return n(i,s)}}return e},a=(e,t,i)=>{if(!i)return{path:e,isRewritten:!1};for(let a of i.rules){let{canonical:i,localized:o}=a,s=r(e,i);if(s){let e=o[t];if(e)return{path:n(e,s),isRewritten:!0}}}return{path:e,isRewritten:!1}},o=(e,t)=>{let n=e.startsWith(`/`)?e:`/${e}`;return n.startsWith(`/${t}/`)||n===`/${t}`?n:`/${t}${n===`/`?``:n}`},s=(t,n,r)=>{let o=e(r,`url`);if(!o)return;let{path:s,isRewritten:c}=a(i(t,void 0,o),n,o);if(c&&s!==t)return s};export{i as getCanonicalPath,o as getInternalPath,a as getLocalizedPath,s as getRewritePath,e as getRewriteRules};
+//#region src/localization/rewriteUtils.ts
+/**
+* Normalizes legacy Record format or extracts specialized rules from RewriteObject.
+*/
+const getRewriteRules = (rewrite, context = "url") => {
+	if (!rewrite) return void 0;
+	if ("url" in rewrite) return rewrite[context];
+	return { rules: Object.entries(rewrite).map(([canonical, localized]) => ({
+		canonical: canonical.startsWith("/") ? canonical.replace(/\[([^\]]+)\]/g, ":$1") : `/${canonical.replace(/\[([^\]]+)\]/g, ":$1")}`,
+		localized: Object.fromEntries(Object.entries(localized).map(([locale, pattern]) => {
+			return [locale, pattern?.startsWith("/") ? pattern.replace(/\[([^\]]+)\]/g, ":$1") : `/${(pattern || "").replace(/\[([^\]]+)\]/g, ":$1")}`];
+		}))
+	})) };
+};
+/**
+* Converts normalized pattern to Regex.
+* Internal syntax supports:
+* - :param -> ([^/]+) (one segment)
+* - :param* -> (.*) (zero or more segments)
+* - :param+ -> (.+) (one or more segments)
+* - :param? -> ([^/]*) (zero or one segment)
+*/
+const patternToRegex = (pattern) => {
+	const regexString = pattern.replace(/\//g, "\\/").replace(/\\\/:(?:[^/\\*+?]+)\*/g, "(?:\\/(.*))?").replace(/\\\/:(?:[^/\\*+?]+)\?/g, "(?:\\/([^\\/]+))?").replace(/:([^/\\*+?]+)\*/g, "(.*)").replace(/:([^/\\*+?]+)\?/g, "([^\\/]*)").replace(/:([^/\\*+?]+)\+/g, "(.+)").replace(/:([^/\\*+?]+)/g, "([^\\/]+)");
+	return new RegExp(`^${regexString}$`);
+};
+/**
+* Replaces route parameters in a path with provided values.
+*/
+const fillPath = (pattern, params) => {
+	let index = 0;
+	return pattern.replace(/:([^/\\*+?]+)[*+?]?/g, () => params[index++] ?? "").replace(/\/+/g, "/").replace(/\/$/, "") || "/";
+};
+/**
+* Extract values from a URL based on a pattern.
+*/
+const extractParams = (url, pattern) => {
+	const regex = patternToRegex(pattern);
+	const match = url.match(regex);
+	return match ? match.slice(1) : null;
+};
+/**
+* Given a localized URL (e.g., "/produits/123"), finds the canonical internal path (e.g., "/products/123").
+* If locale is provided, only check for that locale. Otherwise, check for all locales.
+*/
+const getCanonicalPath = (localizedPath, locale, rewriteRules) => {
+	if (!rewriteRules) return localizedPath;
+	for (const rule of rewriteRules.rules) {
+		const { canonical, localized } = rule;
+		const localesToCheck = locale ? [locale] : Object.keys(localized);
+		for (const loc of localesToCheck) {
+			const localizedPattern = localized[loc];
+			if (!localizedPattern) continue;
+			const params = extractParams(localizedPath, localizedPattern);
+			if (params) return fillPath(canonical, params);
+		}
+	}
+	return localizedPath;
+};
+/**
+* Given a canonical path (e.g., "/products/123"), finds the localized URL pattern (e.g., "/produits/123").
+*/
+const getLocalizedPath = (canonicalPath, locale, rewriteRules) => {
+	if (!rewriteRules) return {
+		path: canonicalPath,
+		isRewritten: false
+	};
+	for (const rule of rewriteRules.rules) {
+		const { canonical, localized } = rule;
+		const params = extractParams(canonicalPath, canonical);
+		if (params) {
+			const targetPattern = localized[locale];
+			if (targetPattern) return {
+				path: fillPath(targetPattern, params),
+				isRewritten: true
+			};
+		}
+	}
+	return {
+		path: canonicalPath,
+		isRewritten: false
+	};
+};
+/**
+* Returns the internal path for a given canonical path and locale.
+* Ensures the locale prefix is present exactly once.
+*/
+const getInternalPath = (canonicalPath, locale) => {
+	const pathWithLeadingSlash = canonicalPath.startsWith("/") ? canonicalPath : `/${canonicalPath}`;
+	if (pathWithLeadingSlash.startsWith(`/${locale}/`) || pathWithLeadingSlash === `/${locale}`) return pathWithLeadingSlash;
+	return `/${locale}${pathWithLeadingSlash === "/" ? "" : pathWithLeadingSlash}`;
+};
+/**
+* Given a current pathname and locale, returns the pretty localized path if a rewrite rule exists and the path is not already localized.
+*/
+const getRewritePath = (pathname, locale, rewrite) => {
+	const rules = getRewriteRules(rewrite, "url");
+	if (!rules) return void 0;
+	const { path: localizedPath, isRewritten } = getLocalizedPath(getCanonicalPath(pathname, void 0, rules), locale, rules);
+	if (isRewritten && localizedPath !== pathname) return localizedPath;
+};
+
+//#endregion
+export { getCanonicalPath, getInternalPath, getLocalizedPath, getRewritePath, getRewriteRules };
 //# sourceMappingURL=rewriteUtils.mjs.map

package/dist/esm/localization/rewriteUtils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"rewriteUtils.mjs","names":[],"sources":["../../../src/localization/rewriteUtils.ts"],"sourcesContent":["import type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport type { RewriteObject, RewriteRules, RoutingConfig } from '@intlayer/types/config';\nimport type { Locale } from '@intlayer/types/allLocales';\n\nexport type LocalizedPathResult = {\n  path: string;\n  isRewritten: boolean;\n};\n\n/**\n * Normalizes legacy Record format or extracts specialized rules from RewriteObject.\n */\nexport const getRewriteRules = (\n  rewrite: RoutingConfig['rewrite'],\n  context: keyof RewriteObject = 'url'\n): RewriteRules | undefined => {\n  if (!rewrite) return undefined;\n\n  if ('url' in rewrite) {\n    return (rewrite as RewriteObject)[context];\n  }\n\n  // Normalize legacy format\n  return {\n    rules: Object.entries(rewrite).map(([canonical, localized]) => ({\n      // Normalize canonical path\n      canonical: canonical.startsWith('/')\n        ? canonical.replace(/\\[([^\\]]+)\\]/g, ':$1')\n        : `/${canonical.replace(/\\[([^\\]]+)\\]/g, ':$1')}`,\n\n      // Normalize localized path\n      localized: Object.fromEntries(\n        Object.entries(localized).map(([locale, pattern]) => {\n          const normalizedPattern = pattern?.startsWith('/')\n            ? pattern.replace(/\\[([^\\]]+)\\]/g, ':$1')\n            : `/${(pattern || '').replace(/\\[([^\\]]+)\\]/g, ':$1')}`;\n          return [locale, normalizedPattern];\n        })\n      ),\n    })),\n  };\n};\n\n/**\n * Converts normalized pattern to Regex.\n * Internal syntax supports:\n * - :param -> ([^/]+) (one segment)\n * - :param* -> (.*) (zero or more segments)\n * - :param+ -> (.+) (one or more segments)\n * - :param? -> ([^/]*) (zero or one segment)\n */\nconst patternToRegex = (pattern: string) => {\n  const regexString = pattern\n    .replace(/\\//g, '\\\\/') // Escape slashes\n    .replace(/\\\\\\/:(?:[^/\\\\*+?]+)\\*/g, '(?:\\\\/(.*))?') // /:param*\n    .replace(/\\\\\\/:(?:[^/\\\\*+?]+)\\?/g, '(?:\\\\/([^\\\\/]+))?') // /:param?\n    .replace(/:([^/\\\\*+?]+)\\*/g, '(.*)') // :param* (if no leading slash)\n    .replace(/:([^/\\\\*+?]+)\\?/g, '([^\\\\/]*)') // :param? (if no leading slash)\n    .replace(/:([^/\\\\*+?]+)\\+/g, '(.+)') // :param+\n    .replace(/:([^/\\\\*+?]+)/g, '([^\\\\/]+)'); // :param\n\n  return new RegExp(`^${regexString}$`);\n};\n\n/**\n * Replaces route parameters in a path with provided values.\n */\nconst fillPath = (pattern: string, params: string[]) => {\n  let index = 0;\n  return (\n    pattern\n      .replace(/:([^/\\\\*+?]+)[*+?]?/g, () => params[index++] ?? '')\n      .replace(/\\/+/g, '/')\n      .replace(/\\/$/, '') || '/'\n  );\n};\n\n/**\n * Extract values from a URL based on a pattern.\n */\nconst extractParams = (url: string, pattern: string): string[] | null => {\n  const regex = patternToRegex(pattern);\n  const match = url.match(regex);\n  return match ? match.slice(1) : null;\n};\n\n/**\n * Given a localized URL (e.g., \"/produits/123\"), finds the canonical internal path (e.g., \"/products/123\").\n * If locale is provided, only check for that locale. Otherwise, check for all locales.\n */\nexport const getCanonicalPath = (\n  localizedPath: string,\n  locale?: Locale,\n  rewriteRules?: RewriteRules\n): string => {\n  if (!rewriteRules) return localizedPath;\n\n  for (const rule of rewriteRules.rules) {\n    const { canonical, localized } = rule;\n    const localesToCheck = locale ? [locale] : Object.keys(localized);\n\n    for (const loc of localesToCheck) {\n      const localizedPattern = localized[loc as keyof typeof localized];\n\n      if (!localizedPattern) continue;\n\n      const params = extractParams(localizedPath, localizedPattern);\n\n      if (params) {\n        return fillPath(canonical, params);\n      }\n    }\n  }\n\n  return localizedPath;\n};\n\n/**\n * Given a canonical path (e.g., \"/products/123\"), finds the localized URL pattern (e.g., \"/produits/123\").\n */\nexport const getLocalizedPath = (\n  canonicalPath: string,\n  locale: LocalesValues,\n  rewriteRules?: RewriteRules\n): LocalizedPathResult => {\n  if (!rewriteRules) return { path: canonicalPath, isRewritten: false };\n\n  for (const rule of rewriteRules.rules) {\n    const { canonical, localized } = rule;\n\n    // Check if the input path matches a configured canonical pattern\n    const params = extractParams(canonicalPath, canonical);\n\n    if (params) {\n      const targetPattern = localized[locale as keyof typeof localized];\n\n      if (targetPattern) {\n        return {\n          path: fillPath(targetPattern, params),\n          isRewritten: true,\n        };\n      }\n    }\n  }\n\n  return { path: canonicalPath, isRewritten: false };\n};\n\n/**\n * Returns the internal path for a given canonical path and locale.\n * Ensures the locale prefix is present exactly once.\n */\nexport const getInternalPath = (\n  canonicalPath: string,\n  locale: Locale\n): string => {\n  const pathWithLeadingSlash = canonicalPath.startsWith('/')\n    ? canonicalPath\n    : `/${canonicalPath}`;\n\n  if (\n    pathWithLeadingSlash.startsWith(`/${locale}/`) ||\n    pathWithLeadingSlash === `/${locale}`\n  ) {\n    return pathWithLeadingSlash;\n  }\n\n  return `/${locale}${pathWithLeadingSlash === '/' ? '' : pathWithLeadingSlash}`;\n};\n\n/**\n * Given a current pathname and locale, returns the pretty localized path if a rewrite rule exists and the path is not already localized.\n */\nexport const getRewritePath = (\n  pathname: string,\n  locale: Locale,\n  rewrite?: RoutingConfig['rewrite']\n): string | undefined => {\n  const rules = getRewriteRules(rewrite, 'url');\n  if (!rules) return undefined;\n\n  // Identify canonical path (relative to root, no locale prefix expected in 'url' context)\n  const canonicalPath = getCanonicalPath(pathname, undefined, rules);\n\n  // Get the localized path for the current locale\n  const { path: localizedPath, isRewritten } = getLocalizedPath(\n    canonicalPath,\n    locale,\n    rules\n  );\n\n  if (isRewritten && localizedPath !== pathname) {\n    return localizedPath;\n  }\n\n  return undefined;\n};\n"],"mappings":"AAYA,MAAa,GACX,EACA,EAA+B,QACF,CACxB,KAOL,MALI,QAAS,EACH,EAA0B,GAI7B,CACL,MAAO,OAAO,QAAQ,EAAQ,CAAC,KAAK,CAAC,EAAW,MAAgB,CAE9D,UAAW,EAAU,WAAW,IAAI,CAChC,EAAU,QAAQ,gBAAiB,MAAM,CACzC,IAAI,EAAU,QAAQ,gBAAiB,MAAM,GAGjD,UAAW,OAAO,YAChB,OAAO,QAAQ,EAAU,CAAC,KAAK,CAAC,EAAQ,KAI/B,CAAC,EAHkB,GAAS,WAAW,IAAI,CAC9C,EAAQ,QAAQ,gBAAiB,MAAM,CACvC,KAAK,GAAW,IAAI,QAAQ,gBAAiB,MAAM,GACrB,CAClC,CACH,CACF,EAAE,CACJ,EAWG,EAAkB,GAAoB,CAC1C,IAAM,EAAc,EACjB,QAAQ,MAAO,MAAM,CACrB,QAAQ,yBAA0B,eAAe,CACjD,QAAQ,yBAA0B,oBAAoB,CACtD,QAAQ,mBAAoB,OAAO,CACnC,QAAQ,mBAAoB,YAAY,CACxC,QAAQ,mBAAoB,OAAO,CACnC,QAAQ,iBAAkB,YAAY,CAEzC,OAAW,OAAO,IAAI,EAAY,GAAG,EAMjC,GAAY,EAAiB,IAAqB,CACtD,IAAI,EAAQ,EACZ,OACE,EACG,QAAQ,2BAA8B,EAAO,MAAY,GAAG,CAC5D,QAAQ,OAAQ,IAAI,CACpB,QAAQ,MAAO,GAAG,EAAI,KAOvB,GAAiB,EAAa,IAAqC,CACvE,IAAM,EAAQ,EAAe,EAAQ,CAC/B,EAAQ,EAAI,MAAM,EAAM,CAC9B,OAAO,EAAQ,EAAM,MAAM,EAAE,CAAG,MAOrB,GACX,EACA,EACA,IACW,CACX,GAAI,CAAC,EAAc,OAAO,EAE1B,IAAK,IAAM,KAAQ,EAAa,MAAO,CACrC,GAAM,CAAE,YAAW,aAAc,EAC3B,EAAiB,EAAS,CAAC,EAAO,CAAG,OAAO,KAAK,EAAU,CAEjE,IAAK,IAAM,KAAO,EAAgB,CAChC,IAAM,EAAmB,EAAU,GAEnC,GAAI,CAAC,EAAkB,SAEvB,IAAM,EAAS,EAAc,EAAe,EAAiB,CAE7D,GAAI,EACF,OAAO,EAAS,EAAW,EAAO,EAKxC,OAAO,GAMI,GACX,EACA,EACA,IACwB,CACxB,GAAI,CAAC,EAAc,MAAO,CAAE,KAAM,EAAe,YAAa,GAAO,CAErE,IAAK,IAAM,KAAQ,EAAa,MAAO,CACrC,GAAM,CAAE,YAAW,aAAc,EAG3B,EAAS,EAAc,EAAe,EAAU,CAEtD,GAAI,EAAQ,CACV,IAAM,EAAgB,EAAU,GAEhC,GAAI,EACF,MAAO,CACL,KAAM,EAAS,EAAe,EAAO,CACrC,YAAa,GACd,EAKP,MAAO,CAAE,KAAM,EAAe,YAAa,GAAO,EAOvC,GACX,EACA,IACW,CACX,IAAM,EAAuB,EAAc,WAAW,IAAI,CACtD,EACA,IAAI,IASR,OANE,EAAqB,WAAW,IAAI,EAAO,GAAG,EAC9C,IAAyB,IAAI,IAEtB,EAGF,IAAI,IAAS,IAAyB,IAAM,GAAK,KAM7C,GACX,EACA,EACA,IACuB,CACvB,IAAM,EAAQ,EAAgB,EAAS,MAAM,CAC7C,GAAI,CAAC,EAAO,OAMZ,GAAM,CAAE,KAAM,EAAe,eAAgB,EAHvB,EAAiB,EAAU,IAAA,GAAW,EAAM,CAKhE,EACA,EACD,CAED,GAAI,GAAe,IAAkB,EACnC,OAAO"}
+{"version":3,"file":"rewriteUtils.mjs","names":[],"sources":["../../../src/localization/rewriteUtils.ts"],"sourcesContent":["import type { Locale } from '@intlayer/types/allLocales';\nimport type {\n  RewriteObject,\n  RewriteRules,\n  RoutingConfig,\n} from '@intlayer/types/config';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\n\nexport type LocalizedPathResult = {\n  path: string;\n  isRewritten: boolean;\n};\n\n/**\n * Normalizes legacy Record format or extracts specialized rules from RewriteObject.\n */\nexport const getRewriteRules = (\n  rewrite: RoutingConfig['rewrite'],\n  context: keyof RewriteObject = 'url'\n): RewriteRules | undefined => {\n  if (!rewrite) return undefined;\n\n  if ('url' in rewrite) {\n    return (rewrite as RewriteObject)[context];\n  }\n\n  // Normalize legacy format\n  return {\n    rules: Object.entries(rewrite).map(([canonical, localized]) => ({\n      // Normalize canonical path\n      canonical: canonical.startsWith('/')\n        ? canonical.replace(/\\[([^\\]]+)\\]/g, ':$1')\n        : `/${canonical.replace(/\\[([^\\]]+)\\]/g, ':$1')}`,\n\n      // Normalize localized path\n      localized: Object.fromEntries(\n        Object.entries(localized).map(([locale, pattern]) => {\n          const normalizedPattern = pattern?.startsWith('/')\n            ? pattern.replace(/\\[([^\\]]+)\\]/g, ':$1')\n            : `/${(pattern || '').replace(/\\[([^\\]]+)\\]/g, ':$1')}`;\n          return [locale, normalizedPattern];\n        })\n      ),\n    })),\n  };\n};\n\n/**\n * Converts normalized pattern to Regex.\n * Internal syntax supports:\n * - :param -> ([^/]+) (one segment)\n * - :param* -> (.*) (zero or more segments)\n * - :param+ -> (.+) (one or more segments)\n * - :param? -> ([^/]*) (zero or one segment)\n */\nconst patternToRegex = (pattern: string) => {\n  const regexString = pattern\n    .replace(/\\//g, '\\\\/') // Escape slashes\n    .replace(/\\\\\\/:(?:[^/\\\\*+?]+)\\*/g, '(?:\\\\/(.*))?') // /:param*\n    .replace(/\\\\\\/:(?:[^/\\\\*+?]+)\\?/g, '(?:\\\\/([^\\\\/]+))?') // /:param?\n    .replace(/:([^/\\\\*+?]+)\\*/g, '(.*)') // :param* (if no leading slash)\n    .replace(/:([^/\\\\*+?]+)\\?/g, '([^\\\\/]*)') // :param? (if no leading slash)\n    .replace(/:([^/\\\\*+?]+)\\+/g, '(.+)') // :param+\n    .replace(/:([^/\\\\*+?]+)/g, '([^\\\\/]+)'); // :param\n\n  return new RegExp(`^${regexString}$`);\n};\n\n/**\n * Replaces route parameters in a path with provided values.\n */\nconst fillPath = (pattern: string, params: string[]) => {\n  let index = 0;\n  return (\n    pattern\n      .replace(/:([^/\\\\*+?]+)[*+?]?/g, () => params[index++] ?? '')\n      .replace(/\\/+/g, '/')\n      .replace(/\\/$/, '') || '/'\n  );\n};\n\n/**\n * Extract values from a URL based on a pattern.\n */\nconst extractParams = (url: string, pattern: string): string[] | null => {\n  const regex = patternToRegex(pattern);\n  const match = url.match(regex);\n  return match ? match.slice(1) : null;\n};\n\n/**\n * Given a localized URL (e.g., \"/produits/123\"), finds the canonical internal path (e.g., \"/products/123\").\n * If locale is provided, only check for that locale. Otherwise, check for all locales.\n */\nexport const getCanonicalPath = (\n  localizedPath: string,\n  locale?: Locale,\n  rewriteRules?: RewriteRules\n): string => {\n  if (!rewriteRules) return localizedPath;\n\n  for (const rule of rewriteRules.rules) {\n    const { canonical, localized } = rule;\n    const localesToCheck = locale ? [locale] : Object.keys(localized);\n\n    for (const loc of localesToCheck) {\n      const localizedPattern = localized[loc as keyof typeof localized];\n\n      if (!localizedPattern) continue;\n\n      const params = extractParams(localizedPath, localizedPattern);\n\n      if (params) {\n        return fillPath(canonical, params);\n      }\n    }\n  }\n\n  return localizedPath;\n};\n\n/**\n * Given a canonical path (e.g., \"/products/123\"), finds the localized URL pattern (e.g., \"/produits/123\").\n */\nexport const getLocalizedPath = (\n  canonicalPath: string,\n  locale: LocalesValues,\n  rewriteRules?: RewriteRules\n): LocalizedPathResult => {\n  if (!rewriteRules) return { path: canonicalPath, isRewritten: false };\n\n  for (const rule of rewriteRules.rules) {\n    const { canonical, localized } = rule;\n\n    // Check if the input path matches a configured canonical pattern\n    const params = extractParams(canonicalPath, canonical);\n\n    if (params) {\n      const targetPattern = localized[locale as keyof typeof localized];\n\n      if (targetPattern) {\n        return {\n          path: fillPath(targetPattern, params),\n          isRewritten: true,\n        };\n      }\n    }\n  }\n\n  return { path: canonicalPath, isRewritten: false };\n};\n\n/**\n * Returns the internal path for a given canonical path and locale.\n * Ensures the locale prefix is present exactly once.\n */\nexport const getInternalPath = (\n  canonicalPath: string,\n  locale: Locale\n): string => {\n  const pathWithLeadingSlash = canonicalPath.startsWith('/')\n    ? canonicalPath\n    : `/${canonicalPath}`;\n\n  if (\n    pathWithLeadingSlash.startsWith(`/${locale}/`) ||\n    pathWithLeadingSlash === `/${locale}`\n  ) {\n    return pathWithLeadingSlash;\n  }\n\n  return `/${locale}${pathWithLeadingSlash === '/' ? '' : pathWithLeadingSlash}`;\n};\n\n/**\n * Given a current pathname and locale, returns the pretty localized path if a rewrite rule exists and the path is not already localized.\n */\nexport const getRewritePath = (\n  pathname: string,\n  locale: Locale,\n  rewrite?: RoutingConfig['rewrite']\n): string | undefined => {\n  const rules = getRewriteRules(rewrite, 'url');\n  if (!rules) return undefined;\n\n  // Identify canonical path (relative to root, no locale prefix expected in 'url' context)\n  const canonicalPath = getCanonicalPath(pathname, undefined, rules);\n\n  // Get the localized path for the current locale\n  const { path: localizedPath, isRewritten } = getLocalizedPath(\n    canonicalPath,\n    locale,\n    rules\n  );\n\n  if (isRewritten && localizedPath !== pathname) {\n    return localizedPath;\n  }\n\n  return undefined;\n};\n"],"mappings":";;;;AAgBA,MAAa,mBACX,SACA,UAA+B,UACF;AAC7B,KAAI,CAAC,QAAS,QAAO;AAErB,KAAI,SAAS,QACX,QAAQ,QAA0B;AAIpC,QAAO,EACL,OAAO,OAAO,QAAQ,QAAQ,CAAC,KAAK,CAAC,WAAW,gBAAgB;EAE9D,WAAW,UAAU,WAAW,IAAI,GAChC,UAAU,QAAQ,iBAAiB,MAAM,GACzC,IAAI,UAAU,QAAQ,iBAAiB,MAAM;EAGjD,WAAW,OAAO,YAChB,OAAO,QAAQ,UAAU,CAAC,KAAK,CAAC,QAAQ,aAAa;AAInD,UAAO,CAAC,QAHkB,SAAS,WAAW,IAAI,GAC9C,QAAQ,QAAQ,iBAAiB,MAAM,GACvC,KAAK,WAAW,IAAI,QAAQ,iBAAiB,MAAM,GACrB;IAClC,CACH;EACF,EAAE,EACJ;;;;;;;;;;AAWH,MAAM,kBAAkB,YAAoB;CAC1C,MAAM,cAAc,QACjB,QAAQ,OAAO,MAAM,CACrB,QAAQ,0BAA0B,eAAe,CACjD,QAAQ,0BAA0B,oBAAoB,CACtD,QAAQ,oBAAoB,OAAO,CACnC,QAAQ,oBAAoB,YAAY,CACxC,QAAQ,oBAAoB,OAAO,CACnC,QAAQ,kBAAkB,YAAY;AAEzC,QAAO,IAAI,OAAO,IAAI,YAAY,GAAG;;;;;AAMvC,MAAM,YAAY,SAAiB,WAAqB;CACtD,IAAI,QAAQ;AACZ,QACE,QACG,QAAQ,8BAA8B,OAAO,YAAY,GAAG,CAC5D,QAAQ,QAAQ,IAAI,CACpB,QAAQ,OAAO,GAAG,IAAI;;;;;AAO7B,MAAM,iBAAiB,KAAa,YAAqC;CACvE,MAAM,QAAQ,eAAe,QAAQ;CACrC,MAAM,QAAQ,IAAI,MAAM,MAAM;AAC9B,QAAO,QAAQ,MAAM,MAAM,EAAE,GAAG;;;;;;AAOlC,MAAa,oBACX,eACA,QACA,iBACW;AACX,KAAI,CAAC,aAAc,QAAO;AAE1B,MAAK,MAAM,QAAQ,aAAa,OAAO;EACrC,MAAM,EAAE,WAAW,cAAc;EACjC,MAAM,iBAAiB,SAAS,CAAC,OAAO,GAAG,OAAO,KAAK,UAAU;AAEjE,OAAK,MAAM,OAAO,gBAAgB;GAChC,MAAM,mBAAmB,UAAU;AAEnC,OAAI,CAAC,iBAAkB;GAEvB,MAAM,SAAS,cAAc,eAAe,iBAAiB;AAE7D,OAAI,OACF,QAAO,SAAS,WAAW,OAAO;;;AAKxC,QAAO;;;;;AAMT,MAAa,oBACX,eACA,QACA,iBACwB;AACxB,KAAI,CAAC,aAAc,QAAO;EAAE,MAAM;EAAe,aAAa;EAAO;AAErE,MAAK,MAAM,QAAQ,aAAa,OAAO;EACrC,MAAM,EAAE,WAAW,cAAc;EAGjC,MAAM,SAAS,cAAc,eAAe,UAAU;AAEtD,MAAI,QAAQ;GACV,MAAM,gBAAgB,UAAU;AAEhC,OAAI,cACF,QAAO;IACL,MAAM,SAAS,eAAe,OAAO;IACrC,aAAa;IACd;;;AAKP,QAAO;EAAE,MAAM;EAAe,aAAa;EAAO;;;;;;AAOpD,MAAa,mBACX,eACA,WACW;CACX,MAAM,uBAAuB,cAAc,WAAW,IAAI,GACtD,gBACA,IAAI;AAER,KACE,qBAAqB,WAAW,IAAI,OAAO,GAAG,IAC9C,yBAAyB,IAAI,SAE7B,QAAO;AAGT,QAAO,IAAI,SAAS,yBAAyB,MAAM,KAAK;;;;;AAM1D,MAAa,kBACX,UACA,QACA,YACuB;CACvB,MAAM,QAAQ,gBAAgB,SAAS,MAAM;AAC7C,KAAI,CAAC,MAAO,QAAO;CAMnB,MAAM,EAAE,MAAM,eAAe,gBAAgB,iBAHvB,iBAAiB,UAAU,QAAW,MAAM,EAKhE,QACA,MACD;AAED,KAAI,eAAe,kBAAkB,SACnC,QAAO"}