@intlayer/core 7.0.9-canary.0 → 7.0.9-canary.3

package/dist/esm/localization/getLocalizedUrl.mjs

@@ -1,4 +1,6 @@
-import { getMultilingualUrls } from "./getMultilingualUrls.mjs";
+import { checkIsURLAbsolute } from "../utils/checkIsURLAbsolute.mjs";
+import { getPathWithoutLocale } from "./getPathWithoutLocale.mjs";
+import { DefaultValues } from "@intlayer/config/client";
 import configuration from "@intlayer/config/built";
 
 //#region src/localization/getLocalizedUrl.ts
@@ -12,33 +14,54 @@ import configuration from "@intlayer/config/built";
 *
 * ```ts
 *  // prefix-no-default mode
-*  getLocalizedUrl('/about', 'fr', ['en', 'fr'], 'en', 'prefix-no-default');
+*  getLocalizedUrl('/about', 'fr', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'prefix-no-default' });
 *  // Returns '/fr/about' for the French locale
 *  // Returns '/about' for the English locale (default)
 *
 *  // prefix-all mode
-*  getLocalizedUrl('/about', 'en', ['en', 'fr'], 'en', 'prefix-all');
+*  getLocalizedUrl('/about', 'en', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'prefix-all' });
 *  // Returns '/en/about' for the English locale
 *  // Returns '/fr/about' for the French locale
 *
 *  // search-params mode
-*  getLocalizedUrl('/about', 'fr', ['en', 'fr'], 'en', 'search-params');
+*  getLocalizedUrl('/about', 'fr', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'search-params' });
 *  // Returns '/about?locale=fr' for the French locale
 *
 *  // no-prefix mode
-*  getLocalizedUrl('/about', 'fr', ['en', 'fr'], 'en', 'no-prefix');
+*  getLocalizedUrl('/about', 'fr', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'no-prefix' });
 *  // Returns '/about' for any locale
 * ```
 *
 * @param url - The original URL string to be processed.
 * @param currentLocale - The current locale.
-* @param locales - Optional array of supported locales. Defaults to configured locales.
-* @param defaultLocale - The default locale. Defaults to configured default locale.
-* @param mode - URL routing mode for locale handling. Defaults to configured mode.
+* @param options - Configuration options
+* @param options.locales - Optional array of supported locales. Defaults to configured locales.
+* @param options.defaultLocale - The default locale. Defaults to configured default locale.
+* @param options.mode - URL routing mode for locale handling. Defaults to configured mode.
 * @returns The localized URL for the current locale.
 */
