@intlayer/config 9.3.2 → 9.3.3

package/dist/cjs/bundle/index.cjs

@@ -2,8 +2,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_utils_alias = require('../utils/alias.cjs');
 const require_configFile_getConfiguration = require('../configFile/getConfiguration.cjs');
-const require_bundle_logBundle = require('./logBundle.cjs');
 const require_envVars_envVars = require('../envVars/envVars.cjs');
+const require_bundle_logBundle = require('./logBundle.cjs');
 let node_path = require("node:path");
 let node_fs_promises = require("node:fs/promises");
 let _intlayer_types_package_json = require("@intlayer/types/package.json");

package/dist/cjs/configFile/buildConfigurationFields.cjs

@@ -256,6 +256,30 @@ const buildBuildFields = (customConfiguration) => ({
 	*/
 	purge: customConfiguration?.purge ?? false,
 	/**
+	* Group the per-locale dictionary chunks by the code-split boundary that uses
+	* them, so a lazily loaded page fetches its content in one request.
+	*
+	* Default: true
+	*
+	* Note:
+	* - Only applies to dictionaries using `importMode: 'dynamic'`.
+	* - Only applies to the client build, and only when bundling (not in dev).
+	*/
+	chunkGrouping: customConfiguration?.chunkGrouping ?? true,
+	/**
+	* Load a dictionary together with the chunk that uses it, instead of fetching
+	* it once that chunk renders — so a reader renders synchronously rather than
+	* suspending, and navigating no longer flashes a loading state.
+	*
+	* Default: true
+	*
+	* Note:
+	* - Only applies to dictionaries using `importMode: 'dynamic'`.
+	* - Only applies to the client build; the server keeps loading on demand.
+	* - Requires a bundler supporting top-level await (Vite, esbuild).
+	*/
+	dictionariesPreload: customConfiguration?.dictionariesPreload ?? true,
+	/**
 	* Pattern to traverse the code to optimize.
 	*
 	* Allows to avoid to traverse the code that is not relevant to the optimization.

package/dist/cjs/configFile/buildConfigurationFields.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"buildConfigurationFields.cjs","names":["getProjectRequire","isAbsolute","join","statSync","dirname","FILE_EXTENSIONS","CONTENT_DIR","CODE_DIR","EXCLUDED_PATHS","TRAVERSE_PATTERN","OUTPUT_FORMAT","intlayerConfigSchema","buildBrowserConfiguration","buildInternationalizationFields","buildEditorFields","buildLogFields","buildAnalyticsFields"],"sources":["../../../src/configFile/buildConfigurationFields.ts"],"sourcesContent":["import { statSync } from 'node:fs';\nimport { dirname, isAbsolute, join } from 'node:path';\nimport type {\n  AiConfig,\n  BuildConfig,\n  CompilerConfig,\n  ContentConfig,\n  CustomIntlayerConfig,\n  DictionaryConfig,\n  IntlayerConfig,\n  LogFunctions,\n  SystemConfig,\n} from '@intlayer/types/config';\nimport {\n  BUILD_MODE,\n  CACHE,\n  MINIFY,\n  OUTPUT_FORMAT,\n  PURGE,\n  TRAVERSE_PATTERN,\n  TYPE_CHECKING,\n} from '../defaultValues/build';\nimport {\n  COMPILER_DICTIONARY_KEY_PREFIX,\n  COMPILER_ENABLED,\n  COMPILER_NO_METADATA,\n  COMPILER_SAVE_COMPONENTS,\n} from '../defaultValues/compiler';\nimport {\n  CODE_DIR,\n  CONTENT_DIR,\n  EXCLUDED_PATHS,\n  FILE_EXTENSIONS,\n  WATCH,\n} from '../defaultValues/content';\nimport {\n  CONTENT_AUTO_TRANSFORMATION,\n  FILL,\n  IMPORT_MODE,\n  LOCATION,\n} from '../defaultValues/dictionary';\nimport {\n  CACHE_DIR,\n  CONFIG_DIR,\n  DICTIONARIES_DIR,\n  DYNAMIC_DICTIONARIES_DIR,\n  FETCH_DICTIONARIES_DIR,\n  MAIN_DIR,\n  MODULE_AUGMENTATION_DIR,\n  REMOTE_DICTIONARIES_DIR,\n  TEMP_DIR,\n  TYPES_DIR,\n  UNMERGED_DICTIONARIES_DIR,\n} from '../defaultValues/system';\nimport { getProjectRequire } from '../utils';\nimport {\n  buildAnalyticsFields,\n  buildBrowserConfiguration,\n  buildEditorFields,\n  buildInternationalizationFields,\n  buildLogFields,\n} from './buildBrowserConfiguration';\nimport { intlayerConfigSchema } from './configurationSchema';\n\nexport {\n  type BrowserIntlayerConfig,\n  buildAnalyticsFields,\n  buildBrowserConfiguration,\n  buildEditorFields,\n  buildInternationalizationFields,\n  buildLogFields,\n  buildRoutingFields,\n  extractBrowserConfiguration,\n} from './buildBrowserConfiguration';\n\nlet storedConfiguration: IntlayerConfig;\n\n// ---------------------------------------------------------------------------\n// Server-only field builders (Node.js — not browser-safe)\n// ---------------------------------------------------------------------------\n\n/**\n * Build the `system` section of the Intlayer configuration.\n *\n * Resolves all directory paths (dictionaries, types, cache, …) relative to\n * the project base directory, using Node.js `require.resolve` where available\n * and falling back to `path.join` otherwise.\n *\n * @param baseDir - Project root directory. Defaults to `process.cwd()`.\n * @param customConfiguration - Partial user-supplied system config.\n * @returns A fully-resolved {@link SystemConfig}.\n */\nconst buildSystemFields = (\n  baseDir?: string,\n  customConfiguration?: Partial<SystemConfig>\n): SystemConfig => {\n  const projectBaseDir = baseDir ?? process.cwd();\n\n  const optionalJoinBaseDir = (pathInput: string) => {\n    let absolutePath: string;\n\n    try {\n      const requireFunction = getProjectRequire(projectBaseDir);\n      try {\n        absolutePath = requireFunction.resolve(pathInput, {\n          paths: [projectBaseDir],\n        });\n      } catch (err) {\n        if (!pathInput.startsWith('.') && !isAbsolute(pathInput)) {\n          absolutePath = requireFunction.resolve(`${pathInput}/package.json`, {\n            paths: [projectBaseDir],\n          });\n        } else {\n          throw err;\n        }\n      }\n    } catch {\n      absolutePath = isAbsolute(pathInput)\n        ? pathInput\n        : join(projectBaseDir, pathInput);\n    }\n\n    try {\n      const stats = statSync(absolutePath);\n      if (stats.isFile()) {\n        return dirname(absolutePath);\n      }\n    } catch {\n      if (/\\.[a-z0-9]+$/i.test(absolutePath)) {\n        return dirname(absolutePath);\n      }\n    }\n\n    return absolutePath;\n  };\n\n  const dictionariesDir = optionalJoinBaseDir(\n    customConfiguration?.dictionariesDir ?? DICTIONARIES_DIR\n  );\n\n  return {\n    baseDir: projectBaseDir,\n    moduleAugmentationDir: optionalJoinBaseDir(\n      customConfiguration?.moduleAugmentationDir ?? MODULE_AUGMENTATION_DIR\n    ),\n    unmergedDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.unmergedDictionariesDir ?? UNMERGED_DICTIONARIES_DIR\n    ),\n    remoteDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.remoteDictionariesDir ?? REMOTE_DICTIONARIES_DIR\n    ),\n    dictionariesDir,\n    dynamicDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.dynamicDictionariesDir ?? DYNAMIC_DICTIONARIES_DIR\n    ),\n    fetchDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.fetchDictionariesDir ?? FETCH_DICTIONARIES_DIR\n    ),\n    typesDir: optionalJoinBaseDir(customConfiguration?.typesDir ?? TYPES_DIR),\n    mainDir: optionalJoinBaseDir(customConfiguration?.mainDir ?? MAIN_DIR),\n    configDir: optionalJoinBaseDir(\n      customConfiguration?.configDir ?? CONFIG_DIR\n    ),\n    cacheDir: optionalJoinBaseDir(customConfiguration?.cacheDir ?? CACHE_DIR),\n    tempDir: optionalJoinBaseDir(customConfiguration?.tempDir ?? TEMP_DIR),\n  };\n};\n\n/**\n * Build the `content` section of the Intlayer configuration.\n *\n * Resolves content and code directories relative to the project base using\n * `require.resolve`, falling back to `path.join`.\n *\n * @param systemConfig - Already-built system configuration (provides `baseDir`).\n * @param customConfiguration - Partial user-supplied content config.\n * @returns A fully-resolved {@link ContentConfig}.\n */\nconst buildContentFields = (\n  systemConfig: SystemConfig,\n  customConfiguration?: Partial<ContentConfig>\n): ContentConfig => {\n  const fileExtensions = customConfiguration?.fileExtensions ?? FILE_EXTENSIONS;\n\n  const optionalJoinBaseDir = (pathInput: string) => {\n    let absolutePath: string;\n\n    try {\n      const requireFunction = getProjectRequire(systemConfig.baseDir);\n      try {\n        absolutePath = requireFunction.resolve(pathInput, {\n          paths: [systemConfig.baseDir],\n        });\n      } catch (err) {\n        if (!pathInput.startsWith('.') && !isAbsolute(pathInput)) {\n          absolutePath = requireFunction.resolve(`${pathInput}/package.json`, {\n            paths: [systemConfig.baseDir],\n          });\n        } else {\n          throw err;\n        }\n      }\n    } catch {\n      try {\n        try {\n          absolutePath = require.resolve(pathInput, {\n            paths: [systemConfig.baseDir],\n          });\n        } catch (err) {\n          if (!pathInput.startsWith('.') && !isAbsolute(pathInput)) {\n            absolutePath = require.resolve(`${pathInput}/package.json`, {\n              paths: [systemConfig.baseDir],\n            });\n          } else {\n            throw err;\n          }\n        }\n      } catch {\n        absolutePath = isAbsolute(pathInput)\n          ? pathInput\n          : join(systemConfig.baseDir, pathInput);\n      }\n    }\n\n    try {\n      const stats = statSync(absolutePath);\n      if (stats.isFile()) {\n        return dirname(absolutePath);\n      }\n    } catch {\n      if (/\\.[a-z0-9]+$/i.test(absolutePath)) {\n        return dirname(absolutePath);\n      }\n    }\n\n    return absolutePath;\n  };\n\n  const contentDir = (customConfiguration?.contentDir ?? CONTENT_DIR).map(\n    optionalJoinBaseDir\n  );\n  const codeDir = (customConfiguration?.codeDir ?? CODE_DIR).map(\n    optionalJoinBaseDir\n  );\n\n  return {\n    fileExtensions,\n    contentDir,\n    codeDir,\n    excludedPath: customConfiguration?.excludedPath ?? EXCLUDED_PATHS,\n    watch: customConfiguration?.watch ?? WATCH,\n    formatCommand: customConfiguration?.formatCommand,\n  };\n};\n\n/**\n * Build the `ai` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied AI config.\n * @returns A fully-defaulted {@link AiConfig}.\n */\nconst buildAiFields = (customConfiguration?: Partial<AiConfig>): AiConfig => ({\n  /**\n   * AI configuration\n   */\n  provider: customConfiguration?.provider,\n\n  /**\n   * API key\n   */\n  apiKey: customConfiguration?.apiKey,\n\n  /**\n   * API model\n   */\n  model: customConfiguration?.model,\n\n  /**\n   * Temperature\n   */\n  temperature: customConfiguration?.temperature,\n\n  /**\n   * Application context\n   *\n   * Default: undefined\n   *\n   * The application context.\n   *\n   * Example: `'My application context'`\n   *\n   * Note: Can be used to provide additional context about the application to the AI model. You can add more rules (e.g. \"You should not transform urls\").\n   */\n  applicationContext: customConfiguration?.applicationContext,\n\n  /**\n   * Base URL for the AI API\n   *\n   * Default: undefined\n   *\n   * The base URL for the AI API.\n   *\n   * Example: `'http://localhost:5000'`\n   *\n   * Note: Can be used to point to a local, or custom AI API endpoint.\n   */\n  baseURL: customConfiguration?.baseURL,\n\n  /**\n   * Data serialization\n   *\n   * Options:\n   * - \"json\": The industry standard. Highly reliable and structured, but consumes more tokens.\n   * - \"toon\": An optimized format designed to reduce token consumption (cost-effective). However, it may slightly increase the risk of output inconsistency compared to standard JSON\n   *\n   * Default: `\"json\"`\n   */\n  dataSerialization: customConfiguration?.dataSerialization,\n});\n\n/**\n * Build the `build` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied build config.\n * @returns A fully-defaulted {@link BuildConfig}.\n */\nconst buildBuildFields = (\n  customConfiguration?: Partial<BuildConfig>\n): BuildConfig => ({\n  /**\n   * Indicates the mode of the build\n   *\n   * Default: 'auto'\n   *\n   * If 'auto', the build will be enabled automatically when the application is built.\n   * If 'manual', the build will be set only when the build command is executed.\n   *\n   * Can be used to disable dictionaries build, for instance when execution on Node.js environment should be avoided.\n   */\n  mode: customConfiguration?.mode ?? BUILD_MODE,\n\n  /**\n   * Indicates if the build should be optimized\n   *\n   * Default: process.env.NODE_ENV === 'production'\n   *\n   * If true, the build will be optimized.\n   * If false, the build will not be optimized.\n   *\n   * Intlayer will replace all calls of dictionaries to optimize chunking. That way the final bundle will import only the dictionaries that are used.\n   * All imports will stay as static import to avoid async processing when loading the dictionaries.\n   *\n   * Note:\n   * - Intlayer will replace all call of `useIntlayer` with the defined mode by the `importMode` option.\n   * - Intlayer will replace all call of `getIntlayer` with `getDictionary`.\n   * - This option relies on the `@intlayer/babel` and `@intlayer/swc` plugins.\n   * - In most cases, \"dynamic\" will be used for React applications, \"async\" for Vue.js applications.\n   * - Ensure all keys are declared statically in the `useIntlayer` calls. e.g. `useIntlayer('navbar')`.\n   */\n  optimize: customConfiguration?.optimize,\n\n  /**\n   * Indicates the mode of import to use for the dictionaries.\n   *\n   * Available modes:\n   * - \"static\": The dictionaries are imported statically.\n   *   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionary`.\n   * - \"dynamic\": The dictionaries are imported dynamically in a synchronous component using the suspense API.\n   *   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionaryDynamic`.\n   * - \"live\": The dictionaries are imported dynamically using the live sync API.\n   *   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionaryDynamic`.\n   *   Live mode will use the live sync API to fetch the dictionaries. If the API call fails, the dictionaries will be imported dynamically as \"dynamic\" mode.\n   *\n   * Default: \"static\"\n   *\n   * By default, when a dictionary is loaded, it imports content for all locales as it's imported statically.\n   *\n   * Note:\n   * - Dynamic imports rely on Suspense and may slightly impact rendering performance.\n   * - If disabled all locales will be loaded at once, even if they are not used.\n   * - This option relies on the `@intlayer/babel` and `@intlayer/swc` plugins.\n   * - Ensure all keys are declared statically in the `useIntlayer` calls. e.g. `useIntlayer('navbar')`.\n   * - This option will be ignored if `optimize` is disabled.\n   * - This option will not impact the `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` and `useDictionaryDynamic` functions. You can still use them to refine you code on manual optimization.\n   * - The \"live\" allows to sync the dictionaries to the live sync server.\n   *\n   * @deprecated Use `dictionary.importMode` instead.\n   */\n  importMode: customConfiguration?.importMode,\n\n  /**\n   * Minify the dictionaries to reduce the bundle size.\n   *\n   * Default: false\n   *\n   * Note:\n   * - This option will be ignored if `optimize` is disabled.\n   * - This option will be ignore if `editor.enabled` is true.\n   * - If there is edge cases where the minification is not working properly, the dictionary will be not minified.\n   */\n  minify: customConfiguration?.minify ?? MINIFY,\n\n  /**\n   * Purge the unused keys in a dictionaries\n   *\n   * Default: false\n   *\n   * Note:\n   * - This option will be ignored if `optimize` is disabled.\n   * - This option will be ignored if `editor.enabled` is true.\n   */\n  purge: customConfiguration?.purge ?? PURGE,\n\n  /**\n   * Pattern to traverse the code to optimize.\n   *\n   * Allows to avoid to traverse the code that is not relevant to the optimization.\n   * Improve build performance.\n   *\n   * Default: ['**\\/*.{js,ts,mjs,cjs,jsx,tsx}', '!**\\/node_modules/**']\n   *\n   * Example: `['src/**\\/*.{ts,tsx}', '../ui-library/**\\/*.{ts,tsx}']`\n   *\n   * Note:\n   * - This option will be ignored if `optimize` is disabled.\n   * - Use glob pattern.\n   */\n  traversePattern: customConfiguration?.traversePattern ?? TRAVERSE_PATTERN,\n\n  /**\n   * Output format of the dictionaries\n   *\n   * Can be set on large projects to improve build performance.\n   *\n   * Default: ['cjs', 'esm']\n   *\n   * The output format of the dictionaries. It can be either 'cjs' or 'esm'.\n   * - 'cjs': The dictionaries are outputted as CommonJS modules.\n   * - 'esm': The dictionaries are outputted as ES modules.\n   */\n  outputFormat: customConfiguration?.outputFormat ?? OUTPUT_FORMAT,\n\n  /**\n   * Cache\n   */\n  cache: customConfiguration?.cache ?? CACHE,\n\n  /**\n   * Require function\n   */\n  require: customConfiguration?.require,\n\n  /**\n   * Indicates if the build should check TypeScript types\n   *\n   * Default: `false`\n   *\n   * If true, the build will check TypeScript types and log errors.\n   * Note: This can slow down the build.\n   */\n  checkTypes: customConfiguration?.checkTypes ?? TYPE_CHECKING,\n});\n\n/**\n * Build the `compiler` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied compiler config.\n * @returns A fully-defaulted {@link CompilerConfig}.\n */\nconst buildCompilerFields = (\n  customConfiguration?: Partial<CompilerConfig>\n): CompilerConfig => ({\n  /**\n   * Indicates if the compiler should be enabled\n   */\n  enabled: customConfiguration?.enabled ?? COMPILER_ENABLED,\n\n  /**\n   * Prefix for the extracted dictionary keys\n   */\n  dictionaryKeyPrefix:\n    customConfiguration?.dictionaryKeyPrefix ?? COMPILER_DICTIONARY_KEY_PREFIX,\n\n  /**\n   * Pattern to traverse the code to optimize.\n   *\n   * @deprecated use `build.traversePattern` instead\n   */\n  transformPattern: customConfiguration?.transformPattern,\n\n  /**\n   * Pattern to exclude from the optimization.\n   *\n   * @deprecated use `build.traversePattern` instead\n   */\n  excludePattern: customConfiguration?.excludePattern,\n\n  /**\n   * Defines the output files path. Replaces `outputDir`.\n   *\n   * - `./` paths are resolved relative to the component directory.\n   * - `/` paths are resolved relative to the project root (`baseDir`).\n   *\n   * - Including the `{{locale}}` variable in the path will trigger the generation of separate dictionaries per locale.\n   *\n   * @example:\n   * ```ts\n   * {\n   *   // Create Multilingual .content.ts files close to the component\n   *   output: ({ fileName, extension }) => `./${fileName}${extension}`,\n   *\n   *   // output: './{{fileName}}{{extension}}', // Equivalent using template string\n   * }\n   * ```\n   *\n   * ```ts\n   * {\n   *   // Create centralize per-locale JSON at the root of the project\n   *   output: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,\n   *\n   *   // output: '/locales/{{locale}}/{{key}}.content.json', // Equivalent using template string\n   * }\n   * ```\n   *\n   * ```ts\n   * {\n   *   // Create per-locale JSON files with locale-specific output paths\n   *   output: {\n   *     en: ({ fileName, locale }) => `${fileName}.${locale}.content.json`,\n   *     fr: '{{fileName}}.{{locale}}.content.json',\n   *     es: false, // skip this locale\n   *   },\n   * }\n   * ```\n   *\n   * Variable list:\n   *   - `fileName`: The name of the file.\n   *   - `key`: The key of the content.\n   *   - `locale`: The locale of the content.\n   *   - `extension`: The extension of the file.\n   *   - `componentFileName`: The name of the component file.\n   *   - `componentExtension`: The extension of the component file.\n   *   - `format`: The format of the dictionary.\n   *   - `componentFormat`: The format of the component dictionary.\n   *   - `componentDirPath`: The directory path of the component.\n   */\n  output: customConfiguration?.output,\n\n  /**\n   * Indicates if the metadata should be saved in the file.\n   *\n   * If true, the compiler will not save the metadata of the dictionaries.\n   *\n   * If `true`:\n   *\n   * ```json\n   * {\n   *   \"key\": \"value\"\n   * }\n   * ```\n   *\n   * If `false`:\n   *\n   * ```json\n   * {\n   *   \"key\": \"value\",\n   *   \"content\": {\n   *      \"key\": \"value\"\n   *   }\n   * }\n   * ```\n   *\n   * Default: `false`\n   *\n   * Note: Useful if used with loadJSON plugin\n   */\n  noMetadata: customConfiguration?.noMetadata ?? COMPILER_NO_METADATA,\n\n  /**\n   * Indicates if the components should be saved after being transformed.\n   */\n  saveComponents:\n    customConfiguration?.saveComponents ?? COMPILER_SAVE_COMPONENTS,\n});\n\n/**\n * Build the `dictionary` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied dictionary config.\n * @returns A fully-defaulted {@link DictionaryConfig}.\n */\nconst buildDictionaryFields = (\n  customConfiguration?: Partial<DictionaryConfig>\n): DictionaryConfig => {\n  const contentAutoTransformation =\n    customConfiguration?.contentAutoTransformation ??\n    CONTENT_AUTO_TRANSFORMATION;\n\n  return {\n    /**\n     * Indicate how the dictionary should be filled using AI.\n     *\n     * Default: `true`\n     *\n     * - If `true`, will consider the `compiler.output` field.\n     * - If `false`, will skip the fill process.\n     *\n     * - `./` paths are resolved relative to the component directory.\n     * - `/` paths are resolved relative to the project root (`baseDir`).\n     *\n     * - If includes `{{locale}}` variable in the path, will trigger the generation of separate dictionaries per locale.\n     *\n     * Example:\n     * ```ts\n     * {\n     *   // Create Multilingual .content.ts files close to the component\n     *   fill: ({ fileName, extension }) => `./${fileName}${extension}`,\n     *\n     *   // fill: './{{fileName}}{{extension}}', // Equivalent using template string\n     * }\n     * ```\n     *\n     * ```ts\n     * {\n     *   // Create centralize per-locale JSON at the root of the project\n     *   fill: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,\n     *\n     *   // fill: '/locales/{{locale}}/{{key}}.content.json', // Equivalent using template string\n     * }\n     * ```\n     *\n     * ```ts\n     * {\n     *   // Create custom output based on the locale\n     *   fill: {\n     *     en: ({ key }) => `/locales/en/${key}.content.json`,\n     *     fr: '/locales/fr/{{key}}.content.json',\n     *     es: false,\n     *     de: true,\n     *   },\n     * }\n     * ```\n     *\n     *\n     * Variable list:\n     *   - `fileName`: The name of the file.\n     *   - `key`: The key of the content.\n     *   - `locale`: The locale of the content.\n     *   - `extension`: The extension of the file.\n     *   - `componentFileName`: The name of the component file.\n     *   - `componentExtension`: The extension of the component file.\n     *   - `format`: The format of the dictionary.\n     *   - `componentFormat`: The format of the component dictionary.\n     *   - `componentDirPath`: The directory path of the component.\n     */\n    fill: customConfiguration?.fill ?? FILL,\n\n    /**\n     * Indicates if the content of the dictionary should be automatically transformed.\n     *\n     * Default: `false`\n     */\n    contentAutoTransformation:\n      typeof contentAutoTransformation === 'object'\n        ? {\n            markdown: contentAutoTransformation.markdown ?? false,\n            html: contentAutoTransformation.html ?? false,\n            insertion: contentAutoTransformation.insertion ?? false,\n          }\n        : contentAutoTransformation,\n\n    /**\n     * The location of the dictionary.\n     *\n     * Default: `\"local\"`\n     */\n    location: customConfiguration?.location ?? LOCATION,\n\n    /**\n     * Transform the dictionary in a per-locale dictionary.\n     * Each field declared in a per-locale dictionary will be transformed in a translation node.\n     * If missing, the dictionary will be treated as a multilingual dictionary.\n     */\n    locale: customConfiguration?.locale,\n\n    /**\n     * The title of the dictionary.\n     */\n    title: customConfiguration?.title,\n\n    /**\n     * The description of the dictionary.\n     */\n    description: customConfiguration?.description,\n\n    /**\n     * Tags to categorize the dictionaries.\n     */\n    tags: customConfiguration?.tags,\n\n    /**\n     * The priority of the dictionary.\n     */\n    priority: customConfiguration?.priority,\n\n    /**\n     * Indicates the mode of import to use for the dictionary.\n     *\n     * Available modes:\n     * - \"static\": The dictionaries are imported statically.\n     * - \"dynamic\": The dictionaries are imported dynamically in a synchronous component using the suspense API.\n     * - \"live\": The dictionaries are imported dynamically using the live sync API.\n     *\n     * Default: `\"static\"`\n     */\n    importMode: customConfiguration?.importMode ?? IMPORT_MODE,\n\n    /**\n     * The default message format for all dictionaries in the project.\n     *\n     * Default: 'intlayer'\n     */\n    format: customConfiguration?.format,\n  };\n};\n\n// ---------------------------------------------------------------------------\n// Main export\n// ---------------------------------------------------------------------------\n\n/**\n * Build the complete Intlayer configuration by merging user-supplied values\n * with defaults.\n *\n * Internally this function:\n * 1. Calls {@link buildBrowserConfiguration} to produce the browser-safe\n *    subset (internationalization, routing, editor public fields, log, metadata).\n * 2. Extends the result with full server-side fields:\n *    - `internationalization` — adds `requiredLocales` and `strictMode`.\n *    - `editor` — adds `clientId` and `clientSecret`.\n *    - `log` — adds custom log functions.\n *    - `system`, `content`, `ai`, `build`, `compiler`, `dictionary`.\n *\n * @param customConfiguration - Optional user-supplied configuration object.\n * @param baseDir - Project root directory. Defaults to `process.cwd()`.\n * @param logFunctions - Optional custom logging functions.\n * @returns A fully-built {@link IntlayerConfig}.\n */\nexport const buildConfigurationFields = (\n  customConfiguration?: CustomIntlayerConfig,\n  baseDir?: string,\n  logFunctions?: LogFunctions\n): IntlayerConfig => {\n  if (customConfiguration) {\n    const result = intlayerConfigSchema.safeParse(customConfiguration);\n\n    if (!result.success) {\n      const logError = logFunctions?.error ?? console.error;\n\n      for (const issue of result.error.issues) {\n        logError(`${issue.path.join('.')}: ${issue.message}`);\n      }\n    }\n  }\n\n  // build browser-safe config (shared defaults, no Node.js deps)\n  const browserConfig = buildBrowserConfiguration(customConfiguration);\n\n  // extend shared fields with server-only additions\n  const internationalizationConfig = buildInternationalizationFields(\n    customConfiguration?.internationalization\n  );\n\n  const editorConfig = buildEditorFields(customConfiguration?.editor);\n\n  const logConfig = buildLogFields(customConfiguration?.log, logFunctions);\n\n  // build server-only fields\n  const systemConfig = buildSystemFields(baseDir, customConfiguration?.system);\n\n  const contentConfig = buildContentFields(\n    systemConfig,\n    customConfiguration?.content\n  );\n\n  storedConfiguration = {\n    // Shared browser fields\n    routing: browserConfig.routing,\n    // Full (extended) shared fields\n    internationalization: internationalizationConfig,\n    editor: editorConfig,\n    analytics: buildAnalyticsFields(customConfiguration?.analytics),\n    log: logConfig,\n    // Server-only fields\n    system: systemConfig,\n    content: contentConfig,\n    ai: buildAiFields(customConfiguration?.ai),\n    build: buildBuildFields(customConfiguration?.build),\n    compiler: buildCompilerFields(customConfiguration?.compiler),\n    dictionary: buildDictionaryFields(customConfiguration?.dictionary),\n    plugins: customConfiguration?.plugins,\n    schemas: customConfiguration?.schemas,\n  } as IntlayerConfig;\n\n  return storedConfiguration;\n};\n"],"mappings":"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"}
+{"version":3,"file":"buildConfigurationFields.cjs","names":["getProjectRequire","isAbsolute","join","statSync","dirname","FILE_EXTENSIONS","CONTENT_DIR","CODE_DIR","EXCLUDED_PATHS","TRAVERSE_PATTERN","OUTPUT_FORMAT","intlayerConfigSchema","buildBrowserConfiguration","buildInternationalizationFields","buildEditorFields","buildLogFields","buildAnalyticsFields"],"sources":["../../../src/configFile/buildConfigurationFields.ts"],"sourcesContent":["import { statSync } from 'node:fs';\nimport { dirname, isAbsolute, join } from 'node:path';\nimport type {\n  AiConfig,\n  BuildConfig,\n  CompilerConfig,\n  ContentConfig,\n  CustomIntlayerConfig,\n  DictionaryConfig,\n  IntlayerConfig,\n  LogFunctions,\n  SystemConfig,\n} from '@intlayer/types/config';\nimport {\n  BUILD_MODE,\n  CACHE,\n  CHUNK_GROUPING,\n  DICTIONARIES_PRELOAD,\n  MINIFY,\n  OUTPUT_FORMAT,\n  PURGE,\n  TRAVERSE_PATTERN,\n  TYPE_CHECKING,\n} from '../defaultValues/build';\nimport {\n  COMPILER_DICTIONARY_KEY_PREFIX,\n  COMPILER_ENABLED,\n  COMPILER_NO_METADATA,\n  COMPILER_SAVE_COMPONENTS,\n} from '../defaultValues/compiler';\nimport {\n  CODE_DIR,\n  CONTENT_DIR,\n  EXCLUDED_PATHS,\n  FILE_EXTENSIONS,\n  WATCH,\n} from '../defaultValues/content';\nimport {\n  CONTENT_AUTO_TRANSFORMATION,\n  FILL,\n  IMPORT_MODE,\n  LOCATION,\n} from '../defaultValues/dictionary';\nimport {\n  CACHE_DIR,\n  CONFIG_DIR,\n  DICTIONARIES_DIR,\n  DYNAMIC_DICTIONARIES_DIR,\n  FETCH_DICTIONARIES_DIR,\n  MAIN_DIR,\n  MODULE_AUGMENTATION_DIR,\n  REMOTE_DICTIONARIES_DIR,\n  TEMP_DIR,\n  TYPES_DIR,\n  UNMERGED_DICTIONARIES_DIR,\n} from '../defaultValues/system';\nimport { getProjectRequire } from '../utils';\nimport {\n  buildAnalyticsFields,\n  buildBrowserConfiguration,\n  buildEditorFields,\n  buildInternationalizationFields,\n  buildLogFields,\n} from './buildBrowserConfiguration';\nimport { intlayerConfigSchema } from './configurationSchema';\n\nexport {\n  type BrowserIntlayerConfig,\n  buildAnalyticsFields,\n  buildBrowserConfiguration,\n  buildEditorFields,\n  buildInternationalizationFields,\n  buildLogFields,\n  buildRoutingFields,\n  extractBrowserConfiguration,\n} from './buildBrowserConfiguration';\n\nlet storedConfiguration: IntlayerConfig;\n\n// ---------------------------------------------------------------------------\n// Server-only field builders (Node.js — not browser-safe)\n// ---------------------------------------------------------------------------\n\n/**\n * Build the `system` section of the Intlayer configuration.\n *\n * Resolves all directory paths (dictionaries, types, cache, …) relative to\n * the project base directory, using Node.js `require.resolve` where available\n * and falling back to `path.join` otherwise.\n *\n * @param baseDir - Project root directory. Defaults to `process.cwd()`.\n * @param customConfiguration - Partial user-supplied system config.\n * @returns A fully-resolved {@link SystemConfig}.\n */\nconst buildSystemFields = (\n  baseDir?: string,\n  customConfiguration?: Partial<SystemConfig>\n): SystemConfig => {\n  const projectBaseDir = baseDir ?? process.cwd();\n\n  const optionalJoinBaseDir = (pathInput: string) => {\n    let absolutePath: string;\n\n    try {\n      const requireFunction = getProjectRequire(projectBaseDir);\n      try {\n        absolutePath = requireFunction.resolve(pathInput, {\n          paths: [projectBaseDir],\n        });\n      } catch (err) {\n        if (!pathInput.startsWith('.') && !isAbsolute(pathInput)) {\n          absolutePath = requireFunction.resolve(`${pathInput}/package.json`, {\n            paths: [projectBaseDir],\n          });\n        } else {\n          throw err;\n        }\n      }\n    } catch {\n      absolutePath = isAbsolute(pathInput)\n        ? pathInput\n        : join(projectBaseDir, pathInput);\n    }\n\n    try {\n      const stats = statSync(absolutePath);\n      if (stats.isFile()) {\n        return dirname(absolutePath);\n      }\n    } catch {\n      if (/\\.[a-z0-9]+$/i.test(absolutePath)) {\n        return dirname(absolutePath);\n      }\n    }\n\n    return absolutePath;\n  };\n\n  const dictionariesDir = optionalJoinBaseDir(\n    customConfiguration?.dictionariesDir ?? DICTIONARIES_DIR\n  );\n\n  return {\n    baseDir: projectBaseDir,\n    moduleAugmentationDir: optionalJoinBaseDir(\n      customConfiguration?.moduleAugmentationDir ?? MODULE_AUGMENTATION_DIR\n    ),\n    unmergedDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.unmergedDictionariesDir ?? UNMERGED_DICTIONARIES_DIR\n    ),\n    remoteDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.remoteDictionariesDir ?? REMOTE_DICTIONARIES_DIR\n    ),\n    dictionariesDir,\n    dynamicDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.dynamicDictionariesDir ?? DYNAMIC_DICTIONARIES_DIR\n    ),\n    fetchDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.fetchDictionariesDir ?? FETCH_DICTIONARIES_DIR\n    ),\n    typesDir: optionalJoinBaseDir(customConfiguration?.typesDir ?? TYPES_DIR),\n    mainDir: optionalJoinBaseDir(customConfiguration?.mainDir ?? MAIN_DIR),\n    configDir: optionalJoinBaseDir(\n      customConfiguration?.configDir ?? CONFIG_DIR\n    ),\n    cacheDir: optionalJoinBaseDir(customConfiguration?.cacheDir ?? CACHE_DIR),\n    tempDir: optionalJoinBaseDir(customConfiguration?.tempDir ?? TEMP_DIR),\n  };\n};\n\n/**\n * Build the `content` section of the Intlayer configuration.\n *\n * Resolves content and code directories relative to the project base using\n * `require.resolve`, falling back to `path.join`.\n *\n * @param systemConfig - Already-built system configuration (provides `baseDir`).\n * @param customConfiguration - Partial user-supplied content config.\n * @returns A fully-resolved {@link ContentConfig}.\n */\nconst buildContentFields = (\n  systemConfig: SystemConfig,\n  customConfiguration?: Partial<ContentConfig>\n): ContentConfig => {\n  const fileExtensions = customConfiguration?.fileExtensions ?? FILE_EXTENSIONS;\n\n  const optionalJoinBaseDir = (pathInput: string) => {\n    let absolutePath: string;\n\n    try {\n      const requireFunction = getProjectRequire(systemConfig.baseDir);\n      try {\n        absolutePath = requireFunction.resolve(pathInput, {\n          paths: [systemConfig.baseDir],\n        });\n      } catch (err) {\n        if (!pathInput.startsWith('.') && !isAbsolute(pathInput)) {\n          absolutePath = requireFunction.resolve(`${pathInput}/package.json`, {\n            paths: [systemConfig.baseDir],\n          });\n        } else {\n          throw err;\n        }\n      }\n    } catch {\n      try {\n        try {\n          absolutePath = require.resolve(pathInput, {\n            paths: [systemConfig.baseDir],\n          });\n        } catch (err) {\n          if (!pathInput.startsWith('.') && !isAbsolute(pathInput)) {\n            absolutePath = require.resolve(`${pathInput}/package.json`, {\n              paths: [systemConfig.baseDir],\n            });\n          } else {\n            throw err;\n          }\n        }\n      } catch {\n        absolutePath = isAbsolute(pathInput)\n          ? pathInput\n          : join(systemConfig.baseDir, pathInput);\n      }\n    }\n\n    try {\n      const stats = statSync(absolutePath);\n      if (stats.isFile()) {\n        return dirname(absolutePath);\n      }\n    } catch {\n      if (/\\.[a-z0-9]+$/i.test(absolutePath)) {\n        return dirname(absolutePath);\n      }\n    }\n\n    return absolutePath;\n  };\n\n  const contentDir = (customConfiguration?.contentDir ?? CONTENT_DIR).map(\n    optionalJoinBaseDir\n  );\n  const codeDir = (customConfiguration?.codeDir ?? CODE_DIR).map(\n    optionalJoinBaseDir\n  );\n\n  return {\n    fileExtensions,\n    contentDir,\n    codeDir,\n    excludedPath: customConfiguration?.excludedPath ?? EXCLUDED_PATHS,\n    watch: customConfiguration?.watch ?? WATCH,\n    formatCommand: customConfiguration?.formatCommand,\n  };\n};\n\n/**\n * Build the `ai` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied AI config.\n * @returns A fully-defaulted {@link AiConfig}.\n */\nconst buildAiFields = (customConfiguration?: Partial<AiConfig>): AiConfig => ({\n  /**\n   * AI configuration\n   */\n  provider: customConfiguration?.provider,\n\n  /**\n   * API key\n   */\n  apiKey: customConfiguration?.apiKey,\n\n  /**\n   * API model\n   */\n  model: customConfiguration?.model,\n\n  /**\n   * Temperature\n   */\n  temperature: customConfiguration?.temperature,\n\n  /**\n   * Application context\n   *\n   * Default: undefined\n   *\n   * The application context.\n   *\n   * Example: `'My application context'`\n   *\n   * Note: Can be used to provide additional context about the application to the AI model. You can add more rules (e.g. \"You should not transform urls\").\n   */\n  applicationContext: customConfiguration?.applicationContext,\n\n  /**\n   * Base URL for the AI API\n   *\n   * Default: undefined\n   *\n   * The base URL for the AI API.\n   *\n   * Example: `'http://localhost:5000'`\n   *\n   * Note: Can be used to point to a local, or custom AI API endpoint.\n   */\n  baseURL: customConfiguration?.baseURL,\n\n  /**\n   * Data serialization\n   *\n   * Options:\n   * - \"json\": The industry standard. Highly reliable and structured, but consumes more tokens.\n   * - \"toon\": An optimized format designed to reduce token consumption (cost-effective). However, it may slightly increase the risk of output inconsistency compared to standard JSON\n   *\n   * Default: `\"json\"`\n   */\n  dataSerialization: customConfiguration?.dataSerialization,\n});\n\n/**\n * Build the `build` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied build config.\n * @returns A fully-defaulted {@link BuildConfig}.\n */\nconst buildBuildFields = (\n  customConfiguration?: Partial<BuildConfig>\n): BuildConfig => ({\n  /**\n   * Indicates the mode of the build\n   *\n   * Default: 'auto'\n   *\n   * If 'auto', the build will be enabled automatically when the application is built.\n   * If 'manual', the build will be set only when the build command is executed.\n   *\n   * Can be used to disable dictionaries build, for instance when execution on Node.js environment should be avoided.\n   */\n  mode: customConfiguration?.mode ?? BUILD_MODE,\n\n  /**\n   * Indicates if the build should be optimized\n   *\n   * Default: process.env.NODE_ENV === 'production'\n   *\n   * If true, the build will be optimized.\n   * If false, the build will not be optimized.\n   *\n   * Intlayer will replace all calls of dictionaries to optimize chunking. That way the final bundle will import only the dictionaries that are used.\n   * All imports will stay as static import to avoid async processing when loading the dictionaries.\n   *\n   * Note:\n   * - Intlayer will replace all call of `useIntlayer` with the defined mode by the `importMode` option.\n   * - Intlayer will replace all call of `getIntlayer` with `getDictionary`.\n   * - This option relies on the `@intlayer/babel` and `@intlayer/swc` plugins.\n   * - In most cases, \"dynamic\" will be used for React applications, \"async\" for Vue.js applications.\n   * - Ensure all keys are declared statically in the `useIntlayer` calls. e.g. `useIntlayer('navbar')`.\n   */\n  optimize: customConfiguration?.optimize,\n\n  /**\n   * Indicates the mode of import to use for the dictionaries.\n   *\n   * Available modes:\n   * - \"static\": The dictionaries are imported statically.\n   *   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionary`.\n   * - \"dynamic\": The dictionaries are imported dynamically in a synchronous component using the suspense API.\n   *   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionaryDynamic`.\n   * - \"live\": The dictionaries are imported dynamically using the live sync API.\n   *   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionaryDynamic`.\n   *   Live mode will use the live sync API to fetch the dictionaries. If the API call fails, the dictionaries will be imported dynamically as \"dynamic\" mode.\n   *\n   * Default: \"static\"\n   *\n   * By default, when a dictionary is loaded, it imports content for all locales as it's imported statically.\n   *\n   * Note:\n   * - Dynamic imports rely on Suspense and may slightly impact rendering performance.\n   * - If disabled all locales will be loaded at once, even if they are not used.\n   * - This option relies on the `@intlayer/babel` and `@intlayer/swc` plugins.\n   * - Ensure all keys are declared statically in the `useIntlayer` calls. e.g. `useIntlayer('navbar')`.\n   * - This option will be ignored if `optimize` is disabled.\n   * - This option will not impact the `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` and `useDictionaryDynamic` functions. You can still use them to refine you code on manual optimization.\n   * - The \"live\" allows to sync the dictionaries to the live sync server.\n   *\n   * @deprecated Use `dictionary.importMode` instead.\n   */\n  importMode: customConfiguration?.importMode,\n\n  /**\n   * Minify the dictionaries to reduce the bundle size.\n   *\n   * Default: false\n   *\n   * Note:\n   * - This option will be ignored if `optimize` is disabled.\n   * - This option will be ignore if `editor.enabled` is true.\n   * - If there is edge cases where the minification is not working properly, the dictionary will be not minified.\n   */\n  minify: customConfiguration?.minify ?? MINIFY,\n\n  /**\n   * Purge the unused keys in a dictionaries\n   *\n   * Default: false\n   *\n   * Note:\n   * - This option will be ignored if `optimize` is disabled.\n   * - This option will be ignored if `editor.enabled` is true.\n   */\n  purge: customConfiguration?.purge ?? PURGE,\n\n  /**\n   * Group the per-locale dictionary chunks by the code-split boundary that uses\n   * them, so a lazily loaded page fetches its content in one request.\n   *\n   * Default: true\n   *\n   * Note:\n   * - Only applies to dictionaries using `importMode: 'dynamic'`.\n   * - Only applies to the client build, and only when bundling (not in dev).\n   */\n  chunkGrouping: customConfiguration?.chunkGrouping ?? CHUNK_GROUPING,\n\n  /**\n   * Load a dictionary together with the chunk that uses it, instead of fetching\n   * it once that chunk renders — so a reader renders synchronously rather than\n   * suspending, and navigating no longer flashes a loading state.\n   *\n   * Default: true\n   *\n   * Note:\n   * - Only applies to dictionaries using `importMode: 'dynamic'`.\n   * - Only applies to the client build; the server keeps loading on demand.\n   * - Requires a bundler supporting top-level await (Vite, esbuild).\n   */\n  dictionariesPreload:\n    customConfiguration?.dictionariesPreload ?? DICTIONARIES_PRELOAD,\n\n  /**\n   * Pattern to traverse the code to optimize.\n   *\n   * Allows to avoid to traverse the code that is not relevant to the optimization.\n   * Improve build performance.\n   *\n   * Default: ['**\\/*.{js,ts,mjs,cjs,jsx,tsx}', '!**\\/node_modules/**']\n   *\n   * Example: `['src/**\\/*.{ts,tsx}', '../ui-library/**\\/*.{ts,tsx}']`\n   *\n   * Note:\n   * - This option will be ignored if `optimize` is disabled.\n   * - Use glob pattern.\n   */\n  traversePattern: customConfiguration?.traversePattern ?? TRAVERSE_PATTERN,\n\n  /**\n   * Output format of the dictionaries\n   *\n   * Can be set on large projects to improve build performance.\n   *\n   * Default: ['cjs', 'esm']\n   *\n   * The output format of the dictionaries. It can be either 'cjs' or 'esm'.\n   * - 'cjs': The dictionaries are outputted as CommonJS modules.\n   * - 'esm': The dictionaries are outputted as ES modules.\n   */\n  outputFormat: customConfiguration?.outputFormat ?? OUTPUT_FORMAT,\n\n  /**\n   * Cache\n   */\n  cache: customConfiguration?.cache ?? CACHE,\n\n  /**\n   * Require function\n   */\n  require: customConfiguration?.require,\n\n  /**\n   * Indicates if the build should check TypeScript types\n   *\n   * Default: `false`\n   *\n   * If true, the build will check TypeScript types and log errors.\n   * Note: This can slow down the build.\n   */\n  checkTypes: customConfiguration?.checkTypes ?? TYPE_CHECKING,\n});\n\n/**\n * Build the `compiler` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied compiler config.\n * @returns A fully-defaulted {@link CompilerConfig}.\n */\nconst buildCompilerFields = (\n  customConfiguration?: Partial<CompilerConfig>\n): CompilerConfig => ({\n  /**\n   * Indicates if the compiler should be enabled\n   */\n  enabled: customConfiguration?.enabled ?? COMPILER_ENABLED,\n\n  /**\n   * Prefix for the extracted dictionary keys\n   */\n  dictionaryKeyPrefix:\n    customConfiguration?.dictionaryKeyPrefix ?? COMPILER_DICTIONARY_KEY_PREFIX,\n\n  /**\n   * Pattern to traverse the code to optimize.\n   *\n   * @deprecated use `build.traversePattern` instead\n   */\n  transformPattern: customConfiguration?.transformPattern,\n\n  /**\n   * Pattern to exclude from the optimization.\n   *\n   * @deprecated use `build.traversePattern` instead\n   */\n  excludePattern: customConfiguration?.excludePattern,\n\n  /**\n   * Defines the output files path. Replaces `outputDir`.\n   *\n   * - `./` paths are resolved relative to the component directory.\n   * - `/` paths are resolved relative to the project root (`baseDir`).\n   *\n   * - Including the `{{locale}}` variable in the path will trigger the generation of separate dictionaries per locale.\n   *\n   * @example:\n   * ```ts\n   * {\n   *   // Create Multilingual .content.ts files close to the component\n   *   output: ({ fileName, extension }) => `./${fileName}${extension}`,\n   *\n   *   // output: './{{fileName}}{{extension}}', // Equivalent using template string\n   * }\n   * ```\n   *\n   * ```ts\n   * {\n   *   // Create centralize per-locale JSON at the root of the project\n   *   output: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,\n   *\n   *   // output: '/locales/{{locale}}/{{key}}.content.json', // Equivalent using template string\n   * }\n   * ```\n   *\n   * ```ts\n   * {\n   *   // Create per-locale JSON files with locale-specific output paths\n   *   output: {\n   *     en: ({ fileName, locale }) => `${fileName}.${locale}.content.json`,\n   *     fr: '{{fileName}}.{{locale}}.content.json',\n   *     es: false, // skip this locale\n   *   },\n   * }\n   * ```\n   *\n   * Variable list:\n   *   - `fileName`: The name of the file.\n   *   - `key`: The key of the content.\n   *   - `locale`: The locale of the content.\n   *   - `extension`: The extension of the file.\n   *   - `componentFileName`: The name of the component file.\n   *   - `componentExtension`: The extension of the component file.\n   *   - `format`: The format of the dictionary.\n   *   - `componentFormat`: The format of the component dictionary.\n   *   - `componentDirPath`: The directory path of the component.\n   */\n  output: customConfiguration?.output,\n\n  /**\n   * Indicates if the metadata should be saved in the file.\n   *\n   * If true, the compiler will not save the metadata of the dictionaries.\n   *\n   * If `true`:\n   *\n   * ```json\n   * {\n   *   \"key\": \"value\"\n   * }\n   * ```\n   *\n   * If `false`:\n   *\n   * ```json\n   * {\n   *   \"key\": \"value\",\n   *   \"content\": {\n   *      \"key\": \"value\"\n   *   }\n   * }\n   * ```\n   *\n   * Default: `false`\n   *\n   * Note: Useful if used with loadJSON plugin\n   */\n  noMetadata: customConfiguration?.noMetadata ?? COMPILER_NO_METADATA,\n\n  /**\n   * Indicates if the components should be saved after being transformed.\n   */\n  saveComponents:\n    customConfiguration?.saveComponents ?? COMPILER_SAVE_COMPONENTS,\n});\n\n/**\n * Build the `dictionary` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied dictionary config.\n * @returns A fully-defaulted {@link DictionaryConfig}.\n */\nconst buildDictionaryFields = (\n  customConfiguration?: Partial<DictionaryConfig>\n): DictionaryConfig => {\n  const contentAutoTransformation =\n    customConfiguration?.contentAutoTransformation ??\n    CONTENT_AUTO_TRANSFORMATION;\n\n  return {\n    /**\n     * Indicate how the dictionary should be filled using AI.\n     *\n     * Default: `true`\n     *\n     * - If `true`, will consider the `compiler.output` field.\n     * - If `false`, will skip the fill process.\n     *\n     * - `./` paths are resolved relative to the component directory.\n     * - `/` paths are resolved relative to the project root (`baseDir`).\n     *\n     * - If includes `{{locale}}` variable in the path, will trigger the generation of separate dictionaries per locale.\n     *\n     * Example:\n     * ```ts\n     * {\n     *   // Create Multilingual .content.ts files close to the component\n     *   fill: ({ fileName, extension }) => `./${fileName}${extension}`,\n     *\n     *   // fill: './{{fileName}}{{extension}}', // Equivalent using template string\n     * }\n     * ```\n     *\n     * ```ts\n     * {\n     *   // Create centralize per-locale JSON at the root of the project\n     *   fill: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,\n     *\n     *   // fill: '/locales/{{locale}}/{{key}}.content.json', // Equivalent using template string\n     * }\n     * ```\n     *\n     * ```ts\n     * {\n     *   // Create custom output based on the locale\n     *   fill: {\n     *     en: ({ key }) => `/locales/en/${key}.content.json`,\n     *     fr: '/locales/fr/{{key}}.content.json',\n     *     es: false,\n     *     de: true,\n     *   },\n     * }\n     * ```\n     *\n     *\n     * Variable list:\n     *   - `fileName`: The name of the file.\n     *   - `key`: The key of the content.\n     *   - `locale`: The locale of the content.\n     *   - `extension`: The extension of the file.\n     *   - `componentFileName`: The name of the component file.\n     *   - `componentExtension`: The extension of the component file.\n     *   - `format`: The format of the dictionary.\n     *   - `componentFormat`: The format of the component dictionary.\n     *   - `componentDirPath`: The directory path of the component.\n     */\n    fill: customConfiguration?.fill ?? FILL,\n\n    /**\n     * Indicates if the content of the dictionary should be automatically transformed.\n     *\n     * Default: `false`\n     */\n    contentAutoTransformation:\n      typeof contentAutoTransformation === 'object'\n        ? {\n            markdown: contentAutoTransformation.markdown ?? false,\n            html: contentAutoTransformation.html ?? false,\n            insertion: contentAutoTransformation.insertion ?? false,\n          }\n        : contentAutoTransformation,\n\n    /**\n     * The location of the dictionary.\n     *\n     * Default: `\"local\"`\n     */\n    location: customConfiguration?.location ?? LOCATION,\n\n    /**\n     * Transform the dictionary in a per-locale dictionary.\n     * Each field declared in a per-locale dictionary will be transformed in a translation node.\n     * If missing, the dictionary will be treated as a multilingual dictionary.\n     */\n    locale: customConfiguration?.locale,\n\n    /**\n     * The title of the dictionary.\n     */\n    title: customConfiguration?.title,\n\n    /**\n     * The description of the dictionary.\n     */\n    description: customConfiguration?.description,\n\n    /**\n     * Tags to categorize the dictionaries.\n     */\n    tags: customConfiguration?.tags,\n\n    /**\n     * The priority of the dictionary.\n     */\n    priority: customConfiguration?.priority,\n\n    /**\n     * Indicates the mode of import to use for the dictionary.\n     *\n     * Available modes:\n     * - \"static\": The dictionaries are imported statically.\n     * - \"dynamic\": The dictionaries are imported dynamically in a synchronous component using the suspense API.\n     * - \"live\": The dictionaries are imported dynamically using the live sync API.\n     *\n     * Default: `\"static\"`\n     */\n    importMode: customConfiguration?.importMode ?? IMPORT_MODE,\n\n    /**\n     * The default message format for all dictionaries in the project.\n     *\n     * Default: 'intlayer'\n     */\n    format: customConfiguration?.format,\n  };\n};\n\n// ---------------------------------------------------------------------------\n// Main export\n// ---------------------------------------------------------------------------\n\n/**\n * Build the complete Intlayer configuration by merging user-supplied values\n * with defaults.\n *\n * Internally this function:\n * 1. Calls {@link buildBrowserConfiguration} to produce the browser-safe\n *    subset (internationalization, routing, editor public fields, log, metadata).\n * 2. Extends the result with full server-side fields:\n *    - `internationalization` — adds `requiredLocales` and `strictMode`.\n *    - `editor` — adds `clientId` and `clientSecret`.\n *    - `log` — adds custom log functions.\n *    - `system`, `content`, `ai`, `build`, `compiler`, `dictionary`.\n *\n * @param customConfiguration - Optional user-supplied configuration object.\n * @param baseDir - Project root directory. Defaults to `process.cwd()`.\n * @param logFunctions - Optional custom logging functions.\n * @returns A fully-built {@link IntlayerConfig}.\n */\nexport const buildConfigurationFields = (\n  customConfiguration?: CustomIntlayerConfig,\n  baseDir?: string,\n  logFunctions?: LogFunctions\n): IntlayerConfig => {\n  if (customConfiguration) {\n    const result = intlayerConfigSchema.safeParse(customConfiguration);\n\n    if (!result.success) {\n      const logError = logFunctions?.error ?? console.error;\n\n      for (const issue of result.error.issues) {\n        logError(`${issue.path.join('.')}: ${issue.message}`);\n      }\n    }\n  }\n\n  // build browser-safe config (shared defaults, no Node.js deps)\n  const browserConfig = buildBrowserConfiguration(customConfiguration);\n\n  // extend shared fields with server-only additions\n  const internationalizationConfig = buildInternationalizationFields(\n    customConfiguration?.internationalization\n  );\n\n  const editorConfig = buildEditorFields(customConfiguration?.editor);\n\n  const logConfig = buildLogFields(customConfiguration?.log, logFunctions);\n\n  // build server-only fields\n  const systemConfig = buildSystemFields(baseDir, customConfiguration?.system);\n\n  const contentConfig = buildContentFields(\n    systemConfig,\n    customConfiguration?.content\n  );\n\n  storedConfiguration = {\n    // Shared browser fields\n    routing: browserConfig.routing,\n    // Full (extended) shared fields\n    internationalization: internationalizationConfig,\n    editor: editorConfig,\n    analytics: buildAnalyticsFields(customConfiguration?.analytics),\n    log: logConfig,\n    // Server-only fields\n    system: systemConfig,\n    content: contentConfig,\n    ai: buildAiFields(customConfiguration?.ai),\n    build: buildBuildFields(customConfiguration?.build),\n    compiler: buildCompilerFields(customConfiguration?.compiler),\n    dictionary: buildDictionaryFields(customConfiguration?.dictionary),\n    plugins: customConfiguration?.plugins,\n    schemas: customConfiguration?.schemas,\n  } as IntlayerConfig;\n\n  return storedConfiguration;\n};\n"],"mappings":"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"}

