@intlayer/core 9.0.0-canary.3 → 9.0.0-canary.5

package/dist/cjs/localization/rewriteUtils.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"rewriteUtils.cjs","names":[],"sources":["../../../src/localization/rewriteUtils.ts"],"sourcesContent":["// ── 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 rewrite rules are explicitly disabled at build time\n * (INTLAYER_ROUTING_REWRITE_RULES === 'false').\n */\nconst TREE_SHAKE_REWRITE =\n  process.env['INTLAYER_ROUTING_REWRITE_RULES'] === 'false';\n\nimport 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 || TREE_SHAKE_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 || TREE_SHAKE_REWRITE) 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 || TREE_SHAKE_REWRITE)\n    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  if (TREE_SHAKE_REWRITE) return 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":"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"}
+{"version":3,"file":"rewriteUtils.cjs","names":[],"sources":["../../../src/localization/rewriteUtils.ts"],"sourcesContent":["// ── 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 rewrite rules are explicitly disabled at build time\n * (INTLAYER_ROUTING_REWRITE_RULES === 'false').\n */\nconst TREE_SHAKE_REWRITE =\n  process.env.INTLAYER_ROUTING_REWRITE_RULES === 'false';\n\nimport 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 || TREE_SHAKE_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 || TREE_SHAKE_REWRITE) 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 || TREE_SHAKE_REWRITE)\n    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  if (TREE_SHAKE_REWRITE) return 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":"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"}

package/dist/cjs/localization/validatePrefix.cjs

@@ -5,11 +5,11 @@ const require_localization_getPrefix = require('./getPrefix.cjs');
 /**
 * True when the build-time routing mode is known and is NOT 'no-prefix'.
 */
-const TREE_SHAKE_NO_PREFIX = process.env["INTLAYER_ROUTING_MODE"] && process.env["INTLAYER_ROUTING_MODE"] !== "no-prefix";
+const TREE_SHAKE_NO_PREFIX = process.env.INTLAYER_ROUTING_MODE && process.env.INTLAYER_ROUTING_MODE !== "no-prefix";
 /**
 * True when the build-time routing mode is known and is NOT 'search-params'.
 */
-const TREE_SHAKE_SEARCH_PARAMS = process.env["INTLAYER_ROUTING_MODE"] && process.env["INTLAYER_ROUTING_MODE"] !== "search-params";
+const TREE_SHAKE_SEARCH_PARAMS = process.env.INTLAYER_ROUTING_MODE && process.env.INTLAYER_ROUTING_MODE !== "search-params";
 /**
 * Checks whether a given locale is valid based on the configured locales.
 *

package/dist/cjs/localization/validatePrefix.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"validatePrefix.cjs","names":["resolveRoutingConfig","getPrefix"],"sources":["../../../src/localization/validatePrefix.ts"],"sourcesContent":["// ── 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 'no-prefix'.\n */\nconst TREE_SHAKE_NO_PREFIX =\n  process.env['INTLAYER_ROUTING_MODE'] &&\n  process.env['INTLAYER_ROUTING_MODE'] !== 'no-prefix';\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 { LocalesValues } from '@intlayer/types/module_augmentation';\nimport {\n  getPrefix,\n  type RoutingOptions,\n  resolveRoutingConfig,\n} from './getPrefix';\n\nexport type ValidatePrefixResult = {\n  isValid: boolean;\n  localePrefix: string | undefined;\n};\n\n/**\n * Checks whether a given locale is valid based on the configured locales.\n *\n * @param locale - The locale value to validate. Can be `undefined` or `null`.\n * @param options - Optional configuration to override default settings.\n * @param options.locales - Array of valid locales. Defaults to the configured internationalization locales.\n * @param options.defaultLocale - The default locale to use as fallback. Defaults to the configured default locale.\n * @param options.mode - The routing mode (`'prefix'`, `'prefix-all'`, or `'no-prefix'`). Defaults to the configured routing mode.\n * @returns An object containing the validation result and the locale prefix.\n *\n * @example\n * // Check if 'en' is a valid locale\n * const { isValid, localePrefix } = validatePrefix('en');\n *\n * @example\n * // Check with custom options\n * const { isValid, localePrefix } = validatePrefix('fr', {\n *   locales: ['en', 'fr', 'es'],\n *   defaultLocale: 'en',\n *   mode: 'prefix-all',\n * });\n */\nexport const validatePrefix = (\n  locale: LocalesValues | undefined | null,\n  options?: RoutingOptions\n): ValidatePrefixResult => {\n  const { defaultLocale, mode, locales } = resolveRoutingConfig(options);\n\n  if (\n    (!TREE_SHAKE_NO_PREFIX && mode === 'no-prefix') ||\n    (!TREE_SHAKE_SEARCH_PARAMS && mode === 'search-params')\n  ) {\n    return { isValid: true, localePrefix: undefined };\n  }\n\n  const { localePrefix } = getPrefix(locale || defaultLocale, {\n    mode,\n    locales,\n    defaultLocale,\n  });\n\n  if (localePrefix === locale && locale === undefined) {\n    return { isValid: true, localePrefix: undefined };\n  }\n\n  // A segment that doesn't match a locale code pattern (e.g. 'concept', 'compiler')\n  // is a content slug from a default-locale URL, not an invalid locale attempt.\n  if (locale && !/^[a-z]{2,3}(-[a-zA-Z]{2,4})?$/.test(locale)) {\n    return { isValid: true, localePrefix: undefined };\n  }\n\n  const isValid = locales.some((localeEl) => localeEl === locale);\n\n  return { isValid, localePrefix };\n};\n"],"mappings":";;;;;;;AAOA,MAAM,uBACJ,QAAQ,IAAI,4BACZ,QAAQ,IAAI,6BAA6B;;;;AAK3C,MAAM,2BACJ,QAAQ,IAAI,4BACZ,QAAQ,IAAI,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;AAoC3C,MAAa,kBACX,QACA,YACyB;CACzB,MAAM,EAAE,eAAe,MAAM,YAAYA,oDAAqB,QAAQ;AAEtE,KACG,CAAC,wBAAwB,SAAS,eAClC,CAAC,4BAA4B,SAAS,gBAEvC,QAAO;EAAE,SAAS;EAAM,cAAc;EAAW;CAGnD,MAAM,EAAE,iBAAiBC,yCAAU,UAAU,eAAe;EAC1D;EACA;EACA;EACD,CAAC;AAEF,KAAI,iBAAiB,UAAU,WAAW,OACxC,QAAO;EAAE,SAAS;EAAM,cAAc;EAAW;AAKnD,KAAI,UAAU,CAAC,gCAAgC,KAAK,OAAO,CACzD,QAAO;EAAE,SAAS;EAAM,cAAc;EAAW;AAKnD,QAAO;EAAE,SAFO,QAAQ,MAAM,aAAa,aAAa,OAExC;EAAE;EAAc"}
+{"version":3,"file":"validatePrefix.cjs","names":["resolveRoutingConfig","getPrefix"],"sources":["../../../src/localization/validatePrefix.ts"],"sourcesContent":["// ── 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 'no-prefix'.\n */\nconst TREE_SHAKE_NO_PREFIX =\n  process.env.INTLAYER_ROUTING_MODE &&\n  process.env.INTLAYER_ROUTING_MODE !== 'no-prefix';\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 { LocalesValues } from '@intlayer/types/module_augmentation';\nimport {\n  getPrefix,\n  type RoutingOptions,\n  resolveRoutingConfig,\n} from './getPrefix';\n\nexport type ValidatePrefixResult = {\n  isValid: boolean;\n  localePrefix: string | undefined;\n};\n\n/**\n * Checks whether a given locale is valid based on the configured locales.\n *\n * @param locale - The locale value to validate. Can be `undefined` or `null`.\n * @param options - Optional configuration to override default settings.\n * @param options.locales - Array of valid locales. Defaults to the configured internationalization locales.\n * @param options.defaultLocale - The default locale to use as fallback. Defaults to the configured default locale.\n * @param options.mode - The routing mode (`'prefix'`, `'prefix-all'`, or `'no-prefix'`). Defaults to the configured routing mode.\n * @returns An object containing the validation result and the locale prefix.\n *\n * @example\n * // Check if 'en' is a valid locale\n * const { isValid, localePrefix } = validatePrefix('en');\n *\n * @example\n * // Check with custom options\n * const { isValid, localePrefix } = validatePrefix('fr', {\n *   locales: ['en', 'fr', 'es'],\n *   defaultLocale: 'en',\n *   mode: 'prefix-all',\n * });\n */\nexport const validatePrefix = (\n  locale: LocalesValues | undefined | null,\n  options?: RoutingOptions\n): ValidatePrefixResult => {\n  const { defaultLocale, mode, locales } = resolveRoutingConfig(options);\n\n  if (\n    (!TREE_SHAKE_NO_PREFIX && mode === 'no-prefix') ||\n    (!TREE_SHAKE_SEARCH_PARAMS && mode === 'search-params')\n  ) {\n    return { isValid: true, localePrefix: undefined };\n  }\n\n  const { localePrefix } = getPrefix(locale || defaultLocale, {\n    mode,\n    locales,\n    defaultLocale,\n  });\n\n  if (localePrefix === locale && locale === undefined) {\n    return { isValid: true, localePrefix: undefined };\n  }\n\n  // A segment that doesn't match a locale code pattern (e.g. 'concept', 'compiler')\n  // is a content slug from a default-locale URL, not an invalid locale attempt.\n  if (locale && !/^[a-z]{2,3}(-[a-zA-Z]{2,4})?$/.test(locale)) {\n    return { isValid: true, localePrefix: undefined };\n  }\n\n  const isValid = locales.some((localeEl) => localeEl === locale);\n\n  return { isValid, localePrefix };\n};\n"],"mappings":";;;;;;;AAOA,MAAM,uBACJ,QAAQ,IAAI,yBACZ,QAAQ,IAAI,0BAA0B;;;;AAKxC,MAAM,2BACJ,QAAQ,IAAI,yBACZ,QAAQ,IAAI,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;AAoCxC,MAAa,kBACX,QACA,YACyB;CACzB,MAAM,EAAE,eAAe,MAAM,YAAYA,oDAAqB,QAAQ;AAEtE,KACG,CAAC,wBAAwB,SAAS,eAClC,CAAC,4BAA4B,SAAS,gBAEvC,QAAO;EAAE,SAAS;EAAM,cAAc;EAAW;CAGnD,MAAM,EAAE,iBAAiBC,yCAAU,UAAU,eAAe;EAC1D;EACA;EACA;EACD,CAAC;AAEF,KAAI,iBAAiB,UAAU,WAAW,OACxC,QAAO;EAAE,SAAS;EAAM,cAAc;EAAW;AAKnD,KAAI,UAAU,CAAC,gCAAgC,KAAK,OAAO,CACzD,QAAO;EAAE,SAAS;EAAM,cAAc;EAAW;AAKnD,QAAO;EAAE,SAFO,QAAQ,MAAM,aAAa,aAAa,OAExC;EAAE;EAAc"}

package/dist/cjs/utils/localeStorage.cjs

@@ -8,19 +8,19 @@ let _intlayer_config_built = require("@intlayer/config/built");
 /**
 * True when cookie storage is explicitly disabled at build time.
 */
-const TREE_SHAKE_STORAGE_COOKIES = process.env["INTLAYER_ROUTING_STORAGE_COOKIES"] === "false";
+const TREE_SHAKE_STORAGE_COOKIES = process.env.INTLAYER_ROUTING_STORAGE_COOKIES === "false";
 /**
 * True when localStorage is explicitly disabled at build time.
 */
-const TREE_SHAKE_STORAGE_LOCAL_STORAGE = process.env["INTLAYER_ROUTING_STORAGE_LOCALSTORAGE"] === "false";
+const TREE_SHAKE_STORAGE_LOCAL_STORAGE = process.env.INTLAYER_ROUTING_STORAGE_LOCALSTORAGE === "false";
 /**
 * True when sessionStorage is explicitly disabled at build time.
 */
-const TREE_SHAKE_STORAGE_SESSION_STORAGE = process.env["INTLAYER_ROUTING_STORAGE_SESSIONSTORAGE"] === "false";
+const TREE_SHAKE_STORAGE_SESSION_STORAGE = process.env.INTLAYER_ROUTING_STORAGE_SESSIONSTORAGE === "false";
 /**
 * True when header storage is explicitly disabled at build time.
 */
-const TREE_SHAKE_STORAGE_HEADERS = process.env["INTLAYER_ROUTING_STORAGE_HEADERS"] === "false";
+const TREE_SHAKE_STORAGE_HEADERS = process.env.INTLAYER_ROUTING_STORAGE_HEADERS === "false";
 const localeStorageOptions = {
 	getCookie: (name) => document.cookie.split(";").find((c) => c.trim().startsWith(`${name}=`))?.split("=")[1],
 	getLocaleStorage: (name) => localStorage.getItem(name),

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

@@ -1 +1 @@
-{"version":3,"file":"localeStorage.cjs","names":["internationalization","routing","resolveExpiresToTimestamp","buildCookieString","getCookie"],"sources":["../../../src/utils/localeStorage.ts"],"sourcesContent":["import { internationalization, routing } from '@intlayer/config/built';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { buildCookieString, resolveExpiresToTimestamp } from './cookieExpiry';\nimport { getCookie } from './getCookie';\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 cookie storage is explicitly disabled at build time.\n */\nconst TREE_SHAKE_STORAGE_COOKIES =\n  process.env['INTLAYER_ROUTING_STORAGE_COOKIES'] === 'false';\n\n/**\n * True when localStorage is explicitly disabled at build time.\n */\nconst TREE_SHAKE_STORAGE_LOCAL_STORAGE =\n  process.env['INTLAYER_ROUTING_STORAGE_LOCALSTORAGE'] === 'false';\n\n/**\n * True when sessionStorage is explicitly disabled at build time.\n */\nconst TREE_SHAKE_STORAGE_SESSION_STORAGE =\n  process.env['INTLAYER_ROUTING_STORAGE_SESSIONSTORAGE'] === 'false';\n\n/**\n * True when header storage is explicitly disabled at build time.\n */\nconst TREE_SHAKE_STORAGE_HEADERS =\n  process.env['INTLAYER_ROUTING_STORAGE_HEADERS'] === 'false';\n\n// ============================================================================\n// Shared types\n// ============================================================================\n\nexport type CookieBuildAttributes = {\n  domain?: string;\n  path?: string;\n  secure?: boolean;\n  httpOnly?: boolean;\n  sameSite?: 'strict' | 'lax' | 'none';\n  /**\n   * Absolute expiry as milliseconds since epoch, ready for `cookieStore.set()`.\n   * Already resolved from the normalized `expires` by\n   * `resolveExpiresToTimestamp`.\n   */\n  expires?: number | undefined;\n};\n\n// ============================================================================\n// Client-specific types and functions\n// (cookies via browser APIs, localStorage, sessionStorage — no headers)\n// ============================================================================\n\nexport type LocaleStorageClientOptions = {\n  overwrite?: boolean;\n  isCookieEnabled?: boolean;\n  setCookieStore?: (\n    name: string,\n    value: string,\n    cookie: CookieBuildAttributes\n  ) => void;\n  setCookieString?: (name: string, cookie: string) => void;\n  getCookie?: (name: string) => string | undefined | null;\n  setSessionStorage?: (name: string, value: string) => void;\n  getSessionStorage?: (name: string) => string | undefined | null;\n  setLocaleStorage?: (name: string, value: string) => void;\n  getLocaleStorage?: (name: string) => string | undefined | null;\n};\n\n// cookieStore is part of the experimental Cookie Store API\ndeclare const cookieStore: any;\n\nexport const localeStorageOptions: LocaleStorageClientOptions = {\n  getCookie: (name: string) =>\n    document.cookie\n      .split(';')\n      .find((c) => c.trim().startsWith(`${name}=`))\n      ?.split('=')[1],\n  getLocaleStorage: (name: string) => localStorage.getItem(name),\n  getSessionStorage: (name: string) => sessionStorage.getItem(name),\n  isCookieEnabled: true,\n  setCookieStore: (name, value, attributes) =>\n    cookieStore.set({\n      name,\n      value,\n      path: attributes.path,\n      domain: attributes.domain,\n      expires: attributes.expires,\n      sameSite: attributes.sameSite,\n    }),\n  setCookieString: (_name, cookie) => {\n    // biome-ignore lint/suspicious/noDocumentCookie: set cookie fallback\n    document.cookie = cookie;\n  },\n  setSessionStorage: (name, value) => sessionStorage.setItem(name, value),\n  setLocaleStorage: (name, value) => localStorage.setItem(name, value),\n};\n\n/**\n * Retrieves the locale from browser storage mechanisms\n * (cookies, localStorage, sessionStorage).\n * Does not read from headers — use `getLocaleFromStorageServer` for that.\n */\nexport const getLocaleFromStorageClient = (\n  options: LocaleStorageClientOptions = localeStorageOptions\n): Locale | undefined => {\n  const { locales } = internationalization;\n\n  if (options?.isCookieEnabled === false) return undefined;\n\n  const isValidLocale = (value: string | null | undefined): value is Locale =>\n    !!value && locales.includes(value as Locale);\n\n  if (!TREE_SHAKE_STORAGE_COOKIES) {\n    for (let i = 0; i < (routing.storage.cookies ?? []).length; i++) {\n      try {\n        const value = options?.getCookie?.(routing.storage.cookies![i].name);\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_LOCAL_STORAGE) {\n    for (let i = 0; i < (routing.storage.localStorage ?? []).length; i++) {\n      try {\n        const value = options?.getLocaleStorage?.(\n          routing.storage.localStorage![i].name\n        );\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_SESSION_STORAGE && routing.storage.sessionStorage) {\n    for (let i = 0; i < routing.storage.sessionStorage.length; i++) {\n      try {\n        const value = options?.getSessionStorage?.(\n          routing.storage.sessionStorage[i].name\n        );\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n};\n\n/**\n * Stores the locale in browser storage mechanisms\n * (cookies, localStorage, sessionStorage).\n * Does not write to headers — use `setLocaleInStorageServer` for that.\n */\nexport const setLocaleInStorageClient = (\n  locale: LocalesValues,\n  options?: LocaleStorageClientOptions\n): void => {\n  if (options?.isCookieEnabled === false) return;\n\n  if (!TREE_SHAKE_STORAGE_COOKIES && routing.storage.cookies) {\n    for (let i = 0; i < routing.storage.cookies.length; i++) {\n      const { name, attributes } = routing.storage.cookies[i];\n      try {\n        if (options?.setCookieStore) {\n          options.setCookieStore(name, locale, {\n            ...attributes,\n            expires: resolveExpiresToTimestamp(attributes.expires),\n          });\n        }\n      } catch {\n        try {\n          if (options?.setCookieString) {\n            options.setCookieString(\n              name,\n              buildCookieString(name, locale, attributes)\n            );\n          }\n        } catch {}\n      }\n    }\n  }\n\n  if (\n    !TREE_SHAKE_STORAGE_LOCAL_STORAGE &&\n    routing.storage.localStorage &&\n    options?.setLocaleStorage\n  ) {\n    for (let i = 0; i < routing.storage.localStorage.length; i++) {\n      const { name } = routing.storage.localStorage[i];\n      try {\n        if (!(options?.overwrite ?? true) && options?.getLocaleStorage) {\n          if (options.getLocaleStorage(name)) continue;\n        }\n        options.setLocaleStorage(name, locale);\n      } catch {}\n    }\n  }\n\n  if (\n    !TREE_SHAKE_STORAGE_SESSION_STORAGE &&\n    routing.storage.sessionStorage &&\n    options?.setSessionStorage\n  ) {\n    for (let i = 0; i < routing.storage.sessionStorage.length; i++) {\n      const { name } = routing.storage.sessionStorage[i];\n      try {\n        if (!(options?.overwrite ?? true) && options?.getSessionStorage) {\n          if (options.getSessionStorage(name)) continue;\n        }\n        options.setSessionStorage(name, locale);\n      } catch {}\n    }\n  }\n};\n\n/**\n * Client-side locale storage utility.\n * Handles cookies (browser), localStorage and sessionStorage.\n * Does not access headers.\n *\n * @example\n * ```ts\n * const storage = LocaleStorageClient(localeStorageOptions);\n * const locale = storage.getLocale();\n * storage.setLocale('fr');\n * ```\n */\nexport const LocaleStorageClient = (options: LocaleStorageClientOptions) => ({\n  getLocale: () => getLocaleFromStorageClient(options),\n  setLocale: (locale: LocalesValues) =>\n    setLocaleInStorageClient(locale, options),\n});\n\n// ============================================================================\n// Server-specific types and functions\n// (cookies via injected getter/setter, headers — no localStorage/sessionStorage)\n// ============================================================================\n\nexport type LocaleStorageServerOptions = {\n  overwrite?: boolean;\n  isCookieEnabled?: boolean;\n  setCookieStore?: (\n    name: string,\n    value: string,\n    cookie: CookieBuildAttributes\n  ) => void;\n  setCookieString?: (name: string, cookie: string) => void;\n  getCookie?: (name: string) => string | undefined | null;\n  getHeader?: (name: string) => string | undefined | null;\n  setHeader?: (name: string, value: string) => void;\n};\n\n/**\n * Retrieves the locale from server-side storage mechanisms (cookies, headers).\n * Does not access localStorage or sessionStorage.\n * No browser cookie fallback — the caller must provide `getCookie`.\n */\nexport const getLocaleFromStorageServer = (\n  options: LocaleStorageServerOptions\n): Locale | undefined => {\n  const { locales } = internationalization;\n\n  if (options?.isCookieEnabled === false) return undefined;\n\n  const isValidLocale = (value: string | null | undefined): value is Locale =>\n    !!value && locales.includes(value as Locale);\n\n  if (!TREE_SHAKE_STORAGE_COOKIES && routing.storage.cookies) {\n    for (let i = 0; i < routing.storage.cookies.length; i++) {\n      try {\n        const value = options?.getCookie?.(routing.storage.cookies[i].name);\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_HEADERS && routing.storage.headers) {\n    for (let i = 0; i < routing.storage.headers.length; i++) {\n      try {\n        const value = options?.getHeader?.(routing.storage.headers[i].name);\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n};\n\n/**\n * Stores the locale in server-side storage mechanisms (cookies, headers).\n * Does not write to localStorage or sessionStorage.\n */\nexport const setLocaleInStorageServer = (\n  locale: LocalesValues,\n  options?: LocaleStorageServerOptions\n): void => {\n  if (options?.isCookieEnabled === false) return;\n\n  if (!TREE_SHAKE_STORAGE_COOKIES && routing.storage.cookies) {\n    for (let i = 0; i < routing.storage.cookies.length; i++) {\n      const { name, attributes } = routing.storage.cookies[i];\n\n      try {\n        if (options?.setCookieStore) {\n          options.setCookieStore(name, locale, {\n            ...attributes,\n            expires: resolveExpiresToTimestamp(attributes.expires),\n          });\n        }\n      } catch {\n        try {\n          if (options?.setCookieString) {\n            options.setCookieString(\n              name,\n              buildCookieString(name, locale, attributes)\n            );\n          }\n        } catch {}\n      }\n    }\n  }\n\n  if (\n    !TREE_SHAKE_STORAGE_HEADERS &&\n    routing.storage.headers &&\n    options?.setHeader\n  ) {\n    for (let i = 0; i < routing.storage.headers.length; i++) {\n      try {\n        options.setHeader(routing.storage.headers[i].name, locale);\n      } catch {}\n    }\n  }\n};\n\n/**\n * Server-side locale storage utility.\n * Handles cookies (via injected getter/setter) and headers.\n * Does not access localStorage or sessionStorage.\n *\n * @example\n * ```ts\n * const storage = LocaleStorageServer({\n *   getCookie: (name) => req.cookies[name],\n *   setCookieStore: (name, value, attrs) => res.cookie(name, value, attrs),\n *   getHeader: (name) => req.headers[name],\n *   setHeader: (name, value) => res.setHeader(name, value),\n * });\n * const locale = storage.getLocale();\n * storage.setLocale('fr');\n * ```\n */\nexport const LocaleStorageServer = (options: LocaleStorageServerOptions) => ({\n  getLocale: () => getLocaleFromStorageServer(options),\n  setLocale: (locale: LocalesValues) =>\n    setLocaleInStorageServer(locale, options),\n});\n\n// ============================================================================\n// Deprecated: combined LocaleStorage\n// Use LocaleStorageClient or LocaleStorageServer instead\n// ============================================================================\n\n/**\n * @deprecated Use {@link LocaleStorageClientOptions} or {@link LocaleStorageServerOptions} instead.\n */\nexport type LocaleStorageOptions = LocaleStorageClientOptions &\n  LocaleStorageServerOptions;\n\n/**\n * Retrieves the locale from all storage mechanisms\n * (cookies, localStorage, sessionStorage, headers).\n *\n * @deprecated Use {@link getLocaleFromStorageClient} (browser) or\n * {@link getLocaleFromStorageServer} (server) instead.\n */\nexport const getLocaleFromStorage = (\n  options: Pick<\n    LocaleStorageOptions,\n    | 'getCookie'\n    | 'getSessionStorage'\n    | 'getLocaleStorage'\n    | 'getHeader'\n    | 'isCookieEnabled'\n  >\n): Locale | undefined => {\n  const { locales } = internationalization;\n\n  if (options?.isCookieEnabled === false) return undefined;\n\n  const isValidLocale = (value: string | null | undefined): value is Locale =>\n    !!value && locales.includes(value as Locale);\n\n  const readCookie = (name: string): string | undefined => {\n    try {\n      const fromOption = options?.getCookie?.(name);\n      if (fromOption !== null && fromOption !== undefined) return fromOption;\n    } catch {}\n    // Browser fallback kept for backward compatibility\n    return getCookie(name);\n  };\n\n  if (!TREE_SHAKE_STORAGE_COOKIES && routing.storage.cookies) {\n    for (let i = 0; i < routing.storage.cookies.length; i++) {\n      const value = readCookie(routing.storage.cookies[i].name);\n      if (isValidLocale(value)) return value;\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_LOCAL_STORAGE && routing.storage.localStorage) {\n    for (let i = 0; i < routing.storage.localStorage.length; i++) {\n      try {\n        const value = options?.getLocaleStorage?.(\n          routing.storage.localStorage[i].name\n        );\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_SESSION_STORAGE && routing.storage.sessionStorage) {\n    for (let i = 0; i < routing.storage.sessionStorage.length; i++) {\n      try {\n        const value = options?.getSessionStorage?.(\n          routing.storage.sessionStorage[i].name\n        );\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_HEADERS && routing.storage.headers) {\n    for (let i = 0; i < routing.storage.headers.length; i++) {\n      try {\n        const value = options?.getHeader?.(routing.storage.headers[i].name);\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n};\n\n/**\n * Stores the locale in all configured storage mechanisms\n * (cookies, localStorage, sessionStorage, headers).\n *\n * @deprecated Use {@link setLocaleInStorageClient} (browser) or\n * {@link setLocaleInStorageServer} (server) instead.\n */\nexport const setLocaleInStorage = (\n  locale: LocalesValues,\n  options?: LocaleStorageOptions\n): void => {\n  if (options?.isCookieEnabled === false) return;\n\n  if (!TREE_SHAKE_STORAGE_COOKIES && routing.storage.cookies) {\n    for (let i = 0; i < routing.storage.cookies.length; i++) {\n      const { name, attributes } = routing.storage.cookies[i];\n      try {\n        if (options?.setCookieStore) {\n          options.setCookieStore(name, locale, {\n            ...attributes,\n            expires: resolveExpiresToTimestamp(attributes.expires),\n          });\n        }\n      } catch {\n        try {\n          if (options?.setCookieString) {\n            options.setCookieString(\n              name,\n              buildCookieString(name, locale, attributes)\n            );\n          }\n        } catch {}\n      }\n    }\n  }\n\n  if (\n    !TREE_SHAKE_STORAGE_LOCAL_STORAGE &&\n    routing.storage.localStorage &&\n    options?.setLocaleStorage\n  ) {\n    for (let i = 0; i < routing.storage.localStorage.length; i++) {\n      const { name } = routing.storage.localStorage[i];\n      try {\n        if (!(options?.overwrite ?? true) && options?.getLocaleStorage) {\n          if (options.getLocaleStorage(name)) continue;\n        }\n        options.setLocaleStorage(name, locale);\n      } catch {}\n    }\n  }\n\n  if (\n    !TREE_SHAKE_STORAGE_SESSION_STORAGE &&\n    routing.storage.sessionStorage &&\n    options?.setSessionStorage\n  ) {\n    for (let i = 0; i < routing.storage.sessionStorage.length; i++) {\n      const { name } = routing.storage.sessionStorage[i];\n      try {\n        if (!(options?.overwrite ?? true) && options?.getSessionStorage) {\n          if (options.getSessionStorage(name)) continue;\n        }\n        options.setSessionStorage(name, locale);\n      } catch {}\n    }\n  }\n\n  if (\n    !TREE_SHAKE_STORAGE_HEADERS &&\n    routing.storage.headers &&\n    options?.setHeader\n  ) {\n    for (let i = 0; i < routing.storage.headers.length; i++) {\n      try {\n        options.setHeader(routing.storage.headers[i].name, locale);\n      } catch {}\n    }\n  }\n};\n\n/**\n * Utility object to get and set the locale in storage based on configuration.\n *\n * @deprecated Use {@link LocaleStorageClient} (browser) or\n * {@link LocaleStorageServer} (server) instead.\n */\nexport const LocaleStorage = (options: LocaleStorageOptions) => ({\n  getLocale: () => getLocaleFromStorage(options),\n  setLocale: (locale: LocalesValues) => setLocaleInStorage(locale, options),\n});\n"],"mappings":"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"}
+{"version":3,"file":"localeStorage.cjs","names":["internationalization","routing","resolveExpiresToTimestamp","buildCookieString","getCookie"],"sources":["../../../src/utils/localeStorage.ts"],"sourcesContent":["import { internationalization, routing } from '@intlayer/config/built';\nimport type { Locale } from '@intlayer/types/allLocales';\nimport type { LocalesValues } from '@intlayer/types/module_augmentation';\nimport { buildCookieString, resolveExpiresToTimestamp } from './cookieExpiry';\nimport { getCookie } from './getCookie';\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 cookie storage is explicitly disabled at build time.\n */\nconst TREE_SHAKE_STORAGE_COOKIES =\n  process.env.INTLAYER_ROUTING_STORAGE_COOKIES === 'false';\n\n/**\n * True when localStorage is explicitly disabled at build time.\n */\nconst TREE_SHAKE_STORAGE_LOCAL_STORAGE =\n  process.env.INTLAYER_ROUTING_STORAGE_LOCALSTORAGE === 'false';\n\n/**\n * True when sessionStorage is explicitly disabled at build time.\n */\nconst TREE_SHAKE_STORAGE_SESSION_STORAGE =\n  process.env.INTLAYER_ROUTING_STORAGE_SESSIONSTORAGE === 'false';\n\n/**\n * True when header storage is explicitly disabled at build time.\n */\nconst TREE_SHAKE_STORAGE_HEADERS =\n  process.env.INTLAYER_ROUTING_STORAGE_HEADERS === 'false';\n\n// ============================================================================\n// Shared types\n// ============================================================================\n\nexport type CookieBuildAttributes = {\n  domain?: string;\n  path?: string;\n  secure?: boolean;\n  httpOnly?: boolean;\n  sameSite?: 'strict' | 'lax' | 'none';\n  /**\n   * Absolute expiry as milliseconds since epoch, ready for `cookieStore.set()`.\n   * Already resolved from the normalized `expires` by\n   * `resolveExpiresToTimestamp`.\n   */\n  expires?: number | undefined;\n};\n\n// ============================================================================\n// Client-specific types and functions\n// (cookies via browser APIs, localStorage, sessionStorage — no headers)\n// ============================================================================\n\nexport type LocaleStorageClientOptions = {\n  overwrite?: boolean;\n  isCookieEnabled?: boolean;\n  setCookieStore?: (\n    name: string,\n    value: string,\n    cookie: CookieBuildAttributes\n  ) => void;\n  setCookieString?: (name: string, cookie: string) => void;\n  getCookie?: (name: string) => string | undefined | null;\n  setSessionStorage?: (name: string, value: string) => void;\n  getSessionStorage?: (name: string) => string | undefined | null;\n  setLocaleStorage?: (name: string, value: string) => void;\n  getLocaleStorage?: (name: string) => string | undefined | null;\n};\n\n// cookieStore is part of the experimental Cookie Store API\ndeclare const cookieStore: any;\n\nexport const localeStorageOptions: LocaleStorageClientOptions = {\n  getCookie: (name: string) =>\n    document.cookie\n      .split(';')\n      .find((c) => c.trim().startsWith(`${name}=`))\n      ?.split('=')[1],\n  getLocaleStorage: (name: string) => localStorage.getItem(name),\n  getSessionStorage: (name: string) => sessionStorage.getItem(name),\n  isCookieEnabled: true,\n  setCookieStore: (name, value, attributes) =>\n    cookieStore.set({\n      name,\n      value,\n      path: attributes.path,\n      domain: attributes.domain,\n      expires: attributes.expires,\n      sameSite: attributes.sameSite,\n    }),\n  setCookieString: (_name, cookie) => {\n    // biome-ignore lint/suspicious/noDocumentCookie: set cookie fallback\n    document.cookie = cookie;\n  },\n  setSessionStorage: (name, value) => sessionStorage.setItem(name, value),\n  setLocaleStorage: (name, value) => localStorage.setItem(name, value),\n};\n\n/**\n * Retrieves the locale from browser storage mechanisms\n * (cookies, localStorage, sessionStorage).\n * Does not read from headers — use `getLocaleFromStorageServer` for that.\n */\nexport const getLocaleFromStorageClient = (\n  options: LocaleStorageClientOptions = localeStorageOptions\n): Locale | undefined => {\n  const { locales } = internationalization;\n\n  if (options?.isCookieEnabled === false) return undefined;\n\n  const isValidLocale = (value: string | null | undefined): value is Locale =>\n    !!value && locales.includes(value as Locale);\n\n  if (!TREE_SHAKE_STORAGE_COOKIES) {\n    for (let i = 0; i < (routing.storage.cookies ?? []).length; i++) {\n      try {\n        const value = options?.getCookie?.(routing.storage.cookies![i].name);\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_LOCAL_STORAGE) {\n    for (let i = 0; i < (routing.storage.localStorage ?? []).length; i++) {\n      try {\n        const value = options?.getLocaleStorage?.(\n          routing.storage.localStorage![i].name\n        );\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_SESSION_STORAGE && routing.storage.sessionStorage) {\n    for (let i = 0; i < routing.storage.sessionStorage.length; i++) {\n      try {\n        const value = options?.getSessionStorage?.(\n          routing.storage.sessionStorage[i].name\n        );\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n};\n\n/**\n * Stores the locale in browser storage mechanisms\n * (cookies, localStorage, sessionStorage).\n * Does not write to headers — use `setLocaleInStorageServer` for that.\n */\nexport const setLocaleInStorageClient = (\n  locale: LocalesValues,\n  options?: LocaleStorageClientOptions\n): void => {\n  if (options?.isCookieEnabled === false) return;\n\n  if (!TREE_SHAKE_STORAGE_COOKIES && routing.storage.cookies) {\n    for (let i = 0; i < routing.storage.cookies.length; i++) {\n      const { name, attributes } = routing.storage.cookies[i];\n      try {\n        if (options?.setCookieStore) {\n          options.setCookieStore(name, locale, {\n            ...attributes,\n            expires: resolveExpiresToTimestamp(attributes.expires),\n          });\n        }\n      } catch {\n        try {\n          if (options?.setCookieString) {\n            options.setCookieString(\n              name,\n              buildCookieString(name, locale, attributes)\n            );\n          }\n        } catch {}\n      }\n    }\n  }\n\n  if (\n    !TREE_SHAKE_STORAGE_LOCAL_STORAGE &&\n    routing.storage.localStorage &&\n    options?.setLocaleStorage\n  ) {\n    for (let i = 0; i < routing.storage.localStorage.length; i++) {\n      const { name } = routing.storage.localStorage[i];\n      try {\n        if (!(options?.overwrite ?? true) && options?.getLocaleStorage) {\n          if (options.getLocaleStorage(name)) continue;\n        }\n        options.setLocaleStorage(name, locale);\n      } catch {}\n    }\n  }\n\n  if (\n    !TREE_SHAKE_STORAGE_SESSION_STORAGE &&\n    routing.storage.sessionStorage &&\n    options?.setSessionStorage\n  ) {\n    for (let i = 0; i < routing.storage.sessionStorage.length; i++) {\n      const { name } = routing.storage.sessionStorage[i];\n      try {\n        if (!(options?.overwrite ?? true) && options?.getSessionStorage) {\n          if (options.getSessionStorage(name)) continue;\n        }\n        options.setSessionStorage(name, locale);\n      } catch {}\n    }\n  }\n};\n\n/**\n * Client-side locale storage utility.\n * Handles cookies (browser), localStorage and sessionStorage.\n * Does not access headers.\n *\n * @example\n * ```ts\n * const storage = LocaleStorageClient(localeStorageOptions);\n * const locale = storage.getLocale();\n * storage.setLocale('fr');\n * ```\n */\nexport const LocaleStorageClient = (options: LocaleStorageClientOptions) => ({\n  getLocale: () => getLocaleFromStorageClient(options),\n  setLocale: (locale: LocalesValues) =>\n    setLocaleInStorageClient(locale, options),\n});\n\n// ============================================================================\n// Server-specific types and functions\n// (cookies via injected getter/setter, headers — no localStorage/sessionStorage)\n// ============================================================================\n\nexport type LocaleStorageServerOptions = {\n  overwrite?: boolean;\n  isCookieEnabled?: boolean;\n  setCookieStore?: (\n    name: string,\n    value: string,\n    cookie: CookieBuildAttributes\n  ) => void;\n  setCookieString?: (name: string, cookie: string) => void;\n  getCookie?: (name: string) => string | undefined | null;\n  getHeader?: (name: string) => string | undefined | null;\n  setHeader?: (name: string, value: string) => void;\n};\n\n/**\n * Retrieves the locale from server-side storage mechanisms (cookies, headers).\n * Does not access localStorage or sessionStorage.\n * No browser cookie fallback — the caller must provide `getCookie`.\n */\nexport const getLocaleFromStorageServer = (\n  options: LocaleStorageServerOptions\n): Locale | undefined => {\n  const { locales } = internationalization;\n\n  if (options?.isCookieEnabled === false) return undefined;\n\n  const isValidLocale = (value: string | null | undefined): value is Locale =>\n    !!value && locales.includes(value as Locale);\n\n  if (!TREE_SHAKE_STORAGE_COOKIES && routing.storage.cookies) {\n    for (let i = 0; i < routing.storage.cookies.length; i++) {\n      try {\n        const value = options?.getCookie?.(routing.storage.cookies[i].name);\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_HEADERS && routing.storage.headers) {\n    for (let i = 0; i < routing.storage.headers.length; i++) {\n      try {\n        const value = options?.getHeader?.(routing.storage.headers[i].name);\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n};\n\n/**\n * Stores the locale in server-side storage mechanisms (cookies, headers).\n * Does not write to localStorage or sessionStorage.\n */\nexport const setLocaleInStorageServer = (\n  locale: LocalesValues,\n  options?: LocaleStorageServerOptions\n): void => {\n  if (options?.isCookieEnabled === false) return;\n\n  if (!TREE_SHAKE_STORAGE_COOKIES && routing.storage.cookies) {\n    for (let i = 0; i < routing.storage.cookies.length; i++) {\n      const { name, attributes } = routing.storage.cookies[i];\n\n      try {\n        if (options?.setCookieStore) {\n          options.setCookieStore(name, locale, {\n            ...attributes,\n            expires: resolveExpiresToTimestamp(attributes.expires),\n          });\n        }\n      } catch {\n        try {\n          if (options?.setCookieString) {\n            options.setCookieString(\n              name,\n              buildCookieString(name, locale, attributes)\n            );\n          }\n        } catch {}\n      }\n    }\n  }\n\n  if (\n    !TREE_SHAKE_STORAGE_HEADERS &&\n    routing.storage.headers &&\n    options?.setHeader\n  ) {\n    for (let i = 0; i < routing.storage.headers.length; i++) {\n      try {\n        options.setHeader(routing.storage.headers[i].name, locale);\n      } catch {}\n    }\n  }\n};\n\n/**\n * Server-side locale storage utility.\n * Handles cookies (via injected getter/setter) and headers.\n * Does not access localStorage or sessionStorage.\n *\n * @example\n * ```ts\n * const storage = LocaleStorageServer({\n *   getCookie: (name) => req.cookies[name],\n *   setCookieStore: (name, value, attrs) => res.cookie(name, value, attrs),\n *   getHeader: (name) => req.headers[name],\n *   setHeader: (name, value) => res.setHeader(name, value),\n * });\n * const locale = storage.getLocale();\n * storage.setLocale('fr');\n * ```\n */\nexport const LocaleStorageServer = (options: LocaleStorageServerOptions) => ({\n  getLocale: () => getLocaleFromStorageServer(options),\n  setLocale: (locale: LocalesValues) =>\n    setLocaleInStorageServer(locale, options),\n});\n\n// ============================================================================\n// Deprecated: combined LocaleStorage\n// Use LocaleStorageClient or LocaleStorageServer instead\n// ============================================================================\n\n/**\n * @deprecated Use {@link LocaleStorageClientOptions} or {@link LocaleStorageServerOptions} instead.\n */\nexport type LocaleStorageOptions = LocaleStorageClientOptions &\n  LocaleStorageServerOptions;\n\n/**\n * Retrieves the locale from all storage mechanisms\n * (cookies, localStorage, sessionStorage, headers).\n *\n * @deprecated Use {@link getLocaleFromStorageClient} (browser) or\n * {@link getLocaleFromStorageServer} (server) instead.\n */\nexport const getLocaleFromStorage = (\n  options: Pick<\n    LocaleStorageOptions,\n    | 'getCookie'\n    | 'getSessionStorage'\n    | 'getLocaleStorage'\n    | 'getHeader'\n    | 'isCookieEnabled'\n  >\n): Locale | undefined => {\n  const { locales } = internationalization;\n\n  if (options?.isCookieEnabled === false) return undefined;\n\n  const isValidLocale = (value: string | null | undefined): value is Locale =>\n    !!value && locales.includes(value as Locale);\n\n  const readCookie = (name: string): string | undefined => {\n    try {\n      const fromOption = options?.getCookie?.(name);\n      if (fromOption !== null && fromOption !== undefined) return fromOption;\n    } catch {}\n    // Browser fallback kept for backward compatibility\n    return getCookie(name);\n  };\n\n  if (!TREE_SHAKE_STORAGE_COOKIES && routing.storage.cookies) {\n    for (let i = 0; i < routing.storage.cookies.length; i++) {\n      const value = readCookie(routing.storage.cookies[i].name);\n      if (isValidLocale(value)) return value;\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_LOCAL_STORAGE && routing.storage.localStorage) {\n    for (let i = 0; i < routing.storage.localStorage.length; i++) {\n      try {\n        const value = options?.getLocaleStorage?.(\n          routing.storage.localStorage[i].name\n        );\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_SESSION_STORAGE && routing.storage.sessionStorage) {\n    for (let i = 0; i < routing.storage.sessionStorage.length; i++) {\n      try {\n        const value = options?.getSessionStorage?.(\n          routing.storage.sessionStorage[i].name\n        );\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n\n  if (!TREE_SHAKE_STORAGE_HEADERS && routing.storage.headers) {\n    for (let i = 0; i < routing.storage.headers.length; i++) {\n      try {\n        const value = options?.getHeader?.(routing.storage.headers[i].name);\n        if (isValidLocale(value)) return value;\n      } catch {}\n    }\n  }\n};\n\n/**\n * Stores the locale in all configured storage mechanisms\n * (cookies, localStorage, sessionStorage, headers).\n *\n * @deprecated Use {@link setLocaleInStorageClient} (browser) or\n * {@link setLocaleInStorageServer} (server) instead.\n */\nexport const setLocaleInStorage = (\n  locale: LocalesValues,\n  options?: LocaleStorageOptions\n): void => {\n  if (options?.isCookieEnabled === false) return;\n\n  if (!TREE_SHAKE_STORAGE_COOKIES && routing.storage.cookies) {\n    for (let i = 0; i < routing.storage.cookies.length; i++) {\n      const { name, attributes } = routing.storage.cookies[i];\n      try {\n        if (options?.setCookieStore) {\n          options.setCookieStore(name, locale, {\n            ...attributes,\n            expires: resolveExpiresToTimestamp(attributes.expires),\n          });\n        }\n      } catch {\n        try {\n          if (options?.setCookieString) {\n            options.setCookieString(\n              name,\n              buildCookieString(name, locale, attributes)\n            );\n          }\n        } catch {}\n      }\n    }\n  }\n\n  if (\n    !TREE_SHAKE_STORAGE_LOCAL_STORAGE &&\n    routing.storage.localStorage &&\n    options?.setLocaleStorage\n  ) {\n    for (let i = 0; i < routing.storage.localStorage.length; i++) {\n      const { name } = routing.storage.localStorage[i];\n      try {\n        if (!(options?.overwrite ?? true) && options?.getLocaleStorage) {\n          if (options.getLocaleStorage(name)) continue;\n        }\n        options.setLocaleStorage(name, locale);\n      } catch {}\n    }\n  }\n\n  if (\n    !TREE_SHAKE_STORAGE_SESSION_STORAGE &&\n    routing.storage.sessionStorage &&\n    options?.setSessionStorage\n  ) {\n    for (let i = 0; i < routing.storage.sessionStorage.length; i++) {\n      const { name } = routing.storage.sessionStorage[i];\n      try {\n        if (!(options?.overwrite ?? true) && options?.getSessionStorage) {\n          if (options.getSessionStorage(name)) continue;\n        }\n        options.setSessionStorage(name, locale);\n      } catch {}\n    }\n  }\n\n  if (\n    !TREE_SHAKE_STORAGE_HEADERS &&\n    routing.storage.headers &&\n    options?.setHeader\n  ) {\n    for (let i = 0; i < routing.storage.headers.length; i++) {\n      try {\n        options.setHeader(routing.storage.headers[i].name, locale);\n      } catch {}\n    }\n  }\n};\n\n/**\n * Utility object to get and set the locale in storage based on configuration.\n *\n * @deprecated Use {@link LocaleStorageClient} (browser) or\n * {@link LocaleStorageServer} (server) instead.\n */\nexport const LocaleStorage = (options: LocaleStorageOptions) => ({\n  getLocale: () => getLocaleFromStorage(options),\n  setLocale: (locale: LocalesValues) => setLocaleInStorage(locale, options),\n});\n"],"mappings":"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"}

package/dist/esm/index.mjs

@@ -62,6 +62,7 @@ import { renameContentNodeByKeyPath } from "./dictionaryManipulator/renameConten
 import { updateNodeChildren } from "./dictionaryManipulator/updateNodeChildren.mjs";
 import { checkIsURLAbsolute } from "./utils/checkIsURLAbsolute.mjs";
 import { getPathWithoutLocale } from "./localization/getPathWithoutLocale.mjs";
+import { comparePaths, normalizePath } from "./localization/comparePaths.mjs";
 import { getPrefix } from "./localization/getPrefix.mjs";
 import { getCanonicalPath, getInternalPath, getLocalizedPath, getRewritePath, getRewriteRules } from "./localization/rewriteUtils.mjs";
 import { getLocalizedUrl } from "./localization/getLocalizedUrl.mjs";
@@ -92,4 +93,4 @@ import { interpolateMessage, parseTaggedMessage, resolveMessage, resolveMessageN
 import { isSameKeyPath } from "./utils/isSameKeyPath.mjs";
 import { stringifyYaml } from "./utils/stringifyYaml.mjs";
 
-export { ATTRIBUTES_TO_SANITIZE, ATTRIBUTE_TO_NODE_PROP_MAP, ATTR_EXTRACTOR_R, BLOCKQUOTE_ALERT_R, BLOCKQUOTE_R, BLOCKQUOTE_TRIM_LEFT_MULTILINE_R, BLOCK_END_R, BREAK_LINE_R, BREAK_THEMATIC_R, CAPTURE_LETTER_AFTER_HYPHEN, CODE_BLOCK_FENCED_R, CODE_BLOCK_R, CODE_INLINE_R, COMPOSITE_ID_SEPARATOR, CONSECUTIVE_NEWLINE_R, CR_NEWLINE_R, CUSTOM_COMPONENT_R, CachedIntl, CachedIntl as Intl, DO_NOT_PROCESS_HTML_ELEMENTS, DURATION_DELAY_TRIGGER, FOOTNOTE_R, FOOTNOTE_REFERENCE_R, FORMFEED_R, FRONT_MATTER_R, GFM_TASK_R, HEADING_ATX_COMPLIANT_R, HEADING_R, HEADING_SETEXT_R, HTML_BLOCK_ELEMENT_R, HTML_CHAR_CODE_R, HTML_COMMENT_R, HTML_CUSTOM_ATTR_R, HTML_LEFT_TRIM_AMOUNT_R, HTML_SELF_CLOSING_ELEMENT_R, HTML_TAGS, INLINE_SKIP_R, INTERPOLATION_R, LINK_AUTOLINK_BARE_URL_R, LINK_AUTOLINK_R, LIST_LOOKBEHIND_R, LOOKAHEAD, LocaleStorage, LocaleStorageClient, LocaleStorageServer, NAMED_CODES_TO_UNICODE, NP_TABLE_R, ORDERED, ORDERED_LIST_BULLET, ORDERED_LIST_ITEM_PREFIX, ORDERED_LIST_ITEM_PREFIX_R, ORDERED_LIST_ITEM_R, ORDERED_LIST_R, PARAGRAPH_R, Priority, QUALIFIER_DYNAMIC_TYPES_KEY, QUALIFIER_ORDER, REFERENCE_IMAGE_OR_LINK, REFERENCE_IMAGE_R, REFERENCE_LINK_R, RuleType, SHORTCODE_R, SHOULD_RENDER_AS_BLOCK_R, TABLE_CENTER_ALIGN, TABLE_LEFT_ALIGN, TABLE_RIGHT_ALIGN, TABLE_TRIM_PIPES, TAB_R, TEXT_BOLD_R, TEXT_EMPHASIZED_R, TEXT_ESCAPED_R, TEXT_MARKED_R, TEXT_PLAIN_R, TEXT_STRIKETHROUGHED_R, TRIM_STARTING_NEWLINES, UNESCAPE_R, UNORDERED, UNORDERED_LIST_BULLET, UNORDERED_LIST_ITEM_PREFIX, UNORDERED_LIST_ITEM_PREFIX_R, UNORDERED_LIST_ITEM_R, UNORDERED_LIST_R, VOID_HTML_ELEMENTS, allowInline, anyScopeRegex, attributeValueToNodePropValue, bindIntl, blockRegex, buildMaskPlugin, captureNothing, checkIsURLAbsolute, checkMissingLocalesPlugin, compact, compile, compileWithOptions, condition as cond, conditionPlugin, createCompiler, createRenderer, currency, cx, date, deepTransformNode, editDictionaryByKeyPath, enumeration as enu, enumerationPlugin, fallbackPlugin, filePlugin, filterMissingTranslationsOnlyPlugin, filterTranslationsOnlyPlugin, findMatchingCondition, gender, genderPlugin, generateListItemPrefix, generateListItemPrefixRegex, generateListItemRegex, generateListRegex, generateSitemap, generateSitemapUrl, get, getBasePlugins, getBrowserLocale, getCachedIntl, getCanonicalPath, getCondition, getContent, getContentNodeByKeyPath, getCookie, getDefaultNode, getDictionary, getDictionaryCompositeId, getDictionaryQualifierId, getDictionaryQualifierSegments, getDictionaryQualifierTypes, getDictionarySelectorCacheKey, getEditedContent, getEditedDictionary, getEmptyNode, getEnumeration, getFilterMissingTranslationsContent, getFilterMissingTranslationsDictionary, getFilterTranslationsOnlyContent, getFilterTranslationsOnlyDictionary, getFilteredLocalesContent, getFilteredLocalesDictionary, getHTML, getHTMLTextDir, getInsertionValues, getInternalPath, getIntlayer, getLocale, getLocaleFromPath, getLocaleFromStorage, getLocaleFromStorageClient, getLocaleFromStorageServer, getLocaleLang, getLocaleName, getLocalizedContent, getLocalizedPath, getLocalizedUrl, getMarkdownMetadata, getMaskContent, getMissingLocalesContent, getMissingLocalesContentFromDictionary, getMultilingualDictionary, getMultilingualUrls, getNesting, getNodeChildren, getNodeType, getPathWithoutLocale, getPerLocaleDictionary, getPlural, getPrefix, getReplacedValuesContent, getRewritePath, getRewriteRules, getSplittedContent, getSplittedDictionaryContent, getTranslation, html, i18nextToIntlayerFormatter, icuToIntlayerFormatter, inlineRegex, insertion as insert, insertContentInDictionary, insertionPlugin, interpolateMessage, intlayerToI18nextFormatter, intlayerToICUFormatter, intlayerToPortableObjectFormatter, intlayerToVueI18nFormatter, isQualifiedDictionaryGroup, isQualifiedDynamicLoaderMap, isSameKeyPath, isValidElement, list, localeDetector, localeFlatMap, localeMap, localeRecord, localeResolver, localeStorageOptions, markdown as md, mergeDictionaries, mergeQualifiedDictionaries, nesting as nest, nestedPlugin, normalizeAttributeKey, normalizeDictionaries, normalizeDictionary, normalizeWhitespace, number, orderDictionaries, parseBlock, parseCaptureInline, parseDictionarySelector, parseInline, parseMarkdown, parseSimpleInline, parseStyleAttribute, parseTableAlign, parseTableAlignCapture, parseTableCells, parseTableRow, parseTaggedMessage, parseYaml, parserFor, percentage, plural, pluralPlugin, portableObjectToIntlayerFormatter, presets, qualifies, reconstructQualifiedEntry, relativeTime, removeContentNodeByKeyPath, renameContentNodeByKeyPath, renderFor, renderMarkdownAst, renderNothing, resolveMessage, resolveMessageNode, resolveQualifiedDictionary, resolveQualifiedDynamicContent, resolveQualifiedDynamicContentAsync, sanitizer, setLocaleInStorage, setLocaleInStorageClient, setLocaleInStorageServer, simpleInlineRegex, slugify, some, splitInsertionTemplate, startsWith, stringifyYaml, translation as t, translationPlugin, trimEnd, trimLeadingWhitespaceOutsideFences, unescapeString, units, unquote, updateNodeChildren, validateHTML, validateMarkdown, validatePrefix, vueI18nToIntlayerFormatter };
+export { ATTRIBUTES_TO_SANITIZE, ATTRIBUTE_TO_NODE_PROP_MAP, ATTR_EXTRACTOR_R, BLOCKQUOTE_ALERT_R, BLOCKQUOTE_R, BLOCKQUOTE_TRIM_LEFT_MULTILINE_R, BLOCK_END_R, BREAK_LINE_R, BREAK_THEMATIC_R, CAPTURE_LETTER_AFTER_HYPHEN, CODE_BLOCK_FENCED_R, CODE_BLOCK_R, CODE_INLINE_R, COMPOSITE_ID_SEPARATOR, CONSECUTIVE_NEWLINE_R, CR_NEWLINE_R, CUSTOM_COMPONENT_R, CachedIntl, CachedIntl as Intl, DO_NOT_PROCESS_HTML_ELEMENTS, DURATION_DELAY_TRIGGER, FOOTNOTE_R, FOOTNOTE_REFERENCE_R, FORMFEED_R, FRONT_MATTER_R, GFM_TASK_R, HEADING_ATX_COMPLIANT_R, HEADING_R, HEADING_SETEXT_R, HTML_BLOCK_ELEMENT_R, HTML_CHAR_CODE_R, HTML_COMMENT_R, HTML_CUSTOM_ATTR_R, HTML_LEFT_TRIM_AMOUNT_R, HTML_SELF_CLOSING_ELEMENT_R, HTML_TAGS, INLINE_SKIP_R, INTERPOLATION_R, LINK_AUTOLINK_BARE_URL_R, LINK_AUTOLINK_R, LIST_LOOKBEHIND_R, LOOKAHEAD, LocaleStorage, LocaleStorageClient, LocaleStorageServer, NAMED_CODES_TO_UNICODE, NP_TABLE_R, ORDERED, ORDERED_LIST_BULLET, ORDERED_LIST_ITEM_PREFIX, ORDERED_LIST_ITEM_PREFIX_R, ORDERED_LIST_ITEM_R, ORDERED_LIST_R, PARAGRAPH_R, Priority, QUALIFIER_DYNAMIC_TYPES_KEY, QUALIFIER_ORDER, REFERENCE_IMAGE_OR_LINK, REFERENCE_IMAGE_R, REFERENCE_LINK_R, RuleType, SHORTCODE_R, SHOULD_RENDER_AS_BLOCK_R, TABLE_CENTER_ALIGN, TABLE_LEFT_ALIGN, TABLE_RIGHT_ALIGN, TABLE_TRIM_PIPES, TAB_R, TEXT_BOLD_R, TEXT_EMPHASIZED_R, TEXT_ESCAPED_R, TEXT_MARKED_R, TEXT_PLAIN_R, TEXT_STRIKETHROUGHED_R, TRIM_STARTING_NEWLINES, UNESCAPE_R, UNORDERED, UNORDERED_LIST_BULLET, UNORDERED_LIST_ITEM_PREFIX, UNORDERED_LIST_ITEM_PREFIX_R, UNORDERED_LIST_ITEM_R, UNORDERED_LIST_R, VOID_HTML_ELEMENTS, allowInline, anyScopeRegex, attributeValueToNodePropValue, bindIntl, blockRegex, buildMaskPlugin, captureNothing, checkIsURLAbsolute, checkMissingLocalesPlugin, compact, comparePaths, compile, compileWithOptions, condition as cond, conditionPlugin, createCompiler, createRenderer, currency, cx, date, deepTransformNode, editDictionaryByKeyPath, enumeration as enu, enumerationPlugin, fallbackPlugin, filePlugin, filterMissingTranslationsOnlyPlugin, filterTranslationsOnlyPlugin, findMatchingCondition, gender, genderPlugin, generateListItemPrefix, generateListItemPrefixRegex, generateListItemRegex, generateListRegex, generateSitemap, generateSitemapUrl, get, getBasePlugins, getBrowserLocale, getCachedIntl, getCanonicalPath, getCondition, getContent, getContentNodeByKeyPath, getCookie, getDefaultNode, getDictionary, getDictionaryCompositeId, getDictionaryQualifierId, getDictionaryQualifierSegments, getDictionaryQualifierTypes, getDictionarySelectorCacheKey, getEditedContent, getEditedDictionary, getEmptyNode, getEnumeration, getFilterMissingTranslationsContent, getFilterMissingTranslationsDictionary, getFilterTranslationsOnlyContent, getFilterTranslationsOnlyDictionary, getFilteredLocalesContent, getFilteredLocalesDictionary, getHTML, getHTMLTextDir, getInsertionValues, getInternalPath, getIntlayer, getLocale, getLocaleFromPath, getLocaleFromStorage, getLocaleFromStorageClient, getLocaleFromStorageServer, getLocaleLang, getLocaleName, getLocalizedContent, getLocalizedPath, getLocalizedUrl, getMarkdownMetadata, getMaskContent, getMissingLocalesContent, getMissingLocalesContentFromDictionary, getMultilingualDictionary, getMultilingualUrls, getNesting, getNodeChildren, getNodeType, getPathWithoutLocale, getPerLocaleDictionary, getPlural, getPrefix, getReplacedValuesContent, getRewritePath, getRewriteRules, getSplittedContent, getSplittedDictionaryContent, getTranslation, html, i18nextToIntlayerFormatter, icuToIntlayerFormatter, inlineRegex, insertion as insert, insertContentInDictionary, insertionPlugin, interpolateMessage, intlayerToI18nextFormatter, intlayerToICUFormatter, intlayerToPortableObjectFormatter, intlayerToVueI18nFormatter, isQualifiedDictionaryGroup, isQualifiedDynamicLoaderMap, isSameKeyPath, isValidElement, list, localeDetector, localeFlatMap, localeMap, localeRecord, localeResolver, localeStorageOptions, markdown as md, mergeDictionaries, mergeQualifiedDictionaries, nesting as nest, nestedPlugin, normalizeAttributeKey, normalizeDictionaries, normalizeDictionary, normalizePath, normalizeWhitespace, number, orderDictionaries, parseBlock, parseCaptureInline, parseDictionarySelector, parseInline, parseMarkdown, parseSimpleInline, parseStyleAttribute, parseTableAlign, parseTableAlignCapture, parseTableCells, parseTableRow, parseTaggedMessage, parseYaml, parserFor, percentage, plural, pluralPlugin, portableObjectToIntlayerFormatter, presets, qualifies, reconstructQualifiedEntry, relativeTime, removeContentNodeByKeyPath, renameContentNodeByKeyPath, renderFor, renderMarkdownAst, renderNothing, resolveMessage, resolveMessageNode, resolveQualifiedDictionary, resolveQualifiedDynamicContent, resolveQualifiedDynamicContentAsync, sanitizer, setLocaleInStorage, setLocaleInStorageClient, setLocaleInStorageServer, simpleInlineRegex, slugify, some, splitInsertionTemplate, startsWith, stringifyYaml, translation as t, translationPlugin, trimEnd, trimLeadingWhitespaceOutsideFences, unescapeString, units, unquote, updateNodeChildren, validateHTML, validateMarkdown, validatePrefix, vueI18nToIntlayerFormatter };

package/dist/esm/interpreter/getContent/plugins.mjs

@@ -19,7 +19,7 @@ const fallbackPlugin = {
 	transform: (node) => node
 };
 /** Translation plugin. Replaces node with a locale string if nodeType = Translation. */
-const translationPlugin = (locale, fallback) => process.env["INTLAYER_NODE_TYPE_TRANSLATION"] === "false" ? fallbackPlugin : {
+const translationPlugin = (locale, fallback) => process.env.INTLAYER_NODE_TYPE_TRANSLATION === "false" ? fallbackPlugin : {
 	id: "translation-plugin",
 	canHandle: (node) => typeof node === "object" && node?.nodeType === NodeTypes.TRANSLATION,
 	transform: (node, props, deepTransformNode) => {
@@ -40,7 +40,7 @@ const translationPlugin = (locale, fallback) => process.env["INTLAYER_NODE_TYPE_
 	}
 };
 /** Enumeration plugin. Replaces node with a function that takes quantity => string. */
-const enumerationPlugin = process.env["INTLAYER_NODE_TYPE_ENUMERATION"] === "false" ? fallbackPlugin : {
+const enumerationPlugin = process.env.INTLAYER_NODE_TYPE_ENUMERATION === "false" ? fallbackPlugin : {
 	id: "enumeration-plugin",
 	canHandle: (node) => typeof node === "object" && node?.nodeType === NodeTypes.ENUMERATION,
 	transform: (node, props, deepTransformNode) => {
@@ -69,7 +69,7 @@ const enumerationPlugin = process.env["INTLAYER_NODE_TYPE_ENUMERATION"] === "fal
 * `{ count, ...values }`) => string, picking the matching CLDR plural form
 * for the active locale and interpolating `{{count}}` (and other values).
 */
-const pluralPlugin = (locale) => process.env["INTLAYER_NODE_TYPE_PLURAL"] === "false" ? fallbackPlugin : {
+const pluralPlugin = (locale) => process.env.INTLAYER_NODE_TYPE_PLURAL === "false" ? fallbackPlugin : {
 	id: "plural-plugin",
 	canHandle: (node) => typeof node === "object" && node?.nodeType === NodeTypes.PLURAL,
 	transform: (node, props, deepTransformNode) => {
@@ -118,7 +118,7 @@ const pluralPlugin = (locale) => process.env["INTLAYER_NODE_TYPE_PLURAL"] === "f
 	}
 };
 /** Condition plugin. Replaces node with a function that takes boolean => string. */
-const conditionPlugin = process.env["INTLAYER_NODE_TYPE_CONDITION"] === "false" ? fallbackPlugin : {
+const conditionPlugin = process.env.INTLAYER_NODE_TYPE_CONDITION === "false" ? fallbackPlugin : {
 	id: "condition-plugin",
 	canHandle: (node) => typeof node === "object" && node?.nodeType === NodeTypes.CONDITION,
 	transform: (node, props, deepTransformNode) => {
@@ -143,7 +143,7 @@ const conditionPlugin = process.env["INTLAYER_NODE_TYPE_CONDITION"] === "false"
 	}
 };
 /** Insertion plugin. Replaces node with a function that takes quantity => string. */
-const insertionPlugin = process.env["INTLAYER_NODE_TYPE_INSERTION"] === "false" ? fallbackPlugin : {
+const insertionPlugin = process.env.INTLAYER_NODE_TYPE_INSERTION === "false" ? fallbackPlugin : {
 	id: "insertion-plugin",
 	canHandle: (node) => typeof node === "object" && node?.nodeType === NodeTypes.INSERTION,
 	transform: (node, props, deepTransformNode) => {
@@ -178,7 +178,7 @@ const insertionPlugin = process.env["INTLAYER_NODE_TYPE_INSERTION"] === "false"
 	}
 };
 /** Gender plugin. Replaces node with a function that takes gender => string. */
-const genderPlugin = process.env["INTLAYER_NODE_TYPE_GENDER"] === "false" ? fallbackPlugin : {
+const genderPlugin = process.env.INTLAYER_NODE_TYPE_GENDER === "false" ? fallbackPlugin : {
 	id: "gender-plugin",
 	canHandle: (node) => typeof node === "object" && node?.nodeType === NodeTypes.GENDER,
 	transform: (node, props, deepTransformNode) => {
@@ -199,7 +199,7 @@ const genderPlugin = process.env["INTLAYER_NODE_TYPE_GENDER"] === "false" ? fall
 	}
 };
 /** Nested plugin. Replaces node with the result of `getNesting`. */
-const nestedPlugin = (locale) => process.env["INTLAYER_NODE_TYPE_NESTED"] === "false" ? fallbackPlugin : {
+const nestedPlugin = (locale) => process.env.INTLAYER_NODE_TYPE_NESTED === "false" ? fallbackPlugin : {
 	id: "nested-plugin",
 	canHandle: (node) => typeof node === "object" && (node?.nodeType === NodeTypes.NESTED || node?.nodeType === "n"),
 	transform: (node, props) => getNesting(node[NodeTypes.NESTED].dictionaryKey, node[NodeTypes.NESTED].path, {
@@ -208,7 +208,7 @@ const nestedPlugin = (locale) => process.env["INTLAYER_NODE_TYPE_NESTED"] === "f
 	})
 };
 /** File plugin. Replaces node with the result of `getNesting`. */
-const filePlugin = process.env["INTLAYER_NODE_TYPE_FILE"] === "false" ? fallbackPlugin : {
+const filePlugin = process.env.INTLAYER_NODE_TYPE_FILE === "false" ? fallbackPlugin : {
 	id: "file-plugin",
 	canHandle: (node) => typeof node === "object" && node?.nodeType === NodeTypes.FILE,
 	transform: (node, props, deepTransform) => deepTransform(node.content, {

package/dist/esm/interpreter/getContent/plugins.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugins.mjs","names":[],"sources":["../../../../src/interpreter/getContent/plugins.ts"],"sourcesContent":["import type { Locale } from '@intlayer/types/allLocales';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport type { NodeType } from '@intlayer/types/nodeType';\nimport * as NodeTypes from '@intlayer/types/nodeType';\nimport type {\n  ConditionContent,\n  EnumerationContent,\n  FileContent,\n  Gender,\n  GenderContent,\n  InsertionContent,\n  NestedContent,\n  PluralContent,\n  PluralContentState,\n  TranslationContent,\n} from '../../transpiler';\nimport { getCondition } from '../getCondition';\nimport { getEnumeration } from '../getEnumeration';\nimport { getGender } from '../getGender';\nimport { getInsertion } from '../getInsertion';\nimport { type GetNestingResult, getNesting } from '../getNesting';\nimport { getPlural } from '../getPlural';\nimport { getTranslation } from '../getTranslation';\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 * PLUGIN DEFINITION\n * --------------------------------------------- */\n\n/**\n * A plugin/transformer that can optionally transform a node during a single DFS pass.\n * - `canHandle` decides if the node is transformable by this plugin.\n * - `transform` returns the transformed node (and does not recurse further).\n *\n * > `transformFn` is a function that can be used to deeply transform inside the plugin.\n */\nexport type Plugins = {\n  id: string;\n  canHandle: (node: any) => boolean;\n  transform: (\n    node: any,\n    props: NodeProps,\n    transformFn: (node: any, props: NodeProps) => any\n  ) => any;\n};\n\n/** ---------------------------------------------\n * FALLBACK PLUGIN\n *\n * Used to fallback a tree-shaken plugin\n * --------------------------------------------- */\n\nexport const fallbackPlugin: Plugins = {\n  id: 'fallback-plugin',\n  canHandle: () => false,\n  transform: (node) => node,\n};\n\n/** ---------------------------------------------\n * TRANSLATION PLUGIN\n * --------------------------------------------- */\n\nexport type UnionKeys<T> = T extends unknown ? keyof T : never;\nexport type ValueAtKey<T, K> = T extends unknown\n  ? K extends keyof T\n    ? T[K]\n    : never\n  : never;\n\nexport type TranslationCond<T, S, L extends LocalesValues> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.TRANSLATION]: infer U;\n}\n  ? U extends Record<PropertyKey, unknown>\n    ? U[keyof U] extends Record<PropertyKey, unknown>\n      ? {\n          [K in UnionKeys<U[keyof U]>]: L extends keyof U\n            ? K extends keyof U[L]\n              ? U[L][K]\n              : ValueAtKey<U[keyof U], K>\n            : ValueAtKey<U[keyof U], K>;\n        } extends infer Content\n        ? DeepTransformContent<Content, S>\n        : never\n      : (L extends keyof U ? U[L] : U[keyof U]) extends infer Content\n        ? DeepTransformContent<Content, S>\n        : never\n    : never\n  : never;\n\n/** Translation plugin. Replaces node with a locale string if nodeType = Translation. */\nexport const translationPlugin = (\n  locale: LocalesValues,\n  fallback?: LocalesValues\n): Plugins =>\n  process.env['INTLAYER_NODE_TYPE_TRANSLATION'] === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'translation-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.TRANSLATION,\n        transform: (node: TranslationContent, props, deepTransformNode) => {\n          const original = node[NodeTypes.TRANSLATION] ?? {};\n          const result: Record<string, any> = {};\n\n          for (const key in original) {\n            const childProps = {\n              ...props,\n              children: original[key as keyof typeof original],\n              keyPath: [\n                ...props.keyPath,\n                { type: NodeTypes.TRANSLATION, key } as KeyPath,\n              ],\n            };\n            result[key] = deepTransformNode(\n              original[key as keyof typeof original],\n              childProps\n            );\n          }\n\n          return getTranslation(result, locale, fallback);\n        },\n      };\n\n/** ---------------------------------------------\n * ENUMERATION PLUGIN\n * --------------------------------------------- */\n\nexport type EnumerationCond<T, S, _L> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.ENUMERATION]: object;\n}\n  ? (\n      quantity: number\n    ) => DeepTransformContent<\n      T[typeof NodeTypes.ENUMERATION][keyof T[typeof NodeTypes.ENUMERATION]],\n      S\n    >\n  : never;\n\n/** Enumeration plugin. Replaces node with a function that takes quantity => string. */\nexport const enumerationPlugin: Plugins =\n  process.env['INTLAYER_NODE_TYPE_ENUMERATION'] === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'enumeration-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.ENUMERATION,\n        transform: (node: EnumerationContent, props, deepTransformNode) => {\n          const original = node[NodeTypes.ENUMERATION];\n          const result: Record<string, any> = {};\n\n          for (const key in original) {\n            const child = original[key as unknown as keyof typeof original];\n            const childProps = {\n              ...props,\n              children: child,\n              keyPath: [\n                ...props.keyPath,\n                { type: NodeTypes.ENUMERATION, key } as KeyPath,\n              ],\n            };\n            result[key] = deepTransformNode(child, childProps);\n          }\n\n          return (arg: number | { count: number }) => {\n            const quantity = typeof arg === 'number' ? arg : arg.count;\n            const subResult = getEnumeration(result, quantity);\n\n            if (typeof subResult === 'function' && typeof arg === 'object') {\n              return subResult(arg);\n            }\n\n            return subResult;\n          };\n        },\n      };\n\n/** ---------------------------------------------\n * PLURAL PLUGIN\n * --------------------------------------------- */\n\nexport type PluralCond<T, S, _L> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.PLURAL]: object;\n}\n  ? (\n      arg: number | { count: number; [key: string]: unknown }\n    ) => DeepTransformContent<\n      T[typeof NodeTypes.PLURAL][keyof T[typeof NodeTypes.PLURAL]],\n      S\n    >\n  : never;\n\ntype SubResultFunction = (values: Record<string, string | number>) => string;\n\n/**\n * Plural plugin. Replaces node with a function that takes a count (or\n * `{ count, ...values }`) => string, picking the matching CLDR plural form\n * for the active locale and interpolating `{{count}}` (and other values).\n */\nexport const pluralPlugin = (locale?: LocalesValues): Plugins =>\n  process.env['INTLAYER_NODE_TYPE_PLURAL'] === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'plural-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.PLURAL,\n        transform: (node: PluralContent, props, deepTransformNode) => {\n          const original = node[NodeTypes.PLURAL];\n          const result: Record<string, any> = {};\n\n          /** String plugin for plural. Replaces string node with a component that renders the insertion. */\n          const pluralStringPlugin: Plugins = {\n            id: 'plural-string-plugin',\n            canHandle: (node) => typeof node === 'string',\n            transform: (node: string, subProps, deepTransformNode) => {\n              const transformedResult = deepTransformNode(node, {\n                ...subProps,\n                children: node,\n                plugins: [\n                  ...(props.plugins ?? ([] as Plugins[])).filter(\n                    (plugin) => plugin.id !== 'intlayer-node-plugin'\n                  ),\n                ],\n              });\n\n              return (values: { [k: string]: string | number }) => {\n                const children = getInsertion(transformedResult, values);\n\n                return deepTransformNode(children, {\n                  ...subProps,\n                  plugins: props.plugins,\n                  children,\n                });\n              };\n            },\n          };\n\n          for (const key in original) {\n            const child = original[key as keyof typeof original];\n            const childProps = {\n              ...props,\n              children: child,\n              keyPath: [\n                ...props.keyPath,\n                { type: NodeTypes.PLURAL, key } as KeyPath,\n              ],\n              plugins: [pluralStringPlugin, ...(props.plugins ?? [])],\n            };\n            result[key] = deepTransformNode(child, childProps);\n          }\n\n          const effectiveLocale = String(locale ?? props.locale ?? 'en');\n\n          return (arg: number | { count: number; [key: string]: unknown }) => {\n            const count = typeof arg === 'number' ? arg : arg.count;\n            const values =\n              typeof arg === 'number'\n                ? { count: arg }\n                : (arg as { count: number; [key: string]: unknown });\n\n            const subResult: string | SubResultFunction = getPlural(\n              result as PluralContent['plural'] as PluralContentState<string>,\n              count,\n              effectiveLocale\n            );\n\n            if (typeof subResult === 'function') {\n              return (subResult as SubResultFunction)(values);\n            }\n\n            return subResult;\n          };\n        },\n      };\n\n/** ---------------------------------------------\n * CONDITION PLUGIN\n * --------------------------------------------- */\n\nexport type ConditionCond<T, S, _L> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.CONDITION]: object;\n}\n  ? (\n      value: boolean | { value: boolean }\n    ) => DeepTransformContent<\n      T[typeof NodeTypes.CONDITION][keyof T[typeof NodeTypes.CONDITION]],\n      S\n    >\n  : never;\n\n/** Condition plugin. Replaces node with a function that takes boolean => string. */\nexport const conditionPlugin: Plugins =\n  process.env['INTLAYER_NODE_TYPE_CONDITION'] === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'condition-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.CONDITION,\n        transform: (node: ConditionContent, props, deepTransformNode) => {\n          const original = node[NodeTypes.CONDITION];\n          const result: Record<string, any> = {};\n\n          for (const key in original) {\n            const child = original[key as keyof typeof original];\n            const childProps = {\n              ...props,\n              children: child,\n              keyPath: [\n                ...props.keyPath,\n                { type: NodeTypes.CONDITION, key } as KeyPath,\n              ],\n            };\n            result[key] = deepTransformNode(child, childProps);\n          }\n\n          return (arg: boolean | { value: boolean }) => {\n            const value = typeof arg === 'boolean' ? arg : arg.value;\n            const subResult = getCondition(result as any, value);\n\n            if (typeof subResult === 'function' && typeof arg === 'object') {\n              return subResult(arg);\n            }\n\n            return subResult;\n          };\n        },\n      };\n\n/** ---------------------------------------------\n *  INSERTION PLUGIN\n *  --------------------------------------------- */\n\nexport type InsertionCond<T, S, _L> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.INSERTION]: infer I;\n  fields: readonly string[];\n}\n  ? (\n      values: {\n        [K in T['fields'][number]]: string | number;\n      }\n    ) => I extends string\n      ? DeepTransformContent<string, S>\n      : DeepTransformContent<I, S>\n  : never;\n\n/** Insertion plugin. Replaces node with a function that takes quantity => string. */\nexport const insertionPlugin: Plugins =\n  process.env['INTLAYER_NODE_TYPE_INSERTION'] === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'insertion-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.INSERTION,\n        transform: (node: InsertionContent, props, deepTransformNode) => {\n          const newKeyPath: KeyPath[] = [\n            ...props.keyPath,\n            {\n              type: NodeTypes.INSERTION,\n            },\n          ];\n\n          const children = node[NodeTypes.INSERTION];\n\n          /** Insertion string plugin. Replaces string node with a component that render the insertion. */\n          const insertionStringPlugin: Plugins = {\n            id: 'insertion-string-plugin',\n            canHandle: (node) => typeof node === 'string',\n            transform: (node: string, subProps, deepTransformNode) => {\n              const transformedResult = deepTransformNode(node, {\n                ...subProps,\n                children: node,\n                plugins: [\n                  ...(props.plugins ?? ([] as Plugins[])).filter(\n                    (plugin) => plugin.id !== 'intlayer-node-plugin'\n                  ),\n                ],\n              });\n\n              return (\n                values: {\n                  [K in InsertionContent['fields'][number]]: string | number;\n                }\n              ) => {\n                const children = getInsertion(transformedResult, values);\n\n                return deepTransformNode(children, {\n                  ...subProps,\n                  plugins: props.plugins,\n                  children,\n                });\n              };\n            },\n          };\n\n          return deepTransformNode(children, {\n            ...props,\n            children,\n            keyPath: newKeyPath,\n            plugins: [insertionStringPlugin, ...(props.plugins ?? [])],\n          });\n        },\n      };\n\n/** ---------------------------------------------\n * GENDER PLUGIN\n * --------------------------------------------- */\n\nexport type GenderCond<T, S, _L> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.GENDER]: object;\n}\n  ? (\n      value: Gender\n    ) => DeepTransformContent<\n      T[typeof NodeTypes.GENDER][keyof T[typeof NodeTypes.GENDER]],\n      S\n    >\n  : never;\n\n/** Gender plugin. Replaces node with a function that takes gender => string. */\nexport const genderPlugin: Plugins =\n  process.env['INTLAYER_NODE_TYPE_GENDER'] === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'gender-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.GENDER,\n        transform: (node: GenderContent, props, deepTransformNode) => {\n          const original = node[NodeTypes.GENDER];\n          const result: Record<string, any> = {};\n\n          for (const key in original) {\n            const child = original[key as keyof typeof original];\n            const childProps = {\n              ...props,\n              children: child,\n              keyPath: [\n                ...props.keyPath,\n                { type: NodeTypes.GENDER, key } as KeyPath,\n              ],\n            };\n            result[key] = deepTransformNode(child, childProps);\n          }\n\n          return (value: Gender) => getGender(result as any, value);\n        },\n      };\n\n/** ---------------------------------------------\n * NESTED PLUGIN\n * --------------------------------------------- */\n\nexport type NestedCond<T, S, _L> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.NESTED]: infer U;\n}\n  ? U extends {\n      dictionaryKey: infer K extends DictionaryKeys;\n      path?: infer P;\n    }\n    ? GetNestingResult<K, P, S>\n    : never\n  : never;\n\n/** Nested plugin. Replaces node with the result of `getNesting`. */\nexport const nestedPlugin = (locale?: LocalesValues): Plugins =>\n  process.env['INTLAYER_NODE_TYPE_NESTED'] === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'nested-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' &&\n          (node?.nodeType === NodeTypes.NESTED || node?.nodeType === 'n'),\n        transform: (node: NestedContent, props) =>\n          getNesting(\n            node[NodeTypes.NESTED].dictionaryKey,\n            node[NodeTypes.NESTED].path,\n            {\n              ...props,\n              locale: (locale ?? props.locale) as Locale,\n            }\n          ),\n      };\n\n/** ---------------------------------------------\n * FILE PLUGIN\n * --------------------------------------------- */\n\nexport type FileCond<T, S, _L> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.FILE]: string;\n  content?: string;\n}\n  ? DeepTransformContent<string, S>\n  : never;\n\n/** File plugin. Replaces node with the result of `getNesting`. */\nexport const filePlugin: Plugins =\n  process.env['INTLAYER_NODE_TYPE_FILE'] === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'file-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.FILE,\n        transform: (node: FileContent, props, deepTransform) =>\n          deepTransform(node.content, {\n            ...props,\n            children: node.content,\n          }),\n      };\n\n/**\n * PLUGIN RESULT\n */\n\n/**\n * Interface that defines the properties of a node.\n * This interface can be augmented in other packages, such as `react-intlayer`.\n */\nexport interface NodeProps {\n  dictionaryKey: string;\n  keyPath: KeyPath[];\n  plugins?: Plugins[];\n  locale?: Locale;\n  dictionaryPath?: string;\n  children?: any;\n  /**\n   * Forces eager traversal of plain objects in `deepTransformNode`. By default\n   * traversal is lazy (property getters), so callers that discard the returned\n   * value never trigger plugins on nested nodes. Set this when running plugins\n   * for their side effects only (e.g. missing-locale detection).\n   */\n  eager?: boolean;\n}\n\n/**\n * Interface that defines the plugins that can be used to transform a node.\n * This interface can be augmented in other packages, such as `react-intlayer`.\n */\nexport interface IInterpreterPlugin<T, S, L extends LocalesValues> {\n  translation: TranslationCond<T, S, L>;\n  enumeration: EnumerationCond<T, S, L>;\n  plural: PluralCond<T, S, L>;\n  condition: ConditionCond<T, S, L>;\n  insertion: InsertionCond<T, S, L>;\n  gender: GenderCond<T, S, L>;\n  nested: NestedCond<T, S, L>;\n  file: FileCond<T, S, L>;\n}\n\n/**\n * Allow to avoid overwriting import from `intlayer` package when `IInterpreterPlugin<T>` interface is augmented in another package, such as `react-intlayer`.\n */\nexport type IInterpreterPluginState = {\n  translation: true;\n  enumeration: true;\n  plural: true;\n  condition: true;\n  insertion: true;\n  gender: true;\n  nested: true;\n  file: true;\n};\n\n/**\n * Utility type to check if a plugin can be applied to a node.\n */\ntype CheckApplyPlugin<\n  T,\n  K extends keyof IInterpreterPlugin<T, S, L>,\n  S,\n  L extends LocalesValues = DeclaredLocales,\n> = K extends keyof S // Test if the key is a key of S.\n  ? // Test if the key of S is true. Then the plugin can be applied.\n    S[K] extends true\n    ? // Test if the key of S exist\n      IInterpreterPlugin<T, S, L>[K] extends never\n      ? never\n      : // Test if the plugin condition is true (if it's not, the plugin is skipped for this node)\n        IInterpreterPlugin<T, S, L>[K]\n    : never\n  : never;\n\n/**\n * Traverse recursively through an object or array, applying each plugin as needed.\n */\ntype Traverse<T, S, L extends LocalesValues = DeclaredLocales> =\n  T extends ReadonlyArray<infer U> // Turn any read-only array into a plain mutable array\n    ? Array<DeepTransformContent<U, S, L>>\n    : T extends object\n      ? { [K in keyof T]: DeepTransformContent<T[K], S, L> }\n      : T;\n\nexport type IsAny<T> = 0 extends 1 & T ? true : false;\n\n/**\n * Traverse recursively through an object or array, applying each plugin as needed.\n */\nexport type DeepTransformContent<\n  T,\n  S = IInterpreterPluginState,\n  L extends LocalesValues = DeclaredLocales,\n> =\n  IsAny<T> extends true\n    ? T\n    : CheckApplyPlugin<T, keyof IInterpreterPlugin<T, S, L>, S, L> extends never // Check if there is a plugin for T:\n      ? // No plugin was found, so try to transform T recursively:\n        Traverse<T, S, L>\n      : // A plugin was found – use the plugin's transformation.\n        CheckApplyPlugin<T, keyof IInterpreterPlugin<T, S, L>, S, L>;\n"],"mappings":"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"}
+{"version":3,"file":"plugins.mjs","names":[],"sources":["../../../../src/interpreter/getContent/plugins.ts"],"sourcesContent":["import type { Locale } from '@intlayer/types/allLocales';\nimport type { KeyPath } from '@intlayer/types/keyPath';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport type { NodeType } from '@intlayer/types/nodeType';\nimport * as NodeTypes from '@intlayer/types/nodeType';\nimport type {\n  ConditionContent,\n  EnumerationContent,\n  FileContent,\n  Gender,\n  GenderContent,\n  InsertionContent,\n  NestedContent,\n  PluralContent,\n  PluralContentState,\n  TranslationContent,\n} from '../../transpiler';\nimport { getCondition } from '../getCondition';\nimport { getEnumeration } from '../getEnumeration';\nimport { getGender } from '../getGender';\nimport { getInsertion } from '../getInsertion';\nimport { type GetNestingResult, getNesting } from '../getNesting';\nimport { getPlural } from '../getPlural';\nimport { getTranslation } from '../getTranslation';\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 * PLUGIN DEFINITION\n * --------------------------------------------- */\n\n/**\n * A plugin/transformer that can optionally transform a node during a single DFS pass.\n * - `canHandle` decides if the node is transformable by this plugin.\n * - `transform` returns the transformed node (and does not recurse further).\n *\n * > `transformFn` is a function that can be used to deeply transform inside the plugin.\n */\nexport type Plugins = {\n  id: string;\n  canHandle: (node: any) => boolean;\n  transform: (\n    node: any,\n    props: NodeProps,\n    transformFn: (node: any, props: NodeProps) => any\n  ) => any;\n};\n\n/** ---------------------------------------------\n * FALLBACK PLUGIN\n *\n * Used to fallback a tree-shaken plugin\n * --------------------------------------------- */\n\nexport const fallbackPlugin: Plugins = {\n  id: 'fallback-plugin',\n  canHandle: () => false,\n  transform: (node) => node,\n};\n\n/** ---------------------------------------------\n * TRANSLATION PLUGIN\n * --------------------------------------------- */\n\nexport type UnionKeys<T> = T extends unknown ? keyof T : never;\nexport type ValueAtKey<T, K> = T extends unknown\n  ? K extends keyof T\n    ? T[K]\n    : never\n  : never;\n\nexport type TranslationCond<T, S, L extends LocalesValues> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.TRANSLATION]: infer U;\n}\n  ? U extends Record<PropertyKey, unknown>\n    ? U[keyof U] extends Record<PropertyKey, unknown>\n      ? {\n          [K in UnionKeys<U[keyof U]>]: L extends keyof U\n            ? K extends keyof U[L]\n              ? U[L][K]\n              : ValueAtKey<U[keyof U], K>\n            : ValueAtKey<U[keyof U], K>;\n        } extends infer Content\n        ? DeepTransformContent<Content, S>\n        : never\n      : (L extends keyof U ? U[L] : U[keyof U]) extends infer Content\n        ? DeepTransformContent<Content, S>\n        : never\n    : never\n  : never;\n\n/** Translation plugin. Replaces node with a locale string if nodeType = Translation. */\nexport const translationPlugin = (\n  locale: LocalesValues,\n  fallback?: LocalesValues\n): Plugins =>\n  process.env.INTLAYER_NODE_TYPE_TRANSLATION === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'translation-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.TRANSLATION,\n        transform: (node: TranslationContent, props, deepTransformNode) => {\n          const original = node[NodeTypes.TRANSLATION] ?? {};\n          const result: Record<string, any> = {};\n\n          for (const key in original) {\n            const childProps = {\n              ...props,\n              children: original[key as keyof typeof original],\n              keyPath: [\n                ...props.keyPath,\n                { type: NodeTypes.TRANSLATION, key } as KeyPath,\n              ],\n            };\n            result[key] = deepTransformNode(\n              original[key as keyof typeof original],\n              childProps\n            );\n          }\n\n          return getTranslation(result, locale, fallback);\n        },\n      };\n\n/** ---------------------------------------------\n * ENUMERATION PLUGIN\n * --------------------------------------------- */\n\nexport type EnumerationCond<T, S, _L> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.ENUMERATION]: object;\n}\n  ? (\n      quantity: number\n    ) => DeepTransformContent<\n      T[typeof NodeTypes.ENUMERATION][keyof T[typeof NodeTypes.ENUMERATION]],\n      S\n    >\n  : never;\n\n/** Enumeration plugin. Replaces node with a function that takes quantity => string. */\nexport const enumerationPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_ENUMERATION === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'enumeration-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.ENUMERATION,\n        transform: (node: EnumerationContent, props, deepTransformNode) => {\n          const original = node[NodeTypes.ENUMERATION];\n          const result: Record<string, any> = {};\n\n          for (const key in original) {\n            const child = original[key as unknown as keyof typeof original];\n            const childProps = {\n              ...props,\n              children: child,\n              keyPath: [\n                ...props.keyPath,\n                { type: NodeTypes.ENUMERATION, key } as KeyPath,\n              ],\n            };\n            result[key] = deepTransformNode(child, childProps);\n          }\n\n          return (arg: number | { count: number }) => {\n            const quantity = typeof arg === 'number' ? arg : arg.count;\n            const subResult = getEnumeration(result, quantity);\n\n            if (typeof subResult === 'function' && typeof arg === 'object') {\n              return subResult(arg);\n            }\n\n            return subResult;\n          };\n        },\n      };\n\n/** ---------------------------------------------\n * PLURAL PLUGIN\n * --------------------------------------------- */\n\nexport type PluralCond<T, S, _L> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.PLURAL]: object;\n}\n  ? (\n      arg: number | { count: number; [key: string]: unknown }\n    ) => DeepTransformContent<\n      T[typeof NodeTypes.PLURAL][keyof T[typeof NodeTypes.PLURAL]],\n      S\n    >\n  : never;\n\ntype SubResultFunction = (values: Record<string, string | number>) => string;\n\n/**\n * Plural plugin. Replaces node with a function that takes a count (or\n * `{ count, ...values }`) => string, picking the matching CLDR plural form\n * for the active locale and interpolating `{{count}}` (and other values).\n */\nexport const pluralPlugin = (locale?: LocalesValues): Plugins =>\n  process.env.INTLAYER_NODE_TYPE_PLURAL === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'plural-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.PLURAL,\n        transform: (node: PluralContent, props, deepTransformNode) => {\n          const original = node[NodeTypes.PLURAL];\n          const result: Record<string, any> = {};\n\n          /** String plugin for plural. Replaces string node with a component that renders the insertion. */\n          const pluralStringPlugin: Plugins = {\n            id: 'plural-string-plugin',\n            canHandle: (node) => typeof node === 'string',\n            transform: (node: string, subProps, deepTransformNode) => {\n              const transformedResult = deepTransformNode(node, {\n                ...subProps,\n                children: node,\n                plugins: [\n                  ...(props.plugins ?? ([] as Plugins[])).filter(\n                    (plugin) => plugin.id !== 'intlayer-node-plugin'\n                  ),\n                ],\n              });\n\n              return (values: { [k: string]: string | number }) => {\n                const children = getInsertion(transformedResult, values);\n\n                return deepTransformNode(children, {\n                  ...subProps,\n                  plugins: props.plugins,\n                  children,\n                });\n              };\n            },\n          };\n\n          for (const key in original) {\n            const child = original[key as keyof typeof original];\n            const childProps = {\n              ...props,\n              children: child,\n              keyPath: [\n                ...props.keyPath,\n                { type: NodeTypes.PLURAL, key } as KeyPath,\n              ],\n              plugins: [pluralStringPlugin, ...(props.plugins ?? [])],\n            };\n            result[key] = deepTransformNode(child, childProps);\n          }\n\n          const effectiveLocale = String(locale ?? props.locale ?? 'en');\n\n          return (arg: number | { count: number; [key: string]: unknown }) => {\n            const count = typeof arg === 'number' ? arg : arg.count;\n            const values =\n              typeof arg === 'number'\n                ? { count: arg }\n                : (arg as { count: number; [key: string]: unknown });\n\n            const subResult: string | SubResultFunction = getPlural(\n              result as PluralContent['plural'] as PluralContentState<string>,\n              count,\n              effectiveLocale\n            );\n\n            if (typeof subResult === 'function') {\n              return (subResult as SubResultFunction)(values);\n            }\n\n            return subResult;\n          };\n        },\n      };\n\n/** ---------------------------------------------\n * CONDITION PLUGIN\n * --------------------------------------------- */\n\nexport type ConditionCond<T, S, _L> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.CONDITION]: object;\n}\n  ? (\n      value: boolean | { value: boolean }\n    ) => DeepTransformContent<\n      T[typeof NodeTypes.CONDITION][keyof T[typeof NodeTypes.CONDITION]],\n      S\n    >\n  : never;\n\n/** Condition plugin. Replaces node with a function that takes boolean => string. */\nexport const conditionPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_CONDITION === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'condition-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.CONDITION,\n        transform: (node: ConditionContent, props, deepTransformNode) => {\n          const original = node[NodeTypes.CONDITION];\n          const result: Record<string, any> = {};\n\n          for (const key in original) {\n            const child = original[key as keyof typeof original];\n            const childProps = {\n              ...props,\n              children: child,\n              keyPath: [\n                ...props.keyPath,\n                { type: NodeTypes.CONDITION, key } as KeyPath,\n              ],\n            };\n            result[key] = deepTransformNode(child, childProps);\n          }\n\n          return (arg: boolean | { value: boolean }) => {\n            const value = typeof arg === 'boolean' ? arg : arg.value;\n            const subResult = getCondition(result as any, value);\n\n            if (typeof subResult === 'function' && typeof arg === 'object') {\n              return subResult(arg);\n            }\n\n            return subResult;\n          };\n        },\n      };\n\n/** ---------------------------------------------\n *  INSERTION PLUGIN\n *  --------------------------------------------- */\n\nexport type InsertionCond<T, S, _L> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.INSERTION]: infer I;\n  fields: readonly string[];\n}\n  ? (\n      values: {\n        [K in T['fields'][number]]: string | number;\n      }\n    ) => I extends string\n      ? DeepTransformContent<string, S>\n      : DeepTransformContent<I, S>\n  : never;\n\n/** Insertion plugin. Replaces node with a function that takes quantity => string. */\nexport const insertionPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_INSERTION === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'insertion-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.INSERTION,\n        transform: (node: InsertionContent, props, deepTransformNode) => {\n          const newKeyPath: KeyPath[] = [\n            ...props.keyPath,\n            {\n              type: NodeTypes.INSERTION,\n            },\n          ];\n\n          const children = node[NodeTypes.INSERTION];\n\n          /** Insertion string plugin. Replaces string node with a component that render the insertion. */\n          const insertionStringPlugin: Plugins = {\n            id: 'insertion-string-plugin',\n            canHandle: (node) => typeof node === 'string',\n            transform: (node: string, subProps, deepTransformNode) => {\n              const transformedResult = deepTransformNode(node, {\n                ...subProps,\n                children: node,\n                plugins: [\n                  ...(props.plugins ?? ([] as Plugins[])).filter(\n                    (plugin) => plugin.id !== 'intlayer-node-plugin'\n                  ),\n                ],\n              });\n\n              return (\n                values: {\n                  [K in InsertionContent['fields'][number]]: string | number;\n                }\n              ) => {\n                const children = getInsertion(transformedResult, values);\n\n                return deepTransformNode(children, {\n                  ...subProps,\n                  plugins: props.plugins,\n                  children,\n                });\n              };\n            },\n          };\n\n          return deepTransformNode(children, {\n            ...props,\n            children,\n            keyPath: newKeyPath,\n            plugins: [insertionStringPlugin, ...(props.plugins ?? [])],\n          });\n        },\n      };\n\n/** ---------------------------------------------\n * GENDER PLUGIN\n * --------------------------------------------- */\n\nexport type GenderCond<T, S, _L> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.GENDER]: object;\n}\n  ? (\n      value: Gender\n    ) => DeepTransformContent<\n      T[typeof NodeTypes.GENDER][keyof T[typeof NodeTypes.GENDER]],\n      S\n    >\n  : never;\n\n/** Gender plugin. Replaces node with a function that takes gender => string. */\nexport const genderPlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_GENDER === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'gender-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.GENDER,\n        transform: (node: GenderContent, props, deepTransformNode) => {\n          const original = node[NodeTypes.GENDER];\n          const result: Record<string, any> = {};\n\n          for (const key in original) {\n            const child = original[key as keyof typeof original];\n            const childProps = {\n              ...props,\n              children: child,\n              keyPath: [\n                ...props.keyPath,\n                { type: NodeTypes.GENDER, key } as KeyPath,\n              ],\n            };\n            result[key] = deepTransformNode(child, childProps);\n          }\n\n          return (value: Gender) => getGender(result as any, value);\n        },\n      };\n\n/** ---------------------------------------------\n * NESTED PLUGIN\n * --------------------------------------------- */\n\nexport type NestedCond<T, S, _L> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.NESTED]: infer U;\n}\n  ? U extends {\n      dictionaryKey: infer K extends DictionaryKeys;\n      path?: infer P;\n    }\n    ? GetNestingResult<K, P, S>\n    : never\n  : never;\n\n/** Nested plugin. Replaces node with the result of `getNesting`. */\nexport const nestedPlugin = (locale?: LocalesValues): Plugins =>\n  process.env.INTLAYER_NODE_TYPE_NESTED === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'nested-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' &&\n          (node?.nodeType === NodeTypes.NESTED || node?.nodeType === 'n'),\n        transform: (node: NestedContent, props) =>\n          getNesting(\n            node[NodeTypes.NESTED].dictionaryKey,\n            node[NodeTypes.NESTED].path,\n            {\n              ...props,\n              locale: (locale ?? props.locale) as Locale,\n            }\n          ),\n      };\n\n/** ---------------------------------------------\n * FILE PLUGIN\n * --------------------------------------------- */\n\nexport type FileCond<T, S, _L> = T extends {\n  nodeType: NodeType | string;\n  [NodeTypes.FILE]: string;\n  content?: string;\n}\n  ? DeepTransformContent<string, S>\n  : never;\n\n/** File plugin. Replaces node with the result of `getNesting`. */\nexport const filePlugin: Plugins =\n  process.env.INTLAYER_NODE_TYPE_FILE === 'false'\n    ? fallbackPlugin\n    : {\n        id: 'file-plugin',\n        canHandle: (node) =>\n          typeof node === 'object' && node?.nodeType === NodeTypes.FILE,\n        transform: (node: FileContent, props, deepTransform) =>\n          deepTransform(node.content, {\n            ...props,\n            children: node.content,\n          }),\n      };\n\n/**\n * PLUGIN RESULT\n */\n\n/**\n * Interface that defines the properties of a node.\n * This interface can be augmented in other packages, such as `react-intlayer`.\n */\nexport interface NodeProps {\n  dictionaryKey: string;\n  keyPath: KeyPath[];\n  plugins?: Plugins[];\n  locale?: Locale;\n  dictionaryPath?: string;\n  children?: any;\n  /**\n   * Forces eager traversal of plain objects in `deepTransformNode`. By default\n   * traversal is lazy (property getters), so callers that discard the returned\n   * value never trigger plugins on nested nodes. Set this when running plugins\n   * for their side effects only (e.g. missing-locale detection).\n   */\n  eager?: boolean;\n}\n\n/**\n * Interface that defines the plugins that can be used to transform a node.\n * This interface can be augmented in other packages, such as `react-intlayer`.\n */\nexport interface IInterpreterPlugin<T, S, L extends LocalesValues> {\n  translation: TranslationCond<T, S, L>;\n  enumeration: EnumerationCond<T, S, L>;\n  plural: PluralCond<T, S, L>;\n  condition: ConditionCond<T, S, L>;\n  insertion: InsertionCond<T, S, L>;\n  gender: GenderCond<T, S, L>;\n  nested: NestedCond<T, S, L>;\n  file: FileCond<T, S, L>;\n}\n\n/**\n * Allow to avoid overwriting import from `intlayer` package when `IInterpreterPlugin<T>` interface is augmented in another package, such as `react-intlayer`.\n */\nexport type IInterpreterPluginState = {\n  translation: true;\n  enumeration: true;\n  plural: true;\n  condition: true;\n  insertion: true;\n  gender: true;\n  nested: true;\n  file: true;\n};\n\n/**\n * Utility type to check if a plugin can be applied to a node.\n */\ntype CheckApplyPlugin<\n  T,\n  K extends keyof IInterpreterPlugin<T, S, L>,\n  S,\n  L extends LocalesValues = DeclaredLocales,\n> = K extends keyof S // Test if the key is a key of S.\n  ? // Test if the key of S is true. Then the plugin can be applied.\n    S[K] extends true\n    ? // Test if the key of S exist\n      IInterpreterPlugin<T, S, L>[K] extends never\n      ? never\n      : // Test if the plugin condition is true (if it's not, the plugin is skipped for this node)\n        IInterpreterPlugin<T, S, L>[K]\n    : never\n  : never;\n\n/**\n * Traverse recursively through an object or array, applying each plugin as needed.\n */\ntype Traverse<T, S, L extends LocalesValues = DeclaredLocales> =\n  T extends ReadonlyArray<infer U> // Turn any read-only array into a plain mutable array\n    ? Array<DeepTransformContent<U, S, L>>\n    : T extends object\n      ? { [K in keyof T]: DeepTransformContent<T[K], S, L> }\n      : T;\n\nexport type IsAny<T> = 0 extends 1 & T ? true : false;\n\n/**\n * Traverse recursively through an object or array, applying each plugin as needed.\n */\nexport type DeepTransformContent<\n  T,\n  S = IInterpreterPluginState,\n  L extends LocalesValues = DeclaredLocales,\n> =\n  IsAny<T> extends true\n    ? T\n    : CheckApplyPlugin<T, keyof IInterpreterPlugin<T, S, L>, S, L> extends never // Check if there is a plugin for T:\n      ? // No plugin was found, so try to transform T recursively:\n        Traverse<T, S, L>\n      : // A plugin was found – use the plugin's transformation.\n        CheckApplyPlugin<T, keyof IInterpreterPlugin<T, S, L>, S, L>;\n"],"mappings":";;;;;;;;;;;;;;;AA4DA,MAAa,iBAA0B;CACrC,IAAI;CACJ,iBAAiB;CACjB,YAAY,SAAS;CACtB;;AAmCD,MAAa,qBACX,QACA,aAEA,QAAQ,IAAI,mCAAmC,UAC3C,iBACA;CACE,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAAY,MAAM,aAAa,UAAU;CAC3D,YAAY,MAA0B,OAAO,sBAAsB;EACjE,MAAM,WAAW,KAAK,UAAU,gBAAgB,EAAE;EAClD,MAAM,SAA8B,EAAE;AAEtC,OAAK,MAAM,OAAO,UAAU;GAC1B,MAAM,aAAa;IACjB,GAAG;IACH,UAAU,SAAS;IACnB,SAAS,CACP,GAAG,MAAM,SACT;KAAE,MAAM,UAAU;KAAa;KAAK,CACrC;IACF;AACD,UAAO,OAAO,kBACZ,SAAS,MACT,WACD;;AAGH,SAAO,eAAe,QAAQ,QAAQ,SAAS;;CAElD;;AAmBP,MAAa,oBACX,QAAQ,IAAI,mCAAmC,UAC3C,iBACA;CACE,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAAY,MAAM,aAAa,UAAU;CAC3D,YAAY,MAA0B,OAAO,sBAAsB;EACjE,MAAM,WAAW,KAAK,UAAU;EAChC,MAAM,SAA8B,EAAE;AAEtC,OAAK,MAAM,OAAO,UAAU;GAC1B,MAAM,QAAQ,SAAS;AASvB,UAAO,OAAO,kBAAkB,OAAO;IAPrC,GAAG;IACH,UAAU;IACV,SAAS,CACP,GAAG,MAAM,SACT;KAAE,MAAM,UAAU;KAAa;KAAK,CACrC;IAE8C,CAAC;;AAGpD,UAAQ,QAAoC;GAE1C,MAAM,YAAY,eAAe,QADhB,OAAO,QAAQ,WAAW,MAAM,IAAI,MACH;AAElD,OAAI,OAAO,cAAc,cAAc,OAAO,QAAQ,SACpD,QAAO,UAAU,IAAI;AAGvB,UAAO;;;CAGZ;;;;;;AAyBP,MAAa,gBAAgB,WAC3B,QAAQ,IAAI,8BAA8B,UACtC,iBACA;CACE,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAAY,MAAM,aAAa,UAAU;CAC3D,YAAY,MAAqB,OAAO,sBAAsB;EAC5D,MAAM,WAAW,KAAK,UAAU;EAChC,MAAM,SAA8B,EAAE;;EAGtC,MAAM,qBAA8B;GAClC,IAAI;GACJ,YAAY,SAAS,OAAO,SAAS;GACrC,YAAY,MAAc,UAAU,sBAAsB;IACxD,MAAM,oBAAoB,kBAAkB,MAAM;KAChD,GAAG;KACH,UAAU;KACV,SAAS,CACP,IAAI,MAAM,WAAY,EAAE,EAAgB,QACrC,WAAW,OAAO,OAAO,uBAC3B,CACF;KACF,CAAC;AAEF,YAAQ,WAA6C;KACnD,MAAM,WAAW,aAAa,mBAAmB,OAAO;AAExD,YAAO,kBAAkB,UAAU;MACjC,GAAG;MACH,SAAS,MAAM;MACf;MACD,CAAC;;;GAGP;AAED,OAAK,MAAM,OAAO,UAAU;GAC1B,MAAM,QAAQ,SAAS;AAUvB,UAAO,OAAO,kBAAkB,OAAO;IARrC,GAAG;IACH,UAAU;IACV,SAAS,CACP,GAAG,MAAM,SACT;KAAE,MAAM,UAAU;KAAQ;KAAK,CAChC;IACD,SAAS,CAAC,oBAAoB,GAAI,MAAM,WAAW,EAAE,CAAE;IAER,CAAC;;EAGpD,MAAM,kBAAkB,OAAO,UAAU,MAAM,UAAU,KAAK;AAE9D,UAAQ,QAA4D;GAClE,MAAM,QAAQ,OAAO,QAAQ,WAAW,MAAM,IAAI;GAClD,MAAM,SACJ,OAAO,QAAQ,WACX,EAAE,OAAO,KAAK,GACb;GAEP,MAAM,YAAwC,UAC5C,QACA,OACA,gBACD;AAED,OAAI,OAAO,cAAc,WACvB,QAAQ,UAAgC,OAAO;AAGjD,UAAO;;;CAGZ;;AAmBP,MAAa,kBACX,QAAQ,IAAI,iCAAiC,UACzC,iBACA;CACE,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAAY,MAAM,aAAa,UAAU;CAC3D,YAAY,MAAwB,OAAO,sBAAsB;EAC/D,MAAM,WAAW,KAAK,UAAU;EAChC,MAAM,SAA8B,EAAE;AAEtC,OAAK,MAAM,OAAO,UAAU;GAC1B,MAAM,QAAQ,SAAS;AASvB,UAAO,OAAO,kBAAkB,OAAO;IAPrC,GAAG;IACH,UAAU;IACV,SAAS,CACP,GAAG,MAAM,SACT;KAAE,MAAM,UAAU;KAAW;KAAK,CACnC;IAE8C,CAAC;;AAGpD,UAAQ,QAAsC;GAE5C,MAAM,YAAY,aAAa,QADjB,OAAO,QAAQ,YAAY,MAAM,IAAI,MACC;AAEpD,OAAI,OAAO,cAAc,cAAc,OAAO,QAAQ,SACpD,QAAO,UAAU,IAAI;AAGvB,UAAO;;;CAGZ;;AAqBP,MAAa,kBACX,QAAQ,IAAI,iCAAiC,UACzC,iBACA;CACE,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAAY,MAAM,aAAa,UAAU;CAC3D,YAAY,MAAwB,OAAO,sBAAsB;EAC/D,MAAM,aAAwB,CAC5B,GAAG,MAAM,SACT,EACE,MAAM,UAAU,WACjB,CACF;EAED,MAAM,WAAW,KAAK,UAAU;;EAGhC,MAAM,wBAAiC;GACrC,IAAI;GACJ,YAAY,SAAS,OAAO,SAAS;GACrC,YAAY,MAAc,UAAU,sBAAsB;IACxD,MAAM,oBAAoB,kBAAkB,MAAM;KAChD,GAAG;KACH,UAAU;KACV,SAAS,CACP,IAAI,MAAM,WAAY,EAAE,EAAgB,QACrC,WAAW,OAAO,OAAO,uBAC3B,CACF;KACF,CAAC;AAEF,YACE,WAGG;KACH,MAAM,WAAW,aAAa,mBAAmB,OAAO;AAExD,YAAO,kBAAkB,UAAU;MACjC,GAAG;MACH,SAAS,MAAM;MACf;MACD,CAAC;;;GAGP;AAED,SAAO,kBAAkB,UAAU;GACjC,GAAG;GACH;GACA,SAAS;GACT,SAAS,CAAC,uBAAuB,GAAI,MAAM,WAAW,EAAE,CAAE;GAC3D,CAAC;;CAEL;;AAmBP,MAAa,eACX,QAAQ,IAAI,8BAA8B,UACtC,iBACA;CACE,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAAY,MAAM,aAAa,UAAU;CAC3D,YAAY,MAAqB,OAAO,sBAAsB;EAC5D,MAAM,WAAW,KAAK,UAAU;EAChC,MAAM,SAA8B,EAAE;AAEtC,OAAK,MAAM,OAAO,UAAU;GAC1B,MAAM,QAAQ,SAAS;AASvB,UAAO,OAAO,kBAAkB,OAAO;IAPrC,GAAG;IACH,UAAU;IACV,SAAS,CACP,GAAG,MAAM,SACT;KAAE,MAAM,UAAU;KAAQ;KAAK,CAChC;IAE8C,CAAC;;AAGpD,UAAQ,UAAkB,UAAU,QAAe,MAAM;;CAE5D;;AAmBP,MAAa,gBAAgB,WAC3B,QAAQ,IAAI,8BAA8B,UACtC,iBACA;CACE,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,aACf,MAAM,aAAa,UAAU,UAAU,MAAM,aAAa;CAC7D,YAAY,MAAqB,UAC/B,WACE,KAAK,UAAU,QAAQ,eACvB,KAAK,UAAU,QAAQ,MACvB;EACE,GAAG;EACH,QAAS,UAAU,MAAM;EAC1B,CACF;CACJ;;AAeP,MAAa,aACX,QAAQ,IAAI,4BAA4B,UACpC,iBACA;CACE,IAAI;CACJ,YAAY,SACV,OAAO,SAAS,YAAY,MAAM,aAAa,UAAU;CAC3D,YAAY,MAAmB,OAAO,kBACpC,cAAc,KAAK,SAAS;EAC1B,GAAG;EACH,UAAU,KAAK;EAChB,CAAC;CACL"}

package/dist/esm/interpreter/getIntlayer.mjs

@@ -42,7 +42,7 @@ const getIntlayer = (key, localeOrSelector, plugins) => {
 	}
 	let locale;
 	let selectorCacheKey = "";
-	if (process.env["INTLAYER_DICTIONARY_SELECTOR"] !== "false") {
+	if (process.env.INTLAYER_DICTIONARY_SELECTOR !== "false") {
 		const parsed = parseDictionarySelector(localeOrSelector);
 		locale = parsed.locale;
 		selectorCacheKey = getDictionarySelectorCacheKey(parsed.selector);

package/dist/esm/interpreter/getIntlayer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"getIntlayer.mjs","names":[],"sources":["../../../src/interpreter/getIntlayer.ts"],"sourcesContent":["import { log } from '@intlayer/config/built';\nimport { colorizeKey, getAppLogger } from '@intlayer/config/logger';\nimport { getDictionaries } from '@intlayer/dictionaries-entry';\nimport type { DictionarySelector } from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  DictionaryRegistryResult,\n  ExtractSelectorLocale,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport {\n  getDictionarySelectorCacheKey,\n  parseDictionarySelector,\n} from '../dictionaryManipulator/qualifiedDictionary';\nimport type {\n  DeepTransformContent,\n  IInterpreterPluginState,\n  Plugins,\n} from './getContent';\nimport { getDictionary } from './getDictionary';\n\n/**\n * Creates a Recursive Proxy that returns the path of the accessed key\n * stringified. This prevents the app from crashing on undefined access.\n */\nconst createSafeFallback = (path = ''): any => {\n  return new Proxy({} as Record<string | symbol, unknown>, {\n    get: (_target, prop) => {\n      if (\n        prop === 'toJSON' ||\n        prop === Symbol.toPrimitive ||\n        prop === 'toString' ||\n        prop === 'valueOf'\n      ) {\n        return () => path;\n      }\n      if (prop === 'then') {\n        return undefined; // Prevent it from being treated as a Promise\n      }\n      if (prop === Symbol.iterator) {\n        return function* () {\n          yield path;\n        };\n      }\n\n      // Recursively build the path (e.g., \"myDictionary.home.title\")\n      const nextPath = path ? `${path}.${String(prop)}` : String(prop);\n      return createSafeFallback(nextPath);\n    },\n  });\n};\n\nconst dictionaryCache = new Map<string, any>();\nconst warnedMissingDictionaries = new Set<string>();\n\n/**\n * Picks one dictionary by its key and returns its content for the given\n * locale or selector.\n *\n * The second argument is either a locale (`'fr'`) or a selector object:\n * - `{ item: 2 }` — collection item (omit `item` to get every item as array)\n * - `{ variant: 'black-friday' }` — named variant (omit for the `default` one)\n * - `{ id: 'prod_abc', ...metaFields }` — meta record\n * - `locale` can be combined with any selector: `{ item: 2, locale: 'fr' }`\n */\nexport const getIntlayer = <\n  const T extends DictionaryKeys,\n  const A extends LocalesValues | DictionarySelector = DeclaredLocales,\n>(\n  key: T,\n  localeOrSelector?: A,\n  plugins?: Plugins[]\n): DeepTransformContent<\n  DictionaryRegistryResult<T, A>,\n  IInterpreterPluginState,\n  ExtractSelectorLocale<A>\n> => {\n  const dictionaries = getDictionaries();\n  const dictionary = dictionaries[key as T];\n\n  if (!dictionary && process.env.NODE_ENV === 'development') {\n    if (!warnedMissingDictionaries.has(key as string)) {\n      // Log a warning instead of throwing (so developers know it's missing)\n      const logger = getAppLogger({ log });\n      logger(\n        typeof window === 'undefined'\n          ? `Dictionary ${colorizeKey(key)} was not found. Using fallback proxy.`\n          : `Dictionary ${key} was not found. Using fallback proxy.`,\n        {\n          level: 'warn',\n        }\n      );\n      warnedMissingDictionaries.add(key as string);\n    }\n\n    return createSafeFallback(key as string);\n  }\n\n  let locale: LocalesValues | undefined;\n  let selectorCacheKey = '';\n\n  if (process.env['INTLAYER_DICTIONARY_SELECTOR'] !== 'false') {\n    const parsed = parseDictionarySelector(localeOrSelector);\n    locale = parsed.locale;\n    selectorCacheKey = getDictionarySelectorCacheKey(parsed.selector);\n  } else {\n    // Selectors are unused in this project (build-time flag): the second\n    // argument can only be a locale, so the selector parsing is dead code.\n    locale = localeOrSelector as LocalesValues | undefined;\n  }\n\n  const cacheKey = `${key}_${locale ?? 'default'}_${selectorCacheKey}_${plugins ? 'custom_plugins' : 'default_plugins'}`;\n\n  if (dictionaryCache.has(cacheKey)) {\n    return dictionaryCache.get(cacheKey);\n  }\n\n  const result = getDictionary(dictionary, localeOrSelector, plugins);\n\n  dictionaryCache.set(cacheKey, result);\n\n  return result as any;\n};\n"],"mappings":";;;;;;;;;;;AA0BA,MAAM,sBAAsB,OAAO,OAAY;AAC7C,QAAO,IAAI,MAAM,EAAE,EAAsC,EACvD,MAAM,SAAS,SAAS;AACtB,MACE,SAAS,YACT,SAAS,OAAO,eAChB,SAAS,cACT,SAAS,UAET,cAAa;AAEf,MAAI,SAAS,OACX;AAEF,MAAI,SAAS,OAAO,SAClB,QAAO,aAAa;AAClB,SAAM;;AAMV,SAAO,mBADU,OAAO,GAAG,KAAK,GAAG,OAAO,KAAK,KAAK,OAAO,KAAK,CAC7B;IAEtC,CAAC;;AAGJ,MAAM,kCAAkB,IAAI,KAAkB;AAC9C,MAAM,4CAA4B,IAAI,KAAa;;;;;;;;;;;AAYnD,MAAa,eAIX,KACA,kBACA,YAKG;CAEH,MAAM,aADe,iBACU,CAAC;AAEhC,KAAI,CAAC,cAAc,MAAwC;AACzD,MAAI,CAAC,0BAA0B,IAAI,IAAc,EAAE;AAGjD,GADe,aAAa,EAAE,KAAK,CAC7B,CACJ,OAAO,WAAW,cACd,cAAc,YAAY,IAAI,CAAC,yCAC/B,cAAc,IAAI,wCACtB,EACE,OAAO,QACR,CACF;AACD,6BAA0B,IAAI,IAAc;;AAG9C,SAAO,mBAAmB,IAAc;;CAG1C,IAAI;CACJ,IAAI,mBAAmB;AAEvB,KAAI,QAAQ,IAAI,oCAAoC,SAAS;EAC3D,MAAM,SAAS,wBAAwB,iBAAiB;AACxD,WAAS,OAAO;AAChB,qBAAmB,8BAA8B,OAAO,SAAS;OAIjE,UAAS;CAGX,MAAM,WAAW,GAAG,IAAI,GAAG,UAAU,UAAU,GAAG,iBAAiB,GAAG,UAAU,mBAAmB;AAEnG,KAAI,gBAAgB,IAAI,SAAS,CAC/B,QAAO,gBAAgB,IAAI,SAAS;CAGtC,MAAM,SAAS,cAAc,YAAY,kBAAkB,QAAQ;AAEnE,iBAAgB,IAAI,UAAU,OAAO;AAErC,QAAO"}
+{"version":3,"file":"getIntlayer.mjs","names":[],"sources":["../../../src/interpreter/getIntlayer.ts"],"sourcesContent":["import { log } from '@intlayer/config/built';\nimport { colorizeKey, getAppLogger } from '@intlayer/config/logger';\nimport { getDictionaries } from '@intlayer/dictionaries-entry';\nimport type { DictionarySelector } from '@intlayer/types/dictionary';\nimport type {\n  DeclaredLocales,\n  DictionaryKeys,\n  DictionaryRegistryResult,\n  ExtractSelectorLocale,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport {\n  getDictionarySelectorCacheKey,\n  parseDictionarySelector,\n} from '../dictionaryManipulator/qualifiedDictionary';\nimport type {\n  DeepTransformContent,\n  IInterpreterPluginState,\n  Plugins,\n} from './getContent';\nimport { getDictionary } from './getDictionary';\n\n/**\n * Creates a Recursive Proxy that returns the path of the accessed key\n * stringified. This prevents the app from crashing on undefined access.\n */\nconst createSafeFallback = (path = ''): any => {\n  return new Proxy({} as Record<string | symbol, unknown>, {\n    get: (_target, prop) => {\n      if (\n        prop === 'toJSON' ||\n        prop === Symbol.toPrimitive ||\n        prop === 'toString' ||\n        prop === 'valueOf'\n      ) {\n        return () => path;\n      }\n      if (prop === 'then') {\n        return undefined; // Prevent it from being treated as a Promise\n      }\n      if (prop === Symbol.iterator) {\n        return function* () {\n          yield path;\n        };\n      }\n\n      // Recursively build the path (e.g., \"myDictionary.home.title\")\n      const nextPath = path ? `${path}.${String(prop)}` : String(prop);\n      return createSafeFallback(nextPath);\n    },\n  });\n};\n\nconst dictionaryCache = new Map<string, any>();\nconst warnedMissingDictionaries = new Set<string>();\n\n/**\n * Picks one dictionary by its key and returns its content for the given\n * locale or selector.\n *\n * The second argument is either a locale (`'fr'`) or a selector object:\n * - `{ item: 2 }` — collection item (omit `item` to get every item as array)\n * - `{ variant: 'black-friday' }` — named variant (omit for the `default` one)\n * - `{ id: 'prod_abc', ...metaFields }` — meta record\n * - `locale` can be combined with any selector: `{ item: 2, locale: 'fr' }`\n */\nexport const getIntlayer = <\n  const T extends DictionaryKeys,\n  const A extends LocalesValues | DictionarySelector = DeclaredLocales,\n>(\n  key: T,\n  localeOrSelector?: A,\n  plugins?: Plugins[]\n): DeepTransformContent<\n  DictionaryRegistryResult<T, A>,\n  IInterpreterPluginState,\n  ExtractSelectorLocale<A>\n> => {\n  const dictionaries = getDictionaries();\n  const dictionary = dictionaries[key as T];\n\n  if (!dictionary && process.env.NODE_ENV === 'development') {\n    if (!warnedMissingDictionaries.has(key as string)) {\n      // Log a warning instead of throwing (so developers know it's missing)\n      const logger = getAppLogger({ log });\n      logger(\n        typeof window === 'undefined'\n          ? `Dictionary ${colorizeKey(key)} was not found. Using fallback proxy.`\n          : `Dictionary ${key} was not found. Using fallback proxy.`,\n        {\n          level: 'warn',\n        }\n      );\n      warnedMissingDictionaries.add(key as string);\n    }\n\n    return createSafeFallback(key as string);\n  }\n\n  let locale: LocalesValues | undefined;\n  let selectorCacheKey = '';\n\n  if (process.env.INTLAYER_DICTIONARY_SELECTOR !== 'false') {\n    const parsed = parseDictionarySelector(localeOrSelector);\n    locale = parsed.locale;\n    selectorCacheKey = getDictionarySelectorCacheKey(parsed.selector);\n  } else {\n    // Selectors are unused in this project (build-time flag): the second\n    // argument can only be a locale, so the selector parsing is dead code.\n    locale = localeOrSelector as LocalesValues | undefined;\n  }\n\n  const cacheKey = `${key}_${locale ?? 'default'}_${selectorCacheKey}_${plugins ? 'custom_plugins' : 'default_plugins'}`;\n\n  if (dictionaryCache.has(cacheKey)) {\n    return dictionaryCache.get(cacheKey);\n  }\n\n  const result = getDictionary(dictionary, localeOrSelector, plugins);\n\n  dictionaryCache.set(cacheKey, result);\n\n  return result as any;\n};\n"],"mappings":";;;;;;;;;;;AA0BA,MAAM,sBAAsB,OAAO,OAAY;AAC7C,QAAO,IAAI,MAAM,EAAE,EAAsC,EACvD,MAAM,SAAS,SAAS;AACtB,MACE,SAAS,YACT,SAAS,OAAO,eAChB,SAAS,cACT,SAAS,UAET,cAAa;AAEf,MAAI,SAAS,OACX;AAEF,MAAI,SAAS,OAAO,SAClB,QAAO,aAAa;AAClB,SAAM;;AAMV,SAAO,mBADU,OAAO,GAAG,KAAK,GAAG,OAAO,KAAK,KAAK,OAAO,KAAK,CAC7B;IAEtC,CAAC;;AAGJ,MAAM,kCAAkB,IAAI,KAAkB;AAC9C,MAAM,4CAA4B,IAAI,KAAa;;;;;;;;;;;AAYnD,MAAa,eAIX,KACA,kBACA,YAKG;CAEH,MAAM,aADe,iBACU,CAAC;AAEhC,KAAI,CAAC,cAAc,MAAwC;AACzD,MAAI,CAAC,0BAA0B,IAAI,IAAc,EAAE;AAGjD,GADe,aAAa,EAAE,KAAK,CAC7B,CACJ,OAAO,WAAW,cACd,cAAc,YAAY,IAAI,CAAC,yCAC/B,cAAc,IAAI,wCACtB,EACE,OAAO,QACR,CACF;AACD,6BAA0B,IAAI,IAAc;;AAG9C,SAAO,mBAAmB,IAAc;;CAG1C,IAAI;CACJ,IAAI,mBAAmB;AAEvB,KAAI,QAAQ,IAAI,iCAAiC,SAAS;EACxD,MAAM,SAAS,wBAAwB,iBAAiB;AACxD,WAAS,OAAO;AAChB,qBAAmB,8BAA8B,OAAO,SAAS;OAIjE,UAAS;CAGX,MAAM,WAAW,GAAG,IAAI,GAAG,UAAU,UAAU,GAAG,iBAAiB,GAAG,UAAU,mBAAmB;AAEnG,KAAI,gBAAgB,IAAI,SAAS,CAC/B,QAAO,gBAAgB,IAAI,SAAS;CAGtC,MAAM,SAAS,cAAc,YAAY,kBAAkB,QAAQ;AAEnE,iBAAgB,IAAI,UAAU,OAAO;AAErC,QAAO"}

package/dist/esm/localization/comparePaths.mjs

@@ -0,0 +1,73 @@
+import { checkIsURLAbsolute } from "../utils/checkIsURLAbsolute.mjs";
+import { getPathWithoutLocale } from "./getPathWithoutLocale.mjs";
+
+//#region src/localization/comparePaths.ts
+/**
+* Normalizes a URL or pathname into a canonical, locale-agnostic pathname so
+* that two paths pointing to the same page compare equal — useful for
+* highlighting the active navigation link.
+*
+* The normalization:
+* - strips the locale segment (reusing {@link getPathWithoutLocale})
+* - strips the protocol/host so absolute and relative inputs compare equally
+* - drops the query string and hash
+* - ensures a single leading slash
+* - removes any trailing slash (except for the root path)
+* - falls back to `'/'` for empty values
+*
+* Example:
+*
+* ```ts
+* normalizePath('/ru/path')                    // '/path'
+* normalizePath('/ru/path/')                   // '/path'
+* normalizePath('ru/path')                     // '/path'
+* normalizePath('/ru/')                        // '/'
+* normalizePath('/ru')                         // '/'
+* normalizePath('')                            // '/'
+* normalizePath('https://example.com/ru/path') // '/path'
+* ```
+*
+* @param inputUrl - The URL string or pathname to normalize.
+* @param locales - Optional array of supported locales. Defaults to the
+*   configured locales.
+* @returns The normalized, locale-agnostic pathname.
+*/
+const normalizePath = (inputUrl, locales) => {
+	const withoutLocale = getPathWithoutLocale(inputUrl || "/", locales);
+	const { pathname } = checkIsURLAbsolute(withoutLocale) ? new URL(withoutLocale) : new URL(withoutLocale, "http://example.com");
+	if (pathname.length > 1 && pathname.endsWith("/")) return pathname.slice(0, -1);
+	return pathname || "/";
+};
+/**
+* Compares two URLs or pathnames for equality, ignoring locale segment,
+* protocol/host, query string, hash and trailing slashes.
+*
+* Both inputs are normalized through {@link normalizePath} before comparison,
+* making this ideal for matching the current pathname against a navigation
+* link's `href`.
+*
+* Example:
+*
+* ```ts
+* comparePaths('/ru/path', '/path')   // true
+* comparePaths('/ru/path/', '/path')  // true
+* comparePaths('/ru/path', '/path/')  // true
+* comparePaths('/ru/', '/')           // true
+* comparePaths('/ru', '/')            // true
+* comparePaths('ru/path', '/path')    // true
+* comparePaths('', '/')               // true
+* comparePaths('/ru', '')             // true
+* comparePaths('/ru/path', '/other')  // false
+* ```
+*
+* @param pathname - The first URL string or pathname to compare.
+* @param href - The second URL string or pathname to compare.
+* @param locales - Optional array of supported locales. Defaults to the
+*   configured locales.
+* @returns `true` when both inputs resolve to the same locale-agnostic path.
+*/
+const comparePaths = (pathname, href, locales) => normalizePath(pathname, locales) === normalizePath(href, locales);
+
+//#endregion
+export { comparePaths, normalizePath };
+//# sourceMappingURL=comparePaths.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"comparePaths.mjs","names":[],"sources":["../../../src/localization/comparePaths.ts"],"sourcesContent":["import type {\n  DeclaredLocales,\n  LocalesValues,\n} from '@intlayer/types/module_augmentation';\nimport { checkIsURLAbsolute } from '../utils/checkIsURLAbsolute';\nimport { getPathWithoutLocale } from './getPathWithoutLocale';\n\n/**\n * Normalizes a URL or pathname into a canonical, locale-agnostic pathname so\n * that two paths pointing to the same page compare equal — useful for\n * highlighting the active navigation link.\n *\n * The normalization:\n * - strips the locale segment (reusing {@link getPathWithoutLocale})\n * - strips the protocol/host so absolute and relative inputs compare equally\n * - drops the query string and hash\n * - ensures a single leading slash\n * - removes any trailing slash (except for the root path)\n * - falls back to `'/'` for empty values\n *\n * Example:\n *\n * ```ts\n * normalizePath('/ru/path')                    // '/path'\n * normalizePath('/ru/path/')                   // '/path'\n * normalizePath('ru/path')                     // '/path'\n * normalizePath('/ru/')                        // '/'\n * normalizePath('/ru')                         // '/'\n * normalizePath('')                            // '/'\n * normalizePath('https://example.com/ru/path') // '/path'\n * ```\n *\n * @param inputUrl - The URL string or pathname to normalize.\n * @param locales - Optional array of supported locales. Defaults to the\n *   configured locales.\n * @returns The normalized, locale-agnostic pathname.\n */\nexport const normalizePath = <const L extends LocalesValues = DeclaredLocales>(\n  inputUrl: string,\n  locales?: L[]\n): string => {\n  const withoutLocale = getPathWithoutLocale(inputUrl || '/', locales);\n\n  // Reuse the URL API to isolate the pathname from any host/query/hash.\n  const url = checkIsURLAbsolute(withoutLocale)\n    ? new URL(withoutLocale)\n    : new URL(withoutLocale, 'http://example.com');\n\n  const { pathname } = url;\n\n  // Remove a trailing slash, keeping the root path intact.\n  if (pathname.length > 1 && pathname.endsWith('/')) {\n    return pathname.slice(0, -1);\n  }\n\n  return pathname || '/';\n};\n\n/**\n * Compares two URLs or pathnames for equality, ignoring locale segment,\n * protocol/host, query string, hash and trailing slashes.\n *\n * Both inputs are normalized through {@link normalizePath} before comparison,\n * making this ideal for matching the current pathname against a navigation\n * link's `href`.\n *\n * Example:\n *\n * ```ts\n * comparePaths('/ru/path', '/path')   // true\n * comparePaths('/ru/path/', '/path')  // true\n * comparePaths('/ru/path', '/path/')  // true\n * comparePaths('/ru/', '/')           // true\n * comparePaths('/ru', '/')            // true\n * comparePaths('ru/path', '/path')    // true\n * comparePaths('', '/')               // true\n * comparePaths('/ru', '')             // true\n * comparePaths('/ru/path', '/other')  // false\n * ```\n *\n * @param pathname - The first URL string or pathname to compare.\n * @param href - The second URL string or pathname to compare.\n * @param locales - Optional array of supported locales. Defaults to the\n *   configured locales.\n * @returns `true` when both inputs resolve to the same locale-agnostic path.\n */\nexport const comparePaths = <const L extends LocalesValues = DeclaredLocales>(\n  pathname: string,\n  href: string,\n  locales?: L[]\n): boolean => normalizePath(pathname, locales) === normalizePath(href, locales);\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,MAAa,iBACX,UACA,YACW;CACX,MAAM,gBAAgB,qBAAqB,YAAY,KAAK,QAAQ;CAOpE,MAAM,EAAE,aAJI,mBAAmB,cAAc,GACzC,IAAI,IAAI,cAAc,GACtB,IAAI,IAAI,eAAe,qBAAqB;AAKhD,KAAI,SAAS,SAAS,KAAK,SAAS,SAAS,IAAI,CAC/C,QAAO,SAAS,MAAM,GAAG,GAAG;AAG9B,QAAO,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+BrB,MAAa,gBACX,UACA,MACA,YACY,cAAc,UAAU,QAAQ,KAAK,cAAc,MAAM,QAAQ"}