vite-intlayer 9.1.2 → 9.2.0

package/dist/esm/intlayerPlugin.mjs

@@ -10,6 +10,7 @@ import { colorize, getAppLogger } from "@intlayer/config/logger";
 import { getConfiguration } from "@intlayer/config/node";
 import { getAlias, getHasDictionarySelector, getUnusedNodeTypesAsync } from "@intlayer/config/utils";
 import { formatDictionarySelectorEnvVar, formatNodeTypeToEnvVar, getConfigEnvVars } from "@intlayer/config/envVars";
+import { resolveProxyMode } from "@intlayer/core/localization";
 import { getDictionaries } from "@intlayer/dictionaries-entry";
 import { logConfigDetails } from "@intlayer/engine/logConfigDetails";
 
@@ -102,7 +103,7 @@ const intlayerPlugin = (configOptions) => {
 	plugins.push(intlayerPrune(intlayerConfig, pruneContext));
 	plugins.push(intlayerMinify(intlayerConfig, pruneContext));
 	if (intlayerConfig.compiler?.enabled && intlayerConfig.compiler?.output) plugins.push(intlayerCompiler({ configOptions: getConfigOptions }));
-	if (intlayerConfig.routing.enableProxy) plugins.push(intlayerProxy({
+	if (resolveProxyMode(intlayerConfig.routing.enableProxy) !== "disabled") plugins.push(intlayerProxy({
 		...proxy,
 		configOptions: getConfigOptions
 	}));

package/dist/esm/intlayerPlugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"intlayerPlugin.mjs","names":[],"sources":["../../src/intlayerPlugin.ts"],"sourcesContent":["import { resolve } from 'node:path';\nimport { type CompatCallerConfig, createPruneContext } from '@intlayer/babel';\nimport { BLUE } from '@intlayer/config/colors';\nimport {\n  formatDictionarySelectorEnvVar,\n  formatNodeTypeToEnvVar,\n  getConfigEnvVars,\n} from '@intlayer/config/envVars';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\nimport {\n  getAlias,\n  getHasDictionarySelector,\n  getUnusedNodeTypesAsync,\n} from '@intlayer/config/utils';\nimport { getDictionaries } from '@intlayer/dictionaries-entry';\nimport { logConfigDetails } from '@intlayer/engine/logConfigDetails';\nimport type { PluginOption } from 'vite';\nimport { intlayerCompiler } from './IntlayerCompilerPlugin';\nimport { intlayerMinify } from './intlayerMinifyPlugin';\nimport { intlayerOptimize } from './intlayerOptimizePlugin';\nimport {\n  type IntlayerProxyPluginOptions,\n  intlayerProxy,\n} from './intlayerProxyPlugin';\nimport { intlayerPrune } from './intlayerPrunePlugin';\n\n/**\n * Extended options accepted by the intlayer Vite plugin.\n *\n * Extends {@link GetConfigurationOptions} with compat-adapter caller\n * configurations.  Compat adapter packages (e.g. `@intlayer/react-i18next/plugin`,\n * `@intlayer/vue-i18n/plugin`) inject their own caller configs here so the\n * field-usage analyser can recognise their translation function call patterns\n * and prune unused dictionary fields accordingly.\n */\nexport type IntlayerPluginOptions = GetConfigurationOptions & {\n  /**\n   * Compat-adapter namespace caller configurations to pass to the\n   * field-usage analyser (Vite `buildStart` phase).\n   *\n   * Defined by each compat adapter package; the core `vite-intlayer` package\n   * ships with an empty default to stay framework-agnostic.\n   */\n  compatCallers?: CompatCallerConfig[];\n\n  /**\n   * Options forwarded to the bundled locale-routing proxy (`intlayerProxy`).\n   *\n   * Since Intlayer v9 the proxy is plugged directly into the main `intlayer()`\n   * plugin (controlled by `routing.enableProxy`, `true` by default). These\n   * routing options let you tune that bundled proxy without registering it\n   * separately — e.g. ignore API routes from locale routing.\n   *\n   * @example\n   * ```ts\n   * intlayer({ proxy: { ignore: (req) => req.url?.startsWith('/api') } })\n   * ```\n   */\n  proxy?: Pick<IntlayerProxyPluginOptions, 'ignore'>;\n};\n\n/**\n * Vite plugin that integrates Intlayer into the Vite build process.\n *\n * It handles:\n * 1. Preparing Intlayer resources (dictionaries) before build.\n * 2. Configuring Vite aliases for dictionary access.\n * 3. Setting up dev-server watchers for content changes.\n * 4. Applying build optimizations (tree-shaking dictionaries).\n *\n * @param configOptions - Optional configuration to override default Intlayer settings.\n * @returns A Vite plugin option.\n *\n * @example\n * ```ts\n * import { intlayer } from 'vite-intlayer';\n *\n * export default defineConfig({\n *   plugins: [intlayer()],\n * });\n *\n * ```\n * @deprecated Rename to intlayer instead\n */\nexport const intlayerPlugin = (\n  configOptions?: IntlayerPluginOptions\n): PluginOption => {\n  const { compatCallers, proxy, ...getConfigOptions } = configOptions ?? {};\n  const intlayerConfig = getConfiguration(getConfigOptions);\n  logConfigDetails(getConfigOptions);\n  const appLogger = getAppLogger(intlayerConfig);\n\n  const alias = getAlias({\n    configuration: intlayerConfig,\n    formatter: (value: string) => resolve(value),\n  });\n\n  const aliasPackages = Object.keys(alias);\n\n  const plugins: PluginOption[] = [\n    {\n      name: 'vite-intlayer-plugin',\n\n      apply: (_config, env) => {\n        // Don't apply intlayer plugin during `preview` command\n        const isPreviewCommand =\n          env.command === 'serve' && env.mode === 'production';\n\n        // But if liveSync is enabled, ensure the data are fresh\n        const isLiveSyncEnabled = intlayerConfig.editor.liveSync;\n\n        return !isPreviewCommand || isLiveSyncEnabled;\n      },\n\n      config: async (_config, env) => {\n        const { mode } = intlayerConfig.build;\n\n        const isDevCommand =\n          env.command === 'serve' && env.mode === 'development';\n        const isBuildCommand = env.command === 'build';\n\n        // Only call prepareIntlayer during `dev` or `build` (not during `preview`)\n        // If prod: clean and rebuild once\n        // If dev: rebuild only once if it's more than 1 hour since last rebuild\n        if (isDevCommand || isBuildCommand || mode === 'auto') {\n          // Lazily load the heavy build pipeline (`@intlayer/engine/build`) only\n          // when a rebuild is actually required, keeping the Vite config phase\n          // lightweight (e.g. during `preview`).\n          const { prepareIntlayer } = await import('@intlayer/engine/build');\n\n          // prepareIntlayer use runOnce to ensure to run only once because will run twice on client and server side otherwise\n          await prepareIntlayer(intlayerConfig, {\n            clean: isBuildCommand,\n            cacheTimeoutMs: isBuildCommand\n              ? 1000 * 30 // 30 seconds for build (to ensure to rebuild all dictionaries)\n              : 1000 * 60 * 60, // 1 hour for dev (default cache timeout)\n            env: isBuildCommand ? 'prod' : 'dev',\n          });\n        }\n\n        let define: Record<string, string> = {\n          // Preset an env var to avoid 'process is not defined' error\n          // Needed for some libraries that does not add process.env\n          'process.env.INTLAYER': '\"true\"',\n        };\n\n        if (isBuildCommand) {\n          const dictionaries = getDictionaries(intlayerConfig);\n\n          if (Object.keys(dictionaries).length === 0) {\n            appLogger(\n              'No dictionaries found. Please check your configuration.',\n              {\n                isVerbose: true,\n              }\n            );\n          }\n\n          const unusedNodeTypes = await getUnusedNodeTypesAsync(dictionaries);\n\n          if (unusedNodeTypes.length > 0) {\n            appLogger(\n              [\n                'Filtering out unused logic:',\n                unusedNodeTypes\n                  .filter(\n                    (key) =>\n                      !['reactNode', 'solidNode', 'preactNode'].includes(key)\n                  )\n                  .map((key) => colorize(key, BLUE))\n                  .join(', '),\n              ],\n              {\n                isVerbose: true,\n              }\n            );\n          }\n\n          define = {\n            ...define,\n\n            // Tree shacking env var based on config\n            ...formatNodeTypeToEnvVar(\n              unusedNodeTypes,\n              (key) => `process.env.${key}`,\n              (value) => `\"${value}\"`\n            ),\n\n            // Tree shacking env var for the dictionary selector logic\n            // (collections / variants)\n            ...formatDictionarySelectorEnvVar(\n              getHasDictionarySelector(dictionaries),\n              (key) => `process.env.${key}`,\n              (value) => `\"${value}\"`\n            ),\n\n            // Tree shacking env var based on config\n            ...getConfigEnvVars(\n              intlayerConfig,\n              (key) => `process.env.${key}`,\n              (value) => `\"${value}\"` // Wrap by \"\" to ensure env var set properly\n            ),\n          };\n        }\n\n        // mergeConfig handles both array and record alias formats,\n        // and correctly appends to optimizeDeps.exclude / ssr.noExternal\n        return {\n          define,\n          resolve: {\n            alias,\n          },\n          optimizeDeps: {\n            // Exclude alias entry points since they're local files, not npm packages\n            exclude: aliasPackages,\n          },\n          ssr: {\n            // Ensure intlayer packages are bundled so aliases are applied\n            noExternal: [/(^@intlayer\\/|intlayer$)/],\n          },\n        };\n      },\n\n      configureServer: async (server) => {\n        if (server.config.mode === 'development') {\n          // Lazily load the file watcher (`@intlayer/engine/watcher`, which pulls\n          // in `@parcel/watcher`) only when the dev server actually starts.\n          const { watch } = await import('@intlayer/engine/watcher');\n\n          // Start watching (assuming watch is also async)\n          await watch({ configuration: intlayerConfig });\n        }\n      },\n    },\n  ];\n\n  // Shared mutable state: the optimize plugin writes field-usage data during\n  // buildStart; the prune and minify plugins read it during transform.\n  const pruneContext = createPruneContext();\n\n  // Babel transform: rewrites useIntlayer/getIntlayer calls and injects\n  // JSON / dynamic-mjs imports.  Also runs the usage analyser in buildStart.\n  plugins.push(intlayerOptimize(intlayerConfig, pruneContext, compatCallers));\n\n  // Prune: removes unused content fields from dictionary JSON files.\n  // Runs with enforce:'pre' so it intercepts raw JSON before Vite's\n  // built-in JSON → ESM conversion.\n  plugins.push(intlayerPrune(intlayerConfig, pruneContext));\n\n  // Minify: compacts dictionary JSON files (parse + re-stringify).\n  // Registered after prune so it receives already-pruned output when both options are active.\n  plugins.push(intlayerMinify(intlayerConfig, pruneContext));\n\n  // Compiler: extracts content declared inline in components into dictionaries.\n  // Bundled directly into the main plugin so users no longer need to register\n  // `intlayerCompiler()` separately. Only added when the compiler is enabled and\n  // an `output` path is configured. Registering `intlayerCompiler()` manually as\n  // well is safe — the compiler deduplicates itself.\n  if (intlayerConfig.compiler?.enabled && intlayerConfig.compiler?.output) {\n    plugins.push(intlayerCompiler({ configOptions: getConfigOptions }));\n  }\n\n  // Proxy: locale-routing middleware (detection / redirect / rewrite) for dev,\n  // preview, and production SSR. Bundled directly into the main plugin and\n  // controlled by the `routing.enableProxy` option (true by default).\n  // Registering `intlayerProxy()` manually as well is safe — the proxy\n  // deduplicates itself.\n  if (intlayerConfig.routing.enableProxy) {\n    plugins.push(intlayerProxy({ ...proxy, configOptions: getConfigOptions }));\n  }\n\n  return plugins;\n};\n\n/**\n * A Vite plugin that integrates Intlayer configuration into the build process\n *\n * ```ts\n * // Example usage of the plugin in a Vite configuration\n * export default defineConfig({\n *   plugins: [ intlayer() ],\n * });\n * ```\n */\nexport const intlayer = intlayerPlugin;\n/**\n * @deprecated Rename to intlayer instead\n *\n * A Vite plugin that integrates Intlayer configuration into the build process\n *\n * ```ts\n * // Example usage of the plugin in a Vite configuration\n * export default defineConfig({\n *   plugins: [ intlayer() ],\n * });\n * ```\n */\nexport const intLayerPlugin = intlayerPlugin;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwFA,MAAa,kBACX,kBACiB;CACjB,MAAM,EAAE,eAAe,OAAO,GAAG,qBAAqB,iBAAiB,CAAC;CACxE,MAAM,iBAAiB,iBAAiB,gBAAgB;CACxD,iBAAiB,gBAAgB;CACjC,MAAM,YAAY,aAAa,cAAc;CAE7C,MAAM,QAAQ,SAAS;EACrB,eAAe;EACf,YAAY,UAAkB,QAAQ,KAAK;CAC7C,CAAC;CAED,MAAM,gBAAgB,OAAO,KAAK,KAAK;CAEvC,MAAM,UAA0B,CAC9B;EACE,MAAM;EAEN,QAAQ,SAAS,QAAQ;GAEvB,MAAM,mBACJ,IAAI,YAAY,WAAW,IAAI,SAAS;GAG1C,MAAM,oBAAoB,eAAe,OAAO;GAEhD,OAAO,CAAC,oBAAoB;EAC9B;EAEA,QAAQ,OAAO,SAAS,QAAQ;GAC9B,MAAM,EAAE,SAAS,eAAe;GAEhC,MAAM,eACJ,IAAI,YAAY,WAAW,IAAI,SAAS;GAC1C,MAAM,iBAAiB,IAAI,YAAY;GAKvC,IAAI,gBAAgB,kBAAkB,SAAS,QAAQ;IAIrD,MAAM,EAAE,oBAAoB,MAAM,OAAO;IAGzC,MAAM,gBAAgB,gBAAgB;KACpC,OAAO;KACP,gBAAgB,iBACZ,MAAO,KACP,MAAO,KAAK;KAChB,KAAK,iBAAiB,SAAS;IACjC,CAAC;GACH;GAEA,IAAI,SAAiC,EAGnC,wBAAwB,WAC1B;GAEA,IAAI,gBAAgB;IAClB,MAAM,eAAe,gBAAgB,cAAc;IAEnD,IAAI,OAAO,KAAK,YAAY,CAAC,CAAC,WAAW,GACvC,UACE,2DACA,EACE,WAAW,KACb,CACF;IAGF,MAAM,kBAAkB,MAAM,wBAAwB,YAAY;IAElE,IAAI,gBAAgB,SAAS,GAC3B,UACE,CACE,+BACA,gBACG,QACE,QACC,CAAC;KAAC;KAAa;KAAa;IAAY,CAAC,CAAC,SAAS,GAAG,CAC1D,CAAC,CACA,KAAK,QAAQ,SAAS,KAAK,IAAI,CAAC,CAAC,CACjC,KAAK,IAAI,CACd,GACA,EACE,WAAW,KACb,CACF;IAGF,SAAS;KACP,GAAG;KAGH,GAAG,uBACD,kBACC,QAAQ,eAAe,QACvB,UAAU,IAAI,MAAM,EACvB;KAIA,GAAG,+BACD,yBAAyB,YAAY,IACpC,QAAQ,eAAe,QACvB,UAAU,IAAI,MAAM,EACvB;KAGA,GAAG,iBACD,iBACC,QAAQ,eAAe,QACvB,UAAU,IAAI,MAAM,EACvB;IACF;GACF;GAIA,OAAO;IACL;IACA,SAAS,EACP,MACF;IACA,cAAc,EAEZ,SAAS,cACX;IACA,KAAK,EAEH,YAAY,CAAC,0BAA0B,EACzC;GACF;EACF;EAEA,iBAAiB,OAAO,WAAW;GACjC,IAAI,OAAO,OAAO,SAAS,eAAe;IAGxC,MAAM,EAAE,UAAU,MAAM,OAAO;IAG/B,MAAM,MAAM,EAAE,eAAe,eAAe,CAAC;GAC/C;EACF;CACF,CACF;CAIA,MAAM,eAAe,mBAAmB;CAIxC,QAAQ,KAAK,iBAAiB,gBAAgB,cAAc,aAAa,CAAC;CAK1E,QAAQ,KAAK,cAAc,gBAAgB,YAAY,CAAC;CAIxD,QAAQ,KAAK,eAAe,gBAAgB,YAAY,CAAC;CAOzD,IAAI,eAAe,UAAU,WAAW,eAAe,UAAU,QAC/D,QAAQ,KAAK,iBAAiB,EAAE,eAAe,iBAAiB,CAAC,CAAC;CAQpE,IAAI,eAAe,QAAQ,aACzB,QAAQ,KAAK,cAAc;EAAE,GAAG;EAAO,eAAe;CAAiB,CAAC,CAAC;CAG3E,OAAO;AACT;;;;;;;;;;;AAYA,MAAa,WAAW;;;;;;;;;;;;;AAaxB,MAAa,iBAAiB"}
+{"version":3,"file":"intlayerPlugin.mjs","names":[],"sources":["../../src/intlayerPlugin.ts"],"sourcesContent":["import { resolve } from 'node:path';\nimport { type CompatCallerConfig, createPruneContext } from '@intlayer/babel';\nimport { BLUE } from '@intlayer/config/colors';\nimport {\n  formatDictionarySelectorEnvVar,\n  formatNodeTypeToEnvVar,\n  getConfigEnvVars,\n} from '@intlayer/config/envVars';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\nimport {\n  getAlias,\n  getHasDictionarySelector,\n  getUnusedNodeTypesAsync,\n} from '@intlayer/config/utils';\nimport { resolveProxyMode } from '@intlayer/core/localization';\nimport { getDictionaries } from '@intlayer/dictionaries-entry';\nimport { logConfigDetails } from '@intlayer/engine/logConfigDetails';\nimport type { PluginOption } from 'vite';\nimport { intlayerCompiler } from './IntlayerCompilerPlugin';\nimport { intlayerMinify } from './intlayerMinifyPlugin';\nimport { intlayerOptimize } from './intlayerOptimizePlugin';\nimport {\n  type IntlayerProxyPluginOptions,\n  intlayerProxy,\n} from './intlayerProxyPlugin';\nimport { intlayerPrune } from './intlayerPrunePlugin';\n\n/**\n * Extended options accepted by the intlayer Vite plugin.\n *\n * Extends {@link GetConfigurationOptions} with compat-adapter caller\n * configurations.  Compat adapter packages (e.g. `@intlayer/react-i18next/plugin`,\n * `@intlayer/vue-i18n/plugin`) inject their own caller configs here so the\n * field-usage analyser can recognise their translation function call patterns\n * and prune unused dictionary fields accordingly.\n */\nexport type IntlayerPluginOptions = GetConfigurationOptions & {\n  /**\n   * Compat-adapter namespace caller configurations to pass to the\n   * field-usage analyser (Vite `buildStart` phase).\n   *\n   * Defined by each compat adapter package; the core `vite-intlayer` package\n   * ships with an empty default to stay framework-agnostic.\n   */\n  compatCallers?: CompatCallerConfig[];\n\n  /**\n   * Options forwarded to the bundled locale-routing proxy (`intlayerProxy`).\n   *\n   * Since Intlayer v9 the proxy is plugged directly into the main `intlayer()`\n   * plugin (controlled by `routing.enableProxy`, unset by default, which\n   * selects auto mode). These routing options let you tune that bundled proxy\n   * without registering it separately — e.g. ignore API routes from locale\n   * routing.\n   *\n   * @example\n   * ```ts\n   * intlayer({ proxy: { ignore: (req) => req.url?.startsWith('/api') } })\n   * ```\n   */\n  proxy?: Pick<IntlayerProxyPluginOptions, 'ignore'>;\n};\n\n/**\n * Vite plugin that integrates Intlayer into the Vite build process.\n *\n * It handles:\n * 1. Preparing Intlayer resources (dictionaries) before build.\n * 2. Configuring Vite aliases for dictionary access.\n * 3. Setting up dev-server watchers for content changes.\n * 4. Applying build optimizations (tree-shaking dictionaries).\n *\n * @param configOptions - Optional configuration to override default Intlayer settings.\n * @returns A Vite plugin option.\n *\n * @example\n * ```ts\n * import { intlayer } from 'vite-intlayer';\n *\n * export default defineConfig({\n *   plugins: [intlayer()],\n * });\n *\n * ```\n * @deprecated Rename to intlayer instead\n */\nexport const intlayerPlugin = (\n  configOptions?: IntlayerPluginOptions\n): PluginOption => {\n  const { compatCallers, proxy, ...getConfigOptions } = configOptions ?? {};\n  const intlayerConfig = getConfiguration(getConfigOptions);\n  logConfigDetails(getConfigOptions);\n  const appLogger = getAppLogger(intlayerConfig);\n\n  const alias = getAlias({\n    configuration: intlayerConfig,\n    formatter: (value: string) => resolve(value),\n  });\n\n  const aliasPackages = Object.keys(alias);\n\n  const plugins: PluginOption[] = [\n    {\n      name: 'vite-intlayer-plugin',\n\n      apply: (_config, env) => {\n        // Don't apply intlayer plugin during `preview` command\n        const isPreviewCommand =\n          env.command === 'serve' && env.mode === 'production';\n\n        // But if liveSync is enabled, ensure the data are fresh\n        const isLiveSyncEnabled = intlayerConfig.editor.liveSync;\n\n        return !isPreviewCommand || isLiveSyncEnabled;\n      },\n\n      config: async (_config, env) => {\n        const { mode } = intlayerConfig.build;\n\n        const isDevCommand =\n          env.command === 'serve' && env.mode === 'development';\n        const isBuildCommand = env.command === 'build';\n\n        // Only call prepareIntlayer during `dev` or `build` (not during `preview`)\n        // If prod: clean and rebuild once\n        // If dev: rebuild only once if it's more than 1 hour since last rebuild\n        if (isDevCommand || isBuildCommand || mode === 'auto') {\n          // Lazily load the heavy build pipeline (`@intlayer/engine/build`) only\n          // when a rebuild is actually required, keeping the Vite config phase\n          // lightweight (e.g. during `preview`).\n          const { prepareIntlayer } = await import('@intlayer/engine/build');\n\n          // prepareIntlayer use runOnce to ensure to run only once because will run twice on client and server side otherwise\n          await prepareIntlayer(intlayerConfig, {\n            clean: isBuildCommand,\n            cacheTimeoutMs: isBuildCommand\n              ? 1000 * 30 // 30 seconds for build (to ensure to rebuild all dictionaries)\n              : 1000 * 60 * 60, // 1 hour for dev (default cache timeout)\n            env: isBuildCommand ? 'prod' : 'dev',\n          });\n        }\n\n        let define: Record<string, string> = {\n          // Preset an env var to avoid 'process is not defined' error\n          // Needed for some libraries that does not add process.env\n          'process.env.INTLAYER': '\"true\"',\n        };\n\n        if (isBuildCommand) {\n          const dictionaries = getDictionaries(intlayerConfig);\n\n          if (Object.keys(dictionaries).length === 0) {\n            appLogger(\n              'No dictionaries found. Please check your configuration.',\n              {\n                isVerbose: true,\n              }\n            );\n          }\n\n          const unusedNodeTypes = await getUnusedNodeTypesAsync(dictionaries);\n\n          if (unusedNodeTypes.length > 0) {\n            appLogger(\n              [\n                'Filtering out unused logic:',\n                unusedNodeTypes\n                  .filter(\n                    (key) =>\n                      !['reactNode', 'solidNode', 'preactNode'].includes(key)\n                  )\n                  .map((key) => colorize(key, BLUE))\n                  .join(', '),\n              ],\n              {\n                isVerbose: true,\n              }\n            );\n          }\n\n          define = {\n            ...define,\n\n            // Tree shacking env var based on config\n            ...formatNodeTypeToEnvVar(\n              unusedNodeTypes,\n              (key) => `process.env.${key}`,\n              (value) => `\"${value}\"`\n            ),\n\n            // Tree shacking env var for the dictionary selector logic\n            // (collections / variants)\n            ...formatDictionarySelectorEnvVar(\n              getHasDictionarySelector(dictionaries),\n              (key) => `process.env.${key}`,\n              (value) => `\"${value}\"`\n            ),\n\n            // Tree shacking env var based on config\n            ...getConfigEnvVars(\n              intlayerConfig,\n              (key) => `process.env.${key}`,\n              (value) => `\"${value}\"` // Wrap by \"\" to ensure env var set properly\n            ),\n          };\n        }\n\n        // mergeConfig handles both array and record alias formats,\n        // and correctly appends to optimizeDeps.exclude / ssr.noExternal\n        return {\n          define,\n          resolve: {\n            alias,\n          },\n          optimizeDeps: {\n            // Exclude alias entry points since they're local files, not npm packages\n            exclude: aliasPackages,\n          },\n          ssr: {\n            // Ensure intlayer packages are bundled so aliases are applied\n            noExternal: [/(^@intlayer\\/|intlayer$)/],\n          },\n        };\n      },\n\n      configureServer: async (server) => {\n        if (server.config.mode === 'development') {\n          // Lazily load the file watcher (`@intlayer/engine/watcher`, which pulls\n          // in `@parcel/watcher`) only when the dev server actually starts.\n          const { watch } = await import('@intlayer/engine/watcher');\n\n          // Start watching (assuming watch is also async)\n          await watch({ configuration: intlayerConfig });\n        }\n      },\n    },\n  ];\n\n  // Shared mutable state: the optimize plugin writes field-usage data during\n  // buildStart; the prune and minify plugins read it during transform.\n  const pruneContext = createPruneContext();\n\n  // Babel transform: rewrites useIntlayer/getIntlayer calls and injects\n  // JSON / dynamic-mjs imports.  Also runs the usage analyser in buildStart.\n  plugins.push(intlayerOptimize(intlayerConfig, pruneContext, compatCallers));\n\n  // Prune: removes unused content fields from dictionary JSON files.\n  // Runs with enforce:'pre' so it intercepts raw JSON before Vite's\n  // built-in JSON → ESM conversion.\n  plugins.push(intlayerPrune(intlayerConfig, pruneContext));\n\n  // Minify: compacts dictionary JSON files (parse + re-stringify).\n  // Registered after prune so it receives already-pruned output when both options are active.\n  plugins.push(intlayerMinify(intlayerConfig, pruneContext));\n\n  // Compiler: extracts content declared inline in components into dictionaries.\n  // Bundled directly into the main plugin so users no longer need to register\n  // `intlayerCompiler()` separately. Only added when the compiler is enabled and\n  // an `output` path is configured. Registering `intlayerCompiler()` manually as\n  // well is safe — the compiler deduplicates itself.\n  if (intlayerConfig.compiler?.enabled && intlayerConfig.compiler?.output) {\n    plugins.push(intlayerCompiler({ configOptions: getConfigOptions }));\n  }\n\n  // Proxy: locale-routing middleware (detection / redirect / rewrite) for dev,\n  // preview, and production SSR. Bundled directly into the main plugin and\n  // controlled by the `routing.enableProxy` option, which is unset by default\n  // and therefore resolves to auto mode. Only an explicit `false` skips\n  // registration — a plain truthiness check would wrongly drop the proxy for\n  // every project that never set the option.\n  // Registering `intlayerProxy()` manually as well is safe — the proxy\n  // deduplicates itself.\n  if (resolveProxyMode(intlayerConfig.routing.enableProxy) !== 'disabled') {\n    plugins.push(intlayerProxy({ ...proxy, configOptions: getConfigOptions }));\n  }\n\n  return plugins;\n};\n\n/**\n * A Vite plugin that integrates Intlayer configuration into the build process\n *\n * ```ts\n * // Example usage of the plugin in a Vite configuration\n * export default defineConfig({\n *   plugins: [ intlayer() ],\n * });\n * ```\n */\nexport const intlayer = intlayerPlugin;\n/**\n * @deprecated Rename to intlayer instead\n *\n * A Vite plugin that integrates Intlayer configuration into the build process\n *\n * ```ts\n * // Example usage of the plugin in a Vite configuration\n * export default defineConfig({\n *   plugins: [ intlayer() ],\n * });\n * ```\n */\nexport const intLayerPlugin = intlayerPlugin;\n"],"mappings":"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"}

package/dist/esm/intlayerProxyPlugin.mjs

@@ -1,10 +1,9 @@
 import { createPrimaryInstanceGuard } from "./dedupePlugin.mjs";
-import * as ANSIColors from "@intlayer/config/colors";
-import { colorize, getAppLogger } from "@intlayer/config/logger";
+import { getAppLogger } from "@intlayer/config/logger";
 import { getConfiguration } from "@intlayer/config/node";
+import { formatProxyEnabledMessage, getCanonicalPath, getDomainHostname, getDomainOrigin, getInternalPath, getLocaleFromDomain, getLocalizedPath, getRewriteRules, isProxyStorageLocaleEnabled, localeDetector, resolveProxyMode } from "@intlayer/core/localization";
 import { ROUTING_MODE } from "@intlayer/config/defaultValues";
 import { fileURLToPath, parse } from "node:url";
-import { getCanonicalPath, getDomainHostname, getDomainOrigin, getInternalPath, getLocaleFromDomain, getLocalizedPath, getRewriteRules, localeDetector } from "@intlayer/core/localization";
 import { getCookie, getLocaleFromStorageServer, setLocaleInStorageServer } from "@intlayer/core/utils";
 
 //#region src/intlayerProxyPlugin.ts
@@ -34,10 +33,11 @@ const PROXY_PLUGIN_NAME = "vite-intlayer-middleware-plugin";
 *
 */
 const createIntlayerProxyHandler = (options) => {
-	const { ignore, configOptions } = options ?? {};
+	const { ignore, configOptions, isDevServer = false } = options ?? {};
 	const { internationalization, routing } = getConfiguration(configOptions);
 	const { locales: supportedLocales, defaultLocale } = internationalization;
-	const { basePath = "", mode = ROUTING_MODE, rewrite, domains } = routing;
+	const { basePath = "", mode = ROUTING_MODE, rewrite, domains, enableProxy } = routing;
+	const canUseStorageLocale = isProxyStorageLocaleEnabled(resolveProxyMode(enableProxy), isDevServer);
 	const redirectCounts = /* @__PURE__ */ new Map();
 	const MAX_REDIRECTS = 10;
 	const REDIRECT_TTL_MS = 2e3;
@@ -56,8 +56,13 @@ const createIntlayerProxyHandler = (options) => {
 	};
 	/**
 	* Retrieves the locale from storage (cookies, localStorage, sessionStorage).
+	*
+	* Returns `undefined` when the stored locale is not allowed to drive locale
+	* resolution (auto mode on a dev/preview server), which makes every caller
+	* fall through to `Accept-Language` detection and then the default locale.
 	*/
 	const getStorageLocale = (req) => {
+		if (!canUseStorageLocale) return void 0;
 		return getLocaleFromStorageServer({ getCookie: (name) => getCookie(name, req.headers.cookie) });
 	};
 	/**
@@ -432,11 +437,21 @@ const createIntlayerProxyHandler = (options) => {
 * });
 * ```
 *
-* @deprecated Since Intlayer v9, `intlayerProxy()` is bundled directly into the `intlayer()` plugin and enabled by default through the `routing.enableProxy` option (`true` by default). Registering it separately as shown below is now optional.
+* @deprecated Since Intlayer v9, `intlayerProxy()` is bundled directly into the `intlayer()` plugin and enabled by default through the `routing.enableProxy` option (unset by default, which selects auto mode). Registering it separately as shown below is now optional.
 */
 const intlayerProxy = (options) => {
-	const handler = createIntlayerProxyHandler(options);
-	const logger = getAppLogger(getConfiguration(options?.configOptions));
+	const handler = createIntlayerProxyHandler({
+		...options,
+		isDevServer: true
+	});
+	const intlayerConfig = getConfiguration(options?.configOptions);
+	const logger = getAppLogger(intlayerConfig);
+	const isStorageLocaleSuppressed = !isProxyStorageLocaleEnabled(resolveProxyMode(intlayerConfig.routing.enableProxy), true);
+	/**
+	* Logs that the proxy is serving requests, spelling out when auto mode has
+	* suppressed the stored locale so the reported state matches the behaviour.
+	*/
+	const logProxyEnabled = () => logger(formatProxyEnabledMessage(isStorageLocaleSuppressed), { level: "info" });
 	const guard = createPrimaryInstanceGuard(PROXY_PLUGIN_NAME);
 	const plugin = {
 		name: PROXY_PLUGIN_NAME,
@@ -458,12 +473,12 @@ const intlayerProxy = (options) => {
 		},
 		configureServer: (server) => {
 			if (!guard.isPrimary) return;
-			logger(`Intlayer proxy ${colorize("enabled", ANSIColors.GREEN)}`, { level: "info" });
+			logProxyEnabled();
 			server.middlewares.use(handler);
 		},
 		configurePreviewServer: (server) => {
 			if (!guard.isPrimary) return;
-			logger(`Intlayer proxy ${colorize("enabled", ANSIColors.GREEN)}`, { level: "info" });
+			logProxyEnabled();
 			server.middlewares.use(handler);
 		}
 	};

package/dist/esm/intlayerProxyPlugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"intlayerProxyPlugin.mjs","names":[],"sources":["../../src/intlayerProxyPlugin.ts"],"sourcesContent":["import type { IncomingMessage, ServerResponse } from 'node:http';\nimport { fileURLToPath, parse } from 'node:url';\nimport * as ANSIColors from '@intlayer/config/colors';\nimport { ROUTING_MODE } from '@intlayer/config/defaultValues';\nimport { colorize, getAppLogger } from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\nimport {\n  getCanonicalPath,\n  getDomainHostname,\n  getDomainOrigin,\n  getInternalPath,\n  getLocaleFromDomain,\n  getLocalizedPath,\n  getRewriteRules,\n  localeDetector,\n} from '@intlayer/core/localization';\nimport {\n  getCookie,\n  getLocaleFromStorageServer,\n  setLocaleInStorageServer,\n} from '@intlayer/core/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\n/* @ts-ignore - Vite types error */\nimport type { Connect, Plugin } from 'vite';\nimport { createPrimaryInstanceGuard } from './dedupePlugin';\n\nconst PROXY_PLUGIN_NAME = 'vite-intlayer-middleware-plugin';\n\nexport type IntlayerProxyPluginOptions = {\n  /**\n   * A function that allows you to ignore specific requests from the intlayer proxy.\n   *\n   * @example\n   * ```ts\n   * export default defineConfig({\n   *   plugins: [ intlayerProxy({ ignore: (req) => req.url?.startsWith('/api') }) ],\n   * });\n   * ```\n   *\n   * @param req - The incoming request.\n   * @returns A boolean value indicating whether to ignore the request.\n   */\n  ignore?: (req: IncomingMessage) => boolean | undefined;\n  /**\n   * Optional Intlayer configuration overrides forwarded to `getConfiguration`.\n   *\n   * @example\n   * ```ts\n   * export default defineConfig({\n   *   plugins: [ intlayerProxy({ configOptions: { override: { ... } } }) ],\n   * });\n   * ```\n   */\n  configOptions?: GetConfigurationOptions;\n};\n\n/**\n * A Node.js-compatible Connect middleware function.\n * Compatible with Vite dev/preview server, Node.js http, Express, and h3's\n * `fromNodeMiddleware` wrapper for Nitro/TanStack Start production use.\n */\ntype NodeMiddleware = (\n  req: IncomingMessage,\n  res: ServerResponse<IncomingMessage>,\n  next: () => void\n) => void;\n\n/**\n * Creates a standalone, framework-agnostic locale-routing middleware.\n *\n * This function contains all the locale detection, redirect, and rewrite logic.\n * It is intentionally separated from the Vite plugin so the same handler can be\n * used in every environment:\n *\n * - **Dev**: wired up automatically by `intlayerProxy` via `configureServer`\n * - **Preview**: wired up automatically by `intlayerProxy` via `configurePreviewServer`\n * - **Production (Nitro / TanStack Start)**: create `server/middleware/intlayerProxy.ts`:\n *\n * @example\n * ```ts\n * // server/middleware/intlayerProxy.ts\n * import { fromNodeMiddleware } from 'h3';\n * import { createIntlayerProxyHandler } from 'vite-intlayer';\n *\n * export default fromNodeMiddleware(createIntlayerProxyHandler());\n * ```\n *\n * @param options - Plugin-specific options, such as path ignoring and Intlayer configuration overrides.\n * @returns A Connect-compatible `(req, res, next) => void` middleware.\n *\n */\nexport const createIntlayerProxyHandler = (\n  options?: IntlayerProxyPluginOptions\n): NodeMiddleware => {\n  const { ignore, configOptions } = options ?? {};\n  const intlayerConfig = getConfiguration(configOptions);\n\n  const { internationalization, routing } = intlayerConfig;\n  const { locales: supportedLocales, defaultLocale } = internationalization;\n\n  const { basePath = '', mode = ROUTING_MODE, rewrite, domains } = routing;\n\n  type RedirectCounter = { count: number; lastSeen: number };\n  const redirectCounts = new Map<string, RedirectCounter>();\n  const MAX_REDIRECTS = 10;\n  const REDIRECT_TTL_MS = 2_000;\n\n  // Derived flags from routing.mode\n  const noPrefix =\n    (!(\n      process.env.INTLAYER_ROUTING_MODE &&\n      process.env.INTLAYER_ROUTING_MODE !== 'no-prefix'\n    ) &&\n      mode === 'no-prefix') ||\n    (!(\n      process.env.INTLAYER_ROUTING_MODE &&\n      process.env.INTLAYER_ROUTING_MODE !== 'search-params'\n    ) &&\n      mode === 'search-params');\n  const prefixDefault =\n    !(\n      process.env.INTLAYER_ROUTING_MODE &&\n      process.env.INTLAYER_ROUTING_MODE !== 'prefix-all'\n    ) && mode === 'prefix-all';\n\n  const rewriteRules =\n    process.env.INTLAYER_ROUTING_REWRITE_RULES !== 'false'\n      ? getRewriteRules(rewrite, 'url')\n      : undefined;\n\n  /**\n   * Extracts the hostname from a request's `Host` header, handling IPv6\n   * literals (`[::1]:5173` → `::1`) that a plain `split(':')` would mangle.\n   */\n  const getRequestHostname = (req: IncomingMessage): string => {\n    const host = req.headers.host ?? '';\n    const ipv6Match = host.match(/^\\[([^\\]]+)\\]/);\n    if (ipv6Match) return ipv6Match[1]!;\n    return host.split(':')[0] ?? '';\n  };\n\n  /* --------------------------------------------------------------------\n   *                     Helper & Utility Functions\n   * --------------------------------------------------------------------\n   */\n\n  /**\n   * Retrieves the locale from storage (cookies, localStorage, sessionStorage).\n   */\n  const getStorageLocale = (req: IncomingMessage): Locale | undefined => {\n    const locale = getLocaleFromStorageServer({\n      getCookie: (name: string) => getCookie(name, req.headers.cookie),\n    });\n    return locale;\n  };\n\n  /**\n   * Appends locale to search params when routing mode is 'search-params'.\n   */\n  const appendLocaleSearchIfNeeded = (\n    search: string | undefined,\n    locale: Locale\n  ): string | undefined => {\n    if (\n      (process.env.INTLAYER_ROUTING_MODE &&\n        process.env.INTLAYER_ROUTING_MODE !== 'search-params') ||\n      mode !== 'search-params'\n    )\n      return search;\n\n    const params = new URLSearchParams(search ?? '');\n\n    params.set('locale', locale);\n\n    return `?${params.toString()}`;\n  };\n\n  /**\n   * Checks whether a pathname starts with the given locale as a full path\n   * segment (`/fr` or `/fr/...`). A bare `startsWith('/fr')` would also match\n   * unrelated paths like `/friends`, causing wrong prefix stripping and\n   * self-redirect loops.\n   */\n  const hasLocaleSegmentPrefix = (pathname: string, locale: Locale): boolean =>\n    pathname === `/${locale}` || pathname.startsWith(`/${locale}/`);\n\n  /**\n   * Extracts the locale from the URL pathname if present as the first segment.\n   * e.g. if pathname is /en/some/page or /en, checks if \"en\" is in supportedLocales.\n   */\n  const getPathLocale = (pathname: string): Locale | undefined => {\n    const segments = pathname.split('/').filter(Boolean);\n    const firstSegment = segments[0];\n    if (firstSegment && supportedLocales.includes(firstSegment as Locale)) {\n      return firstSegment as Locale;\n    }\n    return undefined;\n  };\n\n  /**\n   * Persists the resolved locale onto the outgoing response as a cookie (and\n   * header, per `routing.storage`). Only the cookie survives a client redirect,\n   * so this is what carries an explicitly-selected locale across a\n   * prefix-stripping redirect. Enabled cookie/header targets are resolved by\n   * {@link setLocaleInStorageServer} from the config; disabled ones are no-ops.\n   */\n  const persistLocaleOnResponse = (\n    res: ServerResponse<IncomingMessage>,\n    locale: Locale\n  ) => {\n    setLocaleInStorageServer(locale, {\n      setCookieStore: (name, value, attributes) => {\n        const parts: string[] = [`${name}=${encodeURIComponent(value)}`];\n        if (attributes.path) parts.push(`Path=${attributes.path}`);\n        if (attributes.domain) parts.push(`Domain=${attributes.domain}`);\n        if (typeof attributes.expires === 'number')\n          parts.push(`Expires=${new Date(attributes.expires).toUTCString()}`);\n        if (attributes.secure) parts.push('Secure');\n        if (attributes.httpOnly) parts.push('HttpOnly');\n        if (attributes.sameSite) parts.push(`SameSite=${attributes.sameSite}`);\n\n        const cookieString = parts.join('; ');\n        const existing = res.getHeader('Set-Cookie');\n        const cookies = Array.isArray(existing)\n          ? existing.map(String)\n          : existing !== undefined\n            ? [String(existing)]\n            : [];\n        cookies.push(cookieString);\n        res.setHeader('Set-Cookie', cookies);\n      },\n      setHeader: (name: string, value: string) => {\n        res.setHeader(name, value);\n      },\n    });\n  };\n\n  /**\n   * Identifies the client issuing a request, so redirect-loop tracking is\n   * scoped per client. Without this, concurrent visitors hitting the same\n   * legitimate redirect (e.g. `/` → `/fr/`) would share one counter and trip\n   * the loop detector under normal production traffic.\n   */\n  const getClientKey = (req: IncomingMessage): string => {\n    const forwardedFor = req.headers['x-forwarded-for'];\n    const forwardedIp = (\n      Array.isArray(forwardedFor) ? forwardedFor[0] : forwardedFor\n    )\n      ?.split(',')[0]\n      ?.trim();\n\n    return forwardedIp || req.socket?.remoteAddress || 'unknown';\n  };\n\n  /**\n   * Strips any origin from a redirect target, keeping only path, search and\n   * hash. Prevents open redirects: user-controlled paths like `//evil.com/x`\n   * would otherwise be echoed verbatim into the `Location` header and be\n   * interpreted by browsers as a protocol-relative cross-origin URL.\n   */\n  const toSameOriginUrl = (url: string): string => {\n    try {\n      const parsed = new URL(url, 'http://intlayer-internal');\n      return `${parsed.pathname}${parsed.search}${parsed.hash}`;\n    } catch {\n      return url;\n    }\n  };\n\n  type RedirectOptions = {\n    /** Human-readable reason logged when a redirect loop is detected. */\n    reason?: string;\n    /** The URL of the incoming request, used for redirect-loop tracking. */\n    originalUrl?: string;\n    /**\n     * When provided, the locale is persisted (cookie/header, per config) on\n     * the redirect response so the follow-up request resolves the same locale.\n     */\n    persistLocale?: Locale;\n    /**\n     * HTTP status for the redirect. Defaults to 302: locale redirects depend\n     * on mutable state (cookie, Accept-Language) and must not be cached by\n     * the browser as permanent. Domain-routing redirects pass 301 explicitly.\n     */\n    status?: number;\n    /**\n     * Allows a cross-origin `Location` target. Only the domain-routing\n     * redirect sets this; all other targets are sanitized to same-origin.\n     */\n    allowCrossOrigin?: boolean;\n  };\n\n  /**\n   * Writes a redirect response with the given new URL.\n   */\n  const redirectUrl = (\n    req: IncomingMessage,\n    res: ServerResponse<IncomingMessage>,\n    newUrl: string,\n    options?: RedirectOptions\n  ) => {\n    const {\n      reason,\n      originalUrl,\n      persistLocale,\n      status = 302,\n      allowCrossOrigin = false,\n    } = options ?? {};\n\n    const targetUrl = allowCrossOrigin ? newUrl : toSameOriginUrl(newUrl);\n\n    if (originalUrl) {\n      if (originalUrl === targetUrl) {\n        console.error('[REDIRECT LOOP DETECTED!]', { originalUrl, reason });\n        res.writeHead(500, { 'Content-Type': 'text/plain' });\n        return res.end(\n          `Redirect loop detected: ${originalUrl} redirects to itself`\n        );\n      }\n\n      const now = Date.now();\n      const trackingKey = `${getClientKey(req)}|${originalUrl} -> ${targetUrl}`;\n      const previousEntry = redirectCounts.get(trackingKey);\n      const count =\n        previousEntry && now - previousEntry.lastSeen < REDIRECT_TTL_MS\n          ? previousEntry.count + 1\n          : 1;\n\n      redirectCounts.set(trackingKey, { count, lastSeen: now });\n\n      if (count > MAX_REDIRECTS) {\n        console.error('[REDIRECT LOOP DETECTED!]', {\n          originalUrl,\n          redirectCount: count,\n          lastRedirectTo: targetUrl,\n          reason,\n        });\n        res.writeHead(500, { 'Content-Type': 'text/plain' });\n        return res.end(\n          `Redirect loop detected: ${count} redirects from ${originalUrl}`\n        );\n      }\n\n      for (const [entryKey, entry] of redirectCounts) {\n        if (now - entry.lastSeen >= REDIRECT_TTL_MS)\n          redirectCounts.delete(entryKey);\n      }\n    }\n\n    if (persistLocale) {\n      persistLocaleOnResponse(res, persistLocale);\n    }\n\n    res.writeHead(status, { Location: targetUrl });\n    return res.end();\n  };\n\n  /**\n   * \"Rewrite\" the request internally by adjusting req.url.\n   * Also sets the locale in the response/request headers via storage to mimic\n   * Next.js's behaviour of propagating the detected locale downstream.\n   */\n  const rewriteUrl = (\n    req: Connect.IncomingMessage,\n    res: ServerResponse<IncomingMessage>,\n    newUrl: string,\n    locale?: Locale\n  ) => {\n    if (req.url !== newUrl) {\n      req.url = newUrl;\n    }\n    if (locale) {\n      setLocaleInStorageServer(locale, {\n        setHeader: (name: string, value: string) => {\n          res.setHeader(name, value);\n          req.headers[name] = value;\n        },\n      });\n    }\n  };\n\n  /**\n   * Constructs a new path string, optionally including a locale prefix, basePath, and search parameters.\n   * - basePath:    (e.g. '/myapp')\n   * - locale:      (e.g. 'en')\n   * - currentPath: (e.g. '/products/shoes')\n   * - search:      (e.g. '?foo=bar')\n   */\n  const constructPath = (\n    locale: Locale,\n    currentPath: string,\n    search?: string\n  ) => {\n    // Strip any incoming locale prefix to avoid double-prefixing\n    const pathWithoutPrefix = hasLocaleSegmentPrefix(currentPath, locale)\n      ? currentPath.slice(`/${locale}`.length)\n      : currentPath;\n\n    // Ensure basePath always starts with '/' and has no trailing slash\n    const cleanBasePath = basePath.startsWith('/') ? basePath : `/${basePath}`;\n    const normalizedBasePath = cleanBasePath.endsWith('/')\n      ? cleanBasePath.slice(0, -1)\n      : cleanBasePath;\n\n    // In 'search-params' and 'no-prefix' modes, do not prefix the path with the locale\n    if (\n      (!(\n        process.env.INTLAYER_ROUTING_MODE &&\n        process.env.INTLAYER_ROUTING_MODE !== 'no-prefix'\n      ) &&\n        mode === 'no-prefix') ||\n      (!(\n        process.env.INTLAYER_ROUTING_MODE &&\n        process.env.INTLAYER_ROUTING_MODE !== 'search-params'\n      ) &&\n        mode === 'search-params')\n    ) {\n      const newPath = search\n        ? `${pathWithoutPrefix || '/'}${search}`\n        : pathWithoutPrefix || '/';\n      return newPath;\n    }\n\n    // Check if path already starts with locale to avoid double-prefixing\n    const pathWithLocalePrefix = hasLocaleSegmentPrefix(currentPath, locale)\n      ? currentPath\n      : `/${locale}${currentPath}`;\n\n    let newPath = `${normalizedBasePath}${pathWithLocalePrefix}`;\n\n    // Special case: if prefixDefault is false and locale is defaultLocale, remove the locale prefix\n    if (!prefixDefault && locale === defaultLocale) {\n      newPath = `${normalizedBasePath}${pathWithoutPrefix || '/'}`;\n    }\n\n    // Never emit a trailing slash (`/fr/` for the root path): the framework's\n    // trailing-slash normalisation would redirect it back and forth with this\n    // proxy, creating an infinite redirect loop.\n    if (newPath.length > 1 && newPath.endsWith('/')) {\n      newPath = newPath.slice(0, -1);\n    }\n\n    // Append search parameters if provided\n    if (search) {\n      newPath += search;\n    }\n\n    return newPath;\n  };\n\n  /* --------------------------------------------------------------------\n   *               Handlers that mirror Next.js style logic\n   * --------------------------------------------------------------------\n   */\n\n  /**\n   * If `noPrefix` is true, we never prefix the locale in the URL.\n   * We simply rewrite the request to the same path, but with the best-chosen locale\n   * in a header or search params if desired.\n   */\n  const handleNoPrefix = ({\n    req,\n    res,\n    next,\n    originalPath,\n    searchParams,\n    storageLocale,\n    originalUrl,\n  }: {\n    req: Connect.IncomingMessage;\n    res: ServerResponse<IncomingMessage>;\n    next: Connect.NextFunction;\n    originalPath: string;\n    searchParams: string;\n    storageLocale?: Locale;\n    originalUrl?: string;\n  }) => {\n    const pathLocale = getPathLocale(originalPath);\n\n    // Determine the best locale: prefer cookie/storage, fall back to Accept-Language detection\n    let locale = storageLocale ?? defaultLocale;\n\n    // Use localeDetector if no storage locale is available\n    if (!storageLocale) {\n      const detectedLocale = localeDetector(\n        req.headers as Record<string, string>,\n        supportedLocales,\n        defaultLocale\n      );\n      locale = detectedLocale as Locale;\n    }\n\n    // Guard against a stale/unsupported locale coming from storage or detection\n    if (!supportedLocales.includes(locale)) {\n      locale = defaultLocale;\n    }\n\n    if (pathLocale) {\n      const pathWithoutLocale =\n        originalPath.slice(`/${pathLocale}`.length) || '/';\n\n      const canonicalPath = getCanonicalPath(\n        pathWithoutLocale,\n        pathLocale,\n        rewriteRules\n      );\n\n      const search = appendLocaleSearchIfNeeded(searchParams, pathLocale);\n\n      const redirectPath = search\n        ? `${canonicalPath}${search}`\n        : `${canonicalPath}${searchParams ?? ''}`;\n\n      // Persist the explicitly-requested locale: stripping the prefix drops\n      // the only locale signal from the URL, so without this the follow-up\n      // request would fall back to cookie / Accept-Language detection and\n      // could resolve a different locale.\n      return redirectUrl(req, res, redirectPath, {\n        originalUrl,\n        persistLocale: pathLocale,\n      });\n    }\n\n    const canonicalPath = getCanonicalPath(originalPath, locale, rewriteRules);\n\n    // In search-params mode, we need to redirect to add the locale search param\n    if (\n      !(\n        process.env.INTLAYER_ROUTING_MODE &&\n        process.env.INTLAYER_ROUTING_MODE !== 'search-params'\n      ) &&\n      mode === 'search-params'\n    ) {\n      // Check if locale search param already exists and matches the detected locale\n      const existingSearchParams = new URLSearchParams(searchParams ?? '');\n      const existingLocale = existingSearchParams.get('locale');\n\n      if (existingLocale === locale) {\n        // Rewrite internally — URL stays the same in the browser, but the framework\n        // sees /[locale]/path so the [locale] route param is populated correctly.\n        // getInternalPath collapses the root path to `/${locale}` — a trailing\n        // slash (`/fr/`) would trigger the framework's trailing-slash\n        // normalisation redirect and loop with this proxy.\n        const internalPath = getInternalPath(canonicalPath, locale);\n        const rewritePath = `${internalPath}${searchParams ?? ''}`;\n\n        rewriteUrl(req, res, rewritePath, locale);\n        return next();\n      }\n\n      // Locale param missing or doesn't match — redirect to add/update it (URL changes in browser)\n      const search = appendLocaleSearchIfNeeded(searchParams, locale);\n      const redirectPath = search\n        ? `${originalPath}${search}`\n        : `${originalPath}${searchParams ?? ''}`;\n\n      return redirectUrl(req, res, redirectPath, { originalUrl });\n    }\n\n    // For no-prefix mode (not search-params), add locale prefix internally for routing\n    // so the framework can match the [locale] route param without exposing it in the URL.\n    // getInternalPath collapses the root path to `/${locale}` — a trailing slash\n    // (`/fr/`) would trigger the framework's trailing-slash normalisation\n    // redirect and loop with this proxy.\n    const internalPath = getInternalPath(canonicalPath, locale);\n\n    const search = appendLocaleSearchIfNeeded(searchParams, locale);\n    const rewritePath = search\n      ? `${internalPath}${search}`\n      : `${internalPath}${searchParams ?? ''}`;\n\n    // Rewrite internally — URL stays the same in the browser\n    rewriteUrl(req, res, rewritePath, locale);\n\n    return next();\n  };\n\n  /**\n   * The main prefix logic.\n   */\n  const handlePrefix = ({\n    req,\n    res,\n    next,\n    originalPath,\n    searchParams,\n    pathLocale,\n    storageLocale,\n    originalUrl,\n  }: {\n    req: Connect.IncomingMessage;\n    res: ServerResponse<IncomingMessage>;\n    next: Connect.NextFunction;\n    originalPath: string;\n    searchParams: string;\n    pathLocale?: Locale;\n    storageLocale?: Locale;\n    originalUrl?: string;\n  }) => {\n    if (!pathLocale) {\n      handleMissingPathLocale({\n        req,\n        res,\n        next,\n        originalPath,\n        searchParams,\n        storageLocale,\n        originalUrl,\n      });\n      return;\n    }\n\n    handleExistingPathLocale({\n      req,\n      res,\n      next,\n      originalPath,\n      searchParams,\n      pathLocale,\n      originalUrl,\n    });\n  };\n\n  /**\n   * Handles requests where the locale is missing from the URL pathname.\n   * Detects a locale from storage / headers / default, then either redirects or rewrites.\n   */\n  const handleMissingPathLocale = ({\n    req,\n    res,\n    next,\n    originalPath,\n    searchParams,\n    storageLocale,\n    originalUrl,\n  }: {\n    req: Connect.IncomingMessage;\n    res: ServerResponse<IncomingMessage>;\n    next: Connect.NextFunction;\n    originalPath: string;\n    searchParams: string;\n    storageLocale?: Locale;\n    originalUrl?: string;\n  }) => {\n    // Choose the best locale: cookie/storage → Accept-Language detection → defaultLocale\n    let locale = (storageLocale ??\n      localeDetector(\n        req.headers as Record<string, string>,\n        supportedLocales,\n        defaultLocale\n      )) as Locale;\n\n    // If still invalid, fall back to defaultLocale\n    if (!supportedLocales.includes(locale)) {\n      locale = defaultLocale;\n    }\n\n    // Resolve to canonical path.\n    // If user visits /a-propos (implied 'fr'), this resolves to /about\n    const canonicalPath = getCanonicalPath(originalPath, locale, rewriteRules);\n\n    // Determine target localized path for redirection.\n    // /about + 'fr' → /a-propos\n    const targetLocalizedPathResult = getLocalizedPath(\n      canonicalPath,\n      locale,\n      rewriteRules\n    );\n    const targetLocalizedPath =\n      typeof targetLocalizedPathResult === 'string'\n        ? targetLocalizedPathResult\n        : targetLocalizedPathResult.path;\n\n    // Construct new path, preserving original search params\n    const search = appendLocaleSearchIfNeeded(searchParams, locale);\n    const newPath = constructPath(locale, targetLocalizedPath, search);\n\n    // If we always prefix default or if this is not the default locale,\n    // do a redirect so the user sees the locale in the URL\n    if (prefixDefault || locale !== defaultLocale) {\n      return redirectUrl(req, res, newPath, { originalUrl });\n    }\n\n    // If we do NOT prefix the default locale, pass through the canonical path unchanged.\n    // Rewriting to `/${locale}${canonicalPath}` (e.g. /en/) causes TanStack Start to issue a\n    // trailing-slash normalisation redirect (/en/ → /en), which the proxy then strips back to /,\n    // creating an infinite redirect loop.\n    // Because {-$locale} is an optional segment, the framework matches the un-prefixed URL with\n    // locale=undefined and falls back to defaultLocale via `params.locale ?? defaultLocale`.\n    // searchParams MUST be preserved here — dropping them causes the framework (e.g. TanStack Start) to\n    // see a URL with no search params, trigger a validateSearch normalisation redirect to the prefixed URL\n    // (e.g. /en?page=1&...), which the middleware then strips back to /?..., creating an infinite loop.\n    rewriteUrl(req, res, `${canonicalPath}${searchParams}`, locale);\n    return next();\n  };\n\n  /**\n   * Handles requests where the locale prefix is present in the pathname.\n   */\n  const handleExistingPathLocale = ({\n    req,\n    res,\n    next,\n    originalPath,\n    searchParams,\n    pathLocale,\n    originalUrl,\n  }: {\n    req: Connect.IncomingMessage;\n    res: ServerResponse<IncomingMessage>;\n    next: Connect.NextFunction;\n    originalPath: string;\n    searchParams: string;\n    pathLocale: Locale;\n    originalUrl?: string;\n  }) => {\n    const rawPath = originalPath.slice(`/${pathLocale}`.length) || '/';\n\n    // Identify the canonical path (internal path).\n    // Ex: /a-propos (from URL) → /about (canonical)\n    const canonicalPath = getCanonicalPath(rawPath, pathLocale, rewriteRules);\n\n    // When rewrite rules are configured and the URL is already a valid localized pretty URL\n    // (e.g. /fr/essais which maps to canonical /fr/tests), do NOT redirect to canonical.\n    //\n    // Why: the SPA router (Solid, React Router, Vue Router…) is expected to define routes using\n    // the localized paths (e.g. <Route path=\"/essais\">) so the browser URL must stay as-is.\n    // A 301 redirect to canonical would:\n    //  1. Change the browser URL to the canonical form (/fr/tests)\n    //  2. Break subsequent client-side navigation because <A> links produced by getLocalizedUrl\n    //     point back to the localized URL (/fr/essais) which then has no matching route.\n    //\n    // We set the locale header and call next() so the server serves the page at the pretty URL.\n    if (canonicalPath !== rawPath) {\n      const newPath = searchParams\n        ? `${originalPath}${searchParams}`\n        : originalPath;\n      rewriteUrl(req, res, newPath, pathLocale);\n      return next();\n    }\n\n    handleDefaultLocaleRedirect({\n      req,\n      res,\n      next,\n      searchParams,\n      pathLocale,\n      canonicalPath,\n      originalUrl,\n    });\n  };\n\n  /**\n   * If the path locale is the default locale but we don't want to prefix the default, remove it.\n   */\n  const handleDefaultLocaleRedirect = ({\n    req,\n    res,\n    next,\n    searchParams,\n    pathLocale,\n    canonicalPath,\n    originalUrl,\n  }: {\n    req: Connect.IncomingMessage;\n    res: ServerResponse<IncomingMessage>;\n    next: Connect.NextFunction;\n    searchParams: string;\n    pathLocale: Locale;\n    canonicalPath: string;\n    originalUrl?: string;\n  }) => {\n    // If we don't prefix the default locale AND the path locale IS the default → strip the prefix\n    if (!prefixDefault && pathLocale === defaultLocale) {\n      const targetLocalizedPathResult = getLocalizedPath(\n        canonicalPath,\n        pathLocale,\n        rewriteRules\n      );\n      const targetLocalizedPath =\n        typeof targetLocalizedPathResult === 'string'\n          ? targetLocalizedPathResult\n          : targetLocalizedPathResult.path;\n\n      // Construct path without prefix\n      const cleanBasePath = basePath.startsWith('/')\n        ? basePath\n        : `/${basePath}`;\n      const normalizedBasePath = cleanBasePath.endsWith('/')\n        ? cleanBasePath.slice(0, -1)\n        : cleanBasePath;\n\n      let finalPath = targetLocalizedPath;\n      if (finalPath.startsWith('/')) finalPath = finalPath.slice(1);\n\n      const fullPath = `${normalizedBasePath}/${finalPath}`.replace(\n        /\\/+/g,\n        '/'\n      );\n\n      // Persist the explicitly-requested default locale. Stripping the prefix\n      // (e.g. /es → /) drops the only locale signal from the URL, so without\n      // this the follow-up request to the canonical path would fall back to\n      // Accept-Language detection and could resolve a different locale.\n      return redirectUrl(req, res, fullPath + (searchParams ?? ''), {\n        originalUrl,\n        persistLocale: pathLocale,\n      });\n    }\n\n    // If we do prefix the default or pathLocale !== default, keep as-is\n    // but rewrite to canonical internally.\n    // Never emit a trailing slash (`/fr/` for the bare `/fr` URL): rewriting\n    // `/fr` to `/fr/` makes the framework issue a trailing-slash normalisation\n    // redirect back to `/fr`, which this proxy rewrites again — an infinite\n    // redirect loop. `getInternalPath` collapses the root path to `/${locale}`.\n    const internalUrl = getInternalPath(canonicalPath, pathLocale);\n    const newPath = searchParams\n      ? `${internalUrl}${searchParams}`\n      : internalUrl;\n\n    rewriteUrl(req, res, newPath, pathLocale);\n    return next();\n  };\n\n  return (req, res, next) => {\n    // Parse original URL for path and query\n    const parsedUrl = parse(req.url ?? '/', true);\n    const originalPath = parsedUrl.pathname ?? '/';\n    const searchParams = parsedUrl.search ?? '';\n\n    // Check if there's a locale prefix in the path FIRST\n    const pathLocale = getPathLocale(originalPath);\n\n    // Bypass special Vite/server endpoints and node_modules\n    if (\n      // Custom ignore function\n      (ignore?.(req) ?? false) ||\n      originalPath.startsWith('/node_modules') ||\n      /**\n       * /^@vite/            # HMR client and helpers\n       * /^@fs/              # file-system import serving\n       * /^@id/              # virtual module ids\n       * /^@tanstack/start-router-manifest # Tanstack Start Router manifest\n       */\n      originalPath.startsWith('/@') ||\n      /**\n       * /^__vite_ping$      # health ping\n       * /^__open-in-editor$\n       * /^__manifest$       # Remix/RR7 lazyRouteDiscovery\n       */\n      originalPath.startsWith('/_')\n    ) {\n      return next();\n    }\n\n    // Static file requests (e.g. /assets/video.mp4): bypass locale routing.\n    // If the URL carries a locale prefix (e.g. /fr/assets/video.mp4),\n    // rewrite the request internally to the unprefixed path (/assets/video.mp4)\n    // so the file can be served correctly from the public directory.\n    if (originalPath.match(/\\.[a-zA-Z0-9]+$/)) {\n      if (pathLocale) {\n        const pathWithoutLocale =\n          originalPath.slice(`/${pathLocale}`.length) || '/';\n        req.url = `${pathWithoutLocale}${searchParams}`;\n      }\n      return next();\n    }\n\n    // Attempt to read the locale from storage (cookies, localStorage, etc.)\n    const storageLocale = getStorageLocale(req);\n\n    // CRITICAL FIX: If there's a valid pathLocale, it takes precedence over storage\n    // This prevents race conditions when cookies are stale during locale switches\n    const effectiveStorageLocale =\n      pathLocale && supportedLocales.includes(pathLocale)\n        ? pathLocale\n        : storageLocale;\n\n    // Store original URL for redirect tracking\n    const originalUrl = req.url;\n\n    // Domain routing: if the path locale is mapped to a different domain, redirect there.\n    // e.g. intlayer.org/zh/about → https://intlayer.zh/about\n    if (\n      process.env.INTLAYER_ROUTING_DOMAINS !== 'false' &&\n      !noPrefix &&\n      pathLocale &&\n      domains\n    ) {\n      const localeDomain = domains[pathLocale as keyof typeof domains];\n      if (localeDomain) {\n        const reqHost = getRequestHostname(req);\n        const domainHost = getDomainHostname(localeDomain);\n        if (domainHost !== reqHost) {\n          const rawPath = originalPath.slice(`/${pathLocale}`.length) || '/';\n          const targetOrigin = getDomainOrigin(localeDomain);\n          // Domain mapping is stable config, so a cacheable 301 is intended\n          // here — unlike locale-detection redirects, which use 302.\n          redirectUrl(req, res, `${targetOrigin}${rawPath}${searchParams}`, {\n            reason: 'domain-routing',\n            originalUrl,\n            status: 301,\n            allowCrossOrigin: true,\n          });\n          return;\n        }\n      }\n    }\n\n    // Domain routing: if the current hostname is exclusively mapped to one locale,\n    // treat it as that locale without a URL prefix.\n    // e.g. intlayer.zh/about → internally rewrite to /zh/about\n    if (\n      process.env.INTLAYER_ROUTING_DOMAINS !== 'false' &&\n      !noPrefix &&\n      !pathLocale\n    ) {\n      const reqHost = getRequestHostname(req);\n      const domainLocale = getLocaleFromDomain(reqHost, domains);\n      if (domainLocale) {\n        const canonicalPath = getCanonicalPath(\n          originalPath,\n          domainLocale,\n          rewriteRules\n        );\n\n        // Default locale without forced prefixing: pass the canonical path\n        // through unchanged, mirroring handleMissingPathLocale. Rewriting `/`\n        // to `/en/` makes TanStack Start issue a trailing-slash normalisation\n        // redirect (/en/ → /en), whose prefix the proxy then strips back to /,\n        // creating an infinite redirect loop.\n        if (!prefixDefault && domainLocale === defaultLocale) {\n          rewriteUrl(\n            req as Connect.IncomingMessage,\n            res,\n            `${canonicalPath}${searchParams}`,\n            domainLocale\n          );\n          return next();\n        }\n\n        // Never emit a trailing slash (`/zh/`): the framework would redirect\n        // it to `/zh`, which this proxy rewrites to `/zh/` again — a loop.\n        const internalPath = getInternalPath(canonicalPath, domainLocale);\n\n        rewriteUrl(\n          req as Connect.IncomingMessage,\n          res,\n          searchParams ? `${internalPath}${searchParams}` : internalPath,\n          domainLocale\n        );\n        return next();\n      }\n    }\n\n    if (noPrefix) {\n      handleNoPrefix({\n        req: req as Connect.IncomingMessage,\n        res,\n        next,\n        originalPath,\n        searchParams,\n        storageLocale: effectiveStorageLocale,\n        originalUrl,\n      });\n      return;\n    }\n\n    handlePrefix({\n      req: req as Connect.IncomingMessage,\n      res,\n      next,\n      originalPath,\n      searchParams,\n      pathLocale,\n      storageLocale: effectiveStorageLocale,\n      originalUrl,\n    });\n  };\n};\n\n/**\n * Vite plugin that provides locale-based routing middleware for **all environments**:\n * development, preview, and production SSR (Nitro / TanStack Start).\n *\n * - **Dev** (`vite dev`): registered via `configureServer`.\n * - **Preview** (`vite preview`): registered via `configurePreviewServer`.\n * - **Production Nitro** (`vite build`): automatically injected via the `.nitro` module\n *   property that `nitro/vite` reads and pushes into `nitroConfig.modules`. The module\n *   registers `intlayerNitroHandler` as a Nitro server middleware — no extra user config\n *   needed.\n *\n * If you need custom config options or an `ignore` predicate in production, bypass\n * auto-injection and create a server middleware file manually:\n *\n * ```ts\n * // server/middleware/intlayerProxy.ts\n * import { fromNodeMiddleware } from 'h3';\n * import { createIntlayerProxyHandler } from 'vite-intlayer';\n *\n * export default fromNodeMiddleware(\n *   createIntlayerProxyHandler({\n *     ignore: (req) => req.url?.startsWith('/api'),\n *     configOptions: myConfig,\n *   })\n * );\n * ```\n *\n * @param options - Plugin-specific options, like ignoring certain paths and Intlayer configuration overrides.\n * @returns A Vite plugin.\n *\n * @example\n * ```ts\n * import { intlayerProxy } from 'vite-intlayer';\n *\n * export default defineConfig({\n *   plugins: [intlayerProxy()],\n * });\n * ```\n *\n * @deprecated Since Intlayer v9, `intlayerProxy()` is bundled directly into the `intlayer()` plugin and enabled by default through the `routing.enableProxy` option (`true` by default). Registering it separately as shown below is now optional.\n */\nexport const intlayerProxy = (options?: IntlayerProxyPluginOptions): Plugin => {\n  const handler = createIntlayerProxyHandler(options);\n  const intlayerConfig = getConfiguration(options?.configOptions);\n  const logger = getAppLogger(intlayerConfig);\n\n  // Ensures the proxy registers its middleware only once, even when it is\n  // registered both via `intlayer()` (which now bundles it) and a manual\n  // `intlayerProxy()` call.\n  const guard = createPrimaryInstanceGuard(PROXY_PLUGIN_NAME);\n\n  /**\n   * Nitro module injected automatically by `nitro/vite`.\n   *\n   * When a Vite plugin carries a `.nitro` property, `nitro/vite` pushes it into\n   * `nitroConfig.modules` during the build phase. The module's `setup` hook adds\n   * our locale-routing handler to Nitro's server pipeline, making locale detection\n   * work in production SSR builds (TanStack Start, Nuxt, etc.) without any extra\n   * user configuration.\n   *\n   * @see https://github.com/nitrojs/nitro (nitro/vite source, line ~402)\n   */\n  const nitroModule = {\n    name: 'intlayer-proxy',\n    setup(nitro: {\n      options: {\n        dev: boolean;\n        handlers: {\n          route: string;\n          handler: string;\n          middleware: boolean;\n        }[];\n      };\n    }) {\n      // In dev mode, locale routing is already handled by configureServer (Vite dev server).\n      // The Nitro dev server uses h3 v2's Web Fetch API event model which is incompatible\n      // with fromNodeMiddleware (h3 v1) and would cause double-execution anyway.\n      // Only inject for production builds where Nitro is the actual HTTP server.\n      if (nitro.options.dev) return;\n\n      const handlerPath = fileURLToPath(\n        new URL('./intlayerNitroHandler.mjs', import.meta.url)\n      );\n\n      // Skip if an identical handler was already registered by another instance\n      // (e.g. both `intlayer()` and a manual `intlayerProxy()`).\n      const alreadyRegistered = nitro.options.handlers.some(\n        (existingHandler) => existingHandler.handler === handlerPath\n      );\n      if (alreadyRegistered) return;\n\n      nitro.options.handlers.push({\n        route: '/**',\n        handler: handlerPath,\n        middleware: true,\n      });\n    },\n  };\n\n  const plugin = {\n    name: PROXY_PLUGIN_NAME,\n    // Decide whether this is the primary instance before registering middleware.\n    configResolved: (config: { plugins: readonly { name: string }[] }) => {\n      guard.resolve(config);\n    },\n    // Injected into nitroConfig.modules by the `nitro/vite` plugin so the\n    // locale-routing middleware is registered in the production Nitro server.\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    nitro: nitroModule as any,\n    // Vite dev server\n    configureServer: (server) => {\n      if (!guard.isPrimary) return;\n      logger(`Intlayer proxy ${colorize('enabled', ANSIColors.GREEN)}`, {\n        level: 'info',\n      });\n      server.middlewares.use(handler);\n    },\n    // Vite preview server\n    configurePreviewServer: (server) => {\n      if (!guard.isPrimary) return;\n      logger(`Intlayer proxy ${colorize('enabled', ANSIColors.GREEN)}`, {\n        level: 'info',\n      });\n      server.middlewares.use(handler);\n    },\n  } as Plugin;\n\n  // Register the plugin object so the dedupe guard can identify the primary\n  // instance by reference during `configResolved`.\n  guard.setPlugin(plugin);\n\n  return plugin;\n};\n\n/**\n * @deprecated Rename to intlayerProxy instead\n *\n * A Vite plugin that integrates a logic similar to the Next.js intlayer middleware.\n *\n * ```ts\n * // Example usage of the plugin in a Vite configuration\n * export default defineConfig({\n *   plugins: [ intlayerMiddleware() ],\n * });\n * ```\n */\nexport const intlayerMiddleware = intlayerProxy;\n\n/**\n * @deprecated Rename to intlayerProxy instead\n *\n * A Vite plugin that integrates a logic similar to the Next.js intlayer middleware.\n *\n * ```ts\n * // Example usage of the plugin in a Vite configuration\n * export default defineConfig({\n *   plugins: [ intlayerMiddleware() ],\n * });\n * ```\n */\nexport const intLayerMiddlewarePlugin = intlayerProxy;\n"],"mappings":"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"}
+{"version":3,"file":"intlayerProxyPlugin.mjs","names":[],"sources":["../../src/intlayerProxyPlugin.ts"],"sourcesContent":["import type { IncomingMessage, ServerResponse } from 'node:http';\nimport { fileURLToPath, parse } from 'node:url';\nimport { ROUTING_MODE } from '@intlayer/config/defaultValues';\nimport { getAppLogger } from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\nimport {\n  formatProxyEnabledMessage,\n  getCanonicalPath,\n  getDomainHostname,\n  getDomainOrigin,\n  getInternalPath,\n  getLocaleFromDomain,\n  getLocalizedPath,\n  getRewriteRules,\n  isProxyStorageLocaleEnabled,\n  localeDetector,\n  resolveProxyMode,\n} from '@intlayer/core/localization';\nimport {\n  getCookie,\n  getLocaleFromStorageServer,\n  setLocaleInStorageServer,\n} from '@intlayer/core/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\n/* @ts-ignore - Vite types error */\nimport type { Connect, Plugin } from 'vite';\nimport { createPrimaryInstanceGuard } from './dedupePlugin';\n\nconst PROXY_PLUGIN_NAME = 'vite-intlayer-middleware-plugin';\n\nexport type IntlayerProxyPluginOptions = {\n  /**\n   * A function that allows you to ignore specific requests from the intlayer proxy.\n   *\n   * @example\n   * ```ts\n   * export default defineConfig({\n   *   plugins: [ intlayerProxy({ ignore: (req) => req.url?.startsWith('/api') }) ],\n   * });\n   * ```\n   *\n   * @param req - The incoming request.\n   * @returns A boolean value indicating whether to ignore the request.\n   */\n  ignore?: (req: IncomingMessage) => boolean | undefined;\n  /**\n   * Optional Intlayer configuration overrides forwarded to `getConfiguration`.\n   *\n   * @example\n   * ```ts\n   * export default defineConfig({\n   *   plugins: [ intlayerProxy({ configOptions: { override: { ... } } }) ],\n   * });\n   * ```\n   */\n  configOptions?: GetConfigurationOptions;\n  /**\n   * Whether a development or preview server is serving the app.\n   *\n   * Set internally by the plugin from `configureServer` /\n   * `configurePreviewServer`. It only matters in the proxy's auto mode, where\n   * a dev server keeps locale routing URL-driven by ignoring the stored locale\n   * as a redirect source.\n   *\n   * Defaults to `false` so that mounting `createIntlayerProxyHandler()`\n   * manually — the documented production Nitro setup — keeps full behaviour.\n   *\n   * @default false\n   */\n  isDevServer?: boolean;\n};\n\n/**\n * A Node.js-compatible Connect middleware function.\n * Compatible with Vite dev/preview server, Node.js http, Express, and h3's\n * `fromNodeMiddleware` wrapper for Nitro/TanStack Start production use.\n */\ntype NodeMiddleware = (\n  req: IncomingMessage,\n  res: ServerResponse<IncomingMessage>,\n  next: () => void\n) => void;\n\n/**\n * Creates a standalone, framework-agnostic locale-routing middleware.\n *\n * This function contains all the locale detection, redirect, and rewrite logic.\n * It is intentionally separated from the Vite plugin so the same handler can be\n * used in every environment:\n *\n * - **Dev**: wired up automatically by `intlayerProxy` via `configureServer`\n * - **Preview**: wired up automatically by `intlayerProxy` via `configurePreviewServer`\n * - **Production (Nitro / TanStack Start)**: create `server/middleware/intlayerProxy.ts`:\n *\n * @example\n * ```ts\n * // server/middleware/intlayerProxy.ts\n * import { fromNodeMiddleware } from 'h3';\n * import { createIntlayerProxyHandler } from 'vite-intlayer';\n *\n * export default fromNodeMiddleware(createIntlayerProxyHandler());\n * ```\n *\n * @param options - Plugin-specific options, such as path ignoring and Intlayer configuration overrides.\n * @returns A Connect-compatible `(req, res, next) => void` middleware.\n *\n */\nexport const createIntlayerProxyHandler = (\n  options?: IntlayerProxyPluginOptions\n): NodeMiddleware => {\n  const { ignore, configOptions, isDevServer = false } = options ?? {};\n  const intlayerConfig = getConfiguration(configOptions);\n\n  const { internationalization, routing } = intlayerConfig;\n  const { locales: supportedLocales, defaultLocale } = internationalization;\n\n  const {\n    basePath = '',\n    mode = ROUTING_MODE,\n    rewrite,\n    domains,\n    enableProxy,\n  } = routing;\n\n  // In auto mode a dev/preview server ignores the stored locale when resolving\n  // which locale a request maps to, so a lingering cookie cannot keep pulling\n  // navigation to another locale while developing. Prefix redirects, locale\n  // persistence and `Accept-Language` detection are unaffected.\n  const canUseStorageLocale = isProxyStorageLocaleEnabled(\n    resolveProxyMode(enableProxy),\n    isDevServer\n  );\n\n  type RedirectCounter = { count: number; lastSeen: number };\n  const redirectCounts = new Map<string, RedirectCounter>();\n  const MAX_REDIRECTS = 10;\n  const REDIRECT_TTL_MS = 2_000;\n\n  // Derived flags from routing.mode\n  const noPrefix =\n    (!(\n      process.env.INTLAYER_ROUTING_MODE &&\n      process.env.INTLAYER_ROUTING_MODE !== 'no-prefix'\n    ) &&\n      mode === 'no-prefix') ||\n    (!(\n      process.env.INTLAYER_ROUTING_MODE &&\n      process.env.INTLAYER_ROUTING_MODE !== 'search-params'\n    ) &&\n      mode === 'search-params');\n  const prefixDefault =\n    !(\n      process.env.INTLAYER_ROUTING_MODE &&\n      process.env.INTLAYER_ROUTING_MODE !== 'prefix-all'\n    ) && mode === 'prefix-all';\n\n  const rewriteRules =\n    process.env.INTLAYER_ROUTING_REWRITE_RULES !== 'false'\n      ? getRewriteRules(rewrite, 'url')\n      : undefined;\n\n  /**\n   * Extracts the hostname from a request's `Host` header, handling IPv6\n   * literals (`[::1]:5173` → `::1`) that a plain `split(':')` would mangle.\n   */\n  const getRequestHostname = (req: IncomingMessage): string => {\n    const host = req.headers.host ?? '';\n    const ipv6Match = host.match(/^\\[([^\\]]+)\\]/);\n    if (ipv6Match) return ipv6Match[1]!;\n    return host.split(':')[0] ?? '';\n  };\n\n  /* --------------------------------------------------------------------\n   *                     Helper & Utility Functions\n   * --------------------------------------------------------------------\n   */\n\n  /**\n   * Retrieves the locale from storage (cookies, localStorage, sessionStorage).\n   *\n   * Returns `undefined` when the stored locale is not allowed to drive locale\n   * resolution (auto mode on a dev/preview server), which makes every caller\n   * fall through to `Accept-Language` detection and then the default locale.\n   */\n  const getStorageLocale = (req: IncomingMessage): Locale | undefined => {\n    if (!canUseStorageLocale) return undefined;\n\n    const locale = getLocaleFromStorageServer({\n      getCookie: (name: string) => getCookie(name, req.headers.cookie),\n    });\n    return locale;\n  };\n\n  /**\n   * Appends locale to search params when routing mode is 'search-params'.\n   */\n  const appendLocaleSearchIfNeeded = (\n    search: string | undefined,\n    locale: Locale\n  ): string | undefined => {\n    if (\n      (process.env.INTLAYER_ROUTING_MODE &&\n        process.env.INTLAYER_ROUTING_MODE !== 'search-params') ||\n      mode !== 'search-params'\n    )\n      return search;\n\n    const params = new URLSearchParams(search ?? '');\n\n    params.set('locale', locale);\n\n    return `?${params.toString()}`;\n  };\n\n  /**\n   * Checks whether a pathname starts with the given locale as a full path\n   * segment (`/fr` or `/fr/...`). A bare `startsWith('/fr')` would also match\n   * unrelated paths like `/friends`, causing wrong prefix stripping and\n   * self-redirect loops.\n   */\n  const hasLocaleSegmentPrefix = (pathname: string, locale: Locale): boolean =>\n    pathname === `/${locale}` || pathname.startsWith(`/${locale}/`);\n\n  /**\n   * Extracts the locale from the URL pathname if present as the first segment.\n   * e.g. if pathname is /en/some/page or /en, checks if \"en\" is in supportedLocales.\n   */\n  const getPathLocale = (pathname: string): Locale | undefined => {\n    const segments = pathname.split('/').filter(Boolean);\n    const firstSegment = segments[0];\n    if (firstSegment && supportedLocales.includes(firstSegment as Locale)) {\n      return firstSegment as Locale;\n    }\n    return undefined;\n  };\n\n  /**\n   * Persists the resolved locale onto the outgoing response as a cookie (and\n   * header, per `routing.storage`). Only the cookie survives a client redirect,\n   * so this is what carries an explicitly-selected locale across a\n   * prefix-stripping redirect. Enabled cookie/header targets are resolved by\n   * {@link setLocaleInStorageServer} from the config; disabled ones are no-ops.\n   */\n  const persistLocaleOnResponse = (\n    res: ServerResponse<IncomingMessage>,\n    locale: Locale\n  ) => {\n    setLocaleInStorageServer(locale, {\n      setCookieStore: (name, value, attributes) => {\n        const parts: string[] = [`${name}=${encodeURIComponent(value)}`];\n        if (attributes.path) parts.push(`Path=${attributes.path}`);\n        if (attributes.domain) parts.push(`Domain=${attributes.domain}`);\n        if (typeof attributes.expires === 'number')\n          parts.push(`Expires=${new Date(attributes.expires).toUTCString()}`);\n        if (attributes.secure) parts.push('Secure');\n        if (attributes.httpOnly) parts.push('HttpOnly');\n        if (attributes.sameSite) parts.push(`SameSite=${attributes.sameSite}`);\n\n        const cookieString = parts.join('; ');\n        const existing = res.getHeader('Set-Cookie');\n        const cookies = Array.isArray(existing)\n          ? existing.map(String)\n          : existing !== undefined\n            ? [String(existing)]\n            : [];\n        cookies.push(cookieString);\n        res.setHeader('Set-Cookie', cookies);\n      },\n      setHeader: (name: string, value: string) => {\n        res.setHeader(name, value);\n      },\n    });\n  };\n\n  /**\n   * Identifies the client issuing a request, so redirect-loop tracking is\n   * scoped per client. Without this, concurrent visitors hitting the same\n   * legitimate redirect (e.g. `/` → `/fr/`) would share one counter and trip\n   * the loop detector under normal production traffic.\n   */\n  const getClientKey = (req: IncomingMessage): string => {\n    const forwardedFor = req.headers['x-forwarded-for'];\n    const forwardedIp = (\n      Array.isArray(forwardedFor) ? forwardedFor[0] : forwardedFor\n    )\n      ?.split(',')[0]\n      ?.trim();\n\n    return forwardedIp || req.socket?.remoteAddress || 'unknown';\n  };\n\n  /**\n   * Strips any origin from a redirect target, keeping only path, search and\n   * hash. Prevents open redirects: user-controlled paths like `//evil.com/x`\n   * would otherwise be echoed verbatim into the `Location` header and be\n   * interpreted by browsers as a protocol-relative cross-origin URL.\n   */\n  const toSameOriginUrl = (url: string): string => {\n    try {\n      const parsed = new URL(url, 'http://intlayer-internal');\n      return `${parsed.pathname}${parsed.search}${parsed.hash}`;\n    } catch {\n      return url;\n    }\n  };\n\n  type RedirectOptions = {\n    /** Human-readable reason logged when a redirect loop is detected. */\n    reason?: string;\n    /** The URL of the incoming request, used for redirect-loop tracking. */\n    originalUrl?: string;\n    /**\n     * When provided, the locale is persisted (cookie/header, per config) on\n     * the redirect response so the follow-up request resolves the same locale.\n     */\n    persistLocale?: Locale;\n    /**\n     * HTTP status for the redirect. Defaults to 302: locale redirects depend\n     * on mutable state (cookie, Accept-Language) and must not be cached by\n     * the browser as permanent. Domain-routing redirects pass 301 explicitly.\n     */\n    status?: number;\n    /**\n     * Allows a cross-origin `Location` target. Only the domain-routing\n     * redirect sets this; all other targets are sanitized to same-origin.\n     */\n    allowCrossOrigin?: boolean;\n  };\n\n  /**\n   * Writes a redirect response with the given new URL.\n   */\n  const redirectUrl = (\n    req: IncomingMessage,\n    res: ServerResponse<IncomingMessage>,\n    newUrl: string,\n    options?: RedirectOptions\n  ) => {\n    const {\n      reason,\n      originalUrl,\n      persistLocale,\n      status = 302,\n      allowCrossOrigin = false,\n    } = options ?? {};\n\n    const targetUrl = allowCrossOrigin ? newUrl : toSameOriginUrl(newUrl);\n\n    if (originalUrl) {\n      if (originalUrl === targetUrl) {\n        console.error('[REDIRECT LOOP DETECTED!]', { originalUrl, reason });\n        res.writeHead(500, { 'Content-Type': 'text/plain' });\n        return res.end(\n          `Redirect loop detected: ${originalUrl} redirects to itself`\n        );\n      }\n\n      const now = Date.now();\n      const trackingKey = `${getClientKey(req)}|${originalUrl} -> ${targetUrl}`;\n      const previousEntry = redirectCounts.get(trackingKey);\n      const count =\n        previousEntry && now - previousEntry.lastSeen < REDIRECT_TTL_MS\n          ? previousEntry.count + 1\n          : 1;\n\n      redirectCounts.set(trackingKey, { count, lastSeen: now });\n\n      if (count > MAX_REDIRECTS) {\n        console.error('[REDIRECT LOOP DETECTED!]', {\n          originalUrl,\n          redirectCount: count,\n          lastRedirectTo: targetUrl,\n          reason,\n        });\n        res.writeHead(500, { 'Content-Type': 'text/plain' });\n        return res.end(\n          `Redirect loop detected: ${count} redirects from ${originalUrl}`\n        );\n      }\n\n      for (const [entryKey, entry] of redirectCounts) {\n        if (now - entry.lastSeen >= REDIRECT_TTL_MS)\n          redirectCounts.delete(entryKey);\n      }\n    }\n\n    if (persistLocale) {\n      persistLocaleOnResponse(res, persistLocale);\n    }\n\n    res.writeHead(status, { Location: targetUrl });\n    return res.end();\n  };\n\n  /**\n   * \"Rewrite\" the request internally by adjusting req.url.\n   * Also sets the locale in the response/request headers via storage to mimic\n   * Next.js's behaviour of propagating the detected locale downstream.\n   */\n  const rewriteUrl = (\n    req: Connect.IncomingMessage,\n    res: ServerResponse<IncomingMessage>,\n    newUrl: string,\n    locale?: Locale\n  ) => {\n    if (req.url !== newUrl) {\n      req.url = newUrl;\n    }\n    if (locale) {\n      setLocaleInStorageServer(locale, {\n        setHeader: (name: string, value: string) => {\n          res.setHeader(name, value);\n          req.headers[name] = value;\n        },\n      });\n    }\n  };\n\n  /**\n   * Constructs a new path string, optionally including a locale prefix, basePath, and search parameters.\n   * - basePath:    (e.g. '/myapp')\n   * - locale:      (e.g. 'en')\n   * - currentPath: (e.g. '/products/shoes')\n   * - search:      (e.g. '?foo=bar')\n   */\n  const constructPath = (\n    locale: Locale,\n    currentPath: string,\n    search?: string\n  ) => {\n    // Strip any incoming locale prefix to avoid double-prefixing\n    const pathWithoutPrefix = hasLocaleSegmentPrefix(currentPath, locale)\n      ? currentPath.slice(`/${locale}`.length)\n      : currentPath;\n\n    // Ensure basePath always starts with '/' and has no trailing slash\n    const cleanBasePath = basePath.startsWith('/') ? basePath : `/${basePath}`;\n    const normalizedBasePath = cleanBasePath.endsWith('/')\n      ? cleanBasePath.slice(0, -1)\n      : cleanBasePath;\n\n    // In 'search-params' and 'no-prefix' modes, do not prefix the path with the locale\n    if (\n      (!(\n        process.env.INTLAYER_ROUTING_MODE &&\n        process.env.INTLAYER_ROUTING_MODE !== 'no-prefix'\n      ) &&\n        mode === 'no-prefix') ||\n      (!(\n        process.env.INTLAYER_ROUTING_MODE &&\n        process.env.INTLAYER_ROUTING_MODE !== 'search-params'\n      ) &&\n        mode === 'search-params')\n    ) {\n      const newPath = search\n        ? `${pathWithoutPrefix || '/'}${search}`\n        : pathWithoutPrefix || '/';\n      return newPath;\n    }\n\n    // Check if path already starts with locale to avoid double-prefixing\n    const pathWithLocalePrefix = hasLocaleSegmentPrefix(currentPath, locale)\n      ? currentPath\n      : `/${locale}${currentPath}`;\n\n    let newPath = `${normalizedBasePath}${pathWithLocalePrefix}`;\n\n    // Special case: if prefixDefault is false and locale is defaultLocale, remove the locale prefix\n    if (!prefixDefault && locale === defaultLocale) {\n      newPath = `${normalizedBasePath}${pathWithoutPrefix || '/'}`;\n    }\n\n    // Never emit a trailing slash (`/fr/` for the root path): the framework's\n    // trailing-slash normalisation would redirect it back and forth with this\n    // proxy, creating an infinite redirect loop.\n    if (newPath.length > 1 && newPath.endsWith('/')) {\n      newPath = newPath.slice(0, -1);\n    }\n\n    // Append search parameters if provided\n    if (search) {\n      newPath += search;\n    }\n\n    return newPath;\n  };\n\n  /* --------------------------------------------------------------------\n   *               Handlers that mirror Next.js style logic\n   * --------------------------------------------------------------------\n   */\n\n  /**\n   * If `noPrefix` is true, we never prefix the locale in the URL.\n   * We simply rewrite the request to the same path, but with the best-chosen locale\n   * in a header or search params if desired.\n   */\n  const handleNoPrefix = ({\n    req,\n    res,\n    next,\n    originalPath,\n    searchParams,\n    storageLocale,\n    originalUrl,\n  }: {\n    req: Connect.IncomingMessage;\n    res: ServerResponse<IncomingMessage>;\n    next: Connect.NextFunction;\n    originalPath: string;\n    searchParams: string;\n    storageLocale?: Locale;\n    originalUrl?: string;\n  }) => {\n    const pathLocale = getPathLocale(originalPath);\n\n    // Determine the best locale: prefer cookie/storage, fall back to Accept-Language detection\n    let locale = storageLocale ?? defaultLocale;\n\n    // Use localeDetector if no storage locale is available\n    if (!storageLocale) {\n      const detectedLocale = localeDetector(\n        req.headers as Record<string, string>,\n        supportedLocales,\n        defaultLocale\n      );\n      locale = detectedLocale as Locale;\n    }\n\n    // Guard against a stale/unsupported locale coming from storage or detection\n    if (!supportedLocales.includes(locale)) {\n      locale = defaultLocale;\n    }\n\n    if (pathLocale) {\n      const pathWithoutLocale =\n        originalPath.slice(`/${pathLocale}`.length) || '/';\n\n      const canonicalPath = getCanonicalPath(\n        pathWithoutLocale,\n        pathLocale,\n        rewriteRules\n      );\n\n      const search = appendLocaleSearchIfNeeded(searchParams, pathLocale);\n\n      const redirectPath = search\n        ? `${canonicalPath}${search}`\n        : `${canonicalPath}${searchParams ?? ''}`;\n\n      // Persist the explicitly-requested locale: stripping the prefix drops\n      // the only locale signal from the URL, so without this the follow-up\n      // request would fall back to cookie / Accept-Language detection and\n      // could resolve a different locale.\n      return redirectUrl(req, res, redirectPath, {\n        originalUrl,\n        persistLocale: pathLocale,\n      });\n    }\n\n    const canonicalPath = getCanonicalPath(originalPath, locale, rewriteRules);\n\n    // In search-params mode, we need to redirect to add the locale search param\n    if (\n      !(\n        process.env.INTLAYER_ROUTING_MODE &&\n        process.env.INTLAYER_ROUTING_MODE !== 'search-params'\n      ) &&\n      mode === 'search-params'\n    ) {\n      // Check if locale search param already exists and matches the detected locale\n      const existingSearchParams = new URLSearchParams(searchParams ?? '');\n      const existingLocale = existingSearchParams.get('locale');\n\n      if (existingLocale === locale) {\n        // Rewrite internally — URL stays the same in the browser, but the framework\n        // sees /[locale]/path so the [locale] route param is populated correctly.\n        // getInternalPath collapses the root path to `/${locale}` — a trailing\n        // slash (`/fr/`) would trigger the framework's trailing-slash\n        // normalisation redirect and loop with this proxy.\n        const internalPath = getInternalPath(canonicalPath, locale);\n        const rewritePath = `${internalPath}${searchParams ?? ''}`;\n\n        rewriteUrl(req, res, rewritePath, locale);\n        return next();\n      }\n\n      // Locale param missing or doesn't match — redirect to add/update it (URL changes in browser)\n      const search = appendLocaleSearchIfNeeded(searchParams, locale);\n      const redirectPath = search\n        ? `${originalPath}${search}`\n        : `${originalPath}${searchParams ?? ''}`;\n\n      return redirectUrl(req, res, redirectPath, { originalUrl });\n    }\n\n    // For no-prefix mode (not search-params), add locale prefix internally for routing\n    // so the framework can match the [locale] route param without exposing it in the URL.\n    // getInternalPath collapses the root path to `/${locale}` — a trailing slash\n    // (`/fr/`) would trigger the framework's trailing-slash normalisation\n    // redirect and loop with this proxy.\n    const internalPath = getInternalPath(canonicalPath, locale);\n\n    const search = appendLocaleSearchIfNeeded(searchParams, locale);\n    const rewritePath = search\n      ? `${internalPath}${search}`\n      : `${internalPath}${searchParams ?? ''}`;\n\n    // Rewrite internally — URL stays the same in the browser\n    rewriteUrl(req, res, rewritePath, locale);\n\n    return next();\n  };\n\n  /**\n   * The main prefix logic.\n   */\n  const handlePrefix = ({\n    req,\n    res,\n    next,\n    originalPath,\n    searchParams,\n    pathLocale,\n    storageLocale,\n    originalUrl,\n  }: {\n    req: Connect.IncomingMessage;\n    res: ServerResponse<IncomingMessage>;\n    next: Connect.NextFunction;\n    originalPath: string;\n    searchParams: string;\n    pathLocale?: Locale;\n    storageLocale?: Locale;\n    originalUrl?: string;\n  }) => {\n    if (!pathLocale) {\n      handleMissingPathLocale({\n        req,\n        res,\n        next,\n        originalPath,\n        searchParams,\n        storageLocale,\n        originalUrl,\n      });\n      return;\n    }\n\n    handleExistingPathLocale({\n      req,\n      res,\n      next,\n      originalPath,\n      searchParams,\n      pathLocale,\n      originalUrl,\n    });\n  };\n\n  /**\n   * Handles requests where the locale is missing from the URL pathname.\n   * Detects a locale from storage / headers / default, then either redirects or rewrites.\n   */\n  const handleMissingPathLocale = ({\n    req,\n    res,\n    next,\n    originalPath,\n    searchParams,\n    storageLocale,\n    originalUrl,\n  }: {\n    req: Connect.IncomingMessage;\n    res: ServerResponse<IncomingMessage>;\n    next: Connect.NextFunction;\n    originalPath: string;\n    searchParams: string;\n    storageLocale?: Locale;\n    originalUrl?: string;\n  }) => {\n    // Choose the best locale: cookie/storage → Accept-Language detection → defaultLocale\n    let locale = (storageLocale ??\n      localeDetector(\n        req.headers as Record<string, string>,\n        supportedLocales,\n        defaultLocale\n      )) as Locale;\n\n    // If still invalid, fall back to defaultLocale\n    if (!supportedLocales.includes(locale)) {\n      locale = defaultLocale;\n    }\n\n    // Resolve to canonical path.\n    // If user visits /a-propos (implied 'fr'), this resolves to /about\n    const canonicalPath = getCanonicalPath(originalPath, locale, rewriteRules);\n\n    // Determine target localized path for redirection.\n    // /about + 'fr' → /a-propos\n    const targetLocalizedPathResult = getLocalizedPath(\n      canonicalPath,\n      locale,\n      rewriteRules\n    );\n    const targetLocalizedPath =\n      typeof targetLocalizedPathResult === 'string'\n        ? targetLocalizedPathResult\n        : targetLocalizedPathResult.path;\n\n    // Construct new path, preserving original search params\n    const search = appendLocaleSearchIfNeeded(searchParams, locale);\n    const newPath = constructPath(locale, targetLocalizedPath, search);\n\n    // If we always prefix default or if this is not the default locale,\n    // do a redirect so the user sees the locale in the URL\n    if (prefixDefault || locale !== defaultLocale) {\n      return redirectUrl(req, res, newPath, { originalUrl });\n    }\n\n    // If we do NOT prefix the default locale, pass through the canonical path unchanged.\n    // Rewriting to `/${locale}${canonicalPath}` (e.g. /en/) causes TanStack Start to issue a\n    // trailing-slash normalisation redirect (/en/ → /en), which the proxy then strips back to /,\n    // creating an infinite redirect loop.\n    // Because {-$locale} is an optional segment, the framework matches the un-prefixed URL with\n    // locale=undefined and falls back to defaultLocale via `params.locale ?? defaultLocale`.\n    // searchParams MUST be preserved here — dropping them causes the framework (e.g. TanStack Start) to\n    // see a URL with no search params, trigger a validateSearch normalisation redirect to the prefixed URL\n    // (e.g. /en?page=1&...), which the middleware then strips back to /?..., creating an infinite loop.\n    rewriteUrl(req, res, `${canonicalPath}${searchParams}`, locale);\n    return next();\n  };\n\n  /**\n   * Handles requests where the locale prefix is present in the pathname.\n   */\n  const handleExistingPathLocale = ({\n    req,\n    res,\n    next,\n    originalPath,\n    searchParams,\n    pathLocale,\n    originalUrl,\n  }: {\n    req: Connect.IncomingMessage;\n    res: ServerResponse<IncomingMessage>;\n    next: Connect.NextFunction;\n    originalPath: string;\n    searchParams: string;\n    pathLocale: Locale;\n    originalUrl?: string;\n  }) => {\n    const rawPath = originalPath.slice(`/${pathLocale}`.length) || '/';\n\n    // Identify the canonical path (internal path).\n    // Ex: /a-propos (from URL) → /about (canonical)\n    const canonicalPath = getCanonicalPath(rawPath, pathLocale, rewriteRules);\n\n    // When rewrite rules are configured and the URL is already a valid localized pretty URL\n    // (e.g. /fr/essais which maps to canonical /fr/tests), do NOT redirect to canonical.\n    //\n    // Why: the SPA router (Solid, React Router, Vue Router…) is expected to define routes using\n    // the localized paths (e.g. <Route path=\"/essais\">) so the browser URL must stay as-is.\n    // A 301 redirect to canonical would:\n    //  1. Change the browser URL to the canonical form (/fr/tests)\n    //  2. Break subsequent client-side navigation because <A> links produced by getLocalizedUrl\n    //     point back to the localized URL (/fr/essais) which then has no matching route.\n    //\n    // We set the locale header and call next() so the server serves the page at the pretty URL.\n    if (canonicalPath !== rawPath) {\n      const newPath = searchParams\n        ? `${originalPath}${searchParams}`\n        : originalPath;\n      rewriteUrl(req, res, newPath, pathLocale);\n      return next();\n    }\n\n    handleDefaultLocaleRedirect({\n      req,\n      res,\n      next,\n      searchParams,\n      pathLocale,\n      canonicalPath,\n      originalUrl,\n    });\n  };\n\n  /**\n   * If the path locale is the default locale but we don't want to prefix the default, remove it.\n   */\n  const handleDefaultLocaleRedirect = ({\n    req,\n    res,\n    next,\n    searchParams,\n    pathLocale,\n    canonicalPath,\n    originalUrl,\n  }: {\n    req: Connect.IncomingMessage;\n    res: ServerResponse<IncomingMessage>;\n    next: Connect.NextFunction;\n    searchParams: string;\n    pathLocale: Locale;\n    canonicalPath: string;\n    originalUrl?: string;\n  }) => {\n    // If we don't prefix the default locale AND the path locale IS the default → strip the prefix\n    if (!prefixDefault && pathLocale === defaultLocale) {\n      const targetLocalizedPathResult = getLocalizedPath(\n        canonicalPath,\n        pathLocale,\n        rewriteRules\n      );\n      const targetLocalizedPath =\n        typeof targetLocalizedPathResult === 'string'\n          ? targetLocalizedPathResult\n          : targetLocalizedPathResult.path;\n\n      // Construct path without prefix\n      const cleanBasePath = basePath.startsWith('/')\n        ? basePath\n        : `/${basePath}`;\n      const normalizedBasePath = cleanBasePath.endsWith('/')\n        ? cleanBasePath.slice(0, -1)\n        : cleanBasePath;\n\n      let finalPath = targetLocalizedPath;\n      if (finalPath.startsWith('/')) finalPath = finalPath.slice(1);\n\n      const fullPath = `${normalizedBasePath}/${finalPath}`.replace(\n        /\\/+/g,\n        '/'\n      );\n\n      // Persist the explicitly-requested default locale. Stripping the prefix\n      // (e.g. /es → /) drops the only locale signal from the URL, so without\n      // this the follow-up request to the canonical path would fall back to\n      // Accept-Language detection and could resolve a different locale.\n      return redirectUrl(req, res, fullPath + (searchParams ?? ''), {\n        originalUrl,\n        persistLocale: pathLocale,\n      });\n    }\n\n    // If we do prefix the default or pathLocale !== default, keep as-is\n    // but rewrite to canonical internally.\n    // Never emit a trailing slash (`/fr/` for the bare `/fr` URL): rewriting\n    // `/fr` to `/fr/` makes the framework issue a trailing-slash normalisation\n    // redirect back to `/fr`, which this proxy rewrites again — an infinite\n    // redirect loop. `getInternalPath` collapses the root path to `/${locale}`.\n    const internalUrl = getInternalPath(canonicalPath, pathLocale);\n    const newPath = searchParams\n      ? `${internalUrl}${searchParams}`\n      : internalUrl;\n\n    rewriteUrl(req, res, newPath, pathLocale);\n    return next();\n  };\n\n  return (req, res, next) => {\n    // Parse original URL for path and query\n    const parsedUrl = parse(req.url ?? '/', true);\n    const originalPath = parsedUrl.pathname ?? '/';\n    const searchParams = parsedUrl.search ?? '';\n\n    // Check if there's a locale prefix in the path FIRST\n    const pathLocale = getPathLocale(originalPath);\n\n    // Bypass special Vite/server endpoints and node_modules\n    if (\n      // Custom ignore function\n      (ignore?.(req) ?? false) ||\n      originalPath.startsWith('/node_modules') ||\n      /**\n       * /^@vite/            # HMR client and helpers\n       * /^@fs/              # file-system import serving\n       * /^@id/              # virtual module ids\n       * /^@tanstack/start-router-manifest # Tanstack Start Router manifest\n       */\n      originalPath.startsWith('/@') ||\n      /**\n       * /^__vite_ping$      # health ping\n       * /^__open-in-editor$\n       * /^__manifest$       # Remix/RR7 lazyRouteDiscovery\n       */\n      originalPath.startsWith('/_')\n    ) {\n      return next();\n    }\n\n    // Static file requests (e.g. /assets/video.mp4): bypass locale routing.\n    // If the URL carries a locale prefix (e.g. /fr/assets/video.mp4),\n    // rewrite the request internally to the unprefixed path (/assets/video.mp4)\n    // so the file can be served correctly from the public directory.\n    if (originalPath.match(/\\.[a-zA-Z0-9]+$/)) {\n      if (pathLocale) {\n        const pathWithoutLocale =\n          originalPath.slice(`/${pathLocale}`.length) || '/';\n        req.url = `${pathWithoutLocale}${searchParams}`;\n      }\n      return next();\n    }\n\n    // Attempt to read the locale from storage (cookies, localStorage, etc.)\n    const storageLocale = getStorageLocale(req);\n\n    // CRITICAL FIX: If there's a valid pathLocale, it takes precedence over storage\n    // This prevents race conditions when cookies are stale during locale switches\n    const effectiveStorageLocale =\n      pathLocale && supportedLocales.includes(pathLocale)\n        ? pathLocale\n        : storageLocale;\n\n    // Store original URL for redirect tracking\n    const originalUrl = req.url;\n\n    // Domain routing: if the path locale is mapped to a different domain, redirect there.\n    // e.g. intlayer.org/zh/about → https://intlayer.zh/about\n    if (\n      process.env.INTLAYER_ROUTING_DOMAINS !== 'false' &&\n      !noPrefix &&\n      pathLocale &&\n      domains\n    ) {\n      const localeDomain = domains[pathLocale as keyof typeof domains];\n      if (localeDomain) {\n        const reqHost = getRequestHostname(req);\n        const domainHost = getDomainHostname(localeDomain);\n        if (domainHost !== reqHost) {\n          const rawPath = originalPath.slice(`/${pathLocale}`.length) || '/';\n          const targetOrigin = getDomainOrigin(localeDomain);\n          // Domain mapping is stable config, so a cacheable 301 is intended\n          // here — unlike locale-detection redirects, which use 302.\n          redirectUrl(req, res, `${targetOrigin}${rawPath}${searchParams}`, {\n            reason: 'domain-routing',\n            originalUrl,\n            status: 301,\n            allowCrossOrigin: true,\n          });\n          return;\n        }\n      }\n    }\n\n    // Domain routing: if the current hostname is exclusively mapped to one locale,\n    // treat it as that locale without a URL prefix.\n    // e.g. intlayer.zh/about → internally rewrite to /zh/about\n    if (\n      process.env.INTLAYER_ROUTING_DOMAINS !== 'false' &&\n      !noPrefix &&\n      !pathLocale\n    ) {\n      const reqHost = getRequestHostname(req);\n      const domainLocale = getLocaleFromDomain(reqHost, domains);\n      if (domainLocale) {\n        const canonicalPath = getCanonicalPath(\n          originalPath,\n          domainLocale,\n          rewriteRules\n        );\n\n        // Default locale without forced prefixing: pass the canonical path\n        // through unchanged, mirroring handleMissingPathLocale. Rewriting `/`\n        // to `/en/` makes TanStack Start issue a trailing-slash normalisation\n        // redirect (/en/ → /en), whose prefix the proxy then strips back to /,\n        // creating an infinite redirect loop.\n        if (!prefixDefault && domainLocale === defaultLocale) {\n          rewriteUrl(\n            req as Connect.IncomingMessage,\n            res,\n            `${canonicalPath}${searchParams}`,\n            domainLocale\n          );\n          return next();\n        }\n\n        // Never emit a trailing slash (`/zh/`): the framework would redirect\n        // it to `/zh`, which this proxy rewrites to `/zh/` again — a loop.\n        const internalPath = getInternalPath(canonicalPath, domainLocale);\n\n        rewriteUrl(\n          req as Connect.IncomingMessage,\n          res,\n          searchParams ? `${internalPath}${searchParams}` : internalPath,\n          domainLocale\n        );\n        return next();\n      }\n    }\n\n    if (noPrefix) {\n      handleNoPrefix({\n        req: req as Connect.IncomingMessage,\n        res,\n        next,\n        originalPath,\n        searchParams,\n        storageLocale: effectiveStorageLocale,\n        originalUrl,\n      });\n      return;\n    }\n\n    handlePrefix({\n      req: req as Connect.IncomingMessage,\n      res,\n      next,\n      originalPath,\n      searchParams,\n      pathLocale,\n      storageLocale: effectiveStorageLocale,\n      originalUrl,\n    });\n  };\n};\n\n/**\n * Vite plugin that provides locale-based routing middleware for **all environments**:\n * development, preview, and production SSR (Nitro / TanStack Start).\n *\n * - **Dev** (`vite dev`): registered via `configureServer`.\n * - **Preview** (`vite preview`): registered via `configurePreviewServer`.\n * - **Production Nitro** (`vite build`): automatically injected via the `.nitro` module\n *   property that `nitro/vite` reads and pushes into `nitroConfig.modules`. The module\n *   registers `intlayerNitroHandler` as a Nitro server middleware — no extra user config\n *   needed.\n *\n * If you need custom config options or an `ignore` predicate in production, bypass\n * auto-injection and create a server middleware file manually:\n *\n * ```ts\n * // server/middleware/intlayerProxy.ts\n * import { fromNodeMiddleware } from 'h3';\n * import { createIntlayerProxyHandler } from 'vite-intlayer';\n *\n * export default fromNodeMiddleware(\n *   createIntlayerProxyHandler({\n *     ignore: (req) => req.url?.startsWith('/api'),\n *     configOptions: myConfig,\n *   })\n * );\n * ```\n *\n * @param options - Plugin-specific options, like ignoring certain paths and Intlayer configuration overrides.\n * @returns A Vite plugin.\n *\n * @example\n * ```ts\n * import { intlayerProxy } from 'vite-intlayer';\n *\n * export default defineConfig({\n *   plugins: [intlayerProxy()],\n * });\n * ```\n *\n * @deprecated Since Intlayer v9, `intlayerProxy()` is bundled directly into the `intlayer()` plugin and enabled by default through the `routing.enableProxy` option (unset by default, which selects auto mode). Registering it separately as shown below is now optional.\n */\nexport const intlayerProxy = (options?: IntlayerProxyPluginOptions): Plugin => {\n  // Dev and preview servers run the same handler; both are \"dev servers\" as far\n  // as auto mode is concerned, so a single instance covers both hooks.\n  const handler = createIntlayerProxyHandler({ ...options, isDevServer: true });\n  const intlayerConfig = getConfiguration(options?.configOptions);\n  const logger = getAppLogger(intlayerConfig);\n\n  // Both hooks below serve a dev or preview server, hence the hard-coded true.\n  const isStorageLocaleSuppressed = !isProxyStorageLocaleEnabled(\n    resolveProxyMode(intlayerConfig.routing.enableProxy),\n    true\n  );\n\n  /**\n   * Logs that the proxy is serving requests, spelling out when auto mode has\n   * suppressed the stored locale so the reported state matches the behaviour.\n   */\n  const logProxyEnabled = () =>\n    logger(formatProxyEnabledMessage(isStorageLocaleSuppressed), {\n      level: 'info',\n    });\n\n  // Ensures the proxy registers its middleware only once, even when it is\n  // registered both via `intlayer()` (which now bundles it) and a manual\n  // `intlayerProxy()` call.\n  const guard = createPrimaryInstanceGuard(PROXY_PLUGIN_NAME);\n\n  /**\n   * Nitro module injected automatically by `nitro/vite`.\n   *\n   * When a Vite plugin carries a `.nitro` property, `nitro/vite` pushes it into\n   * `nitroConfig.modules` during the build phase. The module's `setup` hook adds\n   * our locale-routing handler to Nitro's server pipeline, making locale detection\n   * work in production SSR builds (TanStack Start, Nuxt, etc.) without any extra\n   * user configuration.\n   *\n   * @see https://github.com/nitrojs/nitro (nitro/vite source, line ~402)\n   */\n  const nitroModule = {\n    name: 'intlayer-proxy',\n    setup(nitro: {\n      options: {\n        dev: boolean;\n        handlers: {\n          route: string;\n          handler: string;\n          middleware: boolean;\n        }[];\n      };\n    }) {\n      // In dev mode, locale routing is already handled by configureServer (Vite dev server).\n      // The Nitro dev server uses h3 v2's Web Fetch API event model which is incompatible\n      // with fromNodeMiddleware (h3 v1) and would cause double-execution anyway.\n      // Only inject for production builds where Nitro is the actual HTTP server.\n      if (nitro.options.dev) return;\n\n      const handlerPath = fileURLToPath(\n        new URL('./intlayerNitroHandler.mjs', import.meta.url)\n      );\n\n      // Skip if an identical handler was already registered by another instance\n      // (e.g. both `intlayer()` and a manual `intlayerProxy()`).\n      const alreadyRegistered = nitro.options.handlers.some(\n        (existingHandler) => existingHandler.handler === handlerPath\n      );\n      if (alreadyRegistered) return;\n\n      nitro.options.handlers.push({\n        route: '/**',\n        handler: handlerPath,\n        middleware: true,\n      });\n    },\n  };\n\n  const plugin = {\n    name: PROXY_PLUGIN_NAME,\n    // Decide whether this is the primary instance before registering middleware.\n    configResolved: (config: { plugins: readonly { name: string }[] }) => {\n      guard.resolve(config);\n    },\n    // Injected into nitroConfig.modules by the `nitro/vite` plugin so the\n    // locale-routing middleware is registered in the production Nitro server.\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    nitro: nitroModule as any,\n    // Vite dev server\n    configureServer: (server) => {\n      if (!guard.isPrimary) return;\n      logProxyEnabled();\n      server.middlewares.use(handler);\n    },\n    // Vite preview server\n    configurePreviewServer: (server) => {\n      if (!guard.isPrimary) return;\n      logProxyEnabled();\n      server.middlewares.use(handler);\n    },\n  } as Plugin;\n\n  // Register the plugin object so the dedupe guard can identify the primary\n  // instance by reference during `configResolved`.\n  guard.setPlugin(plugin);\n\n  return plugin;\n};\n\n/**\n * @deprecated Rename to intlayerProxy instead\n *\n * A Vite plugin that integrates a logic similar to the Next.js intlayer middleware.\n *\n * ```ts\n * // Example usage of the plugin in a Vite configuration\n * export default defineConfig({\n *   plugins: [ intlayerMiddleware() ],\n * });\n * ```\n */\nexport const intlayerMiddleware = intlayerProxy;\n\n/**\n * @deprecated Rename to intlayerProxy instead\n *\n * A Vite plugin that integrates a logic similar to the Next.js intlayer middleware.\n *\n * ```ts\n * // Example usage of the plugin in a Vite configuration\n * export default defineConfig({\n *   plugins: [ intlayerMiddleware() ],\n * });\n * ```\n */\nexport const intLayerMiddlewarePlugin = intlayerProxy;\n"],"mappings":"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"}

package/dist/types/intlayerPlugin.d.ts

@@ -25,9 +25,10 @@ type IntlayerPluginOptions = GetConfigurationOptions & {
    * Options forwarded to the bundled locale-routing proxy (`intlayerProxy`).
    *
    * Since Intlayer v9 the proxy is plugged directly into the main `intlayer()`
-   * plugin (controlled by `routing.enableProxy`, `true` by default). These
-   * routing options let you tune that bundled proxy without registering it
-   * separately — e.g. ignore API routes from locale routing.
+   * plugin (controlled by `routing.enableProxy`, unset by default, which
+   * selects auto mode). These routing options let you tune that bundled proxy
+   * without registering it separately — e.g. ignore API routes from locale
+   * routing.
    *
    * @example
    * ```ts

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

@@ -1 +1 @@
-{"version":3,"file":"intlayerPlugin.d.ts","names":[],"sources":["../../src/intlayerPlugin.ts"],"mappings":";;;;;;;;;;;;;;KAuCY,wBAAwB;;;;;;;;EAQlC,gBAAgB;;;;;;;;;;;;;;EAehB,QAAQ,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;cA0BF,iBAAc,gBACT,0BACf;;;;;;;;;;;cAsMU,iBAAQ;;;;;;;;;;;;;cAaR,uBAAc"}
+{"version":3,"file":"intlayerPlugin.d.ts","names":[],"sources":["../../src/intlayerPlugin.ts"],"mappings":";;;;;;;;;;;;;;KAwCY,wBAAwB;;;;;;;;EAQlC,gBAAgB;;;;;;;;;;;;;;;EAgBhB,QAAQ,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;cA0BF,iBAAc,gBACT,0BACf;;;;;;;;;;;cAyMU,iBAAQ;;;;;;;;;;;;;cAaR,uBAAc"}

package/dist/types/intlayerProxyPlugin.d.ts

@@ -28,6 +28,20 @@ type IntlayerProxyPluginOptions = {
    * ```
    */
   configOptions?: GetConfigurationOptions;
+  /**
+   * Whether a development or preview server is serving the app.
+   *
+   * Set internally by the plugin from `configureServer` /
+   * `configurePreviewServer`. It only matters in the proxy's auto mode, where
+   * a dev server keeps locale routing URL-driven by ignoring the stored locale
+   * as a redirect source.
+   *
+   * Defaults to `false` so that mounting `createIntlayerProxyHandler()`
+   * manually — the documented production Nitro setup — keeps full behaviour.
+   *
+   * @default false
+   */
+  isDevServer?: boolean;
 };
 /**
  * A Node.js-compatible Connect middleware function.
@@ -99,7 +113,7 @@ declare const createIntlayerProxyHandler: (options?: IntlayerProxyPluginOptions)
  * });
  * ```
  *
- * @deprecated Since Intlayer v9, `intlayerProxy()` is bundled directly into the `intlayer()` plugin and enabled by default through the `routing.enableProxy` option (`true` by default). Registering it separately as shown below is now optional.
+ * @deprecated Since Intlayer v9, `intlayerProxy()` is bundled directly into the `intlayer()` plugin and enabled by default through the `routing.enableProxy` option (unset by default, which selects auto mode). Registering it separately as shown below is now optional.
  */
 declare const intlayerProxy: (options?: IntlayerProxyPluginOptions) => Plugin;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"intlayerProxyPlugin.d.ts","names":[],"sources":["../../src/intlayerProxyPlugin.ts"],"mappings":";;;;KA+BY;;;;;;;;;;;;;;EAcV,UAAU,KAAK;;;;;;;;;;;EAWf,gBAAgB;;;;;;;KAQb,kBACH,KAAK,iBACL,KAAK,eAAe,kBACpB;;;;;;;;;;;;;;;;;;;;;;;;;cA2BW,6BAA0B,UAC3B,+BACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAk6BU,gBAAa,UAAc,+BAA6B;;;;;;;;;;;;;cAyGxD,2BAAkB;;;;;;;;;;;;;cAclB,iCAAwB"}
+{"version":3,"file":"intlayerProxyPlugin.d.ts","names":[],"sources":["../../src/intlayerProxyPlugin.ts"],"mappings":";;;;KAiCY;;;;;;;;;;;;;;EAcV,UAAU,KAAK;;;;;;;;;;;EAWf,gBAAgB;;;;;;;;;;;;;;EAchB;;;;;;;KAQG,kBACH,KAAK,iBACL,KAAK,eAAe,kBACpB;;;;;;;;;;;;;;;;;;;;;;;;;cA2BW,6BAA0B,UAC3B,+BACT;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAu7BU,gBAAa,UAAc,+BAA6B;;;;;;;;;;;;;cAsHxD,2BAAkB;;;;;;;;;;;;;cAclB,iCAAwB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-intlayer",
-  "version": "9.1.2",
+  "version": "9.2.0",
   "private": false,
   "description": "A Vite plugin for seamless internationalization (i18n), providing locale detection, redirection, and environment-based configuration",
   "keywords": [
@@ -81,12 +81,12 @@
     "typecheck": "tsc --noEmit --project tsconfig.types.json"
   },
   "dependencies": {
-    "@intlayer/babel": "9.1.2",
-    "@intlayer/config": "9.1.2",
-    "@intlayer/core": "9.1.2",
-    "@intlayer/dictionaries-entry": "9.1.2",
-    "@intlayer/engine": "9.1.2",
-    "@intlayer/types": "9.1.2"
+    "@intlayer/babel": "9.2.0",
+    "@intlayer/config": "9.2.0",
+    "@intlayer/core": "9.2.0",
+    "@intlayer/dictionaries-entry": "9.2.0",
+    "@intlayer/engine": "9.2.0",
+    "@intlayer/types": "9.2.0"
   },
   "devDependencies": {
     "@types/node": "26.1.2",
@@ -100,8 +100,8 @@
   },
   "peerDependencies": {
     "@babel/core": ">=6.0.0",
-    "@intlayer/svelte-compiler": "9.1.2",
-    "@intlayer/vue-compiler": "9.1.2",
+    "@intlayer/svelte-compiler": "9.2.0",
+    "@intlayer/vue-compiler": "9.2.0",
     "h3": ">=1.0.0",
     "vite": ">=4.0.0"
   },