package/dist/cjs/defaultValues/build.cjs

@@ -29,10 +29,14 @@ const CACHE = true;
 const TYPE_CHECKING = false;
 const MINIFY = false;
 const PURGE = false;
+const CHUNK_GROUPING = true;
+const DICTIONARIES_PRELOAD = true;
 
 //#endregion
 exports.BUILD_MODE = BUILD_MODE;
 exports.CACHE = CACHE;
+exports.CHUNK_GROUPING = CHUNK_GROUPING;
+exports.DICTIONARIES_PRELOAD = DICTIONARIES_PRELOAD;
 exports.MINIFY = MINIFY;
 exports.OPTIMIZE = OPTIMIZE;
 exports.OUTPUT_FORMAT = OUTPUT_FORMAT;

package/dist/cjs/defaultValues/build.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"build.cjs","names":[],"sources":["../../../src/defaultValues/build.ts"],"sourcesContent":["export const BUILD_MODE = 'auto';\n\nexport const OPTIMIZE = undefined;\n\nexport const TRAVERSE_PATTERN = [\n  // Included files to parse\n  '**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,astro}',\n\n  // Excluded paths\n  '!**/node_modules/**',\n  '!**/dist/**',\n  '!**/build/**',\n  '!**/.intlayer/**',\n  '!**/.next/**',\n  '!**/.nuxt/**',\n  '!**/.expo/**',\n  '!**/.vercel/**',\n  '!**/.turbo/**',\n  '!**/.tanstack/**',\n  '!**/.output/**',\n  '!**/.svelte-kit/**',\n  '!**/*.config.*',\n  '!**/*.test.*',\n  '!**/*.spec.*',\n  '!**/*.stories.*',\n  '!**/*.d.ts',\n  '!**/*.d.ts.map',\n  '!**/*.map',\n];\n\nexport const OUTPUT_FORMAT: ('cjs' | 'esm')[] = ['esm', 'cjs'];\n\nexport const CACHE = true;\n\nexport const TYPE_CHECKING = false;\n\nexport const MINIFY = false;\n\nexport const PURGE = false;\n"],"mappings":";;AAAA,MAAa,aAAa;AAE1B,MAAa,WAAW;AAExB,MAAa,mBAAmB;CAE9B;CAGA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,MAAa,gBAAmC,CAAC,OAAO,KAAK;AAE7D,MAAa,QAAQ;AAErB,MAAa,gBAAgB;AAE7B,MAAa,SAAS;AAEtB,MAAa,QAAQ"}
+{"version":3,"file":"build.cjs","names":[],"sources":["../../../src/defaultValues/build.ts"],"sourcesContent":["export const BUILD_MODE = 'auto';\n\nexport const OPTIMIZE = undefined;\n\nexport const TRAVERSE_PATTERN = [\n  // Included files to parse\n  '**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,astro}',\n\n  // Excluded paths\n  '!**/node_modules/**',\n  '!**/dist/**',\n  '!**/build/**',\n  '!**/.intlayer/**',\n  '!**/.next/**',\n  '!**/.nuxt/**',\n  '!**/.expo/**',\n  '!**/.vercel/**',\n  '!**/.turbo/**',\n  '!**/.tanstack/**',\n  '!**/.output/**',\n  '!**/.svelte-kit/**',\n  '!**/*.config.*',\n  '!**/*.test.*',\n  '!**/*.spec.*',\n  '!**/*.stories.*',\n  '!**/*.d.ts',\n  '!**/*.d.ts.map',\n  '!**/*.map',\n];\n\nexport const OUTPUT_FORMAT: ('cjs' | 'esm')[] = ['esm', 'cjs'];\n\nexport const CACHE = true;\n\nexport const TYPE_CHECKING = false;\n\nexport const MINIFY = false;\n\nexport const PURGE = false;\n\nexport const CHUNK_GROUPING = true;\n\nexport const DICTIONARIES_PRELOAD = true;\n"],"mappings":";;AAAA,MAAa,aAAa;AAE1B,MAAa,WAAW;AAExB,MAAa,mBAAmB;CAE9B;CAGA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,MAAa,gBAAmC,CAAC,OAAO,KAAK;AAE7D,MAAa,QAAQ;AAErB,MAAa,gBAAgB;AAE7B,MAAa,SAAS;AAEtB,MAAa,QAAQ;AAErB,MAAa,iBAAiB;AAE9B,MAAa,uBAAuB"}