-const getLocalizedUrl = (url, currentLocale, locales = configuration?.internationalization?.locales, defaultLocale = configuration?.internationalization?.defaultLocale, mode = configuration?.routing?.mode) => {
-	return getMultilingualUrls(url, locales, defaultLocale, mode)[currentLocale] ?? url;
+const getLocalizedUrl = (url, currentLocale, options = {}) => {
+	const { locales = configuration?.internationalization?.locales ?? DefaultValues.Internationalization.LOCALES, defaultLocale = configuration?.internationalization?.defaultLocale ?? DefaultValues.Internationalization.DEFAULT_LOCALE, mode = configuration?.routing?.mode ?? DefaultValues.Routing.ROUTING_MODE } = options;
+	const urlWithoutLocale = getPathWithoutLocale(url, locales);
+	if (mode === "no-prefix") return urlWithoutLocale;
+	const isAbsoluteUrl = checkIsURLAbsolute(urlWithoutLocale);
+	const parsedUrl = isAbsoluteUrl ? new URL(urlWithoutLocale) : new URL(urlWithoutLocale, "http://example.com");
+	let pathname = parsedUrl.pathname;
+	if (!pathname.startsWith("/")) pathname = `/${pathname}`;
+	const baseUrl = isAbsoluteUrl ? `${parsedUrl.protocol}//${parsedUrl.host}` : "";
+	if (mode === "search-params") {
+		const searchParams = new URLSearchParams(parsedUrl.search);
+		searchParams.set("locale", currentLocale.toString());
+		const queryString = searchParams.toString();
+		const pathWithQuery = queryString ? `${pathname}?${queryString}` : pathname;
+		if (isAbsoluteUrl) return `${baseUrl}${pathWithQuery}${parsedUrl.hash}`;
+		return `${pathWithQuery}${parsedUrl.hash}`;
+	}
+	const isDefaultLocale = currentLocale?.toString() === defaultLocale?.toString();
+	let localizedPath = mode === "prefix-all" || mode === "prefix-no-default" && !isDefaultLocale ? `/${currentLocale}${pathname}` : pathname;
+	if (localizedPath.length > 1 && localizedPath.endsWith("/")) localizedPath = localizedPath.slice(0, -1);
+	if (isAbsoluteUrl) return `${baseUrl}${localizedPath}${parsedUrl.search}${parsedUrl.hash}`;
+	return `${localizedPath}${parsedUrl.search}${parsedUrl.hash}`;
 };
 
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"getLocalizedUrl.mjs","names":[],"sources":["../../../src/localization/getLocalizedUrl.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { LocalesValues } from '@intlayer/types';\nimport { getMultilingualUrls } from './getMultilingualUrls';\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', ['en', 'fr'], 'en', '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', ['en', 'fr'], 'en', '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', ['en', 'fr'], 'en', 'search-params');\n *  // Returns '/about?locale=fr' for the French locale\n *\n *  // no-prefix mode\n *  getLocalizedUrl('/about', 'fr', ['en', 'fr'], 'en', '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 locales - Optional array of supported locales. Defaults to configured locales.\n * @param defaultLocale - The default locale. Defaults to configured default locale.\n * @param mode - URL routing mode for locale handling. Defaults to configured mode.\n * @returns The localized URL for the current locale.\n */\nexport const getLocalizedUrl = (\n  url: string,\n  currentLocale: LocalesValues,\n  locales: LocalesValues[] | undefined = configuration?.internationalization\n    ?.locales,\n  defaultLocale: LocalesValues | undefined = configuration?.internationalization\n    ?.defaultLocale,\n  mode:\n    | 'prefix-no-default'\n    | 'prefix-all'\n    | 'no-prefix'\n    | 'search-params'\n    | undefined = configuration?.routing?.mode\n): string => {\n  // Get all multilingual URLs\n  const urlWithoutLocale = getMultilingualUrls(\n    url,\n    locales,\n    defaultLocale,\n    mode\n  );\n\n  return (\n    urlWithoutLocale[\n      currentLocale as unknown as keyof typeof urlWithoutLocale\n    ] ?? url\n  );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,MAAa,mBACX,KACA,eACA,UAAuC,eAAe,sBAClD,SACJ,gBAA2C,eAAe,sBACtD,eACJ,OAKgB,eAAe,SAAS,SAC7B;AASX,QAPyB,oBACvB,KACA,SACA,eACA,KACD,CAIG,kBACG"}
+{"version":3,"file":"getLocalizedUrl.mjs","names":[],"sources":["../../../src/localization/getLocalizedUrl.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport { DefaultValues } from '@intlayer/config/client';\nimport type { LocalesValues } from '@intlayer/types';\nimport { checkIsURLAbsolute } from '../utils/checkIsURLAbsolute';\nimport { getPathWithoutLocale } from './getPathWithoutLocale';\n\n/**\n * Generate URL by prefixing the given URL with the referenced locale or adding search parameters\n * based on the routing mode. Handles both absolute and relative URLs appropriately.\n *\n * This function gets the locales, default locale, and routing mode from the configuration if not provided.\n *\n * Example:\n *\n * ```ts\n *  // prefix-no-default mode\n *  getLocalizedUrl('/about', 'fr', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'prefix-no-default' });\n *  // Returns '/fr/about' for the French locale\n *  // Returns '/about' for the English locale (default)\n *\n *  // prefix-all mode\n *  getLocalizedUrl('/about', 'en', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'prefix-all' });\n *  // Returns '/en/about' for the English locale\n *  // Returns '/fr/about' for the French locale\n *\n *  // search-params mode\n *  getLocalizedUrl('/about', 'fr', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'search-params' });\n *  // Returns '/about?locale=fr' for the French locale\n *\n *  // no-prefix mode\n *  getLocalizedUrl('/about', 'fr', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'no-prefix' });\n *  // Returns '/about' for any locale\n * ```\n *\n * @param url - The original URL string to be processed.\n * @param currentLocale - The current locale.\n * @param options - Configuration options\n * @param options.locales - Optional array of supported locales. Defaults to configured locales.\n * @param options.defaultLocale - The default locale. Defaults to configured default locale.\n * @param options.mode - URL routing mode for locale handling. Defaults to configured mode.\n * @returns The localized URL for the current locale.\n */\nexport const getLocalizedUrl = (\n  url: string,\n  currentLocale: LocalesValues,\n  options: {\n    locales?: LocalesValues[];\n    defaultLocale?: LocalesValues;\n    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';\n  } = {}\n): string => {\n  const {\n    locales = configuration?.internationalization?.locales ??\n      DefaultValues.Internationalization.LOCALES,\n    defaultLocale = configuration?.internationalization?.defaultLocale ??\n      DefaultValues.Internationalization.DEFAULT_LOCALE,\n    mode = configuration?.routing?.mode ?? DefaultValues.Routing.ROUTING_MODE,\n  } = options;\n  // Remove any existing locale segment from the URL\n  const urlWithoutLocale = getPathWithoutLocale(url, locales);\n\n  if (mode === 'no-prefix') {\n    // No locale prefixing\n    return urlWithoutLocale;\n  }\n\n  // Determine if the original URL is absolute (includes protocol)\n  const isAbsoluteUrl = checkIsURLAbsolute(urlWithoutLocale);\n\n  // Initialize a URL object if the URL is absolute\n  // For relative URLs, use a dummy base to leverage the URL API\n  const parsedUrl = isAbsoluteUrl\n    ? new URL(urlWithoutLocale)\n    : new URL(urlWithoutLocale, 'http://example.com');\n\n  // Extract the pathname from the parsed URL\n  let pathname = parsedUrl.pathname;\n\n  // Ensure the pathname starts with a '/'\n  if (!pathname.startsWith('/')) {\n    pathname = `/${pathname}`;\n  }\n\n  // Prepare the base URL (protocol + host) if it's absolute\n  const baseUrl = isAbsoluteUrl\n    ? `${parsedUrl.protocol}//${parsedUrl.host}`\n    : '';\n\n  if (mode === 'search-params') {\n    // Use search parameters for locale handling\n    const searchParams = new URLSearchParams(parsedUrl.search);\n    searchParams.set('locale', currentLocale.toString());\n\n    const queryString = searchParams.toString();\n    const pathWithQuery = queryString ? `${pathname}?${queryString}` : pathname;\n\n    if (isAbsoluteUrl) {\n      return `${baseUrl}${pathWithQuery}${parsedUrl.hash}`;\n    }\n\n    return `${pathWithQuery}${parsedUrl.hash}`;\n  }\n\n  // Prefix-based routing (prefix-all or prefix-no-default)\n  const isDefaultLocale =\n    currentLocale?.toString() === defaultLocale?.toString();\n\n  const shouldPrefix =\n    mode === 'prefix-all' || (mode === 'prefix-no-default' && !isDefaultLocale);\n\n  // Construct the new pathname with or without the locale prefix\n  let localizedPath = shouldPrefix ? `/${currentLocale}${pathname}` : pathname;\n\n  // Remove trailing slash for non-root paths\n  if (localizedPath.length > 1 && localizedPath.endsWith('/')) {\n    localizedPath = localizedPath.slice(0, -1);\n  }\n\n  // Combine with the base URL if the original URL was absolute\n  if (isAbsoluteUrl) {\n    return `${baseUrl}${localizedPath}${parsedUrl.search}${parsedUrl.hash}`;\n  }\n\n  return `${localizedPath}${parsedUrl.search}${parsedUrl.hash}`;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0CA,MAAa,mBACX,KACA,eACA,UAII,EAAE,KACK;CACX,MAAM,EACJ,UAAU,eAAe,sBAAsB,WAC7C,cAAc,qBAAqB,SACrC,gBAAgB,eAAe,sBAAsB,iBACnD,cAAc,qBAAqB,gBACrC,OAAO,eAAe,SAAS,QAAQ,cAAc,QAAQ,iBAC3D;CAEJ,MAAM,mBAAmB,qBAAqB,KAAK,QAAQ;AAE3D,KAAI,SAAS,YAEX,QAAO;CAIT,MAAM,gBAAgB,mBAAmB,iBAAiB;CAI1D,MAAM,YAAY,gBACd,IAAI,IAAI,iBAAiB,GACzB,IAAI,IAAI,kBAAkB,qBAAqB;CAGnD,IAAI,WAAW,UAAU;AAGzB,KAAI,CAAC,SAAS,WAAW,IAAI,CAC3B,YAAW,IAAI;CAIjB,MAAM,UAAU,gBACZ,GAAG,UAAU,SAAS,IAAI,UAAU,SACpC;AAEJ,KAAI,SAAS,iBAAiB;EAE5B,MAAM,eAAe,IAAI,gBAAgB,UAAU,OAAO;AAC1D,eAAa,IAAI,UAAU,cAAc,UAAU,CAAC;EAEpD,MAAM,cAAc,aAAa,UAAU;EAC3C,MAAM,gBAAgB,cAAc,GAAG,SAAS,GAAG,gBAAgB;AAEnE,MAAI,cACF,QAAO,GAAG,UAAU,gBAAgB,UAAU;AAGhD,SAAO,GAAG,gBAAgB,UAAU;;CAItC,MAAM,kBACJ,eAAe,UAAU,KAAK,eAAe,UAAU;CAMzD,IAAI,gBAHF,SAAS,gBAAiB,SAAS,uBAAuB,CAAC,kBAG1B,IAAI,gBAAgB,aAAa;AAGpE,KAAI,cAAc,SAAS,KAAK,cAAc,SAAS,IAAI,CACzD,iBAAgB,cAAc,MAAM,GAAG,GAAG;AAI5C,KAAI,cACF,QAAO,GAAG,UAAU,gBAAgB,UAAU,SAAS,UAAU;AAGnE,QAAO,GAAG,gBAAgB,UAAU,SAAS,UAAU"}

package/dist/esm/localization/getMultilingualUrls.mjs

@@ -1,6 +1,4 @@
-import { checkIsURLAbsolute } from "../utils/checkIsURLAbsolute.mjs";
-import { getPathWithoutLocale } from "./getPathWithoutLocale.mjs";
-import { DefaultValues } from "@intlayer/config/client";
+import { getLocalizedUrl } from "./getLocalizedUrl.mjs";
 import configuration from "@intlayer/config/built";
 
 //#region src/localization/getMultilingualUrls.ts
@@ -15,52 +13,37 @@ import configuration from "@intlayer/config/built";
 *
 * ```ts
 *  // prefix-no-default mode
-*  getMultilingualUrls('/dashboard', ['en', 'fr'], 'en', 'prefix-no-default')
+*  getMultilingualUrls('/dashboard', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'prefix-no-default' })
 *     // Returns { en: '/dashboard', fr: '/fr/dashboard' }
 *
 *  // prefix-all mode
-*  getMultilingualUrls('/dashboard', ['en', 'fr'], 'en', 'prefix-all')
+*  getMultilingualUrls('/dashboard', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'prefix-all' })
 *     // Returns { en: '/en/dashboard', fr: '/fr/dashboard' }
 *
 *  // search-params mode
-*  getMultilingualUrls('/dashboard', ['en', 'fr'], 'en', 'search-params')
+*  getMultilingualUrls('/dashboard', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'search-params' })
 *     // Returns { en: '/dashboard?locale=en', fr: '/dashboard?locale=fr' }
 *
 *  // no-prefix mode
-*  getMultilingualUrls('/dashboard', ['en', 'fr'], 'en', 'no-prefix')
+*  getMultilingualUrls('/dashboard', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'no-prefix' })
 *     // Returns { en: '/dashboard', fr: '/dashboard' }
 * ```
 *
 * @param url - The original URL string to be processed.
-* @param locales - Optional array of supported locales. Defaults to configured locales.
-* @param defaultLocale - The default locale. Defaults to configured default locale.
-* @param mode - URL routing mode for locale handling. Defaults to configured mode.
+* @param options - Configuration options
+* @param options.locales - Optional array of supported locales. Defaults to configured locales.
+* @param options.defaultLocale - The default locale. Defaults to configured default locale.
+* @param options.mode - URL routing mode for locale handling. Defaults to configured mode.
 * @returns An object mapping each locale to its corresponding multilingual URL.
 */
-const getMultilingualUrls = (url, locales = configuration?.internationalization?.locales, defaultLocale = configuration?.internationalization?.defaultLocale, mode = configuration?.routing?.mode) => {
-	const urlWithoutLocale = getPathWithoutLocale(url, locales);
-	const isAbsoluteUrl = checkIsURLAbsolute(urlWithoutLocale);
-	const parsedUrl = isAbsoluteUrl ? new URL(urlWithoutLocale) : new URL(urlWithoutLocale, "http://example.com");
-	let pathname = parsedUrl.pathname;
-	if (!pathname.startsWith("/")) pathname = `/${pathname}`;
-	const baseUrl = isAbsoluteUrl ? `${parsedUrl.protocol}//${parsedUrl.host}` : "";
-	const routingMode = mode ?? DefaultValues.Routing.ROUTING_MODE;
+const getMultilingualUrls = (url, options = {}) => {
+	const { locales = configuration?.internationalization?.locales, defaultLocale = configuration?.internationalization?.defaultLocale, mode = configuration?.routing?.mode } = options;
 	return (locales ?? []).reduce((acc, locale) => {
-		const isDefaultLocale = locale?.toString() === defaultLocale?.toString();
-		let localizedUrl;
-		if (routingMode === "search-params") {
-			const searchParams = new URLSearchParams(parsedUrl.search);
-			searchParams.set("locale", locale.toString());
-			const queryString = searchParams.toString();
-			const pathWithQuery = queryString ? `${pathname}?${queryString}` : pathname;
-			localizedUrl = isAbsoluteUrl ? `${baseUrl}${pathWithQuery}${parsedUrl.hash}` : `${pathWithQuery}${parsedUrl.hash}`;
-		} else if (routingMode === "no-prefix") localizedUrl = isAbsoluteUrl ? `${baseUrl}${pathname}${parsedUrl.search}${parsedUrl.hash}` : `${pathname}${parsedUrl.search}${parsedUrl.hash}`;
-		else {
-			let localizedPath = routingMode === "prefix-all" || routingMode === "prefix-no-default" && !isDefaultLocale ? `/${locale}${pathname}` : pathname;
-			if (localizedPath.length > 1 && localizedPath.endsWith("/")) localizedPath = localizedPath.slice(0, -1);
-			localizedUrl = isAbsoluteUrl ? `${baseUrl}${localizedPath}${parsedUrl.search}${parsedUrl.hash}` : `${localizedPath}${parsedUrl.search}${parsedUrl.hash}`;
-		}
-		acc[locale] = localizedUrl;
+		acc[locale] = getLocalizedUrl(url, locale, {
+			locales,
+			defaultLocale,
+			mode
+		});
 		return acc;
 	}, {});
 };

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

@@ -1 +1 @@
-{"version":3,"file":"getMultilingualUrls.mjs","names":["localizedUrl: string"],"sources":["../../../src/localization/getMultilingualUrls.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport { DefaultValues } from '@intlayer/config/client';\nimport type { LocalesValues, StrictModeLocaleMap } from '@intlayer/types';\nimport { checkIsURLAbsolute } from '../utils/checkIsURLAbsolute';\nimport { getPathWithoutLocale } from './getPathWithoutLocale';\n\n/**\n * Generates multilingual URLs by prefixing the given URL with each supported locale\n * or adding search parameters based on the routing mode.\n * Handles both absolute and relative URLs appropriately.\n *\n * This function gets the locales, default locale, and routing mode from the configuration if not provided.\n *\n * Example:\n *\n * ```ts\n *  // prefix-no-default mode\n *  getMultilingualUrls('/dashboard', ['en', 'fr'], 'en', 'prefix-no-default')\n *     // Returns { en: '/dashboard', fr: '/fr/dashboard' }\n *\n *  // prefix-all mode\n *  getMultilingualUrls('/dashboard', ['en', 'fr'], 'en', 'prefix-all')\n *     // Returns { en: '/en/dashboard', fr: '/fr/dashboard' }\n *\n *  // search-params mode\n *  getMultilingualUrls('/dashboard', ['en', 'fr'], 'en', 'search-params')\n *     // Returns { en: '/dashboard?locale=en', fr: '/dashboard?locale=fr' }\n *\n *  // no-prefix mode\n *  getMultilingualUrls('/dashboard', ['en', 'fr'], 'en', 'no-prefix')\n *     // Returns { en: '/dashboard', fr: '/dashboard' }\n * ```\n *\n * @param url - The original URL string to be processed.\n * @param locales - Optional array of supported locales. Defaults to configured locales.\n * @param defaultLocale - The default locale. Defaults to configured default locale.\n * @param mode - URL routing mode for locale handling. Defaults to configured mode.\n * @returns An object mapping each locale to its corresponding multilingual URL.\n */\nexport const getMultilingualUrls = (\n  url: string,\n  locales: LocalesValues[] | undefined = configuration?.internationalization\n    ?.locales,\n  defaultLocale: LocalesValues | undefined = configuration?.internationalization\n    ?.defaultLocale,\n  mode:\n    | 'prefix-no-default'\n    | 'prefix-all'\n    | 'no-prefix'\n    | 'search-params'\n    | undefined = configuration?.routing?.mode\n): StrictModeLocaleMap<string> => {\n  // Remove any existing locale segment from the URL\n  const urlWithoutLocale = getPathWithoutLocale(url, locales);\n\n  // Determine if the original URL is absolute (includes protocol)\n  const isAbsoluteUrl = checkIsURLAbsolute(urlWithoutLocale);\n\n  // Initialize a URL object if the URL is absolute\n  // For relative URLs, use a dummy base to leverage the URL API\n  const parsedUrl = isAbsoluteUrl\n    ? new URL(urlWithoutLocale)\n    : new URL(urlWithoutLocale, 'http://example.com');\n\n  // Extract the pathname from the parsed URL\n  let pathname = parsedUrl.pathname;\n\n  // Ensure the pathname starts with a '/'\n  if (!pathname.startsWith('/')) {\n    pathname = `/${pathname}`;\n  }\n\n  // Prepare the base URL (protocol + host) if it's absolute\n  const baseUrl = isAbsoluteUrl\n    ? `${parsedUrl.protocol}//${parsedUrl.host}`\n    : '';\n\n  // Default mode to 'prefix-no-default' if not provided\n  const routingMode = mode ?? DefaultValues.Routing.ROUTING_MODE;\n\n  // Generate multilingual URLs by iterating over each locale\n  const multilingualUrls = (locales ?? []).reduce<StrictModeLocaleMap<string>>(\n    (acc, locale) => {\n      // Determine if the current locale is the default locale\n      const isDefaultLocale = locale?.toString() === defaultLocale?.toString();\n\n      let localizedUrl: string;\n\n      if (routingMode === 'search-params') {\n        // Use search parameters for locale handling\n        const searchParams = new URLSearchParams(parsedUrl.search);\n        searchParams.set('locale', locale.toString());\n\n        const queryString = searchParams.toString();\n        const pathWithQuery = queryString\n          ? `${pathname}?${queryString}`\n          : pathname;\n\n        localizedUrl = isAbsoluteUrl\n          ? `${baseUrl}${pathWithQuery}${parsedUrl.hash}`\n          : `${pathWithQuery}${parsedUrl.hash}`;\n      } else if (routingMode === 'no-prefix') {\n        // No locale prefixing\n        localizedUrl = isAbsoluteUrl\n          ? `${baseUrl}${pathname}${parsedUrl.search}${parsedUrl.hash}`\n          : `${pathname}${parsedUrl.search}${parsedUrl.hash}`;\n      } else {\n        // Handle prefix-based modes (prefix-all or prefix-no-default)\n        const shouldPrefix =\n          routingMode === 'prefix-all' ||\n          (routingMode === 'prefix-no-default' && !isDefaultLocale);\n\n        // Construct the new pathname with or without the locale prefix\n        let localizedPath = shouldPrefix ? `/${locale}${pathname}` : pathname;\n\n        if (localizedPath.length > 1 && localizedPath.endsWith('/')) {\n          localizedPath = localizedPath.slice(0, -1);\n        }\n\n        // Combine with the base URL if the original URL was absolute\n        localizedUrl = isAbsoluteUrl\n          ? `${baseUrl}${localizedPath}${parsedUrl.search}${parsedUrl.hash}`\n          : `${localizedPath}${parsedUrl.search}${parsedUrl.hash}`;\n      }\n\n      // Assign the constructed URL to the corresponding locale key\n      acc[locale as unknown as keyof typeof acc] = localizedUrl;\n\n      return acc;\n    },\n    {} as StrictModeLocaleMap<string>\n  );\n\n  return multilingualUrls;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuCA,MAAa,uBACX,KACA,UAAuC,eAAe,sBAClD,SACJ,gBAA2C,eAAe,sBACtD,eACJ,OAKgB,eAAe,SAAS,SACR;CAEhC,MAAM,mBAAmB,qBAAqB,KAAK,QAAQ;CAG3D,MAAM,gBAAgB,mBAAmB,iBAAiB;CAI1D,MAAM,YAAY,gBACd,IAAI,IAAI,iBAAiB,GACzB,IAAI,IAAI,kBAAkB,qBAAqB;CAGnD,IAAI,WAAW,UAAU;AAGzB,KAAI,CAAC,SAAS,WAAW,IAAI,CAC3B,YAAW,IAAI;CAIjB,MAAM,UAAU,gBACZ,GAAG,UAAU,SAAS,IAAI,UAAU,SACpC;CAGJ,MAAM,cAAc,QAAQ,cAAc,QAAQ;AAuDlD,SApD0B,WAAW,EAAE,EAAE,QACtC,KAAK,WAAW;EAEf,MAAM,kBAAkB,QAAQ,UAAU,KAAK,eAAe,UAAU;EAExE,IAAIA;AAEJ,MAAI,gBAAgB,iBAAiB;GAEnC,MAAM,eAAe,IAAI,gBAAgB,UAAU,OAAO;AAC1D,gBAAa,IAAI,UAAU,OAAO,UAAU,CAAC;GAE7C,MAAM,cAAc,aAAa,UAAU;GAC3C,MAAM,gBAAgB,cAClB,GAAG,SAAS,GAAG,gBACf;AAEJ,kBAAe,gBACX,GAAG,UAAU,gBAAgB,UAAU,SACvC,GAAG,gBAAgB,UAAU;aACxB,gBAAgB,YAEzB,gBAAe,gBACX,GAAG,UAAU,WAAW,UAAU,SAAS,UAAU,SACrD,GAAG,WAAW,UAAU,SAAS,UAAU;OAC1C;GAOL,IAAI,gBAJF,gBAAgB,gBACf,gBAAgB,uBAAuB,CAAC,kBAGR,IAAI,SAAS,aAAa;AAE7D,OAAI,cAAc,SAAS,KAAK,cAAc,SAAS,IAAI,CACzD,iBAAgB,cAAc,MAAM,GAAG,GAAG;AAI5C,kBAAe,gBACX,GAAG,UAAU,gBAAgB,UAAU,SAAS,UAAU,SAC1D,GAAG,gBAAgB,UAAU,SAAS,UAAU;;AAItD,MAAI,UAAyC;AAE7C,SAAO;IAET,EAAE,CACH"}
+{"version":3,"file":"getMultilingualUrls.mjs","names":[],"sources":["../../../src/localization/getMultilingualUrls.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { LocalesValues, StrictModeLocaleMap } from '@intlayer/types';\nimport { getLocalizedUrl } from './getLocalizedUrl';\n\n/**\n * Generates multilingual URLs by prefixing the given URL with each supported locale\n * or adding search parameters based on the routing mode.\n * Handles both absolute and relative URLs appropriately.\n *\n * This function gets the locales, default locale, and routing mode from the configuration if not provided.\n *\n * Example:\n *\n * ```ts\n *  // prefix-no-default mode\n *  getMultilingualUrls('/dashboard', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'prefix-no-default' })\n *     // Returns { en: '/dashboard', fr: '/fr/dashboard' }\n *\n *  // prefix-all mode\n *  getMultilingualUrls('/dashboard', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'prefix-all' })\n *     // Returns { en: '/en/dashboard', fr: '/fr/dashboard' }\n *\n *  // search-params mode\n *  getMultilingualUrls('/dashboard', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'search-params' })\n *     // Returns { en: '/dashboard?locale=en', fr: '/dashboard?locale=fr' }\n *\n *  // no-prefix mode\n *  getMultilingualUrls('/dashboard', { locales: ['en', 'fr'], defaultLocale: 'en', mode: 'no-prefix' })\n *     // Returns { en: '/dashboard', fr: '/dashboard' }\n * ```\n *\n * @param url - The original URL string to be processed.\n * @param options - Configuration options\n * @param options.locales - Optional array of supported locales. Defaults to configured locales.\n * @param options.defaultLocale - The default locale. Defaults to configured default locale.\n * @param options.mode - URL routing mode for locale handling. Defaults to configured mode.\n * @returns An object mapping each locale to its corresponding multilingual URL.\n */\nexport const getMultilingualUrls = (\n  url: string,\n  options: {\n    locales?: LocalesValues[];\n    defaultLocale?: LocalesValues;\n    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';\n  } = {}\n): StrictModeLocaleMap<string> => {\n  const {\n    locales = configuration?.internationalization?.locales,\n    defaultLocale = configuration?.internationalization?.defaultLocale,\n    mode = configuration?.routing?.mode,\n  } = options;\n\n  // Generate multilingual URLs by iterating over each locale and calling getLocalizedUrl\n  const multilingualUrls = (locales ?? []).reduce<StrictModeLocaleMap<string>>(\n    (acc, locale) => {\n      // Get the localized URL for this locale\n      const localizedUrl = getLocalizedUrl(url, locale, {\n        locales,\n        defaultLocale,\n        mode,\n      });\n\n      // Assign the constructed URL to the corresponding locale key\n      acc[locale as unknown as keyof typeof acc] = localizedUrl;\n\n      return acc;\n    },\n    {} as StrictModeLocaleMap<string>\n  );\n\n  return multilingualUrls;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsCA,MAAa,uBACX,KACA,UAII,EAAE,KAC0B;CAChC,MAAM,EACJ,UAAU,eAAe,sBAAsB,SAC/C,gBAAgB,eAAe,sBAAsB,eACrD,OAAO,eAAe,SAAS,SAC7B;AAoBJ,SAjB0B,WAAW,EAAE,EAAE,QACtC,KAAK,WAAW;AASf,MAAI,UAPiB,gBAAgB,KAAK,QAAQ;GAChD;GACA;GACA;GACD,CAAC;AAKF,SAAO;IAET,EAAE,CACH"}

package/dist/esm/localization/getPrefix.mjs

@@ -0,0 +1,45 @@
+import configuration from "@intlayer/config/built";
+
+//#region src/localization/getPrefix.ts
+/**
+* Determines the URL prefix for a given locale based on the routing mode configuration.
+*
+* Example:
+*
+* ```ts
+*  // prefix-no-default mode with default locale
+*  getPrefix('en', { defaultLocale: 'en', mode: 'prefix-no-default' })
+*     // Returns ''
+*
+*  // prefix-no-default mode with non-default locale
+*  getPrefix('fr', { defaultLocale: 'en', mode: 'prefix-no-default' })
+*     // Returns 'en/'
+*
+*  // prefix-all mode
+*  getPrefix('en', { defaultLocale: 'en', mode: 'prefix-all' })
+*     // Returns 'en/'
+*
+*  // search-params mode
+*  getPrefix('en', { defaultLocale: 'en', mode: 'search-params' })
+*     // Returns ''
+*
+*  // no-prefix mode
+*  getPrefix('en', { defaultLocale: 'en', mode: 'no-prefix' })
+*     // Returns ''
+* ```
+*
+* @param locale - The locale to check for prefix. If not provided, uses configured default locale.
+* @param options - Configuration options
+* @param options.defaultLocale - The default locale. Defaults to configured default locale.
+* @param options.mode - URL routing mode for locale handling. Defaults to configured mode.
+* @param options.addSlash - Whether to add a trailing slash to the prefix. Defaults to true.
+* @returns The prefix string for the given locale (e.g., 'en/', 'fr/') or an empty string.
+*/
+const getPrefix = (locale, options = {}) => {
+	const { defaultLocale = configuration?.internationalization?.defaultLocale, mode = configuration?.routing?.mode, addSlash = true } = options;
+	return mode === "prefix-all" || mode === "prefix-no-default" && defaultLocale !== locale ? `${defaultLocale}${addSlash ? "/" : ""}` : "";
+};
+
+//#endregion
+export { getPrefix };
+//# sourceMappingURL=getPrefix.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getPrefix.mjs","names":[],"sources":["../../../src/localization/getPrefix.ts"],"sourcesContent":["import configuration from '@intlayer/config/built';\nimport type { LocalesValues } from '@intlayer/types';\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 ''\n *\n *  // prefix-no-default mode with non-default locale\n *  getPrefix('fr', { defaultLocale: 'en', mode: 'prefix-no-default' })\n *     // Returns 'en/'\n *\n *  // prefix-all mode\n *  getPrefix('en', { defaultLocale: 'en', mode: 'prefix-all' })\n *     // Returns 'en/'\n *\n *  // search-params mode\n *  getPrefix('en', { defaultLocale: 'en', mode: 'search-params' })\n *     // Returns ''\n *\n *  // no-prefix mode\n *  getPrefix('en', { defaultLocale: 'en', mode: 'no-prefix' })\n *     // Returns ''\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 * @param options.addSlash - Whether to add a trailing slash to the prefix. Defaults to true.\n * @returns The prefix string for the given locale (e.g., 'en/', 'fr/') or an empty string.\n */\nexport const getPrefix = (\n  locale?: LocalesValues,\n  options: {\n    defaultLocale?: LocalesValues;\n    mode?: 'prefix-no-default' | 'prefix-all' | 'no-prefix' | 'search-params';\n    addSlash?: boolean;\n  } = {}\n): string => {\n  const {\n    defaultLocale = configuration?.internationalization?.defaultLocale,\n    mode = configuration?.routing?.mode,\n    addSlash = true,\n  } = options;\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  return shouldPrefix ? `${defaultLocale}${addSlash ? '/' : ''}` : '';\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,MAAa,aACX,QACA,UAII,EAAE,KACK;CACX,MAAM,EACJ,gBAAgB,eAAe,sBAAsB,eACrD,OAAO,eAAe,SAAS,MAC/B,WAAW,SACT;AAOJ,QAHE,SAAS,gBACR,SAAS,uBAAuB,kBAAkB,SAE/B,GAAG,gBAAgB,WAAW,MAAM,OAAO"}

package/dist/esm/localization/index.mjs

@@ -6,8 +6,9 @@ import { getLocaleFromPath } from "./getLocaleFromPath.mjs";
 import { getLocaleLang } from "./getLocaleLang.mjs";
 import { getLocaleName } from "./getLocaleName.mjs";
 import { getPathWithoutLocale } from "./getPathWithoutLocale.mjs";
-import { getMultilingualUrls } from "./getMultilingualUrls.mjs";
 import { getLocalizedUrl } from "./getLocalizedUrl.mjs";
+import { getMultilingualUrls } from "./getMultilingualUrls.mjs";
+import { getPrefix } from "./getPrefix.mjs";
 import { localeFlatMap, localeMap, localeRecord } from "./localeMapper.mjs";
 
-export { getBrowserLocale, getHTMLTextDir, getLocaleFromPath, getLocaleLang, getLocaleName, getLocalizedUrl, getMultilingualUrls, getPathWithoutLocale, localeDetector, localeFlatMap, localeMap, localeRecord, localeResolver, localeStorageOptions };
+export { getBrowserLocale, getHTMLTextDir, getLocaleFromPath, getLocaleLang, getLocaleName, getLocalizedUrl, getMultilingualUrls, getPathWithoutLocale, getPrefix, localeDetector, localeFlatMap, localeMap, localeRecord, localeResolver, localeStorageOptions };

package/dist/esm/types/dist/esm/_virtual/rolldown_runtime.mjs

@@ -0,0 +1,14 @@
+//#region ../types/dist/esm/_virtual/rolldown_runtime.mjs
+var __defProp = Object.defineProperty;
+var __export = (all) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	return target;
+};
+
+//#endregion
+export { __export };
+//# sourceMappingURL=rolldown_runtime.mjs.map

package/dist/esm/types/dist/esm/_virtual/rolldown_runtime.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"rolldown_runtime.mjs","names":[],"sources":["../../../../../../../types/dist/esm/_virtual/rolldown_runtime.mjs"],"sourcesContent":["//#region rolldown:runtime\nvar __defProp = Object.defineProperty;\nvar __export = (all) => {\n\tlet target = {};\n\tfor (var name in all) __defProp(target, name, {\n\t\tget: all[name],\n\t\tenumerable: true\n\t});\n\treturn target;\n};\n\n//#endregion\nexport { __export };"],"mappings":";AACA,IAAI,YAAY,OAAO;AACvB,IAAI,YAAY,QAAQ;CACvB,IAAI,SAAS,EAAE;AACf,MAAK,IAAI,QAAQ,IAAK,WAAU,QAAQ,MAAM;EAC7C,KAAK,IAAI;EACT,YAAY;EACZ,CAAC;AACF,QAAO"}