@intlayer/core 9.5.9 → 9.5.11

package/dist/cjs/interpreter/getTranslation.cjs

@@ -14,20 +14,26 @@ const isPlainObject = (value) => {
 /**
 * Recursively merges two objects, skipping undefined source values.
 * First argument takes precedence. Arrays replace rather than merge.
+*
+* Copy-on-write: an object the source adds nothing to is returned as-is, so a
+* complete translation costs a read-only walk instead of a full copy.
 */
 const deepMerge = (target, source) => {
 	if (target === void 0) return source;
 	if (source === void 0) return target;
 	if (Array.isArray(target)) return target;
-	if (isPlainObject(target) && isPlainObject(source)) {
-		const result = { ...target };
-		for (const key of Object.keys(source)) {
-			if (key === "__proto__" || key === "constructor" || source[key] === void 0) continue;
-			result[key] = target[key] !== void 0 ? deepMerge(target[key], source[key]) : source[key];
-		}
-		return result;
+	if (!isPlainObject(target) || !isPlainObject(source)) return target;
+	let result = target;
+	for (const key of Object.keys(source)) {
+		const sourceValue = source[key];
+		if (key === "__proto__" || key === "constructor" || sourceValue === void 0) continue;
+		const targetValue = target[key];
+		const merged = targetValue === void 0 ? sourceValue : typeof targetValue === "object" ? deepMerge(targetValue, sourceValue) : targetValue;
+		if (merged === targetValue) continue;
+		if (result === target) result = { ...target };
+		result[key] = merged;
 	}
-	return target;
+	return result;
 };
 /**
 * Picks the appropriate content from a locale map based on the provided locale.
@@ -53,28 +59,26 @@ const deepMerge = (target, source) => {
 * ```
 */
 const getTranslation = (languageContent, locale, fallback) => {
-	const get = (loc) => languageContent[loc];
-	const seen = /* @__PURE__ */ new Set();
-	const locales = [];
-	const addLocale = (loc) => {
-		if (loc && !seen.has(loc)) {
-			seen.add(loc);
-			locales.push(loc);
-		}
-	};
-	addLocale(locale);
-	if (locale.includes("-")) addLocale(locale.split("-")[0]);
-	addLocale(fallback);
-	if (fallback?.includes("-")) addLocale(fallback.split("-")[0]);
+	const get = (localeEl) => languageContent[localeEl];
+	const exactMatch = get(locale);
+	if (typeof exactMatch === "string") return exactMatch;
+	const candidates = [
+		locale,
+		locale.split("-")[0],
+		fallback,
+		fallback?.split("-")[0]
+	];
 	const results = [];
-	for (const loc of locales) {
-		const val = get(loc);
-		if (val === void 0) continue;
-		if (typeof val === "string") {
-			if (results.length === 0) return val;
+	for (let index = 0; index < candidates.length; index++) {
+		const candidate = candidates[index];
+		if (!candidate || candidates.indexOf(candidate) < index) continue;
+		const value = get(candidate);
+		if (value === void 0) continue;
+		if (typeof value === "string") {
+			if (results.length === 0) return value;
 			continue;
 		}
-		results.push(val);
+		results.push(value);
 	}
 	if (results.length === 0) return void 0;
 	if (results.length === 1) return results[0];

package/dist/cjs/interpreter/getTranslation.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"getTranslation.cjs","names":[],"sources":["../../../src/interpreter/getTranslation.ts"],"sourcesContent":["import type {\n  LocalesValues,\n  StrictModeLocaleMap,\n} from '@intlayer/types/module_augmentation';\n\n/**\n * Check if a value is a plain object that can be safely merged.\n * Returns false for Promises, React elements, class instances, etc.\n */\nconst isPlainObject = (value: unknown): boolean => {\n  if (value === null || typeof value !== 'object') return false;\n  if (typeof (value as any).then === 'function') return false;\n  if (\n    (value as any).$$typeof !== undefined ||\n    (value as any).__v_isVNode !== undefined ||\n    (value as any)._isVNode !== undefined ||\n    (value as any).isJSX !== undefined\n  ) {\n    return false;\n  }\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null || Array.isArray(value);\n};\n\n/**\n * Recursively merges two objects, skipping undefined source values.\n * First argument takes precedence. Arrays replace rather than merge.\n */\nconst deepMerge = (target: any, source: any): any => {\n  if (target === undefined) return source;\n  if (source === undefined) return target;\n  if (Array.isArray(target)) return target;\n  if (isPlainObject(target) && isPlainObject(source)) {\n    const result = { ...target };\n\n    for (const key of Object.keys(source)) {\n      if (\n        key === '__proto__' ||\n        key === 'constructor' ||\n        source[key] === undefined\n      )\n        continue;\n      result[key] =\n        target[key] !== undefined\n          ? deepMerge(target[key], source[key])\n          : source[key];\n    }\n    return result;\n  }\n  return target;\n};\n\n/**\n * Picks the appropriate content from a locale map based on the provided locale.\n *\n * It handles:\n * 1. Exact locale match (e.g., 'en-US').\n * 2. Generic locale fallback (e.g., 'en' if 'en-US' is not found).\n * 3. Explicit fallback locale.\n * 4. Deep merging of objects to ensure partial translations are complemented by fallbacks.\n *\n * @param languageContent - A map of locales to content.\n * @param locale - The target locale to retrieve.\n * @param fallback - Optional fallback locale if the target is not found.\n * @returns The translated content.\n *\n * @example\n * ```ts\n * const content = getTranslation({\n *   en: 'Hello',\n *   fr: 'Bonjour',\n * }, 'fr');\n * // 'Bonjour'\n * ```\n */\nexport const getTranslation = <const Content = string>(\n  languageContent: StrictModeLocaleMap<Content>,\n  locale: LocalesValues,\n  fallback?: LocalesValues\n): Content => {\n  const get = (loc: string): Content | undefined =>\n    languageContent[loc as keyof typeof languageContent];\n\n  // Build priority-ordered locale candidates (most specific first), deduped\n  const seen = new Set<string>();\n  const locales: string[] = [];\n  const addLocale = (loc: string | undefined) => {\n    if (loc && !seen.has(loc)) {\n      seen.add(loc);\n      locales.push(loc);\n    }\n  };\n\n  addLocale(locale);\n  if (locale.includes('-')) addLocale(locale.split('-')[0]);\n\n  addLocale(fallback);\n  if (fallback?.includes('-')) addLocale(fallback.split('-')[0]);\n\n  // Collect results: strings exit early (if no higher-priority object was found),\n  // objects are accumulated for deep merging.\n  const results: Content[] = [];\n\n  for (const loc of locales) {\n    const val = get(loc);\n\n    if (val === undefined) continue;\n    if (typeof val === 'string') {\n      if (results.length === 0) return val;\n      continue; // an object at higher priority takes precedence\n    }\n\n    results.push(val);\n  }\n\n  if (results.length === 0) return undefined as Content;\n  if (results.length === 1) return results[0];\n  if (Array.isArray(results[0])) return results[0];\n\n  // Merge objects: first result (most specific) takes precedence\n  return (results as object[]).reduce((acc, curr) =>\n    deepMerge(acc, curr)\n  ) as Content;\n};\n"],"mappings":";;;;;;AASA,MAAM,iBAAiB,UAA4B;CACjD,IAAI,UAAU,QAAQ,OAAO,UAAU,UAAU,OAAO;CACxD,IAAI,OAAQ,MAAc,SAAS,YAAY,OAAO;CACtD,IACG,MAAc,aAAa,UAC3B,MAAc,gBAAgB,UAC9B,MAAc,aAAa,UAC3B,MAAc,UAAU,QAEzB,OAAO;CAET,MAAM,QAAQ,OAAO,eAAe,KAAK;CACzC,OAAO,UAAU,OAAO,aAAa,UAAU,QAAQ,MAAM,QAAQ,KAAK;AAC5E;;;;;AAMA,MAAM,aAAa,QAAa,WAAqB;CACnD,IAAI,WAAW,QAAW,OAAO;CACjC,IAAI,WAAW,QAAW,OAAO;CACjC,IAAI,MAAM,QAAQ,MAAM,GAAG,OAAO;CAClC,IAAI,cAAc,MAAM,KAAK,cAAc,MAAM,GAAG;EAClD,MAAM,SAAS,EAAE,GAAG,OAAO;EAE3B,KAAK,MAAM,OAAO,OAAO,KAAK,MAAM,GAAG;GACrC,IACE,QAAQ,eACR,QAAQ,iBACR,OAAO,SAAS,QAEhB;GACF,OAAO,OACL,OAAO,SAAS,SACZ,UAAU,OAAO,MAAM,OAAO,IAAI,IAClC,OAAO;EACf;EACA,OAAO;CACT;CACA,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,MAAa,kBACX,iBACA,QACA,aACY;CACZ,MAAM,OAAO,QACX,gBAAgB;CAGlB,MAAM,uBAAO,IAAI,IAAY;CAC7B,MAAM,UAAoB,CAAC;CAC3B,MAAM,aAAa,QAA4B;EAC7C,IAAI,OAAO,CAAC,KAAK,IAAI,GAAG,GAAG;GACzB,KAAK,IAAI,GAAG;GACZ,QAAQ,KAAK,GAAG;EAClB;CACF;CAEA,UAAU,MAAM;CAChB,IAAI,OAAO,SAAS,GAAG,GAAG,UAAU,OAAO,MAAM,GAAG,CAAC,CAAC,EAAE;CAExD,UAAU,QAAQ;CAClB,IAAI,UAAU,SAAS,GAAG,GAAG,UAAU,SAAS,MAAM,GAAG,CAAC,CAAC,EAAE;CAI7D,MAAM,UAAqB,CAAC;CAE5B,KAAK,MAAM,OAAO,SAAS;EACzB,MAAM,MAAM,IAAI,GAAG;EAEnB,IAAI,QAAQ,QAAW;EACvB,IAAI,OAAO,QAAQ,UAAU;GAC3B,IAAI,QAAQ,WAAW,GAAG,OAAO;GACjC;EACF;EAEA,QAAQ,KAAK,GAAG;CAClB;CAEA,IAAI,QAAQ,WAAW,GAAG,OAAO;CACjC,IAAI,QAAQ,WAAW,GAAG,OAAO,QAAQ;CACzC,IAAI,MAAM,QAAQ,QAAQ,EAAE,GAAG,OAAO,QAAQ;CAG9C,OAAQ,QAAqB,QAAQ,KAAK,SACxC,UAAU,KAAK,IAAI,CACrB;AACF"}
+{"version":3,"file":"getTranslation.cjs","names":[],"sources":["../../../src/interpreter/getTranslation.ts"],"sourcesContent":["import type {\n  LocalesValues,\n  StrictModeLocaleMap,\n} from '@intlayer/types/module_augmentation';\n\n/**\n * Check if a value is a plain object that can be safely merged.\n * Returns false for Promises, React elements, class instances, etc.\n */\nconst isPlainObject = (value: unknown): boolean => {\n  if (value === null || typeof value !== 'object') return false;\n  if (typeof (value as any).then === 'function') return false;\n  if (\n    (value as any).$$typeof !== undefined ||\n    (value as any).__v_isVNode !== undefined ||\n    (value as any)._isVNode !== undefined ||\n    (value as any).isJSX !== undefined\n  ) {\n    return false;\n  }\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null || Array.isArray(value);\n};\n\n/**\n * Recursively merges two objects, skipping undefined source values.\n * First argument takes precedence. Arrays replace rather than merge.\n *\n * Copy-on-write: an object the source adds nothing to is returned as-is, so a\n * complete translation costs a read-only walk instead of a full copy.\n */\nconst deepMerge = (target: any, source: any): any => {\n  if (target === undefined) return source;\n  if (source === undefined) return target;\n  if (Array.isArray(target)) return target;\n  if (!isPlainObject(target) || !isPlainObject(source)) return target;\n\n  let result = target;\n\n  for (const key of Object.keys(source)) {\n    const sourceValue = source[key];\n\n    if (\n      key === '__proto__' ||\n      key === 'constructor' ||\n      sourceValue === undefined\n    )\n      continue;\n\n    const targetValue = target[key];\n\n    // Only objects need a recursive merge: a primitive the target holds wins\n    const merged =\n      targetValue === undefined\n        ? sourceValue\n        : typeof targetValue === 'object'\n          ? deepMerge(targetValue, sourceValue)\n          : targetValue;\n\n    if (merged === targetValue) continue;\n\n    if (result === target) result = { ...target };\n    result[key] = merged;\n  }\n\n  return result;\n};\n\n/**\n * Picks the appropriate content from a locale map based on the provided locale.\n *\n * It handles:\n * 1. Exact locale match (e.g., 'en-US').\n * 2. Generic locale fallback (e.g., 'en' if 'en-US' is not found).\n * 3. Explicit fallback locale.\n * 4. Deep merging of objects to ensure partial translations are complemented by fallbacks.\n *\n * @param languageContent - A map of locales to content.\n * @param locale - The target locale to retrieve.\n * @param fallback - Optional fallback locale if the target is not found.\n * @returns The translated content.\n *\n * @example\n * ```ts\n * const content = getTranslation({\n *   en: 'Hello',\n *   fr: 'Bonjour',\n * }, 'fr');\n * // 'Bonjour'\n * ```\n */\nexport const getTranslation = <const Content = string>(\n  languageContent: StrictModeLocaleMap<Content>,\n  locale: LocalesValues,\n  fallback?: LocalesValues\n): Content => {\n  const get = (localeEl: string): Content | undefined =>\n    languageContent[localeEl as keyof typeof languageContent];\n\n  // Fast path for the common case: a string for the exact locale always wins,\n  // so the candidate chain below would return it anyway.\n  const exactMatch = get(locale);\n  if (typeof exactMatch === 'string') return exactMatch;\n\n  // Priority-ordered locale candidates, most specific first\n  const candidates = [\n    locale,\n    locale.split('-')[0],\n    fallback,\n    fallback?.split('-')[0],\n  ];\n\n  // Strings exit early (unless a higher-priority object was found), objects\n  // are accumulated for deep merging\n  const results: Content[] = [];\n\n  for (let index = 0; index < candidates.length; index++) {\n    const candidate = candidates[index];\n\n    // Skip empty and repeated candidates\n    if (!candidate || candidates.indexOf(candidate) < index) continue;\n\n    const value = get(candidate);\n\n    if (value === undefined) continue;\n    if (typeof value === 'string') {\n      if (results.length === 0) return value;\n      continue; // an object at higher priority takes precedence\n    }\n\n    results.push(value);\n  }\n\n  if (results.length === 0) return undefined as Content;\n  if (results.length === 1) return results[0]!;\n  if (Array.isArray(results[0])) return results[0];\n\n  // Merge objects: first result (most specific) takes precedence\n  return (results as object[]).reduce((acc, curr) =>\n    deepMerge(acc, curr)\n  ) as Content;\n};\n"],"mappings":";;;;;;AASA,MAAM,iBAAiB,UAA4B;CACjD,IAAI,UAAU,QAAQ,OAAO,UAAU,UAAU,OAAO;CACxD,IAAI,OAAQ,MAAc,SAAS,YAAY,OAAO;CACtD,IACG,MAAc,aAAa,UAC3B,MAAc,gBAAgB,UAC9B,MAAc,aAAa,UAC3B,MAAc,UAAU,QAEzB,OAAO;CAET,MAAM,QAAQ,OAAO,eAAe,KAAK;CACzC,OAAO,UAAU,OAAO,aAAa,UAAU,QAAQ,MAAM,QAAQ,KAAK;AAC5E;;;;;;;;AASA,MAAM,aAAa,QAAa,WAAqB;CACnD,IAAI,WAAW,QAAW,OAAO;CACjC,IAAI,WAAW,QAAW,OAAO;CACjC,IAAI,MAAM,QAAQ,MAAM,GAAG,OAAO;CAClC,IAAI,CAAC,cAAc,MAAM,KAAK,CAAC,cAAc,MAAM,GAAG,OAAO;CAE7D,IAAI,SAAS;CAEb,KAAK,MAAM,OAAO,OAAO,KAAK,MAAM,GAAG;EACrC,MAAM,cAAc,OAAO;EAE3B,IACE,QAAQ,eACR,QAAQ,iBACR,gBAAgB,QAEhB;EAEF,MAAM,cAAc,OAAO;EAG3B,MAAM,SACJ,gBAAgB,SACZ,cACA,OAAO,gBAAgB,WACrB,UAAU,aAAa,WAAW,IAClC;EAER,IAAI,WAAW,aAAa;EAE5B,IAAI,WAAW,QAAQ,SAAS,EAAE,GAAG,OAAO;EAC5C,OAAO,OAAO;CAChB;CAEA,OAAO;AACT;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,MAAa,kBACX,iBACA,QACA,aACY;CACZ,MAAM,OAAO,aACX,gBAAgB;CAIlB,MAAM,aAAa,IAAI,MAAM;CAC7B,IAAI,OAAO,eAAe,UAAU,OAAO;CAG3C,MAAM,aAAa;EACjB;EACA,OAAO,MAAM,GAAG,CAAC,CAAC;EAClB;EACA,UAAU,MAAM,GAAG,CAAC,CAAC;CACvB;CAIA,MAAM,UAAqB,CAAC;CAE5B,KAAK,IAAI,QAAQ,GAAG,QAAQ,WAAW,QAAQ,SAAS;EACtD,MAAM,YAAY,WAAW;EAG7B,IAAI,CAAC,aAAa,WAAW,QAAQ,SAAS,IAAI,OAAO;EAEzD,MAAM,QAAQ,IAAI,SAAS;EAE3B,IAAI,UAAU,QAAW;EACzB,IAAI,OAAO,UAAU,UAAU;GAC7B,IAAI,QAAQ,WAAW,GAAG,OAAO;GACjC;EACF;EAEA,QAAQ,KAAK,KAAK;CACpB;CAEA,IAAI,QAAQ,WAAW,GAAG,OAAO;CACjC,IAAI,QAAQ,WAAW,GAAG,OAAO,QAAQ;CACzC,IAAI,MAAM,QAAQ,QAAQ,EAAE,GAAG,OAAO,QAAQ;CAG9C,OAAQ,QAAqB,QAAQ,KAAK,SACxC,UAAU,KAAK,IAAI,CACrB;AACF"}

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

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

package/dist/cjs/localization/localeResolver.cjs

@@ -7,6 +7,7 @@ let _intlayer_config_built = require("@intlayer/config/built");
 * or falls back to the default locale if no match is found.
 */
 const localeResolver = (selectedLocale, locales = _intlayer_config_built.internationalization?.locales, defaultLocale = _intlayer_config_built.internationalization?.defaultLocale) => {
+	if (locales?.includes(selectedLocale)) return selectedLocale;
 	const requestedLocales = [selectedLocale].flat();
 	const normalize = (locale) => locale.trim().toLowerCase();
 	try {

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

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

package/dist/cjs/markdown/compiler.cjs

@@ -107,7 +107,8 @@ const createElementFactory = (ctx, options) => {
 };
 const createDocumentScope = () => ({
 	footnotes: [],
-	references: {}
+	references: {},
+	slugCounts: /* @__PURE__ */ new Map()
 });
 /**
 * Small enough to scan linearly, large enough that an app mixing a few option
@@ -522,9 +523,17 @@ const createRules = (createElement, ctx, options, scope, attrStringToMap, contai
 			_order: require_markdown_constants.Priority.HIGH,
 			_parse(capture, parse, state) {
 				const text = capture[2] ?? "";
+				const baseSlug = slug(text) || "section";
+				const counts = scope.current.slugCounts;
+				let id = baseSlug;
+				if (counts) {
+					const count = counts.get(baseSlug) ?? 0;
+					counts.set(baseSlug, count + 1);
+					if (count > 0) id = `${baseSlug}-${count}`;
+				}
 				return {
 					children: require_markdown_utils.parseInline(parse, text, state),
-					id: slug(text),
+					id,
 					level: capture[1]?.length ?? 1
 				};
 			},
@@ -981,7 +990,7 @@ const createDocumentRules = (createElement, ctx, options, scope) => {
 				if (mappedKey === "ref") return map;
 				map[mappedKey] = require_markdown_utils.attributeValueToNodePropValue(tag, key, value, ctx.sanitizer ?? require_markdown_utils.sanitizer);
 				if (typeof map[mappedKey] === "string" && require_markdown_elementScanner.startsWithElement(map[mappedKey])) map[mappedKey] = parseMarkdown(map[mappedKey].trim(), ctx, options).ast;
-			} else if (raw !== "style") map[require_markdown_constants.ATTRIBUTE_TO_NODE_PROP_MAP[raw] ?? raw] = true;
+			} else if (raw !== "style" && require_markdown_constants.ATTRIBUTE_NAME_START_R.test(raw)) map[require_markdown_constants.ATTRIBUTE_TO_NODE_PROP_MAP[raw] ?? raw] = true;
 			return map;
 		}, {});
 	};