package/dist/cjs/defaultValues/dictionary.cjs

@@ -4,10 +4,51 @@ const FILL = true;
 const LOCATION = "local";
 const CONTENT_AUTO_TRANSFORMATION = false;
 const IMPORT_MODE = "static";
+/**
+* Directory the per-locale JSON chunks of `importMode: 'dynamic'` are written
+* under, relative to `system.dynamicDictionariesDir`.
+*
+* Plain dictionaries land at `<subdir>/<key>/<locale>.json`, qualified ones
+* (collections, variants) nest one directory per dimension in between. The
+* static first segment is required by Turbopack, and build-tool plugins match
+* module ids against this layout — hence the shared constant rather than a
+* literal repeated on both sides.
+*/
+const DYNAMIC_DICTIONARIES_JSON_SUBDIR = "json";
+/**
+* Marker property carrying the ordered qualifier dimensions on a dynamic loader
+* map. Its presence distinguishes a qualified group loader map (a nested tree
+* of chunks) from a plain dynamic loader map (one chunk per `locale`). Prefixed
+* and unlikely to collide with a real locale code.
+*/
+const QUALIFIER_DYNAMIC_TYPES_KEY = "__intlayerQualifierTypes";
+/**
+* Marker property carrying the dictionary a generated dynamic entry point
+* already resolved for the browsing locale, before any component rendered.
+*
+* Build-tool plugins prepend a top-level `await` to those entry points, so the
+* chunk that statically imports one only finishes evaluating once the awaited
+* locale chunk has landed. A read during render then finds the content in place
+* instead of suspending.
+*/
+const PRELOADED_DYNAMIC_KEY = "__intlayerPreloaded";
+/**
+* Name of the local binding a generated dynamic entry point holds its loader
+* map in, before exporting it as default.
+*
+* The preload preamble is appended to that generated source and mutates the
+* binding, so the code generator and the build plugins have to agree on the
+* name — hence the shared constant rather than a literal repeated in both.
+*/
+const DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER = "content";
 
 //#endregion
 exports.CONTENT_AUTO_TRANSFORMATION = CONTENT_AUTO_TRANSFORMATION;
+exports.DYNAMIC_DICTIONARIES_JSON_SUBDIR = DYNAMIC_DICTIONARIES_JSON_SUBDIR;
+exports.DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER = DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER;
 exports.FILL = FILL;
 exports.IMPORT_MODE = IMPORT_MODE;
 exports.LOCATION = LOCATION;
+exports.PRELOADED_DYNAMIC_KEY = PRELOADED_DYNAMIC_KEY;
+exports.QUALIFIER_DYNAMIC_TYPES_KEY = QUALIFIER_DYNAMIC_TYPES_KEY;
 //# sourceMappingURL=dictionary.cjs.map

package/dist/cjs/defaultValues/dictionary.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"dictionary.cjs","names":[],"sources":["../../../src/defaultValues/dictionary.ts"],"sourcesContent":["import type { DictionaryLocation } from '@intlayer/types/dictionary';\n\nexport const FILL = true;\nexport const LOCATION: DictionaryLocation = 'local';\nexport const CONTENT_AUTO_TRANSFORMATION = false;\nexport const IMPORT_MODE = 'static';\n"],"mappings":";;AAEA,MAAa,OAAO;AACpB,MAAa,WAA+B;AAC5C,MAAa,8BAA8B;AAC3C,MAAa,cAAc"}
+{"version":3,"file":"dictionary.cjs","names":[],"sources":["../../../src/defaultValues/dictionary.ts"],"sourcesContent":["import type { DictionaryLocation } from '@intlayer/types/dictionary';\n\nexport const FILL = true;\nexport const LOCATION: DictionaryLocation = 'local';\nexport const CONTENT_AUTO_TRANSFORMATION = false;\nexport const IMPORT_MODE = 'static';\n\n/**\n * Directory the per-locale JSON chunks of `importMode: 'dynamic'` are written\n * under, relative to `system.dynamicDictionariesDir`.\n *\n * Plain dictionaries land at `<subdir>/<key>/<locale>.json`, qualified ones\n * (collections, variants) nest one directory per dimension in between. The\n * static first segment is required by Turbopack, and build-tool plugins match\n * module ids against this layout — hence the shared constant rather than a\n * literal repeated on both sides.\n */\nexport const DYNAMIC_DICTIONARIES_JSON_SUBDIR = 'json';\n\n/**\n * Marker property carrying the ordered qualifier dimensions on a dynamic loader\n * map. Its presence distinguishes a qualified group loader map (a nested tree\n * of chunks) from a plain dynamic loader map (one chunk per `locale`). Prefixed\n * and unlikely to collide with a real locale code.\n */\nexport const QUALIFIER_DYNAMIC_TYPES_KEY = '__intlayerQualifierTypes';\n\n/**\n * Marker property carrying the dictionary a generated dynamic entry point\n * already resolved for the browsing locale, before any component rendered.\n *\n * Build-tool plugins prepend a top-level `await` to those entry points, so the\n * chunk that statically imports one only finishes evaluating once the awaited\n * locale chunk has landed. A read during render then finds the content in place\n * instead of suspending.\n */\nexport const PRELOADED_DYNAMIC_KEY = '__intlayerPreloaded';\n\n/**\n * Name of the local binding a generated dynamic entry point holds its loader\n * map in, before exporting it as default.\n *\n * The preload preamble is appended to that generated source and mutates the\n * binding, so the code generator and the build plugins have to agree on the\n * name — hence the shared constant rather than a literal repeated in both.\n */\nexport const DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER = 'content';\n"],"mappings":";;AAEA,MAAa,OAAO;AACpB,MAAa,WAA+B;AAC5C,MAAa,8BAA8B;AAC3C,MAAa,cAAc;;;;;;;;;;;AAY3B,MAAa,mCAAmC;;;;;;;AAQhD,MAAa,8BAA8B;;;;;;;;;;AAW3C,MAAa,wBAAwB;;;;;;;;;AAUrC,MAAa,sCAAsC"}

package/dist/cjs/defaultValues/index.cjs

@@ -19,6 +19,7 @@ exports.BASE_PATH = require_defaultValues_routing.BASE_PATH;
 exports.BUILD_MODE = require_defaultValues_build.BUILD_MODE;
 exports.CACHE = require_defaultValues_build.CACHE;
 exports.CACHE_DIR = require_defaultValues_system.CACHE_DIR;
+exports.CHUNK_GROUPING = require_defaultValues_build.CHUNK_GROUPING;
 exports.CMS_URL = require_defaultValues_editor.CMS_URL;
 exports.CODE_DIR = require_defaultValues_content.CODE_DIR;
 exports.COMPILER_DICTIONARY_KEY_PREFIX = require_defaultValues_compiler.COMPILER_DICTIONARY_KEY_PREFIX;
@@ -31,8 +32,11 @@ exports.CONTENT_DIR = require_defaultValues_content.CONTENT_DIR;
 exports.COOKIE_NAME = require_defaultValues_routing.COOKIE_NAME;
 exports.DEFAULT_LOCALE = require_defaultValues_internationalization.DEFAULT_LOCALE;
 exports.DICTIONARIES_DIR = require_defaultValues_system.DICTIONARIES_DIR;
+exports.DICTIONARIES_PRELOAD = require_defaultValues_build.DICTIONARIES_PRELOAD;
 exports.DICTIONARY_PRIORITY_STRATEGY = require_defaultValues_editor.DICTIONARY_PRIORITY_STRATEGY;
 exports.DYNAMIC_DICTIONARIES_DIR = require_defaultValues_system.DYNAMIC_DICTIONARIES_DIR;
+exports.DYNAMIC_DICTIONARIES_JSON_SUBDIR = require_defaultValues_dictionary.DYNAMIC_DICTIONARIES_JSON_SUBDIR;
+exports.DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER = require_defaultValues_dictionary.DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER;
 exports.EDITOR_URL = require_defaultValues_editor.EDITOR_URL;
 exports.ENABLE_PROXY = require_defaultValues_routing.ENABLE_PROXY;
 exports.EXCLUDED_PATHS = require_defaultValues_content.EXCLUDED_PATHS;
@@ -57,7 +61,9 @@ exports.OPTIMIZE = require_defaultValues_build.OPTIMIZE;
 exports.OUTPUT_FORMAT = require_defaultValues_build.OUTPUT_FORMAT;
 exports.PORT = require_defaultValues_editor.PORT;
 exports.PREFIX = require_defaultValues_log.PREFIX;
+exports.PRELOADED_DYNAMIC_KEY = require_defaultValues_dictionary.PRELOADED_DYNAMIC_KEY;
 exports.PURGE = require_defaultValues_build.PURGE;
+exports.QUALIFIER_DYNAMIC_TYPES_KEY = require_defaultValues_dictionary.QUALIFIER_DYNAMIC_TYPES_KEY;
 exports.REACT_INTL_MESSAGES_DIR = require_defaultValues_content.REACT_INTL_MESSAGES_DIR;
 exports.REMOTE_DICTIONARIES_DIR = require_defaultValues_system.REMOTE_DICTIONARIES_DIR;
 exports.REQUIRED_LOCALES = require_defaultValues_internationalization.REQUIRED_LOCALES;

package/dist/cjs/dictionaryPreload.cjs

@@ -0,0 +1,149 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_defaultValues_dictionary = require('./defaultValues/dictionary.cjs');
+let node_path = require("node:path");
+
+//#region src/dictionaryPreload.ts
+/**
+* Matches a generated dynamic entry point, whose layout is
+* `<dynamicDictionariesDir>/<key>.mjs`. The per-locale JSON chunks it imports
+* live one directory deeper, under `json/`, and are deliberately excluded.
+*/
+const DYNAMIC_ENTRY_PATTERN = /\/(?<key>[^/]+)\.mjs$/;
+/** Escapes a literal path segment for embedding in a regular expression. */
+const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+/**
+* Builds a filter matching only the generated dynamic entry points, for
+* bundlers whose load hook is selected by a regular expression over the raw
+* file path (esbuild).
+*
+* A hook registered on every `.mjs` would call back into JavaScript for each
+* such file in the build, `node_modules` included, so the filter is anchored on
+* the dictionaries directory name. It matches both path separators because
+* esbuild tests the platform path, which is backslash-separated on Windows —
+* the directory name itself never contains one.
+*
+* The name alone is not proof of location, so the callback must still confirm
+* the full path lies inside `dynamicDictionariesDir`.
+*
+* @param dynamicDictionariesDir - Absolute dictionaries root, any separator.
+*/
+const createDynamicEntryFilter = (dynamicDictionariesDir) => {
+	const directoryName = dynamicDictionariesDir.split(/[\\/]/).filter(Boolean).pop() ?? "";
+	return new RegExp(`[\\\\/]${escapeRegExp(directoryName)}[\\\\/][^\\\\/]+\\.mjs$`);
+};
+/**
+* Specifier of the module the injected preamble reads the locale from, as the
+* bundler plugins are expected to resolve it.
+*
+* Never emitted as-is: a generated entry point lives in the *application's*
+* `.intlayer` directory, and an application depends on `intlayer` and its
+* framework binding — not on `@intlayer/core` — so a bare specifier would
+* resolve from a directory where the package is absent, or, worse, silently
+* hit an unrelated copy hoisted higher up the tree.
+*/
+const PRELOAD_MODULE_SPECIFIER = "@intlayer/core/localization";
+/** Package and subpath {@link PRELOAD_MODULE_SPECIFIER} is composed of. */
+const PRELOAD_PACKAGE_NAME = "@intlayer/core";
+const PRELOAD_PACKAGE_SUBPATH = "./localization";
+/**
+* Resolves {@link PRELOAD_MODULE_SPECIFIER} to an absolute id the injected
+* preamble can import, from a package that actually depends on it.
+*
+* Deliberately not `require.resolve(PRELOAD_MODULE_SPECIFIER)`: that applies
+* the `require` condition and lands on the package's CommonJS build, which the
+* preamble would then pull into a *browser* bundle behind a CommonJS interop
+* wrapper — a second copy of the module alongside the ESM one the application
+* already imports, each with its own memoized locale. The manifest is resolved
+* instead (a condition-free subpath) and its `import` entry read directly.
+*
+* @param requireFn - `require`, or `createRequire(import.meta.url)`, from the
+*   plugin package.
+* @returns Absolute path to the ESM build, falling back to whatever the
+*   standard resolution yields if the package ever stops publishing one.
+*/
+const resolvePreloadModuleId = (requireFn) => {
+	const manifestPath = requireFn.resolve(`${PRELOAD_PACKAGE_NAME}/package.json`);
+	const subpathExport = requireFn(manifestPath).exports?.[PRELOAD_PACKAGE_SUBPATH];
+	const esmEntry = typeof subpathExport === "string" ? subpathExport : subpathExport?.import;
+	if (!esmEntry) return requireFn.resolve(PRELOAD_MODULE_SPECIFIER);
+	return (0, node_path.resolve)((0, node_path.dirname)(manifestPath), esmEntry);
+};
+/**
+* Builds the import the injected preamble relies on, hoisted ahead of the
+* generated source.
+*
+* @param preloadModuleId - Specifier resolving to {@link PRELOAD_MODULE_SPECIFIER}
+*   from the plugin package, which does depend on it.
+*/
+const buildPreloadImport = (preloadModuleId) => `import { getPreloadLocale as __intlayerGetPreloadLocale } from '${preloadModuleId}';\n`;
+/**
+* Preamble appended to a generated dynamic entry point.
+*
+* The load is started while the entry point evaluates, but is deliberately
+* *not* awaited at the top level. Awaiting would make the entry point an async
+* module, which delays the resolution of every chunk that statically imports
+* it — including the chunks behind a `React.lazy` boundary. A boundary whose
+* module resolves that late during hydration stays on its fallback for good:
+* the framework has already swapped the server markup for the pending state and
+* does not retry, so the section never appears. Starting the request here and
+* letting the reader pick the result up keeps the whole benefit of the early
+* fetch without ever holding up module evaluation.
+*
+* The gain is in *when* the request starts: it leaves as soon as the chunk that
+* needs the dictionary is evaluated — on a router's `import()` of a route,
+* including a preload on hover — rather than once the consuming component
+* renders. By the time the reader runs, the marker is usually already set and
+* the read is synchronous, so no loading state is revealed.
+*
+* Only the resolved locale is requested, so a page still downloads exactly the
+* language it renders.
+*
+* A failed load is swallowed: leaving the marker unset drops the read back onto
+* the asynchronous path, where the existing loading state surfaces the error.
+*/
+const PRELOAD_PREAMBLE = [
+	"",
+	"// Injected by Intlayer: starts the browsing locale load with this module.",
+	"const __intlayerLocale = __intlayerGetPreloadLocale();",
+	`const __intlayerLoader = ${require_defaultValues_dictionary.DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER}[__intlayerLocale];`,
+	"",
+	`if (typeof window !== 'undefined' && typeof __intlayerLoader === 'function') {`,
+	"  __intlayerLoader().then(",
+	"    (__intlayerDictionary) => {",
+	`      ${require_defaultValues_dictionary.DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER}['${require_defaultValues_dictionary.PRELOADED_DYNAMIC_KEY}'] = {`,
+	"        locale: __intlayerLocale,",
+	"        dictionary: __intlayerDictionary,",
+	"      };",
+	"    },",
+	"    () => undefined",
+	"  );",
+	"}",
+	""
+].join("\n");
+/**
+* Adds the browsing-locale preload to a generated dynamic entry point.
+*
+* Bundler-agnostic on purpose: the Vite plugin and the esbuild plugin apply the
+* identical transform, and keeping one implementation means the emitted shape
+* cannot drift between them. The caller decides *which* modules to hand over
+* (the id is matched against the dynamic dictionaries directory) and how to
+* report a skip.
+*
+* @param code - Source of the generated `<key>.mjs` entry point.
+* @param preloadModuleId - Specifier the preamble imports the locale resolver
+*   from, already resolved against the plugin package.
+* @returns The transformed source, or the reason it was left alone.
+*/
+const addDynamicEntryPreload = (code, preloadModuleId) => {
+	if (code.includes("__intlayerQualifierTypes")) return { skipped: "qualified" };
+	if (!code.includes(`const ${"content"} =`)) return { skipped: "unrecognized-shape" };
+	return { code: buildPreloadImport(preloadModuleId) + code + PRELOAD_PREAMBLE };
+};
+
+//#endregion
+exports.DYNAMIC_ENTRY_PATTERN = DYNAMIC_ENTRY_PATTERN;
+exports.PRELOAD_MODULE_SPECIFIER = PRELOAD_MODULE_SPECIFIER;
+exports.addDynamicEntryPreload = addDynamicEntryPreload;
+exports.createDynamicEntryFilter = createDynamicEntryFilter;
+exports.resolvePreloadModuleId = resolvePreloadModuleId;
+//# sourceMappingURL=dictionaryPreload.cjs.map

package/dist/cjs/dictionaryPreload.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictionaryPreload.cjs","names":["resolve","dirname","DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER","PRELOADED_DYNAMIC_KEY"],"sources":["../../src/dictionaryPreload.ts"],"sourcesContent":["import { dirname, resolve } from 'node:path';\nimport {\n  DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER,\n  PRELOADED_DYNAMIC_KEY,\n  QUALIFIER_DYNAMIC_TYPES_KEY,\n} from './defaultValues/dictionary';\n\n/**\n * Matches a generated dynamic entry point, whose layout is\n * `<dynamicDictionariesDir>/<key>.mjs`. The per-locale JSON chunks it imports\n * live one directory deeper, under `json/`, and are deliberately excluded.\n */\nexport const DYNAMIC_ENTRY_PATTERN = /\\/(?<key>[^/]+)\\.mjs$/;\n\n/** Escapes a literal path segment for embedding in a regular expression. */\nconst escapeRegExp = (value: string): string =>\n  value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n\n/**\n * Builds a filter matching only the generated dynamic entry points, for\n * bundlers whose load hook is selected by a regular expression over the raw\n * file path (esbuild).\n *\n * A hook registered on every `.mjs` would call back into JavaScript for each\n * such file in the build, `node_modules` included, so the filter is anchored on\n * the dictionaries directory name. It matches both path separators because\n * esbuild tests the platform path, which is backslash-separated on Windows —\n * the directory name itself never contains one.\n *\n * The name alone is not proof of location, so the callback must still confirm\n * the full path lies inside `dynamicDictionariesDir`.\n *\n * @param dynamicDictionariesDir - Absolute dictionaries root, any separator.\n */\nexport const createDynamicEntryFilter = (\n  dynamicDictionariesDir: string\n): RegExp => {\n  const directoryName =\n    dynamicDictionariesDir.split(/[\\\\/]/).filter(Boolean).pop() ?? '';\n\n  return new RegExp(\n    `[\\\\\\\\/]${escapeRegExp(directoryName)}[\\\\\\\\/][^\\\\\\\\/]+\\\\.mjs$`\n  );\n};\n\n/**\n * Specifier of the module the injected preamble reads the locale from, as the\n * bundler plugins are expected to resolve it.\n *\n * Never emitted as-is: a generated entry point lives in the *application's*\n * `.intlayer` directory, and an application depends on `intlayer` and its\n * framework binding — not on `@intlayer/core` — so a bare specifier would\n * resolve from a directory where the package is absent, or, worse, silently\n * hit an unrelated copy hoisted higher up the tree.\n */\nexport const PRELOAD_MODULE_SPECIFIER = '@intlayer/core/localization';\n\n/** Package and subpath {@link PRELOAD_MODULE_SPECIFIER} is composed of. */\nconst PRELOAD_PACKAGE_NAME = '@intlayer/core';\nconst PRELOAD_PACKAGE_SUBPATH = './localization';\n\n/** The subset of a `package.json` this resolution reads. */\ntype PackageManifest = {\n  exports?: Record<string, { import?: string } | string | undefined>;\n};\n\n/**\n * Resolves {@link PRELOAD_MODULE_SPECIFIER} to an absolute id the injected\n * preamble can import, from a package that actually depends on it.\n *\n * Deliberately not `require.resolve(PRELOAD_MODULE_SPECIFIER)`: that applies\n * the `require` condition and lands on the package's CommonJS build, which the\n * preamble would then pull into a *browser* bundle behind a CommonJS interop\n * wrapper — a second copy of the module alongside the ESM one the application\n * already imports, each with its own memoized locale. The manifest is resolved\n * instead (a condition-free subpath) and its `import` entry read directly.\n *\n * @param requireFn - `require`, or `createRequire(import.meta.url)`, from the\n *   plugin package.\n * @returns Absolute path to the ESM build, falling back to whatever the\n *   standard resolution yields if the package ever stops publishing one.\n */\nexport const resolvePreloadModuleId = (requireFn: NodeRequire): string => {\n  const manifestPath = requireFn.resolve(\n    `${PRELOAD_PACKAGE_NAME}/package.json`\n  );\n  const manifest = requireFn(manifestPath) as PackageManifest;\n  const subpathExport = manifest.exports?.[PRELOAD_PACKAGE_SUBPATH];\n\n  const esmEntry =\n    typeof subpathExport === 'string' ? subpathExport : subpathExport?.import;\n\n  if (!esmEntry) return requireFn.resolve(PRELOAD_MODULE_SPECIFIER);\n\n  return resolve(dirname(manifestPath), esmEntry);\n};\n\n/**\n * Builds the import the injected preamble relies on, hoisted ahead of the\n * generated source.\n *\n * @param preloadModuleId - Specifier resolving to {@link PRELOAD_MODULE_SPECIFIER}\n *   from the plugin package, which does depend on it.\n */\nconst buildPreloadImport = (preloadModuleId: string): string =>\n  `import { getPreloadLocale as __intlayerGetPreloadLocale } from '${preloadModuleId}';\\n`;\n\n/**\n * Preamble appended to a generated dynamic entry point.\n *\n * The load is started while the entry point evaluates, but is deliberately\n * *not* awaited at the top level. Awaiting would make the entry point an async\n * module, which delays the resolution of every chunk that statically imports\n * it — including the chunks behind a `React.lazy` boundary. A boundary whose\n * module resolves that late during hydration stays on its fallback for good:\n * the framework has already swapped the server markup for the pending state and\n * does not retry, so the section never appears. Starting the request here and\n * letting the reader pick the result up keeps the whole benefit of the early\n * fetch without ever holding up module evaluation.\n *\n * The gain is in *when* the request starts: it leaves as soon as the chunk that\n * needs the dictionary is evaluated — on a router's `import()` of a route,\n * including a preload on hover — rather than once the consuming component\n * renders. By the time the reader runs, the marker is usually already set and\n * the read is synchronous, so no loading state is revealed.\n *\n * Only the resolved locale is requested, so a page still downloads exactly the\n * language it renders.\n *\n * A failed load is swallowed: leaving the marker unset drops the read back onto\n * the asynchronous path, where the existing loading state surfaces the error.\n */\nconst PRELOAD_PREAMBLE = [\n  '',\n  '// Injected by Intlayer: starts the browsing locale load with this module.',\n  'const __intlayerLocale = __intlayerGetPreloadLocale();',\n  `const __intlayerLoader = ${DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER}[__intlayerLocale];`,\n  '',\n  `if (typeof window !== 'undefined' && typeof __intlayerLoader === 'function') {`,\n  '  __intlayerLoader().then(',\n  '    (__intlayerDictionary) => {',\n  `      ${DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER}['${PRELOADED_DYNAMIC_KEY}'] = {`,\n  '        locale: __intlayerLocale,',\n  '        dictionary: __intlayerDictionary,',\n  '      };',\n  '    },',\n  '    () => undefined',\n  '  );',\n  '}',\n  '',\n].join('\\n');\n\n/** Why a generated entry point was left untransformed. */\nexport type PreloadSkipReason = 'qualified' | 'unrecognized-shape';\n\nexport type PreloadTransformResult =\n  | { code: string; skipped?: undefined }\n  | { code?: undefined; skipped: PreloadSkipReason };\n\n/**\n * Adds the browsing-locale preload to a generated dynamic entry point.\n *\n * Bundler-agnostic on purpose: the Vite plugin and the esbuild plugin apply the\n * identical transform, and keeping one implementation means the emitted shape\n * cannot drift between them. The caller decides *which* modules to hand over\n * (the id is matched against the dynamic dictionaries directory) and how to\n * report a skip.\n *\n * @param code - Source of the generated `<key>.mjs` entry point.\n * @param preloadModuleId - Specifier the preamble imports the locale resolver\n *   from, already resolved against the plugin package.\n * @returns The transformed source, or the reason it was left alone.\n */\nexport const addDynamicEntryPreload = (\n  code: string,\n  preloadModuleId: string\n): PreloadTransformResult => {\n  // Qualified entry points (collections, variants) expose a nested tree of\n  // loaders per locale rather than one loader, so preloading them would have to\n  // guess which coordinate the call site targets — and would fetch every chunk\n  // to avoid guessing wrong.\n  if (code.includes(QUALIFIER_DYNAMIC_TYPES_KEY)) {\n    return { skipped: 'qualified' };\n  }\n\n  // The preamble mutates the generated binding; if the code generator ever\n  // stops emitting it, skipping keeps the build correct (and merely\n  // unoptimized) instead of emitting a reference error.\n  if (!code.includes(`const ${DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER} =`)) {\n    return { skipped: 'unrecognized-shape' };\n  }\n\n  return {\n    code: buildPreloadImport(preloadModuleId) + code + PRELOAD_PREAMBLE,\n  };\n};\n"],"mappings":";;;;;;;;;;AAYA,MAAa,wBAAwB;;AAGrC,MAAM,gBAAgB,UACpB,MAAM,QAAQ,uBAAuB,MAAM;;;;;;;;;;;;;;;;;AAkB7C,MAAa,4BACX,2BACW;CACX,MAAM,gBACJ,uBAAuB,MAAM,OAAO,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,IAAI,KAAK;CAEjE,OAAO,IAAI,OACT,UAAU,aAAa,aAAa,EAAE,wBACxC;AACF;;;;;;;;;;;AAYA,MAAa,2BAA2B;;AAGxC,MAAM,uBAAuB;AAC7B,MAAM,0BAA0B;;;;;;;;;;;;;;;;;AAuBhC,MAAa,0BAA0B,cAAmC;CACxE,MAAM,eAAe,UAAU,QAC7B,GAAG,qBAAqB,cAC1B;CAEA,MAAM,gBADW,UAAU,YACE,CAAC,CAAC,UAAU;CAEzC,MAAM,WACJ,OAAO,kBAAkB,WAAW,gBAAgB,eAAe;CAErE,IAAI,CAAC,UAAU,OAAO,UAAU,QAAQ,wBAAwB;CAEhE,WAAOA,uBAAQC,mBAAQ,YAAY,GAAG,QAAQ;AAChD;;;;;;;;AASA,MAAM,sBAAsB,oBAC1B,mEAAmE,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BrF,MAAM,mBAAmB;CACvB;CACA;CACA;CACA,4BAA4BC,qEAAoC;CAChE;CACA;CACA;CACA;CACA,SAASA,qEAAoC,IAAIC,uDAAsB;CACvE;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC,CAAC,KAAK,IAAI;;;;;;;;;;;;;;;AAuBX,MAAa,0BACX,MACA,oBAC2B;CAK3B,IAAI,KAAK,mCAAoC,GAC3C,OAAO,EAAE,SAAS,YAAY;CAMhC,IAAI,CAAC,KAAK,SAAS,mBAA6C,GAAG,GACjE,OAAO,EAAE,SAAS,qBAAqB;CAGzC,OAAO,EACL,MAAM,mBAAmB,eAAe,IAAI,OAAO,iBACrD;AACF"}

package/dist/esm/bundle/index.mjs

@@ -1,7 +1,7 @@
 import { getAlias } from "../utils/alias.mjs";
 import { getConfiguration } from "../configFile/getConfiguration.mjs";
-import { BundleLogger } from "./logBundle.mjs";
 import { getConfigEnvVars } from "../envVars/envVars.mjs";
+import { BundleLogger } from "./logBundle.mjs";
 import { isAbsolute, join, resolve } from "node:path";
 import { mkdir, rm, writeFile } from "node:fs/promises";
 import configPackageJson from "@intlayer/types/package.json" with { type: "json" };

package/dist/esm/configFile/buildConfigurationFields.mjs

@@ -1,5 +1,5 @@
 import { __require } from "../_virtual/_rolldown/runtime.mjs";
-import { BUILD_MODE, CACHE, MINIFY, OUTPUT_FORMAT, PURGE, TRAVERSE_PATTERN, TYPE_CHECKING } from "../defaultValues/build.mjs";
+import { BUILD_MODE, CACHE, CHUNK_GROUPING, DICTIONARIES_PRELOAD, MINIFY, OUTPUT_FORMAT, PURGE, TRAVERSE_PATTERN, TYPE_CHECKING } from "../defaultValues/build.mjs";
 import { COMPILER_DICTIONARY_KEY_PREFIX, COMPILER_ENABLED, COMPILER_NO_METADATA, COMPILER_SAVE_COMPONENTS } from "../defaultValues/compiler.mjs";
 import { CODE_DIR, CONTENT_DIR, EXCLUDED_PATHS, FILE_EXTENSIONS, WATCH } from "../defaultValues/content.mjs";
 import { CONTENT_AUTO_TRANSFORMATION, FILL, IMPORT_MODE, LOCATION } from "../defaultValues/dictionary.mjs";
@@ -256,6 +256,30 @@ const buildBuildFields = (customConfiguration) => ({
 	*/
 	purge: customConfiguration?.purge ?? false,
 	/**
+	* Group the per-locale dictionary chunks by the code-split boundary that uses
+	* them, so a lazily loaded page fetches its content in one request.
+	*
+	* Default: true
+	*
+	* Note:
+	* - Only applies to dictionaries using `importMode: 'dynamic'`.
+	* - Only applies to the client build, and only when bundling (not in dev).
+	*/
+	chunkGrouping: customConfiguration?.chunkGrouping ?? true,
+	/**
+	* Load a dictionary together with the chunk that uses it, instead of fetching
+	* it once that chunk renders — so a reader renders synchronously rather than
+	* suspending, and navigating no longer flashes a loading state.
+	*
+	* Default: true
+	*
+	* Note:
+	* - Only applies to dictionaries using `importMode: 'dynamic'`.
+	* - Only applies to the client build; the server keeps loading on demand.
+	* - Requires a bundler supporting top-level await (Vite, esbuild).
+	*/
+	dictionariesPreload: customConfiguration?.dictionariesPreload ?? true,
+	/**
 	* Pattern to traverse the code to optimize.
 	*
 	* Allows to avoid to traverse the code that is not relevant to the optimization.

package/dist/esm/configFile/buildConfigurationFields.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"buildConfigurationFields.mjs","names":[],"sources":["../../../src/configFile/buildConfigurationFields.ts"],"sourcesContent":["import { statSync } from 'node:fs';\nimport { dirname, isAbsolute, join } from 'node:path';\nimport type {\n  AiConfig,\n  BuildConfig,\n  CompilerConfig,\n  ContentConfig,\n  CustomIntlayerConfig,\n  DictionaryConfig,\n  IntlayerConfig,\n  LogFunctions,\n  SystemConfig,\n} from '@intlayer/types/config';\nimport {\n  BUILD_MODE,\n  CACHE,\n  MINIFY,\n  OUTPUT_FORMAT,\n  PURGE,\n  TRAVERSE_PATTERN,\n  TYPE_CHECKING,\n} from '../defaultValues/build';\nimport {\n  COMPILER_DICTIONARY_KEY_PREFIX,\n  COMPILER_ENABLED,\n  COMPILER_NO_METADATA,\n  COMPILER_SAVE_COMPONENTS,\n} from '../defaultValues/compiler';\nimport {\n  CODE_DIR,\n  CONTENT_DIR,\n  EXCLUDED_PATHS,\n  FILE_EXTENSIONS,\n  WATCH,\n} from '../defaultValues/content';\nimport {\n  CONTENT_AUTO_TRANSFORMATION,\n  FILL,\n  IMPORT_MODE,\n  LOCATION,\n} from '../defaultValues/dictionary';\nimport {\n  CACHE_DIR,\n  CONFIG_DIR,\n  DICTIONARIES_DIR,\n  DYNAMIC_DICTIONARIES_DIR,\n  FETCH_DICTIONARIES_DIR,\n  MAIN_DIR,\n  MODULE_AUGMENTATION_DIR,\n  REMOTE_DICTIONARIES_DIR,\n  TEMP_DIR,\n  TYPES_DIR,\n  UNMERGED_DICTIONARIES_DIR,\n} from '../defaultValues/system';\nimport { getProjectRequire } from '../utils';\nimport {\n  buildAnalyticsFields,\n  buildBrowserConfiguration,\n  buildEditorFields,\n  buildInternationalizationFields,\n  buildLogFields,\n} from './buildBrowserConfiguration';\nimport { intlayerConfigSchema } from './configurationSchema';\n\nexport {\n  type BrowserIntlayerConfig,\n  buildAnalyticsFields,\n  buildBrowserConfiguration,\n  buildEditorFields,\n  buildInternationalizationFields,\n  buildLogFields,\n  buildRoutingFields,\n  extractBrowserConfiguration,\n} from './buildBrowserConfiguration';\n\nlet storedConfiguration: IntlayerConfig;\n\n// ---------------------------------------------------------------------------\n// Server-only field builders (Node.js — not browser-safe)\n// ---------------------------------------------------------------------------\n\n/**\n * Build the `system` section of the Intlayer configuration.\n *\n * Resolves all directory paths (dictionaries, types, cache, …) relative to\n * the project base directory, using Node.js `require.resolve` where available\n * and falling back to `path.join` otherwise.\n *\n * @param baseDir - Project root directory. Defaults to `process.cwd()`.\n * @param customConfiguration - Partial user-supplied system config.\n * @returns A fully-resolved {@link SystemConfig}.\n */\nconst buildSystemFields = (\n  baseDir?: string,\n  customConfiguration?: Partial<SystemConfig>\n): SystemConfig => {\n  const projectBaseDir = baseDir ?? process.cwd();\n\n  const optionalJoinBaseDir = (pathInput: string) => {\n    let absolutePath: string;\n\n    try {\n      const requireFunction = getProjectRequire(projectBaseDir);\n      try {\n        absolutePath = requireFunction.resolve(pathInput, {\n          paths: [projectBaseDir],\n        });\n      } catch (err) {\n        if (!pathInput.startsWith('.') && !isAbsolute(pathInput)) {\n          absolutePath = requireFunction.resolve(`${pathInput}/package.json`, {\n            paths: [projectBaseDir],\n          });\n        } else {\n          throw err;\n        }\n      }\n    } catch {\n      absolutePath = isAbsolute(pathInput)\n        ? pathInput\n        : join(projectBaseDir, pathInput);\n    }\n\n    try {\n      const stats = statSync(absolutePath);\n      if (stats.isFile()) {\n        return dirname(absolutePath);\n      }\n    } catch {\n      if (/\\.[a-z0-9]+$/i.test(absolutePath)) {\n        return dirname(absolutePath);\n      }\n    }\n\n    return absolutePath;\n  };\n\n  const dictionariesDir = optionalJoinBaseDir(\n    customConfiguration?.dictionariesDir ?? DICTIONARIES_DIR\n  );\n\n  return {\n    baseDir: projectBaseDir,\n    moduleAugmentationDir: optionalJoinBaseDir(\n      customConfiguration?.moduleAugmentationDir ?? MODULE_AUGMENTATION_DIR\n    ),\n    unmergedDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.unmergedDictionariesDir ?? UNMERGED_DICTIONARIES_DIR\n    ),\n    remoteDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.remoteDictionariesDir ?? REMOTE_DICTIONARIES_DIR\n    ),\n    dictionariesDir,\n    dynamicDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.dynamicDictionariesDir ?? DYNAMIC_DICTIONARIES_DIR\n    ),\n    fetchDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.fetchDictionariesDir ?? FETCH_DICTIONARIES_DIR\n    ),\n    typesDir: optionalJoinBaseDir(customConfiguration?.typesDir ?? TYPES_DIR),\n    mainDir: optionalJoinBaseDir(customConfiguration?.mainDir ?? MAIN_DIR),\n    configDir: optionalJoinBaseDir(\n      customConfiguration?.configDir ?? CONFIG_DIR\n    ),\n    cacheDir: optionalJoinBaseDir(customConfiguration?.cacheDir ?? CACHE_DIR),\n    tempDir: optionalJoinBaseDir(customConfiguration?.tempDir ?? TEMP_DIR),\n  };\n};\n\n/**\n * Build the `content` section of the Intlayer configuration.\n *\n * Resolves content and code directories relative to the project base using\n * `require.resolve`, falling back to `path.join`.\n *\n * @param systemConfig - Already-built system configuration (provides `baseDir`).\n * @param customConfiguration - Partial user-supplied content config.\n * @returns A fully-resolved {@link ContentConfig}.\n */\nconst buildContentFields = (\n  systemConfig: SystemConfig,\n  customConfiguration?: Partial<ContentConfig>\n): ContentConfig => {\n  const fileExtensions = customConfiguration?.fileExtensions ?? FILE_EXTENSIONS;\n\n  const optionalJoinBaseDir = (pathInput: string) => {\n    let absolutePath: string;\n\n    try {\n      const requireFunction = getProjectRequire(systemConfig.baseDir);\n      try {\n        absolutePath = requireFunction.resolve(pathInput, {\n          paths: [systemConfig.baseDir],\n        });\n      } catch (err) {\n        if (!pathInput.startsWith('.') && !isAbsolute(pathInput)) {\n          absolutePath = requireFunction.resolve(`${pathInput}/package.json`, {\n            paths: [systemConfig.baseDir],\n          });\n        } else {\n          throw err;\n        }\n      }\n    } catch {\n      try {\n        try {\n          absolutePath = require.resolve(pathInput, {\n            paths: [systemConfig.baseDir],\n          });\n        } catch (err) {\n          if (!pathInput.startsWith('.') && !isAbsolute(pathInput)) {\n            absolutePath = require.resolve(`${pathInput}/package.json`, {\n              paths: [systemConfig.baseDir],\n            });\n          } else {\n            throw err;\n          }\n        }\n      } catch {\n        absolutePath = isAbsolute(pathInput)\n          ? pathInput\n          : join(systemConfig.baseDir, pathInput);\n      }\n    }\n\n    try {\n      const stats = statSync(absolutePath);\n      if (stats.isFile()) {\n        return dirname(absolutePath);\n      }\n    } catch {\n      if (/\\.[a-z0-9]+$/i.test(absolutePath)) {\n        return dirname(absolutePath);\n      }\n    }\n\n    return absolutePath;\n  };\n\n  const contentDir = (customConfiguration?.contentDir ?? CONTENT_DIR).map(\n    optionalJoinBaseDir\n  );\n  const codeDir = (customConfiguration?.codeDir ?? CODE_DIR).map(\n    optionalJoinBaseDir\n  );\n\n  return {\n    fileExtensions,\n    contentDir,\n    codeDir,\n    excludedPath: customConfiguration?.excludedPath ?? EXCLUDED_PATHS,\n    watch: customConfiguration?.watch ?? WATCH,\n    formatCommand: customConfiguration?.formatCommand,\n  };\n};\n\n/**\n * Build the `ai` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied AI config.\n * @returns A fully-defaulted {@link AiConfig}.\n */\nconst buildAiFields = (customConfiguration?: Partial<AiConfig>): AiConfig => ({\n  /**\n   * AI configuration\n   */\n  provider: customConfiguration?.provider,\n\n  /**\n   * API key\n   */\n  apiKey: customConfiguration?.apiKey,\n\n  /**\n   * API model\n   */\n  model: customConfiguration?.model,\n\n  /**\n   * Temperature\n   */\n  temperature: customConfiguration?.temperature,\n\n  /**\n   * Application context\n   *\n   * Default: undefined\n   *\n   * The application context.\n   *\n   * Example: `'My application context'`\n   *\n   * Note: Can be used to provide additional context about the application to the AI model. You can add more rules (e.g. \"You should not transform urls\").\n   */\n  applicationContext: customConfiguration?.applicationContext,\n\n  /**\n   * Base URL for the AI API\n   *\n   * Default: undefined\n   *\n   * The base URL for the AI API.\n   *\n   * Example: `'http://localhost:5000'`\n   *\n   * Note: Can be used to point to a local, or custom AI API endpoint.\n   */\n  baseURL: customConfiguration?.baseURL,\n\n  /**\n   * Data serialization\n   *\n   * Options:\n   * - \"json\": The industry standard. Highly reliable and structured, but consumes more tokens.\n   * - \"toon\": An optimized format designed to reduce token consumption (cost-effective). However, it may slightly increase the risk of output inconsistency compared to standard JSON\n   *\n   * Default: `\"json\"`\n   */\n  dataSerialization: customConfiguration?.dataSerialization,\n});\n\n/**\n * Build the `build` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied build config.\n * @returns A fully-defaulted {@link BuildConfig}.\n */\nconst buildBuildFields = (\n  customConfiguration?: Partial<BuildConfig>\n): BuildConfig => ({\n  /**\n   * Indicates the mode of the build\n   *\n   * Default: 'auto'\n   *\n   * If 'auto', the build will be enabled automatically when the application is built.\n   * If 'manual', the build will be set only when the build command is executed.\n   *\n   * Can be used to disable dictionaries build, for instance when execution on Node.js environment should be avoided.\n   */\n  mode: customConfiguration?.mode ?? BUILD_MODE,\n\n  /**\n   * Indicates if the build should be optimized\n   *\n   * Default: process.env.NODE_ENV === 'production'\n   *\n   * If true, the build will be optimized.\n   * If false, the build will not be optimized.\n   *\n   * Intlayer will replace all calls of dictionaries to optimize chunking. That way the final bundle will import only the dictionaries that are used.\n   * All imports will stay as static import to avoid async processing when loading the dictionaries.\n   *\n   * Note:\n   * - Intlayer will replace all call of `useIntlayer` with the defined mode by the `importMode` option.\n   * - Intlayer will replace all call of `getIntlayer` with `getDictionary`.\n   * - This option relies on the `@intlayer/babel` and `@intlayer/swc` plugins.\n   * - In most cases, \"dynamic\" will be used for React applications, \"async\" for Vue.js applications.\n   * - Ensure all keys are declared statically in the `useIntlayer` calls. e.g. `useIntlayer('navbar')`.\n   */\n  optimize: customConfiguration?.optimize,\n\n  /**\n   * Indicates the mode of import to use for the dictionaries.\n   *\n   * Available modes:\n   * - \"static\": The dictionaries are imported statically.\n   *   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionary`.\n   * - \"dynamic\": The dictionaries are imported dynamically in a synchronous component using the suspense API.\n   *   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionaryDynamic`.\n   * - \"live\": The dictionaries are imported dynamically using the live sync API.\n   *   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionaryDynamic`.\n   *   Live mode will use the live sync API to fetch the dictionaries. If the API call fails, the dictionaries will be imported dynamically as \"dynamic\" mode.\n   *\n   * Default: \"static\"\n   *\n   * By default, when a dictionary is loaded, it imports content for all locales as it's imported statically.\n   *\n   * Note:\n   * - Dynamic imports rely on Suspense and may slightly impact rendering performance.\n   * - If disabled all locales will be loaded at once, even if they are not used.\n   * - This option relies on the `@intlayer/babel` and `@intlayer/swc` plugins.\n   * - Ensure all keys are declared statically in the `useIntlayer` calls. e.g. `useIntlayer('navbar')`.\n   * - This option will be ignored if `optimize` is disabled.\n   * - This option will not impact the `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` and `useDictionaryDynamic` functions. You can still use them to refine you code on manual optimization.\n   * - The \"live\" allows to sync the dictionaries to the live sync server.\n   *\n   * @deprecated Use `dictionary.importMode` instead.\n   */\n  importMode: customConfiguration?.importMode,\n\n  /**\n   * Minify the dictionaries to reduce the bundle size.\n   *\n   * Default: false\n   *\n   * Note:\n   * - This option will be ignored if `optimize` is disabled.\n   * - This option will be ignore if `editor.enabled` is true.\n   * - If there is edge cases where the minification is not working properly, the dictionary will be not minified.\n   */\n  minify: customConfiguration?.minify ?? MINIFY,\n\n  /**\n   * Purge the unused keys in a dictionaries\n   *\n   * Default: false\n   *\n   * Note:\n   * - This option will be ignored if `optimize` is disabled.\n   * - This option will be ignored if `editor.enabled` is true.\n   */\n  purge: customConfiguration?.purge ?? PURGE,\n\n  /**\n   * Pattern to traverse the code to optimize.\n   *\n   * Allows to avoid to traverse the code that is not relevant to the optimization.\n   * Improve build performance.\n   *\n   * Default: ['**\\/*.{js,ts,mjs,cjs,jsx,tsx}', '!**\\/node_modules/**']\n   *\n   * Example: `['src/**\\/*.{ts,tsx}', '../ui-library/**\\/*.{ts,tsx}']`\n   *\n   * Note:\n   * - This option will be ignored if `optimize` is disabled.\n   * - Use glob pattern.\n   */\n  traversePattern: customConfiguration?.traversePattern ?? TRAVERSE_PATTERN,\n\n  /**\n   * Output format of the dictionaries\n   *\n   * Can be set on large projects to improve build performance.\n   *\n   * Default: ['cjs', 'esm']\n   *\n   * The output format of the dictionaries. It can be either 'cjs' or 'esm'.\n   * - 'cjs': The dictionaries are outputted as CommonJS modules.\n   * - 'esm': The dictionaries are outputted as ES modules.\n   */\n  outputFormat: customConfiguration?.outputFormat ?? OUTPUT_FORMAT,\n\n  /**\n   * Cache\n   */\n  cache: customConfiguration?.cache ?? CACHE,\n\n  /**\n   * Require function\n   */\n  require: customConfiguration?.require,\n\n  /**\n   * Indicates if the build should check TypeScript types\n   *\n   * Default: `false`\n   *\n   * If true, the build will check TypeScript types and log errors.\n   * Note: This can slow down the build.\n   */\n  checkTypes: customConfiguration?.checkTypes ?? TYPE_CHECKING,\n});\n\n/**\n * Build the `compiler` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied compiler config.\n * @returns A fully-defaulted {@link CompilerConfig}.\n */\nconst buildCompilerFields = (\n  customConfiguration?: Partial<CompilerConfig>\n): CompilerConfig => ({\n  /**\n   * Indicates if the compiler should be enabled\n   */\n  enabled: customConfiguration?.enabled ?? COMPILER_ENABLED,\n\n  /**\n   * Prefix for the extracted dictionary keys\n   */\n  dictionaryKeyPrefix:\n    customConfiguration?.dictionaryKeyPrefix ?? COMPILER_DICTIONARY_KEY_PREFIX,\n\n  /**\n   * Pattern to traverse the code to optimize.\n   *\n   * @deprecated use `build.traversePattern` instead\n   */\n  transformPattern: customConfiguration?.transformPattern,\n\n  /**\n   * Pattern to exclude from the optimization.\n   *\n   * @deprecated use `build.traversePattern` instead\n   */\n  excludePattern: customConfiguration?.excludePattern,\n\n  /**\n   * Defines the output files path. Replaces `outputDir`.\n   *\n   * - `./` paths are resolved relative to the component directory.\n   * - `/` paths are resolved relative to the project root (`baseDir`).\n   *\n   * - Including the `{{locale}}` variable in the path will trigger the generation of separate dictionaries per locale.\n   *\n   * @example:\n   * ```ts\n   * {\n   *   // Create Multilingual .content.ts files close to the component\n   *   output: ({ fileName, extension }) => `./${fileName}${extension}`,\n   *\n   *   // output: './{{fileName}}{{extension}}', // Equivalent using template string\n   * }\n   * ```\n   *\n   * ```ts\n   * {\n   *   // Create centralize per-locale JSON at the root of the project\n   *   output: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,\n   *\n   *   // output: '/locales/{{locale}}/{{key}}.content.json', // Equivalent using template string\n   * }\n   * ```\n   *\n   * ```ts\n   * {\n   *   // Create per-locale JSON files with locale-specific output paths\n   *   output: {\n   *     en: ({ fileName, locale }) => `${fileName}.${locale}.content.json`,\n   *     fr: '{{fileName}}.{{locale}}.content.json',\n   *     es: false, // skip this locale\n   *   },\n   * }\n   * ```\n   *\n   * Variable list:\n   *   - `fileName`: The name of the file.\n   *   - `key`: The key of the content.\n   *   - `locale`: The locale of the content.\n   *   - `extension`: The extension of the file.\n   *   - `componentFileName`: The name of the component file.\n   *   - `componentExtension`: The extension of the component file.\n   *   - `format`: The format of the dictionary.\n   *   - `componentFormat`: The format of the component dictionary.\n   *   - `componentDirPath`: The directory path of the component.\n   */\n  output: customConfiguration?.output,\n\n  /**\n   * Indicates if the metadata should be saved in the file.\n   *\n   * If true, the compiler will not save the metadata of the dictionaries.\n   *\n   * If `true`:\n   *\n   * ```json\n   * {\n   *   \"key\": \"value\"\n   * }\n   * ```\n   *\n   * If `false`:\n   *\n   * ```json\n   * {\n   *   \"key\": \"value\",\n   *   \"content\": {\n   *      \"key\": \"value\"\n   *   }\n   * }\n   * ```\n   *\n   * Default: `false`\n   *\n   * Note: Useful if used with loadJSON plugin\n   */\n  noMetadata: customConfiguration?.noMetadata ?? COMPILER_NO_METADATA,\n\n  /**\n   * Indicates if the components should be saved after being transformed.\n   */\n  saveComponents:\n    customConfiguration?.saveComponents ?? COMPILER_SAVE_COMPONENTS,\n});\n\n/**\n * Build the `dictionary` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied dictionary config.\n * @returns A fully-defaulted {@link DictionaryConfig}.\n */\nconst buildDictionaryFields = (\n  customConfiguration?: Partial<DictionaryConfig>\n): DictionaryConfig => {\n  const contentAutoTransformation =\n    customConfiguration?.contentAutoTransformation ??\n    CONTENT_AUTO_TRANSFORMATION;\n\n  return {\n    /**\n     * Indicate how the dictionary should be filled using AI.\n     *\n     * Default: `true`\n     *\n     * - If `true`, will consider the `compiler.output` field.\n     * - If `false`, will skip the fill process.\n     *\n     * - `./` paths are resolved relative to the component directory.\n     * - `/` paths are resolved relative to the project root (`baseDir`).\n     *\n     * - If includes `{{locale}}` variable in the path, will trigger the generation of separate dictionaries per locale.\n     *\n     * Example:\n     * ```ts\n     * {\n     *   // Create Multilingual .content.ts files close to the component\n     *   fill: ({ fileName, extension }) => `./${fileName}${extension}`,\n     *\n     *   // fill: './{{fileName}}{{extension}}', // Equivalent using template string\n     * }\n     * ```\n     *\n     * ```ts\n     * {\n     *   // Create centralize per-locale JSON at the root of the project\n     *   fill: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,\n     *\n     *   // fill: '/locales/{{locale}}/{{key}}.content.json', // Equivalent using template string\n     * }\n     * ```\n     *\n     * ```ts\n     * {\n     *   // Create custom output based on the locale\n     *   fill: {\n     *     en: ({ key }) => `/locales/en/${key}.content.json`,\n     *     fr: '/locales/fr/{{key}}.content.json',\n     *     es: false,\n     *     de: true,\n     *   },\n     * }\n     * ```\n     *\n     *\n     * Variable list:\n     *   - `fileName`: The name of the file.\n     *   - `key`: The key of the content.\n     *   - `locale`: The locale of the content.\n     *   - `extension`: The extension of the file.\n     *   - `componentFileName`: The name of the component file.\n     *   - `componentExtension`: The extension of the component file.\n     *   - `format`: The format of the dictionary.\n     *   - `componentFormat`: The format of the component dictionary.\n     *   - `componentDirPath`: The directory path of the component.\n     */\n    fill: customConfiguration?.fill ?? FILL,\n\n    /**\n     * Indicates if the content of the dictionary should be automatically transformed.\n     *\n     * Default: `false`\n     */\n    contentAutoTransformation:\n      typeof contentAutoTransformation === 'object'\n        ? {\n            markdown: contentAutoTransformation.markdown ?? false,\n            html: contentAutoTransformation.html ?? false,\n            insertion: contentAutoTransformation.insertion ?? false,\n          }\n        : contentAutoTransformation,\n\n    /**\n     * The location of the dictionary.\n     *\n     * Default: `\"local\"`\n     */\n    location: customConfiguration?.location ?? LOCATION,\n\n    /**\n     * Transform the dictionary in a per-locale dictionary.\n     * Each field declared in a per-locale dictionary will be transformed in a translation node.\n     * If missing, the dictionary will be treated as a multilingual dictionary.\n     */\n    locale: customConfiguration?.locale,\n\n    /**\n     * The title of the dictionary.\n     */\n    title: customConfiguration?.title,\n\n    /**\n     * The description of the dictionary.\n     */\n    description: customConfiguration?.description,\n\n    /**\n     * Tags to categorize the dictionaries.\n     */\n    tags: customConfiguration?.tags,\n\n    /**\n     * The priority of the dictionary.\n     */\n    priority: customConfiguration?.priority,\n\n    /**\n     * Indicates the mode of import to use for the dictionary.\n     *\n     * Available modes:\n     * - \"static\": The dictionaries are imported statically.\n     * - \"dynamic\": The dictionaries are imported dynamically in a synchronous component using the suspense API.\n     * - \"live\": The dictionaries are imported dynamically using the live sync API.\n     *\n     * Default: `\"static\"`\n     */\n    importMode: customConfiguration?.importMode ?? IMPORT_MODE,\n\n    /**\n     * The default message format for all dictionaries in the project.\n     *\n     * Default: 'intlayer'\n     */\n    format: customConfiguration?.format,\n  };\n};\n\n// ---------------------------------------------------------------------------\n// Main export\n// ---------------------------------------------------------------------------\n\n/**\n * Build the complete Intlayer configuration by merging user-supplied values\n * with defaults.\n *\n * Internally this function:\n * 1. Calls {@link buildBrowserConfiguration} to produce the browser-safe\n *    subset (internationalization, routing, editor public fields, log, metadata).\n * 2. Extends the result with full server-side fields:\n *    - `internationalization` — adds `requiredLocales` and `strictMode`.\n *    - `editor` — adds `clientId` and `clientSecret`.\n *    - `log` — adds custom log functions.\n *    - `system`, `content`, `ai`, `build`, `compiler`, `dictionary`.\n *\n * @param customConfiguration - Optional user-supplied configuration object.\n * @param baseDir - Project root directory. Defaults to `process.cwd()`.\n * @param logFunctions - Optional custom logging functions.\n * @returns A fully-built {@link IntlayerConfig}.\n */\nexport const buildConfigurationFields = (\n  customConfiguration?: CustomIntlayerConfig,\n  baseDir?: string,\n  logFunctions?: LogFunctions\n): IntlayerConfig => {\n  if (customConfiguration) {\n    const result = intlayerConfigSchema.safeParse(customConfiguration);\n\n    if (!result.success) {\n      const logError = logFunctions?.error ?? console.error;\n\n      for (const issue of result.error.issues) {\n        logError(`${issue.path.join('.')}: ${issue.message}`);\n      }\n    }\n  }\n\n  // build browser-safe config (shared defaults, no Node.js deps)\n  const browserConfig = buildBrowserConfiguration(customConfiguration);\n\n  // extend shared fields with server-only additions\n  const internationalizationConfig = buildInternationalizationFields(\n    customConfiguration?.internationalization\n  );\n\n  const editorConfig = buildEditorFields(customConfiguration?.editor);\n\n  const logConfig = buildLogFields(customConfiguration?.log, logFunctions);\n\n  // build server-only fields\n  const systemConfig = buildSystemFields(baseDir, customConfiguration?.system);\n\n  const contentConfig = buildContentFields(\n    systemConfig,\n    customConfiguration?.content\n  );\n\n  storedConfiguration = {\n    // Shared browser fields\n    routing: browserConfig.routing,\n    // Full (extended) shared fields\n    internationalization: internationalizationConfig,\n    editor: editorConfig,\n    analytics: buildAnalyticsFields(customConfiguration?.analytics),\n    log: logConfig,\n    // Server-only fields\n    system: systemConfig,\n    content: contentConfig,\n    ai: buildAiFields(customConfiguration?.ai),\n    build: buildBuildFields(customConfiguration?.build),\n    compiler: buildCompilerFields(customConfiguration?.compiler),\n    dictionary: buildDictionaryFields(customConfiguration?.dictionary),\n    plugins: customConfiguration?.plugins,\n    schemas: customConfiguration?.schemas,\n  } as IntlayerConfig;\n\n  return storedConfiguration;\n};\n"],"mappings":"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"}
+{"version":3,"file":"buildConfigurationFields.mjs","names":[],"sources":["../../../src/configFile/buildConfigurationFields.ts"],"sourcesContent":["import { statSync } from 'node:fs';\nimport { dirname, isAbsolute, join } from 'node:path';\nimport type {\n  AiConfig,\n  BuildConfig,\n  CompilerConfig,\n  ContentConfig,\n  CustomIntlayerConfig,\n  DictionaryConfig,\n  IntlayerConfig,\n  LogFunctions,\n  SystemConfig,\n} from '@intlayer/types/config';\nimport {\n  BUILD_MODE,\n  CACHE,\n  CHUNK_GROUPING,\n  DICTIONARIES_PRELOAD,\n  MINIFY,\n  OUTPUT_FORMAT,\n  PURGE,\n  TRAVERSE_PATTERN,\n  TYPE_CHECKING,\n} from '../defaultValues/build';\nimport {\n  COMPILER_DICTIONARY_KEY_PREFIX,\n  COMPILER_ENABLED,\n  COMPILER_NO_METADATA,\n  COMPILER_SAVE_COMPONENTS,\n} from '../defaultValues/compiler';\nimport {\n  CODE_DIR,\n  CONTENT_DIR,\n  EXCLUDED_PATHS,\n  FILE_EXTENSIONS,\n  WATCH,\n} from '../defaultValues/content';\nimport {\n  CONTENT_AUTO_TRANSFORMATION,\n  FILL,\n  IMPORT_MODE,\n  LOCATION,\n} from '../defaultValues/dictionary';\nimport {\n  CACHE_DIR,\n  CONFIG_DIR,\n  DICTIONARIES_DIR,\n  DYNAMIC_DICTIONARIES_DIR,\n  FETCH_DICTIONARIES_DIR,\n  MAIN_DIR,\n  MODULE_AUGMENTATION_DIR,\n  REMOTE_DICTIONARIES_DIR,\n  TEMP_DIR,\n  TYPES_DIR,\n  UNMERGED_DICTIONARIES_DIR,\n} from '../defaultValues/system';\nimport { getProjectRequire } from '../utils';\nimport {\n  buildAnalyticsFields,\n  buildBrowserConfiguration,\n  buildEditorFields,\n  buildInternationalizationFields,\n  buildLogFields,\n} from './buildBrowserConfiguration';\nimport { intlayerConfigSchema } from './configurationSchema';\n\nexport {\n  type BrowserIntlayerConfig,\n  buildAnalyticsFields,\n  buildBrowserConfiguration,\n  buildEditorFields,\n  buildInternationalizationFields,\n  buildLogFields,\n  buildRoutingFields,\n  extractBrowserConfiguration,\n} from './buildBrowserConfiguration';\n\nlet storedConfiguration: IntlayerConfig;\n\n// ---------------------------------------------------------------------------\n// Server-only field builders (Node.js — not browser-safe)\n// ---------------------------------------------------------------------------\n\n/**\n * Build the `system` section of the Intlayer configuration.\n *\n * Resolves all directory paths (dictionaries, types, cache, …) relative to\n * the project base directory, using Node.js `require.resolve` where available\n * and falling back to `path.join` otherwise.\n *\n * @param baseDir - Project root directory. Defaults to `process.cwd()`.\n * @param customConfiguration - Partial user-supplied system config.\n * @returns A fully-resolved {@link SystemConfig}.\n */\nconst buildSystemFields = (\n  baseDir?: string,\n  customConfiguration?: Partial<SystemConfig>\n): SystemConfig => {\n  const projectBaseDir = baseDir ?? process.cwd();\n\n  const optionalJoinBaseDir = (pathInput: string) => {\n    let absolutePath: string;\n\n    try {\n      const requireFunction = getProjectRequire(projectBaseDir);\n      try {\n        absolutePath = requireFunction.resolve(pathInput, {\n          paths: [projectBaseDir],\n        });\n      } catch (err) {\n        if (!pathInput.startsWith('.') && !isAbsolute(pathInput)) {\n          absolutePath = requireFunction.resolve(`${pathInput}/package.json`, {\n            paths: [projectBaseDir],\n          });\n        } else {\n          throw err;\n        }\n      }\n    } catch {\n      absolutePath = isAbsolute(pathInput)\n        ? pathInput\n        : join(projectBaseDir, pathInput);\n    }\n\n    try {\n      const stats = statSync(absolutePath);\n      if (stats.isFile()) {\n        return dirname(absolutePath);\n      }\n    } catch {\n      if (/\\.[a-z0-9]+$/i.test(absolutePath)) {\n        return dirname(absolutePath);\n      }\n    }\n\n    return absolutePath;\n  };\n\n  const dictionariesDir = optionalJoinBaseDir(\n    customConfiguration?.dictionariesDir ?? DICTIONARIES_DIR\n  );\n\n  return {\n    baseDir: projectBaseDir,\n    moduleAugmentationDir: optionalJoinBaseDir(\n      customConfiguration?.moduleAugmentationDir ?? MODULE_AUGMENTATION_DIR\n    ),\n    unmergedDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.unmergedDictionariesDir ?? UNMERGED_DICTIONARIES_DIR\n    ),\n    remoteDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.remoteDictionariesDir ?? REMOTE_DICTIONARIES_DIR\n    ),\n    dictionariesDir,\n    dynamicDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.dynamicDictionariesDir ?? DYNAMIC_DICTIONARIES_DIR\n    ),\n    fetchDictionariesDir: optionalJoinBaseDir(\n      customConfiguration?.fetchDictionariesDir ?? FETCH_DICTIONARIES_DIR\n    ),\n    typesDir: optionalJoinBaseDir(customConfiguration?.typesDir ?? TYPES_DIR),\n    mainDir: optionalJoinBaseDir(customConfiguration?.mainDir ?? MAIN_DIR),\n    configDir: optionalJoinBaseDir(\n      customConfiguration?.configDir ?? CONFIG_DIR\n    ),\n    cacheDir: optionalJoinBaseDir(customConfiguration?.cacheDir ?? CACHE_DIR),\n    tempDir: optionalJoinBaseDir(customConfiguration?.tempDir ?? TEMP_DIR),\n  };\n};\n\n/**\n * Build the `content` section of the Intlayer configuration.\n *\n * Resolves content and code directories relative to the project base using\n * `require.resolve`, falling back to `path.join`.\n *\n * @param systemConfig - Already-built system configuration (provides `baseDir`).\n * @param customConfiguration - Partial user-supplied content config.\n * @returns A fully-resolved {@link ContentConfig}.\n */\nconst buildContentFields = (\n  systemConfig: SystemConfig,\n  customConfiguration?: Partial<ContentConfig>\n): ContentConfig => {\n  const fileExtensions = customConfiguration?.fileExtensions ?? FILE_EXTENSIONS;\n\n  const optionalJoinBaseDir = (pathInput: string) => {\n    let absolutePath: string;\n\n    try {\n      const requireFunction = getProjectRequire(systemConfig.baseDir);\n      try {\n        absolutePath = requireFunction.resolve(pathInput, {\n          paths: [systemConfig.baseDir],\n        });\n      } catch (err) {\n        if (!pathInput.startsWith('.') && !isAbsolute(pathInput)) {\n          absolutePath = requireFunction.resolve(`${pathInput}/package.json`, {\n            paths: [systemConfig.baseDir],\n          });\n        } else {\n          throw err;\n        }\n      }\n    } catch {\n      try {\n        try {\n          absolutePath = require.resolve(pathInput, {\n            paths: [systemConfig.baseDir],\n          });\n        } catch (err) {\n          if (!pathInput.startsWith('.') && !isAbsolute(pathInput)) {\n            absolutePath = require.resolve(`${pathInput}/package.json`, {\n              paths: [systemConfig.baseDir],\n            });\n          } else {\n            throw err;\n          }\n        }\n      } catch {\n        absolutePath = isAbsolute(pathInput)\n          ? pathInput\n          : join(systemConfig.baseDir, pathInput);\n      }\n    }\n\n    try {\n      const stats = statSync(absolutePath);\n      if (stats.isFile()) {\n        return dirname(absolutePath);\n      }\n    } catch {\n      if (/\\.[a-z0-9]+$/i.test(absolutePath)) {\n        return dirname(absolutePath);\n      }\n    }\n\n    return absolutePath;\n  };\n\n  const contentDir = (customConfiguration?.contentDir ?? CONTENT_DIR).map(\n    optionalJoinBaseDir\n  );\n  const codeDir = (customConfiguration?.codeDir ?? CODE_DIR).map(\n    optionalJoinBaseDir\n  );\n\n  return {\n    fileExtensions,\n    contentDir,\n    codeDir,\n    excludedPath: customConfiguration?.excludedPath ?? EXCLUDED_PATHS,\n    watch: customConfiguration?.watch ?? WATCH,\n    formatCommand: customConfiguration?.formatCommand,\n  };\n};\n\n/**\n * Build the `ai` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied AI config.\n * @returns A fully-defaulted {@link AiConfig}.\n */\nconst buildAiFields = (customConfiguration?: Partial<AiConfig>): AiConfig => ({\n  /**\n   * AI configuration\n   */\n  provider: customConfiguration?.provider,\n\n  /**\n   * API key\n   */\n  apiKey: customConfiguration?.apiKey,\n\n  /**\n   * API model\n   */\n  model: customConfiguration?.model,\n\n  /**\n   * Temperature\n   */\n  temperature: customConfiguration?.temperature,\n\n  /**\n   * Application context\n   *\n   * Default: undefined\n   *\n   * The application context.\n   *\n   * Example: `'My application context'`\n   *\n   * Note: Can be used to provide additional context about the application to the AI model. You can add more rules (e.g. \"You should not transform urls\").\n   */\n  applicationContext: customConfiguration?.applicationContext,\n\n  /**\n   * Base URL for the AI API\n   *\n   * Default: undefined\n   *\n   * The base URL for the AI API.\n   *\n   * Example: `'http://localhost:5000'`\n   *\n   * Note: Can be used to point to a local, or custom AI API endpoint.\n   */\n  baseURL: customConfiguration?.baseURL,\n\n  /**\n   * Data serialization\n   *\n   * Options:\n   * - \"json\": The industry standard. Highly reliable and structured, but consumes more tokens.\n   * - \"toon\": An optimized format designed to reduce token consumption (cost-effective). However, it may slightly increase the risk of output inconsistency compared to standard JSON\n   *\n   * Default: `\"json\"`\n   */\n  dataSerialization: customConfiguration?.dataSerialization,\n});\n\n/**\n * Build the `build` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied build config.\n * @returns A fully-defaulted {@link BuildConfig}.\n */\nconst buildBuildFields = (\n  customConfiguration?: Partial<BuildConfig>\n): BuildConfig => ({\n  /**\n   * Indicates the mode of the build\n   *\n   * Default: 'auto'\n   *\n   * If 'auto', the build will be enabled automatically when the application is built.\n   * If 'manual', the build will be set only when the build command is executed.\n   *\n   * Can be used to disable dictionaries build, for instance when execution on Node.js environment should be avoided.\n   */\n  mode: customConfiguration?.mode ?? BUILD_MODE,\n\n  /**\n   * Indicates if the build should be optimized\n   *\n   * Default: process.env.NODE_ENV === 'production'\n   *\n   * If true, the build will be optimized.\n   * If false, the build will not be optimized.\n   *\n   * Intlayer will replace all calls of dictionaries to optimize chunking. That way the final bundle will import only the dictionaries that are used.\n   * All imports will stay as static import to avoid async processing when loading the dictionaries.\n   *\n   * Note:\n   * - Intlayer will replace all call of `useIntlayer` with the defined mode by the `importMode` option.\n   * - Intlayer will replace all call of `getIntlayer` with `getDictionary`.\n   * - This option relies on the `@intlayer/babel` and `@intlayer/swc` plugins.\n   * - In most cases, \"dynamic\" will be used for React applications, \"async\" for Vue.js applications.\n   * - Ensure all keys are declared statically in the `useIntlayer` calls. e.g. `useIntlayer('navbar')`.\n   */\n  optimize: customConfiguration?.optimize,\n\n  /**\n   * Indicates the mode of import to use for the dictionaries.\n   *\n   * Available modes:\n   * - \"static\": The dictionaries are imported statically.\n   *   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionary`.\n   * - \"dynamic\": The dictionaries are imported dynamically in a synchronous component using the suspense API.\n   *   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionaryDynamic`.\n   * - \"live\": The dictionaries are imported dynamically using the live sync API.\n   *   In that case, Intlayer will replace all calls to `useIntlayer` with `useDictionaryDynamic`.\n   *   Live mode will use the live sync API to fetch the dictionaries. If the API call fails, the dictionaries will be imported dynamically as \"dynamic\" mode.\n   *\n   * Default: \"static\"\n   *\n   * By default, when a dictionary is loaded, it imports content for all locales as it's imported statically.\n   *\n   * Note:\n   * - Dynamic imports rely on Suspense and may slightly impact rendering performance.\n   * - If disabled all locales will be loaded at once, even if they are not used.\n   * - This option relies on the `@intlayer/babel` and `@intlayer/swc` plugins.\n   * - Ensure all keys are declared statically in the `useIntlayer` calls. e.g. `useIntlayer('navbar')`.\n   * - This option will be ignored if `optimize` is disabled.\n   * - This option will not impact the `getIntlayer`, `getDictionary`, `useDictionary`, `useDictionaryAsync` and `useDictionaryDynamic` functions. You can still use them to refine you code on manual optimization.\n   * - The \"live\" allows to sync the dictionaries to the live sync server.\n   *\n   * @deprecated Use `dictionary.importMode` instead.\n   */\n  importMode: customConfiguration?.importMode,\n\n  /**\n   * Minify the dictionaries to reduce the bundle size.\n   *\n   * Default: false\n   *\n   * Note:\n   * - This option will be ignored if `optimize` is disabled.\n   * - This option will be ignore if `editor.enabled` is true.\n   * - If there is edge cases where the minification is not working properly, the dictionary will be not minified.\n   */\n  minify: customConfiguration?.minify ?? MINIFY,\n\n  /**\n   * Purge the unused keys in a dictionaries\n   *\n   * Default: false\n   *\n   * Note:\n   * - This option will be ignored if `optimize` is disabled.\n   * - This option will be ignored if `editor.enabled` is true.\n   */\n  purge: customConfiguration?.purge ?? PURGE,\n\n  /**\n   * Group the per-locale dictionary chunks by the code-split boundary that uses\n   * them, so a lazily loaded page fetches its content in one request.\n   *\n   * Default: true\n   *\n   * Note:\n   * - Only applies to dictionaries using `importMode: 'dynamic'`.\n   * - Only applies to the client build, and only when bundling (not in dev).\n   */\n  chunkGrouping: customConfiguration?.chunkGrouping ?? CHUNK_GROUPING,\n\n  /**\n   * Load a dictionary together with the chunk that uses it, instead of fetching\n   * it once that chunk renders — so a reader renders synchronously rather than\n   * suspending, and navigating no longer flashes a loading state.\n   *\n   * Default: true\n   *\n   * Note:\n   * - Only applies to dictionaries using `importMode: 'dynamic'`.\n   * - Only applies to the client build; the server keeps loading on demand.\n   * - Requires a bundler supporting top-level await (Vite, esbuild).\n   */\n  dictionariesPreload:\n    customConfiguration?.dictionariesPreload ?? DICTIONARIES_PRELOAD,\n\n  /**\n   * Pattern to traverse the code to optimize.\n   *\n   * Allows to avoid to traverse the code that is not relevant to the optimization.\n   * Improve build performance.\n   *\n   * Default: ['**\\/*.{js,ts,mjs,cjs,jsx,tsx}', '!**\\/node_modules/**']\n   *\n   * Example: `['src/**\\/*.{ts,tsx}', '../ui-library/**\\/*.{ts,tsx}']`\n   *\n   * Note:\n   * - This option will be ignored if `optimize` is disabled.\n   * - Use glob pattern.\n   */\n  traversePattern: customConfiguration?.traversePattern ?? TRAVERSE_PATTERN,\n\n  /**\n   * Output format of the dictionaries\n   *\n   * Can be set on large projects to improve build performance.\n   *\n   * Default: ['cjs', 'esm']\n   *\n   * The output format of the dictionaries. It can be either 'cjs' or 'esm'.\n   * - 'cjs': The dictionaries are outputted as CommonJS modules.\n   * - 'esm': The dictionaries are outputted as ES modules.\n   */\n  outputFormat: customConfiguration?.outputFormat ?? OUTPUT_FORMAT,\n\n  /**\n   * Cache\n   */\n  cache: customConfiguration?.cache ?? CACHE,\n\n  /**\n   * Require function\n   */\n  require: customConfiguration?.require,\n\n  /**\n   * Indicates if the build should check TypeScript types\n   *\n   * Default: `false`\n   *\n   * If true, the build will check TypeScript types and log errors.\n   * Note: This can slow down the build.\n   */\n  checkTypes: customConfiguration?.checkTypes ?? TYPE_CHECKING,\n});\n\n/**\n * Build the `compiler` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied compiler config.\n * @returns A fully-defaulted {@link CompilerConfig}.\n */\nconst buildCompilerFields = (\n  customConfiguration?: Partial<CompilerConfig>\n): CompilerConfig => ({\n  /**\n   * Indicates if the compiler should be enabled\n   */\n  enabled: customConfiguration?.enabled ?? COMPILER_ENABLED,\n\n  /**\n   * Prefix for the extracted dictionary keys\n   */\n  dictionaryKeyPrefix:\n    customConfiguration?.dictionaryKeyPrefix ?? COMPILER_DICTIONARY_KEY_PREFIX,\n\n  /**\n   * Pattern to traverse the code to optimize.\n   *\n   * @deprecated use `build.traversePattern` instead\n   */\n  transformPattern: customConfiguration?.transformPattern,\n\n  /**\n   * Pattern to exclude from the optimization.\n   *\n   * @deprecated use `build.traversePattern` instead\n   */\n  excludePattern: customConfiguration?.excludePattern,\n\n  /**\n   * Defines the output files path. Replaces `outputDir`.\n   *\n   * - `./` paths are resolved relative to the component directory.\n   * - `/` paths are resolved relative to the project root (`baseDir`).\n   *\n   * - Including the `{{locale}}` variable in the path will trigger the generation of separate dictionaries per locale.\n   *\n   * @example:\n   * ```ts\n   * {\n   *   // Create Multilingual .content.ts files close to the component\n   *   output: ({ fileName, extension }) => `./${fileName}${extension}`,\n   *\n   *   // output: './{{fileName}}{{extension}}', // Equivalent using template string\n   * }\n   * ```\n   *\n   * ```ts\n   * {\n   *   // Create centralize per-locale JSON at the root of the project\n   *   output: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,\n   *\n   *   // output: '/locales/{{locale}}/{{key}}.content.json', // Equivalent using template string\n   * }\n   * ```\n   *\n   * ```ts\n   * {\n   *   // Create per-locale JSON files with locale-specific output paths\n   *   output: {\n   *     en: ({ fileName, locale }) => `${fileName}.${locale}.content.json`,\n   *     fr: '{{fileName}}.{{locale}}.content.json',\n   *     es: false, // skip this locale\n   *   },\n   * }\n   * ```\n   *\n   * Variable list:\n   *   - `fileName`: The name of the file.\n   *   - `key`: The key of the content.\n   *   - `locale`: The locale of the content.\n   *   - `extension`: The extension of the file.\n   *   - `componentFileName`: The name of the component file.\n   *   - `componentExtension`: The extension of the component file.\n   *   - `format`: The format of the dictionary.\n   *   - `componentFormat`: The format of the component dictionary.\n   *   - `componentDirPath`: The directory path of the component.\n   */\n  output: customConfiguration?.output,\n\n  /**\n   * Indicates if the metadata should be saved in the file.\n   *\n   * If true, the compiler will not save the metadata of the dictionaries.\n   *\n   * If `true`:\n   *\n   * ```json\n   * {\n   *   \"key\": \"value\"\n   * }\n   * ```\n   *\n   * If `false`:\n   *\n   * ```json\n   * {\n   *   \"key\": \"value\",\n   *   \"content\": {\n   *      \"key\": \"value\"\n   *   }\n   * }\n   * ```\n   *\n   * Default: `false`\n   *\n   * Note: Useful if used with loadJSON plugin\n   */\n  noMetadata: customConfiguration?.noMetadata ?? COMPILER_NO_METADATA,\n\n  /**\n   * Indicates if the components should be saved after being transformed.\n   */\n  saveComponents:\n    customConfiguration?.saveComponents ?? COMPILER_SAVE_COMPONENTS,\n});\n\n/**\n * Build the `dictionary` section of the Intlayer configuration.\n *\n * @param customConfiguration - Partial user-supplied dictionary config.\n * @returns A fully-defaulted {@link DictionaryConfig}.\n */\nconst buildDictionaryFields = (\n  customConfiguration?: Partial<DictionaryConfig>\n): DictionaryConfig => {\n  const contentAutoTransformation =\n    customConfiguration?.contentAutoTransformation ??\n    CONTENT_AUTO_TRANSFORMATION;\n\n  return {\n    /**\n     * Indicate how the dictionary should be filled using AI.\n     *\n     * Default: `true`\n     *\n     * - If `true`, will consider the `compiler.output` field.\n     * - If `false`, will skip the fill process.\n     *\n     * - `./` paths are resolved relative to the component directory.\n     * - `/` paths are resolved relative to the project root (`baseDir`).\n     *\n     * - If includes `{{locale}}` variable in the path, will trigger the generation of separate dictionaries per locale.\n     *\n     * Example:\n     * ```ts\n     * {\n     *   // Create Multilingual .content.ts files close to the component\n     *   fill: ({ fileName, extension }) => `./${fileName}${extension}`,\n     *\n     *   // fill: './{{fileName}}{{extension}}', // Equivalent using template string\n     * }\n     * ```\n     *\n     * ```ts\n     * {\n     *   // Create centralize per-locale JSON at the root of the project\n     *   fill: ({ key, locale }) => `/locales/${locale}/${key}.content.json`,\n     *\n     *   // fill: '/locales/{{locale}}/{{key}}.content.json', // Equivalent using template string\n     * }\n     * ```\n     *\n     * ```ts\n     * {\n     *   // Create custom output based on the locale\n     *   fill: {\n     *     en: ({ key }) => `/locales/en/${key}.content.json`,\n     *     fr: '/locales/fr/{{key}}.content.json',\n     *     es: false,\n     *     de: true,\n     *   },\n     * }\n     * ```\n     *\n     *\n     * Variable list:\n     *   - `fileName`: The name of the file.\n     *   - `key`: The key of the content.\n     *   - `locale`: The locale of the content.\n     *   - `extension`: The extension of the file.\n     *   - `componentFileName`: The name of the component file.\n     *   - `componentExtension`: The extension of the component file.\n     *   - `format`: The format of the dictionary.\n     *   - `componentFormat`: The format of the component dictionary.\n     *   - `componentDirPath`: The directory path of the component.\n     */\n    fill: customConfiguration?.fill ?? FILL,\n\n    /**\n     * Indicates if the content of the dictionary should be automatically transformed.\n     *\n     * Default: `false`\n     */\n    contentAutoTransformation:\n      typeof contentAutoTransformation === 'object'\n        ? {\n            markdown: contentAutoTransformation.markdown ?? false,\n            html: contentAutoTransformation.html ?? false,\n            insertion: contentAutoTransformation.insertion ?? false,\n          }\n        : contentAutoTransformation,\n\n    /**\n     * The location of the dictionary.\n     *\n     * Default: `\"local\"`\n     */\n    location: customConfiguration?.location ?? LOCATION,\n\n    /**\n     * Transform the dictionary in a per-locale dictionary.\n     * Each field declared in a per-locale dictionary will be transformed in a translation node.\n     * If missing, the dictionary will be treated as a multilingual dictionary.\n     */\n    locale: customConfiguration?.locale,\n\n    /**\n     * The title of the dictionary.\n     */\n    title: customConfiguration?.title,\n\n    /**\n     * The description of the dictionary.\n     */\n    description: customConfiguration?.description,\n\n    /**\n     * Tags to categorize the dictionaries.\n     */\n    tags: customConfiguration?.tags,\n\n    /**\n     * The priority of the dictionary.\n     */\n    priority: customConfiguration?.priority,\n\n    /**\n     * Indicates the mode of import to use for the dictionary.\n     *\n     * Available modes:\n     * - \"static\": The dictionaries are imported statically.\n     * - \"dynamic\": The dictionaries are imported dynamically in a synchronous component using the suspense API.\n     * - \"live\": The dictionaries are imported dynamically using the live sync API.\n     *\n     * Default: `\"static\"`\n     */\n    importMode: customConfiguration?.importMode ?? IMPORT_MODE,\n\n    /**\n     * The default message format for all dictionaries in the project.\n     *\n     * Default: 'intlayer'\n     */\n    format: customConfiguration?.format,\n  };\n};\n\n// ---------------------------------------------------------------------------\n// Main export\n// ---------------------------------------------------------------------------\n\n/**\n * Build the complete Intlayer configuration by merging user-supplied values\n * with defaults.\n *\n * Internally this function:\n * 1. Calls {@link buildBrowserConfiguration} to produce the browser-safe\n *    subset (internationalization, routing, editor public fields, log, metadata).\n * 2. Extends the result with full server-side fields:\n *    - `internationalization` — adds `requiredLocales` and `strictMode`.\n *    - `editor` — adds `clientId` and `clientSecret`.\n *    - `log` — adds custom log functions.\n *    - `system`, `content`, `ai`, `build`, `compiler`, `dictionary`.\n *\n * @param customConfiguration - Optional user-supplied configuration object.\n * @param baseDir - Project root directory. Defaults to `process.cwd()`.\n * @param logFunctions - Optional custom logging functions.\n * @returns A fully-built {@link IntlayerConfig}.\n */\nexport const buildConfigurationFields = (\n  customConfiguration?: CustomIntlayerConfig,\n  baseDir?: string,\n  logFunctions?: LogFunctions\n): IntlayerConfig => {\n  if (customConfiguration) {\n    const result = intlayerConfigSchema.safeParse(customConfiguration);\n\n    if (!result.success) {\n      const logError = logFunctions?.error ?? console.error;\n\n      for (const issue of result.error.issues) {\n        logError(`${issue.path.join('.')}: ${issue.message}`);\n      }\n    }\n  }\n\n  // build browser-safe config (shared defaults, no Node.js deps)\n  const browserConfig = buildBrowserConfiguration(customConfiguration);\n\n  // extend shared fields with server-only additions\n  const internationalizationConfig = buildInternationalizationFields(\n    customConfiguration?.internationalization\n  );\n\n  const editorConfig = buildEditorFields(customConfiguration?.editor);\n\n  const logConfig = buildLogFields(customConfiguration?.log, logFunctions);\n\n  // build server-only fields\n  const systemConfig = buildSystemFields(baseDir, customConfiguration?.system);\n\n  const contentConfig = buildContentFields(\n    systemConfig,\n    customConfiguration?.content\n  );\n\n  storedConfiguration = {\n    // Shared browser fields\n    routing: browserConfig.routing,\n    // Full (extended) shared fields\n    internationalization: internationalizationConfig,\n    editor: editorConfig,\n    analytics: buildAnalyticsFields(customConfiguration?.analytics),\n    log: logConfig,\n    // Server-only fields\n    system: systemConfig,\n    content: contentConfig,\n    ai: buildAiFields(customConfiguration?.ai),\n    build: buildBuildFields(customConfiguration?.build),\n    compiler: buildCompilerFields(customConfiguration?.compiler),\n    dictionary: buildDictionaryFields(customConfiguration?.dictionary),\n    plugins: customConfiguration?.plugins,\n    schemas: customConfiguration?.schemas,\n  } as IntlayerConfig;\n\n  return storedConfiguration;\n};\n"],"mappings":"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"}

package/dist/esm/defaultValues/build.mjs

@@ -28,7 +28,9 @@ const CACHE = true;
 const TYPE_CHECKING = false;
 const MINIFY = false;
 const PURGE = false;
+const CHUNK_GROUPING = true;
+const DICTIONARIES_PRELOAD = true;
 
 //#endregion
-export { BUILD_MODE, CACHE, MINIFY, OPTIMIZE, OUTPUT_FORMAT, PURGE, TRAVERSE_PATTERN, TYPE_CHECKING };
+export { BUILD_MODE, CACHE, CHUNK_GROUPING, DICTIONARIES_PRELOAD, MINIFY, OPTIMIZE, OUTPUT_FORMAT, PURGE, TRAVERSE_PATTERN, TYPE_CHECKING };
 //# sourceMappingURL=build.mjs.map

package/dist/esm/defaultValues/build.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"build.mjs","names":[],"sources":["../../../src/defaultValues/build.ts"],"sourcesContent":["export const BUILD_MODE = 'auto';\n\nexport const OPTIMIZE = undefined;\n\nexport const TRAVERSE_PATTERN = [\n  // Included files to parse\n  '**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,astro}',\n\n  // Excluded paths\n  '!**/node_modules/**',\n  '!**/dist/**',\n  '!**/build/**',\n  '!**/.intlayer/**',\n  '!**/.next/**',\n  '!**/.nuxt/**',\n  '!**/.expo/**',\n  '!**/.vercel/**',\n  '!**/.turbo/**',\n  '!**/.tanstack/**',\n  '!**/.output/**',\n  '!**/.svelte-kit/**',\n  '!**/*.config.*',\n  '!**/*.test.*',\n  '!**/*.spec.*',\n  '!**/*.stories.*',\n  '!**/*.d.ts',\n  '!**/*.d.ts.map',\n  '!**/*.map',\n];\n\nexport const OUTPUT_FORMAT: ('cjs' | 'esm')[] = ['esm', 'cjs'];\n\nexport const CACHE = true;\n\nexport const TYPE_CHECKING = false;\n\nexport const MINIFY = false;\n\nexport const PURGE = false;\n"],"mappings":";AAAA,MAAa,aAAa;AAE1B,MAAa,WAAW;AAExB,MAAa,mBAAmB;CAE9B;CAGA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,MAAa,gBAAmC,CAAC,OAAO,KAAK;AAE7D,MAAa,QAAQ;AAErB,MAAa,gBAAgB;AAE7B,MAAa,SAAS;AAEtB,MAAa,QAAQ"}
+{"version":3,"file":"build.mjs","names":[],"sources":["../../../src/defaultValues/build.ts"],"sourcesContent":["export const BUILD_MODE = 'auto';\n\nexport const OPTIMIZE = undefined;\n\nexport const TRAVERSE_PATTERN = [\n  // Included files to parse\n  '**/*.{tsx,ts,js,mjs,cjs,jsx,vue,svelte,astro}',\n\n  // Excluded paths\n  '!**/node_modules/**',\n  '!**/dist/**',\n  '!**/build/**',\n  '!**/.intlayer/**',\n  '!**/.next/**',\n  '!**/.nuxt/**',\n  '!**/.expo/**',\n  '!**/.vercel/**',\n  '!**/.turbo/**',\n  '!**/.tanstack/**',\n  '!**/.output/**',\n  '!**/.svelte-kit/**',\n  '!**/*.config.*',\n  '!**/*.test.*',\n  '!**/*.spec.*',\n  '!**/*.stories.*',\n  '!**/*.d.ts',\n  '!**/*.d.ts.map',\n  '!**/*.map',\n];\n\nexport const OUTPUT_FORMAT: ('cjs' | 'esm')[] = ['esm', 'cjs'];\n\nexport const CACHE = true;\n\nexport const TYPE_CHECKING = false;\n\nexport const MINIFY = false;\n\nexport const PURGE = false;\n\nexport const CHUNK_GROUPING = true;\n\nexport const DICTIONARIES_PRELOAD = true;\n"],"mappings":";AAAA,MAAa,aAAa;AAE1B,MAAa,WAAW;AAExB,MAAa,mBAAmB;CAE9B;CAGA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,MAAa,gBAAmC,CAAC,OAAO,KAAK;AAE7D,MAAa,QAAQ;AAErB,MAAa,gBAAgB;AAE7B,MAAa,SAAS;AAEtB,MAAa,QAAQ;AAErB,MAAa,iBAAiB;AAE9B,MAAa,uBAAuB"}

package/dist/esm/defaultValues/dictionary.mjs

@@ -3,7 +3,44 @@ const FILL = true;
 const LOCATION = "local";
 const CONTENT_AUTO_TRANSFORMATION = false;
 const IMPORT_MODE = "static";
+/**
+* Directory the per-locale JSON chunks of `importMode: 'dynamic'` are written
+* under, relative to `system.dynamicDictionariesDir`.
+*
+* Plain dictionaries land at `<subdir>/<key>/<locale>.json`, qualified ones
+* (collections, variants) nest one directory per dimension in between. The
+* static first segment is required by Turbopack, and build-tool plugins match
+* module ids against this layout — hence the shared constant rather than a
+* literal repeated on both sides.
+*/
+const DYNAMIC_DICTIONARIES_JSON_SUBDIR = "json";
+/**
+* Marker property carrying the ordered qualifier dimensions on a dynamic loader
+* map. Its presence distinguishes a qualified group loader map (a nested tree
+* of chunks) from a plain dynamic loader map (one chunk per `locale`). Prefixed
+* and unlikely to collide with a real locale code.
+*/
+const QUALIFIER_DYNAMIC_TYPES_KEY = "__intlayerQualifierTypes";
+/**
+* Marker property carrying the dictionary a generated dynamic entry point
+* already resolved for the browsing locale, before any component rendered.
+*
+* Build-tool plugins prepend a top-level `await` to those entry points, so the
+* chunk that statically imports one only finishes evaluating once the awaited
+* locale chunk has landed. A read during render then finds the content in place
+* instead of suspending.
+*/
+const PRELOADED_DYNAMIC_KEY = "__intlayerPreloaded";
+/**
+* Name of the local binding a generated dynamic entry point holds its loader
+* map in, before exporting it as default.
+*
+* The preload preamble is appended to that generated source and mutates the
+* binding, so the code generator and the build plugins have to agree on the
+* name — hence the shared constant rather than a literal repeated in both.
+*/
+const DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER = "content";
 
 //#endregion
-export { CONTENT_AUTO_TRANSFORMATION, FILL, IMPORT_MODE, LOCATION };
+export { CONTENT_AUTO_TRANSFORMATION, DYNAMIC_DICTIONARIES_JSON_SUBDIR, DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER, FILL, IMPORT_MODE, LOCATION, PRELOADED_DYNAMIC_KEY, QUALIFIER_DYNAMIC_TYPES_KEY };
 //# sourceMappingURL=dictionary.mjs.map

package/dist/esm/defaultValues/dictionary.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"dictionary.mjs","names":[],"sources":["../../../src/defaultValues/dictionary.ts"],"sourcesContent":["import type { DictionaryLocation } from '@intlayer/types/dictionary';\n\nexport const FILL = true;\nexport const LOCATION: DictionaryLocation = 'local';\nexport const CONTENT_AUTO_TRANSFORMATION = false;\nexport const IMPORT_MODE = 'static';\n"],"mappings":";AAEA,MAAa,OAAO;AACpB,MAAa,WAA+B;AAC5C,MAAa,8BAA8B;AAC3C,MAAa,cAAc"}
+{"version":3,"file":"dictionary.mjs","names":[],"sources":["../../../src/defaultValues/dictionary.ts"],"sourcesContent":["import type { DictionaryLocation } from '@intlayer/types/dictionary';\n\nexport const FILL = true;\nexport const LOCATION: DictionaryLocation = 'local';\nexport const CONTENT_AUTO_TRANSFORMATION = false;\nexport const IMPORT_MODE = 'static';\n\n/**\n * Directory the per-locale JSON chunks of `importMode: 'dynamic'` are written\n * under, relative to `system.dynamicDictionariesDir`.\n *\n * Plain dictionaries land at `<subdir>/<key>/<locale>.json`, qualified ones\n * (collections, variants) nest one directory per dimension in between. The\n * static first segment is required by Turbopack, and build-tool plugins match\n * module ids against this layout — hence the shared constant rather than a\n * literal repeated on both sides.\n */\nexport const DYNAMIC_DICTIONARIES_JSON_SUBDIR = 'json';\n\n/**\n * Marker property carrying the ordered qualifier dimensions on a dynamic loader\n * map. Its presence distinguishes a qualified group loader map (a nested tree\n * of chunks) from a plain dynamic loader map (one chunk per `locale`). Prefixed\n * and unlikely to collide with a real locale code.\n */\nexport const QUALIFIER_DYNAMIC_TYPES_KEY = '__intlayerQualifierTypes';\n\n/**\n * Marker property carrying the dictionary a generated dynamic entry point\n * already resolved for the browsing locale, before any component rendered.\n *\n * Build-tool plugins prepend a top-level `await` to those entry points, so the\n * chunk that statically imports one only finishes evaluating once the awaited\n * locale chunk has landed. A read during render then finds the content in place\n * instead of suspending.\n */\nexport const PRELOADED_DYNAMIC_KEY = '__intlayerPreloaded';\n\n/**\n * Name of the local binding a generated dynamic entry point holds its loader\n * map in, before exporting it as default.\n *\n * The preload preamble is appended to that generated source and mutates the\n * binding, so the code generator and the build plugins have to agree on the\n * name — hence the shared constant rather than a literal repeated in both.\n */\nexport const DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER = 'content';\n"],"mappings":";AAEA,MAAa,OAAO;AACpB,MAAa,WAA+B;AAC5C,MAAa,8BAA8B;AAC3C,MAAa,cAAc;;;;;;;;;;;AAY3B,MAAa,mCAAmC;;;;;;;AAQhD,MAAa,8BAA8B;;;;;;;;;;AAW3C,MAAa,wBAAwB;;;;;;;;;AAUrC,MAAa,sCAAsC"}

package/dist/esm/defaultValues/index.mjs

@@ -1,7 +1,7 @@
-import { BUILD_MODE, CACHE, MINIFY, OPTIMIZE, OUTPUT_FORMAT, PURGE, TRAVERSE_PATTERN, TYPE_CHECKING } from "./build.mjs";
+import { BUILD_MODE, CACHE, CHUNK_GROUPING, DICTIONARIES_PRELOAD, MINIFY, OPTIMIZE, OUTPUT_FORMAT, PURGE, TRAVERSE_PATTERN, TYPE_CHECKING } from "./build.mjs";
 import { COMPILER_DICTIONARY_KEY_PREFIX, COMPILER_ENABLED, COMPILER_NO_METADATA, COMPILER_SAVE_COMPONENTS } from "./compiler.mjs";
 import { CODE_DIR, CONTENT_DIR, EXCLUDED_PATHS, FILE_EXTENSIONS, I18NEXT_DICTIONARIES_DIR, REACT_INTL_MESSAGES_DIR, WATCH } from "./content.mjs";
-import { CONTENT_AUTO_TRANSFORMATION, FILL, IMPORT_MODE, LOCATION } from "./dictionary.mjs";
+import { CONTENT_AUTO_TRANSFORMATION, DYNAMIC_DICTIONARIES_JSON_SUBDIR, DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER, FILL, IMPORT_MODE, LOCATION, PRELOADED_DYNAMIC_KEY, QUALIFIER_DYNAMIC_TYPES_KEY } from "./dictionary.mjs";
 import { CACHE_DIR, CONFIG_DIR, DICTIONARIES_DIR, DYNAMIC_DICTIONARIES_DIR, FETCH_DICTIONARIES_DIR, MAIN_DIR, MASKS_DIR, MODULE_AUGMENTATION_DIR, REMOTE_DICTIONARIES_DIR, TEMP_DIR, TYPES_DIR, UNMERGED_DICTIONARIES_DIR } from "./system.mjs";
 import { BASE_PATH, COOKIE_NAME, ENABLE_PROXY, HEADER_NAME, LOCALE_STORAGE_NAME, ROUTING_MODE, SERVER_SET_COOKIE, STORAGE } from "./routing.mjs";
 import { ANALYTICS_ENABLED, ANALYTICS_FLUSH_INTERVAL, ANALYTICS_SAMPLE_RATE } from "./analytics.mjs";
@@ -9,4 +9,4 @@ import { APPLICATION_URL, BACKEND_URL, CMS_URL, DICTIONARY_PRIORITY_STRATEGY, ED
 import { DEFAULT_LOCALE, LOCALES, REQUIRED_LOCALES, STRICT_MODE } from "./internationalization.mjs";
 import { MODE, PREFIX } from "./log.mjs";
 
-export { ANALYTICS_ENABLED, ANALYTICS_FLUSH_INTERVAL, ANALYTICS_SAMPLE_RATE, APPLICATION_URL, BACKEND_URL, BASE_PATH, BUILD_MODE, CACHE, CACHE_DIR, CMS_URL, CODE_DIR, COMPILER_DICTIONARY_KEY_PREFIX, COMPILER_ENABLED, COMPILER_NO_METADATA, COMPILER_SAVE_COMPONENTS, CONFIG_DIR, CONTENT_AUTO_TRANSFORMATION, CONTENT_DIR, COOKIE_NAME, DEFAULT_LOCALE, DICTIONARIES_DIR, DICTIONARY_PRIORITY_STRATEGY, DYNAMIC_DICTIONARIES_DIR, EDITOR_URL, ENABLE_PROXY, EXCLUDED_PATHS, FETCH_DICTIONARIES_DIR, FILE_EXTENSIONS, FILL, HEADER_NAME, I18NEXT_DICTIONARIES_DIR, IMPORT_MODE, IS_ENABLED, LIVE_SYNC, LIVE_SYNC_PORT, LOCALES, LOCALE_STORAGE_NAME, LOCATION, MAIN_DIR, MASKS_DIR, MINIFY, MODE, MODULE_AUGMENTATION_DIR, OPTIMIZE, OUTPUT_FORMAT, PORT, PREFIX, PURGE, REACT_INTL_MESSAGES_DIR, REMOTE_DICTIONARIES_DIR, REQUIRED_LOCALES, ROUTING_MODE, SERVER_SET_COOKIE, STORAGE, STRICT_MODE, TEMP_DIR, TRAVERSE_PATTERN, TYPES_DIR, TYPE_CHECKING, UNMERGED_DICTIONARIES_DIR, WATCH };
+export { ANALYTICS_ENABLED, ANALYTICS_FLUSH_INTERVAL, ANALYTICS_SAMPLE_RATE, APPLICATION_URL, BACKEND_URL, BASE_PATH, BUILD_MODE, CACHE, CACHE_DIR, CHUNK_GROUPING, CMS_URL, CODE_DIR, COMPILER_DICTIONARY_KEY_PREFIX, COMPILER_ENABLED, COMPILER_NO_METADATA, COMPILER_SAVE_COMPONENTS, CONFIG_DIR, CONTENT_AUTO_TRANSFORMATION, CONTENT_DIR, COOKIE_NAME, DEFAULT_LOCALE, DICTIONARIES_DIR, DICTIONARIES_PRELOAD, DICTIONARY_PRIORITY_STRATEGY, DYNAMIC_DICTIONARIES_DIR, DYNAMIC_DICTIONARIES_JSON_SUBDIR, DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER, EDITOR_URL, ENABLE_PROXY, EXCLUDED_PATHS, FETCH_DICTIONARIES_DIR, FILE_EXTENSIONS, FILL, HEADER_NAME, I18NEXT_DICTIONARIES_DIR, IMPORT_MODE, IS_ENABLED, LIVE_SYNC, LIVE_SYNC_PORT, LOCALES, LOCALE_STORAGE_NAME, LOCATION, MAIN_DIR, MASKS_DIR, MINIFY, MODE, MODULE_AUGMENTATION_DIR, OPTIMIZE, OUTPUT_FORMAT, PORT, PREFIX, PRELOADED_DYNAMIC_KEY, PURGE, QUALIFIER_DYNAMIC_TYPES_KEY, REACT_INTL_MESSAGES_DIR, REMOTE_DICTIONARIES_DIR, REQUIRED_LOCALES, ROUTING_MODE, SERVER_SET_COOKIE, STORAGE, STRICT_MODE, TEMP_DIR, TRAVERSE_PATTERN, TYPES_DIR, TYPE_CHECKING, UNMERGED_DICTIONARIES_DIR, WATCH };

package/dist/esm/dictionaryPreload.mjs

@@ -0,0 +1,144 @@
+import { DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER, PRELOADED_DYNAMIC_KEY, QUALIFIER_DYNAMIC_TYPES_KEY } from "./defaultValues/dictionary.mjs";
+import { dirname, resolve } from "node:path";
+
+//#region src/dictionaryPreload.ts
+/**
+* Matches a generated dynamic entry point, whose layout is
+* `<dynamicDictionariesDir>/<key>.mjs`. The per-locale JSON chunks it imports
+* live one directory deeper, under `json/`, and are deliberately excluded.
+*/
+const DYNAMIC_ENTRY_PATTERN = /\/(?<key>[^/]+)\.mjs$/;
+/** Escapes a literal path segment for embedding in a regular expression. */
+const escapeRegExp = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+/**
+* Builds a filter matching only the generated dynamic entry points, for
+* bundlers whose load hook is selected by a regular expression over the raw
+* file path (esbuild).
+*
+* A hook registered on every `.mjs` would call back into JavaScript for each
+* such file in the build, `node_modules` included, so the filter is anchored on
+* the dictionaries directory name. It matches both path separators because
+* esbuild tests the platform path, which is backslash-separated on Windows —
+* the directory name itself never contains one.
+*
+* The name alone is not proof of location, so the callback must still confirm
+* the full path lies inside `dynamicDictionariesDir`.
+*
+* @param dynamicDictionariesDir - Absolute dictionaries root, any separator.
+*/
+const createDynamicEntryFilter = (dynamicDictionariesDir) => {
+	const directoryName = dynamicDictionariesDir.split(/[\\/]/).filter(Boolean).pop() ?? "";
+	return new RegExp(`[\\\\/]${escapeRegExp(directoryName)}[\\\\/][^\\\\/]+\\.mjs$`);
+};
+/**
+* Specifier of the module the injected preamble reads the locale from, as the
+* bundler plugins are expected to resolve it.
+*
+* Never emitted as-is: a generated entry point lives in the *application's*
+* `.intlayer` directory, and an application depends on `intlayer` and its
+* framework binding — not on `@intlayer/core` — so a bare specifier would
+* resolve from a directory where the package is absent, or, worse, silently
+* hit an unrelated copy hoisted higher up the tree.
+*/
+const PRELOAD_MODULE_SPECIFIER = "@intlayer/core/localization";
+/** Package and subpath {@link PRELOAD_MODULE_SPECIFIER} is composed of. */
+const PRELOAD_PACKAGE_NAME = "@intlayer/core";
+const PRELOAD_PACKAGE_SUBPATH = "./localization";
+/**
+* Resolves {@link PRELOAD_MODULE_SPECIFIER} to an absolute id the injected
+* preamble can import, from a package that actually depends on it.
+*
+* Deliberately not `require.resolve(PRELOAD_MODULE_SPECIFIER)`: that applies
+* the `require` condition and lands on the package's CommonJS build, which the
+* preamble would then pull into a *browser* bundle behind a CommonJS interop
+* wrapper — a second copy of the module alongside the ESM one the application
+* already imports, each with its own memoized locale. The manifest is resolved
+* instead (a condition-free subpath) and its `import` entry read directly.
+*
+* @param requireFn - `require`, or `createRequire(import.meta.url)`, from the
+*   plugin package.
+* @returns Absolute path to the ESM build, falling back to whatever the
+*   standard resolution yields if the package ever stops publishing one.
+*/
+const resolvePreloadModuleId = (requireFn) => {
+	const manifestPath = requireFn.resolve(`${PRELOAD_PACKAGE_NAME}/package.json`);
+	const subpathExport = requireFn(manifestPath).exports?.[PRELOAD_PACKAGE_SUBPATH];
+	const esmEntry = typeof subpathExport === "string" ? subpathExport : subpathExport?.import;
+	if (!esmEntry) return requireFn.resolve(PRELOAD_MODULE_SPECIFIER);
+	return resolve(dirname(manifestPath), esmEntry);
+};
+/**
+* Builds the import the injected preamble relies on, hoisted ahead of the
+* generated source.
+*
+* @param preloadModuleId - Specifier resolving to {@link PRELOAD_MODULE_SPECIFIER}
+*   from the plugin package, which does depend on it.
+*/
+const buildPreloadImport = (preloadModuleId) => `import { getPreloadLocale as __intlayerGetPreloadLocale } from '${preloadModuleId}';\n`;
+/**
+* Preamble appended to a generated dynamic entry point.
+*
+* The load is started while the entry point evaluates, but is deliberately
+* *not* awaited at the top level. Awaiting would make the entry point an async
+* module, which delays the resolution of every chunk that statically imports
+* it — including the chunks behind a `React.lazy` boundary. A boundary whose
+* module resolves that late during hydration stays on its fallback for good:
+* the framework has already swapped the server markup for the pending state and
+* does not retry, so the section never appears. Starting the request here and
+* letting the reader pick the result up keeps the whole benefit of the early
+* fetch without ever holding up module evaluation.
+*
+* The gain is in *when* the request starts: it leaves as soon as the chunk that
+* needs the dictionary is evaluated — on a router's `import()` of a route,
+* including a preload on hover — rather than once the consuming component
+* renders. By the time the reader runs, the marker is usually already set and
+* the read is synchronous, so no loading state is revealed.
+*
+* Only the resolved locale is requested, so a page still downloads exactly the
+* language it renders.
+*
+* A failed load is swallowed: leaving the marker unset drops the read back onto
+* the asynchronous path, where the existing loading state surfaces the error.
+*/
+const PRELOAD_PREAMBLE = [
+	"",
+	"// Injected by Intlayer: starts the browsing locale load with this module.",
+	"const __intlayerLocale = __intlayerGetPreloadLocale();",
+	`const __intlayerLoader = ${DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER}[__intlayerLocale];`,
+	"",
+	`if (typeof window !== 'undefined' && typeof __intlayerLoader === 'function') {`,
+	"  __intlayerLoader().then(",
+	"    (__intlayerDictionary) => {",
+	`      ${DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER}['${PRELOADED_DYNAMIC_KEY}'] = {`,
+	"        locale: __intlayerLocale,",
+	"        dictionary: __intlayerDictionary,",
+	"      };",
+	"    },",
+	"    () => undefined",
+	"  );",
+	"}",
+	""
+].join("\n");
+/**
+* Adds the browsing-locale preload to a generated dynamic entry point.
+*
+* Bundler-agnostic on purpose: the Vite plugin and the esbuild plugin apply the
+* identical transform, and keeping one implementation means the emitted shape
+* cannot drift between them. The caller decides *which* modules to hand over
+* (the id is matched against the dynamic dictionaries directory) and how to
+* report a skip.
+*
+* @param code - Source of the generated `<key>.mjs` entry point.
+* @param preloadModuleId - Specifier the preamble imports the locale resolver
+*   from, already resolved against the plugin package.
+* @returns The transformed source, or the reason it was left alone.
+*/
+const addDynamicEntryPreload = (code, preloadModuleId) => {
+	if (code.includes("__intlayerQualifierTypes")) return { skipped: "qualified" };
+	if (!code.includes(`const ${"content"} =`)) return { skipped: "unrecognized-shape" };
+	return { code: buildPreloadImport(preloadModuleId) + code + PRELOAD_PREAMBLE };
+};
+
+//#endregion
+export { DYNAMIC_ENTRY_PATTERN, PRELOAD_MODULE_SPECIFIER, addDynamicEntryPreload, createDynamicEntryFilter, resolvePreloadModuleId };
+//# sourceMappingURL=dictionaryPreload.mjs.map

package/dist/esm/dictionaryPreload.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictionaryPreload.mjs","names":[],"sources":["../../src/dictionaryPreload.ts"],"sourcesContent":["import { dirname, resolve } from 'node:path';\nimport {\n  DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER,\n  PRELOADED_DYNAMIC_KEY,\n  QUALIFIER_DYNAMIC_TYPES_KEY,\n} from './defaultValues/dictionary';\n\n/**\n * Matches a generated dynamic entry point, whose layout is\n * `<dynamicDictionariesDir>/<key>.mjs`. The per-locale JSON chunks it imports\n * live one directory deeper, under `json/`, and are deliberately excluded.\n */\nexport const DYNAMIC_ENTRY_PATTERN = /\\/(?<key>[^/]+)\\.mjs$/;\n\n/** Escapes a literal path segment for embedding in a regular expression. */\nconst escapeRegExp = (value: string): string =>\n  value.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n\n/**\n * Builds a filter matching only the generated dynamic entry points, for\n * bundlers whose load hook is selected by a regular expression over the raw\n * file path (esbuild).\n *\n * A hook registered on every `.mjs` would call back into JavaScript for each\n * such file in the build, `node_modules` included, so the filter is anchored on\n * the dictionaries directory name. It matches both path separators because\n * esbuild tests the platform path, which is backslash-separated on Windows —\n * the directory name itself never contains one.\n *\n * The name alone is not proof of location, so the callback must still confirm\n * the full path lies inside `dynamicDictionariesDir`.\n *\n * @param dynamicDictionariesDir - Absolute dictionaries root, any separator.\n */\nexport const createDynamicEntryFilter = (\n  dynamicDictionariesDir: string\n): RegExp => {\n  const directoryName =\n    dynamicDictionariesDir.split(/[\\\\/]/).filter(Boolean).pop() ?? '';\n\n  return new RegExp(\n    `[\\\\\\\\/]${escapeRegExp(directoryName)}[\\\\\\\\/][^\\\\\\\\/]+\\\\.mjs$`\n  );\n};\n\n/**\n * Specifier of the module the injected preamble reads the locale from, as the\n * bundler plugins are expected to resolve it.\n *\n * Never emitted as-is: a generated entry point lives in the *application's*\n * `.intlayer` directory, and an application depends on `intlayer` and its\n * framework binding — not on `@intlayer/core` — so a bare specifier would\n * resolve from a directory where the package is absent, or, worse, silently\n * hit an unrelated copy hoisted higher up the tree.\n */\nexport const PRELOAD_MODULE_SPECIFIER = '@intlayer/core/localization';\n\n/** Package and subpath {@link PRELOAD_MODULE_SPECIFIER} is composed of. */\nconst PRELOAD_PACKAGE_NAME = '@intlayer/core';\nconst PRELOAD_PACKAGE_SUBPATH = './localization';\n\n/** The subset of a `package.json` this resolution reads. */\ntype PackageManifest = {\n  exports?: Record<string, { import?: string } | string | undefined>;\n};\n\n/**\n * Resolves {@link PRELOAD_MODULE_SPECIFIER} to an absolute id the injected\n * preamble can import, from a package that actually depends on it.\n *\n * Deliberately not `require.resolve(PRELOAD_MODULE_SPECIFIER)`: that applies\n * the `require` condition and lands on the package's CommonJS build, which the\n * preamble would then pull into a *browser* bundle behind a CommonJS interop\n * wrapper — a second copy of the module alongside the ESM one the application\n * already imports, each with its own memoized locale. The manifest is resolved\n * instead (a condition-free subpath) and its `import` entry read directly.\n *\n * @param requireFn - `require`, or `createRequire(import.meta.url)`, from the\n *   plugin package.\n * @returns Absolute path to the ESM build, falling back to whatever the\n *   standard resolution yields if the package ever stops publishing one.\n */\nexport const resolvePreloadModuleId = (requireFn: NodeRequire): string => {\n  const manifestPath = requireFn.resolve(\n    `${PRELOAD_PACKAGE_NAME}/package.json`\n  );\n  const manifest = requireFn(manifestPath) as PackageManifest;\n  const subpathExport = manifest.exports?.[PRELOAD_PACKAGE_SUBPATH];\n\n  const esmEntry =\n    typeof subpathExport === 'string' ? subpathExport : subpathExport?.import;\n\n  if (!esmEntry) return requireFn.resolve(PRELOAD_MODULE_SPECIFIER);\n\n  return resolve(dirname(manifestPath), esmEntry);\n};\n\n/**\n * Builds the import the injected preamble relies on, hoisted ahead of the\n * generated source.\n *\n * @param preloadModuleId - Specifier resolving to {@link PRELOAD_MODULE_SPECIFIER}\n *   from the plugin package, which does depend on it.\n */\nconst buildPreloadImport = (preloadModuleId: string): string =>\n  `import { getPreloadLocale as __intlayerGetPreloadLocale } from '${preloadModuleId}';\\n`;\n\n/**\n * Preamble appended to a generated dynamic entry point.\n *\n * The load is started while the entry point evaluates, but is deliberately\n * *not* awaited at the top level. Awaiting would make the entry point an async\n * module, which delays the resolution of every chunk that statically imports\n * it — including the chunks behind a `React.lazy` boundary. A boundary whose\n * module resolves that late during hydration stays on its fallback for good:\n * the framework has already swapped the server markup for the pending state and\n * does not retry, so the section never appears. Starting the request here and\n * letting the reader pick the result up keeps the whole benefit of the early\n * fetch without ever holding up module evaluation.\n *\n * The gain is in *when* the request starts: it leaves as soon as the chunk that\n * needs the dictionary is evaluated — on a router's `import()` of a route,\n * including a preload on hover — rather than once the consuming component\n * renders. By the time the reader runs, the marker is usually already set and\n * the read is synchronous, so no loading state is revealed.\n *\n * Only the resolved locale is requested, so a page still downloads exactly the\n * language it renders.\n *\n * A failed load is swallowed: leaving the marker unset drops the read back onto\n * the asynchronous path, where the existing loading state surfaces the error.\n */\nconst PRELOAD_PREAMBLE = [\n  '',\n  '// Injected by Intlayer: starts the browsing locale load with this module.',\n  'const __intlayerLocale = __intlayerGetPreloadLocale();',\n  `const __intlayerLoader = ${DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER}[__intlayerLocale];`,\n  '',\n  `if (typeof window !== 'undefined' && typeof __intlayerLoader === 'function') {`,\n  '  __intlayerLoader().then(',\n  '    (__intlayerDictionary) => {',\n  `      ${DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER}['${PRELOADED_DYNAMIC_KEY}'] = {`,\n  '        locale: __intlayerLocale,',\n  '        dictionary: __intlayerDictionary,',\n  '      };',\n  '    },',\n  '    () => undefined',\n  '  );',\n  '}',\n  '',\n].join('\\n');\n\n/** Why a generated entry point was left untransformed. */\nexport type PreloadSkipReason = 'qualified' | 'unrecognized-shape';\n\nexport type PreloadTransformResult =\n  | { code: string; skipped?: undefined }\n  | { code?: undefined; skipped: PreloadSkipReason };\n\n/**\n * Adds the browsing-locale preload to a generated dynamic entry point.\n *\n * Bundler-agnostic on purpose: the Vite plugin and the esbuild plugin apply the\n * identical transform, and keeping one implementation means the emitted shape\n * cannot drift between them. The caller decides *which* modules to hand over\n * (the id is matched against the dynamic dictionaries directory) and how to\n * report a skip.\n *\n * @param code - Source of the generated `<key>.mjs` entry point.\n * @param preloadModuleId - Specifier the preamble imports the locale resolver\n *   from, already resolved against the plugin package.\n * @returns The transformed source, or the reason it was left alone.\n */\nexport const addDynamicEntryPreload = (\n  code: string,\n  preloadModuleId: string\n): PreloadTransformResult => {\n  // Qualified entry points (collections, variants) expose a nested tree of\n  // loaders per locale rather than one loader, so preloading them would have to\n  // guess which coordinate the call site targets — and would fetch every chunk\n  // to avoid guessing wrong.\n  if (code.includes(QUALIFIER_DYNAMIC_TYPES_KEY)) {\n    return { skipped: 'qualified' };\n  }\n\n  // The preamble mutates the generated binding; if the code generator ever\n  // stops emitting it, skipping keeps the build correct (and merely\n  // unoptimized) instead of emitting a reference error.\n  if (!code.includes(`const ${DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER} =`)) {\n    return { skipped: 'unrecognized-shape' };\n  }\n\n  return {\n    code: buildPreloadImport(preloadModuleId) + code + PRELOAD_PREAMBLE,\n  };\n};\n"],"mappings":";;;;;;;;;AAYA,MAAa,wBAAwB;;AAGrC,MAAM,gBAAgB,UACpB,MAAM,QAAQ,uBAAuB,MAAM;;;;;;;;;;;;;;;;;AAkB7C,MAAa,4BACX,2BACW;CACX,MAAM,gBACJ,uBAAuB,MAAM,OAAO,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,IAAI,KAAK;CAEjE,OAAO,IAAI,OACT,UAAU,aAAa,aAAa,EAAE,wBACxC;AACF;;;;;;;;;;;AAYA,MAAa,2BAA2B;;AAGxC,MAAM,uBAAuB;AAC7B,MAAM,0BAA0B;;;;;;;;;;;;;;;;;AAuBhC,MAAa,0BAA0B,cAAmC;CACxE,MAAM,eAAe,UAAU,QAC7B,GAAG,qBAAqB,cAC1B;CAEA,MAAM,gBADW,UAAU,YACE,CAAC,CAAC,UAAU;CAEzC,MAAM,WACJ,OAAO,kBAAkB,WAAW,gBAAgB,eAAe;CAErE,IAAI,CAAC,UAAU,OAAO,UAAU,QAAQ,wBAAwB;CAEhE,OAAO,QAAQ,QAAQ,YAAY,GAAG,QAAQ;AAChD;;;;;;;;AASA,MAAM,sBAAsB,oBAC1B,mEAAmE,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BrF,MAAM,mBAAmB;CACvB;CACA;CACA;CACA,4BAA4B,oCAAoC;CAChE;CACA;CACA;CACA;CACA,SAAS,oCAAoC,IAAI,sBAAsB;CACvE;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF,CAAC,CAAC,KAAK,IAAI;;;;;;;;;;;;;;;AAuBX,MAAa,0BACX,MACA,oBAC2B;CAK3B,IAAI,KAAK,mCAAoC,GAC3C,OAAO,EAAE,SAAS,YAAY;CAMhC,IAAI,CAAC,KAAK,SAAS,mBAA6C,GAAG,GACjE,OAAO,EAAE,SAAS,qBAAqB;CAGzC,OAAO,EACL,MAAM,mBAAmB,eAAe,IAAI,OAAO,iBACrD;AACF"}

package/dist/types/configFile/buildConfigurationFields.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buildConfigurationFields.d.ts","names":[],"sources":["../../../src/configFile/buildConfigurationFields.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;cA4uBa,2BAAwB,sBACb,sBAAoB,kBAC1B,eACD,iBACd"}
+{"version":3,"file":"buildConfigurationFields.d.ts","names":[],"sources":["../../../src/configFile/buildConfigurationFields.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;cAywBa,2BAAwB,sBACb,sBAAoB,kBAC1B,eACD,iBACd"}

package/dist/types/defaultValues/build.d.ts

@@ -7,6 +7,8 @@ declare const CACHE = true;
 declare const TYPE_CHECKING = false;
 declare const MINIFY = false;
 declare const PURGE = false;
+declare const CHUNK_GROUPING = true;
+declare const DICTIONARIES_PRELOAD = true;
 //#endregion
-export { BUILD_MODE, CACHE, MINIFY, OPTIMIZE, OUTPUT_FORMAT, PURGE, TRAVERSE_PATTERN, TYPE_CHECKING };
+export { BUILD_MODE, CACHE, CHUNK_GROUPING, DICTIONARIES_PRELOAD, MINIFY, OPTIMIZE, OUTPUT_FORMAT, PURGE, TRAVERSE_PATTERN, TYPE_CHECKING };
 //# sourceMappingURL=build.d.ts.map

package/dist/types/defaultValues/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","names":[],"sources":["../../../src/defaultValues/build.ts"],"mappings":";cAAa;cAEA;cAEA;cA0BA;cAEA;cAEA;cAEA;cAEA"}
+{"version":3,"file":"build.d.ts","names":[],"sources":["../../../src/defaultValues/build.ts"],"mappings":";cAAa;cAEA;cAEA;cA0BA;cAEA;cAEA;cAEA;cAEA;cAEA;cAEA"}

package/dist/types/defaultValues/dictionary.d.ts

@@ -4,6 +4,43 @@ declare const FILL = true;
 declare const LOCATION: DictionaryLocation;
 declare const CONTENT_AUTO_TRANSFORMATION = false;
 declare const IMPORT_MODE = "static";
+/**
+ * Directory the per-locale JSON chunks of `importMode: 'dynamic'` are written
+ * under, relative to `system.dynamicDictionariesDir`.
+ *
+ * Plain dictionaries land at `<subdir>/<key>/<locale>.json`, qualified ones
+ * (collections, variants) nest one directory per dimension in between. The
+ * static first segment is required by Turbopack, and build-tool plugins match
+ * module ids against this layout — hence the shared constant rather than a
+ * literal repeated on both sides.
+ */
+declare const DYNAMIC_DICTIONARIES_JSON_SUBDIR = "json";
+/**
+ * Marker property carrying the ordered qualifier dimensions on a dynamic loader
+ * map. Its presence distinguishes a qualified group loader map (a nested tree
+ * of chunks) from a plain dynamic loader map (one chunk per `locale`). Prefixed
+ * and unlikely to collide with a real locale code.
+ */
+declare const QUALIFIER_DYNAMIC_TYPES_KEY = "__intlayerQualifierTypes";
+/**
+ * Marker property carrying the dictionary a generated dynamic entry point
+ * already resolved for the browsing locale, before any component rendered.
+ *
+ * Build-tool plugins prepend a top-level `await` to those entry points, so the
+ * chunk that statically imports one only finishes evaluating once the awaited
+ * locale chunk has landed. A read during render then finds the content in place
+ * instead of suspending.
+ */
+declare const PRELOADED_DYNAMIC_KEY = "__intlayerPreloaded";
+/**
+ * Name of the local binding a generated dynamic entry point holds its loader
+ * map in, before exporting it as default.
+ *
+ * The preload preamble is appended to that generated source and mutates the
+ * binding, so the code generator and the build plugins have to agree on the
+ * name — hence the shared constant rather than a literal repeated in both.
+ */
+declare const DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER = "content";
 //#endregion
-export { CONTENT_AUTO_TRANSFORMATION, FILL, IMPORT_MODE, LOCATION };
+export { CONTENT_AUTO_TRANSFORMATION, DYNAMIC_DICTIONARIES_JSON_SUBDIR, DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER, FILL, IMPORT_MODE, LOCATION, PRELOADED_DYNAMIC_KEY, QUALIFIER_DYNAMIC_TYPES_KEY };
 //# sourceMappingURL=dictionary.d.ts.map

package/dist/types/defaultValues/dictionary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dictionary.d.ts","names":[],"sources":["../../../src/defaultValues/dictionary.ts"],"mappings":";;cAEa;cACA,UAAU;cACV;cACA"}
+{"version":3,"file":"dictionary.d.ts","names":[],"sources":["../../../src/defaultValues/dictionary.ts"],"mappings":";;cAEa;cACA,UAAU;cACV;cACA;;;;;;;;;;;cAYA;;;;;;;cAQA;;;;;;;;;;cAWA;;;;;;;;;cAUA"}

package/dist/types/defaultValues/index.d.ts

@@ -1,11 +1,11 @@
 import { ANALYTICS_ENABLED, ANALYTICS_FLUSH_INTERVAL, ANALYTICS_SAMPLE_RATE } from "./analytics.js";
-import { BUILD_MODE, CACHE, MINIFY, OPTIMIZE, OUTPUT_FORMAT, PURGE, TRAVERSE_PATTERN, TYPE_CHECKING } from "./build.js";
+import { BUILD_MODE, CACHE, CHUNK_GROUPING, DICTIONARIES_PRELOAD, MINIFY, OPTIMIZE, OUTPUT_FORMAT, PURGE, TRAVERSE_PATTERN, TYPE_CHECKING } from "./build.js";
 import { COMPILER_DICTIONARY_KEY_PREFIX, COMPILER_ENABLED, COMPILER_NO_METADATA, COMPILER_SAVE_COMPONENTS } from "./compiler.js";
 import { CODE_DIR, CONTENT_DIR, EXCLUDED_PATHS, FILE_EXTENSIONS, I18NEXT_DICTIONARIES_DIR, REACT_INTL_MESSAGES_DIR, WATCH } from "./content.js";
-import { CONTENT_AUTO_TRANSFORMATION, FILL, IMPORT_MODE, LOCATION } from "./dictionary.js";
+import { CONTENT_AUTO_TRANSFORMATION, DYNAMIC_DICTIONARIES_JSON_SUBDIR, DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER, FILL, IMPORT_MODE, LOCATION, PRELOADED_DYNAMIC_KEY, QUALIFIER_DYNAMIC_TYPES_KEY } from "./dictionary.js";
 import { APPLICATION_URL, BACKEND_URL, CMS_URL, DICTIONARY_PRIORITY_STRATEGY, EDITOR_URL, IS_ENABLED, LIVE_SYNC, LIVE_SYNC_PORT, PORT } from "./editor.js";
 import { DEFAULT_LOCALE, LOCALES, REQUIRED_LOCALES, STRICT_MODE } from "./internationalization.js";
 import { MODE, PREFIX } from "./log.js";
 import { BASE_PATH, COOKIE_NAME, ENABLE_PROXY, HEADER_NAME, LOCALE_STORAGE_NAME, ROUTING_MODE, SERVER_SET_COOKIE, STORAGE } from "./routing.js";
 import { CACHE_DIR, CONFIG_DIR, DICTIONARIES_DIR, DYNAMIC_DICTIONARIES_DIR, FETCH_DICTIONARIES_DIR, MAIN_DIR, MASKS_DIR, MODULE_AUGMENTATION_DIR, REMOTE_DICTIONARIES_DIR, TEMP_DIR, TYPES_DIR, UNMERGED_DICTIONARIES_DIR } from "./system.js";
-export { ANALYTICS_ENABLED, ANALYTICS_FLUSH_INTERVAL, ANALYTICS_SAMPLE_RATE, APPLICATION_URL, BACKEND_URL, BASE_PATH, BUILD_MODE, CACHE, CACHE_DIR, CMS_URL, CODE_DIR, COMPILER_DICTIONARY_KEY_PREFIX, COMPILER_ENABLED, COMPILER_NO_METADATA, COMPILER_SAVE_COMPONENTS, CONFIG_DIR, CONTENT_AUTO_TRANSFORMATION, CONTENT_DIR, COOKIE_NAME, DEFAULT_LOCALE, DICTIONARIES_DIR, DICTIONARY_PRIORITY_STRATEGY, DYNAMIC_DICTIONARIES_DIR, EDITOR_URL, ENABLE_PROXY, EXCLUDED_PATHS, FETCH_DICTIONARIES_DIR, FILE_EXTENSIONS, FILL, HEADER_NAME, I18NEXT_DICTIONARIES_DIR, IMPORT_MODE, IS_ENABLED, LIVE_SYNC, LIVE_SYNC_PORT, LOCALES, LOCALE_STORAGE_NAME, LOCATION, MAIN_DIR, MASKS_DIR, MINIFY, MODE, MODULE_AUGMENTATION_DIR, OPTIMIZE, OUTPUT_FORMAT, PORT, PREFIX, PURGE, REACT_INTL_MESSAGES_DIR, REMOTE_DICTIONARIES_DIR, REQUIRED_LOCALES, ROUTING_MODE, SERVER_SET_COOKIE, STORAGE, STRICT_MODE, TEMP_DIR, TRAVERSE_PATTERN, TYPES_DIR, TYPE_CHECKING, UNMERGED_DICTIONARIES_DIR, WATCH };
+export { ANALYTICS_ENABLED, ANALYTICS_FLUSH_INTERVAL, ANALYTICS_SAMPLE_RATE, APPLICATION_URL, BACKEND_URL, BASE_PATH, BUILD_MODE, CACHE, CACHE_DIR, CHUNK_GROUPING, CMS_URL, CODE_DIR, COMPILER_DICTIONARY_KEY_PREFIX, COMPILER_ENABLED, COMPILER_NO_METADATA, COMPILER_SAVE_COMPONENTS, CONFIG_DIR, CONTENT_AUTO_TRANSFORMATION, CONTENT_DIR, COOKIE_NAME, DEFAULT_LOCALE, DICTIONARIES_DIR, DICTIONARIES_PRELOAD, DICTIONARY_PRIORITY_STRATEGY, DYNAMIC_DICTIONARIES_DIR, DYNAMIC_DICTIONARIES_JSON_SUBDIR, DYNAMIC_ENTRY_LOADER_MAP_IDENTIFIER, EDITOR_URL, ENABLE_PROXY, EXCLUDED_PATHS, FETCH_DICTIONARIES_DIR, FILE_EXTENSIONS, FILL, HEADER_NAME, I18NEXT_DICTIONARIES_DIR, IMPORT_MODE, IS_ENABLED, LIVE_SYNC, LIVE_SYNC_PORT, LOCALES, LOCALE_STORAGE_NAME, LOCATION, MAIN_DIR, MASKS_DIR, MINIFY, MODE, MODULE_AUGMENTATION_DIR, OPTIMIZE, OUTPUT_FORMAT, PORT, PREFIX, PRELOADED_DYNAMIC_KEY, PURGE, QUALIFIER_DYNAMIC_TYPES_KEY, REACT_INTL_MESSAGES_DIR, REMOTE_DICTIONARIES_DIR, REQUIRED_LOCALES, ROUTING_MODE, SERVER_SET_COOKIE, STORAGE, STRICT_MODE, TEMP_DIR, TRAVERSE_PATTERN, TYPES_DIR, TYPE_CHECKING, UNMERGED_DICTIONARIES_DIR, WATCH };

package/dist/types/dictionaryPreload.d.ts

@@ -0,0 +1,79 @@
+//#region src/dictionaryPreload.d.ts
+/**
+ * Matches a generated dynamic entry point, whose layout is
+ * `<dynamicDictionariesDir>/<key>.mjs`. The per-locale JSON chunks it imports
+ * live one directory deeper, under `json/`, and are deliberately excluded.
+ */
+declare const DYNAMIC_ENTRY_PATTERN: RegExp;
+/**
+ * Builds a filter matching only the generated dynamic entry points, for
+ * bundlers whose load hook is selected by a regular expression over the raw
+ * file path (esbuild).
+ *
+ * A hook registered on every `.mjs` would call back into JavaScript for each
+ * such file in the build, `node_modules` included, so the filter is anchored on
+ * the dictionaries directory name. It matches both path separators because
+ * esbuild tests the platform path, which is backslash-separated on Windows —
+ * the directory name itself never contains one.
+ *
+ * The name alone is not proof of location, so the callback must still confirm
+ * the full path lies inside `dynamicDictionariesDir`.
+ *
+ * @param dynamicDictionariesDir - Absolute dictionaries root, any separator.
+ */
+declare const createDynamicEntryFilter: (dynamicDictionariesDir: string) => RegExp;
+/**
+ * Specifier of the module the injected preamble reads the locale from, as the
+ * bundler plugins are expected to resolve it.
+ *
+ * Never emitted as-is: a generated entry point lives in the *application's*
+ * `.intlayer` directory, and an application depends on `intlayer` and its
+ * framework binding — not on `@intlayer/core` — so a bare specifier would
+ * resolve from a directory where the package is absent, or, worse, silently
+ * hit an unrelated copy hoisted higher up the tree.
+ */
+declare const PRELOAD_MODULE_SPECIFIER = "@intlayer/core/localization";
+/**
+ * Resolves {@link PRELOAD_MODULE_SPECIFIER} to an absolute id the injected
+ * preamble can import, from a package that actually depends on it.
+ *
+ * Deliberately not `require.resolve(PRELOAD_MODULE_SPECIFIER)`: that applies
+ * the `require` condition and lands on the package's CommonJS build, which the
+ * preamble would then pull into a *browser* bundle behind a CommonJS interop
+ * wrapper — a second copy of the module alongside the ESM one the application
+ * already imports, each with its own memoized locale. The manifest is resolved
+ * instead (a condition-free subpath) and its `import` entry read directly.
+ *
+ * @param requireFn - `require`, or `createRequire(import.meta.url)`, from the
+ *   plugin package.
+ * @returns Absolute path to the ESM build, falling back to whatever the
+ *   standard resolution yields if the package ever stops publishing one.
+ */
+declare const resolvePreloadModuleId: (requireFn: NodeRequire) => string;
+/** Why a generated entry point was left untransformed. */
+type PreloadSkipReason = 'qualified' | 'unrecognized-shape';
+type PreloadTransformResult = {
+  code: string;
+  skipped?: undefined;
+} | {
+  code?: undefined;
+  skipped: PreloadSkipReason;
+};
+/**
+ * Adds the browsing-locale preload to a generated dynamic entry point.
+ *
+ * Bundler-agnostic on purpose: the Vite plugin and the esbuild plugin apply the
+ * identical transform, and keeping one implementation means the emitted shape
+ * cannot drift between them. The caller decides *which* modules to hand over
+ * (the id is matched against the dynamic dictionaries directory) and how to
+ * report a skip.
+ *
+ * @param code - Source of the generated `<key>.mjs` entry point.
+ * @param preloadModuleId - Specifier the preamble imports the locale resolver
+ *   from, already resolved against the plugin package.
+ * @returns The transformed source, or the reason it was left alone.
+ */
+declare const addDynamicEntryPreload: (code: string, preloadModuleId: string) => PreloadTransformResult;
+//#endregion
+export { DYNAMIC_ENTRY_PATTERN, PRELOAD_MODULE_SPECIFIER, PreloadSkipReason, PreloadTransformResult, addDynamicEntryPreload, createDynamicEntryFilter, resolvePreloadModuleId };
+//# sourceMappingURL=dictionaryPreload.d.ts.map

package/dist/types/dictionaryPreload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dictionaryPreload.d.ts","names":[],"sources":["../../src/dictionaryPreload.ts"],"mappings":";;;;;;cAYa,uBAAqB;;;;;;;;;;;;;;;;;cAsBrB,2BAAwB,mCAElC;;;;;;;;;;;cAmBU;;;;;;;;;;;;;;;;;cA2BA,yBAAsB,WAAe;;KAuEtC;KAEA;EACN;EAAc;;EACd;EAAkB,SAAS;;;;;;;;;;;;;;;;cAgBpB,yBAAsB,cACrB,4BAEX"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intlayer/config",
-  "version": "9.3.2",
+  "version": "9.3.3",
   "private": false,
   "description": "Retrieve Intlayer configurations and manage environment variables for both server-side and client-side environments.",
   "keywords": [
@@ -97,6 +97,11 @@
       "require": "./dist/cjs/defaultValues/index.cjs",
       "import": "./dist/esm/defaultValues/index.mjs"
     },
+    "./dictionaryPreload": {
+      "types": "./dist/types/dictionaryPreload.d.ts",
+      "require": "./dist/cjs/dictionaryPreload.cjs",
+      "import": "./dist/esm/dictionaryPreload.mjs"
+    },
     "./bundle": {
       "types": "./dist/types/bundle/index.d.ts",
       "require": "./dist/cjs/bundle/index.cjs",
@@ -172,7 +177,7 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/types": "9.3.2",
+    "@intlayer/types": "9.3.3",
     "defu": "6.1.7",
     "dotenv": "17.4.2",
     "esbuild": "0.28.2",
@@ -187,7 +192,7 @@
     "rimraf": "6.1.3",
     "tsdown": "0.22.14",
     "typescript": "7.0.2",
-    "vitest": "4.1.10"
+    "vitest": "4.1.11"
   },
   "peerDependencies": {
     "react": ">=16.0.0"